@usethrottle/cart 2.0.0 → 3.0.1

package/README.md

@@ -74,7 +74,7 @@ External stores can also request read-only storefront quotes with a publishable
 import { StorefrontQuoteClient } from '@usethrottle/cart';
 
 const quotes = new StorefrontQuoteClient({
-  storeId: 'store_uuid',
+  applicationId: 'application_uuid',
   quoteToken: 'pk_publishable_quote_token',
 });
 
@@ -170,14 +170,14 @@ try {
 
 ## Client options
 
-| Option | Default | Description |
-|---|---|---|
-| `apiKey` | — | **Required.** Your Throttle secret key (`sk_…`). |
-| `baseUrl` | `https://throttle-api-gff1.onrender.com` | Override for local dev or staging. |
-| `timeoutMs` | `30000` | Per-request abort timeout in ms. |
-| `fetch` | `globalThis.fetch` | Custom fetch implementation (e.g. `node-fetch`). |
+| Option      | Default                       | Description                                                 |
+| ----------- | ----------------------------- | ----------------------------------------------------------- |
+| `apiKey`    | —                             | **Required.** Your Throttle secret key (`sk_…`).            |
+| `baseUrl`   | `https://api.usethrottle.dev` | Optional override for a dedicated Throttle API environment. |
+| `timeoutMs` | `30000`                       | Per-request abort timeout in ms.                            |
+| `fetch`     | `globalThis.fetch`            | Custom fetch implementation (e.g. `node-fetch`).            |
 
 ## See also
 
-- [API client (auto-generated): `@usethrottle/api-client`](https://www.npmjs.com/package/@usethrottle/api-client)
+- [Checkout SDK: `@usethrottle/checkout-sdk`](https://www.npmjs.com/package/@usethrottle/checkout-sdk)
 - [React embed components: `@usethrottle/checkout-react`](https://www.npmjs.com/package/@usethrottle/checkout-react)

package/dist/index.cjs

@@ -133,18 +133,19 @@ var CartClient = class {
 
 // src/storefront.ts
 var StorefrontQuoteClient = class {
-  storeId;
+  applicationId;
   quoteToken;
   baseUrl;
   fetchImpl;
   timeoutMs;
   origin;
   constructor(opts) {
-    if (!opts.storeId) throw new Error("StorefrontQuoteClient: storeId is required");
+    const applicationId = opts.applicationId ?? opts.storeId;
+    if (!applicationId) throw new Error("StorefrontQuoteClient: applicationId is required");
     if (!opts.quoteToken?.startsWith("pk_")) {
       throw new Error("StorefrontQuoteClient: quoteToken must be a publishable pk_ token");
     }
-    this.storeId = opts.storeId;
+    this.applicationId = applicationId;
     this.quoteToken = opts.quoteToken;
     this.baseUrl = (opts.baseUrl ?? "https://api.usethrottle.dev").replace(/\/+$/, "");
     this.fetchImpl = opts.fetch ?? globalThis.fetch;
@@ -161,7 +162,7 @@ var StorefrontQuoteClient = class {
         method: "POST",
         headers,
         body: JSON.stringify({
-          storeId: this.storeId,
+          applicationId: this.applicationId,
           quoteToken: this.quoteToken,
           ...input
         }),

package/dist/index.d.cts

@@ -338,7 +338,10 @@ declare class CartClient {
 }
 
 interface StorefrontQuoteClientOptions {
-    storeId: string;
+    /** Current API contract: the application/store UUID that owns the quote config. */
+    applicationId?: string;
+    /** @deprecated Use applicationId. Kept as an alias for older storefronts. */
+    storeId?: string;
     quoteToken: string;
     baseUrl?: string;
     fetch?: typeof globalThis.fetch;
@@ -346,7 +349,7 @@ interface StorefrontQuoteClientOptions {
     origin?: string;
 }
 declare class StorefrontQuoteClient {
-    private readonly storeId;
+    private readonly applicationId;
     private readonly quoteToken;
     private readonly baseUrl;
     private readonly fetchImpl;

package/dist/index.d.ts

@@ -338,7 +338,10 @@ declare class CartClient {
 }
 
 interface StorefrontQuoteClientOptions {
-    storeId: string;
+    /** Current API contract: the application/store UUID that owns the quote config. */
+    applicationId?: string;
+    /** @deprecated Use applicationId. Kept as an alias for older storefronts. */
+    storeId?: string;
     quoteToken: string;
     baseUrl?: string;
     fetch?: typeof globalThis.fetch;
@@ -346,7 +349,7 @@ interface StorefrontQuoteClientOptions {
     origin?: string;
 }
 declare class StorefrontQuoteClient {
-    private readonly storeId;
+    private readonly applicationId;
     private readonly quoteToken;
     private readonly baseUrl;
     private readonly fetchImpl;

package/dist/index.js

@@ -105,18 +105,19 @@ var CartClient = class {
 
 // src/storefront.ts
 var StorefrontQuoteClient = class {
-  storeId;
+  applicationId;
   quoteToken;
   baseUrl;
   fetchImpl;
   timeoutMs;
   origin;
   constructor(opts) {
-    if (!opts.storeId) throw new Error("StorefrontQuoteClient: storeId is required");
+    const applicationId = opts.applicationId ?? opts.storeId;
+    if (!applicationId) throw new Error("StorefrontQuoteClient: applicationId is required");
     if (!opts.quoteToken?.startsWith("pk_")) {
       throw new Error("StorefrontQuoteClient: quoteToken must be a publishable pk_ token");
     }
-    this.storeId = opts.storeId;
+    this.applicationId = applicationId;
     this.quoteToken = opts.quoteToken;
     this.baseUrl = (opts.baseUrl ?? "https://api.usethrottle.dev").replace(/\/+$/, "");
     this.fetchImpl = opts.fetch ?? globalThis.fetch;
@@ -133,7 +134,7 @@ var StorefrontQuoteClient = class {
         method: "POST",
         headers,
         body: JSON.stringify({
-          storeId: this.storeId,
+          applicationId: this.applicationId,
           quoteToken: this.quoteToken,
           ...input
         }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/cart",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "Typed REST client for the Throttle Cart API.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -13,12 +13,10 @@
       "require": "./dist/index.cjs"
     }
   },
-  "files": ["dist", "README.md"],
-  "scripts": {
-    "build": "tsup",
-    "test": "vitest run",
-    "typecheck": "tsc --noEmit"
-  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "devDependencies": {
     "tsup": "^8.0.0",
     "vitest": "^2.1.9",
@@ -26,5 +24,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
-}
+}