Merge pull request #115 from appwrite/dev

premtsd-code · web-flow · commit 44b2ff601f89 · 2026-05-20T10:37:33.000+01:00
feat: Dart SDK update for version 24.1.0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Change Log
 
+## 24.1.0
+
+* Added `sizeActual` field to `File` model for actual stored size after compression/encryption
+* Added `deno-1.21`, `deno-1.24`, and `deno-1.35` to `BuildRuntime` and `Runtime` enums
+* Updated `BillingLimits` fields to be nullable to match the server's sparse "limits crossed" response
+* Updated `Project.billingLimits` to be nullable
+* Updated advisor example docs to use API key authentication
+
 ## 24.0.0
 
 * Breaking: Renamed `AuthMethod` enum to `ProjectAuthMethodId`
diff --git a/README.md b/README.md
@@ -21,7 +21,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  dart_appwrite: ^24.0.0
+  dart_appwrite: ^24.1.0
 ```
 
 You can install packages from the command line:
diff --git a/docs/examples/advisor/get-insight.md b/docs/examples/advisor/get-insight.md
@@ -4,7 +4,7 @@ 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
-    .setSession(''); // The user session to authenticate with
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
 
 Advisor advisor = Advisor(client);
 
diff --git a/docs/examples/advisor/get-report.md b/docs/examples/advisor/get-report.md
@@ -4,7 +4,7 @@ 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
-    .setSession(''); // The user session to authenticate with
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
 
 Advisor advisor = Advisor(client);
 
diff --git a/docs/examples/advisor/list-insights.md b/docs/examples/advisor/list-insights.md
@@ -4,7 +4,7 @@ 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
-    .setSession(''); // The user session to authenticate with
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
 
 Advisor advisor = Advisor(client);
 
diff --git a/docs/examples/advisor/list-reports.md b/docs/examples/advisor/list-reports.md
@@ -4,7 +4,7 @@ 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
-    .setSession(''); // The user session to authenticate with
+    .setKey('<YOUR_API_KEY>'); // Your secret API key
 
 Advisor advisor = Advisor(client);
 
diff --git a/lib/src/client_browser.dart b/lib/src/client_browser.dart
@@ -33,7 +33,7 @@ class ClientBrowser extends ClientBase with ClientMixin {
       'x-sdk-name': 'Dart',
       'x-sdk-platform': 'server',
       'x-sdk-language': 'dart',
-      'x-sdk-version': '24.0.0',
+      'x-sdk-version': '24.1.0',
       'X-Appwrite-Response-Format': '1.9.5',
     };
 
diff --git a/lib/src/client_io.dart b/lib/src/client_io.dart
@@ -42,9 +42,9 @@ class ClientIO extends ClientBase with ClientMixin {
       'x-sdk-name': 'Dart',
       'x-sdk-platform': 'server',
       'x-sdk-language': 'dart',
-      'x-sdk-version': '24.0.0',
+      'x-sdk-version': '24.1.0',
       'user-agent':
-          'AppwriteDartSDK/24.0.0 (${Platform.operatingSystem}; ${Platform.operatingSystemVersion})',
+          'AppwriteDartSDK/24.1.0 (${Platform.operatingSystem}; ${Platform.operatingSystemVersion})',
       'X-Appwrite-Response-Format': '1.9.5',
     };
 
diff --git a/lib/src/enums/build_runtime.dart b/lib/src/enums/build_runtime.dart
@@ -32,6 +32,9 @@ enum BuildRuntime {
   pythonMl311(value: 'python-ml-3.11'),
   pythonMl312(value: 'python-ml-3.12'),
   pythonMl313(value: 'python-ml-3.13'),
+  deno121(value: 'deno-1.21'),
+  deno124(value: 'deno-1.24'),
+  deno135(value: 'deno-1.35'),
   deno140(value: 'deno-1.40'),
   deno146(value: 'deno-1.46'),
   deno20(value: 'deno-2.0'),
diff --git a/lib/src/enums/runtime.dart b/lib/src/enums/runtime.dart
@@ -32,6 +32,9 @@ enum Runtime {
   pythonMl311(value: 'python-ml-3.11'),
   pythonMl312(value: 'python-ml-3.12'),
   pythonMl313(value: 'python-ml-3.13'),
+  deno121(value: 'deno-1.21'),
+  deno124(value: 'deno-1.24'),
+  deno135(value: 'deno-1.35'),
   deno140(value: 'deno-1.40'),
   deno146(value: 'deno-1.46'),
   deno20(value: 'deno-2.0'),
diff --git a/lib/src/models/billing_limits.dart b/lib/src/models/billing_limits.dart
@@ -3,38 +3,38 @@ part of '../../models.dart';
 /// BillingLimits
 class BillingLimits implements Model {
   /// Bandwidth limit
-  final int bandwidth;
+  final int? bandwidth;
 
   /// Storage limit
-  final int storage;
+  final int? storage;
 
   /// Users limit
-  final int users;
+  final int? users;
 
   /// Executions limit
-  final int executions;
+  final int? executions;
 
   /// GBHours limit
-  final int GBHours;
+  final int? GBHours;
 
   /// Image transformations limit
-  final int imageTransformations;
+  final int? imageTransformations;
 
   /// Auth phone limit
-  final int authPhone;
+  final int? authPhone;
 
   /// Budget limit percentage
-  final int budgetLimit;
+  final int? budgetLimit;
 
   BillingLimits({
-    required this.bandwidth,
-    required this.storage,
-    required this.users,
-    required this.executions,
-    required this.GBHours,
-    required this.imageTransformations,
-    required this.authPhone,
-    required this.budgetLimit,
+    this.bandwidth,
+    this.storage,
+    this.users,
+    this.executions,
+    this.GBHours,
+    this.imageTransformations,
+    this.authPhone,
+    this.budgetLimit,
   });
 
   factory BillingLimits.fromMap(Map<String, dynamic> map) {
diff --git a/lib/src/models/file.dart b/lib/src/models/file.dart
@@ -29,6 +29,9 @@ class File implements Model {
   /// File original size in bytes.
   final int sizeOriginal;
 
+  /// File actual stored size in bytes after compression and/or encryption.
+  final int sizeActual;
+
   /// Total number of chunks available
   final int chunksTotal;
 
@@ -51,6 +54,7 @@ class File implements Model {
     required this.signature,
     required this.mimeType,
     required this.sizeOriginal,
+    required this.sizeActual,
     required this.chunksTotal,
     required this.chunksUploaded,
     required this.encryption,
@@ -68,6 +72,7 @@ class File implements Model {
       signature: map['signature'].toString(),
       mimeType: map['mimeType'].toString(),
       sizeOriginal: map['sizeOriginal'],
+      sizeActual: map['sizeActual'],
       chunksTotal: map['chunksTotal'],
       chunksUploaded: map['chunksUploaded'],
       encryption: map['encryption'],
@@ -87,6 +92,7 @@ class File implements Model {
       "signature": signature,
       "mimeType": mimeType,
       "sizeOriginal": sizeOriginal,
+      "sizeActual": sizeActual,
       "chunksTotal": chunksTotal,
       "chunksUploaded": chunksUploaded,
       "encryption": encryption,
diff --git a/lib/src/models/project.dart b/lib/src/models/project.dart
@@ -75,7 +75,7 @@ class Project implements Model {
   final String region;
 
   /// Billing limits reached
-  final BillingLimits billingLimits;
+  final BillingLimits? billingLimits;
 
   /// Project blocks information
   final List<Block> blocks;
@@ -108,7 +108,7 @@ class Project implements Model {
     required this.services,
     required this.protocols,
     required this.region,
-    required this.billingLimits,
+    this.billingLimits,
     required this.blocks,
     required this.consoleAccessedAt,
   });
diff --git a/pubspec.yaml b/pubspec.yaml
@@ -1,5 +1,5 @@
 name: dart_appwrite
-version: 24.0.0
+version: 24.1.0
 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
 homepage: https://appwrite.io
 repository: https://github.com/appwrite/sdk-for-dart
diff --git a/test/services/project_test.dart b/test/services/project_test.dart
diff --git a/test/services/storage_test.dart b/test/services/storage_test.dart
diff --git a/test/src/models/billing_limits_test.dart b/test/src/models/billing_limits_test.dart
diff --git a/test/src/models/file_test.dart b/test/src/models/file_test.dart
diff --git a/test/src/models/project_test.dart b/test/src/models/project_test.dart
