chore: bump SDK version to 21.1.0

TorstenDittmann · TorstenDittmann · commit 32aad853d683 · 2026-05-21T22:36:24.000+04:00
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 # Appwrite Command Line SDK
 
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-cli.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.9.4-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.9.5-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
@@ -29,7 +29,7 @@ Once the installation is complete, you can verify the install using
 
 ```sh
 $ appwrite -v
-21.0.0
+21.1.0
 ```
 
 ### Install using prebuilt binaries
@@ -83,7 +83,7 @@ $ scoop install https://raw.githubusercontent.com/appwrite/sdk-for-cli/master/sc
 Once the installation completes, you can verify your install using
 ```
 $ appwrite -v
-21.0.0
+21.1.0
 ```
 
 ## Getting Started 
diff --git a/cli.ts b/cli.ts
@@ -45,14 +45,17 @@ import { locale } from './lib/commands/services/locale.js';
 import { messaging } from './lib/commands/services/messaging.js';
 import { migrations } from './lib/commands/services/migrations.js';
 import { organizations } from './lib/commands/services/organizations.js';
+import { presences } from './lib/commands/services/presences.js';
 import { project } from './lib/commands/services/project.js';
 import { projects } from './lib/commands/services/projects.js';
 import { proxy } from './lib/commands/services/proxy.js';
+import { advisor } from './lib/commands/services/advisor.js';
 import { sites } from './lib/commands/services/sites.js';
 import { storage } from './lib/commands/services/storage.js';
 import { tablesDB } from './lib/commands/services/tables-db.js';
 import { teams } from './lib/commands/services/teams.js';
 import { tokens } from './lib/commands/services/tokens.js';
+import { usage } from './lib/commands/services/usage.js';
 import { users } from './lib/commands/services/users.js';
 import { vcs } from './lib/commands/services/vcs.js';
 import { webhooks } from './lib/commands/services/webhooks.js';
@@ -215,14 +218,17 @@ if (process.argv.includes('-v') || process.argv.includes('--version')) {
             .addCommand(messaging)
             .addCommand(migrations)
             .addCommand(organizations)
+            .addCommand(presences)
             .addCommand(project)
             .addCommand(projects)
             .addCommand(proxy)
+            .addCommand(advisor)
             .addCommand(sites)
             .addCommand(storage)
             .addCommand(tablesDB)
             .addCommand(teams)
             .addCommand(tokens)
+            .addCommand(usage)
             .addCommand(users)
             .addCommand(vcs)
             .addCommand(webhooks)
diff --git a/docs/examples/advisor/delete-report.md b/docs/examples/advisor/delete-report.md
@@ -0,0 +1,4 @@
+```bash
+appwrite advisor delete-report \
+    --report-id <REPORT_ID>
+```
diff --git a/docs/examples/advisor/get-insight.md b/docs/examples/advisor/get-insight.md
@@ -0,0 +1,5 @@
+```bash
+appwrite advisor get-insight \
+    --report-id <REPORT_ID> \
+    --insight-id <INSIGHT_ID>
+```
diff --git a/docs/examples/advisor/get-report.md b/docs/examples/advisor/get-report.md
@@ -0,0 +1,4 @@
+```bash
+appwrite advisor get-report \
+    --report-id <REPORT_ID>
+```
diff --git a/docs/examples/advisor/list-insights.md b/docs/examples/advisor/list-insights.md
@@ -0,0 +1,5 @@
+```bash
+appwrite advisor list-insights \
+    --report-id <REPORT_ID> \
+    --limit 25
+```
diff --git a/docs/examples/advisor/list-reports.md b/docs/examples/advisor/list-reports.md
@@ -0,0 +1,4 @@
+```bash
+appwrite advisor list-reports \
+    --limit 25
+```
diff --git a/docs/examples/presences/delete.md b/docs/examples/presences/delete.md
@@ -0,0 +1,4 @@
+```bash
+appwrite presences delete \
+    --presence-id <PRESENCE_ID>
+```
diff --git a/docs/examples/presences/get-usage.md b/docs/examples/presences/get-usage.md
@@ -0,0 +1,3 @@
+```bash
+appwrite presences get-usage
+```
diff --git a/docs/examples/presences/get.md b/docs/examples/presences/get.md
@@ -0,0 +1,4 @@
+```bash
+appwrite presences get \
+    --presence-id <PRESENCE_ID>
+```
diff --git a/docs/examples/presences/list.md b/docs/examples/presences/list.md
@@ -0,0 +1,4 @@
+```bash
+appwrite presences list \
+    --limit 25
+```
diff --git a/docs/examples/presences/update-presence.md b/docs/examples/presences/update-presence.md
@@ -0,0 +1,5 @@
+```bash
+appwrite presences update-presence \
+    --presence-id <PRESENCE_ID> \
+    --user-id <USER_ID>
+```
diff --git a/docs/examples/presences/upsert.md b/docs/examples/presences/upsert.md
@@ -0,0 +1,6 @@
+```bash
+appwrite presences upsert \
+    --presence-id <PRESENCE_ID> \
+    --user-id <USER_ID> \
+    --status <STATUS>
+```
diff --git a/docs/examples/project/get.md b/docs/examples/project/get.md
@@ -0,0 +1,3 @@
+```bash
+appwrite project get
+```
diff --git a/docs/examples/project/update-deny-aliased-email-policy.md b/docs/examples/project/update-deny-aliased-email-policy.md
@@ -0,0 +1,4 @@
+```bash
+appwrite project update-deny-aliased-email-policy \
+    --enabled false
+```
diff --git a/docs/examples/project/update-deny-canonical-email-policy.md b/docs/examples/project/update-deny-canonical-email-policy.md
diff --git a/docs/examples/projects/get.md b/docs/examples/projects/get.md
diff --git a/docs/examples/usage/list-events.md b/docs/examples/usage/list-events.md
@@ -0,0 +1,4 @@
+```bash
+appwrite usage list-events \
+    --limit 25
+```
diff --git a/docs/examples/usage/list-gauges.md b/docs/examples/usage/list-gauges.md
@@ -0,0 +1,4 @@
+```bash
+appwrite usage list-gauges \
+    --limit 25
+```
diff --git a/install.ps1 b/install.ps1
@@ -13,8 +13,8 @@
 # You can use "View source" of this page to see the full script.
 
 # REPO
-$GITHUB_x64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/21.0.0/appwrite-cli-win-x64.exe"
-$GITHUB_arm64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/21.0.0/appwrite-cli-win-arm64.exe"
+$GITHUB_x64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/21.1.0/appwrite-cli-win-x64.exe"
+$GITHUB_arm64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/21.1.0/appwrite-cli-win-arm64.exe"
 
 $APPWRITE_BINARY_NAME = "appwrite.exe"
 
diff --git a/install.sh b/install.sh
@@ -120,7 +120,7 @@ verifyMacOSCodeSignature() {
 downloadBinary() {
     echo "[2/5] Downloading executable for $OS ($ARCH) ..."
 
-    GITHUB_LATEST_VERSION="21.0.0"
+    GITHUB_LATEST_VERSION="21.1.0"
     GITHUB_FILE="appwrite-cli-${OS}-${ARCH}"
     GITHUB_URL="https://github.com/$GITHUB_REPOSITORY_NAME/releases/download/$GITHUB_LATEST_VERSION/$GITHUB_FILE"
 
diff --git a/lib/commands/services/advisor.ts b/lib/commands/services/advisor.ts
@@ -0,0 +1,129 @@
+import { Command } from "commander";
+import {
+  buildQueries,
+  collectQueryValue,
+  parseDeprecatedWhereQuery,
+  parseFilterQuery,
+} from "../utils/query.js";
+import { sdkForProject } from "../../sdks.js";
+import {
+  actionRunner,
+  commandDescriptions,
+  success,
+  parse,
+  parseBool,
+  parseInteger,
+} from "../../parser.js";
+import { Advisor } from "@appwrite.io/console";
+
+let advisorClient: Advisor | null = null;
+
+const getAdvisorClient = async (): Promise<Advisor> => {
+  if (!advisorClient) {
+    const sdkClient = await sdkForProject();
+    advisorClient = new Advisor(sdkClient);
+  }
+  return advisorClient;
+};
+
+export const advisor = new Command("advisor")
+  .description(commandDescriptions["advisor"] ?? "")
+  .configureHelp({
+    helpWidth: process.stdout.columns || 80,
+  });
+
+const advisorListReportsCommand = advisor
+  .command(`list-reports`)
+  .description(`Get a list of all the project's analyzer reports. You can use the query params to filter your results.
+`)
+  .option(`--queries [queries...]`, `Raw Appwrite JSON query strings (legacy). Use this for advanced queries or automation; for common filtering, sorting, and pagination prefer --filter, --sort-asc, --sort-desc, --limit, and --offset. When mixed, raw --queries are sent before generated flag 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: appId, type, targetType, target, analyzedAt`)
+  .option(
+    `--total [value]`,
+    `When set to false, the total count returned will be 0 and will not be calculated.`,
+    (value: string | undefined) =>
+      value === undefined ? true : parseBool(value),
+  )
+  .option(`--filter <expression>`, `Filter using a simple comparison expression. Repeat for multiple filters. Supports field=value, field!=value, field>value, field>=value, field<value, and field<=value.`, (value: string, previous: string[] | undefined) => collectQueryValue(parseFilterQuery(value), previous))
+  .option(`--where <expression>`, `Deprecated. Use --filter instead. Filter using a simple comparison expression. Repeat for multiple filters.`, (value: string, previous: string[] | undefined) => collectQueryValue(parseDeprecatedWhereQuery(value), previous))
+  .option(`--sort-asc <attribute>`, `Sort results by an attribute in ascending order. Repeat for multiple sort fields.`, (value: string, previous: string[] | undefined) => collectQueryValue(value, previous))
+  .option(`--sort-desc <attribute>`, `Sort results by an attribute in descending order. Repeat for multiple sort fields.`, (value: string, previous: string[] | undefined) => collectQueryValue(value, previous))
+  .option(`--limit <limit>`, `Maximum number of results to return.`, parseInteger)
+  .option(`--offset <offset>`, `Number of results to skip.`, parseInteger)
+  .option(`--cursor-after <id>`, `Return results after this cursor ID.`)
+  .option(`--cursor-before <id>`, `Return results before this cursor ID.`)
+  .action(
+    actionRunner(
+      async ({ queries, total, filter, where, sortAsc, sortDesc, cursorAfter, cursorBefore, limit, offset }) =>
+        parse(await (await getAdvisorClient()).listReports(buildQueries({ queries, filter, where, sortAsc, sortDesc, cursorAfter, cursorBefore, limit, offset }), total)),
+    ),
+  );
+
+
+const advisorGetReportCommand = advisor
+  .command(`get-report`)
+  .description(`Get an analyzer report by its unique ID. The response includes the report's metadata and the nested insights it produced.
+`)
+  .requiredOption(`--report-id <report-id>`, `Report ID.`)
+  .action(
+    actionRunner(
+      async ({ reportId }) =>
+        parse(await (await getAdvisorClient()).getReport(reportId)),
+    ),
+  );
+
+
+const advisorDeleteReportCommand = advisor
+  .command(`delete-report`)
+  .description(`Delete an analyzer report by its unique ID. Nested insights and CTA metadata are removed asynchronously by the deletes worker.
+`)
+  .requiredOption(`--report-id <report-id>`, `Report ID.`)
+  .action(
+    actionRunner(
+      async ({ reportId }) =>
+        parse(await (await getAdvisorClient()).deleteReport(reportId)),
+    ),
+  );
+
+
+const advisorListInsightsCommand = advisor
+  .command(`list-insights`)
+  .description(`List the insights produced under a single analyzer report. You can use the query params to filter your results further.
+`)
+  .requiredOption(`--report-id <report-id>`, `Parent report ID.`)
+  .option(`--queries [queries...]`, `Raw Appwrite JSON query strings (legacy). Use this for advanced queries or automation; for common filtering, sorting, and pagination prefer --filter, --sort-asc, --sort-desc, --limit, and --offset. When mixed, raw --queries are sent before generated flag 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: type, severity, status, resourceType, resourceId, parentResourceType, parentResourceId, analyzedAt, dismissedAt, dismissedBy`)
+  .option(
+    `--total [value]`,
+    `When set to false, the total count returned will be 0 and will not be calculated.`,
+    (value: string | undefined) =>
+      value === undefined ? true : parseBool(value),
+  )
+  .option(`--filter <expression>`, `Filter using a simple comparison expression. Repeat for multiple filters. Supports field=value, field!=value, field>value, field>=value, field<value, and field<=value.`, (value: string, previous: string[] | undefined) => collectQueryValue(parseFilterQuery(value), previous))
+  .option(`--where <expression>`, `Deprecated. Use --filter instead. Filter using a simple comparison expression. Repeat for multiple filters.`, (value: string, previous: string[] | undefined) => collectQueryValue(parseDeprecatedWhereQuery(value), previous))
+  .option(`--sort-asc <attribute>`, `Sort results by an attribute in ascending order. Repeat for multiple sort fields.`, (value: string, previous: string[] | undefined) => collectQueryValue(value, previous))
+  .option(`--sort-desc <attribute>`, `Sort results by an attribute in descending order. Repeat for multiple sort fields.`, (value: string, previous: string[] | undefined) => collectQueryValue(value, previous))
+  .option(`--limit <limit>`, `Maximum number of results to return.`, parseInteger)
+  .option(`--offset <offset>`, `Number of results to skip.`, parseInteger)
+  .option(`--cursor-after <id>`, `Return results after this cursor ID.`)
+  .option(`--cursor-before <id>`, `Return results before this cursor ID.`)
+  .action(
+    actionRunner(
+      async ({ reportId, queries, total, filter, where, sortAsc, sortDesc, cursorAfter, cursorBefore, limit, offset }) =>
+        parse(await (await getAdvisorClient()).listInsights(reportId, buildQueries({ queries, filter, where, sortAsc, sortDesc, cursorAfter, cursorBefore, limit, offset }), total)),
+    ),
+  );
+
+
+const advisorGetInsightCommand = advisor
+  .command(`get-insight`)
+  .description(`Get an insight by its unique ID, scoped to its parent report.
+`)
+  .requiredOption(`--report-id <report-id>`, `Parent report ID.`)
+  .requiredOption(`--insight-id <insight-id>`, `Insight ID.`)
+  .action(
+    actionRunner(
+      async ({ reportId, insightId }) =>
+        parse(await (await getAdvisorClient()).getInsight(reportId, insightId)),
+    ),
+  );
+
+
diff --git a/lib/commands/services/presences.ts b/lib/commands/services/presences.ts
diff --git a/lib/commands/services/project.ts b/lib/commands/services/project.ts
diff --git a/lib/commands/services/projects.ts b/lib/commands/services/projects.ts
diff --git a/lib/commands/services/usage.ts b/lib/commands/services/usage.ts
diff --git a/lib/constants.ts b/lib/constants.ts
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
diff --git a/scoop/appwrite.config.json b/scoop/appwrite.config.json

-Original file line number
+Diff line change
@@ @@ -0,0 +1,4 @@ @@
 +```bash
 +appwrite advisor delete-report \
 +    --report-id <REPORT_ID>
 +```
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	+```bash
	`2`	`+appwrite presences get-usage`
	`3`	+```