appwrite-cli 13.0.0-rc.2 → 13.0.0-rc.3

package/lib/commands/services/sites.ts

@@ -1,13 +1,19 @@
 import { Command } from "commander";
+import fs from "fs";
 import { sdkForProject } from "../../sdks.js";
 import {
   actionRunner,
   commandDescriptions,
+  success,
+  parse,
   parseBool,
   parseInteger,
 } from "../../parser.js";
 import {
   Sites,
+  Framework,
+  BuildRuntime,
+  Adapter,
   UsageRange,
   TemplateReferenceType,
   VCSReferenceType,
@@ -32,17 +38,9 @@ export const sites = new Command("sites")
 
 sites
   .command(`list`)
-  .description(
-    `Get a list of all the project's sites. You can use the query params to filter your results.`,
-  )
-  .option(
-    `--queries [queries...]`,
-    `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, enabled, framework, deploymentId, buildCommand, installCommand, outputDirectory, installationId`,
-  )
-  .option(
-    `--search <search>`,
-    `Search term to filter your list results. Max length: 256 chars.`,
-  )
+  .description(`Get a list of all the project's sites. You can use the query params to filter your results.`)
+  .option(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: name, enabled, framework, deploymentId, buildCommand, installCommand, outputDirectory, installationId`)
+  .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
   .option(
     `--total [value]`,
     `When set to false, the total count returned will be 0 and will not be calculated.`,
@@ -52,19 +50,17 @@ sites
   .action(
     actionRunner(
       async ({ queries, search, total }) =>
-        await (await getSitesClient()).list(queries, search, total),
+        parse(await (await getSitesClient()).list(queries, search, total)),
     ),
   );
 
 sites
   .command(`create`)
   .description(`Create a new site.`)
-  .requiredOption(
-    `--site-id <site-id>`,
-    `Site ID. Choose a custom ID or generate a random ID with \`ID.unique()\`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.`,
-  )
+  .requiredOption(`--site-id <site-id>`, `Site ID. Choose a custom ID or generate a random ID with \`ID.unique()\`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.`)
   .requiredOption(`--name <name>`, `Site name. Max length: 128 chars.`)
   .requiredOption(`--framework <framework>`, `Sites framework.`)
+  .requiredOption(`--build-runtime <build-runtime>`, `Runtime to use during build step.`)
   .option(
     `--enabled [value]`,
     `Is site enabled? When set to 'disabled', users cannot access the site but Server SDKs with and API key can still access the site. No data is lost when this is toggled.`,
@@ -77,106 +73,37 @@ sites
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
-  .option(
-    `--timeout <timeout>`,
-    `Maximum request time in seconds.`,
-    parseInteger,
-  )
+  .option(`--timeout <timeout>`, `Maximum request time in seconds.`, parseInteger)
   .option(`--install-command <install-command>`, `Install Command.`)
   .option(`--build-command <build-command>`, `Build Command.`)
   .option(`--output-directory <output-directory>`, `Output Directory for site.`)
-  .requiredOption(
-    `--build-runtime <build-runtime>`,
-    `Runtime to use during build step.`,
-  )
-  .option(
-    `--adapter <adapter>`,
-    `Framework adapter defining rendering strategy. Allowed values are: static, ssr`,
-  )
-  .option(
-    `--installation-id <installation-id>`,
-    `Appwrite Installation ID for VCS (Version Control System) deployment.`,
-  )
-  .option(
-    `--fallback-file <fallback-file>`,
-    `Fallback file for single page application sites.`,
-  )
-  .option(
-    `--provider-repository-id <provider-repository-id>`,
-    `Repository ID of the repo linked to the site.`,
-  )
-  .option(
-    `--provider-branch <provider-branch>`,
-    `Production branch for the repo linked to the site.`,
-  )
+  .option(`--adapter <adapter>`, `Framework adapter defining rendering strategy. Allowed values are: static, ssr`)
+  .option(`--installation-id <installation-id>`, `Appwrite Installation ID for VCS (Version Control System) deployment.`)
+  .option(`--fallback-file <fallback-file>`, `Fallback file for single page application sites.`)
+  .option(`--provider-repository-id <provider-repository-id>`, `Repository ID of the repo linked to the site.`)
+  .option(`--provider-branch <provider-branch>`, `Production branch for the repo linked to the site.`)
   .option(
     `--provider-silent-mode [value]`,
     `Is the VCS (Version Control System) connection in silent mode for the repo linked to the site? In silent mode, comments will not be made on commits and pull requests.`,
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
-  .option(
-    `--provider-root-directory <provider-root-directory>`,
-    `Path to site code in the linked repo.`,
-  )
-  .option(
-    `--specification <specification>`,
-    `Framework specification for the site and builds.`,
-  )
+  .option(`--provider-root-directory <provider-root-directory>`, `Path to site code in the linked repo.`)
+  .option(`--specification <specification>`, `Framework specification for the site and builds.`)
   .action(
     actionRunner(
-      async ({
-        siteId,
-        name,
-        framework,
-        enabled,
-        logging,
-        timeout,
-        installCommand,
-        buildCommand,
-        outputDirectory,
-        buildRuntime,
-        adapter,
-        installationId,
-        fallbackFile,
-        providerRepositoryId,
-        providerBranch,
-        providerSilentMode,
-        providerRootDirectory,
-        specification,
-      }) =>
-        await (
-          await getSitesClient()
-        ).create(
-          siteId,
-          name,
-          framework,
-          enabled,
-          logging,
-          timeout,
-          installCommand,
-          buildCommand,
-          outputDirectory,
-          buildRuntime,
-          adapter,
-          installationId,
-          fallbackFile,
-          providerRepositoryId,
-          providerBranch,
-          providerSilentMode,
-          providerRootDirectory,
-          specification,
-        ),
+      async ({ siteId, name, framework, buildRuntime, enabled, logging, timeout, installCommand, buildCommand, outputDirectory, adapter, installationId, fallbackFile, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory, specification }) =>
+        parse(await (await getSitesClient()).create(siteId, name, framework as Framework, buildRuntime as BuildRuntime, enabled, logging, timeout, installCommand, buildCommand, outputDirectory, adapter as Adapter, installationId, fallbackFile, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory, specification)),
     ),
   );
 
 sites
   .command(`list-frameworks`)
-  .description(
-    `Get a list of all frameworks that are currently available on the server instance.`,
-  )
+  .description(`Get a list of all frameworks that are currently available on the server instance.`)
   .action(
-    actionRunner(async () => await (await getSitesClient()).listFrameworks()),
+    actionRunner(
+      async () => parse(await (await getSitesClient()).listFrameworks()),
+    ),
   );
 
 sites
@@ -184,65 +111,43 @@ sites
   .description(`List allowed site specifications for this instance.`)
   .action(
     actionRunner(
-      async () => await (await getSitesClient()).listSpecifications(),
+      async () => parse(await (await getSitesClient()).listSpecifications()),
     ),
   );
 
 sites
   .command(`list-templates`)
-  .description(
-    `List available site templates. You can use template details in [createSite](/docs/references/cloud/server-nodejs/sites#create) method.`,
-  )
-  .option(
-    `--frameworks [frameworks...]`,
-    `List of frameworks allowed for filtering site templates. Maximum of 100 frameworks are allowed.`,
-  )
-  .option(
-    `--use-cases [use-cases...]`,
-    `List of use cases allowed for filtering site templates. Maximum of 100 use cases are allowed.`,
-  )
-  .option(
-    `--limit <limit>`,
-    `Limit the number of templates returned in the response. Default limit is 25, and maximum limit is 5000.`,
-    parseInteger,
-  )
-  .option(
-    `--offset <offset>`,
-    `Offset the list of returned templates. Maximum offset is 5000.`,
-    parseInteger,
-  )
+  .description(`List available site templates. You can use template details in [createSite](/docs/references/cloud/server-nodejs/sites#create) method.`)
+  .option(`--frameworks [frameworks...]`, `List of frameworks allowed for filtering site templates. Maximum of 100 frameworks are allowed.`)
+  .option(`--use-cases [use-cases...]`, `List of use cases allowed for filtering site templates. Maximum of 100 use cases are allowed.`)
+  .option(`--limit <limit>`, `Limit the number of templates returned in the response. Default limit is 25, and maximum limit is 5000.`, parseInteger)
+  .option(`--offset <offset>`, `Offset the list of returned templates. Maximum offset is 5000.`, parseInteger)
   .action(
     actionRunner(
       async ({ frameworks, useCases, limit, offset }) =>
-        await (
-          await getSitesClient()
-        ).listTemplates(frameworks, useCases, limit, offset),
+        parse(await (await getSitesClient()).listTemplates(frameworks, useCases, limit, offset)),
     ),
   );
 
 sites
   .command(`get-template`)
-  .description(
-    `Get a site template using ID. You can use template details in [createSite](/docs/references/cloud/server-nodejs/sites#create) method.`,
-  )
+  .description(`Get a site template using ID. You can use template details in [createSite](/docs/references/cloud/server-nodejs/sites#create) method.`)
   .requiredOption(`--template-id <template-id>`, `Template ID.`)
   .action(
     actionRunner(
       async ({ templateId }) =>
-        await (await getSitesClient()).getTemplate(templateId),
+        parse(await (await getSitesClient()).getTemplate(templateId)),
     ),
   );
 
 sites
   .command(`list-usage`)
-  .description(
-    `Get usage metrics and statistics for all sites in the project. View statistics including total deployments, builds, logs, storage usage, and compute time. The response includes both current totals and historical data for each metric. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, defaults to 30 days.`,
-  )
+  .description(`Get usage metrics and statistics for all sites in the project. View statistics including total deployments, builds, logs, storage usage, and compute time. The response includes both current totals and historical data for each metric. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, defaults to 30 days.`)
   .option(`--range <range>`, `Date range.`)
   .action(
     actionRunner(
       async ({ range }) =>
-        await (await getSitesClient()).listUsage(range as UsageRange),
+        parse(await (await getSitesClient()).listUsage(range as UsageRange)),
     ),
   );
 
@@ -252,7 +157,8 @@ sites
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
   .action(
     actionRunner(
-      async ({ siteId }) => await (await getSitesClient()).get(siteId),
+      async ({ siteId }) =>
+        parse(await (await getSitesClient()).get(siteId)),
     ),
   );
 
@@ -274,96 +180,28 @@ sites
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
-  .option(
-    `--timeout <timeout>`,
-    `Maximum request time in seconds.`,
-    parseInteger,
-  )
+  .option(`--timeout <timeout>`, `Maximum request time in seconds.`, parseInteger)
   .option(`--install-command <install-command>`, `Install Command.`)
   .option(`--build-command <build-command>`, `Build Command.`)
   .option(`--output-directory <output-directory>`, `Output Directory for site.`)
-  .option(
-    `--build-runtime <build-runtime>`,
-    `Runtime to use during build step.`,
-  )
-  .option(
-    `--adapter <adapter>`,
-    `Framework adapter defining rendering strategy. Allowed values are: static, ssr`,
-  )
-  .option(
-    `--fallback-file <fallback-file>`,
-    `Fallback file for single page application sites.`,
-  )
-  .option(
-    `--installation-id <installation-id>`,
-    `Appwrite Installation ID for VCS (Version Control System) deployment.`,
-  )
-  .option(
-    `--provider-repository-id <provider-repository-id>`,
-    `Repository ID of the repo linked to the site.`,
-  )
-  .option(
-    `--provider-branch <provider-branch>`,
-    `Production branch for the repo linked to the site.`,
-  )
+  .option(`--build-runtime <build-runtime>`, `Runtime to use during build step.`)
+  .option(`--adapter <adapter>`, `Framework adapter defining rendering strategy. Allowed values are: static, ssr`)
+  .option(`--fallback-file <fallback-file>`, `Fallback file for single page application sites.`)
+  .option(`--installation-id <installation-id>`, `Appwrite Installation ID for VCS (Version Control System) deployment.`)
+  .option(`--provider-repository-id <provider-repository-id>`, `Repository ID of the repo linked to the site.`)
+  .option(`--provider-branch <provider-branch>`, `Production branch for the repo linked to the site.`)
   .option(
     `--provider-silent-mode [value]`,
     `Is the VCS (Version Control System) connection in silent mode for the repo linked to the site? In silent mode, comments will not be made on commits and pull requests.`,
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
-  .option(
-    `--provider-root-directory <provider-root-directory>`,
-    `Path to site code in the linked repo.`,
-  )
-  .option(
-    `--specification <specification>`,
-    `Framework specification for the site and builds.`,
-  )
+  .option(`--provider-root-directory <provider-root-directory>`, `Path to site code in the linked repo.`)
+  .option(`--specification <specification>`, `Framework specification for the site and builds.`)
   .action(
     actionRunner(
-      async ({
-        siteId,
-        name,
-        framework,
-        enabled,
-        logging,
-        timeout,
-        installCommand,
-        buildCommand,
-        outputDirectory,
-        buildRuntime,
-        adapter,
-        fallbackFile,
-        installationId,
-        providerRepositoryId,
-        providerBranch,
-        providerSilentMode,
-        providerRootDirectory,
-        specification,
-      }) =>
-        await (
-          await getSitesClient()
-        ).update(
-          siteId,
-          name,
-          framework,
-          enabled,
-          logging,
-          timeout,
-          installCommand,
-          buildCommand,
-          outputDirectory,
-          buildRuntime,
-          adapter,
-          fallbackFile,
-          installationId,
-          providerRepositoryId,
-          providerBranch,
-          providerSilentMode,
-          providerRootDirectory,
-          specification,
-        ),
+      async ({ siteId, name, framework, enabled, logging, timeout, installCommand, buildCommand, outputDirectory, buildRuntime, adapter, fallbackFile, installationId, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory, specification }) =>
+        parse(await (await getSitesClient()).update(siteId, name, framework as Framework, enabled, logging, timeout, installCommand, buildCommand, outputDirectory, buildRuntime as BuildRuntime, adapter as Adapter, fallbackFile, installationId, providerRepositoryId, providerBranch, providerSilentMode, providerRootDirectory, specification)),
     ),
   );
 
@@ -373,40 +211,29 @@ sites
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
   .action(
     actionRunner(
-      async ({ siteId }) => await (await getSitesClient()).delete(siteId),
+      async ({ siteId }) =>
+        parse(await (await getSitesClient()).delete(siteId)),
     ),
   );
 
 sites
   .command(`update-site-deployment`)
-  .description(
-    `Update the site active deployment. Use this endpoint to switch the code deployment that should be used when visitor opens your site.`,
-  )
+  .description(`Update the site active deployment. Use this endpoint to switch the code deployment that should be used when visitor opens your site.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
   .requiredOption(`--deployment-id <deployment-id>`, `Deployment ID.`)
   .action(
     actionRunner(
       async ({ siteId, deploymentId }) =>
-        await (
-          await getSitesClient()
-        ).updateSiteDeployment(siteId, deploymentId),
+        parse(await (await getSitesClient()).updateSiteDeployment(siteId, deploymentId)),
     ),
   );
 
 sites
   .command(`list-deployments`)
-  .description(
-    `Get a list of all the site's code deployments. You can use the query params to filter your results.`,
-  )
+  .description(`Get a list of all the site's code deployments. You can use the query params to filter your results.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
-  .option(
-    `--queries [queries...]`,
-    `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: buildSize, sourceSize, totalSize, buildDuration, status, activate, type`,
-  )
-  .option(
-    `--search <search>`,
-    `Search term to filter your list results. Max length: 256 chars.`,
-  )
+  .option(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: buildSize, sourceSize, totalSize, buildDuration, status, activate, type`)
+  .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
   .option(
     `--total [value]`,
     `When set to false, the total count returned will be 0 and will not be calculated.`,
@@ -416,94 +243,49 @@ sites
   .action(
     actionRunner(
       async ({ siteId, queries, search, total }) =>
-        await (
-          await getSitesClient()
-        ).listDeployments(siteId, queries, search, total),
+        parse(await (await getSitesClient()).listDeployments(siteId, queries, search, total)),
     ),
   );
 
 sites
   .command(`create-deployment`)
-  .description(
-    `Create a new site code deployment. Use this endpoint to upload a new version of your site code. To activate your newly uploaded code, you'll need to update the site's deployment to use your new deployment ID.`,
-  )
+  .description(`Create a new site code deployment. Use this endpoint to upload a new version of your site code. To activate your newly uploaded code, you'll need to update the site's deployment to use your new deployment ID.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
+  .requiredOption(`--code <code>`, `Gzip file with your code package. When used with the Appwrite CLI, pass the path to your code directory, and the CLI will automatically package your code. Use a path that is within the current directory.`)
+  .requiredOption(`--activate <activate>`, `Automatically activate the deployment when it is finished building.`, parseBool)
   .option(`--install-command <install-command>`, `Install Commands.`)
   .option(`--build-command <build-command>`, `Build Commands.`)
   .option(`--output-directory <output-directory>`, `Output Directory.`)
-  .requiredOption(
-    `--code <code>`,
-    `Gzip file with your code package. When used with the Appwrite CLI, pass the path to your code directory, and the CLI will automatically package your code. Use a path that is within the current directory.`,
-  )
-  .requiredOption(
-    `--activate <activate>`,
-    `Automatically activate the deployment when it is finished building.`,
-    parseBool,
-  )
   .action(
     actionRunner(
-      async ({
-        siteId,
-        installCommand,
-        buildCommand,
-        outputDirectory,
-        code,
-        activate,
-      }) =>
-        await (
-          await getSitesClient()
-        ).createDeployment(
-          siteId,
-          installCommand,
-          buildCommand,
-          outputDirectory,
-          code,
-          activate,
-        ),
+      async ({ siteId, code, activate, installCommand, buildCommand, outputDirectory }) =>
+        parse(await (await getSitesClient()).createDeployment(siteId, code, activate, installCommand, buildCommand, outputDirectory)),
     ),
   );
 
 sites
   .command(`create-duplicate-deployment`)
-  .description(
-    `Create a new build for an existing site deployment. This endpoint allows you to rebuild a deployment with the updated site configuration, including its commands and output directory if they have been modified. The build process will be queued and executed asynchronously. The original deployment's code will be preserved and used for the new build.`,
-  )
+  .description(`Create a new build for an existing site deployment. This endpoint allows you to rebuild a deployment with the updated site configuration, including its commands and output directory if they have been modified. The build process will be queued and executed asynchronously. The original deployment's code will be preserved and used for the new build.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
   .requiredOption(`--deployment-id <deployment-id>`, `Deployment ID.`)
   .action(
     actionRunner(
       async ({ siteId, deploymentId }) =>
-        await (
-          await getSitesClient()
-        ).createDuplicateDeployment(siteId, deploymentId),
+        parse(await (await getSitesClient()).createDuplicateDeployment(siteId, deploymentId)),
     ),
   );
 
 sites
   .command(`create-template-deployment`)
-  .description(
-    `Create a deployment based on a template.
+  .description(`Create a deployment based on a template.
 
-Use this endpoint with combination of [listTemplates](https://appwrite.io/docs/products/sites/templates) to find the template details.`,
-  )
+Use this endpoint with combination of [listTemplates](https://appwrite.io/docs/products/sites/templates) to find the template details.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
-  .requiredOption(
-    `--repository <repository>`,
-    `Repository name of the template.`,
-  )
+  .requiredOption(`--repository <repository>`, `Repository name of the template.`)
   .requiredOption(`--owner <owner>`, `The name of the owner of the template.`)
-  .requiredOption(
-    `--root-directory <root-directory>`,
-    `Path to site code in the template repo.`,
-  )
-  .requiredOption(
-    `--type <type>`,
-    `Type for the reference provided. Can be commit, branch, or tag`,
-  )
-  .requiredOption(
-    `--reference <reference>`,
-    `Reference value, can be a commit hash, branch name, or release tag`,
-  )
+  .requiredOption(`--root-directory <root-directory>`, `Path to site code in the template repo.`)
+  .requiredOption(`--type <type>`, `Type for the reference provided. Can be commit, branch, or tag`)
+  .requiredOption(`--reference <reference>`, `Reference value, can be a commit hash, branch name, or release tag`)
   .option(
     `--activate [value]`,
     `Automatically activate the deployment when it is finished building.`,
@@ -512,45 +294,19 @@ Use this endpoint with combination of [listTemplates](https://appwrite.io/docs/p
   )
   .action(
     actionRunner(
-      async ({
-        siteId,
-        repository,
-        owner,
-        rootDirectory,
-        xType,
-        reference,
-        activate,
-      }) =>
-        await (
-          await getSitesClient()
-        ).createTemplateDeployment(
-          siteId,
-          repository,
-          owner,
-          rootDirectory,
-          xType as TemplateReferenceType,
-          reference,
-          activate,
-        ),
+      async ({ siteId, repository, owner, rootDirectory, type, reference, activate }) =>
+        parse(await (await getSitesClient()).createTemplateDeployment(siteId, repository, owner, rootDirectory, type as TemplateReferenceType, reference, activate)),
     ),
   );
 
 sites
   .command(`create-vcs-deployment`)
-  .description(
-    `Create a deployment when a site is connected to VCS.
+  .description(`Create a deployment when a site is connected to VCS.
 
-This endpoint lets you create deployment from a branch, commit, or a tag.`,
-  )
+This endpoint lets you create deployment from a branch, commit, or a tag.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
-  .requiredOption(
-    `--type <type>`,
-    `Type of reference passed. Allowed values are: branch, commit`,
-  )
-  .requiredOption(
-    `--reference <reference>`,
-    `VCS reference to create deployment from. Depending on type this can be: branch name, commit hash`,
-  )
+  .requiredOption(`--type <type>`, `Type of reference passed. Allowed values are: branch, commit`)
+  .requiredOption(`--reference <reference>`, `VCS reference to create deployment from. Depending on type this can be: branch name, commit hash`)
   .option(
     `--activate [value]`,
     `Automatically activate the deployment when it is finished building.`,
@@ -559,15 +315,8 @@ This endpoint lets you create deployment from a branch, commit, or a tag.`,
   )
   .action(
     actionRunner(
-      async ({ siteId, xType, reference, activate }) =>
-        await (
-          await getSitesClient()
-        ).createVcsDeployment(
-          siteId,
-          xType as VCSReferenceType,
-          reference,
-          activate,
-        ),
+      async ({ siteId, type, reference, activate }) =>
+        parse(await (await getSitesClient()).createVcsDeployment(siteId, type as VCSReferenceType, reference, activate)),
     ),
   );
 
@@ -579,7 +328,7 @@ sites
   .action(
     actionRunner(
       async ({ siteId, deploymentId }) =>
-        await (await getSitesClient()).getDeployment(siteId, deploymentId),
+        parse(await (await getSitesClient()).getDeployment(siteId, deploymentId)),
     ),
   );
 
@@ -591,60 +340,46 @@ sites
   .action(
     actionRunner(
       async ({ siteId, deploymentId }) =>
-        await (await getSitesClient()).deleteDeployment(siteId, deploymentId),
+        parse(await (await getSitesClient()).deleteDeployment(siteId, deploymentId)),
     ),
   );
 
 sites
   .command(`get-deployment-download`)
-  .description(
-    `Get a site deployment content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.`,
-  )
+  .description(`Get a site deployment content by its unique ID. The endpoint response return with a 'Content-Disposition: attachment' header that tells the browser to start downloading the file to user downloads directory.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
   .requiredOption(`--deployment-id <deployment-id>`, `Deployment ID.`)
-  .option(
-    `--type <type>`,
-    `Deployment file to download. Can be: "source", "output".`,
-  )
+  .option(`--type <type>`, `Deployment file to download. Can be: "source", "output".`)
+  .requiredOption(`--destination <destination>`, `Path to save the file to.`)
   .action(
     actionRunner(
-      async ({ siteId, deploymentId, xType }) =>
-        await (
-          await getSitesClient()
-        ).getDeploymentDownload(
-          siteId,
-          deploymentId,
-          xType as DeploymentDownloadType,
-        ),
+      async ({ siteId, deploymentId, type, destination }) => {
+        const url = await (await getSitesClient()).getDeploymentDownload(siteId, deploymentId, type as DeploymentDownloadType);
+        const response = await fetch(url);
+        const buffer = Buffer.from(await response.arrayBuffer());
+        fs.writeFileSync(destination, buffer);
+        success(`File saved to ${destination}`);
+      },
     ),
   );
 
 sites
   .command(`update-deployment-status`)
-  .description(
-    `Cancel an ongoing site deployment build. If the build is already in progress, it will be stopped and marked as canceled. If the build hasn't started yet, it will be marked as canceled without executing. You cannot cancel builds that have already completed (status 'ready') or failed. The response includes the final build status and details.`,
-  )
+  .description(`Cancel an ongoing site deployment build. If the build is already in progress, it will be stopped and marked as canceled. If the build hasn't started yet, it will be marked as canceled without executing. You cannot cancel builds that have already completed (status 'ready') or failed. The response includes the final build status and details.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
   .requiredOption(`--deployment-id <deployment-id>`, `Deployment ID.`)
   .action(
     actionRunner(
       async ({ siteId, deploymentId }) =>
-        await (
-          await getSitesClient()
-        ).updateDeploymentStatus(siteId, deploymentId),
+        parse(await (await getSitesClient()).updateDeploymentStatus(siteId, deploymentId)),
     ),
   );
 
 sites
   .command(`list-logs`)
-  .description(
-    `Get a list of all site logs. You can use the query params to filter your results.`,
-  )
+  .description(`Get a list of all site logs. You can use the query params to filter your results.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
-  .option(
-    `--queries [queries...]`,
-    `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: trigger, status, responseStatusCode, duration, requestMethod, requestPath, deploymentId`,
-  )
+  .option(`--queries [queries...]`, `Array of query strings generated using the Query class provided by the SDK. [Learn more about queries](https://appwrite.io/docs/queries). Maximum of 100 queries are allowed, each 4096 characters long. You may filter on the following attributes: trigger, status, responseStatusCode, duration, requestMethod, requestPath, deploymentId`)
   .option(
     `--total [value]`,
     `When set to false, the total count returned will be 0 and will not be calculated.`,
@@ -654,7 +389,7 @@ sites
   .action(
     actionRunner(
       async ({ siteId, queries, total }) =>
-        await (await getSitesClient()).listLogs(siteId, queries, total),
+        parse(await (await getSitesClient()).listLogs(siteId, queries, total)),
     ),
   );
 
@@ -666,7 +401,7 @@ sites
   .action(
     actionRunner(
       async ({ siteId, logId }) =>
-        await (await getSitesClient()).getLog(siteId, logId),
+        parse(await (await getSitesClient()).getLog(siteId, logId)),
     ),
   );
 
@@ -678,21 +413,19 @@ sites
   .action(
     actionRunner(
       async ({ siteId, logId }) =>
-        await (await getSitesClient()).deleteLog(siteId, logId),
+        parse(await (await getSitesClient()).deleteLog(siteId, logId)),
     ),
   );
 
 sites
   .command(`get-usage`)
-  .description(
-    `Get usage metrics and statistics for a for a specific site. View statistics including total deployments, builds, executions, storage usage, and compute time. The response includes both current totals and historical data for each metric. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, defaults to 30 days.`,
-  )
+  .description(`Get usage metrics and statistics for a for a specific site. View statistics including total deployments, builds, executions, storage usage, and compute time. The response includes both current totals and historical data for each metric. Use the optional range parameter to specify the time window for historical data: 24h (last 24 hours), 30d (last 30 days), or 90d (last 90 days). If not specified, defaults to 30 days.`)
   .requiredOption(`--site-id <site-id>`, `Site ID.`)
   .option(`--range <range>`, `Date range.`)
   .action(
     actionRunner(
       async ({ siteId, range }) =>
-        await (await getSitesClient()).getUsage(siteId, range as UsageRange),
+        parse(await (await getSitesClient()).getUsage(siteId, range as UsageRange)),
     ),
   );
 
@@ -703,15 +436,13 @@ sites
   .action(
     actionRunner(
       async ({ siteId }) =>
-        await (await getSitesClient()).listVariables(siteId),
+        parse(await (await getSitesClient()).listVariables(siteId)),
     ),
   );
 
 sites
   .command(`create-variable`)
-  .description(
-    `Create a new site variable. These variables can be accessed during build and runtime (server-side rendering) as environment variables.`,
-  )
+  .description(`Create a new site variable. These variables can be accessed during build and runtime (server-side rendering) as environment variables.`)
   .requiredOption(`--site-id <site-id>`, `Site unique ID.`)
   .requiredOption(`--key <key>`, `Variable key. Max length: 255 chars.`)
   .requiredOption(`--value <value>`, `Variable value. Max length: 8192 chars.`)
@@ -724,9 +455,7 @@ sites
   .action(
     actionRunner(
       async ({ siteId, key, value, secret }) =>
-        await (
-          await getSitesClient()
-        ).createVariable(siteId, key, value, secret),
+        parse(await (await getSitesClient()).createVariable(siteId, key, value, secret)),
     ),
   );
 
@@ -738,7 +467,7 @@ sites
   .action(
     actionRunner(
       async ({ siteId, variableId }) =>
-        await (await getSitesClient()).getVariable(siteId, variableId),
+        parse(await (await getSitesClient()).getVariable(siteId, variableId)),
     ),
   );
 
@@ -758,9 +487,7 @@ sites
   .action(
     actionRunner(
       async ({ siteId, variableId, key, value, secret }) =>
-        await (
-          await getSitesClient()
-        ).updateVariable(siteId, variableId, key, value, secret),
+        parse(await (await getSitesClient()).updateVariable(siteId, variableId, key, value, secret)),
     ),
   );
 
@@ -772,6 +499,7 @@ sites
   .action(
     actionRunner(
       async ({ siteId, variableId }) =>
-        await (await getSitesClient()).deleteVariable(siteId, variableId),
+        parse(await (await getSitesClient()).deleteVariable(siteId, variableId)),
     ),
   );
+