@fanfare-io/fanfare-sdk-core 0.1.0

package/dist/sync/protocol.d.ts

@@ -0,0 +1,254 @@
+/**
+ * Message protocol schemas and types for inter-tab coordination.
+ */
+import * as v from "valibot";
+declare const DurableBootstrapRequestMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"durable:bootstrap:request", undefined>;
+    readonly payload: v.ObjectSchema<{}, undefined>;
+}, undefined>], undefined>;
+declare const DurableBootstrapResponseMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"durable:bootstrap:response", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly session: v.UnknownSchema;
+        readonly sessionVersion: v.NumberSchema<undefined>;
+        readonly capabilityTokens: v.UnknownSchema;
+        readonly capabilityTokensVersion: v.NumberSchema<undefined>;
+        readonly distributionCapabilityIndex: v.UnknownSchema;
+        readonly distributionCapabilityIndexVersion: v.NumberSchema<undefined>;
+        readonly journeys: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+            readonly snapshot: v.UnknownSchema;
+            readonly version: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+declare const SessionUpdateMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"session:update", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly value: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+declare const CapabilityTokensUpdateMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"capability-tokens:update", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly value: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+declare const DistributionCapabilityIndexUpdateMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"distribution-capability-index:update", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly value: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+declare const JourneyUpsertMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"journey:upsert", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly experienceId: v.StringSchema<undefined>;
+        readonly snapshot: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+declare const JourneyRemoveMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"journey:remove", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly experienceId: v.StringSchema<undefined>;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+declare const RuntimeStateMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"runtime:state", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly experienceId: v.StringSchema<undefined>;
+        readonly sequenceId: v.StringSchema<undefined>;
+        readonly participationId: v.StringSchema<undefined>;
+        readonly participationType: v.PicklistSchema<["queue", "draw", "auction", "timed_release", "appointment"], undefined>;
+        readonly leaderId: v.StringSchema<undefined>;
+        readonly runtimeVersion: v.NumberSchema<undefined>;
+        readonly state: v.NullableSchema<v.UnknownSchema, undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+declare const HeartbeatMessageSchema: v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"heartbeat", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly active: v.BooleanSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>;
+export declare const SyncMessageSchema: v.UnionSchema<[v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"durable:bootstrap:request", undefined>;
+    readonly payload: v.ObjectSchema<{}, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"durable:bootstrap:response", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly session: v.UnknownSchema;
+        readonly sessionVersion: v.NumberSchema<undefined>;
+        readonly capabilityTokens: v.UnknownSchema;
+        readonly capabilityTokensVersion: v.NumberSchema<undefined>;
+        readonly distributionCapabilityIndex: v.UnknownSchema;
+        readonly distributionCapabilityIndexVersion: v.NumberSchema<undefined>;
+        readonly journeys: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+            readonly snapshot: v.UnknownSchema;
+            readonly version: v.NumberSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"session:update", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly value: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"capability-tokens:update", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly value: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"distribution-capability-index:update", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly value: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"journey:upsert", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly experienceId: v.StringSchema<undefined>;
+        readonly snapshot: v.UnknownSchema;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"journey:remove", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly experienceId: v.StringSchema<undefined>;
+        readonly version: v.NumberSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"runtime:state", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly experienceId: v.StringSchema<undefined>;
+        readonly sequenceId: v.StringSchema<undefined>;
+        readonly participationId: v.StringSchema<undefined>;
+        readonly participationType: v.PicklistSchema<["queue", "draw", "auction", "timed_release", "appointment"], undefined>;
+        readonly leaderId: v.StringSchema<undefined>;
+        readonly runtimeVersion: v.NumberSchema<undefined>;
+        readonly state: v.NullableSchema<v.UnknownSchema, undefined>;
+    }, undefined>;
+}, undefined>], undefined>, v.IntersectSchema<[v.ObjectSchema<{
+    readonly id: v.StringSchema<undefined>;
+    readonly timestamp: v.NumberSchema<undefined>;
+    readonly source: v.StringSchema<undefined>;
+    readonly version: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"heartbeat", undefined>;
+    readonly payload: v.ObjectSchema<{
+        readonly active: v.BooleanSchema<undefined>;
+    }, undefined>;
+}, undefined>], undefined>], undefined>;
+export type SyncMessage = v.InferOutput<typeof SyncMessageSchema>;
+export type DurableBootstrapRequestMessage = v.InferOutput<typeof DurableBootstrapRequestMessageSchema>;
+export type DurableBootstrapResponseMessage = v.InferOutput<typeof DurableBootstrapResponseMessageSchema>;
+export type SessionUpdateMessage = v.InferOutput<typeof SessionUpdateMessageSchema>;
+export type CapabilityTokensUpdateMessage = v.InferOutput<typeof CapabilityTokensUpdateMessageSchema>;
+export type DistributionCapabilityIndexUpdateMessage = v.InferOutput<typeof DistributionCapabilityIndexUpdateMessageSchema>;
+export type JourneyUpsertMessage = v.InferOutput<typeof JourneyUpsertMessageSchema>;
+export type JourneyRemoveMessage = v.InferOutput<typeof JourneyRemoveMessageSchema>;
+export type RuntimeStateMessage = v.InferOutput<typeof RuntimeStateMessageSchema>;
+export type HeartbeatMessage = v.InferOutput<typeof HeartbeatMessageSchema>;
+export declare function isDurableBootstrapRequestMessage(message: SyncMessage): message is DurableBootstrapRequestMessage;
+export declare function isDurableBootstrapResponseMessage(message: SyncMessage): message is DurableBootstrapResponseMessage;
+export declare function isSessionUpdateMessage(message: SyncMessage): message is SessionUpdateMessage;
+export declare function isCapabilityTokensUpdateMessage(message: SyncMessage): message is CapabilityTokensUpdateMessage;
+export declare function isDistributionCapabilityIndexUpdateMessage(message: SyncMessage): message is DistributionCapabilityIndexUpdateMessage;
+export declare function isJourneyUpsertMessage(message: SyncMessage): message is JourneyUpsertMessage;
+export declare function isJourneyRemoveMessage(message: SyncMessage): message is JourneyRemoveMessage;
+export declare function isRuntimeStateMessage(message: SyncMessage): message is RuntimeStateMessage;
+export declare function isHeartbeatMessage(message: SyncMessage): message is HeartbeatMessage;
+export declare const PROTOCOL_VERSION = 2;
+export declare const DEFAULT_CHANNEL_NAME = "fanfare-sdk-sync";
+export {};

package/dist/sync/protocol.js

@@ -0,0 +1 @@
+import*as e from"valibot";const t=e.object({id:e.string(),timestamp:e.number(),source:e.string(),version:e.number()}),n=e.intersect([t,e.object({type:e.literal("durable:bootstrap:request"),payload:e.object({})})]),r=e.object({snapshot:e.unknown(),version:e.number()}),i=e.intersect([t,e.object({type:e.literal("durable:bootstrap:response"),payload:e.object({session:e.unknown(),sessionVersion:e.number(),capabilityTokens:e.unknown(),capabilityTokensVersion:e.number(),distributionCapabilityIndex:e.unknown(),distributionCapabilityIndexVersion:e.number(),journeys:e.record(e.string(),r)})})]),o=e.intersect([t,e.object({type:e.literal("session:update"),payload:e.object({value:e.unknown(),version:e.number()})})]),a=e.intersect([t,e.object({type:e.literal("capability-tokens:update"),payload:e.object({value:e.unknown(),version:e.number()})})]),s=e.intersect([t,e.object({type:e.literal("distribution-capability-index:update"),payload:e.object({value:e.unknown(),version:e.number()})})]),u=e.intersect([t,e.object({type:e.literal("journey:upsert"),payload:e.object({experienceId:e.string(),snapshot:e.unknown(),version:e.number()})})]),p=e.intersect([t,e.object({type:e.literal("journey:remove"),payload:e.object({experienceId:e.string(),version:e.number()})})]),c=e.intersect([t,e.object({type:e.literal("runtime:state"),payload:e.object({experienceId:e.string(),sequenceId:e.string(),participationId:e.string(),participationType:e.picklist(["queue","draw","auction","timed_release","appointment"]),leaderId:e.string(),runtimeVersion:e.number(),state:e.nullable(e.unknown())})})]),b=e.intersect([t,e.object({type:e.literal("heartbeat"),payload:e.object({active:e.boolean()})})]),l=e.union([n,i,o,a,s,u,p,c,b]);function y(e){return"durable:bootstrap:request"===e.type}function d(e){return"durable:bootstrap:response"===e.type}function j(e){return"session:update"===e.type}function m(e){return"capability-tokens:update"===e.type}function k(e){return"distribution-capability-index:update"===e.type}function v(e){return"journey:upsert"===e.type}function f(e){return"journey:remove"===e.type}function w(e){return"runtime:state"===e.type}function g(e){return"heartbeat"===e.type}const x=2,I="fanfare-sdk-sync";export{I as DEFAULT_CHANNEL_NAME,x as PROTOCOL_VERSION,l as SyncMessageSchema,m as isCapabilityTokensUpdateMessage,k as isDistributionCapabilityIndexUpdateMessage,y as isDurableBootstrapRequestMessage,d as isDurableBootstrapResponseMessage,g as isHeartbeatMessage,f as isJourneyRemoveMessage,v as isJourneyUpsertMessage,w as isRuntimeStateMessage,j as isSessionUpdateMessage};

package/dist/sync/recovery.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Recovery management for sync failures and storage issues
+ *
+ * Handles storage quota errors, sync failures, and implements retry strategies
+ * with exponential backoff and update queuing to prevent race conditions.
+ */
+export interface RecoveryStrategy {
+    maxRetries?: number;
+    backoffMs?: number;
+    onRecoveryFailed?: (error: Error) => void;
+}
+export interface UpdateQueueItem<T> {
+    update: T;
+    timestamp: number;
+}
+export interface UpdateQueue<T> {
+    enqueue: (update: T) => void;
+    process: (handler: (update: T) => Promise<void>) => Promise<void>;
+    clear: () => void;
+    size: () => number;
+}
+/**
+ * Manages recovery from sync failures and storage issues
+ */
+export declare class RecoveryManager {
+    private logger;
+    private strategy;
+    constructor(strategy?: RecoveryStrategy);
+    /**
+     * Attempt to recover from storage quota errors
+     */
+    handleStorageQuotaError(): Promise<void>;
+    /**
+     * Recover from sync failures with retry
+     */
+    recoverSync(operation: () => Promise<void>): Promise<void>;
+    /**
+     * Handle race conditions by implementing a queue
+     */
+    createUpdateQueue<T>(): UpdateQueue<T>;
+    /**
+     * Check if localStorage is available and has space
+     */
+    checkStorageAvailability(): {
+        available: boolean;
+        estimatedSpace?: number;
+    };
+    /**
+     * Create a fallback for when sync is not available
+     */
+    createFallbackSync(): {
+        save: (key: string, value: unknown) => void;
+        load: (key: string) => unknown | null;
+    };
+    /**
+     * Monitor storage usage and warn when approaching limits
+     */
+    monitorStorageUsage(): Promise<{
+        used: number;
+        quota: number;
+        percentage: number;
+        warning: boolean;
+    }>;
+    /**
+     * Get current recovery strategy
+     */
+    getStrategy(): Required<RecoveryStrategy>;
+}

package/dist/sync/transport-factory.d.ts

@@ -0,0 +1,16 @@
+import { ITransport } from './transport-interface';
+/**
+ * Create the best available transport for the current environment
+ *
+ * @param channel - The channel name for cross-tab communication
+ * @returns A transport implementation or null if no transport is available
+ */
+export declare function createTransport(channel: string): ITransport | null;
+/**
+ * Get information about available transports
+ */
+export declare function getTransportInfo(): {
+    broadcastChannel: boolean;
+    localStorage: boolean;
+    available: boolean;
+};

package/dist/sync/transport-factory.js

@@ -0,0 +1 @@
+import{getLogger as r}from"../core/logger.js";import{isBroadcastChannelSupported as n,BroadcastChannelTransport as o}from"./broadcast-transport.js";import{isLocalStorageSupported as a,LocalStorageTransport as t}from"./localstorage-transport.js";function i(i){const l=r();if(n()){const r=new o(i);if(r.isAvailable())return l.info("Using BroadcastChannel transport",{channel:i}),r}if(a()){const r=new t(i);if(r.isAvailable())return l.info("Using localStorage transport (fallback)",{channel:i}),r}return l.warn("No transport available for inter-tab communication"),null}export{i as createTransport};

package/dist/sync/transport-interface.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Transport interface for inter-tab communication
+ *
+ * This interface defines the contract that all transport implementations
+ * must follow, allowing for different communication mechanisms while
+ * maintaining a consistent API.
+ */
+/**
+ * Generic transport interface for cross-tab communication
+ */
+export interface ITransport {
+    /**
+     * Send a message to other tabs
+     */
+    send(message: unknown): void;
+    /**
+     * Register a message listener
+     * @returns Unsubscribe function
+     */
+    onMessage(handler: (event: MessageEvent) => void): () => void;
+    /**
+     * Close the transport and clean up resources
+     */
+    close(): void;
+    /**
+     * Check if transport is available
+     */
+    isAvailable(): boolean;
+}
+/**
+ * Factory function type for creating transport instances
+ */
+export type TransportFactory = (channel: string) => ITransport;

package/dist/sync/transport.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Inter-tab transport layer with automatic fallback
+ *
+ * This module provides a unified abstraction for sending and receiving
+ * messages between tabs/windows using the best available transport mechanism:
+ * - BroadcastChannel API for modern browsers
+ * - localStorage with storage events for older browsers
+ */
+/**
+ * Inter-tab transport with automatic fallback
+ *
+ * Provides a simple interface for sending and receiving messages
+ * between tabs. Automatically selects the best available transport:
+ * 1. BroadcastChannel (preferred for modern browsers)
+ * 2. localStorage + storage events (fallback for older browsers)
+ */
+export declare class InterTabTransport {
+    private transport;
+    private listeners;
+    private unsubscribe?;
+    private logger;
+    private channelName;
+    constructor(channelName?: string);
+    /**
+     * Send a message to other tabs
+     */
+    send(message: unknown): void;
+    /**
+     * Register a message listener
+     * @returns Unsubscribe function
+     */
+    on(listener: (message: unknown) => void): () => void;
+    /**
+     * Close the transport and clean up resources
+     */
+    close(): void;
+    /**
+     * Check if transport is available
+     */
+    isAvailable(): boolean;
+    /**
+     * Get the number of registered listeners
+     */
+    getListenerCount(): number;
+    /**
+     * Handle incoming messages
+     */
+    private handleMessage;
+}

package/dist/sync/transport.js

@@ -0,0 +1 @@
+import{getLogger as s}from"../core/logger.js";import{createTransport as e}from"./transport-factory.js";class t{constructor(t="fanfare-sdk-sync"){this.transport=null,this.listeners=/* @__PURE__ */new Set,this.logger=s(),this.channelName=t,this.transport=e(t),this.transport?(this.unsubscribe=this.transport.onMessage(s=>{this.handleMessage(s.data)}),this.logger.debug("InterTabTransport initialized",{channelName:t,transportAvailable:this.transport.isAvailable()})):this.logger.debug("No transport available, inter-tab communication disabled")}send(s){if(this.transport)try{this.transport.send(s),this.logger.debug("Message sent via transport",{message:s})}catch(e){this.logger.warn("Failed to send message",{error:e,message:s})}else this.logger.debug("Transport not available, message not sent",{message:s})}on(s){return this.listeners.add(s),this.logger.debug("Transport listener added",{listenerCount:this.listeners.size}),()=>{this.listeners.delete(s),this.logger.debug("Transport listener removed",{listenerCount:this.listeners.size})}}close(){if(this.unsubscribe&&(this.unsubscribe(),this.unsubscribe=void 0),this.transport){try{this.transport.close(),this.logger.debug("Transport closed",{channelName:this.channelName})}catch(s){this.logger.warn("Error closing transport",{error:s})}this.transport=null}this.listeners.clear(),this.logger.debug("Transport closed and listeners cleared")}isAvailable(){return null!==this.transport&&this.transport.isAvailable()}getListenerCount(){return this.listeners.size}handleMessage(s){this.logger.debug("Message received via transport",{message:s,listenerCount:this.listeners.size}),this.listeners.forEach(e=>{try{e(s)}catch(t){this.logger.error("Error in transport listener",{error:t,message:s})}})}}export{t as InterTabTransport};

package/dist/test-utils/harness-scenarios.d.ts

@@ -0,0 +1,71 @@
+import { MockServer } from './mock-server';
+export type HarnessScenarioKey = "queue" | "waitlist-queue" | "auth-queue" | "access-code-queue" | "queue-denied" | "draw" | "draw-denied" | "timed-release" | "auction" | "auth-draw" | "admission-cycle";
+/**
+ * Optional fast-forward marker. When passed on a scenario input, the
+ * corresponding distribution mock primes its internal state so the SDK
+ * routes straight to the named stage instead of starting at the pre-entry
+ * stage. Stages that don't apply to a distribution are ignored.
+ *
+ * Currently supported per distribution:
+ * - queue: "start" (default), "granted"
+ * - draw: "start" (default), "granted"
+ * - auction: "start" (default), "granted"
+ * - timed-release: "start" (default), "granted"
+ */
+export type HarnessStage = "start" | "granted";
+export type HarnessScenarioDefinition = {
+    key: HarnessScenarioKey;
+    label: string;
+    experienceId: string;
+    sequenceId: string;
+    queueId?: string;
+    waitlistId?: string;
+    accessCode?: string;
+    drawId?: string;
+    timedReleaseId?: string;
+    auctionId?: string;
+    stage?: HarnessStage;
+};
+export type HarnessScenarioInput = HarnessScenarioKey | (Partial<HarnessScenarioDefinition> & {
+    key: HarnessScenarioKey;
+    stage?: HarnessStage;
+});
+export type HarnessRequestLog = {
+    api: ReturnType<MockServer["getRequests"]>;
+    beacon: ReturnType<MockServer["getRequests"]>;
+};
+export type InstalledHarnessMockServer = {
+    apiBaseUrl: string;
+    beaconBaseUrl: string;
+    /** Primary scenario (first scenario when multiple were installed). */
+    scenario: HarnessScenarioDefinition;
+    /** All scenarios installed on this server. Always at least one entry. */
+    scenarios: HarnessScenarioDefinition[];
+    stop: () => void;
+    getRequests: () => HarnessRequestLog;
+};
+export type InstallHarnessMockServerOptions = {
+    apiBaseUrl?: string;
+    beaconBaseUrl?: string;
+    defaultDelay?: number;
+    logRequests?: boolean;
+    otpCode?: string;
+    /**
+     * Single scenario to install. Mutually exclusive with `scenarios`.
+     * If both are absent, defaults to the "queue" scenario.
+     */
+    scenario?: HarnessScenarioInput;
+    /**
+     * Multiple scenarios to install on the same mock server. Each scenario's
+     * routes are added at their scenario-specific paths (different queueId /
+     * drawId / etc. per scenario). Lets one SDK instance render any of the
+     * installed experiences without spinning up multiple mock servers.
+     */
+    scenarios?: HarnessScenarioInput[];
+};
+export declare const DEFAULT_HARNESS_MOCK_API_BASE_URL = "http://mock.local/api";
+export declare const DEFAULT_HARNESS_MOCK_BEACON_BASE_URL = "http://mock.local/beacon";
+export declare const DEFAULT_TEST_OTP_CODE = "424242";
+export declare const HARNESS_SCENARIOS: Record<HarnessScenarioKey, HarnessScenarioDefinition>;
+export declare function normalizeHarnessScenario(input?: HarnessScenarioInput): HarnessScenarioDefinition;
+export declare function installHarnessMockServer(options?: InstallHarnessMockServerOptions): InstalledHarnessMockServer;

package/dist/test-utils/harness-scenarios.js

@@ -0,0 +1 @@
+import{isMoneyString as e,isMoneyGreaterThan as t,isMoneyGreaterThanOrEqualTo as n}from"../core/money.js";import{MockServer as s,ResponseBuilder as o}from"./mock-server.js";const a="http://mock.local/api",i="http://mock.local/beacon",u="424242";function r(e){const t={isEntered:!1,enteredAt:null};try{const n=window.localStorage.getItem(e);if(!n)return t;const s=JSON.parse(n);return{isEntered:!0===s.isEntered,enteredAt:"string"==typeof s.enteredAt?s.enteredAt:null}}catch{return t}}function d(e,t){window.localStorage.setItem(e,JSON.stringify(t))}const c={queue:{key:"queue",label:"Queue Journey",experienceId:"experience_queue_story_1",sequenceId:"sequence_queue_story_1",queueId:"queue_queue_story_1"},"waitlist-queue":{key:"waitlist-queue",label:"Waitlist to Queue Journey",experienceId:"experience_waitlist_queue_story_1",sequenceId:"sequence_waitlist_queue_story_1",queueId:"queue_waitlist_queue_story_1",waitlistId:"waitlist_waitlist_queue_story_1"},"auth-queue":{key:"auth-queue",label:"Auth-Gated Queue Journey",experienceId:"experience_auth_queue_story_1",sequenceId:"sequence_auth_queue_story_1",queueId:"queue_auth_queue_story_1"},"access-code-queue":{key:"access-code-queue",label:"Access-Code Queue Journey",experienceId:"experience_access_code_queue_story_1",sequenceId:"sequence_access_code_queue_story_1",queueId:"queue_access_code_queue_story_1",accessCode:"VIP123"},draw:{key:"draw",label:"Draw Journey",experienceId:"experience_draw_story_1",sequenceId:"sequence_draw_story_1",drawId:"draw_draw_story_1"},"timed-release":{key:"timed-release",label:"Timed Release Journey",experienceId:"experience_timed_release_story_1",sequenceId:"sequence_timed_release_story_1",timedReleaseId:"timed_release_story_1"},auction:{key:"auction",label:"Auction Journey",experienceId:"experience_auction_story_1",sequenceId:"sequence_auction_story_1",auctionId:"auction_auction_story_1"},"auth-draw":{key:"auth-draw",label:"Auth-Gated Draw Journey",experienceId:"experience_auth_draw_story_1",sequenceId:"sequence_auth_draw_story_1",drawId:"draw_auth_draw_story_1"},"admission-cycle":{key:"admission-cycle",label:"Admission Cycle Journey",experienceId:"experience_admission_cycle_story_1",sequenceId:"sequence_admission_cycle_story_1",queueId:"queue_admission_cycle_story_1"},"queue-denied":{key:"queue-denied",label:"Queue Denied (not selected)",experienceId:"experience_queue_denied_story_1",sequenceId:"sequence_queue_denied_story_1",queueId:"queue_queue_denied_story_1"},"draw-denied":{key:"draw-denied",label:"Draw Denied (not selected)",experienceId:"experience_draw_denied_story_1",sequenceId:"sequence_draw_denied_story_1",drawId:"draw_draw_denied_story_1"}};function _(e){return e.startsWith("http://")||e.startsWith("https://")?e:new URL(e,window.location.origin).toString()}function l(e){if(!e)return c.queue;if("string"==typeof e)return c[e]??c.queue;return{...c[e.key]??c.queue,...e}}async function m(e){try{const t=await e.clone().json();return"object"==typeof t&&null!==t?t:void 0}catch{return}}function I(e,t){return{baseUrl:e,defaultDelay:t.defaultDelay??30,logRequests:t.logRequests??!1,fallbackToNetwork:!1}}function p(e){return function(e){const t=e.headers.get("DPoP"),n=e.headers.get("X-Admission-Key-Thumbprint");if(!t||!n)return!1;const s=t.split(".");return 3===s.length&&!s.some(e=>0===e.length)&&/^[A-Za-z0-9_-]{16,}$/.test(n)}(e)?null:o.badRequest("Missing admission proof headers")}function y(e={}){const t=e.scenarios?.length?e.scenarios.map(e=>l(e)):[l(e.scenario)],n=t[0],d=_(e.apiBaseUrl??a),c=_(e.beaconBaseUrl??i),p=e.otpCode??u,y=new s(I(d,e)),E=new s(I(c,e)),h=/* @__PURE__ */new Date,A=h.toISOString(),x=new Date(h.getTime()+864e5).toISOString(),T={sessionType:null};!function(e,t){const n={id:"session_mock_demo",consumerId:"consumer_mock_demo",guestId:"guest_mock_demo",type:"guest",email:null,phone:null,createdAt:t.nowIso,expiresAt:t.expiresAtIso};e.post("/auth/guest",()=>(t.authState.sessionType="guest",o.ok({session:n,accessToken:"guest_access_token_mock_demo",refreshToken:"guest_refresh_token_mock_demo",beaconToken:"guest_beacon_token_mock_demo"}))),e.post("/auth/refresh",()=>o.ok({accessToken:`access_token_mock_demo_${Date.now()}`,refreshToken:"guest_refresh_token_mock_demo",beaconToken:"authenticated"===t.authState.sessionType?"authenticated_beacon_token_mock_demo":"guest_beacon_token_mock_demo"})),e.post("/auth/otp/request",o.ok({ok:!0})),e.post("/auth/otp/verify",async e=>{const n=await m(e);return("string"==typeof n?.code?n.code:void 0)!==t.otpCode?o.error("Invalid verification code",401):(t.authState.sessionType="authenticated",o.ok({session:{id:"session_authenticated_mock_demo",consumerId:"consumer_authenticated_mock_demo",type:"authenticated",email:"string"==typeof n?.email?n.email:"sdk-harness@example.com",phone:"string"==typeof n?.phone?n.phone:null,createdAt:t.nowIso,expiresAt:t.expiresAtIso},accessToken:"authenticated_access_token_mock_demo",refreshToken:"authenticated_refresh_token_mock_demo",beaconToken:"authenticated_beacon_token_mock_demo"}))}),e.post("/auth/external/exchange",async e=>{const n=await m(e);return("string"==typeof n?.exchangeCode?n.exchangeCode:void 0)?(t.authState.sessionType="authenticated",o.ok({session:{id:"session_external_mock_demo",consumerId:"consumer_external_mock_demo",type:"authenticated",email:"external-auth@example.com",phone:null,createdAt:t.nowIso,expiresAt:t.expiresAtIso},accessToken:"external_access_token_mock_demo",refreshToken:"external_refresh_token_mock_demo",beaconToken:"authenticated_beacon_token_mock_demo"})):o.error("Invalid exchange code",401)})}(y,{nowIso:A,expiresAtIso:x,otpCode:p,authState:T}),function(e){const t=()=>o.ok({ok:!0});e.post("/events",t),e.post("/events/batch",t)}(E);for(const s of t){const e=s.waitlistId?`__fanfare_harness_waitlist__:${s.key}:${s.experienceId}`:void 0,t=s.waitlistId?r(e??""):void 0;k(y,s,{authState:T,expiresAtIso:x,waitlistState:t}),s.queueId&&w(y,{queueId:s.queueId,experienceId:s.experienceId,name:"Journey Queue",initialPosition:"admission-cycle"===s.key?2:5,initialEstimatedWaitSeconds:90,autoExpireAfterGrant:"admission-cycle"===s.key,forceDenyOnEnter:"queue-denied"===s.key}),s.waitlistId&&g(y,{waitlistId:s.waitlistId,sequenceId:s.sequenceId,state:t??{isEntered:!1,enteredAt:null},storageKey:e??""}),s.drawId&&q(y,{drawId:s.drawId,forceDenyOnEnter:"draw-denied"===s.key}),s.timedReleaseId&&D(y,{timedReleaseId:s.timedReleaseId,closeAt:new Date(Date.now()+9e5).toISOString()}),s.auctionId&&S(y,{auctionId:s.auctionId})}return y.start(),E.start(),{apiBaseUrl:d,beaconBaseUrl:c,scenario:n,scenarios:t,stop(){E.stop(),y.stop()},getRequests:()=>({api:y.getRequests(),beacon:E.getRequests()})}}function k(e,t,n){const s=(/* @__PURE__ */new Date).toISOString();e.get("/consumers/me",o.ok({active:{journeys:[]}})),e.get(`/experiences/${t.experienceId}`,o.ok({id:t.experienceId,name:t.label,createdAt:s,updatedAt:s,i18n:{en:{"start.title":t.label,"start.description":"Mock data served from the harness mock server."}}})),e.post(`/experiences/${t.experienceId}/enter`,o.ok({experienceId:t.experienceId,enteredAt:s}));const a=e=>({id:t.sequenceId,name:e,experienceId:t.experienceId,priority:1,color:"#000000"}),i=(e,n,s)=>({schemaVersion:1,experienceId:t.experienceId,outcome:"gated",selected:{sequence:e,status:"gated",gates:[n],reasons:s},offers:[],outcomeReasons:s}),u=e=>({schemaVersion:1,experienceId:t.experienceId,outcome:"routed",selected:{sequence:e,status:"admissible",gates:[],reasons:[],sequenceCapabilityGrant:`mock_sequence_capability_grant_${t.sequenceId}`,sequenceCapabilityGrantExpiresAt:n.expiresAtIso},offers:[],outcomeReasons:[]});"auth-queue"===t.key||"auth-draw"===t.key?e.post(`/experiences/${t.experienceId}/route`,()=>"authenticated"!==n.authState.sessionType?o.ok(i(a("auth-draw"===t.key?"Auth-Gated Draw Sequence":"Auth-Gated Queue Sequence"),{type:"authentication",status:"required",reason:{code:"AUTH_REQUIRED"}},[{code:"AUTH_REQUIRED"}])):o.ok(u(a("auth-draw"===t.key?"Auth-Gated Draw Sequence":"Auth-Gated Queue Sequence")))):"access-code-queue"===t.key?e.post(`/experiences/${t.experienceId}/route`,async e=>{const n=await m(e),s="string"==typeof n?.accessCode?n.accessCode:void 0;return s?s!==t.accessCode?o.ok(i(a("Access-Code Queue Sequence"),{type:"access_code",status:"invalid",reason:{code:"ACCESS_CODE_INVALID"}},[{code:"ACCESS_CODE_INVALID"}])):o.ok(u(a("Access-Code Queue Sequence"))):o.ok(i(a("Access-Code Queue Sequence"),{type:"access_code",status:"missing",reason:{code:"ACCESS_CODE_REQUIRED"}},[{code:"ACCESS_CODE_REQUIRED"}]))}):e.post(`/experiences/${t.experienceId}/route`,o.ok(u(a(`${t.label} Sequence`)))),"waitlist-queue"!==t.key?"draw"!==t.key&&"auth-draw"!==t.key&&"draw-denied"!==t.key?"timed-release"!==t.key?"auction"!==t.key?e.get(`/sequences/${t.sequenceId}/distributions`,()=>{const e=/* @__PURE__ */(new Date).toISOString();return o.ok({recentPast:void 0,active:{type:"queue",id:t.queueId,status:"active",details:{id:t.queueId,type:"queue",openAt:e,metadata:{label:"Journey Queue"},estimatedWaitTime:300,queueLength:10}},upcoming:void 0})}):e.get(`/sequences/${t.sequenceId}/distributions`,()=>{const e=Date.now(),n=new Date(e).toISOString();return o.ok({recentPast:void 0,active:{type:"auction",id:t.auctionId,status:"active",details:{id:t.auctionId,type:"auction",openAt:n,endsAt:new Date(e+36e5).toISOString(),startsAt:n,currencyCode:"USD",reservePrice:"50.00",bidIncrement:"10.00"}},upcoming:void 0})}):e.get(`/sequences/${t.sequenceId}/distributions`,()=>{const e=Date.now();return o.ok({recentPast:void 0,active:{type:"timed_release",id:t.timedReleaseId,status:"active",details:{id:t.timedReleaseId,type:"timed_release",openAt:new Date(e).toISOString(),closeAt:new Date(e+9e5).toISOString()}},upcoming:void 0})}):e.get(`/sequences/${t.sequenceId}/distributions`,()=>{const e=Date.now(),n=new Date(e+72e5).toISOString();return o.ok({recentPast:void 0,active:{type:"draw",id:t.drawId,status:"active",details:{id:t.drawId,type:"draw",openAt:new Date(e).toISOString(),drawTime:n,entryDeadline:n}},upcoming:void 0})}):e.get(`/sequences/${t.sequenceId}/distributions`,()=>{const e=/* @__PURE__ */(new Date).toISOString();return n.waitlistState?.isEntered?o.ok({recentPast:void 0,active:{type:"queue",id:t.queueId,status:"active",details:{id:t.queueId,type:"queue",openAt:e,closeAt:new Date(Date.now()+18e5).toISOString(),metadata:{label:"Journey Queue (Window Open)"},estimatedWaitTime:300,queueLength:10}},upcoming:void 0}):o.ok({recentPast:void 0,active:void 0,upcoming:{type:"queue",id:t.queueId,startsAt:new Date(Date.now()+6e4).toISOString(),waitlistId:t.waitlistId}})})}function w(e,t){const{queueId:n,experienceId:s="experience_mock",name:a="Mock Queue",initialPosition:i=12,initialEstimatedWaitSeconds:u=300,autoExpireAfterGrant:r=!1,forceDenyOnEnter:d=!1}=t;let c=!1,_=!1,l=i,m=u,I=0;e.get(`/queues/${n}`,o.ok({id:n,experienceId:s,name:a,status:"open",capacity:500,currentSize:247,estimatedWaitTime:m,openAt:new Date(Date.now()-3e5).toISOString(),closeAt:new Date(Date.now()+36e5).toISOString()})),e.post(`/queues/${n}/enter`,e=>{const t=p(e);return t||(d?o.ok({status:"DENIED"}):(c=!0,_=!1,I=0,l=i,m=u,o.ok({position:l,estimatedWaitTimeInSeconds:m,status:"QUEUED"})))}),e.post(`/queues/${n}/leave`,()=>(c=!1,_=!1,I=0,o.ok({}))),e.get(`/queues/${n}/status`,()=>c?_?(I+=1,r&&I>1?(c=!1,_=!1,o.ok({status:"EXPIRED"})):o.ok({status:"GRANTED",admissionGrant:`admission_grant_${n}`,expiresAt:new Date(Date.now()+6e5).toISOString()})):(l=Math.max(1,l-1),m=Math.max(0,m-30),l<=1?(_=!0,I=1,o.ok({status:"GRANTED",admissionGrant:`admission_grant_${n}`,expiresAt:new Date(Date.now()+6e5).toISOString()})):o.ok({status:"QUEUED",position:l,estimatedWaitTimeInSeconds:m})):o.ok({status:"NOT_QUEUED"}))}function q(e,t){const{drawId:n,drawAtOffsetMs:s=72e5,forceDenyOnEnter:a=!1}=t;let i="NOT_ENTERED",u=0;e.get(`/draws/${n}`,()=>o.ok({id:n,openAt:new Date(Date.now()-6e4).toISOString(),closeAt:null,timeZone:"UTC",drawAt:new Date(Date.now()+s).toISOString(),capacity:null,continueSelectingUntilCompleted:null})),e.get(`/draws/${n}/status`,()=>"NOT_ENTERED"===i?o.ok({status:"NOT_ENTERED"}):(u+=1,u>=2?o.ok({status:"WON",wonAt:/* @__PURE__ */(new Date).toISOString(),admissionGrant:`admission_grant_${n}`}):o.ok({status:"ENTERED"}))),e.post(`/draws/${n}/enter`,e=>{const t=p(e);return t||(a?o.ok({status:"DENIED"}):(i="ENTERED",u=0,o.ok({status:"ENTERED"})))}),e.post(`/draws/${n}/leave`,()=>(i="NOT_ENTERED",u=0,o.ok({})))}function g(e,t){const{waitlistId:n,sequenceId:s,state:a,storageKey:i}=t;e.get(`/waitlists/${n}/status`,()=>o.ok({waitlistId:n,isEntered:a.isEntered,enteredAt:a.enteredAt??void 0})),e.post(`/waitlists/${n}/enter`,()=>(a.isEntered=!0,a.enteredAt=/* @__PURE__ */(new Date).toISOString(),d(i,a),o.ok({id:`waitlist_entry_${n}`,waitlistId:n,sequenceId:s,consumerId:"consumer_mock_demo",enteredAt:a.enteredAt})));const u=()=>(a.isEntered=!1,a.enteredAt=null,d(i,a),o.ok({}));e.delete(`/waitlists/${n}/leave`,u),e.post(`/waitlists/${n}/leave`,u)}function D(e,t){const{timedReleaseId:n,closeAt:s}=t;let a="NOT_ENTERED",i=null,u=null;e.get(`/timed-releases/${n}`,o.ok({id:n,openAt:new Date(Date.now()-6e4).toISOString(),closeAt:s,timeZone:"America/Los_Angeles",supportsGuest:!0})),e.get(`/timed-releases/${n}/status`,()=>"ENTERED"===a?o.ok({status:"ENTERED",enteredAt:i??/* @__PURE__ */(new Date).toISOString()}):"COMPLETED"===a?o.ok({status:"COMPLETED",completedAt:u??/* @__PURE__ */(new Date).toISOString()}):"LEFT"===a?o.ok({status:"LEFT",leftAt:/* @__PURE__ */(new Date).toISOString()}):o.ok({status:"NOT_ENTERED"})),e.post(`/timed-releases/${n}/enter`,async e=>{const t=await m(e),n="string"==typeof t?.variantId?t.variantId:void 0;return a="ENTERED",i=/* @__PURE__ */(new Date).toISOString(),o.ok({status:"ENTERED",enteredAt:i,selectedVariantId:n})}),e.post(`/timed-releases/${n}/leave`,()=>(a="LEFT",o.ok({}))),e.post(`/timed-releases/${n}/complete`,()=>(a="COMPLETED",u=/* @__PURE__ */(new Date).toISOString(),o.ok({success:!0,admissionGrant:`admission_grant_${n}`})))}function S(s,a){const{auctionId:i}=a,u=/* @__PURE__ */new Date,r=u.toISOString(),d=new Date(u.getTime()+6e5).toISOString();let c="100.00",_=null,l=12,I=!1,p=[{bidId:"bid_1",consumerId:"consumer_mock_demo",amount:"80.00",timestamp:r},{bidId:"bid_2",consumerId:"consumer_mock_demo",amount:"90.00",timestamp:r}];s.get(`/auctions/${i}`,o.ok({id:i,openAt:r,closeAt:d,settleAt:d,currencyCode:"USD",reservePrice:null,minBidIncrement:"10.00",autoExtendSeconds:null,timeZone:"UTC"})),s.get(`/auctions/${i}/highest-bid`,()=>o.ok({amount:c})),s.get(`/auctions/${i}/status`,()=>{const e=null===_?"NOT_BID":n(_,c)?"WINNING":I?"OUTBID":"NOT_BID";return o.ok({status:e,lastBidAmount:_??void 0,bidCount:l,auctionEndTime:d})}),s.post(`/auctions/${i}/enter`,()=>(I=!0,o.ok({}))),s.post(`/auctions/${i}/leave`,()=>(I=!1,_=null,o.ok({}))),s.post(`/auctions/${i}/bid`,async s=>{const a=await m(s),i=a?.amount,u="string"==typeof i?i:"";return e(u)?(_=u,l+=1,t(u,c)&&(c=u),p=[...p,{bidId:`bid_${p.length+1}`,consumerId:"consumer_mock_demo",amount:u,timestamp:/* @__PURE__ */(new Date).toISOString()}],o.ok({status:n(u,c)?"WINNING":"OUTBID",lastBidAmount:u,bidCount:l,winningBidAmount:c,winningBidTime:/* @__PURE__ */(new Date).toISOString(),auctionEndTime:d,paymentToken:null})):o.badRequest("Invalid bid amount")}),s.get(`/auctions/${i}/bids/history`,()=>o.ok(p.map(e=>({...e,isHighest:e.amount===c}))))}export{a as DEFAULT_HARNESS_MOCK_API_BASE_URL,i as DEFAULT_HARNESS_MOCK_BEACON_BASE_URL,u as DEFAULT_TEST_OTP_CODE,c as HARNESS_SCENARIOS,y as installHarnessMockServer,l as normalizeHarnessScenario};

package/dist/test-utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Internal test scaffolding for the first-party adapters (fanfare-sdk-react/
+ * -solid), sdk-harness, and Storybook scenarios. NOT customer API and carries
+ * no stability guarantee (see docs/PUBLIC_SURFACE.md).
+ */
+export * from './harness-scenarios';
+export * from './mock-journey';
+export * from './mock-sdk';
+export * from './mock-server';
+export * from './sdk-factory';
+export * from './verification-scenarios';
+export * from './verification-state';

package/dist/test-utils/index.js

@@ -0,0 +1 @@
+import{DEFAULT_HARNESS_MOCK_API_BASE_URL as o,DEFAULT_HARNESS_MOCK_BEACON_BASE_URL as r,DEFAULT_TEST_OTP_CODE as m,HARNESS_SCENARIOS as s,installHarnessMockServer as i,normalizeHarnessScenario as t}from"./harness-scenarios.js";import{createMockJourneyHandle as e,createMockJourneyStore as f,makeGatedSnapshot as c,makeReadySnapshot as j,makeRoutedSnapshot as p}from"./mock-journey.js";import{createMockFanfareSDK as a,createMockInternalFanfareSDK as n,mockAuction as k,mockAuctionStatus as v,mockDraw as d,mockDrawStatus as y,mockExperience as h,mockExperienceSession as u,mockQueue as x,mockQueueEnterResult as b,mockQueueStatus as g,mockTimedRelease as l,mockTimedReleaseStatus as q,mockWaitlistEntry as w,mockWaitlistStatus as z}from"./mock-sdk.js";import{MockServer as A,ResponseBuilder as B}from"./mock-server.js";import{createMockSDK as C}from"./sdk-factory.js";import{ADAPTER_SMOKE_SCENARIOS as D,DEFAULT_INVALID_ACCESS_CODE as E,DEFAULT_VALID_ACCESS_CODE as F,DEFAULT_VERIFICATION_EMAIL as G,DEFAULT_VERIFICATION_OTP as H,SDK_VERIFICATION_SCENARIOS as I,SHARED_HARNESS_VERIFICATION_SCENARIOS as J,getVerificationScenario as K,isVerificationScenarioKey as L}from"./verification-scenarios.js";import{resetVerificationState as M}from"./verification-state.js";export{D as ADAPTER_SMOKE_SCENARIOS,o as DEFAULT_HARNESS_MOCK_API_BASE_URL,r as DEFAULT_HARNESS_MOCK_BEACON_BASE_URL,E as DEFAULT_INVALID_ACCESS_CODE,m as DEFAULT_TEST_OTP_CODE,F as DEFAULT_VALID_ACCESS_CODE,G as DEFAULT_VERIFICATION_EMAIL,H as DEFAULT_VERIFICATION_OTP,s as HARNESS_SCENARIOS,A as MockServer,B as ResponseBuilder,I as SDK_VERIFICATION_SCENARIOS,J as SHARED_HARNESS_VERIFICATION_SCENARIOS,a as createMockFanfareSDK,n as createMockInternalFanfareSDK,e as createMockJourneyHandle,f as createMockJourneyStore,C as createMockSDK,K as getVerificationScenario,i as installHarnessMockServer,L as isVerificationScenarioKey,c as makeGatedSnapshot,j as makeReadySnapshot,p as makeRoutedSnapshot,k as mockAuction,v as mockAuctionStatus,d as mockDraw,y as mockDrawStatus,h as mockExperience,u as mockExperienceSession,x as mockQueue,b as mockQueueEnterResult,g as mockQueueStatus,l as mockTimedRelease,q as mockTimedReleaseStatus,w as mockWaitlistEntry,z as mockWaitlistStatus,t as normalizeHarnessScenario,M as resetVerificationState};

package/dist/test-utils/mock-journey.d.ts

@@ -0,0 +1,63 @@
+import { ReadableAtom, WritableAtom } from 'nanostores';
+import { DistributionDisplayState } from '../experiences/distribution-monitor.types';
+import { JourneyViewHandlers } from '../experiences/journey-view';
+import { AdmissionGrant, DistributionSummary, GatedSnapshot, JourneyEvent, JourneyHandle, JourneySnapshot, JourneyView, MechanismConsumerState, ReadySnapshot, RoutedSnapshot, RoutingGate, RoutingOffer, SequenceOutcome, SequenceState } from '../experiences/journey.types';
+export declare function makeReadySnapshot(experienceId?: string, overrides?: Partial<ReadySnapshot>): ReadySnapshot;
+export declare function makeGatedSnapshot(params?: {
+    experienceId?: string;
+    gates?: RoutingGate[];
+    selected?: GatedSnapshot["selected"];
+    overrides?: Partial<GatedSnapshot>;
+}): GatedSnapshot;
+export declare function makeRoutedSnapshot(params: {
+    sequence?: SequenceState | ({
+        phase: SequenceState["phase"];
+        waitlistId?: string;
+        reason?: string;
+    } & Record<string, unknown>);
+    experienceId?: string;
+    sequenceId?: string;
+    offers?: RoutingOffer[];
+    distribution?: DistributionSummary;
+    consumer?: MechanismConsumerState;
+    grant?: AdmissionGrant;
+    outcome?: SequenceOutcome;
+    overrides?: Partial<RoutedSnapshot> & {
+        consumer?: MechanismConsumerState;
+        grant?: AdmissionGrant;
+        outcome?: SequenceOutcome;
+        actions?: unknown;
+    };
+}): RoutedSnapshot;
+export interface MockJourneyStore {
+    atom: WritableAtom<JourneySnapshot>;
+    get(): JourneySnapshot;
+    listen(listener: (value: JourneySnapshot, oldValue?: JourneySnapshot) => void): () => void;
+    subscribe(listener: (value: JourneySnapshot, oldValue?: JourneySnapshot) => void): () => void;
+    setValue(value: JourneySnapshot): void;
+    getListenerCount(): number;
+}
+export declare function createMockJourneyStore(initial?: JourneySnapshot): MockJourneyStore;
+export interface MockJourneyController {
+    handle: JourneyHandle;
+    snapshot$: MockJourneyStore;
+    view$: ReadableAtom<JourneyView>;
+    events$: ReadableAtom<JourneyEvent[]>;
+    latestEvent$: ReadableAtom<JourneyEvent | null>;
+    handlers: JourneyViewHandlers;
+    setSnapshot(value: JourneySnapshot): void;
+    updateSnapshot(updater: (value: JourneySnapshot) => JourneySnapshot): void;
+    setDisplayState(value: DistributionDisplayState): void;
+    ackEvent(eventId: string): void;
+    ackAllEvents(): void;
+    destroy(): void;
+}
+export declare function createMockJourneyHandle(args?: {
+    initialSnapshot?: JourneySnapshot;
+    handlers?: Partial<JourneyViewHandlers>;
+    actions?: Partial<JourneyViewHandlers & {
+        ackEvent(eventId: string): void;
+        ackAllEvents(): void;
+        destroy(): void;
+    }>;
+}): MockJourneyController;

package/dist/test-utils/mock-journey.js

@@ -0,0 +1 @@
+import{atom as e,computed as t}from"nanostores";import{buildJourneyView as n}from"../experiences/journey-view.js";import{deriveSequenceState as s}from"../experiences/journey.machine.js";function r(e){if("routed"!==e.journeyStage||"participating"!==e.sequence.phase)return{type:"queue"};switch(e.sequence.mechanism){case"queue":case"waitlist":return{type:"queue"};case"draw":return{type:"draw"};case"auction":return{type:"auction"};case"timed_release":return{type:"timed_release"};case"appointment":return{type:"appointment"}}}function a(e="exp_123",t){return{revision:1,updatedAt:Date.now(),journeyStage:"ready",experienceId:e,experience:void 0,events:[],lastSeenEventId:void 0,...t}}function o(e){return{...a(e?.experienceId),journeyStage:"gated",gates:e?.gates??[],selected:e?.selected,...e?.overrides}}function c(e){const t=e.sequence&&"mechanism"in e.sequence?e.sequence:s({distribution:e.distribution,consumer:e.consumer??e.overrides?.consumer,grant:e.grant??e.overrides?.grant,outcome:e.outcome??e.overrides?.outcome}),{consumer:n,grant:r,outcome:o,actions:c,sequence:i,...u}=e.overrides??{};return{...a(e.experienceId),journeyStage:"routed",sequenceId:e.sequenceId??"seq_1",offers:e.offers??[],sequence:t,...u}}function i(t){const n=e(t??a());let s=0;return{atom:n,get:()=>n.get(),listen:e=>{s+=1;const t=n.listen(e);return()=>{s-=1,t()}},subscribe:e=>{s+=1;const t=n.subscribe(e);return()=>{s-=1,t()}},setValue:e=>n.set(e),getListenerCount:()=>s}}function u(s){const o=s?.initialSnapshot??a(),c=i(o),u=e(r(c.get())),d=s?.actions??{},l={start:async()=>{},reroute:async()=>{},retry:async()=>{},enter:async()=>{},leave:async()=>{},bid:async()=>{},complete:async()=>{},book:async()=>{},cancel:async()=>{},reschedule:async()=>{},claim:()=>{const e=c.get();if("routed"===e.journeyStage&&"granted"===e.sequence.phase)return e.sequence.grant;throw new Error("No grant is available to claim")},...s?.handlers,...d},v=t(c.atom,e=>n(e,l,u)),p=t(c.atom,e=>e.events),m=t(c.atom,e=>{if(!e.events.length)return null;const t=e.lastSeenEventId??"",n=e.events.filter(e=>e.id>t);return n.length?n[n.length-1]:null}),y=e=>{if(d.ackEvent)return void d.ackEvent(e);const t=c.get();t.events.some(t=>t.id===e)&&c.setValue({...t,lastSeenEventId:e})},g=()=>{if(d.ackAllEvents)return void d.ackAllEvents();const e=c.get(),t=e.events[e.events.length-1];t&&c.setValue({...e,lastSeenEventId:t.id})},f=()=>{if(d.destroy)return void d.destroy();const e=c.get().experienceId||o.experienceId;c.setValue(a(e)),u.set(r(a(e)))};return{handle:{view$:v,snapshot$:c.atom,events$:p,latestEvent$:m,ackEvent:y,ackAllEvents:g,destroy:f},snapshot$:c,view$:v,events$:p,latestEvent$:m,handlers:l,setSnapshot:e=>{c.setValue(e)},updateSnapshot:e=>{const t=e(c.get());c.setValue(t)},setDisplayState:e=>u.set(e),ackEvent:y,ackAllEvents:g,destroy:f}}export{u as createMockJourneyHandle,i as createMockJourneyStore,o as makeGatedSnapshot,a as makeReadySnapshot,c as makeRoutedSnapshot};