@aglyn/plugins-commerce 1.0.0-beta.236 → 1.0.0-beta.238

package/src/lib/utils/add-to-cart.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { type AnalyticsItem } from '@aglyn/aglyn/app-utils/analytics-events';
+export interface AddToCartRequest {
+    hostId: string;
+    /** The site's fetch (`Aglyn.useSiteFetch()`), which carries the cart cookie. */
+    siteFetch: typeof fetch;
+    productId: string;
+    variantId: string;
+    quantity: number;
+    /** The GA4 line: product id (never the variant's), name, price, quantity. */
+    item: AnalyticsItem;
+}
+/**
+ * Put one line in the shopper's cart. The product page's Add to cart and the
+ * product grid's quick add both go through this one path, so both record the
+ * same funnel step (AGL-3605), report the same priced `add_to_cart`
+ * (AGL-1591) and refresh every cart badge on the page. Resolves whether the
+ * server took the line; the server prices it, never the caller.
+ */
+export declare function addToCart(request: AddToCartRequest): Promise<boolean>;

package/src/lib/utils/add-to-cart.js

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { buildAddToCartParams, trackEvent } from "@aglyn/aglyn/app-utils/analytics-events";
+import { recordSiteJourneyStep } from "@aglyn/aglyn/app-utils/site-journey";
+import { CART_UPDATED_EVENT } from "../constants/cart-events.js";
+/**
+ * Put one line in the shopper's cart. The product page's Add to cart and the
+ * product grid's quick add both go through this one path, so both record the
+ * same funnel step (AGL-3605), report the same priced `add_to_cart`
+ * (AGL-1591) and refresh every cart badge on the page. Resolves whether the
+ * server took the line; the server prices it, never the caller.
+ */ export async function addToCart(request) {
+    const { hostId, siteFetch, productId, variantId, quantity, item } = request;
+    const response = await siteFetch('/api/commerce/cart', {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json'
+        },
+        body: JSON.stringify({
+            hostId,
+            action: 'add',
+            productId,
+            variantId,
+            quantity
+        })
+    }).catch(()=>null);
+    if (!(response == null ? void 0 : response.ok)) return false;
+    recordSiteJourneyStep('cart', productId);
+    // `value` describes what was JUST ADDED, not the cart's new total — see
+    // `buildAddToCartParams`.
+    trackEvent('add_to_cart', buildAddToCartParams({
+        items: [
+            item
+        ]
+    }));
+    window.dispatchEvent(new Event(CART_UPDATED_EVENT));
+    return true;
+}
+
+//# sourceMappingURL=add-to-cart.js.map

package/src/lib/utils/add-to-cart.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/commerce/src/lib/utils/add-to-cart.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  buildAddToCartParams,\n  trackEvent,\n  type AnalyticsItem,\n} from '@aglyn/aglyn/app-utils/analytics-events'\nimport { recordSiteJourneyStep } from '@aglyn/aglyn/app-utils/site-journey'\nimport { CART_UPDATED_EVENT } from '../constants/cart-events'\n\nexport interface AddToCartRequest {\n  hostId: string\n  /** The site's fetch (`Aglyn.useSiteFetch()`), which carries the cart cookie. */\n  siteFetch: typeof fetch\n  productId: string\n  variantId: string\n  quantity: number\n  /** The GA4 line: product id (never the variant's), name, price, quantity. */\n  item: AnalyticsItem\n}\n\n/**\n * Put one line in the shopper's cart. The product page's Add to cart and the\n * product grid's quick add both go through this one path, so both record the\n * same funnel step (AGL-3605), report the same priced `add_to_cart`\n * (AGL-1591) and refresh every cart badge on the page. Resolves whether the\n * server took the line; the server prices it, never the caller.\n */\nexport async function addToCart(request: AddToCartRequest): Promise<boolean> {\n  const { hostId, siteFetch, productId, variantId, quantity, item } = request\n  const response = await siteFetch('/api/commerce/cart', {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ hostId, action: 'add', productId, variantId, quantity }),\n  }).catch(() => null)\n  if (!response?.ok) return false\n  recordSiteJourneyStep('cart', productId)\n  // `value` describes what was JUST ADDED, not the cart's new total — see\n  // `buildAddToCartParams`.\n  trackEvent('add_to_cart', buildAddToCartParams({ items: [item] }))\n  window.dispatchEvent(new Event(CART_UPDATED_EVENT))\n  return true\n}\n"],"names":["buildAddToCartParams","trackEvent","recordSiteJourneyStep","CART_UPDATED_EVENT","addToCart","request","hostId","siteFetch","productId","variantId","quantity","item","response","method","headers","body","JSON","stringify","action","catch","ok","items","window","dispatchEvent","Event"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,SACEA,oBAAoB,EACpBC,UAAU,QAEL,0CAAyC;AAChD,SAASC,qBAAqB,QAAQ,sCAAqC;AAC3E,SAASC,kBAAkB,QAAQ,8BAA0B;AAa7D;;;;;;CAMC,GACD,OAAO,eAAeC,UAAUC,OAAyB;IACvD,MAAM,EAAEC,MAAM,EAAEC,SAAS,EAAEC,SAAS,EAAEC,SAAS,EAAEC,QAAQ,EAAEC,IAAI,EAAE,GAAGN;IACpE,MAAMO,WAAW,MAAML,UAAU,sBAAsB;QACrDM,QAAQ;QACRC,SAAS;YAAE,gBAAgB;QAAmB;QAC9CC,MAAMC,KAAKC,SAAS,CAAC;YAAEX;YAAQY,QAAQ;YAAOV;YAAWC;YAAWC;QAAS;IAC/E,GAAGS,KAAK,CAAC,IAAM;IACf,IAAI,EAACP,4BAAAA,SAAUQ,EAAE,GAAE,OAAO;IAC1BlB,sBAAsB,QAAQM;IAC9B,wEAAwE;IACxE,0BAA0B;IAC1BP,WAAW,eAAeD,qBAAqB;QAAEqB,OAAO;YAACV;SAAK;IAAC;IAC/DW,OAAOC,aAAa,CAAC,IAAIC,MAAMrB;IAC/B,OAAO;AACT"}