@amboras-dev/meta-shops-checkout 0.2.0

package/README.md

@@ -0,0 +1,39 @@
+# @amboras-dev/meta-shops-checkout
+
+Storefront half of the **Facebook & Instagram Shop** plugin (`facebook-instagram-shop`).
+
+When a shopper checks out from a Meta Shop configured with **"Checkout on another
+website"**, Meta sends them to a deep-link on the merchant's storefront:
+
+```
+https://store.example.com/checkout?products=variant_x:4,variant_y:2&coupon=SAVE10&cart_origin=meta_shops
+```
+
+This package exports a single `rootProviders` slot component,
+`MetaShopsCheckoutProvider`, that:
+
+1. Detects the deep-link (only on the checkout path, only when
+   `cart_origin=meta_shops`).
+2. Builds a **fresh cart** with exactly the items Meta sent (`variantId:qty`).
+   The retailer_id Meta returns is the Medusa variant id, so it maps straight to
+   `createLineItem`.
+3. Applies the `coupon` as a cart promotion (a bad coupon is skipped, not fatal).
+4. Makes it the storefront's active cart (`localStorage.medusa_cart_id` +
+   invalidates the shared `['cart']` query) and strips the URL params.
+
+It is **idempotency-guarded** (a refresh won't re-add items) and fully inert on
+every other page/URL.
+
+### What it does NOT do
+
+Payment-session initialization is left to the storefront's `useCheckout`, which
+auto-initializes it once the shopper provides a shipping address + method —
+Medusa ties the payment amount to shipping, and Meta does not send an address,
+so payment cannot (and should not) be pre-initialized.
+
+### Installation
+
+Installed automatically by the Amboras plugin pipeline as part of the
+`facebook-instagram-shop` plugin (it is the manifest's `npm_package`). It is a
+Class A integration — declarative `rootProviders` binding, no storefront source
+edits.

package/dist/index.d.mts

@@ -0,0 +1,79 @@
+import { ReactElement } from 'react';
+
+interface MetaShopsCheckoutProviderProps {
+    /**
+     * Medusa backend base URL. Defaults to `NEXT_PUBLIC_MEDUSA_BACKEND_URL`
+     * (falling back to `http://localhost:9000`). The `/store/*` API resolves the
+     * tenant from the publishable key, so no store-environment header is needed.
+     */
+    baseUrl?: string;
+    /**
+     * Publishable API key sent as `x-publishable-api-key`. Defaults to
+     * `NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY`. Routes the `/store/*` calls to the
+     * correct tenant.
+     */
+    publishableApiKey?: string;
+    /**
+     * The `cart_origin` query value that marks a Meta Shops deep-link. The
+     * provider stays completely inert unless this exact value is present, so it
+     * is safe to mount on every page. Defaults to `'meta_shops'`.
+     */
+    cartOrigin?: string;
+    /**
+     * Path the deep-link lands on. The provider only seeds when the current
+     * pathname matches this (so a stray `?cart_origin=meta_shops` elsewhere does
+     * nothing). Defaults to `'/checkout'`.
+     */
+    checkoutPath?: string;
+    /** Master switch. When false the provider renders null and does nothing. */
+    enabled?: boolean;
+}
+/** A single `variantId:quantity` pair parsed out of the `products` param. */
+interface ParsedItem {
+    variant_id: string;
+    quantity: number;
+}
+
+/**
+ * Null-rendering side-effect component for the `rootProviders` slot.
+ *
+ * When a Meta Shops "checkout on another website" deep-link lands on the
+ * checkout page:
+ *
+ *   /checkout?products=variant_x:4,variant_y:2&coupon=SAVE10&cart_origin=meta_shops
+ *
+ * it builds a FRESH cart containing exactly the items Meta sent, applies the
+ * coupon, makes that cart the storefront's active cart, and strips the params.
+ * Payment is intentionally NOT initialized here — the storefront's useCheckout
+ * auto-initializes the payment session once the shopper provides shipping
+ * (Medusa ties the pay amount to shipping, which Meta does not send).
+ *
+ * Why a fresh cart: the buyer agreed to a specific set of items on Meta, so we
+ * never merge into a stale browse-cart. Writing our cart id to localStorage
+ * overrides any empty cart the header's useCart may have just auto-created; the
+ * orphaned empty cart is abandoned harmlessly.
+ *
+ * Safe to mount globally: it is fully inert unless pathname === checkoutPath
+ * AND cart_origin === cartOrigin AND a non-empty products param is present.
+ */
+declare function MetaShopsCheckoutProvider({ baseUrl, publishableApiKey, cartOrigin, checkoutPath, enabled, }: MetaShopsCheckoutProviderProps): ReactElement | null;
+
+/**
+ * Parse Meta's `products` deep-link param into line items.
+ *
+ * Format (already percent-decoded by URLSearchParams):
+ *   `variant_123:4,variant_456:2`
+ *
+ * The retailer_id Meta sends back is the Medusa variant id (the Meta Shop sync
+ * mapper sets each catalog item's `id` to `variant.id`), so these map straight
+ * to `createLineItem({ variant_id })` — no translation needed.
+ *
+ * Defensive rules:
+ *   - missing/!positive qty → 1
+ *   - a bare `variant_x` (no `:qty`) → qty 1
+ *   - duplicate variants are merged (quantities summed)
+ *   - blank/garbage segments are skipped, never thrown
+ */
+declare function parseProducts(raw: string): ParsedItem[];
+
+export { MetaShopsCheckoutProvider, type MetaShopsCheckoutProviderProps, type ParsedItem, parseProducts };

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { ReactElement } from 'react';
+
+interface MetaShopsCheckoutProviderProps {
+    /**
+     * Medusa backend base URL. Defaults to `NEXT_PUBLIC_MEDUSA_BACKEND_URL`
+     * (falling back to `http://localhost:9000`). The `/store/*` API resolves the
+     * tenant from the publishable key, so no store-environment header is needed.
+     */
+    baseUrl?: string;
+    /**
+     * Publishable API key sent as `x-publishable-api-key`. Defaults to
+     * `NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY`. Routes the `/store/*` calls to the
+     * correct tenant.
+     */
+    publishableApiKey?: string;
+    /**
+     * The `cart_origin` query value that marks a Meta Shops deep-link. The
+     * provider stays completely inert unless this exact value is present, so it
+     * is safe to mount on every page. Defaults to `'meta_shops'`.
+     */
+    cartOrigin?: string;
+    /**
+     * Path the deep-link lands on. The provider only seeds when the current
+     * pathname matches this (so a stray `?cart_origin=meta_shops` elsewhere does
+     * nothing). Defaults to `'/checkout'`.
+     */
+    checkoutPath?: string;
+    /** Master switch. When false the provider renders null and does nothing. */
+    enabled?: boolean;
+}
+/** A single `variantId:quantity` pair parsed out of the `products` param. */
+interface ParsedItem {
+    variant_id: string;
+    quantity: number;
+}
+
+/**
+ * Null-rendering side-effect component for the `rootProviders` slot.
+ *
+ * When a Meta Shops "checkout on another website" deep-link lands on the
+ * checkout page:
+ *
+ *   /checkout?products=variant_x:4,variant_y:2&coupon=SAVE10&cart_origin=meta_shops
+ *
+ * it builds a FRESH cart containing exactly the items Meta sent, applies the
+ * coupon, makes that cart the storefront's active cart, and strips the params.
+ * Payment is intentionally NOT initialized here — the storefront's useCheckout
+ * auto-initializes the payment session once the shopper provides shipping
+ * (Medusa ties the pay amount to shipping, which Meta does not send).
+ *
+ * Why a fresh cart: the buyer agreed to a specific set of items on Meta, so we
+ * never merge into a stale browse-cart. Writing our cart id to localStorage
+ * overrides any empty cart the header's useCart may have just auto-created; the
+ * orphaned empty cart is abandoned harmlessly.
+ *
+ * Safe to mount globally: it is fully inert unless pathname === checkoutPath
+ * AND cart_origin === cartOrigin AND a non-empty products param is present.
+ */
+declare function MetaShopsCheckoutProvider({ baseUrl, publishableApiKey, cartOrigin, checkoutPath, enabled, }: MetaShopsCheckoutProviderProps): ReactElement | null;
+
+/**
+ * Parse Meta's `products` deep-link param into line items.
+ *
+ * Format (already percent-decoded by URLSearchParams):
+ *   `variant_123:4,variant_456:2`
+ *
+ * The retailer_id Meta sends back is the Medusa variant id (the Meta Shop sync
+ * mapper sets each catalog item's `id` to `variant.id`), so these map straight
+ * to `createLineItem({ variant_id })` — no translation needed.
+ *
+ * Defensive rules:
+ *   - missing/!positive qty → 1
+ *   - a bare `variant_x` (no `:qty`) → qty 1
+ *   - duplicate variants are merged (quantities summed)
+ *   - blank/garbage segments are skipped, never thrown
+ */
+declare function parseProducts(raw: string): ParsedItem[];
+
+export { MetaShopsCheckoutProvider, type MetaShopsCheckoutProviderProps, type ParsedItem, parseProducts };

package/dist/index.js

@@ -0,0 +1,188 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  MetaShopsCheckoutProvider: () => MetaShopsCheckoutProvider,
+  parseProducts: () => parseProducts
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/provider.tsx
+var import_react = require("react");
+var import_react_query = require("@tanstack/react-query");
+
+// src/lib/fetch.ts
+function resolveEnv(key) {
+  if (key === "NEXT_PUBLIC_MEDUSA_BACKEND_URL") return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL;
+  if (key === "NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY") return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY;
+  return void 0;
+}
+async function storeFetch(path, options = {}) {
+  const {
+    baseUrl = resolveEnv("NEXT_PUBLIC_MEDUSA_BACKEND_URL") ?? "http://localhost:9000",
+    publishableApiKey = resolveEnv("NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY"),
+    method = "GET",
+    body
+  } = options;
+  const headers = { Accept: "application/json" };
+  if (publishableApiKey) headers["x-publishable-api-key"] = publishableApiKey;
+  if (body !== void 0) headers["Content-Type"] = "application/json";
+  const res = await fetch(`${baseUrl}${path}`, {
+    method,
+    headers,
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(err.message ?? err.error ?? `Store request failed (${res.status})`);
+  }
+  return res.json();
+}
+
+// src/lib/parse.ts
+function parseProducts(raw) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const segment of raw.split(",")) {
+    const pair = segment.trim();
+    if (!pair) continue;
+    const sep = pair.lastIndexOf(":");
+    const rawId = sep === -1 ? pair : pair.slice(0, sep);
+    const rawQty = sep === -1 ? "" : pair.slice(sep + 1);
+    let variantId = rawId.trim();
+    try {
+      variantId = decodeURIComponent(variantId).trim();
+    } catch {
+    }
+    if (!variantId) continue;
+    const parsed = parseInt(rawQty, 10);
+    const quantity = Number.isFinite(parsed) && parsed > 0 ? parsed : 1;
+    merged.set(variantId, (merged.get(variantId) ?? 0) + quantity);
+  }
+  return Array.from(merged, ([variant_id, quantity]) => ({ variant_id, quantity }));
+}
+
+// src/provider.tsx
+var CART_ID_KEY = "medusa_cart_id";
+var CART_QUERY_KEY = ["cart"];
+var SEEDED_PREFIX = "meta_shops_seeded:";
+function MetaShopsCheckoutProvider({
+  baseUrl,
+  publishableApiKey,
+  cartOrigin = "meta_shops",
+  checkoutPath = "/checkout",
+  enabled = true
+}) {
+  const queryClient = (0, import_react_query.useQueryClient)();
+  const ranRef = (0, import_react.useRef)(false);
+  (0, import_react.useEffect)(() => {
+    if (!enabled || typeof window === "undefined" || ranRef.current) return;
+    let params;
+    try {
+      params = new URLSearchParams(window.location.search);
+    } catch {
+      return;
+    }
+    const norm = (p) => p.replace(/\/+$/, "");
+    if (norm(window.location.pathname) !== norm(checkoutPath)) return;
+    if (params.get("cart_origin") !== cartOrigin) return;
+    const productsRaw = params.get("products");
+    if (!productsRaw) return;
+    const items = parseProducts(productsRaw);
+    if (items.length === 0) return;
+    const couponRaw = params.get("coupon");
+    const coupon = couponRaw && couponRaw.trim() ? couponRaw.trim().toUpperCase() : null;
+    const cleanUrl = () => {
+      try {
+        window.history.replaceState(window.history.state, "", checkoutPath);
+      } catch {
+      }
+    };
+    const seedKey = `${SEEDED_PREFIX}${productsRaw}|${coupon ?? ""}`;
+    try {
+      if (sessionStorage.getItem(seedKey)) {
+        cleanUrl();
+        return;
+      }
+    } catch {
+    }
+    ranRef.current = true;
+    const opts = { baseUrl, publishableApiKey };
+    const seed = async () => {
+      try {
+        const { regions } = await storeFetch(
+          "/store/regions",
+          opts
+        );
+        const regionId = regions?.[0]?.id;
+        if (!regionId) throw new Error("no region available");
+        const { cart: created } = await storeFetch("/store/carts", {
+          ...opts,
+          method: "POST",
+          body: { region_id: regionId }
+        });
+        const cartId = created.id;
+        let latest = created;
+        for (const item of items) {
+          const { cart } = await storeFetch(
+            `/store/carts/${cartId}/line-items`,
+            { ...opts, method: "POST", body: { variant_id: item.variant_id, quantity: item.quantity } }
+          );
+          latest = cart;
+        }
+        if (coupon) {
+          try {
+            const { cart } = await storeFetch(`/store/carts/${cartId}`, {
+              ...opts,
+              method: "POST",
+              body: { promo_codes: [coupon] }
+            });
+            latest = cart;
+          } catch (e) {
+            console.warn(`[meta-shops-checkout] could not apply coupon "${coupon}":`, e);
+          }
+        }
+        try {
+          localStorage.setItem(CART_ID_KEY, cartId);
+        } catch {
+        }
+        try {
+          sessionStorage.setItem(seedKey, "1");
+        } catch {
+        }
+        queryClient.setQueryData(CART_QUERY_KEY, latest);
+        void queryClient.invalidateQueries({ queryKey: CART_QUERY_KEY });
+        cleanUrl();
+      } catch (e) {
+        console.error("[meta-shops-checkout] failed to seed cart from Meta Shops deep-link:", e);
+        ranRef.current = false;
+      }
+    };
+    void seed();
+  }, [enabled, baseUrl, publishableApiKey, cartOrigin, checkoutPath]);
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MetaShopsCheckoutProvider,
+  parseProducts
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/lib/fetch.ts","../src/lib/parse.ts"],"sourcesContent":["// Provider (client component — rootProviders slot): seeds a fresh cart from a\n// Meta Shops \"checkout on another website\" deep-link, then hands off to the\n// storefront's checkout flow.\nexport { MetaShopsCheckoutProvider } from './provider'\n\n// Public types\nexport type { MetaShopsCheckoutProviderProps, ParsedItem } from './types'\n\n// Exposed for reuse / testing.\nexport { parseProducts } from './lib/parse'\n","'use client'\n\nimport { useEffect, useRef, type ReactElement } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { storeFetch } from './lib/fetch'\nimport { parseProducts } from './lib/parse'\nimport type { MetaShopsCheckoutProviderProps } from './types'\n\n// Same key + query the storefront's useCart owns, so the seeded cart becomes\n// THE active cart and the checkout page renders it.\nconst CART_ID_KEY = 'medusa_cart_id'\nconst CART_QUERY_KEY = ['cart'] as const\nconst SEEDED_PREFIX = 'meta_shops_seeded:'\n\n/**\n * Null-rendering side-effect component for the `rootProviders` slot.\n *\n * When a Meta Shops \"checkout on another website\" deep-link lands on the\n * checkout page:\n *\n *   /checkout?products=variant_x:4,variant_y:2&coupon=SAVE10&cart_origin=meta_shops\n *\n * it builds a FRESH cart containing exactly the items Meta sent, applies the\n * coupon, makes that cart the storefront's active cart, and strips the params.\n * Payment is intentionally NOT initialized here — the storefront's useCheckout\n * auto-initializes the payment session once the shopper provides shipping\n * (Medusa ties the pay amount to shipping, which Meta does not send).\n *\n * Why a fresh cart: the buyer agreed to a specific set of items on Meta, so we\n * never merge into a stale browse-cart. Writing our cart id to localStorage\n * overrides any empty cart the header's useCart may have just auto-created; the\n * orphaned empty cart is abandoned harmlessly.\n *\n * Safe to mount globally: it is fully inert unless pathname === checkoutPath\n * AND cart_origin === cartOrigin AND a non-empty products param is present.\n */\nexport function MetaShopsCheckoutProvider({\n  baseUrl,\n  publishableApiKey,\n  cartOrigin = 'meta_shops',\n  checkoutPath = '/checkout',\n  enabled = true,\n}: MetaShopsCheckoutProviderProps): ReactElement | null {\n  const queryClient = useQueryClient()\n  // Guards a single mount (incl. React StrictMode's double-invoke in dev).\n  const ranRef = useRef(false)\n\n  useEffect(() => {\n    if (!enabled || typeof window === 'undefined' || ranRef.current) return\n\n    let params: URLSearchParams\n    try {\n      params = new URLSearchParams(window.location.search)\n    } catch {\n      return\n    }\n\n    const norm = (p: string) => p.replace(/\\/+$/, '')\n    if (norm(window.location.pathname) !== norm(checkoutPath)) return\n    if (params.get('cart_origin') !== cartOrigin) return\n\n    const productsRaw = params.get('products')\n    if (!productsRaw) return\n\n    const items = parseProducts(productsRaw)\n    if (items.length === 0) return\n\n    const couponRaw = params.get('coupon')\n    const coupon = couponRaw && couponRaw.trim() ? couponRaw.trim().toUpperCase() : null\n\n    const cleanUrl = () => {\n      try {\n        window.history.replaceState(window.history.state, '', checkoutPath)\n      } catch {\n        /* ignore */\n      }\n    }\n\n    // Idempotency: never re-seed the same deep-link (refresh, back-nav, re-mount).\n    const seedKey = `${SEEDED_PREFIX}${productsRaw}|${coupon ?? ''}`\n    try {\n      if (sessionStorage.getItem(seedKey)) {\n        cleanUrl()\n        return\n      }\n    } catch {\n      /* sessionStorage blocked → ranRef + cleanUrl still prevent most repeats */\n    }\n\n    ranRef.current = true\n    const opts = { baseUrl, publishableApiKey }\n    const seed = async () => {\n      try {\n        // 1. Region — mirror the storefront's useCart (first region).\n        const { regions } = await storeFetch<{ regions: Array<{ id: string }> }>(\n          '/store/regions',\n          opts,\n        )\n        const regionId = regions?.[0]?.id\n        if (!regionId) throw new Error('no region available')\n\n        // 2. Fresh cart for this Meta order.\n        const { cart: created } = await storeFetch<{ cart: { id: string } }>('/store/carts', {\n          ...opts,\n          method: 'POST',\n          body: { region_id: regionId },\n        })\n        const cartId = created.id\n\n        // 3. Line items — sequential to keep the cart's optimistic version sane.\n        let latest: unknown = created\n        for (const item of items) {\n          const { cart } = await storeFetch<{ cart: unknown }>(\n            `/store/carts/${cartId}/line-items`,\n            { ...opts, method: 'POST', body: { variant_id: item.variant_id, quantity: item.quantity } },\n          )\n          latest = cart\n        }\n\n        // 4. Discount — an invalid/expired coupon must NOT abort the cart.\n        if (coupon) {\n          try {\n            const { cart } = await storeFetch<{ cart: unknown }>(`/store/carts/${cartId}`, {\n              ...opts,\n              method: 'POST',\n              body: { promo_codes: [coupon] },\n            })\n            latest = cart\n          } catch (e) {\n            console.warn(`[meta-shops-checkout] could not apply coupon \"${coupon}\":`, e)\n          }\n        }\n\n        // 5. Activate: make this the storefront's cart and reveal it on checkout.\n        try {\n          localStorage.setItem(CART_ID_KEY, cartId)\n        } catch {\n          /* ignore */\n        }\n        try {\n          sessionStorage.setItem(seedKey, '1')\n        } catch {\n          /* ignore */\n        }\n        queryClient.setQueryData(CART_QUERY_KEY, latest)\n        // Force a refetch so useCart re-reads localStorage (our cart) and wins\n        // any race with a concurrently auto-created empty cart.\n        void queryClient.invalidateQueries({ queryKey: CART_QUERY_KEY })\n\n        cleanUrl()\n      } catch (e) {\n        // Non-fatal: leave the shopper on /checkout with whatever cart exists.\n        console.error('[meta-shops-checkout] failed to seed cart from Meta Shops deep-link:', e)\n        ranRef.current = false // allow a retry if the component re-mounts\n      }\n    }\n\n    void seed()\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [enabled, baseUrl, publishableApiKey, cartOrigin, checkoutPath])\n\n  return null\n}\n","'use client'\n\nfunction resolveEnv(key: string): string | undefined {\n  if (key === 'NEXT_PUBLIC_MEDUSA_BACKEND_URL') return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL\n  if (key === 'NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY') return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY\n  return undefined\n}\n\nexport interface StoreFetchOptions {\n  baseUrl?: string\n  publishableApiKey?: string\n  method?: string\n  body?: unknown\n}\n\n/**\n * Minimal `/store/*` fetch helper, mirroring the storefront's medusa-client\n * (publishable key in the header, JSON in/out). Intentionally raw fetch rather\n * than the JS SDK: this package must NOT bundle a second `@medusajs/js-sdk`\n * copy, and the three cart endpoints we touch are stable.\n */\nexport async function storeFetch<T>(path: string, options: StoreFetchOptions = {}): Promise<T> {\n  const {\n    baseUrl = resolveEnv('NEXT_PUBLIC_MEDUSA_BACKEND_URL') ?? 'http://localhost:9000',\n    publishableApiKey = resolveEnv('NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY'),\n    method = 'GET',\n    body,\n  } = options\n\n  const headers: Record<string, string> = { Accept: 'application/json' }\n  if (publishableApiKey) headers['x-publishable-api-key'] = publishableApiKey\n  if (body !== undefined) headers['Content-Type'] = 'application/json'\n\n  const res = await fetch(`${baseUrl}${path}`, {\n    method,\n    headers,\n    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n  })\n\n  if (!res.ok) {\n    const err = (await res.json().catch(() => ({}))) as { message?: string; error?: string }\n    throw new Error(err.message ?? err.error ?? `Store request failed (${res.status})`)\n  }\n\n  return res.json() as Promise<T>\n}\n","import type { ParsedItem } from '../types'\n\n/**\n * Parse Meta's `products` deep-link param into line items.\n *\n * Format (already percent-decoded by URLSearchParams):\n *   `variant_123:4,variant_456:2`\n *\n * The retailer_id Meta sends back is the Medusa variant id (the Meta Shop sync\n * mapper sets each catalog item's `id` to `variant.id`), so these map straight\n * to `createLineItem({ variant_id })` — no translation needed.\n *\n * Defensive rules:\n *   - missing/!positive qty → 1\n *   - a bare `variant_x` (no `:qty`) → qty 1\n *   - duplicate variants are merged (quantities summed)\n *   - blank/garbage segments are skipped, never thrown\n */\nexport function parseProducts(raw: string): ParsedItem[] {\n  const merged = new Map<string, number>()\n\n  for (const segment of raw.split(',')) {\n    const pair = segment.trim()\n    if (!pair) continue\n\n    // lastIndexOf(':') so a variant id that itself contained a colon survives.\n    const sep = pair.lastIndexOf(':')\n    const rawId = sep === -1 ? pair : pair.slice(0, sep)\n    const rawQty = sep === -1 ? '' : pair.slice(sep + 1)\n\n    let variantId = rawId.trim()\n    try {\n      variantId = decodeURIComponent(variantId).trim()\n    } catch {\n      // already-decoded / malformed escape → keep as-is\n    }\n    if (!variantId) continue\n\n    const parsed = parseInt(rawQty, 10)\n    const quantity = Number.isFinite(parsed) && parsed > 0 ? parsed : 1\n\n    merged.set(variantId, (merged.get(variantId) ?? 0) + quantity)\n  }\n\n  return Array.from(merged, ([variant_id, quantity]) => ({ variant_id, quantity }))\n}\n"],"mappings":"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","names":[]}

package/dist/index.mjs

@@ -0,0 +1,161 @@
+"use client";
+
+// src/provider.tsx
+import { useEffect, useRef } from "react";
+import { useQueryClient } from "@tanstack/react-query";
+
+// src/lib/fetch.ts
+function resolveEnv(key) {
+  if (key === "NEXT_PUBLIC_MEDUSA_BACKEND_URL") return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL;
+  if (key === "NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY") return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY;
+  return void 0;
+}
+async function storeFetch(path, options = {}) {
+  const {
+    baseUrl = resolveEnv("NEXT_PUBLIC_MEDUSA_BACKEND_URL") ?? "http://localhost:9000",
+    publishableApiKey = resolveEnv("NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY"),
+    method = "GET",
+    body
+  } = options;
+  const headers = { Accept: "application/json" };
+  if (publishableApiKey) headers["x-publishable-api-key"] = publishableApiKey;
+  if (body !== void 0) headers["Content-Type"] = "application/json";
+  const res = await fetch(`${baseUrl}${path}`, {
+    method,
+    headers,
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  if (!res.ok) {
+    const err = await res.json().catch(() => ({}));
+    throw new Error(err.message ?? err.error ?? `Store request failed (${res.status})`);
+  }
+  return res.json();
+}
+
+// src/lib/parse.ts
+function parseProducts(raw) {
+  const merged = /* @__PURE__ */ new Map();
+  for (const segment of raw.split(",")) {
+    const pair = segment.trim();
+    if (!pair) continue;
+    const sep = pair.lastIndexOf(":");
+    const rawId = sep === -1 ? pair : pair.slice(0, sep);
+    const rawQty = sep === -1 ? "" : pair.slice(sep + 1);
+    let variantId = rawId.trim();
+    try {
+      variantId = decodeURIComponent(variantId).trim();
+    } catch {
+    }
+    if (!variantId) continue;
+    const parsed = parseInt(rawQty, 10);
+    const quantity = Number.isFinite(parsed) && parsed > 0 ? parsed : 1;
+    merged.set(variantId, (merged.get(variantId) ?? 0) + quantity);
+  }
+  return Array.from(merged, ([variant_id, quantity]) => ({ variant_id, quantity }));
+}
+
+// src/provider.tsx
+var CART_ID_KEY = "medusa_cart_id";
+var CART_QUERY_KEY = ["cart"];
+var SEEDED_PREFIX = "meta_shops_seeded:";
+function MetaShopsCheckoutProvider({
+  baseUrl,
+  publishableApiKey,
+  cartOrigin = "meta_shops",
+  checkoutPath = "/checkout",
+  enabled = true
+}) {
+  const queryClient = useQueryClient();
+  const ranRef = useRef(false);
+  useEffect(() => {
+    if (!enabled || typeof window === "undefined" || ranRef.current) return;
+    let params;
+    try {
+      params = new URLSearchParams(window.location.search);
+    } catch {
+      return;
+    }
+    const norm = (p) => p.replace(/\/+$/, "");
+    if (norm(window.location.pathname) !== norm(checkoutPath)) return;
+    if (params.get("cart_origin") !== cartOrigin) return;
+    const productsRaw = params.get("products");
+    if (!productsRaw) return;
+    const items = parseProducts(productsRaw);
+    if (items.length === 0) return;
+    const couponRaw = params.get("coupon");
+    const coupon = couponRaw && couponRaw.trim() ? couponRaw.trim().toUpperCase() : null;
+    const cleanUrl = () => {
+      try {
+        window.history.replaceState(window.history.state, "", checkoutPath);
+      } catch {
+      }
+    };
+    const seedKey = `${SEEDED_PREFIX}${productsRaw}|${coupon ?? ""}`;
+    try {
+      if (sessionStorage.getItem(seedKey)) {
+        cleanUrl();
+        return;
+      }
+    } catch {
+    }
+    ranRef.current = true;
+    const opts = { baseUrl, publishableApiKey };
+    const seed = async () => {
+      try {
+        const { regions } = await storeFetch(
+          "/store/regions",
+          opts
+        );
+        const regionId = regions?.[0]?.id;
+        if (!regionId) throw new Error("no region available");
+        const { cart: created } = await storeFetch("/store/carts", {
+          ...opts,
+          method: "POST",
+          body: { region_id: regionId }
+        });
+        const cartId = created.id;
+        let latest = created;
+        for (const item of items) {
+          const { cart } = await storeFetch(
+            `/store/carts/${cartId}/line-items`,
+            { ...opts, method: "POST", body: { variant_id: item.variant_id, quantity: item.quantity } }
+          );
+          latest = cart;
+        }
+        if (coupon) {
+          try {
+            const { cart } = await storeFetch(`/store/carts/${cartId}`, {
+              ...opts,
+              method: "POST",
+              body: { promo_codes: [coupon] }
+            });
+            latest = cart;
+          } catch (e) {
+            console.warn(`[meta-shops-checkout] could not apply coupon "${coupon}":`, e);
+          }
+        }
+        try {
+          localStorage.setItem(CART_ID_KEY, cartId);
+        } catch {
+        }
+        try {
+          sessionStorage.setItem(seedKey, "1");
+        } catch {
+        }
+        queryClient.setQueryData(CART_QUERY_KEY, latest);
+        void queryClient.invalidateQueries({ queryKey: CART_QUERY_KEY });
+        cleanUrl();
+      } catch (e) {
+        console.error("[meta-shops-checkout] failed to seed cart from Meta Shops deep-link:", e);
+        ranRef.current = false;
+      }
+    };
+    void seed();
+  }, [enabled, baseUrl, publishableApiKey, cartOrigin, checkoutPath]);
+  return null;
+}
+export {
+  MetaShopsCheckoutProvider,
+  parseProducts
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.tsx","../src/lib/fetch.ts","../src/lib/parse.ts"],"sourcesContent":["'use client'\n\nimport { useEffect, useRef, type ReactElement } from 'react'\nimport { useQueryClient } from '@tanstack/react-query'\nimport { storeFetch } from './lib/fetch'\nimport { parseProducts } from './lib/parse'\nimport type { MetaShopsCheckoutProviderProps } from './types'\n\n// Same key + query the storefront's useCart owns, so the seeded cart becomes\n// THE active cart and the checkout page renders it.\nconst CART_ID_KEY = 'medusa_cart_id'\nconst CART_QUERY_KEY = ['cart'] as const\nconst SEEDED_PREFIX = 'meta_shops_seeded:'\n\n/**\n * Null-rendering side-effect component for the `rootProviders` slot.\n *\n * When a Meta Shops \"checkout on another website\" deep-link lands on the\n * checkout page:\n *\n *   /checkout?products=variant_x:4,variant_y:2&coupon=SAVE10&cart_origin=meta_shops\n *\n * it builds a FRESH cart containing exactly the items Meta sent, applies the\n * coupon, makes that cart the storefront's active cart, and strips the params.\n * Payment is intentionally NOT initialized here — the storefront's useCheckout\n * auto-initializes the payment session once the shopper provides shipping\n * (Medusa ties the pay amount to shipping, which Meta does not send).\n *\n * Why a fresh cart: the buyer agreed to a specific set of items on Meta, so we\n * never merge into a stale browse-cart. Writing our cart id to localStorage\n * overrides any empty cart the header's useCart may have just auto-created; the\n * orphaned empty cart is abandoned harmlessly.\n *\n * Safe to mount globally: it is fully inert unless pathname === checkoutPath\n * AND cart_origin === cartOrigin AND a non-empty products param is present.\n */\nexport function MetaShopsCheckoutProvider({\n  baseUrl,\n  publishableApiKey,\n  cartOrigin = 'meta_shops',\n  checkoutPath = '/checkout',\n  enabled = true,\n}: MetaShopsCheckoutProviderProps): ReactElement | null {\n  const queryClient = useQueryClient()\n  // Guards a single mount (incl. React StrictMode's double-invoke in dev).\n  const ranRef = useRef(false)\n\n  useEffect(() => {\n    if (!enabled || typeof window === 'undefined' || ranRef.current) return\n\n    let params: URLSearchParams\n    try {\n      params = new URLSearchParams(window.location.search)\n    } catch {\n      return\n    }\n\n    const norm = (p: string) => p.replace(/\\/+$/, '')\n    if (norm(window.location.pathname) !== norm(checkoutPath)) return\n    if (params.get('cart_origin') !== cartOrigin) return\n\n    const productsRaw = params.get('products')\n    if (!productsRaw) return\n\n    const items = parseProducts(productsRaw)\n    if (items.length === 0) return\n\n    const couponRaw = params.get('coupon')\n    const coupon = couponRaw && couponRaw.trim() ? couponRaw.trim().toUpperCase() : null\n\n    const cleanUrl = () => {\n      try {\n        window.history.replaceState(window.history.state, '', checkoutPath)\n      } catch {\n        /* ignore */\n      }\n    }\n\n    // Idempotency: never re-seed the same deep-link (refresh, back-nav, re-mount).\n    const seedKey = `${SEEDED_PREFIX}${productsRaw}|${coupon ?? ''}`\n    try {\n      if (sessionStorage.getItem(seedKey)) {\n        cleanUrl()\n        return\n      }\n    } catch {\n      /* sessionStorage blocked → ranRef + cleanUrl still prevent most repeats */\n    }\n\n    ranRef.current = true\n    const opts = { baseUrl, publishableApiKey }\n    const seed = async () => {\n      try {\n        // 1. Region — mirror the storefront's useCart (first region).\n        const { regions } = await storeFetch<{ regions: Array<{ id: string }> }>(\n          '/store/regions',\n          opts,\n        )\n        const regionId = regions?.[0]?.id\n        if (!regionId) throw new Error('no region available')\n\n        // 2. Fresh cart for this Meta order.\n        const { cart: created } = await storeFetch<{ cart: { id: string } }>('/store/carts', {\n          ...opts,\n          method: 'POST',\n          body: { region_id: regionId },\n        })\n        const cartId = created.id\n\n        // 3. Line items — sequential to keep the cart's optimistic version sane.\n        let latest: unknown = created\n        for (const item of items) {\n          const { cart } = await storeFetch<{ cart: unknown }>(\n            `/store/carts/${cartId}/line-items`,\n            { ...opts, method: 'POST', body: { variant_id: item.variant_id, quantity: item.quantity } },\n          )\n          latest = cart\n        }\n\n        // 4. Discount — an invalid/expired coupon must NOT abort the cart.\n        if (coupon) {\n          try {\n            const { cart } = await storeFetch<{ cart: unknown }>(`/store/carts/${cartId}`, {\n              ...opts,\n              method: 'POST',\n              body: { promo_codes: [coupon] },\n            })\n            latest = cart\n          } catch (e) {\n            console.warn(`[meta-shops-checkout] could not apply coupon \"${coupon}\":`, e)\n          }\n        }\n\n        // 5. Activate: make this the storefront's cart and reveal it on checkout.\n        try {\n          localStorage.setItem(CART_ID_KEY, cartId)\n        } catch {\n          /* ignore */\n        }\n        try {\n          sessionStorage.setItem(seedKey, '1')\n        } catch {\n          /* ignore */\n        }\n        queryClient.setQueryData(CART_QUERY_KEY, latest)\n        // Force a refetch so useCart re-reads localStorage (our cart) and wins\n        // any race with a concurrently auto-created empty cart.\n        void queryClient.invalidateQueries({ queryKey: CART_QUERY_KEY })\n\n        cleanUrl()\n      } catch (e) {\n        // Non-fatal: leave the shopper on /checkout with whatever cart exists.\n        console.error('[meta-shops-checkout] failed to seed cart from Meta Shops deep-link:', e)\n        ranRef.current = false // allow a retry if the component re-mounts\n      }\n    }\n\n    void seed()\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [enabled, baseUrl, publishableApiKey, cartOrigin, checkoutPath])\n\n  return null\n}\n","'use client'\n\nfunction resolveEnv(key: string): string | undefined {\n  if (key === 'NEXT_PUBLIC_MEDUSA_BACKEND_URL') return process.env.NEXT_PUBLIC_MEDUSA_BACKEND_URL\n  if (key === 'NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY') return process.env.NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY\n  return undefined\n}\n\nexport interface StoreFetchOptions {\n  baseUrl?: string\n  publishableApiKey?: string\n  method?: string\n  body?: unknown\n}\n\n/**\n * Minimal `/store/*` fetch helper, mirroring the storefront's medusa-client\n * (publishable key in the header, JSON in/out). Intentionally raw fetch rather\n * than the JS SDK: this package must NOT bundle a second `@medusajs/js-sdk`\n * copy, and the three cart endpoints we touch are stable.\n */\nexport async function storeFetch<T>(path: string, options: StoreFetchOptions = {}): Promise<T> {\n  const {\n    baseUrl = resolveEnv('NEXT_PUBLIC_MEDUSA_BACKEND_URL') ?? 'http://localhost:9000',\n    publishableApiKey = resolveEnv('NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY'),\n    method = 'GET',\n    body,\n  } = options\n\n  const headers: Record<string, string> = { Accept: 'application/json' }\n  if (publishableApiKey) headers['x-publishable-api-key'] = publishableApiKey\n  if (body !== undefined) headers['Content-Type'] = 'application/json'\n\n  const res = await fetch(`${baseUrl}${path}`, {\n    method,\n    headers,\n    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n  })\n\n  if (!res.ok) {\n    const err = (await res.json().catch(() => ({}))) as { message?: string; error?: string }\n    throw new Error(err.message ?? err.error ?? `Store request failed (${res.status})`)\n  }\n\n  return res.json() as Promise<T>\n}\n","import type { ParsedItem } from '../types'\n\n/**\n * Parse Meta's `products` deep-link param into line items.\n *\n * Format (already percent-decoded by URLSearchParams):\n *   `variant_123:4,variant_456:2`\n *\n * The retailer_id Meta sends back is the Medusa variant id (the Meta Shop sync\n * mapper sets each catalog item's `id` to `variant.id`), so these map straight\n * to `createLineItem({ variant_id })` — no translation needed.\n *\n * Defensive rules:\n *   - missing/!positive qty → 1\n *   - a bare `variant_x` (no `:qty`) → qty 1\n *   - duplicate variants are merged (quantities summed)\n *   - blank/garbage segments are skipped, never thrown\n */\nexport function parseProducts(raw: string): ParsedItem[] {\n  const merged = new Map<string, number>()\n\n  for (const segment of raw.split(',')) {\n    const pair = segment.trim()\n    if (!pair) continue\n\n    // lastIndexOf(':') so a variant id that itself contained a colon survives.\n    const sep = pair.lastIndexOf(':')\n    const rawId = sep === -1 ? pair : pair.slice(0, sep)\n    const rawQty = sep === -1 ? '' : pair.slice(sep + 1)\n\n    let variantId = rawId.trim()\n    try {\n      variantId = decodeURIComponent(variantId).trim()\n    } catch {\n      // already-decoded / malformed escape → keep as-is\n    }\n    if (!variantId) continue\n\n    const parsed = parseInt(rawQty, 10)\n    const quantity = Number.isFinite(parsed) && parsed > 0 ? parsed : 1\n\n    merged.set(variantId, (merged.get(variantId) ?? 0) + quantity)\n  }\n\n  return Array.from(merged, ([variant_id, quantity]) => ({ variant_id, quantity }))\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@amboras-dev/meta-shops-checkout",
+  "version": "0.2.0",
+  "description": "Meta Shops 'checkout on another website' handoff for Amboras storefronts — builds a fresh cart (line items + discount) from the deep-link URL params and activates it for checkout",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "@tanstack/react-query": ">=5"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "@tanstack/react-query": "^5.0.0",
+    "react": "^19.0.0",
+    "@types/react": "^19.0.0",
+    "@types/node": "^20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}