@usethrottle/cart 3.15.0 → 3.17.0

package/README.md

@@ -460,6 +460,15 @@ resolvable base returns `400 image_url_unresolvable`.
 | `timeoutMs` | `30000`                       | Per-request abort timeout in ms.                                                                                          |
 | `fetch`     | `globalThis.fetch`            | Custom fetch implementation (e.g. `node-fetch`).                                                                          |
 
+## Money
+
+Amounts are integers in the record's minor unit. Show them with
+`formatMoney(amount, cart.currency)`: this package re-exports
+`@usethrottle/money` as `money` and `formatMoney` by name, plus the
+`CurrencyCode` and `MoneyValue` types. `CartSessionClient.absorb(...)` is not
+provided; switch currency with `POST /api/v1/cart-sessions/:id/absorb` (see the
+cart-sessions docs).
+
 ## See also
 
 - [Checkout SDK: `@usethrottle/checkout-sdk`](https://www.npmjs.com/package/@usethrottle/checkout-sdk)

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,12 +17,21 @@ 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, {
   AmountTooLargeError: () => AmountTooLargeError,
+  CURRENCIES: () => import_money.CURRENCIES,
   CartChangedError: () => CartChangedError,
   CartClient: () => CartClient,
   CartNotFoundError: () => CartNotFoundError,
@@ -28,7 +39,10 @@ __export(index_exports, {
   CartPricesChangedError: () => CartPricesChangedError,
   CartSessionClient: () => CartSessionClient,
   CartTimeoutError: () => CartTimeoutError,
+  CurrencyLockedError: () => CurrencyLockedError,
+  CurrencyNotAvailableInProductionError: () => CurrencyNotAvailableInProductionError,
   CurrencyNotEnabledError: () => CurrencyNotEnabledError,
+  CurrencyNotSupportedError: () => CurrencyNotSupportedError,
   DiscountCurrencyUnsupportedError: () => DiscountCurrencyUnsupportedError,
   LineLimitReachedError: () => LineLimitReachedError,
   LineNotPurchasableError: () => LineNotPurchasableError,
@@ -36,6 +50,7 @@ __export(index_exports, {
   LineResolverUnavailableError: () => LineResolverUnavailableError,
   PriceLockedError: () => PriceLockedError,
   QuantityUnavailableError: () => QuantityUnavailableError,
+  QuoteAmountsNeedReviewError: () => QuoteAmountsNeedReviewError,
   ResolvedLinesRequiredError: () => ResolvedLinesRequiredError,
   ShippingCurrencyUnsupportedError: () => ShippingCurrencyUnsupportedError,
   ShippingMethodUnavailableError: () => ShippingMethodUnavailableError,
@@ -43,8 +58,18 @@ __export(index_exports, {
   StorefrontQuoteClient: () => StorefrontQuoteClient,
   ThrottleApiError: () => ThrottleApiError,
   ThrottleError: () => import_errors2.ThrottleError,
+  UnknownCurrencyError: () => import_money.UnknownCurrencyError,
   cartErrorFromResponse: () => cartErrorFromResponse,
-  isThrottleError: () => import_errors2.isThrottleError
+  currencySymbol: () => import_money.currencySymbol,
+  formatMoney: () => import_money.formatMoney,
+  isKnownCurrency: () => import_money.isKnownCurrency,
+  isThrottleError: () => import_errors2.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);
 
@@ -216,6 +241,30 @@ var ShippingCurrencyUnsupportedError = class extends ThrottleApiError {
     this.shipping = d?.shipping && typeof d.shipping === "object" ? d.shipping : null;
   }
 };
+var CurrencyNotSupportedError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("currency_not_supported", 422, args));
+    this.name = "CurrencyNotSupportedError";
+  }
+};
+var CurrencyNotAvailableInProductionError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("currency_not_available_in_production", 422, args));
+    this.name = "CurrencyNotAvailableInProductionError";
+  }
+};
+var CurrencyLockedError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("currency_locked", 409, args));
+    this.name = "CurrencyLockedError";
+  }
+};
+var QuoteAmountsNeedReviewError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("quote_amounts_need_review", 422, args));
+    this.name = "QuoteAmountsNeedReviewError";
+  }
+};
 var RESOLVED_CART_ERRORS = {
   price_locked: PriceLockedError,
   quantity_unavailable: QuantityUnavailableError,
@@ -231,7 +280,11 @@ var RESOLVED_CART_ERRORS = {
   amount_too_large: AmountTooLargeError,
   cart_changed: CartChangedError,
   discount_currency_unsupported: DiscountCurrencyUnsupportedError,
-  shipping_currency_unsupported: ShippingCurrencyUnsupportedError
+  shipping_currency_unsupported: ShippingCurrencyUnsupportedError,
+  currency_not_supported: CurrencyNotSupportedError,
+  currency_not_available_in_production: CurrencyNotAvailableInProductionError,
+  currency_locked: CurrencyLockedError,
+  quote_amounts_need_review: QuoteAmountsNeedReviewError
 };
 function cartErrorFromResponse(args) {
   if (args.statusCode === 409 && args.code === "cart_not_open") {
@@ -635,9 +688,14 @@ var CartSessionClient = class _CartSessionClient {
     }
   }
 };
+
+// src/index.ts
+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 = {
   AmountTooLargeError,
+  CURRENCIES,
   CartChangedError,
   CartClient,
   CartNotFoundError,
@@ -645,7 +703,10 @@ var CartSessionClient = class _CartSessionClient {
   CartPricesChangedError,
   CartSessionClient,
   CartTimeoutError,
+  CurrencyLockedError,
+  CurrencyNotAvailableInProductionError,
   CurrencyNotEnabledError,
+  CurrencyNotSupportedError,
   DiscountCurrencyUnsupportedError,
   LineLimitReachedError,
   LineNotPurchasableError,
@@ -653,6 +714,7 @@ var CartSessionClient = class _CartSessionClient {
   LineResolverUnavailableError,
   PriceLockedError,
   QuantityUnavailableError,
+  QuoteAmountsNeedReviewError,
   ResolvedLinesRequiredError,
   ShippingCurrencyUnsupportedError,
   ShippingMethodUnavailableError,
@@ -660,6 +722,16 @@ var CartSessionClient = class _CartSessionClient {
   StorefrontQuoteClient,
   ThrottleApiError,
   ThrottleError,
+  UnknownCurrencyError,
   cartErrorFromResponse,
-  isThrottleError
+  currencySymbol,
+  formatMoney,
+  isKnownCurrency,
+  isThrottleError,
+  minorUnitsOf,
+  money,
+  moneyValue,
+  parseMoney,
+  toDecimalString,
+  toMinor
 });

package/dist/index.d.cts

@@ -1,3 +1,7 @@
+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';
 import { ThrottleError, ThrottleErrorArgs } from '@usethrottle/errors';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
 
@@ -37,7 +41,7 @@ interface Cart {
     /** Lightweight captured email (no full customer record), or null. */
     customerEmail: string | null;
     status: 'open' | 'checkout' | 'converted' | 'abandoned';
-    currency: string;
+    currency: CurrencyCode;
     subtotal: number;
     taxTotal: number;
     discountTotal: number;
@@ -229,7 +233,7 @@ interface SelectedShipping {
     serviceCode: string | null;
     displayName: string;
     rateAmount: number;
-    currency: string;
+    currency: CurrencyCode;
     estimatedDeliveryDays: number | null;
 }
 interface AppliedDiscount {
@@ -237,7 +241,7 @@ interface AppliedDiscount {
     code: string;
     type: 'percentage' | 'fixed_amount';
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
     freeShipping: boolean;
     validUntil: string | null;
     snapshotHash: string;
@@ -256,7 +260,7 @@ interface TaxLine {
     rateTypeCode?: string | null;
     rate: number;
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
 }
 interface CartEvent {
     id: string;
@@ -297,7 +301,8 @@ interface CreateCartInput {
     }>;
 }
 interface UpdateCartInput {
-    customerId?: string;
+    /** Send `null` to detach the customer; omit to keep it. Detaching does not clear `customerEmail`. */
+    customerId?: string | null;
     /** Lightweight email capture; `null` clears a previously-set value. */
     customerEmail?: string | null;
     billingAddress?: CartAddress;
@@ -382,7 +387,7 @@ interface Order {
     id: string;
     status: string;
     total: number;
-    currency: string;
+    currency: CurrencyCode;
 }
 interface ShippingTaxAddress {
     countryCode?: string;
@@ -437,7 +442,7 @@ interface ShippingTaxMethod {
     type?: 'ship' | 'pickup';
     label: string;
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
     deliveryWindowLabel?: string | null;
     deliveryMinDays?: number | null;
     deliveryMaxDays?: number | null;
@@ -454,7 +459,7 @@ interface ShippingTaxCalculationResponse {
     source: 'off' | 'byo' | 'calculated' | 'app_based' | 'external_push';
     applicationId: string;
     workspaceId?: string;
-    currency: string;
+    currency: CurrencyCode;
     configId?: string;
     configVersion?: number;
     shippingRequired: boolean;
@@ -714,7 +719,7 @@ interface CartSessionSummary {
     /** Cart total in minor units, or `0` on a finished session. */
     total: number;
     /** `null` on a finished session — there is no live cart to price. */
-    currency: string | null;
+    currency: CurrencyCode | null;
 }
 interface CheckoutHandoffInput {
     returnUrl: string;
@@ -980,8 +985,8 @@ declare class LineResolverNotAvailableError extends ThrottleApiError {
 }
 /** `details` of `422 currency_not_enabled`. */
 type CurrencyNotEnabledDetails = {
-    currency: string;
-    enabledCurrencies: string[];
+    currency: CurrencyCode;
+    enabledCurrencies: CurrencyCode[];
 };
 /**
  * `422 currency_not_enabled`: a resolved cart must use the environment's
@@ -1077,6 +1082,31 @@ declare class ShippingCurrencyUnsupportedError extends ThrottleApiError {
     readonly shipping: CartShippingChange | null;
     constructor(args: CartErrorArgs);
 }
+/**
+ * `422 currency_not_supported`: the code is not a supported ISO 4217 currency.
+ * `details` is `{ currency, enabledCurrencies }`.
+ */
+declare class CurrencyNotSupportedError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
+/**
+ * `422 currency_not_available_in_production`: the production environment does
+ * not accept this currency yet. `details` is `{ currency, enabledCurrencies }`.
+ */
+declare class CurrencyNotAvailableInProductionError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
+/** `409 currency_locked`: the main currency can't change after the first production sale. */
+declare class CurrencyLockedError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
+/**
+ * `422 quote_amounts_need_review`: amounts typed before the quote's currency
+ * changed must be confirmed before it is issued. `details.pending` lists them.
+ */
+declare class QuoteAmountsNeedReviewError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
 /**
  * Map a raw API error envelope to the most specific Cart SDK error class.
  * Falls back to {@link ThrottleApiError} for everything unrecognised.
@@ -1089,4 +1119,4 @@ declare function cartErrorFromResponse(args: {
     responseHeaders?: ThrottleErrorArgs['responseHeaders'];
 }): ThrottleApiError;
 
-export { type AddLineItemInput, type AddResolvedLineItemInput, AmountTooLargeError, type AppliedDiscount, type Cart, type CartAddress, type CartBranding, CartChangedError, CartClient, type CartErrorArgs, type CartEvent, CartNotFoundError, CartNotOpenError, type CartPricesChangedDetails, CartPricesChangedError, type CartSession, type CartSessionCart, CartSessionClient, type CartSessionClientOptions, type CartSessionSummary, type CartShippingChange, CartTimeoutError, type CheckoutHandoff, type CheckoutHandoffInput, type CheckoutInput, type CreateCartInput, type CreateCartSessionInput, type CurrencyNotEnabledDetails, CurrencyNotEnabledError, DiscountCurrencyUnsupportedError, type ExternalShippingTaxSnapshotInput, type LegacyLineRecurring, type LineItem, type LineLimitReachedDetails, LineLimitReachedError, type LineNotPurchasableDetails, LineNotPurchasableError, type LineRecurringInput, type LineResolution, type LineResolverNotAvailableDetails, LineResolverNotAvailableError, type LineResolverUnavailableDetails, LineResolverUnavailableError, type Order, type PriceLockedDetails, PriceLockedError, type QuantityUnavailableDetails, QuantityUnavailableError, type RefusedCartLine, ResolvedLinesRequiredError, type SelectShippingInput, type SelectShippingMethodInput, type SelectedShipping, ShippingCurrencyUnsupportedError, ShippingMethodUnavailableError, ShippingQuoteUnavailableError, type ShippingTaxAddress, type ShippingTaxCalculationResponse, type ShippingTaxCartCalculateInput, type ShippingTaxMethod, type ShippingTaxQuoteInput, type ShippingTaxQuoteItem, type StoredLineRecurring, StorefrontQuoteClient, type SubscriptionInterval, type SubscriptionIntervalUnit, type TaxLine, type TaxLineInput, ThrottleApiError, type UpdateCartInput, type UpdateCartSessionInput, type UpdateLineItemInput, cartErrorFromResponse };
+export { type AddLineItemInput, type AddResolvedLineItemInput, AmountTooLargeError, type AppliedDiscount, type Cart, type CartAddress, type CartBranding, CartChangedError, CartClient, type CartErrorArgs, type CartEvent, CartNotFoundError, CartNotOpenError, type CartPricesChangedDetails, CartPricesChangedError, type CartSession, type CartSessionCart, CartSessionClient, type CartSessionClientOptions, type CartSessionSummary, type CartShippingChange, CartTimeoutError, type CheckoutHandoff, type CheckoutHandoffInput, type CheckoutInput, type CreateCartInput, type CreateCartSessionInput, CurrencyLockedError, CurrencyNotAvailableInProductionError, type CurrencyNotEnabledDetails, CurrencyNotEnabledError, CurrencyNotSupportedError, DiscountCurrencyUnsupportedError, type ExternalShippingTaxSnapshotInput, type LegacyLineRecurring, type LineItem, type LineLimitReachedDetails, LineLimitReachedError, type LineNotPurchasableDetails, LineNotPurchasableError, type LineRecurringInput, type LineResolution, type LineResolverNotAvailableDetails, LineResolverNotAvailableError, type LineResolverUnavailableDetails, LineResolverUnavailableError, type Order, type PriceLockedDetails, PriceLockedError, type QuantityUnavailableDetails, QuantityUnavailableError, QuoteAmountsNeedReviewError, type RefusedCartLine, ResolvedLinesRequiredError, type SelectShippingInput, type SelectShippingMethodInput, type SelectedShipping, ShippingCurrencyUnsupportedError, ShippingMethodUnavailableError, ShippingQuoteUnavailableError, type ShippingTaxAddress, type ShippingTaxCalculationResponse, type ShippingTaxCartCalculateInput, type ShippingTaxMethod, type ShippingTaxQuoteInput, type ShippingTaxQuoteItem, type StoredLineRecurring, StorefrontQuoteClient, type SubscriptionInterval, type SubscriptionIntervalUnit, type TaxLine, type TaxLineInput, ThrottleApiError, type UpdateCartInput, type UpdateCartSessionInput, type UpdateLineItemInput, cartErrorFromResponse };

package/dist/index.d.ts

@@ -1,3 +1,7 @@
+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';
 import { ThrottleError, ThrottleErrorArgs } from '@usethrottle/errors';
 export { ThrottleError, isThrottleError } from '@usethrottle/errors';
 
@@ -37,7 +41,7 @@ interface Cart {
     /** Lightweight captured email (no full customer record), or null. */
     customerEmail: string | null;
     status: 'open' | 'checkout' | 'converted' | 'abandoned';
-    currency: string;
+    currency: CurrencyCode;
     subtotal: number;
     taxTotal: number;
     discountTotal: number;
@@ -229,7 +233,7 @@ interface SelectedShipping {
     serviceCode: string | null;
     displayName: string;
     rateAmount: number;
-    currency: string;
+    currency: CurrencyCode;
     estimatedDeliveryDays: number | null;
 }
 interface AppliedDiscount {
@@ -237,7 +241,7 @@ interface AppliedDiscount {
     code: string;
     type: 'percentage' | 'fixed_amount';
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
     freeShipping: boolean;
     validUntil: string | null;
     snapshotHash: string;
@@ -256,7 +260,7 @@ interface TaxLine {
     rateTypeCode?: string | null;
     rate: number;
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
 }
 interface CartEvent {
     id: string;
@@ -297,7 +301,8 @@ interface CreateCartInput {
     }>;
 }
 interface UpdateCartInput {
-    customerId?: string;
+    /** Send `null` to detach the customer; omit to keep it. Detaching does not clear `customerEmail`. */
+    customerId?: string | null;
     /** Lightweight email capture; `null` clears a previously-set value. */
     customerEmail?: string | null;
     billingAddress?: CartAddress;
@@ -382,7 +387,7 @@ interface Order {
     id: string;
     status: string;
     total: number;
-    currency: string;
+    currency: CurrencyCode;
 }
 interface ShippingTaxAddress {
     countryCode?: string;
@@ -437,7 +442,7 @@ interface ShippingTaxMethod {
     type?: 'ship' | 'pickup';
     label: string;
     amount: number;
-    currency: string;
+    currency: CurrencyCode;
     deliveryWindowLabel?: string | null;
     deliveryMinDays?: number | null;
     deliveryMaxDays?: number | null;
@@ -454,7 +459,7 @@ interface ShippingTaxCalculationResponse {
     source: 'off' | 'byo' | 'calculated' | 'app_based' | 'external_push';
     applicationId: string;
     workspaceId?: string;
-    currency: string;
+    currency: CurrencyCode;
     configId?: string;
     configVersion?: number;
     shippingRequired: boolean;
@@ -714,7 +719,7 @@ interface CartSessionSummary {
     /** Cart total in minor units, or `0` on a finished session. */
     total: number;
     /** `null` on a finished session — there is no live cart to price. */
-    currency: string | null;
+    currency: CurrencyCode | null;
 }
 interface CheckoutHandoffInput {
     returnUrl: string;
@@ -980,8 +985,8 @@ declare class LineResolverNotAvailableError extends ThrottleApiError {
 }
 /** `details` of `422 currency_not_enabled`. */
 type CurrencyNotEnabledDetails = {
-    currency: string;
-    enabledCurrencies: string[];
+    currency: CurrencyCode;
+    enabledCurrencies: CurrencyCode[];
 };
 /**
  * `422 currency_not_enabled`: a resolved cart must use the environment's
@@ -1077,6 +1082,31 @@ declare class ShippingCurrencyUnsupportedError extends ThrottleApiError {
     readonly shipping: CartShippingChange | null;
     constructor(args: CartErrorArgs);
 }
+/**
+ * `422 currency_not_supported`: the code is not a supported ISO 4217 currency.
+ * `details` is `{ currency, enabledCurrencies }`.
+ */
+declare class CurrencyNotSupportedError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
+/**
+ * `422 currency_not_available_in_production`: the production environment does
+ * not accept this currency yet. `details` is `{ currency, enabledCurrencies }`.
+ */
+declare class CurrencyNotAvailableInProductionError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
+/** `409 currency_locked`: the main currency can't change after the first production sale. */
+declare class CurrencyLockedError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
+/**
+ * `422 quote_amounts_need_review`: amounts typed before the quote's currency
+ * changed must be confirmed before it is issued. `details.pending` lists them.
+ */
+declare class QuoteAmountsNeedReviewError extends ThrottleApiError {
+    constructor(args: CartErrorArgs);
+}
 /**
  * Map a raw API error envelope to the most specific Cart SDK error class.
  * Falls back to {@link ThrottleApiError} for everything unrecognised.
@@ -1089,4 +1119,4 @@ declare function cartErrorFromResponse(args: {
     responseHeaders?: ThrottleErrorArgs['responseHeaders'];
 }): ThrottleApiError;
 
-export { type AddLineItemInput, type AddResolvedLineItemInput, AmountTooLargeError, type AppliedDiscount, type Cart, type CartAddress, type CartBranding, CartChangedError, CartClient, type CartErrorArgs, type CartEvent, CartNotFoundError, CartNotOpenError, type CartPricesChangedDetails, CartPricesChangedError, type CartSession, type CartSessionCart, CartSessionClient, type CartSessionClientOptions, type CartSessionSummary, type CartShippingChange, CartTimeoutError, type CheckoutHandoff, type CheckoutHandoffInput, type CheckoutInput, type CreateCartInput, type CreateCartSessionInput, type CurrencyNotEnabledDetails, CurrencyNotEnabledError, DiscountCurrencyUnsupportedError, type ExternalShippingTaxSnapshotInput, type LegacyLineRecurring, type LineItem, type LineLimitReachedDetails, LineLimitReachedError, type LineNotPurchasableDetails, LineNotPurchasableError, type LineRecurringInput, type LineResolution, type LineResolverNotAvailableDetails, LineResolverNotAvailableError, type LineResolverUnavailableDetails, LineResolverUnavailableError, type Order, type PriceLockedDetails, PriceLockedError, type QuantityUnavailableDetails, QuantityUnavailableError, type RefusedCartLine, ResolvedLinesRequiredError, type SelectShippingInput, type SelectShippingMethodInput, type SelectedShipping, ShippingCurrencyUnsupportedError, ShippingMethodUnavailableError, ShippingQuoteUnavailableError, type ShippingTaxAddress, type ShippingTaxCalculationResponse, type ShippingTaxCartCalculateInput, type ShippingTaxMethod, type ShippingTaxQuoteInput, type ShippingTaxQuoteItem, type StoredLineRecurring, StorefrontQuoteClient, type SubscriptionInterval, type SubscriptionIntervalUnit, type TaxLine, type TaxLineInput, ThrottleApiError, type UpdateCartInput, type UpdateCartSessionInput, type UpdateLineItemInput, cartErrorFromResponse };
+export { type AddLineItemInput, type AddResolvedLineItemInput, AmountTooLargeError, type AppliedDiscount, type Cart, type CartAddress, type CartBranding, CartChangedError, CartClient, type CartErrorArgs, type CartEvent, CartNotFoundError, CartNotOpenError, type CartPricesChangedDetails, CartPricesChangedError, type CartSession, type CartSessionCart, CartSessionClient, type CartSessionClientOptions, type CartSessionSummary, type CartShippingChange, CartTimeoutError, type CheckoutHandoff, type CheckoutHandoffInput, type CheckoutInput, type CreateCartInput, type CreateCartSessionInput, CurrencyLockedError, CurrencyNotAvailableInProductionError, type CurrencyNotEnabledDetails, CurrencyNotEnabledError, CurrencyNotSupportedError, DiscountCurrencyUnsupportedError, type ExternalShippingTaxSnapshotInput, type LegacyLineRecurring, type LineItem, type LineLimitReachedDetails, LineLimitReachedError, type LineNotPurchasableDetails, LineNotPurchasableError, type LineRecurringInput, type LineResolution, type LineResolverNotAvailableDetails, LineResolverNotAvailableError, type LineResolverUnavailableDetails, LineResolverUnavailableError, type Order, type PriceLockedDetails, PriceLockedError, type QuantityUnavailableDetails, QuantityUnavailableError, QuoteAmountsNeedReviewError, type RefusedCartLine, ResolvedLinesRequiredError, type SelectShippingInput, type SelectShippingMethodInput, type SelectedShipping, ShippingCurrencyUnsupportedError, ShippingMethodUnavailableError, ShippingQuoteUnavailableError, type ShippingTaxAddress, type ShippingTaxCalculationResponse, type ShippingTaxCartCalculateInput, type ShippingTaxMethod, type ShippingTaxQuoteInput, type ShippingTaxQuoteItem, type StoredLineRecurring, StorefrontQuoteClient, type SubscriptionInterval, type SubscriptionIntervalUnit, type TaxLine, type TaxLineInput, ThrottleApiError, type UpdateCartInput, type UpdateCartSessionInput, type UpdateLineItemInput, cartErrorFromResponse };

package/dist/index.js

@@ -166,6 +166,30 @@ var ShippingCurrencyUnsupportedError = class extends ThrottleApiError {
     this.shipping = d?.shipping && typeof d.shipping === "object" ? d.shipping : null;
   }
 };
+var CurrencyNotSupportedError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("currency_not_supported", 422, args));
+    this.name = "CurrencyNotSupportedError";
+  }
+};
+var CurrencyNotAvailableInProductionError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("currency_not_available_in_production", 422, args));
+    this.name = "CurrencyNotAvailableInProductionError";
+  }
+};
+var CurrencyLockedError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("currency_locked", 409, args));
+    this.name = "CurrencyLockedError";
+  }
+};
+var QuoteAmountsNeedReviewError = class extends ThrottleApiError {
+  constructor(args) {
+    super(coded("quote_amounts_need_review", 422, args));
+    this.name = "QuoteAmountsNeedReviewError";
+  }
+};
 var RESOLVED_CART_ERRORS = {
   price_locked: PriceLockedError,
   quantity_unavailable: QuantityUnavailableError,
@@ -181,7 +205,11 @@ var RESOLVED_CART_ERRORS = {
   amount_too_large: AmountTooLargeError,
   cart_changed: CartChangedError,
   discount_currency_unsupported: DiscountCurrencyUnsupportedError,
-  shipping_currency_unsupported: ShippingCurrencyUnsupportedError
+  shipping_currency_unsupported: ShippingCurrencyUnsupportedError,
+  currency_not_supported: CurrencyNotSupportedError,
+  currency_not_available_in_production: CurrencyNotAvailableInProductionError,
+  currency_locked: CurrencyLockedError,
+  quote_amounts_need_review: QuoteAmountsNeedReviewError
 };
 function cartErrorFromResponse(args) {
   if (args.statusCode === 409 && args.code === "cart_not_open") {
@@ -585,8 +613,24 @@ var CartSessionClient = class _CartSessionClient {
     }
   }
 };
+
+// src/index.ts
+import * as money from "@usethrottle/money";
+import {
+  formatMoney,
+  currencySymbol,
+  minorUnitsOf,
+  toDecimalString,
+  toMinor,
+  parseMoney,
+  moneyValue,
+  CURRENCIES,
+  isKnownCurrency,
+  UnknownCurrencyError
+} from "@usethrottle/money";
 export {
   AmountTooLargeError,
+  CURRENCIES,
   CartChangedError,
   CartClient,
   CartNotFoundError,
@@ -594,7 +638,10 @@ export {
   CartPricesChangedError,
   CartSessionClient,
   CartTimeoutError,
+  CurrencyLockedError,
+  CurrencyNotAvailableInProductionError,
   CurrencyNotEnabledError,
+  CurrencyNotSupportedError,
   DiscountCurrencyUnsupportedError,
   LineLimitReachedError,
   LineNotPurchasableError,
@@ -602,6 +649,7 @@ export {
   LineResolverUnavailableError,
   PriceLockedError,
   QuantityUnavailableError,
+  QuoteAmountsNeedReviewError,
   ResolvedLinesRequiredError,
   ShippingCurrencyUnsupportedError,
   ShippingMethodUnavailableError,
@@ -609,6 +657,16 @@ export {
   StorefrontQuoteClient,
   ThrottleApiError,
   ThrottleError2 as ThrottleError,
+  UnknownCurrencyError,
   cartErrorFromResponse,
-  isThrottleError
+  currencySymbol,
+  formatMoney,
+  isKnownCurrency,
+  isThrottleError,
+  minorUnitsOf,
+  money,
+  moneyValue,
+  parseMoney,
+  toDecimalString,
+  toMinor
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/cart",
-  "version": "3.15.0",
+  "version": "3.17.0",
   "description": "Typed REST client for the Throttle Cart API.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -18,7 +18,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@usethrottle/errors": "^1.1.0"
+    "@usethrottle/errors": "^1.1.0",
+    "@usethrottle/money": "^1.0.0"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
@@ -30,7 +31,7 @@
   },
   "scripts": {
     "build": "tsup",
-    "test": "tsc --noEmit --strict --skipLibCheck --target es2022 --lib es2022,dom --module esnext --moduleResolution bundler __tests__/recurring-types.check.ts && vitest run",
+    "test": "tsc --noEmit --strict --skipLibCheck --target es2022 --lib es2022,dom --module esnext --moduleResolution bundler __tests__/recurring-types.check.ts __tests__/cart-customer-detach.check.ts __tests__/currency-types.check.ts && vitest run",
     "typecheck": "tsc --noEmit"
   }
 }