@camera.ui/transport 0.0.21 → 0.0.22

package/dist/closeCodes-ClWJVOpq.js

@@ -0,0 +1,14 @@
+//#region src/transports/closeCodes.ts
+function classifyClose(input) {
+	const obj = typeof input === "string" ? void 0 : input;
+	const code = obj?.wsCloseCode ?? obj?.code;
+	if (code === 4401 || code === 1008) return "auth-expired";
+	if (code === 4403 || code === 4400) return "forbidden";
+	const text = (typeof input === "string" ? input : obj?.reason ?? obj?.message ?? "").toLowerCase();
+	if (!text) return "other";
+	if (text.includes("forbidden") || text.includes("403")) return "forbidden";
+	if (text.includes("unauthorized") || text.includes("401") || text.includes("auth")) return "auth-expired";
+	return "other";
+}
+//#endregion
+export { classifyClose as t };

package/dist/{contract-d-0gfY8v.js → contract-dt1m8U-o.js}

@@ -12,11 +12,6 @@ function isEndpointChange(a, b) {
 	if (!a || !b) return true;
 	return a.endpoint.url !== b.endpoint.url || a.endpoint.mode !== b.endpoint.mode;
 }
-function isTokenOnlyChange(a, b) {
-	if (!a || !b) return false;
-	if (isEndpointChange(a, b)) return false;
-	return !isSameTarget(a, b);
-}
 var TransportEmitter = class {
 	listeners = /* @__PURE__ */ new Map();
 	on(event, handler) {
@@ -40,4 +35,4 @@ var TransportEmitter = class {
 	}
 };
 //#endregion
-export { isTokenOnlyChange as i, isEndpointChange as n, isSameTarget as r, TransportEmitter as t };
+export { isEndpointChange as n, isSameTarget as r, TransportEmitter as t };

package/dist/core/kernel.d.ts

@@ -4,6 +4,7 @@ export type Unsubscribe = () => void;
 export interface KernelOptions {
     readonly context: ReducerContext;
     readonly initial?: ConnectionPhase;
+    readonly onAction?: (action: Action, prev: ConnectionPhase, next: ConnectionPhase) => void;
 }
 export interface Kernel {
     readonly phase: ConnectionPhase;

package/dist/core/types.d.ts

@@ -24,33 +24,22 @@ export interface TransportSpec {
     readonly id: TransportId;
     readonly kind: TransportKind;
     readonly phaseGating: boolean;
-    readonly graceMs?: number;
 }
 export interface TransportStatus {
     readonly up: boolean;
     readonly lastError?: string;
     readonly downSince?: number;
 }
-export type ReconnectCause = 'transport-down' | 'auth-error' | 'network-change' | 'user-retry' | 'endpoint-swap';
 export type ConnectionPhase = {
     readonly kind: 'idle';
 } | {
     readonly kind: 'discovering';
     readonly instanceId: string;
-    readonly attempt: number;
-    readonly transports?: ReadonlyMap<TransportId, TransportStatus>;
+    readonly pendingTokens?: Tokens;
 } | {
     readonly kind: 'online';
     readonly instanceId: string;
     readonly target: ConnectionTarget;
-    readonly transports: ReadonlyMap<TransportId, TransportStatus>;
-} | {
-    readonly kind: 'reconnecting';
-    readonly instanceId: string;
-    readonly lastTarget: ConnectionTarget | null;
-    readonly cause: ReconnectCause;
-    readonly since: number;
-    readonly transports: ReadonlyMap<TransportId, TransportStatus>;
 } | {
     readonly kind: 'needs-auth';
     readonly instanceId: string | null;
@@ -77,16 +66,6 @@ export type Action = {
 } | {
     readonly type: 'PROBE_FAILED_ALL';
     readonly error: string;
-} | {
-    readonly type: 'TRANSPORT_UP';
-    readonly id: TransportId;
-} | {
-    readonly type: 'TRANSPORT_DOWN';
-    readonly id: TransportId;
-    readonly reason: string;
-} | {
-    readonly type: 'TRANSPORT_DOWN_CONFIRMED';
-    readonly id: TransportId;
 } | {
     readonly type: 'TOKENS_REFRESHED';
     readonly tokens: Tokens;
@@ -102,9 +81,11 @@ export type Action = {
     readonly type: 'BACKOFF_HINT';
     readonly retryAfterMs: number;
     readonly source?: string;
+} | {
+    readonly type: 'ENDPOINT_SWAP';
+    readonly endpoint: Endpoint;
+    readonly tokens: Tokens;
 };
 export interface ReducerContext {
-    readonly specs: ReadonlyMap<TransportId, TransportSpec>;
     readonly now: () => number;
-    readonly retryBackoffMs?: (attempt: number) => number;
 }

package/dist/effects/backgroundProbe.d.ts

@@ -0,0 +1,20 @@
+import { Kernel } from '../core/kernel.js';
+import { ConnectionTarget, Endpoint, Tokens } from '../core/types.js';
+import { TimeoutByModeFn } from '../race.js';
+import { ProbeContext } from './probeLoop.js';
+export type BackgroundProbeOutcome = 'swap' | 'same' | 'failed' | 'skipped';
+export interface BackgroundProbeOptions {
+    readonly kernel: Kernel;
+    readonly discover: (signal: AbortSignal) => Promise<readonly Endpoint[]>;
+    readonly probe: (ctx: ProbeContext) => Promise<Tokens>;
+    readonly lastTarget?: () => ConnectionTarget | null;
+    readonly timeoutByMode?: TimeoutByModeFn;
+    readonly prefer?: (endpoint: Endpoint) => boolean;
+    readonly preferGraceMs?: number;
+    readonly onResult?: (outcome: BackgroundProbeOutcome, detail?: string) => void;
+}
+export interface BackgroundProbe {
+    run(): Promise<BackgroundProbeOutcome>;
+    dispose(): void;
+}
+export declare function createBackgroundProbe(options: BackgroundProbeOptions): BackgroundProbe;

package/dist/effects/degradedRecovery.d.ts

@@ -0,0 +1,14 @@
+import { Kernel } from '../core/kernel.js';
+import { ConnectionSignalHandle } from '../signal.js';
+import { BackgroundProbeOutcome } from './backgroundProbe.js';
+export type Detach = () => void;
+export interface DegradedRecoveryOptions {
+    readonly kernel: Kernel;
+    readonly signal: ConnectionSignalHandle;
+    readonly ensureAll: () => void;
+    readonly probe: () => Promise<BackgroundProbeOutcome>;
+    readonly graceMs?: number;
+    readonly onEscalate?: (round: number) => void;
+    readonly onOffline?: (reason: string) => void;
+}
+export declare function attachDegradedRecovery(options: DegradedRecoveryOptions): Detach;

package/dist/effects/probeLoop.d.ts

@@ -15,9 +15,11 @@ export interface ProbeContext {
 }
 export interface ProbeLoopOptions {
     readonly kernel: Kernel;
+    readonly preferGraceMs?: number;
     readonly discover: (signal: AbortSignal) => Promise<readonly Endpoint[]>;
     readonly probe: (ctx: ProbeContext) => Promise<Tokens>;
     readonly timeoutByMode?: TimeoutByModeFn;
+    readonly prefer?: (endpoint: Endpoint) => boolean;
     readonly onDiscoverStart?: () => void;
     readonly onDiscoverSuccess?: (pool: readonly Endpoint[]) => void;
     readonly onDiscoverError?: (err: unknown) => void;

package/dist/effects/transportSync.d.ts

@@ -5,7 +5,9 @@ export type Detach = () => void;
 export interface TransportSyncOptions {
     readonly kernel: Kernel;
     readonly transports: readonly Transport[];
+    readonly retryMs?: number;
     readonly onError?: (transport: Transport, target: ConnectionTarget | null, error: unknown) => void;
+    readonly onRetry?: (transport: Transport, target: ConnectionTarget | null) => void;
     readonly onApplied?: (target: ConnectionTarget | null) => void;
 }
 export declare function attachTransportSync(options: TransportSyncOptions): Detach;

package/dist/index.d.ts

@@ -1,32 +1,37 @@
 export { createKernel } from './core/kernel.js';
 export { reducer } from './core/reducer.js';
-export { endpointKey, isSameEndpoint, sortByPriority } from './core/resolver.js';
+export { createBackgroundProbe } from './effects/backgroundProbe.js';
 export { attachBackoff } from './effects/backoff.js';
 export { attachCrossTab } from './effects/crossTab.js';
+export { attachDegradedRecovery } from './effects/degradedRecovery.js';
 export { attachNetworkChange } from './effects/networkChange.js';
 export { attachPersistence, localStorageAdapter, memoryStorageAdapter } from './effects/persistence.js';
-export { attachPresence, defaultOnNetworkOnline } from './effects/presence.js';
+export { attachPresence } from './effects/presence.js';
 export { attachProbeLoop, isProbeFailure, makeProbeFailure } from './effects/probeLoop.js';
-export { attachReconnectWatchdog } from './effects/reconnectWatchdog.js';
 export { attachTokenLifecycle } from './effects/tokenLifecycle.js';
 export { attachTransportSync } from './effects/transportSync.js';
-export { attachTransportWatchdog } from './effects/transportWatchdog.js';
 export { attachWorkerBridge } from './effects/workerBridge.js';
-export { DEFAULT_RACE_TIMEOUT_BY_MODE, raceFirst, RaceFirstError } from './race.js';
-export { isEndpointChange, isSameTarget, isTokenOnlyChange, TransportEmitter } from './transports/contract.js';
-export type { Action, BackoffHint, ConnectionPhase, ConnectionTarget, Endpoint, EndpointMode, ReconnectCause, ReducerContext, Tokens, TransportId, TransportKind, TransportSpec, TransportStatus, } from './core/types.js';
+export { createConnectionJournal } from './journal.js';
+export { raceFirst } from './race.js';
+export { createConnectionSignal } from './signal.js';
+export { classifyClose } from './transports/closeCodes.js';
+export { isEndpointChange, isSameTarget, TransportEmitter } from './transports/contract.js';
 export type { Kernel, KernelOptions, Listener, Unsubscribe } from './core/kernel.js';
+export type { Action, BackoffHint, ConnectionPhase, ConnectionTarget, Endpoint, EndpointMode, ReducerContext, Tokens, TransportId, TransportKind, TransportSpec, TransportStatus, } from './core/types.js';
+export type { BackgroundProbe, BackgroundProbeOptions, BackgroundProbeOutcome } from './effects/backgroundProbe.js';
 export type { BackoffOptions } from './effects/backoff.js';
 export type { CrossTabOptions, CrossTabSource } from './effects/crossTab.js';
+export type { DegradedRecoveryOptions } from './effects/degradedRecovery.js';
 export type { NetworkChangeOptions, NetworkChangeSource } from './effects/networkChange.js';
 export type { PersistedTarget, Persistence, PersistenceOptions, StorageAdapter } from './effects/persistence.js';
 export type { PresenceCallback, PresenceOptions, VisibilitySource } from './effects/presence.js';
 export type { ProbeContext, ProbeFailure, ProbeFailureKind, ProbeLoopOptions } from './effects/probeLoop.js';
-export type { ReconnectWatchdogOptions } from './effects/reconnectWatchdog.js';
 export type { Detach, RefreshReason, TokenLifecycle, TokenLifecycleOptions } from './effects/tokenLifecycle.js';
 export type { TransportSyncOptions } from './effects/transportSync.js';
-export type { TransportWatchdogOptions, WatchdogClearReason } from './effects/transportWatchdog.js';
 export type { WorkerBridge, WorkerBridgeOptions } from './effects/workerBridge.js';
+export type { ConnectionJournal, JournalEntry, JournalOptions } from './journal.js';
 export type { RaceCandidate, RaceFirstOptions, RaceFirstResult, TimeoutByModeFn } from './race.js';
-export type { KernelSyncMessage, KernelSyncRequestMessage, MessageSource, WorkerHost, WorkerMessage } from './worker/protocol.js';
+export type { ConnectionSignal, ConnectionSignalHandle, ConnectionSignalOptions } from './signal.js';
+export type { CloseClass, CloseLike } from './transports/closeCodes.js';
 export type { PerResourceTransport, Transport, TransportEvent, TransportEventHandler, TransportEventPayload } from './transports/contract.js';
+export type { KernelSyncMessage, KernelSyncRequestMessage, MessageSource, WorkerHost, WorkerMessage } from './worker/protocol.js';