appwrite-cli 17.2.1 → 17.3.0

package/lib/constants.ts

@@ -1,22 +0,0 @@
-// SDK
-export const SDK_TITLE = 'Appwrite';
-export const SDK_TITLE_LOWER = 'appwrite';
-export const SDK_VERSION = '17.2.1';
-export const SDK_NAME = 'Command Line';
-export const SDK_PLATFORM = 'console';
-export const SDK_LANGUAGE = 'cli';
-export const SDK_LOGO = "\n    _                            _ _           ___   __   _____\n   \/_\\  _ __  _ ____      ___ __(_) |_ ___    \/ __\\ \/ \/   \\_   \\\n  \/\/_\\\\| '_ \\| '_ \\ \\ \/\\ \/ \/ '__| | __\/ _ \\  \/ \/   \/ \/     \/ \/\\\/\n \/  _  \\ |_) | |_) \\ V  V \/| |  | | ||  __\/ \/ \/___\/ \/___\/\\\/ \/_\n \\_\/ \\_\/ .__\/| .__\/ \\_\/\\_\/ |_|  |_|\\__\\___| \\____\/\\____\/\\____\/\n       |_|   |_|\n\n";
-
-// CLI
-export const EXECUTABLE_NAME = 'appwrite';
-
-// NPM
-export const NPM_PACKAGE_NAME = 'appwrite-cli';
-export const NPM_REGISTRY_URL = `https://registry.npmjs.org/${NPM_PACKAGE_NAME}/latest`;
-
-// GitHub
-export const GITHUB_REPO = 'appwrite/appwrite-cli';
-export const GITHUB_RELEASES_URL = `https://github.com/${GITHUB_REPO}/releases`;
-
-// API
-export const DEFAULT_ENDPOINT = 'https://cloud.appwrite.io/v1';

package/lib/emulation/docker.ts

@@ -1,326 +0,0 @@
-import ignoreModule from "ignore";
-const ignore: typeof ignoreModule =
-  (ignoreModule as unknown as { default?: typeof ignoreModule }).default ??
-  ignoreModule;
-import net from "net";
-import chalk from "chalk";
-import childProcess from "child_process";
-import { localConfig } from "../config.js";
-import path from "path";
-import fs from "fs";
-import { log, error, success } from "../parser.js";
-import { openRuntimesVersion, systemTools, Queue } from "./utils.js";
-import { getAllFiles } from "../utils.js";
-import type { FunctionType } from "../commands/config.js";
-
-export async function dockerStop(id: string): Promise<void> {
-  const stopProcess = childProcess.spawn("docker", ["rm", "--force", id], {
-    stdio: "pipe",
-    env: {
-      ...process.env,
-      DOCKER_CLI_HINTS: "false",
-    },
-  });
-
-  await new Promise<void>((res) => {
-    stopProcess.on("close", res);
-  });
-}
-
-export async function dockerPull(func: FunctionType): Promise<void> {
-  const runtimeChunks = func.runtime.split("-");
-  const runtimeVersion = runtimeChunks.pop();
-  const runtimeName = runtimeChunks.join("-");
-  const imageName = `openruntimes/${runtimeName}:${openRuntimesVersion}-${runtimeVersion}`;
-
-  log("Verifying Docker image ...");
-
-  const pullProcess = childProcess.spawn("docker", ["pull", imageName], {
-    stdio: "pipe",
-    env: {
-      ...process.env,
-      DOCKER_CLI_HINTS: "false",
-    },
-  });
-
-  await new Promise<void>((res) => {
-    pullProcess.on("close", res);
-  });
-}
-
-export async function dockerBuild(
-  func: FunctionType,
-  variables: Record<string, string>,
-): Promise<void> {
-  const runtimeChunks = func.runtime.split("-");
-  const runtimeVersion = runtimeChunks.pop();
-  const runtimeName = runtimeChunks.join("-");
-  const imageName = `openruntimes/${runtimeName}:${openRuntimesVersion}-${runtimeVersion}`;
-
-  const functionDir = path.join(localConfig.getDirname(), func.path);
-
-  const id = func.$id;
-
-  const ignorer = ignore();
-  ignorer.add(".appwrite");
-  if (func.ignore) {
-    ignorer.add(func.ignore);
-  } else if (fs.existsSync(path.join(functionDir, ".gitignore"))) {
-    ignorer.add(
-      fs.readFileSync(path.join(functionDir, ".gitignore")).toString(),
-    );
-  }
-
-  const files = getAllFiles(functionDir)
-    .map((file) => path.relative(functionDir, file))
-    .filter((file) => !ignorer.ignores(file));
-  const tmpBuildPath = path.join(functionDir, ".appwrite/tmp-build");
-  if (!fs.existsSync(tmpBuildPath)) {
-    fs.mkdirSync(tmpBuildPath, { recursive: true });
-  }
-
-  let killInterval: ReturnType<typeof setInterval> | undefined;
-
-  try {
-    for (const f of files) {
-      const filePath = path.join(tmpBuildPath, f);
-      const fileDir = path.dirname(filePath);
-      if (!fs.existsSync(fileDir)) {
-        fs.mkdirSync(fileDir, { recursive: true });
-      }
-
-      const sourcePath = path.join(functionDir, f);
-      fs.copyFileSync(sourcePath, filePath);
-    }
-
-    const params: string[] = ["run"];
-    params.push("--name", id);
-    params.push("-v", `${tmpBuildPath}/:/mnt/code:rw`);
-    params.push("-e", "OPEN_RUNTIMES_ENV=development");
-    params.push("-e", "OPEN_RUNTIMES_SECRET=");
-    params.push("-e", `OPEN_RUNTIMES_ENTRYPOINT=${func.entrypoint}`);
-
-    for (const k of Object.keys(variables)) {
-      params.push("-e", `${k}=${variables[k]}`);
-    }
-
-    params.push(imageName, "sh", "-c", `helpers/build.sh "${func.commands}"`);
-
-    const buildProcess = childProcess.spawn("docker", params, {
-      stdio: "pipe",
-      cwd: functionDir,
-      env: {
-        ...process.env,
-        DOCKER_CLI_HINTS: "false",
-      },
-    });
-
-    buildProcess.stdout.on("data", (data) => {
-      process.stdout.write(chalk.blackBright(`${data}\n`));
-    });
-
-    buildProcess.stderr.on("data", (data) => {
-      process.stderr.write(chalk.blackBright(`${data}\n`));
-    });
-
-    killInterval = setInterval(() => {
-      if (!Queue.isEmpty()) {
-        log("Cancelling build ...");
-        buildProcess.stdout.destroy();
-        buildProcess.stdin.destroy();
-        buildProcess.stderr.destroy();
-        buildProcess.kill("SIGKILL");
-        clearInterval(killInterval);
-      }
-    }, 100);
-
-    await new Promise<void>((res) => {
-      buildProcess.on("close", res);
-    });
-
-    clearInterval(killInterval);
-    killInterval = undefined;
-
-    if (!Queue.isEmpty()) {
-      await dockerStop(id);
-      return;
-    }
-
-    const copyPath = path.join(
-      localConfig.getDirname(),
-      func.path,
-      ".appwrite",
-      "build.tar.gz",
-    );
-    const copyDir = path.dirname(copyPath);
-    if (!fs.existsSync(copyDir)) {
-      fs.mkdirSync(copyDir, { recursive: true });
-    }
-
-    const copyProcess = childProcess.spawn(
-      "docker",
-      ["cp", `${id}:/mnt/code/code.tar.gz`, copyPath],
-      {
-        stdio: "pipe",
-        cwd: functionDir,
-        env: {
-          ...process.env,
-          DOCKER_CLI_HINTS: "false",
-        },
-      },
-    );
-
-    await new Promise<void>((res) => {
-      copyProcess.on("close", res);
-    });
-
-    await dockerStop(id);
-  } finally {
-    // Clean up interval if still running
-    if (killInterval !== undefined) {
-      clearInterval(killInterval);
-    }
-
-    // Clean up temp files
-    const tempPath = path.join(
-      localConfig.getDirname(),
-      func.path,
-      "code.tar.gz",
-    );
-    if (fs.existsSync(tempPath)) {
-      fs.rmSync(tempPath, { force: true });
-    }
-
-    // Always clean up tmpBuildPath
-    fs.rmSync(tmpBuildPath, { recursive: true, force: true });
-  }
-}
-
-export async function dockerStart(
-  func: FunctionType,
-  variables: Record<string, string>,
-  port: number,
-): Promise<void> {
-  // Pack function files
-  const functionDir = path.join(localConfig.getDirname(), func.path);
-
-  const runtimeChunks = func.runtime.split("-");
-  const runtimeVersion = runtimeChunks.pop();
-  const runtimeName = runtimeChunks.join("-");
-  const imageName = `openruntimes/${runtimeName}:${openRuntimesVersion}-${runtimeVersion}`;
-
-  const tool = systemTools[runtimeName];
-
-  const id = func.$id;
-
-  const params: string[] = ["run"];
-  params.push("--rm");
-  params.push("--name", id);
-  params.push("-p", `${port}:3000`);
-  params.push("-e", "OPEN_RUNTIMES_ENV=development");
-  params.push("-e", "OPEN_RUNTIMES_SECRET=");
-  params.push("-e", `OPEN_RUNTIMES_ENTRYPOINT=${func.entrypoint}`);
-
-  for (const k of Object.keys(variables)) {
-    params.push("-e", `${k}=${variables[k]}`);
-  }
-
-  params.push(
-    "-v",
-    `${functionDir}/.appwrite/logs.txt:/mnt/logs/dev_logs.log:rw`,
-  );
-  params.push(
-    "-v",
-    `${functionDir}/.appwrite/errors.txt:/mnt/logs/dev_errors.log:rw`,
-  );
-  params.push(
-    "-v",
-    `${functionDir}/.appwrite/build.tar.gz:/mnt/code/code.tar.gz:ro`,
-  );
-  params.push(imageName, "sh", "-c", `helpers/start.sh "${tool.startCommand}"`);
-
-  const startProcess = childProcess.spawn("docker", params, {
-    stdio: "pipe",
-    cwd: functionDir,
-    env: {
-      ...process.env,
-      DOCKER_CLI_HINTS: "false",
-    },
-  });
-
-  startProcess.stdout.on("data", (data) => {
-    process.stdout.write(chalk.blackBright(data));
-  });
-
-  startProcess.stderr.on("data", (data) => {
-    process.stdout.write(chalk.blackBright(data));
-  });
-
-  try {
-    await waitUntilPortOpen(port);
-  } catch (err: unknown) {
-    const message = err instanceof Error ? err.message : String(err);
-    error(`Failed to start function with error: ${message}`);
-    return;
-  }
-
-  success(`Visit http://localhost:${port}/ to execute your function.`);
-}
-
-export async function dockerCleanup(functionId: string): Promise<void> {
-  await dockerStop(functionId);
-
-  const func = localConfig.getFunction(functionId);
-  const appwritePath = path.join(
-    localConfig.getDirname(),
-    func.path,
-    ".appwrite",
-  );
-  if (fs.existsSync(appwritePath)) {
-    fs.rmSync(appwritePath, { recursive: true, force: true });
-  }
-
-  const tempPath = path.join(
-    localConfig.getDirname(),
-    func.path,
-    "code.tar.gz",
-  );
-  if (fs.existsSync(tempPath)) {
-    fs.rmSync(tempPath, { force: true });
-  }
-}
-
-function waitUntilPortOpen(port: number, iteration: number = 0): Promise<void> {
-  return new Promise((resolve, reject) => {
-    const client = new net.Socket();
-
-    client.once("connect", () => {
-      client.removeAllListeners("connect");
-      client.removeAllListeners("error");
-      client.end();
-      client.destroy();
-      client.unref();
-
-      resolve();
-    });
-
-    client.once("error", async (err) => {
-      client.removeAllListeners("connect");
-      client.removeAllListeners("error");
-      client.end();
-      client.destroy();
-      client.unref();
-
-      if (iteration > 100) {
-        reject(err);
-      } else {
-        await new Promise<void>((res) => setTimeout(res, 100));
-        waitUntilPortOpen(port, iteration + 1)
-          .then(resolve)
-          .catch(reject);
-      }
-    });
-
-    client.connect({ port, host: "127.0.0.1" }, function () {});
-  });
-}

package/lib/emulation/utils.ts

@@ -1,208 +0,0 @@
-import { EventEmitter } from "node:events";
-import { localConfig } from "../config.js";
-import { log } from "../parser.js";
-import { sdkForConsole, sdkForProject } from "../sdks.js";
-import { Projects, Scopes, Users } from "@appwrite.io/console";
-
-export const openRuntimesVersion = "v4";
-
-export const runtimeNames: Record<string, string> = {
-  node: "Node.js",
-  php: "PHP",
-  ruby: "Ruby",
-  python: "Python",
-  "python-ml": "Python (ML)",
-  deno: "Deno",
-  dart: "Dart",
-  dotnet: ".NET",
-  java: "Java",
-  swift: "Swift",
-  kotlin: "Kotlin",
-  bun: "Bun",
-  go: "Go",
-};
-
-interface SystemTool {
-  isCompiled: boolean;
-  startCommand: string;
-  dependencyFiles: string[];
-}
-
-export const systemTools: Record<string, SystemTool> = {
-  node: {
-    isCompiled: false,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: ["package.json", "package-lock.json"],
-  },
-  php: {
-    isCompiled: false,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: ["composer.json", "composer.lock"],
-  },
-  ruby: {
-    isCompiled: false,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: ["Gemfile", "Gemfile.lock"],
-  },
-  python: {
-    isCompiled: false,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: ["requirements.txt", "requirements.lock"],
-  },
-  "python-ml": {
-    isCompiled: false,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: ["requirements.txt", "requirements.lock"],
-  },
-  deno: {
-    isCompiled: false,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: [],
-  },
-  dart: {
-    isCompiled: true,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: [],
-  },
-  dotnet: {
-    isCompiled: true,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: [],
-  },
-  java: {
-    isCompiled: true,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: [],
-  },
-  swift: {
-    isCompiled: true,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: [],
-  },
-  kotlin: {
-    isCompiled: true,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: [],
-  },
-  bun: {
-    isCompiled: false,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: ["package.json", "package-lock.json", "bun.lockb"],
-  },
-  go: {
-    isCompiled: true,
-    startCommand: "sh helpers/server.sh",
-    dependencyFiles: [],
-  },
-};
-
-export const JwtManager = {
-  userJwt: null as string | null,
-  functionJwt: null as string | null,
-
-  timerWarn: null as NodeJS.Timeout | null,
-  timerError: null as NodeJS.Timeout | null,
-
-  async setup(
-    userId: string | null = null,
-    projectScopes: Scopes[] = [],
-  ): Promise<void> {
-    const consoleClient = await sdkForConsole();
-    const projectsClient = new Projects(consoleClient);
-
-    if (this.timerWarn) {
-      clearTimeout(this.timerWarn);
-    }
-
-    if (this.timerError) {
-      clearTimeout(this.timerError);
-    }
-
-    this.timerWarn = setTimeout(
-      () => {
-        log(
-          "Warning: Authorized JWT will expire in 5 minutes. Please stop and re-run the command to refresh tokens for 1 hour.",
-        );
-      },
-      1000 * 60 * 55,
-    ); // 55 mins
-
-    this.timerError = setTimeout(
-      () => {
-        log(
-          "Warning: Authorized JWT just expired. Please stop and re-run the command to obtain new tokens with 1 hour validity.",
-        );
-        log("Some Appwrite API communication is not authorized now.");
-      },
-      1000 * 60 * 60,
-    ); // 60 mins
-
-    if (userId) {
-      const projectClient = await sdkForProject();
-      const usersClient = new Users(projectClient);
-      await usersClient.get({
-        userId,
-      });
-      const userResponse = await usersClient.createJWT({
-        userId,
-        duration: 60 * 60,
-      });
-      this.userJwt = userResponse.jwt;
-    }
-
-    const functionResponse = await projectsClient.createJWT({
-      projectId: localConfig.getProject().projectId!,
-      scopes: projectScopes,
-      duration: 60 * 60,
-    });
-    this.functionJwt = functionResponse.jwt;
-  },
-};
-
-interface QueueReloadEvent {
-  files: string[];
-}
-
-export const Queue = {
-  files: [] as string[],
-  locked: false,
-  events: new EventEmitter(),
-  debounce: null as NodeJS.Timeout | null,
-
-  push(file: string): void {
-    if (!this.files.includes(file)) {
-      this.files.push(file);
-    }
-
-    if (!this.locked) {
-      this._trigger();
-    }
-  },
-
-  lock(): void {
-    this.files = [];
-    this.locked = true;
-  },
-
-  isEmpty(): boolean {
-    return this.files.length === 0;
-  },
-
-  unlock(): void {
-    this.locked = false;
-    if (this.files.length > 0) {
-      this._trigger();
-    }
-  },
-
-  _trigger(): void {
-    if (this.debounce) {
-      return;
-    }
-
-    this.debounce = setTimeout(() => {
-      this.events.emit("reload", { files: this.files } as QueueReloadEvent);
-      this.debounce = null;
-    }, 300);
-  },
-};

package/lib/id.ts

@@ -1,30 +0,0 @@
-class ID {
-  // Generate an hex ID based on timestamp
-  // Recreated from https://www.php.net/manual/en/function.uniqid.php
-  static #hexTimestamp(): string {
-    const now = new Date();
-    const sec = Math.floor(now.getTime() / 1000);
-    const msec = now.getMilliseconds();
-
-    // Convert to hexadecimal
-    const hexTimestamp = sec.toString(16) + msec.toString(16).padStart(5, "0");
-    return hexTimestamp;
-  }
-
-  static custom(id: string): string {
-    return id;
-  }
-
-  static unique(padding: number = 7): string {
-    // Generate a unique ID with padding to have a longer ID
-    const baseId = ID.#hexTimestamp();
-    let randomPadding = "";
-    for (let i = 0; i < padding; i++) {
-      const randomHexDigit = Math.floor(Math.random() * 16).toString(16);
-      randomPadding += randomHexDigit;
-    }
-    return baseId + randomPadding;
-  }
-}
-
-export default ID;

package/lib/json.ts

@@ -1,51 +0,0 @@
-import JSONbigModule from "json-bigint";
-
-const JSONbigParser = JSONbigModule({ storeAsString: false });
-const JSONbigSerializer = JSONbigModule({ useNativeBigInt: true });
-
-const MAX_SAFE = BigInt(Number.MAX_SAFE_INTEGER);
-const MIN_SAFE = BigInt(Number.MIN_SAFE_INTEGER);
-const MAX_INT64 = BigInt("9223372036854775807");
-const MIN_INT64 = BigInt("-9223372036854775808");
-
-interface BigNumberLike {
-  _isBigNumber: boolean;
-  isInteger: () => boolean;
-  toFixed: () => string;
-  toNumber: () => number;
-}
-
-function isBigNumber(value: unknown): value is BigNumberLike {
-  return (
-    value !== null &&
-    typeof value === "object" &&
-    (value as BigNumberLike)._isBigNumber === true &&
-    typeof (value as BigNumberLike).isInteger === "function" &&
-    typeof (value as BigNumberLike).toFixed === "function" &&
-    typeof (value as BigNumberLike).toNumber === "function"
-  );
-}
-
-function reviver(_key: string, value: unknown): unknown {
-  if (isBigNumber(value)) {
-    if (value.isInteger()) {
-      const str = value.toFixed();
-      const bi = BigInt(str);
-      if (bi >= MIN_SAFE && bi <= MAX_SAFE) {
-        return Number(str);
-      }
-      if (bi >= MIN_INT64 && bi <= MAX_INT64) {
-        return bi;
-      }
-      return value.toNumber();
-    }
-    return value.toNumber();
-  }
-  return value;
-}
-
-export const JSONBig = {
-  parse: <T = unknown>(text: string): T =>
-    JSONbigParser.parse(text, reviver) as T,
-  stringify: JSONbigSerializer.stringify,
-};