@ianmenethil/zp-observer 6.0.0

package/dist/types/core/types.d.ts

@@ -0,0 +1,292 @@
+/**
+ * Shared types for @ianmenethil/zp-observer
+ *
+ * v6 extends the three-event telemetry model (open / heartbeat / close) into a
+ * domain event bus that carries signal from the full payment stack: device
+ * fingerprint, HPP lifecycle, and merchant-reported outcomes — all correlated
+ * by a single `correlationId`.
+ */
+export declare const VERSION: "6.0.0";
+export type CloseReason = 'user.callback_invoked' | 'user.modal_closed' | 'user.manual_close' | 'system.idle_timeout' | 'system.network_abandoned' | 'page.pagehide';
+export type PaymentOutcome = 'success' | 'declined' | 'abandoned' | 'error' | 'unknown';
+export interface OpenEvent {
+    kind: 'open';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    iframeSrc: string | null;
+    userAgent: string;
+    screenWidth: number;
+    screenHeight: number;
+    navigationType: string | null;
+    metadata: Record<string, unknown>;
+    userActivation?: {
+        hasBeenActive: boolean;
+        isActive: boolean;
+    };
+    navigationDetail?: {
+        wasDiscarded: boolean | null;
+        redirectCount: number | null;
+        transferSize: number | null;
+        type: string | null;
+    };
+}
+export interface HeartbeatEvent {
+    kind: 'heartbeat';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    sequence: number;
+    missedBeats: number;
+    metadata: Record<string, unknown>;
+}
+export interface CloseEvent {
+    kind: 'close';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    reason: CloseReason;
+    elapsedMs: number;
+    heartbeatCount: number;
+    missedBeats: number;
+    wasPersisted: boolean | null;
+    metadata: Record<string, unknown>;
+}
+export interface SessionInitEvent {
+    kind: 'payment.session_init';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+}
+export interface FingerprintStartedEvent {
+    kind: 'payment.fingerprint_started';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    attempt: number;
+    metadata: Record<string, unknown>;
+}
+export interface FingerprintCacheHitEvent {
+    kind: 'payment.fingerprint_cache_hit';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    age: number;
+    metadata: Record<string, unknown>;
+}
+export interface FingerprintSucceededEvent {
+    kind: 'payment.fingerprint_succeeded';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+}
+export interface FingerprintFailedEvent {
+    kind: 'payment.fingerprint_failed';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    error: string;
+    attempt: number;
+    metadata: Record<string, unknown>;
+}
+export interface HppInitEvent {
+    kind: 'payment.hpp_init';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+}
+export interface HppIframeLoadedEvent {
+    kind: 'payment.hpp_iframe_loaded';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+}
+export interface HppConfigInvalidEvent {
+    kind: 'payment.hpp_config_invalid';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    errors: string[];
+    metadata: Record<string, unknown>;
+}
+export interface ModalOpenedEvent {
+    kind: 'payment.modal_opened';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    iframeSrc: string | null;
+    metadata: Record<string, unknown>;
+}
+export interface OutcomeEvent {
+    kind: 'payment.outcome';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    outcome: PaymentOutcome;
+    metadata: Record<string, unknown>;
+}
+export interface PreflightEvent {
+    kind: 'payment.preflight';
+    sessionId: string;
+    correlationId: string;
+    timestamp: number;
+    metadata: Record<string, unknown>;
+}
+export type ObserverEvent = OpenEvent | HeartbeatEvent | CloseEvent | SessionInitEvent | FingerprintStartedEvent | FingerprintCacheHitEvent | FingerprintSucceededEvent | FingerprintFailedEvent | HppInitEvent | HppIframeLoadedEvent | HppConfigInvalidEvent | ModalOpenedEvent | OutcomeEvent | PreflightEvent;
+export type DiagnosticEvent = {
+    kind: 'exp.pageshow';
+    persisted: boolean;
+    navigationType: string | null;
+    timestamp: number;
+} | {
+    kind: 'exp.freeze';
+    timestamp: number;
+} | {
+    kind: 'exp.resume';
+    timestamp: number;
+} | {
+    kind: 'exp.window_focus';
+    timestamp: number;
+} | {
+    kind: 'exp.window_blur';
+    timestamp: number;
+} | {
+    kind: 'exp.visibility_detail';
+    prevState: string;
+    currState: string;
+    prevStateDurationMs: number;
+    hasFocus: boolean | null;
+    onLine: boolean | null;
+    timestamp: number;
+} | {
+    kind: 'exp.perf_entry';
+    entryType: string;
+    name: string;
+    startTime: number;
+    duration?: number;
+    size?: number;
+    url?: string;
+    timestamp: number;
+} | {
+    kind: 'exp.iframe_resize';
+    width: number;
+    height: number;
+    timestamp: number;
+} | {
+    kind: 'exp.iframe_src';
+    previousSrc: string | null;
+    currentSrc: string;
+    timestamp: number;
+} | {
+    kind: 'exp.page_lifecycle_beacon';
+    phase: 'navigation' | 'pageshow' | 'pagehide';
+    ok: boolean;
+    timestamp: number;
+} | {
+    kind: 'exp.was_discarded';
+    wasDiscarded: boolean | null;
+    timestamp: number;
+} | {
+    kind: 'system.persistence_unavailable';
+    error: string;
+    timestamp: number;
+};
+export interface ExperimentalOptions {
+    captureUserActivation?: boolean;
+    captureNavigationTimingDetail?: boolean;
+    captureWasDiscarded?: boolean;
+    capturePageShow?: boolean;
+    captureWindowFocus?: boolean;
+    captureVisibilityDetail?: boolean;
+    captureFreezeResume?: boolean;
+    capturePerformanceEntries?: boolean;
+    perfEntryTypes?: readonly ('longtask' | 'largest-contentful-paint')[];
+    captureIframeResize?: boolean;
+    captureIframeSrcChanges?: boolean;
+    pageLifecycleBeaconUrl?: string;
+    attachDiagnosticsToHeartbeat?: boolean;
+    diagnosticsMax?: number;
+}
+export interface TransportResult {
+    ok: boolean;
+    status?: number;
+}
+export interface Transport {
+    /** Generic write path — handles any ObserverEvent. */
+    send(event: ObserverEvent): Promise<TransportResult>;
+    /** Fire-and-forget delegator for open events. */
+    sendOpen(event: OpenEvent): void;
+    /** Response-aware delegator for heartbeats. */
+    sendHeartbeat(event: HeartbeatEvent): Promise<TransportResult>;
+    /** Dismissal-safe delegator for close events. */
+    sendClose(event: CloseEvent): void;
+}
+export type UIState = 'IDLE' | 'DETECTING' | 'ACTIVE_MODAL_VISIBLE' | 'BACKGROUND_HIDDEN' | 'DISMISSED';
+export type TransportState = 'CONNECTED' | 'HEARTBEAT_LATE' | 'DISCONNECTED';
+export interface ObserverState {
+    ui: UIState;
+    transport: TransportState;
+    sessionId: string;
+    correlationId: string;
+    shortcode: string;
+    isActive: boolean;
+    iframeDetected: boolean;
+    heartbeatCount: number;
+    missedBeats: number;
+    elapsedMs: number;
+}
+export type PersistenceMode = 'memory' | 'localStorage';
+export interface DiagnosticDump {
+    sessionId: string;
+    correlationId: string;
+    state: ObserverState;
+    recentEvents: ObserverEvent[];
+    diagnostics: DiagnosticEvent[];
+    configuredTransport: string;
+    version: string;
+}
+export interface ObserverDiagnostics {
+    dump(): DiagnosticDump;
+}
+export interface Observer {
+    readonly sessionId: string;
+    readonly correlationId: string;
+    readonly shortcode: string;
+    readonly diagnostics: ObserverDiagnostics;
+    start(): void;
+    stop(reason?: CloseReason): void;
+    getState(): ObserverState;
+    /** Push a domain event onto the bus and through the transport. */
+    emit(event: ObserverEvent): void;
+}
+export interface CreateObserverOptions {
+    sessionId: string;
+    transport: Transport;
+    correlationId?: string;
+    metadata?: Record<string, unknown>;
+    beforeSend?: (event: ObserverEvent) => ObserverEvent | null;
+    heartbeatMs?: number;
+    heartbeatMissThreshold?: number;
+    idleTimeoutMs?: number;
+    detectionIntervalMs?: number;
+    detectionTimeoutMs?: number;
+    iframeSelectors?: string[];
+    debug?: boolean;
+    experimental?: ExperimentalOptions;
+    onDiagnostic?: (event: DiagnosticEvent) => void;
+    persistence?: PersistenceMode;
+}
+export interface PreflightReport {
+    ok: boolean;
+    endpoint: string;
+    status: number | undefined;
+    latencyMs: number;
+    corsError: boolean;
+    networkError: string | null;
+    beaconSupported: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/core/types.d.ts.map

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

package/dist/types/diagnostics/preflight.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Merchant-facing preflight validator.
+ *
+ * Sends a single `payment.preflight` event to the configured transport,
+ * checks CORS, response code, latency, and reports structural errors.
+ * Integrators print the report during development to verify their
+ * telemetry pipeline is wired correctly.
+ */
+import type { ObserverEvent, PreflightReport, Transport } from '../core/types.js';
+interface PreflightOptions {
+    transport: Transport;
+    /** Optional sample event data to include in validation. */
+    sample?: Partial<ObserverEvent>;
+}
+export declare function preflight(options: PreflightOptions): Promise<PreflightReport>;
+export {};
+//# sourceMappingURL=preflight.d.ts.map

package/dist/types/diagnostics/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElF,UAAU,gBAAgB;IACzB,SAAS,EAAE,SAAS,CAAC;IACrB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAChC;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAyCnF"}

package/dist/types/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @ianmenethil/zp-observer — public entry (v6)
+ *
+ * Telemetry bridge for Zenith hosted checkout. Tracks the full payment
+ * lifecycle: session init, device fingerprint, HPP detection, modal open,
+ * heartbeats, close, and merchant-reported outcomes — all correlated by
+ * a single `correlationId`.
+ */
+import { createObserver } from './core/observer.js';
+import { httpTransport } from './transport/http-transport.js';
+import { callbackTransport } from './transport/callback-transport.js';
+import { installZenPayAutoPatch } from './integration/zenpay-auto-patch.js';
+import { installHPPBridge } from './integration/hpp-bridge.js';
+import { installDeviceFPBridge } from './integration/devicefp-bridge.js';
+import { preflight } from './diagnostics/preflight.js';
+import { reportOutcome } from './outcome.js';
+import { VERSION } from './core/types.js';
+export { createObserver, httpTransport, callbackTransport, installZenPayAutoPatch, installHPPBridge, installDeviceFPBridge, preflight, reportOutcome, VERSION, };
+export type { CloseEvent, CloseReason, CreateObserverOptions, DiagnosticDump, DiagnosticEvent, ExperimentalOptions, HeartbeatEvent, HppConfigInvalidEvent, HppIframeLoadedEvent, HppInitEvent, Observer, ObserverDiagnostics, ObserverEvent, ObserverState, OpenEvent, OutcomeEvent, PersistenceMode, PreflightReport, SessionInitEvent, Transport, TransportResult, TransportState, UIState, } from './core/types.js';
+export type { HttpTransportOptions } from './transport/http-transport.js';
+export type { CallbackTransportOptions } from './transport/callback-transport.js';
+export type { AutoPatchHandle, AutoPatchOptions } from './integration/zenpay-auto-patch.js';
+export type { CreateSessionOptions, ZenPaySession } from './session.js';
+export type { ReportOutcomeOptions } from './outcome.js';
+export type { DeviceFPBridgeOptions, DeviceFPHooks } from './integration/devicefp-bridge.js';
+declare global {
+    interface Window {
+        ZPObserver?: {
+            createObserver: typeof createObserver;
+            httpTransport: typeof httpTransport;
+            callbackTransport: typeof callbackTransport;
+            installZenPayAutoPatch: typeof installZenPayAutoPatch;
+            installHPPBridge: typeof installHPPBridge;
+            installDeviceFPBridge: typeof installDeviceFPBridge;
+            preflight: typeof preflight;
+            reportOutcome: typeof reportOutcome;
+            VERSION: typeof VERSION;
+        };
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,OAAO,EACN,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,OAAO,GACP,CAAC;AAEF,YAAY,EACX,UAAU,EACV,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,SAAS,EACT,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,cAAc,EACd,OAAO,GACP,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAClF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAE7F,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,UAAU,CAAC,EAAE;YACZ,cAAc,EAAE,OAAO,cAAc,CAAC;YACtC,aAAa,EAAE,OAAO,aAAa,CAAC;YACpC,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;YAC5C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;YACtD,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;YAC1C,qBAAqB,EAAE,OAAO,qBAAqB,CAAC;YACpD,SAAS,EAAE,OAAO,SAAS,CAAC;YAC5B,aAAa,EAAE,OAAO,aAAa,CAAC;YACpC,OAAO,EAAE,OAAO,OAAO,CAAC;SACxB,CAAC;KACF;CACD"}

package/dist/types/integration/devicefp-bridge.d.ts

@@ -0,0 +1,31 @@
+/**
+ * DEVICEFP → OBSERVER bridge.
+ *
+ * Returns typed hook functions that the integrator spreads into DEVICEFP's
+ * `captureThumbmark()` options. Each hook emits a domain event through the
+ * observer and then calls the original integrator callback (if provided).
+ *
+ * Usage:
+ *   const bridge = installDeviceFPBridge(observer);
+ *   await captureThumbmark({
+ *     apiKey: '...',
+ *     onSuccess: bridge.onSucceeded,
+ *     onError: bridge.onFailed,
+ *     onCacheHit: bridge.onCacheHit,
+ *   });
+ */
+import type { Observer } from '../core/types.js';
+export interface DeviceFPBridgeOptions {
+    onFingerprintStarted?: (attempt: number) => void;
+    onFingerprintCacheHit?: (age: number) => void;
+    onFingerprintSucceeded?: () => void;
+    onFingerprintFailed?: (error: string, attempt: number) => void;
+}
+export interface DeviceFPHooks {
+    onFingerprintStarted: (attempt: number) => void;
+    onFingerprintCacheHit: (age: number) => void;
+    onFingerprintSucceeded: () => void;
+    onFingerprintFailed: (error: string, attempt: number) => void;
+}
+export declare function installDeviceFPBridge(observer: Pick<Observer, 'sessionId' | 'correlationId' | 'emit'>, options?: DeviceFPBridgeOptions): DeviceFPHooks;
+//# sourceMappingURL=devicefp-bridge.d.ts.map

package/dist/types/integration/devicefp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devicefp-bridge.d.ts","sourceRoot":"","sources":["../../../src/integration/devicefp-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,qBAAqB;IACrC,oBAAoB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,qBAAqB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,sBAAsB,CAAC,EAAE,MAAM,IAAI,CAAC;IACpC,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,aAAa;IAC7B,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,qBAAqB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9D;AAED,wBAAgB,qBAAqB,CACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC,EAChE,OAAO,GAAE,qBAA0B,GACjC,aAAa,CAqDf"}

package/dist/types/integration/hpp-bridge.d.ts

@@ -0,0 +1,13 @@
+/**
+ * HPP-TS observation bridge — wraps `window.onPaymentPluginLoaded`.
+ *
+ * HPP-TS v5 exposes `window.onPaymentPluginLoaded` (lines 794-823) as a
+ * callback that fires when the payment iframe has loaded. This bridge wraps
+ * it to emit `payment.hpp_iframe_loaded` through the observer without
+ * modifying HPP-TS source.
+ */
+import type { Observer } from '../core/types.js';
+export declare function installHPPBridge(observer: Pick<Observer, 'sessionId' | 'correlationId' | 'emit'>): {
+    uninstall(): void;
+};
+//# sourceMappingURL=hpp-bridge.d.ts.map

package/dist/types/integration/hpp-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hpp-bridge.d.ts","sourceRoot":"","sources":["../../../src/integration/hpp-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,CAAC,GAC9D;IAAE,SAAS,IAAI,IAAI,CAAA;CAAE,CAwCvB"}

package/dist/types/integration/zenpay-auto-patch.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ZenPay plugin auto-patch (v6).
+ *
+ * One-line integration: detects the ZenPay plugin and rewrites its
+ * `onPluginClose` at invocation time to use our shortcode. Emits
+ * `payment.hpp_init` domain events when the plugin is invoked so the
+ * observer's event stream captures HPP lifecycle.
+ *
+ * Supports:
+ *   - v3: jQuery plugin `$.fn.zpPayment`
+ *   - v5: global `window.ZenPay` (class or factory)
+ *
+ * If neither is present at install time, we set a short-lived polling
+ * watch (plugins are typically loaded via <script> before first payment).
+ */
+import type { Observer } from '../core/types.js';
+export interface AutoPatchHandle {
+    uninstall(): void;
+    isPatched(): boolean;
+}
+export interface AutoPatchOptions {
+    pollIntervalMs?: number;
+    pollTimeoutMs?: number;
+    chainExisting?: boolean;
+    debug?: boolean;
+}
+export declare function installZenPayAutoPatch(observer: Pick<Observer, 'sessionId' | 'correlationId' | 'shortcode' | 'emit'>, options?: AutoPatchOptions): AutoPatchHandle;
+//# sourceMappingURL=zenpay-auto-patch.d.ts.map

package/dist/types/integration/zenpay-auto-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zenpay-auto-patch.d.ts","sourceRoot":"","sources":["../../../src/integration/zenpay-auto-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAajD,MAAM,WAAW,eAAe;IAC/B,SAAS,IAAI,IAAI,CAAC;IAClB,SAAS,IAAI,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AA8HD,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,eAAe,GAAG,WAAW,GAAG,MAAM,CAAC,EAC9E,OAAO,GAAE,gBAAqB,GAC5B,eAAe,CA+DjB"}

package/dist/types/outcome.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Cross-page outcome reporting.
+ *
+ * The merchant's "thank you" / "decline" / "error" page is the authoritative
+ * outcome source. `reportOutcome` sends a single `payment.outcome` event
+ * without needing a live Observer instance — just enough to POST the result.
+ *
+ * Convention: the HPP backend forwards `correlationId` in the redirect URL
+ * as `?cid=<uuid>`. The return page reads it and calls `reportOutcome`.
+ */
+import type { PaymentOutcome, Transport } from './core/types.js';
+export interface ReportOutcomeOptions {
+    correlationId: string;
+    sessionId: string;
+    outcome: PaymentOutcome;
+    transport: Transport;
+    metadata?: Record<string, unknown>;
+}
+export declare function reportOutcome(options: ReportOutcomeOptions): void;
+//# sourceMappingURL=outcome.d.ts.map

package/dist/types/outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/outcome.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAajE"}

package/dist/types/session.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Unified entry point — `createZenPaySession`.
+ *
+ * Composes the observer, auto-patch, HPP bridge, and DEVICEFP hooks into a
+ * single call. Returns a correlation-aware session object the integrator
+ * destructures and passes to DEVICEFP and HPP-TS.
+ *
+ *   import { createZenPaySession, httpTransport } from '@ianmenethil/zp-observer/session';
+ *
+ *   const session = await createZenPaySession({
+ *     sessionId: merchantUPID,
+ *     transport: httpTransport({ openUrl, aliveUrl, closeUrl }),
+ *     deviceFP: { apiKey: '...', captureTimeoutMs: 7000 },
+ *     persistence: 'localStorage',
+ *   });
+ *
+ *   // Pass session.fingerprint.hooks to DEVICEFP's captureThumbmark()
+ *   // Pass session.hppDefaults.onPluginClose to ZenPay
+ *   // observer starts automatically — no manual start() needed
+ */
+import type { Observer, PersistenceMode, Transport } from './core/types.js';
+import type { AutoPatchOptions } from './integration/zenpay-auto-patch.js';
+export interface CreateSessionOptions {
+    sessionId: string;
+    transport: Transport;
+    correlationId?: string;
+    metadata?: Record<string, unknown>;
+    persistence?: PersistenceMode;
+    deviceFP?: {
+        apiKey?: string;
+        captureTimeoutMs?: number;
+    };
+    autoPatch?: AutoPatchOptions;
+    heartbeatMs?: number;
+    debug?: boolean;
+}
+export interface ZenPaySession {
+    readonly sessionId: string;
+    readonly correlationId: string;
+    readonly observer: Observer;
+    readonly hppDefaults: {
+        onPluginClose: string;
+    };
+    readonly fingerprint: {
+        hooks: {
+            onFingerprintStarted: (attempt: number) => void;
+            onFingerprintCacheHit: (age: number) => void;
+            onFingerprintSucceeded: () => void;
+            onFingerprintFailed: (error: string, attempt: number) => void;
+        };
+    };
+}
+export declare function createZenPaySession(options: CreateSessionOptions): ZenPaySession;
+//# sourceMappingURL=session.d.ts.map

package/dist/types/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE;QACrB,aAAa,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE;QACrB,KAAK,EAAE;YACN,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;YAChD,qBAAqB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;YAC7C,sBAAsB,EAAE,MAAM,IAAI,CAAC;YACnC,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;SAC9D,CAAC;KACF,CAAC;CACF;AAED,wBAAgB,mBAAmB,CAClC,OAAO,EAAE,oBAAoB,GAC3B,aAAa,CAiFf"}

package/dist/types/transport/callback-transport.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Callback transport — bring-your-own-sink (v6).
+ *
+ * For integrators who want full control over how and where events go.
+ * `send(event)` is the primary path; `sendOpen` / `sendHeartbeat` / `sendClose`
+ * are thin delegators for backward compatibility.
+ */
+import type { ObserverEvent, Transport, TransportResult } from '../core/types.js';
+export interface CallbackTransportOptions {
+    onOpen?: (event: ObserverEvent) => void;
+    onHeartbeat?: (event: ObserverEvent) => Promise<TransportResult> | TransportResult;
+    onClose?: (event: ObserverEvent) => void;
+    /** Generic callback for domain events that don't match open/heartbeat/close. */
+    onEvent?: (event: ObserverEvent) => Promise<TransportResult> | TransportResult;
+}
+export declare function callbackTransport(opts?: CallbackTransportOptions): Transport;
+//# sourceMappingURL=callback-transport.d.ts.map

package/dist/types/transport/callback-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/callback-transport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,wBAAwB;IACxC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;IACnF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,gFAAgF;IAChF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,eAAe,CAAC;CAC/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,wBAA6B,GAAG,SAAS,CAwDhF"}

package/dist/types/transport/http-transport.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Default HTTP transport (v6).
+ *
+ * `send(event)` is the primary write path — dispatches based on event kind.
+ * `sendOpen` / `sendHeartbeat` / `sendClose` are retained as thin delegators
+ * for backward compatibility with v5 consumers.
+ *
+ * Strategies:
+ *   - heartbeat → fetch POST with AbortController timeout (needs status code)
+ *   - everything else → navigator.sendBeacon, with fetch({keepalive:true}) fallback
+ */
+import type { Transport } from '../core/types.js';
+export interface HttpTransportOptions {
+    /** Endpoint for the single `open` beacon. */
+    openUrl: string;
+    /** Endpoint for periodic heartbeat POSTs. */
+    aliveUrl: string;
+    /** Endpoint for the final `close` beacon. */
+    closeUrl: string;
+    /** Optional endpoint for domain events (falls back to aliveUrl). */
+    eventUrl?: string;
+    /** Static headers applied to heartbeats. sendBeacon cannot set headers. */
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** Override fetch (useful for tests / custom retry wrappers). */
+    fetch?: typeof fetch;
+    /** Heartbeat request timeout. Default 8000ms. */
+    heartbeatTimeoutMs?: number;
+}
+export declare function httpTransport(opts: HttpTransportOptions): Transport;
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/types/transport/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/http-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,WAAW,oBAAoB;IACpC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAEjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAElE,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAErB,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA+CD,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,CAgEnE"}

package/dist/types/umd.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IIFE entry for the CDN bundle.
+ *
+ * Built by esbuild (scripts/build.ts) with `globalName: "ZPObserver"`.
+ * The IIFE sets `window.ZPObserver` as a side effect so <script> consumers
+ * get the same flat namespace:
+ *
+ *   <script src=".../zp-observer.min.js"></script>
+ *   <script>
+ *     const obs = ZPObserver.createObserver({ ... });
+ *     ZPObserver.installZenPayAutoPatch(obs);
+ *     obs.start();
+ *   </script>
+ */
+export { createObserver, httpTransport, callbackTransport, installZenPayAutoPatch, installHPPBridge, installDeviceFPBridge, preflight, reportOutcome, VERSION, } from './index.js';
+//# sourceMappingURL=umd.d.ts.map

package/dist/types/umd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"umd.d.ts","sourceRoot":"","sources":["../../src/umd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACN,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,aAAa,EACb,OAAO,GACP,MAAM,YAAY,CAAC"}