@usethrottle/checkout-react 2.1.0 → 2.2.0

package/README.md

@@ -132,9 +132,12 @@ export function MyEmbed({ sessionId }: { sessionId: string }) {
 Own a Throttle cart directly from the browser — no backend, no secret key. The
 hook wraps `@usethrottle/cart`'s `CartSessionClient`: it creates the cart lazily
 on the first `addItem`, persists the session id to `localStorage`, resumes it on
-the next visit, and exposes reactive `cart` state. Authorize with a publishable
-`pk_` quote token + your application's origin allowlist (set origins via
-`PUT /api/v1/embed-config`).
+the next visit, and exposes reactive `cart` state. Authorize with a storefront quote
+token (`qt_…`, from the dashboard Shipping & Tax page or
+`POST /api/v1/shipping-tax/quote-tokens`) + your application's origin allowlist
+(set origins via `PUT /api/v1/embed-config`). Quote tokens minted before `qt_`
+start with `pk_` and keep working. A `pk_` publishable API key is a different
+credential and is refused with `401 invalid_quote_token`.
 
 ```tsx
 import { useCartSession } from '@usethrottle/checkout-react';
@@ -143,7 +146,7 @@ function Cart() {
   const cart = useCartSession({
     applicationId: '7f9d4c8a-5b2e-4f16-9a73-2d1e5c8b6f40',
     environmentId: 'a1b2c3d4-...',
-    quoteToken: 'pk_live_...',
+    quoteToken: 'qt_...',
   });
 
   return (
@@ -203,6 +206,13 @@ The callback shape changed in v0.2: `onCompleted(orderId, paymentId)`
 is now `onSucceeded({orderId, paymentId})` and `onError(code, message)`
 is now `onFailed({code, message})`. Update call sites accordingly.
 
+## 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. For analytics, use `toDecimalString(amount, currency)`, never `/ 100`.
+
 ## See also
 
 - [CLI: `throttle embed-config`](https://www.npmjs.com/package/@usethrottle/cli)