feat: SDK update for version 20.2.0

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## 20.2.0
+
+* Added: Introduced `bigint` create/update APIs for legacy Databases attributes
+* Added: Introduced `bigint` create/update APIs for `TablesDB` columns
+* Updated: Extended key-list query filters with `key`, `resourceType`, `resourceId`, and `secret`
+
 ## 20.1.0
 
 * Added `--switch` and `--new` flags on `appwrite login` to explicitly manage multiple saved accounts

README.md

@@ -1,7 +1,7 @@
 # Appwrite Command Line SDK
 
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-cli.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.9.3-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.9.4-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![Twitter Account](https://img.shields.io/twitter/follow/appwrite?color=00acee&label=twitter&style=flat-square)](https://twitter.com/appwrite)
 [![Discord](https://img.shields.io/discord/564160730845151244?label=discord&style=flat-square)](https://appwrite.io/discord)
@@ -29,7 +29,7 @@ Once the installation is complete, you can verify the install using
 
 ```sh
 $ appwrite -v
-20.1.0
+20.2.0
 ```
 
 ### Install using prebuilt binaries
@@ -83,7 +83,7 @@ $ scoop install https://raw.githubusercontent.com/appwrite/sdk-for-cli/master/sc
 Once the installation completes, you can verify your install using
 ```
 $ appwrite -v
-20.1.0
+20.2.0
 ```
 
 ## Getting Started 

docs/examples/databases/create-big-int-attribute.md

@@ -0,0 +1,7 @@
+```bash
+appwrite databases create-big-int-attribute \
+    --database-id <DATABASE_ID> \
+    --collection-id <COLLECTION_ID> \
+    --key '' \
+    --required false
+```

docs/examples/databases/update-big-int-attribute.md

@@ -0,0 +1,8 @@
+```bash
+appwrite databases update-big-int-attribute \
+    --database-id <DATABASE_ID> \
+    --collection-id <COLLECTION_ID> \
+    --key '' \
+    --required false \
+    --default null
+```

docs/examples/functions/create-variable.md

@@ -1,6 +1,7 @@
 ```bash
 appwrite functions create-variable \
     --function-id <FUNCTION_ID> \
+    --variable-id <VARIABLE_ID> \
     --key <KEY> \
     --value <VALUE>
 ```

docs/examples/functions/list-variables.md

@@ -1,4 +1,5 @@
 ```bash
 appwrite functions list-variables \
-    --function-id <FUNCTION_ID>
+    --function-id <FUNCTION_ID> \
+    --limit 25
 ```

docs/examples/functions/update-variable.md

@@ -1,6 +1,5 @@
 ```bash
 appwrite functions update-variable \
     --function-id <FUNCTION_ID> \
-    --variable-id <VARIABLE_ID> \
-    --key <KEY>
+    --variable-id <VARIABLE_ID>
 ```

docs/examples/project/create-ephemeral-key.md

@@ -1,5 +1,5 @@
 ```bash
 appwrite project create-ephemeral-key \
     --scopes one two three \
-    --duration 1
+    --duration 600
 ```

docs/examples/project/get-o-auth-2-provider.md

@@ -1,4 +1,4 @@
 ```bash
 appwrite project get-o-auth-2-provider \
-    --provider <PROVIDER>
+    --provider-id amazon
 ```

docs/examples/project/list-o-auth-2-providers.md

@@ -1,3 +1,4 @@
 ```bash
-appwrite project list-o-auth-2-providers
+appwrite project list-o-auth-2-providers \
+    --limit 25
 ```

docs/examples/proxy/update-rule-status.md

@@ -0,0 +1,4 @@
+```bash
+appwrite proxy update-rule-status \
+    --rule-id <RULE_ID>
+```

docs/examples/sites/create-variable.md

@@ -1,6 +1,7 @@
 ```bash
 appwrite sites create-variable \
     --site-id <SITE_ID> \
+    --variable-id <VARIABLE_ID> \
     --key <KEY> \
     --value <VALUE>
 ```

docs/examples/sites/list-variables.md

@@ -1,4 +1,5 @@
 ```bash
 appwrite sites list-variables \
-    --site-id <SITE_ID>
+    --site-id <SITE_ID> \
+    --limit 25
 ```

docs/examples/sites/update-variable.md

@@ -1,6 +1,5 @@
 ```bash
 appwrite sites update-variable \
     --site-id <SITE_ID> \
-    --variable-id <VARIABLE_ID> \
-    --key <KEY>
+    --variable-id <VARIABLE_ID>
 ```

docs/examples/tablesdb/create-big-int-column.md

@@ -0,0 +1,7 @@
+```bash
+appwrite tables-db create-big-int-column \
+    --database-id <DATABASE_ID> \
+    --table-id <TABLE_ID> \
+    --key '' \
+    --required false
+```

docs/examples/tablesdb/update-big-int-column.md

@@ -0,0 +1,8 @@
+```bash
+appwrite tables-db update-big-int-column \
+    --database-id <DATABASE_ID> \
+    --table-id <TABLE_ID> \
+    --key '' \
+    --required false \
+    --default null
+```

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/20.1.0/appwrite-cli-win-x64.exe"
-$GITHUB_arm64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/20.1.0/appwrite-cli-win-arm64.exe"
+$GITHUB_x64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/20.2.0/appwrite-cli-win-x64.exe"
+$GITHUB_arm64_URL = "https://github.com/appwrite/sdk-for-cli/releases/download/20.2.0/appwrite-cli-win-arm64.exe"
 
 $APPWRITE_BINARY_NAME = "appwrite.exe"
 

install.sh

@@ -120,7 +120,7 @@ verifyMacOSCodeSignature() {
 downloadBinary() {
     echo "[2/5] Downloading executable for $OS ($ARCH) ..."
 
-    GITHUB_LATEST_VERSION="20.1.0"
+    GITHUB_LATEST_VERSION="20.2.0"
     GITHUB_FILE="appwrite-cli-${OS}-${ARCH}"
     GITHUB_URL="https://github.com/$GITHUB_REPOSITORY_NAME/releases/download/$GITHUB_LATEST_VERSION/$GITHUB_FILE"
 

lib/commands/services/databases.ts

@@ -367,6 +367,51 @@
   );
 
 
+const databasesCreateBigIntAttributeCommand = databases
+  .command(`create-big-int-attribute`)
+  .description(`Create a bigint attribute. Optionally, minimum and maximum values can be provided.
+`)
+  .requiredOption(`--database-id <database-id>`, `Database ID.`)
+  .requiredOption(`--collection-id <collection-id>`, `Collection ID.`)
+  .requiredOption(`--key <key>`, `Attribute Key.`)
+  .requiredOption(`--required <required>`, `Is attribute required?`, parseBool)
+  .option(`--min <min>`, `Minimum value`, parseInteger)
+  .option(`--max <max>`, `Maximum value`, parseInteger)
+  .option(`--xdefault <xdefault>`, `Default value. Cannot be set when attribute is required.`, parseInteger)
+  .option(
+    `--array [value]`,
+    `Is attribute an array?`,
+    (value: string | undefined) =>
+      value === undefined ? true : parseBool(value),
+  )
+  .action(
+    actionRunner(
+      async ({ databaseId, collectionId, key, required, min, max, xdefault, array }) =>
+        parse(await (await getDatabasesClient()).createBigIntAttribute(databaseId, collectionId, key, required, min, max, xdefault, array)),
+    ),
+  );
+
+
+const databasesUpdateBigIntAttributeCommand = databases
+  .command(`update-big-int-attribute`)
+  .description(`Update a bigint attribute. Changing the \`default\` value will not update already existing documents.
+`)
+  .requiredOption(`--database-id <database-id>`, `Database ID.`)
+  .requiredOption(`--collection-id <collection-id>`, `Collection ID.`)
+  .requiredOption(`--key <key>`, `Attribute Key.`)
+  .requiredOption(`--required <required>`, `Is attribute required?`, parseBool)
+  .requiredOption(`--xdefault <xdefault>`, `Default value. Cannot be set when attribute is required.`, parseInteger)
+  .option(`--min <min>`, `Minimum value`, parseInteger)
+  .option(`--max <max>`, `Maximum value`, parseInteger)
+  .option(`--new-key <new-key>`, `New Attribute Key.`)
+  .action(
+    actionRunner(
+      async ({ databaseId, collectionId, key, required, xdefault, min, max, newKey }) =>
+        parse(await (await getDatabasesClient()).updateBigIntAttribute(databaseId, collectionId, key, required, xdefault, min, max, newKey)),
+    ),
+  );
+
+
 const databasesCreateBooleanAttributeCommand = databases
   .command(`create-boolean-attribute`)
   .description(`Create a boolean attribute.

lib/commands/services/functions.ts

@@ -513,10 +513,24 @@
   .command(`list-variables`)
   .description(`Get a list of all variables of a specific function.`)
   .requiredOption(`--function-id <function-id>`, `Function unique ID.`)
+  .option(`--queries [queries...]`, `Raw Appwrite JSON query strings (legacy). Use this for advanced queries or automation; for common filtering, sorting, and pagination prefer --where, --sort-asc, --sort-desc, --limit, and --offset. When mixed, raw --queries are sent before generated flag 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: key, resourceType, resourceId, secret`)
+  .option(
+    `--total [value]`,
+    `When set to false, the total count returned will be 0 and will not be calculated.`,
+    (value: string | undefined) =>
+      value === undefined ? true : parseBool(value),
+  )
+  .option(`--where <expression>`, `Filter using a simple comparison expression. Repeat for multiple filters. Supports field=value, field!=value, field>value, field>=value, field<value, and field<=value.`, (value: string, previous: string[] | undefined) => collectQueryValue(parseWhereQuery(value), previous))
+  .option(`--sort-asc <attribute>`, `Sort results by an attribute in ascending order. Repeat for multiple sort fields.`, (value: string, previous: string[] | undefined) => collectQueryValue(value, previous))
+  .option(`--sort-desc <attribute>`, `Sort results by an attribute in descending order. Repeat for multiple sort fields.`, (value: string, previous: string[] | undefined) => collectQueryValue(value, previous))
+  .option(`--limit <limit>`, `Maximum number of results to return.`, parseInteger)
+  .option(`--offset <offset>`, `Number of results to skip.`, parseInteger)
+  .option(`--cursor-after <id>`, `Return results after this cursor ID.`)
+  .option(`--cursor-before <id>`, `Return results before this cursor ID.`)
   .action(
     actionRunner(
-      async ({ functionId }) =>
-        parse(await (await getFunctionsClient()).listVariables(functionId)),
+      async ({ functionId, queries, total, where, sortAsc, sortDesc, cursorAfter, cursorBefore, limit, offset }) =>
+        parse(await (await getFunctionsClient()).listVariables(functionId, buildQueries({ queries, where, sortAsc, sortDesc, cursorAfter, cursorBefore, limit, offset }), total)),
     ),
   );
 
@@ -525,6 +539,7 @@
   .command(`create-variable`)
   .description(`Create a new function environment variable. These variables can be accessed in the function at runtime as environment variables.`)
   .requiredOption(`--function-id <function-id>`, `Function unique ID.`)
+  .requiredOption(`--variable-id <variable-id>`, `Variable ID. Choose a custom ID or generate a random ID with \`ID.unique()\`. Valid chars are a-z, A-Z, 0-9, period, hyphen, and underscore. Can't start with a special char. Max length is 36 chars.`)
   .requiredOption(`--key <key>`, `Variable key. Max length: 255 chars.`)
   .requiredOption(`--value <value>`, `Variable value. Max length: 8192 chars.`)
   .option(
@@ -535,8 +550,8 @@
   )
   .action(
     actionRunner(
-      async ({ functionId, key, value, secret }) =>
-        parse(await (await getFunctionsClient()).createVariable(functionId, key, value, secret)),
+      async ({ functionId, variableId, key, value, secret }) =>
+        parse(await (await getFunctionsClient()).createVariable(functionId, variableId, key, value, secret)),
     ),
   );
 
@@ -559,7 +574,7 @@
   .description(`Update variable by its unique ID.`)
   .requiredOption(`--function-id <function-id>`, `Function unique ID.`)
   .requiredOption(`--variable-id <variable-id>`, `Variable unique ID.`)
-  .requiredOption(`--key <key>`, `Variable key. Max length: 255 chars.`)
+  .option(`--key <key>`, `Variable key. Max length: 255 chars.`)
   .option(`--value <value>`, `Variable value. Max length: 8192 chars.`)
   .option(
     `--secret [value]`,

lib/commands/services/migrations.ts

@@ -64,10 +64,11 @@
   .requiredOption(`--endpoint <endpoint>`, `Source Appwrite endpoint`)
   .requiredOption(`--project-id <project-id>`, `Source Project ID`)
   .requiredOption(`--api-key <api-key>`, `Source API Key`)
+  .option(`--on-duplicate <on-duplicate>`, `Behavior when a row with an existing $id is encountered. "fail" (default): abort on first conflict. "skip": silently ignore. "overwrite": replace existing row.`)
   .action(
     actionRunner(
-      async ({ resources, endpoint, projectId, apiKey }) =>
-        parse(await (await getMigrationsClient()).createAppwriteMigration(resources, endpoint, projectId, apiKey)),
+      async ({ resources, endpoint, projectId, apiKey, onDuplicate }) =>
+        parse(await (await getMigrationsClient()).createAppwriteMigration(resources, endpoint, projectId, apiKey, onDuplicate)),
     ),
   );
 
@@ -136,10 +137,11 @@
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
+  .option(`--on-duplicate <on-duplicate>`, `Behavior when a row with an existing $id is encountered. "fail" (default): abort on first conflict. "skip": silently ignore. "overwrite": replace existing row.`)
   .action(
     actionRunner(
-      async ({ bucketId, fileId, resourceId, internalFile }) =>
-        parse(await (await getMigrationsClient()).createCSVImport(bucketId, fileId, resourceId, internalFile)),
+      async ({ bucketId, fileId, resourceId, internalFile, onDuplicate }) =>
+        parse(await (await getMigrationsClient()).createCSVImport(bucketId, fileId, resourceId, internalFile, onDuplicate)),
     ),
   );
 
@@ -212,10 +214,11 @@
     (value: string | undefined) =>
       value === undefined ? true : parseBool(value),
   )
+  .option(`--on-duplicate <on-duplicate>`, `Behavior when a row with an existing $id is encountered. "fail" (default): abort on first conflict. "skip": silently ignore. "overwrite": replace existing row.`)
   .action(
     actionRunner(
-      async ({ bucketId, fileId, resourceId, internalFile }) =>
-        parse(await (await getMigrationsClient()).createJSONImport(bucketId, fileId, resourceId, internalFile)),
+      async ({ bucketId, fileId, resourceId, internalFile, onDuplicate }) =>
+        parse(await (await getMigrationsClient()).createJSONImport(bucketId, fileId, resourceId, internalFile, onDuplicate)),
     ),
   );