chirag-appwrite-cli 0.2.0 → 0.3.0

package/docs/examples/users/update-phone-verification.md

@@ -0,0 +1,3 @@
+appwrite users update-phone-verification \
+    --user-id <USER_ID> \
+    --phone-verification false

package/docs/examples/users/update-phone.md

@@ -0,0 +1,3 @@
+appwrite users update-phone \
+    --user-id <USER_ID> \
+    --number +12065550100

package/docs/examples/users/update-prefs.md

@@ -0,0 +1,3 @@
+appwrite users update-prefs \
+    --user-id <USER_ID> \
+    --prefs '{ "key": "value" }'

package/docs/examples/users/update-status.md

@@ -0,0 +1,3 @@
+appwrite users update-status \
+    --user-id <USER_ID> \
+    --status false

package/docs/examples/users/update-target.md

@@ -0,0 +1,3 @@
+appwrite users update-target \
+    --user-id <USER_ID> \
+    --target-id <TARGET_ID>

package/docs/examples/vcs/create-repository-detection.md

@@ -0,0 +1,4 @@
+appwrite vcs create-repository-detection \
+    --installation-id <INSTALLATION_ID> \
+    --provider-repository-id <PROVIDER_REPOSITORY_ID> \
+    --type runtime

package/docs/examples/vcs/create-repository.md

@@ -0,0 +1,4 @@
+appwrite vcs create-repository \
+    --installation-id <INSTALLATION_ID> \
+    --name <NAME> \
+    --private false

package/docs/examples/vcs/delete-installation.md

@@ -0,0 +1,2 @@
+appwrite vcs delete-installation \
+    --installation-id <INSTALLATION_ID>

package/docs/examples/vcs/get-installation.md

@@ -0,0 +1,2 @@
+appwrite vcs get-installation \
+    --installation-id <INSTALLATION_ID>

package/docs/examples/vcs/get-repository-contents.md

@@ -0,0 +1,3 @@
+appwrite vcs get-repository-contents \
+    --installation-id <INSTALLATION_ID> \
+    --provider-repository-id <PROVIDER_REPOSITORY_ID>

package/docs/examples/vcs/get-repository.md

@@ -0,0 +1,3 @@
+appwrite vcs get-repository \
+    --installation-id <INSTALLATION_ID> \
+    --provider-repository-id <PROVIDER_REPOSITORY_ID>

package/docs/examples/vcs/list-installations.md

@@ -0,0 +1 @@
+appwrite vcs list-installations

package/docs/examples/vcs/list-repositories.md

@@ -0,0 +1,3 @@
+appwrite vcs list-repositories \
+    --installation-id <INSTALLATION_ID> \
+    --type runtime

package/docs/examples/vcs/list-repository-branches.md

@@ -0,0 +1,3 @@
+appwrite vcs list-repository-branches \
+    --installation-id <INSTALLATION_ID> \
+    --provider-repository-id <PROVIDER_REPOSITORY_ID>

package/docs/examples/vcs/update-external-deployments.md

@@ -0,0 +1,4 @@
+appwrite vcs update-external-deployments \
+    --installation-id <INSTALLATION_ID> \
+    --repository-id <REPOSITORY_ID> \
+    --provider-pull-request-id <PROVIDER_PULL_REQUEST_ID>

package/index.ts

@@ -1,175 +1,13 @@
-#! /usr/bin/env node
-
-/** Required to set max width of the help commands */
-const oldWidth = process.stdout.columns;
-process.stdout.columns = 100;
-/** ---------------------------------------------- */
+/**
+ * Library exports for programmatic use of the Appwrite CLI
+ *
+ * For CLI usage, run the 'appwrite' command directly.
+ */
 
-import { program } from "commander";
-import chalk from "chalk";
-import packageJson from "./package.json" with { type: "json" };
-const { version } = packageJson;
-import { commandDescriptions, cliConfig } from "./lib/parser.js";
-import { client } from "./lib/commands/generic.js";
-import { getLatestVersion, compareVersions } from "./lib/utils.js";
-import inquirer from "inquirer";
-import {
-  login,
-  logout,
-  whoami,
-  migrate,
-  register,
-} from "./lib/commands/generic.js";
-import { init } from "./lib/commands/init.js";
-import { types } from "./lib/commands/types.js";
-import { pull } from "./lib/commands/pull.js";
-import { run } from "./lib/commands/run.js";
-import { push, deploy } from "./lib/commands/push.js";
-import { update } from "./lib/commands/update.js";
-import { account } from "./lib/commands/services/account.js";
-import { console } from "./lib/commands/services/console.js";
-import { databases } from "./lib/commands/services/databases.js";
-import { functions } from "./lib/commands/services/functions.js";
-import { graphql } from "./lib/commands/services/graphql.js";
-import { health } from "./lib/commands/services/health.js";
-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 { project } from "./lib/commands/services/project.js";
-import { projects } from "./lib/commands/services/projects.js";
-import { proxy } from "./lib/commands/services/proxy.js";
-import { sites } from "./lib/commands/services/sites.js";
-import { storage } from "./lib/commands/services/storage.js";
-import { tablesdb } from "./lib/commands/services/tablesdb.js";
-import { teams } from "./lib/commands/services/teams.js";
-import { tokens } from "./lib/commands/services/tokens.js";
-import { users } from "./lib/commands/services/users.js";
-import { vcs } from "./lib/commands/services/vcs.js";
-import searchList from "inquirer-search-list";
 import { Push } from "./lib/commands/push.js";
 import { Pull } from "./lib/commands/pull.js";
 import { Schema } from "./lib/commands/schema.js";
 
-inquirer.registerPrompt("search-list", searchList);
-
-/**
- * Check for updates and show version information
- */
-async function checkVersion(): Promise<void> {
-  process.stdout.write(chalk.bold(`appwrite version ${version}`) + "\n");
-
-  try {
-    const latestVersion = await getLatestVersion();
-    const comparison = compareVersions(version, latestVersion);
-
-    if (comparison > 0) {
-      // Current version is older than latest
-      process.stdout.write(
-        chalk.yellow(
-          `\n⚠️  A newer version is available: ${chalk.bold(latestVersion)}`,
-        ) + "\n",
-      );
-      process.stdout.write(
-        chalk.cyan(
-          `💡 Run '${chalk.bold("appwrite update")}' to update to the latest version.`,
-        ) + "\n",
-      );
-    } else if (comparison === 0) {
-      process.stdout.write(
-        chalk.green("\n✅ You are running the latest version!") + "\n",
-      );
-    } else {
-      // Current version is newer than latest (pre-release/dev)
-      process.stdout.write(
-        chalk.blue(
-          "\n🚀 You are running a pre-release or development version.",
-        ) + "\n",
-      );
-    }
-  } catch (error) {
-    // Silently fail version check, just show current version
-    process.stdout.write(chalk.gray("\n(Unable to check for updates)") + "\n");
-  }
-}
-
-// Intercept version flag before Commander.js processes it
-if (process.argv.includes("-v") || process.argv.includes("--version")) {
-  (async () => {
-    await checkVersion();
-    process.exit(0);
-  })();
-} else {
-  program
-    .description(commandDescriptions["main"])
-    .configureHelp({
-      helpWidth: process.stdout.columns || 80,
-      sortSubcommands: true,
-    })
-    .helpOption("-h, --help", "Display help for command")
-    .version(version, "-v, --version", "Output the version number")
-    .option("-V, --verbose", "Show complete error log")
-    .option("-j, --json", "Output in JSON format")
-    .hook("preAction", migrate)
-    .option("-f,--force", "Flag to confirm all warnings")
-    .option("-a,--all", "Flag to push all resources")
-    .option("--id [id...]", "Flag to pass a list of ids for a given action")
-    .option("--report", "Enable reporting in case of CLI errors")
-    .on("option:json", () => {
-      cliConfig.json = true;
-    })
-    .on("option:verbose", () => {
-      cliConfig.verbose = true;
-    })
-    .on("option:report", function () {
-      cliConfig.report = true;
-      cliConfig.reportData = { data: this };
-    })
-    .on("option:force", () => {
-      cliConfig.force = true;
-    })
-    .on("option:all", () => {
-      cliConfig.all = true;
-    })
-    .on("option:id", function () {
-      cliConfig.ids = (this as any).opts().id;
-    })
-    .showSuggestionAfterError()
-    .addCommand(whoami)
-    .addCommand(register)
-    .addCommand(login)
-    .addCommand(init)
-    .addCommand(pull)
-    .addCommand(push)
-    .addCommand(types)
-    .addCommand(deploy)
-    .addCommand(run)
-    .addCommand(update)
-    .addCommand(logout)
-    .addCommand(account)
-    .addCommand(console)
-    .addCommand(databases)
-    .addCommand(functions)
-    .addCommand(graphql)
-    .addCommand(health)
-    .addCommand(locale)
-    .addCommand(messaging)
-    .addCommand(migrations)
-    .addCommand(project)
-    .addCommand(projects)
-    .addCommand(proxy)
-    .addCommand(sites)
-    .addCommand(storage)
-    .addCommand(tablesdb)
-    .addCommand(teams)
-    .addCommand(tokens)
-    .addCommand(users)
-    .addCommand(vcs)
-    .addCommand(client)
-    .parse(process.argv);
-
-  process.stdout.columns = oldWidth;
-}
-
 export { Schema, Push, Pull };
 export type {
   ConfigType,

package/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/13.0.0-rc.3/appwrite-cli-win-x64.exe"
-$GITHUB_arm64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/13.0.0-rc.3/appwrite-cli-win-arm64.exe"
+$GITHUB_x64_URL = "https://github.com/repoowner/reponame/releases/download/0.0.0/appwrite-cli-win-x64.exe"
+$GITHUB_arm64_URL = "https://github.com/repoowner/reponame/releases/download/0.0.0/appwrite-cli-win-arm64.exe"
 
 $APPWRITE_BINARY_NAME = "appwrite.exe"
 
@@ -83,7 +83,7 @@ function CleanUp {
 function InstallCompleted {
     Write-Host "[4/4] Finishing Installation ... "
     cleanup
-    Write-Host "To get started with Appwrite CLI, please visit https://appwrite.io/docs/command-line"
+    Write-Host "To get started with Appwrite CLI, please visit https://example.com/docs/command-line"
     Write-Host "As first step, you can login to your Appwrite account using 'appwrite login'"
 }
 

package/install.sh

@@ -27,7 +27,7 @@ APPWRITE_EXECUTABLE_FILEPATH="$APPWRITE_INSTALL_DIR/$APPWRITE_EXECUTABLE_NAME"
 APPWRITE_TEMP_NAME=temp-$(date +%s)
 
 # Appwrite CLI image name
-GITHUB_REPOSITORY_NAME=appwrite/sdk-for-cli
+GITHUB_REPOSITORY_NAME=repoowner/reponame
 
 # sudo is required to copy executable to APPWRITE_INSTALL_DIR for linux
 USE_SUDO="false"
@@ -96,7 +96,7 @@ printSuccess() {
 downloadBinary() {
     echo "[2/4] Downloading executable for $OS ($ARCH) ..."
 
-    GITHUB_LATEST_VERSION="13.0.0-rc.3"
+    GITHUB_LATEST_VERSION="0.0.0"
     GITHUB_FILE="appwrite-cli-${OS}-${ARCH}"
     GITHUB_URL="https://github.com/$GITHUB_REPOSITORY_NAME/releases/download/$GITHUB_LATEST_VERSION/$GITHUB_FILE"
 
@@ -144,7 +144,7 @@ cleanup() {
 installCompleted() {
     echo "[4/4] Wrapping up installation ... "
     cleanup
-    echo "🚀 To get started with Appwrite CLI, please visit https://appwrite.io/docs/command-line"
+    echo "🚀 To get started with Appwrite CLI, please visit https://example.com/docs/command-line"
     echo "As first step, you can login to your Appwrite account using 'appwrite login'"
 }
 

package/lib/client.ts

@@ -10,8 +10,16 @@ import type {
   ResponseType,
   FileUpload,
 } from "./types.js";
+import {
+  DEFAULT_ENDPOINT,
+  SDK_NAME,
+  SDK_PLATFORM,
+  SDK_LANGUAGE,
+  SDK_VERSION,
+  SDK_TITLE,
+} from "./constants.js";
 
-const JSONBigInt = JSONbig({ storeAsString: false });
+const JSONBigInt = JSONbig({ useNativeBigInt: true });
 
 class Client {
   private endpoint: string;
@@ -19,15 +27,15 @@ class Client {
   private selfSigned: boolean;
 
   constructor() {
-    this.endpoint = "https://cloud.appwrite.io/v1";
+    this.endpoint = DEFAULT_ENDPOINT;
     this.selfSigned = false;
     this.headers = {
       "content-type": "",
-      "x-sdk-name": "Command Line",
-      "x-sdk-platform": "console",
-      "x-sdk-language": "cli",
-      "x-sdk-version": "13.0.0-rc.3",
-      "user-agent": `AppwriteCLI/13.0.0-rc.3 (${os.type()} ${os.version()}; ${os.arch()})`,
+      "x-sdk-name": SDK_NAME,
+      "x-sdk-platform": SDK_PLATFORM,
+      "x-sdk-language": SDK_LANGUAGE,
+      "x-sdk-version": SDK_VERSION,
+      "user-agent": `${SDK_TITLE}CLI/${SDK_VERSION} (${os.type()} ${os.version()}; ${os.arch()})`,
       "X-Appwrite-Response-Format": "1.8.1",
     };
   }

package/lib/commands/config.ts

@@ -79,6 +79,7 @@ const ConfigSchema = z
     sites: z.array(z.lazy(() => SiteSchema)).optional(),
     databases: z.array(z.lazy(() => DatabaseSchema)).optional(),
     collections: z.array(z.lazy(() => CollectionSchema)).optional(),
+    tablesDB: z.array(z.lazy(() => DatabaseSchema)).optional(),
     tables: z.array(z.lazy(() => TablesDBSchema)).optional(),
     topics: z.array(z.lazy(() => TopicSchema)).optional(),
     teams: z.array(z.lazy(() => TeamSchema)).optional(),
@@ -126,10 +127,10 @@ const SettingsSchema = z
           .optional(),
         security: z
           .object({
-            duration: z.number().optional(),
-            limit: z.number().optional(),
-            sessionsLimit: z.number().optional(),
-            passwordHistory: z.number().optional(),
+            duration: z.union([z.number(), z.bigint()]).optional(),
+            limit: z.union([z.number(), z.bigint()]).optional(),
+            sessionsLimit: z.union([z.number(), z.bigint()]).optional(),
+            passwordHistory: z.union([z.number(), z.bigint()]).optional(),
             passwordDictionary: z.boolean().optional(),
             personalDataCheck: z.boolean().optional(),
             sessionAlerts: z.boolean().optional(),
@@ -154,7 +155,7 @@ const SiteSchema = z
     name: z.string(),
     enabled: z.boolean().optional(),
     logging: z.boolean().optional(),
-    timeout: z.number().optional(),
+    timeout: z.union([z.number(), z.bigint()]).optional(),
     framework: z.string().optional(),
     buildRuntime: z.string().optional(),
     adapter: z.string().optional(),
@@ -181,7 +182,7 @@ const FunctionSchema = z
     scopes: z.array(z.string()).optional(),
     events: z.array(z.string()).optional(),
     schedule: z.string().optional(),
-    timeout: z.number().optional(),
+    timeout: z.union([z.number(), z.bigint()]).optional(),
     entrypoint: z.string().optional(),
     commands: z.string().optional(),
     vars: z.record(z.string(), z.string()).optional(),
@@ -233,6 +234,7 @@ const AttributeSchemaBase = z
       .optional(),
     elements: z.array(z.string()).optional(),
     relatedCollection: z.string().optional(),
+    relatedTable: z.string().optional(),
     relationType: z.string().optional(),
     twoWay: z.boolean().optional(),
     twoWayKey: z.string().optional(),
@@ -255,6 +257,20 @@ const AttributeSchema = AttributeSchemaBase.refine(
     message: "When 'required' is true, 'default' must be null",
     path: ["default"],
   },
+).refine(
+  (data) => {
+    if (
+      data.type === "string" &&
+      (data.size === undefined || data.size === null)
+    ) {
+      return false;
+    }
+    return true;
+  },
+  {
+    message: "When 'type' is 'string', 'size' must be defined",
+    path: ["size"],
+  },
 );
 
 const IndexSchema = z

package/lib/commands/generate.ts

@@ -0,0 +1,76 @@
+import * as path from "path";
+import { Command } from "commander";
+import { ConfigType } from "./config.js";
+import { localConfig } from "../config.js";
+import { success, error, log, actionRunner } from "../parser.js";
+import { DatabasesGenerator } from "./generators/databases.js";
+
+export interface GenerateCommandOptions {
+  output: string;
+}
+
+const generateAction = async (
+  options: GenerateCommandOptions,
+): Promise<void> => {
+  const generator = new DatabasesGenerator();
+  const project = localConfig.getProject();
+
+  if (!project.projectId) {
+    error("No project found. Please run 'appwrite init project' first.");
+    process.exit(1);
+  }
+
+  const config: ConfigType = {
+    projectId: project.projectId,
+    projectName: project.projectName,
+    tablesDB: localConfig.getTablesDBs(),
+    tables: localConfig.getTables(),
+    databases: localConfig.getDatabases(),
+    collections: localConfig.getCollections(),
+  };
+
+  const outputDir = options.output;
+  const absoluteOutputDir = path.isAbsolute(outputDir)
+    ? outputDir
+    : path.join(process.cwd(), outputDir);
+
+  log(`Generating type-safe SDK to ${absoluteOutputDir}...`);
+
+  try {
+    const result = await generator.generate(config);
+    await generator.writeFiles(absoluteOutputDir, result);
+
+    success(`Generated files:`);
+    console.log(`  - ${path.join(outputDir, "appwrite/index.ts")}`);
+    console.log(`  - ${path.join(outputDir, "appwrite/databases.ts")}`);
+    console.log(`  - ${path.join(outputDir, "appwrite/types.ts")}`);
+    console.log("");
+    log(`Import the generated SDK in your project:`);
+    console.log(
+      `  import { createDatabases } from "./${outputDir}/appwrite/index.js";`,
+    );
+    console.log("");
+    log(`Usage:`);
+    console.log(`  import { Client } from 'node-appwrite';`);
+    console.log(
+      `  const client = new Client().setEndpoint('...').setProject('...').setKey('...');`,
+    );
+    console.log(`  const databases = createDatabases(client);`);
+    console.log(`  const db = databases.from('your-database-id');`);
+    console.log(`  await db.tableName.create({ ... });`);
+  } catch (err: any) {
+    error(`Failed to generate SDK: ${err.message}`);
+    process.exit(1);
+  }
+};
+
+export const generate = new Command("generate")
+  .description(
+    "Generate a type-safe SDK from your Appwrite project configuration",
+  )
+  .option(
+    "-o, --output <directory>",
+    "Output directory for generated files (default: generated)",
+    "generated",
+  )
+  .action(actionRunner(generateAction));