feat: regenerate CLI from OpenAPI spec

Author: hostingerbot[bot]

client/client.gen.go

@@ -13,7 +13,7 @@ import (
 var ListSetupsCmd = &cobra.Command{
 	Use:   "list-setups",
 	Short: "List website setups",
-	Long:  "Returns the website setups started in the last 24 hours for the hosting accounts\naccessible to the authenticated client, newest first.\n\nMeant for polling right after creating a website: the website shows up in the\nwebsites list before its server-side setup has finished, and while the setup is\n`running` endpoints that operate on that website may respond with `404` or `409`.\nPoll this endpoint with the `domain` filter every 10 to 15 seconds and wait for\n`status: completed` before uploading files, deploying or creating databases.\n`failed` means the setup stopped before finishing or has not reported progress for\nover an hour. Setups older than 24 hours are not listed.",
+	Long:  "Returns the website setups started in the last 24 hours for the hosting accounts\naccessible to the authenticated client, newest first. Narrow the list with the\n`order_id`, `subscription_id` or `domain` filters.\n\nMeant for polling right after creating a website or starting a website setup: the\nwebsite shows up in the websites list before its server-side setup has finished, and\nwhile the setup is `running` endpoints that operate on that website may respond with\n`404` or `409`. Poll this endpoint with the `domain` filter every 10 to 15 seconds and\nwait for `status: completed` before uploading files, deploying or creating databases.\n`failed` means the setup stopped before finishing or has not reported progress for\nover an hour. Setups older than 24 hours are not listed.\n\n`type` is the website type the setup was started with (`wordpress`, `headless_wordpress`,\n`headless_ecommerce`, `headless_pocketbase`), or `null` for an empty website.",
 	Run: func(cmd *cobra.Command, args []string) {
 		r, err := api.Request().HostingListWebsiteSetupsV1WithResponse(context.TODO(), listSetupsParams(cmd))
 		if err != nil {
@@ -25,11 +25,21 @@ var ListSetupsCmd = &cobra.Command{
 }
 
 func init() {
+	ListSetupsCmd.Flags().IntP("order-id", "", 0, "Order ID")
+	ListSetupsCmd.Flags().StringP("subscription-id", "", "", "Filter by hosting order subscription ID")
 	ListSetupsCmd.Flags().StringP("domain", "", "", "Filter by domain name (exact match)")
 }
 
 func listSetupsParams(cmd *cobra.Command) *client.HostingListWebsiteSetupsV1Params {
 	params := &client.HostingListWebsiteSetupsV1Params{}
+	if cmd.Flags().Changed("order-id") {
+		v, _ := cmd.Flags().GetInt("order-id")
+		params.OrderId = &v
+	}
+	if cmd.Flags().Changed("subscription-id") {
+		v, _ := cmd.Flags().GetString("subscription-id")
+		params.SubscriptionId = &v
+	}
 	if cmd.Flags().Changed("domain") {
 		v, _ := cmd.Flags().GetString("domain")
 		params.Domain = &v

cmd/hosting/websites/list_setups.go

@@ -0,0 +1,56 @@
+package websites
+
+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 StartSetupCmd = &cobra.Command{
+	Use:   "start-setup <order_id>",
+	Short: "Start website setup",
+	Long:  "Starts a website setup on a Web or Cloud hosting order and returns the created setup\nright away; the website itself is provisioned asynchronously. Poll the list website\nsetups endpoint with the `domain` filter every 10 to 15 seconds and wait for\n`status: completed` before uploading files, deploying or creating databases.\n\nOmit `type` for an empty website. `type: wordpress` installs WordPress in the website\nroot with the admin user, email and password from `wordpress`, the domain as the site\ntitle, and `en_US` when `wordpress.language` is omitted. The headless types\n(`headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless\nwebsite; `headless_wordpress` additionally installs WordPress into the `cms` directory\nof the website root with generated credentials.\n\nOmit `domain` to set the website up on a generated temporary free subdomain.\n\nThe order must already have a hosting account: to create the first website on a new\nhosting plan use the create website endpoint, which takes the `datacenter_code`.\nReturns 404 when the order does not exist or is not accessible to the authenticated\nclient, and 409 with a `Retry-After` header while a setup for the same domain is still\nrunning.",
+	Args:  cobra.MatchAll(cobra.ExactArgs(1)),
+	Run: func(cmd *cobra.Command, args []string) {
+		utils.EnumCheck(cmd, "type", []string{"wordpress", "headless_wordpress", "headless_ecommerce", "headless_pocketbase"})
+		payload, err := json.Marshal(startSetupBody(cmd))
+		if err != nil {
+			log.Fatal(err)
+		}
+		r, err := api.Request().HostingStartWebsiteSetupV1WithBodyWithResponse(context.TODO(), utils.StringToInt(args[0]), "application/json", bytes.NewReader(payload))
+		if err != nil {
+			log.Fatal(err)
+		}
+
+		output.Format(cmd, r.Body, r.StatusCode())
+	},
+}
+
+func init() {
+	StartSetupCmd.Flags().StringP("domain", "", "", "Customer-owned domain. Cannot start with \"www.\". Omit or `null` to set the website up on a generated temporary free subdomain.")
+	StartSetupCmd.Flags().StringP("type", "", "", "Website type. Omit or `null` for an empty website. `wordpress` installs WordPress in the website root and requires `wordpress`. The headless types (`headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless website; `headless_wordpress` additionally installs WordPress into the `cms` directory with generated credentials. (one of: wordpress, headless_wordpress, headless_ecommerce, headless_pocketbase)")
+	StartSetupCmd.Flags().StringP("wordpress", "", "", "WordPress install settings. Required when `type` is `wordpress`, not allowed otherwise. The site title is the domain. (JSON)")
+}
+
+func startSetupBody(cmd *cobra.Command) map[string]any {
+	body := map[string]any{}
+	if cmd.Flags().Changed("domain") {
+		v, _ := cmd.Flags().GetString("domain")
+		body["domain"] = v
+	}
+	if cmd.Flags().Changed("type") {
+		v, _ := cmd.Flags().GetString("type")
+		body["type"] = v
+	}
+	if cmd.Flags().Changed("wordpress") {
+		v, _ := cmd.Flags().GetString("wordpress")
+		body["wordpress"] = utils.JSONValue(v, "wordpress")
+	}
+	return body
+}

cmd/hosting/websites/start_setup.go

@@ -15,4 +15,5 @@ func init() {
 	GroupCmd.AddCommand(DeployStaticSiteArchiveCmd)
 	GroupCmd.AddCommand(ListCmd)
 	GroupCmd.AddCommand(ListSetupsCmd)
+	GroupCmd.AddCommand(StartSetupCmd)
 }

cmd/hosting/websites/websites.go

@@ -23,4 +23,5 @@ Websites commands
 * [hostinger hosting websites deploy-static-site-archive](hostinger_hosting_websites_deploy-static-site-archive.md)	 - Deploy static site archive
 * [hostinger hosting websites list](hostinger_hosting_websites_list.md)	 - List websites
 * [hostinger hosting websites list-setups](hostinger_hosting_websites_list-setups.md)	 - List website setups
+* [hostinger hosting websites start-setup](hostinger_hosting_websites_start-setup.md)	 - Start website setup
 

docs/hostinger_hosting_websites.md

@@ -5,25 +5,31 @@ List website setups
 ### Synopsis
 
 Returns the website setups started in the last 24 hours for the hosting accounts
-accessible to the authenticated client, newest first.
-
-Meant for polling right after creating a website: the website shows up in the
-websites list before its server-side setup has finished, and while the setup is
-`running` endpoints that operate on that website may respond with `404` or `409`.
-Poll this endpoint with the `domain` filter every 10 to 15 seconds and wait for
-`status: completed` before uploading files, deploying or creating databases.
+accessible to the authenticated client, newest first. Narrow the list with the
+`order_id`, `subscription_id` or `domain` filters.
+
+Meant for polling right after creating a website or starting a website setup: the
+website shows up in the websites list before its server-side setup has finished, and
+while the setup is `running` endpoints that operate on that website may respond with
+`404` or `409`. Poll this endpoint with the `domain` filter every 10 to 15 seconds and
+wait for `status: completed` before uploading files, deploying or creating databases.
 `failed` means the setup stopped before finishing or has not reported progress for
 over an hour. Setups older than 24 hours are not listed.
 
+`type` is the website type the setup was started with (`wordpress`, `headless_wordpress`,
+`headless_ecommerce`, `headless_pocketbase`), or `null` for an empty website.
+
 ```
 hostinger hosting websites list-setups [flags]
 ```
 
 ### Options
 
 ```
-      --domain string   Filter by domain name (exact match)
-  -h, --help            help for list-setups
+      --domain string            Filter by domain name (exact match)
+  -h, --help                     help for list-setups
+      --order-id int             Order ID
+      --subscription-id string   Filter by hosting order subscription ID
 ```
 
 ### Options inherited from parent commands

docs/hostinger_hosting_websites_list-setups.md

@@ -0,0 +1,50 @@
+## hostinger hosting websites start-setup
+
+Start website setup
+
+### Synopsis
+
+Starts a website setup on a Web or Cloud hosting order and returns the created setup
+right away; the website itself is provisioned asynchronously. Poll the list website
+setups endpoint with the `domain` filter every 10 to 15 seconds and wait for
+`status: completed` before uploading files, deploying or creating databases.
+
+Omit `type` for an empty website. `type: wordpress` installs WordPress in the website
+root with the admin user, email and password from `wordpress`, the domain as the site
+title, and `en_US` when `wordpress.language` is omitted. The headless types
+(`headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless
+website; `headless_wordpress` additionally installs WordPress into the `cms` directory
+of the website root with generated credentials.
+
+Omit `domain` to set the website up on a generated temporary free subdomain.
+
+The order must already have a hosting account: to create the first website on a new
+hosting plan use the create website endpoint, which takes the `datacenter_code`.
+Returns 404 when the order does not exist or is not accessible to the authenticated
+client, and 409 with a `Retry-After` header while a setup for the same domain is still
+running.
+
+```
+hostinger hosting websites start-setup <order_id> [flags]
+```
+
+### Options
+
+```
+      --domain null      Customer-owned domain. Cannot start with "www.". Omit or null to set the website up on a generated temporary free subdomain.
+  -h, --help             help for start-setup
+      --type null        Website type. Omit or null for an empty website. `wordpress` installs WordPress in the website root and requires `wordpress`. The headless types (`headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless website; `headless_wordpress` additionally installs WordPress into the `cms` directory with generated credentials. (one of: wordpress, headless_wordpress, headless_ecommerce, headless_pocketbase)
+      --wordpress type   WordPress install settings. Required when type is `wordpress`, not allowed otherwise. The site title is the domain. (JSON)
+```
+
+### 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 websites](hostinger_hosting_websites.md)	 - Websites commands
+

docs/hostinger_hosting_websites_start-setup.md

@@ -1444,6 +1444,11 @@
     "method": "POST",
     "path": "/api/hosting/v1/accounts/{username}/websites/{domain}/nodejs/builds"
   },
+  "hosting_startWebsiteSetupV1": {
+    "command": "hostinger hosting websites start-setup",
+    "method": "POST",
+    "path": "/api/hosting/v1/orders/{order_id}/onboardings"
+  },
   "hosting_toggleCachelessModeV1": {
     "command": "hostinger hosting cache toggle-cacheless",
     "method": "PATCH",