react-native-appwrite 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change log
 
+## 0.21.0
+
+* Add `queries` parameter to `client.subscribe()` for filtering Realtime events
+* Fix `Roles` enum removed from Teams service; `roles` parameter now accepts `string[]`
+* Fix parameter detection in overloaded methods to check for optional params (Account, Avatars, Graphql)
+
 ## 0.20.0
 
 * Add array-based enum parameters (e.g., `permissions: BrowserPermission[]`).

package/README.md

@@ -6,7 +6,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-react-native/releases).**
+**This SDK is compatible with Appwrite server version latest. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-react-native/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 React Native 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)
 

package/dist/cjs/sdk.js

@@ -128,7 +128,7 @@ class Client {
             'x-sdk-name': 'React Native',
             'x-sdk-platform': 'client',
             'x-sdk-language': 'reactnative',
-            'x-sdk-version': '0.20.0',
+            'x-sdk-version': '0.21.0',
             'X-Appwrite-Response-Format': '1.8.0',
         };
         this.realtime = {
@@ -137,6 +137,7 @@ class Client {
             heartbeat: undefined,
             url: '',
             channels: new Set(),
+            queries: new Set(),
             subscriptions: new Map(),
             subscriptionsCounter: 0,
             reconnect: true,
@@ -183,6 +184,9 @@ class Client {
                 this.realtime.channels.forEach(channel => {
                     channels.append('channels[]', channel);
                 });
+                this.realtime.queries.forEach(query => {
+                    channels.append('queries[]', query);
+                });
                 const url = this.config.endpointRealtime + '/realtime?' + channels.toString();
                 if (url !== this.realtime.url || // Check if URL is present
                     !this.realtime.socket || // Check if WebSocket has not been created
@@ -254,7 +258,7 @@ class Client {
                     console.error(e);
                 }
             },
-            cleanUp: channels => {
+            cleanUp: (channels, queries) => {
                 this.realtime.channels.forEach(channel => {
                     if (channels.includes(channel)) {
                         let found = Array.from(this.realtime.subscriptions).some(([_key, subscription]) => {
@@ -265,6 +269,17 @@ class Client {
                         }
                     }
                 });
+                this.realtime.queries.forEach(query => {
+                    if (queries.includes(query)) {
+                        let found = Array.from(this.realtime.subscriptions).some(([_key, subscription]) => {
+                            var _a;
+                            return (_a = subscription.queries) === null || _a === void 0 ? void 0 : _a.includes(query);
+                        });
+                        if (!found) {
+                            this.realtime.queries.delete(query);
+                        }
+                    }
+                });
             }
         };
     }
@@ -410,18 +425,21 @@ class Client {
      * @param {(payload: RealtimeMessage) => void} callback Is called on every realtime update.
      * @returns {() => void} Unsubscribes from events.
      */
-    subscribe(channels, callback) {
+    subscribe(channels, callback, queries = []) {
         let channelArray = typeof channels === 'string' ? [channels] : channels;
         channelArray.forEach(channel => this.realtime.channels.add(channel));
+        const queryStrings = (queries !== null && queries !== void 0 ? queries : []).map(q => typeof q === 'string' ? q : q.toString());
+        queryStrings.forEach(query => this.realtime.queries.add(query));
         const counter = this.realtime.subscriptionsCounter++;
         this.realtime.subscriptions.set(counter, {
             channels: channelArray,
+            queries: queryStrings,
             callback
         });
         this.realtime.connect();
         return () => {
             this.realtime.subscriptions.delete(counter);
-            this.realtime.cleanUp(channelArray);
+            this.realtime.cleanUp(channelArray, queryStrings);
             this.realtime.connect();
         };
     }
@@ -719,7 +737,7 @@ class Account extends Service {
     }
     createMfaAuthenticator(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'type' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('type' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -740,7 +758,7 @@ class Account extends Service {
     }
     createMFAAuthenticator(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'type' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('type' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -761,7 +779,7 @@ class Account extends Service {
     }
     updateMfaAuthenticator(paramsOrFirst, ...rest) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'type' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('type' in paramsOrFirst || 'otp' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -790,7 +808,7 @@ class Account extends Service {
     }
     updateMFAAuthenticator(paramsOrFirst, ...rest) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'type' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('type' in paramsOrFirst || 'otp' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -819,7 +837,7 @@ class Account extends Service {
     }
     deleteMfaAuthenticator(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'type' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('type' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -840,7 +858,7 @@ class Account extends Service {
     }
     deleteMFAAuthenticator(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'type' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('type' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -861,7 +879,7 @@ class Account extends Service {
     }
     createMfaChallenge(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'factor' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('factor' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -885,7 +903,7 @@ class Account extends Service {
     }
     createMFAChallenge(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'factor' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('factor' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -1178,7 +1196,7 @@ class Account extends Service {
     }
     updatePrefs(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'prefs' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('prefs' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -1378,7 +1396,7 @@ class Account extends Service {
     }
     createOAuth2Session(paramsOrFirst, ...rest) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'provider' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('provider' in paramsOrFirst || 'success' in paramsOrFirst || 'failure' in paramsOrFirst || 'scopes' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -1721,7 +1739,7 @@ class Account extends Service {
     }
     createOAuth2Token(paramsOrFirst, ...rest) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'provider' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('provider' in paramsOrFirst || 'success' in paramsOrFirst || 'failure' in paramsOrFirst || 'scopes' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -1955,7 +1973,7 @@ class Avatars extends Service {
     }
     getBrowser(paramsOrFirst, ...rest) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'code' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('code' in paramsOrFirst || 'width' in paramsOrFirst || 'height' in paramsOrFirst || 'quality' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -1993,7 +2011,7 @@ class Avatars extends Service {
     }
     getCreditCard(paramsOrFirst, ...rest) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'code' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('code' in paramsOrFirst || 'width' in paramsOrFirst || 'height' in paramsOrFirst || 'quality' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -2057,7 +2075,7 @@ class Avatars extends Service {
     }
     getFlag(paramsOrFirst, ...rest) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'code' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('code' in paramsOrFirst || 'width' in paramsOrFirst || 'height' in paramsOrFirst || 'quality' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -3310,7 +3328,7 @@ class Graphql extends Service {
     }
     query(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'query' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('query' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -3335,7 +3353,7 @@ class Graphql extends Service {
     }
     mutation(paramsOrFirst) {
         let params;
-        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && 'query' in paramsOrFirst)) {
+        if ((paramsOrFirst && typeof paramsOrFirst === 'object' && !Array.isArray(paramsOrFirst) && ('query' in paramsOrFirst))) {
             params = (paramsOrFirst || {});
         }
         else {
@@ -5376,10 +5394,6 @@ class Channel {
     file(id = "*") {
         return this.next("files", id);
     }
-    // --- FUNCTION ROUTE ---
-    execution(id = "*") {
-        return this.next("executions", id);
-    }
     // --- TERMINAL ACTIONS ---
     // Restricted to the Actionable union
     create() {
@@ -5404,15 +5418,17 @@ class Channel {
     static function(id = "*") {
         return new Channel(["functions", normalize(id)]);
     }
+    static execution(id = "*") {
+        return new Channel(["executions", normalize(id)]);
+    }
     static team(id = "*") {
         return new Channel(["teams", normalize(id)]);
     }
     static membership(id = "*") {
         return new Channel(["memberships", normalize(id)]);
     }
-    static account(userId = "") {
-        const id = normalize(userId);
-        return id === "*" ? "account" : `account.${id}`;
+    static account() {
+        return "account";
     }
     // Global events
     static get documents() {
@@ -5748,6 +5764,8 @@ exports.OAuthProvider = void 0;
     OAuthProvider["Yandex"] = "yandex";
     OAuthProvider["Zoho"] = "zoho";
     OAuthProvider["Zoom"] = "zoom";
+    OAuthProvider["GithubImagine"] = "githubImagine";
+    OAuthProvider["GoogleImagine"] = "googleImagine";
 })(exports.OAuthProvider || (exports.OAuthProvider = {}));
 
 exports.Browser = void 0;
@@ -6476,13 +6494,6 @@ exports.ImageGravity = void 0;
     ImageGravity["BottomRight"] = "bottom-right";
 })(exports.ImageGravity || (exports.ImageGravity = {}));
 
-exports.Roles = void 0;
-(function (Roles) {
-    Roles["Admin"] = "admin";
-    Roles["Developer"] = "developer";
-    Roles["Owner"] = "owner";
-})(exports.Roles || (exports.Roles = {}));
-
 exports.ExecutionTrigger = void 0;
 (function (ExecutionTrigger) {
     ExecutionTrigger["Http"] = "http";