@astroscope/relay 0.0.0-stage → 1.0.1

package/dist/openai/index.js

@@ -0,0 +1,79 @@
+import { t as hashUser } from "../conversion-user-CV8xIWDK.js";
+import { a as isBrowser } from "../shared-D281USsp.js";
+// src/openai/shared.ts
+/** the openai builders: the events openai has a name for. What an event definition puts under `openai` */
+const openai = {
+	contentsViewed: (contents) => contentsEvent("contents_viewed", contents),
+	itemsAdded: (contents) => contentsEvent("items_added", contents),
+	checkoutStarted: (contents) => contentsEvent("checkout_started", contents),
+	orderCreated: (contents) => contentsEvent("order_created", contents),
+	leadCreated: (user) => ({
+		name: "lead_created",
+		data: { type: "customer_action" },
+		user
+	})
+};
+function contentsEvent(name, { items, currency, value, contentType = "product", user }) {
+	return {
+		name,
+		data: {
+			type: "contents",
+			amount: toMinorUnits(value ?? items.reduce((sum, item) => sum + item.price * item.quantity, 0)),
+			currency,
+			contents: items.map((item) => ({
+				id: item.id,
+				name: item.name,
+				content_type: contentType,
+				quantity: item.quantity,
+				amount: toMinorUnits(item.price),
+				currency
+			}))
+		},
+		user
+	};
+}
+function toMinorUnits(value) {
+	return Math.round(value * 100);
+}
+// src/openai/index.ts
+let initializedUserKey;
+/**
+* The openai ads pixel as a destination: measures the `openai` payload of an event under the event's
+* id, so a conversion the server also reported through the conversions api counts once. The pixel
+* is injected by the cmp after consent, so `window.oaiq` shows up late: events wait for it. The
+* identifiers an event carries are hashed and sent through `init` right before it.
+*/
+function openAiPixel(options = {}) {
+	return {
+		name: "openai",
+		ready: () => isBrowser() && typeof globalThis.window.oaiq === "function",
+		send: (event, meta) => {
+			const user = event.user ? hashUser(event.user, { countryCallingCode: options.countryCallingCode }) : void 0;
+			Promise.resolve(user).then((hashed) => measure(event, meta, hashed)).catch((error) => console.error("relay: destination openai failed", error));
+		}
+	};
+}
+function measure(event, meta, hashed) {
+	const oaiq = window.oaiq;
+	if (!oaiq) return;
+	if (hashed) identify(oaiq, hashed);
+	oaiq("measure", event.name, event.data, { event_id: meta.id });
+}
+function identify(oaiq, hashed) {
+	const user = withoutEmpty({
+		email_sha256: hashed.email,
+		phone_number_sha256: hashed.phone,
+		first_name_sha256: hashed.firstName,
+		last_name_sha256: hashed.lastName
+	});
+	const key = JSON.stringify(user);
+	if (key === initializedUserKey || Object.keys(user).length === 0) return;
+	initializedUserKey = key;
+	oaiq("init", { user });
+}
+function withoutEmpty(user) {
+	return Object.fromEntries(Object.entries(user).filter(([, value]) => value));
+}
+export { openAiPixel, openai, toMinorUnits };
+
+//# sourceMappingURL=index.js.map

package/dist/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/openai/shared.ts","../../src/openai/index.ts"],"sourcesContent":["// imported by the pixel and the conversions api — no node or browser imports here\n\nimport type { ConversionUser } from '../conversion-user.js';\n\n/** monetary values are integers in the minor unit of the currency: 12999 for 129.99 EUR */\nexport type OpenAiContent = {\n  id: string;\n  name: string;\n  content_type: string;\n  quantity: number;\n  amount: number;\n  currency: string;\n};\n\nexport type OpenAiContentsData = {\n  type: 'contents';\n  amount: number;\n  currency: string;\n  contents: readonly OpenAiContent[];\n};\n\nexport type OpenAiCustomerActionData = {\n  type: 'customer_action';\n};\n\n/**\n * What openai takes, from the pixel and from the conversions api alike: the event and, for a\n * conversion the visitor entered identifiers for, the identifiers — hashed by whichever half sends.\n */\nexport type OpenAiEvent = (\n  | {\n    name: 'contents_viewed' | 'items_added' | 'checkout_started' | 'order_created';\n    data: OpenAiContentsData;\n  }\n  | {\n    name: 'lead_created';\n    data: OpenAiCustomerActionData;\n  }\n) & {\n  user?: ConversionUser | undefined;\n};\n\ndeclare module '@astroscope/relay' {\n  interface RelayDestinations {\n    openai: OpenAiEvent;\n  }\n}\n\nexport type OpenAiContentInput = { id: string; name: string; price: number; quantity: number };\n\nexport type OpenAiContents = {\n  items: readonly OpenAiContentInput[];\n  currency: string;\n  /** the total; default: the items summed */\n  value?: number | undefined;\n  /** the `content_type` of the contents; default `product` */\n  contentType?: string | undefined;\n  user?: ConversionUser | undefined;\n};\n\n/** the openai builders: the events openai has a name for. What an event definition puts under `openai` */\nexport const openai = {\n  contentsViewed: (contents: OpenAiContents): OpenAiEvent => contentsEvent('contents_viewed', contents),\n  itemsAdded: (contents: OpenAiContents): OpenAiEvent => contentsEvent('items_added', contents),\n  checkoutStarted: (contents: OpenAiContents): OpenAiEvent => contentsEvent('checkout_started', contents),\n  orderCreated: (contents: OpenAiContents): OpenAiEvent => contentsEvent('order_created', contents),\n  leadCreated: (user?: ConversionUser): OpenAiEvent => ({ name: 'lead_created', data: { type: 'customer_action' }, user }),\n};\n\nfunction contentsEvent(\n  name: 'contents_viewed' | 'items_added' | 'checkout_started' | 'order_created',\n  { items, currency, value, contentType = 'product', user }: OpenAiContents,\n): OpenAiEvent {\n  const total = value ?? items.reduce((sum, item) => sum + item.price * item.quantity, 0);\n\n  return {\n    name,\n    data: {\n      type: 'contents',\n      amount: toMinorUnits(total),\n      currency,\n      contents: items.map((item) => ({\n        id: item.id,\n        name: item.name,\n        content_type: contentType,\n        quantity: item.quantity,\n        amount: toMinorUnits(item.price),\n        currency,\n      })),\n    },\n    user,\n  };\n}\n\nexport function toMinorUnits(value: number): number {\n  return Math.round(value * 100);\n}\n","import type { Destination } from '../client/bus.js';\nimport { type HashedUser, hashUser } from '../conversion-user.js';\nimport { type EventMeta, isBrowser } from '../shared.js';\nimport type { OpenAiEvent } from './shared.js';\n\nexport type { OpenAiContent, OpenAiContentInput, OpenAiContents, OpenAiContentsData, OpenAiCustomerActionData, OpenAiEvent } from './shared.js';\nexport { openai, toMinorUnits } from './shared.js';\n\n/** advanced matching data of the pixel: normalized identifiers as lowercase sha256 hex */\ntype OpenAiUser = {\n  email_sha256?: string | undefined;\n  phone_number_sha256?: string | undefined;\n  first_name_sha256?: string | undefined;\n  last_name_sha256?: string | undefined;\n};\n\ntype OpenAiOptions = {\n  /** deduplicates against the same event sent through the conversions api */\n  event_id?: string | undefined;\n};\n\ntype Oaiq = {\n  (command: 'init', options: { user: OpenAiUser }): void;\n  (command: 'measure', name: OpenAiEvent['name'], data: OpenAiEvent['data'], options?: OpenAiOptions): void;\n};\n\ndeclare global {\n  interface Window {\n    oaiq?: Oaiq | undefined;\n  }\n}\n\nexport type OpenAiPixelOptions = {\n  /** the country calling code national phone numbers get before hashing, e.g. `49` */\n  countryCallingCode?: string | undefined;\n};\n\nlet initializedUserKey: string | undefined;\n\n/**\n * The openai ads pixel as a destination: measures the `openai` payload of an event under the event's\n * id, so a conversion the server also reported through the conversions api counts once. The pixel\n * is injected by the cmp after consent, so `window.oaiq` shows up late: events wait for it. The\n * identifiers an event carries are hashed and sent through `init` right before it.\n */\nexport function openAiPixel(options: OpenAiPixelOptions = {}): Destination<'openai'> {\n  return {\n    name: 'openai',\n    ready: () => isBrowser() && typeof globalThis.window.oaiq === 'function',\n    send: (event, meta) => {\n      const user = event.user ? hashUser(event.user, { countryCallingCode: options.countryCallingCode }) : undefined;\n\n      void Promise.resolve(user)\n        .then((hashed) => measure(event, meta, hashed))\n        .catch((error: unknown) => console.error('relay: destination openai failed', error));\n    },\n  };\n}\n\nfunction measure(event: OpenAiEvent, meta: EventMeta, hashed: HashedUser | undefined): void {\n  const oaiq = window.oaiq;\n\n  if (!oaiq) return;\n\n  if (hashed) {\n    identify(oaiq, hashed);\n  }\n\n  oaiq('measure', event.name, event.data as OpenAiEvent['data'], { event_id: meta.id });\n}\n\nfunction identify(oaiq: Oaiq, hashed: HashedUser): void {\n  const user = withoutEmpty({\n    email_sha256: hashed.email,\n    phone_number_sha256: hashed.phone,\n    first_name_sha256: hashed.firstName,\n    last_name_sha256: hashed.lastName,\n  });\n  const key = JSON.stringify(user);\n\n  if (key === initializedUserKey || Object.keys(user).length === 0) {\n    return;\n  }\n\n  initializedUserKey = key;\n  oaiq('init', { user });\n}\n\nfunction withoutEmpty(user: OpenAiUser): OpenAiUser {\n  return Object.fromEntries(Object.entries(user).filter(([, value]) => value)) as OpenAiUser;\n}\n"],"mappings":";;;;AA6DA,MAAa,SAAS;CACpB,iBAAiB,aAA0C,cAAc,mBAAmB,QAAQ;CACpG,aAAa,aAA0C,cAAc,eAAe,QAAQ;CAC5F,kBAAkB,aAA0C,cAAc,oBAAoB,QAAQ;CACtG,eAAe,aAA0C,cAAc,iBAAiB,QAAQ;CAChG,cAAc,UAAwC;EAAE,MAAM;EAAgB,MAAM,EAAE,MAAM,kBAAkB;EAAG;CAAK;AACxH;AAEA,SAAS,cACP,MACA,EAAE,OAAO,UAAU,OAAO,cAAc,WAAW,QACtC;CAGb,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,QAAQ,aANE,SAAS,MAAM,QAAQ,KAAK,SAAS,MAAM,KAAK,QAAQ,KAAK,UAAU,CAAC,CAMxD;GAC1B;GACA,UAAU,MAAM,KAAK,UAAU;IAC7B,IAAI,KAAK;IACT,MAAM,KAAK;IACX,cAAc;IACd,UAAU,KAAK;IACf,QAAQ,aAAa,KAAK,KAAK;IAC/B;GACF,EAAE;EACJ;EACA;CACF;AACF;AAEA,SAAgB,aAAa,OAAuB;CAClD,OAAO,KAAK,MAAM,QAAQ,GAAG;AAC/B;;AC3DA,IAAI;;;;;;;AAQJ,SAAgB,YAAY,UAA8B,CAAC,GAA0B;CACnF,OAAO;EACL,MAAM;EACN,aAAa,UAAU,KAAK,OAAO,WAAW,OAAO,SAAS;EAC9D,OAAO,OAAO,SAAS;GACrB,MAAM,OAAO,MAAM,OAAO,SAAS,MAAM,MAAM,EAAE,oBAAoB,QAAQ,mBAAmB,CAAC,IAAI,KAAA;GAErG,QAAa,QAAQ,IAAI,CAAC,CACvB,MAAM,WAAW,QAAQ,OAAO,MAAM,MAAM,CAAC,CAAC,CAC9C,OAAO,UAAmB,QAAQ,MAAM,oCAAoC,KAAK,CAAC;EACvF;CACF;AACF;AAEA,SAAS,QAAQ,OAAoB,MAAiB,QAAsC;CAC1F,MAAM,OAAO,OAAO;CAEpB,IAAI,CAAC,MAAM;CAEX,IAAI,QACF,SAAS,MAAM,MAAM;CAGvB,KAAK,WAAW,MAAM,MAAM,MAAM,MAA6B,EAAE,UAAU,KAAK,GAAG,CAAC;AACtF;AAEA,SAAS,SAAS,MAAY,QAA0B;CACtD,MAAM,OAAO,aAAa;EACxB,cAAc,OAAO;EACrB,qBAAqB,OAAO;EAC5B,mBAAmB,OAAO;EAC1B,kBAAkB,OAAO;CAC3B,CAAC;CACD,MAAM,MAAM,KAAK,UAAU,IAAI;CAE/B,IAAI,QAAQ,sBAAsB,OAAO,KAAK,IAAI,CAAC,CAAC,WAAW,GAC7D;CAGF,qBAAqB;CACrB,KAAK,QAAQ,EAAE,KAAK,CAAC;AACvB;AAEA,SAAS,aAAa,MAA8B;CAClD,OAAO,OAAO,YAAY,OAAO,QAAQ,IAAI,CAAC,CAAC,QAAQ,GAAG,WAAW,KAAK,CAAC;AAC7E"}

package/dist/openai/server.d.ts

@@ -0,0 +1,17 @@
+import { a as ServerDestination } from "../runtime-J8VplGyY.js";
+export type OpenAiConversionsOptions = {
+  /** the conversions api key from the ads manager */
+  apiKey: string;
+  pixelId: string;
+  /** names the sending system in the request, e.g. `my-site-de` */
+  integrationSource: string;
+  /** the country calling code national phone numbers get before hashing, e.g. `49` */
+  countryCallingCode?: string | undefined;
+  fetch?: typeof fetch | undefined;
+};
+/**
+ * The openai ads conversions api as a server destination: reports the `openai` payload of an event
+ * under the id the pixel fires it with.
+ */
+export declare function openAiConversions(options: OpenAiConversionsOptions): ServerDestination<'openai'>;
+//# sourceMappingURL=server.d.ts.map

package/dist/openai/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","names":[],"sources":["../../src/openai/server.ts"],"mappings":";YAUY;;EAEV;EACA;;EAEA;;EAEA;EACA,eAAe;;;;;;wBAOD,kBAAkB,SAAS,2BAA2B"}

package/dist/openai/server.js

@@ -0,0 +1,55 @@
+import { t as hashUser } from "../conversion-user-CV8xIWDK.js";
+// src/openai/server.ts
+const CONVERSIONS_API_URL = "https://bzr.openai.com/v1/events";
+const CONVERSIONS_API_TIMEOUT_MS = 1e4;
+/** the click reference the pixel stores for the visitor who came from an openai ad */
+const CLICK_REFERENCE_COOKIE = "__obref";
+/**
+* The openai ads conversions api as a server destination: reports the `openai` payload of an event
+* under the id the pixel fires it with.
+*/
+function openAiConversions(options) {
+	const doFetch = options.fetch ?? fetch;
+	return {
+		name: "openai",
+		async send(event, { id, request }) {
+			const hashed = await hashUser(event.user ?? {}, { countryCallingCode: options.countryCallingCode });
+			const body = {
+				integration_source: options.integrationSource,
+				events: [{
+					id,
+					type: event.name,
+					timestamp_ms: Date.now(),
+					source_url: request.sourceUrl,
+					action_source: "web",
+					user: {
+						emails_sha256: toList(hashed.email),
+						phone_numbers_sha256: toList(hashed.phone),
+						first_names_sha256: toList(hashed.firstName),
+						last_names_sha256: toList(hashed.lastName),
+						ip_address: request.clientAddress,
+						user_agent: request.headers.get("user-agent") ?? void 0,
+						obref: request.cookie(CLICK_REFERENCE_COOKIE)
+					},
+					data: event.data
+				}]
+			};
+			const response = await doFetch(`${CONVERSIONS_API_URL}?pid=${encodeURIComponent(options.pixelId)}`, {
+				method: "POST",
+				headers: {
+					authorization: `Bearer ${options.apiKey}`,
+					"content-type": "application/json"
+				},
+				body: JSON.stringify(body),
+				signal: AbortSignal.timeout(CONVERSIONS_API_TIMEOUT_MS)
+			});
+			if (!response.ok) throw new Error(`conversions api responded ${response.status}: ${await response.text()}`);
+		}
+	};
+}
+function toList(value) {
+	return value ? [value] : void 0;
+}
+export { openAiConversions };
+
+//# sourceMappingURL=server.js.map

package/dist/openai/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":[],"sources":["../../src/openai/server.ts"],"sourcesContent":["import { hashUser } from '../conversion-user.js';\nimport type { ServerDestination } from '../runtime.js';\nimport type { OpenAiEvent } from './shared.js';\n\nconst CONVERSIONS_API_URL = 'https://bzr.openai.com/v1/events';\nconst CONVERSIONS_API_TIMEOUT_MS = 10_000;\n\n/** the click reference the pixel stores for the visitor who came from an openai ad */\nconst CLICK_REFERENCE_COOKIE = '__obref';\n\nexport type OpenAiConversionsOptions = {\n  /** the conversions api key from the ads manager */\n  apiKey: string;\n  pixelId: string;\n  /** names the sending system in the request, e.g. `my-site-de` */\n  integrationSource: string;\n  /** the country calling code national phone numbers get before hashing, e.g. `49` */\n  countryCallingCode?: string | undefined;\n  fetch?: typeof fetch | undefined;\n};\n\n/**\n * The openai ads conversions api as a server destination: reports the `openai` payload of an event\n * under the id the pixel fires it with.\n */\nexport function openAiConversions(options: OpenAiConversionsOptions): ServerDestination<'openai'> {\n  const doFetch = options.fetch ?? fetch;\n\n  return {\n    name: 'openai',\n    async send(event: OpenAiEvent, { id, request }) {\n      const hashed = await hashUser(event.user ?? {}, { countryCallingCode: options.countryCallingCode });\n      const body = {\n        integration_source: options.integrationSource,\n        events: [\n          {\n            id,\n            type: event.name,\n            timestamp_ms: Date.now(),\n            source_url: request.sourceUrl,\n            action_source: 'web',\n            user: {\n              emails_sha256: toList(hashed.email),\n              phone_numbers_sha256: toList(hashed.phone),\n              first_names_sha256: toList(hashed.firstName),\n              last_names_sha256: toList(hashed.lastName),\n              ip_address: request.clientAddress,\n              user_agent: request.headers.get('user-agent') ?? undefined,\n              obref: request.cookie(CLICK_REFERENCE_COOKIE),\n            },\n            data: event.data,\n          },\n        ],\n      };\n\n      const response = await doFetch(`${CONVERSIONS_API_URL}?pid=${encodeURIComponent(options.pixelId)}`, {\n        method: 'POST',\n        headers: { authorization: `Bearer ${options.apiKey}`, 'content-type': 'application/json' },\n        body: JSON.stringify(body),\n        signal: AbortSignal.timeout(CONVERSIONS_API_TIMEOUT_MS),\n      });\n\n      if (!response.ok) {\n        throw new Error(`conversions api responded ${response.status}: ${await response.text()}`);\n      }\n    },\n  };\n}\n\nfunction toList(value: string | undefined): string[] | undefined {\n  return value ? [value] : undefined;\n}\n"],"mappings":";;AAIA,MAAM,sBAAsB;AAC5B,MAAM,6BAA6B;;AAGnC,MAAM,yBAAyB;;;;;AAiB/B,SAAgB,kBAAkB,SAAgE;CAChG,MAAM,UAAU,QAAQ,SAAS;CAEjC,OAAO;EACL,MAAM;EACN,MAAM,KAAK,OAAoB,EAAE,IAAI,WAAW;GAC9C,MAAM,SAAS,MAAM,SAAS,MAAM,QAAQ,CAAC,GAAG,EAAE,oBAAoB,QAAQ,mBAAmB,CAAC;GAClG,MAAM,OAAO;IACX,oBAAoB,QAAQ;IAC5B,QAAQ,CACN;KACE;KACA,MAAM,MAAM;KACZ,cAAc,KAAK,IAAI;KACvB,YAAY,QAAQ;KACpB,eAAe;KACf,MAAM;MACJ,eAAe,OAAO,OAAO,KAAK;MAClC,sBAAsB,OAAO,OAAO,KAAK;MACzC,oBAAoB,OAAO,OAAO,SAAS;MAC3C,mBAAmB,OAAO,OAAO,QAAQ;MACzC,YAAY,QAAQ;MACpB,YAAY,QAAQ,QAAQ,IAAI,YAAY,KAAK,KAAA;MACjD,OAAO,QAAQ,OAAO,sBAAsB;KAC9C;KACA,MAAM,MAAM;IACd,CACF;GACF;GAEA,MAAM,WAAW,MAAM,QAAQ,GAAG,oBAAoB,OAAO,mBAAmB,QAAQ,OAAO,KAAK;IAClG,QAAQ;IACR,SAAS;KAAE,eAAe,UAAU,QAAQ;KAAU,gBAAgB;IAAmB;IACzF,MAAM,KAAK,UAAU,IAAI;IACzB,QAAQ,YAAY,QAAQ,0BAA0B;GACxD,CAAC;GAED,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,MAAM,6BAA6B,SAAS,OAAO,IAAI,MAAM,SAAS,KAAK,GAAG;EAE5F;CACF;AACF;AAEA,SAAS,OAAO,OAAiD;CAC/D,OAAO,QAAQ,CAAC,KAAK,IAAI,KAAA;AAC3B"}

package/dist/react/index.d.ts

@@ -0,0 +1,7 @@
+import { p as TrackInput } from "../shared-CSwqcxPI.js";
+export type TrackProps = {
+  event: TrackInput;
+};
+/** tracks the event once, when the island mounts; renders nothing */
+export declare function Track({ event }: TrackProps): null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/react/index.tsx"],"mappings":";YAIY;EACV,OAAO;;;wBAIO,QAAQ,SAAS"}

package/dist/react/index.js

@@ -0,0 +1,13 @@
+import { track } from "../client/track.js";
+import { useEffectOnce } from "@entwico/dash/react";
+// src/react/index.tsx
+/** tracks the event once, when the island mounts; renders nothing */
+function Track({ event }) {
+	useEffectOnce(() => {
+		track(event);
+	});
+	return null;
+}
+export { Track };
+
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/react/index.tsx"],"sourcesContent":["import { useEffectOnce } from '@entwico/dash/react';\nimport { track } from '../client/track.js';\nimport type { TrackInput } from '../shared.js';\n\nexport type TrackProps = {\n  event: TrackInput;\n};\n\n/** tracks the event once, when the island mounts; renders nothing */\nexport function Track({ event }: TrackProps) {\n  useEffectOnce(() => {\n    track(event);\n  });\n\n  return null;\n}\n"],"mappings":";;;;AASA,SAAgB,MAAM,EAAE,SAAqB;CAC3C,oBAAoB;EAClB,MAAM,KAAK;CACb,CAAC;CAED,OAAO;AACT"}

package/dist/runtime-J8VplGyY.d.ts

@@ -0,0 +1,48 @@
+import { i as DestinationName, l as RelayDestinations, n as ConsentRecord, s as EventMeta } from "./shared-CSwqcxPI.js";
+import { ExcludePattern } from "@astroscope/node/excludes";
+import { APIContext } from "astro";
+/** what a server destination gets from the request the conversion arrived with */
+type RelayRequest = {
+  clientAddress: string;
+  headers: Headers;
+  /** a cookie's value, for the click ids the pixels set */
+  cookie: (name: string) => string | undefined;
+  /** the page the conversion happened on: the referer, else the site's base url */
+  sourceUrl: string;
+};
+/** what a server destination knows about an event: the browser's meta and the request */
+type ServerEventMeta = EventMeta & {
+  request: RelayRequest;
+};
+/**
+ * The server half of a destination: reports a conversion through its conversions api, or records it
+ * first-party. The same shape as a browser destination — a name, its consent, a `send` of its payload.
+ */
+type ServerDestination<N extends DestinationName = DestinationName> = {
+  /** the destination's name: its key in every event; by default also the browser destination whose consent it shares */
+  name: N;
+  send: (payload: RelayDestinations[N], meta: ServerEventMeta) => void | Promise<void>;
+};
+/** a server destination of any registered name */
+type AnyServerDestination = { [N in DestinationName]: ServerDestination<N>; }[DestinationName];
+/** the server destinations by name: the key an event's payload sits under, which is also the destination's own name */
+type ServerDestinations = { [N in DestinationName]?: ServerDestination<N> | undefined; };
+/**
+ * The consent per server destination, where the default — the flag of its name in the record the
+ * request carried — does not fit: `false` for a first-party record that needs none, a function
+ * answering from the record (another destination's flag).
+ */
+type ServerConsent<N extends string> = { [K in N]?: false | ((consent: ConsentRecord) => boolean) | undefined; };
+type RelayServerConfig<P extends ServerDestinations = ServerDestinations> = {
+  destinations: P;
+  consent?: ServerConsent<NoInfer<keyof P & string>> | undefined;
+  /**
+   * Requests whose conversions are not reported — test sessions, crawlers — as the path patterns or
+   * the predicate every astroscope middleware takes.
+   */
+  exclude?: ExcludePattern[] | ((ctx: APIContext) => boolean) | undefined;
+};
+/** types the server registry: the default export of `src/relay/server.ts` */
+declare function defineRelayServer<P extends ServerDestinations>(config: RelayServerConfig<P>): RelayServerConfig<P>;
+export { ServerDestination as a, defineRelayServer as c, ServerConsent as i, RelayRequest as n, ServerDestinations as o, RelayServerConfig as r, ServerEventMeta as s, AnyServerDestination as t };
+//# sourceMappingURL=runtime-J8VplGyY.d.ts.map

package/dist/runtime-J8VplGyY.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-J8VplGyY.d.ts","names":[],"sources":["../src/runtime.ts"],"mappings":";;;;KAKY;EACV;EACA,SAAS;;EAET,SAAS;;EAET;;;KAIU,kBAAkB;EAC5B,SAAS;;;;;;KAOC,kBAAkB,UAAU,kBAAkB;;EAExD,MAAM;EACN,OAAO,SAAS,kBAAkB,IAAI,MAAM,2BAA2B;;;KAI7D,0BAA0B,KAAK,kBAAkB,kBAAkB,MAAK;;KAGxE,wBAAwB,KAAK,mBAAmB,kBAAkB;;;;;;KAOlE,cAAc,uBAAuB,KAAK,eAAe,SAAS;KAElE,kBAAkB,UAAU,qBAAqB;EAC3D,cAAc;EACd,UAAU,cAAc,cAAc;;;;;EAKtC,UAAU,qBAAqB,KAAK;;;iBAItB,kBAAkB,UAAU,oBAAoB,QAAQ,kBAAkB,KAAK,kBAAkB"}

package/dist/server/index.d.ts

@@ -0,0 +1,18 @@
+import { n as ConsentRecord } from "../shared-CSwqcxPI.js";
+import { a as normalizeEmail, c as sha256, i as hashUser, n as HashOptions, o as normalizeName, r as HashedUser, s as normalizePhone } from "../conversion-user-DCfM5EuZ.js";
+import { a as ServerDestination, c as defineRelayServer, i as ServerConsent, n as RelayRequest, o as ServerDestinations, r as RelayServerConfig, s as ServerEventMeta, t as AnyServerDestination } from "../runtime-J8VplGyY.js";
+import { APIContext } from "astro";
+/** what the middleware knows about the request `track()` is called in */
+type RelayRequestContext = {
+  /** the consent the browser sent, by destination name */
+  consent: ConsentRecord;
+  context: APIContext;
+};
+/**
+ * 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.
+ */
+export declare function relayConsent(): ConsentRecord;
+export { type AnyServerDestination, type HashOptions, type HashedUser, type RelayRequest, type RelayRequestContext, type RelayServerConfig, type ServerConsent, type ServerDestination, type ServerDestinations, type ServerEventMeta, defineRelayServer, hashUser, normalizeEmail, normalizeName, normalizePhone, sha256 };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/server/context.ts"],"mappings":";;;;;KAKY;;EAEV,SAAS;EACT,SAAS;;;;;;;wBAgCK,gBAAgB"}

package/dist/server/index.js

@@ -0,0 +1,10 @@
+import { n as relayConsent } from "../context-D11BBDcb.js";
+import { a as sha256, i as normalizePhone, n as normalizeEmail, r as normalizeName, t as hashUser } from "../conversion-user-CV8xIWDK.js";
+// src/runtime.ts
+/** types the server registry: the default export of `src/relay/server.ts` */
+function defineRelayServer(config) {
+	return config;
+}
+export { defineRelayServer, hashUser, normalizeEmail, normalizeName, normalizePhone, relayConsent, sha256 };
+
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/runtime.ts"],"sourcesContent":["import type { ExcludePattern } from '@astroscope/node/excludes';\nimport type { APIContext } from 'astro';\nimport type { ConsentRecord, DestinationName, EventMeta, RelayDestinations } from './shared.js';\n\n/** what a server destination gets from the request the conversion arrived with */\nexport type RelayRequest = {\n  clientAddress: string;\n  headers: Headers;\n  /** a cookie's value, for the click ids the pixels set */\n  cookie: (name: string) => string | undefined;\n  /** the page the conversion happened on: the referer, else the site's base url */\n  sourceUrl: string;\n};\n\n/** what a server destination knows about an event: the browser's meta and the request */\nexport type ServerEventMeta = EventMeta & {\n  request: RelayRequest;\n};\n\n/**\n * The server half of a destination: reports a conversion through its conversions api, or records it\n * first-party. The same shape as a browser destination — a name, its consent, a `send` of its payload.\n */\nexport type ServerDestination<N extends DestinationName = DestinationName> = {\n  /** the destination's name: its key in every event; by default also the browser destination whose consent it shares */\n  name: N;\n  send: (payload: RelayDestinations[N], meta: ServerEventMeta) => void | Promise<void>;\n};\n\n/** a server destination of any registered name */\nexport type AnyServerDestination = { [N in DestinationName]: ServerDestination<N> }[DestinationName];\n\n/** the server destinations by name: the key an event's payload sits under, which is also the destination's own name */\nexport type ServerDestinations = { [N in DestinationName]?: ServerDestination<N> | undefined };\n\n/**\n * The consent per server destination, where the default — the flag of its name in the record the\n * request carried — does not fit: `false` for a first-party record that needs none, a function\n * answering from the record (another destination's flag).\n */\nexport type ServerConsent<N extends string> = { [K in N]?: false | ((consent: ConsentRecord) => boolean) | undefined };\n\nexport type RelayServerConfig<P extends ServerDestinations = ServerDestinations> = {\n  destinations: P;\n  consent?: ServerConsent<NoInfer<keyof P & string>> | undefined;\n  /**\n   * Requests whose conversions are not reported — test sessions, crawlers — as the path patterns or\n   * the predicate every astroscope middleware takes.\n   */\n  exclude?: ExcludePattern[] | ((ctx: APIContext) => boolean) | undefined;\n};\n\n/** types the server registry: the default export of `src/relay/server.ts` */\nexport function defineRelayServer<P extends ServerDestinations>(config: RelayServerConfig<P>): RelayServerConfig<P> {\n  return config;\n}\n"],"mappings":";;;;AAqDA,SAAgB,kBAAgD,QAAoD;CAClH,OAAO;AACT"}

package/dist/server/middleware-entrypoint.d.ts

@@ -0,0 +1,2 @@
+export declare const onRequest: import("astro").MiddlewareHandler;
+//# sourceMappingURL=middleware-entrypoint.d.ts.map

package/dist/server/middleware-entrypoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-entrypoint.d.ts","names":[],"sources":["../../src/server/middleware-entrypoint.ts"],"mappings":"A,qBAEa,2BAAS"}

package/dist/server/middleware-entrypoint.js

@@ -0,0 +1,25 @@
+import { s as parseConsent, t as RELAY_CONSENT_HEADER } from "../shared-D281USsp.js";
+import { r as runWithRelayContext } from "../context-D11BBDcb.js";
+// src/server/middleware.ts
+/**
+* Reads the consent header the browser attached and runs the rest of the chain inside the relay
+* context, so `track()` in an action, an endpoint or a page reports to the consented destinations.
+* Injected by the integration as `pre` middleware, before the project's own — not part of the
+* public API.
+*
+* @internal
+*/
+function createRelayMiddleware() {
+	return (ctx, next) => {
+		const consent = parseConsent(ctx.request.headers.get(RELAY_CONSENT_HEADER));
+		return runWithRelayContext({
+			consent,
+			context: ctx
+		}, next);
+	};
+}
+// src/server/middleware-entrypoint.ts
+const onRequest = createRelayMiddleware();
+export { onRequest };
+
+//# sourceMappingURL=middleware-entrypoint.js.map

package/dist/server/middleware-entrypoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-entrypoint.js","names":[],"sources":["../../src/server/middleware.ts","../../src/server/middleware-entrypoint.ts"],"sourcesContent":["import type { MiddlewareHandler } from 'astro';\nimport { RELAY_CONSENT_HEADER, parseConsent } from '../shared.js';\nimport { runWithRelayContext } from './context.js';\n\n/**\n * Reads the consent header the browser attached and runs the rest of the chain inside the relay\n * context, so `track()` in an action, an endpoint or a page reports to the consented destinations.\n * Injected by the integration as `pre` middleware, before the project's own — not part of the\n * public API.\n *\n * @internal\n */\nexport function createRelayMiddleware(): MiddlewareHandler {\n  return (ctx, next) => {\n    const consent = parseConsent(ctx.request.headers.get(RELAY_CONSENT_HEADER));\n\n    return runWithRelayContext({ consent, context: ctx }, next);\n  };\n}\n","import { createRelayMiddleware } from './middleware.js';\n\nexport const onRequest = createRelayMiddleware();\n"],"mappings":";;;;;;;;;;;AAYA,SAAgB,wBAA2C;CACzD,QAAQ,KAAK,SAAS;EACpB,MAAM,UAAU,aAAa,IAAI,QAAQ,QAAQ,IAAI,oBAAoB,CAAC;EAE1E,OAAO,oBAAoB;GAAE;GAAS,SAAS;EAAI,GAAG,IAAI;CAC5D;AACF;;AChBA,MAAa,YAAY,sBAAsB"}

package/dist/server/registry.d.ts

@@ -0,0 +1,9 @@
+import { r as RelayServerConfig } from "../runtime-J8VplGyY.js";
+/**
+ * The empty server registry. In a site, the integration resolves `@astroscope/relay/registry` to
+ * `src/relay/server.ts` when the file exists; everywhere else — a site without the file, unit tests
+ * outside vite — this one answers and the server-side `track()` reports nothing.
+ */
+declare const registry: RelayServerConfig;
+export { registry as default };
+//# sourceMappingURL=registry.d.ts.map

package/dist/server/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../src/server/registry.ts"],"mappings":";;;;;;cAOM,UAAU"}

package/dist/server/registry.js

@@ -0,0 +1,10 @@
+// src/server/registry.ts
+/**
+* The empty server registry. In a site, the integration resolves `@astroscope/relay/registry` to
+* `src/relay/server.ts` when the file exists; everywhere else — a site without the file, unit tests
+* outside vite — this one answers and the server-side `track()` reports nothing.
+*/
+const registry = { destinations: {} };
+export { registry as default };
+
+//# sourceMappingURL=registry.js.map

package/dist/server/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/server/registry.ts"],"sourcesContent":["import type { RelayServerConfig } from '../runtime.js';\n\n/**\n * The empty server registry. In a site, the integration resolves `@astroscope/relay/registry` to\n * `src/relay/server.ts` when the file exists; everywhere else — a site without the file, unit tests\n * outside vite — this one answers and the server-side `track()` reports nothing.\n */\nconst registry: RelayServerConfig = { destinations: {} };\n\nexport default registry;\n"],"mappings":";;;;;;AAOA,MAAM,WAA8B,EAAE,cAAc,CAAC,EAAE"}

package/dist/server/track.d.ts

@@ -0,0 +1,10 @@
+import { f as TrackFunction } from "../shared-CSwqcxPI.js";
+/**
+ * Reports an event to every consented server destination it carries a payload for, in the
+ * background: a failure is logged and never fails the request. Returns the event id the browser
+ * fires its pixels under: the event's own (an order number, so a resubmitted order never counts
+ * twice) or a fresh one. Outside a request, for an excluded one, or without the browser's consent it
+ * reports nothing and still returns the id.
+ */
+export declare const track: TrackFunction;
+//# sourceMappingURL=track.d.ts.map

package/dist/server/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","names":[],"sources":["../../src/server/track.ts"],"mappings":";;;;;;;;qBAoBa,OAAO"}

package/dist/server/track.js

@@ -0,0 +1,90 @@
+import { c as payloadOf, f as unusableEventId, i as eventIdOf, u as toTracked } from "../shared-D281USsp.js";
+import { t as getRelayContext } from "../context-D11BBDcb.js";
+import { shouldExclude } from "@astroscope/node/excludes";
+import { log } from "@astroscope/node/log";
+import registry from "@astroscope/relay/registry";
+// src/server/config.ts
+/** the server registry: `src/relay/server.ts` of the site, or the empty one without the file */
+function getServerConfig() {
+	return registry;
+}
+// src/server/track.ts
+/**
+* Reports an event to every consented server destination it carries a payload for, in the
+* background: a failure is logged and never fails the request. Returns the event id the browser
+* fires its pixels under: the event's own (an order number, so a resubmitted order never counts
+* twice) or a fresh one. Outside a request, for an excluded one, or without the browser's consent it
+* reports nothing and still returns the id.
+*/
+const track = (input) => {
+	const { event, key, id: own } = toTracked(input);
+	const id = eventIdOf(own);
+	const unusable = unusableEventId(own, id);
+	if (unusable) log.error({
+		key,
+		id
+	}, unusable);
+	const context = getRelayContext();
+	if (!context) {
+		log.debug({
+			key,
+			id
+		}, "tracked outside a request, nothing reported");
+		return id;
+	}
+	const config = getServerConfig();
+	if (shouldExclude(context.context, config.exclude)) return id;
+	const meta = {
+		id,
+		at: Date.now(),
+		key,
+		request: requestOf(context)
+	};
+	const destinations = Object.values(config.destinations).filter((destination) => destination !== void 0).filter((destination) => consentOf(destination.name, config.consent, context.consent));
+	if (destinations.length === 0) {
+		log.debug({
+			key,
+			id
+		}, "no consented server destination, nothing reported");
+		return id;
+	}
+	for (const destination of destinations) {
+		const payload = payloadOf(event, destination.name);
+		if (payload !== void 0) report(destination, payload, meta);
+	}
+	return id;
+};
+function consentOf(name, rules, consent) {
+	const rule = rules?.[name];
+	if (rule === false) return true;
+	if (typeof rule === "function") return rule(consent);
+	return consent[name] === true;
+}
+function requestOf({ context }) {
+	return {
+		clientAddress: context.clientAddress,
+		headers: context.request.headers,
+		cookie: (name) => context.cookies.get(name)?.value,
+		sourceUrl: context.request.headers.get("referer") ?? context.url.origin
+	};
+}
+async function report(destination, payload, meta) {
+	try {
+		await destination.send(payload, meta);
+		log.debug({
+			destination: destination.name,
+			key: meta.key,
+			id: meta.id
+		}, "conversion reported");
+	} catch (error) {
+		log.error({
+			error,
+			destination: destination.name,
+			key: meta.key,
+			id: meta.id
+		}, "failed to report conversion");
+	}
+}
+export { track };
+
+//# sourceMappingURL=track.js.map

package/dist/server/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":[],"sources":["../../src/server/config.ts","../../src/server/track.ts"],"sourcesContent":["import registry from '@astroscope/relay/registry';\nimport type { RelayServerConfig } from '../runtime.js';\n\n/** the server registry: `src/relay/server.ts` of the site, or the empty one without the file */\nexport function getServerConfig(): RelayServerConfig {\n  return registry;\n}\n","import { shouldExclude } from '@astroscope/node/excludes';\nimport { log } from '@astroscope/node/log';\nimport type { ServerConsent, ServerEventMeta } from '../runtime.js';\nimport { type ConsentRecord, type TrackFunction, eventIdOf, payloadOf, toTracked, unusableEventId } from '../shared.js';\nimport { getServerConfig } from './config.js';\nimport { type RelayRequestContext, getRelayContext } from './context.js';\n\n// the destinations as the reporter holds them: the payload type is the destination's business\ntype Registered = {\n  name: string;\n  send(payload: unknown, meta: ServerEventMeta): void | Promise<void>;\n};\n\n/**\n * Reports an event to every consented server destination it carries a payload for, in the\n * background: a failure is logged and never fails the request. Returns the event id the browser\n * fires its pixels under: the event's own (an order number, so a resubmitted order never counts\n * twice) or a fresh one. Outside a request, for an excluded one, or without the browser's consent it\n * reports nothing and still returns the id.\n */\nexport const track: TrackFunction = (input) => {\n  const { event, key, id: own } = toTracked(input);\n  const id = eventIdOf(own);\n  const unusable = unusableEventId(own, id);\n\n  if (unusable) {\n    log.error({ key, id }, unusable);\n  }\n\n  const context = getRelayContext();\n\n  if (!context) {\n    log.debug({ key, id }, 'tracked outside a request, nothing reported');\n\n    return id;\n  }\n\n  const config = getServerConfig();\n\n  if (shouldExclude(context.context, config.exclude)) {\n    return id;\n  }\n\n  const meta: ServerEventMeta = { id, at: Date.now(), key, request: requestOf(context) };\n  const registered = Object.values(config.destinations).filter((destination) => destination !== undefined) as\n    Registered[];\n  const destinations = registered.filter((destination) => consentOf(destination.name, config.consent, context.consent));\n\n  if (destinations.length === 0) {\n    log.debug({ key, id }, 'no consented server destination, nothing reported');\n\n    return id;\n  }\n\n  for (const destination of destinations) {\n    const payload = payloadOf(event, destination.name);\n\n    if (payload !== undefined) {\n      void report(destination, payload, meta);\n    }\n  }\n\n  return id;\n};\n\nfunction consentOf(name: string, rules: ServerConsent<string> | undefined, consent: ConsentRecord): boolean {\n  const rule = rules?.[name];\n\n  if (rule === false) return true;\n  if (typeof rule === 'function') return rule(consent);\n\n  return consent[name] === true;\n}\n\nfunction requestOf({ context }: RelayRequestContext): ServerEventMeta['request'] {\n  return {\n    clientAddress: context.clientAddress,\n    headers: context.request.headers,\n    cookie: (name) => context.cookies.get(name)?.value,\n    sourceUrl: context.request.headers.get('referer') ?? context.url.origin,\n  };\n}\n\nasync function report(destination: Registered, payload: unknown, meta: ServerEventMeta): Promise<void> {\n  try {\n    await destination.send(payload, meta);\n    log.debug({ destination: destination.name, key: meta.key, id: meta.id }, 'conversion reported');\n  } catch (error) {\n    log.error({ error, destination: destination.name, key: meta.key, id: meta.id }, 'failed to report conversion');\n  }\n}\n"],"mappings":";;;;;;;AAIA,SAAgB,kBAAqC;CACnD,OAAO;AACT;;;;;;;;;ACcA,MAAa,SAAwB,UAAU;CAC7C,MAAM,EAAE,OAAO,KAAK,IAAI,QAAQ,UAAU,KAAK;CAC/C,MAAM,KAAK,UAAU,GAAG;CACxB,MAAM,WAAW,gBAAgB,KAAK,EAAE;CAExC,IAAI,UACF,IAAI,MAAM;EAAE;EAAK;CAAG,GAAG,QAAQ;CAGjC,MAAM,UAAU,gBAAgB;CAEhC,IAAI,CAAC,SAAS;EACZ,IAAI,MAAM;GAAE;GAAK;EAAG,GAAG,6CAA6C;EAEpE,OAAO;CACT;CAEA,MAAM,SAAS,gBAAgB;CAE/B,IAAI,cAAc,QAAQ,SAAS,OAAO,OAAO,GAC/C,OAAO;CAGT,MAAM,OAAwB;EAAE;EAAI,IAAI,KAAK,IAAI;EAAG;EAAK,SAAS,UAAU,OAAO;CAAE;CAGrF,MAAM,eAFa,OAAO,OAAO,OAAO,YAAY,CAAC,CAAC,QAAQ,gBAAgB,gBAAgB,KAAA,CAEhE,CAAC,CAAC,QAAQ,gBAAgB,UAAU,YAAY,MAAM,OAAO,SAAS,QAAQ,OAAO,CAAC;CAEpH,IAAI,aAAa,WAAW,GAAG;EAC7B,IAAI,MAAM;GAAE;GAAK;EAAG,GAAG,mDAAmD;EAE1E,OAAO;CACT;CAEA,KAAK,MAAM,eAAe,cAAc;EACtC,MAAM,UAAU,UAAU,OAAO,YAAY,IAAI;EAEjD,IAAI,YAAY,KAAA,GACd,OAAY,aAAa,SAAS,IAAI;CAE1C;CAEA,OAAO;AACT;AAEA,SAAS,UAAU,MAAc,OAA0C,SAAiC;CAC1G,MAAM,OAAO,QAAQ;CAErB,IAAI,SAAS,OAAO,OAAO;CAC3B,IAAI,OAAO,SAAS,YAAY,OAAO,KAAK,OAAO;CAEnD,OAAO,QAAQ,UAAU;AAC3B;AAEA,SAAS,UAAU,EAAE,WAA4D;CAC/E,OAAO;EACL,eAAe,QAAQ;EACvB,SAAS,QAAQ,QAAQ;EACzB,SAAS,SAAS,QAAQ,QAAQ,IAAI,IAAI,CAAC,EAAE;EAC7C,WAAW,QAAQ,QAAQ,QAAQ,IAAI,SAAS,KAAK,QAAQ,IAAI;CACnE;AACF;AAEA,eAAe,OAAO,aAAyB,SAAkB,MAAsC;CACrG,IAAI;EACF,MAAM,YAAY,KAAK,SAAS,IAAI;EACpC,IAAI,MAAM;GAAE,aAAa,YAAY;GAAM,KAAK,KAAK;GAAK,IAAI,KAAK;EAAG,GAAG,qBAAqB;CAChG,SAAS,OAAO;EACd,IAAI,MAAM;GAAE;GAAO,aAAa,YAAY;GAAM,KAAK,KAAK;GAAK,IAAI,KAAK;EAAG,GAAG,6BAA6B;CAC/G;AACF"}

package/dist/shared-CSwqcxPI.d.ts

@@ -0,0 +1,77 @@
+/** the attribute of an element whose click tracks the event serialized into it */
+declare const RELAY_TRACK_ATTRIBUTE = "data-track";
+/** what the visitor allowed, by destination name */
+type ConsentRecord = Readonly<Record<string, boolean>>;
+/**
+ * The answer for one destination: `undefined` as long as the cmp has not read the stored choice yet
+ * — not "no", but "not known", so events wait in memory instead of being dropped.
+ */
+type ConsentAnswer = boolean | undefined;
+/**
+ * Where the bus asks whether the visitor allowed a destination: a cmp adapter (`ccm19()`), or three
+ * members of your own. It covers exactly the registered names — `names` and `of` make the type
+ * invariant in them — so a destination without an answer is a type error.
+ */
+type ConsentSource<N extends string = string> = {
+  /** the registered destination names */
+  names: readonly N[];
+  /** whether the visitor allowed the destination */
+  of: (name: N) => ConsentAnswer;
+  /** destinations needing no consent: taken before the cmp has answered, not in the record */
+  free?: readonly N[] | undefined;
+  /** called once with the re-check: hook it to the cmp's change event, so a choice on this page delivers at once */
+  watch?: ((notify: () => void) => void) | undefined;
+};
+/**
+ * The destinations an event can carry a payload for, by name: the package's destination entries and a
+ * site's own add theirs through module augmentation of `@astroscope/relay`, so every event
+ * definition is checked against the payload the destination takes. `id`, `key` and `event` are
+ * reserved names.
+ */
+interface RelayDestinations {}
+type DestinationName = keyof RelayDestinations & string;
+/** the parameters of an event as a destination's builder takes them */
+type RelayParams = Record<string, unknown>;
+/** an event on the bus: the payload for each destination it is meant for, built by the destination's own builders */
+type RelayEvent = { [N in DestinationName]?: RelayDestinations[N] | undefined; };
+/**
+ * An event a site defined: the definition's key, optionally the id it fires under (an order
+ * number, so every destination counts a conversion once, on both sides), and the payloads it built.
+ */
+type DomainEvent<E extends RelayEvent = RelayEvent> = {
+  key: string;
+  id?: string | undefined;
+  event: E;
+};
+/** what a definition returns: the payloads, and the id where the site's data has one */
+type DefinedPayloads = RelayEvent & {
+  id?: string | undefined;
+};
+/** what `track()`, `<Track>` and `data-track` take: a defined event or a plain one */
+type TrackInput = RelayEvent | DomainEvent;
+/** a defined event: builds the event from the site's own arguments and carries its key */
+type EventDefinition<Args extends unknown[] = unknown[], E extends RelayEvent = RelayEvent, K extends string = string> = ((...args: Args) => DomainEvent<E>) & {
+  readonly key: K;
+};
+/**
+ * One of the site's events: a function that turns the site's own objects into the payloads of the
+ * destinations the event is meant for, under the key that identifies it in a `data-track`
+ * attribute and in logs. One export per event, so an island bundles only the events
+ * it tracks and an event only an action imports never reaches the browser; the key is the export's
+ * name.
+ */
+declare function defineEvent<const K extends string, Args extends unknown[], E extends DefinedPayloads>(key: K, create: (...args: Args) => E): EventDefinition<Args, Omit<E, 'id'>, K>;
+/** the value of the `data-track` attribute of an element whose click tracks the event */
+declare function trackAttribute(input: TrackInput): string;
+/** what a destination knows about an event besides its payload */
+type EventMeta = {
+  id: string;
+  /** epoch milliseconds of the track call */
+  at: number;
+  /** the key of the definition the event came from, `undefined` for a plain event */
+  key?: string | undefined;
+};
+/** `track()`, the same in the browser and on the server: puts the event on the bus, returns its id */
+type TrackFunction = (input: TrackInput) => string;
+export { DomainEvent as a, RELAY_TRACK_ATTRIBUTE as c, RelayParams as d, TrackFunction as f, trackAttribute as h, DestinationName as i, RelayDestinations as l, defineEvent as m, ConsentRecord as n, EventDefinition as o, TrackInput as p, ConsentSource as r, EventMeta as s, ConsentAnswer as t, RelayEvent as u };
+//# sourceMappingURL=shared-CSwqcxPI.d.ts.map

package/dist/shared-CSwqcxPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-CSwqcxPI.d.ts","names":[],"sources":["../src/shared.ts"],"mappings":";cASa;;KAGD,gBAAgB,SAAS;;;;;KA6BzB;;;;;;KAOA,cAAc;;EAExB,gBAAgB;;EAEhB,KAAK,MAAM,MAAM;;EAEjB,gBAAgB;;EAEhB,UAAU;;;;;;;;UAUK;KAEL,wBAAwB;;KAGxB,cAAc;;KAGd,gBAAgB,KAAK,mBAAmB,kBAAkB;;;;;KAM1D,YAAY,UAAU,aAAa;EAC7C;EACA;EACA,OAAO;;;KAIG,kBAAkB;EAAe;;;KAGjC,aAAa,aAAa;;KAG1B,gBACV,oCACA,UAAU,aAAa,YACvB,kCACO,MAAM,SAAS,YAAY;WACzB,KAAK;;;;;;;;;iBAUA,kBAAkB,kBAAkB,wBAAwB,UAAU,iBACpF,KAAK,GACL,YAAY,MAAM,SAAS,IAC1B,gBAAgB,MAAM,KAAK,UAAU;;iBAmCxB,eAAe,OAAO;;KAU1B;EACV;;EAEA;;EAEA;;;KAIU,iBAAiB,OAAO"}