@streamotter/client 0.1.0-rc.1

package/dist/subscription.js

@@ -0,0 +1,424 @@
+import { asStreamOtterError, compareRevisions, EVENTS, streamError, StreamOtterError, UNSUBSCRIBE_TIMEOUT_MS } from "@streamotter/contracts";
+import { WaiterSet } from "./waiters.js";
+/** SDK-detected synchronization failures tolerated per incident before resync-required. */
+const LOCAL_SYNC_ATTEMPTS = 3;
+function isThenable(value) {
+    return (typeof value === "object" || typeof value === "function") && value !== null
+        && typeof value.then === "function";
+}
+/**
+ * Client side of one subscription. Accepts an epoch only after its ordered
+ * `synchronizing` frame, validates sequence and revision order, confirms SDK
+ * receipt after synchronous listener dispatch, and never reports `live` for a
+ * disconnected or superseded view.
+ */
+export class ClientSubscription {
+    id;
+    channel;
+    channelVersion;
+    params;
+    #owner;
+    #listeners = {
+        data: new Set(),
+        state: new Set(),
+        error: new Set()
+    };
+    #waiters = new WaiterSet();
+    #state = "idle";
+    #reason;
+    #terminal = false;
+    #attached = null;
+    #serverKnows = false;
+    #epoch = null;
+    /** Set after we ask the gateway to replace `#epoch`; old-epoch progress is ignored. */
+    #replacing = null;
+    #awaitingEpoch = true;
+    #expectedSequence = 1;
+    #epochRevision = null;
+    #lastRevision = null;
+    #localFailures = 0;
+    #lastError = null;
+    #unsubscribing = null;
+    #retryTimer = null;
+    constructor(owner, channel, channelVersion, params) {
+        this.#owner = owner;
+        this.id = owner.randomId();
+        this.channel = channel;
+        this.channelVersion = channelVersion;
+        this.params = params;
+        // Start in the next microtask so synchronously attached listeners miss nothing.
+        queueMicrotask(() => {
+            if (!this.#terminal)
+                this.#owner.register(this);
+        });
+    }
+    get state() {
+        return this.#state;
+    }
+    get active() {
+        return !this.#terminal;
+    }
+    on(event, listener) {
+        const set = this.#listeners[event];
+        if (set === undefined || typeof listener !== "function") {
+            throw new StreamOtterError("INVALID_REQUEST", { message: "on() accepts \"data\", \"state\", or \"error\" with a function." });
+        }
+        set.add(listener);
+        return () => { set.delete(listener); };
+    }
+    ready(options) {
+        if (this.#state === "live")
+            return Promise.resolve();
+        const blocked = this.#blockedError();
+        if (blocked !== null)
+            return Promise.reject(asStreamOtterError(blocked));
+        return this.#waiters.wait(options);
+    }
+    resync(options) {
+        const blocked = this.#blockedError(true);
+        if (blocked !== null)
+            return Promise.reject(asStreamOtterError(blocked));
+        const wait = this.#waiters.wait(options);
+        this.#localFailures = 0;
+        this.#requestFreshSynchronization();
+        return wait;
+    }
+    unsubscribe() {
+        if (this.#unsubscribing !== null)
+            return this.#unsubscribing;
+        const connection = this.#attached;
+        const serverKnows = this.#serverKnows;
+        this.#terminate("closed", undefined, new StreamOtterError("CANCELLED", { message: "The subscription was unsubscribed." }));
+        this.#unsubscribing = serverKnows && connection !== null && connection.connected
+            ? this.#sendUnsubscribe(connection)
+            : Promise.resolve();
+        return this.#unsubscribing;
+    }
+    // --- called by the client ----------------------------------------------------------
+    /** Subscribes on a freshly authenticated connection. */
+    attach(connection) {
+        if (this.#terminal)
+            return;
+        this.#clearRetry();
+        this.#attached = connection;
+        this.#serverKnows = false;
+        this.#epoch = null;
+        this.#replacing = null;
+        this.#awaitingEpoch = true;
+        this.#setState("authorizing");
+        void this.#subscribe(connection);
+    }
+    /** The transport was lost; the view is stale until a new synchronization completes. */
+    detach(reason) {
+        this.#clearRetry();
+        this.#attached = null;
+        this.#serverKnows = false;
+        this.#awaitingEpoch = true;
+        this.#replacing = null;
+        if (this.#terminal || this.#state === "resync-required")
+            return;
+        this.#setState("stale", reason);
+    }
+    /** Authentication was rejected; waiting for an explicit reconnect(). */
+    authRequired(error) {
+        this.detach("UNAUTHENTICATED");
+        if (!this.#terminal)
+            this.#waiters.rejectAll(error);
+    }
+    /** Terminates without contacting the server (client close or identity change). */
+    terminateLocally(state, error, emit) {
+        if (this.#terminal)
+            return;
+        if (emit)
+            this.#emitError(error);
+        this.#terminate(state, error.code, error);
+    }
+    handleState(connection, frame) {
+        if (this.#terminal || connection !== this.#attached)
+            return;
+        // A frame proves the gateway holds this subscription, even if its acknowledgement
+        // continuation has not run yet (both can arrive in one socket read).
+        this.#serverKnows = true;
+        if (frame.state === "synchronizing") {
+            if (frame.epoch === this.#epoch && !this.#awaitingEpoch)
+                return;
+            this.#epoch = frame.epoch;
+            this.#replacing = null;
+            this.#awaitingEpoch = false;
+            this.#expectedSequence = 1;
+            this.#epochRevision = null;
+            this.#setState("synchronizing");
+            return;
+        }
+        if (frame.epoch !== (this.#epoch ?? ""))
+            return;
+        if (this.#replacing !== null && frame.epoch === this.#replacing
+            && (frame.state === "live" || frame.state === "resync-required")) {
+            return; // Progress of the epoch we asked the gateway to replace.
+        }
+        if (frame.state === "live" && this.#awaitingEpoch)
+            return;
+        switch (frame.state) {
+            case "failed":
+                this.#serverKnows = false;
+                this.#terminate("failed", frame.reason, this.#lastError ?? streamError(frame.reason ?? "INTERNAL"));
+                return;
+            case "closed":
+                this.#serverKnows = false;
+                this.#terminate("closed", frame.reason, this.#lastError ?? streamError(frame.reason ?? "CANCELLED"));
+                return;
+            case "resync-required":
+                this.#setState("resync-required", frame.reason ?? "RESYNC_REQUIRED");
+                return;
+            case "live":
+                this.#localFailures = 0;
+                this.#setState("live");
+                return;
+            case "stale":
+            case "authorizing":
+                this.#setState(frame.state, frame.reason);
+                return;
+            default:
+                return;
+        }
+    }
+    handleData(connection, frame) {
+        if (this.#terminal || connection !== this.#attached)
+            return;
+        this.#serverKnows = true;
+        if (this.#awaitingEpoch || frame.epoch !== this.#epoch)
+            return;
+        if (frame.sequence !== this.#expectedSequence) {
+            this.#localSyncFailure("INVALID_REQUEST", `Expected sequence ${this.#expectedSequence} but received ${frame.sequence}.`);
+            return;
+        }
+        const event = frame.event;
+        if (event.channel !== this.channel || event.channelVersion !== this.channelVersion) {
+            this.#localSyncFailure("INVALID_PAYLOAD", "A frame named a different channel contract.");
+            return;
+        }
+        if (frame.sequence === 1) {
+            if (event.kind !== "snapshot") {
+                this.#localSyncFailure("INVALID_REQUEST", "The first frame of an epoch must be a snapshot.");
+                return;
+            }
+            if (this.#lastRevision !== null && compareRevisions(event.revision, this.#lastRevision) < 0) {
+                this.#localSyncFailure("INVALID_PAYLOAD", "The snapshot is older than state this subscription already delivered.");
+                return;
+            }
+        }
+        else if (event.kind !== "update" || (this.#epochRevision !== null && compareRevisions(event.revision, this.#epochRevision) <= 0)) {
+            this.#localSyncFailure("INVALID_REQUEST", "Updates must follow the snapshot in increasing revision order.");
+            return;
+        }
+        this.#expectedSequence++;
+        this.#epochRevision = event.revision;
+        if (this.#lastRevision === null || compareRevisions(event.revision, this.#lastRevision) > 0)
+            this.#lastRevision = event.revision;
+        for (const listener of [...this.#listeners.data]) {
+            if (!this.#invoke(listener, event))
+                return;
+        }
+        connection.receipt({ subscriptionId: this.id, epoch: frame.epoch, sequence: frame.sequence });
+    }
+    handleError(connection, error) {
+        if (this.#terminal || connection !== this.#attached)
+            return;
+        this.#lastError = error;
+        this.#emitError(error);
+    }
+    // --- internals -----------------------------------------------------------------------
+    #blockedError(forResync = false) {
+        if (this.#owner.closed && this.#state === "closed")
+            return streamError("CLIENT_CLOSED");
+        if (this.#terminal) {
+            if (this.#state === "failed")
+                return this.#lastError ?? streamError("INTERNAL");
+            return this.#owner.closed ? streamError("CLIENT_CLOSED") : streamError("CANCELLED", { message: "The subscription was unsubscribed." });
+        }
+        if (this.#owner.authRequired)
+            return streamError("UNAUTHENTICATED", { message: "Authentication is required; call reconnect()." });
+        if (!forResync && this.#state === "resync-required")
+            return streamError("RESYNC_REQUIRED");
+        return null;
+    }
+    async #subscribe(connection) {
+        let result;
+        try {
+            result = await connection.request(EVENTS.subscribe, {
+                requestId: this.#owner.randomId(),
+                subscriptionId: this.id,
+                channel: this.channel,
+                channelVersion: this.channelVersion,
+                params: this.params
+            });
+        }
+        catch (error) {
+            if (connection !== this.#attached || this.#terminal)
+                return;
+            if (error.code === "TIMEOUT")
+                this.#owner.controlTimedOut(connection);
+            return;
+        }
+        if (connection !== this.#attached || this.#terminal)
+            return;
+        if (result.ok) {
+            this.#serverKnows = true;
+            return;
+        }
+        this.#lastError = result.error;
+        this.#emitError(result.error);
+        if (result.error.code === "OVERLOADED") {
+            // Rate or subscription limit: bounded retry (one- then two-second backoff), then resync-required.
+            this.#localFailures++;
+            if (this.#localFailures >= LOCAL_SYNC_ATTEMPTS) {
+                this.#setState("resync-required", "OVERLOADED");
+                return;
+            }
+            this.#setState("stale", "OVERLOADED");
+            this.#retryTimer = setTimeout(() => {
+                this.#retryTimer = null;
+                if (this.#attached === connection && connection.connected && !this.#terminal)
+                    this.attach(connection);
+            }, 1_000 * 2 ** (this.#localFailures - 1));
+            return;
+        }
+        this.#terminate("failed", result.error.code, result.error);
+    }
+    #clearRetry() {
+        if (this.#retryTimer !== null) {
+            clearTimeout(this.#retryTimer);
+            this.#retryTimer = null;
+        }
+    }
+    #requestFreshSynchronization() {
+        const connection = this.#attached;
+        if (connection === null || !connection.connected)
+            return; // Reconnection resynchronizes.
+        if (!this.#serverKnows) {
+            if (this.#state === "authorizing")
+                return; // A subscribe is already in flight.
+            this.attach(connection);
+            return;
+        }
+        if (this.#state === "authorizing" || this.#state === "synchronizing")
+            return; // Joins the running synchronization.
+        this.#replacing = this.#epoch;
+        this.#awaitingEpoch = true;
+        this.#setState("authorizing");
+        connection.request(EVENTS.resync, { requestId: this.#owner.randomId(), subscriptionId: this.id }).then(result => {
+            if (connection !== this.#attached || this.#terminal || result.ok)
+                return;
+            this.#lastError = result.error;
+            this.#emitError(result.error);
+            if (result.error.code === "INVALID_REQUEST")
+                this.attach(connection); // The gateway no longer knows it.
+        }, (error) => {
+            if (connection === this.#attached && !this.#terminal && error.code === "TIMEOUT")
+                this.#owner.controlTimedOut(connection);
+        });
+    }
+    /** The SDK rejected a frame. Resynchronize, bounded per incident. */
+    #localSyncFailure(code, message) {
+        const error = streamError(code, { message, requestId: this.#owner.randomId() });
+        this.#lastError = error;
+        this.#emitError(error);
+        if (this.#terminal)
+            return;
+        this.#localFailures++;
+        if (this.#localFailures >= LOCAL_SYNC_ATTEMPTS) {
+            const connection = this.#attached;
+            if (this.#serverKnows && connection !== null && connection.connected)
+                void this.#sendUnsubscribe(connection);
+            this.#serverKnows = false;
+            this.#awaitingEpoch = true;
+            this.#setState("resync-required", "RESYNC_REQUIRED");
+            return;
+        }
+        this.#setState("stale", code);
+        this.#requestFreshSynchronization();
+    }
+    #sendUnsubscribe(connection) {
+        return new Promise(resolve => {
+            const timer = setTimeout(resolve, UNSUBSCRIBE_TIMEOUT_MS);
+            connection.request(EVENTS.unsubscribe, { requestId: this.#owner.randomId(), subscriptionId: this.id })
+                .then(() => undefined, () => undefined)
+                .finally(() => { clearTimeout(timer); resolve(); });
+        });
+    }
+    #terminate(state, reason, error) {
+        if (this.#terminal)
+            return;
+        this.#terminal = true;
+        this.#clearRetry();
+        this.#attached = null;
+        this.#owner.unregister(this);
+        this.#lastError = error;
+        this.#setState(state, reason, true);
+        this.#waiters.rejectAll(error);
+        this.#listeners.data.clear();
+        this.#listeners.state.clear();
+        this.#listeners.error.clear();
+    }
+    #setState(state, reason, force = false) {
+        if (this.#terminal && !force)
+            return;
+        if (this.#state === state && this.#reason === reason)
+            return;
+        this.#state = state;
+        this.#reason = reason;
+        const change = reason === undefined ? { state } : { state, reason };
+        for (const listener of [...this.#listeners.state]) {
+            if (!this.#invoke(listener, change))
+                return;
+        }
+        if (state === "live")
+            this.#waiters.resolveAll();
+        else if (state === "resync-required")
+            this.#waiters.rejectAll(streamError("RESYNC_REQUIRED"));
+    }
+    /** Runs a data/state listener. Failures become HANDLER_FAILED and fail the subscription. */
+    #invoke(listener, value) {
+        let returned;
+        try {
+            returned = listener(value);
+        }
+        catch (error) {
+            this.#listenerFailed(error);
+            return false;
+        }
+        if (isThenable(returned)) {
+            Promise.resolve(returned).catch((error) => this.#listenerFailed(error));
+        }
+        return true;
+    }
+    #listenerFailed(cause) {
+        if (this.#terminal)
+            return;
+        this.#owner.logListenerFailure(cause);
+        const error = streamError("HANDLER_FAILED", {
+            message: "A subscription listener threw; the subscription failed.",
+            requestId: this.#owner.randomId()
+        });
+        const connection = this.#attached;
+        const serverKnows = this.#serverKnows;
+        this.#emitError(error);
+        this.#terminate("failed", "HANDLER_FAILED", error);
+        if (serverKnows && connection !== null && connection.connected)
+            void this.#sendUnsubscribe(connection);
+    }
+    /** Error-listener failures are logged, never re-emitted. */
+    #emitError(error) {
+        for (const listener of [...this.#listeners.error]) {
+            try {
+                const returned = listener(error);
+                if (isThenable(returned))
+                    Promise.resolve(returned).catch((cause) => this.#owner.logListenerFailure(cause));
+            }
+            catch (cause) {
+                this.#owner.logListenerFailure(cause);
+            }
+        }
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/subscription.js.map

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

package/dist/waiters.d.ts

@@ -0,0 +1,13 @@
+import { type StreamError, type WaitOptions } from "@streamotter/contracts";
+/**
+ * A set of independent waiters. Each waiter has its own timeout and signal;
+ * cancelling one never affects the others or the operation they wait for.
+ */
+export declare class WaiterSet {
+    #private;
+    get size(): number;
+    wait(options: WaitOptions | undefined): Promise<void>;
+    resolveAll(): void;
+    rejectAll(error: StreamError): void;
+}
+//# sourceMappingURL=waiters.d.ts.map

package/dist/waiters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiters.d.ts","sourceRoot":"","sources":["../src/waiters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE5I;;;GAGG;AACH,qBAAa,SAAS;;IAGpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD,UAAU,IAAI,IAAI;IAIlB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAGpC"}

package/dist/waiters.js

@@ -0,0 +1,43 @@
+import { asStreamOtterError, DEFAULT_READY_TIMEOUT_MS, StreamOtterError } from "@streamotter/contracts";
+/**
+ * A set of independent waiters. Each waiter has its own timeout and signal;
+ * cancelling one never affects the others or the operation they wait for.
+ */
+export class WaiterSet {
+    #waiters = new Set();
+    get size() {
+        return this.#waiters.size;
+    }
+    wait(options) {
+        const timeoutMs = options?.timeoutMs ?? DEFAULT_READY_TIMEOUT_MS;
+        const signal = options?.signal;
+        if (signal?.aborted)
+            return Promise.reject(new StreamOtterError("CANCELLED"));
+        return new Promise((resolve, reject) => {
+            const cleanup = () => {
+                clearTimeout(timer);
+                signal?.removeEventListener("abort", onAbort);
+                this.#waiters.delete(waiter);
+            };
+            const waiter = {
+                resolve: () => { cleanup(); resolve(); },
+                reject: (error) => { cleanup(); reject(asStreamOtterError(error)); }
+            };
+            const onAbort = () => waiter.reject(new StreamOtterError("CANCELLED"));
+            const timer = setTimeout(() => waiter.reject(new StreamOtterError("TIMEOUT", {
+                message: `The subscription did not become live within ${timeoutMs} ms.`
+            })), timeoutMs);
+            signal?.addEventListener("abort", onAbort, { once: true });
+            this.#waiters.add(waiter);
+        });
+    }
+    resolveAll() {
+        for (const waiter of [...this.#waiters])
+            waiter.resolve();
+    }
+    rejectAll(error) {
+        for (const waiter of [...this.#waiters])
+            waiter.reject(error);
+    }
+}
+//# sourceMappingURL=waiters.js.map

package/dist/waiters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"waiters.js","sourceRoot":"","sources":["../src/waiters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,gBAAgB,EAAsC,MAAM,wBAAwB,CAAC;AAE5I;;;GAGG;AACH,MAAM,OAAO,SAAS;IACX,QAAQ,GAAG,IAAI,GAAG,EAAiE,CAAC;IAE7F,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC,OAAgC;QACnC,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,wBAAwB,CAAC;QACjE,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC/B,IAAI,MAAM,EAAE,OAAO;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC,CAAC;YACF,MAAM,MAAM,GAAG;gBACb,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACxC,MAAM,EAAE,CAAC,KAAkB,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;aAClF,CAAC;YACF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,SAAS,EAAE;gBAC3E,OAAO,EAAE,+CAA+C,SAAS,MAAM;aACxE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YAChB,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAC5D,CAAC;IAED,SAAS,CAAC,KAAkB;QAC1B,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;CACF"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@streamotter/client",
+  "version": "0.1.0-rc.1",
+  "description": "StreamOtter browser SDK: subscribe to state channels with authoritative snapshots, revision-ordered updates, and explicit live/stale states over Socket.IO.",
+  "keywords": [
+    "streamotter",
+    "kafka",
+    "socket.io",
+    "websocket",
+    "realtime",
+    "live-data",
+    "state-sync",
+    "browser",
+    "typescript"
+  ],
+  "homepage": "https://github.com/jfricano/StreamOtter/tree/main/packages/client#readme",
+  "bugs": {
+    "url": "https://github.com/jfricano/StreamOtter/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jfricano/StreamOtter.git",
+    "directory": "packages/client"
+  },
+  "license": "MIT",
+  "author": "Orca Solutions",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "socket.io-client": "4.8.3",
+    "@streamotter/contracts": "0.1.0-rc.1"
+  }
+}