@behindthescenes/cart 0.0.3

package/README.md

@@ -0,0 +1,413 @@
+# `@behindthescenes/cart`
+
+Browser SDK for BTS external-site cart state and checkout-link handoff. Use it to persist selected products, validate availability with the BTS API, and send shoppers to static or dynamic BTS checkout links.
+
+## Overview
+
+The BTS Cart SDK provides:
+
+- **Persistent cart state** - Selected products and quantities are stored in browser `localStorage` by default.
+- **Dynamic checkout links** - Generates BTS `/c/:checkoutLinkId?cart=...` URLs from `{ lineItemId, quantity, discount }` cart items.
+- **Static checkout links** - Supports one-click static checkout links through the same SDK API.
+- **Multiple checkout links** - Configure named checkout links and choose which one to use at checkout.
+- **Site-key protection** - Cart URL generation is validated by the BTS website cart API using the same public site key and verified-domain model as `@behindthescenes/analytics`.
+- **Availability validation** - The API validates checkout link status, products/access tiers, requested quantity, and discounts before returning a checkout URL.
+
+## Installation
+
+### npm/yarn/pnpm/bun
+
+```bash
+npm install @behindthescenes/cart
+```
+
+```bash
+pnpm add @behindthescenes/cart
+```
+
+```bash
+yarn add @behindthescenes/cart
+```
+
+```bash
+bun add @behindthescenes/cart
+```
+
+### Browser Bundle (Hosted)
+
+```html
+<script type="module">
+  import { createBTSCart } from "https://behindthescenes.com/sdk/@behindthescenes/cart/latest/browser/browser.js";
+
+  window.btsCart = createBTSCart({
+    siteKey: "your-public-site-key",
+    checkoutLinks: {
+      tickets: {
+        checkoutLinkId: "your-checkout-link-id",
+        mode: "dynamic"
+      }
+    },
+    defaultCheckoutLinkKey: "tickets"
+  });
+</script>
+```
+
+## Quick Start
+
+```ts
+import { createBTSCart } from "@behindthescenes/cart";
+
+const cart = createBTSCart({
+  siteKey: "your-public-site-key",
+  checkoutLinks: {
+    tickets: {
+      checkoutLinkId: "https://dev.behindthescenes.com/c/1a9d4f91-c1dd-455d-aa4c-851b296aff75",
+      mode: "dynamic",
+    },
+  },
+  defaultCheckoutLinkKey: "tickets",
+});
+
+cart.addItem({
+  id: "garnet",
+  lineItemId: "2dd3b989-616e-4e2f-9c47-21e1288d3823",
+  checkoutLinkKey: "tickets",
+  name: "Garnet",
+  unitPrice: 395,
+  fullPrice: 550,
+  quantity: 1,
+  discount: "GARNET-EARLYBIRD",
+});
+
+await cart.checkout("tickets");
+```
+
+## Setup in BTS
+
+Before using the SDK, configure the destination site in BTS:
+
+1. In BTS, go to the relevant space.
+2. Configure the external website integration and copy the public site key.
+3. Verify the external site domain for production use.
+4. Create a checkout link.
+5. For dynamic checkout links, use either the checkout link ID or the full checkout link URL plus the relevant product/access-tier line item IDs.
+
+Local development can use localhost origins without verified-domain matching when the API runs in a local/development/test environment.
+
+## Dynamic Checkout Links
+
+Dynamic checkout links use the BTS checkout cart query parameter:
+
+```ts
+encodeURIComponent(
+  JSON.stringify([
+    {
+      lineItemId: "2dd3b989-616e-4e2f-9c47-21e1288d3823",
+      quantity: 1,
+      discount: "c16cfeea-c604-4009-851c-05e6dcdfbcea",
+    },
+  ]),
+);
+```
+
+The SDK sends that cart payload to the BTS API for validation and receives a final checkout URL. The returned URL is equivalent to:
+
+```text
+https://behindthescenes.com/c/<checkoutLinkId>?cart=<encoded-json>
+```
+
+For dynamic checkout links with no saved checkout-link line items, BTS resolves valid line items from the checkout link space’s public products and access tiers. In that case, `lineItemId` is the product ID or access tier ID.
+
+`discount` can be either the internal promo-code ID or the customer-facing promo code. The cart API resolves customer-facing codes to the internal IDs required by the BTS checkout page before returning the final URL.
+
+Checkout link config also accepts full BTS checkout URLs:
+
+```ts
+const cart = createBTSCart({
+  siteKey: "your-public-site-key",
+  checkoutLinks: {
+    tickets: {
+      checkoutLinkId: "https://behindthescenes.com/c/1a9d4f91-c1dd-455d-aa4c-851b296aff75?discountCode=EARLYBIRD",
+      mode: "dynamic",
+    },
+  },
+});
+```
+
+The SDK extracts the checkout link ID and default `discountCode` from the URL.
+
+## Static Checkout Links
+
+```ts
+const cart = createBTSCart({
+  siteKey: "your-public-site-key",
+  checkoutLinks: {
+    vip: {
+      checkoutLinkId: "static-checkout-link-id",
+      mode: "static",
+      discountCode: "VIP-EARLYBIRD",
+    },
+  },
+});
+
+await cart.checkout("vip");
+```
+
+Static links ignore cart items and validate the configured checkout link before redirecting.
+
+## Multiple Checkout Links
+
+```ts
+const cart = createBTSCart({
+  siteKey: "your-public-site-key",
+  checkoutLinks: {
+    tickets: {
+      checkoutLinkId: "dynamic-ticket-link-id",
+      mode: "dynamic",
+    },
+    merch: {
+      checkoutLinkId: "dynamic-merch-link-id",
+      mode: "dynamic",
+    },
+  },
+  defaultCheckoutLinkKey: "tickets",
+});
+
+cart.addItem({
+  id: "shirt",
+  lineItemId: "product-line-item-id",
+  checkoutLinkKey: "merch",
+  name: "Event Shirt",
+  unitPrice: 49,
+});
+
+await cart.checkout("merch");
+```
+
+## Persistence
+
+The SDK persists cart state to `localStorage` by default.
+
+```ts
+const cart = createBTSCart({
+  siteKey: "your-public-site-key",
+  storageKey: "my-site-cart",
+  persist: true,
+});
+```
+
+Disable persistence:
+
+```ts
+const cart = createBTSCart({
+  siteKey: "your-public-site-key",
+  persist: false,
+});
+```
+
+Provide a custom storage adapter:
+
+```ts
+const cart = createBTSCart({
+  siteKey: "your-public-site-key",
+  storage: {
+    getItem: (key) => sessionStorage.getItem(key),
+    setItem: (key, value) => sessionStorage.setItem(key, value),
+    removeItem: (key) => sessionStorage.removeItem(key),
+  },
+});
+```
+
+## State API
+
+```ts
+cart.addItem(item);
+cart.removeItem("garnet");
+cart.setQuantity("garnet", 2);
+cart.increment("garnet");
+cart.decrement("garnet");
+cart.clear();
+
+const items = cart.getItems();
+const itemCount = cart.getItemCount();
+const subtotal = cart.getSubtotal();
+const total = cart.getTotal();
+```
+
+Subscribe to changes:
+
+```ts
+const unsubscribe = cart.subscribe((state) => {
+  console.log(state.items);
+});
+
+unsubscribe();
+```
+
+## Checkout API
+
+Return a checkout URL without redirecting:
+
+```ts
+const url = await cart.resolveCheckoutUrl("tickets");
+```
+
+Validate and redirect:
+
+```ts
+await cart.checkout("tickets");
+```
+
+## React Integration
+
+```tsx
+import { createBTSCart, type BTSCart, type BTSCartItem } from "@behindthescenes/cart";
+import { createContext, useContext, useEffect, useMemo, useState } from "react";
+
+const CartContext = createContext<BTSCart | null>(null);
+
+export function CartProvider({ children }: { children: React.ReactNode }) {
+  const cart = useMemo(
+    () =>
+      createBTSCart({
+        siteKey: "your-public-site-key",
+        checkoutLinks: {
+          tickets: {
+            checkoutLinkId: "dynamic-ticket-link-id",
+            mode: "dynamic",
+          },
+        },
+        defaultCheckoutLinkKey: "tickets",
+      }),
+    [],
+  );
+
+  return <CartContext.Provider value={cart}>{children}</CartContext.Provider>;
+}
+
+export function useCartItems(): BTSCartItem[] {
+  const cart = useContext(CartContext);
+  if (!cart) throw new Error("useCartItems must be used inside CartProvider");
+
+  const [items, setItems] = useState(() => cart.getItems());
+
+  useEffect(() => cart.subscribe((state) => setItems(state.items)), [cart]);
+
+  return items;
+}
+```
+
+## Configuration
+
+```ts
+type BTSCartInit = {
+  siteKey: string;
+  endpoint?: string;
+  checkoutLinks?: Record<string, BTSCartCheckoutLinkConfig>;
+  defaultCheckoutLinkKey?: string;
+  debug?: boolean;
+  persist?: boolean;
+  storageKey?: string;
+  storage?: BTSCartStorage;
+  requestHeaders?: HeadersInit | ((request: BTSCartRequestContext) => HeadersInit | Promise<HeadersInit>);
+};
+```
+
+Defaults:
+
+- `endpoint`: `https://api.bts.it.com/v2/website/cart`
+- `persist`: `true`
+- `storageKey`: `bts-cart`
+- `defaultCheckoutLinkKey`: first configured checkout link key, or `default`
+
+## Browser Global API
+
+The hosted browser bundle installs:
+
+- `window.BTSCart`
+- `window.createBTSCart`
+- `window.btsCart`
+- `window.btsCartDataLayer`
+- `window.btsCartCommand`
+
+Queued command example:
+
+```html
+<script>
+  window.btsCartDataLayer = window.btsCartDataLayer || [];
+  function btsCartCommand(){window.btsCartDataLayer.push(arguments);}
+
+  btsCartCommand("config", {
+    siteKey: "your-public-site-key",
+    checkoutLinks: {
+      tickets: {
+        checkoutLinkId: "dynamic-ticket-link-id",
+        mode: "dynamic"
+      }
+    }
+  });
+</script>
+```
+
+## Development
+
+```bash
+bun install
+bun run type-check
+bun test
+bun run build
+```
+
+Build artifacts:
+
+- `dist/esm/index.js`
+- `dist/cjs/index.js`
+- `dist/browser/browser.js`
+- `dist/types/index.d.ts`
+- `dist/manifest.json`
+
+## Hosted Bundle
+
+Sync the hosted bundle into `apps/bts-web/public/sdk/@behindthescenes/cart`:
+
+```bash
+bun run build:hosted
+```
+
+Force a rebuild before syncing:
+
+```bash
+bun run build:hosted:force
+```
+
+Hosted layout matches `@behindthescenes/analytics`:
+
+- `latest`
+- one major-version directory, for example `0` or `1`
+
+## Release
+
+The cart SDK uses the same release pipeline as `@behindthescenes/analytics`.
+
+Manual release from GitHub Actions:
+
+1. Open **Cart SDK Release**.
+2. Choose `patch`, `minor`, or `major`.
+3. Run the workflow from `main`.
+
+The workflow:
+
+- installs dependencies with Bun
+- bumps the package version
+- runs `bun run release:check`
+- publishes with `npm publish --provenance --access public`
+- commits the version bump back to `main`
+
+Tag release:
+
+```bash
+git tag cart-sdk-v0.0.2
+git push origin cart-sdk-v0.0.2
+```
+
+The tag version is applied to `packages/cart/package.json` before publishing.

package/dist/browser/browser.js

@@ -0,0 +1 @@
+var R="https://api.bts.it.com/v2/website/cart",v="bts-cart",F="default",G=1;class S extends Error{code;status;constructor(C,w,f){super(w);this.name="BTSCartError",this.code=C,this.status=f}}function M(){return typeof window>"u"?null:window}function Y(){try{return M()?.localStorage}catch{return}}function Z(C){return(C??R).replace(/\/$/,"")}function _(C){if(!Number.isFinite(C??1))return 1;return Math.max(1,Math.floor(C??1))}function J(C){return{items:C.map((w)=>({...w}))}}function $(C,w){let f=new Headers(C);if(!w)return f;return new Headers(w).forEach((r,B)=>f.set(B,r)),f}function z(C){let w=C.checkoutLinkId.trim();try{let f=new URL(w.includes("://")?w:w.startsWith("/")?`https://behindthescenes.com${w}`:w),r=f.pathname.split("/").filter(Boolean),B=r.indexOf("c"),b=B>=0?r[B+1]:r.at(-1);if(b)return{checkoutLinkId:b,discountCode:C.discountCode??f.searchParams.get("discountCode")??void 0}}catch{}return{checkoutLinkId:w,discountCode:C.discountCode}}class T{siteKey;endpoint;debug;persist;storageKey;storage;checkoutLinks;defaultCheckoutLinkKey;requestHeaders;items=[];listeners=new Set;constructor(C){this.siteKey=C.siteKey,this.endpoint=Z(C.endpoint),this.debug=C.debug??!1,this.persist=C.persist??!0,this.storageKey=C.storageKey??v,this.storage=C.storage??Y(),this.checkoutLinks=C.checkoutLinks??{},this.defaultCheckoutLinkKey=C.defaultCheckoutLinkKey??Object.keys(this.checkoutLinks)[0]??F,this.requestHeaders=C.requestHeaders,this.rehydrate()}static init(C){return new T(C)}getItems(){return J(this.items).items}getState(){return J(this.items)}getItemCount(){return this.items.reduce((C,w)=>C+w.quantity,0)}getSubtotal(){return this.items.reduce((C,w)=>C+(w.fullPrice??w.unitPrice)*w.quantity,0)}getTotal(){return this.items.reduce((C,w)=>C+w.unitPrice*w.quantity,0)}subscribe(C){return this.listeners.add(C),C(this.getState()),()=>{this.listeners.delete(C)}}destroy(){this.listeners.clear()}rehydrate(){if(!this.persist||!this.storage)return;try{let C=this.storage.getItem(this.storageKey);if(!C)return;let w=JSON.parse(C),f=Array.isArray(w)?w:w.items;if(!Array.isArray(f))return;this.items=f.map((r)=>this.normalizeItem(r)).filter((r)=>Boolean(r)),this.emit()}catch(C){this.log("Failed to hydrate cart",C)}}addItem(C){let w=this.normalizeItem(C);if(!w)return;let f=this.items.find((r)=>r.id===w.id);if(f){this.setQuantity(f.id,f.quantity+w.quantity);return}this.items=[...this.items,w],this.commit()}removeItem(C){this.items=this.items.filter((w)=>w.id!==C),this.commit()}setQuantity(C,w){let f=Math.floor(w);this.items=f<=0?this.items.filter((r)=>r.id!==C):this.items.map((r)=>r.id===C?{...r,quantity:f}:r),this.commit()}increment(C,w=1){let f=this.items.find((r)=>r.id===C);if(f)this.setQuantity(C,f.quantity+Math.max(1,Math.floor(w)))}decrement(C,w=1){let f=this.items.find((r)=>r.id===C);if(f)this.setQuantity(C,f.quantity-Math.max(1,Math.floor(w)))}clear(){if(this.items=[],this.persist&&this.storage)try{this.storage.removeItem(this.storageKey)}catch(C){this.log("Failed to clear cart storage",C)}this.emit()}async resolveCheckoutUrl(C=this.defaultCheckoutLinkKey){let w=this.checkoutLinks[C];if(!w)throw new S("checkout_link_not_found",`Unknown checkout link key: ${C}`);let f=z(w),r=this.itemsForCheckout(C,w);return(await this.post("/checkout-url",{siteKey:this.siteKey,checkoutLinkId:f.checkoutLinkId,mode:w.mode,discountCode:f.discountCode,items:r})).checkoutUrl}async checkout(C=this.defaultCheckoutLinkKey){let w=await this.resolveCheckoutUrl(C),f=M();if(f)f.location.assign(w);return w}itemsForCheckout(C,w){if(w.mode==="static")return[];let f=this.items.filter((r)=>r.checkoutLinkKey===C).map((r)=>({lineItemId:r.lineItemId,quantity:r.quantity,...r.discount?{discount:r.discount}:{}}));if(f.length===0)throw new S("cart_empty","Your cart is empty.");return f}normalizeItem(C){if(!C.id||!C.lineItemId||!C.name||typeof C.unitPrice!=="number")return null;return{...C,id:C.id,lineItemId:C.lineItemId,checkoutLinkKey:C.checkoutLinkKey??this.defaultCheckoutLinkKey,name:C.name,unitPrice:C.unitPrice,quantity:_(C.quantity)}}async post(C,w){let f=`${this.endpoint}${C}`,r=JSON.stringify(w),B={"Content-Type":"application/json"},b={body:w,bodyText:r,endpoint:this.endpoint,headers:B,path:C,siteKey:this.siteKey,url:f},P=typeof this.requestHeaders==="function"?await this.requestHeaders(b):this.requestHeaders,U=$(B,P),D=await fetch(f,{method:"POST",headers:U,body:r}),A=await D.json().catch(()=>null);if(!D.ok){let V=typeof A==="object"&&A&&"code"in A?A.code:"request_failed",X=typeof A==="object"&&A&&"message"in A?A.message:"Cart request failed";throw new S(V??"request_failed",X??"Cart request failed",D.status)}return A}commit(){if(this.persist&&this.storage)try{let C={version:G,items:this.items};this.storage.setItem(this.storageKey,JSON.stringify(C))}catch(C){this.log("Failed to persist cart",C)}this.emit()}emit(){let C=this.getState();for(let w of this.listeners)w(C)}log(...C){if(this.debug)console.log("[@behindthescenes/cart]",...C)}}function I(C){return T.init(C)}function N(C){return typeof C==="object"&&C!==null&&!Array.isArray(C)}function O(C){let w=typeof window>"u"?null:window;if(!w)return;let[f,r,B]=C;if(typeof f!=="string")return;if(f==="config"){if(!N(r))return;w.btsCart?.destroy?.(),w.btsCart=I(r);return}let b=w.btsCart;if(!b)return;if(f==="add"&&N(r)){b.addItem(r);return}if(f==="remove"&&typeof r==="string"){b.removeItem(r);return}if(f==="quantity"&&typeof r==="string"&&typeof B==="number"){b.setQuantity(r,B);return}if(f==="clear"){b.clear();return}if(f==="checkout")b.checkout(typeof r==="string"?r:void 0)}if(typeof window<"u"){let C=Array.isArray(window.btsCartDataLayer)?[...window.btsCartDataLayer]:[];window.btsCartDataLayer=Array.isArray(window.btsCartDataLayer)?window.btsCartDataLayer:[],window.BTSCart={BTSCart:T,createBTSCart:I},window.createBTSCart=I;for(let w of C)O(Array.from(w));window.btsCartCommand=(...w)=>{window.btsCartDataLayer?.push(w),O(w)}}export{I as createBTSCart,T as BTSCart};

package/dist/cjs/index.js

@@ -0,0 +1 @@
+var{defineProperty:_,getOwnPropertyNames:H,getOwnPropertyDescriptor:b}=Object,q=Object.prototype.hasOwnProperty;function B(F){return this[F]}var I=(F)=>{var G=($??=new WeakMap).get(F),J;if(G)return G;if(G=_({},"__esModule",{value:!0}),F&&typeof F==="object"||typeof F==="function"){for(var M of H(F))if(!q.call(G,M))_(G,M,{get:B.bind(F,M),enumerable:!(J=b(F,M))||J.enumerable})}return $.set(F,G),G},$;var j=(F)=>F;function K(F,G){this[F]=j.bind(null,G)}var T=(F,G)=>{for(var J in G)_(F,J,{get:G[J],enumerable:!0,configurable:!0,set:K.bind(G,J)})};var g={};T(g,{createBTSCart:()=>f,BTSCartError:()=>V,BTSCart:()=>Y});module.exports=I(g);var A="https://api.bts.it.com/v2/website/cart",P="bts-cart",R="default",v=1;class V extends Error{code;status;constructor(F,G,J){super(G);this.name="BTSCartError",this.code=F,this.status=J}}function D(){return typeof window>"u"?null:window}function C(){try{return D()?.localStorage}catch{return}}function S(F){return(F??A).replace(/\/$/,"")}function w(F){if(!Number.isFinite(F??1))return 1;return Math.max(1,Math.floor(F??1))}function z(F){return{items:F.map((G)=>({...G}))}}function x(F,G){let J=new Headers(F);if(!G)return J;return new Headers(G).forEach((M,O)=>J.set(O,M)),J}function L(F){let G=F.checkoutLinkId.trim();try{let J=new URL(G.includes("://")?G:G.startsWith("/")?`https://behindthescenes.com${G}`:G),M=J.pathname.split("/").filter(Boolean),O=M.indexOf("c"),X=O>=0?M[O+1]:M.at(-1);if(X)return{checkoutLinkId:X,discountCode:F.discountCode??J.searchParams.get("discountCode")??void 0}}catch{}return{checkoutLinkId:G,discountCode:F.discountCode}}class Y{siteKey;endpoint;debug;persist;storageKey;storage;checkoutLinks;defaultCheckoutLinkKey;requestHeaders;items=[];listeners=new Set;constructor(F){this.siteKey=F.siteKey,this.endpoint=S(F.endpoint),this.debug=F.debug??!1,this.persist=F.persist??!0,this.storageKey=F.storageKey??P,this.storage=F.storage??C(),this.checkoutLinks=F.checkoutLinks??{},this.defaultCheckoutLinkKey=F.defaultCheckoutLinkKey??Object.keys(this.checkoutLinks)[0]??R,this.requestHeaders=F.requestHeaders,this.rehydrate()}static init(F){return new Y(F)}getItems(){return z(this.items).items}getState(){return z(this.items)}getItemCount(){return this.items.reduce((F,G)=>F+G.quantity,0)}getSubtotal(){return this.items.reduce((F,G)=>F+(G.fullPrice??G.unitPrice)*G.quantity,0)}getTotal(){return this.items.reduce((F,G)=>F+G.unitPrice*G.quantity,0)}subscribe(F){return this.listeners.add(F),F(this.getState()),()=>{this.listeners.delete(F)}}destroy(){this.listeners.clear()}rehydrate(){if(!this.persist||!this.storage)return;try{let F=this.storage.getItem(this.storageKey);if(!F)return;let G=JSON.parse(F),J=Array.isArray(G)?G:G.items;if(!Array.isArray(J))return;this.items=J.map((M)=>this.normalizeItem(M)).filter((M)=>Boolean(M)),this.emit()}catch(F){this.log("Failed to hydrate cart",F)}}addItem(F){let G=this.normalizeItem(F);if(!G)return;let J=this.items.find((M)=>M.id===G.id);if(J){this.setQuantity(J.id,J.quantity+G.quantity);return}this.items=[...this.items,G],this.commit()}removeItem(F){this.items=this.items.filter((G)=>G.id!==F),this.commit()}setQuantity(F,G){let J=Math.floor(G);this.items=J<=0?this.items.filter((M)=>M.id!==F):this.items.map((M)=>M.id===F?{...M,quantity:J}:M),this.commit()}increment(F,G=1){let J=this.items.find((M)=>M.id===F);if(J)this.setQuantity(F,J.quantity+Math.max(1,Math.floor(G)))}decrement(F,G=1){let J=this.items.find((M)=>M.id===F);if(J)this.setQuantity(F,J.quantity-Math.max(1,Math.floor(G)))}clear(){if(this.items=[],this.persist&&this.storage)try{this.storage.removeItem(this.storageKey)}catch(F){this.log("Failed to clear cart storage",F)}this.emit()}async resolveCheckoutUrl(F=this.defaultCheckoutLinkKey){let G=this.checkoutLinks[F];if(!G)throw new V("checkout_link_not_found",`Unknown checkout link key: ${F}`);let J=L(G),M=this.itemsForCheckout(F,G);return(await this.post("/checkout-url",{siteKey:this.siteKey,checkoutLinkId:J.checkoutLinkId,mode:G.mode,discountCode:J.discountCode,items:M})).checkoutUrl}async checkout(F=this.defaultCheckoutLinkKey){let G=await this.resolveCheckoutUrl(F),J=D();if(J)J.location.assign(G);return G}itemsForCheckout(F,G){if(G.mode==="static")return[];let J=this.items.filter((M)=>M.checkoutLinkKey===F).map((M)=>({lineItemId:M.lineItemId,quantity:M.quantity,...M.discount?{discount:M.discount}:{}}));if(J.length===0)throw new V("cart_empty","Your cart is empty.");return J}normalizeItem(F){if(!F.id||!F.lineItemId||!F.name||typeof F.unitPrice!=="number")return null;return{...F,id:F.id,lineItemId:F.lineItemId,checkoutLinkKey:F.checkoutLinkKey??this.defaultCheckoutLinkKey,name:F.name,unitPrice:F.unitPrice,quantity:w(F.quantity)}}async post(F,G){let J=`${this.endpoint}${F}`,M=JSON.stringify(G),O={"Content-Type":"application/json"},X={body:G,bodyText:M,endpoint:this.endpoint,headers:O,path:F,siteKey:this.siteKey,url:J},U=typeof this.requestHeaders==="function"?await this.requestHeaders(X):this.requestHeaders,W=x(O,U),Z=await fetch(J,{method:"POST",headers:W,body:M}),N=await Z.json().catch(()=>null);if(!Z.ok){let Q=typeof N==="object"&&N&&"code"in N?N.code:"request_failed",E=typeof N==="object"&&N&&"message"in N?N.message:"Cart request failed";throw new V(Q??"request_failed",E??"Cart request failed",Z.status)}return N}commit(){if(this.persist&&this.storage)try{let F={version:v,items:this.items};this.storage.setItem(this.storageKey,JSON.stringify(F))}catch(F){this.log("Failed to persist cart",F)}this.emit()}emit(){let F=this.getState();for(let G of this.listeners)G(F)}log(...F){if(this.debug)console.log("[@behindthescenes/cart]",...F)}}function f(F){return Y.init(F)}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/index.js

@@ -0,0 +1 @@
+var _="https://api.bts.it.com/v2/website/cart",$="bts-cart",A="default",P=1;class V extends Error{code;status;constructor(F,G,J){super(G);this.name="BTSCartError",this.code=F,this.status=J}}function v(){return typeof window>"u"?null:window}function Q(){try{return v()?.localStorage}catch{return}}function E(F){return(F??_).replace(/\/$/,"")}function H(F){if(!Number.isFinite(F??1))return 1;return Math.max(1,Math.floor(F??1))}function R(F){return{items:F.map((G)=>({...G}))}}function b(F,G){let J=new Headers(F);if(!G)return J;return new Headers(G).forEach((M,O)=>J.set(O,M)),J}function q(F){let G=F.checkoutLinkId.trim();try{let J=new URL(G.includes("://")?G:G.startsWith("/")?`https://behindthescenes.com${G}`:G),M=J.pathname.split("/").filter(Boolean),O=M.indexOf("c"),X=O>=0?M[O+1]:M.at(-1);if(X)return{checkoutLinkId:X,discountCode:F.discountCode??J.searchParams.get("discountCode")??void 0}}catch{}return{checkoutLinkId:G,discountCode:F.discountCode}}class Z{siteKey;endpoint;debug;persist;storageKey;storage;checkoutLinks;defaultCheckoutLinkKey;requestHeaders;items=[];listeners=new Set;constructor(F){this.siteKey=F.siteKey,this.endpoint=E(F.endpoint),this.debug=F.debug??!1,this.persist=F.persist??!0,this.storageKey=F.storageKey??$,this.storage=F.storage??Q(),this.checkoutLinks=F.checkoutLinks??{},this.defaultCheckoutLinkKey=F.defaultCheckoutLinkKey??Object.keys(this.checkoutLinks)[0]??A,this.requestHeaders=F.requestHeaders,this.rehydrate()}static init(F){return new Z(F)}getItems(){return R(this.items).items}getState(){return R(this.items)}getItemCount(){return this.items.reduce((F,G)=>F+G.quantity,0)}getSubtotal(){return this.items.reduce((F,G)=>F+(G.fullPrice??G.unitPrice)*G.quantity,0)}getTotal(){return this.items.reduce((F,G)=>F+G.unitPrice*G.quantity,0)}subscribe(F){return this.listeners.add(F),F(this.getState()),()=>{this.listeners.delete(F)}}destroy(){this.listeners.clear()}rehydrate(){if(!this.persist||!this.storage)return;try{let F=this.storage.getItem(this.storageKey);if(!F)return;let G=JSON.parse(F),J=Array.isArray(G)?G:G.items;if(!Array.isArray(J))return;this.items=J.map((M)=>this.normalizeItem(M)).filter((M)=>Boolean(M)),this.emit()}catch(F){this.log("Failed to hydrate cart",F)}}addItem(F){let G=this.normalizeItem(F);if(!G)return;let J=this.items.find((M)=>M.id===G.id);if(J){this.setQuantity(J.id,J.quantity+G.quantity);return}this.items=[...this.items,G],this.commit()}removeItem(F){this.items=this.items.filter((G)=>G.id!==F),this.commit()}setQuantity(F,G){let J=Math.floor(G);this.items=J<=0?this.items.filter((M)=>M.id!==F):this.items.map((M)=>M.id===F?{...M,quantity:J}:M),this.commit()}increment(F,G=1){let J=this.items.find((M)=>M.id===F);if(J)this.setQuantity(F,J.quantity+Math.max(1,Math.floor(G)))}decrement(F,G=1){let J=this.items.find((M)=>M.id===F);if(J)this.setQuantity(F,J.quantity-Math.max(1,Math.floor(G)))}clear(){if(this.items=[],this.persist&&this.storage)try{this.storage.removeItem(this.storageKey)}catch(F){this.log("Failed to clear cart storage",F)}this.emit()}async resolveCheckoutUrl(F=this.defaultCheckoutLinkKey){let G=this.checkoutLinks[F];if(!G)throw new V("checkout_link_not_found",`Unknown checkout link key: ${F}`);let J=q(G),M=this.itemsForCheckout(F,G);return(await this.post("/checkout-url",{siteKey:this.siteKey,checkoutLinkId:J.checkoutLinkId,mode:G.mode,discountCode:J.discountCode,items:M})).checkoutUrl}async checkout(F=this.defaultCheckoutLinkKey){let G=await this.resolveCheckoutUrl(F),J=v();if(J)J.location.assign(G);return G}itemsForCheckout(F,G){if(G.mode==="static")return[];let J=this.items.filter((M)=>M.checkoutLinkKey===F).map((M)=>({lineItemId:M.lineItemId,quantity:M.quantity,...M.discount?{discount:M.discount}:{}}));if(J.length===0)throw new V("cart_empty","Your cart is empty.");return J}normalizeItem(F){if(!F.id||!F.lineItemId||!F.name||typeof F.unitPrice!=="number")return null;return{...F,id:F.id,lineItemId:F.lineItemId,checkoutLinkKey:F.checkoutLinkKey??this.defaultCheckoutLinkKey,name:F.name,unitPrice:F.unitPrice,quantity:H(F.quantity)}}async post(F,G){let J=`${this.endpoint}${F}`,M=JSON.stringify(G),O={"Content-Type":"application/json"},X={body:G,bodyText:M,endpoint:this.endpoint,headers:O,path:F,siteKey:this.siteKey,url:J},z=typeof this.requestHeaders==="function"?await this.requestHeaders(X):this.requestHeaders,D=b(O,z),Y=await fetch(J,{method:"POST",headers:D,body:M}),N=await Y.json().catch(()=>null);if(!Y.ok){let U=typeof N==="object"&&N&&"code"in N?N.code:"request_failed",W=typeof N==="object"&&N&&"message"in N?N.message:"Cart request failed";throw new V(U??"request_failed",W??"Cart request failed",Y.status)}return N}commit(){if(this.persist&&this.storage)try{let F={version:P,items:this.items};this.storage.setItem(this.storageKey,JSON.stringify(F))}catch(F){this.log("Failed to persist cart",F)}this.emit()}emit(){let F=this.getState();for(let G of this.listeners)G(F)}log(...F){if(this.debug)console.log("[@behindthescenes/cart]",...F)}}function T(F){return Z.init(F)}export{T as createBTSCart,V as BTSCartError,Z as BTSCart};

package/dist/manifest.json

@@ -0,0 +1,11 @@
+{
+  "name": "@behindthescenes/cart",
+  "version": "0.0.3",
+  "generatedAt": "2026-05-14T11:25:11.511Z",
+  "artifacts": {
+    "browser": "browser/browser.js",
+    "cjs": "cjs/index.js",
+    "esm": "esm/index.js",
+    "types": "types/index.d.ts"
+  }
+}

package/dist/types/browser.d.ts

@@ -0,0 +1,3 @@
+import { BTSCart, createBTSCart } from "./index";
+export { BTSCart, createBTSCart };
+export type { BTSCartCheckoutItemPayload, BTSCartCheckoutLinkConfig, BTSCartCheckoutUrlRequest, BTSCartCheckoutUrlResult, BTSCartInit, BTSCartItem, BTSCartItemInput, BTSCartState, } from "./types/index.types";

package/dist/types/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_ENDPOINT = "https://api.bts.it.com/v2/website/cart";
+export declare const DEFAULT_STORAGE_KEY = "bts-cart";
+export declare const DEFAULT_CHECKOUT_LINK_KEY = "default";
+export declare const STORAGE_VERSION = 1;

package/dist/types/index.d.ts

@@ -0,0 +1,41 @@
+import type { BTSCartInit, BTSCartItem, BTSCartItemInput, BTSCartListener, BTSCartState } from "./types/index.types";
+export declare class BTSCart {
+    private siteKey;
+    private endpoint;
+    private debug;
+    private persist;
+    private storageKey;
+    private storage?;
+    private checkoutLinks;
+    private defaultCheckoutLinkKey;
+    private requestHeaders?;
+    private items;
+    private listeners;
+    constructor(init: BTSCartInit);
+    static init(opts: BTSCartInit): BTSCart;
+    getItems(): BTSCartItem[];
+    getState(): BTSCartState;
+    getItemCount(): number;
+    getSubtotal(): number;
+    getTotal(): number;
+    subscribe(listener: BTSCartListener): () => void;
+    destroy(): void;
+    rehydrate(): void;
+    addItem(input: BTSCartItemInput): void;
+    removeItem(id: string): void;
+    setQuantity(id: string, quantity: number): void;
+    increment(id: string, amount?: number): void;
+    decrement(id: string, amount?: number): void;
+    clear(): void;
+    resolveCheckoutUrl(checkoutLinkKey?: string): Promise<string>;
+    checkout(checkoutLinkKey?: string): Promise<string>;
+    private itemsForCheckout;
+    private normalizeItem;
+    private post;
+    private commit;
+    private emit;
+    private log;
+}
+export declare function createBTSCart(init: BTSCartInit): BTSCart;
+export type { BTSCartCheckoutItemPayload, BTSCartCheckoutLinkConfig, BTSCartCheckoutUrlRequest, BTSCartCheckoutUrlResult, BTSCartErrorCode, BTSCartInit, BTSCartItem, BTSCartItemInput, BTSCartListener, BTSCartMode, BTSCartRequestContext, BTSCartRequestHeaders, BTSCartState, BTSCartStorage, } from "./types/index.types";
+export { BTSCartError } from "./types/index.types";

package/dist/types/types/browser.types.d.ts

@@ -0,0 +1,14 @@
+import type { BTSCart, createBTSCart } from "../index";
+declare global {
+    interface Window {
+        BTSCart?: {
+            BTSCart: typeof BTSCart;
+            createBTSCart: typeof createBTSCart;
+        };
+        createBTSCart?: typeof createBTSCart;
+        btsCart?: BTSCart;
+        btsCartDataLayer?: Array<ArrayLike<unknown>>;
+        btsCartCommand?: (...args: unknown[]) => void;
+    }
+}
+export {};

package/dist/types/types/index.types.d.ts

@@ -0,0 +1,75 @@
+export type BTSCartMode = "static" | "dynamic";
+export type BTSCartStorage = Pick<Storage, "getItem" | "setItem" | "removeItem">;
+export type BTSCartRequestContext = {
+    body: unknown;
+    bodyText: string;
+    endpoint: string;
+    headers: Record<string, string>;
+    path: string;
+    siteKey: string;
+    url: string;
+};
+export type BTSCartRequestHeaders = HeadersInit | ((request: BTSCartRequestContext) => HeadersInit | Promise<HeadersInit>);
+export type BTSCartCheckoutLinkConfig = {
+    /** Raw checkout link ID, or a full BTS checkout URL like `https://behindthescenes.com/c/<id>?discountCode=CODE`. */
+    checkoutLinkId: string;
+    mode: BTSCartMode;
+    discountCode?: string;
+};
+export type BTSCartItemInput = {
+    id: string;
+    lineItemId: string;
+    checkoutLinkKey?: string;
+    productId?: string;
+    accessTierId?: string;
+    name: string;
+    unitPrice: number;
+    fullPrice?: number;
+    image?: string;
+    quantity?: number;
+    /** Internal promo-code ID or customer-facing promo code. Customer codes are resolved by the BTS cart API. */
+    discount?: string;
+};
+export type BTSCartItem = Required<Pick<BTSCartItemInput, "id" | "lineItemId" | "name" | "unitPrice" | "quantity">> & Omit<BTSCartItemInput, "quantity"> & {
+    checkoutLinkKey: string;
+};
+export type BTSCartState = {
+    items: BTSCartItem[];
+};
+export type BTSCartListener = (state: BTSCartState) => void;
+export type BTSCartInit = {
+    siteKey: string;
+    endpoint?: string;
+    checkoutLinks?: Record<string, BTSCartCheckoutLinkConfig>;
+    defaultCheckoutLinkKey?: string;
+    debug?: boolean;
+    persist?: boolean;
+    storageKey?: string;
+    storage?: BTSCartStorage;
+    requestHeaders?: BTSCartRequestHeaders;
+};
+export type BTSCartCheckoutItemPayload = {
+    lineItemId: string;
+    quantity: number;
+    discount?: string;
+};
+export type BTSCartCheckoutUrlRequest = {
+    siteKey: string;
+    checkoutLinkId: string;
+    mode: BTSCartMode;
+    items?: BTSCartCheckoutItemPayload[];
+    discountCode?: string;
+};
+export type BTSCartCheckoutUrlResult = {
+    ok: true;
+    checkoutUrl: string;
+    checkoutLinkId: string;
+    mode: BTSCartMode;
+    items: BTSCartCheckoutItemPayload[];
+};
+export type BTSCartErrorCode = "unknown_site" | "domain_not_verified" | "analytics_disabled" | "checkout_link_not_found" | "checkout_link_inactive" | "checkout_link_expired" | "checkout_link_sold_out" | "checkout_link_mode_mismatch" | "cart_empty" | "line_item_not_found" | "invalid_quantity" | "line_item_sold_out" | "product_unavailable" | "discount_invalid" | "request_failed";
+export declare class BTSCartError extends Error {
+    code: BTSCartErrorCode;
+    status?: number;
+    constructor(code: BTSCartErrorCode, message: string, status?: number);
+}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@behindthescenes/cart",
+  "version": "0.0.3",
+  "description": "Browser cart SDK for BTS external-site checkout links.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gwop-company/bts-backend.git",
+    "directory": "packages/cart"
+  },
+  "keywords": [
+    "cart",
+    "checkout",
+    "browser",
+    "sdk"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
+    },
+    "./browser": {
+      "types": "./dist/types/browser.d.ts",
+      "import": "./dist/browser/browser.js",
+      "default": "./dist/browser/browser.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun ./scripts/build.ts",
+    "build:hosted": "bun ./scripts/sync-hosted-bundle.ts",
+    "build:hosted:force": "bun ./scripts/sync-hosted-bundle.ts --build",
+    "release:version": "bun ./scripts/bump-release-version.ts",
+    "type-check": "tsc --noEmit",
+    "test": "bun test",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "release:check": "bun run lint:check && bun run type-check && bun run test && bun run build && npm pack --dry-run",
+    "release:publish": "bun run release:version && bun run release:check && npm publish --access public",
+    "prepublishOnly": "bun run release:check && bun ./scripts/sync-hosted-bundle.ts"
+  },
+  "devDependencies": {
+    "@bts/eslint-config": "workspace:*",
+    "@types/bun": "^1.3.11",
+    "eslint": "^9.17.0",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}