@mercuryo-ai/magicpay-sdk 0.1.0-test.2

package/dist/session-client.d.ts

@@ -0,0 +1,305 @@
+import { type MagicPayRequestOptions, type MagicPayGatewayConfig } from './gateway.js';
+export interface SessionBackendCurrentRequest {
+    id: string;
+    type: 'secret_read' | 'secret_write' | 'purchase' | 'payment_approval' | 'captcha' | 'alert';
+    status: 'pending' | 'fulfilled' | 'denied' | 'expired' | 'failed' | 'canceled';
+    blocking: boolean;
+    title: string;
+    summary: string | null;
+    created_at: string;
+    updated_at: string;
+    expires_at: string | null;
+}
+export interface SessionBackendSession {
+    id: string;
+    status: 'in_progress' | 'waiting_for_user' | 'error' | 'canceled' | 'completed';
+    type: 'payment' | 'subscription' | 'cancellation';
+    method: 'card' | 'crypto' | 'x402' | null;
+    approach: 'browser' | 'api' | null;
+    amount_total: number | null;
+    currency: string | null;
+    merchant_name: string | null;
+    description: string | null;
+    current_request_id: string | null;
+    last_event_seq: number;
+    error_code: string | null;
+    error_message: string | null;
+    context: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+}
+export interface SessionBackendEvent {
+    id: string;
+    sequence_no: number;
+    type: 'state' | 'observe' | 'reflect' | 'action' | 'error';
+    actor: string;
+    summary: string;
+    payload: Record<string, unknown>;
+    created_at: string;
+}
+export interface SessionBackendRequest {
+    id: string;
+    intent_session_id: string;
+    sequence_no: number;
+    type: 'secret_read' | 'secret_write' | 'purchase' | 'payment_approval' | 'captcha' | 'alert';
+    status: 'pending' | 'fulfilled' | 'denied' | 'expired' | 'failed' | 'canceled';
+    blocking: boolean;
+    title: string;
+    summary: string | null;
+    payload: Record<string, unknown>;
+    response_payload: Record<string, unknown> | null;
+    resolution_channel: string | null;
+    created_at: string;
+    updated_at: string;
+    expires_at: string | null;
+    resolved_at: string | null;
+    delivery_channels: unknown[];
+    error_code: string | null;
+    error_message: string | null;
+}
+export interface SessionBackendSecretCatalogEntry {
+    id: string;
+    kind: 'payment_card' | 'login' | 'identity';
+    display_name: string;
+    description: string | null;
+    status: string;
+    source: 'database_values' | 'payment_account_provider';
+    fields: Array<{
+        key: string;
+        label: string;
+        type: 'text' | 'secret' | 'date' | 'number';
+        required: boolean;
+    }>;
+    applicability: {
+        mode: 'global' | 'hosts';
+        hosts?: string[];
+    };
+    metadata: Record<string, unknown>;
+}
+export interface CreateRemoteSessionInput {
+    browserSessionId: string;
+    description?: string | null;
+    merchantName?: string | null;
+    page?: {
+        ref?: string;
+        url?: string;
+        title?: string;
+    };
+    run: {
+        id: string;
+        started_at: string;
+        ended_at?: string;
+        source?: 'cli' | 'test' | 'replay';
+        status?: 'running' | 'completed' | 'failed' | 'aborted';
+        profile?: string;
+        site_host?: string;
+        protected_run?: boolean;
+    };
+    step: {
+        id: string;
+        ordinal: number;
+        command: string;
+        started_at: string;
+        ended_at?: string;
+        success?: boolean;
+        outcome_type?: string;
+        message?: string;
+        reason?: string;
+        page_ref?: string;
+        target_ref?: string;
+        surface_ref?: string;
+        fill_ref?: string;
+        before_snapshot_id?: string;
+        after_snapshot_id?: string;
+        event_count?: number;
+        child_span_count?: number;
+        protected_step?: boolean;
+    };
+    context?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionResponse {
+    session: SessionBackendSession;
+    current_request: SessionBackendCurrentRequest | null;
+    browser_session_id: string | null;
+}
+export interface RemoteSessionEventEnvelope extends SessionResponse {
+    event: SessionBackendEvent;
+    duplicate: boolean;
+}
+export type CompleteRemoteSessionResponse = RemoteSessionEventEnvelope;
+export interface RemoteSecretRequestEnvelope extends SessionResponse {
+    request: SessionBackendRequest;
+    reused: boolean;
+    duplicate: boolean;
+}
+export interface RemoteSessionSecretRequestEnvelope extends SessionResponse {
+    request: SessionBackendRequest;
+}
+export interface ClaimedRemoteSecret {
+    values: Record<string, string>;
+    source: 'saved_secret' | 'saved_credential' | 'inline_response';
+    stored_secret_ref: string | null;
+    credential_id: string | null;
+    kind: 'login' | 'identity' | 'payment_card' | null;
+}
+export interface ClaimRemoteSecretResponse {
+    request_id: string;
+    secret: ClaimedRemoteSecret;
+    issued_at: string;
+    expires_at: string | null;
+}
+export interface CreateRemoteSessionEventInput {
+    clientEventId: string;
+    sequenceNo: number;
+    type: 'state' | 'observe' | 'reflect' | 'action' | 'error';
+    command: string;
+    status: 'started' | 'completed' | 'blocked' | 'failed';
+    summary: string;
+    timestamp: string;
+    page?: {
+        ref?: string;
+        url?: string;
+        title?: string;
+    };
+    details?: Record<string, unknown>;
+    run?: {
+        id: string;
+        started_at: string;
+        ended_at?: string;
+        source?: 'cli' | 'test' | 'replay';
+        status?: 'running' | 'completed' | 'failed' | 'aborted';
+        profile?: string;
+        site_host?: string;
+        protected_run?: boolean;
+    };
+    step?: {
+        id: string;
+        ordinal: number;
+        command: string;
+        started_at: string;
+        ended_at?: string;
+        success?: boolean;
+        outcome_type?: string;
+        message?: string;
+        reason?: string;
+        page_ref?: string;
+        target_ref?: string;
+        surface_ref?: string;
+        fill_ref?: string;
+        before_snapshot_id?: string;
+        after_snapshot_id?: string;
+        event_count?: number;
+        child_span_count?: number;
+        protected_step?: boolean;
+    };
+}
+export interface CompleteRemoteSessionInput {
+    clientCompletionId: string;
+    status: 'completed' | 'canceled' | 'error';
+    command: string;
+    summary: string;
+    timestamp: string;
+    page?: {
+        ref?: string;
+        url?: string;
+        title?: string;
+    };
+    details?: Record<string, unknown>;
+    run: {
+        id: string;
+        started_at: string;
+        ended_at?: string;
+        source?: 'cli' | 'test' | 'replay';
+        status: 'completed' | 'failed' | 'aborted';
+        profile?: string;
+        site_host?: string;
+        protected_run?: boolean;
+    };
+    step?: {
+        id: string;
+        ordinal: number;
+        command: string;
+        started_at: string;
+        ended_at?: string;
+        success?: boolean;
+        outcome_type?: string;
+        message?: string;
+        reason?: string;
+        page_ref?: string;
+        target_ref?: string;
+        surface_ref?: string;
+        fill_ref?: string;
+        before_snapshot_id?: string;
+        after_snapshot_id?: string;
+        event_count?: number;
+        child_span_count?: number;
+        protected_step?: boolean;
+    };
+}
+export interface CreateRemoteSecretRequestInput {
+    clientRequestId: string;
+    fillRef: string;
+    purpose: string;
+    merchantName: string;
+    page?: {
+        ref?: string;
+        url?: string;
+        title?: string;
+    };
+    secretHint: {
+        storedSecretRef?: string;
+        credentialKey?: string;
+        credentialName?: string;
+        kind?: 'login' | 'identity' | 'payment_card';
+        host?: string;
+        scopeRef?: string;
+        fields?: Array<{
+            key: string;
+            label?: string;
+            type?: 'text' | 'secret' | 'date' | 'number';
+            required?: boolean;
+        }>;
+    };
+    run?: {
+        id: string;
+        started_at: string;
+        ended_at?: string;
+        source?: 'cli' | 'test' | 'replay';
+        status?: 'running' | 'completed' | 'failed' | 'aborted';
+        profile?: string;
+        site_host?: string;
+        protected_run?: boolean;
+    };
+    step?: {
+        id: string;
+        ordinal: number;
+        command: string;
+        started_at: string;
+        ended_at?: string;
+        success?: boolean;
+        outcome_type?: string;
+        message?: string;
+        reason?: string;
+        page_ref?: string;
+        target_ref?: string;
+        surface_ref?: string;
+        fill_ref?: string;
+        before_snapshot_id?: string;
+        after_snapshot_id?: string;
+        event_count?: number;
+        child_span_count?: number;
+        protected_step?: boolean;
+    };
+}
+export declare function createRemoteSession(gateway: MagicPayGatewayConfig, input: CreateRemoteSessionInput, options?: MagicPayRequestOptions): Promise<SessionResponse>;
+export declare function getRemoteSession(gateway: MagicPayGatewayConfig, sessionId: string, options?: MagicPayRequestOptions): Promise<SessionResponse>;
+export declare function getRemoteSessionSecretCatalog(gateway: MagicPayGatewayConfig, sessionId: string, host: string, options?: MagicPayRequestOptions): Promise<SessionBackendSecretCatalogEntry[]>;
+export declare function createRemoteSessionEvent(gateway: MagicPayGatewayConfig, sessionId: string, input: CreateRemoteSessionEventInput, options?: MagicPayRequestOptions): Promise<RemoteSessionEventEnvelope>;
+export declare function completeRemoteSession(gateway: MagicPayGatewayConfig, sessionId: string, input: CompleteRemoteSessionInput, options?: MagicPayRequestOptions): Promise<CompleteRemoteSessionResponse>;
+export declare function createRemoteSecretRequest(gateway: MagicPayGatewayConfig, sessionId: string, input: CreateRemoteSecretRequestInput, options?: MagicPayRequestOptions): Promise<RemoteSecretRequestEnvelope>;
+export declare function getRemoteSecretRequest(gateway: MagicPayGatewayConfig, sessionId: string, requestId: string, options?: MagicPayRequestOptions): Promise<RemoteSessionSecretRequestEnvelope>;
+export declare function claimRemoteSecret(gateway: MagicPayGatewayConfig, sessionId: string, requestId: string, claimId: string, options?: MagicPayRequestOptions): Promise<ClaimRemoteSecretResponse>;
+//# sourceMappingURL=session-client.d.ts.map

package/dist/session-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-client.d.ts","sourceRoot":"","sources":["../src/session-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAE3B,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7F,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,GAAG,kBAAkB,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;IAChF,IAAI,EAAE,SAAS,GAAG,cAAc,GAAG,cAAc,CAAC;IAClD,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,kBAAkB,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7F,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,OAAO,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gCAAgC;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,cAAc,GAAG,OAAO,GAAG,UAAU,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,iBAAiB,GAAG,0BAA0B,CAAC;IACvD,MAAM,EAAE,KAAK,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;QAC5C,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,aAAa,EAAE;QACb,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QACxD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,eAAe,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACrD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,0BAA2B,SAAQ,eAAe;IACjE,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,6BAA6B,GAAG,0BAA0B,CAAC;AAEvE,MAAM,WAAW,2BAA4B,SAAQ,eAAe;IAClE,OAAO,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kCAAmC,SAAQ,eAAe;IACzE,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,EAAE,cAAc,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;IAChE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QACxD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,EAAE;QACH,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,EAAE;QACV,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;QAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,KAAK,CAAC;YACb,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;YAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACJ,CAAC;IACF,GAAG,CAAC,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;QACxD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,wBAAwB,EAC/B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC,CAkB1B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,eAAe,CAAC,CAQ1B;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,gCAAgC,EAAE,CAAC,CAQ7C;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,6BAA6B,EACpC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAoBrC;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,0BAA0B,EACjC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,6BAA6B,CAAC,CAkBxC;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,8BAA8B,EACrC,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,2BAA2B,CAAC,CA+BtC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,kCAAkC,CAAC,CAQ7C;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,yBAAyB,CAAC,CAUpC"}

package/dist/session-client.js

@@ -0,0 +1,82 @@
+import { buildMagicPayClaimSecretUrl, buildMagicPayCompleteSessionUrl, buildMagicPaySessionEventsUrl, buildMagicPaySessionSecretRequestUrl, buildMagicPaySessionSecretRequestsUrl, buildMagicPaySessionSecretsCatalogUrl, buildMagicPaySessionUrl, buildMagicPaySessionsUrl, requestMagicPayJson, } from './gateway.js';
+export async function createRemoteSession(gateway, input, options = {}) {
+    return requestMagicPayJson(gateway, 'POST', buildMagicPaySessionsUrl(gateway.apiUrl), {
+        browser_session_id: input.browserSessionId,
+        entry_command: 'start-session',
+        ...(input.description ? { description: input.description } : {}),
+        ...(input.merchantName ? { merchant_name: input.merchantName } : {}),
+        ...(input.page ? { page: input.page } : {}),
+        ...(input.context ? { context: input.context } : {}),
+        ...(input.metadata ? { metadata: input.metadata } : {}),
+        run: input.run,
+        step: input.step,
+    }, options);
+}
+export async function getRemoteSession(gateway, sessionId, options = {}) {
+    return requestMagicPayJson(gateway, 'GET', buildMagicPaySessionUrl(gateway.apiUrl, sessionId), undefined, options);
+}
+export async function getRemoteSessionSecretCatalog(gateway, sessionId, host, options = {}) {
+    return requestMagicPayJson(gateway, 'GET', `${buildMagicPaySessionSecretsCatalogUrl(gateway.apiUrl, sessionId)}?host=${encodeURIComponent(host)}`, undefined, options);
+}
+export async function createRemoteSessionEvent(gateway, sessionId, input, options = {}) {
+    return requestMagicPayJson(gateway, 'POST', buildMagicPaySessionEventsUrl(gateway.apiUrl, sessionId), {
+        client_event_id: input.clientEventId,
+        sequence_no: input.sequenceNo,
+        type: input.type,
+        command: input.command,
+        status: input.status,
+        summary: input.summary,
+        timestamp: input.timestamp,
+        ...(input.page ? { page: input.page } : {}),
+        ...(input.details ? { details: input.details } : {}),
+        ...(input.run ? { run: input.run } : {}),
+        ...(input.step ? { step: input.step } : {}),
+    }, options);
+}
+export async function completeRemoteSession(gateway, sessionId, input, options = {}) {
+    return requestMagicPayJson(gateway, 'POST', buildMagicPayCompleteSessionUrl(gateway.apiUrl, sessionId), {
+        client_completion_id: input.clientCompletionId,
+        status: input.status,
+        command: input.command,
+        summary: input.summary,
+        timestamp: input.timestamp,
+        ...(input.page ? { page: input.page } : {}),
+        ...(input.details ? { details: input.details } : {}),
+        run: input.run,
+        ...(input.step ? { step: input.step } : {}),
+    }, options);
+}
+export async function createRemoteSecretRequest(gateway, sessionId, input, options = {}) {
+    return requestMagicPayJson(gateway, 'POST', buildMagicPaySessionSecretRequestsUrl(gateway.apiUrl, sessionId), {
+        client_request_id: input.clientRequestId,
+        fill_ref: input.fillRef,
+        purpose: input.purpose,
+        merchant_name: input.merchantName,
+        ...(input.page ? { page: input.page } : {}),
+        secret_hint: {
+            ...(input.secretHint.storedSecretRef
+                ? { stored_secret_ref: input.secretHint.storedSecretRef }
+                : {}),
+            ...(input.secretHint.credentialKey
+                ? { credential_key: input.secretHint.credentialKey }
+                : {}),
+            ...(input.secretHint.credentialName
+                ? { credential_name: input.secretHint.credentialName }
+                : {}),
+            ...(input.secretHint.kind ? { kind: input.secretHint.kind } : {}),
+            ...(input.secretHint.host ? { host: input.secretHint.host } : {}),
+            ...(input.secretHint.scopeRef ? { scope_ref: input.secretHint.scopeRef } : {}),
+            ...(input.secretHint.fields ? { fields: input.secretHint.fields } : {}),
+        },
+        ...(input.run ? { run: input.run } : {}),
+        ...(input.step ? { step: input.step } : {}),
+    }, options);
+}
+export async function getRemoteSecretRequest(gateway, sessionId, requestId, options = {}) {
+    return requestMagicPayJson(gateway, 'GET', buildMagicPaySessionSecretRequestUrl(gateway.apiUrl, sessionId, requestId), undefined, options);
+}
+export async function claimRemoteSecret(gateway, sessionId, requestId, claimId, options = {}) {
+    return requestMagicPayJson(gateway, 'POST', buildMagicPayClaimSecretUrl(gateway.apiUrl, sessionId, requestId), {
+        claim_id: claimId,
+    }, options);
+}

package/dist/session-flow.d.ts

@@ -0,0 +1,42 @@
+import { type MagicPayGatewayConfig } from './gateway.js';
+import { type CreateRemoteSessionInput, type CompleteRemoteSessionInput, type CompleteRemoteSessionResponse } from './session-client.js';
+export type CompleteRemoteSessionFailureKind = 'already_closed' | 'not_found' | 'other';
+export type CompleteRemoteSessionOutcome = {
+    success: true;
+    response: CompleteRemoteSessionResponse;
+} | {
+    success: false;
+    kind: CompleteRemoteSessionFailureKind;
+    reason: string;
+};
+export type RemoteSessionPageSummary = {
+    ref?: string;
+    url?: string;
+    title?: string;
+};
+export declare function classifyCompleteRemoteSessionFailure(error: unknown): CompleteRemoteSessionFailureKind;
+export declare function buildCreateRemoteSessionInput(params: {
+    browserSessionId: string;
+    description?: string | null;
+    merchantName?: string | null;
+    page?: RemoteSessionPageSummary;
+    run: CreateRemoteSessionInput['run'];
+    step: CreateRemoteSessionInput['step'];
+    context?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}): CreateRemoteSessionInput;
+export declare function buildCompleteRemoteSessionInput(params: {
+    clientCompletionId: string;
+    status: CompleteRemoteSessionInput['status'];
+    command: CompleteRemoteSessionInput['command'];
+    summary: string;
+    timestamp: string;
+    page?: RemoteSessionPageSummary;
+    details?: Record<string, unknown>;
+    run: CompleteRemoteSessionInput['run'];
+    step?: CompleteRemoteSessionInput['step'];
+}): CompleteRemoteSessionInput;
+export declare function completeRemoteSessionWithOutcome(gateway: MagicPayGatewayConfig, sessionId: string, input: CompleteRemoteSessionInput, options?: {
+    fetchImpl?: typeof fetch;
+}): Promise<CompleteRemoteSessionOutcome>;
+//# sourceMappingURL=session-flow.d.ts.map

package/dist/session-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-flow.d.ts","sourceRoot":"","sources":["../src/session-flow.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,EACnC,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,gCAAgC,GAAG,gBAAgB,GAAG,WAAW,GAAG,OAAO,CAAC;AAExF,MAAM,MAAM,4BAA4B,GACpC;IACE,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,6BAA6B,CAAC;CACzC,GACD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,gCAAgC,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEN,MAAM,MAAM,wBAAwB,GAAG;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAmBF,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,OAAO,GACb,gCAAgC,CAUlC;AAMD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,GAAG,EAAE,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,wBAAwB,CAW3B;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACtD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,wBAAwB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,EAAE,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAC;CAC3C,GAAG,0BAA0B,CAY7B;AAED,wBAAsB,gCAAgC,CACpD,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,0BAA0B,EACjC,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GACzC,OAAO,CAAC,4BAA4B,CAAC,CAavC"}

package/dist/session-flow.js

@@ -0,0 +1,71 @@
+import { getMagicPayErrorCode, isMagicPayRequestErrorStatus, } from './gateway.js';
+import { completeRemoteSession, } from './session-client.js';
+function formatUnknownSdkError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error && typeof error === 'object') {
+        try {
+            return JSON.stringify(error);
+        }
+        catch {
+            return Object.prototype.toString.call(error);
+        }
+    }
+    return String(error);
+}
+export function classifyCompleteRemoteSessionFailure(error) {
+    if (getMagicPayErrorCode(error) === 'session_closed') {
+        return 'already_closed';
+    }
+    if (isMagicPayRequestErrorStatus(error, 404)) {
+        return 'not_found';
+    }
+    return 'other';
+}
+function hasRemoteSessionPageSummary(page) {
+    return Boolean(page?.ref || page?.url || page?.title);
+}
+export function buildCreateRemoteSessionInput(params) {
+    return {
+        browserSessionId: params.browserSessionId,
+        ...(params.description ? { description: params.description } : {}),
+        ...(params.merchantName ? { merchantName: params.merchantName } : {}),
+        ...(hasRemoteSessionPageSummary(params.page) ? { page: params.page } : {}),
+        run: params.run,
+        step: params.step,
+        ...(params.context ? { context: params.context } : {}),
+        ...(params.metadata ? { metadata: params.metadata } : {}),
+    };
+}
+export function buildCompleteRemoteSessionInput(params) {
+    return {
+        clientCompletionId: params.clientCompletionId,
+        status: params.status,
+        command: params.command,
+        summary: params.summary,
+        timestamp: params.timestamp,
+        ...(hasRemoteSessionPageSummary(params.page) ? { page: params.page } : {}),
+        ...(params.details ? { details: params.details } : {}),
+        run: params.run,
+        ...(params.step ? { step: params.step } : {}),
+    };
+}
+export async function completeRemoteSessionWithOutcome(gateway, sessionId, input, options = {}) {
+    try {
+        return {
+            success: true,
+            response: await completeRemoteSession(gateway, sessionId, input, options),
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            kind: classifyCompleteRemoteSessionFailure(error),
+            reason: formatUnknownSdkError(error),
+        };
+    }
+}