appwrite-cli 13.6.1 → 14.0.0

package/lib/commands/generate.ts

@@ -25,6 +25,8 @@ export interface GenerateCommandOptions {
   output: string;
   language?: string;
   server?: ServerSideOverride;
+  appwriteImportSource?: string;
+  importExtension?: string;
 }
 
 const generateAction = async (
@@ -114,7 +116,10 @@ const generateAction = async (
   );
 
   try {
-    const result = await generator.generate(config);
+    const result = await generator.generate(config, {
+      appwriteImportSource: options.appwriteImportSource,
+      importExtension: options.importExtension,
+    });
     await generator.writeFiles(absoluteOutputDir, result);
 
     const generatedFiles = generator.getGeneratedFilePaths(result);
@@ -131,7 +136,7 @@ const generateAction = async (
       const firstEntity = entities?.[0];
       const dbId = firstEntity?.databaseId ?? "databaseId";
       const tableName = firstEntity?.name ?? "tableName";
-      const importExt = detectImportExtension();
+      const importExt = options.importExtension ?? detectImportExtension();
 
       console.log("");
       log(`Import the generated SDK in your project:`);
@@ -175,6 +180,14 @@ export const generate = new Command("generate")
     "Override server-side generation (auto|true|false)",
     "auto",
   )
+  .option(
+    "--appwrite-import-source <source>",
+    "Override Appwrite import source in generated files (e.g. node-appwrite, appwrite, @appwrite.io/console). Auto-detected from package.json/deno.json if not provided.",
+  )
+  .option(
+    "--import-extension <ext>",
+    'Override import file extension in generated files (.js for ESM, empty string for CJS). Auto-detected from package.json "type" field if not provided.',
+  )
   .addHelpText(
     "after",
     `

package/lib/commands/generators/base.ts

@@ -26,6 +26,24 @@ export interface GenerateResult {
   constantsContent: string;
 }
 
+/**
+ * Options for overriding auto-detected generation settings.
+ */
+export interface GenerateOptions {
+  /**
+   * Override the Appwrite import source used in generated files.
+   * Auto-detected from package.json/deno.json if not provided.
+   * Examples: "node-appwrite", "appwrite", "@appwrite.io/console"
+   */
+  appwriteImportSource?: string;
+  /**
+   * Override the import file extension used in generated files.
+   * Auto-detected from package.json "type" field / deno.json if not provided.
+   * Use ".js" for ESM projects or "" for CJS/unknown projects.
+   */
+  importExtension?: string;
+}
+
 /**
  * Base interface for all language-specific database generators.
  * Implement this interface to add support for new languages.
@@ -44,12 +62,16 @@ export interface IDatabasesGenerator {
   /**
    * Generate the SDK files from the configuration.
    * @param config - The project configuration containing tables/collections
+   * @param options - Optional overrides for auto-detected settings (e.g. import source, extension)
    * @returns Promise resolving to named file contents:
    * `dbContent` (`databases.ts`), `typesContent` (`types.ts`),
    * `indexContent` (`index.ts`), and `constantsContent` (`constants.ts`).
    * Import your generated SDK from `index.ts` (or `index.js` after transpilation).
    */
-  generate(config: ConfigType): Promise<GenerateResult>;
+  generate(
+    config: ConfigType,
+    options?: GenerateOptions,
+  ): Promise<GenerateResult>;
 
   /**
    * Write the generated files to disk.
@@ -80,7 +102,10 @@ export abstract class BaseDatabasesGenerator implements IDatabasesGenerator {
   abstract readonly language: SupportedLanguage;
   abstract readonly fileExtension: string;
 
-  abstract generate(config: ConfigType): Promise<GenerateResult>;
+  abstract generate(
+    config: ConfigType,
+    options?: GenerateOptions,
+  ): Promise<GenerateResult>;
 
   async writeFiles(outputDir: string, result: GenerateResult): Promise<void> {
     const sdkDir = path.join(outputDir, SDK_TITLE_LOWER);

package/lib/commands/generators/index.ts

@@ -9,6 +9,7 @@ export {
   IDatabasesGenerator,
   SupportedLanguage,
   GenerateResult,
+  GenerateOptions,
 } from "./base.js";
 export {
   LanguageDetector,

package/lib/commands/generators/typescript/databases.ts

@@ -6,6 +6,7 @@ import { TypeScript } from "../../../type-generation/languages/typescript.js";
 import { SDK_TITLE, EXECUTABLE_NAME } from "../../../constants.js";
 import {
   BaseDatabasesGenerator,
+  GenerateOptions,
   GenerateResult,
   SupportedLanguage,
 } from "../base.js";
@@ -259,14 +260,13 @@ ${
 };`;
   }
 
-  private generateTypesFile(config: ConfigType): string {
+  private generateTypesFile(config: ConfigType, appwriteDep: string): string {
     const entities = config.tables?.length ? config.tables : config.collections;
 
     if (!entities || entities.length === 0) {
       return "// No tables or collections found in configuration\n";
     }
 
-    const appwriteDep = getAppwriteDependency();
     const enums = this.generateEnums(entities);
     const types = entities
       .map((entity: Entity) => this.generateTableType(entity, entities))
@@ -370,7 +370,11 @@ ${
         }`;
   }
 
-  private generateDatabasesFile(config: ConfigType, importExt: string): string {
+  private generateDatabasesFile(
+    config: ConfigType,
+    importExt: string,
+    appwriteDep: string,
+  ): string {
     const entities = config.tables?.length ? config.tables : config.collections;
 
     if (!entities || entities.length === 0) {
@@ -378,7 +382,6 @@ ${
     }
 
     const entitiesByDb = this.groupEntitiesByDb(entities);
-    const appwriteDep = getAppwriteDependency();
     const supportsServerSide = supportsServerSideMethods(
       appwriteDep,
       this.serverSideOverride,
@@ -405,8 +408,10 @@ ${
     });
   }
 
-  private generateConstantsFile(config: ConfigType): string {
-    const appwriteDep = getAppwriteDependency();
+  private generateConstantsFile(
+    config: ConfigType,
+    appwriteDep: string,
+  ): string {
     const supportsServerSide = supportsServerSideMethods(
       appwriteDep,
       this.serverSideOverride,
@@ -420,12 +425,17 @@ ${
     });
   }
 
-  async generate(config: ConfigType): Promise<GenerateResult> {
+  async generate(
+    config: ConfigType,
+    options?: GenerateOptions,
+  ): Promise<GenerateResult> {
     if (!config.projectId) {
       throw new Error("Project ID is required in configuration");
     }
 
-    const importExt = detectImportExtension();
+    const appwriteDep =
+      options?.appwriteImportSource ?? getAppwriteDependency();
+    const importExt = options?.importExtension ?? detectImportExtension();
 
     const hasEntities =
       (config.tables && config.tables.length > 0) ||
@@ -439,15 +449,15 @@ ${
         dbContent: "// No tables or collections found in configuration\n",
         typesContent: "// No tables or collections found in configuration\n",
         indexContent: this.generateIndexFile(importExt),
-        constantsContent: this.generateConstantsFile(config),
+        constantsContent: this.generateConstantsFile(config, appwriteDep),
       };
     }
 
     return {
-      dbContent: this.generateDatabasesFile(config, importExt),
-      typesContent: this.generateTypesFile(config),
+      dbContent: this.generateDatabasesFile(config, importExt, appwriteDep),
+      typesContent: this.generateTypesFile(config, appwriteDep),
       indexContent: this.generateIndexFile(importExt),
-      constantsContent: this.generateConstantsFile(config),
+      constantsContent: this.generateConstantsFile(config, appwriteDep),
     };
   }
 }

package/lib/commands/services/account.ts

@@ -201,7 +201,7 @@ account
 
 account
   .command(`list-keys`)
-  .description(`Get a list of all API keys from the current account. `)
+  .description(`Get a list of all API keys from the current account.`)
   .option(
     `--total [value]`,
     `When set to false, the total count returned will be 0 and will not be calculated.`,

package/lib/commands/services/databases.ts

@@ -314,7 +314,7 @@ databases
   .description(`Create a boolean attribute.
 `)
   .requiredOption(`--database-id <database-id>`, `Database ID.`)
-  .requiredOption(`--collection-id <collection-id>`, `Collection ID. You can create a new table using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).`)
+  .requiredOption(`--collection-id <collection-id>`, `Collection ID. You can create a new collection using the Database service [server integration](https://appwrite.io/docs/server/databases#databasesCreateCollection).`)
   .requiredOption(`--key <key>`, `Attribute Key.`)
   .requiredOption(`--required <required>`, `Is attribute required?`, parseBool)
   .option(
@@ -801,6 +801,22 @@ databases
     ),
   );
 
+databases
+  .command(`update-relationship-attribute`)
+  .description(`Update relationship attribute. [Learn more about relationship attributes](https://appwrite.io/docs/databases-relationships#relationship-attributes).
+`)
+  .requiredOption(`--database-id <database-id>`, `Database ID.`)
+  .requiredOption(`--collection-id <collection-id>`, `Collection ID.`)
+  .requiredOption(`--key <key>`, `Attribute Key.`)
+  .option(`--on-delete <on-delete>`, `Constraints option`)
+  .option(`--new-key <new-key>`, `New Attribute Key.`)
+  .action(
+    actionRunner(
+      async ({ databaseId, collectionId, key, onDelete, newKey }) =>
+        parse(await (await getDatabasesClient()).updateRelationshipAttribute(databaseId, collectionId, key, onDelete, newKey)),
+    ),
+  );
+
 databases
   .command(`create-string-attribute`)
   .description(`Create a string attribute.
@@ -1005,22 +1021,6 @@ databases
     ),
   );
 
-databases
-  .command(`update-relationship-attribute`)
-  .description(`Update relationship attribute. [Learn more about relationship attributes](https://appwrite.io/docs/databases-relationships#relationship-attributes).
-`)
-  .requiredOption(`--database-id <database-id>`, `Database ID.`)
-  .requiredOption(`--collection-id <collection-id>`, `Collection ID.`)
-  .requiredOption(`--key <key>`, `Attribute Key.`)
-  .option(`--on-delete <on-delete>`, `Constraints option`)
-  .option(`--new-key <new-key>`, `New Attribute Key.`)
-  .action(
-    actionRunner(
-      async ({ databaseId, collectionId, key, onDelete, newKey }) =>
-        parse(await (await getDatabasesClient()).updateRelationshipAttribute(databaseId, collectionId, key, onDelete, newKey)),
-    ),
-  );
-
 databases
   .command(`list-documents`)
   .description(`Get a list of all the user's documents in a given collection. You can use the query params to filter your results.`)
@@ -1034,10 +1034,11 @@ databases
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
+  .option(`--ttl <ttl>`, `TTL (seconds) for cached responses when caching is enabled for select queries. Must be between 0 and 86400 (24 hours).`, parseInteger)
   .action(
     actionRunner(
-      async ({ databaseId, collectionId, queries, transactionId, total }) =>
-        parse(await (await getDatabasesClient()).listDocuments(databaseId, collectionId, queries, transactionId, total)),
+      async ({ databaseId, collectionId, queries, transactionId, total, ttl }) =>
+        parse(await (await getDatabasesClient()).listDocuments(databaseId, collectionId, queries, transactionId, total, ttl)),
     ),
   );
 

package/lib/commands/services/health.ts

@@ -64,6 +64,19 @@ health
     ),
   );
 
+health
+  .command(`get-console-pausing`)
+  .description(`Get console pausing health status. Monitors projects approaching the pause threshold to detect potential issues with console access tracking.
+`)
+  .option(`--threshold <threshold>`, `Percentage threshold of projects approaching pause. When hit (equal or higher), endpoint returns server error. Default value is 10.`, parseInteger)
+  .option(`--inactivity-days <inactivity-days>`, `Number of days of inactivity before a project is paused. Should match the plan's projectInactivityDays setting. Default value is 7.`, parseInteger)
+  .action(
+    actionRunner(
+      async ({ threshold, inactivityDays }) =>
+        parse(await (await getHealthClient()).getConsolePausing(threshold, inactivityDays)),
+    ),
+  );
+
 health
   .command(`get-db`)
   .description(`Check the Appwrite database servers are up and connection is successful.`)

package/lib/commands/services/messaging.ts

@@ -993,7 +993,7 @@ messaging
   .command(`list-subscribers`)
   .description(`Get a list of all subscribers from the current Appwrite project.`)
   .requiredOption(`--topic-id <topic-id>`, `Topic ID. The topic ID subscribed to.`)
-  .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, provider, type, enabled`)
+  .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: targetId, topicId, userId, providerType`)
   .option(`--search <search>`, `Search term to filter your list results. Max length: 256 chars.`)
   .option(
     `--total [value]`,

package/lib/commands/services/projects.ts

@@ -270,6 +270,18 @@ projects
     ),
   );
 
+projects
+  .command(`update-console-access`)
+  .description(`Record console access to a project. This endpoint updates the last accessed timestamp for the project to track console activity.
+`)
+  .requiredOption(`--project-id <project-id>`, `Project ID`)
+  .action(
+    actionRunner(
+      async ({ projectId }) =>
+        parse(await (await getProjectsClient()).updateConsoleAccess(projectId)),
+    ),
+  );
+
 projects
   .command(`list-dev-keys`)
   .description(`List all the project\'s dev keys. Dev keys are project specific and allow you to bypass rate limits and get better error logging during development.'`)
@@ -639,6 +651,19 @@ projects
     ),
   );
 
+projects
+  .command(`update-status`)
+  .description(`Update the status of a project. Can be used to archive/restore projects, and to restore paused projects. When restoring a paused project, the console fingerprint header must be provided and the project must not be blocked for any reason other than inactivity.
+`)
+  .requiredOption(`--project-id <project-id>`, `Project ID`)
+  .requiredOption(`--status <status>`, `New status for the project`)
+  .action(
+    actionRunner(
+      async ({ projectId, status }) =>
+        parse(await (await getProjectsClient()).updateStatus(projectId, status)),
+    ),
+  );
+
 projects
   .command(`update-team`)
   .description(`Update the team ID of a project allowing for it to be transferred to another team.`)

package/lib/commands/services/sites.ts

@@ -243,14 +243,19 @@ sites
   .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.`)
+  .option(
+    `--activate [value]`,
+    `Automatically activate the deployment when it is finished building.`,
+    (value: string | undefined) =>
+      value === undefined ? true : parseBool(value),
+  )
   .action(
     actionRunner(
-      async ({ siteId, code, activate, installCommand, buildCommand, outputDirectory }) =>
-        parse(await (await getSitesClient()).createDeployment(siteId, code, activate, installCommand, buildCommand, outputDirectory)),
+      async ({ siteId, code, installCommand, buildCommand, outputDirectory, activate }) =>
+        parse(await (await getSitesClient()).createDeployment(siteId, code, installCommand, buildCommand, outputDirectory, activate)),
     ),
   );
 

package/lib/commands/services/tables-db.ts

@@ -1109,10 +1109,11 @@ tablesDB
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
+  .option(`--ttl <ttl>`, `TTL (seconds) for cached responses when caching is enabled for select queries. Must be between 0 and 86400 (24 hours).`, parseInteger)
   .action(
     actionRunner(
-      async ({ databaseId, tableId, queries, transactionId, total }) =>
-        parse(await (await getTablesDBClient()).listRows(databaseId, tableId, queries, transactionId, total)),
+      async ({ databaseId, tableId, queries, transactionId, total, ttl }) =>
+        parse(await (await getTablesDBClient()).listRows(databaseId, tableId, queries, transactionId, total, ttl)),
     ),
   );
 

package/lib/commands/services/teams.ts

@@ -139,7 +139,7 @@ Use the \`url\` parameter to redirect the user from the invitation email to your
 Please note that to avoid a [Redirect Attack](https://github.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.md) Appwrite will accept the only redirect URLs under the domains you have added as a platform on the Appwrite Console.
 `)
   .requiredOption(`--team-id <team-id>`, `Team ID.`)
-  .requiredOption(`--roles [roles...]`, `Array of strings. Use this param to set the user roles in the team. A role can be any string. Learn more about [roles and permissions](https://appwrite.io/docs/permissions). Maximum of 100 roles are allowed, each 32 characters long.`)
+  .requiredOption(`--roles [roles...]`, `Array of strings. Use this param to set the user roles in the team. A role can be any string. Learn more about [roles and permissions](https://appwrite.io/docs/permissions). Maximum of 100 roles are allowed, each 81 characters long.`)
   .option(`--email <email>`, `Email of the new team member.`)
   .option(`--user-id <user-id>`, `ID of the user to be added to a team.`)
   .option(`--phone <phone>`, `Phone number. Format this number with a leading '+' and a country code, e.g., +16175551212.`)
@@ -170,7 +170,7 @@ teams
 `)
   .requiredOption(`--team-id <team-id>`, `Team ID.`)
   .requiredOption(`--membership-id <membership-id>`, `Membership ID.`)
-  .requiredOption(`--roles [roles...]`, `An array of strings. Use this param to set the user's roles in the team. A role can be any string. Learn more about [roles and permissions](https://appwrite.io/docs/permissions). Maximum of 100 roles are allowed, each 32 characters long.`)
+  .requiredOption(`--roles [roles...]`, `An array of strings. Use this param to set the user's roles in the team. A role can be any string. Learn more about [roles and permissions](https://appwrite.io/docs/permissions). Maximum of 100 roles are allowed, each 81 characters long.`)
   .action(
     actionRunner(
       async ({ teamId, membershipId, roles }) =>

package/lib/constants.ts

@@ -1,7 +1,7 @@
 // SDK
 export const SDK_TITLE = 'Appwrite';
 export const SDK_TITLE_LOWER = 'appwrite';
-export const SDK_VERSION = '13.6.1';
+export const SDK_VERSION = '14.0.0';
 export const SDK_NAME = 'Command Line';
 export const SDK_PLATFORM = 'console';
 export const SDK_LANGUAGE = 'cli';

package/package.json

@@ -3,7 +3,7 @@
   "type": "module",
   "homepage": "https://appwrite.io/support",
   "description": "Appwrite is an open-source self-hosted backend server that abstracts and simplifies complex and repetitive development tasks behind a very simple REST API",
-  "version": "13.6.1",
+  "version": "14.0.0",
   "license": "BSD-3-Clause",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -47,7 +47,7 @@
     "windows-arm64": "esbuild cli.ts --bundle --loader:.hbs=text --platform=node --target=node18 --format=esm --external:fsevents --outfile=dist/bundle-win-arm64.mjs && pkg dist/bundle-win-arm64.mjs -t node18-win-arm64 -o build/appwrite-cli-win-arm64.exe"
   },
   "dependencies": {
-    "@appwrite.io/console": "^3.1.0",
+    "@appwrite.io/console": "^4.0.0",
     "chalk": "4.1.2",
     "chokidar": "^3.6.0",
     "cli-progress": "^3.12.0",

package/scoop/appwrite.config.json

@@ -1,12 +1,12 @@
 {
 	"$schema": "https://raw.githubusercontent.com/ScoopInstaller/Scoop/master/schema.json",
-	"version": "13.6.1",
+	"version": "14.0.0",
 	"description": "The Appwrite CLI is a command-line application that allows you to interact with Appwrite and perform server-side tasks using your terminal.",
 	"homepage": "https://github.com/appwrite/sdk-for-cli",
 	"license": "BSD-3-Clause",
 	"architecture": {
 		"64bit": {
-			"url": "https://github.com/appwrite/sdk-for-cli/releases/download/13.6.1/appwrite-cli-win-x64.exe",
+			"url": "https://github.com/appwrite/sdk-for-cli/releases/download/14.0.0/appwrite-cli-win-x64.exe",
 			"bin": [
 				[
 					"appwrite-cli-win-x64.exe",
@@ -15,7 +15,7 @@
 			]
 		},
 		"arm64": {
-			"url": "https://github.com/appwrite/sdk-for-cli/releases/download/13.6.1/appwrite-cli-win-arm64.exe",
+			"url": "https://github.com/appwrite/sdk-for-cli/releases/download/14.0.0/appwrite-cli-win-arm64.exe",
 			"bin": [
 				[
 					"appwrite-cli-win-arm64.exe",