@pingaura/telemetry 0.1.0

package/dist/core-Cvg8zn6Q.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-Cvg8zn6Q.mjs","names":[],"sources":["../src/contract.ts","../src/core.ts"],"sourcesContent":["// PingAura analytics event envelope. Zero runtime dependencies by design.\n\nexport const ANALYTICS_SCHEMA_VERSION = 1 as const;\n\nexport const EVENT_TYPES = [\n  'page_view',\n  'page_leave',\n  'web_vitals',\n  'track',\n] as const;\nexport type EventType = (typeof EVENT_TYPES)[number];\n\nexport interface EventContext {\n  url: string;\n  path?: string;\n  referrer?: string;\n  title?: string;\n  locale?: string;\n  screen?: string;\n  user_agent?: string;\n  country?: string;\n}\n\nexport interface AnalyticsEvent {\n  event_id: string;\n  schema_version: typeof ANALYTICS_SCHEMA_VERSION;\n  type: EventType;\n  view_id?: string;\n  timestamp: string;\n  sent_at: string;\n  context: EventContext;\n  properties: Record<string, unknown>;\n  library?: { name: string; version: string };\n}\n\nexport interface BuildEventInput {\n  type: EventType;\n  context: EventContext;\n  /**\n   * Event metadata, archived verbatim. Never put PII here (emails, names, user\n   * IDs, raw query strings) — the collector rejects events whose values look\n   * like PII. Use opaque or aggregate values only.\n   */\n  properties?: Record<string, unknown>;\n  timestamp?: string;\n  view_id?: string;\n  library?: { name: string; version: string };\n}\n\n/** Build a contract-valid event envelope. `now` is injectable for tests. */\nexport function buildEvent(\n  input: BuildEventInput,\n  now: () => string = () => new Date().toISOString(),\n): AnalyticsEvent {\n  const ts = input.timestamp ?? now();\n  return {\n    event_id: globalThis.crypto.randomUUID(),\n    schema_version: ANALYTICS_SCHEMA_VERSION,\n    type: input.type,\n    view_id: input.view_id,\n    timestamp: ts,\n    sent_at: now(),\n    context: input.context,\n    properties: input.properties ?? {},\n    library: input.library,\n  };\n}\n","import {\n  type AnalyticsEvent,\n  type BuildEventInput,\n  buildEvent,\n} from './contract';\n\nexport interface ClientConfig {\n  /** Ingest key (e.g. `process.env.PINGAURA_INGEST_KEY`). Missing/empty disables tracking. */\n  writeKey: string | undefined;\n  /** Ingest endpoint. Defaults to the production collector; override for region/dev/testing. */\n  endpoint?: string;\n  /** Registered site domain (e.g. \"example.com\"), required for attribution. Missing/empty disables tracking. */\n  domain: string | undefined;\n  timeoutMs?: number;\n  debug?: boolean;\n  /** Injectable for tests; defaults to global fetch. */\n  fetchImpl?: typeof fetch;\n  /** Injectable warning sink; defaults to console.warn. */\n  onWarn?: (message: string) => void;\n  /** Pass keepalive on the fetch (default true). Set false in edge runtimes (use ctx.waitUntil). */\n  keepalive?: boolean;\n}\n\nexport interface SendOptions {\n  /** Visitor IP — sent as the X-PA-Client-IP header, never in the body. */\n  ip?: string;\n}\n\nexport interface PageViewInput {\n  url: string;\n  path?: string;\n  referrer?: string;\n  title?: string;\n  locale?: string;\n  userAgent?: string;\n  ip?: string;\n  properties?: Record<string, unknown>;\n}\n\nexport interface AnalyticsClient {\n  send(event: AnalyticsEvent, options?: SendOptions): Promise<void>;\n  sendRaw(input: BuildEventInput, options?: SendOptions): Promise<void>;\n  pageView(input: PageViewInput): Promise<void>;\n  /** `properties` is archived verbatim — never pass PII; opaque/aggregate values only. */\n  track(\n    name: string,\n    properties: Record<string, unknown> | undefined,\n    context: { url: string; path?: string; referrer?: string },\n  ): Promise<void>;\n}\n\nconst DEFAULT_TIMEOUT_MS = 2000;\nconst DEFAULT_ENDPOINT = 'https://telemetry.pingaura.ai/v1/events';\n\n// Reads a 2xx body (releasing the keepalive socket) and returns the collector's\n// rejected count. Cancels the stream on a non-JSON body so the socket is freed.\nasync function drainAndCountRejected(res: Response): Promise<number> {\n  try {\n    if (typeof res.json === 'function') {\n      const body = (await res.json()) as { rejected?: unknown };\n      const rejected = body?.rejected;\n      if (Array.isArray(rejected)) return rejected.length;\n      if (typeof rejected === 'number') return rejected;\n      return 0;\n    }\n  } catch {\n    // not JSON / already consumed — fall through to cancel\n  }\n  await res.body?.cancel?.().catch(() => {});\n  return 0;\n}\n\nexport function createClient(config: ClientConfig): AnalyticsClient {\n  const fetchImpl = config.fetchImpl ?? globalThis.fetch;\n  const warn = config.onWarn ?? ((m: string) => console.warn(m));\n  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const endpoint = config.endpoint ?? DEFAULT_ENDPOINT;\n  // 4xx rejections never self-heal — warn once per status instead of per request.\n  const warnedStatuses = new Set<number>();\n\n  if (!config.writeKey)\n    warn('[pingaura] writeKey missing — analytics disabled');\n  if (!config.domain) warn('[pingaura] domain missing — analytics disabled');\n\n  async function send(\n    event: AnalyticsEvent,\n    options: SendOptions = {},\n  ): Promise<void> {\n    if (!config.writeKey || !config.domain) return; // no-op (already warned at init)\n\n    const headers: Record<string, string> = {\n      'content-type': 'application/json',\n      authorization: `Bearer ${config.writeKey}`,\n    };\n    if (options.ip) headers['x-pa-client-ip'] = options.ip;\n\n    let body: string;\n    try {\n      body = JSON.stringify({ domain: config.domain, events: [event] });\n    } catch (err) {\n      if (config.debug)\n        warn(`[pingaura] failed to serialize event: ${String(err)}`);\n      return;\n    }\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    try {\n      const res = await fetchImpl(endpoint, {\n        method: 'POST',\n        headers,\n        body,\n        signal: controller.signal,\n        // best-effort; ignored on older Node and rejected by some edge runtimes for large bodies\n        keepalive: config.keepalive ?? true,\n      });\n\n      if (res.status < 200 || res.status >= 300) {\n        let detail = '';\n        try {\n          detail = ((await res.text?.()) ?? '').slice(0, 200);\n        } catch {\n          // body unreadable — the status code alone is enough\n        }\n        const message = `[pingaura] ingest rejected (${res.status})${detail ? `: ${detail}` : ''}`;\n        if (res.status === 429 || res.status >= 500) {\n          // transient (rate-limit / server) — debug-only, same as network failures\n          if (config.debug) warn(message);\n        } else if (!warnedStatuses.has(res.status)) {\n          // deterministic client error (bad key/domain/payload) — warn once\n          warnedStatuses.add(res.status);\n          warn(message);\n        }\n        return;\n      }\n\n      // 2xx: drain the body to release the keepalive socket and surface partial drops\n      const rejected = await drainAndCountRejected(res);\n      if (rejected > 0)\n        warn(`[pingaura] ${rejected} event(s) rejected by collector`);\n    } catch (err) {\n      // network / abort / timeout — transient; quiet outside debug\n      if (config.debug) warn(`[pingaura] send failed: ${String(err)}`);\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  // Build inside the guard so a synchronous throw (crypto.randomUUID) never\n  // escapes into the caller's request path — every adapter is fire-and-forget.\n  function safeSend(\n    input: BuildEventInput,\n    options?: SendOptions,\n  ): Promise<void> {\n    let event: AnalyticsEvent;\n    try {\n      event = buildEvent(input);\n    } catch (err) {\n      if (config.debug)\n        warn(`[pingaura] failed to build event: ${String(err)}`);\n      return Promise.resolve();\n    }\n    return send(event, options);\n  }\n\n  return {\n    send,\n    sendRaw: (input, options) => safeSend(input, options),\n    pageView: (input) =>\n      safeSend(\n        {\n          type: 'page_view',\n          context: {\n            url: input.url,\n            path: input.path,\n            referrer: input.referrer,\n            title: input.title,\n            locale: input.locale,\n            user_agent: input.userAgent,\n          },\n          properties: input.properties,\n        },\n        { ip: input.ip },\n      ),\n    track: (name, properties = {}, context) =>\n      safeSend({\n        type: 'track',\n        context: {\n          url: context.url,\n          path: context.path,\n          referrer: context.referrer,\n        },\n        properties: { ...properties, name },\n      }),\n  };\n}\n"],"mappings":"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"}

package/dist/core-DVilpn_i.d.cts

@@ -0,0 +1,93 @@
+//#region src/contract.d.ts
+declare const ANALYTICS_SCHEMA_VERSION: 1;
+declare const EVENT_TYPES: readonly ["page_view", "page_leave", "web_vitals", "track"];
+type EventType = (typeof EVENT_TYPES)[number];
+interface EventContext {
+  url: string;
+  path?: string;
+  referrer?: string;
+  title?: string;
+  locale?: string;
+  screen?: string;
+  user_agent?: string;
+  country?: string;
+}
+interface AnalyticsEvent {
+  event_id: string;
+  schema_version: typeof ANALYTICS_SCHEMA_VERSION;
+  type: EventType;
+  view_id?: string;
+  timestamp: string;
+  sent_at: string;
+  context: EventContext;
+  properties: Record<string, unknown>;
+  library?: {
+    name: string;
+    version: string;
+  };
+}
+interface BuildEventInput {
+  type: EventType;
+  context: EventContext;
+  /**
+   * Event metadata, archived verbatim. Never put PII here (emails, names, user
+   * IDs, raw query strings) — the collector rejects events whose values look
+   * like PII. Use opaque or aggregate values only.
+   */
+  properties?: Record<string, unknown>;
+  timestamp?: string;
+  view_id?: string;
+  library?: {
+    name: string;
+    version: string;
+  };
+}
+/** Build a contract-valid event envelope. `now` is injectable for tests. */
+declare function buildEvent(input: BuildEventInput, now?: () => string): AnalyticsEvent;
+//#endregion
+//#region src/core.d.ts
+interface ClientConfig {
+  /** Ingest key (e.g. `process.env.PINGAURA_INGEST_KEY`). Missing/empty disables tracking. */
+  writeKey: string | undefined;
+  /** Ingest endpoint. Defaults to the production collector; override for region/dev/testing. */
+  endpoint?: string;
+  /** Registered site domain (e.g. "example.com"), required for attribution. Missing/empty disables tracking. */
+  domain: string | undefined;
+  timeoutMs?: number;
+  debug?: boolean;
+  /** Injectable for tests; defaults to global fetch. */
+  fetchImpl?: typeof fetch;
+  /** Injectable warning sink; defaults to console.warn. */
+  onWarn?: (message: string) => void;
+  /** Pass keepalive on the fetch (default true). Set false in edge runtimes (use ctx.waitUntil). */
+  keepalive?: boolean;
+}
+interface SendOptions {
+  /** Visitor IP — sent as the X-PA-Client-IP header, never in the body. */
+  ip?: string;
+}
+interface PageViewInput {
+  url: string;
+  path?: string;
+  referrer?: string;
+  title?: string;
+  locale?: string;
+  userAgent?: string;
+  ip?: string;
+  properties?: Record<string, unknown>;
+}
+interface AnalyticsClient {
+  send(event: AnalyticsEvent, options?: SendOptions): Promise<void>;
+  sendRaw(input: BuildEventInput, options?: SendOptions): Promise<void>;
+  pageView(input: PageViewInput): Promise<void>;
+  /** `properties` is archived verbatim — never pass PII; opaque/aggregate values only. */
+  track(name: string, properties: Record<string, unknown> | undefined, context: {
+    url: string;
+    path?: string;
+    referrer?: string;
+  }): Promise<void>;
+}
+declare function createClient(config: ClientConfig): AnalyticsClient;
+//#endregion
+export { createClient as a, BuildEventInput as c, EventType as d, buildEvent as f, SendOptions as i, EVENT_TYPES as l, ClientConfig as n, ANALYTICS_SCHEMA_VERSION as o, PageViewInput as r, AnalyticsEvent as s, AnalyticsClient as t, EventContext as u };
+//# sourceMappingURL=core-DVilpn_i.d.cts.map

package/dist/core-DVilpn_i.d.mts

@@ -0,0 +1,93 @@
+//#region src/contract.d.ts
+declare const ANALYTICS_SCHEMA_VERSION: 1;
+declare const EVENT_TYPES: readonly ["page_view", "page_leave", "web_vitals", "track"];
+type EventType = (typeof EVENT_TYPES)[number];
+interface EventContext {
+  url: string;
+  path?: string;
+  referrer?: string;
+  title?: string;
+  locale?: string;
+  screen?: string;
+  user_agent?: string;
+  country?: string;
+}
+interface AnalyticsEvent {
+  event_id: string;
+  schema_version: typeof ANALYTICS_SCHEMA_VERSION;
+  type: EventType;
+  view_id?: string;
+  timestamp: string;
+  sent_at: string;
+  context: EventContext;
+  properties: Record<string, unknown>;
+  library?: {
+    name: string;
+    version: string;
+  };
+}
+interface BuildEventInput {
+  type: EventType;
+  context: EventContext;
+  /**
+   * Event metadata, archived verbatim. Never put PII here (emails, names, user
+   * IDs, raw query strings) — the collector rejects events whose values look
+   * like PII. Use opaque or aggregate values only.
+   */
+  properties?: Record<string, unknown>;
+  timestamp?: string;
+  view_id?: string;
+  library?: {
+    name: string;
+    version: string;
+  };
+}
+/** Build a contract-valid event envelope. `now` is injectable for tests. */
+declare function buildEvent(input: BuildEventInput, now?: () => string): AnalyticsEvent;
+//#endregion
+//#region src/core.d.ts
+interface ClientConfig {
+  /** Ingest key (e.g. `process.env.PINGAURA_INGEST_KEY`). Missing/empty disables tracking. */
+  writeKey: string | undefined;
+  /** Ingest endpoint. Defaults to the production collector; override for region/dev/testing. */
+  endpoint?: string;
+  /** Registered site domain (e.g. "example.com"), required for attribution. Missing/empty disables tracking. */
+  domain: string | undefined;
+  timeoutMs?: number;
+  debug?: boolean;
+  /** Injectable for tests; defaults to global fetch. */
+  fetchImpl?: typeof fetch;
+  /** Injectable warning sink; defaults to console.warn. */
+  onWarn?: (message: string) => void;
+  /** Pass keepalive on the fetch (default true). Set false in edge runtimes (use ctx.waitUntil). */
+  keepalive?: boolean;
+}
+interface SendOptions {
+  /** Visitor IP — sent as the X-PA-Client-IP header, never in the body. */
+  ip?: string;
+}
+interface PageViewInput {
+  url: string;
+  path?: string;
+  referrer?: string;
+  title?: string;
+  locale?: string;
+  userAgent?: string;
+  ip?: string;
+  properties?: Record<string, unknown>;
+}
+interface AnalyticsClient {
+  send(event: AnalyticsEvent, options?: SendOptions): Promise<void>;
+  sendRaw(input: BuildEventInput, options?: SendOptions): Promise<void>;
+  pageView(input: PageViewInput): Promise<void>;
+  /** `properties` is archived verbatim — never pass PII; opaque/aggregate values only. */
+  track(name: string, properties: Record<string, unknown> | undefined, context: {
+    url: string;
+    path?: string;
+    referrer?: string;
+  }): Promise<void>;
+}
+declare function createClient(config: ClientConfig): AnalyticsClient;
+//#endregion
+export { createClient as a, BuildEventInput as c, EventType as d, buildEvent as f, SendOptions as i, EVENT_TYPES as l, ClientConfig as n, ANALYTICS_SCHEMA_VERSION as o, PageViewInput as r, AnalyticsEvent as s, AnalyticsClient as t, EventContext as u };
+//# sourceMappingURL=core-DVilpn_i.d.mts.map

package/dist/core-KgLaVgR4.cjs

@@ -0,0 +1,162 @@
+//#region src/contract.ts
+const ANALYTICS_SCHEMA_VERSION = 1;
+const EVENT_TYPES = [
+	"page_view",
+	"page_leave",
+	"web_vitals",
+	"track"
+];
+/** Build a contract-valid event envelope. `now` is injectable for tests. */
+function buildEvent(input, now = () => (/* @__PURE__ */ new Date()).toISOString()) {
+	const ts = input.timestamp ?? now();
+	return {
+		event_id: globalThis.crypto.randomUUID(),
+		schema_version: 1,
+		type: input.type,
+		view_id: input.view_id,
+		timestamp: ts,
+		sent_at: now(),
+		context: input.context,
+		properties: input.properties ?? {},
+		library: input.library
+	};
+}
+//#endregion
+//#region src/core.ts
+const DEFAULT_TIMEOUT_MS = 2e3;
+const DEFAULT_ENDPOINT = "https://telemetry.pingaura.ai/v1/events";
+async function drainAndCountRejected(res) {
+	try {
+		if (typeof res.json === "function") {
+			const rejected = (await res.json())?.rejected;
+			if (Array.isArray(rejected)) return rejected.length;
+			if (typeof rejected === "number") return rejected;
+			return 0;
+		}
+	} catch {}
+	await res.body?.cancel?.().catch(() => {});
+	return 0;
+}
+function createClient(config) {
+	const fetchImpl = config.fetchImpl ?? globalThis.fetch;
+	const warn = config.onWarn ?? ((m) => console.warn(m));
+	const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	const endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+	const warnedStatuses = /* @__PURE__ */ new Set();
+	if (!config.writeKey) warn("[pingaura] writeKey missing — analytics disabled");
+	if (!config.domain) warn("[pingaura] domain missing — analytics disabled");
+	async function send(event, options = {}) {
+		if (!config.writeKey || !config.domain) return;
+		const headers = {
+			"content-type": "application/json",
+			authorization: `Bearer ${config.writeKey}`
+		};
+		if (options.ip) headers["x-pa-client-ip"] = options.ip;
+		let body;
+		try {
+			body = JSON.stringify({
+				domain: config.domain,
+				events: [event]
+			});
+		} catch (err) {
+			if (config.debug) warn(`[pingaura] failed to serialize event: ${String(err)}`);
+			return;
+		}
+		const controller = new AbortController();
+		const timer = setTimeout(() => controller.abort(), timeoutMs);
+		try {
+			const res = await fetchImpl(endpoint, {
+				method: "POST",
+				headers,
+				body,
+				signal: controller.signal,
+				keepalive: config.keepalive ?? true
+			});
+			if (res.status < 200 || res.status >= 300) {
+				let detail = "";
+				try {
+					detail = (await res.text?.() ?? "").slice(0, 200);
+				} catch {}
+				const message = `[pingaura] ingest rejected (${res.status})${detail ? `: ${detail}` : ""}`;
+				if (res.status === 429 || res.status >= 500) {
+					if (config.debug) warn(message);
+				} else if (!warnedStatuses.has(res.status)) {
+					warnedStatuses.add(res.status);
+					warn(message);
+				}
+				return;
+			}
+			const rejected = await drainAndCountRejected(res);
+			if (rejected > 0) warn(`[pingaura] ${rejected} event(s) rejected by collector`);
+		} catch (err) {
+			if (config.debug) warn(`[pingaura] send failed: ${String(err)}`);
+		} finally {
+			clearTimeout(timer);
+		}
+	}
+	function safeSend(input, options) {
+		let event;
+		try {
+			event = buildEvent(input);
+		} catch (err) {
+			if (config.debug) warn(`[pingaura] failed to build event: ${String(err)}`);
+			return Promise.resolve();
+		}
+		return send(event, options);
+	}
+	return {
+		send,
+		sendRaw: (input, options) => safeSend(input, options),
+		pageView: (input) => safeSend({
+			type: "page_view",
+			context: {
+				url: input.url,
+				path: input.path,
+				referrer: input.referrer,
+				title: input.title,
+				locale: input.locale,
+				user_agent: input.userAgent
+			},
+			properties: input.properties
+		}, { ip: input.ip }),
+		track: (name, properties = {}, context) => safeSend({
+			type: "track",
+			context: {
+				url: context.url,
+				path: context.path,
+				referrer: context.referrer
+			},
+			properties: {
+				...properties,
+				name
+			}
+		})
+	};
+}
+//#endregion
+Object.defineProperty(exports, "ANALYTICS_SCHEMA_VERSION", {
+	enumerable: true,
+	get: function() {
+		return ANALYTICS_SCHEMA_VERSION;
+	}
+});
+Object.defineProperty(exports, "EVENT_TYPES", {
+	enumerable: true,
+	get: function() {
+		return EVENT_TYPES;
+	}
+});
+Object.defineProperty(exports, "buildEvent", {
+	enumerable: true,
+	get: function() {
+		return buildEvent;
+	}
+});
+Object.defineProperty(exports, "createClient", {
+	enumerable: true,
+	get: function() {
+		return createClient;
+	}
+});
+
+//# sourceMappingURL=core-KgLaVgR4.cjs.map

package/dist/core-KgLaVgR4.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core-KgLaVgR4.cjs","names":[],"sources":["../src/contract.ts","../src/core.ts"],"sourcesContent":["// PingAura analytics event envelope. Zero runtime dependencies by design.\n\nexport const ANALYTICS_SCHEMA_VERSION = 1 as const;\n\nexport const EVENT_TYPES = [\n  'page_view',\n  'page_leave',\n  'web_vitals',\n  'track',\n] as const;\nexport type EventType = (typeof EVENT_TYPES)[number];\n\nexport interface EventContext {\n  url: string;\n  path?: string;\n  referrer?: string;\n  title?: string;\n  locale?: string;\n  screen?: string;\n  user_agent?: string;\n  country?: string;\n}\n\nexport interface AnalyticsEvent {\n  event_id: string;\n  schema_version: typeof ANALYTICS_SCHEMA_VERSION;\n  type: EventType;\n  view_id?: string;\n  timestamp: string;\n  sent_at: string;\n  context: EventContext;\n  properties: Record<string, unknown>;\n  library?: { name: string; version: string };\n}\n\nexport interface BuildEventInput {\n  type: EventType;\n  context: EventContext;\n  /**\n   * Event metadata, archived verbatim. Never put PII here (emails, names, user\n   * IDs, raw query strings) — the collector rejects events whose values look\n   * like PII. Use opaque or aggregate values only.\n   */\n  properties?: Record<string, unknown>;\n  timestamp?: string;\n  view_id?: string;\n  library?: { name: string; version: string };\n}\n\n/** Build a contract-valid event envelope. `now` is injectable for tests. */\nexport function buildEvent(\n  input: BuildEventInput,\n  now: () => string = () => new Date().toISOString(),\n): AnalyticsEvent {\n  const ts = input.timestamp ?? now();\n  return {\n    event_id: globalThis.crypto.randomUUID(),\n    schema_version: ANALYTICS_SCHEMA_VERSION,\n    type: input.type,\n    view_id: input.view_id,\n    timestamp: ts,\n    sent_at: now(),\n    context: input.context,\n    properties: input.properties ?? {},\n    library: input.library,\n  };\n}\n","import {\n  type AnalyticsEvent,\n  type BuildEventInput,\n  buildEvent,\n} from './contract';\n\nexport interface ClientConfig {\n  /** Ingest key (e.g. `process.env.PINGAURA_INGEST_KEY`). Missing/empty disables tracking. */\n  writeKey: string | undefined;\n  /** Ingest endpoint. Defaults to the production collector; override for region/dev/testing. */\n  endpoint?: string;\n  /** Registered site domain (e.g. \"example.com\"), required for attribution. Missing/empty disables tracking. */\n  domain: string | undefined;\n  timeoutMs?: number;\n  debug?: boolean;\n  /** Injectable for tests; defaults to global fetch. */\n  fetchImpl?: typeof fetch;\n  /** Injectable warning sink; defaults to console.warn. */\n  onWarn?: (message: string) => void;\n  /** Pass keepalive on the fetch (default true). Set false in edge runtimes (use ctx.waitUntil). */\n  keepalive?: boolean;\n}\n\nexport interface SendOptions {\n  /** Visitor IP — sent as the X-PA-Client-IP header, never in the body. */\n  ip?: string;\n}\n\nexport interface PageViewInput {\n  url: string;\n  path?: string;\n  referrer?: string;\n  title?: string;\n  locale?: string;\n  userAgent?: string;\n  ip?: string;\n  properties?: Record<string, unknown>;\n}\n\nexport interface AnalyticsClient {\n  send(event: AnalyticsEvent, options?: SendOptions): Promise<void>;\n  sendRaw(input: BuildEventInput, options?: SendOptions): Promise<void>;\n  pageView(input: PageViewInput): Promise<void>;\n  /** `properties` is archived verbatim — never pass PII; opaque/aggregate values only. */\n  track(\n    name: string,\n    properties: Record<string, unknown> | undefined,\n    context: { url: string; path?: string; referrer?: string },\n  ): Promise<void>;\n}\n\nconst DEFAULT_TIMEOUT_MS = 2000;\nconst DEFAULT_ENDPOINT = 'https://telemetry.pingaura.ai/v1/events';\n\n// Reads a 2xx body (releasing the keepalive socket) and returns the collector's\n// rejected count. Cancels the stream on a non-JSON body so the socket is freed.\nasync function drainAndCountRejected(res: Response): Promise<number> {\n  try {\n    if (typeof res.json === 'function') {\n      const body = (await res.json()) as { rejected?: unknown };\n      const rejected = body?.rejected;\n      if (Array.isArray(rejected)) return rejected.length;\n      if (typeof rejected === 'number') return rejected;\n      return 0;\n    }\n  } catch {\n    // not JSON / already consumed — fall through to cancel\n  }\n  await res.body?.cancel?.().catch(() => {});\n  return 0;\n}\n\nexport function createClient(config: ClientConfig): AnalyticsClient {\n  const fetchImpl = config.fetchImpl ?? globalThis.fetch;\n  const warn = config.onWarn ?? ((m: string) => console.warn(m));\n  const timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n  const endpoint = config.endpoint ?? DEFAULT_ENDPOINT;\n  // 4xx rejections never self-heal — warn once per status instead of per request.\n  const warnedStatuses = new Set<number>();\n\n  if (!config.writeKey)\n    warn('[pingaura] writeKey missing — analytics disabled');\n  if (!config.domain) warn('[pingaura] domain missing — analytics disabled');\n\n  async function send(\n    event: AnalyticsEvent,\n    options: SendOptions = {},\n  ): Promise<void> {\n    if (!config.writeKey || !config.domain) return; // no-op (already warned at init)\n\n    const headers: Record<string, string> = {\n      'content-type': 'application/json',\n      authorization: `Bearer ${config.writeKey}`,\n    };\n    if (options.ip) headers['x-pa-client-ip'] = options.ip;\n\n    let body: string;\n    try {\n      body = JSON.stringify({ domain: config.domain, events: [event] });\n    } catch (err) {\n      if (config.debug)\n        warn(`[pingaura] failed to serialize event: ${String(err)}`);\n      return;\n    }\n\n    const controller = new AbortController();\n    const timer = setTimeout(() => controller.abort(), timeoutMs);\n    try {\n      const res = await fetchImpl(endpoint, {\n        method: 'POST',\n        headers,\n        body,\n        signal: controller.signal,\n        // best-effort; ignored on older Node and rejected by some edge runtimes for large bodies\n        keepalive: config.keepalive ?? true,\n      });\n\n      if (res.status < 200 || res.status >= 300) {\n        let detail = '';\n        try {\n          detail = ((await res.text?.()) ?? '').slice(0, 200);\n        } catch {\n          // body unreadable — the status code alone is enough\n        }\n        const message = `[pingaura] ingest rejected (${res.status})${detail ? `: ${detail}` : ''}`;\n        if (res.status === 429 || res.status >= 500) {\n          // transient (rate-limit / server) — debug-only, same as network failures\n          if (config.debug) warn(message);\n        } else if (!warnedStatuses.has(res.status)) {\n          // deterministic client error (bad key/domain/payload) — warn once\n          warnedStatuses.add(res.status);\n          warn(message);\n        }\n        return;\n      }\n\n      // 2xx: drain the body to release the keepalive socket and surface partial drops\n      const rejected = await drainAndCountRejected(res);\n      if (rejected > 0)\n        warn(`[pingaura] ${rejected} event(s) rejected by collector`);\n    } catch (err) {\n      // network / abort / timeout — transient; quiet outside debug\n      if (config.debug) warn(`[pingaura] send failed: ${String(err)}`);\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n\n  // Build inside the guard so a synchronous throw (crypto.randomUUID) never\n  // escapes into the caller's request path — every adapter is fire-and-forget.\n  function safeSend(\n    input: BuildEventInput,\n    options?: SendOptions,\n  ): Promise<void> {\n    let event: AnalyticsEvent;\n    try {\n      event = buildEvent(input);\n    } catch (err) {\n      if (config.debug)\n        warn(`[pingaura] failed to build event: ${String(err)}`);\n      return Promise.resolve();\n    }\n    return send(event, options);\n  }\n\n  return {\n    send,\n    sendRaw: (input, options) => safeSend(input, options),\n    pageView: (input) =>\n      safeSend(\n        {\n          type: 'page_view',\n          context: {\n            url: input.url,\n            path: input.path,\n            referrer: input.referrer,\n            title: input.title,\n            locale: input.locale,\n            user_agent: input.userAgent,\n          },\n          properties: input.properties,\n        },\n        { ip: input.ip },\n      ),\n    track: (name, properties = {}, context) =>\n      safeSend({\n        type: 'track',\n        context: {\n          url: context.url,\n          path: context.path,\n          referrer: context.referrer,\n        },\n        properties: { ...properties, name },\n      }),\n  };\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_core = require("./core-KgLaVgR4.cjs");
+exports.ANALYTICS_SCHEMA_VERSION = require_core.ANALYTICS_SCHEMA_VERSION;
+exports.EVENT_TYPES = require_core.EVENT_TYPES;
+exports.buildEvent = require_core.buildEvent;
+exports.createClient = require_core.createClient;

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+import { a as createClient, c as BuildEventInput, d as EventType, f as buildEvent, i as SendOptions, l as EVENT_TYPES, n as ClientConfig, o as ANALYTICS_SCHEMA_VERSION, r as PageViewInput, s as AnalyticsEvent, t as AnalyticsClient, u as EventContext } from "./core-DVilpn_i.cjs";
+export { ANALYTICS_SCHEMA_VERSION, AnalyticsClient, AnalyticsEvent, BuildEventInput, ClientConfig, EVENT_TYPES, EventContext, EventType, PageViewInput, SendOptions, buildEvent, createClient };

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { a as createClient, c as BuildEventInput, d as EventType, f as buildEvent, i as SendOptions, l as EVENT_TYPES, n as ClientConfig, o as ANALYTICS_SCHEMA_VERSION, r as PageViewInput, s as AnalyticsEvent, t as AnalyticsClient, u as EventContext } from "./core-DVilpn_i.mjs";
+export { ANALYTICS_SCHEMA_VERSION, AnalyticsClient, AnalyticsEvent, BuildEventInput, ClientConfig, EVENT_TYPES, EventContext, EventType, PageViewInput, SendOptions, buildEvent, createClient };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+import { i as buildEvent, n as ANALYTICS_SCHEMA_VERSION, r as EVENT_TYPES, t as createClient } from "./core-Cvg8zn6Q.mjs";
+export { ANALYTICS_SCHEMA_VERSION, EVENT_TYPES, buildEvent, createClient };

package/dist/matchers-CMwG37qc.cjs

@@ -0,0 +1,18 @@
+//#region src/matchers.ts
+const ASSET_EXT = /\.(?:ico|png|jpe?g|gif|svg|webp|avif|css|js|map|txt|xml|json|woff2?|ttf|eot|mp4|webm)$/i;
+/** Skip framework internals, API routes, and static assets. */
+function shouldTrackPath(pathname) {
+	if (pathname.startsWith("/_next/")) return false;
+	if (pathname.startsWith("/api/")) return false;
+	if (ASSET_EXT.test(pathname)) return false;
+	return true;
+}
+//#endregion
+Object.defineProperty(exports, "shouldTrackPath", {
+	enumerable: true,
+	get: function() {
+		return shouldTrackPath;
+	}
+});
+
+//# sourceMappingURL=matchers-CMwG37qc.cjs.map

package/dist/matchers-CMwG37qc.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers-CMwG37qc.cjs","names":[],"sources":["../src/matchers.ts"],"sourcesContent":["// Default path matcher shared by the next/node/cloudflare adapters.\n\nconst ASSET_EXT =\n  /\\.(?:ico|png|jpe?g|gif|svg|webp|avif|css|js|map|txt|xml|json|woff2?|ttf|eot|mp4|webm)$/i;\n\n/** Skip framework internals, API routes, and static assets. */\nexport function shouldTrackPath(pathname: string): boolean {\n  if (pathname.startsWith('/_next/')) return false;\n  if (pathname.startsWith('/api/')) return false;\n  if (ASSET_EXT.test(pathname)) return false;\n  return true;\n}\n"],"mappings":";AAEA,MAAM,YACJ;;AAGF,SAAgB,gBAAgB,UAA2B;CACzD,IAAI,SAAS,WAAW,SAAS,GAAG,OAAO;CAC3C,IAAI,SAAS,WAAW,OAAO,GAAG,OAAO;CACzC,IAAI,UAAU,KAAK,QAAQ,GAAG,OAAO;CACrC,OAAO;AACT"}

package/dist/matchers-CUD5NL5K.mjs

@@ -0,0 +1,13 @@
+//#region src/matchers.ts
+const ASSET_EXT = /\.(?:ico|png|jpe?g|gif|svg|webp|avif|css|js|map|txt|xml|json|woff2?|ttf|eot|mp4|webm)$/i;
+/** Skip framework internals, API routes, and static assets. */
+function shouldTrackPath(pathname) {
+	if (pathname.startsWith("/_next/")) return false;
+	if (pathname.startsWith("/api/")) return false;
+	if (ASSET_EXT.test(pathname)) return false;
+	return true;
+}
+//#endregion
+export { shouldTrackPath as t };
+
+//# sourceMappingURL=matchers-CUD5NL5K.mjs.map

package/dist/matchers-CUD5NL5K.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchers-CUD5NL5K.mjs","names":[],"sources":["../src/matchers.ts"],"sourcesContent":["// Default path matcher shared by the next/node/cloudflare adapters.\n\nconst ASSET_EXT =\n  /\\.(?:ico|png|jpe?g|gif|svg|webp|avif|css|js|map|txt|xml|json|woff2?|ttf|eot|mp4|webm)$/i;\n\n/** Skip framework internals, API routes, and static assets. */\nexport function shouldTrackPath(pathname: string): boolean {\n  if (pathname.startsWith('/_next/')) return false;\n  if (pathname.startsWith('/api/')) return false;\n  if (ASSET_EXT.test(pathname)) return false;\n  return true;\n}\n"],"mappings":";AAEA,MAAM,YACJ;;AAGF,SAAgB,gBAAgB,UAA2B;CACzD,IAAI,SAAS,WAAW,SAAS,GAAG,OAAO;CAC3C,IAAI,SAAS,WAAW,OAAO,GAAG,OAAO;CACzC,IAAI,UAAU,KAAK,QAAQ,GAAG,OAAO;CACrC,OAAO;AACT"}

package/dist/next.cjs

@@ -0,0 +1,39 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_core = require("./core-KgLaVgR4.cjs");
+const require_matchers = require("./matchers-CMwG37qc.cjs");
+//#region src/next.ts
+function extractRequestData(req) {
+	const ip = (req.headers.get("x-forwarded-for") ?? "").split(",")[0]?.trim() || void 0;
+	return {
+		url: req.nextUrl.href || req.url,
+		path: req.nextUrl.pathname,
+		referrer: req.headers.get("referer") ?? void 0,
+		userAgent: req.headers.get("user-agent") ?? void 0,
+		ip
+	};
+}
+/**
+* Returns a fire-and-forget tracker. Call it from your Next middleware:
+*   const track = createAnalyticsMiddleware({ writeKey, domain: 'example.com' });
+*   export function middleware(req, event) { track(req, event); return NextResponse.next(); }
+*/
+function createAnalyticsMiddleware(config) {
+	const client = require_core.createClient({
+		...config,
+		keepalive: false
+	});
+	const matcher = config.shouldTrack ?? require_matchers.shouldTrackPath;
+	return (req, event) => {
+		try {
+			if (!matcher(req.nextUrl.pathname)) return;
+			const data = extractRequestData(req);
+			event.waitUntil(client.pageView(data));
+		} catch {}
+	};
+}
+//#endregion
+exports.createAnalyticsMiddleware = createAnalyticsMiddleware;
+exports.extractRequestData = extractRequestData;
+exports.shouldTrackPath = require_matchers.shouldTrackPath;
+
+//# sourceMappingURL=next.cjs.map

package/dist/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.cjs","names":["createClient","shouldTrackPath"],"sources":["../src/next.ts"],"sourcesContent":["import { type AnalyticsClient, type ClientConfig, createClient } from './core';\nimport { shouldTrackPath } from './matchers';\n\nexport { shouldTrackPath } from './matchers';\n\n// Minimal structural types — avoids a hard runtime dependency on `next`.\ninterface NextRequestLike {\n  url: string;\n  nextUrl: { pathname: string; href: string };\n  headers: Headers;\n}\ninterface FetchEventLike {\n  waitUntil(promise: Promise<unknown>): void;\n}\n\nexport interface RequestData {\n  url: string;\n  path: string;\n  referrer?: string;\n  userAgent?: string;\n  ip?: string;\n}\n\nexport function extractRequestData(req: NextRequestLike): RequestData {\n  const xff = req.headers.get('x-forwarded-for') ?? '';\n  const ip = xff.split(',')[0]?.trim() || undefined;\n  return {\n    url: req.nextUrl.href || req.url,\n    path: req.nextUrl.pathname,\n    referrer: req.headers.get('referer') ?? undefined,\n    userAgent: req.headers.get('user-agent') ?? undefined,\n    ip,\n  };\n}\n\nexport interface MiddlewareConfig extends ClientConfig {\n  /** Override the default path matcher. */\n  shouldTrack?: (pathname: string) => boolean;\n}\n\n/**\n * Returns a fire-and-forget tracker. Call it from your Next middleware:\n *   const track = createAnalyticsMiddleware({ writeKey, domain: 'example.com' });\n *   export function middleware(req, event) { track(req, event); return NextResponse.next(); }\n */\nexport function createAnalyticsMiddleware(\n  config: MiddlewareConfig,\n): (req: NextRequestLike, event: FetchEventLike) => void {\n  // dispatch rides event.waitUntil — keepalive off, like the Cloudflare adapter\n  const client: AnalyticsClient = createClient({ ...config, keepalive: false });\n  const matcher = config.shouldTrack ?? shouldTrackPath;\n\n  return (req, event) => {\n    try {\n      if (!matcher(req.nextUrl.pathname)) return;\n      const data = extractRequestData(req);\n      event.waitUntil(client.pageView(data));\n    } catch {\n      // never block the request\n    }\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,mBAAmB,KAAmC;CAEpE,MAAM,MADM,IAAI,QAAQ,IAAI,iBAAiB,KAAK,GAAA,CACnC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,KAAK,KAAA;CACxC,OAAO;EACL,KAAK,IAAI,QAAQ,QAAQ,IAAI;EAC7B,MAAM,IAAI,QAAQ;EAClB,UAAU,IAAI,QAAQ,IAAI,SAAS,KAAK,KAAA;EACxC,WAAW,IAAI,QAAQ,IAAI,YAAY,KAAK,KAAA;EAC5C;CACF;AACF;;;;;;AAYA,SAAgB,0BACd,QACuD;CAEvD,MAAM,SAA0BA,aAAAA,aAAa;EAAE,GAAG;EAAQ,WAAW;CAAM,CAAC;CAC5E,MAAM,UAAU,OAAO,eAAeC,iBAAAA;CAEtC,QAAQ,KAAK,UAAU;EACrB,IAAI;GACF,IAAI,CAAC,QAAQ,IAAI,QAAQ,QAAQ,GAAG;GACpC,MAAM,OAAO,mBAAmB,GAAG;GACnC,MAAM,UAAU,OAAO,SAAS,IAAI,CAAC;EACvC,QAAQ,CAER;CACF;AACF"}

package/dist/next.d.cts

@@ -0,0 +1,39 @@
+import { n as ClientConfig } from "./core-DVilpn_i.cjs";
+
+//#region src/matchers.d.ts
+/** Skip framework internals, API routes, and static assets. */
+declare function shouldTrackPath(pathname: string): boolean;
+//#endregion
+//#region src/next.d.ts
+interface NextRequestLike {
+  url: string;
+  nextUrl: {
+    pathname: string;
+    href: string;
+  };
+  headers: Headers;
+}
+interface FetchEventLike {
+  waitUntil(promise: Promise<unknown>): void;
+}
+interface RequestData {
+  url: string;
+  path: string;
+  referrer?: string;
+  userAgent?: string;
+  ip?: string;
+}
+declare function extractRequestData(req: NextRequestLike): RequestData;
+interface MiddlewareConfig extends ClientConfig {
+  /** Override the default path matcher. */
+  shouldTrack?: (pathname: string) => boolean;
+}
+/**
+ * Returns a fire-and-forget tracker. Call it from your Next middleware:
+ *   const track = createAnalyticsMiddleware({ writeKey, domain: 'example.com' });
+ *   export function middleware(req, event) { track(req, event); return NextResponse.next(); }
+ */
+declare function createAnalyticsMiddleware(config: MiddlewareConfig): (req: NextRequestLike, event: FetchEventLike) => void;
+//#endregion
+export { MiddlewareConfig, RequestData, createAnalyticsMiddleware, extractRequestData, shouldTrackPath };
+//# sourceMappingURL=next.d.cts.map

package/dist/next.d.mts

@@ -0,0 +1,39 @@
+import { n as ClientConfig } from "./core-DVilpn_i.mjs";
+
+//#region src/matchers.d.ts
+/** Skip framework internals, API routes, and static assets. */
+declare function shouldTrackPath(pathname: string): boolean;
+//#endregion
+//#region src/next.d.ts
+interface NextRequestLike {
+  url: string;
+  nextUrl: {
+    pathname: string;
+    href: string;
+  };
+  headers: Headers;
+}
+interface FetchEventLike {
+  waitUntil(promise: Promise<unknown>): void;
+}
+interface RequestData {
+  url: string;
+  path: string;
+  referrer?: string;
+  userAgent?: string;
+  ip?: string;
+}
+declare function extractRequestData(req: NextRequestLike): RequestData;
+interface MiddlewareConfig extends ClientConfig {
+  /** Override the default path matcher. */
+  shouldTrack?: (pathname: string) => boolean;
+}
+/**
+ * Returns a fire-and-forget tracker. Call it from your Next middleware:
+ *   const track = createAnalyticsMiddleware({ writeKey, domain: 'example.com' });
+ *   export function middleware(req, event) { track(req, event); return NextResponse.next(); }
+ */
+declare function createAnalyticsMiddleware(config: MiddlewareConfig): (req: NextRequestLike, event: FetchEventLike) => void;
+//#endregion
+export { MiddlewareConfig, RequestData, createAnalyticsMiddleware, extractRequestData, shouldTrackPath };
+//# sourceMappingURL=next.d.mts.map

package/dist/next.mjs

@@ -0,0 +1,36 @@
+import { t as createClient } from "./core-Cvg8zn6Q.mjs";
+import { t as shouldTrackPath } from "./matchers-CUD5NL5K.mjs";
+//#region src/next.ts
+function extractRequestData(req) {
+	const ip = (req.headers.get("x-forwarded-for") ?? "").split(",")[0]?.trim() || void 0;
+	return {
+		url: req.nextUrl.href || req.url,
+		path: req.nextUrl.pathname,
+		referrer: req.headers.get("referer") ?? void 0,
+		userAgent: req.headers.get("user-agent") ?? void 0,
+		ip
+	};
+}
+/**
+* Returns a fire-and-forget tracker. Call it from your Next middleware:
+*   const track = createAnalyticsMiddleware({ writeKey, domain: 'example.com' });
+*   export function middleware(req, event) { track(req, event); return NextResponse.next(); }
+*/
+function createAnalyticsMiddleware(config) {
+	const client = createClient({
+		...config,
+		keepalive: false
+	});
+	const matcher = config.shouldTrack ?? shouldTrackPath;
+	return (req, event) => {
+		try {
+			if (!matcher(req.nextUrl.pathname)) return;
+			const data = extractRequestData(req);
+			event.waitUntil(client.pageView(data));
+		} catch {}
+	};
+}
+//#endregion
+export { createAnalyticsMiddleware, extractRequestData, shouldTrackPath };
+
+//# sourceMappingURL=next.mjs.map

package/dist/next.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.mjs","names":[],"sources":["../src/next.ts"],"sourcesContent":["import { type AnalyticsClient, type ClientConfig, createClient } from './core';\nimport { shouldTrackPath } from './matchers';\n\nexport { shouldTrackPath } from './matchers';\n\n// Minimal structural types — avoids a hard runtime dependency on `next`.\ninterface NextRequestLike {\n  url: string;\n  nextUrl: { pathname: string; href: string };\n  headers: Headers;\n}\ninterface FetchEventLike {\n  waitUntil(promise: Promise<unknown>): void;\n}\n\nexport interface RequestData {\n  url: string;\n  path: string;\n  referrer?: string;\n  userAgent?: string;\n  ip?: string;\n}\n\nexport function extractRequestData(req: NextRequestLike): RequestData {\n  const xff = req.headers.get('x-forwarded-for') ?? '';\n  const ip = xff.split(',')[0]?.trim() || undefined;\n  return {\n    url: req.nextUrl.href || req.url,\n    path: req.nextUrl.pathname,\n    referrer: req.headers.get('referer') ?? undefined,\n    userAgent: req.headers.get('user-agent') ?? undefined,\n    ip,\n  };\n}\n\nexport interface MiddlewareConfig extends ClientConfig {\n  /** Override the default path matcher. */\n  shouldTrack?: (pathname: string) => boolean;\n}\n\n/**\n * Returns a fire-and-forget tracker. Call it from your Next middleware:\n *   const track = createAnalyticsMiddleware({ writeKey, domain: 'example.com' });\n *   export function middleware(req, event) { track(req, event); return NextResponse.next(); }\n */\nexport function createAnalyticsMiddleware(\n  config: MiddlewareConfig,\n): (req: NextRequestLike, event: FetchEventLike) => void {\n  // dispatch rides event.waitUntil — keepalive off, like the Cloudflare adapter\n  const client: AnalyticsClient = createClient({ ...config, keepalive: false });\n  const matcher = config.shouldTrack ?? shouldTrackPath;\n\n  return (req, event) => {\n    try {\n      if (!matcher(req.nextUrl.pathname)) return;\n      const data = extractRequestData(req);\n      event.waitUntil(client.pageView(data));\n    } catch {\n      // never block the request\n    }\n  };\n}\n"],"mappings":";;;AAuBA,SAAgB,mBAAmB,KAAmC;CAEpE,MAAM,MADM,IAAI,QAAQ,IAAI,iBAAiB,KAAK,GAAA,CACnC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,KAAK,KAAA;CACxC,OAAO;EACL,KAAK,IAAI,QAAQ,QAAQ,IAAI;EAC7B,MAAM,IAAI,QAAQ;EAClB,UAAU,IAAI,QAAQ,IAAI,SAAS,KAAK,KAAA;EACxC,WAAW,IAAI,QAAQ,IAAI,YAAY,KAAK,KAAA;EAC5C;CACF;AACF;;;;;;AAYA,SAAgB,0BACd,QACuD;CAEvD,MAAM,SAA0B,aAAa;EAAE,GAAG;EAAQ,WAAW;CAAM,CAAC;CAC5E,MAAM,UAAU,OAAO,eAAe;CAEtC,QAAQ,KAAK,UAAU;EACrB,IAAI;GACF,IAAI,CAAC,QAAQ,IAAI,QAAQ,QAAQ,GAAG;GACpC,MAAM,OAAO,mBAAmB,GAAG;GACnC,MAAM,UAAU,OAAO,SAAS,IAAI,CAAC;EACvC,QAAQ,CAER;CACF;AACF"}