@appwrite.io/console 3.0.0 → 4.0.0

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

@@ -12,7 +12,8 @@ const result = await databases.listDocuments({
     collectionId: '<COLLECTION_ID>',
     queries: [], // optional
     transactionId: '<TRANSACTION_ID>', // optional
-    total: false // optional
+    total: false, // optional
+    ttl: 0 // optional
 });
 
 console.log(result);

package/docs/examples/domains/create-purchase.md

@@ -0,0 +1,25 @@
+```javascript
+import { Client, Domains } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const domains = new Domains(client);
+
+const result = await domains.createPurchase({
+    domain: '',
+    organizationId: '<ORGANIZATION_ID>',
+    firstName: '<FIRST_NAME>',
+    lastName: '<LAST_NAME>',
+    email: 'email@example.com',
+    phone: '+12065550100',
+    billingAddressId: '<BILLING_ADDRESS_ID>',
+    paymentMethodId: '<PAYMENT_METHOD_ID>',
+    addressLine3: '<ADDRESS_LINE3>', // optional
+    companyName: '<COMPANY_NAME>', // optional
+    periodYears: 1 // optional
+});
+
+console.log(result);
+```

package/docs/examples/domains/create-transfer-in.md

@@ -0,0 +1,18 @@
+```javascript
+import { Client, Domains } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const domains = new Domains(client);
+
+const result = await domains.createTransferIn({
+    domain: '',
+    organizationId: '<ORGANIZATION_ID>',
+    authCode: '<AUTH_CODE>',
+    paymentMethodId: '<PAYMENT_METHOD_ID>'
+});
+
+console.log(result);
+```

package/docs/examples/domains/create-transfer-out.md

@@ -0,0 +1,16 @@
+```javascript
+import { Client, Domains } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const domains = new Domains(client);
+
+const result = await domains.createTransferOut({
+    domainId: '<DOMAIN_ID>',
+    organizationId: '<ORGANIZATION_ID>'
+});
+
+console.log(result);
+```

package/docs/examples/domains/get-transfer-status.md

@@ -0,0 +1,15 @@
+```javascript
+import { Client, Domains } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const domains = new Domains(client);
+
+const result = await domains.getTransferStatus({
+    domainId: '<DOMAIN_ID>'
+});
+
+console.log(result);
+```

package/docs/examples/health/get-console-pausing.md

@@ -0,0 +1,16 @@
+```javascript
+import { Client, Health } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const health = new Health(client);
+
+const result = await health.getConsolePausing({
+    threshold: null, // optional
+    inactivityDays: null // optional
+});
+
+console.log(result);
+```

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

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, AppwriteMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.createAppwriteMigration({
-    resources: [Resources.User],
+    resources: [AppwriteMigrationResource.User],
     endpoint: 'https://example.com',
     projectId: '<PROJECT_ID>',
     apiKey: '<API_KEY>'

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

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, FirebaseMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.createFirebaseMigration({
-    resources: [Resources.User],
+    resources: [FirebaseMigrationResource.User],
     serviceAccount: '<SERVICE_ACCOUNT>'
 });
 

package/docs/examples/migrations/create-n-host-migration.md

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, NHostMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.createNHostMigration({
-    resources: [Resources.User],
+    resources: [NHostMigrationResource.User],
     subdomain: '<SUBDOMAIN>',
     region: '<REGION>',
     adminSecret: '<ADMIN_SECRET>',

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

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, SupabaseMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.createSupabaseMigration({
-    resources: [Resources.User],
+    resources: [SupabaseMigrationResource.User],
     endpoint: 'https://example.com',
     apiKey: '<API_KEY>',
     databaseHost: '<DATABASE_HOST>',

package/docs/examples/migrations/get-appwrite-report.md

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, AppwriteMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.getAppwriteReport({
-    resources: [Resources.User],
+    resources: [AppwriteMigrationResource.User],
     endpoint: 'https://example.com',
     projectID: '<PROJECT_ID>',
     key: '<KEY>'

package/docs/examples/migrations/get-firebase-report.md

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, FirebaseMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.getFirebaseReport({
-    resources: [Resources.User],
+    resources: [FirebaseMigrationResource.User],
     serviceAccount: '<SERVICE_ACCOUNT>'
 });
 

package/docs/examples/migrations/get-n-host-report.md

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, NHostMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.getNHostReport({
-    resources: [Resources.User],
+    resources: [NHostMigrationResource.User],
     subdomain: '<SUBDOMAIN>',
     region: '<REGION>',
     adminSecret: '<ADMIN_SECRET>',

package/docs/examples/migrations/get-supabase-report.md

@@ -1,5 +1,5 @@
 ```javascript
-import { Client, Migrations, Resources } from "@appwrite.io/console";
+import { Client, Migrations, SupabaseMigrationResource } from "@appwrite.io/console";
 
 const client = new Client()
     .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
@@ -8,7 +8,7 @@ const client = new Client()
 const migrations = new Migrations(client);
 
 const result = await migrations.getSupabaseReport({
-    resources: [Resources.User],
+    resources: [SupabaseMigrationResource.User],
     endpoint: 'https://example.com',
     apiKey: '<API_KEY>',
     databaseHost: '<DATABASE_HOST>',

package/docs/examples/organizations/get-scopes.md

@@ -8,7 +8,8 @@ const client = new Client()
 const organizations = new Organizations(client);
 
 const result = await organizations.getScopes({
-    organizationId: '<ORGANIZATION_ID>'
+    organizationId: '<ORGANIZATION_ID>',
+    projectId: '<PROJECT_ID>' // optional
 });
 
 console.log(result);

package/docs/examples/projects/update-console-access.md

@@ -0,0 +1,15 @@
+```javascript
+import { Client, Projects } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const projects = new Projects(client);
+
+const result = await projects.updateConsoleAccess({
+    projectId: '<PROJECT_ID>'
+});
+
+console.log(result);
+```

package/docs/examples/projects/update-status.md

@@ -0,0 +1,16 @@
+```javascript
+import { Client, Projects, Status } from "@appwrite.io/console";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const projects = new Projects(client);
+
+const result = await projects.updateStatus({
+    projectId: '<PROJECT_ID>',
+    status: Status.Active
+});
+
+console.log(result);
+```

package/docs/examples/sites/create-deployment.md

@@ -10,10 +10,10 @@ const sites = new Sites(client);
 const result = await sites.createDeployment({
     siteId: '<SITE_ID>',
     code: document.getElementById('uploader').files[0],
-    activate: false,
     installCommand: '<INSTALL_COMMAND>', // optional
     buildCommand: '<BUILD_COMMAND>', // optional
-    outputDirectory: '<OUTPUT_DIRECTORY>' // optional
+    outputDirectory: '<OUTPUT_DIRECTORY>', // optional
+    activate: false // optional
 });
 
 console.log(result);

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

@@ -12,7 +12,8 @@ const result = await tablesDB.listRows({
     tableId: '<TABLE_ID>',
     queries: [], // optional
     transactionId: '<TRANSACTION_ID>', // optional
-    total: false // optional
+    total: false, // optional
+    ttl: 0 // optional
 });
 
 console.log(result);

package/package.json

@@ -2,7 +2,7 @@
   "name": "@appwrite.io/console",
   "homepage": "https://appwrite.io/support",
   "description": "Appwrite is an open-source self-hosted backend server that abstracts and simplifies complex and repetitive development tasks behind a very simple REST API",
-  "version": "3.0.0",
+  "version": "4.0.0",
   "license": "BSD-3-Clause",
   "main": "dist/cjs/sdk.js",
   "exports": {

package/src/channel.ts

@@ -16,8 +16,14 @@ interface Resolved { _res: any }
 type Actionable = Document | Row | File | Team | Membership;
 
 function normalize(id: string): string {
-  const trimmed = id.trim();
-  return trimmed === "" ? "*" : trimmed;
+  if (id === undefined || id === null) {
+    throw new Error("Channel ID is required");
+  }
+  const trimmed = String(id).trim();
+  if (trimmed === "") {
+    throw new Error("Channel ID is required");
+  }
+  return trimmed;
 }
 
 export class Channel<T> {
@@ -44,9 +50,8 @@ export class Channel<T> {
 
   // --- DATABASE ROUTE ---
   // Only available on Channel<Database>
-  collection(this: Channel<Database>, id?: string): Channel<Collection> {
-    // Default: wildcard collection ID
-    return this.next<Collection>("collections", id ?? "*");
+  collection(this: Channel<Database>, id: string): Channel<Collection> {
+    return this.next<Collection>("collections", id);
   }
 
   // Only available on Channel<Collection>
@@ -56,9 +61,8 @@ export class Channel<T> {
   }
 
   // --- TABLESDB ROUTE ---
-  table(this: Channel<TablesDB>, id?: string): Channel<Table> {
-    // Default: wildcard table ID
-    return this.next<Table>("tables", id ?? "*");
+  table(this: Channel<TablesDB>, id: string): Channel<Table> {
+    return this.next<Table>("tables", id);
   }
 
   row(this: Channel<Table>, id?: string): Channel<Row> {
@@ -91,31 +95,31 @@ export class Channel<T> {
   }
 
   // --- ROOT FACTORIES ---
-  static database(id: string = "*") {
+  static database(id: string) {
     return new Channel<Database>(["databases", normalize(id)]);
   }
 
-  static execution(id: string = "*") {
+  static execution(id: string) {
     return new Channel<Execution>(["executions", normalize(id)]);
   }
 
-  static tablesdb(id: string = "*") {
+  static tablesdb(id: string) {
     return new Channel<TablesDB>(["tablesdb", normalize(id)]);
   }
 
-  static bucket(id: string = "*") {
+  static bucket(id: string) {
     return new Channel<Bucket>(["buckets", normalize(id)]);
   }
 
-  static function(id: string = "*") {
+  static function(id: string) {
     return new Channel<Func>(["functions", normalize(id)]);
   }
 
-  static team(id: string = "*") {
+  static team(id: string) {
     return new Channel<Team>(["teams", normalize(id)]);
   }
 
-  static membership(id: string = "*") {
+  static membership(id: string) {
     return new Channel<Membership>(["memberships", normalize(id)]);
   }
 

package/src/client.ts

@@ -7,6 +7,8 @@ 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');
 
 function isBigNumber(value: any): boolean {
     return value !== null
@@ -25,7 +27,10 @@ function reviver(_key: string, value: any): any {
             if (bi >= MIN_SAFE && bi <= MAX_SAFE) {
                 return Number(str);
             }
-            return bi;
+            if (bi >= MIN_INT64 && bi <= MAX_INT64) {
+                return bi;
+            }
+            return value.toNumber();
         }
         return value.toNumber();
     }
@@ -395,7 +400,7 @@ class Client {
         'x-sdk-name': 'Console',
         'x-sdk-platform': 'console',
         'x-sdk-language': 'web',
-        'x-sdk-version': '3.0.0',
+        'x-sdk-version': '4.0.0',
         'X-Appwrite-Response-Format': '1.8.0',
     };
 

package/src/enums/appwrite-migration-resource.ts

@@ -0,0 +1,21 @@
+export enum AppwriteMigrationResource {
+    User = 'user',
+    Team = 'team',
+    Membership = 'membership',
+    Database = 'database',
+    Table = 'table',
+    Column = 'column',
+    Index = 'index',
+    Row = 'row',
+    Document = 'document',
+    Attribute = 'attribute',
+    Collection = 'collection',
+    Bucket = 'bucket',
+    File = 'file',
+    Function = 'function',
+    Deployment = 'deployment',
+    Environmentvariable = 'environment-variable',
+    Site = 'site',
+    Sitedeployment = 'site-deployment',
+    Sitevariable = 'site-variable',
+}

package/src/enums/domain-transfer-status-status.ts

@@ -0,0 +1,10 @@
+export enum DomainTransferStatusStatus {
+    Transferrable = 'transferrable',
+    NotTransferrable = 'not_transferrable',
+    PendingOwner = 'pending_owner',
+    PendingAdmin = 'pending_admin',
+    PendingRegistry = 'pending_registry',
+    Completed = 'completed',
+    Cancelled = 'cancelled',
+    ServiceUnavailable = 'service_unavailable',
+}

package/src/enums/firebase-migration-resource.ts

@@ -0,0 +1,12 @@
+export enum FirebaseMigrationResource {
+    User = 'user',
+    Database = 'database',
+    Table = 'table',
+    Column = 'column',
+    Row = 'row',
+    Document = 'document',
+    Attribute = 'attribute',
+    Collection = 'collection',
+    Bucket = 'bucket',
+    File = 'file',
+}

package/src/enums/{resources.ts → n-host-migration-resource.ts}

@@ -1,4 +1,4 @@
-export enum Resources {
+export enum NHostMigrationResource {
     User = 'user',
     Database = 'database',
     Table = 'table',

package/src/enums/status.ts

@@ -0,0 +1,3 @@
+export enum Status {
+    Active = 'active',
+}

package/src/enums/supabase-migration-resource.ts

@@ -0,0 +1,13 @@
+export enum SupabaseMigrationResource {
+    User = 'user',
+    Database = 'database',
+    Table = 'table',
+    Column = 'column',
+    Index = 'index',
+    Row = 'row',
+    Document = 'document',
+    Attribute = 'attribute',
+    Collection = 'collection',
+    Bucket = 'bucket',
+    File = 'file',
+}

package/src/index.ts

@@ -71,7 +71,10 @@ export { ExecutionMethod } from './enums/execution-method';
 export { Name } from './enums/name';
 export { MessagePriority } from './enums/message-priority';
 export { SmtpEncryption } from './enums/smtp-encryption';
-export { Resources } from './enums/resources';
+export { AppwriteMigrationResource } from './enums/appwrite-migration-resource';
+export { FirebaseMigrationResource } from './enums/firebase-migration-resource';
+export { NHostMigrationResource } from './enums/n-host-migration-resource';
+export { SupabaseMigrationResource } from './enums/supabase-migration-resource';
 export { ProjectUsageRange } from './enums/project-usage-range';
 export { Region } from './enums/region';
 export { Api } from './enums/api';
@@ -80,6 +83,7 @@ export { PlatformType } from './enums/platform-type';
 export { ResourceType } from './enums/resource-type';
 export { ApiService } from './enums/api-service';
 export { SMTPSecure } from './enums/smtp-secure';
+export { Status } from './enums/status';
 export { EmailTemplateType } from './enums/email-template-type';
 export { EmailTemplateLocale } from './enums/email-template-locale';
 export { SmsTemplateType } from './enums/sms-template-type';
@@ -108,3 +112,4 @@ export { ProxyRuleDeploymentResourceType } from './enums/proxy-rule-deployment-r
 export { ProxyRuleStatus } from './enums/proxy-rule-status';
 export { MessageStatus } from './enums/message-status';
 export { BillingPlanGroup } from './enums/billing-plan-group';
+export { DomainTransferStatusStatus } from './enums/domain-transfer-status-status';