feat: regenerate CLI from OpenAPI spec

Author: hostingerbot[bot]

client/client.gen.go

@@ -0,0 +1,26 @@
+package nodejs
+
+import (
+	"context"
+	"log"
+
+	"github.com/google/uuid"
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/spf13/cobra"
+)
+
+var AnalyseFailedBuildCmd = &cobra.Command{
+	Use:   "analyse-failed-build <username> <domain> <uuid>",
+	Short: "Analyse failed Node.js build",
+	Long:  "Returns an AI analysis of why a build failed and how to fix it, based on the build logs,\nthe project file list and package.json. Only builds in the `failed` state can be analysed;\nany other state returns 422. When no analysis could be produced both `analysis` and\n`solution` are null, in which case read `Get NodeJS build logs` instead.\n\nEach call runs the analysis again, so call it once per failed build and keep the result.\nLimited to 5 calls per minute per API client (429 above that).",
+	Args:  cobra.MatchAll(cobra.ExactArgs(3)),
+	Run: func(cmd *cobra.Command, args []string) {
+		r, err := api.Request().HostingAnalyseFailedNodeJsBuildV1WithResponse(context.TODO(), args[0], args[1], uuid.MustParse(args[2]))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}

cmd/hosting/nodejs/analyse_failed_build.go

@@ -0,0 +1,26 @@
+package nodejs
+
+import (
+	"context"
+	"log"
+
+	"github.com/google/uuid"
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/spf13/cobra"
+)
+
+var BuildCmd = &cobra.Command{
+	Use:   "build <username> <domain> <uuid>",
+	Short: "Get Node.js build details",
+	Long:  "Returns one build by UUID: its state (`pending`, `running`, `completed`, `failed`), the\noptions it ran with and timestamps. Poll this while a build is pending or running. When it\nis failed, read `Get NodeJS build logs` and `Analyse failed Node.js build` for the cause.\nReturns 404 when the UUID does not belong to a build of this website.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(3)),
+	Run: func(cmd *cobra.Command, args []string) {
+		r, err := api.Request().HostingGetNodeJsBuildDetailsV1WithResponse(context.TODO(), args[0], args[1], uuid.MustParse(args[2]))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}

cmd/hosting/nodejs/build.go

@@ -0,0 +1,25 @@
+package nodejs
+
+import (
+	"context"
+	"log"
+
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/spf13/cobra"
+)
+
+var BuildSettingsCmd = &cobra.Command{
+	Use:   "build-settings <username> <domain>",
+	Short: "Get Node.js build settings",
+	Long:  "Returns the build settings stored for the website: framework (`app_type`), Node.js version,\nroot and output directory, build script, entry file and package manager. Stored settings\ndrive Git auto-deployment builds. A build started through the API uses the values sent in\nthat request and saves them here only when no settings exist yet.\n\nReturns 404 until the first build or the first settings update stores them. Use this after\na failed build to check whether the framework or the entry file were detected wrong, then\nfix them with the `Update Node.js build settings` endpoint.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(2)),
+	Run: func(cmd *cobra.Command, args []string) {
+		r, err := api.Request().HostingGetNodeJsBuildSettingsV1WithResponse(context.TODO(), args[0], args[1])
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}

cmd/hosting/nodejs/build_settings.go

@@ -0,0 +1,25 @@
+package nodejs
+
+import (
+	"context"
+	"log"
+
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/spf13/cobra"
+)
+
+var ClearRuntimeLogsCmd = &cobra.Command{
+	Use:   "clear-runtime-logs <username> <domain>",
+	Short: "Clear Node.js runtime logs",
+	Long:  "Empties the Node.js application's runtime log file. This cannot be undone, so confirm with\nthe user before calling it. Returns success even when no log file exists yet.\n\nUse it before reproducing a problem so the next `Get Node.js runtime logs` call returns\nonly fresh entries; start that call with `period` again instead of reusing a `from_line`\nfrom before the clear.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(2)),
+	Run: func(cmd *cobra.Command, args []string) {
+		r, err := api.Request().HostingClearNodeJsRuntimeLogsV1WithResponse(context.TODO(), args[0], args[1])
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}

cmd/hosting/nodejs/clear_runtime_logs.go

@@ -10,13 +10,19 @@ var GroupCmd = &cobra.Command{
 }
 
 func init() {
+	GroupCmd.AddCommand(AnalyseFailedBuildCmd)
+	GroupCmd.AddCommand(BuildCmd)
 	GroupCmd.AddCommand(BuildLogsCmd)
+	GroupCmd.AddCommand(BuildSettingsCmd)
 	GroupCmd.AddCommand(BuildSettingsFromArchiveCmd)
+	GroupCmd.AddCommand(ClearRuntimeLogsCmd)
 	GroupCmd.AddCommand(ListBuildsCmd)
 	GroupCmd.AddCommand(ListEnvironmentVariablesCmd)
 	GroupCmd.AddCommand(ListVulnerabilitiesCmd)
 	GroupCmd.AddCommand(PatchVulnerabilitiesCmd)
 	GroupCmd.AddCommand(ReplaceEnvironmentVariablesCmd)
 	GroupCmd.AddCommand(RestartApplicationCmd)
+	GroupCmd.AddCommand(RuntimeLogsCmd)
 	GroupCmd.AddCommand(StartBuildCmd)
+	GroupCmd.AddCommand(UpdateBuildSettingsCmd)
 }

cmd/hosting/nodejs/nodejs.go

@@ -0,0 +1,61 @@
+package nodejs
+
+import (
+	"context"
+	"log"
+
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/client"
+	"github.com/hostinger/api-cli/output"
+	"github.com/hostinger/api-cli/utils"
+	"github.com/spf13/cobra"
+)
+
+var RuntimeLogsCmd = &cobra.Command{
+	Use:   "runtime-logs <username> <domain>",
+	Short: "Get Node.js runtime logs",
+	Long:  "Returns the Node.js application's runtime console log entries, oldest first, each with\ntimestamp, level and message. On the first call send `period` (`1h`, `1d`, `1w` or `1m`)\nand optionally `levels` and `limit` (1-5000, default 1000); when more entries match than\n`limit`, the newest are kept.\n\nTo poll for new entries send `total_lines + 1` from the previous response as `from_line`\nand omit `period`; `period` and `from_line` cannot be combined. Lines that are not JSON\nwith a timestamp, level and message are skipped, so `logs` may hold fewer than `limit`\nentries while `total_lines` counts every raw line. Entries with a timestamp before\n`last_deployed_at` belong to the previous deployment. Returns an empty `logs` list when\nthe application has not written a log file yet.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(2)),
+	Run: func(cmd *cobra.Command, args []string) {
+		utils.EnumCheck(cmd, "period", []string{"1h", "1d", "1w", "1m"})
+		r, err := api.Request().HostingGetNodeJsRuntimeLogsV1WithResponse(context.TODO(), args[0], args[1], runtimeLogsParams(cmd))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}
+
+func init() {
+	RuntimeLogsCmd.Flags().StringP("period", "", "", "Time window for the first fetch. Required when `from_line` is not sent. (one of: 1h, 1d, 1w, 1m)")
+	RuntimeLogsCmd.Flags().IntP("from-line", "", 0, "1-based line of the log file to start from. For polling send `total_lines + 1` from the\nprevious response. Cannot be combined with `period`.")
+	RuntimeLogsCmd.Flags().IntP("limit", "", 1000, "Maximum number of log entries to return. When more entries match, the newest are kept.")
+	RuntimeLogsCmd.Flags().StringSliceP("levels", "", nil, "Return only entries with these log levels, sent as a comma-separated list, e.g. ERROR,WARN.\nMatching runs on the raw log line, so entries written with numeric levels (for example by\npino) are excluded while this filter is set. (one of: LOG, ERROR, WARN, INFO, DEBUG, TRACE)")
+}
+
+func runtimeLogsParams(cmd *cobra.Command) *client.HostingGetNodeJsRuntimeLogsV1Params {
+	params := &client.HostingGetNodeJsRuntimeLogsV1Params{}
+	if cmd.Flags().Changed("period") {
+		v, _ := cmd.Flags().GetString("period")
+		e := client.HostingGetNodeJsRuntimeLogsV1ParamsPeriod(v)
+		params.Period = &e
+	}
+	if cmd.Flags().Changed("from-line") {
+		v, _ := cmd.Flags().GetInt("from-line")
+		params.FromLine = &v
+	}
+	if cmd.Flags().Changed("limit") {
+		v, _ := cmd.Flags().GetInt("limit")
+		params.Limit = &v
+	}
+	if cmd.Flags().Changed("levels") {
+		v, _ := cmd.Flags().GetStringSlice("levels")
+		es := make([]client.HostingGetNodeJsRuntimeLogsV1ParamsLevels, len(v))
+		for i, s := range v {
+			es[i] = client.HostingGetNodeJsRuntimeLogsV1ParamsLevels(s)
+		}
+		params.Levels = &es
+	}
+	return params
+}

cmd/hosting/nodejs/runtime_logs.go

@@ -0,0 +1,76 @@
+package nodejs
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"log"
+
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/hostinger/api-cli/utils"
+	"github.com/spf13/cobra"
+)
+
+var UpdateBuildSettingsCmd = &cobra.Command{
+	Use:   "update-build-settings <username> <domain>",
+	Short: "Update Node.js build settings",
+	Long:  "Replaces the build settings stored for the website. Send the full set: `node_version` is\nrequired and every nullable field you omit is stored as null. Creates the settings when\nnone exist yet.\n\nThis does not start a build. Stored settings drive Git auto-deployment builds; a build\nstarted through the API uses the values sent in that request, so to rebuild with corrected\nsettings call `Start Node.js build` with the same values. Typical fixes: a wrong `app_type`\nafter auto-detection, or a missing `entry_file` for express, fastify, nest, nuxt and hono\napps.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(2)),
+	Run: func(cmd *cobra.Command, args []string) {
+		utils.EnumCheck(cmd, "app-type", []string{"create-react-app", "gatsby", "vite", "angular", "react", "vue", "parcel", "next", "nuxt", "nest", "express", "fastify", "astro", "svelte", "svelte-kit", "hono", "react-router", "nitro", "other"})
+		utils.EnumCheck(cmd, "package-manager", []string{"npm", "yarn", "pnpm"})
+		payload, err := json.Marshal(updateBuildSettingsBody(cmd))
+		if err != nil {
+			log.Fatal(err)
+		}
+		r, err := api.Request().HostingUpdateNodeJsBuildSettingsV1WithBodyWithResponse(context.TODO(), args[0], args[1], "application/json", bytes.NewReader(payload))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}
+
+func init() {
+	UpdateBuildSettingsCmd.Flags().StringP("app-type", "", "", "Node.js application framework. Set it explicitly when auto-detection picked the wrong one. (one of: create-react-app, gatsby, vite, angular, react, vue, parcel, next, nuxt, nest, express, fastify, astro, svelte, svelte-kit, hono, react-router, nitro, other)")
+	UpdateBuildSettingsCmd.Flags().StringP("build-script", "", "", "The package.json script that builds the application")
+	UpdateBuildSettingsCmd.Flags().StringP("entry-file", "", "", "The main entry point file for the application\n(required for express, fastify, nest, nuxt and hono app types)")
+	UpdateBuildSettingsCmd.Flags().IntP("node-version", "", 0, "Node.js major version (one of: 18, 20, 22, 24)")
+	UpdateBuildSettingsCmd.Flags().StringP("output-directory", "", "", "Build output directory relative to the root directory")
+	UpdateBuildSettingsCmd.Flags().StringP("package-manager", "", "", "Package manager used to install dependencies (one of: npm, yarn, pnpm)")
+	UpdateBuildSettingsCmd.Flags().StringP("root-directory", "", "", "Application root directory (where package.json is located) relative to public_html.\nOmit it, or send \".\", for public_html itself.")
+	UpdateBuildSettingsCmd.MarkFlagRequired("node-version")
+}
+
+func updateBuildSettingsBody(cmd *cobra.Command) map[string]any {
+	body := map[string]any{}
+	if cmd.Flags().Changed("app-type") {
+		v, _ := cmd.Flags().GetString("app-type")
+		body["app_type"] = v
+	}
+	if cmd.Flags().Changed("build-script") {
+		v, _ := cmd.Flags().GetString("build-script")
+		body["build_script"] = v
+	}
+	if cmd.Flags().Changed("entry-file") {
+		v, _ := cmd.Flags().GetString("entry-file")
+		body["entry_file"] = v
+	}
+	nodeVersionVal, _ := cmd.Flags().GetInt("node-version")
+	body["node_version"] = nodeVersionVal
+	if cmd.Flags().Changed("output-directory") {
+		v, _ := cmd.Flags().GetString("output-directory")
+		body["output_directory"] = v
+	}
+	if cmd.Flags().Changed("package-manager") {
+		v, _ := cmd.Flags().GetString("package-manager")
+		body["package_manager"] = v
+	}
+	if cmd.Flags().Changed("root-directory") {
+		v, _ := cmd.Flags().GetString("root-directory")
+		body["root_directory"] = v
+	}
+	return body
+}

cmd/hosting/nodejs/update_build_settings.go

@@ -18,13 +18,19 @@ NodeJS commands
 ### SEE ALSO
 
 * [hostinger hosting](hostinger_hosting.md)	 - Hosting commands
+* [hostinger hosting nodejs analyse-failed-build](hostinger_hosting_nodejs_analyse-failed-build.md)	 - Analyse failed Node.js build
+* [hostinger hosting nodejs build](hostinger_hosting_nodejs_build.md)	 - Get Node.js build details
 * [hostinger hosting nodejs build-logs](hostinger_hosting_nodejs_build-logs.md)	 - Get NodeJS build logs
+* [hostinger hosting nodejs build-settings](hostinger_hosting_nodejs_build-settings.md)	 - Get Node.js build settings
 * [hostinger hosting nodejs build-settings-from-archive](hostinger_hosting_nodejs_build-settings-from-archive.md)	 - Get Node.js build settings from archive
+* [hostinger hosting nodejs clear-runtime-logs](hostinger_hosting_nodejs_clear-runtime-logs.md)	 - Clear Node.js runtime logs
 * [hostinger hosting nodejs list-builds](hostinger_hosting_nodejs_list-builds.md)	 - List NodeJS builds
 * [hostinger hosting nodejs list-environment-variables](hostinger_hosting_nodejs_list-environment-variables.md)	 - List Node.js environment variables
 * [hostinger hosting nodejs list-vulnerabilities](hostinger_hosting_nodejs_list-vulnerabilities.md)	 - List Node.js vulnerabilities
 * [hostinger hosting nodejs patch-vulnerabilities](hostinger_hosting_nodejs_patch-vulnerabilities.md)	 - Patch Node.js vulnerabilities
 * [hostinger hosting nodejs replace-environment-variables](hostinger_hosting_nodejs_replace-environment-variables.md)	 - Replace Node.js environment variables
 * [hostinger hosting nodejs restart-application](hostinger_hosting_nodejs_restart-application.md)	 - Restart Node.js application
+* [hostinger hosting nodejs runtime-logs](hostinger_hosting_nodejs_runtime-logs.md)	 - Get Node.js runtime logs
 * [hostinger hosting nodejs start-build](hostinger_hosting_nodejs_start-build.md)	 - Start Node.js build
+* [hostinger hosting nodejs update-build-settings](hostinger_hosting_nodejs_update-build-settings.md)	 - Update Node.js build settings
 

docs/hostinger_hosting_nodejs.md

@@ -0,0 +1,35 @@
+## hostinger hosting nodejs analyse-failed-build
+
+Analyse failed Node.js build
+
+### Synopsis
+
+Returns an AI analysis of why a build failed and how to fix it, based on the build logs,
+the project file list and package.json. Only builds in the `failed` state can be analysed;
+any other state returns 422. When no analysis could be produced both `analysis` and
+`solution` are null, in which case read `Get NodeJS build logs` instead.
+
+Each call runs the analysis again, so call it once per failed build and keep the result.
+Limited to 5 calls per minute per API client (429 above that).
+
+```
+hostinger hosting nodejs analyse-failed-build <username> <domain> <uuid> [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for analyse-failed-build
+```
+
+### Options inherited from parent commands
+
+```
+      --config string   Config file (default is $HOME/.hostinger.yaml)
+      --format string   Output format type (json|table|tree), default: table
+```
+
+### SEE ALSO
+
+* [hostinger hosting nodejs](hostinger_hosting_nodejs.md)	 - NodeJS commands
+