Skip to content

feat: Command Line SDK update for version 21.0.1#322

Merged
abnegate merged 4 commits into
masterfrom
dev
May 24, 2026
Merged

feat: Command Line SDK update for version 21.0.1#322
abnegate merged 4 commits into
masterfrom
dev

Conversation

@abnegate
Copy link
Copy Markdown
Member

@abnegate abnegate commented May 24, 2026

This PR refreshes the generated CLI release output using appwrite/sdk-generator 1.31.6 and bumps the CLI release metadata to 21.0.1.

Final diff is intentionally limited to generated output that is compatible with the currently published @appwrite.io/console@13.0.0 dependency:

  • update the README API badge to Appwrite 1.9.5 while keeping compatibility on 1.9.x
  • map generated Kotlin integer attributes to Long in the CLI type-generation helper
  • bump CLI release metadata from 21.0.0 to 21.0.1 in package.json, package-lock.json, lib/constants.ts, README examples, and the changelog

The Sites config resource key is already present on both master and this generated branch, so it does not produce an additional CLI repo diff.

Validation:

  • npm ci
  • npm run build
  • node dist/cli.cjs -v
  • git diff --check

Note: npm run lint currently reports existing generated-code violations across lib/commands/* and is not the required PR validation check.

Copilot AI review requested due to automatic review settings May 24, 2026 03:07
@greptile-apps
Copy link
Copy Markdown

greptile-apps Bot commented May 24, 2026

Greptile Summary

This is a patch-level version bump (21.0.0 → 21.0.1) that updates the API badge to 1.9.5 and fixes Kotlin type generation to emit Long instead of Int for Appwrite integer attributes, aligning with the 64-bit integer storage used by the Android/Kotlin SDK.

  • lib/type-generation/languages/kotlin.ts: Single-line fix changing AttributeType.INTEGER mapping from "Int" to "Long", which prevents silent value truncation for integers exceeding 32-bit range in generated Kotlin data classes.
  • Version files (package.json, package-lock.json, lib/constants.ts, README.md): All version references consistently updated to 21.0.1 with no dependency changes.

Confidence Score: 5/5

Safe to merge — changes are limited to a version bump and a single well-scoped type-generation fix.

All six changed files are consistent version-bump housekeeping or the targeted Int → Long fix in Kotlin type generation. The Long change is correct: Appwrite stores integers as 64-bit values and the Android/Kotlin SDK models already use Long, so this brings the CLI type helper into alignment. No dependency tree changes, no logic changes beyond the single type mapping.

No files require special attention.

Important Files Changed

Filename Overview
lib/type-generation/languages/kotlin.ts Maps INTEGER attribute type from Int to Long to match 64-bit integer storage in Appwrite's Android/Kotlin SDK models.
lib/constants.ts Version constant bumped from 21.0.0 to 21.0.1, consistent with package.json and README.
package.json Package version bumped to 21.0.1; no dependency changes.
package-lock.json Lock file updated to reflect version 21.0.1; no dependency tree changes.
README.md API version badge updated to 1.9.5 and CLI version references updated to 21.0.1.
CHANGELOG.md New 21.0.1 changelog entry documents the Kotlin Long fix and Sites type-generation inclusion.

Reviews (3): Last reviewed commit: "chore: bump cli sdk release to 21.0.1" | Re-trigger Greptile

Comment thread lib/commands/services/organization.ts Outdated
Comment thread lib/commands/services/storage.ts Outdated
Comment thread lib/commands/services/storage.ts Outdated
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Appwrite Command Line SDK to align with Appwrite Console SDK @appwrite.io/console@13.0.0 and CLI version 21.0.0, adding new service command surfaces (compute/usage/presences/advisor/organization) and adjusting existing command groupings and docs examples.

Changes:

  • Added new CLI service command groups: compute, usage, presences, advisor, and organization, and wired them into cli.ts.
  • Restructured project/organization-related commands (moving some projects/organizations functionality under organization/project) and updated examples accordingly.
  • Updated Kotlin type generation mapping for integer attributes and refreshed README/API version badge text.

Reviewed changes

Copilot reviewed 87 out of 87 changed files in this pull request and generated 10 comments.

Show a summary per file
File Description
README.md Updates API version badge and compatibility text.
lib/type-generation/languages/kotlin.ts Maps integer attributes to Kotlin Long.
lib/commands/services/usage.ts Adds usage command group (list events/gauges).
lib/commands/services/storage.ts Updates bucket --maximum-file-size help text.
lib/commands/services/sites.ts Adds provider branch/path trigger options for sites.
lib/commands/services/projects.ts Removes several projects subcommands (re-org).
lib/commands/services/project.ts Adds project get; renames aliased email policy command; updates SMTP/template option help.
lib/commands/services/presences.ts Adds presences command group.
lib/commands/services/organizations.ts Removes organization key management subcommands (re-org).
lib/commands/services/organization.ts Adds organization command group (keys/projects).
lib/commands/services/functions.ts Adds provider branch/path trigger options for functions.
lib/commands/services/compute.ts Adds compute command group (databases management).
lib/commands/services/advisor.ts Adds advisor command group (reports/insights).
docs/examples/usage/list-gauges.md Adds example for usage list-gauges.
docs/examples/usage/list-events.md Adds example for usage list-events.
docs/examples/projects/create.md Removes outdated projects create example.
docs/examples/project/update-deny-canonical-email-policy.md Removes outdated canonical email policy example.
docs/examples/project/update-deny-aliased-email-policy.md Adds example for renamed aliased email policy command.
docs/examples/project/get.md Adds example for new project get.
docs/examples/presences/upsert.md Adds example for presences upsert.
docs/examples/presences/update-presence.md Adds example for presences update-presence.
docs/examples/presences/list.md Fixes example to use presences list.
docs/examples/presences/get.md Adds example for presences get.
docs/examples/presences/get-usage.md Adds example for presences get-usage.
docs/examples/presences/delete.md Adds example for presences delete.
docs/examples/organizations/list-keys.md Removes outdated organizations list-keys example.
docs/examples/organizations/get-key.md Removes outdated organizations get-key example.
docs/examples/organizations/delete-key.md Removes outdated organizations delete-key example.
docs/examples/organizations/create-key.md Removes outdated organizations create-key example.
docs/examples/organization/update-project.md Updates example to organization update-project.
docs/examples/organization/update-key.md Updates example to organization update-key.
docs/examples/organization/list-projects.md Adds example for organization list-projects.
docs/examples/organization/list-keys.md Adds example for organization list-keys.
docs/examples/organization/get-project.md Updates example to organization get-project.
docs/examples/organization/get-key.md Adds example for organization get-key.
docs/examples/organization/delete-project.md Adds example for organization delete-project.
docs/examples/organization/delete-key.md Adds example for organization delete-key.
docs/examples/organization/create-project.md Adds example for organization create-project.
docs/examples/organization/create-key.md Adds example for organization create-key.
docs/examples/compute/update-database.md Adds example for compute update-database.
docs/examples/compute/update-database-pooler.md Adds example for compute update-database-pooler.
docs/examples/compute/update-database-maintenance-window.md Adds example for compute update-database-maintenance-window.
docs/examples/compute/update-database-credentials.md Adds example for compute update-database-credentials.
docs/examples/compute/update-database-backup-storage.md Adds example for compute update-database-backup-storage.
docs/examples/compute/list-databases.md Adds example for compute list-databases.
docs/examples/compute/list-database-restorations.md Adds example for compute list-database-restorations.
docs/examples/compute/list-database-queries.md Adds example for compute list-database-queries.
docs/examples/compute/list-database-logs.md Adds example for compute list-database-logs.
docs/examples/compute/list-database-extensions.md Adds example for compute list-database-extensions.
docs/examples/compute/list-database-connections.md Adds example for compute list-database-connections.
docs/examples/compute/list-database-branches.md Adds example for compute list-database-branches.
docs/examples/compute/list-database-backups.md Adds example for compute list-database-backups.
docs/examples/compute/get-database.md Adds example for compute get-database.
docs/examples/compute/get-database-usage.md Adds example for compute get-database-usage.
docs/examples/compute/get-database-status.md Adds example for compute get-database-status.
docs/examples/compute/get-database-schema.md Adds example for compute get-database-schema.
docs/examples/compute/get-database-restoration.md Adds example for compute get-database-restoration.
docs/examples/compute/get-database-pooler.md Adds example for compute get-database-pooler.
docs/examples/compute/get-database-pitr-windows.md Adds example for compute get-database-pitr-windows.
docs/examples/compute/get-database-metrics.md Adds example for compute get-database-metrics.
docs/examples/compute/get-database-insights.md Adds example for compute get-database-insights.
docs/examples/compute/get-database-ha-status.md Adds example for compute get-database-ha-status.
docs/examples/compute/get-database-credentials.md Adds example for compute get-database-credentials.
docs/examples/compute/get-database-backup.md Adds example for compute get-database-backup.
docs/examples/compute/delete-database.md Adds example for compute delete-database.
docs/examples/compute/delete-database-extension.md Adds example for compute delete-database-extension.
docs/examples/compute/delete-database-connection.md Adds example for compute delete-database-connection.
docs/examples/compute/delete-database-branch.md Adds example for compute delete-database-branch.
docs/examples/compute/delete-database-backup.md Adds example for compute delete-database-backup.
docs/examples/compute/create-database.md Adds example for compute create-database.
docs/examples/compute/create-database-upgrade.md Adds example for compute create-database-upgrade.
docs/examples/compute/create-database-schema-preview.md Adds example for compute create-database-schema-preview.
docs/examples/compute/create-database-restoration.md Adds example for compute create-database-restoration.
docs/examples/compute/create-database-query-explanation.md Adds example for compute create-database-query-explanation.
docs/examples/compute/create-database-migration.md Adds example for compute create-database-migration.
docs/examples/compute/create-database-failover.md Adds example for compute create-database-failover.
docs/examples/compute/create-database-extension.md Adds example for compute create-database-extension.
docs/examples/compute/create-database-execution.md Adds example for compute create-database-execution.
docs/examples/compute/create-database-connection.md Adds example for compute create-database-connection.
docs/examples/compute/create-database-branch.md Adds example for compute create-database-branch.
docs/examples/compute/create-database-backup.md Adds example for compute create-database-backup.
docs/examples/advisor/list-reports.md Adds example for advisor list-reports.
docs/examples/advisor/list-insights.md Adds example for advisor list-insights.
docs/examples/advisor/get-report.md Adds example for advisor get-report.
docs/examples/advisor/get-insight.md Adds example for advisor get-insight.
docs/examples/advisor/delete-report.md Adds example for advisor delete-report.
cli.ts Registers newly added command groups with the CLI.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread lib/commands/services/usage.ts Outdated
Comment on lines +9 to +16
import {
actionRunner,
commandDescriptions,
success,
parse,
parseBool,
parseInteger,
} from "../../parser.js";
Comment thread lib/commands/services/presences.ts Outdated
Comment on lines +9 to +17
import {
actionRunner,
commandDescriptions,
success,
parse,
parseBool,
parseInteger,
parseJsonObject,
} from "../../parser.js";
Comment thread lib/commands/services/compute.ts Outdated
Comment on lines +9 to +17
import {
actionRunner,
commandDescriptions,
success,
parse,
parseBool,
parseInteger,
parseJsonObject,
} from "../../parser.js";
Comment thread lib/commands/services/advisor.ts Outdated
Comment on lines +9 to +16
import {
actionRunner,
commandDescriptions,
success,
parse,
parseBool,
parseInteger,
} from "../../parser.js";
Comment thread lib/commands/services/organization.ts Outdated
Comment on lines +9 to +16
import {
actionRunner,
commandDescriptions,
success,
parse,
parseBool,
parseInteger,
} from "../../parser.js";
Comment thread lib/commands/services/compute.ts Outdated
Comment on lines +194 to +197
value === undefined ? true : parseBool(value),
)
.option(`--metrics-trace-sample-rate <metrics-trace-sample-rate>`, `Fraction of queries to trace (0.0–1.0). Forwarded to the sidecar.`, parseInteger)
.option(`--metrics-slow-query-log-threshold-ms <metrics-slow-query-log-threshold-ms>`, `Threshold in ms above which queries are logged as slow. Forwarded to the sidecar.`, parseInteger)
Comment thread lib/commands/services/compute.ts Outdated
Comment on lines +145 to +147
.option(`--specification <specification>`, `Specification. Changes cpu, memory, and type based on specification config.`)
.option(`--cpu <cpu>`, `CPU cores to allocate (125-16000).`, parseInteger)
.option(`--memory <memory>`, `Memory in MB to allocate (128-65536).`, parseInteger)
Comment thread lib/commands/services/compute.ts Outdated
Comment on lines +36 to +39
const computeListDatabasesCommand = compute
.command(`list-databases`)
.description(` List all dedicated databases. Results support pagination.`)
.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.`)
Comment thread lib/commands/services/storage.ts Outdated
value === undefined ? true : parseBool(value),
)
.option(`--maximum-file-size <maximum-file-size>`, `Maximum file size allowed in bytes. Maximum allowed value is 5GB.`, parseInteger)
.option(`--maximum-file-size <maximum-file-size>`, `Maximum file size allowed in bytes. Maximum allowed value is 0B.`, parseInteger)
Comment thread lib/commands/services/storage.ts Outdated
value === undefined ? true : parseBool(value),
)
.option(`--maximum-file-size <maximum-file-size>`, `Maximum file size allowed in bytes. Maximum allowed value is 5GB.`, parseInteger)
.option(`--maximum-file-size <maximum-file-size>`, `Maximum file size allowed in bytes. Maximum allowed value is 0B.`, parseInteger)
@abnegate abnegate changed the title feat: Command Line SDK update for version 21.0.0 feat: Command Line SDK update for version 21.0.1 May 24, 2026
@abnegate abnegate merged commit 8325bec into master May 24, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants