feat: SDK update for version 29.4.0

CHANGELOG.md

@@ -1,5 +1,25 @@
 # Change Log
 
+## 29.4.0
+
+* Added: `domains` service to manage domains, DNS records, email presets, prices, transfer status and zones
+* Added: `waf` service with bypass, challenge, deny, rate-limit and redirect rules
+* Added: `account.createEmailVerificationOTP`, `updateEmailVerificationOTP`, `createRecoveryOTP` and `updateRecoveryOTP`
+* Added: `account.createIdTokenSession` and `Identity.providerIdToken`
+* Added: `oauth2.introspect`
+* Added: project environments with `project.createEnvironment`, `getEnvironment`, `listEnvironments`, `updateEnvironment` and `deleteEnvironment`
+* Added: `organization.createEphemeralProjectKey`, `listProjectKeys`, `getProjectKey`, `updateProjectKey` and `deleteProjectKey`
+* Added: Kakao, TikTok and Webflow OAuth2 providers with `project.updateOAuth2Kakao`, `updateOAuth2TikTok` and `updateOAuth2Webflow`
+* Added: optional `prompt` on the Auth0, Discord, GitHub, Microsoft, Okta, Salesforce and Zoho OAuth2 settings, and native client IDs on Apple and Google
+* Added: `project.updatePasswordPwnedPolicy`, `project.updatePasswordRotationPolicy` and `User.passwordPwned`
+* Added: `messaging.createAppwriteProvider` and `messaging.updateAppwriteProvider`
+* Added: optional `replyToEmail` and `replyToName` on email messages, `channelId` on push messages, and `qos` and `expiry` on topics
+* Added: `avatars.updatePhoto` and `avatars.deletePhoto`
+* Added: optional `duration` on `account.createEmailPasswordSession`, `current` on `account.deleteSessions`, `membershipId` on `teams.createMembership` and `fingerprints` on Android platforms
+* Added: optional `total` on the locale, transaction, runtime, specification and framework lists
+* Added: `dart-3.13` and `flutter-3.47` runtimes, the `jaspr` framework, the `trigram` index type, `auto` image gravity, the `dedicatedDatabase` proxy rule resource type, OTP email templates and new key scopes
+* Added: optional fields on `BillingPlan`, `DedicatedDatabase`, `DedicatedDatabaseSpecification`, `Project` and `Topic`, and `free` and `start` in `BillingPlanGroup`
+
 ## 29.3.1
 
 * Fixed: added `ProjectAuthMethodId.Passkey`, so `project.updateAuthMethod` can enable passkeys

docs/examples/account/create-email-password-session.md

@@ -11,5 +11,6 @@ const account = new sdk.Account(client);
 const result = await account.createEmailPasswordSession({
     email: 'email@example.com',
     password: 'password',
+    duration: 60, // optional
 });
 ```

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

@@ -0,0 +1,14 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const account = new sdk.Account(client);
+
+const result = await account.createEmailVerificationOTP({
+    phrase: false, // optional
+});
+```

docs/examples/account/create-id-token-session.md

@@ -0,0 +1,19 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const account = new sdk.Account(client);
+
+const result = await account.createIdTokenSession({
+    provider: sdk.IdTokenProvider.Apple,
+    idToken: '<ID_TOKEN>',
+    nonce: '<NONCE>', // optional
+    accessToken: '<ACCESS_TOKEN>', // optional
+    accessTokenExpiry: 0, // optional
+    name: '<NAME>', // optional
+});
+```

docs/examples/account/create-recovery-otp.md

@@ -0,0 +1,15 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const account = new sdk.Account(client);
+
+const result = await account.createRecoveryOTP({
+    email: 'email@example.com',
+    phrase: false, // optional
+});
+```

docs/examples/account/delete-sessions.md

@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const account = new sdk.Account(client);
 
-const result = await account.deleteSessions();
+const result = await account.deleteSessions({
+    current: false, // optional
+});
 ```

docs/examples/account/list-sessions.md

@@ -8,5 +8,7 @@ const client = new sdk.Client()
 
 const account = new sdk.Account(client);
 
-const result = await account.listSessions();
+const result = await account.listSessions({
+    total: false, // optional
+});
 ```

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

@@ -0,0 +1,15 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const account = new sdk.Account(client);
+
+const result = await account.updateEmailVerificationOTP({
+    userId: '<USER_ID>',
+    secret: '<SECRET>',
+});
+```

docs/examples/account/update-recovery-otp.md

@@ -0,0 +1,16 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const account = new sdk.Account(client);
+
+const result = await account.updateRecoveryOTP({
+    userId: '<USER_ID>',
+    secret: '<SECRET>',
+    password: 'password',
+});
+```

docs/examples/avatars/delete-photo.md

@@ -0,0 +1,12 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const avatars = new sdk.Avatars(client);
+
+const result = await avatars.deletePhoto();
+```

docs/examples/avatars/update-photo.md

@@ -0,0 +1,15 @@
+```javascript
+const sdk = require('node-appwrite');
+const { InputFile } = require('node-appwrite/file');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setSession(''); // The user session to authenticate with
+
+const avatars = new sdk.Avatars(client);
+
+const result = await avatars.updatePhoto({
+    file: InputFile.fromPath('/path/to/file', 'filename'),
+});
+```

docs/examples/databases/list-transactions.md

@@ -10,5 +10,6 @@ const databases = new sdk.Databases(client);
 
 const result = await databases.listTransactions({
     queries: [], // optional
+    total: false, // optional
 });
 ```

docs/examples/documentsdb/list-transactions.md

@@ -10,5 +10,6 @@ const documentsDB = new sdk.DocumentsDB(client);
 
 const result = await documentsDB.listTransactions({
     queries: [], // optional
+    total: false, // optional
 });
 ```

docs/examples/domains/create-preset-google-workspace.md

@@ -0,0 +1,14 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createPresetGoogleWorkspace({
+    domainId: '<DOMAIN_ID>',
+});
+```

docs/examples/domains/create-preset-i-cloud.md

@@ -0,0 +1,14 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createPresetICloud({
+    domainId: '<DOMAIN_ID>',
+});
+```

docs/examples/domains/create-preset-mailgun.md

@@ -0,0 +1,14 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createPresetMailgun({
+    domainId: '<DOMAIN_ID>',
+});
+```

docs/examples/domains/create-preset-outlook.md

@@ -0,0 +1,14 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createPresetOutlook({
+    domainId: '<DOMAIN_ID>',
+});
+```

docs/examples/domains/create-preset-proton-mail.md

@@ -0,0 +1,14 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createPresetProtonMail({
+    domainId: '<DOMAIN_ID>',
+});
+```

docs/examples/domains/create-preset-zoho.md

@@ -0,0 +1,14 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createPresetZoho({
+    domainId: '<DOMAIN_ID>',
+});
+```

docs/examples/domains/create-record-a.md

@@ -0,0 +1,18 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createRecordA({
+    domainId: '<DOMAIN_ID>',
+    name: '',
+    value: '',
+    ttl: 1,
+    comment: '<COMMENT>', // optional
+});
+```

docs/examples/domains/create-record-aaaa.md

@@ -0,0 +1,18 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createRecordAAAA({
+    domainId: '<DOMAIN_ID>',
+    name: '',
+    value: '',
+    ttl: 1,
+    comment: '<COMMENT>', // optional
+});
+```

docs/examples/domains/create-record-alias.md

@@ -0,0 +1,18 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createRecordAlias({
+    domainId: '<DOMAIN_ID>',
+    name: '',
+    value: '<VALUE>',
+    ttl: 1,
+    comment: '<COMMENT>', // optional
+});
+```

docs/examples/domains/create-record-caa.md

@@ -0,0 +1,18 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createRecordCAA({
+    domainId: '<DOMAIN_ID>',
+    name: '',
+    value: '',
+    ttl: 1,
+    comment: '<COMMENT>', // optional
+});
+```

docs/examples/domains/create-record-cname.md

@@ -0,0 +1,18 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createRecordCNAME({
+    domainId: '<DOMAIN_ID>',
+    name: '',
+    value: '<VALUE>',
+    ttl: 1,
+    comment: '<COMMENT>', // optional
+});
+```

docs/examples/domains/create-record-https.md

@@ -0,0 +1,18 @@
+```javascript
+const sdk = require('node-appwrite');
+
+const client = new sdk.Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>') // Your project ID
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
+
+const domains = new sdk.Domains(client);
+
+const result = await domains.createRecordHTTPS({
+    domainId: '<DOMAIN_ID>',
+    name: '',
+    value: '<VALUE>',
+    ttl: 1,
+    comment: '<COMMENT>', // optional
+});
+```