appwrite-cli 12.0.1 → 13.0.0-rc.2

package/lib/commands/services/graphql.ts

@@ -0,0 +1,47 @@
+import { Command } from "commander";
+import { sdkForProject } from "../../sdks.js";
+import {
+  actionRunner,
+  commandDescriptions,
+  parseBool,
+  parseInteger,
+} from "../../parser.js";
+import { Graphql } from "@appwrite.io/console";
+
+let graphqlClient: Graphql | null = null;
+
+const getGraphqlClient = async (): Promise<Graphql> => {
+  if (!graphqlClient) {
+    const sdkClient = await sdkForProject();
+    graphqlClient = new Graphql(sdkClient);
+  }
+  return graphqlClient;
+};
+
+export const graphql = new Command("graphql")
+  .description(commandDescriptions["graphql"] ?? "")
+  .configureHelp({
+    helpWidth: process.stdout.columns || 80,
+  });
+
+graphql
+  .command(`query`)
+  .description(`Execute a GraphQL mutation.`)
+  .requiredOption(`--query <query>`, `The query or queries to execute.`)
+  .action(
+    actionRunner(
+      async ({ query }) =>
+        await (await getGraphqlClient()).query(JSON.parse(query)),
+    ),
+  );
+
+graphql
+  .command(`mutation`)
+  .description(`Execute a GraphQL mutation.`)
+  .requiredOption(`--query <query>`, `The query or queries to execute.`)
+  .action(
+    actionRunner(
+      async ({ query }) =>
+        await (await getGraphqlClient()).mutation(JSON.parse(query)),
+    ),
+  );

package/lib/commands/services/health.ts

@@ -0,0 +1,322 @@
+import { Command } from "commander";
+import { sdkForProject } from "../../sdks.js";
+import {
+  actionRunner,
+  commandDescriptions,
+  parseBool,
+  parseInteger,
+} from "../../parser.js";
+import { Health } from "@appwrite.io/console";
+
+let healthClient: Health | null = null;
+
+const getHealthClient = async (): Promise<Health> => {
+  if (!healthClient) {
+    const sdkClient = await sdkForProject();
+    healthClient = new Health(sdkClient);
+  }
+  return healthClient;
+};
+
+export const health = new Command("health")
+  .description(commandDescriptions["health"] ?? "")
+  .configureHelp({
+    helpWidth: process.stdout.columns || 80,
+  });
+
+health
+  .command(`get`)
+  .description(`Check the Appwrite HTTP server is up and responsive.`)
+  .action(actionRunner(async () => await (await getHealthClient()).get()));
+
+health
+  .command(`get-antivirus`)
+  .description(
+    `Check the Appwrite Antivirus server is up and connection is successful.`,
+  )
+  .action(
+    actionRunner(async () => await (await getHealthClient()).getAntivirus()),
+  );
+
+health
+  .command(`get-cache`)
+  .description(
+    `Check the Appwrite in-memory cache servers are up and connection is successful.`,
+  )
+  .action(actionRunner(async () => await (await getHealthClient()).getCache()));
+
+health
+  .command(`get-certificate`)
+  .description(`Get the SSL certificate for a domain`)
+  .option(`--domain <domain>`, `string`)
+  .action(
+    actionRunner(
+      async ({ domain }) =>
+        await (await getHealthClient()).getCertificate(domain),
+    ),
+  );
+
+health
+  .command(`get-db`)
+  .description(
+    `Check the Appwrite database servers are up and connection is successful.`,
+  )
+  .action(actionRunner(async () => await (await getHealthClient()).getDB()));
+
+health
+  .command(`get-pub-sub`)
+  .description(
+    `Check the Appwrite pub-sub servers are up and connection is successful.`,
+  )
+  .action(
+    actionRunner(async () => await (await getHealthClient()).getPubSub()),
+  );
+
+health
+  .command(`get-queue-builds`)
+  .description(
+    `Get the number of builds that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueBuilds(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-certificates`)
+  .description(
+    `Get the number of certificates that are waiting to be issued against [Letsencrypt](https://letsencrypt.org/) in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueCertificates(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-databases`)
+  .description(
+    `Get the number of database changes that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(`--name <name>`, `Queue name for which to check the queue size`)
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ name, threshold }) =>
+        await (await getHealthClient()).getQueueDatabases(name, threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-deletes`)
+  .description(
+    `Get the number of background destructive changes that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueDeletes(threshold),
+    ),
+  );
+
+health
+  .command(`get-failed-jobs`)
+  .description(
+    `Returns the amount of failed jobs in a given queue.
+`,
+  )
+  .requiredOption(`--name <name>`, `The name of the queue`)
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ name, threshold }) =>
+        await (await getHealthClient()).getFailedJobs(name, threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-functions`)
+  .description(
+    `Get the number of function executions that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueFunctions(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-logs`)
+  .description(
+    `Get the number of logs that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueLogs(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-mails`)
+  .description(
+    `Get the number of mails that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueMails(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-messaging`)
+  .description(
+    `Get the number of messages that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueMessaging(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-migrations`)
+  .description(
+    `Get the number of migrations that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueMigrations(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-stats-resources`)
+  .description(
+    `Get the number of metrics that are waiting to be processed in the Appwrite stats resources queue.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueStatsResources(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-usage`)
+  .description(
+    `Get the number of metrics that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueUsage(threshold),
+    ),
+  );
+
+health
+  .command(`get-queue-webhooks`)
+  .description(
+    `Get the number of webhooks that are waiting to be processed in the Appwrite internal queue server.`,
+  )
+  .option(
+    `--threshold <threshold>`,
+    `Queue size threshold. When hit (equal or higher), endpoint returns server error. Default value is 5000.`,
+    parseInteger,
+  )
+  .action(
+    actionRunner(
+      async ({ threshold }) =>
+        await (await getHealthClient()).getQueueWebhooks(threshold),
+    ),
+  );
+
+health
+  .command(`get-storage`)
+  .description(
+    `Check the Appwrite storage device is up and connection is successful.`,
+  )
+  .action(
+    actionRunner(async () => await (await getHealthClient()).getStorage()),
+  );
+
+health
+  .command(`get-storage-local`)
+  .description(
+    `Check the Appwrite local storage device is up and connection is successful.`,
+  )
+  .action(
+    actionRunner(async () => await (await getHealthClient()).getStorageLocal()),
+  );
+
+health
+  .command(`get-time`)
+  .description(
+    `Check the Appwrite server time is synced with Google remote NTP server. We use this technology to smoothly handle leap seconds with no disruptive events. The [Network Time Protocol](https://en.wikipedia.org/wiki/Network_Time_Protocol) (NTP) is used by hundreds of millions of computers and devices to synchronize their clocks over the Internet. If your computer sets its own clock, it likely uses NTP.`,
+  )
+  .action(actionRunner(async () => await (await getHealthClient()).getTime()));

package/lib/commands/services/locale.ts

@@ -0,0 +1,99 @@
+import { Command } from "commander";
+import { sdkForProject } from "../../sdks.js";
+import {
+  actionRunner,
+  commandDescriptions,
+  parseBool,
+  parseInteger,
+} from "../../parser.js";
+import { Locale } from "@appwrite.io/console";
+
+let localeClient: Locale | null = null;
+
+const getLocaleClient = async (): Promise<Locale> => {
+  if (!localeClient) {
+    const sdkClient = await sdkForProject();
+    localeClient = new Locale(sdkClient);
+  }
+  return localeClient;
+};
+
+export const locale = new Command("locale")
+  .description(commandDescriptions["locale"] ?? "")
+  .configureHelp({
+    helpWidth: process.stdout.columns || 80,
+  });
+
+locale
+  .command(`get`)
+  .description(
+    `Get the current user location based on IP. Returns an object with user country code, country name, continent name, continent code, ip address and suggested currency. You can use the locale header to get the data in a supported language.
+
+([IP Geolocation by DB-IP](https://db-ip.com))`,
+  )
+  .action(actionRunner(async () => await (await getLocaleClient()).get()));
+
+locale
+  .command(`list-codes`)
+  .description(
+    `List of all locale codes in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).`,
+  )
+  .action(
+    actionRunner(async () => await (await getLocaleClient()).listCodes()),
+  );
+
+locale
+  .command(`list-continents`)
+  .description(
+    `List of all continents. You can use the locale header to get the data in a supported language.`,
+  )
+  .action(
+    actionRunner(async () => await (await getLocaleClient()).listContinents()),
+  );
+
+locale
+  .command(`list-countries`)
+  .description(
+    `List of all countries. You can use the locale header to get the data in a supported language.`,
+  )
+  .action(
+    actionRunner(async () => await (await getLocaleClient()).listCountries()),
+  );
+
+locale
+  .command(`list-countries-eu`)
+  .description(
+    `List of all countries that are currently members of the EU. You can use the locale header to get the data in a supported language.`,
+  )
+  .action(
+    actionRunner(async () => await (await getLocaleClient()).listCountriesEU()),
+  );
+
+locale
+  .command(`list-countries-phones`)
+  .description(
+    `List of all countries phone codes. You can use the locale header to get the data in a supported language.`,
+  )
+  .action(
+    actionRunner(
+      async () => await (await getLocaleClient()).listCountriesPhones(),
+    ),
+  );
+
+locale
+  .command(`list-currencies`)
+  .description(
+    `List of all currencies, including currency symbol, name, plural, and decimal digits for all major and minor currencies. You can use the locale header to get the data in a supported language.`,
+  )
+  .action(
+    actionRunner(async () => await (await getLocaleClient()).listCurrencies()),
+  );
+
+locale
+  .command(`list-languages`)
+  .description(
+    `List of all languages classified by ISO 639-1 including 2-letter code, name in English, and name in the respective language.`,
+  )
+  .action(
+    actionRunner(async () => await (await getLocaleClient()).listLanguages()),
+  );