@usethrottle/catalog 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @usethrottle/catalog
 
+## 1.3.0
+
+### Minor Changes
+
+- e159fc9: Multi-currency slice 2. Everything is additive: without the new calls the SDK behaves as 1.2.0.
+
+  - Money helpers from `@usethrottle/money` (a new dependency, `^1.0.0`): the `money` namespace and, by name, `formatMoney`, `currencySymbol`, `toDecimalString`, `toMinor`, `parseMoney`, `minorUnitsOf`, `isKnownCurrency`, `moneyValue`, `CURRENCIES`, `UnknownCurrencyError` and the `CurrencyCode` and `MoneyValue` types. Prices are integers in the minor units of their currency; format them with `formatMoney`.
+  - `CurrencyCode` typing on every price object's `currency` (product, variant, price list and cart line), `CartView.currency` and `OpenCartRef.currency`. `CartOptions.currency` stays `string`.
+  - `useCart().format(minor)` formats an amount in the cart's currency.
+  - `useCart().switchCurrency(next)` finds or creates the shopper's cart in `next` and moves the current cart's lines into it through Throttle's absorb route. Signed in, it finds the customer's open cart in that currency; as a guest, it reads the optional `CartStorage` per-currency slots (`getFor`, `setFor`, `removeFor`, implemented by `createMemoryCartStorage`). With no target it creates an empty cart in `next`. Removed lines and a dropped discount are reported through the hook's `warnings`. Any failure keeps the old cart, its stored id and its currency.
+  - The catalog Worker now accepts an empty cart create (`items: []`), which the switch needs. Older clients are unaffected.
+
 ## 1.2.0
 
 ### Minor Changes

package/README.md

@@ -32,13 +32,13 @@ for (const product of products) {
 }
 ```
 
-Prices are integers in minor units (cents for USD). The client talks to `https://catalog.usethrottle.dev` by default (`baseUrl` changes it). Every call takes `{ signal, timeoutMs }`; the default timeout is 10 seconds.
+Prices are integers in the minor units of their currency; format them with `formatMoney` (`formatMoney(product.priceRange.minMinor, product.priceRange.currency)` gives `$19.99` for USD and `¥1,999` for JPY, the same on the server and in the browser). The root re-exports `@usethrottle/money` as `money` and by name (`formatMoney`, `currencySymbol`, `minorUnitsOf`, `toDecimalString`, `toMinor`, `parseMoney`, `moneyValue`, `CURRENCIES`, `isKnownCurrency`, `UnknownCurrencyError`, and the types `CurrencyCode` and `MoneyValue`); every `currency` the SDK answers is a `CurrencyCode`, which is still assignable to `string`. The client talks to `https://catalog.usethrottle.dev` by default (`baseUrl` changes it). Every call takes `{ signal, timeoutMs }`; the default timeout is 10 seconds.
 
 ## Entries
 
 | Import                              | What it holds                                                                                                                                                                                                                                                                           |
 | ----------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `@usethrottle/catalog`              | `createCatalogClient`, the error classes and `isCatalogError`, and the answer types. No DOM and no Node-only API.                                                                                                                                                                       |
+| `@usethrottle/catalog`              | `createCatalogClient`, the error classes and `isCatalogError`, the answer types, and the `@usethrottle/money` helpers (`money`, `formatMoney`, …). No DOM and no Node-only API.                                                                                                         |
 | `@usethrottle/catalog/react`        | `CatalogProvider`, the read hooks, `useCart`, `useSubmitReview` and `useCustomerKey` (marked `"use client"`).                                                                                                                                                                           |
 | `@usethrottle/catalog/react/extras` | `useTags`, `useCollections` and `useReviewEligibility` (marked `"use client"`). They share `CatalogProvider` and the cache with `/react`: import the provider from `/react` and these three from here.                                                                                  |
 | `@usethrottle/catalog/server`       | `createServerCatalogClient`, `catalogTags`, `syncCatalogGeneration` and the paging helpers (`listAllProductHandles`, `staticProductParams`, `listAllCollectionHandles`, `listAllCategoryHandles`: it asks for `CATEGORY_TREE_MAX_DEPTH` levels, 10, so a sitemap lists the whole tree). |
@@ -105,7 +105,7 @@ try {
 
 ## Carts and checkout
 
-Carts are resolved by the catalog: the browser sends SKUs and quantities, never prices. `carts.create` answers Throttle's hosted cart URL (`cartUrl`) and a session id. It takes three optional URLs, each an absolute `https` URL on the store's Checkout settings › Allowed return websites (otherwise `422 RETURN_URL_NOT_ALLOWED`, one issue per refused field):
+Carts are resolved by the catalog: the browser sends SKUs and quantities, never prices. `carts.create` answers Throttle's hosted cart URL (`cartUrl`) and a session id; `items` may be empty, for an empty cart in a currency. It takes three optional URLs, each an absolute `https` URL on the store's Checkout settings › Allowed return websites (otherwise `422 RETURN_URL_NOT_ALLOWED`, one issue per refused field):
 
 ```ts
 const cart = await catalog.carts.create({
@@ -117,7 +117,7 @@ const cart = await catalog.carts.create({
 // cart.returnUrlApplied is false when Throttle did not store them.
 ```
 
-Without them the shopper ends on Throttle's own completion page. To build your own cart page instead, use `catalog.carts.session(cart.sessionId)` (`get`, `add`, `update`, `remove`, `refresh`, `checkout({ returnUrl, cancelUrl })`). `checkout()` answers the checkout URL; it never navigates. Both are checked before any request: `carts.create` refuses a URL that is not absolute `https` (`INVALID_REQUEST`, naming the field), and `checkout()` one that is not absolute `http` or `https`.
+Without them the shopper ends on Throttle's own completion page. To build your own cart page instead, use `catalog.carts.session(cart.sessionId)` (`get`, `add`, `update`, `remove`, `refresh`, `checkout({ returnUrl, cancelUrl })`, and `absorb(fromSessionId)`, which moves another session's cart into this one in this cart's currency, answering `{ cart, warnings }`; `useCart().switchCurrency` is built on it). `checkout()` answers the checkout URL; it never navigates. Both are checked before any request: `carts.create` refuses a URL that is not absolute `https` (`INVALID_REQUEST`, naming the field), and `checkout()` one that is not absolute `http` or `https`.
 
 ## React
 
@@ -191,7 +191,7 @@ function ProductGrid() {
 - **Hooks:** `useProducts`, `useProduct`, `useRelated`, `useFilterValues`, `useCategories`, `useCollection`, `useSuggest` (debounced 200 ms, 2 characters at least), `useReviews` and `useConfig` from `/react`; `useTags`, `useCollections` and `useReviewEligibility` from `/react/extras` (below). Each answers `{ data, dataFor, error, isLoading, isPreviousData, isStale, isValidating, refetch }` and takes `enabled`, `initialData` (for an SSR hand-off), `staleTimeMs` and `keepPreviousData`. With a signed-in customer (`customerKey` set), `initialData` is shown and revalidated at once, since a server render with the server key is anonymous; to avoid the brief list-price paint, render the server side with the customer's token.
 - **The cache** is per provider: answers are shown at once and refetched when older than 60 seconds, and calls for one key share one request. Two providers never share it.
 - **`customerKey`** partitions the cache by customer. Change it in the same update as the token: a change starts an empty cache and every mounted hook refetches, so one customer never sees another's prices. It is required whenever `customerToken` can return a token: `useCart` drops the cart on a sign-out or a customer change only by watching it, so without it one customer's cart stays for the next shopper. Keep one `client` per currency and language (see [One client per currency and language](#one-client-per-currency-and-language)) and pass `customerToken` as a function.
-- **`useCart`** keeps one cart per provider and runs its changes one at a time. It creates the cart on the first `add`, recreates it once if Throttle ended the session, and makes a new cart on `switchCurrency`. A switch lands whole or not at all: if the new cart cannot be made, read back or saved, `switchCurrency` rejects and the old cart, its stored id and the old currency stay. The cart is dropped when the signed-in customer signs out or changes, and kept on sign-in. `checkout()` uses the provider's `cartUrls` unless given URLs, and answers the checkout URL. `cartUrls` go on every cart create, so they must be absolute `https` URLs on the store's Allowed return websites, or every `add` fails; otherwise (on `http://localhost`, say) leave them out and pass the URLs to `checkout(input)`. The default `cartStorage` is memory only; key a persistent one by customer, as above: a new adapter object per customer, never one stable object that reads the current customer when called (a drop removes the outgoing customer's entry through the outgoing object, so such an adapter would delete the incoming customer's cart instead).
+- **`useCart`** keeps one cart per provider and runs its changes one at a time. It creates the cart on the first `add` and recreates it once if Throttle ended the session. `format(minor)` formats an amount in the cart's currency (`useCart().format(4763)` on a EUR cart is `€47.63`). **`switchCurrency(currency)`** keeps one cart per currency: it moves the cart into the shopper's open cart in that currency (a signed-in customer's from `customerCart`; a guest's from `cartStorage.getFor`, used only while that cart is still open), or into a new empty cart when there is none, and Throttle closes the old cart as merged. Lines with no price in the new currency stay behind and a discount code the new currency refuses is dropped; both are reported in `warnings` (`lines_removed`, `discount_dropped`). If anything fails before the move lands (the lookup, the new cart, the move itself, for example `422 currency_not_available_in_production`), `switchCurrency` rejects and the old cart, its stored id and the old currency stay. A signed-in switch needs `customerToken` on the client: the new cart is created as the customer's, and Throttle moves a customer's cart only into that customer's cart (`403 cart_owner_mismatch` otherwise). A `cartStorage` adapter may implement the optional `getFor(currency)`, `setFor(currency, id)` and `removeFor(currency)` (`createMemoryCartStorage` does); without them a guest switch always makes a new cart. These are guest slots: a signed-in switch never writes them, and the provider forgets them on a sign-in, a sign-out or a customer change (through `removeFor`, or `setFor(currency, '')` when the adapter has no `removeFor`), so the next guest never reaches a customer's cart. The cart is dropped when the signed-in customer signs out or changes, and kept on sign-in. `checkout()` uses the provider's `cartUrls` unless given URLs, and answers the checkout URL. `cartUrls` go on every cart create, so they must be absolute `https` URLs on the store's Allowed return websites, or every `add` fails; otherwise (on `http://localhost`, say) leave them out and pass the URLs to `checkout(input)`. The default `cartStorage` is memory only; key a persistent one by customer, as above: a new adapter object per customer, never one stable object that reads the current customer when called (a drop removes the outgoing customer's entry through the outgoing object, so such an adapter would delete the incoming customer's cart instead).
 - **Rate limits:** a catalog `429` pauses every read of the provider until its retry time; each mounted key then refetches once.
 - **`useSubmitReview(handle)`** submits a review with one idempotency key per submission.
 
@@ -229,7 +229,7 @@ function Shell({ customerId, children }) {
 }
 ```
 
-`useCart` looks the cart up once per visit when the slot is empty (or ended), and before it would create a new cart. **It resumes only when a currency is known:** set `currency` on the client (`createCatalogClient({ currency: 'USD' })`) or pass it to the hook, `useCart({ currency: 'USD' })`. With neither, `useCart` makes no lookup and the first `add` creates a cart as before. A found cart in another currency is not adopted. Without `customerCart` nothing changes from 1.1.0. Known limits: a write within 30 seconds of a read that predates another device's merge reopens the emptied cart, and so can a write after a re-read that failed. The lookup runs once per visit, so a currency that becomes known only after mount does not trigger it; the first `add` finds the cart instead. With two `useCart` call sites that pass different currencies, the lookup and the create can use different currencies; pass one currency (or set it on the client). `switchCurrency` while signed in creates a cart in the new currency without a lookup, so a customer with an open cart in that currency on another device can end up with a second one.
+`useCart` looks the cart up once per visit when the slot is empty (or ended), and before it would create a new cart. **It resumes only when a currency is known:** set `currency` on the client (`createCatalogClient({ currency: 'USD' })`) or pass it to the hook, `useCart({ currency: 'USD' })`. With neither, `useCart` makes no lookup and the first `add` creates a cart as before. A found cart in another currency is not adopted. Without `customerCart` nothing changes from 1.1.0. Throttle refuses a write to a cart another device merged (`409 cart_not_open`), so it is never reopened; `useCart` then looks the customer's cart up. `switchCurrency` while signed in looks up the customer's open cart in the new currency and moves the cart into it, so a customer keeps one cart per currency across devices. The lookup runs once per visit, so a currency that becomes known only after mount does not trigger it; the first `add` finds the cart instead. With two `useCart` call sites that pass different currencies, the lookup and the create can use different currencies; pass one currency (or set it on the client).
 
 ### Key transport
 
@@ -444,7 +444,7 @@ The OpenAPI 3.1 document of the storefront API is at https://catalog.usethrottle
 
 ### One client per currency and language
 
-Hooks take no per-call currency or language: both come from the client. A store with a currency or language switcher keeps one client per `(currency, locale)`, memoised on both, so the client changes only when one of them does. On a currency switch, run `useCart().switchCurrency()` first and swap the client only once it resolves. The switch lands whole or not at all: when it rejects, the cart is still in the old currency, so keep the old client.
+Hooks take no per-call currency or language: both come from the client. A store with a currency or language switcher keeps one client per `(currency, locale)`, memoised on both, so the client changes only when one of them does. On a currency switch, run `useCart().switchCurrency()` first and swap the client only once it resolves. When it rejects, the cart is still in the old currency, so keep the old client; when it resolves, show `cart.warnings` (lines left behind, a dropped discount code).
 
 ```tsx
 'use client';

package/dist/admin.cjs

@@ -10,7 +10,7 @@
 
 
 
-var _chunkB2DYAHNRcjs = require('./chunk-B2DYAHNR.cjs');
+var _chunk2YQNMBDIcjs = require('./chunk-2YQNMBDI.cjs');
 require('./chunk-ETV4XYOV.cjs');
 
 // src/generated/push-types.ts
@@ -45,7 +45,7 @@ var MAX_IDEMPOTENCY_KEY = 200;
 var HEADER_SAFE = /^[\x21-\x7e]+$/u;
 var MAX_RETRY_AFTER_S = 86400;
 function invalidRequest(message) {
-  return new (0, _chunkB2DYAHNRcjs.CatalogError)({
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
     code: "INVALID_REQUEST",
     message,
     statusCode: 0,
@@ -54,7 +54,7 @@ function invalidRequest(message) {
   });
 }
 function clientError(code, message) {
-  return new (0, _chunkB2DYAHNRcjs.CatalogError)({
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
     code,
     message,
     statusCode: 0,
@@ -126,13 +126,13 @@ function toError(status, headers, text) {
     requestId
   };
   if (status === 429) {
-    return new (0, _chunkB2DYAHNRcjs.RateLimitedError)({
+    return new (0, _chunk2YQNMBDIcjs.RateLimitedError)({
       ...init,
       retryable: true,
-      retryAfterSeconds: retryAfter !== null && retryAfter >= 1 ? retryAfter : _chunkB2DYAHNRcjs.RATE_LIMIT_DEFAULT_RETRY_S
+      retryAfterSeconds: retryAfter !== null && retryAfter >= 1 ? retryAfter : _chunk2YQNMBDIcjs.RATE_LIMIT_DEFAULT_RETRY_S
     });
   }
-  return new (0, _chunkB2DYAHNRcjs.CatalogError)(init);
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)(init);
 }
 function guarded(work, callerSignal, timeoutMs) {
   if (_optionalChain([callerSignal, 'optionalAccess', _8 => _8.aborted])) return Promise.reject(callerSignal.reason);
@@ -151,7 +151,7 @@ function guarded(work, callerSignal, timeoutMs) {
     const timer = setTimeout(() => {
       finish();
       controller.abort();
-      reject(new (0, _chunkB2DYAHNRcjs.TimeoutError)({ timeoutMs }));
+      reject(new (0, _chunk2YQNMBDIcjs.TimeoutError)({ timeoutMs }));
     }, timeoutMs);
     _optionalChain([callerSignal, 'optionalAccess', _12 => _12.addEventListener, 'call', _13 => _13("abort", onAbort, { once: true })]);
     work(controller.signal).then(
@@ -194,7 +194,7 @@ function createHttp(key, baseUrl, fetchFn, timeoutMs) {
                 signal
               });
             } catch (cause) {
-              throw new (0, _chunkB2DYAHNRcjs.NetworkError)({ cause });
+              throw new (0, _chunk2YQNMBDIcjs.NetworkError)({ cause });
             }
             try {
               return {
@@ -203,14 +203,14 @@ function createHttp(key, baseUrl, fetchFn, timeoutMs) {
                 text: await response.text()
               };
             } catch (cause) {
-              throw new (0, _chunkB2DYAHNRcjs.NetworkError)({ cause });
+              throw new (0, _chunk2YQNMBDIcjs.NetworkError)({ cause });
             }
           },
           spec.signal,
           timeoutMs
         );
       } catch (error) {
-        if (error instanceof _chunkB2DYAHNRcjs.NetworkError && attempt < attempts) continue;
+        if (error instanceof _chunk2YQNMBDIcjs.NetworkError && attempt < attempts) continue;
         throw error;
       }
     }
@@ -223,7 +223,7 @@ function createHttp(key, baseUrl, fetchFn, timeoutMs) {
         throw toError(answer.status, answer.headers, answer.text);
       const parsed = parseJson(answer.text);
       if (parsed === void 0)
-        throw new (0, _chunkB2DYAHNRcjs.CatalogError)({
+        throw new (0, _chunk2YQNMBDIcjs.CatalogError)({
           code: "INVALID_RESPONSE",
           message: "The server answered with a body that is not JSON.",
           statusCode: answer.status,
@@ -278,7 +278,7 @@ function refQuery(ref) {
   return [[field, value]];
 }
 function unreadable() {
-  return new (0, _chunkB2DYAHNRcjs.CatalogError)({
+  return new (0, _chunk2YQNMBDIcjs.CatalogError)({
     code: "INVALID_RESPONSE",
     message: "The server answered with an unexpected shape.",
     statusCode: 200,
@@ -367,7 +367,7 @@ async function pollUntil(read, done, options = {}) {
     const value = await read(options.signal);
     if (done(value)) return value;
     const remaining = deadline - Date.now();
-    if (remaining <= 0) throw new (0, _chunkB2DYAHNRcjs.TimeoutError)({ timeoutMs });
+    if (remaining <= 0) throw new (0, _chunk2YQNMBDIcjs.TimeoutError)({ timeoutMs });
     await sleep(Math.min(intervalMs, remaining), options.signal);
   }
 }
@@ -452,7 +452,7 @@ function createJobs(http) {
         await handle.send(rows, { idempotencyKey });
         return;
       } catch (error) {
-        if (!(error instanceof _chunkB2DYAHNRcjs.RateLimitedError) || retry >= QUEUE_RETRIES)
+        if (!(error instanceof _chunk2YQNMBDIcjs.RateLimitedError) || retry >= QUEUE_RETRIES)
           throw error;
         await sleep(error.retryAfterSeconds * 1e3, signal);
       }
@@ -589,7 +589,7 @@ function assertServer() {
 function createCatalogAdmin(options) {
   assertServer();
   const key = checkKey(options.key);
-  const baseUrl = (_nullishCoalesce(options.baseUrl, () => ( _chunkB2DYAHNRcjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "");
+  const baseUrl = (_nullishCoalesce(options.baseUrl, () => ( _chunk2YQNMBDIcjs.DEFAULT_BASE_URL))).replace(/\/+$/u, "");
   if (!/^https?:\/\/[^\s/]+/iu.test(baseUrl))
     throw invalidRequest("baseUrl must be an absolute http or https URL.");
   const http = createHttp(
@@ -678,4 +678,4 @@ async function verifyCatalogWebhook(input) {
 
 
 
-exports.CartLineError = _chunkB2DYAHNRcjs.CartLineError; exports.CatalogError = _chunkB2DYAHNRcjs.CatalogError; exports.CustomerTokenInvalidError = _chunkB2DYAHNRcjs.CustomerTokenInvalidError; exports.FeatureUnavailableError = _chunkB2DYAHNRcjs.FeatureUnavailableError; exports.NetworkError = _chunkB2DYAHNRcjs.NetworkError; exports.OriginNotAllowedError = _chunkB2DYAHNRcjs.OriginNotAllowedError; exports.RateLimitedError = _chunkB2DYAHNRcjs.RateLimitedError; exports.TimeoutError = _chunkB2DYAHNRcjs.TimeoutError; exports.createCatalogAdmin = createCatalogAdmin; exports.isCatalogError = _chunkB2DYAHNRcjs.isCatalogError; exports.verifyCatalogWebhook = verifyCatalogWebhook;
+exports.CartLineError = _chunk2YQNMBDIcjs.CartLineError; exports.CatalogError = _chunk2YQNMBDIcjs.CatalogError; exports.CustomerTokenInvalidError = _chunk2YQNMBDIcjs.CustomerTokenInvalidError; exports.FeatureUnavailableError = _chunk2YQNMBDIcjs.FeatureUnavailableError; exports.NetworkError = _chunk2YQNMBDIcjs.NetworkError; exports.OriginNotAllowedError = _chunk2YQNMBDIcjs.OriginNotAllowedError; exports.RateLimitedError = _chunk2YQNMBDIcjs.RateLimitedError; exports.TimeoutError = _chunk2YQNMBDIcjs.TimeoutError; exports.createCatalogAdmin = createCatalogAdmin; exports.isCatalogError = _chunk2YQNMBDIcjs.isCatalogError; exports.verifyCatalogWebhook = verifyCatalogWebhook;

package/dist/admin.d.cts

@@ -1,5 +1,6 @@
-export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-yTBMAdCv.cjs';
-import './contract-types-BPSzY_Co.cjs';
+export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-BOaSKgY3.cjs';
+import './contract-types-BRyonOYH.cjs';
+import '@usethrottle/money';
 
 type JobBatchAnswer = {
     batchId: string;

package/dist/admin.d.ts

@@ -1,5 +1,6 @@
-export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-7DCsTyB2.js';
-import './contract-types-BPSzY_Co.js';
+export { C as CartLineError, a as CartLineProblem, b as CatalogError, c as CatalogErrorCode, d as CatalogErrorInit, e as CatalogErrorIssue, f as CatalogErrorSource, g as ClientErrorCode, h as CustomerTokenInvalidError, F as FeatureUnavailableError, N as NetworkError, O as OriginNotAllowedError, R as RateLimitedError, T as TimeoutError, i as isCatalogError } from './catalog-error-CSoPS0-d.js';
+import './contract-types-BRyonOYH.js';
+import '@usethrottle/money';
 
 type JobBatchAnswer = {
     batchId: string;

package/dist/admin.js

@@ -10,7 +10,7 @@ import {
   RateLimitedError,
   TimeoutError,
   isCatalogError
-} from "./chunk-55G4ZTD5.js";
+} from "./chunk-3DLH56OX.js";
 import "./chunk-PKBMQBKP.js";
 
 // src/generated/push-types.ts

package/dist/{catalog-error-yTBMAdCv.d.cts → catalog-error-BOaSKgY3.d.cts}

@@ -1,4 +1,4 @@
-import { i as CatalogContractErrorCode } from './contract-types-BPSzY_Co.cjs';
+import { i as CatalogContractErrorCode } from './contract-types-BRyonOYH.cjs';
 
 /**
  * Shared error type for every Throttle SDK.
@@ -153,6 +153,16 @@ declare const THROTTLE_CART_CODES: {
         readonly statuses: readonly [501];
         readonly retryable: false;
     };
+    /** The absorb (MC2-R39): a customer's cart never moves into a guest's or another customer's. */
+    readonly cart_owner_mismatch: {
+        readonly statuses: readonly [403];
+        readonly retryable: false;
+    };
+    /** The absorb: the two carts are priced by different apps. */
+    readonly cart_resolver_mismatch: {
+        readonly statuses: readonly [422];
+        readonly retryable: false;
+    };
 };
 type ThrottleCartCode = keyof typeof THROTTLE_CART_CODES;
 

package/dist/{catalog-error-7DCsTyB2.d.ts → catalog-error-CSoPS0-d.d.ts}

@@ -1,4 +1,4 @@
-import { i as CatalogContractErrorCode } from './contract-types-BPSzY_Co.js';
+import { i as CatalogContractErrorCode } from './contract-types-BRyonOYH.js';
 
 /**
  * Shared error type for every Throttle SDK.
@@ -153,6 +153,16 @@ declare const THROTTLE_CART_CODES: {
         readonly statuses: readonly [501];
         readonly retryable: false;
     };
+    /** The absorb (MC2-R39): a customer's cart never moves into a guest's or another customer's. */
+    readonly cart_owner_mismatch: {
+        readonly statuses: readonly [403];
+        readonly retryable: false;
+    };
+    /** The absorb: the two carts are priced by different apps. */
+    readonly cart_resolver_mismatch: {
+        readonly statuses: readonly [422];
+        readonly retryable: false;
+    };
 };
 type ThrottleCartCode = keyof typeof THROTTLE_CART_CODES;
 

package/dist/{chunk-B2DYAHNR.cjs → chunk-2YQNMBDI.cjs}

@@ -1,9 +1,24 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 var _chunkETV4XYOVcjs = require('./chunk-ETV4XYOV.cjs');
 
 // src/version.ts
-var SDK_VERSION = true ? "1.2.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.3.0" : "0.0.0-dev";
+
+// src/index.ts
+var _money = require('@usethrottle/money'); var money = _interopRequireWildcard(_money);
+
+
+
+
+
+
+
+
+
+
+
+
 
 // src/errors/catalog-error.ts
 var _errors = require('@usethrottle/errors');
@@ -190,6 +205,8 @@ var ERROR_KINDS = Object.freeze({
   cart_session_not_found: "base",
   origin_not_allowed: "origin",
   checkout_unavailable: "base",
+  cart_owner_mismatch: "base",
+  cart_resolver_mismatch: "base",
   // Client codes.
   TIMEOUT: "timeout",
   NETWORK_ERROR: "network",
@@ -731,6 +748,9 @@ function createTransport(o) {
 function createCartSession(options, sessionId, throttleBaseUrl) {
   const base = (_nullishCoalesce(throttleBaseUrl, () => ( THROTTLE_API_URL))).replace(/\/+$/u, "");
   async function call(method, tail, body, opts, accept) {
+    return (await exchange(method, tail, body, opts, accept)).data;
+  }
+  async function exchange(method, tail, body, opts, accept) {
     const signal = _optionalChain([opts, 'optionalAccess', _30 => _30.signal]);
     if (_optionalChain([signal, 'optionalAccess', _31 => _31.aborted])) throw signal.reason;
     const timeoutMs = _optionalChain([opts, 'optionalAccess', _32 => _32.timeoutMs]) === void 0 ? options.timeoutMs : checkTimeout(opts.timeoutMs);
@@ -768,7 +788,10 @@ function createCartSession(options, sessionId, throttleBaseUrl) {
           retryable: false
         });
       }
-      return data;
+      return {
+        data,
+        meta: parsed.meta
+      };
     }
     throw toCatalogError(mapInput);
   }
@@ -811,6 +834,27 @@ function createCartSession(options, sessionId, throttleBaseUrl) {
         opts,
         (data) => isHttpUrl(data.checkoutUrl)
       );
+    },
+    absorb: async (fromSessionId, opts) => {
+      const { data, meta } = await exchange(
+        "POST",
+        () => "/absorb",
+        { fromSessionId },
+        opts
+      );
+      if (typeof data.cart !== "object" || data.cart === null)
+        throw new CatalogError({
+          code: "INVALID_RESPONSE",
+          message: "Throttle answered an absorb without a cart.",
+          statusCode: 200,
+          source: "throttle",
+          retryable: false
+        });
+      const warnings = _optionalChain([meta, 'optionalAccess', _36 => _36.warnings]);
+      return {
+        cart: data.cart,
+        warnings: Array.isArray(warnings) ? warnings : []
+      };
     }
   };
 }
@@ -839,7 +883,7 @@ function createCarts(transport, options) {
     // The input's own currency and locale win over the call's and the
     // client's; the return URLs are sent unchanged (P6-R2).
     create: async (input, opts) => {
-      if (_optionalChain([opts, 'optionalAccess', _36 => _36.signal, 'optionalAccess', _37 => _37.aborted])) throw opts.signal.reason;
+      if (_optionalChain([opts, 'optionalAccess', _37 => _37.signal, 'optionalAccess', _38 => _38.aborted])) throw opts.signal.reason;
       for (const field of [
         "returnUrl",
         "cancelUrl",
@@ -862,12 +906,12 @@ function createCarts(transport, options) {
           customerToken: "optional",
           tokenFallback: "throw",
           featureRoute: true,
-          ..._optionalChain([opts, 'optionalAccess', _38 => _38.idempotencyKey]) === void 0 ? {} : { idempotencyKey: opts.idempotencyKey }
+          ..._optionalChain([opts, 'optionalAccess', _39 => _39.idempotencyKey]) === void 0 ? {} : { idempotencyKey: opts.idempotencyKey }
         },
         opts
       );
     },
-    session: (sessionId, opts) => createCartSession(options, sessionId, _optionalChain([opts, 'optionalAccess', _39 => _39.throttleBaseUrl]))
+    session: (sessionId, opts) => createCartSession(options, sessionId, _optionalChain([opts, 'optionalAccess', _40 => _40.throttleBaseUrl]))
   };
 }
 
@@ -908,11 +952,11 @@ function productsQuery(query = {}) {
     featured: query.featured,
     handles: query.handles,
     skus: query.skus,
-    year: _optionalChain([vehicle, 'optionalAccess', _40 => _40.year]),
-    make: _optionalChain([vehicle, 'optionalAccess', _41 => _41.make]),
-    model: _optionalChain([vehicle, 'optionalAccess', _42 => _42.model]),
-    submodel: _optionalChain([vehicle, 'optionalAccess', _43 => _43.submodel]),
-    engine: _optionalChain([vehicle, 'optionalAccess', _44 => _44.engine]),
+    year: _optionalChain([vehicle, 'optionalAccess', _41 => _41.year]),
+    make: _optionalChain([vehicle, 'optionalAccess', _42 => _42.make]),
+    model: _optionalChain([vehicle, 'optionalAccess', _43 => _43.model]),
+    submodel: _optionalChain([vehicle, 'optionalAccess', _44 => _44.submodel]),
+    engine: _optionalChain([vehicle, 'optionalAccess', _45 => _45.engine]),
     sort: query.sort,
     limit: query.limit,
     page: query.page,
@@ -950,7 +994,7 @@ function createProducts(transport) {
         path: `${SF}/products/${pathSegment(handle)}`,
         // Always the full product (P6-R18).
         query: buildQuery(
-          { fields: "full", include: commaList(_optionalChain([opts, 'optionalAccess', _45 => _45.include])) },
+          { fields: "full", include: commaList(_optionalChain([opts, 'optionalAccess', _46 => _46.include])) },
           ["fields", "include"]
         ),
         customerToken: "optional",
@@ -966,7 +1010,7 @@ function createProducts(transport) {
         method: "GET",
         path: `${SF}/products/${pathSegment(handle)}/related`,
         query: buildQuery(
-          { limit: _optionalChain([opts, 'optionalAccess', _46 => _46.limit]), fields: commaList(_optionalChain([opts, 'optionalAccess', _47 => _47.fields])) },
+          { limit: _optionalChain([opts, 'optionalAccess', _47 => _47.limit]), fields: commaList(_optionalChain([opts, 'optionalAccess', _48 => _48.fields])) },
           ["limit", "fields"]
         ),
         customerToken: "optional",
@@ -1002,7 +1046,7 @@ function createSuggest(transport) {
     {
       method: "GET",
       path: `${SF}/suggest`,
-      query: buildQuery({ q, limit: _optionalChain([opts, 'optionalAccess', _48 => _48.limit]) }, ["q", "limit"]),
+      query: buildQuery({ q, limit: _optionalChain([opts, 'optionalAccess', _49 => _49.limit]) }, ["q", "limit"]),
       // Never a customer token (P8-R22): list prices for everyone.
       customerToken: "none",
       tokenFree: true,
@@ -1027,10 +1071,10 @@ function createReviews(transport) {
         path: reviewsPath(handle),
         query: buildQuery(
           {
-            sort: _optionalChain([opts, 'optionalAccess', _49 => _49.sort]),
-            rating: _optionalChain([opts, 'optionalAccess', _50 => _50.rating]),
-            limit: _optionalChain([opts, 'optionalAccess', _51 => _51.limit]),
-            cursor: _optionalChain([opts, 'optionalAccess', _52 => _52.cursor])
+            sort: _optionalChain([opts, 'optionalAccess', _50 => _50.sort]),
+            rating: _optionalChain([opts, 'optionalAccess', _51 => _51.rating]),
+            limit: _optionalChain([opts, 'optionalAccess', _52 => _52.limit]),
+            cursor: _optionalChain([opts, 'optionalAccess', _53 => _53.cursor])
           },
           ["sort", "rating", "limit", "cursor"]
         ),
@@ -1062,7 +1106,7 @@ function createReviews(transport) {
         customerToken: "required",
         tokenFallback: "throw",
         featureRoute: false,
-        ..._optionalChain([opts, 'optionalAccess', _53 => _53.idempotencyKey]) === void 0 ? {} : { idempotencyKey: opts.idempotencyKey }
+        ..._optionalChain([opts, 'optionalAccess', _54 => _54.idempotencyKey]) === void 0 ? {} : { idempotencyKey: opts.idempotencyKey }
       },
       opts
     )
@@ -1078,7 +1122,7 @@ function createCategories(transport) {
       {
         method: "GET",
         path: `${SF2}/categories`,
-        query: buildQuery({ depth: _optionalChain([opts, 'optionalAccess', _54 => _54.depth]) }, ["depth"]),
+        query: buildQuery({ depth: _optionalChain([opts, 'optionalAccess', _55 => _55.depth]) }, ["depth"]),
         customerToken: "none",
         tokenFallback: "anonymous",
         featureRoute: true,
@@ -1107,7 +1151,7 @@ function createTags(transport) {
       {
         method: "GET",
         path: `${SF2}/tags`,
-        query: buildQuery({ q: _optionalChain([opts, 'optionalAccess', _55 => _55.q]), limit: _optionalChain([opts, 'optionalAccess', _56 => _56.limit]) }, ["q", "limit"]),
+        query: buildQuery({ q: _optionalChain([opts, 'optionalAccess', _56 => _56.q]), limit: _optionalChain([opts, 'optionalAccess', _57 => _57.limit]) }, ["q", "limit"]),
         customerToken: "none",
         tokenFallback: "anonymous",
         featureRoute: true
@@ -1123,7 +1167,7 @@ function createCollections(transport) {
       {
         method: "GET",
         path: `${SF2}/collections`,
-        query: buildQuery({ limit: _optionalChain([opts, 'optionalAccess', _57 => _57.limit]), cursor: _optionalChain([opts, 'optionalAccess', _58 => _58.cursor]) }, [
+        query: buildQuery({ limit: _optionalChain([opts, 'optionalAccess', _58 => _58.limit]), cursor: _optionalChain([opts, 'optionalAccess', _59 => _59.cursor]) }, [
           "limit",
           "cursor"
         ]),
@@ -1209,4 +1253,15 @@ function createCatalogClient(options) {
 
 
 
-exports.SDK_VERSION = SDK_VERSION; exports.CatalogError = CatalogError; exports.RateLimitedError = RateLimitedError; exports.OriginNotAllowedError = OriginNotAllowedError; exports.CustomerTokenInvalidError = CustomerTokenInvalidError; exports.CartLineError = CartLineError; exports.TimeoutError = TimeoutError; exports.NetworkError = NetworkError; exports.FeatureUnavailableError = FeatureUnavailableError; exports.isCatalogError = isCatalogError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.THROTTLE_CHECKOUT_URL = THROTTLE_CHECKOUT_URL; exports.RATE_LIMIT_DEFAULT_RETRY_S = RATE_LIMIT_DEFAULT_RETRY_S; exports.STALE_MS = STALE_MS; exports.CACHE_MAX_ENTRIES = CACHE_MAX_ENTRIES; exports.SUGGEST_DEBOUNCE_MS = SUGGEST_DEBOUNCE_MS; exports.SUGGEST_MIN_CHARS = SUGGEST_MIN_CHARS; exports.INDEXING_REVALIDATE_MS = INDEXING_REVALIDATE_MS; exports.CACHE_TAG = CACHE_TAG; exports.TAG_MAX_CHARS = TAG_MAX_CHARS; exports.DEFAULT_REVALIDATE_S = DEFAULT_REVALIDATE_S; exports.LIST_PAGE_SIZE = LIST_PAGE_SIZE; exports.LIST_MAX_HANDLES = LIST_MAX_HANDLES; exports.CATEGORY_TREE_MAX_DEPTH = CATEGORY_TREE_MAX_DEPTH; exports.createCatalogClient = createCatalogClient;
+
+
+
+
+
+
+
+
+
+
+
+exports.SDK_VERSION = SDK_VERSION; exports.CatalogError = CatalogError; exports.RateLimitedError = RateLimitedError; exports.OriginNotAllowedError = OriginNotAllowedError; exports.CustomerTokenInvalidError = CustomerTokenInvalidError; exports.CartLineError = CartLineError; exports.TimeoutError = TimeoutError; exports.NetworkError = NetworkError; exports.FeatureUnavailableError = FeatureUnavailableError; exports.isCatalogError = isCatalogError; exports.DEFAULT_BASE_URL = DEFAULT_BASE_URL; exports.THROTTLE_CHECKOUT_URL = THROTTLE_CHECKOUT_URL; exports.RATE_LIMIT_DEFAULT_RETRY_S = RATE_LIMIT_DEFAULT_RETRY_S; exports.STALE_MS = STALE_MS; exports.CACHE_MAX_ENTRIES = CACHE_MAX_ENTRIES; exports.SUGGEST_DEBOUNCE_MS = SUGGEST_DEBOUNCE_MS; exports.SUGGEST_MIN_CHARS = SUGGEST_MIN_CHARS; exports.INDEXING_REVALIDATE_MS = INDEXING_REVALIDATE_MS; exports.CACHE_TAG = CACHE_TAG; exports.TAG_MAX_CHARS = TAG_MAX_CHARS; exports.DEFAULT_REVALIDATE_S = DEFAULT_REVALIDATE_S; exports.LIST_PAGE_SIZE = LIST_PAGE_SIZE; exports.LIST_MAX_HANDLES = LIST_MAX_HANDLES; exports.CATEGORY_TREE_MAX_DEPTH = CATEGORY_TREE_MAX_DEPTH; exports.createCatalogClient = createCatalogClient; exports.money = money; exports.CURRENCIES = _money.CURRENCIES; exports.UnknownCurrencyError = _money.UnknownCurrencyError; exports.currencySymbol = _money.currencySymbol; exports.formatMoney = _money.formatMoney; exports.isKnownCurrency = _money.isKnownCurrency; exports.minorUnitsOf = _money.minorUnitsOf; exports.moneyValue = _money.moneyValue; exports.parseMoney = _money.parseMoney; exports.toDecimalString = _money.toDecimalString; exports.toMinor = _money.toMinor;

package/dist/{chunk-55G4ZTD5.js → chunk-3DLH56OX.js}

@@ -3,7 +3,22 @@ import {
 } from "./chunk-PKBMQBKP.js";
 
 // src/version.ts
-var SDK_VERSION = true ? "1.2.0" : "0.0.0-dev";
+var SDK_VERSION = true ? "1.3.0" : "0.0.0-dev";
+
+// src/index.ts
+import * as money from "@usethrottle/money";
+import {
+  CURRENCIES,
+  UnknownCurrencyError,
+  currencySymbol,
+  formatMoney,
+  isKnownCurrency,
+  minorUnitsOf,
+  moneyValue,
+  parseMoney,
+  toDecimalString,
+  toMinor
+} from "@usethrottle/money";
 
 // src/errors/catalog-error.ts
 import { ThrottleError } from "@usethrottle/errors";
@@ -190,6 +205,8 @@ var ERROR_KINDS = Object.freeze({
   cart_session_not_found: "base",
   origin_not_allowed: "origin",
   checkout_unavailable: "base",
+  cart_owner_mismatch: "base",
+  cart_resolver_mismatch: "base",
   // Client codes.
   TIMEOUT: "timeout",
   NETWORK_ERROR: "network",
@@ -731,6 +748,9 @@ function createTransport(o) {
 function createCartSession(options, sessionId, throttleBaseUrl) {
   const base = (throttleBaseUrl ?? THROTTLE_API_URL).replace(/\/+$/u, "");
   async function call(method, tail, body, opts, accept) {
+    return (await exchange(method, tail, body, opts, accept)).data;
+  }
+  async function exchange(method, tail, body, opts, accept) {
     const signal = opts?.signal;
     if (signal?.aborted) throw signal.reason;
     const timeoutMs = opts?.timeoutMs === void 0 ? options.timeoutMs : checkTimeout(opts.timeoutMs);
@@ -768,7 +788,10 @@ function createCartSession(options, sessionId, throttleBaseUrl) {
           retryable: false
         });
       }
-      return data;
+      return {
+        data,
+        meta: parsed.meta
+      };
     }
     throw toCatalogError(mapInput);
   }
@@ -811,6 +834,27 @@ function createCartSession(options, sessionId, throttleBaseUrl) {
         opts,
         (data) => isHttpUrl(data.checkoutUrl)
       );
+    },
+    absorb: async (fromSessionId, opts) => {
+      const { data, meta } = await exchange(
+        "POST",
+        () => "/absorb",
+        { fromSessionId },
+        opts
+      );
+      if (typeof data.cart !== "object" || data.cart === null)
+        throw new CatalogError({
+          code: "INVALID_RESPONSE",
+          message: "Throttle answered an absorb without a cart.",
+          statusCode: 200,
+          source: "throttle",
+          retryable: false
+        });
+      const warnings = meta?.warnings;
+      return {
+        cart: data.cart,
+        warnings: Array.isArray(warnings) ? warnings : []
+      };
     }
   };
 }
@@ -1208,5 +1252,16 @@ export {
   LIST_PAGE_SIZE,
   LIST_MAX_HANDLES,
   CATEGORY_TREE_MAX_DEPTH,
-  createCatalogClient
+  createCatalogClient,
+  money,
+  CURRENCIES,
+  UnknownCurrencyError,
+  currencySymbol,
+  formatMoney,
+  isKnownCurrency,
+  minorUnitsOf,
+  moneyValue,
+  parseMoney,
+  toDecimalString,
+  toMinor
 };