@foony/realtime 0.0.1

package/README.md

@@ -0,0 +1,118 @@
+# @foony/realtime
+
+TypeScript SDK for the Foony Realtime service. A small client for the
+wire protocol implemented by `services/realtime-saas` — connect, sub /
+unsub, publish, and presence.
+
+## Install
+
+```bash
+npm install @foony/realtime
+```
+
+The package ships compiled ESM output and TypeScript declarations.
+
+## Quick start
+
+### Browser / Foony client
+
+```ts
+import { Realtime } from '@foony/realtime';
+
+const realtime = new Realtime({
+  url: 'wss://realtime.foony.com',
+  authCallback: async () => {
+    const response = await fetch('/api/realtime/token');
+    return await response.text();
+  },
+});
+
+const channel = realtime.channels.get('chat:room-1');
+
+channel.subscribe((message) => {
+  console.log('chat message:', message.data);
+});
+
+await channel.publish('chat', { text: 'hello world' });
+
+channel.presence.subscribe((event) => {
+  console.log(event.action, event.clientId, event.data);
+});
+await channel.presence.enter({ name: 'Alice' });
+```
+
+### Node / server (token minting)
+
+```ts
+import { mintRealtimeToken } from '@foony/realtime/server';
+
+app.get('/api/realtime/token', (req, res) => {
+  const token = mintRealtimeToken({
+    signingKey: process.env.REALTIME_JWT_SIGNING_KEY!,
+    appId: 'foony',
+    clientId: req.user.id,
+    capability: '{"chat:*":["subscribe","publish","presence"]}',
+    ttlMs: 15 * 60 * 1000,
+  });
+  res.type('text/plain').send(token);
+});
+```
+
+The signing key must exactly match the `JWT_SIGNING_KEY` env var the
+realtime edge binary boots with.
+
+## Local development against the realtime backend
+
+Start the backend following `services/realtime-saas/README.md`. Then
+mint a dev token:
+
+```bash
+cd services/realtime-saas
+JWT_SIGNING_KEY=local-dev-key go run ./cmd/devtoken -app foony -client alice
+```
+
+Use the printed token in the SDK:
+
+```ts
+const realtime = new Realtime({
+  url: 'ws://localhost:3000',
+  token: process.env.FOONY_REALTIME_DEV_TOKEN!,
+});
+```
+
+## Channel names
+
+Channel names must match `[A-Za-z0-9._-]{1,255}` and cannot start or
+end with a `.`. Use dots to express hierarchy (`chat.rooms.42`). The
+server rejects invalid names with error code `40001` (`BadFrame`).
+
+## API surface
+
+- `Realtime` — top-level client. Owns the WebSocket; channels attach lazily.
+- `client.channels.get(name)` — returns a stable `Channel` for that name.
+- `channel.subscribe(fn)` — message listener; returns an unsubscribe fn.
+- `channel.publish(name, data)` — publish one message; resolves on ack.
+- `channel.presence.subscribe(fn)` — presence listener.
+- `channel.presence.enter|update|leave(data?)` — mutate this connection's membership.
+- `client.onStateChange(fn)` — observe `connecting | connected | disconnected | closed | failed`.
+
+## Reconnect
+
+When the connection drops unexpectedly the client retries with
+exponential backoff (1s, 2s, 4s, ..., capped at 30s). All
+subscriptions that were established before the disconnect are
+re-issued automatically; presence membership is NOT automatically
+restored — call `enter()` again on the `disconnected -> connected`
+transition if you need it.
+
+Pass `autoReconnect: false` to disable retries entirely (useful in tests).
+
+## Tests
+
+```bash
+npm test
+```
+
+Runs unit tests (wire + token mint) plus an in-process end-to-end test
+that drives the SDK against a fake edge built on `ws`. No external
+services required.

package/lib/channel.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Channel + Presence public API. Wraps the Connection layer with
+ * per-channel state.
+ */
+import type { Connection, MessageListener, PresenceEventListener } from './connection.js';
+/** Listener handle returned by `subscribe` — call to remove the listener. */
+export type UnsubscribeFn = () => void;
+/**
+ * One subscription handle per (channel, listener) pair. Channels are
+ * value-equal by name on a given Realtime client — calling
+ * `client.channels.get('chat:1')` twice returns the same instance.
+ */
+export declare class Channel {
+    readonly name: string;
+    readonly presence: Presence;
+    private readonly connection;
+    private attachPromise;
+    private attached;
+    constructor(connection: Connection, name: string);
+    /**
+     * Ensure the server is subscribed to this channel. Called implicitly
+     * by `subscribe()` and `presence.subscribe()`; expose it so callers
+     * can pre-attach if they want to surface attach errors before the
+     * first message arrives.
+     */
+    attach(): Promise<void>;
+    /**
+     * Detach from the server (stop receiving messages and presence
+     * events). Local listeners are preserved — call `unsubscribe()` to
+     * clear them.
+     */
+    detach(): Promise<void>;
+    /**
+     * Register a listener for message frames on this channel. Implicitly
+     * attaches if needed. Returns an unsubscribe function.
+     */
+    subscribe(listener: MessageListener): UnsubscribeFn;
+    /** Publish one application-level message to the channel. */
+    publish(name: string, data: unknown): Promise<void>;
+}
+/**
+ * Per-channel presence facade. Wraps the `pres` frame and `presEvt`
+ * listener dispatch.
+ */
+export declare class Presence {
+    private readonly connection;
+    private readonly channelName;
+    private readonly channel;
+    constructor(connection: Connection, channelName: string, channel: Channel);
+    /**
+     * Register a listener for presence events. Implicitly attaches the
+     * underlying channel — presence events arrive on the same WebSocket
+     * subscription as message frames.
+     */
+    subscribe(listener: PresenceEventListener): UnsubscribeFn;
+    /** Announce this connection as present in the channel. */
+    enter(data?: unknown): Promise<void>;
+    /** Update the data attached to this connection's presence entry. */
+    update(data?: unknown): Promise<void>;
+    /** Remove this connection's presence entry. */
+    leave(): Promise<void>;
+    private send;
+}
+//# sourceMappingURL=channel.d.ts.map

package/lib/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG1F,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAS;gBAEb,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;IAMhD;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAe7B;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAO7B;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa;IAWnD,4DAA4D;IACtD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAI1D;AAED;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAMzE;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,qBAAqB,GAAG,aAAa;IASzD,0DAA0D;IACpD,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,oEAAoE;IAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,+CAA+C;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,IAAI;CASnB"}

package/lib/channel.js

@@ -0,0 +1,123 @@
+/**
+ * Channel + Presence public API. Wraps the Connection layer with
+ * per-channel state.
+ */
+/**
+ * One subscription handle per (channel, listener) pair. Channels are
+ * value-equal by name on a given Realtime client — calling
+ * `client.channels.get('chat:1')` twice returns the same instance.
+ */
+export class Channel {
+    name;
+    presence;
+    connection;
+    attachPromise = null;
+    attached = false;
+    constructor(connection, name) {
+        this.connection = connection;
+        this.name = name;
+        this.presence = new Presence(connection, name, this);
+    }
+    /**
+     * Ensure the server is subscribed to this channel. Called implicitly
+     * by `subscribe()` and `presence.subscribe()`; expose it so callers
+     * can pre-attach if they want to surface attach errors before the
+     * first message arrives.
+     */
+    async attach() {
+        if (this.attached)
+            return;
+        if (this.attachPromise)
+            return this.attachPromise;
+        this.attachPromise = this.connection
+            .request({ t: 'sub', channel: this.name })
+            .then(() => {
+            this.attached = true;
+            this.connection.rememberSubscription(this.name);
+        })
+            .finally(() => {
+            this.attachPromise = null;
+        });
+        return this.attachPromise;
+    }
+    /**
+     * Detach from the server (stop receiving messages and presence
+     * events). Local listeners are preserved — call `unsubscribe()` to
+     * clear them.
+     */
+    async detach() {
+        if (!this.attached)
+            return;
+        await this.connection.request({ t: 'unsub', channel: this.name });
+        this.attached = false;
+        this.connection.forgetSubscription(this.name);
+    }
+    /**
+     * Register a listener for message frames on this channel. Implicitly
+     * attaches if needed. Returns an unsubscribe function.
+     */
+    subscribe(listener) {
+        const listeners = this.connection.addChannelListeners(this.name);
+        listeners.messages.add(listener);
+        // Fire-and-forget attach; the listener stays registered even if
+        // attach fails so a retry-on-reconnect surfaces the right state.
+        this.attach().catch(() => { });
+        return () => {
+            listeners.messages.delete(listener);
+        };
+    }
+    /** Publish one application-level message to the channel. */
+    async publish(name, data) {
+        await this.attach();
+        await this.connection.request({ t: 'pub', channel: this.name, name, data });
+    }
+}
+/**
+ * Per-channel presence facade. Wraps the `pres` frame and `presEvt`
+ * listener dispatch.
+ */
+export class Presence {
+    connection;
+    channelName;
+    channel;
+    constructor(connection, channelName, channel) {
+        this.connection = connection;
+        this.channelName = channelName;
+        this.channel = channel;
+    }
+    /**
+     * Register a listener for presence events. Implicitly attaches the
+     * underlying channel — presence events arrive on the same WebSocket
+     * subscription as message frames.
+     */
+    subscribe(listener) {
+        const listeners = this.connection.addChannelListeners(this.channelName);
+        listeners.presence.add(listener);
+        this.channel.attach().catch(() => { });
+        return () => {
+            listeners.presence.delete(listener);
+        };
+    }
+    /** Announce this connection as present in the channel. */
+    async enter(data) {
+        await this.send('enter', data);
+    }
+    /** Update the data attached to this connection's presence entry. */
+    async update(data) {
+        await this.send('update', data);
+    }
+    /** Remove this connection's presence entry. */
+    async leave() {
+        await this.send('leave', undefined);
+    }
+    async send(action, data) {
+        await this.channel.attach();
+        await this.connection.request({
+            t: 'pres',
+            channel: this.channelName,
+            action,
+            ...(data === undefined ? {} : { data }),
+        });
+    }
+}
+//# sourceMappingURL=channel.js.map

package/lib/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;GAIG;AACH,MAAM,OAAO,OAAO;IACT,IAAI,CAAS;IACb,QAAQ,CAAW;IACX,UAAU,CAAa;IAChC,aAAa,GAAyB,IAAI,CAAC;IAC3C,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,UAAsB,EAAE,IAAY;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC;QAClD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,UAAU;aACjC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aACzC,IAAI,CAAC,GAAG,EAAE;YACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC,CAAC,CAAC;QACL,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,QAAyB;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,gEAAgE;QAChE,iEAAiE;QACjE,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC9B,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAa;QACvC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,QAAQ;IACF,UAAU,CAAa;IACvB,WAAW,CAAS;IACpB,OAAO,CAAU;IAElC,YAAY,UAAsB,EAAE,WAAmB,EAAE,OAAgB;QACvE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAA+B;QACvC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxE,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACtC,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC;IACJ,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,MAAM,CAAC,IAAc;QACzB,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,+CAA+C;IAC/C,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,MAAsB,EAAE,IAAa;QACtD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAC5B,CAAC,EAAE,MAAM;YACT,OAAO,EAAE,IAAI,CAAC,WAAW;YACzB,MAAM;YACN,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;CACF"}

package/lib/connection.d.ts

@@ -0,0 +1,139 @@
+/**
+ * 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.
+ */
+import type { AckFrame, ClientFrame, MessageFrame, PresenceEventFrame, PresenceFrame, PublishFrame, SubscribeFrame, UnsubscribeFrame } from './wire.js';
+/**
+ * Frames the SDK can issue with `request()`. Each carries an `id` the
+ * server echoes on the matching ack/err frame; Connection assigns the
+ * id so callers can omit it.
+ */
+export type AckableFrame = Omit<SubscribeFrame, 'id'> | Omit<UnsubscribeFrame, 'id'> | Omit<PublishFrame, 'id'> | Omit<PresenceFrame, 'id'>;
+/** Options that control how Connection reaches the edge. */
+export type ConnectionOptions = {
+    /** ws:// or wss:// URL pointing at the realtime edge binary. */
+    readonly url: string;
+    /**
+     * A Realtime API key in `appSlug.publicKeyId:privateKey` form. Convenient for trusted
+     * quick starts and server-side scripts; browser apps should prefer JWTs
+     * returned from `authCallback`.
+     */
+    readonly key?: string;
+    /** Optional client id to attach to a direct key-auth connection. */
+    readonly clientId?: string;
+    /**
+     * A static JWT to send in the auth handshake. Mutually exclusive with
+     * `authCallback`. Useful for local dev and short scripts.
+     */
+    readonly token?: string;
+    /**
+     * Async callback that returns a fresh JWT. Called once on connect and
+     * again on every reconnect. Use this when the token is short-lived
+     * (the production path).
+     */
+    readonly authCallback?: () => Promise<string> | string;
+    /**
+     * Override the global WebSocket constructor. Mostly useful in tests;
+     * defaults to `globalThis.WebSocket` which is present in browsers and
+     * Node 22+.
+     */
+    readonly webSocket?: typeof WebSocket;
+    /**
+     * If true, attempt to reconnect after unexpected disconnects with
+     * exponential backoff. Defaults to true.
+     */
+    readonly autoReconnect?: boolean;
+    /**
+     * Initial backoff for reconnects (default 1000ms). Doubles each
+     * attempt up to maxReconnectDelayMs.
+     */
+    readonly initialReconnectDelayMs?: number;
+    /** Cap on the reconnect backoff (default 30000ms). */
+    readonly maxReconnectDelayMs?: number;
+};
+/** Connection lifecycle states. */
+export type ConnectionState = 'initialized' | 'connecting' | 'connected' | 'disconnected' | 'closing' | 'closed' | 'failed';
+/** Listener for state transitions. */
+export type ConnectionStateListener = (state: ConnectionState, reason?: Error) => void;
+/** Listener invoked for every message frame on a channel. */
+export type MessageListener = (message: MessageFrame) => void;
+/** Listener invoked for every presence event frame on a channel. */
+export type PresenceEventListener = (event: PresenceEventFrame) => void;
+/**
+ * Internal listener registry, keyed by channel name. Connection owns
+ * the maps so reconnect can transparently re-subscribe.
+ */
+type ChannelListeners = {
+    readonly messages: Set<MessageListener>;
+    readonly presence: Set<PresenceEventListener>;
+};
+/**
+ * Connection is the transport layer. One Realtime client owns one
+ * Connection; channels share it.
+ */
+export declare class Connection {
+    readonly options: ConnectionOptions;
+    private socket;
+    private state;
+    private connectionId;
+    private serverClientId;
+    private nextRequestId;
+    private readonly pending;
+    private readonly channelListeners;
+    private readonly stateListeners;
+    private connectPromise;
+    private reconnectTimer;
+    private reconnectAttempt;
+    /** Channels the SDK has asked to be subscribed to; re-sent on reconnect. */
+    private readonly desiredSubscriptions;
+    constructor(options: ConnectionOptions);
+    /** Current connection state. */
+    getState(): ConnectionState;
+    /** The server-issued connection id, populated after a successful auth handshake. */
+    getConnectionId(): string | null;
+    /** The client id encoded in the token, populated after auth. */
+    getClientId(): string | null;
+    /** Register a state-change listener. Returns an unsubscribe function. */
+    onStateChange(listener: ConnectionStateListener): () => void;
+    /**
+     * Open the WebSocket and complete the auth handshake. Idempotent —
+     * concurrent calls await the same in-flight connect.
+     */
+    connect(): Promise<void>;
+    /** Close the WebSocket and release resources. */
+    close(): Promise<void>;
+    /**
+     * Send a frame that expects an ack. Returns the matching AckFrame, or
+     * rejects with the server's ErrorFrame (wrapped in an Error).
+     */
+    request(frame: AckableFrame): Promise<AckFrame>;
+    /** Send a fire-and-forget frame (no ack expected). */
+    send(frame: ClientFrame): Promise<void>;
+    /**
+     * 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: string): ChannelListeners;
+    /** Forget all listeners for a channel. Called from Channel.detach. */
+    removeChannelListeners(channel: string): void;
+    /** Add `channel` to the set of subscriptions to restore on reconnect. */
+    rememberSubscription(channel: string): void;
+    /** Stop restoring this subscription on future reconnects. */
+    forgetSubscription(channel: string): void;
+    private doConnect;
+    private makeSocket;
+    private createAuthFrame;
+    /** Steady-state message handler; installed after a successful auth. */
+    private readonly handleMessage;
+    private handleClose;
+    private scheduleReconnect;
+    private restoreSubscriptionsOnReconnect;
+    private sendRaw;
+    private setState;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/lib/connection.d.ts.map

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