@streamotter/gateway 0.1.0-rc.1

package/dist/runtime/subscription.d.ts

@@ -0,0 +1,65 @@
+import { type ErrorCode, type Params, type Revision, type StreamEvent, type SubscriptionState } from "@streamotter/contracts";
+import { SubscriptionBudget } from "./budget.ts";
+import { type ChannelRuntime, type GatewayCore, type SubscriptionHost } from "./core.ts";
+/** A full-state frame waiting in a subscription's buffer or send queue. */
+export interface PendingFrame {
+    readonly event: StreamEvent;
+    readonly bytes: number;
+    readonly revision: Revision;
+    readonly dataHash: string;
+}
+/** Envelope overhead added to serialized events when estimating frame bytes. */
+export declare const FRAME_OVERHEAD_BYTES = 128;
+export type AdmitResult = "queued" | "filtered" | "overflow" | "inactive";
+/**
+ * Server side of one subscription. Implements the V1 synchronization sequence:
+ * authorize → require source → capture → snapshot → recheck → send snapshot →
+ * receipt → drain buffered newer states → live. Each attempt is a new epoch;
+ * invalidation discards the previous generation's frames and handler results.
+ */
+export declare class ServerSubscription {
+    #private;
+    readonly id: string;
+    readonly channel: ChannelRuntime;
+    readonly params: Params;
+    readonly canonicalParams: string;
+    readonly routingKey: string;
+    readonly contractKey: string;
+    readonly budget: SubscriptionBudget;
+    constructor(options: {
+        id: string;
+        channel: ChannelRuntime;
+        params: Params;
+        canonicalParams: string;
+        host: SubscriptionHost;
+        core: GatewayCore;
+    });
+    get state(): SubscriptionState;
+    get phase(): string;
+    get epoch(): string;
+    get terminated(): boolean;
+    get capturing(): boolean;
+    start(requestId: string): void;
+    /**
+     * Client-requested resynchronization. Coalesces with a synchronization that has
+     * not yet sent its snapshot (the client will still see a new epoch). Once the
+     * client has seen this epoch's frames, a request starts a new epoch.
+     */
+    requestResync(requestId: string): void;
+    onSourceUnavailable(reason: ErrorCode): void;
+    onSourceReady(): void;
+    /** Terminal failure: discards pending data and removes the subscription. */
+    fail(code: ErrorCode, requestId: string, message?: string): void;
+    /** Silent teardown for unsubscribe or connection closure. */
+    dispose(): void;
+    /** True when admitting this state would conflict with the current state at the same revision. */
+    conflicts(revision: Revision, dataHash: string): boolean;
+    /**
+     * Admits a mapped full state and records the queue outcome under the record's
+     * request ID (before any resulting send). Never waits: overflow invalidates this
+     * generation instead.
+     */
+    admit(frame: PendingFrame, requestId: string): AdmitResult;
+    onReceipt(epoch: string, sequence: number): void;
+}
+//# sourceMappingURL=subscription.d.ts.map

package/dist/runtime/subscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../src/runtime/subscription.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EACrF,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAGrG,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAgB1E;;;;;GAKG;AACH,qBAAa,kBAAkB;;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;gBAoBxB,OAAO,EAAE;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,cAAc,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,IAAI,EAAE,gBAAgB,CAAC;QACvB,IAAI,EAAE,WAAW,CAAC;KACnB;IAaD,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAK9B;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAiBtC,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAiB5C,aAAa,IAAI,IAAI;IAIrB,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAchE,6DAA6D;IAC7D,OAAO,IAAI,IAAI;IAQf,iGAAiG;IACjG,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKxD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW;IAkB1D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAiUjD"}

package/dist/runtime/subscription.js

@@ -0,0 +1,482 @@
+import { compareRevisions, isJsonValue, isPlainObject, isRevision, streamError, validateValue } from "@streamotter/contracts";
+import { SubscriptionBudget } from "./budget.js";
+import { routingKey } from "./core.js";
+import { describeError, invokeHandler, newId, nowIso, sha256Hex } from "./util.js";
+/** Envelope overhead added to serialized events when estimating frame bytes. */
+export const FRAME_OVERHEAD_BYTES = 128;
+const CAPTURING = new Set(["capturing", "snapshot-sent", "draining", "live"]);
+/**
+ * Server side of one subscription. Implements the V1 synchronization sequence:
+ * authorize → require source → capture → snapshot → recheck → send snapshot →
+ * receipt → drain buffered newer states → live. Each attempt is a new epoch;
+ * invalidation discards the previous generation's frames and handler results.
+ */
+export class ServerSubscription {
+    id;
+    channel;
+    params;
+    canonicalParams;
+    routingKey;
+    contractKey;
+    budget;
+    #host;
+    #core;
+    #phase = "idle";
+    #publicState = "idle";
+    #epoch = "";
+    #sequence = 0;
+    #generation = 0;
+    #controller = new AbortController();
+    #attempts = 0;
+    #retryTimer = null;
+    #queue = [];
+    #inFlight = null;
+    #receiptTimer = null;
+    #drainRemaining = 0;
+    #snapshotRevision = null;
+    #tail = null;
+    #lastDelivered = null;
+    constructor(options) {
+        this.id = options.id;
+        this.channel = options.channel;
+        this.params = options.params;
+        this.canonicalParams = options.canonicalParams;
+        this.#host = options.host;
+        this.#core = options.core;
+        this.routingKey = routingKey(this.channel.name, this.channel.version, this.#host.principal.tenantId, this.canonicalParams);
+        this.contractKey = JSON.stringify([this.channel.name, this.channel.version, this.canonicalParams]);
+        const { limits } = this.#core;
+        this.budget = new SubscriptionBudget(limits.maxPendingFramesPerSubscription, limits.maxPendingBytesPerSubscription, this.#host.connectionBudget);
+    }
+    get state() {
+        return this.#publicState;
+    }
+    get phase() {
+        return this.#phase;
+    }
+    get epoch() {
+        return this.#epoch;
+    }
+    get terminated() {
+        return this.#phase === "terminated";
+    }
+    get capturing() {
+        return CAPTURING.has(this.#phase);
+    }
+    start(requestId) {
+        this.channel.subscriptions.add(this);
+        void this.#beginAttempt(false, requestId);
+    }
+    /**
+     * Client-requested resynchronization. Coalesces with a synchronization that has
+     * not yet sent its snapshot (the client will still see a new epoch). Once the
+     * client has seen this epoch's frames, a request starts a new epoch.
+     */
+    requestResync(requestId) {
+        switch (this.#phase) {
+            case "backoff":
+            case "snapshot-sent":
+            case "draining":
+                void this.#beginAttempt(true, requestId);
+                return;
+            case "live":
+            case "resync-required":
+                this.#attempts = 0;
+                void this.#beginAttempt(true, requestId);
+                return;
+            default:
+                return;
+        }
+    }
+    onSourceUnavailable(reason) {
+        switch (this.#phase) {
+            case "authorizing":
+            case "capturing":
+            case "snapshot-sent":
+            case "draining":
+            case "live":
+            case "backoff":
+                this.#invalidate();
+                this.#phase = "waiting-source";
+                this.#sendState("stale", reason);
+                return;
+            default:
+                return;
+        }
+    }
+    onSourceReady() {
+        if (this.#phase === "waiting-source")
+            void this.#beginAttempt(true, newId());
+    }
+    /** Terminal failure: discards pending data and removes the subscription. */
+    fail(code, requestId, message) {
+        if (this.#phase === "terminated")
+            return;
+        this.#invalidate();
+        this.#phase = "terminated";
+        this.channel.subscriptions.delete(this);
+        this.#host.sendError({
+            subscriptionId: this.id,
+            epoch: this.#epoch,
+            error: streamError(code, message === undefined ? { requestId } : { requestId, message })
+        });
+        this.#sendState("failed", code);
+        this.#host.removeSubscription(this.id);
+    }
+    /** Silent teardown for unsubscribe or connection closure. */
+    dispose() {
+        if (this.#phase === "terminated")
+            return;
+        this.#invalidate();
+        this.#phase = "terminated";
+        this.#publicState = "closed";
+        this.channel.subscriptions.delete(this);
+    }
+    /** True when admitting this state would conflict with the current state at the same revision. */
+    conflicts(revision, dataHash) {
+        if (!this.capturing || this.#tail === null)
+            return false;
+        return this.#tail.revision === revision && this.#tail.dataHash !== dataHash;
+    }
+    /**
+     * Admits a mapped full state and records the queue outcome under the record's
+     * request ID (before any resulting send). Never waits: overflow invalidates this
+     * generation instead.
+     */
+    admit(frame, requestId) {
+        if (!this.capturing)
+            return "inactive";
+        if (this.#tail !== null && compareRevisions(frame.revision, this.#tail.revision) <= 0) {
+            this.#trace("queue", "filtered", undefined, requestId);
+            return "filtered";
+        }
+        if (!this.budget.tryReserve(frame.bytes)) {
+            this.#trace("queue", "rejected", "OVERLOADED", requestId);
+            this.#attemptFailed("OVERLOADED", newId());
+            return "overflow";
+        }
+        this.#trace("queue", "ok", undefined, requestId);
+        this.#queue.push(frame);
+        this.#tail = { revision: frame.revision, dataHash: frame.dataHash };
+        this.#pump();
+        return "queued";
+    }
+    onReceipt(epoch, sequence) {
+        if (epoch !== this.#epoch || !this.capturing)
+            return;
+        const inFlight = this.#inFlight;
+        if (inFlight === null || sequence < inFlight.sequence) {
+            if (sequence <= this.#sequence)
+                return; // Duplicate receipts are harmless.
+            this.#protocolViolation("A receipt was received for a frame that was not sent.");
+            return;
+        }
+        if (sequence > inFlight.sequence) {
+            this.#protocolViolation("A receipt skipped an unacknowledged frame.");
+            return;
+        }
+        this.#clearReceiptTimer();
+        this.budget.release(inFlight.bytes);
+        this.#inFlight = null;
+        if (this.#lastDelivered === null || compareRevisions(inFlight.revision, this.#lastDelivered) > 0) {
+            this.#lastDelivered = inFlight.revision;
+        }
+        this.#trace("receipt", "ok");
+        if (this.#phase === "snapshot-sent") {
+            const boundary = this.#snapshotRevision ?? "0";
+            const kept = [];
+            for (const frame of this.#queue) {
+                if (compareRevisions(frame.revision, boundary) <= 0) {
+                    this.budget.release(frame.bytes);
+                    this.#trace("queue", "filtered");
+                }
+                else {
+                    kept.push(frame);
+                }
+            }
+            this.#queue = kept;
+            this.#drainRemaining = kept.length;
+            this.#phase = "draining";
+            if (this.#drainRemaining === 0)
+                this.#goLive();
+            else
+                this.#pump();
+            return;
+        }
+        if (this.#phase === "draining") {
+            this.#drainRemaining--;
+            if (this.#drainRemaining <= 0) {
+                this.#goLive();
+                return;
+            }
+        }
+        this.#pump();
+    }
+    // --- synchronization attempts -------------------------------------------------
+    async #beginAttempt(announce, requestId) {
+        const generation = this.#invalidate();
+        const signal = this.#controller.signal;
+        this.#attempts++;
+        this.#phase = "authorizing";
+        if (announce)
+            this.#sendState("authorizing");
+        else
+            this.#publicState = "authorizing";
+        if (!(await this.#authorize(generation, signal, requestId)))
+            return;
+        if (!this.channel.source.ready) {
+            this.#attempts--; // Waiting for a source does not consume an attempt.
+            this.#phase = "waiting-source";
+            this.#sendState("stale", this.channel.source.reason ?? "SOURCE_UNAVAILABLE");
+            return;
+        }
+        this.#epoch = newId();
+        this.#sequence = 0;
+        this.#sendState("synchronizing");
+        this.#phase = "capturing";
+        this.#core.router.add(this);
+        const { limits } = this.#core;
+        const deadline = Date.now() + limits.snapshotTimeoutMs;
+        const acquired = await this.#core.snapshots.acquire(signal, deadline);
+        if (generation !== this.#generation) {
+            if (acquired)
+                this.#core.snapshots.release();
+            return;
+        }
+        if (!acquired) {
+            this.#trace("snapshot", "failed", "TIMEOUT");
+            this.#attemptFailed("TIMEOUT", requestId);
+            return;
+        }
+        const principal = this.#host.principal;
+        const handlers = this.channel.handlers;
+        let outcome;
+        try {
+            outcome = await invokeHandler(context => handlers.snapshot({ ...context, principal, params: this.params }), { timeoutMs: Math.max(1, deadline - Date.now()), requestId, parent: signal });
+        }
+        finally {
+            this.#core.snapshots.release();
+        }
+        if (generation !== this.#generation || outcome.kind === "aborted")
+            return;
+        if (outcome.kind === "timeout") {
+            this.#trace("snapshot", "failed", "TIMEOUT");
+            this.#attemptFailed("TIMEOUT", requestId);
+            return;
+        }
+        if (outcome.kind === "error") {
+            this.#trace("snapshot", "failed", "HANDLER_FAILED");
+            this.#core.logger.warn("Snapshot handler failed", { channel: this.channel.name, requestId, error: describeError(outcome.error) });
+            this.fail("HANDLER_FAILED", requestId);
+            return;
+        }
+        const snapshot = outcome.value;
+        const problem = this.#snapshotProblem(snapshot);
+        if (problem !== null) {
+            this.#trace("snapshot", "rejected", "INVALID_PAYLOAD");
+            this.#core.logger.warn("Snapshot rejected", { channel: this.channel.name, requestId, reason: problem });
+            this.fail("INVALID_PAYLOAD", requestId);
+            return;
+        }
+        const { revision, data } = snapshot;
+        if (this.#lastDelivered !== null && compareRevisions(revision, this.#lastDelivered) < 0) {
+            this.#trace("snapshot", "rejected", "INVALID_PAYLOAD");
+            this.#core.logger.warn("Snapshot regressed below delivered state", { channel: this.channel.name, requestId });
+            this.#attemptFailed("INVALID_PAYLOAD", requestId);
+            return;
+        }
+        this.#trace("snapshot", "ok");
+        // Recheck authorization and token validity immediately before delivery.
+        if (!(await this.#authorize(generation, signal, requestId)))
+            return;
+        const event = {
+            id: newId(),
+            channel: this.channel.name,
+            channelVersion: this.channel.version,
+            kind: "snapshot",
+            data,
+            revision,
+            receivedAt: nowIso()
+        };
+        const bytes = Buffer.byteLength(JSON.stringify(event)) + FRAME_OVERHEAD_BYTES;
+        if (bytes > limits.maxDataFrameBytes) {
+            this.#trace("snapshot", "rejected", "INVALID_PAYLOAD");
+            this.#core.logger.warn("Snapshot exceeds maxDataFrameBytes", { channel: this.channel.name, requestId, bytes });
+            this.fail("INVALID_PAYLOAD", requestId);
+            return;
+        }
+        if (!this.budget.tryReserve(bytes)) {
+            this.#trace("queue", "rejected", "OVERLOADED");
+            this.#attemptFailed("OVERLOADED", requestId);
+            return;
+        }
+        const dataHash = sha256Hex(data);
+        this.#snapshotRevision = revision;
+        if (this.#tail === null || compareRevisions(revision, this.#tail.revision) >= 0) {
+            this.#tail = { revision, dataHash };
+        }
+        this.#phase = "snapshot-sent";
+        this.#transmit({ event, bytes, revision, dataHash });
+    }
+    async #authorize(generation, signal, requestId) {
+        const revocationSeq = this.#core.revocations.sequence;
+        const principal = this.#host.principal;
+        const outcome = await invokeHandler(context => this.channel.handlers.authorize({ ...context, principal, params: this.params }), { timeoutMs: this.#core.limits.handlerTimeoutMs, requestId, parent: signal });
+        if (generation !== this.#generation || outcome.kind === "aborted")
+            return false;
+        if (outcome.kind === "timeout") {
+            this.#trace("authorize", "failed", "TIMEOUT");
+            this.#attemptFailed("TIMEOUT", requestId);
+            return false;
+        }
+        if (outcome.kind === "error") {
+            this.#trace("authorize", "failed", "HANDLER_FAILED");
+            this.#core.logger.warn("Authorize handler failed", { channel: this.channel.name, requestId, error: describeError(outcome.error) });
+            this.fail("HANDLER_FAILED", requestId);
+            return false;
+        }
+        if (outcome.value !== true) {
+            this.#trace("authorize", "rejected", "FORBIDDEN");
+            this.fail("FORBIDDEN", requestId);
+            return false;
+        }
+        if (!this.#host.canDeliver())
+            return false;
+        const channel = { name: this.channel.name, version: this.channel.version, canonicalParams: this.canonicalParams };
+        if (this.#core.revocations.revokedSince(revocationSeq, principal, channel)) {
+            this.#trace("authorize", "rejected", "FORBIDDEN");
+            this.fail("FORBIDDEN", requestId);
+            return false;
+        }
+        this.#trace("authorize", "ok");
+        return true;
+    }
+    #snapshotProblem(snapshot) {
+        if (!isPlainObject(snapshot))
+            return "snapshot must return an object";
+        for (const key of Object.keys(snapshot)) {
+            if (key !== "revision" && key !== "data")
+                return `unexpected snapshot field "${key}"`;
+        }
+        if (!isRevision(snapshot["revision"]))
+            return "revision must be a canonical unsigned decimal string";
+        if (!isJsonValue(snapshot["data"]))
+            return "data must be JSON";
+        const issue = validateValue(this.channel.payloadSchema, snapshot["data"]);
+        return issue === null ? null : `data ${issue.path}: ${issue.message}`;
+    }
+    /** A failed attempt: stale, then bounded retry with one- then two-second backoff. */
+    #attemptFailed(code, requestId) {
+        const generation = this.#invalidate();
+        this.#phase = "backoff";
+        this.#sendState("stale", code);
+        if (this.#attempts >= this.#core.limits.maxSyncAttempts) {
+            this.#phase = "resync-required";
+            this.#host.sendError({ subscriptionId: this.id, epoch: this.#epoch, error: streamError("RESYNC_REQUIRED", { requestId }) });
+            this.#sendState("resync-required", "RESYNC_REQUIRED");
+            return;
+        }
+        const delay = this.#attempts === 0 ? 0 : 1_000 * 2 ** (this.#attempts - 1);
+        this.#retryTimer = setTimeout(() => {
+            this.#retryTimer = null;
+            if (generation === this.#generation && this.#phase === "backoff")
+                void this.#beginAttempt(true, newId());
+        }, delay);
+    }
+    /** Interrupts an active generation (overflow, protocol violation) and resynchronizes. */
+    #interrupt(code) {
+        this.#trace("queue", "rejected", code);
+        this.#attemptFailed(code, newId());
+    }
+    #protocolViolation(message) {
+        this.#host.sendError({
+            subscriptionId: this.id,
+            epoch: this.#epoch,
+            error: streamError("INVALID_REQUEST", { message, requestId: newId() })
+        });
+        this.#interrupt("INVALID_REQUEST");
+    }
+    #goLive() {
+        this.#phase = "live";
+        this.#attempts = 0;
+        this.#sendState("live");
+        this.#pump();
+    }
+    // --- delivery ------------------------------------------------------------------
+    #pump() {
+        if (this.#inFlight !== null)
+            return;
+        if (this.#phase !== "draining" && this.#phase !== "live")
+            return;
+        const next = this.#queue.shift();
+        if (next !== undefined)
+            this.#transmit(next);
+    }
+    #transmit(frame) {
+        if (!this.#host.canDeliver()) {
+            this.budget.release(frame.bytes);
+            return;
+        }
+        if (this.#sequence >= Number.MAX_SAFE_INTEGER - 1) {
+            this.budget.release(frame.bytes);
+            this.#interrupt("OVERLOADED");
+            return;
+        }
+        this.#sequence++;
+        this.#inFlight = { ...frame, sequence: this.#sequence };
+        this.#host.sendData({ subscriptionId: this.id, epoch: this.#epoch, sequence: this.#sequence, event: frame.event });
+        this.#trace("send", "ok");
+        this.#receiptTimer = setTimeout(() => {
+            this.#receiptTimer = null;
+            this.#trace("receipt", "failed", "OVERLOADED");
+            this.#host.receiptTimedOut();
+        }, this.#core.limits.receiptTimeoutMs);
+    }
+    #clearReceiptTimer() {
+        if (this.#receiptTimer !== null) {
+            clearTimeout(this.#receiptTimer);
+            this.#receiptTimer = null;
+        }
+    }
+    /** Starts a new generation: aborts handlers, drops frames, and leaves the routing index. */
+    #invalidate() {
+        this.#generation++;
+        this.#controller.abort();
+        this.#controller = new AbortController();
+        if (this.#retryTimer !== null) {
+            clearTimeout(this.#retryTimer);
+            this.#retryTimer = null;
+        }
+        this.#clearReceiptTimer();
+        for (const frame of this.#queue)
+            this.budget.release(frame.bytes);
+        this.#queue = [];
+        if (this.#inFlight !== null) {
+            this.budget.release(this.#inFlight.bytes);
+            this.#inFlight = null;
+        }
+        this.#drainRemaining = 0;
+        this.#snapshotRevision = null;
+        this.#tail = null;
+        this.#core.router.remove(this);
+        return this.#generation;
+    }
+    #sendState(state, reason) {
+        this.#publicState = state;
+        this.#host.sendState(reason === undefined
+            ? { subscriptionId: this.id, epoch: this.#epoch, state }
+            : { subscriptionId: this.id, epoch: this.#epoch, state, reason });
+    }
+    #trace(stage, outcome, errorCode, requestId) {
+        this.#core.traces.record({
+            requestId: requestId ?? (this.#epoch || this.id),
+            stage,
+            outcome,
+            sourceId: this.channel.source.id,
+            channel: this.channel.name,
+            subscriptionId: this.id,
+            ...(errorCode === undefined ? {} : { errorCode })
+        });
+    }
+}
+//# sourceMappingURL=subscription.js.map

package/dist/runtime/subscription.js.map

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

package/dist/runtime/traces.d.ts

@@ -0,0 +1,26 @@
+import { type Page, type Trace } from "@streamotter/contracts";
+export type TraceInput = Omit<Trace, "id" | "at">;
+export interface TraceQuery {
+    limit: number;
+    cursor?: string;
+    sourceId?: string;
+    channel?: string;
+    outcome?: Trace["outcome"];
+}
+/**
+ * Bounded in-memory trace metadata. Never stores payloads or credentials. Cursors
+ * are ephemeral positions scoped to this gateway run, not data-recovery cursors.
+ */
+export declare class TraceBuffer {
+    #private;
+    constructor(maxEntries: number, maxBytes: number);
+    record(input: TraceInput): void;
+    get size(): number;
+    /**
+     * Without a cursor, returns the newest `limit` matching traces (oldest first).
+     * With a cursor, returns up to `limit` matching traces recorded after it.
+     * nextCursor continues after the last examined trace, so callers can poll.
+     */
+    page(query: TraceQuery): Page<Trace>;
+}
+//# sourceMappingURL=traces.d.ts.map

package/dist/runtime/traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../src/runtime/traces.ts"],"names":[],"mappings":"AACA,OAAO,EAAoC,KAAK,IAAI,EAAE,KAAK,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAKjG,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;AAClD,MAAM,WAAW,UAAU;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;CAAE;AAE/H;;;GAGG;AACH,qBAAa,WAAW;;gBASV,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAKhD,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAkB/B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAmBD;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC;CA8BrC"}