sdk update

Author: ArnabChatterjee20k

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.8.x. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-flutter/releases).**
+**This SDK is compatible with Appwrite server version latest. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-flutter/releases).**
 
 Appwrite is an open-source backend as a service server that abstracts and simplifies complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to [https://appwrite.io/docs](https://appwrite.io/docs)
 
@@ -19,7 +19,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yml
 dependencies:
-  appwrite: ^21.4.0
+  appwrite: ^21.4.1
 ```
 
 You can install packages from the command line:

docs/examples/databases/list-documents.md

@@ -13,5 +13,6 @@ DocumentList result = await databases.listDocuments(
     queries: [], // optional
     transactionId: '<TRANSACTION_ID>', // optional
     total: false, // optional
+    ttl: 0, // optional
 );
 ```

docs/examples/tablesdb/list-rows.md

@@ -13,5 +13,6 @@ RowList result = await tablesDB.listRows(
     queries: [], // optional
     transactionId: '<TRANSACTION_ID>', // optional
     total: false, // optional
+    ttl: 0, // optional
 );
 ```

lib/appwrite.dart

@@ -1,6 +1,6 @@
 /// Appwrite Flutter SDK
 ///
-/// This SDK is compatible with Appwrite server version 1.8.x.
+/// This SDK is compatible with Appwrite server version 1.8.x. 
 /// For older versions, please check
 /// [previous releases](https://github.com/appwrite/sdk-for-flutter/releases).
 library appwrite;

lib/channel.dart

@@ -2,35 +2,28 @@ part of appwrite;
 
 // Marker classes for type safety
 class _Root {}
-
 class _Database {}
-
 class _Collection {}
-
 class _Document {}
-
 class _TablesDB {}
-
 class _Table {}
-
 class _Row {}
-
 class _Bucket {}
-
 class _File {}
-
 class _Func {}
-
 class _Execution {}
-
 class _Team {}
-
 class _Membership {}
-
 class _Resolved {}
 
 // Helper function for normalizing ID
-String _normalize(String id) => id.trim().isEmpty ? '*' : id.trim();
+String _normalize(String id) {
+  final trimmed = id.trim();
+  if (trimmed.isEmpty) {
+    throw ArgumentError('Channel ID is required');
+  }
+  return trimmed;
+}
 
 /// Channel class with generic type parameter for type-safe method chaining
 class Channel<T> {
@@ -58,25 +51,25 @@ class Channel<T> {
   String toString() => _segments.join('.');
 
   // --- ROOT FACTORIES ---
-  static Channel<_Database> database([String id = '*']) =>
+  static Channel<_Database> database(String id) =>
       Channel<_Database>._(['databases', _normalize(id)]);
 
-  static Channel<_TablesDB> tablesdb([String id = '*']) =>
+  static Channel<_TablesDB> tablesdb(String id) =>
       Channel<_TablesDB>._(['tablesdb', _normalize(id)]);
 
-  static Channel<_Bucket> bucket([String id = '*']) =>
+  static Channel<_Bucket> bucket(String id) =>
       Channel<_Bucket>._(['buckets', _normalize(id)]);
 
-  static Channel<_Execution> execution([String id = '*']) =>
+  static Channel<_Execution> execution(String id) =>
       Channel<_Execution>._(['executions', _normalize(id)]);
 
-  static Channel<_Func> function([String id = '*']) =>
+  static Channel<_Func> function(String id) =>
       Channel<_Func>._(['functions', _normalize(id)]);
 
-  static Channel<_Team> team([String id = '*']) =>
+  static Channel<_Team> team(String id) =>
       Channel<_Team>._(['teams', _normalize(id)]);
 
-  static Channel<_Membership> membership([String id = '*']) =>
+  static Channel<_Membership> membership(String id) =>
       Channel<_Membership>._(['memberships', _normalize(id)]);
 
   static String account() => 'account';
@@ -95,21 +88,21 @@ class Channel<T> {
 
 /// Only available on Channel<_Database>
 extension DatabaseChannel on Channel<_Database> {
-  Channel<_Collection> collection([String? id]) =>
-      _next<_Collection>('collections', id ?? '*');
+  Channel<_Collection> collection(String id) =>
+      _next<_Collection>('collections', id);
 }
 
 /// Only available on Channel<_Collection>
 extension CollectionChannel on Channel<_Collection> {
-  Channel<_Document> document([String? id]) =>
-      _next<_Document>('documents', id);
+  Channel<_Document> document([String? id]) => _next<_Document>('documents', id);
 }
 
 // --- TABLESDB ROUTE ---
 
 /// Only available on Channel<_TablesDB>
 extension TablesDBChannel on Channel<_TablesDB> {
-  Channel<_Table> table([String? id]) => _next<_Table>('tables', id ?? '*');
+  Channel<_Table> table(String id) =>
+      _next<_Table>('tables', id);
 }
 
 /// Only available on Channel<_Table>

lib/client_browser.dart

@@ -1 +1 @@
-export 'src/client_browser.dart';
+export 'src/client_browser.dart';

lib/client_io.dart

@@ -1 +1 @@
-export 'src/client_io.dart';
+export 'src/client_io.dart';

lib/operator.dart

@@ -31,7 +31,7 @@ class Operator {
 
     result['method'] = method;
 
-    if (values != null) {
+    if(values != null) {
       result['values'] = values is List ? values : [values];
     }
 
@@ -147,7 +147,8 @@ class Operator {
       Operator._('arrayRemove', [value]).toString();
 
   /// Remove duplicate values from an array attribute.
-  static String arrayUnique() => Operator._('arrayUnique', []).toString();
+  static String arrayUnique() =>
+      Operator._('arrayUnique', []).toString();
 
   /// Keep only values that exist in both the current array and the provided array.
   static String arrayIntersect(List<dynamic> values) =>
@@ -172,7 +173,8 @@ class Operator {
       Operator._('stringReplace', [search, replace]).toString();
 
   /// Toggle a boolean attribute.
-  static String toggle() => Operator._('toggle', []).toString();
+  static String toggle() =>
+      Operator._('toggle', []).toString();
 
   /// Add days to a date attribute.
   static String dateAddDays(int days) =>
@@ -183,5 +185,6 @@ class Operator {
       Operator._('dateSubDays', [days]).toString();
 
   /// Set a date attribute to the current date and time.
-  static String dateSetNow() => Operator._('dateSetNow', []).toString();
+  static String dateSetNow() =>
+      Operator._('dateSetNow', []).toString();
 }

lib/query.dart

@@ -10,14 +10,14 @@ class Query {
 
   Map<String, dynamic> toJson() {
     final result = <String, dynamic>{};
-
+    
     result['method'] = method;
-
-    if (attribute != null) {
+    
+    if(attribute != null) {
       result['attribute'] = attribute;
     }
-
-    if (values != null) {
+    
+    if(values != null) {
       result['values'] = values is List ? values : [values];
     }
 
@@ -28,7 +28,7 @@ class Query {
   String toString() => jsonEncode(toJson());
 
   /// Filter resources where [attribute] is equal to [value].
-  ///
+  /// 
   /// [value] can be a single value or a list. If a list is used
   /// the query will return resources where [attribute] is equal
   /// to any of the values in the list.
@@ -140,46 +140,50 @@ class Query {
       Query._('notEndsWith', attribute, value).toString();
 
   /// Filter resources where document was created before [value].
-  static String createdBefore(String value) => lessThan('\$createdAt', value);
+  static String createdBefore(String value) =>
+      lessThan('\$createdAt', value);
 
   /// Filter resources where document was created after [value].
-  static String createdAfter(String value) => greaterThan('\$createdAt', value);
+  static String createdAfter(String value) =>
+      greaterThan('\$createdAt', value);
 
   /// Filter resources where document was created between [start] and [end] (inclusive).
   static String createdBetween(String start, String end) =>
       between('\$createdAt', start, end);
 
   /// Filter resources where document was updated before [value].
-  static String updatedBefore(String value) => lessThan('\$updatedAt', value);
+  static String updatedBefore(String value) =>
+      lessThan('\$updatedAt', value);
 
   /// Filter resources where document was updated after [value].
-  static String updatedAfter(String value) => greaterThan('\$updatedAt', value);
+  static String updatedAfter(String value) =>
+      greaterThan('\$updatedAt', value);
 
   /// Filter resources where document was updated between [start] and [end] (inclusive).
   static String updatedBetween(String start, String end) =>
       between('\$updatedAt', start, end);
 
   static String or(List<String> queries) => Query._(
-        'or',
-        null,
-        queries.map((query) => jsonDecode(query)).toList(),
-      ).toString();
+    'or',
+    null,
+    queries.map((query) => jsonDecode(query)).toList(),
+  ).toString();
 
   static String and(List<String> queries) => Query._(
-        'and',
-        null,
-        queries.map((query) => jsonDecode(query)).toList(),
-      ).toString();
+    'and',
+    null,
+    queries.map((query) => jsonDecode(query)).toList(),
+  ).toString();
 
   /// Filter array elements where at least one element matches all the specified queries.
   ///
   /// [attribute] The attribute containing the array to filter on.
   /// [queries] The list of query strings to match against array elements.
   static String elemMatch(String attribute, List<String> queries) => Query._(
-        'elemMatch',
-        attribute,
-        queries.map((query) => jsonDecode(query)).toList(),
-      ).toString();
+    'elemMatch',
+    attribute,
+    queries.map((query) => jsonDecode(query)).toList(),
+  ).toString();
 
   /// Specify which attributes should be returned by the API call.
   static String select(List<String> attributes) =>
@@ -194,17 +198,18 @@ class Query {
       Query._('orderDesc', attribute).toString();
 
   /// Sort results randomly.
-  static String orderRandom() => Query._('orderRandom').toString();
+  static String orderRandom() =>
+      Query._('orderRandom').toString();
 
   /// Return results before [id].
-  ///
+  /// 
   /// Refer to the [Cursor Based Pagination](https://appwrite.io/docs/pagination#cursor-pagination)
   /// docs for more information.
   static String cursorBefore(String id) =>
       Query._('cursorBefore', null, id).toString();
 
   /// Return results after [id].
-  ///
+  /// 
   /// Refer to the [Cursor Based Pagination](https://appwrite.io/docs/pagination#cursor-pagination)
   /// docs for more information.
   static String cursorAfter(String id) =>
@@ -214,43 +219,27 @@ class Query {
   static String limit(int limit) => Query._('limit', null, limit).toString();
 
   /// Return results from [offset].
-  ///
+  /// 
   /// Refer to the [Offset Pagination](https://appwrite.io/docs/pagination#offset-pagination)
   /// docs for more information.
   static String offset(int offset) =>
       Query._('offset', null, offset).toString();
 
   /// Filter resources where [attribute] is at a specific distance from the given coordinates.
-  static String distanceEqual(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceEqual', attribute, [
-        [values, distance, meters]
-      ]).toString();
+  static String distanceEqual(String attribute, List<dynamic> values, num distance, [bool meters = true]) =>
+      Query._('distanceEqual', attribute, [[values, distance, meters]]).toString();
 
   /// Filter resources where [attribute] is not at a specific distance from the given coordinates.
-  static String distanceNotEqual(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceNotEqual', attribute, [
-        [values, distance, meters]
-      ]).toString();
+  static String distanceNotEqual(String attribute, List<dynamic> values, num distance, [bool meters = true]) =>
+      Query._('distanceNotEqual', attribute, [[values, distance, meters]]).toString();
 
   /// Filter resources where [attribute] is at a distance greater than the specified value from the given coordinates.
-  static String distanceGreaterThan(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceGreaterThan', attribute, [
-        [values, distance, meters]
-      ]).toString();
+  static String distanceGreaterThan(String attribute, List<dynamic> values, num distance, [bool meters = true]) =>
+      Query._('distanceGreaterThan', attribute, [[values, distance, meters]]).toString();
 
   /// Filter resources where [attribute] is at a distance less than the specified value from the given coordinates.
-  static String distanceLessThan(
-          String attribute, List<dynamic> values, num distance,
-          [bool meters = true]) =>
-      Query._('distanceLessThan', attribute, [
-        [values, distance, meters]
-      ]).toString();
+  static String distanceLessThan(String attribute, List<dynamic> values, num distance, [bool meters = true]) =>
+      Query._('distanceLessThan', attribute, [[values, distance, meters]]).toString();
 
   /// Filter resources where [attribute] intersects with the given geometry.
   static String intersects(String attribute, List<dynamic> values) =>
@@ -283,4 +272,4 @@ class Query {
   /// Filter resources where [attribute] does not touch the given geometry.
   static String notTouches(String attribute, List<dynamic> values) =>
       Query._('notTouches', attribute, [values]).toString();
-}
+}

lib/realtime_browser.dart

@@ -1 +1 @@
-export 'src/realtime_browser.dart';
+export 'src/realtime_browser.dart';