react-native-appwrite 0.17.1 → 0.18.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Change log
 
+## 0.18.0
+
+* Add `total` parameter to list queries allowing skipping counting rows in a table for improved performance
+* Add `Operator` class for atomic modification of rows via update, bulk update, upsert, and bulk upsert operations
+
 ## 0.17.1
 
 * Add transaction support for Databases and TablesDB

package/dist/cjs/sdk.js

@@ -100,7 +100,7 @@ class Client {
             'x-sdk-name': 'React Native',
             'x-sdk-platform': 'client',
             'x-sdk-language': 'reactnative',
-            'x-sdk-version': '0.17.1',
+            'x-sdk-version': '0.18.0',
             'X-Appwrite-Response-Format': '1.8.0',
         };
         this.realtime = {
@@ -569,22 +569,27 @@ class Account extends Service {
             'content-type': 'application/json',
         }, payload);
     }
-    listIdentities(paramsOrFirst) {
+    listIdentities(paramsOrFirst, ...rest) {
         let params;
         if (!paramsOrFirst || (paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
             params = {
-                queries: paramsOrFirst
+                queries: paramsOrFirst,
+                total: rest[0]
             };
         }
         const queries = params.queries;
+        const total = params.total;
         const apiPath = '/account/identities';
         const payload = {};
         if (typeof queries !== 'undefined') {
             payload['queries'] = queries;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -623,22 +628,27 @@ class Account extends Service {
             'content-type': 'application/json',
         }, payload);
     }
-    listLogs(paramsOrFirst) {
+    listLogs(paramsOrFirst, ...rest) {
         let params;
         if (!paramsOrFirst || (paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
             params = {
-                queries: paramsOrFirst
+                queries: paramsOrFirst,
+                total: rest[0]
             };
         }
         const queries = params.queries;
+        const total = params.total;
         const apiPath = '/account/logs';
         const payload = {};
         if (typeof queries !== 'undefined') {
             payload['queries'] = queries;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -2565,13 +2575,15 @@ class Databases extends Service {
                 databaseId: paramsOrFirst,
                 collectionId: rest[0],
                 queries: rest[1],
-                transactionId: rest[2]
+                transactionId: rest[2],
+                total: rest[3]
             };
         }
         const databaseId = params.databaseId;
         const collectionId = params.collectionId;
         const queries = params.queries;
         const transactionId = params.transactionId;
+        const total = params.total;
         if (typeof databaseId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "databaseId"');
         }
@@ -2586,6 +2598,9 @@ class Databases extends Service {
         if (typeof transactionId !== 'undefined') {
             payload['transactionId'] = transactionId;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -2927,11 +2942,13 @@ class Functions extends Service {
         else {
             params = {
                 functionId: paramsOrFirst,
-                queries: rest[0]
+                queries: rest[0],
+                total: rest[1]
             };
         }
         const functionId = params.functionId;
         const queries = params.queries;
+        const total = params.total;
         if (typeof functionId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "functionId"');
         }
@@ -2940,6 +2957,9 @@ class Functions extends Service {
         if (typeof queries !== 'undefined') {
             payload['queries'] = queries;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -3262,12 +3282,14 @@ class Storage extends Service {
             params = {
                 bucketId: paramsOrFirst,
                 queries: rest[0],
-                search: rest[1]
+                search: rest[1],
+                total: rest[2]
             };
         }
         const bucketId = params.bucketId;
         const queries = params.queries;
         const search = params.search;
+        const total = params.total;
         if (typeof bucketId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "bucketId"');
         }
@@ -3279,6 +3301,9 @@ class Storage extends Service {
         if (typeof search !== 'undefined') {
             payload['search'] = search;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -3885,13 +3910,15 @@ class TablesDB extends Service {
                 databaseId: paramsOrFirst,
                 tableId: rest[0],
                 queries: rest[1],
-                transactionId: rest[2]
+                transactionId: rest[2],
+                total: rest[3]
             };
         }
         const databaseId = params.databaseId;
         const tableId = params.tableId;
         const queries = params.queries;
         const transactionId = params.transactionId;
+        const total = params.total;
         if (typeof databaseId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "databaseId"');
         }
@@ -3906,6 +3933,9 @@ class TablesDB extends Service {
         if (typeof transactionId !== 'undefined') {
             payload['transactionId'] = transactionId;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -4244,11 +4274,13 @@ class Teams extends Service {
         else {
             params = {
                 queries: paramsOrFirst,
-                search: rest[0]
+                search: rest[0],
+                total: rest[1]
             };
         }
         const queries = params.queries;
         const search = params.search;
+        const total = params.total;
         const apiPath = '/teams';
         const payload = {};
         if (typeof queries !== 'undefined') {
@@ -4257,6 +4289,9 @@ class Teams extends Service {
         if (typeof search !== 'undefined') {
             payload['search'] = search;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -4375,12 +4410,14 @@ class Teams extends Service {
             params = {
                 teamId: paramsOrFirst,
                 queries: rest[0],
-                search: rest[1]
+                search: rest[1],
+                total: rest[2]
             };
         }
         const teamId = params.teamId;
         const queries = params.queries;
         const search = params.search;
+        const total = params.total;
         if (typeof teamId === 'undefined') {
             throw new AppwriteException('Missing required parameter: "teamId"');
         }
@@ -4392,6 +4429,9 @@ class Teams extends Service {
         if (typeof search !== 'undefined') {
             payload['search'] = search;
         }
+        if (typeof total !== 'undefined') {
+            payload['total'] = total;
+        }
         const uri = new URL(this.client.config.endpoint + apiPath);
         return this.client.call('get', uri, {}, payload);
     }
@@ -4722,14 +4762,14 @@ Query.notEndsWith = (attribute, value) => new Query("notEndsWith", attribute, va
  * @param {string} value
  * @returns {string}
  */
-Query.createdBefore = (value) => new Query("createdBefore", undefined, value).toString();
+Query.createdBefore = (value) => Query.lessThan("$createdAt", value);
 /**
  * Filter resources where document was created after date.
  *
  * @param {string} value
  * @returns {string}
  */
-Query.createdAfter = (value) => new Query("createdAfter", undefined, value).toString();
+Query.createdAfter = (value) => Query.greaterThan("$createdAt", value);
 /**
  * Filter resources where document was created between dates.
  *
@@ -4737,21 +4777,21 @@ Query.createdAfter = (value) => new Query("createdAfter", undefined, value).toSt
  * @param {string} end
  * @returns {string}
  */
-Query.createdBetween = (start, end) => new Query("createdBetween", undefined, [start, end]).toString();
+Query.createdBetween = (start, end) => Query.between("$createdAt", start, end);
 /**
  * Filter resources where document was updated before date.
  *
  * @param {string} value
  * @returns {string}
  */
-Query.updatedBefore = (value) => new Query("updatedBefore", undefined, value).toString();
+Query.updatedBefore = (value) => Query.lessThan("$updatedAt", value);
 /**
  * Filter resources where document was updated after date.
  *
  * @param {string} value
  * @returns {string}
  */
-Query.updatedAfter = (value) => new Query("updatedAfter", undefined, value).toString();
+Query.updatedAfter = (value) => Query.greaterThan("$updatedAt", value);
 /**
  * Filter resources where document was updated between dates.
  *
@@ -4759,7 +4799,7 @@ Query.updatedAfter = (value) => new Query("updatedAfter", undefined, value).toSt
  * @param {string} end
  * @returns {string}
  */
-Query.updatedBetween = (start, end) => new Query("updatedBetween", undefined, [start, end]).toString();
+Query.updatedBetween = (start, end) => Query.between("$updatedAt", start, end);
 Query.or = (queries) => new Query("or", undefined, queries.map((query) => JSON.parse(query))).toString();
 Query.and = (queries) => new Query("and", undefined, queries.map((query) => JSON.parse(query))).toString();
 /**
@@ -5004,6 +5044,271 @@ _a = ID, _ID_hexTimestamp = function _ID_hexTimestamp() {
     return hexTimestamp;
 };
 
+exports.Condition = void 0;
+(function (Condition) {
+    Condition["Equal"] = "equal";
+    Condition["NotEqual"] = "notEqual";
+    Condition["GreaterThan"] = "greaterThan";
+    Condition["GreaterThanEqual"] = "greaterThanEqual";
+    Condition["LessThan"] = "lessThan";
+    Condition["LessThanEqual"] = "lessThanEqual";
+    Condition["Contains"] = "contains";
+    Condition["IsNull"] = "isNull";
+    Condition["IsNotNull"] = "isNotNull";
+})(exports.Condition || (exports.Condition = {}));
+/**
+ * Helper class to generate operator strings for atomic operations.
+ */
+class Operator {
+    /**
+     * Constructor for Operator class.
+     *
+     * @param {string} method
+     * @param {OperatorValues} values
+     */
+    constructor(method, values) {
+        this.method = method;
+        if (values !== undefined) {
+            if (Array.isArray(values)) {
+                this.values = values;
+            }
+            else {
+                this.values = [values];
+            }
+        }
+    }
+    /**
+     * Convert the operator object to a JSON string.
+     *
+     * @returns {string}
+     */
+    toString() {
+        return JSON.stringify({
+            method: this.method,
+            values: this.values,
+        });
+    }
+}
+/**
+ * Increment a numeric attribute by a specified value.
+ *
+ * @param {number} value
+ * @param {number} max
+ * @returns {string}
+ */
+Operator.increment = (value = 1, max) => {
+    if (isNaN(value) || !isFinite(value)) {
+        throw new Error("Value cannot be NaN or Infinity");
+    }
+    if (max !== undefined && (isNaN(max) || !isFinite(max))) {
+        throw new Error("Max cannot be NaN or Infinity");
+    }
+    const values = [value];
+    if (max !== undefined) {
+        values.push(max);
+    }
+    return new Operator("increment", values).toString();
+};
+/**
+ * Decrement a numeric attribute by a specified value.
+ *
+ * @param {number} value
+ * @param {number} min
+ * @returns {string}
+ */
+Operator.decrement = (value = 1, min) => {
+    if (isNaN(value) || !isFinite(value)) {
+        throw new Error("Value cannot be NaN or Infinity");
+    }
+    if (min !== undefined && (isNaN(min) || !isFinite(min))) {
+        throw new Error("Min cannot be NaN or Infinity");
+    }
+    const values = [value];
+    if (min !== undefined) {
+        values.push(min);
+    }
+    return new Operator("decrement", values).toString();
+};
+/**
+ * Multiply a numeric attribute by a specified factor.
+ *
+ * @param {number} factor
+ * @param {number} max
+ * @returns {string}
+ */
+Operator.multiply = (factor, max) => {
+    if (isNaN(factor) || !isFinite(factor)) {
+        throw new Error("Factor cannot be NaN or Infinity");
+    }
+    if (max !== undefined && (isNaN(max) || !isFinite(max))) {
+        throw new Error("Max cannot be NaN or Infinity");
+    }
+    const values = [factor];
+    if (max !== undefined) {
+        values.push(max);
+    }
+    return new Operator("multiply", values).toString();
+};
+/**
+ * Divide a numeric attribute by a specified divisor.
+ *
+ * @param {number} divisor
+ * @param {number} min
+ * @returns {string}
+ */
+Operator.divide = (divisor, min) => {
+    if (isNaN(divisor) || !isFinite(divisor)) {
+        throw new Error("Divisor cannot be NaN or Infinity");
+    }
+    if (min !== undefined && (isNaN(min) || !isFinite(min))) {
+        throw new Error("Min cannot be NaN or Infinity");
+    }
+    if (divisor === 0) {
+        throw new Error("Divisor cannot be zero");
+    }
+    const values = [divisor];
+    if (min !== undefined) {
+        values.push(min);
+    }
+    return new Operator("divide", values).toString();
+};
+/**
+ * Apply modulo operation on a numeric attribute.
+ *
+ * @param {number} divisor
+ * @returns {string}
+ */
+Operator.modulo = (divisor) => {
+    if (isNaN(divisor) || !isFinite(divisor)) {
+        throw new Error("Divisor cannot be NaN or Infinity");
+    }
+    if (divisor === 0) {
+        throw new Error("Divisor cannot be zero");
+    }
+    return new Operator("modulo", [divisor]).toString();
+};
+/**
+ * Raise a numeric attribute to a specified power.
+ *
+ * @param {number} exponent
+ * @param {number} max
+ * @returns {string}
+ */
+Operator.power = (exponent, max) => {
+    if (isNaN(exponent) || !isFinite(exponent)) {
+        throw new Error("Exponent cannot be NaN or Infinity");
+    }
+    if (max !== undefined && (isNaN(max) || !isFinite(max))) {
+        throw new Error("Max cannot be NaN or Infinity");
+    }
+    const values = [exponent];
+    if (max !== undefined) {
+        values.push(max);
+    }
+    return new Operator("power", values).toString();
+};
+/**
+ * Append values to an array attribute.
+ *
+ * @param {any[]} values
+ * @returns {string}
+ */
+Operator.arrayAppend = (values) => new Operator("arrayAppend", values).toString();
+/**
+ * Prepend values to an array attribute.
+ *
+ * @param {any[]} values
+ * @returns {string}
+ */
+Operator.arrayPrepend = (values) => new Operator("arrayPrepend", values).toString();
+/**
+ * Insert a value at a specific index in an array attribute.
+ *
+ * @param {number} index
+ * @param {any} value
+ * @returns {string}
+ */
+Operator.arrayInsert = (index, value) => new Operator("arrayInsert", [index, value]).toString();
+/**
+ * Remove a value from an array attribute.
+ *
+ * @param {any} value
+ * @returns {string}
+ */
+Operator.arrayRemove = (value) => new Operator("arrayRemove", [value]).toString();
+/**
+ * Remove duplicate values from an array attribute.
+ *
+ * @returns {string}
+ */
+Operator.arrayUnique = () => new Operator("arrayUnique", []).toString();
+/**
+ * Keep only values that exist in both the current array and the provided array.
+ *
+ * @param {any[]} values
+ * @returns {string}
+ */
+Operator.arrayIntersect = (values) => new Operator("arrayIntersect", values).toString();
+/**
+ * Remove values from the array that exist in the provided array.
+ *
+ * @param {any[]} values
+ * @returns {string}
+ */
+Operator.arrayDiff = (values) => new Operator("arrayDiff", values).toString();
+/**
+ * Filter array values based on a condition.
+ *
+ * @param {Condition} condition
+ * @param {any} value
+ * @returns {string}
+ */
+Operator.arrayFilter = (condition, value) => {
+    const values = [condition, value === undefined ? null : value];
+    return new Operator("arrayFilter", values).toString();
+};
+/**
+ * Concatenate a value to a string or array attribute.
+ *
+ * @param {any} value
+ * @returns {string}
+ */
+Operator.stringConcat = (value) => new Operator("stringConcat", [value]).toString();
+/**
+ * Replace occurrences of a search string with a replacement string.
+ *
+ * @param {string} search
+ * @param {string} replace
+ * @returns {string}
+ */
+Operator.stringReplace = (search, replace) => new Operator("stringReplace", [search, replace]).toString();
+/**
+ * Toggle a boolean attribute.
+ *
+ * @returns {string}
+ */
+Operator.toggle = () => new Operator("toggle", []).toString();
+/**
+ * Add days to a date attribute.
+ *
+ * @param {number} days
+ * @returns {string}
+ */
+Operator.dateAddDays = (days) => new Operator("dateAddDays", [days]).toString();
+/**
+ * Subtract days from a date attribute.
+ *
+ * @param {number} days
+ * @returns {string}
+ */
+Operator.dateSubDays = (days) => new Operator("dateSubDays", [days]).toString();
+/**
+ * Set a date attribute to the current date and time.
+ *
+ * @returns {string}
+ */
+Operator.dateSetNow = () => new Operator("dateSetNow", []).toString();
+
 exports.AuthenticatorType = void 0;
 (function (AuthenticatorType) {
     AuthenticatorType["Totp"] = "totp";
@@ -5334,6 +5639,22 @@ exports.ImageFormat = void 0;
     ImageFormat["Gif"] = "gif";
 })(exports.ImageFormat || (exports.ImageFormat = {}));
 
+exports.ExecutionTrigger = void 0;
+(function (ExecutionTrigger) {
+    ExecutionTrigger["Http"] = "http";
+    ExecutionTrigger["Schedule"] = "schedule";
+    ExecutionTrigger["Event"] = "event";
+})(exports.ExecutionTrigger || (exports.ExecutionTrigger = {}));
+
+exports.ExecutionStatus = void 0;
+(function (ExecutionStatus) {
+    ExecutionStatus["Waiting"] = "waiting";
+    ExecutionStatus["Processing"] = "processing";
+    ExecutionStatus["Completed"] = "completed";
+    ExecutionStatus["Failed"] = "failed";
+    ExecutionStatus["Scheduled"] = "scheduled";
+})(exports.ExecutionStatus || (exports.ExecutionStatus = {}));
+
 exports.Account = Account;
 exports.AppwriteException = AppwriteException;
 exports.Avatars = Avatars;
@@ -5344,6 +5665,7 @@ exports.Graphql = Graphql;
 exports.ID = ID;
 exports.Locale = Locale;
 exports.Messaging = Messaging;
+exports.Operator = Operator;
 exports.Permission = Permission;
 exports.Query = Query;
 exports.Role = Role;