feat: Dart SDK update for version 23.1.0

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change Log
 
+## 23.1.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`
+
 ## 23.0.0
 
 * [BREAKING] Renamed Webhook model fields: `security` → `tls`, `httpUser` → `authUsername`, `httpPass` → `authPassword`, `signatureKey` → `secret`

README.md

@@ -7,7 +7,7 @@
 [![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)
 
-**This SDK is compatible with Appwrite server version 1.9.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-dart/releases).**
+**This SDK is compatible with Appwrite server version latest. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-dart/releases).**
 
  > This is the Dart SDK for integrating with Appwrite from your Dart server-side code. If you're looking for the Flutter SDK you should check [appwrite/sdk-for-flutter](https://github.com/appwrite/sdk-for-flutter)
 
@@ -21,7 +21,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  dart_appwrite: ^23.0.0
+  dart_appwrite: ^23.1.0
 ```
 
 You can install packages from the command line:

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

@@ -0,0 +1,21 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Databases databases = Databases(client);
+
+AttributeBigint result = await databases.createBigIntAttribute(
+    databaseId: '<DATABASE_ID>',
+    collectionId: '<COLLECTION_ID>',
+    key: '',
+    xrequired: false,
+    min: 0, // (optional)
+    max: 0, // (optional)
+    xdefault: 0, // (optional)
+    array: false, // (optional)
+);
+```

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

@@ -0,0 +1,21 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Databases databases = Databases(client);
+
+AttributeBigint result = await databases.updateBigIntAttribute(
+    databaseId: '<DATABASE_ID>',
+    collectionId: '<COLLECTION_ID>',
+    key: '',
+    xrequired: false,
+    xdefault: 0,
+    min: 0, // (optional)
+    max: 0, // (optional)
+    newKey: '', // (optional)
+);
+```

docs/examples/functions/create-variable.md

@@ -10,6 +10,7 @@ Functions functions = Functions(client);
 
 Variable result = await functions.createVariable(
     functionId: '<FUNCTION_ID>',
+    variableId: '<VARIABLE_ID>',
     key: '<KEY>',
     value: '<VALUE>',
     secret: false, // (optional)

docs/examples/functions/create.md

@@ -21,7 +21,7 @@ Func result = await functions.create(
     logging: false, // (optional)
     entrypoint: '<ENTRYPOINT>', // (optional)
     commands: '<COMMANDS>', // (optional)
-    scopes: [enums.Scopes.sessionsWrite], // (optional)
+    scopes: [enums.Scopes.projectRead], // (optional)
     installationId: '<INSTALLATION_ID>', // (optional)
     providerRepositoryId: '<PROVIDER_REPOSITORY_ID>', // (optional)
     providerBranch: '<PROVIDER_BRANCH>', // (optional)

docs/examples/functions/list-variables.md

@@ -10,5 +10,7 @@ Functions functions = Functions(client);
 
 VariableList result = await functions.listVariables(
     functionId: '<FUNCTION_ID>',
+    queries: [], // (optional)
+    total: false, // (optional)
 );
 ```

docs/examples/functions/update-variable.md

@@ -11,7 +11,7 @@ Functions functions = Functions(client);
 Variable result = await functions.updateVariable(
     functionId: '<FUNCTION_ID>',
     variableId: '<VARIABLE_ID>',
-    key: '<KEY>',
+    key: '<KEY>', // (optional)
     value: '<VALUE>', // (optional)
     secret: false, // (optional)
 );

docs/examples/functions/update.md

@@ -21,7 +21,7 @@ Func result = await functions.update(
     logging: false, // (optional)
     entrypoint: '<ENTRYPOINT>', // (optional)
     commands: '<COMMANDS>', // (optional)
-    scopes: [enums.Scopes.sessionsWrite], // (optional)
+    scopes: [enums.Scopes.projectRead], // (optional)
     installationId: '<INSTALLATION_ID>', // (optional)
     providerRepositoryId: '<PROVIDER_REPOSITORY_ID>', // (optional)
     providerBranch: '<PROVIDER_BRANCH>', // (optional)

docs/examples/presences/delete.md

@@ -0,0 +1,14 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Presences presences = Presences(client);
+
+await presences.delete(
+    presenceId: '<PRESENCE_ID>',
+);
+```

docs/examples/presences/get.md

@@ -0,0 +1,14 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Presences presences = Presences(client);
+
+Presence result = await presences.get(
+    presenceId: '<PRESENCE_ID>',
+);
+```

docs/examples/presences/list.md

@@ -0,0 +1,16 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Presences presences = Presences(client);
+
+PresenceList result = await presences.list(
+    queries: [], // (optional)
+    total: false, // (optional)
+    ttl: 0, // (optional)
+);
+```

docs/examples/presences/update-presence.md

@@ -0,0 +1,22 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+import 'package:dart_appwrite/permission.dart';
+import 'package:dart_appwrite/role.dart';
+
+Client client = 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
+
+Presences presences = Presences(client);
+
+Presence result = await presences.updatePresence(
+    presenceId: '<PRESENCE_ID>',
+    userId: '<USER_ID>',
+    status: '<STATUS>', // (optional)
+    expiresAt: '2020-10-15T06:38:00.000+00:00', // (optional)
+    metadata: {}, // (optional)
+    permissions: [Permission.read(Role.any())], // (optional)
+    purge: false, // (optional)
+);
+```

docs/examples/presences/upsert.md

@@ -0,0 +1,21 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+import 'package:dart_appwrite/permission.dart';
+import 'package:dart_appwrite/role.dart';
+
+Client client = 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
+
+Presences presences = Presences(client);
+
+Presence result = await presences.upsert(
+    presenceId: '<PRESENCE_ID>',
+    userId: '<USER_ID>',
+    status: '<STATUS>',
+    permissions: [Permission.read(Role.any())], // (optional)
+    expiresAt: '2020-10-15T06:38:00.000+00:00', // (optional)
+    metadata: {}, // (optional)
+);
+```

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

@@ -0,0 +1,16 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+import 'package:dart_appwrite/enums.dart' as enums;
+
+Client client = 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
+
+Project project = Project(client);
+
+EphemeralKey result = await project.createEphemeralKey(
+    scopes: [enums.Scopes.projectRead],
+    duration: 600,
+);
+```

docs/examples/project/create-key.md

@@ -12,7 +12,7 @@ Project project = Project(client);
 Key result = await project.createKey(
     keyId: '<KEY_ID>',
     name: '<NAME>',
-    scopes: [enums.Scopes.sessionsWrite],
+    scopes: [enums.Scopes.projectRead],
     expire: '2020-10-15T06:38:00.000+00:00', // (optional)
 );
 ```

docs/examples/project/create-mock-phone.md

@@ -0,0 +1,15 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Project project = Project(client);
+
+MockNumber result = await project.createMockPhone(
+    number: '+12065550100',
+    otp: '<OTP>',
+);
+```

docs/examples/project/create-smtp-test.md

@@ -0,0 +1,14 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Project project = Project(client);
+
+ result = await project.createSMTPTest(
+    emails: [],
+);
+```

docs/examples/project/delete-mock-phone.md

@@ -0,0 +1,14 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Project project = Project(client);
+
+await project.deleteMockPhone(
+    number: '+12065550100',
+);
+```

docs/examples/project/delete.md

@@ -0,0 +1,12 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Project project = Project(client);
+
+await project.delete();
+```

docs/examples/project/get-email-template.md

@@ -0,0 +1,16 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+import 'package:dart_appwrite/enums.dart' as enums;
+
+Client client = 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
+
+Project project = Project(client);
+
+EmailTemplate result = await project.getEmailTemplate(
+    templateId: enums.EmailTemplateType.verification,
+    locale: enums.EmailTemplateLocale.af, // (optional)
+);
+```

docs/examples/project/get-mock-phone.md

@@ -0,0 +1,14 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Project project = Project(client);
+
+MockNumber result = await project.getMockPhone(
+    number: '+12065550100',
+);
+```

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

@@ -0,0 +1,15 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+import 'package:dart_appwrite/enums.dart' as enums;
+
+Client client = 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
+
+Project project = Project(client);
+
+dynamic result = await project.getOAuth2Provider(
+    providerId: enums.ProviderId.amazon,
+);
+```

docs/examples/project/get-policy.md

@@ -0,0 +1,15 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+import 'package:dart_appwrite/enums.dart' as enums;
+
+Client client = 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
+
+Project project = Project(client);
+
+dynamic result = await project.getPolicy(
+    policyId: enums.PolicyId.passwordDictionary,
+);
+```

docs/examples/project/list-email-templates.md

@@ -0,0 +1,15 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Project project = Project(client);
+
+EmailTemplateList result = await project.listEmailTemplates(
+    queries: [], // (optional)
+    total: false, // (optional)
+);
+```

docs/examples/project/list-mock-phones.md

@@ -0,0 +1,15 @@
+```dart
+import 'package:dart_appwrite/dart_appwrite.dart';
+
+Client client = 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
+
+Project project = Project(client);
+
+MockNumberList result = await project.listMockPhones(
+    queries: [], // (optional)
+    total: false, // (optional)
+);
+```