feat: Command Line SDK update for version 23.2.0

.github/workflows/publish.yml

@@ -154,11 +154,20 @@ jobs:
           GHR_REPLACE: false
           GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
 
+      - name: Generate Appwrite Bot token for Homebrew tap
+        id: bot-token
+        uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
+        with:
+          app-id: ${{ vars.APPWRITE_BOT_APP_ID }}
+          private-key: ${{ secrets.APPWRITE_BOT_PRIVATE_KEY }}
+          owner: appwrite
+          repositories: homebrew-appwrite
+
       - name: Check out Homebrew tap
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
           repository: ${{ env.HOMEBREW_TAP_REPO }}
-          token: ${{ secrets.HOMEBREW_TAP_GH_TOKEN }}
+          token: ${{ steps.bot-token.outputs.token }}
           path: homebrew-tap
           fetch-depth: 0
 
@@ -225,7 +234,7 @@ jobs:
           FORMULA_PATH: ${{ steps.tap.outputs.formula_path }}
           SOURCE_REPO: ${{ github.repository }}
           SERVER_URL: ${{ github.server_url }}
-          GH_TOKEN: ${{ secrets.HOMEBREW_TAP_GH_TOKEN }}
+          GH_TOKEN: ${{ steps.bot-token.outputs.token }}
         run: |
           set -euo pipefail
 
@@ -237,8 +246,8 @@ jobs:
           BASE_BRANCH="$(gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name')"
           BRANCH="release/${EXECUTABLE_NAME}-${RELEASE_TAG}"
 
-          git config user.name "appwrite-bot"
-          git config user.email "bot@appwrite.io"
+          git config user.name "appwrite-bot[bot]"
+          git config user.email "217594562+appwrite-bot[bot]@users.noreply.github.com"
 
           git checkout -B "$BRANCH"
           git add "$FORMULA_PATH"

CHANGELOG.md

@@ -1,5 +1,21 @@
 # Change Log
 
+## 23.2.0
+
+* Added: `apps` installation commands: `list-installations`, `get-installation`, `delete-installation`, `create-installation-token`
+* Added: `vcs list-namespaces` command for listing provider namespaces of an installation
+* Added: `--provider-namespace` option to `vcs create-repository`
+* Added: `tablesdb list-operations` command for dedicated database lifecycle operations
+* Added: Compact deployment summaries with human-readable sizes in deployment output
+* Added: `--filter`, `--where`, `--sort-asc`, `--sort-desc`, `--limit`, `--offset`, `--cursor-after`, and `--cursor-before` options to `vcs list-repositories` and `activities list-events`
+* Updated: Command groups now use compact service names: `tablesdb` and `oauth2`. `tables-db` still works as an alias
+* Updated: `apps` command group now shows a service description in help output
+* Updated: `storage list-files` documents `folder` as a filterable attribute
+* Fixed: `push sites` and `pull sites` now carry `fallbackFile` and the VCS fields `installationId`, `providerRepositoryId`, `providerBranch`, `providerSilentMode`, and `providerRootDirectory`
+* Fixed: Symlinks in function directories are resolved for `run` and `push`, confined to the project root
+* Fixed: Token refresh now uses the logged-in session endpoint, and session credentials are no longer sent to a different endpoint
+* Fixed: Site screenshot previews preserve the configured region
+
 ## 23.1.0
 
 * Added: `apps` service commands for managing OAuth2 applications, keys, secrets, and installations

README.md

@@ -29,7 +29,7 @@ Once the installation is complete, you can verify the install using
 
 ```sh
 $ appwrite -v
-23.1.0
+23.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
-23.1.0
+23.2.0
 ```
 
 ## Getting Started 

cli.ts

@@ -45,15 +45,15 @@ 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 { notifications } from './lib/commands/services/notifications.js';
-import { oauth2 } from './lib/commands/services/oauth-2.js';
+import { oauth2 } from './lib/commands/services/oauth2.js';
 import { organization } from './lib/commands/services/organization.js';
 import { organizations } from './lib/commands/services/organizations.js';
 import { presences } from './lib/commands/services/presences.js';
 import { project } from './lib/commands/services/project.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/tables-db.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';

docs/examples/activities/list-events.md

@@ -1,3 +1,4 @@
 ```bash
-appwrite activities list-events
+appwrite activities list-events \
+    --limit 25
 ```

docs/examples/apps/create-installation-token.md

@@ -0,0 +1,5 @@
+```bash
+appwrite apps create-installation-token \
+    --app-id <APP_ID> \
+    --installation-id <INSTALLATION_ID>
+```

docs/examples/apps/delete-installation.md

@@ -0,0 +1,5 @@
+```bash
+appwrite apps delete-installation \
+    --app-id <APP_ID> \
+    --installation-id <INSTALLATION_ID>
+```

docs/examples/apps/get-installation.md

@@ -0,0 +1,5 @@
+```bash
+appwrite apps get-installation \
+    --app-id <APP_ID> \
+    --installation-id <INSTALLATION_ID>
+```

docs/examples/apps/list-installations.md

@@ -0,0 +1,5 @@
+```bash
+appwrite apps list-installations \
+    --app-id <APP_ID> \
+    --limit 25
+```

docs/examples/oauth2/authorize-post.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite oauth-2 authorize-post
+appwrite oauth2 authorize-post
 ```

docs/examples/oauth2/authorize.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite oauth-2 authorize
+appwrite oauth2 authorize
 ```

docs/examples/oauth2/create-device-authorization.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite oauth-2 create-device-authorization
+appwrite oauth2 create-device-authorization
 ```

docs/examples/oauth2/create-grant.md

@@ -1,4 +1,4 @@
 ```bash
-appwrite oauth-2 create-grant \
+appwrite oauth2 create-grant \
     --user-_code <USER_CODE>
 ```

docs/examples/oauth2/create-par.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite oauth-2 create-par \
+appwrite oauth2 create-par \
     --client-_id <CLIENT_ID> \
     --redirect-_uri https://example.com \
     --response-_type code

docs/examples/oauth2/create-token.md

@@ -1,4 +1,4 @@
 ```bash
-appwrite oauth-2 create-token \
+appwrite oauth2 create-token \
     --grant-_type <GRANT_TYPE>
 ```

docs/examples/oauth2/get-grant.md

@@ -1,4 +1,4 @@
 ```bash
-appwrite oauth-2 get-grant \
+appwrite oauth2 get-grant \
     --grant-_id <GRANT_ID>
 ```

docs/examples/oauth2/list-organizations.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite oauth-2 list-organizations
+appwrite oauth2 list-organizations
 ```

docs/examples/oauth2/list-projects.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite oauth-2 list-projects
+appwrite oauth2 list-projects
 ```

docs/examples/oauth2/logout-post.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite oauth-2 logout-post
+appwrite oauth2 logout-post
 ```

docs/examples/oauth2/logout.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite oauth-2 logout
+appwrite oauth2 logout
 ```

docs/examples/oauth2/reject.md

@@ -1,4 +1,4 @@
 ```bash
-appwrite oauth-2 reject \
+appwrite oauth2 reject \
     --grant-_id <GRANT_ID>
 ```

docs/examples/oauth2/revoke.md

@@ -1,4 +1,4 @@
 ```bash
-appwrite oauth-2 revoke \
+appwrite oauth2 revoke \
     --token <TOKEN>
 ```

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

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

docs/examples/tablesdb/create-boolean-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-boolean-column \
+appwrite tablesdb create-boolean-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-datetime-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-datetime-column \
+appwrite tablesdb create-datetime-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-email-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-email-column \
+appwrite tablesdb create-email-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-enum-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-enum-column \
+appwrite tablesdb create-enum-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-failover.md

@@ -1,4 +1,4 @@
 ```bash
-appwrite tables-db create-failover \
+appwrite tablesdb create-failover \
     --database-id <DATABASE_ID>
 ```

docs/examples/tablesdb/create-float-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-float-column \
+appwrite tablesdb create-float-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-index.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-index \
+appwrite tablesdb create-index \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-integer-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-integer-column \
+appwrite tablesdb create-integer-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-ip-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-ip-column \
+appwrite tablesdb create-ip-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-line-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-line-column \
+appwrite tablesdb create-line-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-longtext-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-longtext-column \
+appwrite tablesdb create-longtext-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-mediumtext-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-mediumtext-column \
+appwrite tablesdb create-mediumtext-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-migration.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-migration \
+appwrite tablesdb create-migration \
     --database-id <DATABASE_ID> \
     --specification s-1vcpu-1gb
 ```

docs/examples/tablesdb/create-operations.md

@@ -1,4 +1,4 @@
 ```bash
-appwrite tables-db create-operations \
+appwrite tablesdb create-operations \
     --transaction-id <TRANSACTION_ID>
 ```

docs/examples/tablesdb/create-point-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-point-column \
+appwrite tablesdb create-point-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-polygon-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-polygon-column \
+appwrite tablesdb create-polygon-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-relationship-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-relationship-column \
+appwrite tablesdb create-relationship-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --related-table-id <RELATED_TABLE_ID> \

docs/examples/tablesdb/create-row.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-row \
+appwrite tablesdb create-row \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --row-id <ROW_ID> \

docs/examples/tablesdb/create-rows.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-rows \
+appwrite tablesdb create-rows \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --rows one two three

docs/examples/tablesdb/create-string-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-string-column \
+appwrite tablesdb create-string-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-table.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-table \
+appwrite tablesdb create-table \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --name <NAME>

docs/examples/tablesdb/create-text-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-text-column \
+appwrite tablesdb create-text-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-transaction.md

@@ -1,3 +1,3 @@
 ```bash
-appwrite tables-db create-transaction
+appwrite tablesdb create-transaction
 ```

docs/examples/tablesdb/create-url-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-url-column \
+appwrite tablesdb create-url-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create-varchar-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create-varchar-column \
+appwrite tablesdb create-varchar-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --key '' \

docs/examples/tablesdb/create.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db create \
+appwrite tablesdb create \
     --database-id <DATABASE_ID> \
     --name <NAME>
 ```

docs/examples/tablesdb/decrement-row-column.md

@@ -1,5 +1,5 @@
 ```bash
-appwrite tables-db decrement-row-column \
+appwrite tablesdb decrement-row-column \
     --database-id <DATABASE_ID> \
     --table-id <TABLE_ID> \
     --row-id <ROW_ID> \