@behindthescenes/cart 0.0.8 → 0.0.12

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

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

package/dist/types/browser.d.ts

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

package/dist/types/constants.d.ts

@@ -1,4 +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;
+export declare const STORAGE_VERSION = 2;

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;
@@ -11,31 +16,56 @@ export declare class BTSCart {
     private requestHeaders?;
     private items;
     private listeners;
+    /** Hydrate the cart from init options and restore any persisted state. */
     constructor(init: BTSCartInit);
+    /** Convenience constructor matching the analytics package's static `init` API. */
     static init(opts: BTSCartInit): BTSCart;
+    /** Return a defensive copy of cart items for read-only external consumers. */
     getItems(): BTSCartItem[];
+    /** Return the full cart state object expected by subscribers and embedders. */
     getState(): BTSCartState;
+    /** Count total units across all lines, not just distinct items. */
     getItemCount(): number;
+    /** Sum undiscounted line totals using `fullPrice` when it exists. */
     getSubtotal(): number;
+    /** Sum discounted line totals using the actual checkout unit price. */
     getTotal(): number;
+    /** Register a listener and immediately emit the current state for simple UI synchronization. */
     subscribe(listener: BTSCartListener): () => void;
+    /** Tear down subscriptions without mutating the cart contents. */
     destroy(): void;
+    /** Restore a versioned cart snapshot from storage and normalize legacy item shapes on read. */
     rehydrate(): void;
+    /** Add a new line or merge into an existing line with the same SDK item id. */
     addItem(input: BTSCartItemInput): void;
+    /** Remove a line entirely by its SDK item id. */
     removeItem(id: string): void;
+    /** Replace a line quantity, dropping the line when the requested quantity is zero or below. */
     setQuantity(id: string, quantity: number): void;
+    /** Increase a line quantity using a clamped positive integer increment. */
     increment(id: string, amount?: number): void;
+    /** Decrease a line quantity using a clamped positive integer decrement. */
     decrement(id: string, amount?: number): void;
+    /** Empty the in-memory cart and remove the persisted snapshot when persistence is enabled. */
     clear(): void;
+    /** Build a checkout URL via the cart API, then append browser attribution for downstream analytics. */
     resolveCheckoutUrl(checkoutLinkKey?: string): Promise<string>;
+    /** Resolve a checkout URL and navigate the current browser when one is available. */
     checkout(checkoutLinkKey?: string): Promise<string>;
+    /** Convert current cart lines into the API payload expected by dynamic checkout links. */
     private itemsForCheckout;
+    /** Normalize partial external item input into the persisted cart line shape. */
     private normalizeItem;
+    /** POST a cart request with optional caller-supplied headers and normalized API errors. */
     private post;
+    /** Recompute derived cart state, persist it when enabled, and notify subscribers. */
     private commit;
+    /** Fan out the latest immutable state snapshot to all listeners. */
     private emit;
+    /** Emit debug logs only when the SDK was initialized in debug mode. */
     private log;
 }
+/** Public package factory mirroring the class-based `BTSCart.init` constructor. */
 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/BTSCart.types.d.ts

@@ -0,0 +1,98 @@
+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 = {
+    /** Checkout link UUID, or a full checkout URL (`https://…/c/<uuid>?discountCode=…`). Relative `/c/<uuid>` is supported. */
+    checkoutLinkId: string;
+    mode: BTSCartMode;
+    discountCode?: string;
+};
+export type BTSCartItemInput = {
+    id: string;
+    /**
+     * 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;
+    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;
+    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;
+    /**
+     * 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[];
+};
+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" | "quantity_exceeded" | "product_unavailable" | "discounts_invalid" | "request_failed" | "discounts_invalid";
+export declare class BTSCartError extends Error {
+    code: BTSCartErrorCode;
+    status?: number;
+    details?: {
+        lineItemId: string;
+        productId?: string;
+        accessTierId?: string;
+        discountCode: string;
+        discountId?: string;
+        reason: string;
+    }[];
+    constructor(code: BTSCartErrorCode, message: string, status?: number, details?: BTSCartError["details"]);
+}

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

@@ -1,86 +1,4 @@
-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 = {
-    /** Checkout link UUID, or a full checkout URL (`https://…/c/<uuid>?discountCode=…`). Relative `/c/<uuid>` is supported. */
-    checkoutLinkId: string;
-    mode: BTSCartMode;
-    discountCode?: string;
-};
-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`).
-     */
-    lineItemId: string;
-    checkoutLinkKey?: string;
-    productId?: string;
-    accessTierId?: string;
-    /** Display only in the SDK; defaults to `"Item"` if empty. Not sent to the cart API. */
-    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;
-    /**
-     * 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.
-     */
-    discountEligibleTierOrProductIds?: 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" | "quantity_exceeded" | "product_unavailable" | "discount_invalid" | "request_failed";
-export declare class BTSCartError extends Error {
-    code: BTSCartErrorCode;
-    status?: number;
-    constructor(code: BTSCartErrorCode, message: string, status?: number);
-}
+export type * from "./BTSCart.types";
+export type * as BTSCartBrowserTypes from "./BTSCartBrowser.types";
+export type * as BTSCartTypes from "./BTSCart.types";
+export { BTSCartError } from "./BTSCart.types";

package/dist/types/utils/attribution.util.d.ts

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

package/dist/types/utils/browserEnv.util.d.ts

@@ -0,0 +1,5 @@
+/** Read `window` defensively so Node / SSR bundles never crash on a missing global. */
+declare function safeWindow(): Window | null;
+/** Prefer a directly mocked `globalThis.localStorage`, then fall back to `window.localStorage`. */
+declare function safeStorage(): Storage | null;
+export { safeStorage, safeWindow };

package/package.json

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