@motherbase/client 1.0.1 → 1.1.1

package/dist/index.d.ts

@@ -1,31 +1,65 @@
 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 { AuthClient } from './auth.js';
+import { StorageClient } from './storage.js';
+import { FunctionsClient } from './functions.js';
 import { RealtimeModule } from './realtime.js';
-import { RestModule } from './rest.js';
-import { EdgeModule } from './edge.js';
+import { RealtimeChannel, type RealtimeChannelOptions } from './channel.js';
+import { PostgrestQueryBuilder } from './postgrest.js';
 import type { ClientOptions } from './types.js';
-export declare class BackendClient {
-    readonly auth: AuthModule;
-    readonly users: UsersModule;
-    readonly storage: StorageModule;
-    readonly devices: DevicesModule;
+/**
+ * Supabase-js-compatible client for a Motherbase backend.
+ *
+ * Drop-in shaped: `client.from(table).select()…`, `client.auth.signInWithPassword()`,
+ * `client.storage.from(bucket)`, `client.channel(name)`, `client.functions.invoke()`.
+ */
+export declare class MotherbaseClient {
+    private readonly url;
+    /** Accepted for supabase-js signature parity; sent as an `apikey` header when set. */
+    readonly key?: string | undefined;
+    readonly auth: AuthClient;
+    readonly storage: StorageClient;
+    readonly functions: FunctionsClient;
+    /** Low-level realtime transport. Prefer `channel()` for the Supabase surface. */
     readonly realtime: RealtimeModule;
-    readonly rest: RestModule;
-    readonly edge: EdgeModule;
+    private readonly http;
     private readonly store;
-    constructor(apiUrl: string, options?: ClientOptions);
+    private readonly channels;
+    constructor(url: string, 
+    /** Accepted for supabase-js signature parity; sent as an `apikey` header when set. */
+    key?: string | undefined, options?: ClientOptions);
+    /** Start a PostgREST-style query against a table. */
+    from<Row extends object = Record<string, unknown>>(table: string): PostgrestQueryBuilder<Row>;
+    /** Create (or reuse) a realtime channel. */
+    channel(name: string, opts?: RealtimeChannelOptions): RealtimeChannel;
+    /** Unsubscribe and drop a channel. */
+    removeChannel(channel: RealtimeChannel): Promise<'ok'>;
+    /** Unsubscribe and drop every channel. */
+    removeAllChannels(): Promise<'ok'>;
     /** 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;
+/**
+ * Create a Supabase-compatible Motherbase client.
+ *
+ * @param url  Backend API base URL.
+ * @param key  Anon/publishable key (optional). Sent as an `apikey` header.
+ * @param options  Session storage, fetch override, extra headers.
+ */
+export declare function createClient(url: string, key?: string, options?: ClientOptions): MotherbaseClient;
 export { BackendError } from './http.js';
 export { memoryStorage, localStorageStorage };
 export { cookieStorage, serverCookieStorage } from './cookie.js';
+export { PostgrestQueryBuilder } from './postgrest.js';
+export type { PostgrestSingleBuilder } from './postgrest.js';
+export { AuthClient } from './auth.js';
+export type { SignUpCredentials, SignInWithPasswordCredentials, Subscription } from './auth.js';
+export { StorageClient, StorageBucket } from './storage.js';
+export type { UploadOptions, UploadResult } from './storage.js';
+export { FunctionsClient } from './functions.js';
+export type { FunctionInvokeAuth, FunctionInvokeOptions } from './functions.js';
+export { RealtimeChannel } from './channel.js';
+export type { PostgresChangeEvent, PostgresChangeFilter, PostgresChangePayload, ChannelStatus, BroadcastFilter, PresenceFilter, BroadcastMessage, BroadcastReceived, RealtimeChannelOptions, PresenceEntry, PresenceState, PresenceJoinPayload, PresenceLeavePayload, } from './channel.js';
 export type { CookieAdapter, CookieOptions } from './cookie.js';
-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';
+export type { ApiEnvelope, User, Tokens, Session, FileObject, FileVisibility, StorageUploadResponse, StorageRemoveResponse, UploadInput, SessionStorageAdapter, ClientOptions, MotherbaseResponse, MotherbaseError, AuthChangeEvent, AuthChangeListener, } from './types.js';
+export type { RealtimeConnectOptions, RealtimeStatus, RealtimeStatusListener, RealtimeWatchEvent, RealtimeWatchOptions, IoFactory, SocketLike, } from './realtime.js';
 //# 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":"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,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,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"}
+{"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,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAYzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,sFAAsF;IACtF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM;IAbvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAElC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;gBAG5C,GAAG,EAAE,MAAM;IAC5B,sFAAsF;IAC7E,GAAG,CAAC,EAAE,MAAM,YAAA,EACrB,OAAO,GAAE,aAAkB;IAwB7B,qDAAqD;IACrD,IAAI,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC;IAI7F,4CAA4C;IAC5C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,eAAe;IAQzE,sCAAsC;IAChC,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5D,0CAA0C;IACpC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMxC,6EAA6E;IAC7E,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAG5B;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,gBAAgB,CAErG;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,iBAAiB,EAAE,6BAA6B,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EACV,WAAW,EACX,IAAI,EACJ,MAAM,EACN,OAAO,EACP,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,qBAAqB,EACrB,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,UAAU,GACX,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,43 +1,89 @@
 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 { AuthClient } from './auth.js';
+import { StorageClient } from './storage.js';
+import { FunctionsClient } from './functions.js';
 import { RealtimeModule } from './realtime.js';
-import { RestModule } from './rest.js';
-import { EdgeModule } from './edge.js';
-export class BackendClient {
-    constructor(apiUrl, options = {}) {
+import { RealtimeChannel } from './channel.js';
+import { PostgrestQueryBuilder } from './postgrest.js';
+/**
+ * Supabase-js-compatible client for a Motherbase backend.
+ *
+ * Drop-in shaped: `client.from(table).select()…`, `client.auth.signInWithPassword()`,
+ * `client.storage.from(bucket)`, `client.channel(name)`, `client.functions.invoke()`.
+ */
+export class MotherbaseClient {
+    constructor(url, 
+    /** Accepted for supabase-js signature parity; sent as an `apikey` header when set. */
+    key, options = {}) {
+        this.url = url;
+        this.key = key;
+        this.channels = new Map();
         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;
+        const headers = { ...options.headers };
+        if (key)
+            headers['apikey'] = key;
         this.store = new SessionStore(options.storage ?? memoryStorage());
-        // auth needs the http client, and http needs auth.refresh for the 401 path,
+        // 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.http = new HttpClient(url, this.store, { autoRefresh, fetch: fetchImpl, headers }, () => auth._refresh());
+        auth = new AuthClient(this.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);
+        this.storage = new StorageClient(this.http, url);
+        this.functions = new FunctionsClient(this.http);
+        this.realtime = new RealtimeModule(url, this.store, fetchImpl, options.realtimeIoFactory);
+    }
+    /** Start a PostgREST-style query against a table. */
+    from(table) {
+        return new PostgrestQueryBuilder(this.http, table);
+    }
+    /** Create (or reuse) a realtime channel. */
+    channel(name, opts = {}) {
+        const existing = this.channels.get(name);
+        if (existing)
+            return existing;
+        const channel = new RealtimeChannel(name, this.realtime, opts);
+        this.channels.set(name, channel);
+        return channel;
+    }
+    /** Unsubscribe and drop a channel. */
+    async removeChannel(channel) {
+        await channel.unsubscribe();
+        this.channels.delete(channel.topic);
+        return 'ok';
+    }
+    /** Unsubscribe and drop every channel. */
+    async removeAllChannels() {
+        await Promise.all(Array.from(this.channels.values()).map(c => c.unsubscribe()));
+        this.channels.clear();
+        return 'ok';
     }
     /** 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);
+/**
+ * Create a Supabase-compatible Motherbase client.
+ *
+ * @param url  Backend API base URL.
+ * @param key  Anon/publishable key (optional). Sent as an `apikey` header.
+ * @param options  Session storage, fetch override, extra headers.
+ */
+export function createClient(url, key, options = {}) {
+    return new MotherbaseClient(url, key, options);
 }
 export { BackendError } from './http.js';
 export { memoryStorage, localStorageStorage };
 export { cookieStorage, serverCookieStorage } from './cookie.js';
+export { PostgrestQueryBuilder } from './postgrest.js';
+export { AuthClient } from './auth.js';
+export { StorageClient, StorageBucket } from './storage.js';
+export { FunctionsClient } from './functions.js';
+export { RealtimeChannel } from './channel.js';
 //# sourceMappingURL=index.js.map

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,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;AAC9C,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/postgrest.d.ts

@@ -0,0 +1,58 @@
+import { HttpClient } from './http.js';
+import type { MotherbaseResponse } from './types.js';
+type Primitive = string | number | boolean | null;
+/**
+ * PostgREST-style, chainable, thenable query builder mapping onto the backend's
+ * `/rest/v1/:model` query-param dialect. Awaiting it resolves to `{ data, error }`
+ * and never rejects for expected API errors (only for programmer misuse).
+ */
+export declare class PostgrestQueryBuilder<Row extends object = Record<string, unknown>> implements PromiseLike<MotherbaseResponse<Row[]>> {
+    private readonly http;
+    private readonly model;
+    private method;
+    private columns;
+    private readonly filters;
+    private readonly orderParts;
+    private limitValue?;
+    private offsetValue?;
+    private body?;
+    private rowMode;
+    constructor(http: HttpClient, model: string);
+    select(columns?: string): this;
+    insert(values: Partial<Row> | Array<Partial<Row>>): this;
+    /**
+     * Emulated upsert. The backend has no native upsert, so this issues an insert.
+     * Documented as best-effort in the README compatibility matrix.
+     */
+    upsert(values: Partial<Row> | Array<Partial<Row>>): this;
+    update(values: Partial<Row>): this;
+    delete(): this;
+    eq(column: string, value: Primitive): this;
+    neq(column: string, value: Primitive): this;
+    gt(column: string, value: Primitive): this;
+    gte(column: string, value: Primitive): this;
+    lt(column: string, value: Primitive): this;
+    lte(column: string, value: Primitive): this;
+    like(column: string, pattern: string): this;
+    ilike(column: string, pattern: string): this;
+    in(column: string, values: readonly Primitive[]): this;
+    is(column: string, value: null | boolean): this;
+    order(column: string, options?: {
+        ascending?: boolean;
+    }): this;
+    limit(count: number): this;
+    /** Inclusive range → offset/limit. `range(0, 9)` fetches 10 rows from offset 0. */
+    range(from: number, to: number): this;
+    single(): PostgrestSingleBuilder<Row>;
+    maybeSingle(): PostgrestSingleBuilder<Row>;
+    /** The URL path (with query string) this builder targets. Exposed for tests. */
+    toPath(): string;
+    private execute;
+    then<TResult1 = MotherbaseResponse<Row[]>, TResult2 = never>(onfulfilled?: ((value: MotherbaseResponse<Row[]>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+}
+/** Same builder, typed to resolve a single row (from `.single()` / `.maybeSingle()`). */
+export interface PostgrestSingleBuilder<Row extends object> extends Omit<PostgrestQueryBuilder<Row>, 'then' | 'single' | 'maybeSingle'>, PromiseLike<MotherbaseResponse<Row>> {
+    then<TResult1 = MotherbaseResponse<Row>, TResult2 = never>(onfulfilled?: ((value: MotherbaseResponse<Row>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+}
+export {};
+//# sourceMappingURL=postgrest.d.ts.map

package/dist/postgrest.d.ts.map

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

package/dist/postgrest.js

@@ -0,0 +1,166 @@
+import { toError } from './http.js';
+import { contractPath } from '@motherbase/contracts';
+function encodeValue(value) {
+    if (value === null)
+        return 'null';
+    return String(value);
+}
+function encodeList(values) {
+    return `(${values.map(encodeValue).join(',')})`;
+}
+/**
+ * PostgREST-style, chainable, thenable query builder mapping onto the backend's
+ * `/rest/v1/:model` query-param dialect. Awaiting it resolves to `{ data, error }`
+ * and never rejects for expected API errors (only for programmer misuse).
+ */
+export class PostgrestQueryBuilder {
+    constructor(http, model) {
+        this.http = http;
+        this.model = model;
+        this.method = 'GET';
+        this.columns = '*';
+        this.filters = new URLSearchParams();
+        this.orderParts = [];
+        this.rowMode = 'many';
+    }
+    // --- verbs -------------------------------------------------------------
+    select(columns = '*') {
+        if (this.method === 'GET' && this.body === undefined)
+            this.method = 'GET';
+        this.columns = columns;
+        return this;
+    }
+    insert(values) {
+        this.method = 'POST';
+        this.body = values;
+        return this;
+    }
+    /**
+     * Emulated upsert. The backend has no native upsert, so this issues an insert.
+     * Documented as best-effort in the README compatibility matrix.
+     */
+    upsert(values) {
+        this.method = 'POST';
+        this.body = values;
+        return this;
+    }
+    update(values) {
+        this.method = 'PATCH';
+        this.body = values;
+        return this;
+    }
+    delete() {
+        this.method = 'DELETE';
+        return this;
+    }
+    // --- filters -----------------------------------------------------------
+    eq(column, value) {
+        this.filters.set(column, `eq.${encodeValue(value)}`);
+        return this;
+    }
+    neq(column, value) {
+        this.filters.set(column, `neq.${encodeValue(value)}`);
+        return this;
+    }
+    gt(column, value) {
+        this.filters.set(column, `gt.${encodeValue(value)}`);
+        return this;
+    }
+    gte(column, value) {
+        this.filters.set(column, `gte.${encodeValue(value)}`);
+        return this;
+    }
+    lt(column, value) {
+        this.filters.set(column, `lt.${encodeValue(value)}`);
+        return this;
+    }
+    lte(column, value) {
+        this.filters.set(column, `lte.${encodeValue(value)}`);
+        return this;
+    }
+    like(column, pattern) {
+        this.filters.set(column, `like.${pattern}`);
+        return this;
+    }
+    ilike(column, pattern) {
+        this.filters.set(column, `ilike.${pattern}`);
+        return this;
+    }
+    in(column, values) {
+        this.filters.set(column, `in.${encodeList(values)}`);
+        return this;
+    }
+    is(column, value) {
+        this.filters.set(column, `is.${value === null ? 'null' : String(value)}`);
+        return this;
+    }
+    // --- modifiers ---------------------------------------------------------
+    order(column, options = {}) {
+        this.orderParts.push(`${column}.${options.ascending === false ? 'desc' : 'asc'}`);
+        return this;
+    }
+    limit(count) {
+        this.limitValue = count;
+        return this;
+    }
+    /** Inclusive range → offset/limit. `range(0, 9)` fetches 10 rows from offset 0. */
+    range(from, to) {
+        this.offsetValue = from;
+        this.limitValue = to - from + 1;
+        return this;
+    }
+    single() {
+        this.rowMode = 'single';
+        return this;
+    }
+    maybeSingle() {
+        this.rowMode = 'maybeSingle';
+        return this;
+    }
+    // --- execution ---------------------------------------------------------
+    /** The URL path (with query string) this builder targets. Exposed for tests. */
+    toPath() {
+        const params = new URLSearchParams();
+        if (this.columns && this.columns !== '*')
+            params.set('select', this.columns);
+        this.filters.forEach((value, key) => params.set(key, value));
+        if (this.orderParts.length)
+            params.set('order', this.orderParts.join(','));
+        if (typeof this.limitValue === 'number')
+            params.set('limit', String(this.limitValue));
+        if (typeof this.offsetValue === 'number')
+            params.set('offset', String(this.offsetValue));
+        const query = params.toString();
+        return `${contractPath.rest(this.model)}${query ? `?${query}` : ''}`;
+    }
+    async execute() {
+        try {
+            const rows = await this.http.request(this.toPath(), {
+                method: this.method,
+                body: this.body,
+            });
+            const list = Array.isArray(rows) ? rows : rows == null ? [] : [rows];
+            if (this.rowMode === 'single') {
+                if (list.length !== 1) {
+                    const error = {
+                        message: 'JSON object requested, multiple (or no) rows returned',
+                        code: 'PGRST116',
+                    };
+                    return { data: null, error };
+                }
+                return { data: list[0], error: null };
+            }
+            if (this.rowMode === 'maybeSingle') {
+                return { data: list.length ? list[0] : null, error: null };
+            }
+            return { data: list, error: null };
+        }
+        catch (err) {
+            return { data: null, error: toError(err) };
+        }
+    }
+    then(onfulfilled, onrejected) {
+        return this.execute().then(onfulfilled, onrejected);
+    }
+}
+//# sourceMappingURL=postgrest.js.map

package/dist/postgrest.js.map

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

package/dist/realtime.d.ts

@@ -1,4 +1,35 @@
 import type { SessionStore } from './session.js';
+import { type RealtimeJoinAck, type RealtimeJoinConfig, type RealtimeTopicEnvelope, type RealtimeTopicMessageType } from '@motherbase/contracts';
+export type RealtimeStatus = 'idle' | 'connecting' | 'connected' | 'reconnecting' | 'polling' | 'disconnected' | 'error';
+export type RealtimeStatusListener = (status: RealtimeStatus, detail?: unknown) => void;
+export interface RealtimeConnectOptions {
+    timeoutMs?: number;
+    fallbackPolling?: boolean;
+}
+export interface RealtimeWatchOptions {
+    intervalMs?: number;
+    query?: string;
+    polling?: boolean;
+}
+/** Events received are pre-filtered by server-side REST policies for the current session. */
+export type RealtimeWatchEvent<T> = {
+    type: 'created' | 'updated' | 'deleted';
+    source: 'socket';
+    payload: T;
+} | {
+    type: 'snapshot';
+    source: 'polling';
+    rows: T[];
+};
+/** Minimal shape we rely on from socket.io-client's Socket. */
+export interface SocketLike {
+    on(event: string, cb: (...args: unknown[]) => void): void;
+    off(event: string, cb?: (...args: unknown[]) => void): void;
+    emit(event: string, ...args: unknown[]): void;
+    disconnect(): void;
+    connected: boolean;
+}
+export type IoFactory = (url: string, opts: Record<string, unknown>) => SocketLike;
 /**
  * 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
@@ -7,12 +38,65 @@ import type { SessionStore } from './session.js';
 export declare class RealtimeModule {
     private readonly baseUrl;
     private readonly store;
+    private readonly fetchImpl;
+    /** Inject a socket factory (tests / custom transports). Falls back to socket.io-client. */
+    private readonly ioFactory?;
     private socket;
-    constructor(baseUrl: string, store: SessionStore);
-    connect(): Promise<void>;
+    private status;
+    private readonly statusListeners;
+    private readonly pollers;
+    private readonly tableSubscriptionRefs;
+    private pollerSeq;
+    private readonly channelsByTopic;
+    private topicRouterBound;
+    constructor(baseUrl: string, store: SessionStore, fetchImpl?: typeof fetch, 
+    /** Inject a socket factory (tests / custom transports). Falls back to socket.io-client. */
+    ioFactory?: IoFactory | undefined);
+    /** True once a socket is connected. */
+    get connected(): boolean;
+    getStatus(): RealtimeStatus;
+    onStatusChange(listener: RealtimeStatusListener): () => void;
+    connect(options?: RealtimeConnectOptions): Promise<void>;
     on(event: string, cb: (...args: unknown[]) => void): void;
     off(event: string, cb?: (...args: unknown[]) => void): void;
     emit(event: string, ...args: unknown[]): void;
+    /**
+     * @deprecated Legacy low-level table watcher. Prefer the Supabase-shaped
+     * `client.channel(topic).on('postgres_changes', { event, schema, table, filter }, cb)`.
+     * Kept for backwards compatibility; scheduled for removal.
+     *
+     * Subscribe to create/update/delete events for a model table.
+     *
+     * Events are filtered server-side: you will only receive events for rows
+     * your session is authorized to see (based on REST API SELECT policies).
+     * Anonymous sessions receive only public rows; authenticated sessions receive
+     * rows matching their access policies (e.g. owner-only rows they own).
+     *
+     * Falls back to polling the REST endpoint at subscribe time if the WebSocket
+     * is not yet connected (polling does not auto-start on later disconnects).
+     */
+    watchTable<T>(model: string, cb: (event: RealtimeWatchEvent<T>) => void, options?: RealtimeWatchOptions): () => void;
     disconnect(): void;
+    /** Register a channel so incoming rt:msg envelopes for its topic are routed to it. */
+    registerChannel(topic: string, channel: {
+        _receive(env: RealtimeTopicEnvelope): void;
+    }): void;
+    unregisterChannel(topic: string): void;
+    /** Emit rt:join and resolve the server ack (or a timeout/error ack). */
+    joinTopic(topic: string, config: RealtimeJoinConfig, timeoutMs?: number): Promise<RealtimeJoinAck>;
+    leaveTopic(topic: string): void;
+    sendTopic(topic: string, type: RealtimeTopicMessageType, event: string, payload: unknown): void;
+    /** Emit an rt:msg and wait for the server ack (or resolve 'timed out'/'error'). */
+    sendTopicWithAck(topic: string, type: RealtimeTopicMessageType, event: string, payload: unknown, timeoutMs?: number): Promise<'ok' | 'timed out' | 'error'>;
+    private bindTopicRouter;
+    private retainTableSubscription;
+    private releaseTableSubscription;
+    private resubscribeTables;
+    private bindSocketStatus;
+    private waitForConnect;
+    private startPolling;
+    private stopPolling;
+    private fetchRows;
+    private setStatus;
 }
 //# sourceMappingURL=realtime.d.ts.map

package/dist/realtime.d.ts.map

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