appwrite-cli 10.0.1 → 10.2.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+## 10.2.1
+
+* Add transaction support for Databases and TablesDB
+
+## 10.1.0
+
+* Deprecate `createVerification` method in `Account` service
+* Add `createEmailVerification` method in `Account` service
+
 ## 10.0.1
 
 * Fix CLI Dart model generation issues

package/README.md

@@ -29,7 +29,7 @@ Once the installation is complete, you can verify the install using
 
 ```sh
 $ appwrite -v
-10.0.1
+10.2.1
 ```
 
 ### Install using prebuilt binaries
@@ -60,7 +60,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
-10.0.1
+10.2.1
 ```
 
 ## Getting Started 

package/docs/examples/account/create-email-verification.md

@@ -0,0 +1,2 @@
+appwrite account create-email-verification \
+    --url https://example.com

package/docs/examples/account/update-email-verification.md

@@ -0,0 +1,3 @@
+appwrite account update-email-verification \
+    --user-id <USER_ID> \
+    --secret <SECRET>

package/docs/examples/databases/create-operations.md

@@ -0,0 +1,2 @@
+appwrite databases create-operations \
+    --transaction-id <TRANSACTION_ID>

package/docs/examples/databases/create-transaction.md

@@ -0,0 +1 @@
+appwrite databases create-transaction

package/docs/examples/databases/delete-transaction.md

@@ -0,0 +1,2 @@
+appwrite databases delete-transaction \
+    --transaction-id <TRANSACTION_ID>

package/docs/examples/databases/get-transaction.md

@@ -0,0 +1,2 @@
+appwrite databases get-transaction \
+    --transaction-id <TRANSACTION_ID>

package/docs/examples/databases/list-transactions.md

@@ -0,0 +1 @@
+appwrite databases list-transactions

package/docs/examples/databases/update-transaction.md

@@ -0,0 +1,2 @@
+appwrite databases update-transaction \
+    --transaction-id <TRANSACTION_ID>

package/docs/examples/migrations/create-csv-migration.md

@@ -1,4 +1,4 @@
 appwrite migrations create-csv-migration \
     --bucket-id <BUCKET_ID> \
     --file-id <FILE_ID> \
-    --resource-id [ID1:ID2]
+    --resource-id <ID1:ID2>

package/docs/examples/tablesdb/create-operations.md

@@ -0,0 +1,2 @@
+appwrite tables-db create-operations \
+    --transaction-id <TRANSACTION_ID>

package/docs/examples/tablesdb/create-transaction.md

@@ -0,0 +1 @@
+appwrite tables-db create-transaction

package/docs/examples/tablesdb/delete-transaction.md

@@ -0,0 +1,2 @@
+appwrite tables-db delete-transaction \
+    --transaction-id <TRANSACTION_ID>

package/docs/examples/tablesdb/get-transaction.md

@@ -0,0 +1,2 @@
+appwrite tables-db get-transaction \
+    --transaction-id <TRANSACTION_ID>

package/docs/examples/tablesdb/list-transactions.md

@@ -0,0 +1 @@
+appwrite tables-db list-transactions

package/docs/examples/tablesdb/update-transaction.md

@@ -0,0 +1,2 @@
+appwrite tables-db update-transaction \
+    --transaction-id <TRANSACTION_ID>

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

package/install.sh

@@ -97,7 +97,7 @@ printSuccess() {
 downloadBinary() {
     echo "[2/4] Downloading executable for $OS ($ARCH) ..."
 
-    GITHUB_LATEST_VERSION="10.0.1"
+    GITHUB_LATEST_VERSION="10.2.1"
     GITHUB_FILE="appwrite-cli-${OS}-${ARCH}"
     GITHUB_URL="https://github.com/$GITHUB_REPOSITORY_NAME/releases/download/$GITHUB_LATEST_VERSION/$GITHUB_FILE"
 

package/lib/client.js

@@ -16,8 +16,8 @@ class Client {
       'x-sdk-name': 'Command Line',
       'x-sdk-platform': 'console',
       'x-sdk-language': 'cli',
-      'x-sdk-version': '10.0.1',
-      'user-agent' : `AppwriteCLI/10.0.1 (${os.type()} ${os.version()}; ${os.arch()})`,
+      'x-sdk-version': '10.2.1',
+      'user-agent' : `AppwriteCLI/10.2.1 (${os.type()} ${os.version()}; ${os.arch()})`,
       'X-Appwrite-Response-Format' : '1.8.0',
     };
   }

package/lib/commands/account.js

@@ -1527,6 +1527,39 @@ const accountCreatePhoneToken = async ({userId,phone,parseOutput = true, overrid
 
     return response;
 
+}
+/**
+ * @typedef {Object} AccountCreateEmailVerificationRequestParams
+ * @property {string} url URL to redirect the user back to your app from the verification email. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.
+ * @property {boolean} overrideForCli
+ * @property {boolean} parseOutput
+ * @property {libClient | undefined} sdk
+ */
+
+/**
+ * @param {AccountCreateEmailVerificationRequestParams} params
+ */
+const accountCreateEmailVerification = async ({url,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
+    let apiPath = '/account/verifications/email';
+    let payload = {};
+    if (typeof url !== 'undefined') {
+        payload['url'] = url;
+    }
+
+    let response = undefined;
+
+    response = await client.call('post', apiPath, {
+        'content-type': 'application/json',
+    }, payload);
+
+    if (parseOutput) {
+        parse(response)
+    }
+
+    return response;
+
 }
 /**
  * @typedef {Object} AccountCreateVerificationRequestParams
@@ -1542,7 +1575,7 @@ const accountCreatePhoneToken = async ({userId,phone,parseOutput = true, overrid
 const accountCreateVerification = async ({url,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
     let client = !sdk ? await sdkForProject() :
     sdk;
-    let apiPath = '/account/verification';
+    let apiPath = '/account/verifications/email';
     let payload = {};
     if (typeof url !== 'undefined') {
         payload['url'] = url;
@@ -1560,6 +1593,43 @@ const accountCreateVerification = async ({url,parseOutput = true, overrideForCli
 
     return response;
 
+}
+/**
+ * @typedef {Object} AccountUpdateEmailVerificationRequestParams
+ * @property {string} userId User ID.
+ * @property {string} secret Valid verification token.
+ * @property {boolean} overrideForCli
+ * @property {boolean} parseOutput
+ * @property {libClient | undefined} sdk
+ */
+
+/**
+ * @param {AccountUpdateEmailVerificationRequestParams} params
+ */
+const accountUpdateEmailVerification = async ({userId,secret,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
+    let client = !sdk ? await sdkForProject() :
+    sdk;
+    let apiPath = '/account/verifications/email';
+    let payload = {};
+    if (typeof userId !== 'undefined') {
+        payload['userId'] = userId;
+    }
+    if (typeof secret !== 'undefined') {
+        payload['secret'] = secret;
+    }
+
+    let response = undefined;
+
+    response = await client.call('put', apiPath, {
+        'content-type': 'application/json',
+    }, payload);
+
+    if (parseOutput) {
+        parse(response)
+    }
+
+    return response;
+
 }
 /**
  * @typedef {Object} AccountUpdateVerificationRequestParams
@@ -1576,7 +1646,7 @@ const accountCreateVerification = async ({url,parseOutput = true, overrideForCli
 const accountUpdateVerification = async ({userId,secret,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
     let client = !sdk ? await sdkForProject() :
     sdk;
-    let apiPath = '/account/verification';
+    let apiPath = '/account/verifications/email';
     let payload = {};
     if (typeof userId !== 'undefined') {
         payload['userId'] = userId;
@@ -1611,7 +1681,7 @@ const accountUpdateVerification = async ({userId,secret,parseOutput = true, over
 const accountCreatePhoneVerification = async ({parseOutput = true, overrideForCli = false, sdk = undefined}) => {
     let client = !sdk ? await sdkForProject() :
     sdk;
-    let apiPath = '/account/verification/phone';
+    let apiPath = '/account/verifications/phone';
     let payload = {};
 
     let response = undefined;
@@ -1642,7 +1712,7 @@ const accountCreatePhoneVerification = async ({parseOutput = true, overrideForCl
 const accountUpdatePhoneVerification = async ({userId,secret,parseOutput = true, overrideForCli = false, sdk = undefined}) => {
     let client = !sdk ? await sdkForProject() :
     sdk;
-    let apiPath = '/account/verification/phone';
+    let apiPath = '/account/verifications/phone';
     let payload = {};
     if (typeof userId !== 'undefined') {
         payload['userId'] = userId;
@@ -1949,16 +2019,29 @@ account
     .action(actionRunner(accountCreatePhoneToken))
 
 account
-    .command(`create-verification`)
+    .command(`create-email-verification`)
     .description(`Use this endpoint to send a verification message to your user email address to confirm they are the valid owners of that address. Both the **userId** and **secret** arguments will be passed as query parameters to the URL you have provided to be attached to the verification email. The provided URL should redirect the user back to your app and allow you to complete the verification process by verifying both the **userId** and **secret** parameters. Learn more about how to [complete the verification process](https://appwrite.io/docs/references/cloud/client-web/account#updateVerification). The verification link sent to the user's email address is valid for 7 days.  Please note that in order to avoid a [Redirect Attack](https://github.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.md), the only valid redirect URLs are the ones from domains you have set when adding your platforms in the console interface. `)
     .requiredOption(`--url <url>`, `URL to redirect the user back to your app from the verification email. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.`)
+    .action(actionRunner(accountCreateEmailVerification))
+
+account
+    .command(`create-verification`)
+    .description(`[**DEPRECATED** - This command is deprecated. Please use 'account create-email-verification' instead] Use this endpoint to send a verification message to your user email address to confirm they are the valid owners of that address. Both the **userId** and **secret** arguments will be passed as query parameters to the URL you have provided to be attached to the verification email. The provided URL should redirect the user back to your app and allow you to complete the verification process by verifying both the **userId** and **secret** parameters. Learn more about how to [complete the verification process](https://appwrite.io/docs/references/cloud/client-web/account#updateVerification). The verification link sent to the user's email address is valid for 7 days.  Please note that in order to avoid a [Redirect Attack](https://github.com/OWASP/CheatSheetSeries/blob/master/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.md), the only valid redirect URLs are the ones from domains you have set when adding your platforms in the console interface. `)
+    .requiredOption(`--url <url>`, `URL to redirect the user back to your app from the verification email. Only URLs from hostnames in your project platform list are allowed. This requirement helps to prevent an [open redirect](https://cheatsheetseries.owasp.org/cheatsheets/Unvalidated_Redirects_and_Forwards_Cheat_Sheet.html) attack against your project API.`)
     .action(actionRunner(accountCreateVerification))
 
 account
-    .command(`update-verification`)
+    .command(`update-email-verification`)
     .description(`Use this endpoint to complete the user email verification process. Use both the **userId** and **secret** parameters that were attached to your app URL to verify the user email ownership. If confirmed this route will return a 200 status code.`)
     .requiredOption(`--user-id <user-id>`, `User ID.`)
     .requiredOption(`--secret <secret>`, `Valid verification token.`)
+    .action(actionRunner(accountUpdateEmailVerification))
+
+account
+    .command(`update-verification`)
+    .description(`[**DEPRECATED** - This command is deprecated. Please use 'account update-email-verification' instead] Use this endpoint to complete the user email verification process. Use both the **userId** and **secret** parameters that were attached to your app URL to verify the user email ownership. If confirmed this route will return a 200 status code.`)
+    .requiredOption(`--user-id <user-id>`, `User ID.`)
+    .requiredOption(`--secret <secret>`, `Valid verification token.`)
     .action(actionRunner(accountUpdateVerification))
 
 account
@@ -2019,7 +2102,9 @@ module.exports = {
     accountCreateMagicURLToken,
     accountCreateOAuth2Token,
     accountCreatePhoneToken,
+    accountCreateEmailVerification,
     accountCreateVerification,
+    accountUpdateEmailVerification,
     accountUpdateVerification,
     accountCreatePhoneVerification,
     accountUpdatePhoneVerification