@astroscope/relay 0.0.0-stage → 1.0.1

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+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";
+import { AstroIntegration } from "astro";
+/**
+ * Astro integration for the relay. The site's `src/relay/` folder holds the halves: `client.ts`
+ * configures the bus and is loaded on every page, `server.ts` registers the server destinations and is
+ * what the server-side `track()` reports to. A half without its file is off. The middleware that
+ * reads the consent header off every request is always added, so `relayConsent()` works regardless.
+ */
+export default function relayIntegration(): AstroIntegration;
+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.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,73 @@
+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";
+import fs from "node:fs";
+// src/integration.ts
+/** the browser half: the bus configuration as its default export, loaded on every page when the file exists */
+const CLIENT_MODULE = "src/relay/client.ts";
+/** the server half: the registry of server destinations, resolved when the file exists */
+const SERVER_MODULE = "src/relay/server.ts";
+const CLIENT_VIRTUAL_MODULE_ID = "virtual:@astroscope/relay/client";
+const RESOLVED_CLIENT_VIRTUAL_MODULE_ID = `\0${CLIENT_VIRTUAL_MODULE_ID}`;
+/** the package's empty registry, which the site's module replaces when it exists */
+const REGISTRY_MODULE_ID = "@astroscope/relay/registry";
+/**
+* Resolves the halves through vite: the injected page script loads the client module when it
+* exists, and the package's empty registry gives way to the site's module when that exists, so the
+* reporter and the site share one instance. The registry carries the destinations' secrets, so the
+* client build must never pull it in.
+*/
+function relayVitePlugin(logger) {
+	let reported = false;
+	return {
+		name: "@astroscope/relay",
+		enforce: "pre",
+		async resolveId(id, importer) {
+			if (id === CLIENT_VIRTUAL_MODULE_ID) return RESOLVED_CLIENT_VIRTUAL_MODULE_ID;
+			if (id !== REGISTRY_MODULE_ID) return;
+			return (await this.resolve(`/${SERVER_MODULE}`, importer))?.id;
+		},
+		async load(id) {
+			if (id === RESOLVED_CLIENT_VIRTUAL_MODULE_ID) {
+				if (!await this.resolve(`/${CLIENT_MODULE}`)) return "";
+				return [
+					"import { configureRelay } from '@astroscope/relay/client';",
+					`import config from ${JSON.stringify(`/${CLIENT_MODULE}`)};`,
+					"configureRelay(await config);"
+				].join("\n");
+			}
+			if (id.endsWith(`/${SERVER_MODULE}`) && this.environment?.name === "client") throw new Error(`[@astroscope/relay] ${SERVER_MODULE} is server-only — the browser configures the bus in ${CLIENT_MODULE}`);
+		},
+		async buildStart() {
+			if (reported) return;
+			reported = true;
+			const [client, server] = await Promise.all([this.resolve(`/${CLIENT_MODULE}`), this.resolve(`/${SERVER_MODULE}`)]);
+			logger.info(`${client ? `browser bus from ${CLIENT_MODULE}` : "no browser bus"}, ${server ? `server destinations from ${SERVER_MODULE}` : "no server destinations"}`);
+		}
+	};
+}
+/**
+* Astro integration for the relay. The site's `src/relay/` folder holds the halves: `client.ts`
+* configures the bus and is loaded on every page, `server.ts` registers the server destinations and is
+* what the server-side `track()` reports to. A half without its file is off. The middleware that
+* reads the consent header off every request is always added, so `relayConsent()` works regardless.
+*/
+function relayIntegration() {
+	return {
+		name: "@astroscope/relay",
+		hooks: { "astro:config:setup": ({ addMiddleware, config, injectScript, logger, updateConfig }) => {
+			addMiddleware({
+				order: "pre",
+				entrypoint: "@astroscope/relay/middleware"
+			});
+			updateConfig({ vite: {
+				plugins: [relayVitePlugin(logger)],
+				ssr: { noExternal: ["@astroscope/relay"] }
+			} });
+			if (fs.existsSync(new URL(CLIENT_MODULE, config.root))) injectScript("page", `import ${JSON.stringify(CLIENT_VIRTUAL_MODULE_ID)};`);
+		} }
+	};
+}
+export { RELAY_TRACK_ATTRIBUTE, collect, relayIntegration as default, defineEvent, inlineTrack, isCommerceEvent, trackAttribute, wellKnownEvents };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/integration.ts"],"sourcesContent":["import fs from 'node:fs';\nimport type { AstroIntegration, AstroIntegrationLogger } from 'astro';\nimport type { Plugin } from 'vite';\n\n/** the browser half: the bus configuration as its default export, loaded on every page when the file exists */\nconst CLIENT_MODULE = 'src/relay/client.ts';\n/** the server half: the registry of server destinations, resolved when the file exists */\nconst SERVER_MODULE = 'src/relay/server.ts';\n\nconst CLIENT_VIRTUAL_MODULE_ID = 'virtual:@astroscope/relay/client';\nconst RESOLVED_CLIENT_VIRTUAL_MODULE_ID = `\\0${CLIENT_VIRTUAL_MODULE_ID}`;\n/** the package's empty registry, which the site's module replaces when it exists */\nconst REGISTRY_MODULE_ID = '@astroscope/relay/registry';\n\n/**\n * Resolves the halves through vite: the injected page script loads the client module when it\n * exists, and the package's empty registry gives way to the site's module when that exists, so the\n * reporter and the site share one instance. The registry carries the destinations' secrets, so the\n * client build must never pull it in.\n */\nfunction relayVitePlugin(logger: AstroIntegrationLogger): Plugin {\n  let reported = false;\n\n  return {\n    name: '@astroscope/relay',\n    // before vite's own resolver, which would otherwise settle the registry import on the package's empty one\n    enforce: 'pre',\n\n    async resolveId(id, importer) {\n      if (id === CLIENT_VIRTUAL_MODULE_ID) return RESOLVED_CLIENT_VIRTUAL_MODULE_ID;\n\n      if (id !== REGISTRY_MODULE_ID) return;\n\n      // eslint-disable-next-line unicorn/no-this-outside-of-class -- `this` is the vite plugin context api\n      const server = await this.resolve(`/${SERVER_MODULE}`, importer);\n\n      return server?.id;\n    },\n\n    async load(id) {\n      if (id === RESOLVED_CLIENT_VIRTUAL_MODULE_ID) {\n        // eslint-disable-next-line unicorn/no-this-outside-of-class -- `this` is the vite plugin context api\n        const client = await this.resolve(`/${CLIENT_MODULE}`);\n\n        if (!client) return '';\n\n        return [\n          'import { configureRelay } from \\'@astroscope/relay/client\\';',\n          `import config from ${JSON.stringify(`/${CLIENT_MODULE}`)};`,\n          'configureRelay(await config);',\n        ].join('\\n');\n      }\n\n      // eslint-disable-next-line unicorn/no-this-outside-of-class -- `this` is the vite plugin context api\n      if (id.endsWith(`/${SERVER_MODULE}`) && this.environment?.name === 'client') {\n        throw new Error(`[@astroscope/relay] ${SERVER_MODULE} is server-only — the browser configures the bus in ${CLIENT_MODULE}`);\n      }\n    },\n\n    async buildStart() {\n      if (reported) return;\n\n      reported = true;\n\n      // eslint-disable-next-line unicorn/no-this-outside-of-class -- `this` is the vite plugin context api\n      const [client, server] = await Promise.all([this.resolve(`/${CLIENT_MODULE}`), this.resolve(`/${SERVER_MODULE}`)]);\n\n      logger.info(\n        `${client ? `browser bus from ${CLIENT_MODULE}` : 'no browser bus'}, ${server ? `server destinations from ${SERVER_MODULE}` : 'no server destinations'}`,\n      );\n    },\n  };\n}\n\n/**\n * Astro integration for the relay. The site's `src/relay/` folder holds the halves: `client.ts`\n * configures the bus and is loaded on every page, `server.ts` registers the server destinations and is\n * what the server-side `track()` reports to. A half without its file is off. The middleware that\n * reads the consent header off every request is always added, so `relayConsent()` works regardless.\n */\nexport default function relayIntegration(): AstroIntegration {\n  return {\n    name: '@astroscope/relay',\n    hooks: {\n      'astro:config:setup': ({ addMiddleware, config, injectScript, logger, updateConfig }) => {\n        addMiddleware({ order: 'pre', entrypoint: '@astroscope/relay/middleware' });\n        // bundled into the server build, so the registry import passes through the plugin instead\n        // of node's resolution of an externalized package\n        updateConfig({ vite: { plugins: [relayVitePlugin(logger)], ssr: { noExternal: ['@astroscope/relay'] } } });\n\n        // a site without a browser half ships no script for it\n        if (fs.existsSync(new URL(CLIENT_MODULE, config.root))) {\n          injectScript('page', `import ${JSON.stringify(CLIENT_VIRTUAL_MODULE_ID)};`);\n        }\n      },\n    },\n  };\n}\n"],"mappings":";;;;;;AAKA,MAAM,gBAAgB;;AAEtB,MAAM,gBAAgB;AAEtB,MAAM,2BAA2B;AACjC,MAAM,oCAAoC,KAAK;;AAE/C,MAAM,qBAAqB;;;;;;;AAQ3B,SAAS,gBAAgB,QAAwC;CAC/D,IAAI,WAAW;CAEf,OAAO;EACL,MAAM;EAEN,SAAS;EAET,MAAM,UAAU,IAAI,UAAU;GAC5B,IAAI,OAAO,0BAA0B,OAAO;GAE5C,IAAI,OAAO,oBAAoB;GAK/B,QAAO,MAFc,KAAK,QAAQ,IAAI,iBAAiB,QAAQ,EAAA,EAEhD;EACjB;EAEA,MAAM,KAAK,IAAI;GACb,IAAI,OAAO,mCAAmC;IAI5C,IAAI,CAAC,MAFgB,KAAK,QAAQ,IAAI,eAAe,GAExC,OAAO;IAEpB,OAAO;KACL;KACA,sBAAsB,KAAK,UAAU,IAAI,eAAe,EAAE;KAC1D;IACF,CAAC,CAAC,KAAK,IAAI;GACb;GAGA,IAAI,GAAG,SAAS,IAAI,eAAe,KAAK,KAAK,aAAa,SAAS,UACjE,MAAM,IAAI,MAAM,uBAAuB,cAAc,sDAAsD,eAAe;EAE9H;EAEA,MAAM,aAAa;GACjB,IAAI,UAAU;GAEd,WAAW;GAGX,MAAM,CAAC,QAAQ,UAAU,MAAM,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,eAAe,GAAG,KAAK,QAAQ,IAAI,eAAe,CAAC,CAAC;GAEjH,OAAO,KACL,GAAG,SAAS,oBAAoB,kBAAkB,iBAAiB,IAAI,SAAS,4BAA4B,kBAAkB,0BAChI;EACF;CACF;AACF;;;;;;;AAQA,SAAwB,mBAAqC;CAC3D,OAAO;EACL,MAAM;EACN,OAAO,EACL,uBAAuB,EAAE,eAAe,QAAQ,cAAc,QAAQ,mBAAmB;GACvF,cAAc;IAAE,OAAO;IAAO,YAAY;GAA+B,CAAC;GAG1E,aAAa,EAAE,MAAM;IAAE,SAAS,CAAC,gBAAgB,MAAM,CAAC;IAAG,KAAK,EAAE,YAAY,CAAC,mBAAmB,EAAE;GAAE,EAAE,CAAC;GAGzG,IAAI,GAAG,WAAW,IAAI,IAAI,eAAe,OAAO,IAAI,CAAC,GACnD,aAAa,QAAQ,UAAU,KAAK,UAAU,wBAAwB,EAAE,EAAE;EAE9E,EACF;CACF;AACF"}

package/dist/instance-Bu0EMJ_-.js

@@ -0,0 +1,268 @@
+import { a as isBrowser, c as payloadOf, f as unusableEventId, i as eventIdOf, l as serializeConsent, n as RELAY_TRACK_ATTRIBUTE, o as isTrackInput, t as RELAY_CONSENT_HEADER, u as toTracked } from "./shared-D281USsp.js";
+// src/client/debug.ts
+const titleStyle = "color: #5c7ced;";
+const sentStyle = "color: #5c7ced;";
+const pendingStyle = "color: #999;";
+const declinedStyle = "color: #999;text-decoration: line-through;";
+function styleOf(status) {
+	switch (status) {
+		case "sent": return sentStyle;
+		case "declined": return declinedStyle;
+		default: return pendingStyle;
+	}
+}
+function safely(fn) {
+	try {
+		fn();
+	} catch (error) {
+		console.error("relay: failed printing the debug log", error);
+		console.groupEnd();
+	}
+}
+/** one collapsed group per tracked event: what came in, and what each destination got or why not */
+function reportTracked(input, meta, outcomes) {
+	safely(() => {
+		const sent = outcomes.filter(({ status }) => status === "sent").length;
+		console.groupCollapsed(`%crelay ${meta.key ?? "event"} #${meta.id} → sent to ${sent} of ${outcomes.length}`, titleStyle);
+		console.log("%c>>", titleStyle, input);
+		for (const { name, payload, status } of outcomes) console.log(`%c<< ${name}`, styleOf(status), status === "sent" ? payload : status, status === "sent" ? "" : payload);
+		console.groupEnd();
+	});
+}
+/** a delivery after the event's own group: consent given later, an sdk that appeared, a replay on the next page */
+function reportLate(name, payload, meta) {
+	safely(() => {
+		console.groupCollapsed(`%crelay ${meta.key ?? "event"} #${meta.id} → ${name}, later`, titleStyle);
+		console.log(`%c<< ${name}`, sentStyle, payload);
+		console.groupEnd();
+	});
+}
+// src/client/bus.ts
+/** events kept in memory for destinations that are not ready or not consented yet */
+const BUFFER_SIZE = 200;
+const READY_POLL_MS = 200;
+const READY_POLL_ATTEMPTS = 100;
+function createBus(env = {}) {
+	const now = env.now ?? (() => Date.now());
+	const schedule = env.schedule ?? defaultSchedule;
+	let states = [];
+	let debug;
+	let tracking;
+	let consent = {
+		names: [],
+		of: () => {}
+	};
+	let free = /* @__PURE__ */ new Set();
+	const buffer = [];
+	let cancelPoll;
+	let pollAttempts = 0;
+	const consentOf = (destination) => free.has(destination.name) ? true : consent.of(destination.name);
+	/** the consent as known now, by destination name; an unknown answer counts as not given */
+	const consentRecord = () => Object.fromEntries(states.filter(({ destination }) => !free.has(destination.name)).map(({ destination }) => [destination.name, consentOf(destination) === true]));
+	const dispatch = () => {
+		let waiting = false;
+		for (const state of states) {
+			const { destination } = state;
+			const allowed = consentOf(destination);
+			if (allowed === void 0) {
+				waiting ||= buffer.length > 0;
+				continue;
+			}
+			if (!allowed) continue;
+			const pending = buffer.filter((emitted) => !state.delivered.has(emitted.id)).map((emitted) => pendingOf(emitted, destination)).filter((entry) => entry !== void 0);
+			if (destination.ready?.() ?? true) deliver(state, pending);
+			else waiting ||= pending.length > 0;
+		}
+		if (waiting) poll();
+	};
+	const deliver = (state, entries) => {
+		for (const { payload, ...meta } of entries) {
+			if (state.delivered.has(meta.id)) continue;
+			state.delivered.add(meta.id);
+			try {
+				state.destination.send(payload, meta);
+			} catch (error) {
+				console.error(`relay: destination ${state.destination.name} failed`, error);
+			}
+			if (tracking !== meta.id && debugging()) reportLate(state.destination.name, payload, meta);
+		}
+	};
+	const debugging = () => typeof debug === "function" ? debug() : debug === true;
+	/** what became of the event at each destination it carries a payload for, as things stand after the dispatch */
+	const outcomesOf = (emitted) => {
+		const outcomes = [];
+		for (const state of states) {
+			const { destination } = state;
+			const payload = payloadOf(emitted.event, destination.name);
+			if (payload === void 0) continue;
+			const status = statusOf(state, emitted.id, consentOf(destination));
+			outcomes.push({
+				name: destination.name,
+				payload,
+				status
+			});
+		}
+		return outcomes;
+	};
+	/** the re-check after a choice or a destination sdk appeared: the poll starts over */
+	const notify = () => {
+		pollAttempts = 0;
+		dispatch();
+	};
+	const poll = () => {
+		if (cancelPoll || pollAttempts >= READY_POLL_ATTEMPTS) return;
+		cancelPoll = schedule(() => {
+			cancelPoll = void 0;
+			pollAttempts += 1;
+			dispatch();
+		}, READY_POLL_MS);
+	};
+	return {
+		configure(next) {
+			const destinations = registeredDestinations(next.destinations);
+			const answered = /* @__PURE__ */ new Set([...next.consent.names, ...next.consent.free ?? []]);
+			for (const destination of destinations) if (!answered.has(destination.name)) throw new Error(`relay: destination ${destination.name} has no consent source`);
+			states = destinations.map((destination) => ({
+				destination,
+				delivered: /* @__PURE__ */ new Set()
+			}));
+			consent = next.consent;
+			free = new Set(next.consent.free);
+			debug = next.debug;
+			dispatch();
+			next.consent.watch?.(notify);
+		},
+		track(input) {
+			const { event, key, id: own } = toTracked(input);
+			const id = eventIdOf(own);
+			const unusable = unusableEventId(own, id);
+			if (unusable) console.error(`relay: ${unusable}`);
+			const emitted = {
+				id,
+				at: now(),
+				key,
+				event
+			};
+			buffer.push(emitted);
+			if (buffer.length > BUFFER_SIZE) {
+				const evicted = buffer.splice(0, buffer.length - BUFFER_SIZE);
+				for (const state of states) for (const entry of evicted) state.delivered.delete(entry.id);
+			}
+			pollAttempts = 0;
+			tracking = emitted.id;
+			dispatch();
+			tracking = void 0;
+			if (debugging()) reportTracked(input, {
+				id: emitted.id,
+				at: emitted.at,
+				key
+			}, outcomesOf(emitted));
+			return emitted.id;
+		},
+		notify,
+		consent: consentRecord
+	};
+}
+function statusOf(state, id, allowed) {
+	if (state.delivered.has(id)) return "sent";
+	if (allowed === void 0) return "consent pending";
+	if (!allowed) return "declined";
+	return "waiting for sdk";
+}
+/** the destinations of a record, each checked to sit under its own name */
+function registeredDestinations(destinations) {
+	const registered = [];
+	for (const [name, destination] of Object.entries(destinations)) {
+		if (!destination) continue;
+		if (destination.name !== name) throw new Error(`relay: destination ${destination.name} is registered under ${name}`);
+		registered.push(destination);
+	}
+	return registered;
+}
+function pendingOf(emitted, destination) {
+	const payload = payloadOf(emitted.event, destination.name);
+	return payload === void 0 ? void 0 : {
+		id: emitted.id,
+		at: emitted.at,
+		key: emitted.key,
+		payload
+	};
+}
+function defaultSchedule(callback, ms) {
+	const handle = setTimeout(callback, ms);
+	return () => clearTimeout(handle);
+}
+// src/client/fetch.ts
+const PATCHED = Symbol.for("@astroscope/relay.fetch");
+/**
+* Wraps the global `fetch` so every same-origin request carries the consent header, read from the
+* bus at call time: the browser's half of the server-side `track()`. Astro's action client calls
+* `fetch` with no way to add a header per call, which is why the global is wrapped, once; the
+* original is kept and called, so other wrappers chain. Cross-origin requests are left alone — a
+* custom header would be a preflight there and tell a third party what the visitor chose.
+*/
+function installConsentHeader(consent) {
+	const target = globalThis;
+	const original = target.fetch;
+	if (typeof original !== "function" || Object.hasOwn(original, PATCHED)) return;
+	const patched = function(input, init) {
+		const value = serializeConsent(consent());
+		if (!value || !isSameOrigin(input)) return original.call(this, input, init);
+		const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : void 0));
+		headers.set(RELAY_CONSENT_HEADER, value);
+		return original.call(this, input, {
+			...init,
+			headers
+		});
+	};
+	patched[PATCHED] = true;
+	target.fetch = patched;
+}
+function isSameOrigin(input) {
+	const { location } = globalThis;
+	try {
+		return new URL(urlOf(input), location.href).origin === location.origin;
+	} catch {
+		return false;
+	}
+}
+function urlOf(input) {
+	if (typeof input === "string") return input;
+	return input instanceof URL ? input.href : input.url;
+}
+// src/client/instance.ts
+/** the bus of this page: one instance, whichever module loads first */
+const bus = install();
+function install() {
+	const existing = globalThis.__relay__;
+	if (existing?.track && existing.configure && existing.notify && existing.consent) return existing;
+	const created = createBus();
+	const queued = Array.isArray(existing?.q) ? existing.q : [];
+	const installed = {
+		...created,
+		q: { push: (input) => void created.track(input) }
+	};
+	globalThis.__relay__ = installed;
+	for (const input of queued) if (isTrackInput(input)) created.track(input);
+	if (isBrowser()) {
+		installConsentHeader(created.consent);
+		document.addEventListener("click", trackClick, { capture: true });
+	}
+	return created;
+}
+function trackClick(event) {
+	const target = event.target;
+	if (!(target instanceof Element)) return;
+	const raw = target.closest(`[${CSS.escape(RELAY_TRACK_ATTRIBUTE)}]`)?.getAttribute(RELAY_TRACK_ATTRIBUTE);
+	if (!raw) return;
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (isTrackInput(parsed)) bus.track(parsed);
+}
+export { createBus as n, bus as t };
+
+//# sourceMappingURL=instance-Bu0EMJ_-.js.map

package/dist/instance-Bu0EMJ_-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-Bu0EMJ_-.js","names":[],"sources":["../src/client/debug.ts","../src/client/bus.ts","../src/client/fetch.ts","../src/client/instance.ts"],"sourcesContent":["import type { EventMeta, TrackInput } from '../shared.js';\n\n/** what became of an event at one destination when it was tracked */\nexport type Outcome = {\n  name: string;\n  payload: unknown;\n  status: 'sent' | 'declined' | 'consent pending' | 'waiting for sdk';\n};\n\nconst titleStyle = 'color: #5c7ced;';\nconst sentStyle = 'color: #5c7ced;';\nconst pendingStyle = 'color: #999;';\nconst declinedStyle = 'color: #999;text-decoration: line-through;';\n\nfunction styleOf(status: Outcome['status']): string {\n  switch (status) {\n    case 'sent': {\n      return sentStyle;\n    }\n    case 'declined': {\n      return declinedStyle;\n    }\n    default: {\n      return pendingStyle;\n    }\n  }\n}\n\nfunction safely(fn: () => void): void {\n  try {\n    fn();\n  } catch (error) {\n    console.error('relay: failed printing the debug log', error);\n    console.groupEnd();\n  }\n}\n\n/** one collapsed group per tracked event: what came in, and what each destination got or why not */\nexport function reportTracked(input: TrackInput, meta: EventMeta, outcomes: readonly Outcome[]): void {\n  safely(() => {\n    const sent = outcomes.filter(({ status }) => status === 'sent').length;\n\n    console.groupCollapsed(`%crelay ${meta.key ?? 'event'} #${meta.id} → sent to ${sent} of ${outcomes.length}`, titleStyle);\n    console.log('%c>>', titleStyle, input);\n\n    for (const { name, payload, status } of outcomes) {\n      console.log(`%c<< ${name}`, styleOf(status), status === 'sent' ? payload : status, status === 'sent' ? '' : payload);\n    }\n\n    console.groupEnd();\n  });\n}\n\n/** a delivery after the event's own group: consent given later, an sdk that appeared, a replay on the next page */\nexport function reportLate(name: string, payload: unknown, meta: EventMeta): void {\n  safely(() => {\n    console.groupCollapsed(`%crelay ${meta.key ?? 'event'} #${meta.id} → ${name}, later`, titleStyle);\n    console.log(`%c<< ${name}`, sentStyle, payload);\n    console.groupEnd();\n  });\n}\n","import {\n  type ConsentAnswer,\n  type ConsentRecord,\n  type ConsentSource,\n  type DestinationName,\n  type EventMeta,\n  type RelayDestinations,\n  type RelayEvent,\n  type TrackInput,\n  eventIdOf,\n  payloadOf,\n  toTracked,\n  unusableEventId,\n} from '../shared.js';\nimport { type Outcome, reportLate, reportTracked } from './debug.js';\n\n/** one consumer of the bus: a tag, a pixel, a tracker, a log — it takes the payload built for it */\nexport type Destination<N extends DestinationName = DestinationName> = {\n  /** the destination's name: its key in every event and in the registration, its flag in the consent header */\n  name: N;\n  /** whether the destination's sdk is there to take events; default: always */\n  ready?: (() => boolean) | undefined;\n  send: (payload: RelayDestinations[N], meta: EventMeta) => void;\n};\n\n/** a destination of any registered name */\nexport type AnyDestination = { [N in DestinationName]: Destination<N> }[DestinationName];\n\n/** the destinations by name: the key an event's payload sits under, which is also the destination's own name */\nexport type Destinations = { [N in DestinationName]?: Destination<N> | undefined };\n\nexport type RelayConfig<P extends Destinations = Destinations> = {\n  destinations: P;\n  /** the consent of exactly the registered destinations; `NoInfer` keeps `destinations` the only source of the names */\n  consent: ConsentSource<NoInfer<keyof P & string>>;\n  /**\n   * log every tracked event to the console, with what each destination got or why not; a function is asked per event\n   */\n  debug?: boolean | (() => boolean) | undefined;\n};\n\n/** a consent source for whichever names: what the bus holds, as any `RelayConfig` narrows to it */\ntype ConsentHolder = Omit<ConsentSource, 'of'> & { of: (name: never) => ConsentAnswer };\n\n/** the configuration as the bus takes it, whichever names it was typed for */\nexport type BusConfig = Omit<RelayConfig, 'consent'> & { consent: ConsentHolder };\n\nexport type Bus = {\n  /** register the destinations; events tracked earlier are delivered now */\n  configure: (config: BusConfig) => void;\n  /** put an event on the bus; returns its id */\n  track: (input: TrackInput) => string;\n  /** re-check the destinations' consent and readiness: after the cmp's choice changed or a destination sdk appeared */\n  notify: () => void;\n  /** the consent as known now, by destination name: what a request to the server carries */\n  consent: () => ConsentRecord;\n};\n\nexport type BusEnvironment = {\n  now?: (() => number) | undefined;\n  /** schedules a readiness re-check; returns the cancel */\n  schedule?: ((callback: () => void, ms: number) => () => void) | undefined;\n};\n\n// the destinations as the bus holds them: the payload type is the destination's business\ntype Registered = {\n  name: string;\n  ready?: (() => boolean) | undefined;\n  send(payload: unknown, meta: EventMeta): void;\n};\n\ntype Emitted = EventMeta & { event: RelayEvent };\n\n/** what a destination gets: its payload of the event, under the event's meta */\ntype Pending = EventMeta & { payload: unknown };\n\ntype DestinationState = {\n  destination: Registered;\n  delivered: Set<string>;\n};\n\n/** events kept in memory for destinations that are not ready or not consented yet */\nconst BUFFER_SIZE = 200;\n\nconst READY_POLL_MS = 200;\nconst READY_POLL_ATTEMPTS = 100;\n\nexport function createBus(env: BusEnvironment = {}): Bus {\n  const now = env.now ?? (() => Date.now());\n  const schedule = env.schedule ?? defaultSchedule;\n\n  let states: DestinationState[] = [];\n  let debug: RelayConfig['debug'];\n  // the event being tracked right now: its deliveries belong to its own log group, later ones get their own\n  let tracking: string | undefined;\n  let consent: ConsentHolder = { names: [], of: () => {} };\n  let free = new Set<string>();\n  const buffer: Emitted[] = [];\n  let cancelPoll: (() => void) | undefined;\n  let pollAttempts = 0;\n\n  const consentOf = (destination: Registered): ConsentAnswer =>\n    free.has(destination.name) ? true : consent.of(destination.name as never);\n\n  /** the consent as known now, by destination name; an unknown answer counts as not given */\n  const consentRecord = (): ConsentRecord =>\n    Object.fromEntries(\n      states\n        .filter(({ destination }) => !free.has(destination.name))\n        .map(({ destination }) => [destination.name, consentOf(destination) === true]),\n    );\n\n  const dispatch = (): void => {\n    let waiting = false;\n\n    for (const state of states) {\n      const { destination } = state;\n      const allowed = consentOf(destination);\n\n      // a cmp that has not read the stored choice yet is polled like a destination that has not loaded yet\n      if (allowed === undefined) {\n        waiting ||= buffer.length > 0;\n        continue;\n      }\n\n      if (!allowed) continue;\n\n      const pending = buffer\n        .filter((emitted) => !state.delivered.has(emitted.id))\n        .map((emitted) => pendingOf(emitted, destination))\n        .filter((entry) => entry !== undefined);\n\n      if (destination.ready?.() ?? true) {\n        deliver(state, pending);\n      } else {\n        waiting ||= pending.length > 0;\n      }\n    }\n\n    if (waiting) {\n      poll();\n    }\n  };\n\n  const deliver = (state: DestinationState, entries: readonly Pending[]): void => {\n    for (const { payload, ...meta } of entries) {\n      if (state.delivered.has(meta.id)) continue;\n\n      state.delivered.add(meta.id);\n\n      try {\n        state.destination.send(payload, meta);\n      } catch (error) {\n        console.error(`relay: destination ${state.destination.name} failed`, error);\n      }\n\n      if (tracking !== meta.id && debugging()) {\n        reportLate(state.destination.name, payload, meta);\n      }\n    }\n  };\n\n  const debugging = (): boolean => (typeof debug === 'function' ? debug() : debug === true);\n\n  /** what became of the event at each destination it carries a payload for, as things stand after the dispatch */\n  const outcomesOf = (emitted: Emitted): Outcome[] => {\n    const outcomes: Outcome[] = [];\n\n    for (const state of states) {\n      const { destination } = state;\n      const payload = payloadOf(emitted.event, destination.name);\n\n      if (payload === undefined) continue;\n\n      const status = statusOf(state, emitted.id, consentOf(destination));\n\n      outcomes.push({ name: destination.name, payload, status });\n    }\n\n    return outcomes;\n  };\n\n  /** the re-check after a choice or a destination sdk appeared: the poll starts over */\n  const notify = (): void => {\n    pollAttempts = 0;\n    dispatch();\n  };\n\n  const poll = (): void => {\n    if (cancelPoll || pollAttempts >= READY_POLL_ATTEMPTS) return;\n\n    cancelPoll = schedule(() => {\n      cancelPoll = undefined;\n      pollAttempts += 1;\n      dispatch();\n    }, READY_POLL_MS);\n  };\n\n  return {\n    configure(next) {\n      const destinations = registeredDestinations(next.destinations);\n      const answered = new Set([...next.consent.names, ...(next.consent.free ?? [])]);\n\n      for (const destination of destinations) {\n        if (!answered.has(destination.name)) {\n          throw new Error(`relay: destination ${destination.name} has no consent source`);\n        }\n      }\n\n      states = destinations.map((destination) => ({ destination, delivered: new Set() }));\n      consent = next.consent;\n      free = new Set(next.consent.free);\n      debug = next.debug;\n\n      dispatch();\n\n      next.consent.watch?.(notify);\n    },\n\n    track(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        console.error(`relay: ${unusable}`);\n      }\n\n      const emitted: Emitted = { id, at: now(), key, event };\n\n      buffer.push(emitted);\n\n      if (buffer.length > BUFFER_SIZE) {\n        const evicted = buffer.splice(0, buffer.length - BUFFER_SIZE);\n\n        for (const state of states) {\n          for (const entry of evicted) state.delivered.delete(entry.id);\n        }\n      }\n\n      pollAttempts = 0;\n      tracking = emitted.id;\n      dispatch();\n      tracking = undefined;\n\n      if (debugging()) {\n        reportTracked(input, { id: emitted.id, at: emitted.at, key }, outcomesOf(emitted));\n      }\n\n      return emitted.id;\n    },\n\n    notify,\n\n    consent: consentRecord,\n  };\n}\n\nfunction statusOf(state: DestinationState, id: string, allowed: ConsentAnswer): Outcome['status'] {\n  if (state.delivered.has(id)) return 'sent';\n  if (allowed === undefined) return 'consent pending';\n  if (!allowed) return 'declined';\n\n  return 'waiting for sdk';\n}\n\n/** the destinations of a record, each checked to sit under its own name */\nfunction registeredDestinations(destinations: Destinations): Registered[] {\n  const registered: Registered[] = [];\n\n  for (const [name, destination] of Object.entries(destinations) as [string, Registered | undefined][]) {\n    if (!destination) continue;\n\n    if (destination.name !== name) {\n      throw new Error(`relay: destination ${destination.name} is registered under ${name}`);\n    }\n\n    registered.push(destination);\n  }\n\n  return registered;\n}\n\nfunction pendingOf(emitted: Emitted, destination: Registered): Pending | undefined {\n  const payload = payloadOf(emitted.event, destination.name);\n\n  return payload === undefined ? undefined : { id: emitted.id, at: emitted.at, key: emitted.key, payload };\n}\n\nfunction defaultSchedule(callback: () => void, ms: number): () => void {\n  const handle = setTimeout(callback, ms);\n\n  return () => clearTimeout(handle);\n}\n","import { type ConsentRecord, RELAY_CONSENT_HEADER, serializeConsent } from '../shared.js';\n\nconst PATCHED = Symbol.for('@astroscope/relay.fetch');\n\ntype Fetch = typeof fetch & { [PATCHED]?: true };\n\n/**\n * Wraps the global `fetch` so every same-origin request carries the consent header, read from the\n * bus at call time: the browser's half of the server-side `track()`. Astro's action client calls\n * `fetch` with no way to add a header per call, which is why the global is wrapped, once; the\n * original is kept and called, so other wrappers chain. Cross-origin requests are left alone — a\n * custom header would be a preflight there and tell a third party what the visitor chose.\n */\nexport function installConsentHeader(consent: () => ConsentRecord): void {\n  const target = globalThis as { fetch?: Fetch };\n  const original = target.fetch;\n\n  if (typeof original !== 'function' || Object.hasOwn(original, PATCHED)) return;\n\n  const patched: Fetch = function (this: unknown, input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n    const value = serializeConsent(consent());\n\n    if (!value || !isSameOrigin(input)) {\n      return original.call(this, input, init);\n    }\n\n    const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : undefined));\n\n    headers.set(RELAY_CONSENT_HEADER, value);\n\n    return original.call(this, input, { ...init, headers });\n  };\n\n  patched[PATCHED] = true;\n  target.fetch = patched;\n}\n\nfunction isSameOrigin(input: RequestInfo | URL): boolean {\n  const { location } = globalThis;\n\n  try {\n    return new URL(urlOf(input), location.href).origin === location.origin;\n  } catch {\n    return false;\n  }\n}\n\nfunction urlOf(input: RequestInfo | URL): string {\n  if (typeof input === 'string') return input;\n\n  return input instanceof URL ? input.href : input.url;\n}\n","import { RELAY_TRACK_ATTRIBUTE, type TrackInput, isBrowser, isTrackInput } from '../shared.js';\nimport { type Bus, createBus } from './bus.js';\nimport { installConsentHeader } from './fetch.js';\n\n/** what inline scripts push into before the bus is installed, and the bus itself afterwards */\ntype Queue = { q: { push: (input: TrackInput) => void } };\n\ntype RelayGlobal = Queue & Partial<Bus>;\n\ndeclare global {\n  // the global the inline queue and the bus share\n  var __relay__: RelayGlobal | undefined;\n}\n\n/** the bus of this page: one instance, whichever module loads first */\nexport const bus: Bus = install();\n\nfunction install(): Bus {\n  const existing = globalThis.__relay__;\n\n  if (existing?.track && existing.configure && existing.notify && existing.consent) {\n    return existing as Bus;\n  }\n\n  const created = createBus();\n  const queued = Array.isArray(existing?.q) ? (existing.q as unknown[]) : [];\n\n  // later inline pushes land on the bus directly\n  const installed: RelayGlobal = { ...created, q: { push: (input) => void created.track(input) } };\n\n  // eslint-disable-next-line unicorn/no-global-object-property-assignment -- `self.__relay__` is the queue inline scripts push into before the bus exists; the bus takes its place\n  globalThis.__relay__ = installed;\n\n  for (const input of queued) {\n    if (isTrackInput(input)) created.track(input);\n  }\n\n  if (isBrowser()) {\n    installConsentHeader(created.consent);\n    document.addEventListener('click', trackClick, { capture: true });\n  }\n\n  return created;\n}\n\n// an element marked `data-track` (a button, a link) tracks the event serialized into the attribute\n// when clicked — before hydration too, and without a listener per component\nfunction trackClick(event: MouseEvent): void {\n  const target = event.target;\n\n  if (!(target instanceof Element)) return;\n\n  const element = target.closest(`[${CSS.escape(RELAY_TRACK_ATTRIBUTE)}]`);\n  const raw = element?.getAttribute(RELAY_TRACK_ATTRIBUTE);\n\n  if (!raw) return;\n\n  let parsed: unknown;\n\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return;\n  }\n\n  if (isTrackInput(parsed)) bus.track(parsed);\n}\n"],"mappings":"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"}

package/dist/matomo/index.d.ts

@@ -0,0 +1,46 @@
+import { a as Destination } from "../bus-Z7l8oJtS.js";
+import { a as CommerceItem } from "../commerce-DCGO8yag.js";
+declare global {
+  interface Window {
+    /** the matomo command queue; the tracker replays it once loaded */
+    _paq?: unknown[][] | undefined;
+    /** set by matomo.js once the tracker has loaded */
+    Matomo?: unknown;
+  }
+}
+/** one `_paq.push()` argument list: the method name and its arguments */
+export type MatomoCall = readonly unknown[];
+/** what the tracker takes: the calls of one event, pushed in order */
+export type MatomoCalls = readonly MatomoCall[];
+declare module '@astroscope/relay' {
+  interface RelayDestinations {
+    matomo: MatomoCalls;
+  }
+}
+export type MatomoOrder = {
+  /** the order number */
+  id: string;
+  value: number;
+  tax?: number | undefined;
+  shipping?: number | undefined;
+  items?: readonly CommerceItem[] | undefined;
+};
+/**
+ * The matomo builders: an event, a site search, an ecommerce order, or the raw `calls()`. What an
+ * event definition puts under `matomo`. Product and cart views stay events: the ecommerce views
+ * need the page view call, which the tracker snippet already made.
+ */
+export declare const matomo: {
+  calls: (...calls: MatomoCall[]) => MatomoCalls;
+  event: (category: string, action: string, name?: string, value?: number) => MatomoCalls;
+  siteSearch: (term: string, category?: string, count?: number) => MatomoCalls;
+  order: (order: MatomoOrder) => MatomoCalls;
+};
+/**
+ * The matomo tracker as a destination: pushes the `matomo` calls of an event into `_paq`. The queue is
+ * installed right away, so pushes never wait for the tracker; the tracker's own snippet (from the
+ * cmp after consent, or from the page for a cookieless setup, declared free in the consent source)
+ * loads matomo.js and the page view.
+ */
+export declare function matomoTracker(): Destination<'matomo'>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/matomo/index.ts"],"mappings":";;QAIQ;YACI;;IAER;;IAEA;;;;YAKQ;;YAGA,uBAAuB;;YAGvB;IACR,QAAQ;;;YAIA;;EAEV;EACA;EACA;EACA;EACA,iBAAiB;;;;;;;qBAQN;EACO,WAAA,OAAA,iBAAe;EACf,QAAA,kBAAM,gBAAgB,eAAe,mBAAmB;EAGvD,aAAA,cAAM,mBAAmB,mBAAmB;EAChD,QAAA,OAAA,gBAAc;;;;;;;;wBAcf,iBAAiB"}

package/dist/matomo/index.js

@@ -0,0 +1,61 @@
+import { a as isBrowser } from "../shared-D281USsp.js";
+// src/matomo/index.ts
+/**
+* The matomo builders: an event, a site search, an ecommerce order, or the raw `calls()`. What an
+* event definition puts under `matomo`. Product and cart views stay events: the ecommerce views
+* need the page view call, which the tracker snippet already made.
+*/
+const matomo = {
+	calls: (...calls) => calls,
+	event: (category, action, name, value) => [[
+		"trackEvent",
+		category,
+		action,
+		name,
+		value
+	]],
+	siteSearch: (term, category, count) => [[
+		"trackSiteSearch",
+		term,
+		category,
+		count
+	]],
+	order: (order) => [...(order.items ?? []).map((item) => [
+		"addEcommerceItem",
+		item.item_id,
+		item.item_name,
+		item.item_category,
+		item.price,
+		item.quantity
+	]), [
+		"trackEcommerceOrder",
+		order.id,
+		order.value,
+		void 0,
+		order.tax,
+		order.shipping
+	]]
+};
+/**
+* The matomo tracker as a destination: pushes the `matomo` calls of an event into `_paq`. The queue is
+* installed right away, so pushes never wait for the tracker; the tracker's own snippet (from the
+* cmp after consent, or from the page for a cookieless setup, declared free in the consent source)
+* loads matomo.js and the page view.
+*/
+function matomoTracker() {
+	if (isBrowser()) installQueue();
+	return {
+		name: "matomo",
+		ready: () => isBrowser() && globalThis.window.Matomo !== void 0,
+		send: (calls) => {
+			const paq = globalThis.window._paq ?? [];
+			for (const call of calls) paq.push([...call]);
+		}
+	};
+}
+function installQueue() {
+	window._paq ??= [];
+}
+export { matomo, matomoTracker };
+
+//# sourceMappingURL=index.js.map

package/dist/matomo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/matomo/index.ts"],"sourcesContent":["import type { Destination } from '../client/bus.js';\nimport type { CommerceItem } from '../commerce.js';\nimport { isBrowser } from '../shared.js';\n\ndeclare global {\n  interface Window {\n    /** the matomo command queue; the tracker replays it once loaded */\n    _paq?: unknown[][] | undefined;\n    /** set by matomo.js once the tracker has loaded */\n    Matomo?: unknown;\n  }\n}\n\n/** one `_paq.push()` argument list: the method name and its arguments */\nexport type MatomoCall = readonly unknown[];\n\n/** what the tracker takes: the calls of one event, pushed in order */\nexport type MatomoCalls = readonly MatomoCall[];\n\ndeclare module '@astroscope/relay' {\n  interface RelayDestinations {\n    matomo: MatomoCalls;\n  }\n}\n\nexport type MatomoOrder = {\n  /** the order number */\n  id: string;\n  value: number;\n  tax?: number | undefined;\n  shipping?: number | undefined;\n  items?: readonly CommerceItem[] | undefined;\n};\n\n/**\n * The matomo builders: an event, a site search, an ecommerce order, or the raw `calls()`. What an\n * event definition puts under `matomo`. Product and cart views stay events: the ecommerce views\n * need the page view call, which the tracker snippet already made.\n */\nexport const matomo = {\n  calls: (...calls: MatomoCall[]): MatomoCalls => calls,\n  event: (category: string, action: string, name?: string, value?: number): MatomoCalls => [\n    ['trackEvent', category, action, name, value],\n  ],\n  siteSearch: (term: string, category?: string, count?: number): MatomoCalls => [['trackSiteSearch', term, category, count]],\n  order: (order: MatomoOrder): MatomoCalls => [\n    ...(order.items ?? []).map(\n      (item): MatomoCall => ['addEcommerceItem', item.item_id, item.item_name, item.item_category, item.price, item.quantity],\n    ),\n    ['trackEcommerceOrder', order.id, order.value, undefined, order.tax, order.shipping],\n  ],\n};\n\n/**\n * The matomo tracker as a destination: pushes the `matomo` calls of an event into `_paq`. The queue is\n * installed right away, so pushes never wait for the tracker; the tracker's own snippet (from the\n * cmp after consent, or from the page for a cookieless setup, declared free in the consent source)\n * loads matomo.js and the page view.\n */\nexport function matomoTracker(): Destination<'matomo'> {\n  if (isBrowser()) {\n    installQueue();\n  }\n\n  return {\n    name: 'matomo',\n    ready: () => isBrowser() && globalThis.window.Matomo !== undefined,\n    send: (calls) => {\n      const paq = globalThis.window._paq ?? [];\n\n      for (const call of calls) {\n        paq.push([...call]);\n      }\n    },\n  };\n}\n\nfunction installQueue(): void {\n  // eslint-disable-next-line unicorn/no-global-object-property-assignment -- `window._paq` is the tracker's documented contract\n  window._paq ??= [];\n}\n"],"mappings":";;;;;;;AAuCA,MAAa,SAAS;CACpB,QAAQ,GAAG,UAAqC;CAChD,QAAQ,UAAkB,QAAgB,MAAe,UAAgC,CACvF;EAAC;EAAc;EAAU;EAAQ;EAAM;CAAK,CAC9C;CACA,aAAa,MAAc,UAAmB,UAAgC,CAAC;EAAC;EAAmB;EAAM;EAAU;CAAK,CAAC;CACzH,QAAQ,UAAoC,CAC1C,IAAI,MAAM,SAAS,CAAC,EAAA,CAAG,KACpB,SAAqB;EAAC;EAAoB,KAAK;EAAS,KAAK;EAAW,KAAK;EAAe,KAAK;EAAO,KAAK;CAAQ,CACxH,GACA;EAAC;EAAuB,MAAM;EAAI,MAAM;EAAO,KAAA;EAAW,MAAM;EAAK,MAAM;CAAQ,CACrF;AACF;;;;;;;AAQA,SAAgB,gBAAuC;CACrD,IAAI,UAAU,GACZ,aAAa;CAGf,OAAO;EACL,MAAM;EACN,aAAa,UAAU,KAAK,WAAW,OAAO,WAAW,KAAA;EACzD,OAAO,UAAU;GACf,MAAM,MAAM,WAAW,OAAO,QAAQ,CAAC;GAEvC,KAAK,MAAM,QAAQ,OACjB,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC;EAEtB;CACF;AACF;AAEA,SAAS,eAAqB;CAE5B,OAAO,SAAS,CAAC;AACnB"}

package/dist/openai/index.d.ts

@@ -0,0 +1,97 @@
+import { a as Destination } from "../bus-Z7l8oJtS.js";
+import { t as ConversionUser } from "../conversion-user-DCfM5EuZ.js";
+/** monetary values are integers in the minor unit of the currency: 12999 for 129.99 EUR */
+type OpenAiContent = {
+  id: string;
+  name: string;
+  content_type: string;
+  quantity: number;
+  amount: number;
+  currency: string;
+};
+type OpenAiContentsData = {
+  type: 'contents';
+  amount: number;
+  currency: string;
+  contents: readonly OpenAiContent[];
+};
+type OpenAiCustomerActionData = {
+  type: 'customer_action';
+};
+/**
+ * What openai takes, from the pixel and from the conversions api alike: the event and, for a
+ * conversion the visitor entered identifiers for, the identifiers — hashed by whichever half sends.
+ */
+type OpenAiEvent = ({
+  name: 'contents_viewed' | 'items_added' | 'checkout_started' | 'order_created';
+  data: OpenAiContentsData;
+} | {
+  name: 'lead_created';
+  data: OpenAiCustomerActionData;
+}) & {
+  user?: ConversionUser | undefined;
+};
+declare module '@astroscope/relay' {
+  interface RelayDestinations {
+    openai: OpenAiEvent;
+  }
+}
+type OpenAiContentInput = {
+  id: string;
+  name: string;
+  price: number;
+  quantity: number;
+};
+type OpenAiContents = {
+  items: readonly OpenAiContentInput[];
+  currency: string;
+  /** the total; default: the items summed */
+  value?: number | undefined;
+  /** the `content_type` of the contents; default `product` */
+  contentType?: string | undefined;
+  user?: ConversionUser | undefined;
+};
+/** the openai builders: the events openai has a name for. What an event definition puts under `openai` */
+export declare const openai: {
+  contentsViewed: (contents: OpenAiContents) => OpenAiEvent;
+  itemsAdded: (contents: OpenAiContents) => OpenAiEvent;
+  checkoutStarted: (contents: OpenAiContents) => OpenAiEvent;
+  orderCreated: (contents: OpenAiContents) => OpenAiEvent;
+  leadCreated: (user?: ConversionUser) => OpenAiEvent;
+};
+export declare function toMinorUnits(value: number): number;
+/** advanced matching data of the pixel: normalized identifiers as lowercase sha256 hex */
+type OpenAiUser = {
+  email_sha256?: string | undefined;
+  phone_number_sha256?: string | undefined;
+  first_name_sha256?: string | undefined;
+  last_name_sha256?: string | undefined;
+};
+type OpenAiOptions = {
+  /** deduplicates against the same event sent through the conversions api */
+  event_id?: string | undefined;
+};
+type Oaiq = {
+  (command: 'init', options: {
+    user: OpenAiUser;
+  }): void;
+  (command: 'measure', name: OpenAiEvent['name'], data: OpenAiEvent['data'], options?: OpenAiOptions): void;
+};
+declare global {
+  interface Window {
+    oaiq?: Oaiq | undefined;
+  }
+}
+export type OpenAiPixelOptions = {
+  /** the country calling code national phone numbers get before hashing, e.g. `49` */
+  countryCallingCode?: string | undefined;
+};
+/**
+ * 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.
+ */
+export declare function openAiPixel(options?: OpenAiPixelOptions): Destination<'openai'>;
+export type { OpenAiContent, OpenAiContentInput, OpenAiContents, OpenAiContentsData, OpenAiCustomerActionData, OpenAiEvent };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":["_0"],"sources":["../../src/openai/shared.ts","../../src/openai/index.ts"],"mappings":";;;KAKY;EACV;EACA;EACA;EACA;EACA;EACA;;KAGU;EACV;EACA;EACA;EACA,mBAAmB;;KAGT;EACV;;;;;;KAOU;EAER;EACA,MAAM;;EAGN;EACA,MAAM;;EAGR,OAAO;;;YAIG;IACR,QAAQ;;;KAIA;EAAuB;EAAY;EAAc;EAAe;;KAEhE;EACV,gBAAgB;EAChB;;EAEA;;EAEA;EACA,OAAO;;;qBAII;EACgB,iBAAA,UAAA,mBAAiB;EACrB,aAAA,UAAA,mBAAiB;EACZ,kBAAA,UAAA,mBAAiB;EACpB,eAAA,UAAA,mBAAiB;EACrB,cAAA,OAAA,mBAAiB;;wBA4BxB,aAAa;;KCrFxB;EACH;EACA;EACA;EACA;;KAGG;;EAEH;;KAGG;GACF,iBAAiB;IAAW,MAAM;;GAClC,oBAAoB,MAAM,qBAAqB,MAAM,qBAAqB,UAAU;;QAG/E;YACI;IACR,OAAO;;;YAIC;;EAEV;;;;;;;;wBAWc,YAAY,UAAS,qBAA0B"}