@usethrottle/checkout-sdk 2.1.0 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @usethrottle/checkout-sdk
 
+## 2.2.0
+
+### Minor Changes
+
+- 14a651f: Multi-currency display. Every SDK re-exports `@usethrottle/money`: a `money` namespace plus `formatMoney`, `currencySymbol`, `minorUnitsOf`, `toDecimalString`, `toMinor`, `parseMoney`, `moneyValue`, `CURRENCIES`, `isKnownCurrency`, `UnknownCurrencyError` and the `CurrencyCode` / `MoneyValue` types (`@usethrottle/mcp` from its library entry). Where an entry already exports a `formatMoney`, that one stays and money's is `money.formatMoney`: `@usethrottle/quotes` keeps `formatMoney(minor, currency, locale?)` and `@usethrottle/auth/components` keeps `formatMoney(minor, currency, locale)`, both deprecated and now printing en-US digits with the currency's own exponent (the locale no longer changes digits). The root `@usethrottle/auth` entry exports money's two-argument `formatMoney`.
+
+  Response `currency` fields are typed `CurrencyCode` (assignable to and from `string`); request inputs stay `string`. No normaliser invents `USD` any more: a subscription, checkout order or embed token without `currency` throws the SDK's "Invalid Throttle response" error, and a subscription renewal charge without one takes the subscription's.
+  - `@usethrottle/api-client`: the public `GET /api/v1/checkout-sessions/{id}` declares its session `currency`, so its result is typed `Record<string, any>` instead of `any`.
+  - `@usethrottle/cart`: `CurrencyNotSupportedError`, `CurrencyNotAvailableInProductionError`, `CurrencyLockedError` and `QuoteAmountsNeedReviewError`, mapped from their codes.
+  - `@usethrottle/payment-methods`: `startAddCard({ currency })`, `<PaymentMethods currency>` and `usePaymentMethods({ currency })` choose the add-card verification hold's currency.
+  - `@usethrottle/discounts`: `Discount.amounts` (per-currency amounts) and `minimum` / `shortfall` on validate and preview results, all optional.
+  - `@usethrottle/quotes`: `<QuoteView>` prints the same amounts on the server and in the browser, whatever the runtime's locale.
+  - `@usethrottle/webhook-types` (major): every payload that carries an amount now has a required `currency`; the money helpers are re-exported at runtime too.
+  - `@usethrottle/cli`: human output formats amounts with `@usethrottle/money` (the currency's own symbol and exponent). The CLI has no library entry, so it re-exports nothing; install `@usethrottle/money` to format amounts yourself.
+  - `@usethrottle/mcp`: the `create_checkout_link` tool description and the session instructions no longer quote amounts in dollars.
+
+### Patch Changes
+
+- Updated dependencies [14a651f]
+  - @usethrottle/checkout-react@2.2.0
+
+## 2.1.1
+
+### Patch Changes
+
+- Updated dependencies [611e776]
+  - @usethrottle/checkout-react@2.1.1
+
 ## 2.1.0
 
 ### Minor Changes

package/README.md

@@ -133,6 +133,13 @@ Net-N day count belongs in `paymentTerms.netN`.
 | `cancelled`    | `sessionId`, `timestamp`                         | User cancelled checkout                    |
 | `step_changed` | `sessionId`, `step`, `timestamp`                 | Checkout step navigation (full embed only) |
 
+## Money
+
+Amounts are integers in the record's minor unit. Show them with
+`formatMoney(amount, currency)`: this package re-exports
+`@usethrottle/money` as `money` and `formatMoney` by name, plus the
+`CurrencyCode` and `MoneyValue` types.
+
 ## Idempotency
 
 `onSucceeded` and `onFailed` are terminal events — the underlying iframe can occasionally emit duplicate postMessages on network hiccups or React strict-mode double-renders. `ThrottleCheckout` maintains a `settledRef` that ensures only the first terminal event fires the callback. All subsequent duplicates are silently dropped.

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,14 +17,33 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CURRENCIES: () => import_money.CURRENCIES,
   ThrottleCheckout: () => ThrottleCheckout,
   ThrottleError: () => import_errors.ThrottleError,
-  isThrottleError: () => import_errors.isThrottleError
+  UnknownCurrencyError: () => import_money.UnknownCurrencyError,
+  currencySymbol: () => import_money.currencySymbol,
+  formatMoney: () => import_money.formatMoney,
+  isKnownCurrency: () => import_money.isKnownCurrency,
+  isThrottleError: () => import_errors.isThrottleError,
+  minorUnitsOf: () => import_money.minorUnitsOf,
+  money: () => money,
+  moneyValue: () => import_money.moneyValue,
+  parseMoney: () => import_money.parseMoney,
+  toDecimalString: () => import_money.toDecimalString,
+  toMinor: () => import_money.toMinor
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -105,10 +126,23 @@ function ThrottleCheckout({
 
 // src/index.ts
 var import_errors = require("@usethrottle/errors");
+var money = __toESM(require("@usethrottle/money"), 1);
+var import_money = require("@usethrottle/money");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CURRENCIES,
   ThrottleCheckout,
   ThrottleError,
-  isThrottleError
+  UnknownCurrencyError,
+  currencySymbol,
+  formatMoney,
+  isKnownCurrency,
+  isThrottleError,
+  minorUnitsOf,
+  money,
+  moneyValue,
+  parseMoney,
+  toDecimalString,
+  toMinor
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/ThrottleCheckout.tsx"],"sourcesContent":["export { ThrottleCheckout } from './ThrottleCheckout.js';\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\nexport type {\n  BrandTheme,\n  TelemetryEvent,\n  ThrottleCheckoutProps,\n  SucceededLineItem,\n} from './types.js';\n","import { useCallback, useEffect, useRef } from 'react';\nimport { PaymentEmbed } from '@usethrottle/checkout-react';\nimport type { ThrottleCheckoutProps, TelemetryEvent } from './types.js';\n\n/**\n * ThrottleCheckout — Phase 1 platform SDK wrapper.\n *\n * Wraps `<PaymentEmbed>` from `@usethrottle/checkout-react` and adds:\n *   1. Idempotency  — settledRef ensures `onSucceeded` / `onFailed` fire at most once\n *                     per component lifetime, even if the iframe sends duplicate events.\n *   2. Telemetry    — `onTelemetry` callback receives every lifecycle event with a\n *                     typed payload so workspaces can pipe to Datadog / Segment / etc.\n *   3. Brand theming — `theme.primary` + `theme.logo` are forwarded to the underlying\n *                     `<PaymentEmbed>` which appends them as URL query params on the\n *                     hosted checkout iframe src.\n */\nexport function ThrottleCheckout({\n  sessionId,\n  parentOrigin = '',\n  baseUrl,\n  theme,\n  onSucceeded,\n  onFailed,\n  onCancelled,\n  onTelemetry,\n}: ThrottleCheckoutProps): JSX.Element {\n  // Idempotency guard — once a terminal event (success or failure) fires,\n  // all subsequent duplicate events from the iframe are silently dropped.\n  const settledRef = useRef(false);\n\n  const emit = useCallback(\n    (event: TelemetryEvent) => {\n      onTelemetry?.(event);\n    },\n    [onTelemetry],\n  );\n\n  // Fire \"mounted\" telemetry once on initial render.\n  useEffect(() => {\n    emit({ type: 'mounted', sessionId, timestamp: Date.now() });\n    // intentionally only on mount — sessionId identity change re-mounts anyway\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const handleReady = useCallback(() => {\n    emit({ type: 'ready', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleProcessing = useCallback(() => {\n    emit({ type: 'processing', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleSucceeded = useCallback(\n    (evt: {\n      orderId: string;\n      paymentId: string;\n      subscriptionId?: string;\n      subscriptionIds?: string[];\n      total?: number;\n      currency?: string;\n      lineItems?: import('./types.js').SucceededLineItem[];\n    }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({\n        type: 'succeeded',\n        sessionId,\n        orderId: evt.orderId,\n        paymentId: evt.paymentId,\n        timestamp: Date.now(),\n        ...(evt.total !== undefined ? { total: evt.total } : {}),\n        ...(evt.currency !== undefined ? { currency: evt.currency } : {}),\n      });\n      onSucceeded?.(evt);\n    },\n    [emit, sessionId, onSucceeded],\n  );\n\n  const handleFailed = useCallback(\n    ({ code, message }: { code: string; message: string }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({ type: 'failed', sessionId, code, message, timestamp: Date.now() });\n      onFailed?.({ code, message });\n    },\n    [emit, sessionId, onFailed],\n  );\n\n  const handleCanceled = useCallback(() => {\n    emit({ type: 'cancelled', sessionId, timestamp: Date.now() });\n    onCancelled?.();\n  }, [emit, sessionId, onCancelled]);\n\n  return (\n    <PaymentEmbed\n      sessionId={sessionId}\n      parentOrigin={parentOrigin}\n      {...(baseUrl !== undefined ? { baseUrl } : {})}\n      primary={theme?.primary}\n      logo={theme?.logo}\n      onReady={handleReady}\n      onProcessing={handleProcessing}\n      onSucceeded={handleSucceeded}\n      onFailed={handleFailed}\n      onCanceled={handleCanceled}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAA+C;AAC/C,4BAA6B;AA6FzB;AA9EG,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuC;AAGrC,QAAM,iBAAa,qBAAO,KAAK;AAE/B,QAAM,WAAO;AAAA,IACX,CAAC,UAA0B;AACzB,oBAAc,KAAK;AAAA,IACrB;AAAA,IACA,CAAC,WAAW;AAAA,EACd;AAGA,8BAAU,MAAM;AACd,SAAK,EAAE,MAAM,WAAW,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAG5D,GAAG,CAAC,CAAC;AAEL,QAAM,kBAAc,0BAAY,MAAM;AACpC,SAAK,EAAE,MAAM,SAAS,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,uBAAmB,0BAAY,MAAM;AACzC,SAAK,EAAE,MAAM,cAAc,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC/D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,sBAAkB;AAAA,IACtB,CAAC,QAQK;AACJ,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK;AAAA,QACH,MAAM;AAAA,QACN;AAAA,QACA,SAAS,IAAI;AAAA,QACb,WAAW,IAAI;AAAA,QACf,WAAW,KAAK,IAAI;AAAA,QACpB,GAAI,IAAI,UAAU,SAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;AAAA,QACtD,GAAI,IAAI,aAAa,SAAY,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,MACjE,CAAC;AACD,oBAAc,GAAG;AAAA,IACnB;AAAA,IACA,CAAC,MAAM,WAAW,WAAW;AAAA,EAC/B;AAEA,QAAM,mBAAe;AAAA,IACnB,CAAC,EAAE,MAAM,QAAQ,MAAyC;AACxD,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK,EAAE,MAAM,UAAU,WAAW,MAAM,SAAS,WAAW,KAAK,IAAI,EAAE,CAAC;AACxE,iBAAW,EAAE,MAAM,QAAQ,CAAC;AAAA,IAC9B;AAAA,IACA,CAAC,MAAM,WAAW,QAAQ;AAAA,EAC5B;AAEA,QAAM,qBAAiB,0BAAY,MAAM;AACvC,SAAK,EAAE,MAAM,aAAa,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAC5D,kBAAc;AAAA,EAChB,GAAG,CAAC,MAAM,WAAW,WAAW,CAAC;AAEjC,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACC,GAAI,YAAY,SAAY,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC5C,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO;AAAA,MACb,SAAS;AAAA,MACT,cAAc;AAAA,MACd,aAAa;AAAA,MACb,UAAU;AAAA,MACV,YAAY;AAAA;AAAA,EACd;AAEJ;;;AD1GA,oBAA+C;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/ThrottleCheckout.tsx"],"sourcesContent":["export { ThrottleCheckout } from './ThrottleCheckout.js';\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\nexport type {\n  BrandTheme,\n  TelemetryEvent,\n  ThrottleCheckoutProps,\n  SucceededLineItem,\n} from './types.js';\n// Money helpers (MC2-R34): amounts are integer minor units of their `currency`.\nexport * as money from '@usethrottle/money';\nexport {\n  formatMoney,\n  currencySymbol,\n  minorUnitsOf,\n  toDecimalString,\n  toMinor,\n  parseMoney,\n  moneyValue,\n  CURRENCIES,\n  isKnownCurrency,\n  UnknownCurrencyError,\n} from '@usethrottle/money';\nexport type { CurrencyCode, MoneyValue } from '@usethrottle/money';\n","import { useCallback, useEffect, useRef } from 'react';\nimport { PaymentEmbed } from '@usethrottle/checkout-react';\nimport type { ThrottleCheckoutProps, TelemetryEvent } from './types.js';\n\n/**\n * ThrottleCheckout — Phase 1 platform SDK wrapper.\n *\n * Wraps `<PaymentEmbed>` from `@usethrottle/checkout-react` and adds:\n *   1. Idempotency  — settledRef ensures `onSucceeded` / `onFailed` fire at most once\n *                     per component lifetime, even if the iframe sends duplicate events.\n *   2. Telemetry    — `onTelemetry` callback receives every lifecycle event with a\n *                     typed payload so workspaces can pipe to Datadog / Segment / etc.\n *   3. Brand theming — `theme.primary` + `theme.logo` are forwarded to the underlying\n *                     `<PaymentEmbed>` which appends them as URL query params on the\n *                     hosted checkout iframe src.\n */\nexport function ThrottleCheckout({\n  sessionId,\n  parentOrigin = '',\n  baseUrl,\n  theme,\n  onSucceeded,\n  onFailed,\n  onCancelled,\n  onTelemetry,\n}: ThrottleCheckoutProps): JSX.Element {\n  // Idempotency guard — once a terminal event (success or failure) fires,\n  // all subsequent duplicate events from the iframe are silently dropped.\n  const settledRef = useRef(false);\n\n  const emit = useCallback(\n    (event: TelemetryEvent) => {\n      onTelemetry?.(event);\n    },\n    [onTelemetry],\n  );\n\n  // Fire \"mounted\" telemetry once on initial render.\n  useEffect(() => {\n    emit({ type: 'mounted', sessionId, timestamp: Date.now() });\n    // intentionally only on mount — sessionId identity change re-mounts anyway\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const handleReady = useCallback(() => {\n    emit({ type: 'ready', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleProcessing = useCallback(() => {\n    emit({ type: 'processing', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleSucceeded = useCallback(\n    (evt: {\n      orderId: string;\n      paymentId: string;\n      subscriptionId?: string;\n      subscriptionIds?: string[];\n      total?: number;\n      currency?: string;\n      lineItems?: import('./types.js').SucceededLineItem[];\n    }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({\n        type: 'succeeded',\n        sessionId,\n        orderId: evt.orderId,\n        paymentId: evt.paymentId,\n        timestamp: Date.now(),\n        ...(evt.total !== undefined ? { total: evt.total } : {}),\n        ...(evt.currency !== undefined ? { currency: evt.currency } : {}),\n      });\n      onSucceeded?.(evt);\n    },\n    [emit, sessionId, onSucceeded],\n  );\n\n  const handleFailed = useCallback(\n    ({ code, message }: { code: string; message: string }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({ type: 'failed', sessionId, code, message, timestamp: Date.now() });\n      onFailed?.({ code, message });\n    },\n    [emit, sessionId, onFailed],\n  );\n\n  const handleCanceled = useCallback(() => {\n    emit({ type: 'cancelled', sessionId, timestamp: Date.now() });\n    onCancelled?.();\n  }, [emit, sessionId, onCancelled]);\n\n  return (\n    <PaymentEmbed\n      sessionId={sessionId}\n      parentOrigin={parentOrigin}\n      {...(baseUrl !== undefined ? { baseUrl } : {})}\n      primary={theme?.primary}\n      logo={theme?.logo}\n      onReady={handleReady}\n      onProcessing={handleProcessing}\n      onSucceeded={handleSucceeded}\n      onFailed={handleFailed}\n      onCanceled={handleCanceled}\n    />\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,mBAA+C;AAC/C,4BAA6B;AA6FzB;AA9EG,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuC;AAGrC,QAAM,iBAAa,qBAAO,KAAK;AAE/B,QAAM,WAAO;AAAA,IACX,CAAC,UAA0B;AACzB,oBAAc,KAAK;AAAA,IACrB;AAAA,IACA,CAAC,WAAW;AAAA,EACd;AAGA,8BAAU,MAAM;AACd,SAAK,EAAE,MAAM,WAAW,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAG5D,GAAG,CAAC,CAAC;AAEL,QAAM,kBAAc,0BAAY,MAAM;AACpC,SAAK,EAAE,MAAM,SAAS,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,uBAAmB,0BAAY,MAAM;AACzC,SAAK,EAAE,MAAM,cAAc,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC/D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,sBAAkB;AAAA,IACtB,CAAC,QAQK;AACJ,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK;AAAA,QACH,MAAM;AAAA,QACN;AAAA,QACA,SAAS,IAAI;AAAA,QACb,WAAW,IAAI;AAAA,QACf,WAAW,KAAK,IAAI;AAAA,QACpB,GAAI,IAAI,UAAU,SAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;AAAA,QACtD,GAAI,IAAI,aAAa,SAAY,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,MACjE,CAAC;AACD,oBAAc,GAAG;AAAA,IACnB;AAAA,IACA,CAAC,MAAM,WAAW,WAAW;AAAA,EAC/B;AAEA,QAAM,mBAAe;AAAA,IACnB,CAAC,EAAE,MAAM,QAAQ,MAAyC;AACxD,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK,EAAE,MAAM,UAAU,WAAW,MAAM,SAAS,WAAW,KAAK,IAAI,EAAE,CAAC;AACxE,iBAAW,EAAE,MAAM,QAAQ,CAAC;AAAA,IAC9B;AAAA,IACA,CAAC,MAAM,WAAW,QAAQ;AAAA,EAC5B;AAEA,QAAM,qBAAiB,0BAAY,MAAM;AACvC,SAAK,EAAE,MAAM,aAAa,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAC5D,kBAAc;AAAA,EAChB,GAAG,CAAC,MAAM,WAAW,WAAW,CAAC;AAEjC,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACC,GAAI,YAAY,SAAY,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC5C,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO;AAAA,MACb,SAAS;AAAA,MACT,cAAc;AAAA,MACd,aAAa;AAAA,MACb,UAAU;AAAA,MACV,YAAY;AAAA;AAAA,EACd;AAEJ;;;AD1GA,oBAA+C;AAQ/C,YAAuB;AACvB,mBAWO;","names":[]}

package/dist/index.d.cts

@@ -1,8 +1,13 @@
+import { CurrencyCode } from '@usethrottle/money';
+import * as money from '@usethrottle/money';
+export { money };
+export { CURRENCIES, CurrencyCode, MoneyValue, UnknownCurrencyError, currencySymbol, formatMoney, isKnownCurrency, minorUnitsOf, moneyValue, parseMoney, toDecimalString, toMinor } from '@usethrottle/money';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
 
 /**
  * @usethrottle/checkout-sdk — Phase 1 types.
  */
+
 interface BrandTheme {
     /** Brand primary colour (#rrggbb or CSS named colour). */
     primary?: string;
@@ -39,7 +44,7 @@ type TelemetryEvent = {
     timestamp: number;
     /** Order total in minor units (when the checkout page supplied it). */
     total?: number;
-    currency?: string;
+    currency?: CurrencyCode;
 } | {
     type: 'failed';
     sessionId: string;
@@ -71,14 +76,15 @@ interface ThrottleCheckoutProps {
     /** Fired once when payment completes successfully. Analytics fields
      * (`total`/`currency`/`lineItems`, minor units) are present when the
      * checkout page supplied them — fire `gtag`/`fbq` purchase events with
-     * value = total / 100. */
+     * value = `toDecimalString(total, currency)` (the currency's own exponent:
+     * JPY has none, KWD has three). */
     onSucceeded?: (args: {
         orderId: string;
         paymentId: string;
         subscriptionId?: string;
         subscriptionIds?: string[];
         total?: number;
-        currency?: string;
+        currency?: CurrencyCode;
         lineItems?: SucceededLineItem[];
     }) => void;
     /** Fired once when payment fails terminally. */

package/dist/index.d.ts

@@ -1,8 +1,13 @@
+import { CurrencyCode } from '@usethrottle/money';
+import * as money from '@usethrottle/money';
+export { money };
+export { CURRENCIES, CurrencyCode, MoneyValue, UnknownCurrencyError, currencySymbol, formatMoney, isKnownCurrency, minorUnitsOf, moneyValue, parseMoney, toDecimalString, toMinor } from '@usethrottle/money';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
 
 /**
  * @usethrottle/checkout-sdk — Phase 1 types.
  */
+
 interface BrandTheme {
     /** Brand primary colour (#rrggbb or CSS named colour). */
     primary?: string;
@@ -39,7 +44,7 @@ type TelemetryEvent = {
     timestamp: number;
     /** Order total in minor units (when the checkout page supplied it). */
     total?: number;
-    currency?: string;
+    currency?: CurrencyCode;
 } | {
     type: 'failed';
     sessionId: string;
@@ -71,14 +76,15 @@ interface ThrottleCheckoutProps {
     /** Fired once when payment completes successfully. Analytics fields
      * (`total`/`currency`/`lineItems`, minor units) are present when the
      * checkout page supplied them — fire `gtag`/`fbq` purchase events with
-     * value = total / 100. */
+     * value = `toDecimalString(total, currency)` (the currency's own exponent:
+     * JPY has none, KWD has three). */
     onSucceeded?: (args: {
         orderId: string;
         paymentId: string;
         subscriptionId?: string;
         subscriptionIds?: string[];
         total?: number;
-        currency?: string;
+        currency?: CurrencyCode;
         lineItems?: SucceededLineItem[];
     }) => void;
     /** Fired once when payment fails terminally. */

package/dist/index.js

@@ -77,9 +77,33 @@ function ThrottleCheckout({
 
 // src/index.ts
 import { ThrottleError, isThrottleError } from "@usethrottle/errors";
+import * as money from "@usethrottle/money";
+import {
+  formatMoney,
+  currencySymbol,
+  minorUnitsOf,
+  toDecimalString,
+  toMinor,
+  parseMoney,
+  moneyValue,
+  CURRENCIES,
+  isKnownCurrency,
+  UnknownCurrencyError
+} from "@usethrottle/money";
 export {
+  CURRENCIES,
   ThrottleCheckout,
   ThrottleError,
-  isThrottleError
+  UnknownCurrencyError,
+  currencySymbol,
+  formatMoney,
+  isKnownCurrency,
+  isThrottleError,
+  minorUnitsOf,
+  money,
+  moneyValue,
+  parseMoney,
+  toDecimalString,
+  toMinor
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ThrottleCheckout.tsx","../src/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport { PaymentEmbed } from '@usethrottle/checkout-react';\nimport type { ThrottleCheckoutProps, TelemetryEvent } from './types.js';\n\n/**\n * ThrottleCheckout — Phase 1 platform SDK wrapper.\n *\n * Wraps `<PaymentEmbed>` from `@usethrottle/checkout-react` and adds:\n *   1. Idempotency  — settledRef ensures `onSucceeded` / `onFailed` fire at most once\n *                     per component lifetime, even if the iframe sends duplicate events.\n *   2. Telemetry    — `onTelemetry` callback receives every lifecycle event with a\n *                     typed payload so workspaces can pipe to Datadog / Segment / etc.\n *   3. Brand theming — `theme.primary` + `theme.logo` are forwarded to the underlying\n *                     `<PaymentEmbed>` which appends them as URL query params on the\n *                     hosted checkout iframe src.\n */\nexport function ThrottleCheckout({\n  sessionId,\n  parentOrigin = '',\n  baseUrl,\n  theme,\n  onSucceeded,\n  onFailed,\n  onCancelled,\n  onTelemetry,\n}: ThrottleCheckoutProps): JSX.Element {\n  // Idempotency guard — once a terminal event (success or failure) fires,\n  // all subsequent duplicate events from the iframe are silently dropped.\n  const settledRef = useRef(false);\n\n  const emit = useCallback(\n    (event: TelemetryEvent) => {\n      onTelemetry?.(event);\n    },\n    [onTelemetry],\n  );\n\n  // Fire \"mounted\" telemetry once on initial render.\n  useEffect(() => {\n    emit({ type: 'mounted', sessionId, timestamp: Date.now() });\n    // intentionally only on mount — sessionId identity change re-mounts anyway\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const handleReady = useCallback(() => {\n    emit({ type: 'ready', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleProcessing = useCallback(() => {\n    emit({ type: 'processing', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleSucceeded = useCallback(\n    (evt: {\n      orderId: string;\n      paymentId: string;\n      subscriptionId?: string;\n      subscriptionIds?: string[];\n      total?: number;\n      currency?: string;\n      lineItems?: import('./types.js').SucceededLineItem[];\n    }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({\n        type: 'succeeded',\n        sessionId,\n        orderId: evt.orderId,\n        paymentId: evt.paymentId,\n        timestamp: Date.now(),\n        ...(evt.total !== undefined ? { total: evt.total } : {}),\n        ...(evt.currency !== undefined ? { currency: evt.currency } : {}),\n      });\n      onSucceeded?.(evt);\n    },\n    [emit, sessionId, onSucceeded],\n  );\n\n  const handleFailed = useCallback(\n    ({ code, message }: { code: string; message: string }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({ type: 'failed', sessionId, code, message, timestamp: Date.now() });\n      onFailed?.({ code, message });\n    },\n    [emit, sessionId, onFailed],\n  );\n\n  const handleCanceled = useCallback(() => {\n    emit({ type: 'cancelled', sessionId, timestamp: Date.now() });\n    onCancelled?.();\n  }, [emit, sessionId, onCancelled]);\n\n  return (\n    <PaymentEmbed\n      sessionId={sessionId}\n      parentOrigin={parentOrigin}\n      {...(baseUrl !== undefined ? { baseUrl } : {})}\n      primary={theme?.primary}\n      logo={theme?.logo}\n      onReady={handleReady}\n      onProcessing={handleProcessing}\n      onSucceeded={handleSucceeded}\n      onFailed={handleFailed}\n      onCanceled={handleCanceled}\n    />\n  );\n}\n","export { ThrottleCheckout } from './ThrottleCheckout.js';\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\nexport type {\n  BrandTheme,\n  TelemetryEvent,\n  ThrottleCheckoutProps,\n  SucceededLineItem,\n} from './types.js';\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,cAAc;AAC/C,SAAS,oBAAoB;AA6FzB;AA9EG,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuC;AAGrC,QAAM,aAAa,OAAO,KAAK;AAE/B,QAAM,OAAO;AAAA,IACX,CAAC,UAA0B;AACzB,oBAAc,KAAK;AAAA,IACrB;AAAA,IACA,CAAC,WAAW;AAAA,EACd;AAGA,YAAU,MAAM;AACd,SAAK,EAAE,MAAM,WAAW,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAG5D,GAAG,CAAC,CAAC;AAEL,QAAM,cAAc,YAAY,MAAM;AACpC,SAAK,EAAE,MAAM,SAAS,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,mBAAmB,YAAY,MAAM;AACzC,SAAK,EAAE,MAAM,cAAc,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC/D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,kBAAkB;AAAA,IACtB,CAAC,QAQK;AACJ,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK;AAAA,QACH,MAAM;AAAA,QACN;AAAA,QACA,SAAS,IAAI;AAAA,QACb,WAAW,IAAI;AAAA,QACf,WAAW,KAAK,IAAI;AAAA,QACpB,GAAI,IAAI,UAAU,SAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;AAAA,QACtD,GAAI,IAAI,aAAa,SAAY,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,MACjE,CAAC;AACD,oBAAc,GAAG;AAAA,IACnB;AAAA,IACA,CAAC,MAAM,WAAW,WAAW;AAAA,EAC/B;AAEA,QAAM,eAAe;AAAA,IACnB,CAAC,EAAE,MAAM,QAAQ,MAAyC;AACxD,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK,EAAE,MAAM,UAAU,WAAW,MAAM,SAAS,WAAW,KAAK,IAAI,EAAE,CAAC;AACxE,iBAAW,EAAE,MAAM,QAAQ,CAAC;AAAA,IAC9B;AAAA,IACA,CAAC,MAAM,WAAW,QAAQ;AAAA,EAC5B;AAEA,QAAM,iBAAiB,YAAY,MAAM;AACvC,SAAK,EAAE,MAAM,aAAa,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAC5D,kBAAc;AAAA,EAChB,GAAG,CAAC,MAAM,WAAW,WAAW,CAAC;AAEjC,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACC,GAAI,YAAY,SAAY,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC5C,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO;AAAA,MACb,SAAS;AAAA,MACT,cAAc;AAAA,MACd,aAAa;AAAA,MACb,UAAU;AAAA,MACV,YAAY;AAAA;AAAA,EACd;AAEJ;;;AC1GA,SAAS,eAAe,uBAAuB;","names":[]}
+{"version":3,"sources":["../src/ThrottleCheckout.tsx","../src/index.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\nimport { PaymentEmbed } from '@usethrottle/checkout-react';\nimport type { ThrottleCheckoutProps, TelemetryEvent } from './types.js';\n\n/**\n * ThrottleCheckout — Phase 1 platform SDK wrapper.\n *\n * Wraps `<PaymentEmbed>` from `@usethrottle/checkout-react` and adds:\n *   1. Idempotency  — settledRef ensures `onSucceeded` / `onFailed` fire at most once\n *                     per component lifetime, even if the iframe sends duplicate events.\n *   2. Telemetry    — `onTelemetry` callback receives every lifecycle event with a\n *                     typed payload so workspaces can pipe to Datadog / Segment / etc.\n *   3. Brand theming — `theme.primary` + `theme.logo` are forwarded to the underlying\n *                     `<PaymentEmbed>` which appends them as URL query params on the\n *                     hosted checkout iframe src.\n */\nexport function ThrottleCheckout({\n  sessionId,\n  parentOrigin = '',\n  baseUrl,\n  theme,\n  onSucceeded,\n  onFailed,\n  onCancelled,\n  onTelemetry,\n}: ThrottleCheckoutProps): JSX.Element {\n  // Idempotency guard — once a terminal event (success or failure) fires,\n  // all subsequent duplicate events from the iframe are silently dropped.\n  const settledRef = useRef(false);\n\n  const emit = useCallback(\n    (event: TelemetryEvent) => {\n      onTelemetry?.(event);\n    },\n    [onTelemetry],\n  );\n\n  // Fire \"mounted\" telemetry once on initial render.\n  useEffect(() => {\n    emit({ type: 'mounted', sessionId, timestamp: Date.now() });\n    // intentionally only on mount — sessionId identity change re-mounts anyway\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  const handleReady = useCallback(() => {\n    emit({ type: 'ready', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleProcessing = useCallback(() => {\n    emit({ type: 'processing', sessionId, timestamp: Date.now() });\n  }, [emit, sessionId]);\n\n  const handleSucceeded = useCallback(\n    (evt: {\n      orderId: string;\n      paymentId: string;\n      subscriptionId?: string;\n      subscriptionIds?: string[];\n      total?: number;\n      currency?: string;\n      lineItems?: import('./types.js').SucceededLineItem[];\n    }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({\n        type: 'succeeded',\n        sessionId,\n        orderId: evt.orderId,\n        paymentId: evt.paymentId,\n        timestamp: Date.now(),\n        ...(evt.total !== undefined ? { total: evt.total } : {}),\n        ...(evt.currency !== undefined ? { currency: evt.currency } : {}),\n      });\n      onSucceeded?.(evt);\n    },\n    [emit, sessionId, onSucceeded],\n  );\n\n  const handleFailed = useCallback(\n    ({ code, message }: { code: string; message: string }) => {\n      if (settledRef.current) return;\n      settledRef.current = true;\n      emit({ type: 'failed', sessionId, code, message, timestamp: Date.now() });\n      onFailed?.({ code, message });\n    },\n    [emit, sessionId, onFailed],\n  );\n\n  const handleCanceled = useCallback(() => {\n    emit({ type: 'cancelled', sessionId, timestamp: Date.now() });\n    onCancelled?.();\n  }, [emit, sessionId, onCancelled]);\n\n  return (\n    <PaymentEmbed\n      sessionId={sessionId}\n      parentOrigin={parentOrigin}\n      {...(baseUrl !== undefined ? { baseUrl } : {})}\n      primary={theme?.primary}\n      logo={theme?.logo}\n      onReady={handleReady}\n      onProcessing={handleProcessing}\n      onSucceeded={handleSucceeded}\n      onFailed={handleFailed}\n      onCanceled={handleCanceled}\n    />\n  );\n}\n","export { ThrottleCheckout } from './ThrottleCheckout.js';\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\nexport type {\n  BrandTheme,\n  TelemetryEvent,\n  ThrottleCheckoutProps,\n  SucceededLineItem,\n} from './types.js';\n// Money helpers (MC2-R34): amounts are integer minor units of their `currency`.\nexport * as money from '@usethrottle/money';\nexport {\n  formatMoney,\n  currencySymbol,\n  minorUnitsOf,\n  toDecimalString,\n  toMinor,\n  parseMoney,\n  moneyValue,\n  CURRENCIES,\n  isKnownCurrency,\n  UnknownCurrencyError,\n} from '@usethrottle/money';\nexport type { CurrencyCode, MoneyValue } from '@usethrottle/money';\n"],"mappings":";AAAA,SAAS,aAAa,WAAW,cAAc;AAC/C,SAAS,oBAAoB;AA6FzB;AA9EG,SAAS,iBAAiB;AAAA,EAC/B;AAAA,EACA,eAAe;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuC;AAGrC,QAAM,aAAa,OAAO,KAAK;AAE/B,QAAM,OAAO;AAAA,IACX,CAAC,UAA0B;AACzB,oBAAc,KAAK;AAAA,IACrB;AAAA,IACA,CAAC,WAAW;AAAA,EACd;AAGA,YAAU,MAAM;AACd,SAAK,EAAE,MAAM,WAAW,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAG5D,GAAG,CAAC,CAAC;AAEL,QAAM,cAAc,YAAY,MAAM;AACpC,SAAK,EAAE,MAAM,SAAS,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC1D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,mBAAmB,YAAY,MAAM;AACzC,SAAK,EAAE,MAAM,cAAc,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAAA,EAC/D,GAAG,CAAC,MAAM,SAAS,CAAC;AAEpB,QAAM,kBAAkB;AAAA,IACtB,CAAC,QAQK;AACJ,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK;AAAA,QACH,MAAM;AAAA,QACN;AAAA,QACA,SAAS,IAAI;AAAA,QACb,WAAW,IAAI;AAAA,QACf,WAAW,KAAK,IAAI;AAAA,QACpB,GAAI,IAAI,UAAU,SAAY,EAAE,OAAO,IAAI,MAAM,IAAI,CAAC;AAAA,QACtD,GAAI,IAAI,aAAa,SAAY,EAAE,UAAU,IAAI,SAAS,IAAI,CAAC;AAAA,MACjE,CAAC;AACD,oBAAc,GAAG;AAAA,IACnB;AAAA,IACA,CAAC,MAAM,WAAW,WAAW;AAAA,EAC/B;AAEA,QAAM,eAAe;AAAA,IACnB,CAAC,EAAE,MAAM,QAAQ,MAAyC;AACxD,UAAI,WAAW,QAAS;AACxB,iBAAW,UAAU;AACrB,WAAK,EAAE,MAAM,UAAU,WAAW,MAAM,SAAS,WAAW,KAAK,IAAI,EAAE,CAAC;AACxE,iBAAW,EAAE,MAAM,QAAQ,CAAC;AAAA,IAC9B;AAAA,IACA,CAAC,MAAM,WAAW,QAAQ;AAAA,EAC5B;AAEA,QAAM,iBAAiB,YAAY,MAAM;AACvC,SAAK,EAAE,MAAM,aAAa,WAAW,WAAW,KAAK,IAAI,EAAE,CAAC;AAC5D,kBAAc;AAAA,EAChB,GAAG,CAAC,MAAM,WAAW,WAAW,CAAC;AAEjC,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACC,GAAI,YAAY,SAAY,EAAE,QAAQ,IAAI,CAAC;AAAA,MAC5C,SAAS,OAAO;AAAA,MAChB,MAAM,OAAO;AAAA,MACb,SAAS;AAAA,MACT,cAAc;AAAA,MACd,aAAa;AAAA,MACb,UAAU;AAAA,MACV,YAAY;AAAA;AAAA,EACd;AAEJ;;;AC1GA,SAAS,eAAe,uBAAuB;AAQ/C,YAAY,WAAW;AACvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/server.cjs

@@ -253,7 +253,7 @@ function normalizeEmbedToken(raw) {
     embedToken: requiredString(raw?.embedToken, "embedToken.embedToken"),
     checkoutSessionId: requiredString(raw?.checkoutSessionId, "embedToken.checkoutSessionId"),
     amount: Number(raw?.amount ?? 0),
-    currency: optionalString(raw?.currency) ?? "USD",
+    currency: requiredString(raw?.currency, "embedToken.currency"),
     hostedUrl: optionalString(raw?.hostedUrl) ?? void 0,
     embedUrl: optionalString(raw?.embedUrl) ?? void 0,
     processorInstanceId: optionalString(raw?.processorInstanceId) ?? void 0,
@@ -267,7 +267,7 @@ function normalizeOrder(raw) {
     orderNumber: optionalString(raw?.orderNumber) ?? void 0,
     status: optionalString(raw?.status) ?? "processing",
     paymentStatus: optionalString(raw?.paymentStatus),
-    currency: optionalString(raw?.currency) ?? "USD",
+    currency: requiredString(raw?.currency, "order.currency"),
     subtotal: Number(raw?.subtotal ?? 0),
     taxTotal: Number(raw?.taxTotal ?? 0),
     shippingTotal: Number(raw?.shippingTotal ?? 0),

package/dist/server.cjs.map

@@ -1 +1 @@
-{"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  /** Set only when the checkout created exactly one subscription. */\n  subscriptionId?: string | null;\n  /** Every subscription the checkout created, in line order. [] when none. */\n  subscriptionIds?: 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    subscriptionId: raw?.subscriptionId === null ? null : (optionalString(raw?.subscriptionId) ?? undefined),\n    subscriptionIds: Array.isArray(raw?.subscriptionIds)\n      ? raw.subscriptionIds.filter((id: unknown): id is string => typeof id === 'string')\n      : 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';\nimport type { CurrencyCode } from '@usethrottle/money';\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  /** Set only when the checkout created exactly one subscription. */\n  subscriptionId?: string | null;\n  /** Every subscription the checkout created, in line order. [] when none. */\n  subscriptionIds?: string[];\n  total?: number;\n  currency?: CurrencyCode;\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: CurrencyCode;\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: CurrencyCode;\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    subscriptionId: raw?.subscriptionId === null ? null : (optionalString(raw?.subscriptionId) ?? undefined),\n    subscriptionIds: Array.isArray(raw?.subscriptionIds)\n      ? raw.subscriptionIds.filter((id: unknown): id is string => typeof id === 'string')\n      : 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: requiredString(raw?.currency, 'embedToken.currency'),\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: requiredString(raw?.currency, 'order.currency'),\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,5 +1,6 @@
 import { ThrottleError, ThrottleErrorArgs } from '@usethrottle/errors';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
+import { CurrencyCode } from '@usethrottle/money';
 
 /**
  * `'embedded'` completes a card payment taken by the payment embed; `'net30'`
@@ -145,7 +146,7 @@ interface CompleteCheckoutSessionResult {
     /** Every subscription the checkout created, in line order. [] when none. */
     subscriptionIds?: string[];
     total?: number;
-    currency?: string;
+    currency?: CurrencyCode;
     status?: string;
     paymentStatus?: string;
     [key: string]: unknown;
@@ -181,7 +182,7 @@ interface CreateEmbedTokenResult {
     embedToken: string;
     checkoutSessionId: string;
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
     hostedUrl?: string;
     embedUrl?: string;
     processorInstanceId?: string;
@@ -193,7 +194,7 @@ interface CheckoutOrder {
     orderNumber?: string;
     status: string;
     paymentStatus: string | null;
-    currency: string;
+    currency: CurrencyCode;
     subtotal: number;
     taxTotal: number;
     shippingTotal: number;

package/dist/server.d.ts

@@ -1,5 +1,6 @@
 import { ThrottleError, ThrottleErrorArgs } from '@usethrottle/errors';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
+import { CurrencyCode } from '@usethrottle/money';
 
 /**
  * `'embedded'` completes a card payment taken by the payment embed; `'net30'`
@@ -145,7 +146,7 @@ interface CompleteCheckoutSessionResult {
     /** Every subscription the checkout created, in line order. [] when none. */
     subscriptionIds?: string[];
     total?: number;
-    currency?: string;
+    currency?: CurrencyCode;
     status?: string;
     paymentStatus?: string;
     [key: string]: unknown;
@@ -181,7 +182,7 @@ interface CreateEmbedTokenResult {
     embedToken: string;
     checkoutSessionId: string;
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
     hostedUrl?: string;
     embedUrl?: string;
     processorInstanceId?: string;
@@ -193,7 +194,7 @@ interface CheckoutOrder {
     orderNumber?: string;
     status: string;
     paymentStatus: string | null;
-    currency: string;
+    currency: CurrencyCode;
     subtotal: number;
     taxTotal: number;
     shippingTotal: number;

package/dist/server.js

@@ -222,7 +222,7 @@ function normalizeEmbedToken(raw) {
     embedToken: requiredString(raw?.embedToken, "embedToken.embedToken"),
     checkoutSessionId: requiredString(raw?.checkoutSessionId, "embedToken.checkoutSessionId"),
     amount: Number(raw?.amount ?? 0),
-    currency: optionalString(raw?.currency) ?? "USD",
+    currency: requiredString(raw?.currency, "embedToken.currency"),
     hostedUrl: optionalString(raw?.hostedUrl) ?? void 0,
     embedUrl: optionalString(raw?.embedUrl) ?? void 0,
     processorInstanceId: optionalString(raw?.processorInstanceId) ?? void 0,
@@ -236,7 +236,7 @@ function normalizeOrder(raw) {
     orderNumber: optionalString(raw?.orderNumber) ?? void 0,
     status: optionalString(raw?.status) ?? "processing",
     paymentStatus: optionalString(raw?.paymentStatus),
-    currency: optionalString(raw?.currency) ?? "USD",
+    currency: requiredString(raw?.currency, "order.currency"),
     subtotal: Number(raw?.subtotal ?? 0),
     taxTotal: Number(raw?.taxTotal ?? 0),
     shippingTotal: Number(raw?.shippingTotal ?? 0),

package/dist/server.js.map

@@ -1 +1 @@
-{"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  /** Set only when the checkout created exactly one subscription. */\n  subscriptionId?: string | null;\n  /** Every subscription the checkout created, in line order. [] when none. */\n  subscriptionIds?: 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    subscriptionId: raw?.subscriptionId === null ? null : (optionalString(raw?.subscriptionId) ?? undefined),\n    subscriptionIds: Array.isArray(raw?.subscriptionIds)\n      ? raw.subscriptionIds.filter((id: unknown): id is string => typeof id === 'string')\n      : 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';\nimport type { CurrencyCode } from '@usethrottle/money';\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  /** Set only when the checkout created exactly one subscription. */\n  subscriptionId?: string | null;\n  /** Every subscription the checkout created, in line order. [] when none. */\n  subscriptionIds?: string[];\n  total?: number;\n  currency?: CurrencyCode;\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: CurrencyCode;\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: CurrencyCode;\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    subscriptionId: raw?.subscriptionId === null ? null : (optionalString(raw?.subscriptionId) ?? undefined),\n    subscriptionIds: Array.isArray(raw?.subscriptionIds)\n      ? raw.subscriptionIds.filter((id: unknown): id is string => typeof id === 'string')\n      : 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: requiredString(raw?.currency, 'embedToken.currency'),\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: requiredString(raw?.currency, 'order.currency'),\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.1.0",
+  "version": "2.2.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -27,8 +27,9 @@
     "react-dom": ">=18 <20"
   },
   "dependencies": {
-    "@usethrottle/checkout-react": "2.1.0",
-    "@usethrottle/errors": "^1.1.0"
+    "@usethrottle/checkout-react": "2.2.0",
+    "@usethrottle/errors": "^1.1.0",
+    "@usethrottle/money": "^1.0.0"
   },
   "devDependencies": {
     "@testing-library/react": "^16.0.0",