@usethrottle/checkout-sdk 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @usethrottle/checkout-sdk
 
+## 2.0.1
+
+### Patch Changes
+
+- Pass the failed response's headers into `ThrottleError` (and its per-SDK
+  subclasses) when constructing the error from a `fetch` `Response`, so
+  `error.requestId` now falls back to the `x-request-id` response header for
+  hand-built error bodies (401/403/500) that carry no `meta.requestId`. Bumps
+  `@usethrottle/errors` to `^1.1.0`, which added this fallback. `cli` and `mcp`
+  bundle `@usethrottle/errors` at build time and pick up the fix in their
+  published bundle.
+
 ## 2.0.0
 
 ### Major Changes

package/dist/server.cjs

@@ -79,7 +79,8 @@ var CheckoutClient = class {
           message: json.error?.message ?? `HTTP ${res.status}`,
           statusCode: res.status,
           details: json.error?.details,
-          body: json
+          body: json,
+          responseHeaders: res.headers
         });
       }
       return json;

package/dist/server.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import { ThrottleError } from '@usethrottle/errors';\n\n/**\n * `'embedded'` completes a card payment taken by the payment embed; `'net30'`\n * issues an invoice on terms. `'card'` names the card category in\n * `allowedMethods` — `completeSession` rejects it with 422\n * `payment_method_not_supported`. Use `'embedded'`.\n */\nexport type PaymentMethod = 'net30' | 'card' | 'embedded';\nexport type SubscriptionInterval = 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';\nexport type SubscriptionIntervalUnit = 'hour' | 'day' | 'week' | 'month';\nexport type CheckoutEmbedMode = 'checkout-full' | 'payment-only';\nexport type CheckoutEmbedRoute = 'c' | 's';\n\nexport interface CheckoutClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  timeoutMs?: number;\n}\n\nexport interface CheckoutAddress {\n  firstName: string;\n  lastName: string;\n  company?: string;\n  addressLine1: string;\n  addressLine2?: string;\n  city: string;\n  stateProvince: string;\n  postalCode: string;\n  countryCode: string;\n  phone?: string;\n}\n\nexport interface CheckoutCustomerAddressInput {\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  addressLine1?: string;\n  addressLine2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\nexport interface CheckoutCustomerInput {\n  customerId?: string;\n  externalCustomerId?: string;\n  email?: string;\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  shippingAddress?: CheckoutCustomerAddressInput;\n  billingAddress?: CheckoutCustomerAddressInput;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RecurringIntentInput {\n  plan: string;\n  /** A named interval. Or send intervalUnit + intervalCount for any cadence from 1 hour to 1 year. */\n  interval?: SubscriptionInterval;\n  intervalUnit?: SubscriptionIntervalUnit;\n  intervalCount?: number;\n  /** Makes the subscription an installment plan of exactly this many payments (2–60). Not combinable with trialDays. */\n  totalPayments?: number;\n  amount?: number;\n  trialDays?: number;\n  planName?: string;\n  create?: 'auto' | 'manual';\n}\n\nexport interface CheckoutCollectInput {\n  shippingAddress?: boolean;\n  billingAddress?: boolean;\n}\n\nexport interface CheckoutPaymentTermsInput {\n  netN?: number | null;\n}\n\nexport interface CreateCheckoutSessionInput {\n  applicationId: string;\n  cartId?: string;\n  externalCartId?: string;\n  customerEmail?: string;\n  customer?: CheckoutCustomerInput;\n  returnUrl: string;\n  cancelUrl: string;\n  allowedMethods?: string[];\n  paymentTerms?: CheckoutPaymentTermsInput;\n  recurring?: RecurringIntentInput;\n  collect?: CheckoutCollectInput;\n  metadata?: Record<string, unknown>;\n  discountCode?: string;\n}\n\nexport interface CheckoutSession {\n  sessionId: string;\n  id?: string;\n  checkoutUrl?: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  embedToken?: string;\n  expiresAt?: string;\n  [key: string]: unknown;\n}\n\nexport type CheckoutSessionStatus =\n  | 'open'\n  | 'customer_set'\n  | 'address_set'\n  | 'processing'\n  | 'completed'\n  | 'expired'\n  | 'cancelled';\n\n/** A session as read back by `getSession` — the create response plus its current state. */\nexport interface CheckoutSessionDetails extends CheckoutSession {\n  status: CheckoutSessionStatus;\n  cartId?: string | null;\n  customerId?: string | null;\n  customerEmail?: string | null;\n  shippingAddress?: CheckoutAddress | null;\n  billingAddress?: CheckoutAddress | null;\n  returnUrl?: string;\n  cancelUrl?: string;\n  completedAt?: string | null;\n  allowedMethods?: string[] | null;\n  collectShipping?: boolean;\n  collectBilling?: boolean;\n  discountCode?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface Net30Acceptance {\n  termsHash: string;\n  acceptedAt: string;\n  companyName: string;\n  billingEmail: string;\n}\n\nexport interface CompleteCheckoutSessionInput {\n  email?: string;\n  shippingAddress?: CheckoutAddress;\n  billingAddress?: CheckoutAddress;\n  billingSameAsShipping?: boolean;\n  paymentMethod: PaymentMethod;\n  netDays?: number;\n  termsAccepted?: boolean;\n  termsSnapshot?: string;\n  invoiceNumber?: string;\n  net30Acceptance?: Net30Acceptance;\n  paymentToken?: string;\n  processorCheckoutSessionId?: string;\n  processorTransactionId?: string;\n}\n\nexport interface CompleteCheckoutSessionResult {\n  orderId: string;\n  orderNumber?: string;\n  paymentId?: string;\n  total?: number;\n  currency?: string;\n  status?: string;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * The card needs a 3-D Secure challenge the buyer has to answer.\n *\n * Only the server-authorized card path (`processorCheckoutSessionId` with no\n * `processorTransactionId`) can produce this. The payment is neither completed\n * nor declined, so there is deliberately no `orderId` and no `paymentId`: put\n * the challenge in front of the buyer, then call `completeSession` again with\n * the same input.\n */\nexport interface CompleteCheckoutSessionRequiresAction {\n  status: 'requires_action';\n  orderId?: undefined;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Narrow on `status === 'requires_action'` before reading `orderId`.\n * `isRequiresAction(result)` does that for you.\n */\nexport type CompleteCheckoutSessionOutcome =\n  | CompleteCheckoutSessionResult\n  | CompleteCheckoutSessionRequiresAction;\n\nexport function isRequiresAction(\n  outcome: CompleteCheckoutSessionOutcome,\n): outcome is CompleteCheckoutSessionRequiresAction {\n  return outcome.status === 'requires_action';\n}\n\nexport interface CreateEmbedTokenInput {\n  externalCartId?: string;\n  amount: number;\n  currency: string;\n  country?: string;\n  // NOTE: `allowedMethods` is intentionally NOT accepted here. A payment-only\n  // Gr4vy embed cannot restrict payment methods (the Gr4vy widget renders the\n  // methods configured on your Gr4vy connection). The server rejects it with\n  // `allowed_methods_unsupported`. To restrict methods, configure the connection\n  // or use the full hosted checkout, where allowedMethods filters the selection.\n}\n\nexport interface CreateEmbedTokenResult {\n  embedToken: string;\n  checkoutSessionId: string;\n  amount: number;\n  currency: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  processorInstanceId?: string;\n  merchantAccountId?: string;\n  [key: string]: unknown;\n}\n\nexport interface CheckoutOrder {\n  id: string;\n  orderNumber?: string;\n  status: string;\n  paymentStatus: string | null;\n  currency: string;\n  subtotal: number;\n  taxTotal: number;\n  shippingTotal: number;\n  total: number;\n  metadata?: Record<string, unknown>;\n  payments?: CheckoutPayment[];\n  [key: string]: unknown;\n}\n\nexport interface ListOrdersOptions {\n  customerId?: string;\n  cursor?: string;\n  limit?: number;\n  status?: string;\n  paymentStatus?: string;\n}\n\nexport interface PaginatedOrders {\n  data: CheckoutOrder[];\n  pagination?: {\n    cursor: string | null;\n    hasMore: boolean;\n  };\n}\n\nexport interface CheckoutPayment {\n  id: string;\n  orderId?: string;\n  processor?: string;\n  processorTransactionId?: string | null;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  method?: string;\n  createdAt?: string;\n  transactions?: CheckoutPaymentTransaction[];\n  [key: string]: unknown;\n}\n\nexport interface CheckoutPaymentTransaction {\n  id: string;\n  paymentId?: string;\n  type?: string;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  createdAt?: string;\n  [key: string]: unknown;\n}\n\nexport interface BuildCheckoutUrlOptions {\n  checkoutOrigin?: string;\n  sessionId: string;\n  parentOrigin?: string;\n  mode?: CheckoutEmbedMode;\n  route?: CheckoutEmbedRoute;\n  primary?: string;\n  logo?: string;\n}\n\nexport interface ThrottleEnvelope<T> {\n  data?: T;\n  meta?: Record<string, unknown>;\n  error?: {\n    code?: string;\n    message?: string;\n    details?: unknown;\n  };\n}\n\n/**\n * Thrown on a non-2xx response from the Throttle Checkout API.\n *\n * Extends the shared {@link ThrottleError} so a single\n * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every\n * Throttle SDK. `instanceof ThrottleCheckoutError` keeps working for existing\n * code.\n */\nexport class ThrottleCheckoutError extends ThrottleError {\n  constructor(args: {\n    code: string;\n    message: string;\n    statusCode: number;\n    details?: unknown;\n    body?: unknown;\n  }) {\n    super(args);\n    this.name = 'ThrottleCheckoutError';\n  }\n}\n\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\n\nexport class CheckoutClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof globalThis.fetch;\n  private readonly timeoutMs: number;\n\n  constructor(opts: CheckoutClientOptions) {\n    if (!opts.apiKey) throw new Error('CheckoutClient: apiKey is required');\n    const fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (!fetchImpl) throw new Error('CheckoutClient: fetch is required');\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? 'https://api.usethrottle.dev').replace(/\\/+$/, '');\n    this.fetchImpl = fetchImpl;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n  }\n\n  async request<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {\n    const envelope = await this.requestEnvelope<T>(method, path, body);\n    if (Object.prototype.hasOwnProperty.call(envelope, 'data')) {\n      return envelope.data as T;\n    }\n    return envelope as T;\n  }\n\n  async requestEnvelope<T = unknown>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<ThrottleEnvelope<T>> {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);\n\n    try {\n      const res = await this.fetchImpl(toAbsoluteUrl(this.baseUrl, path), {\n        method,\n        headers: {\n          'content-type': 'application/json',\n          'x-api-key': this.apiKey,\n        },\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: ctrl.signal,\n      });\n\n      if (res.status === 204) return { data: undefined as T };\n\n      const json = (await res.json().catch(() => ({}))) as ThrottleEnvelope<T>;\n      if (!res.ok) {\n        throw new ThrottleCheckoutError({\n          code: json.error?.code ?? 'unknown_error',\n          message: json.error?.message ?? `HTTP ${res.status}`,\n          statusCode: res.status,\n          details: json.error?.details,\n          body: json,\n        });\n      }\n      return json;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async createSession(input: CreateCheckoutSessionInput): Promise<CheckoutSession> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout/sessions', input);\n    return normalizeCheckoutSession(data);\n  }\n\n  /**\n   * Returns either a completion or `{status: 'requires_action'}` when the card\n   * needs a 3-D Secure challenge — narrow with `isRequiresAction()` before\n   * reading `orderId`.\n   */\n  async completeSession(\n    sessionId: string,\n    input: CompleteCheckoutSessionInput,\n  ): Promise<CompleteCheckoutSessionOutcome> {\n    const data = await this.request<unknown>(\n      'POST',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}/complete`,\n      input,\n    );\n    return normalizeCompleteResult(data);\n  }\n\n  /**\n   * Read a checkout session's current state — `status` tells you whether the\n   * buyer is still in it (`open`, `processing`) or it has settled (`completed`,\n   * `cancelled`, `expired`). Use it to decide whether a session can be resumed\n   * or cancelled instead of tracking that yourself.\n   */\n  async getSession(sessionId: string): Promise<CheckoutSessionDetails> {\n    const data = await this.request<any>(\n      'GET',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n    return {\n      ...normalizeCheckoutSession(data),\n      status: requiredString(data?.status, 'checkoutSession.status') as CheckoutSessionStatus,\n    };\n  }\n\n  /**\n   * Cancel an in-flight checkout session (e.g. the buyer abandoned the embed).\n   * Idempotent — cancelling an already-cancelled session is a no-op; a completed\n   * session cannot be cancelled (the API returns 422 `already_completed`).\n   */\n  async cancelSession(sessionId: string): Promise<void> {\n    await this.request<unknown>(\n      'DELETE',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n  }\n\n  async createEmbedToken(input: CreateEmbedTokenInput): Promise<CreateEmbedTokenResult> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout-sessions/embed-token', input);\n    return normalizeEmbedToken(data);\n  }\n\n  async getOrder(orderId: string): Promise<CheckoutOrder> {\n    const data = await this.request<unknown>('GET', `/api/v1/orders/${encodeURIComponent(orderId)}`);\n    return normalizeOrder(data);\n  }\n\n  async listOrders(options: ListOrdersOptions = {}): Promise<PaginatedOrders> {\n    const params = new URLSearchParams();\n    if (options.customerId) params.set('customerId', options.customerId);\n    if (options.cursor) params.set('cursor', options.cursor);\n    if (options.limit !== undefined) params.set('limit', String(options.limit));\n    if (options.status) params.set('status', options.status);\n    if (options.paymentStatus) params.set('paymentStatus', options.paymentStatus);\n\n    const query = params.toString();\n    const envelope = await this.requestEnvelope<unknown[]>(\n      'GET',\n      `/api/v1/orders${query ? `?${query}` : ''}`,\n    );\n    return {\n      data: (envelope.data ?? []).map(normalizeOrder),\n      pagination: envelope.meta?.pagination as PaginatedOrders['pagination'],\n    };\n  }\n\n  async listOrderPayments(orderId: string): Promise<CheckoutPayment[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/orders/${encodeURIComponent(orderId)}/payments`,\n    );\n    return (data ?? []).map(normalizePayment);\n  }\n\n  async listPaymentTransactions(paymentId: string): Promise<CheckoutPaymentTransaction[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/payments/${encodeURIComponent(paymentId)}/transactions`,\n    );\n    return (data ?? []).map(normalizeTransaction);\n  }\n\n  async getOrderWithPayments(orderId: string): Promise<CheckoutOrder> {\n    const order = await this.getOrder(orderId);\n    const payments = await this.listOrderPayments(orderId);\n    return {\n      ...order,\n      payments: await Promise.all(\n        payments.map(async (payment) => ({\n          ...payment,\n          transactions: payment.id ? await this.listPaymentTransactions(payment.id) : [],\n        })),\n      ),\n    };\n  }\n}\n\nexport function createCheckoutClient(opts: CheckoutClientOptions): CheckoutClient {\n  return new CheckoutClient(opts);\n}\n\nexport function buildCheckoutHostedUrl(options: BuildCheckoutUrlOptions): string {\n  const route = options.route ?? 's';\n  const base = (options.checkoutOrigin ?? 'https://checkout.usethrottle.dev').replace(/\\/+$/, '');\n  return `${base}/${route}/${encodeURIComponent(options.sessionId)}`;\n}\n\nexport function buildCheckoutEmbedUrl(options: BuildCheckoutUrlOptions): string {\n  const baseUrl = buildCheckoutHostedUrl({\n    checkoutOrigin: options.checkoutOrigin,\n    sessionId: options.sessionId,\n    route: options.route ?? 'c',\n  });\n  const params = new URLSearchParams({\n    embed: '1',\n    mode: options.mode ?? 'payment-only',\n    ...(options.parentOrigin ? { parentOrigin: options.parentOrigin.replace(/\\/+$/, '') } : {}),\n  });\n  if (options.primary) params.set('primary', options.primary);\n  if (options.logo) params.set('logo', options.logo);\n  return `${baseUrl}?${params.toString()}`;\n}\n\nfunction toAbsoluteUrl(baseUrl: string, path: string): string {\n  if (/^https?:\\/\\//i.test(path)) return path;\n  return `${baseUrl}${path.startsWith('/') ? path : `/${path}`}`;\n}\n\nfunction normalizeCheckoutSession(raw: any): CheckoutSession {\n  const sessionId = raw?.sessionId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    id: optionalString(raw?.id) ?? undefined,\n    sessionId: requiredString(sessionId, 'checkoutSession.sessionId'),\n    checkoutUrl: optionalString(raw?.checkoutUrl) ?? undefined,\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    embedToken: optionalString(raw?.embedToken) ?? undefined,\n    expiresAt: optionalString(raw?.expiresAt) ?? undefined,\n  };\n}\n\nfunction normalizeCompleteResult(raw: any): CompleteCheckoutSessionOutcome {\n  // A 3-D Secure challenge is a 200, not an error, and carries no order — so\n  // `requiredString(orderId)` below would throw a local parse error at exactly\n  // the moment the caller needs to show the buyer a challenge.\n  if (raw?.status === 'requires_action') {\n    return {\n      ...withoutSnakeKeys(raw),\n      status: 'requires_action',\n      paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n    };\n  }\n  const orderId = raw?.orderId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    orderId: requiredString(orderId, 'checkoutComplete.orderId'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    total: optionalNumber(raw?.total),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n  };\n}\n\nfunction normalizeEmbedToken(raw: any): CreateEmbedTokenResult {\n  return {\n    ...withoutSnakeKeys(raw),\n    embedToken: requiredString(raw?.embedToken, 'embedToken.embedToken'),\n    checkoutSessionId: requiredString(raw?.checkoutSessionId, 'embedToken.checkoutSessionId'),\n    amount: Number(raw?.amount ?? 0),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    processorInstanceId: optionalString(raw?.processorInstanceId) ?? undefined,\n    merchantAccountId: optionalString(raw?.merchantAccountId) ?? undefined,\n  };\n}\n\nfunction normalizeOrder(raw: any): CheckoutOrder {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'order.id'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    status: optionalString(raw?.status) ?? 'processing',\n    paymentStatus: optionalString(raw?.paymentStatus),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    subtotal: Number(raw?.subtotal ?? 0),\n    taxTotal: Number(raw?.taxTotal ?? 0),\n    shippingTotal: Number(raw?.shippingTotal ?? 0),\n    total: Number(raw?.total ?? 0),\n    metadata: objectOrUndefined(raw?.metadata),\n    payments: Array.isArray(raw?.payments) ? raw.payments.map(normalizePayment) : undefined,\n  };\n}\n\nfunction normalizePayment(raw: any): CheckoutPayment {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'payment.id'),\n    orderId: optionalString(raw?.orderId) ?? undefined,\n    processor: optionalString(raw?.processor) ?? undefined,\n    processorTransactionId:\n      optionalString(raw?.processorTransactionId) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    method: optionalString(raw?.method) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n    transactions: Array.isArray(raw?.transactions)\n      ? raw.transactions.map(normalizeTransaction)\n      : undefined,\n  };\n}\n\nfunction normalizeTransaction(raw: any): CheckoutPaymentTransaction {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'transaction.id'),\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    type: optionalString(raw?.type) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n  };\n}\n\nfunction withoutSnakeKeys(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};\n  return Object.fromEntries(\n    Object.entries(value as Record<string, unknown>).filter(([key]) => !key.includes('_')),\n  );\n}\n\nfunction requiredString(value: unknown, label: string): string {\n  if (typeof value === 'string' && value.length > 0) return value;\n  throw new Error(`Invalid Throttle response: missing ${label}`);\n}\n\nfunction optionalString(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nfunction optionalNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction objectOrUndefined(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n"],"mappings":"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","names":["import_errors"]}
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import { ThrottleError, type ThrottleErrorArgs } from '@usethrottle/errors';\n\n/**\n * `'embedded'` completes a card payment taken by the payment embed; `'net30'`\n * issues an invoice on terms. `'card'` names the card category in\n * `allowedMethods` — `completeSession` rejects it with 422\n * `payment_method_not_supported`. Use `'embedded'`.\n */\nexport type PaymentMethod = 'net30' | 'card' | 'embedded';\nexport type SubscriptionInterval = 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';\nexport type SubscriptionIntervalUnit = 'hour' | 'day' | 'week' | 'month';\nexport type CheckoutEmbedMode = 'checkout-full' | 'payment-only';\nexport type CheckoutEmbedRoute = 'c' | 's';\n\nexport interface CheckoutClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  timeoutMs?: number;\n}\n\nexport interface CheckoutAddress {\n  firstName: string;\n  lastName: string;\n  company?: string;\n  addressLine1: string;\n  addressLine2?: string;\n  city: string;\n  stateProvince: string;\n  postalCode: string;\n  countryCode: string;\n  phone?: string;\n}\n\nexport interface CheckoutCustomerAddressInput {\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  addressLine1?: string;\n  addressLine2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\nexport interface CheckoutCustomerInput {\n  customerId?: string;\n  externalCustomerId?: string;\n  email?: string;\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  shippingAddress?: CheckoutCustomerAddressInput;\n  billingAddress?: CheckoutCustomerAddressInput;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RecurringIntentInput {\n  plan: string;\n  /** A named interval. Or send intervalUnit + intervalCount for any cadence from 1 hour to 1 year. */\n  interval?: SubscriptionInterval;\n  intervalUnit?: SubscriptionIntervalUnit;\n  intervalCount?: number;\n  /** Makes the subscription an installment plan of exactly this many payments (2–60). Not combinable with trialDays. */\n  totalPayments?: number;\n  amount?: number;\n  trialDays?: number;\n  planName?: string;\n  create?: 'auto' | 'manual';\n}\n\nexport interface CheckoutCollectInput {\n  shippingAddress?: boolean;\n  billingAddress?: boolean;\n}\n\nexport interface CheckoutPaymentTermsInput {\n  netN?: number | null;\n}\n\nexport interface CreateCheckoutSessionInput {\n  applicationId: string;\n  cartId?: string;\n  externalCartId?: string;\n  customerEmail?: string;\n  customer?: CheckoutCustomerInput;\n  returnUrl: string;\n  cancelUrl: string;\n  allowedMethods?: string[];\n  paymentTerms?: CheckoutPaymentTermsInput;\n  recurring?: RecurringIntentInput;\n  collect?: CheckoutCollectInput;\n  metadata?: Record<string, unknown>;\n  discountCode?: string;\n}\n\nexport interface CheckoutSession {\n  sessionId: string;\n  id?: string;\n  checkoutUrl?: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  embedToken?: string;\n  expiresAt?: string;\n  [key: string]: unknown;\n}\n\nexport type CheckoutSessionStatus =\n  | 'open'\n  | 'customer_set'\n  | 'address_set'\n  | 'processing'\n  | 'completed'\n  | 'expired'\n  | 'cancelled';\n\n/** A session as read back by `getSession` — the create response plus its current state. */\nexport interface CheckoutSessionDetails extends CheckoutSession {\n  status: CheckoutSessionStatus;\n  cartId?: string | null;\n  customerId?: string | null;\n  customerEmail?: string | null;\n  shippingAddress?: CheckoutAddress | null;\n  billingAddress?: CheckoutAddress | null;\n  returnUrl?: string;\n  cancelUrl?: string;\n  completedAt?: string | null;\n  allowedMethods?: string[] | null;\n  collectShipping?: boolean;\n  collectBilling?: boolean;\n  discountCode?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface Net30Acceptance {\n  termsHash: string;\n  acceptedAt: string;\n  companyName: string;\n  billingEmail: string;\n}\n\nexport interface CompleteCheckoutSessionInput {\n  email?: string;\n  shippingAddress?: CheckoutAddress;\n  billingAddress?: CheckoutAddress;\n  billingSameAsShipping?: boolean;\n  paymentMethod: PaymentMethod;\n  netDays?: number;\n  termsAccepted?: boolean;\n  termsSnapshot?: string;\n  invoiceNumber?: string;\n  net30Acceptance?: Net30Acceptance;\n  paymentToken?: string;\n  processorCheckoutSessionId?: string;\n  processorTransactionId?: string;\n}\n\nexport interface CompleteCheckoutSessionResult {\n  orderId: string;\n  orderNumber?: string;\n  paymentId?: string;\n  total?: number;\n  currency?: string;\n  status?: string;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * The card needs a 3-D Secure challenge the buyer has to answer.\n *\n * Only the server-authorized card path (`processorCheckoutSessionId` with no\n * `processorTransactionId`) can produce this. The payment is neither completed\n * nor declined, so there is deliberately no `orderId` and no `paymentId`: put\n * the challenge in front of the buyer, then call `completeSession` again with\n * the same input.\n */\nexport interface CompleteCheckoutSessionRequiresAction {\n  status: 'requires_action';\n  orderId?: undefined;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Narrow on `status === 'requires_action'` before reading `orderId`.\n * `isRequiresAction(result)` does that for you.\n */\nexport type CompleteCheckoutSessionOutcome =\n  | CompleteCheckoutSessionResult\n  | CompleteCheckoutSessionRequiresAction;\n\nexport function isRequiresAction(\n  outcome: CompleteCheckoutSessionOutcome,\n): outcome is CompleteCheckoutSessionRequiresAction {\n  return outcome.status === 'requires_action';\n}\n\nexport interface CreateEmbedTokenInput {\n  externalCartId?: string;\n  amount: number;\n  currency: string;\n  country?: string;\n  // NOTE: `allowedMethods` is intentionally NOT accepted here. A payment-only\n  // Gr4vy embed cannot restrict payment methods (the Gr4vy widget renders the\n  // methods configured on your Gr4vy connection). The server rejects it with\n  // `allowed_methods_unsupported`. To restrict methods, configure the connection\n  // or use the full hosted checkout, where allowedMethods filters the selection.\n}\n\nexport interface CreateEmbedTokenResult {\n  embedToken: string;\n  checkoutSessionId: string;\n  amount: number;\n  currency: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  processorInstanceId?: string;\n  merchantAccountId?: string;\n  [key: string]: unknown;\n}\n\nexport interface CheckoutOrder {\n  id: string;\n  orderNumber?: string;\n  status: string;\n  paymentStatus: string | null;\n  currency: string;\n  subtotal: number;\n  taxTotal: number;\n  shippingTotal: number;\n  total: number;\n  metadata?: Record<string, unknown>;\n  payments?: CheckoutPayment[];\n  [key: string]: unknown;\n}\n\nexport interface ListOrdersOptions {\n  customerId?: string;\n  cursor?: string;\n  limit?: number;\n  status?: string;\n  paymentStatus?: string;\n}\n\nexport interface PaginatedOrders {\n  data: CheckoutOrder[];\n  pagination?: {\n    cursor: string | null;\n    hasMore: boolean;\n  };\n}\n\nexport interface CheckoutPayment {\n  id: string;\n  orderId?: string;\n  processor?: string;\n  processorTransactionId?: string | null;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  method?: string;\n  createdAt?: string;\n  transactions?: CheckoutPaymentTransaction[];\n  [key: string]: unknown;\n}\n\nexport interface CheckoutPaymentTransaction {\n  id: string;\n  paymentId?: string;\n  type?: string;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  createdAt?: string;\n  [key: string]: unknown;\n}\n\nexport interface BuildCheckoutUrlOptions {\n  checkoutOrigin?: string;\n  sessionId: string;\n  parentOrigin?: string;\n  mode?: CheckoutEmbedMode;\n  route?: CheckoutEmbedRoute;\n  primary?: string;\n  logo?: string;\n}\n\nexport interface ThrottleEnvelope<T> {\n  data?: T;\n  meta?: Record<string, unknown>;\n  error?: {\n    code?: string;\n    message?: string;\n    details?: unknown;\n  };\n}\n\n/**\n * Thrown on a non-2xx response from the Throttle Checkout API.\n *\n * Extends the shared {@link ThrottleError} so a single\n * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every\n * Throttle SDK. `instanceof ThrottleCheckoutError` keeps working for existing\n * code.\n */\nexport class ThrottleCheckoutError extends ThrottleError {\n  constructor(args: {\n    code: string;\n    message: string;\n    statusCode: number;\n    details?: unknown;\n    body?: unknown;\n    responseHeaders?: ThrottleErrorArgs['responseHeaders'];\n  }) {\n    super(args);\n    this.name = 'ThrottleCheckoutError';\n  }\n}\n\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\n\nexport class CheckoutClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof globalThis.fetch;\n  private readonly timeoutMs: number;\n\n  constructor(opts: CheckoutClientOptions) {\n    if (!opts.apiKey) throw new Error('CheckoutClient: apiKey is required');\n    const fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (!fetchImpl) throw new Error('CheckoutClient: fetch is required');\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? 'https://api.usethrottle.dev').replace(/\\/+$/, '');\n    this.fetchImpl = fetchImpl;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n  }\n\n  async request<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {\n    const envelope = await this.requestEnvelope<T>(method, path, body);\n    if (Object.prototype.hasOwnProperty.call(envelope, 'data')) {\n      return envelope.data as T;\n    }\n    return envelope as T;\n  }\n\n  async requestEnvelope<T = unknown>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<ThrottleEnvelope<T>> {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);\n\n    try {\n      const res = await this.fetchImpl(toAbsoluteUrl(this.baseUrl, path), {\n        method,\n        headers: {\n          'content-type': 'application/json',\n          'x-api-key': this.apiKey,\n        },\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: ctrl.signal,\n      });\n\n      if (res.status === 204) return { data: undefined as T };\n\n      const json = (await res.json().catch(() => ({}))) as ThrottleEnvelope<T>;\n      if (!res.ok) {\n        throw new ThrottleCheckoutError({\n          code: json.error?.code ?? 'unknown_error',\n          message: json.error?.message ?? `HTTP ${res.status}`,\n          statusCode: res.status,\n          details: json.error?.details,\n          body: json,\n          responseHeaders: res.headers,\n        });\n      }\n      return json;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async createSession(input: CreateCheckoutSessionInput): Promise<CheckoutSession> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout/sessions', input);\n    return normalizeCheckoutSession(data);\n  }\n\n  /**\n   * Returns either a completion or `{status: 'requires_action'}` when the card\n   * needs a 3-D Secure challenge — narrow with `isRequiresAction()` before\n   * reading `orderId`.\n   */\n  async completeSession(\n    sessionId: string,\n    input: CompleteCheckoutSessionInput,\n  ): Promise<CompleteCheckoutSessionOutcome> {\n    const data = await this.request<unknown>(\n      'POST',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}/complete`,\n      input,\n    );\n    return normalizeCompleteResult(data);\n  }\n\n  /**\n   * Read a checkout session's current state — `status` tells you whether the\n   * buyer is still in it (`open`, `processing`) or it has settled (`completed`,\n   * `cancelled`, `expired`). Use it to decide whether a session can be resumed\n   * or cancelled instead of tracking that yourself.\n   */\n  async getSession(sessionId: string): Promise<CheckoutSessionDetails> {\n    const data = await this.request<any>(\n      'GET',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n    return {\n      ...normalizeCheckoutSession(data),\n      status: requiredString(data?.status, 'checkoutSession.status') as CheckoutSessionStatus,\n    };\n  }\n\n  /**\n   * Cancel an in-flight checkout session (e.g. the buyer abandoned the embed).\n   * Idempotent — cancelling an already-cancelled session is a no-op; a completed\n   * session cannot be cancelled (the API returns 422 `already_completed`).\n   */\n  async cancelSession(sessionId: string): Promise<void> {\n    await this.request<unknown>(\n      'DELETE',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n  }\n\n  async createEmbedToken(input: CreateEmbedTokenInput): Promise<CreateEmbedTokenResult> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout-sessions/embed-token', input);\n    return normalizeEmbedToken(data);\n  }\n\n  async getOrder(orderId: string): Promise<CheckoutOrder> {\n    const data = await this.request<unknown>('GET', `/api/v1/orders/${encodeURIComponent(orderId)}`);\n    return normalizeOrder(data);\n  }\n\n  async listOrders(options: ListOrdersOptions = {}): Promise<PaginatedOrders> {\n    const params = new URLSearchParams();\n    if (options.customerId) params.set('customerId', options.customerId);\n    if (options.cursor) params.set('cursor', options.cursor);\n    if (options.limit !== undefined) params.set('limit', String(options.limit));\n    if (options.status) params.set('status', options.status);\n    if (options.paymentStatus) params.set('paymentStatus', options.paymentStatus);\n\n    const query = params.toString();\n    const envelope = await this.requestEnvelope<unknown[]>(\n      'GET',\n      `/api/v1/orders${query ? `?${query}` : ''}`,\n    );\n    return {\n      data: (envelope.data ?? []).map(normalizeOrder),\n      pagination: envelope.meta?.pagination as PaginatedOrders['pagination'],\n    };\n  }\n\n  async listOrderPayments(orderId: string): Promise<CheckoutPayment[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/orders/${encodeURIComponent(orderId)}/payments`,\n    );\n    return (data ?? []).map(normalizePayment);\n  }\n\n  async listPaymentTransactions(paymentId: string): Promise<CheckoutPaymentTransaction[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/payments/${encodeURIComponent(paymentId)}/transactions`,\n    );\n    return (data ?? []).map(normalizeTransaction);\n  }\n\n  async getOrderWithPayments(orderId: string): Promise<CheckoutOrder> {\n    const order = await this.getOrder(orderId);\n    const payments = await this.listOrderPayments(orderId);\n    return {\n      ...order,\n      payments: await Promise.all(\n        payments.map(async (payment) => ({\n          ...payment,\n          transactions: payment.id ? await this.listPaymentTransactions(payment.id) : [],\n        })),\n      ),\n    };\n  }\n}\n\nexport function createCheckoutClient(opts: CheckoutClientOptions): CheckoutClient {\n  return new CheckoutClient(opts);\n}\n\nexport function buildCheckoutHostedUrl(options: BuildCheckoutUrlOptions): string {\n  const route = options.route ?? 's';\n  const base = (options.checkoutOrigin ?? 'https://checkout.usethrottle.dev').replace(/\\/+$/, '');\n  return `${base}/${route}/${encodeURIComponent(options.sessionId)}`;\n}\n\nexport function buildCheckoutEmbedUrl(options: BuildCheckoutUrlOptions): string {\n  const baseUrl = buildCheckoutHostedUrl({\n    checkoutOrigin: options.checkoutOrigin,\n    sessionId: options.sessionId,\n    route: options.route ?? 'c',\n  });\n  const params = new URLSearchParams({\n    embed: '1',\n    mode: options.mode ?? 'payment-only',\n    ...(options.parentOrigin ? { parentOrigin: options.parentOrigin.replace(/\\/+$/, '') } : {}),\n  });\n  if (options.primary) params.set('primary', options.primary);\n  if (options.logo) params.set('logo', options.logo);\n  return `${baseUrl}?${params.toString()}`;\n}\n\nfunction toAbsoluteUrl(baseUrl: string, path: string): string {\n  if (/^https?:\\/\\//i.test(path)) return path;\n  return `${baseUrl}${path.startsWith('/') ? path : `/${path}`}`;\n}\n\nfunction normalizeCheckoutSession(raw: any): CheckoutSession {\n  const sessionId = raw?.sessionId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    id: optionalString(raw?.id) ?? undefined,\n    sessionId: requiredString(sessionId, 'checkoutSession.sessionId'),\n    checkoutUrl: optionalString(raw?.checkoutUrl) ?? undefined,\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    embedToken: optionalString(raw?.embedToken) ?? undefined,\n    expiresAt: optionalString(raw?.expiresAt) ?? undefined,\n  };\n}\n\nfunction normalizeCompleteResult(raw: any): CompleteCheckoutSessionOutcome {\n  // A 3-D Secure challenge is a 200, not an error, and carries no order — so\n  // `requiredString(orderId)` below would throw a local parse error at exactly\n  // the moment the caller needs to show the buyer a challenge.\n  if (raw?.status === 'requires_action') {\n    return {\n      ...withoutSnakeKeys(raw),\n      status: 'requires_action',\n      paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n    };\n  }\n  const orderId = raw?.orderId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    orderId: requiredString(orderId, 'checkoutComplete.orderId'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    total: optionalNumber(raw?.total),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n  };\n}\n\nfunction normalizeEmbedToken(raw: any): CreateEmbedTokenResult {\n  return {\n    ...withoutSnakeKeys(raw),\n    embedToken: requiredString(raw?.embedToken, 'embedToken.embedToken'),\n    checkoutSessionId: requiredString(raw?.checkoutSessionId, 'embedToken.checkoutSessionId'),\n    amount: Number(raw?.amount ?? 0),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    processorInstanceId: optionalString(raw?.processorInstanceId) ?? undefined,\n    merchantAccountId: optionalString(raw?.merchantAccountId) ?? undefined,\n  };\n}\n\nfunction normalizeOrder(raw: any): CheckoutOrder {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'order.id'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    status: optionalString(raw?.status) ?? 'processing',\n    paymentStatus: optionalString(raw?.paymentStatus),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    subtotal: Number(raw?.subtotal ?? 0),\n    taxTotal: Number(raw?.taxTotal ?? 0),\n    shippingTotal: Number(raw?.shippingTotal ?? 0),\n    total: Number(raw?.total ?? 0),\n    metadata: objectOrUndefined(raw?.metadata),\n    payments: Array.isArray(raw?.payments) ? raw.payments.map(normalizePayment) : undefined,\n  };\n}\n\nfunction normalizePayment(raw: any): CheckoutPayment {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'payment.id'),\n    orderId: optionalString(raw?.orderId) ?? undefined,\n    processor: optionalString(raw?.processor) ?? undefined,\n    processorTransactionId:\n      optionalString(raw?.processorTransactionId) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    method: optionalString(raw?.method) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n    transactions: Array.isArray(raw?.transactions)\n      ? raw.transactions.map(normalizeTransaction)\n      : undefined,\n  };\n}\n\nfunction normalizeTransaction(raw: any): CheckoutPaymentTransaction {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'transaction.id'),\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    type: optionalString(raw?.type) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n  };\n}\n\nfunction withoutSnakeKeys(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};\n  return Object.fromEntries(\n    Object.entries(value as Record<string, unknown>).filter(([key]) => !key.includes('_')),\n  );\n}\n\nfunction requiredString(value: unknown, label: string): string {\n  if (typeof value === 'string' && value.length > 0) return value;\n  throw new Error(`Invalid Throttle response: missing ${label}`);\n}\n\nfunction optionalString(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nfunction optionalNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction objectOrUndefined(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n"],"mappings":"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","names":["import_errors"]}

package/dist/server.d.cts

@@ -1,4 +1,4 @@
-import { ThrottleError } from '@usethrottle/errors';
+import { ThrottleError, ThrottleErrorArgs } from '@usethrottle/errors';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
 
 /**
@@ -268,6 +268,7 @@ declare class ThrottleCheckoutError extends ThrottleError {
         statusCode: number;
         details?: unknown;
         body?: unknown;
+        responseHeaders?: ThrottleErrorArgs['responseHeaders'];
     });
 }
 

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { ThrottleError } from '@usethrottle/errors';
+import { ThrottleError, ThrottleErrorArgs } from '@usethrottle/errors';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
 
 /**
@@ -268,6 +268,7 @@ declare class ThrottleCheckoutError extends ThrottleError {
         statusCode: number;
         details?: unknown;
         body?: unknown;
+        responseHeaders?: ThrottleErrorArgs['responseHeaders'];
     });
 }
 

package/dist/server.js

@@ -48,7 +48,8 @@ var CheckoutClient = class {
           message: json.error?.message ?? `HTTP ${res.status}`,
           statusCode: res.status,
           details: json.error?.details,
-          body: json
+          body: json,
+          responseHeaders: res.headers
         });
       }
       return json;

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import { ThrottleError } from '@usethrottle/errors';\n\n/**\n * `'embedded'` completes a card payment taken by the payment embed; `'net30'`\n * issues an invoice on terms. `'card'` names the card category in\n * `allowedMethods` — `completeSession` rejects it with 422\n * `payment_method_not_supported`. Use `'embedded'`.\n */\nexport type PaymentMethod = 'net30' | 'card' | 'embedded';\nexport type SubscriptionInterval = 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';\nexport type SubscriptionIntervalUnit = 'hour' | 'day' | 'week' | 'month';\nexport type CheckoutEmbedMode = 'checkout-full' | 'payment-only';\nexport type CheckoutEmbedRoute = 'c' | 's';\n\nexport interface CheckoutClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  timeoutMs?: number;\n}\n\nexport interface CheckoutAddress {\n  firstName: string;\n  lastName: string;\n  company?: string;\n  addressLine1: string;\n  addressLine2?: string;\n  city: string;\n  stateProvince: string;\n  postalCode: string;\n  countryCode: string;\n  phone?: string;\n}\n\nexport interface CheckoutCustomerAddressInput {\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  addressLine1?: string;\n  addressLine2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\nexport interface CheckoutCustomerInput {\n  customerId?: string;\n  externalCustomerId?: string;\n  email?: string;\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  shippingAddress?: CheckoutCustomerAddressInput;\n  billingAddress?: CheckoutCustomerAddressInput;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RecurringIntentInput {\n  plan: string;\n  /** A named interval. Or send intervalUnit + intervalCount for any cadence from 1 hour to 1 year. */\n  interval?: SubscriptionInterval;\n  intervalUnit?: SubscriptionIntervalUnit;\n  intervalCount?: number;\n  /** Makes the subscription an installment plan of exactly this many payments (2–60). Not combinable with trialDays. */\n  totalPayments?: number;\n  amount?: number;\n  trialDays?: number;\n  planName?: string;\n  create?: 'auto' | 'manual';\n}\n\nexport interface CheckoutCollectInput {\n  shippingAddress?: boolean;\n  billingAddress?: boolean;\n}\n\nexport interface CheckoutPaymentTermsInput {\n  netN?: number | null;\n}\n\nexport interface CreateCheckoutSessionInput {\n  applicationId: string;\n  cartId?: string;\n  externalCartId?: string;\n  customerEmail?: string;\n  customer?: CheckoutCustomerInput;\n  returnUrl: string;\n  cancelUrl: string;\n  allowedMethods?: string[];\n  paymentTerms?: CheckoutPaymentTermsInput;\n  recurring?: RecurringIntentInput;\n  collect?: CheckoutCollectInput;\n  metadata?: Record<string, unknown>;\n  discountCode?: string;\n}\n\nexport interface CheckoutSession {\n  sessionId: string;\n  id?: string;\n  checkoutUrl?: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  embedToken?: string;\n  expiresAt?: string;\n  [key: string]: unknown;\n}\n\nexport type CheckoutSessionStatus =\n  | 'open'\n  | 'customer_set'\n  | 'address_set'\n  | 'processing'\n  | 'completed'\n  | 'expired'\n  | 'cancelled';\n\n/** A session as read back by `getSession` — the create response plus its current state. */\nexport interface CheckoutSessionDetails extends CheckoutSession {\n  status: CheckoutSessionStatus;\n  cartId?: string | null;\n  customerId?: string | null;\n  customerEmail?: string | null;\n  shippingAddress?: CheckoutAddress | null;\n  billingAddress?: CheckoutAddress | null;\n  returnUrl?: string;\n  cancelUrl?: string;\n  completedAt?: string | null;\n  allowedMethods?: string[] | null;\n  collectShipping?: boolean;\n  collectBilling?: boolean;\n  discountCode?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface Net30Acceptance {\n  termsHash: string;\n  acceptedAt: string;\n  companyName: string;\n  billingEmail: string;\n}\n\nexport interface CompleteCheckoutSessionInput {\n  email?: string;\n  shippingAddress?: CheckoutAddress;\n  billingAddress?: CheckoutAddress;\n  billingSameAsShipping?: boolean;\n  paymentMethod: PaymentMethod;\n  netDays?: number;\n  termsAccepted?: boolean;\n  termsSnapshot?: string;\n  invoiceNumber?: string;\n  net30Acceptance?: Net30Acceptance;\n  paymentToken?: string;\n  processorCheckoutSessionId?: string;\n  processorTransactionId?: string;\n}\n\nexport interface CompleteCheckoutSessionResult {\n  orderId: string;\n  orderNumber?: string;\n  paymentId?: string;\n  total?: number;\n  currency?: string;\n  status?: string;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * The card needs a 3-D Secure challenge the buyer has to answer.\n *\n * Only the server-authorized card path (`processorCheckoutSessionId` with no\n * `processorTransactionId`) can produce this. The payment is neither completed\n * nor declined, so there is deliberately no `orderId` and no `paymentId`: put\n * the challenge in front of the buyer, then call `completeSession` again with\n * the same input.\n */\nexport interface CompleteCheckoutSessionRequiresAction {\n  status: 'requires_action';\n  orderId?: undefined;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Narrow on `status === 'requires_action'` before reading `orderId`.\n * `isRequiresAction(result)` does that for you.\n */\nexport type CompleteCheckoutSessionOutcome =\n  | CompleteCheckoutSessionResult\n  | CompleteCheckoutSessionRequiresAction;\n\nexport function isRequiresAction(\n  outcome: CompleteCheckoutSessionOutcome,\n): outcome is CompleteCheckoutSessionRequiresAction {\n  return outcome.status === 'requires_action';\n}\n\nexport interface CreateEmbedTokenInput {\n  externalCartId?: string;\n  amount: number;\n  currency: string;\n  country?: string;\n  // NOTE: `allowedMethods` is intentionally NOT accepted here. A payment-only\n  // Gr4vy embed cannot restrict payment methods (the Gr4vy widget renders the\n  // methods configured on your Gr4vy connection). The server rejects it with\n  // `allowed_methods_unsupported`. To restrict methods, configure the connection\n  // or use the full hosted checkout, where allowedMethods filters the selection.\n}\n\nexport interface CreateEmbedTokenResult {\n  embedToken: string;\n  checkoutSessionId: string;\n  amount: number;\n  currency: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  processorInstanceId?: string;\n  merchantAccountId?: string;\n  [key: string]: unknown;\n}\n\nexport interface CheckoutOrder {\n  id: string;\n  orderNumber?: string;\n  status: string;\n  paymentStatus: string | null;\n  currency: string;\n  subtotal: number;\n  taxTotal: number;\n  shippingTotal: number;\n  total: number;\n  metadata?: Record<string, unknown>;\n  payments?: CheckoutPayment[];\n  [key: string]: unknown;\n}\n\nexport interface ListOrdersOptions {\n  customerId?: string;\n  cursor?: string;\n  limit?: number;\n  status?: string;\n  paymentStatus?: string;\n}\n\nexport interface PaginatedOrders {\n  data: CheckoutOrder[];\n  pagination?: {\n    cursor: string | null;\n    hasMore: boolean;\n  };\n}\n\nexport interface CheckoutPayment {\n  id: string;\n  orderId?: string;\n  processor?: string;\n  processorTransactionId?: string | null;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  method?: string;\n  createdAt?: string;\n  transactions?: CheckoutPaymentTransaction[];\n  [key: string]: unknown;\n}\n\nexport interface CheckoutPaymentTransaction {\n  id: string;\n  paymentId?: string;\n  type?: string;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  createdAt?: string;\n  [key: string]: unknown;\n}\n\nexport interface BuildCheckoutUrlOptions {\n  checkoutOrigin?: string;\n  sessionId: string;\n  parentOrigin?: string;\n  mode?: CheckoutEmbedMode;\n  route?: CheckoutEmbedRoute;\n  primary?: string;\n  logo?: string;\n}\n\nexport interface ThrottleEnvelope<T> {\n  data?: T;\n  meta?: Record<string, unknown>;\n  error?: {\n    code?: string;\n    message?: string;\n    details?: unknown;\n  };\n}\n\n/**\n * Thrown on a non-2xx response from the Throttle Checkout API.\n *\n * Extends the shared {@link ThrottleError} so a single\n * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every\n * Throttle SDK. `instanceof ThrottleCheckoutError` keeps working for existing\n * code.\n */\nexport class ThrottleCheckoutError extends ThrottleError {\n  constructor(args: {\n    code: string;\n    message: string;\n    statusCode: number;\n    details?: unknown;\n    body?: unknown;\n  }) {\n    super(args);\n    this.name = 'ThrottleCheckoutError';\n  }\n}\n\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\n\nexport class CheckoutClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof globalThis.fetch;\n  private readonly timeoutMs: number;\n\n  constructor(opts: CheckoutClientOptions) {\n    if (!opts.apiKey) throw new Error('CheckoutClient: apiKey is required');\n    const fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (!fetchImpl) throw new Error('CheckoutClient: fetch is required');\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? 'https://api.usethrottle.dev').replace(/\\/+$/, '');\n    this.fetchImpl = fetchImpl;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n  }\n\n  async request<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {\n    const envelope = await this.requestEnvelope<T>(method, path, body);\n    if (Object.prototype.hasOwnProperty.call(envelope, 'data')) {\n      return envelope.data as T;\n    }\n    return envelope as T;\n  }\n\n  async requestEnvelope<T = unknown>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<ThrottleEnvelope<T>> {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);\n\n    try {\n      const res = await this.fetchImpl(toAbsoluteUrl(this.baseUrl, path), {\n        method,\n        headers: {\n          'content-type': 'application/json',\n          'x-api-key': this.apiKey,\n        },\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: ctrl.signal,\n      });\n\n      if (res.status === 204) return { data: undefined as T };\n\n      const json = (await res.json().catch(() => ({}))) as ThrottleEnvelope<T>;\n      if (!res.ok) {\n        throw new ThrottleCheckoutError({\n          code: json.error?.code ?? 'unknown_error',\n          message: json.error?.message ?? `HTTP ${res.status}`,\n          statusCode: res.status,\n          details: json.error?.details,\n          body: json,\n        });\n      }\n      return json;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async createSession(input: CreateCheckoutSessionInput): Promise<CheckoutSession> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout/sessions', input);\n    return normalizeCheckoutSession(data);\n  }\n\n  /**\n   * Returns either a completion or `{status: 'requires_action'}` when the card\n   * needs a 3-D Secure challenge — narrow with `isRequiresAction()` before\n   * reading `orderId`.\n   */\n  async completeSession(\n    sessionId: string,\n    input: CompleteCheckoutSessionInput,\n  ): Promise<CompleteCheckoutSessionOutcome> {\n    const data = await this.request<unknown>(\n      'POST',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}/complete`,\n      input,\n    );\n    return normalizeCompleteResult(data);\n  }\n\n  /**\n   * Read a checkout session's current state — `status` tells you whether the\n   * buyer is still in it (`open`, `processing`) or it has settled (`completed`,\n   * `cancelled`, `expired`). Use it to decide whether a session can be resumed\n   * or cancelled instead of tracking that yourself.\n   */\n  async getSession(sessionId: string): Promise<CheckoutSessionDetails> {\n    const data = await this.request<any>(\n      'GET',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n    return {\n      ...normalizeCheckoutSession(data),\n      status: requiredString(data?.status, 'checkoutSession.status') as CheckoutSessionStatus,\n    };\n  }\n\n  /**\n   * Cancel an in-flight checkout session (e.g. the buyer abandoned the embed).\n   * Idempotent — cancelling an already-cancelled session is a no-op; a completed\n   * session cannot be cancelled (the API returns 422 `already_completed`).\n   */\n  async cancelSession(sessionId: string): Promise<void> {\n    await this.request<unknown>(\n      'DELETE',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n  }\n\n  async createEmbedToken(input: CreateEmbedTokenInput): Promise<CreateEmbedTokenResult> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout-sessions/embed-token', input);\n    return normalizeEmbedToken(data);\n  }\n\n  async getOrder(orderId: string): Promise<CheckoutOrder> {\n    const data = await this.request<unknown>('GET', `/api/v1/orders/${encodeURIComponent(orderId)}`);\n    return normalizeOrder(data);\n  }\n\n  async listOrders(options: ListOrdersOptions = {}): Promise<PaginatedOrders> {\n    const params = new URLSearchParams();\n    if (options.customerId) params.set('customerId', options.customerId);\n    if (options.cursor) params.set('cursor', options.cursor);\n    if (options.limit !== undefined) params.set('limit', String(options.limit));\n    if (options.status) params.set('status', options.status);\n    if (options.paymentStatus) params.set('paymentStatus', options.paymentStatus);\n\n    const query = params.toString();\n    const envelope = await this.requestEnvelope<unknown[]>(\n      'GET',\n      `/api/v1/orders${query ? `?${query}` : ''}`,\n    );\n    return {\n      data: (envelope.data ?? []).map(normalizeOrder),\n      pagination: envelope.meta?.pagination as PaginatedOrders['pagination'],\n    };\n  }\n\n  async listOrderPayments(orderId: string): Promise<CheckoutPayment[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/orders/${encodeURIComponent(orderId)}/payments`,\n    );\n    return (data ?? []).map(normalizePayment);\n  }\n\n  async listPaymentTransactions(paymentId: string): Promise<CheckoutPaymentTransaction[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/payments/${encodeURIComponent(paymentId)}/transactions`,\n    );\n    return (data ?? []).map(normalizeTransaction);\n  }\n\n  async getOrderWithPayments(orderId: string): Promise<CheckoutOrder> {\n    const order = await this.getOrder(orderId);\n    const payments = await this.listOrderPayments(orderId);\n    return {\n      ...order,\n      payments: await Promise.all(\n        payments.map(async (payment) => ({\n          ...payment,\n          transactions: payment.id ? await this.listPaymentTransactions(payment.id) : [],\n        })),\n      ),\n    };\n  }\n}\n\nexport function createCheckoutClient(opts: CheckoutClientOptions): CheckoutClient {\n  return new CheckoutClient(opts);\n}\n\nexport function buildCheckoutHostedUrl(options: BuildCheckoutUrlOptions): string {\n  const route = options.route ?? 's';\n  const base = (options.checkoutOrigin ?? 'https://checkout.usethrottle.dev').replace(/\\/+$/, '');\n  return `${base}/${route}/${encodeURIComponent(options.sessionId)}`;\n}\n\nexport function buildCheckoutEmbedUrl(options: BuildCheckoutUrlOptions): string {\n  const baseUrl = buildCheckoutHostedUrl({\n    checkoutOrigin: options.checkoutOrigin,\n    sessionId: options.sessionId,\n    route: options.route ?? 'c',\n  });\n  const params = new URLSearchParams({\n    embed: '1',\n    mode: options.mode ?? 'payment-only',\n    ...(options.parentOrigin ? { parentOrigin: options.parentOrigin.replace(/\\/+$/, '') } : {}),\n  });\n  if (options.primary) params.set('primary', options.primary);\n  if (options.logo) params.set('logo', options.logo);\n  return `${baseUrl}?${params.toString()}`;\n}\n\nfunction toAbsoluteUrl(baseUrl: string, path: string): string {\n  if (/^https?:\\/\\//i.test(path)) return path;\n  return `${baseUrl}${path.startsWith('/') ? path : `/${path}`}`;\n}\n\nfunction normalizeCheckoutSession(raw: any): CheckoutSession {\n  const sessionId = raw?.sessionId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    id: optionalString(raw?.id) ?? undefined,\n    sessionId: requiredString(sessionId, 'checkoutSession.sessionId'),\n    checkoutUrl: optionalString(raw?.checkoutUrl) ?? undefined,\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    embedToken: optionalString(raw?.embedToken) ?? undefined,\n    expiresAt: optionalString(raw?.expiresAt) ?? undefined,\n  };\n}\n\nfunction normalizeCompleteResult(raw: any): CompleteCheckoutSessionOutcome {\n  // A 3-D Secure challenge is a 200, not an error, and carries no order — so\n  // `requiredString(orderId)` below would throw a local parse error at exactly\n  // the moment the caller needs to show the buyer a challenge.\n  if (raw?.status === 'requires_action') {\n    return {\n      ...withoutSnakeKeys(raw),\n      status: 'requires_action',\n      paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n    };\n  }\n  const orderId = raw?.orderId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    orderId: requiredString(orderId, 'checkoutComplete.orderId'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    total: optionalNumber(raw?.total),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n  };\n}\n\nfunction normalizeEmbedToken(raw: any): CreateEmbedTokenResult {\n  return {\n    ...withoutSnakeKeys(raw),\n    embedToken: requiredString(raw?.embedToken, 'embedToken.embedToken'),\n    checkoutSessionId: requiredString(raw?.checkoutSessionId, 'embedToken.checkoutSessionId'),\n    amount: Number(raw?.amount ?? 0),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    processorInstanceId: optionalString(raw?.processorInstanceId) ?? undefined,\n    merchantAccountId: optionalString(raw?.merchantAccountId) ?? undefined,\n  };\n}\n\nfunction normalizeOrder(raw: any): CheckoutOrder {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'order.id'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    status: optionalString(raw?.status) ?? 'processing',\n    paymentStatus: optionalString(raw?.paymentStatus),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    subtotal: Number(raw?.subtotal ?? 0),\n    taxTotal: Number(raw?.taxTotal ?? 0),\n    shippingTotal: Number(raw?.shippingTotal ?? 0),\n    total: Number(raw?.total ?? 0),\n    metadata: objectOrUndefined(raw?.metadata),\n    payments: Array.isArray(raw?.payments) ? raw.payments.map(normalizePayment) : undefined,\n  };\n}\n\nfunction normalizePayment(raw: any): CheckoutPayment {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'payment.id'),\n    orderId: optionalString(raw?.orderId) ?? undefined,\n    processor: optionalString(raw?.processor) ?? undefined,\n    processorTransactionId:\n      optionalString(raw?.processorTransactionId) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    method: optionalString(raw?.method) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n    transactions: Array.isArray(raw?.transactions)\n      ? raw.transactions.map(normalizeTransaction)\n      : undefined,\n  };\n}\n\nfunction normalizeTransaction(raw: any): CheckoutPaymentTransaction {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'transaction.id'),\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    type: optionalString(raw?.type) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n  };\n}\n\nfunction withoutSnakeKeys(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};\n  return Object.fromEntries(\n    Object.entries(value as Record<string, unknown>).filter(([key]) => !key.includes('_')),\n  );\n}\n\nfunction requiredString(value: unknown, label: string): string {\n  if (typeof value === 'string' && value.length > 0) return value;\n  throw new Error(`Invalid Throttle response: missing ${label}`);\n}\n\nfunction optionalString(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nfunction optionalNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction objectOrUndefined(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n"],"mappings":"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","names":["ThrottleError"]}
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import { ThrottleError, type ThrottleErrorArgs } from '@usethrottle/errors';\n\n/**\n * `'embedded'` completes a card payment taken by the payment embed; `'net30'`\n * issues an invoice on terms. `'card'` names the card category in\n * `allowedMethods` — `completeSession` rejects it with 422\n * `payment_method_not_supported`. Use `'embedded'`.\n */\nexport type PaymentMethod = 'net30' | 'card' | 'embedded';\nexport type SubscriptionInterval = 'weekly' | 'biweekly' | 'monthly' | 'quarterly' | 'yearly' | 'custom';\nexport type SubscriptionIntervalUnit = 'hour' | 'day' | 'week' | 'month';\nexport type CheckoutEmbedMode = 'checkout-full' | 'payment-only';\nexport type CheckoutEmbedRoute = 'c' | 's';\n\nexport interface CheckoutClientOptions {\n  apiKey: string;\n  baseUrl?: string;\n  fetch?: typeof globalThis.fetch;\n  timeoutMs?: number;\n}\n\nexport interface CheckoutAddress {\n  firstName: string;\n  lastName: string;\n  company?: string;\n  addressLine1: string;\n  addressLine2?: string;\n  city: string;\n  stateProvince: string;\n  postalCode: string;\n  countryCode: string;\n  phone?: string;\n}\n\nexport interface CheckoutCustomerAddressInput {\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  addressLine1?: string;\n  addressLine2?: string;\n  city?: string;\n  state?: string;\n  postalCode?: string;\n  country?: string;\n}\n\nexport interface CheckoutCustomerInput {\n  customerId?: string;\n  externalCustomerId?: string;\n  email?: string;\n  firstName?: string;\n  lastName?: string;\n  phone?: string;\n  shippingAddress?: CheckoutCustomerAddressInput;\n  billingAddress?: CheckoutCustomerAddressInput;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface RecurringIntentInput {\n  plan: string;\n  /** A named interval. Or send intervalUnit + intervalCount for any cadence from 1 hour to 1 year. */\n  interval?: SubscriptionInterval;\n  intervalUnit?: SubscriptionIntervalUnit;\n  intervalCount?: number;\n  /** Makes the subscription an installment plan of exactly this many payments (2–60). Not combinable with trialDays. */\n  totalPayments?: number;\n  amount?: number;\n  trialDays?: number;\n  planName?: string;\n  create?: 'auto' | 'manual';\n}\n\nexport interface CheckoutCollectInput {\n  shippingAddress?: boolean;\n  billingAddress?: boolean;\n}\n\nexport interface CheckoutPaymentTermsInput {\n  netN?: number | null;\n}\n\nexport interface CreateCheckoutSessionInput {\n  applicationId: string;\n  cartId?: string;\n  externalCartId?: string;\n  customerEmail?: string;\n  customer?: CheckoutCustomerInput;\n  returnUrl: string;\n  cancelUrl: string;\n  allowedMethods?: string[];\n  paymentTerms?: CheckoutPaymentTermsInput;\n  recurring?: RecurringIntentInput;\n  collect?: CheckoutCollectInput;\n  metadata?: Record<string, unknown>;\n  discountCode?: string;\n}\n\nexport interface CheckoutSession {\n  sessionId: string;\n  id?: string;\n  checkoutUrl?: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  embedToken?: string;\n  expiresAt?: string;\n  [key: string]: unknown;\n}\n\nexport type CheckoutSessionStatus =\n  | 'open'\n  | 'customer_set'\n  | 'address_set'\n  | 'processing'\n  | 'completed'\n  | 'expired'\n  | 'cancelled';\n\n/** A session as read back by `getSession` — the create response plus its current state. */\nexport interface CheckoutSessionDetails extends CheckoutSession {\n  status: CheckoutSessionStatus;\n  cartId?: string | null;\n  customerId?: string | null;\n  customerEmail?: string | null;\n  shippingAddress?: CheckoutAddress | null;\n  billingAddress?: CheckoutAddress | null;\n  returnUrl?: string;\n  cancelUrl?: string;\n  completedAt?: string | null;\n  allowedMethods?: string[] | null;\n  collectShipping?: boolean;\n  collectBilling?: boolean;\n  discountCode?: string | null;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface Net30Acceptance {\n  termsHash: string;\n  acceptedAt: string;\n  companyName: string;\n  billingEmail: string;\n}\n\nexport interface CompleteCheckoutSessionInput {\n  email?: string;\n  shippingAddress?: CheckoutAddress;\n  billingAddress?: CheckoutAddress;\n  billingSameAsShipping?: boolean;\n  paymentMethod: PaymentMethod;\n  netDays?: number;\n  termsAccepted?: boolean;\n  termsSnapshot?: string;\n  invoiceNumber?: string;\n  net30Acceptance?: Net30Acceptance;\n  paymentToken?: string;\n  processorCheckoutSessionId?: string;\n  processorTransactionId?: string;\n}\n\nexport interface CompleteCheckoutSessionResult {\n  orderId: string;\n  orderNumber?: string;\n  paymentId?: string;\n  total?: number;\n  currency?: string;\n  status?: string;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * The card needs a 3-D Secure challenge the buyer has to answer.\n *\n * Only the server-authorized card path (`processorCheckoutSessionId` with no\n * `processorTransactionId`) can produce this. The payment is neither completed\n * nor declined, so there is deliberately no `orderId` and no `paymentId`: put\n * the challenge in front of the buyer, then call `completeSession` again with\n * the same input.\n */\nexport interface CompleteCheckoutSessionRequiresAction {\n  status: 'requires_action';\n  orderId?: undefined;\n  paymentStatus?: string;\n  [key: string]: unknown;\n}\n\n/**\n * Narrow on `status === 'requires_action'` before reading `orderId`.\n * `isRequiresAction(result)` does that for you.\n */\nexport type CompleteCheckoutSessionOutcome =\n  | CompleteCheckoutSessionResult\n  | CompleteCheckoutSessionRequiresAction;\n\nexport function isRequiresAction(\n  outcome: CompleteCheckoutSessionOutcome,\n): outcome is CompleteCheckoutSessionRequiresAction {\n  return outcome.status === 'requires_action';\n}\n\nexport interface CreateEmbedTokenInput {\n  externalCartId?: string;\n  amount: number;\n  currency: string;\n  country?: string;\n  // NOTE: `allowedMethods` is intentionally NOT accepted here. A payment-only\n  // Gr4vy embed cannot restrict payment methods (the Gr4vy widget renders the\n  // methods configured on your Gr4vy connection). The server rejects it with\n  // `allowed_methods_unsupported`. To restrict methods, configure the connection\n  // or use the full hosted checkout, where allowedMethods filters the selection.\n}\n\nexport interface CreateEmbedTokenResult {\n  embedToken: string;\n  checkoutSessionId: string;\n  amount: number;\n  currency: string;\n  hostedUrl?: string;\n  embedUrl?: string;\n  processorInstanceId?: string;\n  merchantAccountId?: string;\n  [key: string]: unknown;\n}\n\nexport interface CheckoutOrder {\n  id: string;\n  orderNumber?: string;\n  status: string;\n  paymentStatus: string | null;\n  currency: string;\n  subtotal: number;\n  taxTotal: number;\n  shippingTotal: number;\n  total: number;\n  metadata?: Record<string, unknown>;\n  payments?: CheckoutPayment[];\n  [key: string]: unknown;\n}\n\nexport interface ListOrdersOptions {\n  customerId?: string;\n  cursor?: string;\n  limit?: number;\n  status?: string;\n  paymentStatus?: string;\n}\n\nexport interface PaginatedOrders {\n  data: CheckoutOrder[];\n  pagination?: {\n    cursor: string | null;\n    hasMore: boolean;\n  };\n}\n\nexport interface CheckoutPayment {\n  id: string;\n  orderId?: string;\n  processor?: string;\n  processorTransactionId?: string | null;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  method?: string;\n  createdAt?: string;\n  transactions?: CheckoutPaymentTransaction[];\n  [key: string]: unknown;\n}\n\nexport interface CheckoutPaymentTransaction {\n  id: string;\n  paymentId?: string;\n  type?: string;\n  amount?: number;\n  currency?: string;\n  status?: string;\n  createdAt?: string;\n  [key: string]: unknown;\n}\n\nexport interface BuildCheckoutUrlOptions {\n  checkoutOrigin?: string;\n  sessionId: string;\n  parentOrigin?: string;\n  mode?: CheckoutEmbedMode;\n  route?: CheckoutEmbedRoute;\n  primary?: string;\n  logo?: string;\n}\n\nexport interface ThrottleEnvelope<T> {\n  data?: T;\n  meta?: Record<string, unknown>;\n  error?: {\n    code?: string;\n    message?: string;\n    details?: unknown;\n  };\n}\n\n/**\n * Thrown on a non-2xx response from the Throttle Checkout API.\n *\n * Extends the shared {@link ThrottleError} so a single\n * `catch (e) { if (e instanceof ThrottleError) … }` covers errors from every\n * Throttle SDK. `instanceof ThrottleCheckoutError` keeps working for existing\n * code.\n */\nexport class ThrottleCheckoutError extends ThrottleError {\n  constructor(args: {\n    code: string;\n    message: string;\n    statusCode: number;\n    details?: unknown;\n    body?: unknown;\n    responseHeaders?: ThrottleErrorArgs['responseHeaders'];\n  }) {\n    super(args);\n    this.name = 'ThrottleCheckoutError';\n  }\n}\n\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\n\nexport class CheckoutClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly fetchImpl: typeof globalThis.fetch;\n  private readonly timeoutMs: number;\n\n  constructor(opts: CheckoutClientOptions) {\n    if (!opts.apiKey) throw new Error('CheckoutClient: apiKey is required');\n    const fetchImpl = opts.fetch ?? globalThis.fetch;\n    if (!fetchImpl) throw new Error('CheckoutClient: fetch is required');\n    this.apiKey = opts.apiKey;\n    this.baseUrl = (opts.baseUrl ?? 'https://api.usethrottle.dev').replace(/\\/+$/, '');\n    this.fetchImpl = fetchImpl;\n    this.timeoutMs = opts.timeoutMs ?? 30_000;\n  }\n\n  async request<T = unknown>(method: string, path: string, body?: unknown): Promise<T> {\n    const envelope = await this.requestEnvelope<T>(method, path, body);\n    if (Object.prototype.hasOwnProperty.call(envelope, 'data')) {\n      return envelope.data as T;\n    }\n    return envelope as T;\n  }\n\n  async requestEnvelope<T = unknown>(\n    method: string,\n    path: string,\n    body?: unknown,\n  ): Promise<ThrottleEnvelope<T>> {\n    const ctrl = new AbortController();\n    const timer = setTimeout(() => ctrl.abort(), this.timeoutMs);\n\n    try {\n      const res = await this.fetchImpl(toAbsoluteUrl(this.baseUrl, path), {\n        method,\n        headers: {\n          'content-type': 'application/json',\n          'x-api-key': this.apiKey,\n        },\n        body: body !== undefined ? JSON.stringify(body) : undefined,\n        signal: ctrl.signal,\n      });\n\n      if (res.status === 204) return { data: undefined as T };\n\n      const json = (await res.json().catch(() => ({}))) as ThrottleEnvelope<T>;\n      if (!res.ok) {\n        throw new ThrottleCheckoutError({\n          code: json.error?.code ?? 'unknown_error',\n          message: json.error?.message ?? `HTTP ${res.status}`,\n          statusCode: res.status,\n          details: json.error?.details,\n          body: json,\n          responseHeaders: res.headers,\n        });\n      }\n      return json;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  async createSession(input: CreateCheckoutSessionInput): Promise<CheckoutSession> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout/sessions', input);\n    return normalizeCheckoutSession(data);\n  }\n\n  /**\n   * Returns either a completion or `{status: 'requires_action'}` when the card\n   * needs a 3-D Secure challenge — narrow with `isRequiresAction()` before\n   * reading `orderId`.\n   */\n  async completeSession(\n    sessionId: string,\n    input: CompleteCheckoutSessionInput,\n  ): Promise<CompleteCheckoutSessionOutcome> {\n    const data = await this.request<unknown>(\n      'POST',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}/complete`,\n      input,\n    );\n    return normalizeCompleteResult(data);\n  }\n\n  /**\n   * Read a checkout session's current state — `status` tells you whether the\n   * buyer is still in it (`open`, `processing`) or it has settled (`completed`,\n   * `cancelled`, `expired`). Use it to decide whether a session can be resumed\n   * or cancelled instead of tracking that yourself.\n   */\n  async getSession(sessionId: string): Promise<CheckoutSessionDetails> {\n    const data = await this.request<any>(\n      'GET',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n    return {\n      ...normalizeCheckoutSession(data),\n      status: requiredString(data?.status, 'checkoutSession.status') as CheckoutSessionStatus,\n    };\n  }\n\n  /**\n   * Cancel an in-flight checkout session (e.g. the buyer abandoned the embed).\n   * Idempotent — cancelling an already-cancelled session is a no-op; a completed\n   * session cannot be cancelled (the API returns 422 `already_completed`).\n   */\n  async cancelSession(sessionId: string): Promise<void> {\n    await this.request<unknown>(\n      'DELETE',\n      `/api/v1/checkout/sessions/${encodeURIComponent(sessionId)}`,\n    );\n  }\n\n  async createEmbedToken(input: CreateEmbedTokenInput): Promise<CreateEmbedTokenResult> {\n    const data = await this.request<unknown>('POST', '/api/v1/checkout-sessions/embed-token', input);\n    return normalizeEmbedToken(data);\n  }\n\n  async getOrder(orderId: string): Promise<CheckoutOrder> {\n    const data = await this.request<unknown>('GET', `/api/v1/orders/${encodeURIComponent(orderId)}`);\n    return normalizeOrder(data);\n  }\n\n  async listOrders(options: ListOrdersOptions = {}): Promise<PaginatedOrders> {\n    const params = new URLSearchParams();\n    if (options.customerId) params.set('customerId', options.customerId);\n    if (options.cursor) params.set('cursor', options.cursor);\n    if (options.limit !== undefined) params.set('limit', String(options.limit));\n    if (options.status) params.set('status', options.status);\n    if (options.paymentStatus) params.set('paymentStatus', options.paymentStatus);\n\n    const query = params.toString();\n    const envelope = await this.requestEnvelope<unknown[]>(\n      'GET',\n      `/api/v1/orders${query ? `?${query}` : ''}`,\n    );\n    return {\n      data: (envelope.data ?? []).map(normalizeOrder),\n      pagination: envelope.meta?.pagination as PaginatedOrders['pagination'],\n    };\n  }\n\n  async listOrderPayments(orderId: string): Promise<CheckoutPayment[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/orders/${encodeURIComponent(orderId)}/payments`,\n    );\n    return (data ?? []).map(normalizePayment);\n  }\n\n  async listPaymentTransactions(paymentId: string): Promise<CheckoutPaymentTransaction[]> {\n    const data = await this.request<unknown[]>(\n      'GET',\n      `/api/v1/payments/${encodeURIComponent(paymentId)}/transactions`,\n    );\n    return (data ?? []).map(normalizeTransaction);\n  }\n\n  async getOrderWithPayments(orderId: string): Promise<CheckoutOrder> {\n    const order = await this.getOrder(orderId);\n    const payments = await this.listOrderPayments(orderId);\n    return {\n      ...order,\n      payments: await Promise.all(\n        payments.map(async (payment) => ({\n          ...payment,\n          transactions: payment.id ? await this.listPaymentTransactions(payment.id) : [],\n        })),\n      ),\n    };\n  }\n}\n\nexport function createCheckoutClient(opts: CheckoutClientOptions): CheckoutClient {\n  return new CheckoutClient(opts);\n}\n\nexport function buildCheckoutHostedUrl(options: BuildCheckoutUrlOptions): string {\n  const route = options.route ?? 's';\n  const base = (options.checkoutOrigin ?? 'https://checkout.usethrottle.dev').replace(/\\/+$/, '');\n  return `${base}/${route}/${encodeURIComponent(options.sessionId)}`;\n}\n\nexport function buildCheckoutEmbedUrl(options: BuildCheckoutUrlOptions): string {\n  const baseUrl = buildCheckoutHostedUrl({\n    checkoutOrigin: options.checkoutOrigin,\n    sessionId: options.sessionId,\n    route: options.route ?? 'c',\n  });\n  const params = new URLSearchParams({\n    embed: '1',\n    mode: options.mode ?? 'payment-only',\n    ...(options.parentOrigin ? { parentOrigin: options.parentOrigin.replace(/\\/+$/, '') } : {}),\n  });\n  if (options.primary) params.set('primary', options.primary);\n  if (options.logo) params.set('logo', options.logo);\n  return `${baseUrl}?${params.toString()}`;\n}\n\nfunction toAbsoluteUrl(baseUrl: string, path: string): string {\n  if (/^https?:\\/\\//i.test(path)) return path;\n  return `${baseUrl}${path.startsWith('/') ? path : `/${path}`}`;\n}\n\nfunction normalizeCheckoutSession(raw: any): CheckoutSession {\n  const sessionId = raw?.sessionId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    id: optionalString(raw?.id) ?? undefined,\n    sessionId: requiredString(sessionId, 'checkoutSession.sessionId'),\n    checkoutUrl: optionalString(raw?.checkoutUrl) ?? undefined,\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    embedToken: optionalString(raw?.embedToken) ?? undefined,\n    expiresAt: optionalString(raw?.expiresAt) ?? undefined,\n  };\n}\n\nfunction normalizeCompleteResult(raw: any): CompleteCheckoutSessionOutcome {\n  // A 3-D Secure challenge is a 200, not an error, and carries no order — so\n  // `requiredString(orderId)` below would throw a local parse error at exactly\n  // the moment the caller needs to show the buyer a challenge.\n  if (raw?.status === 'requires_action') {\n    return {\n      ...withoutSnakeKeys(raw),\n      status: 'requires_action',\n      paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n    };\n  }\n  const orderId = raw?.orderId ?? raw?.id;\n  return {\n    ...withoutSnakeKeys(raw),\n    orderId: requiredString(orderId, 'checkoutComplete.orderId'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    total: optionalNumber(raw?.total),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    paymentStatus: optionalString(raw?.paymentStatus) ?? undefined,\n  };\n}\n\nfunction normalizeEmbedToken(raw: any): CreateEmbedTokenResult {\n  return {\n    ...withoutSnakeKeys(raw),\n    embedToken: requiredString(raw?.embedToken, 'embedToken.embedToken'),\n    checkoutSessionId: requiredString(raw?.checkoutSessionId, 'embedToken.checkoutSessionId'),\n    amount: Number(raw?.amount ?? 0),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    hostedUrl: optionalString(raw?.hostedUrl) ?? undefined,\n    embedUrl: optionalString(raw?.embedUrl) ?? undefined,\n    processorInstanceId: optionalString(raw?.processorInstanceId) ?? undefined,\n    merchantAccountId: optionalString(raw?.merchantAccountId) ?? undefined,\n  };\n}\n\nfunction normalizeOrder(raw: any): CheckoutOrder {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'order.id'),\n    orderNumber: optionalString(raw?.orderNumber) ?? undefined,\n    status: optionalString(raw?.status) ?? 'processing',\n    paymentStatus: optionalString(raw?.paymentStatus),\n    currency: optionalString(raw?.currency) ?? 'USD',\n    subtotal: Number(raw?.subtotal ?? 0),\n    taxTotal: Number(raw?.taxTotal ?? 0),\n    shippingTotal: Number(raw?.shippingTotal ?? 0),\n    total: Number(raw?.total ?? 0),\n    metadata: objectOrUndefined(raw?.metadata),\n    payments: Array.isArray(raw?.payments) ? raw.payments.map(normalizePayment) : undefined,\n  };\n}\n\nfunction normalizePayment(raw: any): CheckoutPayment {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'payment.id'),\n    orderId: optionalString(raw?.orderId) ?? undefined,\n    processor: optionalString(raw?.processor) ?? undefined,\n    processorTransactionId:\n      optionalString(raw?.processorTransactionId) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    method: optionalString(raw?.method) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n    transactions: Array.isArray(raw?.transactions)\n      ? raw.transactions.map(normalizeTransaction)\n      : undefined,\n  };\n}\n\nfunction normalizeTransaction(raw: any): CheckoutPaymentTransaction {\n  return {\n    ...withoutSnakeKeys(raw),\n    id: requiredString(raw?.id, 'transaction.id'),\n    paymentId: optionalString(raw?.paymentId) ?? undefined,\n    type: optionalString(raw?.type) ?? undefined,\n    amount: optionalNumber(raw?.amount),\n    currency: optionalString(raw?.currency) ?? undefined,\n    status: optionalString(raw?.status) ?? undefined,\n    createdAt: optionalString(raw?.createdAt) ?? undefined,\n  };\n}\n\nfunction withoutSnakeKeys(value: unknown): Record<string, unknown> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};\n  return Object.fromEntries(\n    Object.entries(value as Record<string, unknown>).filter(([key]) => !key.includes('_')),\n  );\n}\n\nfunction requiredString(value: unknown, label: string): string {\n  if (typeof value === 'string' && value.length > 0) return value;\n  throw new Error(`Invalid Throttle response: missing ${label}`);\n}\n\nfunction optionalString(value: unknown): string | null {\n  return typeof value === 'string' && value.length > 0 ? value : null;\n}\n\nfunction optionalNumber(value: unknown): number | undefined {\n  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;\n}\n\nfunction objectOrUndefined(value: unknown): Record<string, unknown> | undefined {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : undefined;\n}\n"],"mappings":"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","names":["ThrottleError"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/checkout-sdk",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -27,8 +27,8 @@
     "react-dom": ">=18 <20"
   },
   "dependencies": {
-    "@usethrottle/checkout-react": "2.0.0",
-    "@usethrottle/errors": "^1.0.0"
+    "@usethrottle/errors": "^1.1.0",
+    "@usethrottle/checkout-react": "2.0.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.0.0",