@commercejs/checkout 0.1.0

package/dist/__tests__/checkout-session.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=checkout-session.test.d.ts.map

package/dist/__tests__/checkout-session.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-session.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/checkout-session.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/checkout-session.test.js

@@ -0,0 +1,357 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { CheckoutSession } from '../checkout-session.js';
+// ---------------------------------------------------------------------------
+// Mock helpers
+// ---------------------------------------------------------------------------
+function mockPaymentSession(overrides = {}) {
+    return {
+        id: 'ps_test_123',
+        providerId: 'mock',
+        status: 'pending',
+        amount: 99.99,
+        currency: 'SAR',
+        providerData: null,
+        redirectUrl: 'https://gateway.com/3ds/abc',
+        createdAt: '2026-02-09T12:00:00Z',
+        ...overrides,
+    };
+}
+function mockProvider(overrides = {}) {
+    return {
+        id: 'mock',
+        name: 'Mock Provider',
+        createSession: vi.fn().mockResolvedValue(mockPaymentSession()),
+        confirmSession: vi.fn().mockResolvedValue(mockPaymentSession({ status: 'captured' })),
+        getSession: vi.fn().mockResolvedValue(mockPaymentSession()),
+        refund: vi.fn().mockResolvedValue(mockPaymentSession({ status: 'refunded' })),
+        ...overrides,
+    };
+}
+function defaultConfig(overrides = {}) {
+    return {
+        paymentProvider: mockProvider(),
+        currency: 'SAR',
+        amount: 99.99,
+        returnUrl: 'https://store.com/confirm',
+        ...overrides,
+    };
+}
+const address = {
+    firstName: 'Ali',
+    lastName: 'Ahmed',
+    phone: '+966500000000',
+    street: '123 King Fahd Rd',
+    street2: null,
+    city: 'Riyadh',
+    state: 'Riyadh',
+    country: 'SA',
+    postalCode: '12345',
+    district: null,
+    nationalAddress: null,
+    additionalNumber: null,
+};
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('CheckoutSession', () => {
+    let session;
+    beforeEach(() => {
+        session = new CheckoutSession(defaultConfig());
+    });
+    // ---- Initial state ----------------------------------------------------
+    describe('initial state', () => {
+        it('starts in idle state', () => {
+            expect(session.state).toBe('idle');
+        });
+        it('has correct config values', () => {
+            expect(session.amount).toBe(99.99);
+            expect(session.currency).toBe('SAR');
+        });
+        it('has null for all optional fields', () => {
+            expect(session.customerInfo).toBeNull();
+            expect(session.shippingAddress).toBeNull();
+            expect(session.billingAddress).toBeNull();
+            expect(session.shippingMethodId).toBeNull();
+            expect(session.paymentSession).toBeNull();
+            expect(session.orderId).toBeNull();
+            expect(session.error).toBeNull();
+        });
+    });
+    // ---- setCustomerInfo --------------------------------------------------
+    describe('setCustomerInfo', () => {
+        it('transitions idle → info', () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            expect(session.state).toBe('info');
+            expect(session.customerInfo?.email).toBe('ali@example.com');
+        });
+        it('throws if not in idle state', () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            expect(() => session.setCustomerInfo({ email: 'x@x.com' }))
+                .toThrow('Invalid transition');
+        });
+    });
+    // ---- setShippingAddress -----------------------------------------------
+    describe('setShippingAddress', () => {
+        it('transitions info → shipping', () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            expect(session.state).toBe('shipping');
+            expect(session.shippingAddress?.city).toBe('Riyadh');
+        });
+        it('defaults billing address to shipping address', () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            expect(session.billingAddress).toEqual(address);
+        });
+        it('allows separate billing address', () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            const billing = { ...address, city: 'Jeddah' };
+            session.setShippingAddress(address, billing);
+            expect(session.shippingAddress?.city).toBe('Riyadh');
+            expect(session.billingAddress?.city).toBe('Jeddah');
+        });
+        it('throws if not in info state', () => {
+            expect(() => session.setShippingAddress(address))
+                .toThrow('Invalid transition');
+        });
+    });
+    // ---- setShippingMethod ------------------------------------------------
+    describe('setShippingMethod', () => {
+        it('sets method ID in shipping state', () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('express');
+            expect(session.shippingMethodId).toBe('express');
+        });
+        it('throws if not in shipping state', () => {
+            expect(() => session.setShippingMethod('express'))
+                .toThrow('Cannot set shipping method');
+        });
+    });
+    // ---- submitPayment ----------------------------------------------------
+    describe('submitPayment', () => {
+        beforeEach(() => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+        });
+        it('transitions shipping → payment when redirect needed', async () => {
+            await session.submitPayment({ sourceToken: 'tok_xxx' });
+            expect(session.state).toBe('payment');
+            expect(session.paymentSession?.redirectUrl).toBe('https://gateway.com/3ds/abc');
+        });
+        it('emits paymentAction with redirectUrl', async () => {
+            const fn = vi.fn();
+            session.on('paymentAction', fn);
+            await session.submitPayment({ sourceToken: 'tok_xxx' });
+            expect(fn).toHaveBeenCalledWith({ redirectUrl: 'https://gateway.com/3ds/abc' });
+        });
+        it('goes straight to complete if already captured', async () => {
+            const provider = mockProvider({
+                createSession: vi.fn().mockResolvedValue(mockPaymentSession({ status: 'captured', redirectUrl: null })),
+            });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            const completeFn = vi.fn();
+            session.on('complete', completeFn);
+            await session.submitPayment();
+            expect(session.state).toBe('complete');
+            expect(completeFn).toHaveBeenCalled();
+        });
+        it('transitions to failed on provider error', async () => {
+            const provider = mockProvider({
+                createSession: vi.fn().mockRejectedValue(new Error('Gateway down')),
+            });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            const errorFn = vi.fn();
+            session.on('error', errorFn);
+            await expect(session.submitPayment()).rejects.toThrow('Gateway down');
+            expect(session.state).toBe('failed');
+            expect(session.error?.message).toBe('Gateway down');
+            expect(errorFn).toHaveBeenCalled();
+        });
+        it('throws if not in shipping or failed state', async () => {
+            session = new CheckoutSession(defaultConfig());
+            await expect(session.submitPayment()).rejects.toThrow('Cannot submit payment');
+        });
+        it('passes sourceToken and idempotencyKey to provider', async () => {
+            const createSession = vi.fn().mockResolvedValue(mockPaymentSession());
+            const provider = mockProvider({ createSession });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            await session.submitPayment({
+                sourceToken: 'tok_abc',
+                idempotencyKey: 'idem_123',
+            });
+            expect(createSession).toHaveBeenCalledWith(expect.objectContaining({
+                sourceToken: 'tok_abc',
+                idempotencyKey: 'idem_123',
+            }));
+        });
+    });
+    // ---- confirmPayment ---------------------------------------------------
+    describe('confirmPayment', () => {
+        beforeEach(async () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            await session.submitPayment({ sourceToken: 'tok_xxx' });
+        });
+        it('transitions payment → confirming → complete', async () => {
+            const stateChanges = [];
+            session.on('stateChange', (e) => stateChanges.push(e));
+            await session.confirmPayment('ps_test_123');
+            expect(session.state).toBe('complete');
+            expect(stateChanges).toEqual([
+                { from: 'payment', to: 'confirming' },
+                { from: 'confirming', to: 'complete' },
+            ]);
+        });
+        it('emits complete event', async () => {
+            const fn = vi.fn();
+            session.on('complete', fn);
+            await session.confirmPayment();
+            expect(fn).toHaveBeenCalledWith({
+                paymentSession: expect.objectContaining({ status: 'captured' }),
+            });
+        });
+        it('transitions to failed if payment failed', async () => {
+            const provider = mockProvider({
+                createSession: vi.fn().mockResolvedValue(mockPaymentSession()),
+                confirmSession: vi.fn().mockResolvedValue(mockPaymentSession({ status: 'failed' })),
+            });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            await session.submitPayment();
+            await expect(session.confirmPayment()).rejects.toThrow('Payment failed');
+            expect(session.state).toBe('failed');
+        });
+        it('uses stored session ID if none provided', async () => {
+            const confirmSession = vi.fn().mockResolvedValue(mockPaymentSession({ status: 'captured' }));
+            const provider = mockProvider({ confirmSession });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            await session.submitPayment();
+            await session.confirmPayment();
+            expect(confirmSession).toHaveBeenCalledWith('ps_test_123');
+        });
+        it('throws if not in payment state', async () => {
+            session = new CheckoutSession(defaultConfig());
+            await expect(session.confirmPayment('x')).rejects.toThrow('Cannot confirm payment');
+        });
+    });
+    // ---- Retry flow -------------------------------------------------------
+    describe('retry flow (failed → payment)', () => {
+        it('allows re-submitting payment after failure', async () => {
+            const createSession = vi.fn()
+                .mockRejectedValueOnce(new Error('Timeout'))
+                .mockResolvedValueOnce(mockPaymentSession());
+            const provider = mockProvider({ createSession });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            // First attempt fails
+            await expect(session.submitPayment()).rejects.toThrow('Timeout');
+            expect(session.state).toBe('failed');
+            // Retry succeeds
+            await session.submitPayment({ sourceToken: 'tok_retry' });
+            expect(session.state).toBe('payment');
+        });
+    });
+    // ---- State change events ----------------------------------------------
+    describe('stateChange events', () => {
+        it('fires on every transition through the full flow', async () => {
+            const changes = [];
+            const provider = mockProvider({
+                createSession: vi.fn().mockResolvedValue(mockPaymentSession({ status: 'captured', redirectUrl: null })),
+            });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.on('stateChange', (e) => changes.push(e));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            await session.submitPayment();
+            expect(changes).toEqual([
+                { from: 'idle', to: 'info' },
+                { from: 'info', to: 'shipping' },
+                { from: 'shipping', to: 'confirming' },
+                { from: 'confirming', to: 'complete' },
+            ]);
+        });
+    });
+    // ---- Setters ----------------------------------------------------------
+    describe('setAmount', () => {
+        it('updates amount before payment', () => {
+            session.setAmount(200);
+            expect(session.amount).toBe(200);
+        });
+        it('throws if in complete state', async () => {
+            const provider = mockProvider({
+                createSession: vi.fn().mockResolvedValue(mockPaymentSession({ status: 'captured', redirectUrl: null })),
+            });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            await session.submitPayment();
+            expect(() => session.setAmount(200)).toThrow('Cannot update amount');
+        });
+    });
+    describe('setOrderId', () => {
+        it('sets order ID', () => {
+            session.setOrderId('order-abc');
+            expect(session.orderId).toBe('order-abc');
+        });
+    });
+    // ---- toSnapshot -------------------------------------------------------
+    describe('toSnapshot', () => {
+        it('returns serializable snapshot', () => {
+            session.setCustomerInfo({ email: 'ali@example.com', firstName: 'Ali' });
+            const snap = session.toSnapshot();
+            expect(snap.state).toBe('info');
+            expect(snap.customerInfo).toEqual({ email: 'ali@example.com', firstName: 'Ali' });
+            expect(snap.amount).toBe(99.99);
+            expect(snap.currency).toBe('SAR');
+            expect(snap.error).toBeNull();
+        });
+        it('includes error message when failed', async () => {
+            const provider = mockProvider({
+                createSession: vi.fn().mockRejectedValue(new Error('Oops')),
+            });
+            session = new CheckoutSession(defaultConfig({ paymentProvider: provider }));
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            session.setShippingMethod('standard');
+            await session.submitPayment().catch(() => { });
+            const snap = session.toSnapshot();
+            expect(snap.state).toBe('failed');
+            expect(snap.error).toBe('Oops');
+        });
+    });
+    // ---- Invalid transitions ----------------------------------------------
+    describe('invalid transitions', () => {
+        it('cannot skip from idle to shipping', () => {
+            expect(() => session.setShippingAddress(address))
+                .toThrow('Invalid transition: "idle" → "shipping"');
+        });
+        it('cannot go backwards from shipping to info', () => {
+            session.setCustomerInfo({ email: 'ali@example.com' });
+            session.setShippingAddress(address);
+            expect(() => session.setCustomerInfo({ email: 'other@example.com' }))
+                .toThrow('Invalid transition');
+        });
+    });
+});
+//# sourceMappingURL=checkout-session.test.js.map

package/dist/__tests__/checkout-session.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-session.test.js","sourceRoot":"","sources":["../../src/__tests__/checkout-session.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/events.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.test.d.ts.map

package/dist/__tests__/events.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/events.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/events.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect, vi } from 'vitest';
+import { EventEmitter } from '../events.js';
+describe('EventEmitter', () => {
+    // Expose emit for testing by subclassing
+    class TestEmitter extends EventEmitter {
+        fire(event, data) {
+            this.emit(event, data);
+        }
+    }
+    it('calls listener on emit', () => {
+        const emitter = new TestEmitter();
+        const fn = vi.fn();
+        emitter.on('ping', fn);
+        emitter.fire('ping', { value: 42 });
+        expect(fn).toHaveBeenCalledWith({ value: 42 });
+    });
+    it('supports multiple listeners', () => {
+        const emitter = new TestEmitter();
+        const fn1 = vi.fn();
+        const fn2 = vi.fn();
+        emitter.on('ping', fn1);
+        emitter.on('ping', fn2);
+        emitter.fire('ping', { value: 1 });
+        expect(fn1).toHaveBeenCalledOnce();
+        expect(fn2).toHaveBeenCalledOnce();
+    });
+    it('unsubscribes via returned function', () => {
+        const emitter = new TestEmitter();
+        const fn = vi.fn();
+        const unsub = emitter.on('ping', fn);
+        unsub();
+        emitter.fire('ping', { value: 1 });
+        expect(fn).not.toHaveBeenCalled();
+    });
+    it('once fires only once', () => {
+        const emitter = new TestEmitter();
+        const fn = vi.fn();
+        emitter.once('ping', fn);
+        emitter.fire('ping', { value: 1 });
+        emitter.fire('ping', { value: 2 });
+        expect(fn).toHaveBeenCalledOnce();
+        expect(fn).toHaveBeenCalledWith({ value: 1 });
+    });
+    it('removeAllListeners clears everything', () => {
+        const emitter = new TestEmitter();
+        const fn = vi.fn();
+        emitter.on('ping', fn);
+        emitter.on('pong', fn);
+        emitter.removeAllListeners();
+        emitter.fire('ping', { value: 1 });
+        emitter.fire('pong', { message: 'hi' });
+        expect(fn).not.toHaveBeenCalled();
+    });
+    it('does not throw when emitting with no listeners', () => {
+        const emitter = new TestEmitter();
+        expect(() => emitter.fire('ping', { value: 1 })).not.toThrow();
+    });
+});
+//# sourceMappingURL=events.test.js.map

package/dist/__tests__/events.test.js.map

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

package/dist/checkout-session.d.ts

@@ -0,0 +1,126 @@
+import type { Address, PaymentSession } from '@commercejs/types';
+import { EventEmitter } from './events.js';
+import type { CheckoutState, CheckoutSessionConfig, CheckoutCustomerInfo, CheckoutSnapshot, CheckoutEvents } from './types.js';
+/**
+ * Universal checkout session — a state machine that orchestrates the
+ * checkout flow from customer info through payment and confirmation.
+ *
+ * Framework-agnostic: use it in a Nuxt app, a React app, a CLI, or
+ * directly on the server.
+ *
+ * @example
+ * ```ts
+ * import { CheckoutSession } from '@commercejs/checkout'
+ * import { TapPaymentProvider } from '@commercejs/payment-tap'
+ *
+ * const session = new CheckoutSession({
+ *   paymentProvider: new TapPaymentProvider({ secretKey: 'sk_test_...' }),
+ *   currency: 'SAR',
+ *   amount: 199.99,
+ *   returnUrl: 'https://checkout.mystore.com/session123/confirm',
+ * })
+ *
+ * // Listen for events
+ * session.on('stateChange', ({ from, to }) => console.log(`${from} → ${to}`))
+ * session.on('paymentAction', ({ redirectUrl }) => window.location.href = redirectUrl)
+ * session.on('complete', ({ paymentSession }) => console.log('Done!', paymentSession))
+ *
+ * // Walk through the flow
+ * session.setCustomerInfo({ email: 'ali@example.com', firstName: 'Ali' })
+ * session.setShippingAddress({ street: '...', city: 'Riyadh', ... })
+ * session.setShippingMethod('standard')
+ * await session.submitPayment({ sourceToken: 'tok_xxx' })
+ * // → customer redirected for 3DS
+ * await session.confirmPayment('chg_abc123')
+ * // → session.state === 'complete'
+ * ```
+ */
+export declare class CheckoutSession extends EventEmitter<CheckoutEvents> {
+    private _state;
+    private _customerInfo;
+    private _shippingAddress;
+    private _billingAddress;
+    private _shippingMethodId;
+    private _paymentSession;
+    private _error;
+    private readonly provider;
+    private _amount;
+    private _currency;
+    private _returnUrl;
+    private _cancelUrl;
+    private _orderId;
+    private _webhookUrl;
+    constructor(config: CheckoutSessionConfig);
+    get state(): CheckoutState;
+    get customerInfo(): CheckoutCustomerInfo | null;
+    get shippingAddress(): Omit<Address, 'id' | 'isDefault'> | null;
+    get billingAddress(): Omit<Address, 'id' | 'isDefault'> | null;
+    get shippingMethodId(): string | null;
+    get paymentSession(): PaymentSession | null;
+    get amount(): number;
+    get currency(): string;
+    get orderId(): string | null;
+    get error(): Error | null;
+    /**
+     * Set customer info and transition to `info` state.
+     * Must be in `idle` state.
+     */
+    setCustomerInfo(info: CheckoutCustomerInfo): void;
+    /**
+     * Set shipping address and transition to `shipping` state.
+     * Must be in `info` state.
+     * Optionally set billing address (defaults to shipping address).
+     */
+    setShippingAddress(address: Omit<Address, 'id' | 'isDefault'>, billingAddress?: Omit<Address, 'id' | 'isDefault'>): void;
+    /**
+     * Set shipping method.
+     * Can be called while in `shipping` state (does not transition — call
+     * `submitPayment` when ready to move to `payment`).
+     */
+    setShippingMethod(methodId: string): void;
+    /**
+     * Update the order amount. Can be called before payment is submitted.
+     */
+    setAmount(amount: number): void;
+    /**
+     * Set order ID (if not provided at construction time).
+     */
+    setOrderId(orderId: string): void;
+    /**
+     * Submit payment — creates a payment session with the provider.
+     * Must be in `shipping` or `failed` (retry) state.
+     *
+     * @param options - Optional overrides for the payment session
+     * @returns The payment session (may include a redirectUrl for 3DS)
+     */
+    submitPayment(options?: {
+        sourceToken?: string;
+        idempotencyKey?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<PaymentSession>;
+    /**
+     * Confirm payment after 3DS redirect or async completion.
+     * Must be in `payment` state.
+     *
+     * @param sessionId - The payment session ID to confirm (from redirect params)
+     * @returns The confirmed payment session
+     */
+    confirmPayment(sessionId?: string): Promise<PaymentSession>;
+    /**
+     * Handle an async webhook update from the payment provider.
+     *
+     * Unlike `confirmPayment`, this is for trusted server-side events and
+     * works from any non-terminal state. It directly transitions to
+     * `complete` or `failed` based on the payment status.
+     *
+     * @param paymentSession - The updated payment session from the webhook
+     */
+    handleWebhookUpdate(paymentSession: PaymentSession): void;
+    /** Get a serializable snapshot of the current session state */
+    toSnapshot(): CheckoutSnapshot;
+    /** Transition to a new state, emit stateChange event */
+    private transition;
+    /** Assert that a transition is valid, throw if not */
+    private assertTransition;
+}
+//# sourceMappingURL=checkout-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkout-session.d.ts","sourceRoot":"","sources":["../src/checkout-session.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAmB,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAA;AAGnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,eAAgB,SAAQ,YAAY,CAAC,cAAc,CAAC;IAE/D,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,gBAAgB,CAAiD;IACzE,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,eAAe,CAA8B;IACrD,OAAO,CAAC,MAAM,CAAqB;IAGnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,WAAW,CAAe;gBAEtB,MAAM,EAAE,qBAAqB;IAezC,IAAI,KAAK,IAAI,aAAa,CAAuB;IACjD,IAAI,YAAY,IAAI,oBAAoB,GAAG,IAAI,CAA8B;IAC7E,IAAI,eAAe,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI,CAAiC;IAChG,IAAI,cAAc,IAAI,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI,CAAgC;IAC9F,IAAI,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAAkC;IACvE,IAAI,cAAc,IAAI,cAAc,GAAG,IAAI,CAAgC;IAC3E,IAAI,MAAM,IAAI,MAAM,CAAwB;IAC5C,IAAI,QAAQ,IAAI,MAAM,CAA0B;IAChD,IAAI,OAAO,IAAI,MAAM,GAAG,IAAI,CAAyB;IACrD,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAAuB;IAMhD;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAMjD;;;;OAIG;IACH,kBAAkB,CAChB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,EAC1C,cAAc,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,GACjD,IAAI;IAOP;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOzC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjC;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,GAAE;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,cAAc,CAAC,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAC9B,GAAG,OAAO,CAAC,cAAc,CAAC;IAqEhC;;;;;;OAMG;IACG,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA0CjE;;;;;;;;OAQG;IACH,mBAAmB,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAmCzD,+DAA+D;IAC/D,UAAU,IAAI,gBAAgB;IAmB9B,wDAAwD;IACxD,OAAO,CAAC,UAAU;IAMlB,sDAAsD;IACtD,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/checkout-session.js

@@ -0,0 +1,322 @@
+// ---------------------------------------------------------------------------
+// CheckoutSession — universal checkout state machine
+// ---------------------------------------------------------------------------
+//
+// Pure TypeScript, zero framework deps. Works in Node, Edge, or browser.
+//
+// State machine:
+//   idle → info → shipping → payment → confirming → complete
+//                                          ↓
+//                                       failed → payment (retry)
+// ---------------------------------------------------------------------------
+import { EventEmitter } from './events.js';
+import { CHECKOUT_TRANSITIONS } from './types.js';
+/**
+ * Universal checkout session — a state machine that orchestrates the
+ * checkout flow from customer info through payment and confirmation.
+ *
+ * Framework-agnostic: use it in a Nuxt app, a React app, a CLI, or
+ * directly on the server.
+ *
+ * @example
+ * ```ts
+ * import { CheckoutSession } from '@commercejs/checkout'
+ * import { TapPaymentProvider } from '@commercejs/payment-tap'
+ *
+ * const session = new CheckoutSession({
+ *   paymentProvider: new TapPaymentProvider({ secretKey: 'sk_test_...' }),
+ *   currency: 'SAR',
+ *   amount: 199.99,
+ *   returnUrl: 'https://checkout.mystore.com/session123/confirm',
+ * })
+ *
+ * // Listen for events
+ * session.on('stateChange', ({ from, to }) => console.log(`${from} → ${to}`))
+ * session.on('paymentAction', ({ redirectUrl }) => window.location.href = redirectUrl)
+ * session.on('complete', ({ paymentSession }) => console.log('Done!', paymentSession))
+ *
+ * // Walk through the flow
+ * session.setCustomerInfo({ email: 'ali@example.com', firstName: 'Ali' })
+ * session.setShippingAddress({ street: '...', city: 'Riyadh', ... })
+ * session.setShippingMethod('standard')
+ * await session.submitPayment({ sourceToken: 'tok_xxx' })
+ * // → customer redirected for 3DS
+ * await session.confirmPayment('chg_abc123')
+ * // → session.state === 'complete'
+ * ```
+ */
+export class CheckoutSession extends EventEmitter {
+    // --- Internal state ---
+    _state = 'idle';
+    _customerInfo = null;
+    _shippingAddress = null;
+    _billingAddress = null;
+    _shippingMethodId = null;
+    _paymentSession = null;
+    _error = null;
+    // --- Config ---
+    provider;
+    _amount;
+    _currency;
+    _returnUrl;
+    _cancelUrl;
+    _orderId;
+    _webhookUrl;
+    constructor(config) {
+        super();
+        this.provider = config.paymentProvider;
+        this._amount = config.amount;
+        this._currency = config.currency;
+        this._returnUrl = config.returnUrl ?? null;
+        this._cancelUrl = config.cancelUrl ?? null;
+        this._orderId = config.orderId ?? null;
+        this._webhookUrl = config.webhookUrl ?? null;
+    }
+    // ---------------------------------------------------------------------------
+    // Public getters (read-only)
+    // ---------------------------------------------------------------------------
+    get state() { return this._state; }
+    get customerInfo() { return this._customerInfo; }
+    get shippingAddress() { return this._shippingAddress; }
+    get billingAddress() { return this._billingAddress; }
+    get shippingMethodId() { return this._shippingMethodId; }
+    get paymentSession() { return this._paymentSession; }
+    get amount() { return this._amount; }
+    get currency() { return this._currency; }
+    get orderId() { return this._orderId; }
+    get error() { return this._error; }
+    // ---------------------------------------------------------------------------
+    // State transitions
+    // ---------------------------------------------------------------------------
+    /**
+     * Set customer info and transition to `info` state.
+     * Must be in `idle` state.
+     */
+    setCustomerInfo(info) {
+        this.assertTransition('info');
+        this._customerInfo = info;
+        this.transition('info');
+    }
+    /**
+     * Set shipping address and transition to `shipping` state.
+     * Must be in `info` state.
+     * Optionally set billing address (defaults to shipping address).
+     */
+    setShippingAddress(address, billingAddress) {
+        this.assertTransition('shipping');
+        this._shippingAddress = address;
+        this._billingAddress = billingAddress ?? address;
+        this.transition('shipping');
+    }
+    /**
+     * Set shipping method.
+     * Can be called while in `shipping` state (does not transition — call
+     * `submitPayment` when ready to move to `payment`).
+     */
+    setShippingMethod(methodId) {
+        if (this._state !== 'shipping') {
+            throw new Error(`Cannot set shipping method in "${this._state}" state`);
+        }
+        this._shippingMethodId = methodId;
+    }
+    /**
+     * Update the order amount. Can be called before payment is submitted.
+     */
+    setAmount(amount) {
+        if (this._state === 'confirming' || this._state === 'complete') {
+            throw new Error(`Cannot update amount in "${this._state}" state`);
+        }
+        this._amount = amount;
+    }
+    /**
+     * Set order ID (if not provided at construction time).
+     */
+    setOrderId(orderId) {
+        this._orderId = orderId;
+    }
+    // ---------------------------------------------------------------------------
+    // Payment flow
+    // ---------------------------------------------------------------------------
+    /**
+     * Submit payment — creates a payment session with the provider.
+     * Must be in `shipping` or `failed` (retry) state.
+     *
+     * @param options - Optional overrides for the payment session
+     * @returns The payment session (may include a redirectUrl for 3DS)
+     */
+    async submitPayment(options = {}) {
+        // Allow submission from `shipping` (normal flow) or `failed` (retry)
+        if (this._state !== 'shipping' && this._state !== 'failed') {
+            throw new Error(`Cannot submit payment in "${this._state}" state`);
+        }
+        this._error = null;
+        try {
+            const session = await this.provider.createSession({
+                amount: this._amount,
+                currency: this._currency,
+                sourceToken: options.sourceToken,
+                idempotencyKey: options.idempotencyKey,
+                orderId: this._orderId ?? undefined,
+                customerId: undefined, // future: from customerInfo lookup
+                customer: this._customerInfo
+                    ? {
+                        email: this._customerInfo.email,
+                        firstName: this._customerInfo.firstName,
+                        lastName: this._customerInfo.lastName,
+                        phone: this._customerInfo.phone,
+                    }
+                    : undefined,
+                returnUrl: this._returnUrl ?? undefined,
+                cancelUrl: this._cancelUrl ?? undefined,
+                webhookUrl: this._webhookUrl ?? undefined,
+                metadata: options.metadata,
+            });
+            this._paymentSession = session;
+            // If payment is already captured (no 3DS needed), go straight to complete
+            if (session.status === 'captured') {
+                this.transition('confirming');
+                this.transition('complete');
+                this.emit('complete', { paymentSession: session });
+                return session;
+            }
+            // If there's a redirect URL, customer needs to complete 3DS
+            if (session.redirectUrl) {
+                this.transition('payment');
+                this.emit('paymentAction', { redirectUrl: session.redirectUrl });
+                return session;
+            }
+            // If payment was instantly declined (no 3DS), fail immediately
+            if (session.status === 'failed' || session.status === 'cancelled') {
+                const error = new Error(`Payment ${session.status}`);
+                this._error = error;
+                this.transition('failed');
+                this.emit('error', { error, state: this._state });
+                throw error;
+            }
+            // If pending/processing, wait for confirmation
+            this.transition('payment');
+            return session;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this._error = error;
+            this.transition('failed');
+            this.emit('error', { error, state: this._state });
+            throw error;
+        }
+    }
+    /**
+     * Confirm payment after 3DS redirect or async completion.
+     * Must be in `payment` state.
+     *
+     * @param sessionId - The payment session ID to confirm (from redirect params)
+     * @returns The confirmed payment session
+     */
+    async confirmPayment(sessionId) {
+        if (this._state !== 'payment') {
+            throw new Error(`Cannot confirm payment in "${this._state}" state`);
+        }
+        const id = sessionId ?? this._paymentSession?.id;
+        if (!id) {
+            throw new Error('No payment session ID available for confirmation');
+        }
+        this.transition('confirming');
+        try {
+            const confirmed = await this.provider.confirmSession(id);
+            this._paymentSession = confirmed;
+            if (confirmed.status === 'captured') {
+                this.transition('complete');
+                this.emit('complete', { paymentSession: confirmed });
+                return confirmed;
+            }
+            if (confirmed.status === 'failed' || confirmed.status === 'cancelled') {
+                const error = new Error(`Payment ${confirmed.status}`);
+                this._error = error;
+                this.transition('failed');
+                this.emit('error', { error, state: this._state });
+                throw error;
+            }
+            // Still processing — caller should poll or wait for webhook
+            return confirmed;
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            this._error = error;
+            this.transition('failed');
+            this.emit('error', { error, state: this._state });
+            throw error;
+        }
+    }
+    /**
+     * Handle an async webhook update from the payment provider.
+     *
+     * Unlike `confirmPayment`, this is for trusted server-side events and
+     * works from any non-terminal state. It directly transitions to
+     * `complete` or `failed` based on the payment status.
+     *
+     * @param paymentSession - The updated payment session from the webhook
+     */
+    handleWebhookUpdate(paymentSession) {
+        // Don't update terminal states
+        if (this._state === 'complete')
+            return;
+        // Allow re-processing failed state (idempotent)
+        this._paymentSession = paymentSession;
+        if (paymentSession.status === 'captured') {
+            // Skip through intermediate states directly to complete
+            if (this._state !== 'confirming') {
+                this._state = 'confirming';
+            }
+            this.transition('complete');
+            this.emit('complete', { paymentSession });
+        }
+        else if (paymentSession.status === 'failed' ||
+            paymentSession.status === 'cancelled') {
+            const error = new Error(`Payment ${paymentSession.status} (webhook)`);
+            this._error = error;
+            // Force to failed regardless of current state
+            if (this._state !== 'failed') {
+                this._state = 'payment'; // ensure valid transition source
+                this.transition('failed');
+            }
+            this.emit('error', { error, state: this._state });
+        }
+        // For pending/processing — just update the payment session data
+    }
+    // ---------------------------------------------------------------------------
+    // Snapshot (for serialization / SSR hydration)
+    // ---------------------------------------------------------------------------
+    /** Get a serializable snapshot of the current session state */
+    toSnapshot() {
+        return {
+            state: this._state,
+            customerInfo: this._customerInfo,
+            shippingAddress: this._shippingAddress,
+            billingAddress: this._billingAddress,
+            shippingMethodId: this._shippingMethodId,
+            paymentSession: this._paymentSession,
+            amount: this._amount,
+            currency: this._currency,
+            orderId: this._orderId,
+            error: this._error?.message ?? null,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------------
+    /** Transition to a new state, emit stateChange event */
+    transition(to) {
+        const from = this._state;
+        this._state = to;
+        this.emit('stateChange', { from, to });
+    }
+    /** Assert that a transition is valid, throw if not */
+    assertTransition(to) {
+        const allowed = CHECKOUT_TRANSITIONS[this._state];
+        if (!allowed.includes(to)) {
+            throw new Error(`Invalid transition: "${this._state}" → "${to}". ` +
+                `Allowed: [${allowed.join(', ')}]`);
+        }
+    }
+}
+//# sourceMappingURL=checkout-session.js.map

package/dist/checkout-session.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,15 @@
+/** Generic typed event emitter */
+export declare class EventEmitter<TEvents extends {
+    [K in keyof TEvents]: unknown;
+}> {
+    private listeners;
+    /** Subscribe to an event. Returns an unsubscribe function. */
+    on<K extends keyof TEvents>(event: K, fn: (data: TEvents[K]) => void): () => void;
+    /** Subscribe to an event, but only fire once */
+    once<K extends keyof TEvents>(event: K, fn: (data: TEvents[K]) => void): () => void;
+    /** Emit an event to all listeners */
+    protected emit<K extends keyof TEvents>(event: K, data: TEvents[K]): void;
+    /** Remove all listeners (useful for cleanup) */
+    removeAllListeners(): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAIA,kCAAkC;AAClC,qBAAa,YAAY,CAAC,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,GAAG,OAAO;CAAE;IACzE,OAAO,CAAC,SAAS,CAAuD;IAExE,8DAA8D;IAC9D,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAYjF,gDAAgD;IAChD,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAQnF,qCAAqC;IACrC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAQzE,gDAAgD;IAChD,kBAAkB,IAAI,IAAI;CAG3B"}

package/dist/events.js

@@ -0,0 +1,40 @@
+// ---------------------------------------------------------------------------
+// Tiny typed event emitter — zero dependencies, < 40 lines
+// ---------------------------------------------------------------------------
+/** Generic typed event emitter */
+export class EventEmitter {
+    listeners = new Map();
+    /** Subscribe to an event. Returns an unsubscribe function. */
+    on(event, fn) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        const set = this.listeners.get(event);
+        set.add(fn);
+        return () => {
+            set.delete(fn);
+        };
+    }
+    /** Subscribe to an event, but only fire once */
+    once(event, fn) {
+        const unsub = this.on(event, (data) => {
+            unsub();
+            fn(data);
+        });
+        return unsub;
+    }
+    /** Emit an event to all listeners */
+    emit(event, data) {
+        const set = this.listeners.get(event);
+        if (!set)
+            return;
+        for (const fn of set) {
+            fn(data);
+        }
+    }
+    /** Remove all listeners (useful for cleanup) */
+    removeAllListeners() {
+        this.listeners.clear();
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,2DAA2D;AAC3D,8EAA8E;AAE9E,kCAAkC;AAClC,MAAM,OAAO,YAAY;IACf,SAAS,GAAG,IAAI,GAAG,EAA6C,CAAA;IAExE,8DAA8D;IAC9D,EAAE,CAA0B,KAAQ,EAAE,EAA8B;QAClE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;QACtC,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAA;QACtC,GAAG,CAAC,GAAG,CAAC,EAA2B,CAAC,CAAA;QAEpC,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,MAAM,CAAC,EAA2B,CAAC,CAAA;QACzC,CAAC,CAAA;IACH,CAAC;IAED,gDAAgD;IAChD,IAAI,CAA0B,KAAQ,EAAE,EAA8B;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE;YACpC,KAAK,EAAE,CAAA;YACP,EAAE,CAAC,IAAI,CAAC,CAAA;QACV,CAAC,CAAC,CAAA;QACF,OAAO,KAAK,CAAA;IACd,CAAC;IAED,qCAAqC;IAC3B,IAAI,CAA0B,KAAQ,EAAE,IAAgB;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACrC,IAAI,CAAC,GAAG;YAAE,OAAM;QAChB,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACpB,EAAiC,CAAC,IAAI,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,kBAAkB;QAChB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { CheckoutSession } from './checkout-session.js';
+export { EventEmitter } from './events.js';
+export { CHECKOUT_TRANSITIONS } from './types.js';
+export type { CheckoutState, CheckoutSessionConfig, CheckoutCustomerInfo, CheckoutSnapshot, CheckoutEvents, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACjD,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// ---------------------------------------------------------------------------
+// @commercejs/checkout — Universal checkout engine
+// ---------------------------------------------------------------------------
+export { CheckoutSession } from './checkout-session.js';
+export { EventEmitter } from './events.js';
+export { CHECKOUT_TRANSITIONS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,64 @@
+import type { Address, PaymentProvider, PaymentSession } from '@commercejs/types';
+/** All possible checkout states */
+export type CheckoutState = 'idle' | 'info' | 'shipping' | 'payment' | 'confirming' | 'complete' | 'failed';
+/** Allowed state transitions */
+export declare const CHECKOUT_TRANSITIONS: Record<CheckoutState, readonly CheckoutState[]>;
+/** Customer details collected during checkout */
+export interface CheckoutCustomerInfo {
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    phone?: string;
+}
+/** Configuration for creating a CheckoutSession */
+export interface CheckoutSessionConfig {
+    /** The payment provider to use for this session */
+    paymentProvider: PaymentProvider;
+    /** Currency code (e.g. 'SAR', 'USD') */
+    currency: string;
+    /** Total amount — can be updated before payment */
+    amount: number;
+    /** Where to return after 3DS/redirect */
+    returnUrl?: string;
+    /** Where to redirect on cancel */
+    cancelUrl?: string;
+    /** Merchant-specific order ID (if known at checkout start) */
+    orderId?: string;
+    /** Per-transaction webhook URL (e.g., Tap's post.url) */
+    webhookUrl?: string;
+}
+/** Serializable snapshot of the checkout session state */
+export interface CheckoutSnapshot {
+    state: CheckoutState;
+    customerInfo: CheckoutCustomerInfo | null;
+    shippingAddress: Omit<Address, 'id' | 'isDefault'> | null;
+    billingAddress: Omit<Address, 'id' | 'isDefault'> | null;
+    shippingMethodId: string | null;
+    paymentSession: PaymentSession | null;
+    amount: number;
+    currency: string;
+    orderId: string | null;
+    error: string | null;
+}
+/** Events emitted by CheckoutSession */
+export interface CheckoutEvents {
+    /** Fired on every state transition */
+    stateChange: {
+        from: CheckoutState;
+        to: CheckoutState;
+    };
+    /** Fired when payment requires customer action (redirect) */
+    paymentAction: {
+        redirectUrl: string;
+    };
+    /** Fired when checkout completes successfully */
+    complete: {
+        paymentSession: PaymentSession;
+    };
+    /** Fired on any error */
+    error: {
+        error: Error;
+        state: CheckoutState;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAIjF,mCAAmC;AACnC,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,MAAM,GACN,UAAU,GACV,SAAS,GACT,YAAY,GACZ,UAAU,GACV,QAAQ,CAAA;AAEZ,gCAAgC;AAChC,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,aAAa,EAAE,SAAS,aAAa,EAAE,CAQhF,CAAA;AAID,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,eAAe,EAAE,eAAe,CAAA;IAChC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAID,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,CAAA;IACpB,YAAY,EAAE,oBAAoB,GAAG,IAAI,CAAA;IACzC,eAAe,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI,CAAA;IACzD,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI,CAAA;IACxD,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAID,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,WAAW,EAAE;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,EAAE,EAAE,aAAa,CAAA;KAAE,CAAA;IACvD,6DAA6D;IAC7D,aAAa,EAAE;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,iDAAiD;IACjD,QAAQ,EAAE;QAAE,cAAc,EAAE,cAAc,CAAA;KAAE,CAAA;IAC5C,yBAAyB;IACzB,KAAK,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAA;CAC9C"}

package/dist/types.js

@@ -0,0 +1,14 @@
+// ---------------------------------------------------------------------------
+// Checkout engine types
+// ---------------------------------------------------------------------------
+/** Allowed state transitions */
+export const CHECKOUT_TRANSITIONS = {
+    idle: ['info'],
+    info: ['shipping'],
+    shipping: ['payment'],
+    payment: ['confirming', 'failed'],
+    confirming: ['complete', 'failed'],
+    complete: [], // terminal
+    failed: ['payment'], // retry
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAgB9E,gCAAgC;AAChC,MAAM,CAAC,MAAM,oBAAoB,GAAoD;IACnF,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,OAAO,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC;IACjC,UAAU,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAClC,QAAQ,EAAE,EAAE,EAAS,WAAW;IAChC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,QAAQ;CAC9B,CAAA"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@commercejs/checkout",
+  "version": "0.1.0",
+  "description": "Universal checkout engine — framework-agnostic state machine for payment flows",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@commercejs/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.0",
+    "@commercejs/types": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}