Merge pull request #94 from appwrite/dev

Author: abnegate

CHANGELOG.md

@@ -1,5 +1,15 @@
 # Change log
 
+## 0.26.0
+
+* [BREAKING] Changed `$sequence` type from `number` to `string` for `Row` and `Document` models
+* Added impersonation support: `setImpersonateUserId()`, `setImpersonateUserEmail()`, `setImpersonateUserPhone()` on `Client`
+* Added `impersonator` and `impersonatorUserId` optional fields to `User` model
+* Added custom `toString()` on response data objects using `JSONbig.stringify` to fix BigInt serialization
+* Updated `Log` model field descriptions to clarify impersonation behavior for `userId`, `userEmail`, `userName`
+* Updated `X-Appwrite-Response-Format` header to `1.9.0`
+* Updated devDependencies: Rollup 2→3, TypeScript pinned to 5.7.3, and related plugin upgrades
+
 ## 0.24.1
 
 * Fix very large double values (for example 1.7976931348623157e+308) from being expanded into giant integer literals.

README.md

@@ -1,12 +1,12 @@
 # Appwrite React Native SDK
 
 ![License](https://img.shields.io/github/license/appwrite/sdk-for-react-native.svg?style=flat-square)
-![Version](https://img.shields.io/badge/api%20version-1.8.1-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.9.0-blue.svg?style=flat-square)
 [![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
 [![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 latest. For older versions, please check [previous releases](https://github.com/appwrite/sdk-for-react-native/releases).**
+**This SDK is compatible with Appwrite server version 1.9.x. 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.json

@@ -2,7 +2,7 @@
   "name": "react-native-appwrite",
   "homepage": "https://appwrite.io/support",
   "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",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "license": "BSD-3-Clause",
   "main": "dist/cjs/sdk.js",
   "exports": {
@@ -25,13 +25,13 @@
     "build:libs": "rollup -c"
   },
   "devDependencies": {
-    "@rollup/plugin-typescript": "8.3.2",
+    "@rollup/plugin-typescript": "11.1.6",
     "@types/json-bigint": "1.0.4",
     "playwright": "1.56.1",
-    "rollup": "2.75.4",
+    "rollup": "3.29.5",
     "serve-handler": "6.1.0",
-    "tslib": "2.4.0",
-    "typescript": "^5.3.3"
+    "tslib": "2.8.1",
+    "typescript": "5.7.3"
   },
   "dependencies": {
     "expo-file-system": "18.*.*",

rollup.config.js

@@ -1,4 +1,5 @@
-import pkg from "./package.json";
+import { readFileSync } from "fs";
+const pkg = JSON.parse(readFileSync("./package.json", "utf8"));
 import typescript from "@rollup/plugin-typescript";
 
 const external = Object.keys(pkg.dependencies ?? {});

src/client.ts

@@ -152,14 +152,17 @@ class Client {
         locale: '',
         session: '',
         devkey: '',
+        impersonateuserid: '',
+        impersonateuseremail: '',
+        impersonateuserphone: '',
         platform: '',
     };
     headers: Headers = {
         'x-sdk-name': 'React Native',
         'x-sdk-platform': 'client',
         'x-sdk-language': 'reactnative',
-        'x-sdk-version': '0.25.0',
-        'X-Appwrite-Response-Format': '1.8.0',
+        'x-sdk-version': '0.26.0',
+        'X-Appwrite-Response-Format': '1.9.0',
     };
 
     /**
@@ -293,6 +296,69 @@ class Client {
         return this;
     }
 
+    /**
+     * Set ImpersonateUserId
+     *
+     * Impersonate a user by ID on an already user-authenticated request. Requires
+     * the current request to be authenticated as a user with impersonator
+     * capability; X-Appwrite-Key alone is not sufficient. Impersonator users are
+     * intentionally granted users.read so they can discover a target before
+     * impersonation begins. Internal audit logs still attribute actions to the
+     * original impersonator and record the impersonated target only in internal
+     * audit payload data.
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setImpersonateUserId(value: string): this {
+        this.headers['X-Appwrite-Impersonate-User-Id'] = value;
+        this.config.impersonateuserid = value;
+        return this;
+    }
+
+    /**
+     * Set ImpersonateUserEmail
+     *
+     * Impersonate a user by email on an already user-authenticated request.
+     * Requires the current request to be authenticated as a user with
+     * impersonator capability; X-Appwrite-Key alone is not sufficient.
+     * Impersonator users are intentionally granted users.read so they can
+     * discover a target before impersonation begins. Internal audit logs still
+     * attribute actions to the original impersonator and record the impersonated
+     * target only in internal audit payload data.
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setImpersonateUserEmail(value: string): this {
+        this.headers['X-Appwrite-Impersonate-User-Email'] = value;
+        this.config.impersonateuseremail = value;
+        return this;
+    }
+
+    /**
+     * Set ImpersonateUserPhone
+     *
+     * Impersonate a user by phone on an already user-authenticated request.
+     * Requires the current request to be authenticated as a user with
+     * impersonator capability; X-Appwrite-Key alone is not sufficient.
+     * Impersonator users are intentionally granted users.read so they can
+     * discover a target before impersonation begins. Internal audit logs still
+     * attribute actions to the original impersonator and record the impersonated
+     * target only in internal audit payload data.
+     *
+     * @param value string
+     *
+     * @return {this}
+     */
+    setImpersonateUserPhone(value: string): this {
+        this.headers['X-Appwrite-Impersonate-User-Phone'] = value;
+        this.config.impersonateuserphone = value;
+        return this;
+    }
+
 
     private realtime: Realtime = {
         socket: undefined,
@@ -588,6 +654,10 @@ class Client {
                 window.localStorage.setItem('cookieFallback', cookieFallback);
             }
 
+            if (data && typeof data === 'object') {
+                data.toString = () => JSONbig.stringify(data);
+            }
+
             return data;
         } catch (e) {
             if (e instanceof AppwriteException) {

src/models.ts

@@ -240,7 +240,7 @@ export namespace Models {
         /**
          * Row sequence ID.
          */
-        $sequence: number;
+        $sequence: string;
         /**
          * Table ID.
          */
@@ -279,7 +279,7 @@ export namespace Models {
         /**
          * Document sequence ID.
          */
-        $sequence: number;
+        $sequence: string;
         /**
          * Collection ID.
          */
@@ -316,15 +316,15 @@ export namespace Models {
          */
         event: string;
         /**
-         * User ID.
+         * User ID of the actor recorded for this log. During impersonation, this is the original impersonator, not the impersonated target user.
          */
         userId: string;
         /**
-         * User Email.
+         * User email of the actor recorded for this log. During impersonation, this is the original impersonator.
          */
         userEmail: string;
         /**
-         * User Name.
+         * User name of the actor recorded for this log. During impersonation, this is the original impersonator.
          */
         userName: string;
         /**
@@ -477,6 +477,14 @@ export namespace Models {
          * Most recent access date in ISO 8601 format. This attribute is only updated again after 24 hours.
          */
         accessedAt: string;
+        /**
+         * Whether the user can impersonate other users.
+         */
+        impersonator?: boolean;
+        /**
+         * ID of the original actor performing the impersonation. Present only when the current request is impersonating another user. Internal audit logs attribute the action to this user, while the impersonated target is recorded only in internal audit payload data.
+         */
+        impersonatorUserId?: string;
     }
 
     /**