@amboras-dev/snapchat-ads 2.0.0

package/dist/chunk-PK23QMZT.mjs

@@ -0,0 +1,30 @@
+// src/get-config.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;
+  if (key === "NEXT_PUBLIC_STORE_ID") return process.env.NEXT_PUBLIC_STORE_ID;
+  return void 0;
+}
+async function getSnapchatAdsConfig(options = {}) {
+  const baseUrl = options.baseUrl ?? resolveEnv("NEXT_PUBLIC_MEDUSA_BACKEND_URL") ?? "http://localhost:9000";
+  const publishableKey = options.publishableApiKey ?? resolveEnv("NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY");
+  const storeId = options.storeId ?? resolveEnv("NEXT_PUBLIC_STORE_ID");
+  try {
+    const res = await fetch(`${baseUrl}/store/snapchat-ads/config`, {
+      headers: {
+        ...storeId ? { "X-Store-Environment-ID": storeId } : {},
+        ...publishableKey ? { "x-publishable-api-key": publishableKey } : {}
+      },
+      next: { revalidate: 60 }
+    });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+
+export {
+  getSnapchatAdsConfig
+};
+//# sourceMappingURL=chunk-PK23QMZT.mjs.map

package/dist/chunk-PK23QMZT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/get-config.ts"],"sourcesContent":["import type { SnapchatAdsPublicConfig } from './types'\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  if (key === 'NEXT_PUBLIC_STORE_ID') return process.env.NEXT_PUBLIC_STORE_ID\n  return undefined\n}\n\ninterface GetSnapchatAdsConfigOptions {\n  baseUrl?: string\n  publishableApiKey?: string\n  storeId?: string\n}\n\n/**\n * Fetch the non-secret Snapchat Ads config from the Medusa Store API. Returns\n * `null` when the store isn't wired up, when the publishable key is missing,\n * or on any transport error - callers should treat `null` as \"plugin\n * off\" and skip event firing.\n *\n * NEVER surfaces `snap_conversion_api_token` or `snap_ad_account_id` -\n * those live only on the Medusa side and never leave the server.\n */\nexport async function getSnapchatAdsConfig(\n  options: GetSnapchatAdsConfigOptions = {},\n): Promise<SnapchatAdsPublicConfig | null> {\n  const baseUrl = options.baseUrl ?? resolveEnv('NEXT_PUBLIC_MEDUSA_BACKEND_URL') ?? 'http://localhost:9000'\n  const publishableKey = options.publishableApiKey ?? resolveEnv('NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY')\n  const storeId = options.storeId ?? resolveEnv('NEXT_PUBLIC_STORE_ID')\n\n  try {\n    // `next` is a Next.js fetch extension for cache revalidation - ignored outside Next.js\n    const res = await fetch(`${baseUrl}/store/snapchat-ads/config`, {\n      headers: {\n        ...(storeId ? { 'X-Store-Environment-ID': storeId } : {}),\n        ...(publishableKey ? { 'x-publishable-api-key': publishableKey } : {}),\n      },\n      next: { revalidate: 60 },\n    } as RequestInit)\n    if (!res.ok) return null\n    return (await res.json()) as SnapchatAdsPublicConfig\n  } catch {\n    return null\n  }\n}\n"],"mappings":";AAEA,SAAS,WAAW,KAAiC;AACnD,MAAI,QAAQ,iCAAkC,QAAO,QAAQ,IAAI;AACjE,MAAI,QAAQ,qCAAsC,QAAO,QAAQ,IAAI;AACrE,MAAI,QAAQ,uBAAwB,QAAO,QAAQ,IAAI;AACvD,SAAO;AACT;AAiBA,eAAsB,qBACpB,UAAuC,CAAC,GACC;AACzC,QAAM,UAAU,QAAQ,WAAW,WAAW,gCAAgC,KAAK;AACnF,QAAM,iBAAiB,QAAQ,qBAAqB,WAAW,oCAAoC;AACnG,QAAM,UAAU,QAAQ,WAAW,WAAW,sBAAsB;AAEpE,MAAI;AAEF,UAAM,MAAM,MAAM,MAAM,GAAG,OAAO,8BAA8B;AAAA,MAC9D,SAAS;AAAA,QACP,GAAI,UAAU,EAAE,0BAA0B,QAAQ,IAAI,CAAC;AAAA,QACvD,GAAI,iBAAiB,EAAE,yBAAyB,eAAe,IAAI,CAAC;AAAA,MACtE;AAAA,MACA,MAAM,EAAE,YAAY,GAAG;AAAA,IACzB,CAAgB;AAChB,QAAI,CAAC,IAAI,GAAI,QAAO;AACpB,WAAQ,MAAM,IAAI,KAAK;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/get-config-DmAUgsFJ.d.mts

@@ -0,0 +1,108 @@
+/**
+ * Non-secret Snapchat Ads configuration exposed to the browser via
+ * `/store/snapchat-ads/config`. Never contains `snap_conversion_api_token`
+ * or `snap_ad_account_id` - those live only on the Medusa side and never
+ * leave the server.
+ */
+interface SnapchatAdsPublicConfig {
+    snap_pixel_id: string;
+    enabled: boolean;
+    track_page_view: boolean;
+    track_view_content: boolean;
+    track_add_cart: boolean;
+    track_start_checkout: boolean;
+    track_purchase: boolean;
+    test_mode?: boolean;
+}
+/**
+ * Snap Conversions API v3 canonical event names (UPPER_SNAKE_CASE).
+ * Sent verbatim on both the browser Pixel call (`snaptr('track', <name>, ...)`)
+ * and the CAPI wire body (`event_name`). Snap dedups by
+ * (event_name, event_id) within 48h, so the strings MUST match exactly.
+ */
+type SnapEventName = 'PAGE_VIEW' | 'VIEW_CONTENT' | 'ADD_CART' | 'START_CHECKOUT' | 'PURCHASE';
+/**
+ * User-identifying fields for Snap CAPI. All of `em`/`ph`/`madid`/`external_id`
+ * MUST be SHA-256 hex-lowercase-trimmed BEFORE being placed in the CAPI wire
+ * body. The Amboras plugin does hashing on the Medusa side, so the browser-
+ * facing payload carries raw values (or the click-id / ip / user-agent
+ * fields that Snap wants raw). `sc_click_id` is sent RAW - Snap matches it
+ * against their own click table server-side.
+ */
+interface SnapUserData {
+    /** SHA-256 hex lowercase, lowercase-trimmed email BEFORE hashing. */
+    email?: string;
+    /** SHA-256 hex lowercase, E.164 digits-only phone BEFORE hashing (strip leading 00/0, whitespace, +, -, (, )). */
+    phone?: string;
+    /** SHA-256 hex lowercase, lowercase iOS IDFA / Android AAID (keep hyphens) BEFORE hashing. */
+    madid?: string;
+    /** SHA-256 hex lowercase (hash recommended by Snap, but not strictly required). */
+    externalId?: string;
+    /** Snap click id - sent RAW, never hashed. */
+    scClickId?: string;
+    /** First-party cookie id (`sc_at`) - sent RAW, never hashed. */
+    scCookie1?: string;
+}
+/**
+ * Snap CAPI v3 custom-data shape - `value`, `item_price`, and `quantity` are
+ * STRING-typed per the v3 wire spec (research memo caveat #3). Numeric-typed
+ * fields cause the event to silently drop or under-report. `num_items` is
+ * numeric though - inconsistent, but that's what Snap's docs show.
+ *
+ * Amounts are in MAJOR units (e.g. `"10.50"` INR, not `"1050"` paise). Snap
+ * does NOT use Stripe's cents convention.
+ */
+interface SnapCustomData {
+    /** ISO 4217 3-letter uppercase (e.g. `USD`, `INR`, `EUR`). */
+    currency?: string;
+    /** Major-unit amount serialized as a STRING (e.g. `"10.50"`). */
+    value?: string;
+    /**
+     * Order/transaction id echoed by the PURCHASE event only. Matches the
+     * Pixel-side `transaction_id`; Snap dedups on this pair within a 30-day
+     * window on PURCHASE (separately from the 48h event_id dedup).
+     */
+    orderId?: string;
+    contentIds?: string[];
+    /** NUMBER, not string. Snap's docs show num_items as numeric. */
+    numItems?: number;
+    contents?: Array<{
+        id: string;
+        /** Quantity serialized as a STRING per v3 spec. */
+        quantity: string;
+        /** item_price serialized as a STRING per v3 spec. */
+        item_price?: string;
+    }>;
+}
+/**
+ * Payload posted from the storefront to `/api/snapchat-ads/events`. The
+ * storefront proxy enriches with `client_ip_address` + `client_user_agent`
+ * and forwards to Medusa `/store/snapchat-ads/capi` with the same
+ * `event_id`. Snap matches (event_name, event_id) within 48h for browser
+ * vs server dedup.
+ */
+interface SnapEventPayload {
+    eventName: SnapEventName;
+    eventId: string;
+    eventSourceUrl: string;
+    userData: SnapUserData;
+    customData?: SnapCustomData;
+}
+
+interface GetSnapchatAdsConfigOptions {
+    baseUrl?: string;
+    publishableApiKey?: string;
+    storeId?: string;
+}
+/**
+ * Fetch the non-secret Snapchat Ads config from the Medusa Store API. Returns
+ * `null` when the store isn't wired up, when the publishable key is missing,
+ * or on any transport error - callers should treat `null` as "plugin
+ * off" and skip event firing.
+ *
+ * NEVER surfaces `snap_conversion_api_token` or `snap_ad_account_id` -
+ * those live only on the Medusa side and never leave the server.
+ */
+declare function getSnapchatAdsConfig(options?: GetSnapchatAdsConfigOptions): Promise<SnapchatAdsPublicConfig | null>;
+
+export { type SnapEventPayload as S, type SnapUserData as a, type SnapEventName as b, type SnapCustomData as c, type SnapchatAdsPublicConfig as d, getSnapchatAdsConfig as g };

package/dist/get-config-DmAUgsFJ.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Non-secret Snapchat Ads configuration exposed to the browser via
+ * `/store/snapchat-ads/config`. Never contains `snap_conversion_api_token`
+ * or `snap_ad_account_id` - those live only on the Medusa side and never
+ * leave the server.
+ */
+interface SnapchatAdsPublicConfig {
+    snap_pixel_id: string;
+    enabled: boolean;
+    track_page_view: boolean;
+    track_view_content: boolean;
+    track_add_cart: boolean;
+    track_start_checkout: boolean;
+    track_purchase: boolean;
+    test_mode?: boolean;
+}
+/**
+ * Snap Conversions API v3 canonical event names (UPPER_SNAKE_CASE).
+ * Sent verbatim on both the browser Pixel call (`snaptr('track', <name>, ...)`)
+ * and the CAPI wire body (`event_name`). Snap dedups by
+ * (event_name, event_id) within 48h, so the strings MUST match exactly.
+ */
+type SnapEventName = 'PAGE_VIEW' | 'VIEW_CONTENT' | 'ADD_CART' | 'START_CHECKOUT' | 'PURCHASE';
+/**
+ * User-identifying fields for Snap CAPI. All of `em`/`ph`/`madid`/`external_id`
+ * MUST be SHA-256 hex-lowercase-trimmed BEFORE being placed in the CAPI wire
+ * body. The Amboras plugin does hashing on the Medusa side, so the browser-
+ * facing payload carries raw values (or the click-id / ip / user-agent
+ * fields that Snap wants raw). `sc_click_id` is sent RAW - Snap matches it
+ * against their own click table server-side.
+ */
+interface SnapUserData {
+    /** SHA-256 hex lowercase, lowercase-trimmed email BEFORE hashing. */
+    email?: string;
+    /** SHA-256 hex lowercase, E.164 digits-only phone BEFORE hashing (strip leading 00/0, whitespace, +, -, (, )). */
+    phone?: string;
+    /** SHA-256 hex lowercase, lowercase iOS IDFA / Android AAID (keep hyphens) BEFORE hashing. */
+    madid?: string;
+    /** SHA-256 hex lowercase (hash recommended by Snap, but not strictly required). */
+    externalId?: string;
+    /** Snap click id - sent RAW, never hashed. */
+    scClickId?: string;
+    /** First-party cookie id (`sc_at`) - sent RAW, never hashed. */
+    scCookie1?: string;
+}
+/**
+ * Snap CAPI v3 custom-data shape - `value`, `item_price`, and `quantity` are
+ * STRING-typed per the v3 wire spec (research memo caveat #3). Numeric-typed
+ * fields cause the event to silently drop or under-report. `num_items` is
+ * numeric though - inconsistent, but that's what Snap's docs show.
+ *
+ * Amounts are in MAJOR units (e.g. `"10.50"` INR, not `"1050"` paise). Snap
+ * does NOT use Stripe's cents convention.
+ */
+interface SnapCustomData {
+    /** ISO 4217 3-letter uppercase (e.g. `USD`, `INR`, `EUR`). */
+    currency?: string;
+    /** Major-unit amount serialized as a STRING (e.g. `"10.50"`). */
+    value?: string;
+    /**
+     * Order/transaction id echoed by the PURCHASE event only. Matches the
+     * Pixel-side `transaction_id`; Snap dedups on this pair within a 30-day
+     * window on PURCHASE (separately from the 48h event_id dedup).
+     */
+    orderId?: string;
+    contentIds?: string[];
+    /** NUMBER, not string. Snap's docs show num_items as numeric. */
+    numItems?: number;
+    contents?: Array<{
+        id: string;
+        /** Quantity serialized as a STRING per v3 spec. */
+        quantity: string;
+        /** item_price serialized as a STRING per v3 spec. */
+        item_price?: string;
+    }>;
+}
+/**
+ * Payload posted from the storefront to `/api/snapchat-ads/events`. The
+ * storefront proxy enriches with `client_ip_address` + `client_user_agent`
+ * and forwards to Medusa `/store/snapchat-ads/capi` with the same
+ * `event_id`. Snap matches (event_name, event_id) within 48h for browser
+ * vs server dedup.
+ */
+interface SnapEventPayload {
+    eventName: SnapEventName;
+    eventId: string;
+    eventSourceUrl: string;
+    userData: SnapUserData;
+    customData?: SnapCustomData;
+}
+
+interface GetSnapchatAdsConfigOptions {
+    baseUrl?: string;
+    publishableApiKey?: string;
+    storeId?: string;
+}
+/**
+ * Fetch the non-secret Snapchat Ads config from the Medusa Store API. Returns
+ * `null` when the store isn't wired up, when the publishable key is missing,
+ * or on any transport error - callers should treat `null` as "plugin
+ * off" and skip event firing.
+ *
+ * NEVER surfaces `snap_conversion_api_token` or `snap_ad_account_id` -
+ * those live only on the Medusa side and never leave the server.
+ */
+declare function getSnapchatAdsConfig(options?: GetSnapchatAdsConfigOptions): Promise<SnapchatAdsPublicConfig | null>;
+
+export { type SnapEventPayload as S, type SnapUserData as a, type SnapEventName as b, type SnapCustomData as c, type SnapchatAdsPublicConfig as d, getSnapchatAdsConfig as g };

package/dist/get-config.d.mts

@@ -0,0 +1 @@
+export { g as getSnapchatAdsConfig } from './get-config-DmAUgsFJ.mjs';

package/dist/get-config.d.ts

@@ -0,0 +1 @@
+export { g as getSnapchatAdsConfig } from './get-config-DmAUgsFJ.js';

package/dist/get-config.js

@@ -0,0 +1,54 @@
+"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/get-config.ts
+var get_config_exports = {};
+__export(get_config_exports, {
+  getSnapchatAdsConfig: () => getSnapchatAdsConfig
+});
+module.exports = __toCommonJS(get_config_exports);
+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;
+  if (key === "NEXT_PUBLIC_STORE_ID") return process.env.NEXT_PUBLIC_STORE_ID;
+  return void 0;
+}
+async function getSnapchatAdsConfig(options = {}) {
+  const baseUrl = options.baseUrl ?? resolveEnv("NEXT_PUBLIC_MEDUSA_BACKEND_URL") ?? "http://localhost:9000";
+  const publishableKey = options.publishableApiKey ?? resolveEnv("NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY");
+  const storeId = options.storeId ?? resolveEnv("NEXT_PUBLIC_STORE_ID");
+  try {
+    const res = await fetch(`${baseUrl}/store/snapchat-ads/config`, {
+      headers: {
+        ...storeId ? { "X-Store-Environment-ID": storeId } : {},
+        ...publishableKey ? { "x-publishable-api-key": publishableKey } : {}
+      },
+      next: { revalidate: 60 }
+    });
+    if (!res.ok) return null;
+    return await res.json();
+  } catch {
+    return null;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getSnapchatAdsConfig
+});
+//# sourceMappingURL=get-config.js.map

package/dist/get-config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/get-config.ts"],"sourcesContent":["import type { SnapchatAdsPublicConfig } from './types'\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  if (key === 'NEXT_PUBLIC_STORE_ID') return process.env.NEXT_PUBLIC_STORE_ID\n  return undefined\n}\n\ninterface GetSnapchatAdsConfigOptions {\n  baseUrl?: string\n  publishableApiKey?: string\n  storeId?: string\n}\n\n/**\n * Fetch the non-secret Snapchat Ads config from the Medusa Store API. Returns\n * `null` when the store isn't wired up, when the publishable key is missing,\n * or on any transport error - callers should treat `null` as \"plugin\n * off\" and skip event firing.\n *\n * NEVER surfaces `snap_conversion_api_token` or `snap_ad_account_id` -\n * those live only on the Medusa side and never leave the server.\n */\nexport async function getSnapchatAdsConfig(\n  options: GetSnapchatAdsConfigOptions = {},\n): Promise<SnapchatAdsPublicConfig | null> {\n  const baseUrl = options.baseUrl ?? resolveEnv('NEXT_PUBLIC_MEDUSA_BACKEND_URL') ?? 'http://localhost:9000'\n  const publishableKey = options.publishableApiKey ?? resolveEnv('NEXT_PUBLIC_MEDUSA_PUBLISHABLE_KEY')\n  const storeId = options.storeId ?? resolveEnv('NEXT_PUBLIC_STORE_ID')\n\n  try {\n    // `next` is a Next.js fetch extension for cache revalidation - ignored outside Next.js\n    const res = await fetch(`${baseUrl}/store/snapchat-ads/config`, {\n      headers: {\n        ...(storeId ? { 'X-Store-Environment-ID': storeId } : {}),\n        ...(publishableKey ? { 'x-publishable-api-key': publishableKey } : {}),\n      },\n      next: { revalidate: 60 },\n    } as RequestInit)\n    if (!res.ok) return null\n    return (await res.json()) as SnapchatAdsPublicConfig\n  } catch {\n    return null\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,SAAS,WAAW,KAAiC;AACnD,MAAI,QAAQ,iCAAkC,QAAO,QAAQ,IAAI;AACjE,MAAI,QAAQ,qCAAsC,QAAO,QAAQ,IAAI;AACrE,MAAI,QAAQ,uBAAwB,QAAO,QAAQ,IAAI;AACvD,SAAO;AACT;AAiBA,eAAsB,qBACpB,UAAuC,CAAC,GACC;AACzC,QAAM,UAAU,QAAQ,WAAW,WAAW,gCAAgC,KAAK;AACnF,QAAM,iBAAiB,QAAQ,qBAAqB,WAAW,oCAAoC;AACnG,QAAM,UAAU,QAAQ,WAAW,WAAW,sBAAsB;AAEpE,MAAI;AAEF,UAAM,MAAM,MAAM,MAAM,GAAG,OAAO,8BAA8B;AAAA,MAC9D,SAAS;AAAA,QACP,GAAI,UAAU,EAAE,0BAA0B,QAAQ,IAAI,CAAC;AAAA,QACvD,GAAI,iBAAiB,EAAE,yBAAyB,eAAe,IAAI,CAAC;AAAA,MACtE;AAAA,MACA,MAAM,EAAE,YAAY,GAAG;AAAA,IACzB,CAAgB;AAChB,QAAI,CAAC,IAAI,GAAI,QAAO;AACpB,WAAQ,MAAM,IAAI,KAAK;AAAA,EACzB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/get-config.mjs

@@ -0,0 +1,7 @@
+import {
+  getSnapchatAdsConfig
+} from "./chunk-PK23QMZT.mjs";
+export {
+  getSnapchatAdsConfig
+};
+//# sourceMappingURL=get-config.mjs.map

package/dist/get-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,113 @@
+import { S as SnapEventPayload, a as SnapUserData, b as SnapEventName } from './get-config-DmAUgsFJ.mjs';
+export { c as SnapCustomData, d as SnapchatAdsPublicConfig, g as getSnapchatAdsConfig } from './get-config-DmAUgsFJ.mjs';
+
+/**
+ * Send a server-side Snap CAPI event via the storefront's proxy. Fire-
+ * and-forget from the caller's perspective; internal errors are swallowed
+ * because analytics loss is preferable to storefront breakage.
+ *
+ * Intentionally NOT gated on analytics consent - Snap CAPI operates on a
+ * different legal basis (order-tracking legitimate interest) than the
+ * browser pixel. The `SnapPixelProvider` handles browser-side consent
+ * gating separately.
+ */
+declare function sendSnapchatCapiEvent(payload: SnapEventPayload): Promise<void>;
+/**
+ * Fire PAGE_VIEW on both sides. The `SnapPixelProvider` already fires
+ * this on mount + route change; this hook is exposed for callers that
+ * want to trigger a page-view manually (e.g. modal opens counted as
+ * page views).
+ */
+declare function trackPageView(primaryKey: string, userData?: SnapUserData, eventId?: string): void;
+interface TrackViewContentOptions {
+    currency?: string;
+    /** Major-unit value STRING (e.g. `"10.50"`). */
+    value?: string;
+    /** Product / variant id passed to Snap as `content_ids`. */
+    contentIds?: string[];
+    /** Optional per-line breakdown. `item_price` + `quantity` are STRINGS. */
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    numItems?: number;
+    userData?: SnapUserData;
+    eventId?: string;
+}
+declare function trackViewContent(productId: string, options?: TrackViewContentOptions): void;
+interface TrackAddCartOptions {
+    currency?: string;
+    /** Major-unit value STRING. */
+    value?: string;
+    /** Product / variant ids. */
+    contentIds?: string[];
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    /** Top-level `num_items` - number-typed per Snap docs. */
+    numItems?: number;
+    userData?: SnapUserData;
+    eventId?: string;
+}
+declare function trackAddCart(cartId: string, options?: TrackAddCartOptions): void;
+interface TrackStartCheckoutOptions {
+    currency?: string;
+    value?: string;
+    contentIds?: string[];
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    numItems?: number;
+    userData?: SnapUserData;
+    eventId?: string;
+}
+declare function trackStartCheckout(cartId: string, options?: TrackStartCheckoutOptions): void;
+interface TrackPurchaseOptions {
+    currency?: string;
+    value?: string;
+    contentIds?: string[];
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    numItems?: number;
+    userData?: SnapUserData;
+    /**
+     * When present, pins `event_id` / `client_dedup_id` explicitly; otherwise
+     * a stable id is derived from `(PURCHASE, orderId, 0)` - minute-bucket 0
+     * so retries within a longer window still dedup against the server event.
+     */
+    eventId?: string;
+}
+/**
+ * PURCHASE gets the dual-dedup treatment:
+ *   - Top-level `event_id` / Pixel `client_dedup_id` shared for 48h window.
+ *   - `custom_data.order_id` / Pixel `transaction_id` shared for 30-day
+ *     window. Reuses the Amboras order id as both.
+ */
+declare function trackPurchase(orderId: string, options?: TrackPurchaseOptions): void;
+
+/** Bucket a Unix millisecond timestamp into whole minutes. */
+declare function deriveMinuteBucket(nowMs: number): number;
+/** Convenience wrapper for `deriveMinuteBucket(Date.now())`. */
+declare function minuteBucketNow(): number;
+/**
+ * Mint a deterministic event id for `event_id` (CAPI) and
+ * `client_dedup_id` (Pixel). See contract above.
+ *
+ * Callers that want a stable id across a longer window (e.g. tying two
+ * page-view fires back to back to the same URL) can pin `minuteBucket` to
+ * a well-known value; the default is `minuteBucketNow()`. For PURCHASE,
+ * pin `minuteBucket` to a constant per order (recommend `0`) so a
+ * failing browser fire that retries in a later minute still dedups
+ * against the server event.
+ */
+declare function makeEventId(eventName: SnapEventName, primaryKey: string, minuteBucket?: number): string;
+
+export { SnapEventName, SnapEventPayload, SnapUserData, deriveMinuteBucket, makeEventId, minuteBucketNow, sendSnapchatCapiEvent, trackAddCart, trackPageView, trackPurchase, trackStartCheckout, trackViewContent };

package/dist/index.d.ts

@@ -0,0 +1,113 @@
+import { S as SnapEventPayload, a as SnapUserData, b as SnapEventName } from './get-config-DmAUgsFJ.js';
+export { c as SnapCustomData, d as SnapchatAdsPublicConfig, g as getSnapchatAdsConfig } from './get-config-DmAUgsFJ.js';
+
+/**
+ * Send a server-side Snap CAPI event via the storefront's proxy. Fire-
+ * and-forget from the caller's perspective; internal errors are swallowed
+ * because analytics loss is preferable to storefront breakage.
+ *
+ * Intentionally NOT gated on analytics consent - Snap CAPI operates on a
+ * different legal basis (order-tracking legitimate interest) than the
+ * browser pixel. The `SnapPixelProvider` handles browser-side consent
+ * gating separately.
+ */
+declare function sendSnapchatCapiEvent(payload: SnapEventPayload): Promise<void>;
+/**
+ * Fire PAGE_VIEW on both sides. The `SnapPixelProvider` already fires
+ * this on mount + route change; this hook is exposed for callers that
+ * want to trigger a page-view manually (e.g. modal opens counted as
+ * page views).
+ */
+declare function trackPageView(primaryKey: string, userData?: SnapUserData, eventId?: string): void;
+interface TrackViewContentOptions {
+    currency?: string;
+    /** Major-unit value STRING (e.g. `"10.50"`). */
+    value?: string;
+    /** Product / variant id passed to Snap as `content_ids`. */
+    contentIds?: string[];
+    /** Optional per-line breakdown. `item_price` + `quantity` are STRINGS. */
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    numItems?: number;
+    userData?: SnapUserData;
+    eventId?: string;
+}
+declare function trackViewContent(productId: string, options?: TrackViewContentOptions): void;
+interface TrackAddCartOptions {
+    currency?: string;
+    /** Major-unit value STRING. */
+    value?: string;
+    /** Product / variant ids. */
+    contentIds?: string[];
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    /** Top-level `num_items` - number-typed per Snap docs. */
+    numItems?: number;
+    userData?: SnapUserData;
+    eventId?: string;
+}
+declare function trackAddCart(cartId: string, options?: TrackAddCartOptions): void;
+interface TrackStartCheckoutOptions {
+    currency?: string;
+    value?: string;
+    contentIds?: string[];
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    numItems?: number;
+    userData?: SnapUserData;
+    eventId?: string;
+}
+declare function trackStartCheckout(cartId: string, options?: TrackStartCheckoutOptions): void;
+interface TrackPurchaseOptions {
+    currency?: string;
+    value?: string;
+    contentIds?: string[];
+    contents?: Array<{
+        id: string;
+        quantity: string;
+        item_price?: string;
+    }>;
+    numItems?: number;
+    userData?: SnapUserData;
+    /**
+     * When present, pins `event_id` / `client_dedup_id` explicitly; otherwise
+     * a stable id is derived from `(PURCHASE, orderId, 0)` - minute-bucket 0
+     * so retries within a longer window still dedup against the server event.
+     */
+    eventId?: string;
+}
+/**
+ * PURCHASE gets the dual-dedup treatment:
+ *   - Top-level `event_id` / Pixel `client_dedup_id` shared for 48h window.
+ *   - `custom_data.order_id` / Pixel `transaction_id` shared for 30-day
+ *     window. Reuses the Amboras order id as both.
+ */
+declare function trackPurchase(orderId: string, options?: TrackPurchaseOptions): void;
+
+/** Bucket a Unix millisecond timestamp into whole minutes. */
+declare function deriveMinuteBucket(nowMs: number): number;
+/** Convenience wrapper for `deriveMinuteBucket(Date.now())`. */
+declare function minuteBucketNow(): number;
+/**
+ * Mint a deterministic event id for `event_id` (CAPI) and
+ * `client_dedup_id` (Pixel). See contract above.
+ *
+ * Callers that want a stable id across a longer window (e.g. tying two
+ * page-view fires back to back to the same URL) can pin `minuteBucket` to
+ * a well-known value; the default is `minuteBucketNow()`. For PURCHASE,
+ * pin `minuteBucket` to a constant per order (recommend `0`) so a
+ * failing browser fire that retries in a later minute still dedups
+ * against the server event.
+ */
+declare function makeEventId(eventName: SnapEventName, primaryKey: string, minuteBucket?: number): string;
+
+export { SnapEventName, SnapEventPayload, SnapUserData, deriveMinuteBucket, makeEventId, minuteBucketNow, sendSnapchatCapiEvent, trackAddCart, trackPageView, trackPurchase, trackStartCheckout, trackViewContent };