@camera.ui/transport 0.0.30 → 0.1.0

package/dist/closeCodes-CltSRjdJ.js

@@ -0,0 +1,30 @@
+//#region src/transports/closeCodes.ts
+function classifyErrorCode(code) {
+	if (code === "insufficient_role" || code === "user_not_found") return "forbidden";
+	if (code === "invalid_token" || code === "unauthenticated" || code.startsWith("credentials_")) return "auth-expired";
+}
+function classifyClose(input) {
+	const obj = typeof input === "string" ? void 0 : input;
+	const code = obj?.wsCloseCode ?? obj?.code;
+	if (code === 4401) return "auth-expired";
+	if (code === 4403 || code === 4400) return "forbidden";
+	const errorCode = typeof obj?.data === "object" && obj.data !== null ? obj.data.code : void 0;
+	const byErrorCode = typeof errorCode === "string" ? classifyErrorCode(errorCode) : void 0;
+	if (byErrorCode) return byErrorCode;
+	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("unauthenticated") || text.includes("401")) return "auth-expired";
+	return "other";
+}
+function refusedByServer(input) {
+	if (typeof input !== "object" || input === null) return false;
+	const { wsCloseCode, code, data } = input;
+	return classifyClose({
+		wsCloseCode,
+		code,
+		data
+	}) === "forbidden";
+}
+//#endregion
+export { refusedByServer as n, classifyClose as t };

package/dist/core/types.d.ts

@@ -50,6 +50,7 @@ export type ConnectionPhase = {
     readonly lastError: string;
     readonly nextRetryAt: number;
     readonly backoffHint?: BackoffHint;
+    readonly pendingTokens?: Tokens;
 };
 export interface BackoffHint {
     readonly retryAfterMs: number;

package/dist/effects/backgroundProbe.d.ts

@@ -13,6 +13,7 @@ export interface BackgroundProbeOptions {
     readonly preferGraceMs?: number;
     readonly isCurrentHealthy?: () => boolean;
     readonly onResult?: (outcome: BackgroundProbeOutcome, detail?: string) => void;
+    readonly ready?: () => Promise<unknown>;
 }
 export interface BackgroundProbe {
     run(): Promise<BackgroundProbeOutcome>;

package/dist/effects/crossTab.d.ts

@@ -3,12 +3,18 @@ import { ConnectionTarget } from '../core/types.js';
 export type Detach = () => void;
 export interface CrossTabSource extends EventTarget {
 }
+export interface CrossTabPayload {
+    readonly endpoint?: ConnectionTarget['endpoint'];
+    readonly tokens: ConnectionTarget['tokens'];
+}
 export interface CrossTabOptions {
     readonly kernel: Kernel;
     readonly key?: string;
     readonly source?: CrossTabSource;
+    readonly accept?: (payload: CrossTabPayload, current: ConnectionTarget | null) => boolean;
     readonly absorb?: (target: ConnectionTarget | null) => void;
     readonly onTokensReceived?: (tokens: ConnectionTarget['tokens']) => void;
+    readonly onTokensIgnored?: (payload: CrossTabPayload) => void;
     readonly onResetReceived?: () => void;
     readonly onError?: (op: 'parse', err: unknown) => void;
 }

package/dist/effects/degradedRecovery.d.ts

@@ -8,6 +8,7 @@ export interface DegradedRecoveryOptions {
     readonly ensureAll: () => void;
     readonly probe: () => Promise<BackgroundProbeOutcome>;
     readonly graceMs?: number;
+    readonly maxBackoffMs?: number;
     readonly isReachable?: () => boolean;
     readonly onEscalate?: (round: number) => void;
     readonly onOffline?: (reason: string) => void;

package/dist/effects/persistence.d.ts

@@ -14,6 +14,7 @@ export interface PersistedTarget {
 }
 export interface Persistence {
     readonly detach: Detach;
+    readonly ready: Promise<void>;
     peek(): ConnectionTarget | null;
     seed(target: ConnectionTarget): Promise<void>;
     absorb(target: ConnectionTarget | null): void;
@@ -26,6 +27,7 @@ export interface PersistenceOptions {
     readonly onPersist?: (target: ConnectionTarget) => void;
     readonly onClear?: () => void;
     readonly onError?: (op: 'get' | 'set' | 'del' | 'parse', err: unknown) => void;
+    readonly readyTimeoutMs?: number;
 }
 export declare function attachPersistence(options: PersistenceOptions): Persistence;
 export declare function localStorageAdapter(scope?: Storage): StorageAdapter;

package/dist/effects/probeLoop.d.ts

@@ -28,5 +28,6 @@ export interface ProbeLoopOptions {
     readonly onProbeError?: (endpoint: Endpoint, err: unknown) => void;
     readonly onAllFailed?: (reason: string) => void;
     readonly lastTarget?: () => ConnectionTarget | null;
+    readonly ready?: () => Promise<unknown>;
 }
 export declare function attachProbeLoop(options: ProbeLoopOptions): Detach;

package/dist/effects/tokenLifecycle.d.ts

@@ -9,13 +9,17 @@ export interface TokenLifecycleOptions {
     readonly maxTransientRetries?: number;
     readonly transientRetryDelayMs?: number;
     readonly maxServerErrorRetries?: number;
+    readonly minRefreshIntervalMs?: number;
+    readonly reachableRetryDelaysMs?: readonly number[];
+    readonly lockTimeoutMs?: number;
     readonly refresh: (target: ConnectionTarget, reason: RefreshReason) => Promise<Tokens>;
     readonly isTransientError?: (err: unknown) => boolean;
     readonly isServerError?: (err: unknown) => boolean;
     readonly now?: () => number;
     readonly setTimer?: (cb: () => void, ms: number) => unknown;
     readonly clearTimer?: (handle: unknown) => void;
-    readonly acquireRefreshLock?: <T>(fn: () => Promise<T>) => Promise<T>;
+    readonly isReachable?: () => boolean;
+    readonly acquireRefreshLock?: <T>(fn: () => Promise<T>, signal?: AbortSignal) => Promise<T>;
     readonly getLatestTokens?: () => Tokens | null;
     readonly onRefreshStart?: (reason: RefreshReason) => void;
     readonly onRefreshSuccess?: (reason: RefreshReason, tokens: Tokens) => void;
@@ -28,11 +32,11 @@ export interface TokenLifecycleOptions {
     }) => void;
     readonly onScheduled?: (delayMs: number, expiresAt: number) => void;
     readonly onWakeChecked?: (info: {
-        decision: 'refresh-now' | 'still-fresh' | 'no-target' | 'no-expiry';
+        decision: 'refresh-now' | 'still-fresh' | 'throttled' | 'no-target' | 'no-expiry';
         remainingMs?: number;
         phase: string;
     }) => void;
-    readonly onTriggerSkipped?: (reason: RefreshReason, why: 'detached' | 'already-inflight' | 'no-target', phase: string) => void;
+    readonly onTriggerSkipped?: (reason: RefreshReason, why: 'detached' | 'already-inflight' | 'no-target' | 'throttled', phase: string) => void;
 }
 export type Detach = () => void;
 export interface TokenLifecycle {
@@ -40,3 +44,4 @@ export interface TokenLifecycle {
     readonly wake: () => void;
 }
 export declare function attachTokenLifecycle(options: TokenLifecycleOptions): TokenLifecycle;
+export declare function localAccessExpiry(access: string, serverExpiresAt?: number, receivedAt?: number): number | undefined;

package/dist/effects/workerBridge.d.ts

@@ -20,5 +20,6 @@ export interface WorkerBridge {
     syncHost(host: WorkerHost): void;
     syncAll(): void;
     revalidateWorkers(): void;
+    forgetHost(host: WorkerHost): void;
 }
 export declare function attachWorkerBridge(options: WorkerBridgeOptions): WorkerBridge;

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export { attachNetworkChange } from './effects/networkChange.js';
 export { attachPersistence, localStorageAdapter, memoryStorageAdapter } from './effects/persistence.js';
 export { attachPresence } from './effects/presence.js';
 export { attachProbeLoop, isProbeFailure, makeProbeFailure } from './effects/probeLoop.js';
-export { attachTokenLifecycle } from './effects/tokenLifecycle.js';
+export { attachTokenLifecycle, localAccessExpiry } from './effects/tokenLifecycle.js';
 export { attachTransportSync } from './effects/transportSync.js';
 export { attachWorkerBridge } from './effects/workerBridge.js';
 export { createConnectionJournal } from './journal.js';
@@ -20,7 +20,7 @@ export type { Kernel, KernelOptions, Listener, Unsubscribe } from './core/kernel
 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 { CrossTabOptions, CrossTabPayload, 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';