@prood/checkout

pnpm add @prood/checkout

import { CheckoutSession } from '@prood/checkout'
import { StripePaymentProvider } from '@prood/payment-stripe'

const provider = new StripePaymentProvider({ secretKey: 'sk_...' })

const session = new CheckoutSession({
  provider,
  amount: 9999,
  currency: 'EUR',
  orderId: 'ord_123',
  returnUrl: 'https://store.example.com/order-confirmation',
  fulfillment: 'shipping',
})

session.setCustomerInfo({
  email: 'customer@example.com',
  firstName: 'Maria',
  lastName: 'Silva',
  phone: '+351912345678',
})

session.setShippingAddress({
  street: 'Rua Augusta 123',
  city: 'Lisboa',
  country: 'PT',
  postalCode: '1100-053',
  street2: null,
  state: null,
  district: null,
  nationalAddress: null,
})

const paymentSession = await session.submitPayment({
  sourceToken: 'pm_xxx',
})

if (paymentSession.redirectUrl) {
  // Redirect for 3DS
}

const confirmed = await session.confirmPayment(chargeId)
// session.state === 'complete' | 'failed'

session.handleWebhookUpdate({
  id: event.id,
  providerId: 'stripe',
  status: 'captured',
  amount: 9999,
  currency: 'EUR',
  redirectUrl: null,
  createdAt: new Date().toISOString(),
})

session.on('stateChange', ({ from, to }) => { ... })
session.on('complete', ({ paymentSession }) => { ... })
session.on('error', ({ error, state }) => { ... })
session.on('expired', () => { ... })

const snapshot = session.toSnapshot()
// Serializable — used by @prood/checkout-host for Redis persistence

CheckoutSession.fromSnapshot(snapshot, provider)
// Rehydrate from saved state

export { CheckoutSession } from '@prood/checkout'
export { buildTransitions } from '@prood/checkout'
export type { CheckoutState, CheckoutSnapshot, CheckoutChannel } from '@prood/checkout'