@motherbase/client 1.0.0

package/README.md

@@ -0,0 +1,121 @@
+# @motherbase/client
+
+Typed, isomorphic client SDK for the Motherbase client. Works in the browser,
+Next.js (server & client), and Expo Go / React Native. Built on the global
+`fetch` with zero runtime dependencies (`socket.io-client` is an optional peer
+dependency, used only for realtime).
+
+## Install
+
+```bash
+npm i @motherbase/client
+# optional, only if you use realtime:
+npm i socket.io-client
+```
+
+## Quickstart
+
+```ts
+import { createClient, localStorageStorage } from '@motherbase/client';
+
+const client = createClient('http://localhost:5050', {
+  storage: localStorageStorage(), // omit for in-memory (SSR-safe) sessions
+});
+
+await client.hydrate(); // restore a persisted session (optional)
+
+// Auth
+await client.auth.register({ email: 'me@example.com', password: 'secret123' });
+const session = await client.auth.login({ email: 'me@example.com', password: 'secret123' });
+const user = await client.auth.getUser();
+
+// React to auth changes
+const unsubscribe = client.auth.onAuthStateChange((event, session) => {
+  console.log(event, session?.user.email);
+});
+
+// Storage
+const file = await client.storage.upload(myBlob, { visibility: 'public' });
+const url = await client.storage.getUrl(file.id);
+
+// Devices (push)
+await client.devices.register({ token: pushToken, platform: 'ios' });
+
+// REST API (policy-checked /rest/v1)
+const products = await client.rest.from<{ id: string; name: string; price: number }>('products').list({
+  filters: { price: { op: 'lt', value: 50 } },
+  order: [{ field: 'name' }],
+  limit: 20,
+});
+await client.rest.insert('products', { name: 'Tea', price: 12 });
+
+// Edge functions
+const result = await client.edge.invoke<{ ok: boolean }>('hello', { name: 'Ada' });
+
+// Realtime (requires socket.io-client)
+await client.realtime.connect();
+client.realtime.on('message', (msg) => console.log(msg));
+```
+
+The SDK attaches the access token automatically and transparently refreshes it on
+a 401 (single-flight: concurrent requests share one refresh). When the refresh
+token is invalid it clears the session and emits a `signOut` event.
+
+## Storage adapters
+
+| Runtime  | Adapter |
+| -------- | ------- |
+| Browser  | `localStorageStorage()` |
+| SSR/Node | `memoryStorage()` (default) |
+| Expo/RN  | custom `{ get, set }` backed by `AsyncStorage` |
+
+```ts
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { createClient } from '@motherbase/client';
+
+const client = createClient(API_URL, {
+  storage: {
+    async get() {
+      const raw = await AsyncStorage.getItem('session');
+      return raw ? JSON.parse(raw) : null;
+    },
+    async set(session) {
+      if (session) await AsyncStorage.setItem('session', JSON.stringify(session));
+      else await AsyncStorage.removeItem('session');
+    },
+  },
+});
+```
+
+## API surface
+
+- `client.auth` — register, login, loginWithEmail, validateEmail, refresh,
+  logout, forgotPassword, resetPassword, getUser, getSession, onAuthStateChange
+- `client.users` — updateUsername, updateImage, deleteAccount
+- `client.storage` — upload, presign, getUrl, remove
+- `client.devices` — register, unregister
+- `client.rest` — typed CRUD over `/rest/v1/:model` with policy checks
+- `client.edge` — invoke public edge routes exposed at `/api/edge/:route`
+- `client.realtime` — connect, on, off, emit, disconnect
+
+All methods reject with a `clientError` (`message`, `httpStatus`, `apiStatus`)
+on failure.
+
+More examples live in [`docs/sdk.md`](../../docs/sdk.md). Studio also exposes a
+project-specific Connect page with the exact API URL, WebSocket URL and project
+ID to paste into `.env`.
+
+### REST filters
+
+`client.rest` accepts the client query operators directly:
+
+```ts
+await client.rest.from('products').list({
+  select: ['id', 'name'],
+  filters: {
+    price: { op: 'lte', value: 100 },
+    status: { op: 'in', value: ['active', 'draft'] },
+  },
+  order: [{ field: 'createdAt', direction: 'desc' }],
+});
+```

package/dist/auth.d.ts

@@ -0,0 +1,61 @@
+import type { HttpClient } from './http.js';
+import type { SessionStore } from './session.js';
+import type { AuthListener, Session, User } from './types.js';
+interface RegisterParams {
+    email: string;
+    password: string;
+    username?: string;
+}
+interface LoginParams {
+    email: string;
+    password: string;
+}
+interface ResetPasswordParams {
+    email: string;
+    secretCode: string;
+    newPassword: string;
+}
+interface AppleAuthParams {
+    identityToken: string;
+    email?: string | null;
+    fullName?: {
+        givenName?: string | null;
+        familyName?: string | null;
+    } | null;
+}
+export declare class AuthModule {
+    private readonly http;
+    private readonly store;
+    constructor(http: HttpClient, store: SessionStore);
+    register(params: RegisterParams): Promise<Session>;
+    login(params: LoginParams): Promise<Session>;
+    /** Passwordless email flow: requests a verification code. */
+    loginWithEmail(params: {
+        email: string;
+    }): Promise<unknown>;
+    validateEmail(params: {
+        emailVerificationId: string;
+        secretCode: string;
+    }): Promise<Session>;
+    forgotPassword(params: {
+        email: string;
+    }): Promise<unknown>;
+    resetPassword(params: ResetPasswordParams): Promise<unknown>;
+    loginWithGoogle(params: {
+        idToken: string;
+    }): Promise<Session>;
+    google(idToken: string): Promise<Session>;
+    loginWithApple(params: AppleAuthParams): Promise<Session>;
+    apple(params: AppleAuthParams): Promise<Session>;
+    /** Rotate tokens using the stored refresh token. Returns true on success. */
+    refresh(): Promise<boolean>;
+    logout(): Promise<void>;
+    /** Fetch the current user from the API (requires a valid session). */
+    getUser(): Promise<User>;
+    /** The locally-held session, if any. */
+    getSession(): Session | null;
+    onAuthStateChange(listener: AuthListener): () => void;
+    private persist;
+}
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAE9D,UAAU,cAAc;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AACD,UAAU,eAAe;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7E;AAeD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAc,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAxC,IAAI,EAAE,UAAU,EAAmB,KAAK,EAAE,YAAY;IAE7E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD,6DAA6D;IAC7D,cAAc,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrD,aAAa,CAAC,MAAM,EAAE;QAAE,mBAAmB,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IASlG,cAAc,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,eAAe,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IASpE,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInC,cAAc,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/D,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAIhD,6EAA6E;IACvE,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAgB3B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB7B,sEAAsE;IACtE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,wCAAwC;IACxC,UAAU,IAAI,OAAO,GAAG,IAAI;IAI5B,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,IAAI;YAIvC,OAAO;CAKtB"}

package/dist/auth.js

@@ -0,0 +1,115 @@
+/** Split the flattened auth payload into a clean Session. */
+function toSession(payload) {
+    const { accessToken, refreshToken, userToken: _userToken, ...user } = payload;
+    return { accessToken, refreshToken, user: user };
+}
+export class AuthModule {
+    constructor(http, store) {
+        this.http = http;
+        this.store = store;
+    }
+    async register(params) {
+        const payload = await this.http.request('/api/auth/register', {
+            method: 'POST',
+            body: params,
+            anonymous: true,
+        });
+        return this.persist(payload);
+    }
+    async login(params) {
+        const payload = await this.http.request('/api/auth/login', {
+            method: 'POST',
+            body: params,
+            anonymous: true,
+        });
+        return this.persist(payload);
+    }
+    /** Passwordless email flow: requests a verification code. */
+    loginWithEmail(params) {
+        return this.http.request('/api/auth/email', { method: 'PUT', body: params, anonymous: true });
+    }
+    async validateEmail(params) {
+        const payload = await this.http.request('/api/auth/validate-email', {
+            method: 'PUT',
+            body: params,
+            anonymous: true,
+        });
+        return this.persist(payload);
+    }
+    forgotPassword(params) {
+        return this.http.request('/api/auth/forgot-password', { method: 'POST', body: params, anonymous: true });
+    }
+    resetPassword(params) {
+        return this.http.request('/api/auth/reset-password', { method: 'POST', body: params, anonymous: true });
+    }
+    async loginWithGoogle(params) {
+        const payload = await this.http.request('/api/auth/google', {
+            method: 'PUT',
+            body: params,
+            anonymous: true,
+        });
+        return this.persist(payload);
+    }
+    google(idToken) {
+        return this.loginWithGoogle({ idToken });
+    }
+    async loginWithApple(params) {
+        const payload = await this.http.request('/api/auth/apple', {
+            method: 'PUT',
+            body: params,
+            anonymous: true,
+        });
+        return this.persist(payload);
+    }
+    apple(params) {
+        return this.loginWithApple(params);
+    }
+    /** Rotate tokens using the stored refresh token. Returns true on success. */
+    async refresh() {
+        const session = this.store.get();
+        if (!session?.refreshToken)
+            return false;
+        try {
+            const tokens = await this.http.request('/api/auth/refresh', { method: 'POST', body: { refreshToken: session.refreshToken }, anonymous: true });
+            await this.store.setTokens(tokens.accessToken, tokens.refreshToken);
+            return true;
+        }
+        catch {
+            await this.store.set(null, 'signOut');
+            return false;
+        }
+    }
+    async logout() {
+        const session = this.store.get();
+        if (session?.refreshToken) {
+            try {
+                await this.http.request('/api/auth/logout', {
+                    method: 'POST',
+                    body: { refreshToken: session.refreshToken },
+                    anonymous: true,
+                });
+            }
+            catch {
+                // best-effort; clear locally regardless
+            }
+        }
+        await this.store.set(null, 'signOut');
+    }
+    /** Fetch the current user from the API (requires a valid session). */
+    getUser() {
+        return this.http.request('/api/auth/');
+    }
+    /** The locally-held session, if any. */
+    getSession() {
+        return this.store.get();
+    }
+    onAuthStateChange(listener) {
+        return this.store.subscribe(listener);
+    }
+    async persist(payload) {
+        const session = toSession(payload);
+        await this.store.set(session, 'signIn');
+        return session;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/devices.d.ts

@@ -0,0 +1,13 @@
+import type { HttpClient } from './http.js';
+import type { DevicePlatform } from './types.js';
+export declare class DevicesModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Register a push token for the current user. */
+    register(params: {
+        token: string;
+        platform: DevicePlatform;
+    }): Promise<unknown>;
+    unregister(token: string): Promise<unknown>;
+}
+//# sourceMappingURL=devices.d.ts.map

package/dist/devices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.d.ts","sourceRoot":"","sources":["../src/devices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/E,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG5C"}

package/dist/devices.js

@@ -0,0 +1,13 @@
+export class DevicesModule {
+    constructor(http) {
+        this.http = http;
+    }
+    /** Register a push token for the current user. */
+    register(params) {
+        return this.http.request('/api/devices/', { method: 'POST', body: params });
+    }
+    unregister(token) {
+        return this.http.request('/api/devices/', { method: 'DELETE', body: { token } });
+    }
+}
+//# sourceMappingURL=devices.js.map

package/dist/devices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.js","sourceRoot":"","sources":["../src/devices.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,aAAa;IACxB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,kDAAkD;IAClD,QAAQ,CAAC,MAAmD;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,UAAU,CAAC,KAAa;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/edge.d.ts

@@ -0,0 +1,7 @@
+import type { HttpClient } from './http.js';
+export declare class EdgeModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    invoke<Result = unknown, Payload = Record<string, unknown>>(route: string, payload?: Payload): Promise<Result>;
+}
+//# sourceMappingURL=edge.d.ts.map

package/dist/edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.d.ts","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAO/G"}

package/dist/edge.js

@@ -0,0 +1,13 @@
+export class EdgeModule {
+    constructor(http) {
+        this.http = http;
+    }
+    invoke(route, payload) {
+        return this.http.request(`/api/edge/${encodeURIComponent(route)}`, {
+            method: 'POST',
+            body: payload ?? {},
+            anonymous: true,
+        });
+    }
+}
+//# sourceMappingURL=edge.js.map

package/dist/edge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge.js","sourceRoot":"","sources":["../src/edge.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;IACrB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,MAAM,CAAsD,KAAa,EAAE,OAAiB;QAC1F,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAS,aAAa,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE;YACzE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,OAAO,IAAI,EAAE;YACnB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,45 @@
+import type { SessionStore } from './session.js';
+/** Error thrown for any non-successful API response. */
+export declare class BackendError extends Error {
+    /** HTTP status code (0 if the request never completed). */
+    readonly httpStatus: number;
+    /** The API envelope's `status` field when present. */
+    readonly apiStatus?: number;
+    constructor(message: string, httpStatus: number, apiStatus?: number);
+}
+export interface RequestOptions {
+    method?: string;
+    /** JSON body. Mutually exclusive with `form`. */
+    body?: unknown;
+    /** Multipart body. Mutually exclusive with `body`. */
+    form?: FormData;
+    /** Skip attaching the Authorization header (used by auth endpoints). */
+    anonymous?: boolean;
+    /** Internal: prevents infinite refresh recursion. */
+    _retry?: boolean;
+}
+/**
+ * fetch wrapper that injects the bearer token, unwraps the API envelope, maps
+ * failures to BackendError, and performs single-flight token refresh on 401.
+ */
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly store;
+    private readonly opts;
+    /** Performs the refresh; returns true on success. Injected to avoid a cycle. */
+    private readonly doRefresh;
+    private refreshPromise;
+    constructor(baseUrl: string, store: SessionStore, opts: {
+        autoRefresh: boolean;
+        fetch: typeof fetch;
+    }, 
+    /** Performs the refresh; returns true on success. Injected to avoid a cycle. */
+    doRefresh: () => Promise<boolean>);
+    request<T>(path: string, options?: RequestOptions): Promise<T>;
+    /** Shared single-flight refresh: concurrent callers await the same promise. */
+    private refreshOnce;
+    private send;
+    private parse;
+    private url;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,wDAAwD;AACxD,qBAAa,YAAa,SAAQ,KAAK;IACrC,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAMpE;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sDAAsD;IACtD,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,UAAU;IAInB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,gFAAgF;IAChF,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,cAAc,CAAiC;gBAGpC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,KAAK,CAAA;KAAE;IACpE,gFAAgF;IAC/D,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IAG9C,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;IAaxE,+EAA+E;IAC/E,OAAO,CAAC,WAAW;YASL,IAAI;YAsBJ,KAAK;IAgBnB,OAAO,CAAC,GAAG;CAGZ"}

package/dist/http.js

@@ -0,0 +1,81 @@
+/** Error thrown for any non-successful API response. */
+export class BackendError extends Error {
+    constructor(message, httpStatus, apiStatus) {
+        super(message);
+        this.name = 'BackendError';
+        this.httpStatus = httpStatus;
+        this.apiStatus = apiStatus;
+    }
+}
+/**
+ * fetch wrapper that injects the bearer token, unwraps the API envelope, maps
+ * failures to BackendError, and performs single-flight token refresh on 401.
+ */
+export class HttpClient {
+    constructor(baseUrl, store, opts, 
+    /** Performs the refresh; returns true on success. Injected to avoid a cycle. */
+    doRefresh) {
+        this.baseUrl = baseUrl;
+        this.store = store;
+        this.opts = opts;
+        this.doRefresh = doRefresh;
+        this.refreshPromise = null;
+    }
+    async request(path, options = {}) {
+        const res = await this.send(path, options);
+        if (res.status === 401 && this.opts.autoRefresh && !options.anonymous && !options._retry) {
+            const refreshed = await this.refreshOnce();
+            if (refreshed) {
+                return this.request(path, { ...options, _retry: true });
+            }
+        }
+        return this.parse(res);
+    }
+    /** Shared single-flight refresh: concurrent callers await the same promise. */
+    refreshOnce() {
+        if (!this.refreshPromise) {
+            this.refreshPromise = this.doRefresh().finally(() => {
+                this.refreshPromise = null;
+            });
+        }
+        return this.refreshPromise;
+    }
+    async send(path, options) {
+        const headers = {};
+        const session = this.store.get();
+        if (!options.anonymous && session?.accessToken) {
+            headers['Authorization'] = `Bearer ${session.accessToken}`;
+        }
+        let body;
+        if (options.form) {
+            body = options.form; // browser/runtime sets the multipart boundary
+        }
+        else if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(options.body);
+        }
+        return this.opts.fetch(this.url(path), {
+            method: options.method ?? 'GET',
+            headers,
+            body,
+        });
+    }
+    async parse(res) {
+        let envelope;
+        try {
+            envelope = (await res.json());
+        }
+        catch {
+            // non-JSON response
+        }
+        if (!res.ok || (envelope && envelope.status === 0)) {
+            const message = envelope?.message ?? `Request failed with status ${res.status}`;
+            throw new BackendError(message, res.status, envelope?.status);
+        }
+        return (envelope?.data ?? envelope);
+    }
+    url(path) {
+        return `${this.baseUrl.replace(/\/$/, '')}${path}`;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { memoryStorage, localStorageStorage } from './session.js';
+import { AuthModule } from './auth.js';
+import { UsersModule } from './profile.js';
+import { StorageModule } from './storage.js';
+import { DevicesModule } from './devices.js';
+import { RealtimeModule } from './realtime.js';
+import { RestModule } from './rest.js';
+import { EdgeModule } from './edge.js';
+import type { ClientOptions } from './types.js';
+export declare class BackendClient {
+    readonly auth: AuthModule;
+    readonly users: UsersModule;
+    readonly storage: StorageModule;
+    readonly devices: DevicesModule;
+    readonly realtime: RealtimeModule;
+    readonly rest: RestModule;
+    readonly edge: EdgeModule;
+    private readonly store;
+    constructor(apiUrl: string, options?: ClientOptions);
+    /** Load any persisted session before first use. Optional but recommended. */
+    hydrate(): Promise<unknown>;
+}
+/** Create a client for the given API base URL. */
+export declare function createClient(apiUrl: string, options?: ClientOptions): BackendClient;
+export { BackendError } from './http.js';
+export { memoryStorage, localStorageStorage };
+export type { ApiEnvelope, User, Tokens, Session, FileObject, FileVisibility, DevicePlatform, SessionStorageAdapter, ClientOptions, AuthEvent, AuthListener, } from './types.js';
+export type { OrderDirection, RestFilters, RestFilterValue, RestListOptions, RestMutationOptions, RestOperator, } from './rest.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;IAwBvD,6EAA6E;IAC7E,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAG5B;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,aAAa,CAEvF;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,IAAI,EACJ,MAAM,EACN,OAAO,EACP,UAAU,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,42 @@
+import { HttpClient } from './http.js';
+import { SessionStore, memoryStorage, localStorageStorage } from './session.js';
+import { AuthModule } from './auth.js';
+import { UsersModule } from './profile.js';
+import { StorageModule } from './storage.js';
+import { DevicesModule } from './devices.js';
+import { RealtimeModule } from './realtime.js';
+import { RestModule } from './rest.js';
+import { EdgeModule } from './edge.js';
+export class BackendClient {
+    constructor(apiUrl, options = {}) {
+        const fetchImpl = options.fetch ?? globalThis.fetch;
+        if (!fetchImpl) {
+            throw new Error('No fetch implementation found. Pass `fetch` in options for this runtime.');
+        }
+        const autoRefresh = options.autoRefresh ?? true;
+        this.store = new SessionStore(options.storage ?? memoryStorage());
+        // auth needs the http client, and http needs auth.refresh for the 401 path,
+        // so wire them in two steps with a late-bound refresh callback.
+        let auth;
+        const http = new HttpClient(apiUrl, this.store, { autoRefresh, fetch: fetchImpl }, () => auth.refresh());
+        auth = new AuthModule(http, this.store);
+        this.auth = auth;
+        this.users = new UsersModule(http);
+        this.storage = new StorageModule(http);
+        this.devices = new DevicesModule(http);
+        this.realtime = new RealtimeModule(apiUrl, this.store);
+        this.rest = new RestModule(http);
+        this.edge = new EdgeModule(http);
+    }
+    /** Load any persisted session before first use. Optional but recommended. */
+    hydrate() {
+        return this.store.hydrate();
+    }
+}
+/** Create a client for the given API base URL. */
+export function createClient(apiUrl, options = {}) {
+    return new BackendClient(apiUrl, options);
+}
+export { BackendError } from './http.js';
+export { memoryStorage, localStorageStorage };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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,aAAa,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,OAAO,aAAa;IAWxB,YAAY,MAAc,EAAE,UAAyB,EAAE;QACrD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;QAC9F,CAAC;QACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;QAEhD,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,OAAO,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC,CAAC;QAElE,4EAA4E;QAC5E,gEAAgE;QAChE,IAAI,IAAiB,CAAC;QACtB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACzG,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAExC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,6EAA6E;IAC7E,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF;AAED,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,UAAyB,EAAE;IACtE,OAAO,IAAI,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/profile.d.ts

@@ -0,0 +1,16 @@
+import type { HttpClient } from './http.js';
+import type { User } from './types.js';
+/** A file-ish value accepted by multipart uploads (browser File/Blob or RN asset). */
+export type UploadInput = Blob | {
+    uri: string;
+    name?: string;
+    type?: string;
+};
+export declare class UsersModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    updateUsername(username: string): Promise<User>;
+    updateImage(file: UploadInput): Promise<User>;
+    deleteAccount(): Promise<unknown>;
+}
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,sFAAsF;AACtF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAW/E,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7C,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC"}

package/dist/profile.js

@@ -0,0 +1,26 @@
+function appendFile(form, field, file) {
+    if (typeof Blob !== 'undefined' && file instanceof Blob) {
+        form.append(field, file);
+    }
+    else {
+        // React Native style { uri, name, type }
+        form.append(field, file);
+    }
+}
+export class UsersModule {
+    constructor(http) {
+        this.http = http;
+    }
+    updateUsername(username) {
+        return this.http.request('/api/users/username', { method: 'PUT', body: { username } });
+    }
+    updateImage(file) {
+        const form = new FormData();
+        appendFile(form, 'image', file);
+        return this.http.request('/api/users/image', { method: 'PUT', form });
+    }
+    deleteAccount() {
+        return this.http.request('/api/users/', { method: 'DELETE' });
+    }
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAMA,SAAS,UAAU,CAAC,IAAc,EAAE,KAAa,EAAE,IAAiB;IAClE,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,yCAAyC;QACzC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAuB,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,OAAO,WAAW;IACtB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,cAAc,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAO,qBAAqB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,WAAW,CAAC,IAAiB;QAC3B,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAO,kBAAkB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/realtime.d.ts

@@ -0,0 +1,18 @@
+import type { SessionStore } from './session.js';
+/**
+ * Lazy wrapper over socket.io-client. The dependency is optional: it is only
+ * imported when `connect()` is called, so apps that never use realtime do not
+ * need to install it.
+ */
+export declare class RealtimeModule {
+    private readonly baseUrl;
+    private readonly store;
+    private socket;
+    constructor(baseUrl: string, store: SessionStore);
+    connect(): Promise<void>;
+    on(event: string, cb: (...args: unknown[]) => void): void;
+    off(event: string, cb?: (...args: unknown[]) => void): void;
+    emit(event: string, ...args: unknown[]): void;
+    disconnect(): void;
+}
+//# 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,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAajD;;;;GAIG;AACH,qBAAa,cAAc;IAGb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAAU,OAAO,CAAC,QAAQ,CAAC,KAAK;IAFpE,OAAO,CAAC,MAAM,CAA2B;gBAEZ,OAAO,EAAE,MAAM,EAAmB,KAAK,EAAE,YAAY;IAE5E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAIzD,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAI3D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI7C,UAAU,IAAI,IAAI;CAInB"}

package/dist/realtime.js

@@ -0,0 +1,45 @@
+/**
+ * Lazy wrapper over socket.io-client. The dependency is optional: it is only
+ * imported when `connect()` is called, so apps that never use realtime do not
+ * need to install it.
+ */
+export class RealtimeModule {
+    constructor(baseUrl, store) {
+        this.baseUrl = baseUrl;
+        this.store = store;
+        this.socket = null;
+    }
+    async connect() {
+        if (this.socket?.connected)
+            return;
+        let io;
+        try {
+            // socket.io-client is an optional peer dependency; resolved at runtime only.
+            // @ts-ignore -- the module may not be installed at build time
+            ({ io } = (await import('socket.io-client')));
+        }
+        catch {
+            throw new Error('Realtime requires the optional dependency "socket.io-client". Install it: npm i socket.io-client');
+        }
+        const token = this.store.get()?.accessToken;
+        this.socket = io(this.baseUrl, {
+            path: '/ws',
+            transports: ['websocket'],
+            auth: token ? { token } : {},
+        });
+    }
+    on(event, cb) {
+        this.socket?.on(event, cb);
+    }
+    off(event, cb) {
+        this.socket?.off(event, cb);
+    }
+    emit(event, ...args) {
+        this.socket?.emit(event, ...args);
+    }
+    disconnect() {
+        this.socket?.disconnect();
+        this.socket = 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":"AAaA;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAGzB,YAA6B,OAAe,EAAmB,KAAmB;QAArD,YAAO,GAAP,OAAO,CAAQ;QAAmB,UAAK,GAAL,KAAK,CAAc;QAF1E,WAAM,GAAsB,IAAI,CAAC;IAE4C,CAAC;IAEtF,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS;YAAE,OAAO;QACnC,IAAI,EAAa,CAAC;QAClB,IAAI,CAAC;YACH,6EAA6E;YAC7E,8DAA8D;YAC9D,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAiC,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,kGAAkG,CACnG,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,WAAW,CAAC;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE;YAC7B,IAAI,EAAE,KAAK;YACX,UAAU,EAAE,CAAC,WAAW,CAAC;YACzB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,EAAE,CAAC,KAAa,EAAE,EAAgC;QAChD,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,KAAa,EAAE,EAAiC;QAClD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,GAAG,IAAe;QACpC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,UAAU;QACR,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;CACF"}

package/dist/rest.d.ts

@@ -0,0 +1,50 @@
+import type { HttpClient } from './http.js';
+type Primitive = string | number | boolean | null;
+export type RestOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'is';
+export type OrderDirection = 'asc' | 'desc';
+export type RestFilterValue = Primitive | {
+    op: RestOperator;
+    value: Primitive | Primitive[];
+};
+export type RestFilters = Record<string, RestFilterValue>;
+export interface RestListOptions {
+    select?: string[];
+    filters?: RestFilters;
+    order?: Array<{
+        field: string;
+        direction?: OrderDirection;
+    }>;
+    limit?: number;
+    offset?: number;
+}
+export interface RestMutationOptions {
+    filters?: RestFilters;
+}
+export declare class RestTable<Row extends object = Record<string, unknown>> {
+    private readonly http;
+    private readonly model;
+    constructor(http: HttpClient, model: string);
+    list(options?: RestListOptions): Promise<Row[]>;
+    insert(data: Partial<Row>): Promise<Row[]>;
+    update(data: Partial<Row>, options?: RestMutationOptions): Promise<Row[] | {
+        count: number;
+    }>;
+    remove(options?: RestMutationOptions): Promise<Row[] | {
+        count: number;
+    }>;
+}
+export declare class RestModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    from<Row extends object = Record<string, unknown>>(model: string): RestTable<Row>;
+    list<Row extends object = Record<string, unknown>>(model: string, options?: RestListOptions): Promise<Row[]>;
+    insert<Row extends object = Record<string, unknown>>(model: string, data: Partial<Row>): Promise<Row[]>;
+    update<Row extends object = Record<string, unknown>>(model: string, data: Partial<Row>, options?: RestMutationOptions): Promise<Row[] | {
+        count: number;
+    }>;
+    remove<Row extends object = Record<string, unknown>>(model: string, options?: RestMutationOptions): Promise<Row[] | {
+        count: number;
+    }>;
+}
+export {};
+//# sourceMappingURL=rest.d.ts.map

package/dist/rest.d.ts.map

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

package/dist/rest.js

@@ -0,0 +1,75 @@
+function encodeValue(value) {
+    if (Array.isArray(value))
+        return `(${value.map(encodeValue).join(',')})`;
+    if (value === null)
+        return 'null';
+    return String(value);
+}
+function encodeFilter(value) {
+    if (value && typeof value === 'object' && 'op' in value) {
+        return `${value.op}.${encodeValue(value.value)}`;
+    }
+    return encodeValue(value);
+}
+function toQuery(options = {}) {
+    const params = new URLSearchParams();
+    const listOptions = options;
+    if (listOptions.select?.length)
+        params.set('select', listOptions.select.join(','));
+    if (listOptions.order?.length) {
+        params.set('order', listOptions.order.map(({ field, direction = 'asc' }) => `${field}.${direction}`).join(','));
+    }
+    if (typeof listOptions.limit === 'number')
+        params.set('limit', String(listOptions.limit));
+    if (typeof listOptions.offset === 'number')
+        params.set('offset', String(listOptions.offset));
+    for (const [field, value] of Object.entries(options.filters ?? {})) {
+        params.set(field, encodeFilter(value));
+    }
+    const query = params.toString();
+    return query ? `?${query}` : '';
+}
+export class RestTable {
+    constructor(http, model) {
+        this.http = http;
+        this.model = model;
+    }
+    list(options = {}) {
+        return this.http.request(`/rest/v1/${encodeURIComponent(this.model)}${toQuery(options)}`);
+    }
+    insert(data) {
+        return this.http.request(`/rest/v1/${encodeURIComponent(this.model)}`, { method: 'POST', body: data });
+    }
+    update(data, options = {}) {
+        return this.http.request(`/rest/v1/${encodeURIComponent(this.model)}${toQuery(options)}`, {
+            method: 'PATCH',
+            body: data,
+        });
+    }
+    remove(options = {}) {
+        return this.http.request(`/rest/v1/${encodeURIComponent(this.model)}${toQuery(options)}`, {
+            method: 'DELETE',
+        });
+    }
+}
+export class RestModule {
+    constructor(http) {
+        this.http = http;
+    }
+    from(model) {
+        return new RestTable(this.http, model);
+    }
+    list(model, options = {}) {
+        return this.from(model).list(options);
+    }
+    insert(model, data) {
+        return this.from(model).insert(data);
+    }
+    update(model, data, options = {}) {
+        return this.from(model).update(data, options);
+    }
+    remove(model, options = {}) {
+        return this.from(model).remove(options);
+    }
+}
+//# sourceMappingURL=rest.js.map

package/dist/rest.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,29 @@
+import type { Session, SessionStorageAdapter, AuthEvent, AuthListener } from './types.js';
+/** In-memory adapter. Safe everywhere (SSR, tests); does not survive reloads. */
+export declare function memoryStorage(): SessionStorageAdapter;
+/**
+ * Browser localStorage adapter. Falls back to memory when localStorage is
+ * unavailable (SSR, private mode), so it never throws on import or use.
+ */
+export declare function localStorageStorage(key?: string): SessionStorageAdapter;
+/**
+ * Holds the live session in memory, mirrors it to a storage adapter, and
+ * notifies listeners of auth changes. The in-memory copy is the source of truth
+ * for synchronous reads (e.g. attaching the bearer header).
+ */
+export declare class SessionStore {
+    private readonly storage;
+    private current;
+    private readonly listeners;
+    private hydrated;
+    constructor(storage: SessionStorageAdapter);
+    /** Load the persisted session once. Idempotent. */
+    hydrate(): Promise<Session | null>;
+    get(): Session | null;
+    set(session: Session | null, event: AuthEvent): Promise<void>;
+    /** Replace only the tokens, keeping the existing user (used after refresh). */
+    setTokens(accessToken: string, refreshToken: string): Promise<void>;
+    subscribe(listener: AuthListener): () => void;
+    private emit;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1F,iFAAiF;AACjF,wBAAgB,aAAa,IAAI,qBAAqB,CAQrD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,SAAuB,GAAG,qBAAqB,CAkBrF;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAKX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAS;gBAEI,OAAO,EAAE,qBAAqB;IAE3D,mDAAmD;IAC7C,OAAO,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAOxC,GAAG,IAAI,OAAO,GAAG,IAAI;IAIf,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE,+EAA+E;IACzE,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,IAAI;IAK7C,OAAO,CAAC,IAAI;CAGb"}

package/dist/session.js

@@ -0,0 +1,83 @@
+/** In-memory adapter. Safe everywhere (SSR, tests); does not survive reloads. */
+export function memoryStorage() {
+    let current = null;
+    return {
+        get: () => current,
+        set: (s) => {
+            current = s;
+        },
+    };
+}
+/**
+ * Browser localStorage adapter. Falls back to memory when localStorage is
+ * unavailable (SSR, private mode), so it never throws on import or use.
+ */
+export function localStorageStorage(key = 'motherbase.session') {
+    const ls = typeof globalThis !== 'undefined' ? globalThis.localStorage : undefined;
+    if (!ls)
+        return memoryStorage();
+    return {
+        get: () => {
+            const raw = ls.getItem(key);
+            if (!raw)
+                return null;
+            try {
+                return JSON.parse(raw);
+            }
+            catch {
+                return null;
+            }
+        },
+        set: (s) => {
+            if (s)
+                ls.setItem(key, JSON.stringify(s));
+            else
+                ls.removeItem(key);
+        },
+    };
+}
+/**
+ * Holds the live session in memory, mirrors it to a storage adapter, and
+ * notifies listeners of auth changes. The in-memory copy is the source of truth
+ * for synchronous reads (e.g. attaching the bearer header).
+ */
+export class SessionStore {
+    constructor(storage) {
+        this.storage = storage;
+        this.current = null;
+        this.listeners = new Set();
+        this.hydrated = false;
+    }
+    /** Load the persisted session once. Idempotent. */
+    async hydrate() {
+        if (this.hydrated)
+            return this.current;
+        this.current = (await this.storage.get()) ?? null;
+        this.hydrated = true;
+        return this.current;
+    }
+    get() {
+        return this.current;
+    }
+    async set(session, event) {
+        this.current = session;
+        this.hydrated = true;
+        await this.storage.set(session);
+        this.emit(event);
+    }
+    /** Replace only the tokens, keeping the existing user (used after refresh). */
+    async setTokens(accessToken, refreshToken) {
+        if (!this.current)
+            return;
+        await this.set({ ...this.current, accessToken, refreshToken }, 'tokenRefreshed');
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(event) {
+        for (const l of this.listeners)
+            l(event, this.current);
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,29 @@
+import type { HttpClient } from './http.js';
+import type { FileObject, FileVisibility } from './types.js';
+import type { UploadInput } from './profile.js';
+interface UploadOptions {
+    visibility?: FileVisibility;
+    bucket?: string;
+}
+interface PresignParams {
+    filename: string;
+    mime?: string;
+    visibility?: FileVisibility;
+    bucket?: string;
+}
+export declare class StorageModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Multipart upload through the API (field name: "file"). */
+    upload(file: UploadInput, options?: UploadOptions): Promise<FileObject>;
+    /** Request a presigned PUT URL for direct-to-storage upload (S3 driver). */
+    presign(params: PresignParams): Promise<{
+        url: string;
+        [k: string]: unknown;
+    }>;
+    /** Get a (possibly signed) download URL for a stored file. */
+    getUrl(id: string): Promise<string>;
+    remove(id: string): Promise<unknown>;
+}
+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,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAS3E,4EAA4E;IAC5E,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAI9E,8DAA8D;IACxD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrC"}

package/dist/storage.js

@@ -0,0 +1,31 @@
+export class StorageModule {
+    constructor(http) {
+        this.http = http;
+    }
+    /** Multipart upload through the API (field name: "file"). */
+    upload(file, options = {}) {
+        const form = new FormData();
+        if (typeof Blob !== 'undefined' && file instanceof Blob)
+            form.append('file', file);
+        else
+            form.append('file', file);
+        if (options.visibility)
+            form.append('visibility', options.visibility);
+        if (options.bucket)
+            form.append('bucket', options.bucket);
+        return this.http.request('/api/files/', { method: 'POST', form });
+    }
+    /** Request a presigned PUT URL for direct-to-storage upload (S3 driver). */
+    presign(params) {
+        return this.http.request('/api/files/presign', { method: 'POST', body: params });
+    }
+    /** Get a (possibly signed) download URL for a stored file. */
+    async getUrl(id) {
+        const res = await this.http.request(`/api/files/${id}/url`);
+        return res.url;
+    }
+    remove(id) {
+        return this.http.request(`/api/files/${id}`, { method: 'DELETE' });
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,aAAa;IACxB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,6DAA6D;IAC7D,MAAM,CAAC,IAAiB,EAAE,UAAyB,EAAE;QACnD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;;YAC9E,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAuB,CAAC,CAAC;QAClD,IAAI,OAAO,CAAC,UAAU;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACtE,IAAI,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,MAAqB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO,GAAG,CAAC,GAAG,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/** Shared types for the Motherbase client SDK. */
+/** The envelope every API endpoint wraps its payload in. */
+export interface ApiEnvelope<T = unknown> {
+    status: 0 | 1;
+    message: string;
+    data?: T;
+    pager?: Record<string, unknown>;
+}
+/** Authenticated user as returned by the API. Extra fields are preserved. */
+export interface User {
+    id: string;
+    email: string;
+    username?: string | null;
+    role?: string;
+    [key: string]: unknown;
+}
+/** Token pair issued by login/register/refresh. */
+export interface Tokens {
+    accessToken: string;
+    refreshToken: string;
+}
+/** The locally-held session: tokens plus the user they belong to. */
+export interface Session extends Tokens {
+    user: User;
+}
+/** A stored file as returned by the storage endpoints. */
+export interface FileObject {
+    id: string;
+    filename?: string;
+    mime?: string;
+    visibility?: 'public' | 'private';
+    bucket?: string;
+    url?: string;
+    [key: string]: unknown;
+}
+export type FileVisibility = 'public' | 'private';
+export type DevicePlatform = 'ios' | 'android' | 'web';
+/**
+ * Persists the session between runs. Implementations must be synchronous-or-async
+ * tolerant: every method may return a value or a promise of it.
+ */
+export interface SessionStorageAdapter {
+    get(): Session | null | Promise<Session | null>;
+    set(session: Session | null): void | Promise<void>;
+}
+export interface ClientOptions {
+    /** Where to persist the session. Defaults to in-memory (SSR-safe). */
+    storage?: SessionStorageAdapter;
+    /** Refresh the access token automatically on a 401. Default: true. */
+    autoRefresh?: boolean;
+    /** Override the fetch implementation (for SSR or tests). */
+    fetch?: typeof fetch;
+}
+export type AuthEvent = 'signIn' | 'signOut' | 'tokenRefreshed';
+export type AuthListener = (event: AuthEvent, session: Session | null) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,4DAA4D;AAC5D,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,6EAA6E;AAC7E,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mDAAmD;AACnD,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,MAAM,WAAW,OAAQ,SAAQ,MAAM;IACrC,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAClD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,IAAI,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Shared types for the Motherbase client SDK. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@motherbase/client",
+  "version": "1.0.0",
+  "description": "Typed client SDK for Motherbase, the open source self-hosted backend platform.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "sdk",
+    "client",
+    "auth",
+    "backend",
+    "motherbase",
+    "self-hosted"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "socket.io-client": "^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "socket.io-client": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.4.2"
+  }
+}