npm - @sceneinfrastructure/storefront-analytics - Versions diffs - 0.2.0 - Mend

@sceneinfrastructure/storefront-analytics 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README.md ADDED Viewed

@@ -0,0 +1,114 @@
+# @sceneinfrastructure/storefront-analytics
+Browser/server attribution helpers and shared schemas for Mesh
+storefronts. One publishable `pk_` token in, everything else — visit
+cookie, beacons, handoff decoration — handled inside.
+```bash
+pnpm add @sceneinfrastructure/storefront-analytics
+```
+## Tier 1 — base install
+Next.js, one component in the root layout:
+```tsx
+import { MeshAnalytics } from '@sceneinfrastructure/storefront-analytics/react'
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <body>
+        {children}
+        <MeshAnalytics
+          token={process.env.NEXT_PUBLIC_MESH_ANALYTICS_TOKEN!}
+          apiBase={process.env.NEXT_PUBLIC_MESH_API_BASE_URL!}
+          meshHosts={['checkout.mesh.ing']}
+        />
+      </body>
+    </html>
+  )
+}
+```
+No Next.js? Same behavior as a tag (point `src` at your pinned version):
+```html
+<script
+  src="https://cdn.mesh.ing/v1/m.js"
+  data-token="pk_live_..."
+  data-api-base="https://api.mesh.ing"
+  data-mesh-hosts="checkout.mesh.ing"
+></script>
+<script>mesh.track('cart.updated', { lines: [...] })</script>
+```
+The token is the publishable `pk_` key: scene-scoped and origin-pinned,
+safe for browsers. Never use an `sk_` key here.
+## Tier 2 — cart tracking
+Wherever quantity state already lives (Client Components only for the
+hook):
+```tsx
+'use client'
+import { useStorefrontAnalytics } from '@sceneinfrastructure/storefront-analytics/react'
+const { track } = useStorefrontAnalytics({
+  token: process.env.NEXT_PUBLIC_MESH_ANALYTICS_TOKEN!,
+  apiBase: process.env.NEXT_PUBLIC_MESH_API_BASE_URL!,
+})
+track('cart.updated', {
+  eventId,
+  lines: [{ saleKeyId, quantity }],
+})
+```
+Use **either** `<MeshAnalytics/>` **or** the hook per app, never both —
+the hook binds a tag-provided `window.mesh` when present so mixed setups
+never double-track.
+## Tier 3 — join to purchase
+In the backend, wherever `createCartUrl` is already called:
+```ts
+import { getAttribution } from '@sceneinfrastructure/storefront-analytics/server'
+const { visitId } = getAttribution(req)
+await mesh.createCartUrl({ eventId, items, attribution: { visitId } })
+```
+Server-emitted events (webhooks, backend cart updates) go through the
+secret route:
+```ts
+import { trackServerEvent } from '@sceneinfrastructure/storefront-analytics/server'
+await trackServerEvent({
+  apiBase: process.env.MESH_PUBLIC_API_BASE_URL!,
+  apiKey: process.env.MESH_SCENE_API_KEY!, // sk_ — server-only
+  event: { eventName: 'order.confirmed', orderId },
+})
+```
+Non-TypeScript backends use the same field names over HTTP
+(`POST /v1/analytics/track`, `POST /v1/cart-url` with `attribution`).
+## Consent
+Consent is integrator-managed. Wire the CMP state into `consent`
+(component prop, hook config, or `data-consent="false"` on the tag).
+`false` disables minting, storage, decoration, and beacons. Default is
+tracking-enabled — regional opt-in gating is the integrator's call.
+## Subpaths
+- `@sceneinfrastructure/storefront-analytics` — schemas (safe anywhere).
+- `.../client` — vanilla browser core (zero dependencies).
+- `.../react` — `<MeshAnalytics/>` + `useStorefrontAnalytics`.
+- `.../server` — Node-only helpers (`server-only` unsafe for browsers).
+- `.../schemas` — shared zod primitives (imported by the API contracts).

package/dist/chunk-6XI65T7B.js ADDED Viewed

@@ -0,0 +1,233 @@
+// src/client.ts
+var MESH_VISIT_COOKIE = "mesh_visit";
+var MESH_VISIT_COOKIE_MAX_AGE_SECONDS = 90 * 24 * 60 * 60;
+var HANDOFF_REFRESH_BEFORE_EXPIRY_MS = 5 * 60 * 1e3;
+var HANDOFF_TOKEN_TTL_MS = 10 * 60 * 1e3;
+function defaultPlatform(cookieDomain) {
+  return {
+    fetchFn: window.fetch.bind(window),
+    locationHref: typeof window.location.href === "string" ? window.location.href : "",
+    navigate: (href, target) => {
+      if (target === "_blank") {
+        window.open(href, "_blank", "noopener");
+        return;
+      }
+      window.location.assign(href);
+    },
+    now: () => Date.now(),
+    randomId: () => typeof crypto.randomUUID === "function" ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,
+    readCookie: (name) => {
+      const match = document.cookie.match(
+        new RegExp(`(?:^|;\\s*)${name}=([^;]*)`)
+      );
+      return match?.[1] ? decodeURIComponent(match[1]) : void 0;
+    },
+    sendBeacon: typeof navigator.sendBeacon === "function" ? navigator.sendBeacon.bind(navigator) : void 0,
+    writeCookie: (name, value, maxAgeSeconds) => {
+      const domain = cookieDomain ? `; Domain=${cookieDomain}` : "";
+      document.cookie = `${name}=${encodeURIComponent(value)}; Path=/; Max-Age=${maxAgeSeconds}; SameSite=Lax${domain}` + (window.location.protocol === "https:" ? "; Secure" : "");
+    }
+  };
+}
+function apiUrl(apiBase, path) {
+  return `${apiBase.replace(/\/+$/, "")}/v1${path}`;
+}
+function hostMatches(hostname, patterns) {
+  const host = hostname.toLowerCase();
+  return patterns.some((pattern) => {
+    const candidate = pattern.toLowerCase().replace(/^\./, "");
+    return host === candidate || host.endsWith(`.${candidate}`);
+  });
+}
+function clickAnchor(target) {
+  const element = target;
+  const anchor = element?.closest?.("a[href]") ?? null;
+  const href = typeof anchor?.getAttribute === "function" ? anchor.getAttribute("href") : null;
+  if (!href) return null;
+  return {
+    href,
+    target: typeof anchor?.getAttribute === "function" ? anchor.getAttribute("target") ?? null : null
+  };
+}
+function createStorefrontAnalyticsInstance(config, platform) {
+  let consent = config.consent ?? true;
+  const meshHosts = config.meshHosts ?? [];
+  let visitId = consent ? platform.readCookie(MESH_VISIT_COOKIE) : void 0;
+  let handoff;
+  function headers() {
+    return {
+      Authorization: `Bearer ${config.token}`,
+      "Content-Type": "application/json"
+    };
+  }
+  async function postTrack(eventName, props, needsResponse) {
+    const effectiveVisitId = props.visitId ?? visitId;
+    const body = JSON.stringify({
+      eventId: props.eventId ?? platform.randomId(),
+      eventName,
+      ...props.cartId ? { cartId: props.cartId } : {},
+      ...props.cartRevision !== void 0 ? { cartRevision: props.cartRevision } : {},
+      ...props.eventContractId ? { eventContractId: props.eventContractId } : {},
+      ...props.lines ? { lines: props.lines } : {},
+      ...props.referrer ? { referrer: props.referrer } : {},
+      ...props.saleKeyId ? { saleKeyId: props.saleKeyId } : {},
+      ...props.url ? { url: props.url } : {},
+      ...props.utm ? { utm: props.utm } : {},
+      ...effectiveVisitId ? { visitId: effectiveVisitId } : {}
+    });
+    const url = apiUrl(config.apiBase, "/analytics/track");
+    const response = await platform.fetchFn(url, {
+      body,
+      headers: headers(),
+      keepalive: true,
+      method: "POST"
+    });
+    if (!response.ok) return void 0;
+    return await response.json();
+  }
+  async function track(eventName, props = {}) {
+    if (!consent) return void 0;
+    const response = await postTrack(eventName, props);
+    if (response?.visitId && response.visitId !== visitId) {
+      visitId = response.visitId;
+      platform.writeCookie(
+        MESH_VISIT_COOKIE,
+        visitId,
+        MESH_VISIT_COOKIE_MAX_AGE_SECONDS
+      );
+    }
+    return response;
+  }
+  async function mintHandoff() {
+    if (!consent || !visitId) return void 0;
+    const now = platform.now();
+    if (handoff && handoff.exp - now > HANDOFF_REFRESH_BEFORE_EXPIRY_MS) {
+      return handoff.token;
+    }
+    try {
+      const response = await platform.fetchFn(
+        apiUrl(config.apiBase, "/analytics/handoff"),
+        {
+          body: JSON.stringify({ visitId }),
+          headers: headers(),
+          method: "POST"
+        }
+      );
+      if (!response.ok) return void 0;
+      const payload = await response.json();
+      if (!payload.token) return void 0;
+      handoff = { exp: now + HANDOFF_TOKEN_TTL_MS, token: payload.token };
+      return payload.token;
+    } catch {
+      return void 0;
+    }
+  }
+  async function decorateUrl(url) {
+    if (!consent || meshHosts.length === 0) return url;
+    let parsed;
+    try {
+      parsed = new URL(url, platform.locationHref);
+    } catch {
+      return url;
+    }
+    if (!hostMatches(parsed.hostname, meshHosts)) return url;
+    const token = await mintHandoff();
+    if (!token) return url;
+    const exchange = new URL("/handoff", `${parsed.protocol}//${parsed.host}`);
+    exchange.searchParams.set("token", token);
+    exchange.searchParams.set("dest", `${parsed.pathname}${parsed.search}`);
+    return exchange.toString();
+  }
+  function interceptLinks(root) {
+    const onClick = (event) => {
+      const native = event;
+      if (native.defaultPrevented || native.metaKey || native.ctrlKey || native.shiftKey || native.altKey) {
+        return;
+      }
+      const hit = clickAnchor(native.target);
+      if (!hit) return;
+      let parsed;
+      try {
+        parsed = new URL(hit.href, platform.locationHref);
+      } catch {
+        return;
+      }
+      if (!consent || !hostMatches(parsed.hostname, meshHosts)) return;
+      native.preventDefault?.();
+      void (async () => {
+        platform.navigate(await decorateUrl(hit.href), hit.target);
+      })();
+    };
+    root.addEventListener("click", onClick, true);
+    return () => {
+      root.removeEventListener("click", onClick, true);
+    };
+  }
+  function reset() {
+    visitId = void 0;
+    handoff = void 0;
+  }
+  function setConsent(next) {
+    consent = next;
+    if (!next) reset();
+  }
+  const detachers = /* @__PURE__ */ new Set();
+  function dispose() {
+    for (const detach of detachers) detach();
+    detachers.clear();
+    for (const [key, candidate] of instances) {
+      if (candidate === api) instances.delete(key);
+    }
+  }
+  function interceptingLinks(root) {
+    const detach = interceptLinks(root);
+    detachers.add(detach);
+    return () => {
+      detach();
+      detachers.delete(detach);
+    };
+  }
+  const api = {
+    decorateUrl,
+    dispose,
+    getVisitId: () => visitId,
+    interceptLinks: interceptingLinks,
+    reset,
+    setConsent,
+    track
+  };
+  return api;
+}
+var instances = /* @__PURE__ */ new Map();
+function initStorefrontAnalytics(config, platform) {
+  const key = [
+    config.apiBase,
+    config.token,
+    (config.meshHosts ?? []).join(","),
+    config.cookieDomain ?? "",
+    config.consent ?? true
+  ].join("::");
+  const existing = instances.get(key);
+  if (existing) return existing;
+  const resolved = platform ?? (typeof document === "undefined" ? void 0 : defaultPlatform(config.cookieDomain));
+  if (!resolved) {
+    throw new Error(
+      "initStorefrontAnalytics requires a DOM platform outside browsers."
+    );
+  }
+  const instance = createStorefrontAnalyticsInstance(config, resolved);
+  instances.set(key, instance);
+  if (typeof document !== "undefined") {
+    instance.interceptLinks(document);
+    void instance.track("visit.started", {
+      referrer: document.referrer || void 0,
+      url: resolved.locationHref || void 0
+    });
+  }
+  return instance;
+}
+function resetStorefrontAnalyticsInstances() {
+  instances.clear();
+}
+export { MESH_VISIT_COOKIE, createStorefrontAnalyticsInstance, defaultPlatform, initStorefrontAnalytics, resetStorefrontAnalyticsInstances };

package/dist/chunk-NTTEMMBO.js ADDED Viewed

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+// src/schemas.ts
+var storefrontAnalyticsEvents = {
+  cartUpdated: "cart.updated",
+  cartUrlCreated: "cart.url_created",
+  checkoutStarted: "checkout.started",
+  eventView: "event.viewed",
+  orderConfirmed: "order.confirmed",
+  orderExpired: "order.expired",
+  orderRefunded: "order.refunded",
+  orderReserved: "order.reserved",
+  orderVoided: "order.voided",
+  tierView: "tier.viewed",
+  visit: "visit.started"
+};
+var storefrontAnalyticsEventNameSchema = z.enum([
+  storefrontAnalyticsEvents.visit,
+  storefrontAnalyticsEvents.eventView,
+  storefrontAnalyticsEvents.tierView,
+  storefrontAnalyticsEvents.cartUpdated,
+  storefrontAnalyticsEvents.cartUrlCreated,
+  storefrontAnalyticsEvents.checkoutStarted,
+  storefrontAnalyticsEvents.orderReserved,
+  storefrontAnalyticsEvents.orderConfirmed,
+  storefrontAnalyticsEvents.orderExpired,
+  storefrontAnalyticsEvents.orderVoided,
+  storefrontAnalyticsEvents.orderRefunded
+]);
+var uuid = z.string().uuid();
+var hasNoControlCharacters = (value) => [...value].every((char) => {
+  const code = char.codePointAt(0) ?? 0;
+  return code >= 32 && code !== 127;
+});
+var trimmed = (max) => z.string().trim().min(1).max(max).refine(hasNoControlCharacters, {
+  message: "must not contain control characters"
+});
+var optionalTrimmed = (max) => z.string().trim().max(max).refine(hasNoControlCharacters, {
+  message: "must not contain control characters"
+}).transform((value) => value === "" ? void 0 : value).optional();
+var analyticsUtmSchema = z.object({
+  utm_campaign: optionalTrimmed(512),
+  utm_content: optionalTrimmed(512),
+  utm_id: optionalTrimmed(512),
+  utm_medium: optionalTrimmed(512),
+  utm_source: optionalTrimmed(512),
+  utm_term: optionalTrimmed(512)
+});
+var analyticsConsentStateSchema = z.enum([
+  "granted",
+  "denied",
+  "unknown"
+]);
+var storefrontAttributionSchema = z.object({
+  cartId: uuid.optional(),
+  cartRevision: z.number().int().nonnegative().optional(),
+  consentState: analyticsConsentStateSchema.optional(),
+  utm: analyticsUtmSchema.optional(),
+  visitId: uuid
+});
+var saleKeyIdSchema = z.string().regex(/^0x[0-9a-fA-F]+$/);
+var analyticsLineSchema = z.object({
+  quantity: z.number().int().min(1),
+  saleKeyId: saleKeyIdSchema
+});
+var serverAnalyticsLineSchema = analyticsLineSchema.extend({
+  amountUsdc: z.string().regex(/^-?\d+$/, "must be an integer base-unit string").optional(),
+  refundId: uuid.optional()
+});
+var browserEventBaseSchema = z.object({
+  cartId: uuid.optional(),
+  cartRevision: z.number().int().nonnegative().optional(),
+  eventId: uuid,
+  referrer: z.string().trim().max(2048).optional(),
+  url: z.string().trim().max(2048).optional(),
+  utm: analyticsUtmSchema.optional(),
+  visitId: uuid.optional()
+});
+var browserAnalyticsEventSchema = z.discriminatedUnion("eventName", [
+  browserEventBaseSchema.extend({
+    eventName: z.literal(storefrontAnalyticsEvents.visit)
+  }),
+  browserEventBaseSchema.extend({
+    eventContractId: trimmed(64),
+    eventName: z.literal(storefrontAnalyticsEvents.eventView)
+  }),
+  browserEventBaseSchema.extend({
+    eventName: z.literal(storefrontAnalyticsEvents.tierView),
+    saleKeyId: saleKeyIdSchema
+  }),
+  browserEventBaseSchema.extend({
+    cartId: uuid,
+    cartRevision: z.number().int().nonnegative(),
+    eventName: z.literal(storefrontAnalyticsEvents.cartUpdated),
+    lines: z.array(analyticsLineSchema).min(1).max(50)
+  })
+]);
+var trackAnalyticsEventInputSchema = z.object({
+  cartId: uuid.optional(),
+  cartRevision: z.number().int().nonnegative().optional(),
+  eventContractId: trimmed(64).optional(),
+  eventId: uuid,
+  eventName: storefrontAnalyticsEventNameSchema,
+  lines: z.array(analyticsLineSchema).max(50).optional(),
+  referrer: z.string().trim().max(2048).optional(),
+  saleKeyId: saleKeyIdSchema.optional(),
+  sceneId: trimmed(64).optional(),
+  url: z.string().trim().max(2048).optional(),
+  utm: analyticsUtmSchema.optional(),
+  visitId: uuid.optional()
+});
+var createHandoffTokenInputSchema = z.object({
+  visitId: uuid
+});
+var createHandoffTokenOutputSchema = z.object({
+  token: z.string().min(1)
+});
+export { analyticsConsentStateSchema, analyticsUtmSchema, browserAnalyticsEventSchema, createHandoffTokenInputSchema, createHandoffTokenOutputSchema, serverAnalyticsLineSchema, storefrontAnalyticsEventNameSchema, storefrontAnalyticsEvents, storefrontAttributionSchema, trackAnalyticsEventInputSchema };

package/dist/client.d.ts ADDED Viewed

@@ -0,0 +1,67 @@
+type StorefrontAnalyticsCartLine = {
+    quantity: number;
+    saleKeyId: string;
+};
+type StorefrontAnalyticsTrackProps = {
+    cartId?: string;
+    cartRevision?: number;
+    eventContractId?: string;
+    eventId?: string;
+    lines?: Array<StorefrontAnalyticsCartLine>;
+    referrer?: string;
+    saleKeyId?: string;
+    url?: string;
+    utm?: Record<string, string | undefined>;
+    visitId?: string;
+};
+type StorefrontAnalyticsConfig = {
+    /** Publishable `pk_` key. Scene-scoped and origin-pinned. */
+    token: string;
+    /** Mesh API origin, e.g. `https://api.mesh.ing` (no `/v1` suffix). */
+    apiBase: string;
+    /** Hosted Mesh domains whose links get handoff decoration. */
+    meshHosts?: Array<string>;
+    /** Cookie domain override. Defaults to the current hostname. */
+    cookieDomain?: string;
+    /** Integrator CMP wiring. `false` disables mint, storage, beacons. */
+    consent?: boolean;
+};
+type StorefrontAnalyticsTrackResponse = {
+    accepted: boolean;
+    visitId: string;
+};
+type EventTargetLike = {
+    addEventListener(type: string, listener: (event: unknown) => void, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener(type: string, listener: (event: unknown) => void, options?: boolean | AddEventListenerOptions): void;
+};
+/** Seams for unit tests; defaults bind browser globals. */
+type StorefrontAnalyticsPlatform = {
+    fetchFn: typeof fetch;
+    locationHref: string;
+    navigate: (href: string, target?: string | null) => void;
+    now: () => number;
+    randomId: () => string;
+    readCookie: (name: string) => string | undefined;
+    sendBeacon?: (url: string, body: Blob) => boolean;
+    writeCookie: (name: string, value: string, maxAgeSeconds: number) => void;
+};
+declare const MESH_VISIT_COOKIE = "mesh_visit";
+declare function defaultPlatform(cookieDomain?: string): StorefrontAnalyticsPlatform;
+type StorefrontAnalyticsInstance = {
+    track: (eventName: string, props?: StorefrontAnalyticsTrackProps) => Promise<StorefrontAnalyticsTrackResponse | undefined>;
+    getVisitId: () => string | undefined;
+    decorateUrl: (url: string) => Promise<string>;
+    interceptLinks: (root: EventTargetLike) => () => void;
+    reset: () => void;
+    /** Flip consent on the live instance (CMP flows). `false` also drops
+     * any minted visit, so revoked consent stops tracking immediately. */
+    setConsent: (next: boolean) => void;
+    /** Detach listeners and drop memoization. Call on provider unmount. */
+    dispose: () => void;
+};
+declare function createStorefrontAnalyticsInstance(config: StorefrontAnalyticsConfig, platform: StorefrontAnalyticsPlatform): StorefrontAnalyticsInstance;
+declare function initStorefrontAnalytics(config: StorefrontAnalyticsConfig, platform?: StorefrontAnalyticsPlatform): StorefrontAnalyticsInstance;
+/** Test-only: drop memoized singletons between cases. */
+declare function resetStorefrontAnalyticsInstances(): void;
+export { type EventTargetLike, MESH_VISIT_COOKIE, type StorefrontAnalyticsCartLine, type StorefrontAnalyticsConfig, type StorefrontAnalyticsInstance, type StorefrontAnalyticsPlatform, type StorefrontAnalyticsTrackProps, type StorefrontAnalyticsTrackResponse, createStorefrontAnalyticsInstance, defaultPlatform, initStorefrontAnalytics, resetStorefrontAnalyticsInstances };

package/dist/client.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { MESH_VISIT_COOKIE, createStorefrontAnalyticsInstance, defaultPlatform, initStorefrontAnalytics, resetStorefrontAnalyticsInstances } from './chunk-6XI65T7B.js';

package/dist/index.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export { AnalyticsConsentState, AnalyticsUtm, BrowserAnalyticsEvent, CreateHandoffTokenInput, CreateHandoffTokenOutput, ServerAnalyticsLine, StorefrontAnalyticsEventName, StorefrontAttribution, TrackAnalyticsEventInput, analyticsConsentStateSchema, analyticsUtmSchema, browserAnalyticsEventSchema, createHandoffTokenInputSchema, createHandoffTokenOutputSchema, serverAnalyticsLineSchema, storefrontAnalyticsEventNameSchema, storefrontAnalyticsEvents, storefrontAttributionSchema, trackAnalyticsEventInputSchema } from './schemas.js';
2	+ import 'zod';

package/dist/index.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { analyticsConsentStateSchema, analyticsUtmSchema, browserAnalyticsEventSchema, createHandoffTokenInputSchema, createHandoffTokenOutputSchema, serverAnalyticsLineSchema, storefrontAnalyticsEventNameSchema, storefrontAnalyticsEvents, storefrontAttributionSchema, trackAnalyticsEventInputSchema } from './chunk-NTTEMMBO.js';

package/dist/m.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ var meshAnalyticsBundle=(function(exports){'use strict';var k="mesh_visit";function P(t){return {fetchFn:window.fetch.bind(window),locationHref:typeof window.location.href=="string"?window.location.href:"",navigate:(n,r)=>{if(r==="_blank"){window.open(n,"_blank","noopener");return}window.location.assign(n);},now:()=>Date.now(),randomId:()=>typeof crypto.randomUUID=="function"?crypto.randomUUID():`${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`,readCookie:n=>{let r=document.cookie.match(new RegExp(`(?:^\|;\\s)${n}=([^;])`));return r?.[1]?decodeURIComponent(r[1]):void 0},sendBeacon:typeof navigator.sendBeacon=="function"?navigator.sendBeacon.bind(navigator):void 0,writeCookie:(n,r,c)=>{let i=t?`; Domain=${t}`:"";document.cookie=`${n}=${encodeURIComponent(r)}; Path=/; Max-Age=${c}; SameSite=Lax${i}`+(window.location.protocol==="https:"?"; Secure":"");}}}function S(t,n){return `${t.replace(/\/+$/,"")}/v1${n}`}function w(t,n){let r=t.toLowerCase();return n.some(c=>{let i=c.toLowerCase().replace(/^\./,"");return r===i\|\|r.endsWith(`.${i}`)})}function x(t){let r=t?.closest?.("a[href]")??null,c=typeof r?.getAttribute=="function"?r.getAttribute("href"):null;return c?{href:c,target:typeof r?.getAttribute=="function"?r.getAttribute("target")??null:null}:null}function K(t,n){let r=t.consent??true,c=t.meshHosts??[],i=r?n.readCookie(k):void 0,d;function m(){return {Authorization:`Bearer ${t.token}`,"Content-Type":"application/json"}}async function C(o,e,s){let a=e.visitId??i,f=JSON.stringify({eventId:e.eventId??n.randomId(),eventName:o,...e.cartId?{cartId:e.cartId}:{},...e.cartRevision!==void 0?{cartRevision:e.cartRevision}:{},...e.eventContractId?{eventContractId:e.eventContractId}:{},...e.lines?{lines:e.lines}:{},...e.referrer?{referrer:e.referrer}:{},...e.saleKeyId?{saleKeyId:e.saleKeyId}:{},...e.url?{url:e.url}:{},...e.utm?{utm:e.utm}:{},...a?{visitId:a}:{}}),u=S(t.apiBase,"/analytics/track");let I=await n.fetchFn(u,{body:f,headers:m(),keepalive:true,method:"POST"});if(I.ok)return await I.json()}async function _(o,e={}){if(!r)return;let s=await C(o,e);return s?.visitId&&s.visitId!==i&&(i=s.visitId,n.writeCookie(k,i,7776e3)),s}async function L(){if(!r\|\|!i)return;let o=n.now();if(d&&d.exp-o>3e5)return d.token;try{let e=await n.fetchFn(S(t.apiBase,"/analytics/handoff"),{body:JSON.stringify({visitId:i}),headers:m(),method:"POST"});if(!e.ok)return;let s=await e.json();return s.token?(d={exp:o+6e5,token:s.token},s.token):void 0}catch{return}}async function v(o){if(!r\|\|c.length===0)return o;let e;try{e=new URL(o,n.locationHref);}catch{return o}if(!w(e.hostname,c))return o;let s=await L();if(!s)return o;let a=new URL("/handoff",`${e.protocol}//${e.host}`);return a.searchParams.set("token",s),a.searchParams.set("dest",`${e.pathname}${e.search}`),a.toString()}function T(o){let e=s=>{let a=s;if(a.defaultPrevented\|\|a.metaKey\|\|a.ctrlKey\|\|a.shiftKey\|\|a.altKey)return;let f=x(a.target);if(!f)return;let u;try{u=new URL(f.href,n.locationHref);}catch{return}!r\|\|!w(u.hostname,c)\|\|(a.preventDefault?.(),(async()=>n.navigate(await v(f.href),f.target))());};return o.addEventListener("click",e,true),()=>{o.removeEventListener("click",e,true);}}function h(){i=void 0,d=void 0;}function H(o){r=o,o\|\|h();}let l=new Set;function O(){for(let o of l)o();l.clear();for(let[o,e]of g)e===p&&g.delete(o);}function R(o){let e=T(o);return l.add(e),()=>{e(),l.delete(e);}}let p={decorateUrl:v,dispose:O,getVisitId:()=>i,interceptLinks:R,reset:h,setConsent:H,track:_};return p}var g=new Map;function A(t,n){let r=[t.apiBase,t.token,(t.meshHosts??[]).join(","),t.cookieDomain??"",t.consent??true].join("::"),c=g.get(r);if(c)return c;let i=(typeof document>"u"?void 0:P(t.cookieDomain));if(!i)throw new Error("initStorefrontAnalytics requires a DOM platform outside browsers.");let d=K(t,i);return g.set(r,d),typeof document<"u"&&(d.interceptLinks(document),d.track("visit.started",{referrer:document.referrer\|\|void 0,url:i.locationHref\|\|void 0})),d}function y(t){return document.currentScript?.dataset[t]}var E=y("token")??"",b=y("apiBase")??"",B=(y("meshHosts")??"").split(",").map(t=>t.trim()).filter(t=>t.length>0),U=y("consent")!=="false";if(E&&b){let t=A({apiBase:b,consent:U,meshHosts:B,token:E});window.mesh={decorateUrl:n=>t.decorateUrl(n),getVisitId:()=>t.getVisitId(),track:(n,r={})=>t.track(n,r)};}
2	+ exports.MESH_VISIT_COOKIE=k;return exports;})({});

package/dist/react.d.ts ADDED Viewed

@@ -0,0 +1,16 @@
+import { ReactElement } from 'react';
+import { StorefrontAnalyticsConfig, StorefrontAnalyticsInstance } from './client.js';
+declare const MESH_CDN_URL = "https://cdn.mesh.ing/v1/m.js";
+declare function MeshAnalytics({ apiBase, cdnUrl, consent, cookieDomain, meshHosts, token, }: StorefrontAnalyticsConfig & {
+    cdnUrl?: string;
+}): ReactElement;
+type UseStorefrontAnalytics = {
+    decorateUrl: (url: string) => Promise<string>;
+    getVisitId: () => string | undefined;
+    ready: boolean;
+    track: StorefrontAnalyticsInstance['track'];
+};
+declare function useStorefrontAnalytics(config: StorefrontAnalyticsConfig): UseStorefrontAnalytics;
+export { MESH_CDN_URL, MeshAnalytics, type UseStorefrontAnalytics, useStorefrontAnalytics };

package/dist/react.js ADDED Viewed

@@ -0,0 +1,77 @@
+import { initStorefrontAnalytics } from './chunk-6XI65T7B.js';
+import Script from 'next/script';
+import { useMemo, useEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+var MESH_CDN_URL = "https://cdn.mesh.ing/v1/m.js";
+function MeshAnalytics({
+  apiBase,
+  cdnUrl = MESH_CDN_URL,
+  consent = true,
+  cookieDomain,
+  meshHosts = [],
+  token
+}) {
+  return /* @__PURE__ */ jsx(
+    Script,
+    {
+      "data-api-base": apiBase,
+      "data-consent": consent ? void 0 : "false",
+      "data-cookie-domain": cookieDomain,
+      "data-mesh-hosts": meshHosts.join(","),
+      "data-token": token,
+      src: cdnUrl,
+      strategy: "afterInteractive"
+    }
+  );
+}
+function windowMesh() {
+  if (typeof window === "undefined") return void 0;
+  const candidate = window.mesh;
+  if (!candidate || typeof candidate !== "object") return void 0;
+  const mesh = candidate;
+  if (typeof mesh.track !== "function" || typeof mesh.getVisitId !== "function" || typeof mesh.decorateUrl !== "function") {
+    return void 0;
+  }
+  return mesh;
+}
+function useStorefrontAnalytics(config) {
+  const { apiBase, consent, cookieDomain, meshHosts, token } = config;
+  const meshHostsKey = (meshHosts ?? []).join(",");
+  const instance = useMemo(() => {
+    if (typeof window === "undefined") {
+      throw new Error("useStorefrontAnalytics requires a browser.");
+    }
+    const cdn = windowMesh();
+    if (cdn) return cdn;
+    return initStorefrontAnalytics({
+      apiBase,
+      consent,
+      cookieDomain,
+      meshHosts: meshHostsKey.length > 0 ? meshHostsKey.split(",") : [],
+      token
+    });
+  }, [apiBase, consent, cookieDomain, meshHostsKey, token]);
+  useEffect(() => {
+    instance.setConsent(consent ?? true);
+    return () => {
+      instance.dispose();
+    };
+  }, [instance, consent]);
+  if (typeof window === "undefined") {
+    return {
+      decorateUrl: async (url) => url,
+      getVisitId: () => void 0,
+      ready: false,
+      track: async () => void 0
+    };
+  }
+  return {
+    decorateUrl: (url) => instance.decorateUrl(url),
+    getVisitId: () => instance.getVisitId(),
+    ready: true,
+    track: (eventName, props) => instance.track(eventName, props)
+  };
+}
+export { MESH_CDN_URL, MeshAnalytics, useStorefrontAnalytics };

package/dist/schemas.d.ts ADDED Viewed

@@ -0,0 +1,189 @@
+import { z } from 'zod';
+declare const storefrontAnalyticsEvents: {
+    readonly cartUpdated: "cart.updated";
+    readonly cartUrlCreated: "cart.url_created";
+    readonly checkoutStarted: "checkout.started";
+    readonly eventView: "event.viewed";
+    readonly orderConfirmed: "order.confirmed";
+    readonly orderExpired: "order.expired";
+    readonly orderRefunded: "order.refunded";
+    readonly orderReserved: "order.reserved";
+    readonly orderVoided: "order.voided";
+    readonly tierView: "tier.viewed";
+    readonly visit: "visit.started";
+};
+declare const storefrontAnalyticsEventNameSchema: z.ZodEnum<{
+    "cart.updated": "cart.updated";
+    "cart.url_created": "cart.url_created";
+    "checkout.started": "checkout.started";
+    "event.viewed": "event.viewed";
+    "order.confirmed": "order.confirmed";
+    "order.expired": "order.expired";
+    "order.refunded": "order.refunded";
+    "order.reserved": "order.reserved";
+    "order.voided": "order.voided";
+    "tier.viewed": "tier.viewed";
+    "visit.started": "visit.started";
+}>;
+type StorefrontAnalyticsEventName = z.infer<typeof storefrontAnalyticsEventNameSchema>;
+declare const analyticsUtmSchema: z.ZodObject<{
+    utm_campaign: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    utm_content: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    utm_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    utm_medium: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    utm_source: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    utm_term: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+}, z.core.$strip>;
+type AnalyticsUtm = z.infer<typeof analyticsUtmSchema>;
+declare const analyticsConsentStateSchema: z.ZodEnum<{
+    granted: "granted";
+    denied: "denied";
+    unknown: "unknown";
+}>;
+type AnalyticsConsentState = z.infer<typeof analyticsConsentStateSchema>;
+declare const storefrontAttributionSchema: z.ZodObject<{
+    cartId: z.ZodOptional<z.ZodString>;
+    cartRevision: z.ZodOptional<z.ZodNumber>;
+    consentState: z.ZodOptional<z.ZodEnum<{
+        granted: "granted";
+        denied: "denied";
+        unknown: "unknown";
+    }>>;
+    utm: z.ZodOptional<z.ZodObject<{
+        utm_campaign: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_content: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_medium: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_source: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_term: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    }, z.core.$strip>>;
+    visitId: z.ZodString;
+}, z.core.$strip>;
+type StorefrontAttribution = z.infer<typeof storefrontAttributionSchema>;
+declare const serverAnalyticsLineSchema: z.ZodObject<{
+    quantity: z.ZodNumber;
+    saleKeyId: z.ZodString;
+    amountUsdc: z.ZodOptional<z.ZodString>;
+    refundId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ServerAnalyticsLine = z.infer<typeof serverAnalyticsLineSchema>;
+declare const browserAnalyticsEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    cartId: z.ZodOptional<z.ZodString>;
+    cartRevision: z.ZodOptional<z.ZodNumber>;
+    eventId: z.ZodString;
+    referrer: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    utm: z.ZodOptional<z.ZodObject<{
+        utm_campaign: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_content: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_medium: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_source: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_term: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    }, z.core.$strip>>;
+    visitId: z.ZodOptional<z.ZodString>;
+    eventName: z.ZodLiteral<"visit.started">;
+}, z.core.$strip>, z.ZodObject<{
+    cartId: z.ZodOptional<z.ZodString>;
+    cartRevision: z.ZodOptional<z.ZodNumber>;
+    eventId: z.ZodString;
+    referrer: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    utm: z.ZodOptional<z.ZodObject<{
+        utm_campaign: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_content: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_medium: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_source: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_term: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    }, z.core.$strip>>;
+    visitId: z.ZodOptional<z.ZodString>;
+    eventContractId: z.ZodString;
+    eventName: z.ZodLiteral<"event.viewed">;
+}, z.core.$strip>, z.ZodObject<{
+    cartId: z.ZodOptional<z.ZodString>;
+    cartRevision: z.ZodOptional<z.ZodNumber>;
+    eventId: z.ZodString;
+    referrer: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    utm: z.ZodOptional<z.ZodObject<{
+        utm_campaign: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_content: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_medium: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_source: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_term: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    }, z.core.$strip>>;
+    visitId: z.ZodOptional<z.ZodString>;
+    eventName: z.ZodLiteral<"tier.viewed">;
+    saleKeyId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    eventId: z.ZodString;
+    referrer: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    utm: z.ZodOptional<z.ZodObject<{
+        utm_campaign: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_content: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_medium: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_source: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_term: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    }, z.core.$strip>>;
+    visitId: z.ZodOptional<z.ZodString>;
+    cartId: z.ZodString;
+    cartRevision: z.ZodNumber;
+    eventName: z.ZodLiteral<"cart.updated">;
+    lines: z.ZodArray<z.ZodObject<{
+        quantity: z.ZodNumber;
+        saleKeyId: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "eventName">;
+type BrowserAnalyticsEvent = z.infer<typeof browserAnalyticsEventSchema>;
+declare const trackAnalyticsEventInputSchema: z.ZodObject<{
+    cartId: z.ZodOptional<z.ZodString>;
+    cartRevision: z.ZodOptional<z.ZodNumber>;
+    eventContractId: z.ZodOptional<z.ZodString>;
+    eventId: z.ZodString;
+    eventName: z.ZodEnum<{
+        "cart.updated": "cart.updated";
+        "cart.url_created": "cart.url_created";
+        "checkout.started": "checkout.started";
+        "event.viewed": "event.viewed";
+        "order.confirmed": "order.confirmed";
+        "order.expired": "order.expired";
+        "order.refunded": "order.refunded";
+        "order.reserved": "order.reserved";
+        "order.voided": "order.voided";
+        "tier.viewed": "tier.viewed";
+        "visit.started": "visit.started";
+    }>;
+    lines: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        quantity: z.ZodNumber;
+        saleKeyId: z.ZodString;
+    }, z.core.$strip>>>;
+    referrer: z.ZodOptional<z.ZodString>;
+    saleKeyId: z.ZodOptional<z.ZodString>;
+    sceneId: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    utm: z.ZodOptional<z.ZodObject<{
+        utm_campaign: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_content: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_id: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_medium: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_source: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+        utm_term: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
+    }, z.core.$strip>>;
+    visitId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type TrackAnalyticsEventInput = z.infer<typeof trackAnalyticsEventInputSchema>;
+declare const createHandoffTokenInputSchema: z.ZodObject<{
+    visitId: z.ZodString;
+}, z.core.$strip>;
+type CreateHandoffTokenInput = z.infer<typeof createHandoffTokenInputSchema>;
+declare const createHandoffTokenOutputSchema: z.ZodObject<{
+    token: z.ZodString;
+}, z.core.$strip>;
+type CreateHandoffTokenOutput = z.infer<typeof createHandoffTokenOutputSchema>;
+export { type AnalyticsConsentState, type AnalyticsUtm, type BrowserAnalyticsEvent, type CreateHandoffTokenInput, type CreateHandoffTokenOutput, type ServerAnalyticsLine, type StorefrontAnalyticsEventName, type StorefrontAttribution, type TrackAnalyticsEventInput, analyticsConsentStateSchema, analyticsUtmSchema, browserAnalyticsEventSchema, createHandoffTokenInputSchema, createHandoffTokenOutputSchema, serverAnalyticsLineSchema, storefrontAnalyticsEventNameSchema, storefrontAnalyticsEvents, storefrontAttributionSchema, trackAnalyticsEventInputSchema };

package/dist/schemas.js ADDED Viewed

	@@ -0,0 +1 @@
1	+ export { analyticsConsentStateSchema, analyticsUtmSchema, browserAnalyticsEventSchema, createHandoffTokenInputSchema, createHandoffTokenOutputSchema, serverAnalyticsLineSchema, storefrontAnalyticsEventNameSchema, storefrontAnalyticsEvents, storefrontAttributionSchema, trackAnalyticsEventInputSchema } from './chunk-NTTEMMBO.js';

package/dist/server.d.ts ADDED Viewed

@@ -0,0 +1,46 @@
+/** Mint a visit id server-side (e.g. for the first backend-seen shopper). */
+declare function createVisitId(): `${string}-${string}-${string}-${string}-${string}`;
+/**
+ * Read attribution from an incoming request (first-party `mesh_visit`
+ * cookie). Returns the visit for the Storefront API passthrough; the
+ * backend merges its own cart state around it.
+ */
+declare function getAttribution(req: {
+    headers: {
+        get: (name: string) => string | null;
+    };
+}): {
+    visitId: string | undefined;
+};
+type TrackServerEventInput = {
+    amountUsdc?: string;
+    cartId?: string;
+    cartRevision?: number;
+    eventContractId?: string;
+    eventId?: string;
+    eventName: string;
+    lines?: Array<{
+        quantity: number;
+        saleKeyId: string;
+    }>;
+    orderId?: string;
+    saleKeyId?: string;
+    url?: string;
+    utm?: Record<string, string | undefined>;
+    visitId?: string;
+};
+/**
+ * Emit a server-side attribution event (webhook conversions, backend
+ * cart updates). Uses the secret `sk_` route — server-only.
+ */
+declare function trackServerEvent(input: {
+    apiBase: string;
+    apiKey: string;
+    event: TrackServerEventInput;
+    fetcher?: typeof fetch;
+}): Promise<{
+    accepted: boolean;
+    visitId: string;
+}>;
+export { type TrackServerEventInput, createVisitId, getAttribution, trackServerEvent };

package/dist/server.js ADDED Viewed

@@ -0,0 +1,46 @@
+import { randomUUID } from 'crypto';
+// src/server.ts
+function createVisitId() {
+  return randomUUID();
+}
+function parseCookies(header) {
+  const cookies = /* @__PURE__ */ new Map();
+  if (!header) return cookies;
+  for (const part of header.split(";")) {
+    const index = part.indexOf("=");
+    if (index <= 0) continue;
+    const name = part.slice(0, index).trim();
+    const value = part.slice(index + 1).trim();
+    if (name) cookies.set(name, decodeURIComponent(value));
+  }
+  return cookies;
+}
+function getAttribution(req) {
+  const visitId = parseCookies(req.headers.get("cookie")).get("mesh_visit");
+  return { visitId };
+}
+async function trackServerEvent(input) {
+  const response = await (input.fetcher ?? fetch)(
+    `${input.apiBase.replace(/\/+$/, "")}/v1/analytics/track/server`,
+    {
+      body: JSON.stringify({
+        eventId: input.event.eventId ?? randomUUID(),
+        ...input.event
+      }),
+      headers: {
+        Authorization: `Bearer ${input.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      method: "POST"
+    }
+  );
+  if (!response.ok) {
+    throw new Error(
+      `Storefront analytics server track failed with status ${response.status}.`
+    );
+  }
+  return await response.json();
+}
+export { createVisitId, getAttribution, trackServerEvent };

package/package.json ADDED Viewed

@@ -0,0 +1,109 @@
+{
+  "author": "Gatekeeper Team",
+  "description": "Browser/server analytics helpers and shared schemas for Mesh storefront attribution",
+  "devDependencies": {
+    "@types/node": "^22.19.3",
+    "@types/react": "19.2.7",
+    "@types/react-dom": "19.2.3",
+    "next": "15.5.25",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.6",
+    "zod": "4.0.17"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/client.js",
+      "types": "./dist/client.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react.js",
+      "types": "./dist/react.d.ts"
+    },
+    "./schemas": {
+      "import": "./dist/schemas.js",
+      "types": "./dist/schemas.d.ts"
+    },
+    "./server": {
+      "import": "./dist/server.js",
+      "types": "./dist/server.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*.d.ts",
+    "dist/**/*.js",
+    "README.md"
+  ],
+  "keywords": [
+    "mesh",
+    "storefront",
+    "analytics",
+    "typescript"
+  ],
+  "license": "AGPL-3.0",
+  "main": "./dist/index.js",
+  "name": "@sceneinfrastructure/storefront-analytics",
+  "peerDependencies": {
+    "next": "15.5.25",
+    "react": "~19.2.3",
+    "zod": "4.0.17"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "private": false,
+  "publishConfig": {
+    "@sceneinfrastructure:registry": "https://registry.npmjs.org",
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "directory": "packages/storefront-analytics",
+    "type": "git",
+    "url": "https://github.com/sceneinfrastructure/gatekeeper"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/index.d.ts"
+      ],
+      "client": [
+        "dist/client.d.ts"
+      ],
+      "react": [
+        "dist/react.d.ts"
+      ],
+      "schemas": [
+        "dist/schemas.d.ts"
+      ],
+      "server": [
+        "dist/server.d.ts"
+      ]
+    }
+  },
+  "typings": "./dist/index.d.ts",
+  "version": "0.2.0",
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "turbo:dev": "tsup --watch",
+    "turbo:setup:dev": "wait-on dist/index.js",
+    "typecheck": "tsc --noEmit"
+  }
+}