@brass-build/client 0.1.0

package/dist/ws-client.js

@@ -0,0 +1,604 @@
+// One WS connection per SDK instance, lazily opened on the first `subscribe`.
+// Multiplexes N user callbacks onto one WS-level subscription per topic: the
+// subscribe frame is sent on the first callback for a topic, the unsubscribe
+// frame when the last detaches.
+//
+// Reconnect: on `close` back off (1s..30s) and replay the "wanted-state" set
+// of topics. After ~5 minutes of failure *while foregrounded* bail and fire
+// `onError`, keeping the wanted-state so a later resume / `subscribe`
+// recovers.
+//
+// Background-tab resilience: a hidden tab throttles timers but wall-clock
+// (which the give-up budget measures) keeps advancing, so running the budget
+// while hidden would bail on a healthy connection. The reconnect loop pauses
+// while `document.hidden`; foregrounding (`visibilitychange`) or coming back
+// `online` resets the backoff + budget and reconnects with a fresh token.
+//
+// Heartbeat: send `{ type: 'ping' }` every 60 seconds while any topic is
+// subscribed. One interval serves two purposes: it resets the server's
+// 10-minute idle timeout (only client-originated frames do), and it is the
+// presence liveness signal (the server refreshes `last_seen` on each ping;
+// the staleness threshold is 3 missed heartbeats). The server replies
+// `pong`; a topic-less `{ type: 'error', reason: 'bad_message' }` is
+// accepted as a no-op too, so a deploy without the `ping` handler is
+// tolerated. Both are dropped.
+import { IDLE_TOPIC, holdsFrames, step, } from './topic-lifecycle.js';
+import { SDK_CLIENT_ID } from './version.js';
+const RECONNECT_DELAYS_MS = [1000, 2000, 4000, 8000, 16000, 30000];
+const RECONNECT_GIVE_UP_MS = 5 * 60 * 1000;
+const HEARTBEAT_INTERVAL_MS = 60_000;
+// Cap on the frames held for one topic's unacked subscribe, matching the
+// `outboundQueue` bound. Both hold the same kind of mid-reconnect frames
+// (a disconnect rolls every wanted topic back to `subscribing`, so ops sent
+// during the reconnect window are HELD here rather than in `outboundQueue`),
+// so both need the same memory ceiling or a doc edited through a long outage
+// grows one queue without bound. Generous for a single user's in-flight ops.
+const MAX_QUEUED_FRAMES = 1024;
+export class BrassWsClient {
+    opts;
+    ws = null;
+    connecting = false;
+    // Monotonic connect-attempt token. `close()` and each new attempt bump it,
+    // so a continuation parked on the token / assertion awaits in
+    // `ensureConnected` can tell its attempt was superseded and bail instead
+    // of adopting a socket nobody wants (a zombie the heartbeat would keep
+    // alive past the gateway idle timeout). Mechanical: any await added to
+    // the connect path is covered by re-checking the epoch after it.
+    connectEpoch = 0;
+    // Per-topic lifecycle state, driven exclusively through the pure
+    // `step` transition table in `topic-lifecycle.ts`: handlers translate
+    // frames / user calls into events via `dispatch` and execute the
+    // returned effects. Wanted topics (the ones a reconnect replays) are
+    // the entries in a non-`tornDown` phase; the listener map below is the
+    // callback data those decisions act on.
+    topics = new Map();
+    listeners = new Map();
+    // Outbound frames queued while the socket is not OPEN. Drained on `open`
+    // (after subscribe replay) so an optimistic `mutate()` survives a reconnect
+    // window.
+    outboundQueue = [];
+    // Per-topic queues of frames held while `holdsFrames` says the topic's
+    // subscribe is unacked: a topic-scoped frame (`presence`, `op`) sent
+    // before the `subscribed` reply races the SUB# row write and the
+    // server's conditional update fails as a spurious `forbidden`. The
+    // machine's `flush_held` / `drop_held` effects drain or discard them.
+    // Bounded per topic (`MAX_QUEUED_FRAMES`, drop-oldest) so a doc edited
+    // through a long outage can't grow it without limit.
+    pendingTopicSends = new Map();
+    // Warn-once latch for held-queue overflow drops, reset when a topic's held
+    // frames flush on the `subscribed` ack, so each unacked window reports once.
+    heldOverflowReported = false;
+    reconnectAttempt = 0;
+    reconnectStartedAt = null;
+    reconnectTimer = null;
+    // Warn-once latch for outbound-queue overflow drops; reset when the queue
+    // drains on a successful (re)connect, so each disconnect reports at most
+    // once.
+    outboundOverflowReported = false;
+    heartbeatTimer = null;
+    closedByUser = false;
+    // Page-lifecycle listeners, installed lazily on first connect and removed on
+    // user close. Guarded for non-DOM environments (Node, SSR).
+    visibilityListener = null;
+    onlineListener = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    // Returns an unsubscribe that detaches THIS callback only; the WS-level
+    // subscription stays open while other callbacks remain, and the unsubscribe
+    // frame is sent only when the last detaches.
+    subscribe(topic, callback) {
+        let set = this.listeners.get(topic);
+        const firstForTopic = !set;
+        if (!set) {
+            set = new Set();
+            this.listeners.set(topic, set);
+        }
+        set.add(callback);
+        if (firstForTopic) {
+            this.dispatch(topic, { type: 'user_subscribe' });
+            void this.ensureConnected();
+        }
+        else if (!this.ws && !this.connecting && !this.reconnectTimer) {
+            // The wanted-state held this topic but there's no socket and no
+            // reconnect in flight (a prior give-up or a drop while hidden): a fresh
+            // subscribe is the retry signal. (A pending reconnect timer is left
+            // alone so its backoff isn't reset.)
+            this.resume();
+        }
+        return () => {
+            const current = this.listeners.get(topic);
+            if (!current)
+                return;
+            current.delete(callback);
+            if (current.size > 0)
+                return;
+            this.listeners.delete(topic);
+            this.dispatch(topic, { type: 'user_unsubscribe' });
+            // Drop the connection once no topic is wanted, so no idle socket lingers.
+            if (this.listeners.size === 0) {
+                this.close();
+            }
+        };
+    }
+    // Feed one event through the topic's machine, commit the new state, then
+    // execute the effects. `idle` results are pruned; `tornDown` entries are
+    // kept so a same-connection re-subscribe inherits the spent retry, and
+    // the next socket transition prunes them.
+    dispatch(topic, event) {
+        const prior = this.topics.get(topic) ?? IDLE_TOPIC;
+        const { state, effects } = step(prior, event);
+        if (state.phase === 'idle') {
+            this.topics.delete(topic);
+        }
+        else if (event.type === 'user_subscribe') {
+            // Re-insert so the map's order (the reconnect replay order) tracks
+            // subscription order even for a topic re-subscribed after teardown.
+            this.topics.delete(topic);
+            this.topics.set(topic, state);
+        }
+        else {
+            this.topics.set(topic, state);
+        }
+        for (const effect of effects) {
+            this.runEffect(topic, effect);
+        }
+    }
+    runEffect(topic, effect) {
+        switch (effect.kind) {
+            case 'send_subscribe':
+                // Dropped when the socket is not open; `socket_open` re-derives a
+                // `send_subscribe` for every wanted topic, so nothing is lost.
+                this.sendIfOpen({ type: 'subscribe', topic });
+                return;
+            case 'send_unsubscribe':
+                this.sendIfOpen({ type: 'unsubscribe', topic });
+                return;
+            case 'flush_held': {
+                const queued = this.pendingTopicSends.get(topic);
+                if (queued) {
+                    this.pendingTopicSends.delete(topic);
+                    for (const f of queued)
+                        this.sendFrame(f);
+                }
+                // The unacked window closed; re-arm the overflow warning for the next.
+                this.heldOverflowReported = false;
+                return;
+            }
+            case 'drop_held':
+                this.pendingTopicSends.delete(topic);
+                return;
+            case 'drop_listeners':
+                this.listeners.delete(topic);
+                return;
+            case 'fire_error':
+                this.opts.fireError(new Error(`Brass WebSocket subscribe(${topic}): ${effect.reason}`));
+                return;
+        }
+    }
+    // Send an arbitrary frame. Queued when the socket is not open and drained on
+    // the next `open` (covering a mutate during the subscribe handshake gap and
+    // ops that must survive a mid-session reconnect). Failures (overflow, closed
+    // transport) are silently dropped.
+    send(frame) {
+        // Topic-scoped frames sent before the `subscribed` ack race the SUB# row
+        // write and surface as spurious `forbidden`, so hold them until the ack
+        // (see `pendingTopicSends`). The machine's `holdsFrames` covers every
+        // unacked wanted state (fresh subscribe, reconnect replay, retry).
+        const topic = topicOfFrame(frame);
+        const topicState = topic !== undefined ? this.topics.get(topic) : undefined;
+        if (topic !== undefined && topicState && holdsFrames(topicState)) {
+            let queue = this.pendingTopicSends.get(topic);
+            if (!queue) {
+                queue = [];
+                this.pendingTopicSends.set(topic, queue);
+            }
+            // Bounded like `outboundQueue`: drop the oldest held frame on
+            // overflow. Safe to drop here because an op is re-asserted by the
+            // per-doc resend tracker (keyed independently on `client_op_id`), and
+            // a dropped presence frame is superseded by the next `set()`.
+            if (queue.length >= MAX_QUEUED_FRAMES) {
+                queue.shift();
+                if (!this.heldOverflowReported) {
+                    this.heldOverflowReported = true;
+                    this.opts.fireError(new Error('Brass WebSocket: held-frame queue overflowed while a subscribe was unacked; the oldest queued frames were dropped'));
+                }
+            }
+            queue.push(frame);
+            // Ensure a connection is in flight; the machine re-emits the
+            // subscribe on `socket_open`.
+            void this.ensureConnected();
+            return;
+        }
+        if (this.ws && this.ws.readyState === this.ws.OPEN) {
+            this.sendFrame(frame);
+            return;
+        }
+        // Bounded so a misbehaving caller can't leak memory; 1024 is generous for
+        // a single user's mid-session ops during a reconnect (each typically <1KB).
+        if (this.outboundQueue.length >= 1024) {
+            this.outboundQueue.shift();
+            // A dropped frame can be an op the caller believes is saved-pending;
+            // surface it, once per overflow episode so a runaway producer can't
+            // flood the error channel.
+            if (!this.outboundOverflowReported) {
+                this.outboundOverflowReported = true;
+                this.opts.fireError(new Error('Brass WebSocket: outbound queue overflowed while disconnected; the oldest queued frames were dropped and will not reach the server'));
+            }
+        }
+        this.outboundQueue.push(frame);
+        // Kick the connect path if no socket is open yet (a caller that `send`s
+        // without ever subscribing), or the queue would never drain.
+        if (!this.ws && !this.connecting && !this.closedByUser) {
+            void this.ensureConnected();
+        }
+    }
+    close() {
+        this.closedByUser = true;
+        // Supersede any in-flight connect attempt, and clear `connecting` so a
+        // subscribe / send that lands after this close starts its own fresh
+        // attempt through the normal entry path (fresh token, lifecycle
+        // listeners re-armed) instead of finding the entry guard held by a
+        // continuation that is about to bail.
+        this.connectEpoch++;
+        this.connecting = false;
+        this.removeLifecycleListeners();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.stopHeartbeat();
+        const ws = this.ws;
+        this.ws = null;
+        // `socket_closed` per topic: drops held frames and rolls wanted topics
+        // back to `subscribing` so a later resume replays them.
+        for (const topic of this.topics.keys()) {
+            this.dispatch(topic, { type: 'socket_closed' });
+        }
+        this.outboundQueue = [];
+        if (ws && ws.readyState !== ws.CLOSED && ws.readyState !== ws.CLOSING) {
+            try {
+                ws.close();
+            }
+            catch {
+                // Closing an already-closing socket is fine.
+            }
+        }
+    }
+    async ensureConnected() {
+        if (this.ws && this.ws.readyState === this.ws.OPEN)
+            return;
+        if (this.connecting)
+            return;
+        this.ensureLifecycleListeners();
+        this.connecting = true;
+        this.closedByUser = false;
+        const epoch = ++this.connectEpoch;
+        try {
+            const token = await this.opts.getAccessToken();
+            if (epoch !== this.connectEpoch)
+                return;
+            // Anonymous link guest: no access token, but a link token authorises a
+            // read-only connection.
+            const guestToken = token ? null : this.opts.getGuestLinkToken?.() ?? null;
+            if (!token && !guestToken) {
+                this.connecting = false;
+                this.opts.fireError(new Error('Brass WebSocket subscribe: not signed in'));
+                return;
+            }
+            const Ctor = this.opts.webSocketImpl ?? globalThis.WebSocket;
+            if (!Ctor) {
+                this.connecting = false;
+                this.opts.fireError(new Error('Brass WebSocket subscribe: WebSocket is not available'));
+                return;
+            }
+            const assertion = token && this.opts.getAppAssertion
+                ? await this.opts.getAppAssertion()
+                : null;
+            if (epoch !== this.connectEpoch)
+                return;
+            const url = token
+                ? this.buildUrl(token, assertion)
+                : this.buildGuestUrl(guestToken);
+            // The OPEN guard at the top returns only for a socket that is OPEN; a
+            // CONNECTING/CLOSING one falls through to here, so a prior socket can
+            // still be around. Adopt the new socket as `this.ws` FIRST, then close
+            // the old one: its `close` then fails the identity guard below and is
+            // ignored, rather than nulling out the live socket.
+            const prev = this.ws;
+            const ws = new Ctor(url);
+            this.ws = ws;
+            // Guard every lifecycle handler on socket identity. A superseded
+            // socket's delayed `close` (common on a throttled hidden tab) would
+            // otherwise run `onClose`, null out the live `this.ws`, roll every
+            // topic back to `subscribing`, and schedule a spurious reconnect.
+            ws.addEventListener('open', () => {
+                if (this.ws === ws)
+                    this.onOpen();
+            });
+            ws.addEventListener('message', (ev) => {
+                if (this.ws === ws)
+                    this.onMessage(ev);
+            });
+            ws.addEventListener('close', () => {
+                if (this.ws === ws)
+                    this.onClose();
+            });
+            ws.addEventListener('error', () => {
+                // The `close` handler runs after `error` and drives reconnect;
+                // swallowing keeps a transient network error from bubbling.
+            });
+            if (prev) {
+                try {
+                    prev.close();
+                }
+                catch {
+                    // Closing an already-closing socket is fine.
+                }
+            }
+        }
+        catch (err) {
+            // A superseded attempt's failure is not this client's failure: the
+            // `connecting` flag now belongs to the newer attempt, so leave it.
+            if (epoch !== this.connectEpoch)
+                return;
+            this.connecting = false;
+            this.opts.fireError(err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    buildUrl(token, assertion) {
+        const base = this.opts.wsBaseUrl.replace(/\/$/, '');
+        const sep = base.includes('?') ? '&' : '?';
+        const assertionParam = assertion
+            ? `&app_assertion=${encodeURIComponent(assertion)}`
+            : '';
+        // `client` feeds the ws.connect audit so the deployed SDK version
+        // distribution is measurable per live connection.
+        return `${base}${sep}app_id=${encodeURIComponent(this.opts.appId)}&token=${encodeURIComponent(token)}${assertionParam}&client=${encodeURIComponent(SDK_CLIENT_ID)}`;
+    }
+    // Anonymous link-guest connect URL: the link token authorises the socket
+    // (no access token, no app assertion). The server resolves it to a
+    // read-only, single-doc-scoped connection.
+    buildGuestUrl(guestToken) {
+        const base = this.opts.wsBaseUrl.replace(/\/$/, '');
+        const sep = base.includes('?') ? '&' : '?';
+        return `${base}${sep}app_id=${encodeURIComponent(this.opts.appId)}&brass_link=${encodeURIComponent(guestToken)}`;
+    }
+    onOpen() {
+        this.connecting = false;
+        this.reconnectAttempt = 0;
+        this.reconnectStartedAt = null;
+        // `socket_open` per topic: re-subscribes every wanted topic (in
+        // subscription order) with a fresh retry grant, and prunes `tornDown`
+        // leftovers. Runs before the outbound drain so the server sees the
+        // subscribes first; otherwise an op right after a reconnect races its
+        // subscribe and gets `bad_message` (not subscribed yet).
+        for (const topic of this.topics.keys()) {
+            this.dispatch(topic, { type: 'socket_open' });
+        }
+        this.flushOutbound();
+        this.startHeartbeat();
+    }
+    flushOutbound() {
+        if (!this.ws || this.ws.readyState !== this.ws.OPEN)
+            return;
+        const drained = this.outboundQueue;
+        this.outboundQueue = [];
+        this.outboundOverflowReported = false;
+        for (const frame of drained) {
+            this.sendFrame(frame);
+        }
+    }
+    onMessage(ev) {
+        let frame;
+        try {
+            frame = JSON.parse(typeof ev.data === 'string' ? ev.data : String(ev.data));
+        }
+        catch {
+            // Drop garbage; the server protocol is strict JSON.
+            return;
+        }
+        if (!isObject(frame))
+            return;
+        const type = frame.type;
+        if (typeof type !== 'string')
+            return;
+        if (type === 'subscribed' && typeof frame.topic === 'string') {
+            // `flush_held` drains the frames held back for the unacked subscribe.
+            this.dispatch(frame.topic, { type: 'subscribed_ack' });
+            return;
+        }
+        if (type === 'unsubscribed') {
+            // No callbacks fire; the user-side unsubscribe already returned.
+            return;
+        }
+        if (type === 'pong') {
+            // Heartbeat reply; drop silently (the round-trip already reset API
+            // Gateway's idle-timeout).
+            return;
+        }
+        if (type === 'error') {
+            const topic = typeof frame.topic === 'string' ? frame.topic : undefined;
+            const reason = typeof frame.reason === 'string' ? frame.reason : 'error';
+            // A deploy without the `ping` handler replies to our ping with a
+            // topic-less `bad_message` instead of `pong`; treat it as a heartbeat
+            // ack (see the header).
+            if (reason === 'bad_message' && !topic)
+                return;
+            if (topic) {
+                // The machine decides: silent retry, swallow, or teardown +
+                // `fire_error`. A topic with no live state (already unsubscribed
+                // or torn down our side) swallows: the canonical case is a
+                // presence-update racing a `doc_gone` eviction, whose late
+                // `forbidden` reply would otherwise surface as a misleading
+                // "subscribe(...): forbidden" with no subscribe in flight to fail.
+                this.dispatch(topic, { type: 'error', reason });
+                return;
+            }
+            this.opts.fireError(new Error(`Brass WebSocket subscribe: ${reason}`));
+            return;
+        }
+        // Topic-scoped server frames: fan out to every callback for the topic.
+        if (typeof frame.topic === 'string') {
+            const set = this.listeners.get(frame.topic);
+            if (!set)
+                return;
+            for (const cb of set) {
+                try {
+                    cb(frame);
+                }
+                catch {
+                    // A bad listener must not break the others or kill the read loop.
+                }
+            }
+        }
+    }
+    onClose() {
+        this.stopHeartbeat();
+        this.ws = null;
+        // Held frames are tied to the connection's unacked subscribes;
+        // `socket_closed` drops them and preserves wantedness for the replay.
+        for (const topic of this.topics.keys()) {
+            this.dispatch(topic, { type: 'socket_closed' });
+        }
+        this.connecting = false;
+        if (this.closedByUser)
+            return;
+        if (this.listeners.size === 0)
+            return;
+        this.scheduleReconnect();
+    }
+    scheduleReconnect() {
+        // Don't run the loop while hidden: throttled timers but advancing
+        // wall-clock would burn the give-up budget without real attempts and bail
+        // on a healthy connection. `resume()` restarts with a fresh budget on
+        // foreground / network recovery.
+        if (this.isHidden())
+            return;
+        if (this.reconnectStartedAt === null) {
+            this.reconnectStartedAt = Date.now();
+        }
+        if (Date.now() - this.reconnectStartedAt >= RECONNECT_GIVE_UP_MS) {
+            this.opts.fireError(new Error('Brass WebSocket subscribe: reconnect gave up after 5 minutes'));
+            // Keep the wanted-state: a resume / fresh `subscribe` recovers by
+            // replaying it. The budget resets so resume starts clean; clearing
+            // listeners here would make the bail permanent (the background-tab bug
+            // this guards against).
+            this.reconnectAttempt = 0;
+            this.reconnectStartedAt = null;
+            return;
+        }
+        const idx = Math.min(this.reconnectAttempt, RECONNECT_DELAYS_MS.length - 1);
+        const delay = RECONNECT_DELAYS_MS[idx];
+        this.reconnectAttempt += 1;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            void this.ensureConnected();
+        }, delay);
+    }
+    // Foreground return / network recovery: reset the backoff + give-up budget
+    // and reconnect promptly with a fresh token instead of waiting out a long
+    // delay or staying dead after a bail. No-op when nothing is wanted, the user
+    // closed us, or a socket is already open.
+    resume() {
+        if (this.closedByUser)
+            return;
+        if (this.listeners.size === 0)
+            return;
+        if (this.ws && this.ws.readyState === this.ws.OPEN)
+            return;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        this.reconnectAttempt = 0;
+        this.reconnectStartedAt = null;
+        void this.ensureConnected();
+    }
+    isHidden() {
+        const doc = globalThis.document;
+        return doc?.hidden === true;
+    }
+    ensureLifecycleListeners() {
+        if (this.visibilityListener || this.onlineListener)
+            return;
+        const doc = globalThis.document;
+        if (doc && typeof doc.addEventListener === 'function') {
+            const listener = () => {
+                if (doc.hidden !== true)
+                    this.resume();
+            };
+            this.visibilityListener = listener;
+            doc.addEventListener('visibilitychange', listener);
+        }
+        if (typeof globalThis.addEventListener === 'function') {
+            const listener = () => this.resume();
+            this.onlineListener = listener;
+            globalThis.addEventListener('online', listener);
+        }
+    }
+    removeLifecycleListeners() {
+        const doc = globalThis.document;
+        if (this.visibilityListener &&
+            doc &&
+            typeof doc.removeEventListener === 'function') {
+            doc.removeEventListener('visibilitychange', this.visibilityListener);
+        }
+        this.visibilityListener = null;
+        if (this.onlineListener &&
+            typeof globalThis.removeEventListener === 'function') {
+            globalThis.removeEventListener('online', this.onlineListener);
+        }
+        this.onlineListener = null;
+    }
+    startHeartbeat() {
+        this.stopHeartbeat();
+        this.heartbeatTimer = setInterval(() => {
+            this.sendIfOpen({ type: 'ping' });
+        }, HEARTBEAT_INTERVAL_MS);
+    }
+    stopHeartbeat() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+    }
+    sendIfOpen(frame) {
+        if (!this.ws || this.ws.readyState !== this.ws.OPEN)
+            return;
+        this.sendFrame(frame);
+    }
+    sendFrame(frame) {
+        if (!this.ws)
+            return;
+        try {
+            this.ws.send(JSON.stringify(frame));
+        }
+        catch {
+            // A send failure means the connection is half-dead; `close` fires
+            // shortly and drives reconnect.
+        }
+    }
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null;
+}
+// The frame's topic, if any. `send()` uses it to decide whether the frame is
+// subject to the subscribe-pending hold (see `pendingTopicSends`). Returns
+// `undefined` for transport frames (`subscribe` / `unsubscribe` / `ping` /
+// `pong`), which the hold must NOT apply to (the subscribe is what it waits
+// for).
+function topicOfFrame(frame) {
+    if (!isObject(frame))
+        return undefined;
+    const type = frame['type'];
+    if (type === 'subscribe' ||
+        type === 'unsubscribe' ||
+        type === 'ping' ||
+        type === 'pong') {
+        return undefined;
+    }
+    const topic = frame['topic'];
+    return typeof topic === 'string' ? topic : undefined;
+}
+//# sourceMappingURL=ws-client.js.map

package/dist/ws-client.js.map

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

package/dist/ws-frame-limit.d.ts

@@ -0,0 +1,21 @@
+export interface OpFrame {
+    type: 'op';
+    topic: string;
+    op_blob: string;
+    client_op_id: string;
+}
+/**
+ * True when the serialized frame would exceed what the socket carries.
+ *
+ * The envelope is measured with the blob emptied, so a multi-megabyte
+ * value is never serialized just to be counted. Every byte is ASCII
+ * (base64 blob, topic, id), so length is byte length.
+ */
+export declare function opFrameExceedsWsLimit(frame: OpFrame): boolean;
+/** True when the blob is too large to ride in a request body, so it is
+ *  uploaded to storage first and the write names the staged object. */
+export declare function opBlobNeedsStaging(opBlobB64: string): boolean;
+/** True when no single op can hold the blob, so the server could only
+ *  refuse it. Checked locally to save an upload that ends in a 400. */
+export declare function opBlobExceedsDurableLimit(opBlobB64: string): boolean;
+//# sourceMappingURL=ws-frame-limit.d.ts.map

package/dist/ws-frame-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-frame-limit.d.ts","sourceRoot":"","sources":["../src/ws-frame-limit.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;uEACuE;AACvE,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;uEACuE;AACvE,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEpE"}