feat: React Native SDK update for version 0.30.0

.github/workflows/publish.yml

@@ -14,10 +14,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
     - name: Use Node.js
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
       with:
         node-version: '24.14.1'
         registry-url: 'https://registry.npmjs.org'

.npmrc

@@ -0,0 +1 @@
+min-release-age=7

CHANGELOG.md

@@ -1,11 +1,20 @@
 # Change log
 
+## 0.30.0
+
+* Added: Realtime `presences` channel and `RealtimePresence` types for presence subscriptions
+* Added: `Advisor` and `Presences` services
+* Added: `Insight`, `Presence`, and `Report` models with list variants
+* Added: `fusionauth`, `keycloak`, and `kick` providers to `OAuthProvider` enum
+* Added: `Client.setCookie()` method for forwarding cookies in server-side runtimes
+* Updated: `X-Appwrite-Response-Format` header to `1.9.5`
+
 ## 0.29.0
 
-* Breaking: Added `subscribe` message flow for Realtime subscription updates.
-* Breaking: Added `close()` support for Realtime subscriptions.
-* Added: Added `subscriptions` metadata to Realtime events for targeted callbacks.
-* Updated: Updated `X-Appwrite-Response-Format` header to `1.9.2`.
+* Breaking: Added `subscribe` message flow for Realtime subscription updates
+* Breaking: Added `close()` support for Realtime subscriptions
+* Added: Added `subscriptions` metadata to Realtime events for targeted callbacks
+* Updated: Updated `X-Appwrite-Response-Format` header to `1.9.2`
 
 ## 0.28.0
 

README.md

@@ -1,7 +1,7 @@
 # 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.9.2-blue.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.9.5-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)

docs/examples/advisor/get-insight.md

@@ -0,0 +1,16 @@
+```javascript
+import { Client, Advisor } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const advisor = new Advisor(client);
+
+const result = await advisor.getInsight({
+    reportId: '<REPORT_ID>',
+    insightId: '<INSIGHT_ID>'
+});
+
+console.log(result);
+```

docs/examples/advisor/get-report.md

@@ -0,0 +1,15 @@
+```javascript
+import { Client, Advisor } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const advisor = new Advisor(client);
+
+const result = await advisor.getReport({
+    reportId: '<REPORT_ID>'
+});
+
+console.log(result);
+```

docs/examples/advisor/list-insights.md

@@ -0,0 +1,17 @@
+```javascript
+import { Client, Advisor } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const advisor = new Advisor(client);
+
+const result = await advisor.listInsights({
+    reportId: '<REPORT_ID>',
+    queries: [], // optional
+    total: false // optional
+});
+
+console.log(result);
+```

docs/examples/advisor/list-reports.md

@@ -0,0 +1,16 @@
+```javascript
+import { Client, Advisor } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const advisor = new Advisor(client);
+
+const result = await advisor.listReports({
+    queries: [], // optional
+    total: false // optional
+});
+
+console.log(result);
+```

docs/examples/functions/create-execution.md

@@ -11,7 +11,7 @@ const result = await functions.createExecution({
     functionId: '<FUNCTION_ID>',
     body: '<BODY>', // optional
     async: false, // optional
-    path: '<PATH>', // optional
+    xpath: '<PATH>', // optional
     method: ExecutionMethod.GET, // optional
     headers: {}, // optional
     scheduledAt: '<SCHEDULED_AT>' // optional

docs/examples/presences/delete.md

@@ -0,0 +1,15 @@
+```javascript
+import { Client, Presences } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const presences = new Presences(client);
+
+const result = await presences.delete({
+    presenceId: '<PRESENCE_ID>'
+});
+
+console.log(result);
+```

docs/examples/presences/get.md

@@ -0,0 +1,15 @@
+```javascript
+import { Client, Presences } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const presences = new Presences(client);
+
+const result = await presences.get({
+    presenceId: '<PRESENCE_ID>'
+});
+
+console.log(result);
+```

docs/examples/presences/list.md

@@ -0,0 +1,17 @@
+```javascript
+import { Client, Presences } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const presences = new Presences(client);
+
+const result = await presences.list({
+    queries: [], // optional
+    total: false, // optional
+    ttl: 0 // optional
+});
+
+console.log(result);
+```

docs/examples/presences/update.md

@@ -0,0 +1,20 @@
+```javascript
+import { Client, Presences, Permission, Role } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const presences = new Presences(client);
+
+const result = await presences.update({
+    presenceId: '<PRESENCE_ID>',
+    status: '<STATUS>', // optional
+    expiresAt: '2020-10-15T06:38:00.000+00:00', // optional
+    metadata: {}, // optional
+    permissions: ["read("any")"], // optional
+    purge: false // optional
+});
+
+console.log(result);
+```

docs/examples/presences/upsert.md

@@ -0,0 +1,19 @@
+```javascript
+import { Client, Presences, Permission, Role } from "react-native-appwrite";
+
+const client = new Client()
+    .setEndpoint('https://<REGION>.cloud.appwrite.io/v1') // Your API Endpoint
+    .setProject('<YOUR_PROJECT_ID>'); // Your project ID
+
+const presences = new Presences(client);
+
+const result = await presences.upsert({
+    presenceId: '<PRESENCE_ID>',
+    status: '<STATUS>',
+    permissions: ["read("any")"], // optional
+    expiresAt: '2020-10-15T06:38:00.000+00:00', // optional
+    metadata: {} // optional
+});
+
+console.log(result);
+```

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.29.0",
+  "version": "0.30.0",
   "license": "BSD-3-Clause",
   "main": "dist/cjs/sdk.js",
   "exports": {
@@ -52,6 +52,7 @@
     "glob": "^13.0.0",
     "rimraf": "^6.0.0",
     "@xmldom/xmldom": "^0.9.10",
-    "uuid": "^14.0.0"
+    "uuid": "^14.0.0",
+    "postcss": "^8.5.12"
   }
 }

src/channel.ts

@@ -11,9 +11,10 @@ interface Func { _fn: any }
 interface Execution { _exec: any }
 interface Team { _team: any }
 interface Membership { _mem: any }
+interface Presence { _presence: any }
 interface Resolved { _res: any }
 
-type Actionable = Document | Row | File | Team | Membership;
+type Actionable = Document | Row | File | Team | Membership | Presence;
 
 function normalize(id: string): string {
   if (id === undefined || id === null) {
@@ -79,7 +80,7 @@ export class Channel<T> {
     return this.resolve("create");
   }
 
-  upsert(this: Channel<Document | Row>): Channel<Resolved> {
+  upsert(this: Channel<Document | Row | Presence>): Channel<Resolved> {
     return this.resolve("upsert");
   }
 
@@ -120,6 +121,10 @@ export class Channel<T> {
     return new Channel<Membership>(["memberships", normalize(id)]);
   }
 
+  static presence(id: string) {
+    return new Channel<Presence>(["presences", normalize(id)]);
+  }
+
   static account(): string {
     return "account";
   }
@@ -148,8 +153,12 @@ export class Channel<T> {
   static memberships(): string {
     return "memberships";
   }
+
+  static presences(): string {
+    return "presences";
+  }
 }
 
 // Export types for backward compatibility with realtime
-export type ActionableChannel = Channel<Document> | Channel<Row> | Channel<File> | Channel<Execution> | Channel<Team> | Channel<Membership>;
+export type ActionableChannel = Channel<Document> | Channel<Row> | Channel<File> | Channel<Execution> | Channel<Team> | Channel<Membership> | Channel<Presence>;
 export type ResolvedChannel = Channel<Resolved>;