@opinionated-machine/sse-fallback 0.1.1

package/dist/bindingTypes.d.ts

@@ -0,0 +1,327 @@
+/**
+ * Type layer for fallback bindings.
+ *
+ * Everything here is type-only or plain data — the package has no runtime
+ * dependencies. Zod and @lokalise/api-contracts appear as type-only imports
+ * (optional peers); runtime introspection of contracts is structural.
+ */
+import type { z } from 'zod/v4';
+/** A comparable version: a monotonic number or a comparable string. */
+export type Version = number | string;
+/**
+ * Declares how versions are extracted and ordered.
+ *
+ * The version is the correctness backbone of the fallback pattern: a single
+ * "deliver iff newer than the high-watermark" rule handles duplicate delivery
+ * (SSE + poll of the same update), the stale-poll race (a slow poll response
+ * arriving after a newer pushed event), and replay overlap after reconnect.
+ */
+export type VersionConfig<Snapshot, Event> = {
+    /** Extract the version from a poll snapshot body. */
+    ofSnapshot: (snapshot: Snapshot) => Version;
+    /**
+     * Extract the version from a delivered event. The default reads the SSE
+     * `id:`, accepting a bare integer (`"42"`) or the
+     * `"<numeric epoch>-<counter>"` shape produced by the server-side
+     * `createEventIdSequence()`; ids in any other shape (e.g. UUIDs) carry
+     * no version. Return `undefined` for events that carry no version —
+     * they are delivered without advancing the watermark (at-least-once).
+     */
+    ofEvent?: (event: Event) => Version | undefined;
+    /** Custom comparator. Defaults to numeric, falling back to lexicographic. */
+    compare?: (a: Version, b: Version) => number;
+    /**
+     * Versions are consecutive integers per subscription scope. Enables
+     * client-side gap detection (seq N then N+2 → a repair poll is issued
+     * immediately instead of waiting for the deadman timer).
+     * @default false
+     */
+    dense?: boolean;
+}
+/**
+ * Versionless mode: at-least-once, last-writer-wins. No dedup between
+ * channels beyond subscription termination, no gap detection, and the
+ * state layer is limited to full snapshot replacement. An adoption bridge
+ * for backends without versions — strongly prefer declaring versions.
+ */
+ | 'none';
+/** Maps event name → parsed payload type. */
+export type EventPayloadMap = Record<string, unknown>;
+/** An event as delivered to app code, regardless of the channel it used. */
+export type FallbackEvent<Events extends EventPayloadMap = EventPayloadMap> = {
+    [K in keyof Events & string]: {
+        event: K;
+        data: Events[K];
+        /** SSE id when the event arrived over the stream. */
+        id?: string;
+        /**
+         * Which channel produced the event. Present for observability — app
+         * logic SHOULD ignore it; channel transparency is the whole point.
+         */
+        origin: FallbackEventOrigin;
+    };
+}[keyof Events & string];
+export type FallbackEventOrigin = 'sse' | 'poll';
+/** An event synthesized from a snapshot by `snapshotToEvents`. */
+export type SyntheticEvent<Events extends EventPayloadMap = EventPayloadMap> = {
+    [K in keyof Events & string]: {
+        event: K;
+        data: Events[K];
+    };
+}[keyof Events & string];
+/**
+ * Reconciliation + policy declaration for one dual-mode (or bound-pair)
+ * subscription. This is the one thing the framework cannot infer: how a REST
+ * snapshot relates to the SSE events. Everything downstream of this
+ * declaration — racing, canceling, dedup, reconnect, degradation — is
+ * transparent to app code.
+ */
+export type FallbackBindingConfig<Snapshot, Events extends EventPayloadMap, State = undefined> = {
+    /**
+     * Translate a poll snapshot into zero or more events, making poll results
+     * indistinguishable from pushed events for app code. Must be PURE — a
+     * function of the snapshot alone. Return `[]` when the snapshot carries no
+     * news (e.g. a job still pending); the poll still advances the watermark.
+     *
+     * Exactly one of `snapshotToEvents` / `snapshotEvent` is required.
+     */
+    snapshotToEvents?: (snapshot: Snapshot) => ReadonlyArray<SyntheticEvent<Events>>;
+    /**
+     * Shorthand for the common case where the JSON snapshot body IS the
+     * payload of one state-carrying event: expands to
+     * `snapshotToEvents: (s) => [{ event: snapshotEvent, data: s }]`.
+     */
+    snapshotEvent?: keyof Events & string;
+    /** Version extraction/ordering, or `'none'` (see {@link VersionConfig}). */
+    version: VersionConfig<Snapshot, FallbackEvent<Events>>;
+    /**
+     * Events whose delivery completes the subscription (use case: await async
+     * completion). Timers are cancelled, in-flight requests aborted, and
+     * `events()` iterators complete.
+     */
+    terminalEvents?: ReadonlyArray<keyof Events & string>;
+    /**
+     * Optional state layer (use case: initial load + hydration). When present,
+     * the subscription handle exposes `getState()` / `onStateChange()`.
+     * Snapshots REPLACE state via `init`; live events update it via `apply`.
+     * Events synthesized from a snapshot are not applied (the snapshot already
+     * subsumes them).
+     */
+    state?: {
+        init: (snapshot: Snapshot) => State;
+        apply: (state: State, event: FallbackEvent<Events>) => State;
+        /**
+         * On gap detection (dense versions): suppress `apply` until the next
+         * snapshot re-initializes state, so deltas are never applied out of
+         * order. Events still flow to event listeners.
+         * @default true
+         */
+        reinitOnGap?: boolean;
+    };
+    /**
+     * Whether the server's Last-Event-ID replay is complete ('trusted') —
+     * skipping the reconciliation poll after a reconnect — or best-effort
+     * ('untrusted', default) — always polling after the stream reopens.
+     * @default 'untrusted'
+     */
+    replay?: 'trusted' | 'untrusted';
+    /** Per-binding policy defaults; overridable per subscription. */
+    policy?: Partial<FallbackPolicy>;
+};
+export type BackoffConfig = {
+    baseMs: number;
+    factor: number;
+    maxMs: number;
+};
+/**
+ * A hard ceiling on how long a subscription may keep working before it gives
+ * up. Unset by default: a live-state subscription is supposed to run for as
+ * long as the surface is open.
+ *
+ * Set it for pending-completion subscriptions. Every individual wait in this
+ * package is bounded, but the subscription as a whole is not: a backend stuck
+ * in a pending state deadman-polls forever (backing off to
+ * `deadmanIdleBackoff.maxMs`, never giving up), so a permanently pending
+ * operation polls until the tab closes. With a budget the subscription stops
+ * with a `'budget-exhausted'` reason, which is what a UI needs to show an
+ * actionable error and offer a manual retry.
+ */
+export type SubscriptionBudget = {
+    /** Wall-clock ceiling, measured from subscription creation. */
+    maxDurationMs?: number;
+    /** Ceiling on snapshot polls attempted, successful or not. */
+    maxPolls?: number;
+};
+export type FallbackPolicy = {
+    /**
+     * Which channels the subscription uses:
+     * - `'dual'` (default): SSE as the low-latency channel, polls as the
+     *   correctness backbone, degrading to polling after repeated connect
+     *   failures.
+     * - `'poll-only'`: never open a stream at all. The subscription starts in
+     *   `'polling'` and runs the degraded cadence
+     *   (`degradedPollIntervalMs`) from the first tick.
+     *
+     * `'poll-only'` exists so a backend can adopt this package BEFORE it has an
+     * SSE endpoint: the binding, the version gate, the reconciler and the state
+     * machine are the same ones the streaming rollout will use, so turning the
+     * stream on later is a config change on an already-integrated subscription
+     * rather than a second migration. Without it, poll-only delivery is only
+     * reachable after `degradedAfterFailures` connect failures against an
+     * endpoint that must already exist.
+     * @default 'dual'
+     */
+    mode: 'dual' | 'poll-only';
+    /**
+     * Overall ceiling for the subscription — see {@link SubscriptionBudget}.
+     * Unset by default.
+     */
+    subscriptionBudget?: SubscriptionBudget;
+    /**
+     * Initial snapshot poll behavior:
+     * - `'eager'` (default): fetch a snapshot as soon as the stream opens
+     *   (hydration; also closes the startup race where the awaited activity
+     *   completed before the stream was established).
+     * - `'delayed'`: no initial poll; the first poll happens when the deadman
+     *   timer fires.
+     * - `'none'`: same as 'delayed' (kept distinct for future use).
+     */
+    initialPoll: 'eager' | 'delayed' | 'none';
+    /**
+     * Deadman delay: how long after the last DELIVERED EVENT before a
+     * reconciliation poll fires. Heartbeats do not count, and neither do
+     * duplicates below the watermark: both prove transport liveness, not
+     * delivery.
+     */
+    deadmanDelayMs: number;
+    /**
+     * Consecutive no-news polls stretch the deadman interval, and delivered
+     * events do NOT shrink it back: a stream that keeps delivering is proving
+     * it needs less reconciliation, not more. Only a poll that finds something
+     * the stream missed resets the interval to {@link deadmanDelayMs}.
+     */
+    deadmanIdleBackoff: {
+        factor: number;
+        maxMs: number;
+    };
+    /**
+     * Force-close the stream when NO BYTES (events, comments, heartbeats)
+     * arrive within this window — catches silently dead connections.
+     * `'off'` disables byte-level liveness (rely on the deadman alone).
+     */
+    staleConnectionTimeoutMs: number | 'off';
+    /**
+     * Abort a stream connect that has not produced response headers within this
+     * window, so a hung connect is counted as a connect failure (backoff,
+     * degradation) instead of stalling the subscription indefinitely.
+     * `'off'` waits forever — only safe with a transport that times out itself.
+     */
+    connectTimeoutMs: number | 'off';
+    /**
+     * Abort a snapshot poll that has not settled within this window. Without a
+     * bound, one never-settling poll would hold the in-flight latch and leave
+     * the deadman unarmed — disabling the correctness backbone entirely.
+     * `'off'` waits forever — only safe with a transport that times out itself.
+     */
+    pollTimeoutMs: number | 'off';
+    /** Backoff (full jitter) for failed polls. */
+    pollFailureBackoff: BackoffConfig;
+    /** Backoff (full jitter) for SSE reconnect attempts; `retry:` hints override the base. */
+    sseRetryBackoff: BackoffConfig;
+    /**
+     * Bounds applied to a server-sent `retry:` reconnection hint. The hint is
+     * attacker- or bug-reachable input: `retry: 0` would spin a zero-delay
+     * reconnect loop and a very large value would park reconnection for hours,
+     * so it is clamped into this range rather than used verbatim.
+     */
+    serverRetryHintBounds: {
+        minMs: number;
+        maxMs: number;
+    };
+    /**
+     * Consecutive snapshot-poll failures after which subscribe-first hydration
+     * is abandoned: the buffered live events are flushed to the application and
+     * the stream resumes delivering directly. Without this, an endpoint that
+     * keeps failing its snapshot poll would hold the hydration buffer open and
+     * a perfectly healthy stream would deliver nothing.
+     */
+    hydrationAbandonAfterFailures: number;
+    /** Consecutive SSE connect failures before degrading to POLLING_ONLY. */
+    degradedAfterFailures: number;
+    /** Poll cadence while degraded (SSE unavailable). */
+    degradedPollIntervalMs: number;
+    /** Cap for background SSE retry while degraded. */
+    degradedSseRetryMaxMs: number;
+    /** Max events buffered during hydration; overflow drops the buffer and refetches. */
+    hydrationBufferLimit: number;
+    /**
+     * HTTP statuses on the stream or poll that stop the subscription instead
+     * of retrying (auth/authz/not-found are not transient).
+     */
+    unretryableStatuses: ReadonlyArray<number>;
+    /**
+     * Statuses that are offered to `onAuthChallenge` before the subscription
+     * gives up on them. Only meaningful for statuses that are also in
+     * {@link unretryableStatuses}.
+     *
+     * In a SPA a 401 is usually an expired token rather than a genuinely
+     * unauthorized caller, and this package exists to recover without a page
+     * reload. With an `onAuthChallenge` hook configured, the first auth refusal
+     * on either channel is handed to the application, which refreshes
+     * credentials and lets the request run once more; a second refusal without
+     * an intervening success stops the subscription.
+     * @default [401]
+     */
+    authChallengeStatuses: ReadonlyArray<number>;
+};
+export declare const DEFAULT_POLICY: FallbackPolicy;
+/**
+ * Preset for use case A — await async completion.
+ *
+ * Set `subscriptionBudget` on top of this for operations that must not poll
+ * forever if the backend never leaves its pending state.
+ */
+export declare const COMPLETION_POLICY: FallbackPolicy;
+/** Preset for use case B — initial state load + live hydration. */
+export declare const LIVE_STATE_POLICY: FallbackPolicy;
+/**
+ * Preset for adopters with no SSE endpoint yet: same binding, version gate and
+ * state machine as the dual-mode presets, polling only. Flip `mode` back to
+ * `'dual'` once the stream exists.
+ */
+export declare const POLL_ONLY_POLICY: FallbackPolicy;
+type SseBodyLike<TSchemas> = {
+    readonly _tag: 'SseBody';
+    readonly schemaByEventName: TSchemas;
+};
+type EventsFromSchemaMap<TSchemas> = {
+    [K in keyof TSchemas]: TSchemas[K] extends z.ZodType ? z.output<TSchemas[K]> : never;
+};
+type SseEventsOfContentMap<TContent> = {
+    [K in keyof TContent]: TContent[K] extends SseBodyLike<infer TSchemas> ? EventsFromSchemaMap<TSchemas> : never;
+}[keyof TContent];
+type NonSseBodyOfContentMap<TContent> = {
+    [K in keyof TContent]: TContent[K] extends SseBodyLike<unknown> ? never : TContent[K] extends z.ZodType ? z.output<TContent[K]> : never;
+}[keyof TContent];
+type SuccessStatusKey = 200 | 201 | 202 | 203 | 206 | 207 | 208 | 226;
+type SuccessEntries<TContract> = TContract extends {
+    responsesByStatusCode: infer TResponses;
+} ? TResponses[Extract<keyof TResponses, SuccessStatusKey>] : never;
+/** Event payload map inferred from a `defineApiContract` contract's sseBody. */
+export type InferContractEvents<TContract> = Extract<SuccessEntries<TContract> extends infer TEntry ? TEntry extends {
+    content: infer TContent;
+} ? SseEventsOfContentMap<TContent> : never : never, EventPayloadMap>;
+/** Snapshot (non-SSE JSON success body) inferred from a `defineApiContract` contract. */
+export type InferContractSnapshot<TContract> = SuccessEntries<TContract> extends infer TEntry ? TEntry extends {
+    content: infer TContent;
+} ? NonSseBodyOfContentMap<TContent> : TEntry extends z.ZodType ? z.output<TEntry> : never : never;
+/** Event payload map inferred from a legacy `buildSseContract` dual-mode contract. */
+export type InferLegacyEvents<TContract> = TContract extends {
+    serverSentEventSchemas: infer TSchemas;
+} ? EventsFromSchemaMap<TSchemas> : never;
+/** Snapshot inferred from a legacy dual-mode contract's success schema. */
+export type InferLegacySnapshot<TContract> = TContract extends {
+    successResponseBodySchema: infer TSchema;
+} ? TSchema extends z.ZodType ? z.output<TSchema> : never : never;
+export {};
+//# sourceMappingURL=bindingTypes.d.ts.map

package/dist/bindingTypes.d.ts.map

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

package/dist/bindingTypes.js

@@ -0,0 +1,43 @@
+export const DEFAULT_POLICY = {
+    mode: 'dual',
+    initialPoll: 'eager',
+    deadmanDelayMs: 10_000,
+    deadmanIdleBackoff: { factor: 1.5, maxMs: 60_000 },
+    staleConnectionTimeoutMs: 60_000,
+    connectTimeoutMs: 15_000,
+    pollTimeoutMs: 10_000,
+    pollFailureBackoff: { baseMs: 1_000, factor: 2, maxMs: 30_000 },
+    sseRetryBackoff: { baseMs: 1_000, factor: 2, maxMs: 30_000 },
+    serverRetryHintBounds: { minMs: 250, maxMs: 60_000 },
+    hydrationAbandonAfterFailures: 3,
+    degradedAfterFailures: 3,
+    degradedPollIntervalMs: 15_000,
+    degradedSseRetryMaxMs: 60_000,
+    hydrationBufferLimit: 1_000,
+    unretryableStatuses: [401, 403, 404],
+    authChallengeStatuses: [401],
+};
+/**
+ * Preset for use case A — await async completion.
+ *
+ * Set `subscriptionBudget` on top of this for operations that must not poll
+ * forever if the backend never leaves its pending state.
+ */
+export const COMPLETION_POLICY = DEFAULT_POLICY;
+/** Preset for use case B — initial state load + live hydration. */
+export const LIVE_STATE_POLICY = {
+    ...DEFAULT_POLICY,
+    deadmanDelayMs: 120_000,
+    deadmanIdleBackoff: { factor: 1.5, maxMs: 300_000 },
+    degradedPollIntervalMs: 60_000,
+};
+/**
+ * Preset for adopters with no SSE endpoint yet: same binding, version gate and
+ * state machine as the dual-mode presets, polling only. Flip `mode` back to
+ * `'dual'` once the stream exists.
+ */
+export const POLL_ONLY_POLICY = {
+    ...DEFAULT_POLICY,
+    mode: 'poll-only',
+};
+//# sourceMappingURL=bindingTypes.js.map

package/dist/bindingTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindingTypes.js","sourceRoot":"","sources":["../src/bindingTypes.ts"],"names":[],"mappings":"AA4SA,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,OAAO;IACpB,cAAc,EAAE,MAAM;IACtB,kBAAkB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE;IAClD,wBAAwB,EAAE,MAAM;IAChC,gBAAgB,EAAE,MAAM;IACxB,aAAa,EAAE,MAAM;IACrB,kBAAkB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;IAC/D,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE;IAC5D,qBAAqB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE;IACpD,6BAA6B,EAAE,CAAC;IAChC,qBAAqB,EAAE,CAAC;IACxB,sBAAsB,EAAE,MAAM;IAC9B,qBAAqB,EAAE,MAAM;IAC7B,oBAAoB,EAAE,KAAK;IAC3B,mBAAmB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IACpC,qBAAqB,EAAE,CAAC,GAAG,CAAC;CAC7B,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAmB,cAAc,CAAA;AAE/D,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,GAAG,cAAc;IACjB,cAAc,EAAE,OAAO;IACvB,kBAAkB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE;IACnD,sBAAsB,EAAE,MAAM;CAC/B,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,GAAG,cAAc;IACjB,IAAI,EAAE,WAAW;CAClB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createSSEStreamParser, type ParsedSSEEvent, type ParseSSEBufferResult, type ParseSSEStreamOptions, parseSSEBuffer, parseSSEResponse, parseSSEStream, type SSEStreamParser, } from '@opinionated-machine/sse-parser';
+export { type BindFallbackContractsOptions, bindFallbackContracts, defineFallbackBinding, FALLBACK_BINDING_SYMBOL, type FallbackBinding, type FallbackRequestParams, fromLegacyDualModeContract, readFallbackBinding, } from './binding.ts';
+export { type BackoffConfig, COMPLETION_POLICY, DEFAULT_POLICY, type EventPayloadMap, type FallbackBindingConfig, type FallbackEvent, type FallbackEventOrigin, type FallbackPolicy, type InferContractEvents, type InferContractSnapshot, type InferLegacyEvents, type InferLegacySnapshot, LIVE_STATE_POLICY, POLL_ONLY_POLICY, type SubscriptionBudget, type SyntheticEvent, type Version, type VersionConfig, } from './bindingTypes.ts';
+export { createPollGate, type PollGate, type PollGateConfig } from './pollGate.ts';
+export { defaultCompareVersions, type EventOutcome, type IncomingEvent, type InvalidVersionInfo, Reconciler, type SnapshotOutcome, type VersionGap, } from './reconciler.ts';
+export { backoffDelay, ResettableTimer, sleep } from './scheduler.ts';
+export { type CreateResilientSubscriptionOptions, createResilientSubscription, type FallbackDiagnostics, type ResilientSubscription, type StopReason, type SubscriptionStatus, type SubscriptionStopDetail, SubscriptionStoppedError, } from './subscription.ts';
+export { type FallbackTransport, isParsedStreamResponse, type ParsedSseFrame, type ParsedStreamResponse, type RawStreamResponse, type SnapshotResponse, type StreamResponse, type TestSnapshotCall, type TestStreamHandle, TestTransport, type TransportRequest, } from './transport.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,KAAK,eAAe,GACrB,MAAM,iCAAiC,CAAA;AACxC,OAAO,EACL,KAAK,4BAA4B,EACjC,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EACL,KAAK,aAAa,EAClB,iBAAiB,EACjB,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,OAAO,EACZ,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAClF,OAAO,EACL,sBAAsB,EACtB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EACL,KAAK,kCAAkC,EACvC,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,KAAK,iBAAiB,EACtB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,aAAa,EACb,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Re-exported so a transport author does not have to add the parser package
+// as a second dependency to frame a stream by hand.
+export { createSSEStreamParser, parseSSEBuffer, parseSSEResponse, parseSSEStream, } from '@opinionated-machine/sse-parser';
+export { bindFallbackContracts, defineFallbackBinding, FALLBACK_BINDING_SYMBOL, fromLegacyDualModeContract, readFallbackBinding, } from "./binding.js";
+export { COMPLETION_POLICY, DEFAULT_POLICY, LIVE_STATE_POLICY, POLL_ONLY_POLICY, } from "./bindingTypes.js";
+export { createPollGate } from "./pollGate.js";
+export { defaultCompareVersions, Reconciler, } from "./reconciler.js";
+export { backoffDelay, ResettableTimer, sleep } from "./scheduler.js";
+export { createResilientSubscription, SubscriptionStoppedError, } from "./subscription.js";
+export { isParsedStreamResponse, TestTransport, } from "./transport.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,oDAAoD;AACpD,OAAO,EACL,qBAAqB,EAIrB,cAAc,EACd,gBAAgB,EAChB,cAAc,GAEf,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EAGvB,0BAA0B,EAC1B,mBAAmB,GACpB,MAAM,cAAc,CAAA;AACrB,OAAO,EAEL,iBAAiB,EACjB,cAAc,EAUd,iBAAiB,EACjB,gBAAgB,GAKjB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAsC,MAAM,eAAe,CAAA;AAClF,OAAO,EACL,sBAAsB,EAItB,UAAU,GAGX,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EAEL,2BAA2B,EAM3B,wBAAwB,GACzB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAEL,sBAAsB,EAQtB,aAAa,GAEd,MAAM,gBAAgB,CAAA"}

package/dist/pollGate.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Cross-subscription coordination for reconciliation polls.
+ *
+ * Each subscription jitters its own backoff, which spreads out ITS retries but
+ * says nothing about the other subscriptions in the same tab. After a server
+ * blip every live subscription reconnects at once and each fires its
+ * post-reconnect reconciliation poll, so an app running dozens of
+ * subscriptions turns one outage into a burst of dozens of simultaneous
+ * requests against one origin.
+ *
+ * A gate is shared by every subscription that should be capped together
+ * (normally one per origin). It bounds how many reconciliation polls run at
+ * the same time and, with `staggerMs`, spreads the release of queued polls
+ * over a window instead of letting them all start on the same tick.
+ *
+ * ```ts
+ * const gate = createPollGate({ maxConcurrent: 4, staggerMs: 2_000 })
+ * const sub = createResilientSubscription(binding, { transport, pollGate: gate })
+ * ```
+ *
+ * A gate delays polls; it never cancels them. A subscription waiting for a
+ * slot keeps its in-flight latch, so its deadman does not fire a second poll
+ * behind the first.
+ */
+export type PollGate = {
+    /**
+     * Wait for permission to run a reconciliation poll. Resolves with a release
+     * function that MUST be called when the poll settles.
+     *
+     * Rejects when `signal` aborts while waiting; nothing needs releasing then.
+     */
+    acquire(opts: {
+        signal: AbortSignal;
+    }): Promise<() => void>;
+};
+export type PollGateConfig = {
+    /**
+     * Maximum reconciliation polls in flight across every subscription sharing
+     * this gate.
+     * @default 6
+     */
+    maxConcurrent?: number;
+    /**
+     * Spread window. Each poll waits a uniformly random delay in
+     * `[0, staggerMs)` after taking a slot, so a fleet-wide reconnect does not
+     * put every request on the same tick.
+     * @default 0 (no stagger)
+     */
+    staggerMs?: number;
+    /** Injectable randomness for deterministic tests. */
+    random?: () => number;
+};
+/**
+ * Create a {@link PollGate}: a shared concurrency cap plus an optional
+ * randomized stagger for reconciliation polls.
+ */
+export declare function createPollGate(config?: PollGateConfig): PollGate;
+//# sourceMappingURL=pollGate.d.ts.map

package/dist/pollGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pollGate.d.ts","sourceRoot":"","sources":["../src/pollGate.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,QAAQ,GAAG;IACrB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAA;CAC5D,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;CACtB,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,cAAc,GAAG,QAAQ,CA4DhE"}

package/dist/pollGate.js

@@ -0,0 +1,64 @@
+import { sleep } from "./scheduler.js";
+/**
+ * Create a {@link PollGate}: a shared concurrency cap plus an optional
+ * randomized stagger for reconciliation polls.
+ */
+export function createPollGate(config) {
+    const maxConcurrent = Math.max(1, Math.floor(config?.maxConcurrent ?? 6));
+    const staggerMs = Math.max(0, config?.staggerMs ?? 0);
+    const random = config?.random ?? Math.random;
+    let active = 0;
+    const waiting = [];
+    const releaseSlot = () => {
+        // Hand the slot straight to the next waiter rather than decrementing and
+        // letting a fresh caller race in ahead of a subscription already queued.
+        const next = waiting.shift();
+        if (next) {
+            next();
+            return;
+        }
+        active -= 1;
+    };
+    const takeSlot = (signal) => {
+        if (active < maxConcurrent) {
+            active += 1;
+            return Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            const grant = () => {
+                signal.removeEventListener('abort', onAbort);
+                resolve();
+            };
+            const onAbort = () => {
+                const index = waiting.indexOf(grant);
+                if (index >= 0)
+                    waiting.splice(index, 1);
+                reject(new Error('Poll gate wait aborted'));
+            };
+            waiting.push(grant);
+            signal.addEventListener('abort', onAbort, { once: true });
+        });
+    };
+    return {
+        async acquire(opts) {
+            if (opts.signal.aborted)
+                throw new Error('Poll gate wait aborted');
+            await takeSlot(opts.signal);
+            if (staggerMs > 0) {
+                const proceeded = await sleep(Math.floor(random() * staggerMs), opts.signal);
+                if (!proceeded) {
+                    releaseSlot();
+                    throw new Error('Poll gate wait aborted');
+                }
+            }
+            let released = false;
+            return () => {
+                if (released)
+                    return;
+                released = true;
+                releaseSlot();
+            };
+        },
+    };
+}
+//# sourceMappingURL=pollGate.js.map

package/dist/pollGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pollGate.js","sourceRoot":"","sources":["../src/pollGate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAsDtC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAuB;IACpD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,aAAa,IAAI,CAAC,CAAC,CAAC,CAAA;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,IAAI,CAAC,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAA;IAE5C,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,MAAM,OAAO,GAAsB,EAAE,CAAA;IAErC,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,yEAAyE;QACzE,yEAAyE;QACzE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,EAAE,CAAA;QAC5B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,EAAE,CAAA;YACN,OAAM;QACR,CAAC;QACD,MAAM,IAAI,CAAC,CAAA;IACb,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,MAAmB,EAAiB,EAAE;QACtD,IAAI,MAAM,GAAG,aAAa,EAAE,CAAC;YAC3B,MAAM,IAAI,CAAC,CAAA;YACX,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;QACD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,GAAS,EAAE;gBACvB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;gBAC5C,OAAO,EAAE,CAAA;YACX,CAAC,CAAA;YACD,MAAM,OAAO,GAAG,GAAS,EAAE;gBACzB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBACpC,IAAI,KAAK,IAAI,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBACxC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAA;YAC7C,CAAC,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACnB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAA6B;YACzC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;YAClE,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YAE3B,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;gBAClB,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;gBAC5E,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,WAAW,EAAE,CAAA;oBACb,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;gBAC3C,CAAC;YACH,CAAC;YAED,IAAI,QAAQ,GAAG,KAAK,CAAA;YACpB,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ;oBAAE,OAAM;gBACpB,QAAQ,GAAG,IAAI,CAAA;gBACf,WAAW,EAAE,CAAA;YACf,CAAC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}