@airostack/client 0.1.0 → 0.2.0

package/README.md

@@ -1,23 +1,59 @@
 # @airostack/client
 
-Isomorphic client for [AiroStack](https://console.airoxlab.com) projects — Supabase-style database queries and end-user auth. Zero dependencies, works in **Node.js**, **browsers**, and **React Native / Expo**.
+Official client for [AiroStack](https://console.airoxlab.com) projects — Supabase-style database queries and end-user authentication over your project's Data API.
+
+- **Zero dependencies** — plain `fetch` under the hood
+- **Isomorphic** — Node.js ≥ 18, all browsers, React Native / Expo, edge runtimes
+- **Never throws** — every call resolves to `{ data, error }`
+- **RLS-aware** — signed-in users' JWTs ride along automatically, so your Row Level Security policies apply per user
 
 ```bash
 npm install @airostack/client
 ```
 
-## Setup
+---
+
+## 1. Creating a client
 
 ```ts
 import { createClient } from '@airostack/client';
 
 const client = createClient(
-  'https://<project-ref>.db.airoxlab.com', // project URL (dashboard → Connect)
-  '<publishable-key>',                     // API settings → publishable key
+  'https://<project-ref>.db.airoxlab.com', // Project URL  → dashboard → project → Connect
+  '<publishable-key>',                     // Publishable key → project → API settings
 );
 ```
 
-**React Native:** pass AsyncStorage so sessions persist:
+### All options
+
+```ts
+const client = createClient(url, key, {
+  fetch: customFetch,          // bring your own fetch (rarely needed)
+  auth: {
+    persistSession: true,      // keep users signed in across reloads (default true)
+    storage: AsyncStorage,     // WHERE sessions persist — see React Native below
+    storageKey: 'my.app.auth', // storage key (default 'airostack.auth.token')
+  },
+});
+```
+
+### The two keys
+
+| Key | Where to use | Powers |
+|---|---|---|
+| **Publishable** | browsers, mobile apps — safe to ship | anonymous reads + RLS-scoped access; upgrades to the signed-in user when they log in |
+| **Secret** | servers ONLY — never ship to a client | full read/write, bypasses RLS |
+
+```ts
+// server-side admin client (API routes, cron jobs, workers)
+const admin = createClient(url, process.env.AIROSTACK_SECRET_KEY!, {
+  auth: { persistSession: false },
+});
+```
+
+### React Native / Expo
+
+Sessions persist to `localStorage` by default, which doesn't exist in React Native — pass AsyncStorage:
 
 ```ts
 import AsyncStorage from '@react-native-async-storage/async-storage';
@@ -25,61 +61,336 @@ import AsyncStorage from '@react-native-async-storage/async-storage';
 const client = createClient(url, key, { auth: { storage: AsyncStorage } });
 ```
 
-## Database
+Everything else is identical across platforms.
+
+---
+
+## 2. Database queries — `client.from(table)`
+
+Every chain is *thenable*: `await` it whenever you're done building. The result is always:
 
 ```ts
-// read
-const { data, error } = await client
-  .from('orders')
-  .select('id, item, qty')
-  .eq('status', 'paid')
+{
+  data:   T[] | T | null,  // rows (or a single row after .single())
+  error:  ApiError | null, // never thrown — always check this
+  count:  number | null,   // total rows when { count: 'exact' } was requested
+  status: number,          // HTTP status
+}
+```
+
+### Reading
+
+```ts
+// all columns
+const { data, error } = await client.from('tasks').select();
+
+// specific columns
+await client.from('tasks').select('id, title, done');
+
+// filters (chainable, ANDed together)
+await client.from('tasks').select().eq('done', false).gte('priority', 3);
+
+// sorting + paging
+await client.from('tasks')
+  .select()
   .order('created_at', { ascending: false })
   .limit(20);
 
-// one row
-const { data: order } = await client.from('orders').select().eq('id', id).single();
+// page 2 (rows 20–39)
+await client.from('tasks').select().range(20, 39);
+
+// exactly one row — error if none
+const { data: task } = await client.from('tasks').select().eq('id', id).single();
+
+// one row or null — no error if none
+const { data: maybe } = await client.from('tasks').select().eq('id', id).maybeSingle();
+
+// total count (for pagination UIs)
+const { data: rows, count } = await client
+  .from('tasks')
+  .select('*', { count: 'exact' })
+  .limit(10);
+// count = total matching rows, rows = the first 10
+```
+
+### All filters
+
+| Method | SQL equivalent | Example |
+|---|---|---|
+| `.eq(col, v)` | `col = v` | `.eq('status', 'open')` |
+| `.neq(col, v)` | `col <> v` | `.neq('status', 'done')` |
+| `.gt(col, v)` | `col > v` | `.gt('qty', 10)` |
+| `.gte(col, v)` | `col >= v` | `.gte('price', 100)` |
+| `.lt(col, v)` | `col < v` | `.lt('age', 18)` |
+| `.lte(col, v)` | `col <= v` | `.lte('stock', 5)` |
+| `.like(col, p)` | `col LIKE p` | `.like('name', 'A%')` |
+| `.ilike(col, p)` | `col ILIKE p` (case-insensitive) | `.ilike('email', '%@gmail.com')` |
+| `.filter(col, op, v)` | any operator | `.filter('qty', 'gte', 10)` |
 
-// insert (returns the created rows)
-const { data: created } = await client.from('orders').insert({ item: 'Burger', qty: 2 });
+### Inserting
 
-// update / delete
-await client.from('orders').update({ status: 'done' }).eq('id', id);
-await client.from('orders').delete().eq('id', id);
+```ts
+// single row — returns the created row(s) in data
+const { data, error } = await client.from('tasks').insert({ title: 'Ship v1', done: false });
 
-// count
-const { count } = await client.from('orders').select('*', { count: 'exact' }).limit(1);
+// bulk
+await client.from('tasks').insert([
+  { title: 'One' },
+  { title: 'Two' },
+]);
 ```
 
-Filters: `eq neq gt gte lt lte like ilike`, plus the generic `.filter(col, op, value)`.
-Pagination: `.range(from, to)`. Errors never throw — check `error` on the result.
+### Updating
 
-## Auth
+```ts
+// ALWAYS pair .update() with filters — they choose which rows change
+const { data } = await client
+  .from('tasks')
+  .update({ done: true })
+  .eq('id', taskId);
+// data = the updated rows
+```
+
+### Deleting
 
 ```ts
-await client.auth.signUp({ email, password, options: { data: { name: 'Ada' } } });
-await client.auth.signInWithPassword({ email, password });
-const { data: { user } } = await client.auth.getUser();
-await client.auth.signOut();
+await client.from('tasks').delete().eq('id', taskId);
+```
+
+### Typed rows (TypeScript)
+
+```ts
+interface Task { id: string; title: string; done: boolean; created_at: string }
+
+const { data } = await client.from<Task>('tasks').select().eq('done', false);
+// data: Task[] | null — fully typed
+```
+
+### Error handling
+
+Nothing throws. Check `error` on every result:
+
+```ts
+const { data, error } = await client.from('tasks').select();
+if (error) {
+  console.error(error.message, error.status); // ApiError: message + HTTP status
+  return;
+}
+// data is safe to use here
+```
+
+---
+
+## 3. Authentication — `client.auth`
 
-client.auth.onAuthStateChange((event, session) => {
-  // 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED'
+End-user accounts for **your app's users** (not dashboard accounts). Sessions persist automatically and access tokens refresh themselves.
+
+### Sign up
+
+```ts
+const { data, error } = await client.auth.signUp({
+  email: 'ada@example.com',
+  password: 'secret123',
+  options: { data: { name: 'Ada Lovelace' } },  // optional user metadata
+});
+// data.user, data.session — signed in immediately
+```
+
+### Sign in / out
+
+```ts
+const { data, error } = await client.auth.signInWithPassword({
+  email: 'ada@example.com',
+  password: 'secret123',
 });
+
+await client.auth.signOut(); // drops the stored session
 ```
 
-Sessions persist automatically and access tokens refresh on demand. While a
-user is signed in, every `.from()` query carries their JWT — so your
-**Row Level Security** policies (`auth.uid()` etc.) apply per user, exactly
-like Supabase.
+### Current session & user
+
+```ts
+// fast — local session (auto-refreshes the token if it expired)
+const { data: { session } } = await client.auth.getSession();
+if (session) console.log(session.user.email, session.access_token);
+
+// verified — validates the token against the server
+const { data: { user }, error } = await client.auth.getUser();
+```
 
-## Server-side with the secret key
+### Reacting to auth changes
 
 ```ts
-const admin = createClient(url, process.env.AIROSTACK_SECRET_KEY!, {
+const sub = client.auth.onAuthStateChange((event, session) => {
+  // event: 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED'
+  setUser(session?.user ?? null);
+});
+
+sub.unsubscribe(); // e.g. in a useEffect cleanup
+```
+
+### Auth + RLS: how they connect
+
+While a user is signed in, **every `client.from()` query automatically carries their JWT**. On the server, your Row Level Security policies see them via `auth.uid()`, `auth.email()`, `auth.role()`:
+
+```sql
+-- example policy: users only see their own tasks
+create policy "own tasks" on tasks
+  for select using (auth.uid() = user_id);
+```
+
+No extra client code — sign in, and the same `.from('tasks').select()` now returns only that user's rows.
+
+---
+
+## 4. Recipes
+
+**Next.js — one shared client**
+
+```ts
+// src/lib/airostack.ts
+import { createClient } from '@airostack/client';
+
+export const client = createClient(
+  process.env.NEXT_PUBLIC_AIROSTACK_URL!,
+  process.env.NEXT_PUBLIC_AIROSTACK_KEY!,
+);
+```
+
+**React login form**
+
+```tsx
+async function onSubmit(email: string, password: string) {
+  const { error } = await client.auth.signInWithPassword({ email, password });
+  if (error) return setMessage(error.message);
+  router.push('/dashboard');
+}
+```
+
+**Server route with full access**
+
+```ts
+// app/api/report/route.ts — secret key, server only
+import { createClient } from '@airostack/client';
+
+const admin = createClient(process.env.AIROSTACK_URL!, process.env.AIROSTACK_SECRET_KEY!, {
   auth: { persistSession: false },
 });
-// full access, bypasses RLS — server only, never ship this key to a client
+
+export async function GET() {
+  const { data } = await admin.from('orders').select('*', { count: 'exact' }).limit(1000);
+  return Response.json(data);
+}
+```
+
+**Pagination UI**
+
+```ts
+const PAGE = 25;
+const { data, count } = await client
+  .from('orders')
+  .select('*', { count: 'exact' })
+  .order('created_at', { ascending: false })
+  .range(page * PAGE, page * PAGE + PAGE - 1);
+const totalPages = Math.ceil((count ?? 0) / PAGE);
+```
+
+---
+
+## 5. Exported types
+
+```ts
+import type {
+  ApiResult,      // { data, error, count, status }
+  ApiError,       // Error subclass with .status
+  User,           // { id, email, user_metadata?, created_at? }
+  Session,        // { access_token, refresh_token, expires_in, expires_at?, user }
+  AuthResult,     // { data: { user, session }, error }
+  StorageAdapter, // getItem/setItem/removeItem — for custom session storage
+  ClientOptions,  // createClient's third argument
+} from '@airostack/client';
 ```
 
+## 6. RPC — calling Postgres functions
+
+Define a function in the SQL editor, then call it by name with named arguments:
+
+```sql
+create or replace function total_revenue(since date)
+returns numeric language sql stable as $$
+  select coalesce(sum(amount), 0) from orders where created_at >= since;
+$$;
+```
+
+```ts
+const { data, error } = await client.rpc('total_revenue', { since: '2026-01-01' });
+// scalar functions return the value directly; set-returning functions return rows
+
+const { data: rows } = await client.rpc<Order[]>('orders_by_region', { region: 'EU' });
+```
+
+RPC runs under the caller's role — RLS and `security definer/invoker` behave exactly as in SQL.
+
+## 7. Storage — `client.storage.from(bucket)`
+
+Create buckets in the dashboard (project → Storage). Access rules: **reads on
+public buckets** work with the publishable key; **private buckets and all
+writes** need a signed-in user or the secret key.
+
+```ts
+const avatars = client.storage.from('avatars');
+
+// upload (Blob, File, ArrayBuffer, Uint8Array, or string)
+const { error } = await avatars.upload('u1/profile.png', file, { contentType: 'image/png' });
+
+// download → Blob
+const { data: blob } = await avatars.download('u1/profile.png');
+
+// permanent public URL (public buckets) — great for <img src>
+const { data: { publicUrl } } = avatars.getPublicUrl('u1/profile.png');
+
+// list + delete
+const { data: files } = await avatars.list('u1/', { limit: 50 });
+await avatars.remove(['u1/profile.png']);
+```
+
+## 8. Realtime — `client.channel(name)`
+
+First enable realtime for the table in the dashboard (project → Realtime).
+Then subscribe to live changes:
+
+```ts
+const channel = client
+  .channel('orders-feed')
+  .on('postgres_changes', { event: '*', schema: 'public', table: 'orders' }, (payload) => {
+    // payload: { eventType: 'INSERT'|'UPDATE'|'DELETE', schema, table, new, old }
+    console.log(payload.eventType, payload.new);
+  })
+  .subscribe((status) => console.log(status)); // 'SUBSCRIBED' | 'CLOSED' | 'CHANNEL_ERROR'
+
+// later
+client.removeChannel(channel);   // or channel.unsubscribe()
+client.removeAllChannels();      // app teardown
+```
+
+- Filter per event: `{ event: 'INSERT', table: 'orders' }` — or `'*'` for all.
+- Reconnects automatically with backoff.
+- **Node < 22** has no global WebSocket — pass one:
+
+```ts
+import ws from 'ws';
+const client = createClient(url, key, { realtime: { WebSocket: ws as never } });
+```
+
+Browsers, React Native, and Node ≥ 22 need nothing extra.
+
+## 9. Direct SQL (alternative)
+
+For complex server-side queries you can always skip the API and connect straight
+to your project's Postgres (`db.airoxlab.com:5432`, connection string in the
+dashboard's Connect menu) with any SQL client — the Data API and direct SQL are
+the same database.
+
 ## License
 
 MIT

package/dist/index.d.ts

@@ -1,27 +1,49 @@
 import { AuthClient } from './auth.js';
 import { QueryBuilder } from './query-builder.js';
-import type { ClientOptions } from './types.js';
+import { RealtimeChannel } from './realtime.js';
+import { StorageClient } from './storage.js';
+import { ApiError, type ClientOptions } from './types.js';
 export { ApiError } from './types.js';
 export type { ApiResult, AuthResult, ClientOptions, Session, StorageAdapter, User } from './types.js';
 export { AuthClient } from './auth.js';
 export { QueryBuilder } from './query-builder.js';
+export { StorageClient, StorageBucket, type StorageObjectInfo } from './storage.js';
+export { RealtimeChannel, type PostgresChangePayload, type PostgresChangesFilter, type WebSocketLike, } from './realtime.js';
 /**
- * AiroStack client — Supabase-style API over your project's Data API + Auth.
+ * AiroStack client — Supabase-style API over your project's Data API, Auth,
+ * Storage, and Realtime.
  *
  *   import { createClient } from '@airostack/client';
  *   const client = createClient(process.env.AIROSTACK_URL!, process.env.AIROSTACK_KEY!);
  *
  *   const { data, error } = await client.from('orders').select().eq('status', 'paid');
+ *   const { data: result } = await client.rpc('total_revenue', { since: '2026-01-01' });
  *   await client.auth.signInWithPassword({ email, password });
+ *   await client.storage.from('avatars').upload('u1.png', file);
+ *   client.channel('feed').on('postgres_changes', { event: '*', schema: 'public', table: 'orders' }, cb).subscribe();
  */
 export declare class AiroStackClient {
     private url;
     private key;
     readonly auth: AuthClient;
+    readonly storage: StorageClient;
     private fetcher;
+    private channels;
+    private wsCtor;
     constructor(url: string, key: string, options?: ClientOptions);
     /** Query a table through the Data API (RLS applies per the caller's key/JWT). */
     from<T = Record<string, unknown>>(table: string): QueryBuilder<T>;
+    /** Call a Postgres function in the public schema (PostgREST rpc). */
+    rpc<T = unknown>(fn: string, args?: Record<string, unknown>): Promise<{
+        data: T | null;
+        error: ApiError | null;
+    }>;
+    /** Create a realtime channel (subscribe to Postgres changes). */
+    channel(name: string): RealtimeChannel;
+    /** Unsubscribe and drop a channel. */
+    removeChannel(channel: RealtimeChannel): void;
+    /** Unsubscribe all channels (e.g. on app teardown). */
+    removeAllChannels(): void;
 }
 export declare function createClient(url: string, key: string, options?: ClientOptions): AiroStackClient;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACtG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAId,OAAO,CAAC,GAAG;IAAU,OAAO,CAAC,GAAG;IAH5C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,OAAO,CAAe;gBAEV,GAAG,EAAE,MAAM,EAAU,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAO7E,iFAAiF;IACjF,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;CAMlE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAE/F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAoB,eAAe,EAAsB,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACtG,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AAEvB;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe;IAOd,OAAO,CAAC,GAAG;IAAU,OAAO,CAAC,GAAG;IAN5C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAA8C;gBAExC,GAAG,EAAE,MAAM,EAAU,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAU7E,iFAAiF;IACjF,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;IAOjE,qEAAqE;IAC/D,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE,CAAC;IAsBvH,iEAAiE;IACjE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAMtC,sCAAsC;IACtC,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAI7C,uDAAuD;IACvD,iBAAiB,IAAI,IAAI;CAG1B;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,eAAe,CAE/F"}

package/dist/index.js

@@ -1,22 +1,34 @@
 import { AuthClient } from './auth.js';
 import { QueryBuilder } from './query-builder.js';
+import { defaultWebSocket, RealtimeChannel } from './realtime.js';
+import { StorageClient } from './storage.js';
+import { ApiError } from './types.js';
 export { ApiError } from './types.js';
 export { AuthClient } from './auth.js';
 export { QueryBuilder } from './query-builder.js';
+export { StorageClient, StorageBucket } from './storage.js';
+export { RealtimeChannel, } from './realtime.js';
 /**
- * AiroStack client — Supabase-style API over your project's Data API + Auth.
+ * AiroStack client — Supabase-style API over your project's Data API, Auth,
+ * Storage, and Realtime.
  *
  *   import { createClient } from '@airostack/client';
  *   const client = createClient(process.env.AIROSTACK_URL!, process.env.AIROSTACK_KEY!);
  *
  *   const { data, error } = await client.from('orders').select().eq('status', 'paid');
+ *   const { data: result } = await client.rpc('total_revenue', { since: '2026-01-01' });
  *   await client.auth.signInWithPassword({ email, password });
+ *   await client.storage.from('avatars').upload('u1.png', file);
+ *   client.channel('feed').on('postgres_changes', { event: '*', schema: 'public', table: 'orders' }, cb).subscribe();
  */
 export class AiroStackClient {
     url;
     key;
     auth;
+    storage;
     fetcher;
+    channels = new Set();
+    wsCtor;
     constructor(url, key, options) {
         this.url = url;
         this.key = key;
@@ -25,11 +37,53 @@ export class AiroStackClient {
         this.url = url.replace(/\/+$/, '');
         this.fetcher = options?.fetch ?? ((...args) => fetch(...args));
         this.auth = new AuthClient(this.url, key, this.fetcher, options?.auth);
+        const ctx = { url: this.url, key: this.key, fetch: this.fetcher, accessToken: () => this.auth.accessToken() };
+        this.storage = new StorageClient(ctx);
+        this.wsCtor = options?.realtime?.WebSocket ?? defaultWebSocket();
     }
     /** Query a table through the Data API (RLS applies per the caller's key/JWT). */
     from(table) {
         return new QueryBuilder({ url: this.url, key: this.key, fetch: this.fetcher, accessToken: () => this.auth.accessToken() }, table);
     }
+    /** Call a Postgres function in the public schema (PostgREST rpc). */
+    async rpc(fn, args) {
+        try {
+            const headers = { apikey: this.key, 'content-type': 'application/json' };
+            const token = await this.auth.accessToken();
+            if (token)
+                headers.authorization = `Bearer ${token}`;
+            const res = await this.fetcher(`${this.url}/rest/v1/rpc/${fn}`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(args ?? {}),
+            });
+            if (!res.ok) {
+                const body = (await res.json().catch(() => ({})));
+                const msg = typeof body.message === 'string' ? body.message : `rpc failed (${res.status})`;
+                return { data: null, error: new ApiError(msg, res.status) };
+            }
+            const data = res.status === 204 ? null : (await res.json());
+            return { data, error: null };
+        }
+        catch (err) {
+            return { data: null, error: new ApiError(err.message, 0) };
+        }
+    }
+    /** Create a realtime channel (subscribe to Postgres changes). */
+    channel(name) {
+        const ch = new RealtimeChannel(name, this.url, this.key, this.wsCtor, (c) => this.channels.delete(c));
+        this.channels.add(ch);
+        return ch;
+    }
+    /** Unsubscribe and drop a channel. */
+    removeChannel(channel) {
+        channel.unsubscribe();
+    }
+    /** Unsubscribe all channels (e.g. on app teardown). */
+    removeAllChannels() {
+        for (const ch of [...this.channels])
+            ch.unsubscribe();
+    }
 }
 export function createClient(url, key, options) {
     return new AiroStackClient(url, key, options);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAIN;IAAqB;IAHhC,IAAI,CAAa;IAClB,OAAO,CAAe;IAE9B,YAAoB,GAAW,EAAU,GAAW,EAAE,OAAuB;QAAzD,QAAG,GAAH,GAAG,CAAQ;QAAU,QAAG,GAAH,GAAG,CAAQ;QAClD,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChF,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,GAAG,IAA8B,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC;IAED,iFAAiF;IACjF,IAAI,CAA8B,KAAa;QAC7C,OAAO,IAAI,YAAY,CACrB,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,EACjG,KAAK,CACN,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,GAAW,EAAE,OAAuB;IAC5E,OAAO,IAAI,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/realtime.d.ts

@@ -0,0 +1,58 @@
+/** Minimal WebSocket surface — satisfied by browsers, React Native, and
+ *  Node ≥ 22's global WebSocket (or the `ws` package's default export). */
+export interface WebSocketLike {
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: 'open' | 'message' | 'close' | 'error', cb: (ev: never) => void): void;
+}
+type WebSocketCtor = new (url: string) => WebSocketLike;
+export interface PostgresChangesFilter {
+    event: 'INSERT' | 'UPDATE' | 'DELETE' | '*';
+    schema?: string;
+    table: string;
+}
+export interface PostgresChangePayload<T = Record<string, unknown>> {
+    eventType: 'INSERT' | 'UPDATE' | 'DELETE';
+    schema: string;
+    table: string;
+    /** the row after the change (INSERT/UPDATE) */
+    new: T | null;
+    /** the row before the change (DELETE) */
+    old: T | null;
+}
+type ChangeCallback = (payload: PostgresChangePayload) => void;
+type Status = 'SUBSCRIBED' | 'CLOSED' | 'CHANNEL_ERROR';
+/**
+ * Live Postgres change subscriptions — supabase-style:
+ *
+ *   const channel = client
+ *     .channel('orders-feed')
+ *     .on('postgres_changes', { event: '*', schema: 'public', table: 'orders' }, (payload) => {
+ *       console.log(payload.eventType, payload.new);
+ *     })
+ *     .subscribe();
+ *   // later: client.removeChannel(channel)
+ *
+ * Tables must have Realtime enabled in the dashboard (project → Realtime).
+ * Reconnects automatically with backoff until unsubscribed.
+ */
+export declare class RealtimeChannel {
+    readonly name: string;
+    private url;
+    private key;
+    private WS;
+    private onRemove;
+    private bindings;
+    private ws;
+    private closedByUser;
+    private retry;
+    private statusCb;
+    constructor(name: string, url: string, key: string, WS: WebSocketCtor | null, onRemove: (ch: RealtimeChannel) => void);
+    on(_type: 'postgres_changes', filter: PostgresChangesFilter, callback: ChangeCallback): this;
+    subscribe(statusCallback?: (status: Status) => void): this;
+    private connect;
+    unsubscribe(): void;
+}
+export declare function defaultWebSocket(): WebSocketCtor | null;
+export {};
+//# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA;2EAC2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/F;AACD,KAAK,aAAa,GAAG,KAAK,GAAG,EAAE,MAAM,KAAK,aAAa,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,GAAG,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAChE,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;IACd,yCAAyC;IACzC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC;CACf;AAED,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAC/D,KAAK,MAAM,GAAG,YAAY,GAAG,QAAQ,GAAG,eAAe,CAAC;AAOxD;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAe;aAQR,IAAI,EAAE,MAAM;IAC5B,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ;IAXlB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,EAAE,CAA8B;IACxC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAA2C;gBAGzC,IAAI,EAAE,MAAM,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,aAAa,GAAG,IAAI,EACxB,QAAQ,EAAE,CAAC,EAAE,EAAE,eAAe,KAAK,IAAI;IAGjD,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,qBAAqB,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI;IAK5F,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAY1D,OAAO,CAAC,OAAO;IAmDf,WAAW,IAAI,IAAI;CAKpB;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAGvD"}

package/dist/realtime.js

@@ -0,0 +1,112 @@
+/**
+ * Live Postgres change subscriptions — supabase-style:
+ *
+ *   const channel = client
+ *     .channel('orders-feed')
+ *     .on('postgres_changes', { event: '*', schema: 'public', table: 'orders' }, (payload) => {
+ *       console.log(payload.eventType, payload.new);
+ *     })
+ *     .subscribe();
+ *   // later: client.removeChannel(channel)
+ *
+ * Tables must have Realtime enabled in the dashboard (project → Realtime).
+ * Reconnects automatically with backoff until unsubscribed.
+ */
+export class RealtimeChannel {
+    name;
+    url;
+    key;
+    WS;
+    onRemove;
+    bindings = [];
+    ws = null;
+    closedByUser = false;
+    retry = 0;
+    statusCb = null;
+    constructor(name, url, key, WS, onRemove) {
+        this.name = name;
+        this.url = url;
+        this.key = key;
+        this.WS = WS;
+        this.onRemove = onRemove;
+    }
+    on(_type, filter, callback) {
+        this.bindings.push({ filter, callback });
+        return this;
+    }
+    subscribe(statusCallback) {
+        this.statusCb = statusCallback ?? null;
+        if (!this.WS) {
+            this.statusCb?.('CHANNEL_ERROR');
+            throw new Error('No WebSocket available. On Node < 22 pass one: createClient(url, key, { realtime: { WebSocket: require("ws") } })');
+        }
+        this.connect();
+        return this;
+    }
+    connect() {
+        const tables = [...new Set(this.bindings.map((b) => b.filter.table))].join(',');
+        const wsUrl = `${this.url.replace(/^http/, 'ws')}/realtime/v1?apikey=${encodeURIComponent(this.key)}${tables ? `&tables=${encodeURIComponent(tables)}` : ''}`;
+        const ws = new this.WS(wsUrl);
+        this.ws = ws;
+        ws.addEventListener('open', () => {
+            this.retry = 0;
+            this.statusCb?.('SUBSCRIBED');
+        });
+        ws.addEventListener('message', ((ev) => {
+            try {
+                const msg = JSON.parse(String(ev.data));
+                if (msg.type !== 'change' || !msg.event)
+                    return;
+                const e = msg.event;
+                const eventType = (e.type ?? '');
+                if (!['INSERT', 'UPDATE', 'DELETE'].includes(eventType))
+                    return;
+                const payload = {
+                    eventType,
+                    schema: e.schema ?? 'public',
+                    table: e.table ?? '',
+                    new: eventType === 'DELETE' ? null : (e.record ?? null),
+                    old: eventType === 'DELETE' ? (e.record ?? null) : null,
+                };
+                for (const b of this.bindings) {
+                    if (b.filter.table !== payload.table)
+                        continue;
+                    if (b.filter.schema && b.filter.schema !== payload.schema)
+                        continue;
+                    if (b.filter.event !== '*' && b.filter.event !== payload.eventType)
+                        continue;
+                    b.callback(payload);
+                }
+            }
+            catch {
+                // ignore malformed frames
+            }
+        }));
+        ws.addEventListener('close', () => {
+            if (this.closedByUser) {
+                this.statusCb?.('CLOSED');
+                return;
+            }
+            // auto-reconnect with capped backoff
+            const delay = Math.min(1_000 * 2 ** this.retry++, 15_000);
+            setTimeout(() => { if (!this.closedByUser)
+                this.connect(); }, delay);
+        });
+        ws.addEventListener('error', () => {
+            // close handler drives the reconnect
+        });
+    }
+    unsubscribe() {
+        this.closedByUser = true;
+        try {
+            this.ws?.close(1000, 'unsubscribed');
+        }
+        catch { /* already closed */ }
+        this.onRemove(this);
+    }
+}
+export function defaultWebSocket() {
+    const ws = globalThis.WebSocket;
+    return ws ?? null;
+}
+//# sourceMappingURL=realtime.js.map

package/dist/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"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"}

package/dist/storage.d.ts

@@ -0,0 +1,57 @@
+import { ApiError } from './types.js';
+type TokenProvider = () => Promise<string | null>;
+interface Ctx {
+    url: string;
+    key: string;
+    fetch: typeof fetch;
+    accessToken: TokenProvider;
+}
+export interface StorageObjectInfo {
+    name: string;
+    size: number;
+    updated_at: string | null;
+}
+type StorageResult<T> = {
+    data: T | null;
+    error: ApiError | null;
+};
+/** File storage for one bucket — `client.storage.from('avatars')`.
+ *  Reads on public buckets work with the publishable key; private buckets and
+ *  all writes need a signed-in user or the secret key. */
+export declare class StorageBucket {
+    private ctx;
+    private bucket;
+    constructor(ctx: Ctx, bucket: string);
+    private headers;
+    private fail;
+    /** Upload (or overwrite) a file. Body: Blob, File, ArrayBuffer, Uint8Array, or string. */
+    upload(path: string, body: Blob | ArrayBuffer | Uint8Array | string, options?: {
+        contentType?: string;
+    }): Promise<StorageResult<{
+        path: string;
+    }>>;
+    /** Download a file. Returns a Blob (browser/RN) — use .arrayBuffer()/.text() as needed. */
+    download(path: string): Promise<StorageResult<Blob>>;
+    /** Delete files. */
+    remove(paths: string[]): Promise<StorageResult<{
+        removed: string[];
+    }>>;
+    /** List objects (optionally under a prefix). */
+    list(prefix?: string, options?: {
+        limit?: number;
+    }): Promise<StorageResult<StorageObjectInfo[]>>;
+    /** Permanent unauthenticated URL for an object in a PUBLIC bucket —
+     *  perfect for <img src>. */
+    getPublicUrl(path: string): {
+        data: {
+            publicUrl: string;
+        };
+    };
+}
+export declare class StorageClient {
+    private ctx;
+    constructor(ctx: Ctx);
+    from(bucket: string): StorageBucket;
+}
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,KAAK,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAElD,UAAU,GAAG;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,WAAW,EAAE,aAAa,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,KAAK,aAAa,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;CAAE,CAAC;AAEnE;;0DAE0D;AAC1D,qBAAa,aAAa;IACZ,OAAO,CAAC,GAAG;IAAO,OAAO,CAAC,MAAM;gBAAxB,GAAG,EAAE,GAAG,EAAU,MAAM,EAAE,MAAM;YAEtC,OAAO;YAOP,IAAI;IAKlB,0FAA0F;IACpF,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,EAC9C,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACjC,OAAO,CAAC,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAiB3C,2FAA2F;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAY1D,oBAAoB;IACd,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAiB5E,gDAAgD;IAC1C,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC,CAAC;IActG;iCAC6B;IAC7B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;CAI5D;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,GAAG;IAC5B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;CAGpC"}

package/dist/storage.js

@@ -0,0 +1,106 @@
+import { ApiError } from './types.js';
+/** File storage for one bucket — `client.storage.from('avatars')`.
+ *  Reads on public buckets work with the publishable key; private buckets and
+ *  all writes need a signed-in user or the secret key. */
+export class StorageBucket {
+    ctx;
+    bucket;
+    constructor(ctx, bucket) {
+        this.ctx = ctx;
+        this.bucket = bucket;
+    }
+    async headers(extra) {
+        const h = { apikey: this.ctx.key, ...extra };
+        const token = await this.ctx.accessToken();
+        if (token)
+            h.authorization = `Bearer ${token}`;
+        return h;
+    }
+    async fail(res) {
+        const body = (await res.json().catch(() => ({})));
+        return new ApiError(typeof body.message === 'string' ? body.message : `storage error (${res.status})`, res.status);
+    }
+    /** Upload (or overwrite) a file. Body: Blob, File, ArrayBuffer, Uint8Array, or string. */
+    async upload(path, body, options) {
+        try {
+            const contentType = options?.contentType ??
+                (typeof Blob !== 'undefined' && body instanceof Blob && body.type ? body.type : 'application/octet-stream');
+            const res = await this.ctx.fetch(`${this.ctx.url}/storage/v1/object/${this.bucket}/${path}`, {
+                method: 'POST',
+                headers: await this.headers({ 'content-type': contentType }),
+                body: body,
+            });
+            if (!res.ok)
+                return { data: null, error: await this.fail(res) };
+            return { data: { path }, error: null };
+        }
+        catch (err) {
+            return { data: null, error: new ApiError(err.message, 0) };
+        }
+    }
+    /** Download a file. Returns a Blob (browser/RN) — use .arrayBuffer()/.text() as needed. */
+    async download(path) {
+        try {
+            const res = await this.ctx.fetch(`${this.ctx.url}/storage/v1/object/${this.bucket}/${path}`, {
+                headers: await this.headers(),
+            });
+            if (!res.ok)
+                return { data: null, error: await this.fail(res) };
+            return { data: await res.blob(), error: null };
+        }
+        catch (err) {
+            return { data: null, error: new ApiError(err.message, 0) };
+        }
+    }
+    /** Delete files. */
+    async remove(paths) {
+        try {
+            const removed = [];
+            for (const path of paths) {
+                const res = await this.ctx.fetch(`${this.ctx.url}/storage/v1/object/${this.bucket}/${path}`, {
+                    method: 'DELETE',
+                    headers: await this.headers(),
+                });
+                if (!res.ok)
+                    return { data: null, error: await this.fail(res) };
+                removed.push(path);
+            }
+            return { data: { removed }, error: null };
+        }
+        catch (err) {
+            return { data: null, error: new ApiError(err.message, 0) };
+        }
+    }
+    /** List objects (optionally under a prefix). */
+    async list(prefix, options) {
+        try {
+            const res = await this.ctx.fetch(`${this.ctx.url}/storage/v1/object/list/${this.bucket}`, {
+                method: 'POST',
+                headers: await this.headers({ 'content-type': 'application/json' }),
+                body: JSON.stringify({ prefix, limit: options?.limit }),
+            });
+            if (!res.ok)
+                return { data: null, error: await this.fail(res) };
+            return { data: (await res.json()), error: null };
+        }
+        catch (err) {
+            return { data: null, error: new ApiError(err.message, 0) };
+        }
+    }
+    /** Permanent unauthenticated URL for an object in a PUBLIC bucket —
+     *  perfect for <img src>. */
+    getPublicUrl(path) {
+        const ref = new URL(this.ctx.url).hostname.split('.')[0];
+        return { data: { publicUrl: `${this.ctx.url}/storage/v1/object/public/${ref}/${this.bucket}/${path}` } };
+    }
+}
+export class StorageClient {
+    ctx;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    from(bucket) {
+        return new StorageBucket(this.ctx, bucket);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -51,5 +51,10 @@ export interface ClientOptions {
         /** storage key (default 'airostack.auth.token') */
         storageKey?: string;
     };
+    realtime?: {
+        /** WebSocket implementation — needed on Node < 22 (pass the `ws` package).
+         *  Browsers, React Native, and Node ≥ 22 use the global automatically. */
+        WebSocket?: new (url: string) => import('./realtime.js').WebSocketLike;
+    };
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;yBACyB;AACzB,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,oEAAoE;IACpE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,QAAQ,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE;QAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IACrD,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxB;AAED;iDACiD;AACjD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE;QACL,yCAAyC;QACzC,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,8DAA8D;QAC9D,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,mDAAmD;QACnD,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;yBACyB;AACzB,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,oEAAoE;IACpE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,MAAM,EAAE,MAAM,CAAC;gBACH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,QAAQ,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE;QAAE,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC;IACrD,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;CACxB;AAED;iDACiD;AACjD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED,MAAM,WAAW,aAAa;IAC5B,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,IAAI,CAAC,EAAE;QACL,yCAAyC;QACzC,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,8DAA8D;QAC9D,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,mDAAmD;QACnD,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT;kFAC0E;QAC1E,SAAS,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,OAAO,eAAe,EAAE,aAAa,CAAC;KACxE,CAAC;CACH"}

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@airostack/client",
-  "version": "0.1.0",
-  "description": "Isomorphic client for AiroStack projects — Supabase-style Data API queries and Auth. Works in Node.js, browsers, and React Native.",
+  "version": "0.2.0",
+  "description": "Isomorphic client for AiroStack projects — Supabase-style database queries, auth, RPC, storage, and realtime. Works in Node.js, browsers, and React Native.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/airoxlab/baseway.git",
+    "url": "git+https://github.com/airoxlab/baseway.git",
     "directory": "packages/client"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": ["airostack", "postgrest", "database", "auth", "baas", "react-native"],
   "type": "module",
   "main": "./dist/index.js",