@motherbase/client 2.2.1 → 2.2.4

package/dist/realtime/channel.js

@@ -0,0 +1,240 @@
+/**
+ * Supabase-compatible realtime channel. Multiplexes broadcast, presence, and
+ * postgres_changes over a single topic. `postgres_changes` is delivered through
+ * the RealtimeModule.watchTable bridge in this release; broadcast/presence are
+ * routed by topic via rt:msg envelopes.
+ */
+export class RealtimeChannel {
+    constructor(topic, realtime, options = {}) {
+        this.topic = topic;
+        this.realtime = realtime;
+        this.options = options;
+        this.pgBindings = [];
+        this.broadcastBindings = [];
+        this.presenceBindings = [];
+        this.status = 'CLOSED';
+        this.presence = {};
+        /** Settles when the current subscribe() attempt has an ack (or has failed). */
+        this.ready = Promise.resolve();
+        /** Last state passed to track(), replayed after a reconnect. */
+        this.trackedState = null;
+        this.generation = 0;
+        this.subscribing = false;
+    }
+    on(type, filter, callback) {
+        if (type === 'broadcast') {
+            this.broadcastBindings.push({
+                event: filter.event,
+                callback: callback,
+            });
+        }
+        else if (type === 'presence') {
+            this.presenceBindings.push({
+                event: filter.event,
+                callback: callback,
+            });
+        }
+        else if (type === 'postgres_changes') {
+            this.pgBindings.push({
+                filter: filter,
+                callback: callback,
+            });
+        }
+        else {
+            throw new Error(`Unsupported channel event type "${type}". Use broadcast | presence | postgres_changes.`);
+        }
+        return this;
+    }
+    /**
+     * Join the topic. Returns `this` (supabase-js shape), so it is NOT awaitable:
+     * `send()` / `track()` / `untrack()` issued straight after are queued until the
+     * join is acked instead of leaving early and being rejected by the server.
+     */
+    subscribe(onStatus, timeoutMs = 10000) {
+        this.onStatus = onStatus;
+        if (this.subscribing || this.status === 'SUBSCRIBED')
+            return this;
+        const generation = ++this.generation;
+        this.subscribing = true;
+        this.ready = (async () => {
+            try {
+                await this.realtime.connect({ fallbackPolling: false });
+            }
+            catch (err) {
+                if (generation !== this.generation)
+                    return;
+                this.subscribing = false;
+                this.setStatus('CHANNEL_ERROR', err instanceof Error ? err : new Error(String(err)));
+                return;
+            }
+            if (generation !== this.generation)
+                return;
+            this.realtime.registerChannel(this.topic, this);
+            const ack = await this.realtime.joinTopic(this.topic, this.buildConfig(), timeoutMs);
+            if (generation !== this.generation)
+                return;
+            this.subscribing = false;
+            if (ack.status === 'ok' && this.pgBindings.length > 1 && !ack.bindingIds) {
+                this.realtime.leaveTopic(this.topic);
+                this.realtime.unregisterChannel(this.topic);
+                this.setStatus('CHANNEL_ERROR', new Error('Multiple postgres_changes bindings require a server with binding-id support. Upgrade the server or use one binding per channel.'));
+                return;
+            }
+            if (ack.status === 'ok')
+                this.setStatus('SUBSCRIBED');
+            else if (ack.error === 'timeout')
+                this.setStatus('TIMED_OUT', new Error('Realtime join timed out'));
+            else
+                this.setStatus('CHANNEL_ERROR', new Error(ack.error ?? 'Realtime join failed'));
+        })();
+        return this;
+    }
+    /** Leave the topic and stop every listener. The channel can `subscribe()` again. */
+    async unsubscribe() {
+        this.generation += 1;
+        this.subscribing = false;
+        this.realtime.leaveTopic(this.topic);
+        this.realtime.unregisterChannel(this.topic);
+        this.presence = {};
+        this.trackedState = null;
+        this.setStatus('CLOSED');
+        this.ready = Promise.resolve();
+        return 'ok';
+    }
+    /**
+     * Broadcast a message to the topic. Other clients on the topic with a matching
+     * `on('broadcast', { event })` binding receive it; the sender receives its own
+     * message only when the channel was created with `config.broadcast.self`.
+     * With `config.broadcast.ack`, resolves on the server ack.
+     */
+    async send(message) {
+        if (!(await this.subscribed()))
+            return 'error';
+        if (this.options.config?.broadcast?.ack) {
+            return this.realtime.sendTopicWithAck(this.topic, 'broadcast', message.event, message.payload ?? {});
+        }
+        this.realtime.sendTopic(this.topic, 'broadcast', message.event, message.payload ?? {});
+        return 'ok';
+    }
+    /** Announce this client's presence on the topic with the given state. */
+    async track(state) {
+        this.trackedState = state;
+        if (!(await this.subscribed()))
+            return 'error';
+        return this.realtime.sendTopicWithAck(this.topic, 'presence', 'track', { state });
+    }
+    /** Remove this client's presence from the topic. */
+    async untrack() {
+        this.trackedState = null;
+        if (!(await this.subscribed()))
+            return 'error';
+        return this.realtime.sendTopicWithAck(this.topic, 'presence', 'untrack', {});
+    }
+    /** Current presence state, keyed by presence key. */
+    presenceState() {
+        return this.presence;
+    }
+    /** Wait for a pending subscribe() to settle; false when the topic is not joined. */
+    async subscribed() {
+        await this.ready;
+        return this.status === 'SUBSCRIBED';
+    }
+    setStatus(status, err) {
+        this.status = status;
+        this.onStatus?.(status, err);
+    }
+    /** Internal: the module replayed this topic's join on a new socket. */
+    _rejoined(ok) {
+        if (!ok) {
+            this.setStatus('CHANNEL_ERROR', new Error('Realtime rejoin failed'));
+            return;
+        }
+        // Presence lives on the server socket that just died: re-announce it.
+        if (this.trackedState) {
+            void this.realtime.sendTopicWithAck(this.topic, 'presence', 'track', { state: this.trackedState });
+        }
+        this.setStatus('SUBSCRIBED');
+    }
+    /** Internal: receive a topic envelope routed by RealtimeModule. */
+    _receive(envelope) {
+        if (envelope.type === 'broadcast') {
+            for (const binding of this.broadcastBindings) {
+                if (binding.event === '*' || binding.event === envelope.event) {
+                    binding.callback({ type: 'broadcast', event: envelope.event, payload: envelope.payload });
+                }
+            }
+        }
+        else if (envelope.type === 'presence') {
+            // The server sends the full presence state; diff it into sync/join/leave.
+            if (envelope.event === 'state')
+                this.applyPresenceState(envelope.payload);
+        }
+        else if (envelope.type === 'postgres_changes') {
+            const payload = envelope.payload;
+            for (const [index, binding] of this.pgBindings.entries()) {
+                if (envelope.bindingId !== undefined ? envelope.bindingId !== index + 1 : this.pgBindings.length > 1)
+                    continue;
+                const filter = binding.filter;
+                if ((filter.schema ?? 'public') !== payload.schema)
+                    continue;
+                if (filter.table !== payload.table)
+                    continue;
+                if (filter.event !== '*' && filter.event !== payload.eventType)
+                    continue;
+                binding.callback(payload);
+            }
+        }
+    }
+    applyPresenceState(next) {
+        const prev = this.presence;
+        const prevRefs = new Set();
+        for (const key of Object.keys(prev))
+            for (const p of prev[key])
+                prevRefs.add(p.presence_ref);
+        const nextRefs = new Set();
+        for (const key of Object.keys(next))
+            for (const p of next[key])
+                nextRefs.add(p.presence_ref);
+        for (const key of Object.keys(next)) {
+            const newPresences = next[key].filter(p => !prevRefs.has(p.presence_ref));
+            if (newPresences.length) {
+                this.emitPresence('join', { key, newPresences, currentPresences: next[key] });
+            }
+        }
+        for (const key of Object.keys(prev)) {
+            const leftPresences = prev[key].filter(p => !nextRefs.has(p.presence_ref));
+            if (leftPresences.length) {
+                this.emitPresence('leave', { key, leftPresences, currentPresences: next[key] ?? [] });
+            }
+        }
+        this.presence = next;
+        this.emitPresence('sync', undefined);
+    }
+    emitPresence(event, payload) {
+        for (const binding of this.presenceBindings) {
+            if (binding.event === event)
+                binding.callback(payload);
+        }
+    }
+    buildConfig() {
+        const config = {};
+        if (this.options.config?.broadcast) {
+            config.broadcast = { self: Boolean(this.options.config.broadcast.self) };
+        }
+        if (this.options.config?.presence) {
+            config.presence = { key: this.options.config.presence.key };
+        }
+        if (this.options.config?.private)
+            config.private = true;
+        if (this.pgBindings.length) {
+            config.postgres_changes = this.pgBindings.map(b => ({
+                event: b.filter.event,
+                schema: b.filter.schema ?? 'public',
+                table: b.filter.table,
+                filter: b.filter.filter,
+            }));
+        }
+        return config;
+    }
+}
+//# sourceMappingURL=channel.js.map

package/dist/realtime/channel.js.map

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

package/dist/realtime/index.d.ts

@@ -0,0 +1,94 @@
+import { RealtimeJoinConfig, RealtimeJoinAck, RealtimeTopicMessageType } from '@motherbase/contracts';
+import { IoFactory, ChannelHandle, RealtimeStatus, RealtimeStatusListener, RealtimeConnectOptions, RealtimeWatchEvent, RealtimeWatchOptions } from './types.js';
+import { SessionStore } from '../auth/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 readonly fetchImpl;
+    /** Inject a socket factory (tests / custom transports). Falls back to socket.io-client. */
+    private readonly ioFactory?;
+    private socket;
+    private status;
+    private readonly statusListeners;
+    private readonly pollers;
+    private readonly tableSubscriptionRefs;
+    private pollerSeq;
+    private readonly channelsByTopic;
+    /** Topics joined on the current socket, replayed as-is after a reconnect. */
+    private readonly joinedTopics;
+    private topicRouterBound;
+    private connecting;
+    private readonly pendingJoins;
+    /** The token the open socket authenticated with: undefined = anonymous. */
+    private handshakeToken;
+    constructor(baseUrl: string, store: SessionStore, fetchImpl?: typeof fetch, 
+    /** Inject a socket factory (tests / custom transports). Falls back to socket.io-client. */
+    ioFactory?: IoFactory | undefined);
+    /**
+     * Reopen the socket under the current session. Joined topics are kept, so
+     * the `connect` handler replays them on the new socket and each channel
+     * reports SUBSCRIBED (or CHANNEL_ERROR) again through its status callback.
+     */
+    private reauthenticate;
+    /** True once a socket is connected. */
+    get connected(): boolean;
+    /** The connection state right now. */
+    getStatus(): RealtimeStatus;
+    /** Call `listener` now and on every connection state change. Returns the unsubscribe function. */
+    onStatusChange(listener: RealtimeStatusListener): () => void;
+    /** Concurrent callers (several channels subscribing at once) share one attempt, not one socket each. */
+    connect(options?: RealtimeConnectOptions): Promise<void>;
+    private open;
+    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;
+    /** Close the socket and stop every poller. */
+    disconnect(): void;
+    /** Register a channel so incoming rt:msg envelopes for its topic are routed to it. */
+    registerChannel(topic: string, channel: ChannelHandle): 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;
+    /**
+     * Replay every joined topic on a fresh socket. The server keeps topic state on
+     * the socket, so without this a reconnected channel still reports SUBSCRIBED
+     * and receives nothing at all.
+     */
+    private rejoinTopics;
+    private bindSocketStatus;
+    private waitForConnect;
+    private startPolling;
+    private stopPolling;
+    private fetchRows;
+    private setStatus;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/realtime/index.d.ts.map

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