@behindthescenes/cart 0.0.8 → 0.0.10

package/README.md

@@ -12,6 +12,7 @@ The BTS Cart SDK provides:
 - **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.
+- **Quantity** - The SDK only normalizes quantities to integers **≥ 1**. It does not cap counts to per-line inventory or API max; those rules apply on `checkout-url` only.
 
 ## Installation
 
@@ -70,7 +71,7 @@ const cart = createBTSCart({
 
 cart.addItem({
   id: "garnet",
-  lineItemId: "2dd3b989-616e-4e2f-9c47-21e1288d3823",
+  accessTierId: "2dd3b989-616e-4e2f-9c47-21e1288d3823",
   checkoutLinkKey: "tickets",
   name: "Garnet",
   unitPrice: 395,
@@ -116,7 +117,11 @@ The SDK sends that cart payload to the BTS API for validation and receives a fin
 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.
+For dynamic checkout links, set **`accessTierId`** or **`productId`** to the BTS catalog UUID (recommended). The SDK sends that value as `lineItemId` on `checkout-url`, matching how BTS checkout and webhooks resolve lines.
+
+When the link has no saved checkout-link line items, BTS synthesizes the catalog from the space’s public products and tiers — use the tier or product UUID, not a site-local slug in `id`.
+
+You may still pass `lineItemId` alone (persisted `spaces_checkout_link_items.id`, or tier/product UUID). If both a slug and a catalog UUID are present, the SDK prefers `accessTierId` / `productId` for checkout.
 
 `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.
 

package/dist/browser/browser.js

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

package/dist/cjs/index.js

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

package/dist/esm/index.js

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

package/dist/manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "@behindthescenes/cart",
-  "version": "0.0.8",
-  "generatedAt": "2026-05-15T10:30:41.615Z",
+  "version": "0.0.10",
+  "generatedAt": "2026-05-20T05:35:59.735Z",
   "artifacts": {
     "browser": "browser/browser.js",
     "cjs": "cjs/index.js",

package/dist/types/attribution.d.ts

@@ -0,0 +1,2 @@
+/** Append BTS site, journey, UTMs, and click IDs from analytics localStorage to a checkout URL. */
+export declare function decorateCheckoutUrlWithBrowserAttribution(url: string, siteKey: string): string;

package/dist/types/browser.d.ts

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

package/dist/types/index.d.ts

@@ -1,4 +1,9 @@
 import type { BTSCartInit, BTSCartItem, BTSCartItemInput, BTSCartListener, BTSCartState } from "./types/index.types";
+/**
+ * Prefer catalog UUIDs on checkout-url — matches `resolveDynamicCheckoutCartLineItem` (tier/product
+ * id, then persisted line-item pk).
+ */
+export declare function resolveLineItemIdForCheckout(item: Pick<BTSCartItem, "lineItemId" | "productId" | "accessTierId">): string;
 export declare class BTSCart {
     private siteKey;
     private endpoint;

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

@@ -19,12 +19,17 @@ export type BTSCartCheckoutLinkConfig = {
 export type BTSCartItemInput = {
     id: string;
     /**
-     * Sent as `lineItemId` on `POST /v2/website/cart/checkout-url`. Must match a resolved line on the
-     * link: the row’s `id`, or its `product_id` / `access_tier_id` (see `resolveDynamicCheckoutCartLineItem` in `@bts/common`).
+     * Sent as `lineItemId` on `POST /v2/website/cart/checkout-url` when no {@link productId} or
+     * {@link accessTierId} is set. Must match a resolved line on the link: the row’s `id`, or its
+     * `product_id` / `access_tier_id` (see `resolveDynamicCheckoutCartLineItem` in `@bts/common`).
+     * For dynamic catalog links, prefer {@link accessTierId} or {@link productId} instead of a
+     * site-local slug.
      */
-    lineItemId: string;
+    lineItemId?: string;
     checkoutLinkKey?: string;
+    /** BTS product UUID; preferred checkout identifier for product lines on dynamic links. */
     productId?: string;
+    /** BTS access tier UUID; preferred checkout identifier for tier lines on dynamic links. */
     accessTierId?: string;
     /** Display only in the SDK; defaults to `"Item"` if empty. Not sent to the cart API. */
     name: string;
@@ -35,9 +40,8 @@ export type BTSCartItemInput = {
     /** Internal promo-code ID or customer-facing promo code. Customer codes are resolved by the BTS cart API. */
     discount?: string;
     /**
-     * Catalog identifiers (access tier id and/or product id) this promo applies to. Used when cart
-     * lines change so discounts can be cleared if no remaining line is still eligible. Defaults to
-     * {@link accessTierId}, {@link productId}, and {@link lineItemId} when omitted.
+     * Optional catalog identifiers for embedders documenting promo scope. The SDK persists them but
+     * does not clear discounts client-side; the cart API validates promos on checkout-url.
      */
     discountEligibleTierOrProductIds?: string[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behindthescenes/cart",
-  "version": "0.0.8",
+  "version": "0.0.10",
   "description": "Browser cart SDK for BTS external-site checkout links.",
   "license": "UNLICENSED",
   "type": "module",