@usethrottle/cart 3.1.0 → 3.2.0

package/README.md

@@ -1,3 +1,8 @@
+<p align="left">
+  <img src="https://raw.githubusercontent.com/Epic-Design-Labs/app-throttle/main/packages/brand/assets/throttle-logo.png" alt="Throttle" height="56" />
+</p>
+
+
 # @usethrottle/cart
 
 Typed Node.js REST client for the Throttle Cart API.
@@ -19,7 +24,7 @@ const client = new CartClient({ apiKey: process.env.THROTTLE_API_KEY! });
 
 // 1. Create a cart
 const cart = await client.carts.create({
-  storeId: 'store_abc',
+  applicationId: '7f9d4c8a-5b2e-4f16-9a73-2d1e5c8b6f40',
   currency: 'USD',
   netN: 45,
 });
@@ -52,8 +57,8 @@ const order = await client.carts.checkout(cart.id, { paymentMethod: 'card' });
 console.log(order.id, order.status);
 ```
 
-`applicationId` is accepted as an alias for `storeId` when your integration
-already uses the newer application naming.
+Use applicationId for every public request body. Deprecated store identifiers
+are rejected by the API.
 
 All monetary values are integers in the smallest currency unit (cents for USD).
 
@@ -95,7 +100,7 @@ External stores can also request read-only storefront quotes with a publishable
 import { StorefrontQuoteClient } from '@usethrottle/cart';
 
 const quotes = new StorefrontQuoteClient({
-  applicationId: 'application_uuid',
+  applicationId: '7f9d4c8a-5b2e-4f16-9a73-2d1e5c8b6f40',
   quoteToken: 'pk_publishable_quote_token',
 });
 
@@ -123,7 +128,7 @@ when at least one axis is in `byo` mode:
 
 ```ts
 await client.shippingTax.pushExternalSnapshot({
-  storeId: 'store_uuid',
+  applicationId: '7f9d4c8a-5b2e-4f16-9a73-2d1e5c8b6f40',
   cartId: cart.id,
   currency: 'USD',
   totals: {

package/dist/index.cjs

@@ -41,6 +41,9 @@ var ThrottleApiError = class extends Error {
 };
 
 // src/client.ts
+function segment(value) {
+  return encodeURIComponent(value);
+}
 var CartClient = class {
   apiKey;
   baseUrl;
@@ -81,40 +84,44 @@ var CartClient = class {
   get carts() {
     return {
       create: (input) => this.request("POST", "/api/v1/carts", input),
-      get: (id) => this.request("GET", `/api/v1/carts/${id}`),
-      update: (id, input) => this.request("PATCH", `/api/v1/carts/${id}`, input),
-      checkout: (id, input) => this.request("POST", `/api/v1/carts/${id}/checkout`, input ?? {}),
-      merge: (id, customerId) => this.request("POST", `/api/v1/carts/${id}/merge`, { customerId })
+      get: (id) => this.request("GET", `/api/v1/carts/${segment(id)}`),
+      update: (id, input) => this.request("PATCH", `/api/v1/carts/${segment(id)}`, input),
+      checkout: (id, input) => this.request("POST", `/api/v1/carts/${segment(id)}/checkout`, input ?? {}),
+      merge: (id, customerId) => this.request("POST", `/api/v1/carts/${segment(id)}/merge`, { customerId })
     };
   }
   get items() {
     return {
-      add: (cartId, input) => this.request("POST", `/api/v1/carts/${cartId}/items`, input),
-      update: (cartId, itemId, input) => this.request("PATCH", `/api/v1/carts/${cartId}/items/${itemId}`, input),
-      remove: (cartId, itemId) => this.request("DELETE", `/api/v1/carts/${cartId}/items/${itemId}`)
+      add: (cartId, input) => this.request("POST", `/api/v1/carts/${segment(cartId)}/items`, input),
+      update: (cartId, itemId, input) => this.request("PATCH", `/api/v1/carts/${segment(cartId)}/items/${segment(itemId)}`, input),
+      remove: (cartId, itemId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/items/${segment(itemId)}`)
     };
   }
   get shipping() {
     return {
-      select: (cartId, input) => this.request("POST", `/api/v1/carts/${cartId}/shipping`, input),
-      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${cartId}/shipping`)
+      select: (cartId, input) => this.request("POST", `/api/v1/carts/${segment(cartId)}/shipping`, input),
+      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/shipping`)
     };
   }
   get discounts() {
     return {
-      apply: (cartId, code) => this.request("POST", `/api/v1/carts/${cartId}/apply-discount`, { code }),
-      remove: (cartId) => this.request("DELETE", `/api/v1/carts/${cartId}/discount`)
+      apply: (cartId, code) => this.request("POST", `/api/v1/carts/${segment(cartId)}/apply-discount`, { code }),
+      remove: (cartId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/discount`)
     };
   }
   get taxLines() {
     return {
-      set: (cartId, lines) => this.request("PUT", `/api/v1/carts/${cartId}/tax-lines`, { lines }),
-      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${cartId}/tax-lines`)
+      set: (cartId, lines) => this.request("PUT", `/api/v1/carts/${segment(cartId)}/tax-lines`, { lines }),
+      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/tax-lines`)
     };
   }
   get shippingTax() {
     return {
-      calculateCart: (cartId, input = {}) => this.request("POST", `/api/v1/shipping-tax/carts/${cartId}/calculate`, input),
+      calculateCart: (cartId, input = {}) => this.request(
+        "POST",
+        `/api/v1/shipping-tax/carts/${segment(cartId)}/calculate`,
+        input
+      ),
       pushExternalSnapshot: (input) => this.request("POST", "/api/v1/shipping-tax/external-snapshots", input)
     };
   }
@@ -125,7 +132,7 @@ var CartClient = class {
         if (opts?.sinceSequence !== void 0) params.set("sinceSequence", String(opts.sinceSequence));
         if (opts?.limit !== void 0) params.set("limit", String(opts.limit));
         const qs = params.toString();
-        return this.request("GET", `/api/v1/carts/${cartId}/events${qs ? "?" + qs : ""}`);
+        return this.request("GET", `/api/v1/carts/${segment(cartId)}/events${qs ? "?" + qs : ""}`);
       }
     };
   }
@@ -140,12 +147,11 @@ var StorefrontQuoteClient = class {
   timeoutMs;
   origin;
   constructor(opts) {
-    const applicationId = opts.applicationId ?? opts.storeId;
-    if (!applicationId) throw new Error("StorefrontQuoteClient: applicationId is required");
+    if (!opts.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.applicationId = applicationId;
+    this.applicationId = opts.applicationId;
     this.quoteToken = opts.quoteToken;
     this.baseUrl = (opts.baseUrl ?? "https://api.usethrottle.dev").replace(/\/+$/, "");
     this.fetchImpl = opts.fetch ?? globalThis.fetch;
@@ -162,9 +168,9 @@ var StorefrontQuoteClient = class {
         method: "POST",
         headers,
         body: JSON.stringify({
+          ...input,
           applicationId: this.applicationId,
-          quoteToken: this.quoteToken,
-          ...input
+          quoteToken: this.quoteToken
         }),
         signal: ctrl.signal
       });

package/dist/index.d.cts

@@ -1,8 +1,7 @@
 interface Cart {
     id: string;
-    merchantId: string;
+    workspaceId: string;
     applicationId: string;
-    storeId: string | null;
     customerId: string | null;
     status: 'open' | 'checkout' | 'converted' | 'abandoned';
     currency: string;
@@ -88,19 +87,13 @@ interface CartEvent {
     actorId: string | null;
     createdAt: string;
 }
-type CartApplicationRef = {
-    storeId: string;
-    applicationId?: string;
-} | {
+interface CreateCartInput {
     applicationId: string;
-    storeId?: string;
-};
-type CreateCartInput = CartApplicationRef & {
     customerId?: string;
     currency?: string;
     netN?: number | null;
     metadata?: Record<string, unknown>;
-};
+}
 interface UpdateCartInput {
     customerId?: string;
     billingAddress?: Record<string, unknown>;
@@ -224,8 +217,8 @@ interface ShippingTaxCalculationResponse {
     kind: 'quote' | 'cart_estimate' | 'checkout_final' | 'external_snapshot';
     status: 'estimated' | 'final' | 'failed';
     source: 'off' | 'byo' | 'calculated' | 'app_based' | 'external_push';
-    storeId: string;
-    merchantId?: string;
+    applicationId: string;
+    workspaceId?: string;
     currency: string;
     configId?: string;
     configVersion?: number;
@@ -287,7 +280,7 @@ interface ShippingTaxCalculationResponse {
     }>;
 }
 interface ExternalShippingTaxSnapshotInput {
-    storeId: string;
+    applicationId: string;
     cartId?: string | null;
     checkoutSessionId?: string | null;
     orderId?: string | null;
@@ -348,10 +341,7 @@ declare class CartClient {
 }
 
 interface StorefrontQuoteClientOptions {
-    /** 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;
+    applicationId: string;
     quoteToken: string;
     baseUrl?: string;
     fetch?: typeof globalThis.fetch;

package/dist/index.d.ts

@@ -1,8 +1,7 @@
 interface Cart {
     id: string;
-    merchantId: string;
+    workspaceId: string;
     applicationId: string;
-    storeId: string | null;
     customerId: string | null;
     status: 'open' | 'checkout' | 'converted' | 'abandoned';
     currency: string;
@@ -88,19 +87,13 @@ interface CartEvent {
     actorId: string | null;
     createdAt: string;
 }
-type CartApplicationRef = {
-    storeId: string;
-    applicationId?: string;
-} | {
+interface CreateCartInput {
     applicationId: string;
-    storeId?: string;
-};
-type CreateCartInput = CartApplicationRef & {
     customerId?: string;
     currency?: string;
     netN?: number | null;
     metadata?: Record<string, unknown>;
-};
+}
 interface UpdateCartInput {
     customerId?: string;
     billingAddress?: Record<string, unknown>;
@@ -224,8 +217,8 @@ interface ShippingTaxCalculationResponse {
     kind: 'quote' | 'cart_estimate' | 'checkout_final' | 'external_snapshot';
     status: 'estimated' | 'final' | 'failed';
     source: 'off' | 'byo' | 'calculated' | 'app_based' | 'external_push';
-    storeId: string;
-    merchantId?: string;
+    applicationId: string;
+    workspaceId?: string;
     currency: string;
     configId?: string;
     configVersion?: number;
@@ -287,7 +280,7 @@ interface ShippingTaxCalculationResponse {
     }>;
 }
 interface ExternalShippingTaxSnapshotInput {
-    storeId: string;
+    applicationId: string;
     cartId?: string | null;
     checkoutSessionId?: string | null;
     orderId?: string | null;
@@ -348,10 +341,7 @@ declare class CartClient {
 }
 
 interface StorefrontQuoteClientOptions {
-    /** 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;
+    applicationId: string;
     quoteToken: string;
     baseUrl?: string;
     fetch?: typeof globalThis.fetch;

package/dist/index.js

@@ -13,6 +13,9 @@ var ThrottleApiError = class extends Error {
 };
 
 // src/client.ts
+function segment(value) {
+  return encodeURIComponent(value);
+}
 var CartClient = class {
   apiKey;
   baseUrl;
@@ -53,40 +56,44 @@ var CartClient = class {
   get carts() {
     return {
       create: (input) => this.request("POST", "/api/v1/carts", input),
-      get: (id) => this.request("GET", `/api/v1/carts/${id}`),
-      update: (id, input) => this.request("PATCH", `/api/v1/carts/${id}`, input),
-      checkout: (id, input) => this.request("POST", `/api/v1/carts/${id}/checkout`, input ?? {}),
-      merge: (id, customerId) => this.request("POST", `/api/v1/carts/${id}/merge`, { customerId })
+      get: (id) => this.request("GET", `/api/v1/carts/${segment(id)}`),
+      update: (id, input) => this.request("PATCH", `/api/v1/carts/${segment(id)}`, input),
+      checkout: (id, input) => this.request("POST", `/api/v1/carts/${segment(id)}/checkout`, input ?? {}),
+      merge: (id, customerId) => this.request("POST", `/api/v1/carts/${segment(id)}/merge`, { customerId })
     };
   }
   get items() {
     return {
-      add: (cartId, input) => this.request("POST", `/api/v1/carts/${cartId}/items`, input),
-      update: (cartId, itemId, input) => this.request("PATCH", `/api/v1/carts/${cartId}/items/${itemId}`, input),
-      remove: (cartId, itemId) => this.request("DELETE", `/api/v1/carts/${cartId}/items/${itemId}`)
+      add: (cartId, input) => this.request("POST", `/api/v1/carts/${segment(cartId)}/items`, input),
+      update: (cartId, itemId, input) => this.request("PATCH", `/api/v1/carts/${segment(cartId)}/items/${segment(itemId)}`, input),
+      remove: (cartId, itemId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/items/${segment(itemId)}`)
     };
   }
   get shipping() {
     return {
-      select: (cartId, input) => this.request("POST", `/api/v1/carts/${cartId}/shipping`, input),
-      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${cartId}/shipping`)
+      select: (cartId, input) => this.request("POST", `/api/v1/carts/${segment(cartId)}/shipping`, input),
+      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/shipping`)
     };
   }
   get discounts() {
     return {
-      apply: (cartId, code) => this.request("POST", `/api/v1/carts/${cartId}/apply-discount`, { code }),
-      remove: (cartId) => this.request("DELETE", `/api/v1/carts/${cartId}/discount`)
+      apply: (cartId, code) => this.request("POST", `/api/v1/carts/${segment(cartId)}/apply-discount`, { code }),
+      remove: (cartId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/discount`)
     };
   }
   get taxLines() {
     return {
-      set: (cartId, lines) => this.request("PUT", `/api/v1/carts/${cartId}/tax-lines`, { lines }),
-      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${cartId}/tax-lines`)
+      set: (cartId, lines) => this.request("PUT", `/api/v1/carts/${segment(cartId)}/tax-lines`, { lines }),
+      clear: (cartId) => this.request("DELETE", `/api/v1/carts/${segment(cartId)}/tax-lines`)
     };
   }
   get shippingTax() {
     return {
-      calculateCart: (cartId, input = {}) => this.request("POST", `/api/v1/shipping-tax/carts/${cartId}/calculate`, input),
+      calculateCart: (cartId, input = {}) => this.request(
+        "POST",
+        `/api/v1/shipping-tax/carts/${segment(cartId)}/calculate`,
+        input
+      ),
       pushExternalSnapshot: (input) => this.request("POST", "/api/v1/shipping-tax/external-snapshots", input)
     };
   }
@@ -97,7 +104,7 @@ var CartClient = class {
         if (opts?.sinceSequence !== void 0) params.set("sinceSequence", String(opts.sinceSequence));
         if (opts?.limit !== void 0) params.set("limit", String(opts.limit));
         const qs = params.toString();
-        return this.request("GET", `/api/v1/carts/${cartId}/events${qs ? "?" + qs : ""}`);
+        return this.request("GET", `/api/v1/carts/${segment(cartId)}/events${qs ? "?" + qs : ""}`);
       }
     };
   }
@@ -112,12 +119,11 @@ var StorefrontQuoteClient = class {
   timeoutMs;
   origin;
   constructor(opts) {
-    const applicationId = opts.applicationId ?? opts.storeId;
-    if (!applicationId) throw new Error("StorefrontQuoteClient: applicationId is required");
+    if (!opts.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.applicationId = applicationId;
+    this.applicationId = opts.applicationId;
     this.quoteToken = opts.quoteToken;
     this.baseUrl = (opts.baseUrl ?? "https://api.usethrottle.dev").replace(/\/+$/, "");
     this.fetchImpl = opts.fetch ?? globalThis.fetch;
@@ -134,9 +140,9 @@ var StorefrontQuoteClient = class {
         method: "POST",
         headers,
         body: JSON.stringify({
+          ...input,
           applicationId: this.applicationId,
-          quoteToken: this.quoteToken,
-          ...input
+          quoteToken: this.quoteToken
         }),
         signal: ctrl.signal
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usethrottle/cart",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Typed REST client for the Throttle Cart API.",
   "type": "module",
   "main": "./dist/index.cjs",