feat: regenerate CLI from OpenAPI spec

Author: hostingerbot[bot]

client/client.gen.go

@@ -10,5 +10,6 @@ var GroupCmd = &cobra.Command{
 }
 
 func init() {
+	GroupCmd.AddCommand(GenerateUploadUrlCmd)
 	GroupCmd.AddCommand(ImportWebsiteFromArchiveCmd)
 }

cmd/agency_hosting/files/files.go

@@ -0,0 +1,25 @@
+package files
+
+import (
+	"context"
+	"log"
+
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/spf13/cobra"
+)
+
+var GenerateUploadUrlCmd = &cobra.Command{
+	Use:   "generate-upload-url <website_uid>",
+	Short: "Generate upload URL",
+	Long:  "Generate a file browser upload URL with authentication credentials for uploading files\nto an Agency Plan website's file storage.\n\nReturns `url`, `auth_key` and `rest_auth_key`. Use these to upload a file to the\nwebsite's file storage via the TUS resumable upload protocol (TUS 1.0.0). Send\n`X-Auth: {auth_key}` and `X-Auth-Rest: {rest_auth_key}` headers on every request below.\n\n1. Create the upload: `POST` to `{url}/{relative_file_path}?override=true` with headers\n   `upload-length: {file size in bytes}` and `upload-offset: 0`. Expect `201 Created`.\n2. Upload the file: send the file bytes to the same location (any TUS 1.0.0 client, or\n   `PATCH` requests with an `upload-offset` header tracking progress) until complete.\n\n`relative_file_path` is the destination path inside the website's file storage, e.g.\n`app.zip`.\n\nInstead of a TUS client, plain `curl` also works:\n```\nFILE=app.zip\nSIZE=$(stat -f%z \"$FILE\")   # stat -c%s on Linux\n\ncurl -i -X POST \"{url}/${FILE}?override=true\" \\\n  -H \"X-Auth: {auth_key}\" \\\n  -H \"X-Auth-Rest: {rest_auth_key}\" \\\n  -H \"Tus-Resumable: 1.0.0\" \\\n  -H \"Upload-Length: ${SIZE}\" \\\n  -H \"Upload-Offset: 0\"\n# -> 201 Created\n\ncurl -i -X PATCH \"{url}/${FILE}?override=true\" \\\n  -H \"X-Auth: {auth_key}\" \\\n  -H \"X-Auth-Rest: {rest_auth_key}\" \\\n  -H \"Tus-Resumable: 1.0.0\" \\\n  -H \"Content-Type: application/offset+octet-stream\" \\\n  -H \"Upload-Offset: 0\" \\\n  --data-binary \"@${FILE}\"\n# -> 204 No Content, Upload-Offset response header equals SIZE when done\n```",
+	Args:  cobra.MatchAll(cobra.ExactArgs(1)),
+	Run: func(cmd *cobra.Command, args []string) {
+		r, err := api.Request().AgencyHostingGenerateUploadURLV1WithResponse(context.TODO(), args[0])
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}

cmd/agency_hosting/files/generate_upload_url.go

@@ -10,6 +10,7 @@ var GroupCmd = &cobra.Command{
 }
 
 func init() {
+	GroupCmd.AddCommand(GenerateUploadUrlCmd)
 	GroupCmd.AddCommand(ListWebsiteAndDirectoriesCmd)
 	GroupCmd.AddCommand(WebsiteContentCmd)
 }

cmd/hosting/files/files.go

@@ -0,0 +1,46 @@
+package files
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"log"
+
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/spf13/cobra"
+)
+
+var GenerateUploadUrlCmd = &cobra.Command{
+	Use:   "generate-upload-url",
+	Short: "Generate upload URL",
+	Long:  "Generate a file browser upload URL with authentication credentials\nfor uploading files directly to a website's file storage.\n\nReturns `url`, `auth_key` and `rest_auth_key`. Use these to upload a file to the\nwebsite's `public_html` directory via the TUS resumable upload protocol (TUS 1.0.0).\nSend `X-Auth: {auth_key}` and `X-Auth-Rest: {rest_auth_key}` headers on every request\nbelow.\n\n1. Create the upload: `POST` to `{url}/{relative_file_path}?override=true` with headers\n   `upload-length: {file size in bytes}` and `upload-offset: 0`. Expect `201 Created`.\n2. Upload the file: send the file bytes to the same location (any TUS 1.0.0 client, or\n   `PATCH` requests with an `upload-offset` header tracking progress) until complete.\n\n`relative_file_path` is the destination path inside `public_html`, e.g. `app.zip`.\n\nInstead of a TUS client, plain `curl` also works:\n```\nFILE=app.zip\nSIZE=$(stat -f%z \"$FILE\")   # stat -c%s on Linux\n\ncurl -i -X POST \"{url}/${FILE}?override=true\" \\\n  -H \"X-Auth: {auth_key}\" \\\n  -H \"X-Auth-Rest: {rest_auth_key}\" \\\n  -H \"Tus-Resumable: 1.0.0\" \\\n  -H \"Upload-Length: ${SIZE}\" \\\n  -H \"Upload-Offset: 0\"\n# -> 201 Created\n\ncurl -i -X PATCH \"{url}/${FILE}?override=true\" \\\n  -H \"X-Auth: {auth_key}\" \\\n  -H \"X-Auth-Rest: {rest_auth_key}\" \\\n  -H \"Tus-Resumable: 1.0.0\" \\\n  -H \"Content-Type: application/offset+octet-stream\" \\\n  -H \"Upload-Offset: 0\" \\\n  --data-binary \"@${FILE}\"\n# -> 204 No Content, Upload-Offset response header equals SIZE when done\n```",
+	Run: func(cmd *cobra.Command, args []string) {
+		payload, err := json.Marshal(generateUploadUrlBody(cmd))
+		if err != nil {
+			log.Fatal(err)
+		}
+		r, err := api.Request().HostingGenerateUploadURLV1WithBodyWithResponse(context.TODO(), "application/json", bytes.NewReader(payload))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}
+
+func init() {
+	GenerateUploadUrlCmd.Flags().StringP("domain", "", "", "Website domain")
+	GenerateUploadUrlCmd.Flags().StringP("username", "", "", "Account username")
+	GenerateUploadUrlCmd.MarkFlagRequired("domain")
+	GenerateUploadUrlCmd.MarkFlagRequired("username")
+}
+
+func generateUploadUrlBody(cmd *cobra.Command) map[string]any {
+	body := map[string]any{}
+	domainVal, _ := cmd.Flags().GetString("domain")
+	body["domain"] = domainVal
+	usernameVal, _ := cmd.Flags().GetString("username")
+	body["username"] = usernameVal
+	return body
+}

cmd/hosting/files/generate_upload_url.go

@@ -0,0 +1,38 @@
+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/spf13/cobra"
+)
+
+var BuildSettingsFromArchiveCmd = &cobra.Command{
+	Use:   "build-settings-from-archive <username> <domain>",
+	Short: "Get Node.js build settings from archive",
+	Long:  "Auto-detect Node.js build settings from a package.json inside an archive already on the server.\n\nUse this before calling `Start Node.js Build` to preview what settings will be used,\nor to let the user review and override values (framework, node version, root directory,\noutput directory, build script) before committing to a build.\n\nThe archive must already be present on the website's file storage. Use the\n`Generate Upload URL` endpoint to obtain credentials and upload the archive first.\nTo upload an archive and start a build in one step without inspecting settings first,\nuse the `Create Node.js Build from Archive` endpoint instead.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(2)),
+	Run: func(cmd *cobra.Command, args []string) {
+		r, err := api.Request().HostingGetNodeJsBuildSettingsFromArchiveV1WithResponse(context.TODO(), args[0], args[1], buildSettingsFromArchiveParams(cmd))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}
+
+func init() {
+	BuildSettingsFromArchiveCmd.Flags().StringP("archive-path", "", "", "The path to the archive file relative to the document root of the vhost")
+	BuildSettingsFromArchiveCmd.MarkFlagRequired("archive-path")
+}
+
+func buildSettingsFromArchiveParams(cmd *cobra.Command) *client.HostingGetNodeJsBuildSettingsFromArchiveV1Params {
+	params := &client.HostingGetNodeJsBuildSettingsFromArchiveV1Params{}
+	archivePathVal, _ := cmd.Flags().GetString("archive-path")
+	params.ArchivePath = archivePathVal
+	return params
+}

cmd/hosting/nodejs/build_settings_from_archive.go

@@ -15,7 +15,7 @@ import (
 var CreateBuildFromArchiveCmd = &cobra.Command{
 	Use:   "create-build-from-archive <username> <domain>",
 	Short: "Create NodeJS build from archive",
-	Long:  "Upload a project archive, auto-detect build settings, and immediately start a Node.js build.\n\nThis is the recommended single-step approach for deploying a Node.js application.\nThe archive is uploaded to the website's file storage, build settings are auto-detected\nfrom the package.json inside the archive, and the build process starts automatically.\nOptional override fields take precedence over auto-detected values.\nMaximum archive size is 50MB.\n\nBefore archiving, exclude `node_modules/` and any build output directories\n(e.g. `dist/`, `.next/`, `build/`) — they are not needed because the build\nprocess runs the install step automatically, and including them unnecessarily\nincreases the archive size. This also helps keep the archive well under the 50MB limit.\n\nExample (zip):\n```\nzip -r archive.zip . --exclude \"node_modules/*\" --exclude \"dist/*\"\n```\n\nThe returned build `uuid` can be used to poll progress and retrieve logs via\nthe `Get Node.js Build Logs` endpoint.",
+	Long:  "Upload a project archive, auto-detect build settings, and immediately start a Node.js build.\n\nWARNING: on success this overwrites the website's existing contents and cannot be\nundone — verify this is intended before calling this endpoint.\n\nThis is the recommended single-step approach for deploying a Node.js application.\nThe archive is uploaded to the website's file storage, build settings are auto-detected\nfrom the package.json inside the archive, and the build process starts automatically.\nOptional override fields take precedence over auto-detected values.\nMaximum archive size is 50MB.\n\nBefore archiving, exclude `node_modules/` and any build output directories\n(e.g. `dist/`, `.next/`, `build/`) — they are not needed because the build\nprocess runs the install step automatically, and including them unnecessarily\nincreases the archive size. This also helps keep the archive well under the 50MB limit.\n\nExample (zip):\n```\nzip -r archive.zip . --exclude \"node_modules/*\" --exclude \"dist/*\"\n```\n\nThe returned build `uuid` can be used to poll progress and retrieve logs via\nthe `Get Node.js Build Logs` endpoint.",
 	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"})

cmd/hosting/nodejs/create_build_from_archive.go

@@ -11,9 +11,11 @@ var GroupCmd = &cobra.Command{
 
 func init() {
 	GroupCmd.AddCommand(BuildLogsCmd)
+	GroupCmd.AddCommand(BuildSettingsFromArchiveCmd)
 	GroupCmd.AddCommand(CreateBuildFromArchiveCmd)
 	GroupCmd.AddCommand(ListBuildsCmd)
 	GroupCmd.AddCommand(ListVulnerabilitiesCmd)
 	GroupCmd.AddCommand(PatchVulnerabilitiesCmd)
 	GroupCmd.AddCommand(RestartApplicationCmd)
+	GroupCmd.AddCommand(StartBuildCmd)
 }

cmd/hosting/nodejs/nodejs.go

@@ -0,0 +1,81 @@
+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 StartBuildCmd = &cobra.Command{
+	Use:   "start-build <username> <domain>",
+	Short: "Start Node.js build",
+	Long:  "Start a Node.js build process using files already present on the website's file storage.\n\nWARNING: on success this overwrites the website's existing contents and cannot be\nundone — verify this is intended before calling this endpoint.\n\nThe `source_type` must be `archive` and `source_options.archive_path` must point to an\nexisting archive file on the server (relative to the website document root).\nUse the `Generate Upload URL` endpoint to obtain credentials and upload the archive first.\n\nTo auto-detect build settings from an archive before starting, first call the\n`Get Node.js Build Settings from Archive` endpoint. To upload an archive and start\na build in one step, use the `Create Node.js Build from Archive` endpoint instead.\n\nThe returned build `uuid` can be used to poll progress and retrieve logs via\nthe `Get Node.js Build Logs` endpoint.",
+	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"})
+		utils.EnumCheck(cmd, "source-type", []string{"archive"})
+		payload, err := json.Marshal(startBuildBody(cmd))
+		if err != nil {
+			log.Fatal(err)
+		}
+		r, err := api.Request().HostingStartNodeJsBuildV1WithBodyWithResponse(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() {
+	StartBuildCmd.Flags().StringP("app-type", "", "", "Node.js application type (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)")
+	StartBuildCmd.Flags().StringP("build-script", "", "", "Build script that will be ran to build the application")
+	StartBuildCmd.Flags().StringP("entry-file", "", "", "The main entry point file for the application")
+	StartBuildCmd.Flags().IntP("node-version", "", 0, "Node.js version (one of: 18, 20, 22, 24)")
+	StartBuildCmd.Flags().StringP("output-directory", "", "", "Build output directory relative to the root directory")
+	StartBuildCmd.Flags().StringP("package-manager", "", "", "Package manager (one of: npm, yarn, pnpm)")
+	StartBuildCmd.Flags().StringP("root-directory", "", "", "Application root directory (where package.json is located) relative to public_html")
+	StartBuildCmd.Flags().StringP("source-options", "", "", "Source-specific options (JSON)")
+	StartBuildCmd.Flags().StringP("source-type", "", "", "The source type of the files (one of: archive)")
+	StartBuildCmd.MarkFlagRequired("app-type")
+	StartBuildCmd.MarkFlagRequired("build-script")
+	StartBuildCmd.MarkFlagRequired("node-version")
+	StartBuildCmd.MarkFlagRequired("output-directory")
+	StartBuildCmd.MarkFlagRequired("root-directory")
+	StartBuildCmd.MarkFlagRequired("source-options")
+	StartBuildCmd.MarkFlagRequired("source-type")
+}
+
+func startBuildBody(cmd *cobra.Command) map[string]any {
+	body := map[string]any{}
+	appTypeVal, _ := cmd.Flags().GetString("app-type")
+	body["app_type"] = appTypeVal
+	buildScriptVal, _ := cmd.Flags().GetString("build-script")
+	body["build_script"] = buildScriptVal
+	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
+	outputDirectoryVal, _ := cmd.Flags().GetString("output-directory")
+	body["output_directory"] = outputDirectoryVal
+	if cmd.Flags().Changed("package-manager") {
+		v, _ := cmd.Flags().GetString("package-manager")
+		body["package_manager"] = v
+	}
+	rootDirectoryVal, _ := cmd.Flags().GetString("root-directory")
+	body["root_directory"] = rootDirectoryVal
+	sourceOptionsVal, _ := cmd.Flags().GetString("source-options")
+	body["source_options"] = utils.JSONValue(sourceOptionsVal, "source-options")
+	sourceTypeVal, _ := cmd.Flags().GetString("source-type")
+	body["source_type"] = sourceTypeVal
+	return body
+}

cmd/hosting/nodejs/start_build.go

@@ -0,0 +1,43 @@
+package websites
+
+import (
+	"bytes"
+	"context"
+	"encoding/json"
+	"log"
+
+	"github.com/hostinger/api-cli/api"
+	"github.com/hostinger/api-cli/output"
+	"github.com/spf13/cobra"
+)
+
+var DeployStaticSiteArchiveCmd = &cobra.Command{
+	Use:   "deploy-static-site-archive <username> <domain>",
+	Short: "Deploy static site archive",
+	Long:  "Deploy a static application from an archive file.\n\nWARNING: this overwrites the website's existing contents and cannot be undone —\nverify this is intended before calling this endpoint.\n\nThis endpoint allows you to deploy a static application from an archive\nfile that has been uploaded to the website's directory.\n\nThis only works for static sites (pre-built HTML/CSS/JS with no build step). For\nNode.js applications, use `Create NodeJS build from archive` instead, or\n`Start Node.js build` if the archive is already uploaded. For WordPress sites,\nuse `Import WordPress website`.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(2)),
+	Run: func(cmd *cobra.Command, args []string) {
+		payload, err := json.Marshal(deployStaticSiteArchiveBody(cmd))
+		if err != nil {
+			log.Fatal(err)
+		}
+		r, err := api.Request().HostingDeployStaticSiteArchiveV1WithBodyWithResponse(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() {
+	DeployStaticSiteArchiveCmd.Flags().StringP("archive-path", "", "", "Relative path to the archive file from website root directory")
+	DeployStaticSiteArchiveCmd.MarkFlagRequired("archive-path")
+}
+
+func deployStaticSiteArchiveBody(cmd *cobra.Command) map[string]any {
+	body := map[string]any{}
+	archivePathVal, _ := cmd.Flags().GetString("archive-path")
+	body["archive_path"] = archivePathVal
+	return body
+}