@reopt-ai/data-contract 0.6.3 → 0.7.0

package/dist/events-BUIeU60t.d.cts

@@ -0,0 +1,142 @@
+//#region src/events.d.ts
+/**
+ * `@reopt-ai/data-contract/events` — event names and property keys, with no
+ * zod. Browser SDKs import this so their production bundles stay free of
+ * schema code; `./ingest` re-exports everything here.
+ */
+/** Event names the pipeline reserves for its own session bookkeeping. */
+declare const RESERVED_EVENT_NAMES: readonly ["session_start", "session_end", "screen_view"];
+/**
+ * Events the SDKs emit on their own. One declaration, so a consumer that
+ * registers them in its event catalogue (to make them roll up) cannot drift
+ * from what the SDK actually sends — a drifted name silently falls back to
+ * raw queries, which is slower but not visibly wrong.
+ */
+declare const AUTO_EVENT_NAMES: {
+  readonly pageview: "$pageview";
+  readonly screenView: "$screen_view";
+  readonly pageleave: "$pageleave";
+  readonly webVitals: "$web_vitals";
+  readonly exception: "$exception";
+};
+type AutoEventName = (typeof AUTO_EVENT_NAMES)[keyof typeof AUTO_EVENT_NAMES];
+/**
+ * Property keys each automatic event carries. Consumers derive their
+ * breakdown / rollup property lists from here rather than retyping them.
+ * `path`, `origin`, `referrer` and `utm_*` are the keys the ingest pipeline
+ * reads into session and event columns.
+ */
+declare const AUTO_EVENT_PROPERTIES: {
+  readonly $pageview: readonly ["path", "origin", "title", "referrer", "search", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+  readonly $screen_view: readonly ["screen_name"];
+  readonly $pageleave: readonly ["path", "origin", "duration", "scroll_depth", "scroll_depth_bucket"];
+  readonly $web_vitals: readonly ["metric_name", "metric_id", "value", "delta", "rating", "navigation_type", "path"];
+  readonly $exception: readonly ["$exception_type", "$exception_message", "$exception_stack", "$exception_source", "$exception_handled", "$exception_list", "$exception_level", "$exception_fingerprint", "$exception_steps", "path"];
+};
+/**
+ * The subset of {@link AUTO_EVENT_PROPERTIES} that is a sensible rollup
+ * dimension: low cardinality, categorical. Per-measurement ids and
+ * continuous values (`metric_id`, `value`, `delta`, `duration`,
+ * `scroll_depth`) are deliberately absent — as dimensions they would make
+ * the rollup larger than the raw table it summarises. Derive
+ * `rollupProperties` from here, not from the full property list.
+ */
+declare const AUTO_EVENT_ROLLUP_KEYS: {
+  readonly $pageview: readonly ["path", "origin", "referrer", "utm_source", "utm_medium", "utm_campaign"];
+  readonly $screen_view: readonly ["screen_name"];
+  readonly $pageleave: readonly ["path", "origin", "scroll_depth_bucket"];
+  readonly $web_vitals: readonly ["metric_name", "rating", "navigation_type", "path"];
+  readonly $exception: readonly ["$exception_type", "$exception_source", "$exception_handled", "path", "$exception_fingerprint"];
+};
+/**
+ * How deep a `cause` chain is carried, and how many frames of each exception.
+ *
+ * Both caps are part of the contract rather than each SDK's own opinion: the
+ * server fingerprints exactly what it receives, so a client that sent more
+ * frames than the server hashes would group differently from one that sent
+ * fewer, for the same error.
+ */
+/**
+ * The property carrying the host's build identity.
+ *
+ * Not in {@link AUTO_EVENT_PROPERTIES}: it is not specific to any automatic
+ * event — every event the SDK sends carries it once `release` is configured,
+ * the same way a global property does. Error tracking is what reads it, to say
+ * which build an issue first and last appeared in and whether a fix held.
+ */
+declare const RELEASE_PROPERTY = "$release_id";
+declare const MAX_EXCEPTION_CHAIN = 4;
+declare const MAX_EXCEPTION_FRAMES = 50;
+/**
+ * One stack frame, in the shape OTel and Sentry both use.
+ *
+ * snake_case because it is a wire format, not a JS object — renaming these on
+ * the way in or out is how two SDKs end up disagreeing about the same frame.
+ */
+interface ExceptionFrame {
+  /** The file the frame ran in. Absent for a frame no parser could place. */
+  filename?: string;
+  /** Empty or absent for an anonymous frame. */
+  function?: string;
+  /** Dotted module path, where the runtime has one. */
+  module?: string;
+  lineno?: number;
+  colno?: number;
+  /**
+   * The frame belongs to the app rather than a dependency, the runtime, or a
+   * browser extension. Drives the stack panel's default filter, and V1
+   * fingerprinting.
+   */
+  in_app?: boolean;
+  /**
+   * A source map resolved `function` to its original name. Fingerprinting then
+   * drops line and column, because a resolved name survives a rebuild that
+   * shifts them.
+   */
+  resolved?: boolean;
+  /** Source context, when a symbolication step has it (WS-E). */
+  context_line?: string;
+  pre_context?: string[];
+  post_context?: string[];
+  /** Build-injected chunk id, so a source map can be matched without the URL. */
+  chunk_id?: string;
+}
+/** Where an exception came from, and whether anyone caught it. */
+interface ExceptionMechanism {
+  /** False means nothing caught it — the error reached the runtime's handler. */
+  handled: boolean;
+  type: "onerror" | "unhandledrejection" | "manual" | "console" | "nextjs_onRequestError";
+  /** The Error was constructed by the SDK to carry a non-Error throw. */
+  synthetic?: boolean;
+}
+/** One exception in a cause chain. */
+interface ExceptionEntry {
+  type: string;
+  value: string;
+  mechanism: ExceptionMechanism;
+  stacktrace?: {
+    frames: ExceptionFrame[];
+    /** `raw` means the frames are as the engine reported them — not symbolicated. */
+    type: "raw";
+  };
+}
+/** A breadcrumb leading up to an exception (A5). */
+interface ExceptionStep {
+  /** Epoch milliseconds. */
+  timestamp: number;
+  category: "navigation" | "click" | "fetch" | "console" | "custom";
+  message: string;
+  data?: Record<string, unknown>;
+}
+type ExceptionLevel = "fatal" | "error" | "warning" | "info";
+/**
+ * `$pageleave.scroll_depth` is the exact 0–100 percentage; `scroll_depth_bucket`
+ * is the deepest of these thresholds reached, as a string — the value to
+ * break down by. `"0"` means the visitor never reached the first threshold.
+ */
+declare const SCROLL_DEPTH_BUCKETS: readonly [25, 50, 75, 100];
+type ScrollDepthBucket = "0" | `${(typeof SCROLL_DEPTH_BUCKETS)[number]}`;
+declare function scrollDepthBucket(depth: number): ScrollDepthBucket;
+//#endregion
+export { ExceptionEntry as a, ExceptionMechanism as c, MAX_EXCEPTION_FRAMES as d, RELEASE_PROPERTY as f, scrollDepthBucket as g, ScrollDepthBucket as h, AutoEventName as i, ExceptionStep as l, SCROLL_DEPTH_BUCKETS as m, AUTO_EVENT_PROPERTIES as n, ExceptionFrame as o, RESERVED_EVENT_NAMES as p, AUTO_EVENT_ROLLUP_KEYS as r, ExceptionLevel as s, AUTO_EVENT_NAMES as t, MAX_EXCEPTION_CHAIN as u };
+//# sourceMappingURL=events-BUIeU60t.d.cts.map

package/dist/events-BUIeU60t.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-BUIeU60t.d.cts","names":[],"sources":["../src/events.ts"],"mappings":";;;;;;;cAOa;;;;;;;cAQA;;;;;;;KAOD,wBAAwB,+BAA+B;;;;;;;cAQtD;;;;;;;;;;;;;;;cA2CA;;;;;;;;;;;;;;;;;;;;;;;cAwCA;cAEA;cACA;;;;;;;UAQI;;EAEf;;EAEA;;EAEA;EACA;EACA;;;;;;EAMA;;;;;;EAMA;;EAEA;EACA;EACA;;EAEA;;;UAIe;;EAEf;EACA;;EAEA;;;UAIe;EACf;EACA;EACA,WAAW;EACX;IACE,QAAQ;;IAER;;;;UAKa;;EAEf;EACA;EACA;EACA,OAAO;;KAGG;;;;;;cAOC;KACD,qCAAqC;iBAEjC,kBAAkB,gBAAgB"}

package/dist/events-BUIeU60t.d.ts

@@ -0,0 +1,142 @@
+//#region src/events.d.ts
+/**
+ * `@reopt-ai/data-contract/events` — event names and property keys, with no
+ * zod. Browser SDKs import this so their production bundles stay free of
+ * schema code; `./ingest` re-exports everything here.
+ */
+/** Event names the pipeline reserves for its own session bookkeeping. */
+declare const RESERVED_EVENT_NAMES: readonly ["session_start", "session_end", "screen_view"];
+/**
+ * Events the SDKs emit on their own. One declaration, so a consumer that
+ * registers them in its event catalogue (to make them roll up) cannot drift
+ * from what the SDK actually sends — a drifted name silently falls back to
+ * raw queries, which is slower but not visibly wrong.
+ */
+declare const AUTO_EVENT_NAMES: {
+  readonly pageview: "$pageview";
+  readonly screenView: "$screen_view";
+  readonly pageleave: "$pageleave";
+  readonly webVitals: "$web_vitals";
+  readonly exception: "$exception";
+};
+type AutoEventName = (typeof AUTO_EVENT_NAMES)[keyof typeof AUTO_EVENT_NAMES];
+/**
+ * Property keys each automatic event carries. Consumers derive their
+ * breakdown / rollup property lists from here rather than retyping them.
+ * `path`, `origin`, `referrer` and `utm_*` are the keys the ingest pipeline
+ * reads into session and event columns.
+ */
+declare const AUTO_EVENT_PROPERTIES: {
+  readonly $pageview: readonly ["path", "origin", "title", "referrer", "search", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+  readonly $screen_view: readonly ["screen_name"];
+  readonly $pageleave: readonly ["path", "origin", "duration", "scroll_depth", "scroll_depth_bucket"];
+  readonly $web_vitals: readonly ["metric_name", "metric_id", "value", "delta", "rating", "navigation_type", "path"];
+  readonly $exception: readonly ["$exception_type", "$exception_message", "$exception_stack", "$exception_source", "$exception_handled", "$exception_list", "$exception_level", "$exception_fingerprint", "$exception_steps", "path"];
+};
+/**
+ * The subset of {@link AUTO_EVENT_PROPERTIES} that is a sensible rollup
+ * dimension: low cardinality, categorical. Per-measurement ids and
+ * continuous values (`metric_id`, `value`, `delta`, `duration`,
+ * `scroll_depth`) are deliberately absent — as dimensions they would make
+ * the rollup larger than the raw table it summarises. Derive
+ * `rollupProperties` from here, not from the full property list.
+ */
+declare const AUTO_EVENT_ROLLUP_KEYS: {
+  readonly $pageview: readonly ["path", "origin", "referrer", "utm_source", "utm_medium", "utm_campaign"];
+  readonly $screen_view: readonly ["screen_name"];
+  readonly $pageleave: readonly ["path", "origin", "scroll_depth_bucket"];
+  readonly $web_vitals: readonly ["metric_name", "rating", "navigation_type", "path"];
+  readonly $exception: readonly ["$exception_type", "$exception_source", "$exception_handled", "path", "$exception_fingerprint"];
+};
+/**
+ * How deep a `cause` chain is carried, and how many frames of each exception.
+ *
+ * Both caps are part of the contract rather than each SDK's own opinion: the
+ * server fingerprints exactly what it receives, so a client that sent more
+ * frames than the server hashes would group differently from one that sent
+ * fewer, for the same error.
+ */
+/**
+ * The property carrying the host's build identity.
+ *
+ * Not in {@link AUTO_EVENT_PROPERTIES}: it is not specific to any automatic
+ * event — every event the SDK sends carries it once `release` is configured,
+ * the same way a global property does. Error tracking is what reads it, to say
+ * which build an issue first and last appeared in and whether a fix held.
+ */
+declare const RELEASE_PROPERTY = "$release_id";
+declare const MAX_EXCEPTION_CHAIN = 4;
+declare const MAX_EXCEPTION_FRAMES = 50;
+/**
+ * One stack frame, in the shape OTel and Sentry both use.
+ *
+ * snake_case because it is a wire format, not a JS object — renaming these on
+ * the way in or out is how two SDKs end up disagreeing about the same frame.
+ */
+interface ExceptionFrame {
+  /** The file the frame ran in. Absent for a frame no parser could place. */
+  filename?: string;
+  /** Empty or absent for an anonymous frame. */
+  function?: string;
+  /** Dotted module path, where the runtime has one. */
+  module?: string;
+  lineno?: number;
+  colno?: number;
+  /**
+   * The frame belongs to the app rather than a dependency, the runtime, or a
+   * browser extension. Drives the stack panel's default filter, and V1
+   * fingerprinting.
+   */
+  in_app?: boolean;
+  /**
+   * A source map resolved `function` to its original name. Fingerprinting then
+   * drops line and column, because a resolved name survives a rebuild that
+   * shifts them.
+   */
+  resolved?: boolean;
+  /** Source context, when a symbolication step has it (WS-E). */
+  context_line?: string;
+  pre_context?: string[];
+  post_context?: string[];
+  /** Build-injected chunk id, so a source map can be matched without the URL. */
+  chunk_id?: string;
+}
+/** Where an exception came from, and whether anyone caught it. */
+interface ExceptionMechanism {
+  /** False means nothing caught it — the error reached the runtime's handler. */
+  handled: boolean;
+  type: "onerror" | "unhandledrejection" | "manual" | "console" | "nextjs_onRequestError";
+  /** The Error was constructed by the SDK to carry a non-Error throw. */
+  synthetic?: boolean;
+}
+/** One exception in a cause chain. */
+interface ExceptionEntry {
+  type: string;
+  value: string;
+  mechanism: ExceptionMechanism;
+  stacktrace?: {
+    frames: ExceptionFrame[];
+    /** `raw` means the frames are as the engine reported them — not symbolicated. */
+    type: "raw";
+  };
+}
+/** A breadcrumb leading up to an exception (A5). */
+interface ExceptionStep {
+  /** Epoch milliseconds. */
+  timestamp: number;
+  category: "navigation" | "click" | "fetch" | "console" | "custom";
+  message: string;
+  data?: Record<string, unknown>;
+}
+type ExceptionLevel = "fatal" | "error" | "warning" | "info";
+/**
+ * `$pageleave.scroll_depth` is the exact 0–100 percentage; `scroll_depth_bucket`
+ * is the deepest of these thresholds reached, as a string — the value to
+ * break down by. `"0"` means the visitor never reached the first threshold.
+ */
+declare const SCROLL_DEPTH_BUCKETS: readonly [25, 50, 75, 100];
+type ScrollDepthBucket = "0" | `${(typeof SCROLL_DEPTH_BUCKETS)[number]}`;
+declare function scrollDepthBucket(depth: number): ScrollDepthBucket;
+//#endregion
+export { ExceptionEntry as a, ExceptionMechanism as c, MAX_EXCEPTION_FRAMES as d, RELEASE_PROPERTY as f, scrollDepthBucket as g, ScrollDepthBucket as h, AutoEventName as i, ExceptionStep as l, SCROLL_DEPTH_BUCKETS as m, AUTO_EVENT_PROPERTIES as n, ExceptionFrame as o, RESERVED_EVENT_NAMES as p, AUTO_EVENT_ROLLUP_KEYS as r, ExceptionLevel as s, AUTO_EVENT_NAMES as t, MAX_EXCEPTION_CHAIN as u };
+//# sourceMappingURL=events-BUIeU60t.d.ts.map

package/dist/events-BUIeU60t.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events-BUIeU60t.d.ts","names":[],"sources":["../src/events.ts"],"mappings":";;;;;;;cAOa;;;;;;;cAQA;;;;;;;KAOD,wBAAwB,+BAA+B;;;;;;;cAQtD;;;;;;;;;;;;;;;cA2CA;;;;;;;;;;;;;;;;;;;;;;;cAwCA;cAEA;cACA;;;;;;;UAQI;;EAEf;;EAEA;;EAEA;EACA;EACA;;;;;;EAMA;;;;;;EAMA;;EAEA;EACA;EACA;;EAEA;;;UAIe;;EAEf;EACA;;EAEA;;;UAIe;EACf;EACA;EACA,WAAW;EACX;IACE,QAAQ;;IAER;;;;UAKa;;EAEf;EACA;EACA;EACA,OAAO;;KAGG;;;;;;cAOC;KACD,qCAAqC;iBAEjC,kBAAkB,gBAAgB"}

package/dist/events.cjs

@@ -1,17 +1,112 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/events.ts
+const RESERVED_EVENT_NAMES = [
+	"session_start",
+	"session_end",
+	"screen_view"
+];
+const AUTO_EVENT_NAMES = {
+	pageview: "$pageview",
+	screenView: "$screen_view",
+	pageleave: "$pageleave",
+	webVitals: "$web_vitals",
+	exception: "$exception"
+};
+const AUTO_EVENT_PROPERTIES = {
+	[AUTO_EVENT_NAMES.pageview]: [
+		"path",
+		"origin",
+		"title",
+		"referrer",
+		"search",
+		"utm_source",
+		"utm_medium",
+		"utm_campaign",
+		"utm_term",
+		"utm_content"
+	],
+	[AUTO_EVENT_NAMES.screenView]: ["screen_name"],
+	[AUTO_EVENT_NAMES.pageleave]: [
+		"path",
+		"origin",
+		"duration",
+		"scroll_depth",
+		"scroll_depth_bucket"
+	],
+	[AUTO_EVENT_NAMES.webVitals]: [
+		"metric_name",
+		"metric_id",
+		"value",
+		"delta",
+		"rating",
+		"navigation_type",
+		"path"
+	],
+	[AUTO_EVENT_NAMES.exception]: [
+		"$exception_type",
+		"$exception_message",
+		"$exception_stack",
+		"$exception_source",
+		"$exception_handled",
+		"$exception_list",
+		"$exception_level",
+		"$exception_fingerprint",
+		"$exception_steps",
+		"path"
+	]
+};
+const AUTO_EVENT_ROLLUP_KEYS = {
+	[AUTO_EVENT_NAMES.pageview]: [
+		"path",
+		"origin",
+		"referrer",
+		"utm_source",
+		"utm_medium",
+		"utm_campaign"
+	],
+	[AUTO_EVENT_NAMES.screenView]: ["screen_name"],
+	[AUTO_EVENT_NAMES.pageleave]: [
+		"path",
+		"origin",
+		"scroll_depth_bucket"
+	],
+	[AUTO_EVENT_NAMES.webVitals]: [
+		"metric_name",
+		"rating",
+		"navigation_type",
+		"path"
+	],
+	[AUTO_EVENT_NAMES.exception]: [
+		"$exception_type",
+		"$exception_source",
+		"$exception_handled",
+		"path",
+		"$exception_fingerprint"
+	]
+};
+const RELEASE_PROPERTY = "$release_id";
+const MAX_EXCEPTION_CHAIN = 4;
+const MAX_EXCEPTION_FRAMES = 50;
+const SCROLL_DEPTH_BUCKETS = [
+	25,
+	50,
+	75,
+	100
+];
+function scrollDepthBucket(depth) {
+	let reached = "0";
+	for (const threshold of SCROLL_DEPTH_BUCKETS) if (depth >= threshold) reached = `${threshold}`;
+	return reached;
+}
+//#endregion
+exports.AUTO_EVENT_NAMES = AUTO_EVENT_NAMES;
+exports.AUTO_EVENT_PROPERTIES = AUTO_EVENT_PROPERTIES;
+exports.AUTO_EVENT_ROLLUP_KEYS = AUTO_EVENT_ROLLUP_KEYS;
+exports.MAX_EXCEPTION_CHAIN = MAX_EXCEPTION_CHAIN;
+exports.MAX_EXCEPTION_FRAMES = MAX_EXCEPTION_FRAMES;
+exports.RELEASE_PROPERTY = RELEASE_PROPERTY;
+exports.RESERVED_EVENT_NAMES = RESERVED_EVENT_NAMES;
+exports.SCROLL_DEPTH_BUCKETS = SCROLL_DEPTH_BUCKETS;
+exports.scrollDepthBucket = scrollDepthBucket;
 
-
-
-
-
-
-var _chunk3EEANNYNcjs = require('./chunk-3EEANNYN.cjs');
-
-
-
-
-
-
-
-exports.AUTO_EVENT_NAMES = _chunk3EEANNYNcjs.AUTO_EVENT_NAMES; exports.AUTO_EVENT_PROPERTIES = _chunk3EEANNYNcjs.AUTO_EVENT_PROPERTIES; exports.AUTO_EVENT_ROLLUP_KEYS = _chunk3EEANNYNcjs.AUTO_EVENT_ROLLUP_KEYS; exports.RESERVED_EVENT_NAMES = _chunk3EEANNYNcjs.RESERVED_EVENT_NAMES; exports.SCROLL_DEPTH_BUCKETS = _chunk3EEANNYNcjs.SCROLL_DEPTH_BUCKETS; exports.scrollDepthBucket = _chunk3EEANNYNcjs.scrollDepthBucket;
 //# sourceMappingURL=events.cjs.map

package/dist/events.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/events.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACF,iaAAC","file":"/Users/eric/reopt-ai/reopt-data/packages/data-contract/dist/events.cjs"}
+{"version":3,"file":"events.cjs","names":[],"sources":["../src/events.ts"],"sourcesContent":["/**\n * `@reopt-ai/data-contract/events` — event names and property keys, with no\n * zod. Browser SDKs import this so their production bundles stay free of\n * schema code; `./ingest` re-exports everything here.\n */\n\n/** Event names the pipeline reserves for its own session bookkeeping. */\nexport const RESERVED_EVENT_NAMES = [\"session_start\", \"session_end\", \"screen_view\"] as const;\n\n/**\n * Events the SDKs emit on their own. One declaration, so a consumer that\n * registers them in its event catalogue (to make them roll up) cannot drift\n * from what the SDK actually sends — a drifted name silently falls back to\n * raw queries, which is slower but not visibly wrong.\n */\nexport const AUTO_EVENT_NAMES = {\n  pageview: \"$pageview\",\n  screenView: \"$screen_view\",\n  pageleave: \"$pageleave\",\n  webVitals: \"$web_vitals\",\n  exception: \"$exception\",\n} as const;\nexport type AutoEventName = (typeof AUTO_EVENT_NAMES)[keyof typeof AUTO_EVENT_NAMES];\n\n/**\n * Property keys each automatic event carries. Consumers derive their\n * breakdown / rollup property lists from here rather than retyping them.\n * `path`, `origin`, `referrer` and `utm_*` are the keys the ingest pipeline\n * reads into session and event columns.\n */\nexport const AUTO_EVENT_PROPERTIES = {\n  [AUTO_EVENT_NAMES.pageview]: [\n    \"path\",\n    \"origin\",\n    \"title\",\n    \"referrer\",\n    \"search\",\n    \"utm_source\",\n    \"utm_medium\",\n    \"utm_campaign\",\n    \"utm_term\",\n    \"utm_content\",\n  ],\n  [AUTO_EVENT_NAMES.screenView]: [\"screen_name\"],\n  [AUTO_EVENT_NAMES.pageleave]: [\"path\", \"origin\", \"duration\", \"scroll_depth\", \"scroll_depth_bucket\"],\n  [AUTO_EVENT_NAMES.webVitals]: [\"metric_name\", \"metric_id\", \"value\", \"delta\", \"rating\", \"navigation_type\", \"path\"],\n  // `$`-prefixed on purpose: these are reserved, SDK-owned keys with fixed\n  // semantics, distinguished from a host's own snake_case vocabulary the\n  // same way the event names are. Not a typo — do not strip the prefix.\n  [AUTO_EVENT_NAMES.exception]: [\n    \"$exception_type\",\n    \"$exception_message\",\n    \"$exception_stack\",\n    \"$exception_source\",\n    \"$exception_handled\",\n    // Structured form. The flat keys above stay for every consumer written\n    // against them, and because V1 fingerprinting and the rollup keys read them.\n    \"$exception_list\",\n    \"$exception_level\",\n    \"$exception_fingerprint\",\n    \"$exception_steps\",\n    \"path\",\n  ],\n} as const satisfies Record<AutoEventName, readonly string[]>;\n\n/**\n * The subset of {@link AUTO_EVENT_PROPERTIES} that is a sensible rollup\n * dimension: low cardinality, categorical. Per-measurement ids and\n * continuous values (`metric_id`, `value`, `delta`, `duration`,\n * `scroll_depth`) are deliberately absent — as dimensions they would make\n * the rollup larger than the raw table it summarises. Derive\n * `rollupProperties` from here, not from the full property list.\n */\nexport const AUTO_EVENT_ROLLUP_KEYS = {\n  [AUTO_EVENT_NAMES.pageview]: [\"path\", \"origin\", \"referrer\", \"utm_source\", \"utm_medium\", \"utm_campaign\"],\n  [AUTO_EVENT_NAMES.screenView]: [\"screen_name\"],\n  [AUTO_EVENT_NAMES.pageleave]: [\"path\", \"origin\", \"scroll_depth_bucket\"],\n  [AUTO_EVENT_NAMES.webVitals]: [\"metric_name\", \"rating\", \"navigation_type\", \"path\"],\n  [AUTO_EVENT_NAMES.exception]: [\n    \"$exception_type\",\n    \"$exception_source\",\n    \"$exception_handled\",\n    \"path\",\n    // The one high-ish cardinality key in this table, and deliberately so: a\n    // fingerprint is one per *issue*, not one per occurrence, so its cardinality\n    // is the size of the issue list — hundreds, where `path` on a busy site is\n    // thousands. Rolling it up is what lets the issue list read a whole month\n    // without scanning every exception event. The per-day `__other__` fold still\n    // applies, and the read refuses the rollup when it has folded (see\n    // `errorFingerprintVolumes`), because a folded fingerprint would report zero\n    // rather than \"unknown\".\n    \"$exception_fingerprint\",\n  ],\n} as const satisfies Record<AutoEventName, readonly string[]>;\n\n// ─── Exceptions ─────────────────────────────────────────────────────────────\n\n/**\n * How deep a `cause` chain is carried, and how many frames of each exception.\n *\n * Both caps are part of the contract rather than each SDK's own opinion: the\n * server fingerprints exactly what it receives, so a client that sent more\n * frames than the server hashes would group differently from one that sent\n * fewer, for the same error.\n */\n/**\n * The property carrying the host's build identity.\n *\n * Not in {@link AUTO_EVENT_PROPERTIES}: it is not specific to any automatic\n * event — every event the SDK sends carries it once `release` is configured,\n * the same way a global property does. Error tracking is what reads it, to say\n * which build an issue first and last appeared in and whether a fix held.\n */\nexport const RELEASE_PROPERTY = \"$release_id\";\n\nexport const MAX_EXCEPTION_CHAIN = 4;\nexport const MAX_EXCEPTION_FRAMES = 50;\n\n/**\n * One stack frame, in the shape OTel and Sentry both use.\n *\n * snake_case because it is a wire format, not a JS object — renaming these on\n * the way in or out is how two SDKs end up disagreeing about the same frame.\n */\nexport interface ExceptionFrame {\n  /** The file the frame ran in. Absent for a frame no parser could place. */\n  filename?: string;\n  /** Empty or absent for an anonymous frame. */\n  function?: string;\n  /** Dotted module path, where the runtime has one. */\n  module?: string;\n  lineno?: number;\n  colno?: number;\n  /**\n   * The frame belongs to the app rather than a dependency, the runtime, or a\n   * browser extension. Drives the stack panel's default filter, and V1\n   * fingerprinting.\n   */\n  in_app?: boolean;\n  /**\n   * A source map resolved `function` to its original name. Fingerprinting then\n   * drops line and column, because a resolved name survives a rebuild that\n   * shifts them.\n   */\n  resolved?: boolean;\n  /** Source context, when a symbolication step has it (WS-E). */\n  context_line?: string;\n  pre_context?: string[];\n  post_context?: string[];\n  /** Build-injected chunk id, so a source map can be matched without the URL. */\n  chunk_id?: string;\n}\n\n/** Where an exception came from, and whether anyone caught it. */\nexport interface ExceptionMechanism {\n  /** False means nothing caught it — the error reached the runtime's handler. */\n  handled: boolean;\n  type: \"onerror\" | \"unhandledrejection\" | \"manual\" | \"console\" | \"nextjs_onRequestError\";\n  /** The Error was constructed by the SDK to carry a non-Error throw. */\n  synthetic?: boolean;\n}\n\n/** One exception in a cause chain. */\nexport interface ExceptionEntry {\n  type: string;\n  value: string;\n  mechanism: ExceptionMechanism;\n  stacktrace?: {\n    frames: ExceptionFrame[];\n    /** `raw` means the frames are as the engine reported them — not symbolicated. */\n    type: \"raw\";\n  };\n}\n\n/** A breadcrumb leading up to an exception (A5). */\nexport interface ExceptionStep {\n  /** Epoch milliseconds. */\n  timestamp: number;\n  category: \"navigation\" | \"click\" | \"fetch\" | \"console\" | \"custom\";\n  message: string;\n  data?: Record<string, unknown>;\n}\n\nexport type ExceptionLevel = \"fatal\" | \"error\" | \"warning\" | \"info\";\n\n/**\n * `$pageleave.scroll_depth` is the exact 0–100 percentage; `scroll_depth_bucket`\n * is the deepest of these thresholds reached, as a string — the value to\n * break down by. `\"0\"` means the visitor never reached the first threshold.\n */\nexport const SCROLL_DEPTH_BUCKETS = [25, 50, 75, 100] as const;\nexport type ScrollDepthBucket = \"0\" | `${(typeof SCROLL_DEPTH_BUCKETS)[number]}`;\n\nexport function scrollDepthBucket(depth: number): ScrollDepthBucket {\n  let reached: ScrollDepthBucket = \"0\";\n  for (const threshold of SCROLL_DEPTH_BUCKETS) {\n    if (depth >= threshold) reached = `${threshold}`;\n  }\n  return reached;\n}\n"],"mappings":";;AAOA,MAAa,uBAAuB;CAAC;CAAiB;CAAe;AAAa;AAQlF,MAAa,mBAAmB;CAC9B,UAAU;CACV,YAAY;CACZ,WAAW;CACX,WAAW;CACX,WAAW;AACb;AASA,MAAa,wBAAwB;EAClC,iBAAiB,WAAW;EAC3B;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;EACC,iBAAiB,aAAa,CAAC,aAAa;EAC5C,iBAAiB,YAAY;EAAC;EAAQ;EAAU;EAAY;EAAgB;CAAqB;EACjG,iBAAiB,YAAY;EAAC;EAAe;EAAa;EAAS;EAAS;EAAU;EAAmB;CAAM;EAI/G,iBAAiB,YAAY;EAC5B;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;CACF;AACF;AAUA,MAAa,yBAAyB;EACnC,iBAAiB,WAAW;EAAC;EAAQ;EAAU;EAAY;EAAc;EAAc;CAAc;EACrG,iBAAiB,aAAa,CAAC,aAAa;EAC5C,iBAAiB,YAAY;EAAC;EAAQ;EAAU;CAAqB;EACrE,iBAAiB,YAAY;EAAC;EAAe;EAAU;EAAmB;CAAM;EAChF,iBAAiB,YAAY;EAC5B;EACA;EACA;EACA;EASA;CACF;AACF;AAoBA,MAAa,mBAAmB;AAEhC,MAAa,sBAAsB;AACnC,MAAa,uBAAuB;AA0EpC,MAAa,uBAAuB;CAAC;CAAI;CAAI;CAAI;AAAG;AAGpD,SAAgB,kBAAkB,OAAkC;CAClE,IAAI,UAA6B;CACjC,KAAK,MAAM,aAAa,sBACtB,IAAI,SAAS,WAAW,UAAU,GAAG;CAEvC,OAAO;AACT"}

package/dist/events.d.cts

@@ -1,59 +1,2 @@
-/**
- * `@reopt-ai/data-contract/events` — event names and property keys, with no
- * zod. Browser SDKs import this so their production bundles stay free of
- * schema code; `./ingest` re-exports everything here.
- */
-/** Event names the pipeline reserves for its own session bookkeeping. */
-declare const RESERVED_EVENT_NAMES: readonly ["session_start", "session_end", "screen_view"];
-/**
- * Events the SDKs emit on their own. One declaration, so a consumer that
- * registers them in its event catalogue (to make them roll up) cannot drift
- * from what the SDK actually sends — a drifted name silently falls back to
- * raw queries, which is slower but not visibly wrong.
- */
-declare const AUTO_EVENT_NAMES: {
-    readonly pageview: "$pageview";
-    readonly screenView: "$screen_view";
-    readonly pageleave: "$pageleave";
-    readonly webVitals: "$web_vitals";
-    readonly exception: "$exception";
-};
-type AutoEventName = (typeof AUTO_EVENT_NAMES)[keyof typeof AUTO_EVENT_NAMES];
-/**
- * Property keys each automatic event carries. Consumers derive their
- * breakdown / rollup property lists from here rather than retyping them.
- * `path`, `origin`, `referrer` and `utm_*` are the keys the ingest pipeline
- * reads into session and event columns.
- */
-declare const AUTO_EVENT_PROPERTIES: {
-    readonly $pageview: readonly ["path", "origin", "title", "referrer", "search", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
-    readonly $screen_view: readonly ["screen_name"];
-    readonly $pageleave: readonly ["path", "origin", "duration", "scroll_depth", "scroll_depth_bucket"];
-    readonly $web_vitals: readonly ["metric_name", "metric_id", "value", "delta", "rating", "navigation_type", "path"];
-    readonly $exception: readonly ["$exception_type", "$exception_message", "$exception_stack", "$exception_source", "$exception_handled", "path"];
-};
-/**
- * The subset of {@link AUTO_EVENT_PROPERTIES} that is a sensible rollup
- * dimension: low cardinality, categorical. Per-measurement ids and
- * continuous values (`metric_id`, `value`, `delta`, `duration`,
- * `scroll_depth`) are deliberately absent — as dimensions they would make
- * the rollup larger than the raw table it summarises. Derive
- * `rollupProperties` from here, not from the full property list.
- */
-declare const AUTO_EVENT_ROLLUP_KEYS: {
-    readonly $pageview: readonly ["path", "origin", "referrer", "utm_source", "utm_medium", "utm_campaign"];
-    readonly $screen_view: readonly ["screen_name"];
-    readonly $pageleave: readonly ["path", "origin", "scroll_depth_bucket"];
-    readonly $web_vitals: readonly ["metric_name", "rating", "navigation_type", "path"];
-    readonly $exception: readonly ["$exception_type", "$exception_source", "$exception_handled", "path"];
-};
-/**
- * `$pageleave.scroll_depth` is the exact 0–100 percentage; `scroll_depth_bucket`
- * is the deepest of these thresholds reached, as a string — the value to
- * break down by. `"0"` means the visitor never reached the first threshold.
- */
-declare const SCROLL_DEPTH_BUCKETS: readonly [25, 50, 75, 100];
-type ScrollDepthBucket = "0" | `${(typeof SCROLL_DEPTH_BUCKETS)[number]}`;
-declare function scrollDepthBucket(depth: number): ScrollDepthBucket;
-
-export { AUTO_EVENT_NAMES, AUTO_EVENT_PROPERTIES, AUTO_EVENT_ROLLUP_KEYS, type AutoEventName, RESERVED_EVENT_NAMES, SCROLL_DEPTH_BUCKETS, type ScrollDepthBucket, scrollDepthBucket };
+import { a as ExceptionEntry, c as ExceptionMechanism, d as MAX_EXCEPTION_FRAMES, f as RELEASE_PROPERTY, g as scrollDepthBucket, h as ScrollDepthBucket, i as AutoEventName, l as ExceptionStep, m as SCROLL_DEPTH_BUCKETS, n as AUTO_EVENT_PROPERTIES, o as ExceptionFrame, p as RESERVED_EVENT_NAMES, r as AUTO_EVENT_ROLLUP_KEYS, s as ExceptionLevel, t as AUTO_EVENT_NAMES, u as MAX_EXCEPTION_CHAIN } from "./events-BUIeU60t.cjs";
+export { AUTO_EVENT_NAMES, AUTO_EVENT_PROPERTIES, AUTO_EVENT_ROLLUP_KEYS, AutoEventName, ExceptionEntry, ExceptionFrame, ExceptionLevel, ExceptionMechanism, ExceptionStep, MAX_EXCEPTION_CHAIN, MAX_EXCEPTION_FRAMES, RELEASE_PROPERTY, RESERVED_EVENT_NAMES, SCROLL_DEPTH_BUCKETS, ScrollDepthBucket, scrollDepthBucket };

package/dist/events.d.ts

@@ -1,59 +1,2 @@
-/**
- * `@reopt-ai/data-contract/events` — event names and property keys, with no
- * zod. Browser SDKs import this so their production bundles stay free of
- * schema code; `./ingest` re-exports everything here.
- */
-/** Event names the pipeline reserves for its own session bookkeeping. */
-declare const RESERVED_EVENT_NAMES: readonly ["session_start", "session_end", "screen_view"];
-/**
- * Events the SDKs emit on their own. One declaration, so a consumer that
- * registers them in its event catalogue (to make them roll up) cannot drift
- * from what the SDK actually sends — a drifted name silently falls back to
- * raw queries, which is slower but not visibly wrong.
- */
-declare const AUTO_EVENT_NAMES: {
-    readonly pageview: "$pageview";
-    readonly screenView: "$screen_view";
-    readonly pageleave: "$pageleave";
-    readonly webVitals: "$web_vitals";
-    readonly exception: "$exception";
-};
-type AutoEventName = (typeof AUTO_EVENT_NAMES)[keyof typeof AUTO_EVENT_NAMES];
-/**
- * Property keys each automatic event carries. Consumers derive their
- * breakdown / rollup property lists from here rather than retyping them.
- * `path`, `origin`, `referrer` and `utm_*` are the keys the ingest pipeline
- * reads into session and event columns.
- */
-declare const AUTO_EVENT_PROPERTIES: {
-    readonly $pageview: readonly ["path", "origin", "title", "referrer", "search", "utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
-    readonly $screen_view: readonly ["screen_name"];
-    readonly $pageleave: readonly ["path", "origin", "duration", "scroll_depth", "scroll_depth_bucket"];
-    readonly $web_vitals: readonly ["metric_name", "metric_id", "value", "delta", "rating", "navigation_type", "path"];
-    readonly $exception: readonly ["$exception_type", "$exception_message", "$exception_stack", "$exception_source", "$exception_handled", "path"];
-};
-/**
- * The subset of {@link AUTO_EVENT_PROPERTIES} that is a sensible rollup
- * dimension: low cardinality, categorical. Per-measurement ids and
- * continuous values (`metric_id`, `value`, `delta`, `duration`,
- * `scroll_depth`) are deliberately absent — as dimensions they would make
- * the rollup larger than the raw table it summarises. Derive
- * `rollupProperties` from here, not from the full property list.
- */
-declare const AUTO_EVENT_ROLLUP_KEYS: {
-    readonly $pageview: readonly ["path", "origin", "referrer", "utm_source", "utm_medium", "utm_campaign"];
-    readonly $screen_view: readonly ["screen_name"];
-    readonly $pageleave: readonly ["path", "origin", "scroll_depth_bucket"];
-    readonly $web_vitals: readonly ["metric_name", "rating", "navigation_type", "path"];
-    readonly $exception: readonly ["$exception_type", "$exception_source", "$exception_handled", "path"];
-};
-/**
- * `$pageleave.scroll_depth` is the exact 0–100 percentage; `scroll_depth_bucket`
- * is the deepest of these thresholds reached, as a string — the value to
- * break down by. `"0"` means the visitor never reached the first threshold.
- */
-declare const SCROLL_DEPTH_BUCKETS: readonly [25, 50, 75, 100];
-type ScrollDepthBucket = "0" | `${(typeof SCROLL_DEPTH_BUCKETS)[number]}`;
-declare function scrollDepthBucket(depth: number): ScrollDepthBucket;
-
-export { AUTO_EVENT_NAMES, AUTO_EVENT_PROPERTIES, AUTO_EVENT_ROLLUP_KEYS, type AutoEventName, RESERVED_EVENT_NAMES, SCROLL_DEPTH_BUCKETS, type ScrollDepthBucket, scrollDepthBucket };
+import { a as ExceptionEntry, c as ExceptionMechanism, d as MAX_EXCEPTION_FRAMES, f as RELEASE_PROPERTY, g as scrollDepthBucket, h as ScrollDepthBucket, i as AutoEventName, l as ExceptionStep, m as SCROLL_DEPTH_BUCKETS, n as AUTO_EVENT_PROPERTIES, o as ExceptionFrame, p as RESERVED_EVENT_NAMES, r as AUTO_EVENT_ROLLUP_KEYS, s as ExceptionLevel, t as AUTO_EVENT_NAMES, u as MAX_EXCEPTION_CHAIN } from "./events-BUIeU60t.js";
+export { AUTO_EVENT_NAMES, AUTO_EVENT_PROPERTIES, AUTO_EVENT_ROLLUP_KEYS, AutoEventName, ExceptionEntry, ExceptionFrame, ExceptionLevel, ExceptionMechanism, ExceptionStep, MAX_EXCEPTION_CHAIN, MAX_EXCEPTION_FRAMES, RELEASE_PROPERTY, RESERVED_EVENT_NAMES, SCROLL_DEPTH_BUCKETS, ScrollDepthBucket, scrollDepthBucket };