@foony/realtime 0.0.1

package/lib/connection.js

@@ -0,0 +1,333 @@
+/**
+ * Low-level WebSocket connection manager. Handles framing, request /
+ * response correlation, and dispatch to per-channel listeners.
+ *
+ * The class is intentionally protocol-aware but channel-agnostic — the
+ * Channel and Realtime classes layer the public API on top.
+ */
+const DEFAULT_INITIAL_RECONNECT_DELAY_MS = 1_000;
+const DEFAULT_MAX_RECONNECT_DELAY_MS = 30_000;
+/** WebSocket.OPEN — duplicated here so we do not depend on a global. */
+const READY_STATE_OPEN = 1;
+/**
+ * Connection is the transport layer. One Realtime client owns one
+ * Connection; channels share it.
+ */
+export class Connection {
+    options;
+    socket = null;
+    state = 'initialized';
+    connectionId = null;
+    serverClientId = null;
+    nextRequestId = 1;
+    pending = new Map();
+    channelListeners = new Map();
+    stateListeners = new Set();
+    connectPromise = null;
+    reconnectTimer = null;
+    reconnectAttempt = 0;
+    /** Channels the SDK has asked to be subscribed to; re-sent on reconnect. */
+    desiredSubscriptions = new Set();
+    constructor(options) {
+        const authMethods = Number(Boolean(options.token)) + Number(Boolean(options.authCallback)) + Number(Boolean(options.key));
+        if (authMethods !== 1) {
+            throw new Error('Connection: pass exactly one of options.token, options.authCallback, or options.key');
+        }
+        this.options = options;
+    }
+    /** Current connection state. */
+    getState() {
+        return this.state;
+    }
+    /** The server-issued connection id, populated after a successful auth handshake. */
+    getConnectionId() {
+        return this.connectionId;
+    }
+    /** The client id encoded in the token, populated after auth. */
+    getClientId() {
+        return this.serverClientId;
+    }
+    /** Register a state-change listener. Returns an unsubscribe function. */
+    onStateChange(listener) {
+        this.stateListeners.add(listener);
+        return () => this.stateListeners.delete(listener);
+    }
+    /**
+     * Open the WebSocket and complete the auth handshake. Idempotent —
+     * concurrent calls await the same in-flight connect.
+     */
+    async connect() {
+        if (this.state === 'connected')
+            return;
+        if (this.connectPromise)
+            return this.connectPromise;
+        this.connectPromise = this.doConnect().finally(() => {
+            this.connectPromise = null;
+        });
+        return this.connectPromise;
+    }
+    /** Close the WebSocket and release resources. */
+    async close() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.setState('closing');
+        if (this.socket && this.socket.readyState === READY_STATE_OPEN) {
+            this.socket.close(1000, 'client close');
+        }
+        this.setState('closed');
+        for (const pending of this.pending.values()) {
+            pending.reject(new Error('connection closed'));
+        }
+        this.pending.clear();
+    }
+    /**
+     * Send a frame that expects an ack. Returns the matching AckFrame, or
+     * rejects with the server's ErrorFrame (wrapped in an Error).
+     */
+    async request(frame) {
+        await this.connect();
+        const id = this.nextRequestId++;
+        const out = { ...frame, id };
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            try {
+                this.sendRaw(out);
+            }
+            catch (err) {
+                this.pending.delete(id);
+                reject(err instanceof Error ? err : new Error(String(err)));
+            }
+        });
+    }
+    /** Send a fire-and-forget frame (no ack expected). */
+    async send(frame) {
+        await this.connect();
+        this.sendRaw(frame);
+    }
+    /**
+     * Register listeners for a channel. Connection remembers the
+     * registration so it can re-attach across reconnects, but actually
+     * issuing the `sub` frame is the caller's job (Channel does that).
+     */
+    addChannelListeners(channel) {
+        let entry = this.channelListeners.get(channel);
+        if (!entry) {
+            entry = { messages: new Set(), presence: new Set() };
+            this.channelListeners.set(channel, entry);
+        }
+        return entry;
+    }
+    /** Forget all listeners for a channel. Called from Channel.detach. */
+    removeChannelListeners(channel) {
+        this.channelListeners.delete(channel);
+    }
+    /** Add `channel` to the set of subscriptions to restore on reconnect. */
+    rememberSubscription(channel) {
+        this.desiredSubscriptions.add(channel);
+    }
+    /** Stop restoring this subscription on future reconnects. */
+    forgetSubscription(channel) {
+        this.desiredSubscriptions.delete(channel);
+    }
+    // ---- internals ----
+    async doConnect() {
+        this.setState('connecting');
+        const ws = this.makeSocket();
+        this.socket = ws;
+        const authFrame = await this.createAuthFrame();
+        return new Promise((resolve, reject) => {
+            const onOpen = () => {
+                try {
+                    ws.send(JSON.stringify(authFrame));
+                }
+                catch (err) {
+                    reject(err instanceof Error ? err : new Error(String(err)));
+                }
+            };
+            const onAuthMessage = (event) => {
+                let parsed;
+                try {
+                    parsed = JSON.parse(typeof event.data === 'string' ? event.data : event.data.toString());
+                }
+                catch (err) {
+                    reject(new Error(`failed to parse auth response: ${err.message}`));
+                    ws.close(1002, 'bad auth response');
+                    return;
+                }
+                if (parsed.t === 'connected') {
+                    const connected = parsed;
+                    this.connectionId = connected.connectionId;
+                    this.serverClientId = connected.clientId;
+                    this.reconnectAttempt = 0;
+                    // Hand future frames over to the steady-state handler.
+                    ws.removeEventListener('message', onAuthMessage);
+                    ws.addEventListener('message', this.handleMessage);
+                    this.setState('connected');
+                    resolve();
+                    this.restoreSubscriptionsOnReconnect();
+                }
+                else if (parsed.t === 'err') {
+                    const errFrame = parsed;
+                    ws.close(1002, `auth error ${errFrame.code}`);
+                    reject(new Error(`auth failed: ${errFrame.code} ${errFrame.message}`));
+                }
+                else {
+                    reject(new Error(`unexpected first frame: ${parsed.t}`));
+                    ws.close(1002, 'unexpected frame');
+                }
+            };
+            const onError = (event) => {
+                const errMessage = event.message ?? 'websocket error';
+                reject(new Error(`websocket error: ${errMessage}`));
+            };
+            const onClose = (event) => {
+                this.handleClose(event);
+                // If close fires before we finished the handshake, the
+                // surrounding promise hasn't been settled yet — surface it as
+                // a connect failure.
+                reject(new Error(`websocket closed during handshake: ${event.code} ${event.reason}`));
+            };
+            ws.addEventListener('open', onOpen);
+            ws.addEventListener('message', onAuthMessage);
+            ws.addEventListener('error', onError);
+            ws.addEventListener('close', onClose, { once: true });
+        });
+    }
+    makeSocket() {
+        const ctor = this.options.webSocket ?? globalThis.WebSocket;
+        if (!ctor) {
+            throw new Error('Connection: no WebSocket implementation available. Pass options.webSocket or upgrade to Node 22+.');
+        }
+        return new ctor(this.options.url);
+    }
+    async createAuthFrame() {
+        if (this.options.key) {
+            return {
+                t: 'auth',
+                key: this.options.key,
+                ...(this.options.clientId ? { clientId: this.options.clientId } : {}),
+            };
+        }
+        if (this.options.token)
+            return { t: 'auth', token: this.options.token };
+        if (!this.options.authCallback) {
+            throw new Error('Connection: missing auth method');
+        }
+        return { t: 'auth', token: await this.options.authCallback() };
+    }
+    /** Steady-state message handler; installed after a successful auth. */
+    handleMessage = (event) => {
+        let frame;
+        try {
+            frame = JSON.parse(typeof event.data === 'string' ? event.data : event.data.toString());
+        }
+        catch {
+            return;
+        }
+        switch (frame.t) {
+            case 'ack': {
+                const pending = this.pending.get(frame.id);
+                if (pending) {
+                    this.pending.delete(frame.id);
+                    pending.resolve(frame);
+                }
+                return;
+            }
+            case 'err': {
+                if (frame.id != null) {
+                    const pending = this.pending.get(frame.id);
+                    if (pending) {
+                        this.pending.delete(frame.id);
+                        pending.reject(new Error(`server error ${frame.code}: ${frame.message}`));
+                        return;
+                    }
+                }
+                // Unscoped errors (id 0 or missing) are surfaced via state-change
+                // listeners; SDK consumers can subscribe via onStateChange.
+                for (const listener of this.stateListeners) {
+                    listener(this.state, new Error(`server error ${frame.code}: ${frame.message}`));
+                }
+                return;
+            }
+            case 'msg': {
+                const listeners = this.channelListeners.get(frame.channel);
+                if (listeners) {
+                    for (const listener of listeners.messages)
+                        listener(frame);
+                }
+                return;
+            }
+            case 'presEvt': {
+                const listeners = this.channelListeners.get(frame.channel);
+                if (listeners) {
+                    for (const listener of listeners.presence)
+                        listener(frame);
+                }
+                return;
+            }
+            case 'pong':
+            case 'connected':
+            case 'histRes':
+                // Connected can only fire once (we removed the auth listener
+                // above); pong and histRes are unused in the MVP — silent
+                // forwarding keeps the switch exhaustive.
+                return;
+        }
+    };
+    handleClose(_event) {
+        this.socket = null;
+        if (this.state === 'closing' || this.state === 'closed') {
+            this.setState('closed');
+            return;
+        }
+        this.setState('disconnected');
+        if (this.options.autoReconnect === false)
+            return;
+        this.scheduleReconnect();
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer)
+            return;
+        const initial = this.options.initialReconnectDelayMs ?? DEFAULT_INITIAL_RECONNECT_DELAY_MS;
+        const max = this.options.maxReconnectDelayMs ?? DEFAULT_MAX_RECONNECT_DELAY_MS;
+        const delay = Math.min(initial * 2 ** this.reconnectAttempt, max);
+        this.reconnectAttempt += 1;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect().catch(() => {
+                // doConnect itself drove the state machine; schedule another
+                // attempt unless we've been explicitly closed in the meantime.
+                if (this.state !== 'closed' && this.state !== 'closing') {
+                    this.scheduleReconnect();
+                }
+            });
+        }, delay);
+    }
+    restoreSubscriptionsOnReconnect() {
+        // The Channel layer is responsible for re-issuing `sub` frames; we
+        // expose desiredSubscriptions so it can iterate without leaking the
+        // set.
+        for (const channel of this.desiredSubscriptions) {
+            this.request({ t: 'sub', channel }).catch(() => {
+                // Failure to restore a subscription bubbles up via state
+                // listeners on the next request; nothing else to do here.
+            });
+        }
+    }
+    sendRaw(frame) {
+        if (!this.socket || this.socket.readyState !== READY_STATE_OPEN) {
+            throw new Error(`Connection.sendRaw: socket not open (state=${this.state})`);
+        }
+        this.socket.send(JSON.stringify(frame));
+    }
+    setState(state) {
+        if (this.state === state)
+            return;
+        this.state = state;
+        for (const listener of this.stateListeners)
+            listener(state);
+    }
+}
+//# sourceMappingURL=connection.js.map

package/lib/connection.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Public entry point for @foony/realtime.
+ *
+ * Public surface: a `Realtime` class, a `channels.get(name)` registry,
+ * and per-channel `subscribe` / `publish` / `presence` methods.
+ *
+ * For server-side token minting see `@foony/realtime/server`.
+ */
+export { Realtime, type RealtimeOptions } from './realtime.js';
+export { Channel, Presence, type UnsubscribeFn } from './channel.js';
+export { Connection, type ConnectionOptions, type ConnectionState, type ConnectionStateListener, type MessageListener, type PresenceEventListener, } from './connection.js';
+export { type AckFrame, type AuthFrame, type ClientFrame, type ConnectedFrame, type ErrorFrame, type FrameType, type HistoryResponseFrame, type MessageFrame, type PingFrame, type PongFrame, type PresenceAction, type PresenceEventFrame, type PresenceFrame, type PublishFrame, type ServerFrame, type SubscribeFrame, type UnsubscribeFrame, ErrorCode, type ErrorCodeName, } from './wire.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,SAAS,EACT,KAAK,aAAa,GACnB,MAAM,WAAW,CAAC"}

package/lib/index.js

@@ -0,0 +1,13 @@
+/**
+ * Public entry point for @foony/realtime.
+ *
+ * Public surface: a `Realtime` class, a `channels.get(name)` registry,
+ * and per-channel `subscribe` / `publish` / `presence` methods.
+ *
+ * For server-side token minting see `@foony/realtime/server`.
+ */
+export { Realtime } from './realtime.js';
+export { Channel, Presence } from './channel.js';
+export { Connection, } from './connection.js';
+export { ErrorCode, } from './wire.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAwB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAsB,MAAM,cAAc,CAAC;AACrE,OAAO,EACL,UAAU,GAMX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAkBL,SAAS,GAEV,MAAM,WAAW,CAAC"}

package/lib/realtime.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Realtime is the top-level client class. It owns a Connection and a
+ * `channels.get(name)` registry — the public entry point for app code.
+ */
+import { Channel } from './channel.js';
+import { type ConnectionOptions, type ConnectionState, type ConnectionStateListener } from './connection.js';
+/** Options for the Realtime client; mirrors ConnectionOptions. */
+export type RealtimeOptions = ConnectionOptions;
+/**
+ * Realtime client — call `new Realtime({ url, token })` and use
+ * `client.channels.get('chat:1')` to start sending and receiving.
+ */
+export declare class Realtime {
+    private readonly connection;
+    private readonly channelsByName;
+    /** Map-like accessor for channels. Stable instance per name. */
+    readonly channels: {
+        get: (name: string) => Channel;
+        release: (name: string) => void;
+    };
+    constructor(options: RealtimeOptions);
+    /** Eagerly open the WebSocket. Optional — channels attach lazily. */
+    connect(): Promise<void>;
+    /** Close the WebSocket and release every channel. */
+    close(): Promise<void>;
+    /** Current connection state. */
+    getState(): ConnectionState;
+    /** Server-issued connection id, populated after auth. */
+    getConnectionId(): string | null;
+    /** Server-confirmed client id (from the JWT), populated after auth. */
+    getClientId(): string | null;
+    /** Register a connection-state listener. Returns an unsubscribe fn. */
+    onStateChange(listener: ConnectionStateListener): () => void;
+}
+//# sourceMappingURL=realtime.d.ts.map

package/lib/realtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.d.ts","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC7B,MAAM,iBAAiB,CAAC;AAEzB,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA8B;IAE7D,gEAAgE;IAChE,QAAQ,CAAC,QAAQ;oBACH,MAAM,KAAG,OAAO;wBAQZ,MAAM,KAAG,IAAI;MAO7B;gBAEU,OAAO,EAAE,eAAe;IAIpC,qEAAqE;IAC/D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,qDAAqD;IAC/C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B,gCAAgC;IAChC,QAAQ,IAAI,eAAe;IAI3B,yDAAyD;IACzD,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC,uEAAuE;IACvE,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,uEAAuE;IACvE,aAAa,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,IAAI;CAG7D"}

package/lib/realtime.js

@@ -0,0 +1,64 @@
+/**
+ * Realtime is the top-level client class. It owns a Connection and a
+ * `channels.get(name)` registry — the public entry point for app code.
+ */
+import { Channel } from './channel.js';
+import { Connection, } from './connection.js';
+/**
+ * Realtime client — call `new Realtime({ url, token })` and use
+ * `client.channels.get('chat:1')` to start sending and receiving.
+ */
+export class Realtime {
+    connection;
+    channelsByName = new Map();
+    /** Map-like accessor for channels. Stable instance per name. */
+    channels = {
+        get: (name) => {
+            let existing = this.channelsByName.get(name);
+            if (!existing) {
+                existing = new Channel(this.connection, name);
+                this.channelsByName.set(name, existing);
+            }
+            return existing;
+        },
+        release: (name) => {
+            const channel = this.channelsByName.get(name);
+            if (!channel)
+                return;
+            this.channelsByName.delete(name);
+            this.connection.removeChannelListeners(name);
+            channel.detach().catch(() => { });
+        },
+    };
+    constructor(options) {
+        this.connection = new Connection(options);
+    }
+    /** Eagerly open the WebSocket. Optional — channels attach lazily. */
+    async connect() {
+        await this.connection.connect();
+    }
+    /** Close the WebSocket and release every channel. */
+    async close() {
+        for (const name of [...this.channelsByName.keys()]) {
+            this.channels.release(name);
+        }
+        await this.connection.close();
+    }
+    /** Current connection state. */
+    getState() {
+        return this.connection.getState();
+    }
+    /** Server-issued connection id, populated after auth. */
+    getConnectionId() {
+        return this.connection.getConnectionId();
+    }
+    /** Server-confirmed client id (from the JWT), populated after auth. */
+    getClientId() {
+        return this.connection.getClientId();
+    }
+    /** Register a connection-state listener. Returns an unsubscribe fn. */
+    onStateChange(listener) {
+        return this.connection.onStateChange(listener);
+    }
+}
+//# sourceMappingURL=realtime.js.map

package/lib/realtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtime.js","sourceRoot":"","sources":["../src/realtime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,UAAU,GAIX,MAAM,iBAAiB,CAAC;AAKzB;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,UAAU,CAAa;IACvB,cAAc,GAAG,IAAI,GAAG,EAAmB,CAAC;IAE7D,gEAAgE;IACvD,QAAQ,GAAG;QAClB,GAAG,EAAE,CAAC,IAAY,EAAW,EAAE;YAC7B,IAAI,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;gBAC9C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,EAAE,CAAC,IAAY,EAAQ,EAAE;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;IAEF,YAAY,OAAwB;QAClC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,qEAAqE;IACrE,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAClC,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,KAAK;QACT,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;IAED,gCAAgC;IAChC,QAAQ;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;IAED,yDAAyD;IACzD,eAAe;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;IAC3C,CAAC;IAED,uEAAuE;IACvE,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,CAAC;IAED,uEAAuE;IACvE,aAAa,CAAC,QAAiC;QAC7C,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC;CACF"}

package/lib/server.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Server-side helpers for the Foony Realtime SDK.
+ *
+ * `mintRealtimeToken` produces the same HS256 JWT layout the Go edge
+ * binary verifies (see `services/realtime-saas/internal/auth/jwt.go`).
+ * Foony's application server uses this to hand short-lived tokens to
+ * its own clients — the client passes the result into the SDK's
+ * `authCallback`.
+ *
+ * Node-only: relies on `node:crypto` for HMAC-SHA256. Browsers should
+ * never see this module.
+ */
+/** Options to mint a Foony Realtime token. */
+export type MintRealtimeTokenOptions = {
+    /**
+     * The HS256 signing key — must exactly match the edge binary's
+     * `JWT_SIGNING_KEY` env var. 32 bytes recommended for production.
+     */
+    readonly signingKey: string | Uint8Array;
+    /** App id the token is scoped to. Encoded in the JWT `app` claim. */
+    readonly appId: string;
+    /** Customer-controlled identifier for the end user (the JWT `sub`). */
+    readonly clientId: string;
+    /**
+     * Capability JSON string scoping the token (e.g. `{"chat:*":["subscribe","publish"]}`).
+     * Defaults to `{"*":["*"]}` (full wildcard). The MVP edge does not
+     * enforce capabilities yet, but tokens minted today will be checked
+     * once enforcement lands.
+     */
+    readonly capability?: string;
+    /**
+     * Token TTL. Defaults to 1 hour. Must be > 0; long-lived tokens are
+     * an antipattern — the SDK calls `authCallback` on every reconnect
+     * so 5-15 minutes is usually plenty.
+     */
+    readonly ttlMs?: number;
+};
+/**
+ * Returns a compact-encoded HS256 JWT carrying the supplied claims.
+ *
+ * The token shape matches what `services/realtime-saas/internal/auth`
+ * mints with `MintForDev` plus a configurable capability and TTL.
+ */
+export declare function mintRealtimeToken(options: MintRealtimeTokenOptions): string;
+//# sourceMappingURL=server.d.ts.map

package/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,8CAA8C;AAC9C,MAAM,MAAM,wBAAwB,GAAG;IACrC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC;IACzC,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAKF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAmB3E"}

package/lib/server.js

@@ -0,0 +1,53 @@
+/**
+ * Server-side helpers for the Foony Realtime SDK.
+ *
+ * `mintRealtimeToken` produces the same HS256 JWT layout the Go edge
+ * binary verifies (see `services/realtime-saas/internal/auth/jwt.go`).
+ * Foony's application server uses this to hand short-lived tokens to
+ * its own clients — the client passes the result into the SDK's
+ * `authCallback`.
+ *
+ * Node-only: relies on `node:crypto` for HMAC-SHA256. Browsers should
+ * never see this module.
+ */
+import { createHmac } from 'node:crypto';
+const DEFAULT_TTL_MS = 60 * 60 * 1_000;
+const DEFAULT_CAPABILITY = '{"*":["*"]}';
+/**
+ * Returns a compact-encoded HS256 JWT carrying the supplied claims.
+ *
+ * The token shape matches what `services/realtime-saas/internal/auth`
+ * mints with `MintForDev` plus a configurable capability and TTL.
+ */
+export function mintRealtimeToken(options) {
+    const ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
+    if (ttlMs <= 0) {
+        throw new Error('mintRealtimeToken: ttlMs must be > 0');
+    }
+    const issuedAtSec = Math.floor(Date.now() / 1_000);
+    const expiresAtSec = issuedAtSec + Math.floor(ttlMs / 1_000);
+    const payload = {
+        sub: options.clientId,
+        app: options.appId,
+        cap: options.capability ?? DEFAULT_CAPABILITY,
+        iat: issuedAtSec,
+        exp: expiresAtSec,
+    };
+    const header = { alg: 'HS256', typ: 'JWT' };
+    const signingInput = `${encodeSegment(header)}.${encodeSegment(payload)}`;
+    const key = typeof options.signingKey === 'string' ? Buffer.from(options.signingKey, 'utf8') : Buffer.from(options.signingKey);
+    const signature = createHmac('sha256', key).update(signingInput).digest();
+    return `${signingInput}.${base64UrlEncode(signature)}`;
+}
+/**
+ * Encode a JSON value as a base64url segment. JWT spec requires no
+ * padding and the URL-safe alphabet — `Buffer.toString('base64url')`
+ * is exactly that, available in Node 16+.
+ */
+function encodeSegment(value) {
+    return base64UrlEncode(Buffer.from(JSON.stringify(value), 'utf8'));
+}
+function base64UrlEncode(buffer) {
+    return buffer.toString('base64url');
+}
+//# sourceMappingURL=server.js.map

package/lib/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA4BzC,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AACvC,MAAM,kBAAkB,GAAG,aAAa,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC;IAC9C,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG;QACd,GAAG,EAAE,OAAO,CAAC,QAAQ;QACrB,GAAG,EAAE,OAAO,CAAC,KAAK;QAClB,GAAG,EAAE,OAAO,CAAC,UAAU,IAAI,kBAAkB;QAC7C,GAAG,EAAE,WAAW;QAChB,GAAG,EAAE,YAAY;KACgB,CAAC;IACpC,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAoC,CAAC;IAC9E,MAAM,YAAY,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1E,MAAM,GAAG,GAAG,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/H,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC;IAC1E,OAAO,GAAG,YAAY,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC"}