@astroscope/relay 0.0.0-stage → 1.0.1

package/dist/collect-DWdHyn-u.js

@@ -0,0 +1,45 @@
+// src/inline.ts
+/**
+* The body of an inline script that tracks an event from hand-written html, before or after the
+* bus is installed; `<Track>` is the same thing as an Astro component.
+*/
+function inlineTrack(input) {
+	return `(self.__relay__??={q:[]}).q.push(${JSON.stringify(input).replaceAll("<", String.raw`\u003c`)});`;
+}
+// src/collect.ts
+const DEFAULT_WITHIN = 500;
+/**
+* Folds single sightings into batched events: a list of items is seen one item at a time as the
+* rows enter the viewport, while `view_item_list` is one event with the items. The collector
+* keeps a buffer per key and flushes it after the quiet time, in chunks of at most `max` items.
+* Buffers are shared by every caller of the collector, so sightings with the same key from
+* several components go out as one batch.
+*/
+function collect(options) {
+	const { flush, within = DEFAULT_WITHIN } = options;
+	const max = Math.max(1, options.max ?? Infinity);
+	const keyOf = options.key ?? ((context) => context);
+	const batches = /* @__PURE__ */ new Map();
+	const flushBatch = (key) => {
+		const batch = batches.get(key);
+		if (!batch) return;
+		batches.delete(key);
+		for (let start = 0; start < batch.items.length; start += max) flush(batch.context, batch.items.slice(start, start + max));
+	};
+	return (context, item) => {
+		const key = keyOf(context);
+		const existing = batches.get(key);
+		existing?.cancel();
+		const handle = setTimeout(() => flushBatch(key), within);
+		const batch = {
+			context: existing?.context ?? context,
+			items: existing?.items ?? [],
+			cancel: () => clearTimeout(handle)
+		};
+		batch.items.push(item);
+		batches.set(key, batch);
+	};
+}
+export { inlineTrack as n, collect as t };
+
+//# sourceMappingURL=collect-DWdHyn-u.js.map

package/dist/collect-DWdHyn-u.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect-DWdHyn-u.js","names":[],"sources":["../src/inline.ts","../src/collect.ts"],"sourcesContent":["import type { TrackInput } from './shared.js';\n\n/**\n * The body of an inline script that tracks an event from hand-written html, before or after the\n * bus is installed; `<Track>` is the same thing as an Astro component.\n */\nexport function inlineTrack(input: TrackInput): string {\n  // `<` is escaped so the json can never close the script tag it is written into\n  const json = JSON.stringify(input).replaceAll('<', String.raw`\\u003c`);\n\n  return `(self.__relay__??={q:[]}).q.push(${json});`;\n}\n","/** a collector's options; the context identifies the batch and is handed back with it */\nexport type CollectOptions<Ctx, Item> = {\n  /** takes one batch: the context of its first sighting and the items collected under that key */\n  flush: (context: Ctx, items: Item[]) => void;\n  /** the quiet time after the last sighting before the batch goes out, in ms; default 500 */\n  within?: number | undefined;\n  /** the items a batch carries at most, 1 or more; a fuller buffer goes out as several batches; default unlimited */\n  max?: number | undefined;\n};\n\n/** a string context is its own key; any other context needs a key function */\ntype KeyOption<Ctx> = Ctx extends string\n  ? { key?: ((context: Ctx) => string) | undefined }\n  : { key: (context: Ctx) => string };\n\ntype Batch<Ctx, Item> = {\n  context: Ctx;\n  items: Item[];\n  cancel: () => void;\n};\n\nconst DEFAULT_WITHIN = 500;\n\n/**\n * Folds single sightings into batched events: a list of items is seen one item at a time as the\n * rows enter the viewport, while `view_item_list` is one event with the items. The collector\n * keeps a buffer per key and flushes it after the quiet time, in chunks of at most `max` items.\n * Buffers are shared by every caller of the collector, so sightings with the same key from\n * several components go out as one batch.\n */\nexport function collect<Ctx, Item>(\n  options: CollectOptions<Ctx, Item> & KeyOption<Ctx>,\n): (context: Ctx, item: Item) => void {\n  const { flush, within = DEFAULT_WITHIN } = options;\n  const max = Math.max(1, options.max ?? Infinity);\n  const keyOf = options.key ?? ((context: Ctx) => context as string);\n  const batches = new Map<string, Batch<Ctx, Item>>();\n\n  const flushBatch = (key: string): void => {\n    const batch = batches.get(key);\n\n    if (!batch) {\n      return;\n    }\n\n    batches.delete(key);\n\n    for (let start = 0; start < batch.items.length; start += max) {\n      flush(batch.context, batch.items.slice(start, start + max));\n    }\n  };\n\n  return (context, item) => {\n    const key = keyOf(context);\n    const existing = batches.get(key);\n\n    existing?.cancel();\n\n    const handle = setTimeout(() => flushBatch(key), within);\n    const batch: Batch<Ctx, Item> = {\n      context: existing?.context ?? context,\n      items: existing?.items ?? [],\n      cancel: () => clearTimeout(handle),\n    };\n\n    batch.items.push(item);\n    batches.set(key, batch);\n  };\n}\n"],"mappings":";;;;;AAMA,SAAgB,YAAY,OAA2B;CAIrD,OAAO,oCAFM,KAAK,UAAU,KAAK,CAAC,CAAC,WAAW,KAAK,OAAO,GAAG,QAEf,EAAE;AAClD;;ACUA,MAAM,iBAAiB;;;;;;;;AASvB,SAAgB,QACd,SACoC;CACpC,MAAM,EAAE,OAAO,SAAS,mBAAmB;CAC3C,MAAM,MAAM,KAAK,IAAI,GAAG,QAAQ,OAAO,QAAQ;CAC/C,MAAM,QAAQ,QAAQ,SAAS,YAAiB;CAChD,MAAM,0BAAU,IAAI,IAA8B;CAElD,MAAM,cAAc,QAAsB;EACxC,MAAM,QAAQ,QAAQ,IAAI,GAAG;EAE7B,IAAI,CAAC,OACH;EAGF,QAAQ,OAAO,GAAG;EAElB,KAAK,IAAI,QAAQ,GAAG,QAAQ,MAAM,MAAM,QAAQ,SAAS,KACvD,MAAM,MAAM,SAAS,MAAM,MAAM,MAAM,OAAO,QAAQ,GAAG,CAAC;CAE9D;CAEA,QAAQ,SAAS,SAAS;EACxB,MAAM,MAAM,MAAM,OAAO;EACzB,MAAM,WAAW,QAAQ,IAAI,GAAG;EAEhC,UAAU,OAAO;EAEjB,MAAM,SAAS,iBAAiB,WAAW,GAAG,GAAG,MAAM;EACvD,MAAM,QAA0B;GAC9B,SAAS,UAAU,WAAW;GAC9B,OAAO,UAAU,SAAS,CAAC;GAC3B,cAAc,aAAa,MAAM;EACnC;EAEA,MAAM,MAAM,KAAK,IAAI;EACrB,QAAQ,IAAI,KAAK,KAAK;CACxB;AACF"}

package/dist/commerce-DCGO8yag.d.ts

@@ -0,0 +1,106 @@
+import { d as RelayParams } from "./shared-CSwqcxPI.js";
+/** an item of the commerce events */
+type CommerceItem = {
+  item_id: string;
+  item_name: string;
+  price: number;
+  quantity: number;
+  index?: number | undefined;
+  affiliation?: string | undefined;
+  coupon?: string | undefined;
+  discount?: number | undefined;
+  item_brand?: string | undefined;
+  item_category?: string | undefined;
+  item_category2?: string | undefined;
+  item_category3?: string | undefined;
+  item_category4?: string | undefined;
+  item_category5?: string | undefined;
+  item_list_id?: string | undefined;
+  item_list_name?: string | undefined;
+  item_variant?: string | undefined;
+  location_id?: string | undefined;
+  [key: string]: unknown;
+};
+type Items = {
+  items: readonly CommerceItem[];
+};
+type Money = {
+  currency?: string | undefined;
+  value?: number | undefined;
+};
+type Listed = {
+  item_list_id?: string | undefined;
+  item_list_name?: string | undefined;
+};
+/** every well-known params type takes custom parameters next to the known ones */
+type Params<P> = P & RelayParams;
+type ViewItemParams = Params<Items & Money>;
+type ViewItemListParams = Params<Items & Listed>;
+type SelectItemParams = Params<Items & Listed>;
+type AddToCartParams = Params<Items & Money>;
+type RemoveFromCartParams = Params<Items & Money>;
+type ViewCartParams = Params<Items & Money>;
+type BeginCheckoutParams = Params<Items & Money & {
+  coupon?: string | undefined;
+}>;
+type AddShippingInfoParams = Params<Items & Money & {
+  coupon?: string | undefined;
+  shipping_tier?: string | undefined;
+}>;
+type AddPaymentInfoParams = Params<Items & Money & {
+  coupon?: string | undefined;
+  payment_type?: string | undefined;
+}>;
+type PurchaseParams = Params<Items & {
+  transaction_id: string;
+  value: number;
+  currency: string;
+  tax?: number | undefined;
+  shipping?: number | undefined;
+  coupon?: string | undefined;
+}>;
+type RefundParams = Params<Money & {
+  transaction_id: string;
+  tax?: number | undefined;
+  shipping?: number | undefined;
+  items?: readonly CommerceItem[] | undefined;
+}>;
+type SearchParams = Params<{
+  search_term: string;
+}>;
+type SignUpParams = Params<{
+  method?: string | undefined;
+}>;
+type LoginParams = Params<{
+  method?: string | undefined;
+}>;
+type GenerateLeadParams = Params<Money>;
+type WellKnownName = 'view_item' | 'view_item_list' | 'select_item' | 'add_to_cart' | 'remove_from_cart' | 'view_cart' | 'begin_checkout' | 'add_shipping_info' | 'add_payment_info' | 'purchase' | 'refund' | 'search' | 'sign_up' | 'login' | 'generate_lead';
+/** whether a well-known event is a commerce one, whose parameters a container reads under `ecommerce` */
+declare function isCommerceEvent(name: string): boolean;
+/** what a builder set is made of: the event's name and parameters in, the destination's payload out */
+type WellKnownCreate<R> = (name: WellKnownName, params: RelayParams, extra: RelayParams | undefined) => R;
+/**
+ * The well-known events as builders over `create`: one function per event, typed by its
+ * parameters, taking the destination's extra parameters second. The ga4 and tag-manager builders are
+ * made of it; a site's own destination that speaks ga4's names can be too.
+ */
+declare function wellKnownEvents<R>(create: WellKnownCreate<R>): {
+  viewItem: (params: ViewItemParams, extra?: RelayParams) => R;
+  viewItemList: (params: ViewItemListParams, extra?: RelayParams) => R;
+  selectItem: (params: SelectItemParams, extra?: RelayParams) => R;
+  addToCart: (params: AddToCartParams, extra?: RelayParams) => R;
+  removeFromCart: (params: RemoveFromCartParams, extra?: RelayParams) => R;
+  viewCart: (params: ViewCartParams, extra?: RelayParams) => R;
+  beginCheckout: (params: BeginCheckoutParams, extra?: RelayParams) => R;
+  addShippingInfo: (params: AddShippingInfoParams, extra?: RelayParams) => R;
+  addPaymentInfo: (params: AddPaymentInfoParams, extra?: RelayParams) => R;
+  purchase: (params: PurchaseParams, extra?: RelayParams) => R;
+  refund: (params: RefundParams, extra?: RelayParams) => R;
+  search: (params: SearchParams, extra?: RelayParams) => R;
+  signUp: (params: SignUpParams, extra?: RelayParams) => R;
+  login: (params: LoginParams, extra?: RelayParams) => R;
+  generateLead: (params: GenerateLeadParams, extra?: RelayParams) => R;
+};
+export { WellKnownCreate as _, CommerceItem as a, wellKnownEvents as b, PurchaseParams as c, SearchParams as d, SelectItemParams as f, ViewItemParams as g, ViewItemListParams as h, BeginCheckoutParams as i, RefundParams as l, ViewCartParams as m, AddShippingInfoParams as n, GenerateLeadParams as o, SignUpParams as p, AddToCartParams as r, LoginParams as s, AddPaymentInfoParams as t, RemoveFromCartParams as u, WellKnownName as v, isCommerceEvent as y };
+//# sourceMappingURL=commerce-DCGO8yag.d.ts.map

package/dist/commerce-DCGO8yag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-DCGO8yag.d.ts","names":[],"sources":["../src/commerce.ts"],"mappings":";;KAMY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;GACC;;KAGE;EAAU,gBAAgB;;KAC1B;EAAU;EAA+B;;KACzC;EAAW;EAAmC;;;KAG9C,OAAO,KAAK,IAAI;KAET,iBAAiB,OAAO,QAAQ;KAChC,qBAAqB,OAAO,QAAQ;KACpC,mBAAmB,OAAO,QAAQ;KAClC,kBAAkB,OAAO,QAAQ;KACjC,uBAAuB,OAAO,QAAQ;KACtC,iBAAiB,OAAO,QAAQ;KAChC,sBAAsB,OAAO,QAAQ;EAAU;;KAC/C,wBAAwB,OAClC,QAAQ;EAAU;EAA6B;;KAErC,uBAAuB,OACjC,QAAQ;EAAU;EAA6B;;KAErC,iBAAiB,OAC3B;EACE;EACA;EACA;EACA;EACA;EACA;;KAGQ,eAAe,OACzB;EACE;EACA;EACA;EACA,iBAAiB;;KAGT,eAAe;EAAS;;KACxB,eAAe;EAAS;;KACxB,cAAc;EAAS;;KACvB,qBAAqB,OAAO;KAE5B;;iBAgCI,gBAAgB;;KAKpB,gBAAgB,MAAM,MAAM,eAAe,QAAQ,aAAa,OAAO,4BAA4B;;;;;;iBAO/F,gBAAgB,GAAG,QAAQ,gBAAgB;EAGjC,WAAA,QAAA,gBAAA,QAAA,gBAAc;EAAd,eAAA,QAAA,oBAAA,QAAA,gBAAc;EAAd,aAAA,QAAA,kBAAA,QAAA,gBAAc;EAAd,YAAA,QAAA,iBAAA,QAAA,gBAAc;EAAd,iBAAA,QAAA,sBAAA,QAAA,gBAAc;EAAd,WAAA,QAAA,gBAAA,QAAA,gBAAc;EAAd,gBAAA,QAAA,qBAAA,QAAA,gBAAc;EAAd,kBAAA,QAAA,uBAAA,QAAA,gBAAc;EAAd,iBAAA,QAAA,sBAAA,QAAA,gBAAc;EAAd,WAAA,QAAA,gBAAA,QAAA,gBAAc;EAAd,SAAA,QAAA,cAAA,QAAA,gBAAc;EAAd,SAAA,QAAA,cAAA,QAAA,gBAAc;EAAd,SAAA,QAAA,cAAA,QAAA,gBAAc;EAAd,QAAA,QAAA,aAAA,QAAA,gBAAc;EAAd,eAAA,QAAA,oBAAA,QAAA,gBAAc"}

package/dist/commerce-DgNeBWhO.js

@@ -0,0 +1,46 @@
+// src/commerce.ts
+const COMMERCE_NAMES = /* @__PURE__ */ new Set([
+	"view_item",
+	"view_item_list",
+	"select_item",
+	"add_to_cart",
+	"remove_from_cart",
+	"view_cart",
+	"begin_checkout",
+	"add_shipping_info",
+	"add_payment_info",
+	"purchase",
+	"refund"
+]);
+/** whether a well-known event is a commerce one, whose parameters a container reads under `ecommerce` */
+function isCommerceEvent(name) {
+	return COMMERCE_NAMES.has(name);
+}
+/**
+* The well-known events as builders over `create`: one function per event, typed by its
+* parameters, taking the destination's extra parameters second. The ga4 and tag-manager builders are
+* made of it; a site's own destination that speaks ga4's names can be too.
+*/
+function wellKnownEvents(create) {
+	const builder = (name) => (params, extra) => create(name, params, extra);
+	return {
+		viewItem: builder("view_item"),
+		viewItemList: builder("view_item_list"),
+		selectItem: builder("select_item"),
+		addToCart: builder("add_to_cart"),
+		removeFromCart: builder("remove_from_cart"),
+		viewCart: builder("view_cart"),
+		beginCheckout: builder("begin_checkout"),
+		addShippingInfo: builder("add_shipping_info"),
+		addPaymentInfo: builder("add_payment_info"),
+		purchase: builder("purchase"),
+		refund: builder("refund"),
+		search: builder("search"),
+		signUp: builder("sign_up"),
+		login: builder("login"),
+		generateLead: builder("generate_lead")
+	};
+}
+export { wellKnownEvents as n, isCommerceEvent as t };
+
+//# sourceMappingURL=commerce-DgNeBWhO.js.map

package/dist/commerce-DgNeBWhO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commerce-DgNeBWhO.js","names":[],"sources":["../src/commerce.ts"],"sourcesContent":["// the well-known events — ga4's recommended events, the catalogue every tag vendor maps from — as\n// typed parameters, and a factory the ga4 and tag-manager builders are made of. No runtime imports here.\n\nimport type { RelayParams } from './shared.js';\n\n/** an item of the commerce events */\nexport type CommerceItem = {\n  item_id: string;\n  item_name: string;\n  price: number;\n  quantity: number;\n  index?: number | undefined;\n  affiliation?: string | undefined;\n  coupon?: string | undefined;\n  discount?: number | undefined;\n  item_brand?: string | undefined;\n  item_category?: string | undefined;\n  item_category2?: string | undefined;\n  item_category3?: string | undefined;\n  item_category4?: string | undefined;\n  item_category5?: string | undefined;\n  item_list_id?: string | undefined;\n  item_list_name?: string | undefined;\n  item_variant?: string | undefined;\n  location_id?: string | undefined;\n  [key: string]: unknown;\n};\n\ntype Items = { items: readonly CommerceItem[] };\ntype Money = { currency?: string | undefined; value?: number | undefined };\ntype Listed = { item_list_id?: string | undefined; item_list_name?: string | undefined };\n\n/** every well-known params type takes custom parameters next to the known ones */\ntype Params<P> = P & RelayParams;\n\nexport type ViewItemParams = Params<Items & Money>;\nexport type ViewItemListParams = Params<Items & Listed>;\nexport type SelectItemParams = Params<Items & Listed>;\nexport type AddToCartParams = Params<Items & Money>;\nexport type RemoveFromCartParams = Params<Items & Money>;\nexport type ViewCartParams = Params<Items & Money>;\nexport type BeginCheckoutParams = Params<Items & Money & { coupon?: string | undefined }>;\nexport type AddShippingInfoParams = Params<\n  Items & Money & { coupon?: string | undefined; shipping_tier?: string | undefined }\n>;\nexport type AddPaymentInfoParams = Params<\n  Items & Money & { coupon?: string | undefined; payment_type?: string | undefined }\n>;\nexport type PurchaseParams = Params<\n  Items & {\n    transaction_id: string;\n    value: number;\n    currency: string;\n    tax?: number | undefined;\n    shipping?: number | undefined;\n    coupon?: string | undefined;\n  }\n>;\nexport type RefundParams = Params<\n  Money & {\n    transaction_id: string;\n    tax?: number | undefined;\n    shipping?: number | undefined;\n    items?: readonly CommerceItem[] | undefined;\n  }\n>;\nexport type SearchParams = Params<{ search_term: string }>;\nexport type SignUpParams = Params<{ method?: string | undefined }>;\nexport type LoginParams = Params<{ method?: string | undefined }>;\nexport type GenerateLeadParams = Params<Money>;\n\nexport type WellKnownName =\n  | 'view_item'\n  | 'view_item_list'\n  | 'select_item'\n  | 'add_to_cart'\n  | 'remove_from_cart'\n  | 'view_cart'\n  | 'begin_checkout'\n  | 'add_shipping_info'\n  | 'add_payment_info'\n  | 'purchase'\n  | 'refund'\n  | 'search'\n  | 'sign_up'\n  | 'login'\n  | 'generate_lead';\n\nconst COMMERCE_NAMES: ReadonlySet<string> = new Set([\n  'view_item',\n  'view_item_list',\n  'select_item',\n  'add_to_cart',\n  'remove_from_cart',\n  'view_cart',\n  'begin_checkout',\n  'add_shipping_info',\n  'add_payment_info',\n  'purchase',\n  'refund',\n]);\n\n/** whether a well-known event is a commerce one, whose parameters a container reads under `ecommerce` */\nexport function isCommerceEvent(name: string): boolean {\n  return COMMERCE_NAMES.has(name);\n}\n\n/** what a builder set is made of: the event's name and parameters in, the destination's payload out */\nexport type WellKnownCreate<R> = (name: WellKnownName, params: RelayParams, extra: RelayParams | undefined) => R;\n\n/**\n * The well-known events as builders over `create`: one function per event, typed by its\n * parameters, taking the destination's extra parameters second. The ga4 and tag-manager builders are\n * made of it; a site's own destination that speaks ga4's names can be too.\n */\nexport function wellKnownEvents<R>(create: WellKnownCreate<R>) {\n  const builder =\n    <P extends RelayParams>(name: WellKnownName) =>\n      (params: P, extra?: RelayParams): R =>\n        create(name, params, extra);\n\n  return {\n    viewItem: builder<ViewItemParams>('view_item'),\n    viewItemList: builder<ViewItemListParams>('view_item_list'),\n    selectItem: builder<SelectItemParams>('select_item'),\n    addToCart: builder<AddToCartParams>('add_to_cart'),\n    removeFromCart: builder<RemoveFromCartParams>('remove_from_cart'),\n    viewCart: builder<ViewCartParams>('view_cart'),\n    beginCheckout: builder<BeginCheckoutParams>('begin_checkout'),\n    addShippingInfo: builder<AddShippingInfoParams>('add_shipping_info'),\n    addPaymentInfo: builder<AddPaymentInfoParams>('add_payment_info'),\n    purchase: builder<PurchaseParams>('purchase'),\n    refund: builder<RefundParams>('refund'),\n    search: builder<SearchParams>('search'),\n    signUp: builder<SignUpParams>('sign_up'),\n    login: builder<LoginParams>('login'),\n    generateLead: builder<GenerateLeadParams>('generate_lead'),\n  };\n}\n"],"mappings":";AAwFA,MAAM,iCAAsC,IAAI,IAAI;CAClD;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,SAAgB,gBAAgB,MAAuB;CACrD,OAAO,eAAe,IAAI,IAAI;AAChC;;;;;;AAUA,SAAgB,gBAAmB,QAA4B;CAC7D,MAAM,WACoB,UACrB,QAAW,UACV,OAAO,MAAM,QAAQ,KAAK;CAEhC,OAAO;EACL,UAAU,QAAwB,WAAW;EAC7C,cAAc,QAA4B,gBAAgB;EAC1D,YAAY,QAA0B,aAAa;EACnD,WAAW,QAAyB,aAAa;EACjD,gBAAgB,QAA8B,kBAAkB;EAChE,UAAU,QAAwB,WAAW;EAC7C,eAAe,QAA6B,gBAAgB;EAC5D,iBAAiB,QAA+B,mBAAmB;EACnE,gBAAgB,QAA8B,kBAAkB;EAChE,UAAU,QAAwB,UAAU;EAC5C,QAAQ,QAAsB,QAAQ;EACtC,QAAQ,QAAsB,QAAQ;EACtC,QAAQ,QAAsB,SAAS;EACvC,OAAO,QAAqB,OAAO;EACnC,cAAc,QAA4B,eAAe;CAC3D;AACF"}

package/dist/context-D11BBDcb.js

@@ -0,0 +1,27 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+// src/server/context.ts
+const CONTEXT_KEY = Symbol.for("@astroscope/relay.context");
+function storage() {
+	const holder = globalThis;
+	holder[CONTEXT_KEY] ??= new AsyncLocalStorage();
+	return holder[CONTEXT_KEY];
+}
+/** runs the rest of the request inside the relay context; the middleware's business */
+function runWithRelayContext(context, fn) {
+	return storage().run(context, fn);
+}
+/** the context of the current request, `undefined` outside one (a build, a cron, a startup hook) */
+function getRelayContext() {
+	return storage().getStore();
+}
+/**
+* The consent the current request carries, by destination name: what a server destination's default
+* `consent` reads, and what a custom one reads to share another destination's flag. Empty outside a
+* request and for a request the browser sent nothing with.
+*/
+function relayConsent() {
+	return getRelayContext()?.consent ?? {};
+}
+export { relayConsent as n, runWithRelayContext as r, getRelayContext as t };
+
+//# sourceMappingURL=context-D11BBDcb.js.map

package/dist/context-D11BBDcb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-D11BBDcb.js","names":[],"sources":["../src/server/context.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport type { APIContext } from 'astro';\nimport type { ConsentRecord } from '../shared.js';\n\n/** what the middleware knows about the request `track()` is called in */\nexport type RelayRequestContext = {\n  /** the consent the browser sent, by destination name */\n  consent: ConsentRecord;\n  context: APIContext;\n};\n\n// keyed on globalThis like the config: the middleware and a `track()` call may come from separate\n// module instances of this package, and the store must be the one the middleware wrote to\nconst CONTEXT_KEY = Symbol.for('@astroscope/relay.context');\n\ntype ContextHolder = { [CONTEXT_KEY]?: AsyncLocalStorage<RelayRequestContext> | undefined };\n\nfunction storage(): AsyncLocalStorage<RelayRequestContext> {\n  const holder = globalThis as ContextHolder;\n\n  holder[CONTEXT_KEY] ??= new AsyncLocalStorage<RelayRequestContext>();\n\n  return holder[CONTEXT_KEY];\n}\n\n/** runs the rest of the request inside the relay context; the middleware's business */\nexport function runWithRelayContext<T>(context: RelayRequestContext, fn: () => T): T {\n  return storage().run(context, fn);\n}\n\n/** the context of the current request, `undefined` outside one (a build, a cron, a startup hook) */\nexport function getRelayContext(): RelayRequestContext | undefined {\n  return storage().getStore();\n}\n\n/**\n * The consent the current request carries, by destination name: what a server destination's default\n * `consent` reads, and what a custom one reads to share another destination's flag. Empty outside a\n * request and for a request the browser sent nothing with.\n */\nexport function relayConsent(): ConsentRecord {\n  return getRelayContext()?.consent ?? {};\n}\n"],"mappings":";;AAaA,MAAM,cAAc,OAAO,IAAI,2BAA2B;AAI1D,SAAS,UAAkD;CACzD,MAAM,SAAS;CAEf,OAAO,iBAAiB,IAAI,kBAAuC;CAEnE,OAAO,OAAO;AAChB;;AAGA,SAAgB,oBAAuB,SAA8B,IAAgB;CACnF,OAAO,QAAQ,CAAC,CAAC,IAAI,SAAS,EAAE;AAClC;;AAGA,SAAgB,kBAAmD;CACjE,OAAO,QAAQ,CAAC,CAAC,SAAS;AAC5B;;;;;;AAOA,SAAgB,eAA8B;CAC5C,OAAO,gBAAgB,CAAC,EAAE,WAAW,CAAC;AACxC"}

package/dist/conversion-user-CV8xIWDK.js

@@ -0,0 +1,49 @@
+// src/conversion-user.ts
+/** normalizes and hashes the identifiers the way the pixels and the conversions apis expect them */
+async function hashUser(user, options = {}) {
+	const [email, phone, firstName, lastName] = await Promise.all([
+		hashOptional(normalizeEmail(user.email)),
+		hashOptional(normalizePhone(user.phone, options.countryCallingCode)),
+		hashOptional(normalizeName(user.firstName)),
+		hashOptional(normalizeName(user.lastName))
+	]);
+	return withoutEmpty({
+		email,
+		phone,
+		firstName,
+		lastName
+	});
+}
+function normalizeEmail(email) {
+	return email?.trim().toLowerCase() || void 0;
+}
+/**
+* Digits only, with the country calling code: a national number (one leading zero) gets the
+* site's code, `+` and `00` prefixes are dropped. Returns `undefined` for anything that is not
+* 8 to 15 digits afterwards.
+*/
+function normalizePhone(phone, countryCallingCode) {
+	const compact = phone?.replaceAll(/[\s().-]/g, "");
+	if (!compact) return;
+	const international = compact.startsWith("+") || compact.startsWith("00");
+	const national = compact.replace(/^\+?0*/, "");
+	const digits = international || !compact.startsWith("0") ? national : `${countryCallingCode ?? ""}${national}`;
+	return /^\d{8,15}$/.test(digits) ? digits : void 0;
+}
+/** lowercase, without whitespace and punctuation */
+function normalizeName(name) {
+	return name?.toLowerCase().replaceAll(/[\s!-/:-@[-`{-~]/g, "") || void 0;
+}
+async function sha256(value) {
+	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(value));
+	return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+async function hashOptional(value) {
+	return value ? sha256(value) : void 0;
+}
+function withoutEmpty(user) {
+	return Object.fromEntries(Object.entries(user).filter(([, value]) => value));
+}
+export { sha256 as a, normalizePhone as i, normalizeEmail as n, normalizeName as r, hashUser as t };
+
+//# sourceMappingURL=conversion-user-CV8xIWDK.js.map

package/dist/conversion-user-CV8xIWDK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-user-CV8xIWDK.js","names":[],"sources":["../src/conversion-user.ts"],"sourcesContent":["/** what the visitor entered for a conversion; a destination that identifies hashes it as it requires */\nexport type ConversionUser = {\n  email?: string | undefined;\n  phone?: string | undefined;\n  firstName?: string | undefined;\n  lastName?: string | undefined;\n};\n\n/** the identifiers of a visitor as the ad platforms match them: normalized, then sha256 as lowercase hex */\nexport type HashedUser = {\n  email?: string | undefined;\n  phone?: string | undefined;\n  firstName?: string | undefined;\n  lastName?: string | undefined;\n};\n\nexport type HashOptions = {\n  /**\n   * The country calling code a national phone number gets (`49` for a German site): a number\n   * with one leading zero is taken as national, `+` or `00` prefixes are international.\n   */\n  countryCallingCode?: string | undefined;\n};\n\n/** normalizes and hashes the identifiers the way the pixels and the conversions apis expect them */\nexport async function hashUser(user: ConversionUser, options: HashOptions = {}): Promise<HashedUser> {\n  const [email, phone, firstName, lastName] = await Promise.all([\n    hashOptional(normalizeEmail(user.email)),\n    hashOptional(normalizePhone(user.phone, options.countryCallingCode)),\n    hashOptional(normalizeName(user.firstName)),\n    hashOptional(normalizeName(user.lastName)),\n  ]);\n\n  return withoutEmpty({ email, phone, firstName, lastName });\n}\n\nexport function normalizeEmail(email: string | undefined): string | undefined {\n  return email?.trim().toLowerCase() || undefined;\n}\n\n/**\n * Digits only, with the country calling code: a national number (one leading zero) gets the\n * site's code, `+` and `00` prefixes are dropped. Returns `undefined` for anything that is not\n * 8 to 15 digits afterwards.\n */\nexport function normalizePhone(phone: string | undefined, countryCallingCode: string | undefined): string | undefined {\n  const compact = phone?.replaceAll(/[\\s().-]/g, '');\n\n  if (!compact) {\n    return undefined;\n  }\n\n  const international = compact.startsWith('+') || compact.startsWith('00');\n  const national = compact.replace(/^\\+?0*/, '');\n  const digits = international || !compact.startsWith('0') ? national : `${countryCallingCode ?? ''}${national}`;\n\n  return /^\\d{8,15}$/.test(digits) ? digits : undefined;\n}\n\n/** lowercase, without whitespace and punctuation */\nexport function normalizeName(name: string | undefined): string | undefined {\n  return name?.toLowerCase().replaceAll(/[\\s!-/:-@[-`{-~]/g, '') || undefined;\n}\n\nexport async function sha256(value: string): Promise<string> {\n  const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(value));\n\n  return Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, '0')).join('');\n}\n\nasync function hashOptional(value: string | undefined): Promise<string | undefined> {\n  return value ? sha256(value) : undefined;\n}\n\nfunction withoutEmpty(user: HashedUser): HashedUser {\n  return Object.fromEntries(Object.entries(user).filter(([, value]) => value)) as HashedUser;\n}\n"],"mappings":";;AAyBA,eAAsB,SAAS,MAAsB,UAAuB,CAAC,GAAwB;CACnG,MAAM,CAAC,OAAO,OAAO,WAAW,YAAY,MAAM,QAAQ,IAAI;EAC5D,aAAa,eAAe,KAAK,KAAK,CAAC;EACvC,aAAa,eAAe,KAAK,OAAO,QAAQ,kBAAkB,CAAC;EACnE,aAAa,cAAc,KAAK,SAAS,CAAC;EAC1C,aAAa,cAAc,KAAK,QAAQ,CAAC;CAC3C,CAAC;CAED,OAAO,aAAa;EAAE;EAAO;EAAO;EAAW;CAAS,CAAC;AAC3D;AAEA,SAAgB,eAAe,OAA+C;CAC5E,OAAO,OAAO,KAAK,CAAC,CAAC,YAAY,KAAK,KAAA;AACxC;;;;;;AAOA,SAAgB,eAAe,OAA2B,oBAA4D;CACpH,MAAM,UAAU,OAAO,WAAW,aAAa,EAAE;CAEjD,IAAI,CAAC,SACH;CAGF,MAAM,gBAAgB,QAAQ,WAAW,GAAG,KAAK,QAAQ,WAAW,IAAI;CACxE,MAAM,WAAW,QAAQ,QAAQ,UAAU,EAAE;CAC7C,MAAM,SAAS,iBAAiB,CAAC,QAAQ,WAAW,GAAG,IAAI,WAAW,GAAG,sBAAsB,KAAK;CAEpG,OAAO,aAAa,KAAK,MAAM,IAAI,SAAS,KAAA;AAC9C;;AAGA,SAAgB,cAAc,MAA8C;CAC1E,OAAO,MAAM,YAAY,CAAC,CAAC,WAAW,qBAAqB,EAAE,KAAK,KAAA;AACpE;AAEA,eAAsB,OAAO,OAAgC;CAC3D,MAAM,SAAS,MAAM,OAAO,OAAO,OAAO,WAAW,IAAI,YAAY,CAAC,CAAC,OAAO,KAAK,CAAC;CAEpF,OAAO,MAAM,KAAK,IAAI,WAAW,MAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;AACjG;AAEA,eAAe,aAAa,OAAwD;CAClF,OAAO,QAAQ,OAAO,KAAK,IAAI,KAAA;AACjC;AAEA,SAAS,aAAa,MAA8B;CAClD,OAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,CAAC,CAAC,QAAQ,GAAG,WAAW,KAAK,CAAC;AAC7E"}

package/dist/conversion-user-DCfM5EuZ.d.ts

@@ -0,0 +1,35 @@
+/** what the visitor entered for a conversion; a destination that identifies hashes it as it requires */
+type ConversionUser = {
+  email?: string | undefined;
+  phone?: string | undefined;
+  firstName?: string | undefined;
+  lastName?: string | undefined;
+};
+/** the identifiers of a visitor as the ad platforms match them: normalized, then sha256 as lowercase hex */
+type HashedUser = {
+  email?: string | undefined;
+  phone?: string | undefined;
+  firstName?: string | undefined;
+  lastName?: string | undefined;
+};
+type HashOptions = {
+  /**
+   * The country calling code a national phone number gets (`49` for a German site): a number
+   * with one leading zero is taken as national, `+` or `00` prefixes are international.
+   */
+  countryCallingCode?: string | undefined;
+};
+/** normalizes and hashes the identifiers the way the pixels and the conversions apis expect them */
+declare function hashUser(user: ConversionUser, options?: HashOptions): Promise<HashedUser>;
+declare function normalizeEmail(email: string | undefined): string | undefined;
+/**
+ * Digits only, with the country calling code: a national number (one leading zero) gets the
+ * site's code, `+` and `00` prefixes are dropped. Returns `undefined` for anything that is not
+ * 8 to 15 digits afterwards.
+ */
+declare function normalizePhone(phone: string | undefined, countryCallingCode: string | undefined): string | undefined;
+/** lowercase, without whitespace and punctuation */
+declare function normalizeName(name: string | undefined): string | undefined;
+declare function sha256(value: string): Promise<string>;
+export { normalizeEmail as a, sha256 as c, hashUser as i, HashOptions as n, normalizeName as o, HashedUser as r, normalizePhone as s, ConversionUser as t };
+//# sourceMappingURL=conversion-user-DCfM5EuZ.d.ts.map

package/dist/conversion-user-DCfM5EuZ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-user-DCfM5EuZ.d.ts","names":[],"sources":["../src/conversion-user.ts"],"mappings":";KACY;EACV;EACA;EACA;EACA;;;KAIU;EACV;EACA;EACA;EACA;;KAGU;;;;;EAKV;;;iBAIoB,SAAS,MAAM,gBAAgB,UAAS,cAAmB,QAAQ;iBAWzE,eAAe;;;;;;iBASf,eAAe,2BAA2B;;iBAe1C,cAAc;iBAIR,OAAO,gBAAgB"}

package/dist/ga4/index.d.ts

@@ -0,0 +1,50 @@
+import { a as Destination } from "../bus-Z7l8oJtS.js";
+import { d as RelayParams } from "../shared-CSwqcxPI.js";
+declare global {
+  interface Window {
+    dataLayer?: unknown[] | undefined;
+    gtag?: ((...args: unknown[]) => void) | undefined;
+    /** set by gtag.js once the tag has loaded */
+    google_tag_manager?: unknown;
+  }
+}
+/** what the google tag takes: `gtag('event', name, params)` */
+export type Ga4Event = {
+  name: string;
+  params: RelayParams;
+};
+declare module '@astroscope/relay' {
+  interface RelayDestinations {
+    ga4: Ga4Event;
+  }
+}
+/**
+ * The ga4 builders: the well-known events (ga4's recommended ones) typed by their parameters, and
+ * `event(name, params)` for a custom one. What an event definition puts under `ga4`.
+ */
+export declare const ga4: {
+  viewItem: (params: import("@astroscope/relay").ViewItemParams, extra?: RelayParams) => Ga4Event;
+  viewItemList: (params: import("@astroscope/relay").ViewItemListParams, extra?: RelayParams) => Ga4Event;
+  selectItem: (params: import("@astroscope/relay").SelectItemParams, extra?: RelayParams) => Ga4Event;
+  addToCart: (params: import("@astroscope/relay").AddToCartParams, extra?: RelayParams) => Ga4Event;
+  removeFromCart: (params: import("@astroscope/relay").RemoveFromCartParams, extra?: RelayParams) => Ga4Event;
+  viewCart: (params: import("@astroscope/relay").ViewCartParams, extra?: RelayParams) => Ga4Event;
+  beginCheckout: (params: import("@astroscope/relay").BeginCheckoutParams, extra?: RelayParams) => Ga4Event;
+  addShippingInfo: (params: import("@astroscope/relay").AddShippingInfoParams, extra?: RelayParams) => Ga4Event;
+  addPaymentInfo: (params: import("@astroscope/relay").AddPaymentInfoParams, extra?: RelayParams) => Ga4Event;
+  purchase: (params: import("@astroscope/relay").PurchaseParams, extra?: RelayParams) => Ga4Event;
+  refund: (params: import("@astroscope/relay").RefundParams, extra?: RelayParams) => Ga4Event;
+  search: (params: import("@astroscope/relay").SearchParams, extra?: RelayParams) => Ga4Event;
+  signUp: (params: import("@astroscope/relay").SignUpParams, extra?: RelayParams) => Ga4Event;
+  login: (params: import("@astroscope/relay").LoginParams, extra?: RelayParams) => Ga4Event;
+  generateLead: (params: import("@astroscope/relay").GenerateLeadParams, extra?: RelayParams) => Ga4Event;
+  event: (name: string, params?: RelayParams) => Ga4Event;
+};
+/**
+ * The google tag as a destination: hands the `ga4` payload of an event to `gtag('event', …)`. The
+ * `gtag` queue stub is installed right away, so the tag's own snippet only has to load; a consented
+ * event is delivered once it has and kept across a navigation until then. A site that runs the tag
+ * inside a tag-manager container takes `@astroscope/relay/gtm` instead.
+ */
+export declare function ga4Tag(): Destination<'ga4'>;
+//# sourceMappingURL=index.d.ts.map

package/dist/ga4/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ga4/index.ts"],"mappings":";;QAIQ;YACI;IACR;IACA,YAAY;;IAEZ;;;;YAKQ;EACV;EACA,QAAQ;;;YAIE;IACR,KAAK;;;;;;;qBAQI;;;;;;;;;;;;;;;;EACG,QAAA,cAAM,SAAU,gBAAmB;;;;;;;;wBAUnC,UAAU"}

package/dist/ga4/index.js

@@ -0,0 +1,45 @@
+import { n as wellKnownEvents } from "../commerce-DgNeBWhO.js";
+import { a as isBrowser } from "../shared-D281USsp.js";
+// src/ga4/index.ts
+/**
+* The ga4 builders: the well-known events (ga4's recommended ones) typed by their parameters, and
+* `event(name, params)` for a custom one. What an event definition puts under `ga4`.
+*/
+const ga4 = {
+	event: (name, params = {}) => ({
+		name,
+		params
+	}),
+	...wellKnownEvents((name, params, extra) => ({
+		name,
+		params: {
+			...extra,
+			...params
+		}
+	}))
+};
+/**
+* The google tag as a destination: hands the `ga4` payload of an event to `gtag('event', …)`. The
+* `gtag` queue stub is installed right away, so the tag's own snippet only has to load; a consented
+* event is delivered once it has and kept across a navigation until then. A site that runs the tag
+* inside a tag-manager container takes `@astroscope/relay/gtm` instead.
+*/
+function ga4Tag() {
+	if (isBrowser()) installQueue();
+	return {
+		name: "ga4",
+		ready: () => isBrowser() && globalThis.window.google_tag_manager !== void 0,
+		send: (event) => {
+			globalThis.window.gtag?.("event", event.name, event.params);
+		}
+	};
+}
+function installQueue() {
+	window.dataLayer ??= [];
+	window.gtag ??= function() {
+		globalThis.window.dataLayer?.push(arguments);
+	};
+}
+export { ga4, ga4Tag };
+
+//# sourceMappingURL=index.js.map

package/dist/ga4/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/ga4/index.ts"],"sourcesContent":["import type { Destination } from '../client/bus.js';\nimport { wellKnownEvents } from '../commerce.js';\nimport { type RelayParams, isBrowser } from '../shared.js';\n\ndeclare global {\n  interface Window {\n    dataLayer?: unknown[] | undefined;\n    gtag?: ((...args: unknown[]) => void) | undefined;\n    /** set by gtag.js once the tag has loaded */\n    google_tag_manager?: unknown;\n  }\n}\n\n/** what the google tag takes: `gtag('event', name, params)` */\nexport type Ga4Event = {\n  name: string;\n  params: RelayParams;\n};\n\ndeclare module '@astroscope/relay' {\n  interface RelayDestinations {\n    ga4: Ga4Event;\n  }\n}\n\n/**\n * The ga4 builders: the well-known events (ga4's recommended ones) typed by their parameters, and\n * `event(name, params)` for a custom one. What an event definition puts under `ga4`.\n */\nexport const ga4 = {\n  event: (name: string, params: RelayParams = {}): Ga4Event => ({ name, params }),\n  ...wellKnownEvents((name, params, extra): Ga4Event => ({ name, params: { ...extra, ...params } })),\n};\n\n/**\n * The google tag as a destination: hands the `ga4` payload of an event to `gtag('event', …)`. The\n * `gtag` queue stub is installed right away, so the tag's own snippet only has to load; a consented\n * event is delivered once it has and kept across a navigation until then. A site that runs the tag\n * inside a tag-manager container takes `@astroscope/relay/gtm` instead.\n */\nexport function ga4Tag(): Destination<'ga4'> {\n  if (isBrowser()) {\n    installQueue();\n  }\n\n  return {\n    name: 'ga4',\n    ready: () => isBrowser() && globalThis.window.google_tag_manager !== undefined,\n    send: (event) => {\n      globalThis.window.gtag?.('event', event.name, event.params);\n    },\n  };\n}\n\n// the google snippet: the tag replays the `arguments` entries of the data layer once loaded\nfunction installQueue(): void {\n  /* eslint-disable unicorn/no-global-object-property-assignment -- `window.dataLayer` and `window.gtag` are the tag's documented contract */\n  window.dataLayer ??= [];\n  window.gtag ??= function () {\n    // eslint-disable-next-line prefer-rest-params -- gtag.js processes `arguments` objects only\n    globalThis.window.dataLayer?.push(arguments);\n  };\n  /* eslint-enable unicorn/no-global-object-property-assignment */\n}\n"],"mappings":";;;;;;;AA6BA,MAAa,MAAM;CACjB,QAAQ,MAAc,SAAsB,CAAC,OAAiB;EAAE;EAAM;CAAO;CAC7E,GAAG,iBAAiB,MAAM,QAAQ,WAAqB;EAAE;EAAM,QAAQ;GAAE,GAAG;GAAO,GAAG;EAAO;CAAE,EAAE;AACnG;;;;;;;AAQA,SAAgB,SAA6B;CAC3C,IAAI,UAAU,GACZ,aAAa;CAGf,OAAO;EACL,MAAM;EACN,aAAa,UAAU,KAAK,WAAW,OAAO,uBAAuB,KAAA;EACrE,OAAO,UAAU;GACf,WAAW,OAAO,OAAO,SAAS,MAAM,MAAM,MAAM,MAAM;EAC5D;CACF;AACF;AAGA,SAAS,eAAqB;CAE5B,OAAO,cAAc,CAAC;CACtB,OAAO,SAAS,WAAY;EAE1B,WAAW,OAAO,WAAW,KAAK,SAAS;CAC7C;AAEF"}

package/dist/gtm/index.d.ts

@@ -0,0 +1,51 @@
+import { a as Destination } from "../bus-Z7l8oJtS.js";
+import { d as RelayParams } from "../shared-CSwqcxPI.js";
+declare global {
+  interface Window {
+    dataLayer?: unknown[] | undefined;
+    /** set by gtm.js once the container has loaded */
+    google_tag_manager?: unknown;
+  }
+}
+/** one data layer push: the container's event name and what its variables read */
+export type GtmPush = RelayParams & {
+  event: string;
+};
+declare module '@astroscope/relay' {
+  interface RelayDestinations {
+    gtm: GtmPush;
+  }
+}
+/**
+ * The tag-manager builders: `event(name, params)` is the push as the container's variables read
+ * it; the well-known events put their parameters under `ecommerce` — the shape a container's ga4
+ * tags are written against — and take the parameters next to it second (`purchase(commerce, {
+ * user_email })`). What an event definition puts under `gtm`.
+ */
+export declare const gtm: {
+  viewItem: (params: import("@astroscope/relay").ViewItemParams, extra?: RelayParams) => GtmPush;
+  viewItemList: (params: import("@astroscope/relay").ViewItemListParams, extra?: RelayParams) => GtmPush;
+  selectItem: (params: import("@astroscope/relay").SelectItemParams, extra?: RelayParams) => GtmPush;
+  addToCart: (params: import("@astroscope/relay").AddToCartParams, extra?: RelayParams) => GtmPush;
+  removeFromCart: (params: import("@astroscope/relay").RemoveFromCartParams, extra?: RelayParams) => GtmPush;
+  viewCart: (params: import("@astroscope/relay").ViewCartParams, extra?: RelayParams) => GtmPush;
+  beginCheckout: (params: import("@astroscope/relay").BeginCheckoutParams, extra?: RelayParams) => GtmPush;
+  addShippingInfo: (params: import("@astroscope/relay").AddShippingInfoParams, extra?: RelayParams) => GtmPush;
+  addPaymentInfo: (params: import("@astroscope/relay").AddPaymentInfoParams, extra?: RelayParams) => GtmPush;
+  purchase: (params: import("@astroscope/relay").PurchaseParams, extra?: RelayParams) => GtmPush;
+  refund: (params: import("@astroscope/relay").RefundParams, extra?: RelayParams) => GtmPush;
+  search: (params: import("@astroscope/relay").SearchParams, extra?: RelayParams) => GtmPush;
+  signUp: (params: import("@astroscope/relay").SignUpParams, extra?: RelayParams) => GtmPush;
+  login: (params: import("@astroscope/relay").LoginParams, extra?: RelayParams) => GtmPush;
+  generateLead: (params: import("@astroscope/relay").GenerateLeadParams, extra?: RelayParams) => GtmPush;
+  event: (name: string, params?: RelayParams) => GtmPush;
+};
+/**
+ * A tag-manager container as a destination: pushes the `gtm` payload of an event into the data layer
+ * with the event id (`event_id`, what the container's Meta or Ads tags use to deduplicate against
+ * their server-side counterparts). Which tags fire on a push is the container's business, so the
+ * consent asked for is the container's own (its embedding in the cmp). Ready once the container
+ * has loaded.
+ */
+export declare function gtmContainer(): Destination<'gtm'>;
+//# sourceMappingURL=index.d.ts.map

package/dist/gtm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/gtm/index.ts"],"mappings":";;QAIQ;YACI;IACR;;IAEA;;;;YAKQ,UAAU;EACpB;;;YAIU;IACR,KAAK;;;;;;;;;qBAUI;;;;;;;;;;;;;;;;EACG,QAAA,cAAM,SAAU,gBAAmB;;;;;;;;;wBAcnC,gBAAgB"}

package/dist/gtm/index.js

@@ -0,0 +1,49 @@
+import { n as wellKnownEvents, t as isCommerceEvent } from "../commerce-DgNeBWhO.js";
+import { a as isBrowser } from "../shared-D281USsp.js";
+// src/gtm/index.ts
+/**
+* The tag-manager builders: `event(name, params)` is the push as the container's variables read
+* it; the well-known events put their parameters under `ecommerce` — the shape a container's ga4
+* tags are written against — and take the parameters next to it second (`purchase(commerce, {
+* user_email })`). What an event definition puts under `gtm`.
+*/
+const gtm = {
+	event: (name, params = {}) => ({
+		event: name,
+		...params
+	}),
+	...wellKnownEvents((name, params, extra) => isCommerceEvent(name) ? {
+		event: name,
+		...extra,
+		ecommerce: params
+	} : {
+		event: name,
+		...extra,
+		...params
+	})
+};
+/**
+* A tag-manager container as a destination: pushes the `gtm` payload of an event into the data layer
+* with the event id (`event_id`, what the container's Meta or Ads tags use to deduplicate against
+* their server-side counterparts). Which tags fire on a push is the container's business, so the
+* consent asked for is the container's own (its embedding in the cmp). Ready once the container
+* has loaded.
+*/
+function gtmContainer() {
+	return {
+		name: "gtm",
+		ready: () => isBrowser() && globalThis.window.google_tag_manager !== void 0,
+		send: (push, meta) => {
+			const dataLayer = globalThis.window.dataLayer ??= [];
+			const entry = {
+				...push,
+				event_id: meta.id
+			};
+			if ("ecommerce" in push) dataLayer.push({ ecommerce: null }, entry);
+			else dataLayer.push(entry);
+		}
+	};
+}
+export { gtm, gtmContainer };
+
+//# sourceMappingURL=index.js.map

package/dist/gtm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/gtm/index.ts"],"sourcesContent":["import type { Destination } from '../client/bus.js';\nimport { isCommerceEvent, wellKnownEvents } from '../commerce.js';\nimport { type RelayParams, isBrowser } from '../shared.js';\n\ndeclare global {\n  interface Window {\n    dataLayer?: unknown[] | undefined;\n    /** set by gtm.js once the container has loaded */\n    google_tag_manager?: unknown;\n  }\n}\n\n/** one data layer push: the container's event name and what its variables read */\nexport type GtmPush = RelayParams & {\n  event: string;\n};\n\ndeclare module '@astroscope/relay' {\n  interface RelayDestinations {\n    gtm: GtmPush;\n  }\n}\n\n/**\n * The tag-manager builders: `event(name, params)` is the push as the container's variables read\n * it; the well-known events put their parameters under `ecommerce` — the shape a container's ga4\n * tags are written against — and take the parameters next to it second (`purchase(commerce, {\n * user_email })`). What an event definition puts under `gtm`.\n */\nexport const gtm = {\n  event: (name: string, params: RelayParams = {}): GtmPush => ({ event: name, ...params }),\n  ...wellKnownEvents(\n    (name, params, extra): GtmPush =>\n      isCommerceEvent(name) ? { event: name, ...extra, ecommerce: params } : { event: name, ...extra, ...params },\n  ),\n};\n\n/**\n * A tag-manager container as a destination: pushes the `gtm` payload of an event into the data layer\n * with the event id (`event_id`, what the container's Meta or Ads tags use to deduplicate against\n * their server-side counterparts). Which tags fire on a push is the container's business, so the\n * consent asked for is the container's own (its embedding in the cmp). Ready once the container\n * has loaded.\n */\nexport function gtmContainer(): Destination<'gtm'> {\n  return {\n    name: 'gtm',\n    ready: () => isBrowser() && globalThis.window.google_tag_manager !== undefined,\n    send: (push, meta) => {\n      const dataLayer = (globalThis.window.dataLayer ??= []);\n      const entry = { ...push, event_id: meta.id };\n\n      if ('ecommerce' in push) {\n        // the container merges pushes, a cleared object keeps the previous event's items out\n        dataLayer.push({ ecommerce: null }, entry);\n      } else {\n        dataLayer.push(entry);\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;AA6BA,MAAa,MAAM;CACjB,QAAQ,MAAc,SAAsB,CAAC,OAAgB;EAAE,OAAO;EAAM,GAAG;CAAO;CACtF,GAAG,iBACA,MAAM,QAAQ,UACb,gBAAgB,IAAI,IAAI;EAAE,OAAO;EAAM,GAAG;EAAO,WAAW;CAAO,IAAI;EAAE,OAAO;EAAM,GAAG;EAAO,GAAG;CAAO,CAC9G;AACF;;;;;;;;AASA,SAAgB,eAAmC;CACjD,OAAO;EACL,MAAM;EACN,aAAa,UAAU,KAAK,WAAW,OAAO,uBAAuB,KAAA;EACrE,OAAO,MAAM,SAAS;GACpB,MAAM,YAAa,WAAW,OAAO,cAAc,CAAC;GACpD,MAAM,QAAQ;IAAE,GAAG;IAAM,UAAU,KAAK;GAAG;GAE3C,IAAI,eAAe,MAEjB,UAAU,KAAK,EAAE,WAAW,KAAK,GAAG,KAAK;QAEzC,UAAU,KAAK,KAAK;EAExB;CACF;AACF"}

package/dist/index.browser.d.ts

@@ -0,0 +1,8 @@
+import { t as ConversionUser } from "./conversion-user-DCfM5EuZ.js";
+import { n as collect, r as inlineTrack, t as CollectOptions } from "./collect-DRl177oR.js";
+import { _ as WellKnownCreate, a as CommerceItem, b as wellKnownEvents, c as PurchaseParams, d as SearchParams, f as SelectItemParams, g as ViewItemParams, h as ViewItemListParams, i as BeginCheckoutParams, l as RefundParams, m as ViewCartParams, n as AddShippingInfoParams, o as GenerateLeadParams, p as SignUpParams, r as AddToCartParams, s as LoginParams, t as AddPaymentInfoParams, u as RemoveFromCartParams, v as WellKnownName, y as isCommerceEvent } from "./commerce-DCGO8yag.js";
+import { a as DomainEvent, c as RELAY_TRACK_ATTRIBUTE, d as RelayParams, h as trackAttribute, i as DestinationName, l as RelayDestinations, m as defineEvent, n as ConsentRecord, o as EventDefinition, p as TrackInput, r as ConsentSource, s as EventMeta, t as ConsentAnswer, u as RelayEvent } from "./shared-CSwqcxPI.js";
+/** the integration is server-only; the browser build of the root entry never loads it */
+export default function relayIntegration(): never;
+export { type AddPaymentInfoParams, type AddShippingInfoParams, type AddToCartParams, type BeginCheckoutParams, type CollectOptions, type CommerceItem, type ConsentAnswer, type ConsentRecord, type ConsentSource, type ConversionUser, type DestinationName, type DomainEvent, type EventDefinition, type EventMeta, type GenerateLeadParams, type LoginParams, type PurchaseParams, RELAY_TRACK_ATTRIBUTE, type RefundParams, type RelayDestinations, type RelayEvent, type RelayParams, type RemoveFromCartParams, type SearchParams, type SelectItemParams, type SignUpParams, type TrackInput, type ViewCartParams, type ViewItemListParams, type ViewItemParams, type WellKnownCreate, type WellKnownName, collect, defineEvent, inlineTrack, isCommerceEvent, trackAttribute, wellKnownEvents };
+//# sourceMappingURL=index.browser.d.ts.map

package/dist/index.browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.d.ts","names":[],"sources":["../src/index.browser.ts"],"mappings":";;;;;wBAyCwB"}

package/dist/index.browser.js

@@ -0,0 +1,11 @@
+import { n as inlineTrack, t as collect } from "./collect-DWdHyn-u.js";
+import { n as wellKnownEvents, t as isCommerceEvent } from "./commerce-DgNeBWhO.js";
+import { d as trackAttribute, n as RELAY_TRACK_ATTRIBUTE, r as defineEvent } from "./shared-D281USsp.js";
+// src/index.browser.ts
+/** the integration is server-only; the browser build of the root entry never loads it */
+function relayIntegration() {
+	throw new Error("the @astroscope/relay integration is server-only");
+}
+export { RELAY_TRACK_ATTRIBUTE, collect, relayIntegration as default, defineEvent, inlineTrack, isCommerceEvent, trackAttribute, wellKnownEvents };
+
+//# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","names":[],"sources":["../src/index.browser.ts"],"sourcesContent":["export type { ConversionUser } from './conversion-user.js';\nexport { inlineTrack } from './inline.js';\nexport type { CollectOptions } from './collect.js';\nexport { collect } from './collect.js';\nexport type {\n  AddPaymentInfoParams,\n  AddShippingInfoParams,\n  AddToCartParams,\n  BeginCheckoutParams,\n  CommerceItem,\n  GenerateLeadParams,\n  LoginParams,\n  PurchaseParams,\n  RefundParams,\n  RemoveFromCartParams,\n  SearchParams,\n  SelectItemParams,\n  SignUpParams,\n  ViewCartParams,\n  ViewItemListParams,\n  ViewItemParams,\n  WellKnownCreate,\n  WellKnownName,\n} from './commerce.js';\nexport { isCommerceEvent, wellKnownEvents } from './commerce.js';\nexport type {\n  ConsentAnswer,\n  ConsentRecord,\n  ConsentSource,\n  DomainEvent,\n  EventDefinition,\n  EventMeta,\n  DestinationName,\n  RelayEvent,\n  RelayParams,\n  RelayDestinations,\n  TrackInput,\n} from './shared.js';\nexport { RELAY_TRACK_ATTRIBUTE, defineEvent, trackAttribute } from './shared.js';\n\n/** the integration is server-only; the browser build of the root entry never loads it */\nexport default function relayIntegration(): never {\n  throw new Error('the @astroscope/relay integration is server-only');\n}\n"],"mappings":";;;;;AAyCA,SAAwB,mBAA0B;CAChD,MAAM,IAAI,MAAM,kDAAkD;AACpE"}