@plasius/analytics 1.3.1 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/metrics.cjs CHANGED
@@ -1,9 +1,123 @@
1
- "use strict";Object.defineProperty(exports, "__esModule", {value: true});
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
2
19
 
3
-
4
- var _chunk5BHE32SKcjs = require('./chunk-5BHE32SK.cjs');
5
-
6
-
7
-
8
- exports.USEFUL_METRIC_EVENT_DEFINITIONS = _chunk5BHE32SKcjs.USEFUL_METRIC_EVENT_DEFINITIONS; exports.projectUsefulMetric = _chunk5BHE32SKcjs.projectUsefulMetric;
20
+ // src/journey/metrics.ts
21
+ var metrics_exports = {};
22
+ __export(metrics_exports, {
23
+ USEFUL_METRIC_EVENT_DEFINITIONS: () => USEFUL_METRIC_EVENT_DEFINITIONS,
24
+ projectUsefulMetric: () => projectUsefulMetric
25
+ });
26
+ module.exports = __toCommonJS(metrics_exports);
27
+ var durationBuckets = [
28
+ [100, "lt100ms"],
29
+ [250, "lt250ms"],
30
+ [500, "lt500ms"],
31
+ [1e3, "lt1000ms"],
32
+ [2500, "lt2500ms"],
33
+ [5e3, "lt5000ms"],
34
+ [1e4, "lt10000ms"],
35
+ [Infinity, "gte10000ms"]
36
+ ];
37
+ var duration = (category) => ({
38
+ category,
39
+ outcome: "unknown",
40
+ buckets: durationBuckets,
41
+ maximum: 864e5
42
+ });
43
+ var metrics = /* @__PURE__ */ (() => ({
44
+ "page.load": duration("presentation"),
45
+ "route.ready": duration("presentation"),
46
+ "world.ready": duration("presentation"),
47
+ "request.duration": duration("request"),
48
+ "vital.lcp": duration("presentation"),
49
+ "vital.fcp": duration("presentation"),
50
+ "vital.inp": duration("interaction"),
51
+ "vital.ttfb": duration("request"),
52
+ "vital.cls": {
53
+ category: "presentation",
54
+ outcome: "unknown",
55
+ maximum: 100,
56
+ buckets: [[0.1, "lt01"], [0.25, "lt025"], [Infinity, "gte025"]]
57
+ },
58
+ "episode.active-duration": {
59
+ category: "state",
60
+ outcome: "unknown",
61
+ maximum: 864e5,
62
+ buckets: [
63
+ [1e4, "lt10s"],
64
+ [6e4, "lt60s"],
65
+ [3e5, "lt300s"],
66
+ [9e5, "lt900s"],
67
+ [36e5, "lt3600s"],
68
+ [Infinity, "gte3600s"]
69
+ ]
70
+ },
71
+ "episode.started": { category: "state", outcome: "unknown" },
72
+ "episode.completed": { category: "state", outcome: "unknown" },
73
+ "request.started": { category: "request", outcome: "unknown" },
74
+ "request.completed": { category: "request", outcome: "success" },
75
+ "request.failed": { category: "request", outcome: "failure" },
76
+ "request.cancelled": { category: "request", outcome: "cancelled" },
77
+ "request.rejected": { category: "request", outcome: "denied" },
78
+ "error.runtime": { category: "error", outcome: "failure" },
79
+ "error.resource": { category: "error", outcome: "failure" },
80
+ "error.render": { category: "error", outcome: "failure" },
81
+ "error.unhandled": { category: "error", outcome: "failure" }
82
+ }))();
83
+ var USEFUL_METRIC_EVENT_DEFINITIONS = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {
84
+ const names = definition.buckets ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`) : [`metric.${metric}`];
85
+ return names.map((name) => [name, Object.freeze({ category: definition.category })]);
86
+ }))))();
87
+ function projectUsefulMetric(input) {
88
+ try {
89
+ if (typeof input !== "object" || input === null || Array.isArray(input)) return null;
90
+ const prototype = Object.getPrototypeOf(input);
91
+ if (prototype !== Object.prototype && prototype !== null) return null;
92
+ const keys = Reflect.ownKeys(input);
93
+ if (keys.length < 1 || keys.length > 2 || keys.some((key) => key !== "metric" && key !== "value")) return null;
94
+ const descriptors = Object.getOwnPropertyDescriptors(input);
95
+ const metric = descriptors.metric;
96
+ if (!metric || !("value" in metric) || typeof metric.value !== "string" || !Object.hasOwn(metrics, metric.value)) return null;
97
+ const definition = metrics[metric.value];
98
+ let name = `metric.${metric.value}`;
99
+ if (definition.buckets) {
100
+ const value = descriptors.value;
101
+ if (keys.length !== 2 || !value || !("value" in value) || typeof value.value !== "number" || !Number.isFinite(value.value) || value.value < 0 || value.value > definition.maximum) return null;
102
+ const bucket = definition.buckets.find(([upper]) => value.value < upper);
103
+ name += `.${bucket[1]}`;
104
+ } else if (keys.length !== 1) {
105
+ return null;
106
+ }
107
+ return Object.freeze({
108
+ name,
109
+ category: definition.category,
110
+ phase: metric.value.endsWith(".started") ? "start" : "end",
111
+ outcome: definition.outcome,
112
+ modality: "system"
113
+ });
114
+ } catch {
115
+ return null;
116
+ }
117
+ }
118
+ // Annotate the CommonJS export names for ESM import in node:
119
+ 0 && (module.exports = {
120
+ USEFUL_METRIC_EVENT_DEFINITIONS,
121
+ projectUsefulMetric
122
+ });
9
123
  //# sourceMappingURL=metrics.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["/home/runner/work/analytics/analytics/dist/metrics.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,iKAAC","file":"/home/runner/work/analytics/analytics/dist/metrics.cjs"}
1
+ {"version":3,"sources":["../src/journey/metrics.ts"],"sourcesContent":["import type {\n SemanticJourneyCategory,\n SemanticJourneyEventDefinition,\n SemanticJourneyEventInput,\n SemanticJourneyOutcome,\n} from \"./types.js\";\n\ntype Bucket = readonly [upperExclusive: number, token: string];\ninterface MetricDefinition {\n readonly category: SemanticJourneyCategory;\n readonly outcome: SemanticJourneyOutcome;\n readonly buckets?: readonly Bucket[];\n readonly maximum?: number;\n}\n\nconst durationBuckets: readonly Bucket[] = [\n [100, \"lt100ms\"], [250, \"lt250ms\"], [500, \"lt500ms\"],\n [1000, \"lt1000ms\"], [2500, \"lt2500ms\"], [5000, \"lt5000ms\"],\n [10000, \"lt10000ms\"], [Infinity, \"gte10000ms\"],\n];\nconst duration = (category: SemanticJourneyCategory): MetricDefinition => ({\n category, outcome: \"unknown\", buckets: durationBuckets, maximum: 86_400_000,\n});\n// Fixed literal initialization is pure so hosts importing unrelated analytics\n// APIs can drop this optional metric module from their initial bundle.\nconst metrics: Readonly<Record<string, MetricDefinition>> = /* @__PURE__ */ (() => ({\n \"page.load\": duration(\"presentation\"),\n \"route.ready\": duration(\"presentation\"),\n \"world.ready\": duration(\"presentation\"),\n \"request.duration\": duration(\"request\"),\n \"vital.lcp\": duration(\"presentation\"),\n \"vital.fcp\": duration(\"presentation\"),\n \"vital.inp\": duration(\"interaction\"),\n \"vital.ttfb\": duration(\"request\"),\n \"vital.cls\": {\n category: \"presentation\", outcome: \"unknown\", maximum: 100,\n buckets: [[0.1, \"lt01\"], [0.25, \"lt025\"], [Infinity, \"gte025\"]],\n },\n \"episode.active-duration\": {\n category: \"state\", outcome: \"unknown\", maximum: 86_400_000,\n buckets: [[10000, \"lt10s\"], [60000, \"lt60s\"], [300000, \"lt300s\"],\n [900000, \"lt900s\"], [3600000, \"lt3600s\"], [Infinity, \"gte3600s\"]],\n },\n \"episode.started\": { category: \"state\", outcome: \"unknown\" },\n \"episode.completed\": { category: \"state\", outcome: \"unknown\" },\n \"request.started\": { category: \"request\", outcome: \"unknown\" },\n \"request.completed\": { category: \"request\", outcome: \"success\" },\n \"request.failed\": { category: \"request\", outcome: \"failure\" },\n \"request.cancelled\": { category: \"request\", outcome: \"cancelled\" },\n \"request.rejected\": { category: \"request\", outcome: \"denied\" },\n \"error.runtime\": { category: \"error\", outcome: \"failure\" },\n \"error.resource\": { category: \"error\", outcome: \"failure\" },\n \"error.render\": { category: \"error\", outcome: \"failure\" },\n \"error.unhandled\": { category: \"error\", outcome: \"failure\" },\n}))();\n\n/**\n * Fixed useful-metric catalogue entries for host catalogue composition and\n * collector allowlists. Buckets are part of event names so they survive the\n * existing aggregate wire format, which deliberately does not carry attributes.\n * This is not a collector or sender and has no browser/network side effects.\n */\nexport const USEFUL_METRIC_EVENT_DEFINITIONS: Readonly<\n Record<string, Readonly<SemanticJourneyEventDefinition>>\n> = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {\n const names = definition.buckets\n ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`)\n : [`metric.${metric}`];\n return names.map(name => [name, Object.freeze({ category: definition.category })]);\n}))))();\n\n/**\n * Projects one observation into a catalogue-controlled, identity-free event.\n * Accepts exactly { metric } for a counter or { metric, value } for a duration\n * in milliseconds (CLS is unitless). Rejects unknown/extra fields, accessors,\n * invalid numbers and legacy raw NFR payloads without reflecting their values.\n *\n * The host evaluates remote enablement, bounds observation frequency, tracks\n * this result with its semantic client, and owns disposal. Episode observations\n * are anonymous in-memory activity counts, never unique users or sessions.\n */\nexport function projectUsefulMetric(input: unknown): SemanticJourneyEventInput | null {\n try {\n if (typeof input !== \"object\" || input === null || Array.isArray(input)) return null;\n const prototype = Object.getPrototypeOf(input);\n if (prototype !== Object.prototype && prototype !== null) return null;\n const keys = Reflect.ownKeys(input);\n if (keys.length < 1 || keys.length > 2 || keys.some(key => key !== \"metric\" && key !== \"value\")) return null;\n const descriptors = Object.getOwnPropertyDescriptors(input);\n const metric = descriptors.metric;\n if (!metric || !(\"value\" in metric) || typeof metric.value !== \"string\"\n || !Object.hasOwn(metrics, metric.value)) return null;\n const definition = metrics[metric.value]!;\n let name = `metric.${metric.value}`;\n if (definition.buckets) {\n const value = descriptors.value;\n if (keys.length !== 2 || !value || !(\"value\" in value)\n || typeof value.value !== \"number\" || !Number.isFinite(value.value)\n || value.value < 0 || value.value > definition.maximum!) return null;\n const bucket = definition.buckets.find(([upper]) => value.value < upper)!;\n name += `.${bucket[1]}`;\n } else if (keys.length !== 1) {\n return null;\n }\n return Object.freeze({\n name, category: definition.category,\n phase: metric.value.endsWith(\".started\") ? \"start\" : \"end\",\n outcome: definition.outcome, modality: \"system\",\n });\n } catch {\n return null;\n }\n}\n"],"mappings":"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","names":[]}
package/dist/metrics.js CHANGED
@@ -1,7 +1,95 @@
1
- import {
2
- USEFUL_METRIC_EVENT_DEFINITIONS,
3
- projectUsefulMetric
4
- } from "./chunk-OEVYIQET.js";
1
+ // src/journey/metrics.ts
2
+ var durationBuckets = [
3
+ [100, "lt100ms"],
4
+ [250, "lt250ms"],
5
+ [500, "lt500ms"],
6
+ [1e3, "lt1000ms"],
7
+ [2500, "lt2500ms"],
8
+ [5e3, "lt5000ms"],
9
+ [1e4, "lt10000ms"],
10
+ [Infinity, "gte10000ms"]
11
+ ];
12
+ var duration = (category) => ({
13
+ category,
14
+ outcome: "unknown",
15
+ buckets: durationBuckets,
16
+ maximum: 864e5
17
+ });
18
+ var metrics = /* @__PURE__ */ (() => ({
19
+ "page.load": duration("presentation"),
20
+ "route.ready": duration("presentation"),
21
+ "world.ready": duration("presentation"),
22
+ "request.duration": duration("request"),
23
+ "vital.lcp": duration("presentation"),
24
+ "vital.fcp": duration("presentation"),
25
+ "vital.inp": duration("interaction"),
26
+ "vital.ttfb": duration("request"),
27
+ "vital.cls": {
28
+ category: "presentation",
29
+ outcome: "unknown",
30
+ maximum: 100,
31
+ buckets: [[0.1, "lt01"], [0.25, "lt025"], [Infinity, "gte025"]]
32
+ },
33
+ "episode.active-duration": {
34
+ category: "state",
35
+ outcome: "unknown",
36
+ maximum: 864e5,
37
+ buckets: [
38
+ [1e4, "lt10s"],
39
+ [6e4, "lt60s"],
40
+ [3e5, "lt300s"],
41
+ [9e5, "lt900s"],
42
+ [36e5, "lt3600s"],
43
+ [Infinity, "gte3600s"]
44
+ ]
45
+ },
46
+ "episode.started": { category: "state", outcome: "unknown" },
47
+ "episode.completed": { category: "state", outcome: "unknown" },
48
+ "request.started": { category: "request", outcome: "unknown" },
49
+ "request.completed": { category: "request", outcome: "success" },
50
+ "request.failed": { category: "request", outcome: "failure" },
51
+ "request.cancelled": { category: "request", outcome: "cancelled" },
52
+ "request.rejected": { category: "request", outcome: "denied" },
53
+ "error.runtime": { category: "error", outcome: "failure" },
54
+ "error.resource": { category: "error", outcome: "failure" },
55
+ "error.render": { category: "error", outcome: "failure" },
56
+ "error.unhandled": { category: "error", outcome: "failure" }
57
+ }))();
58
+ var USEFUL_METRIC_EVENT_DEFINITIONS = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {
59
+ const names = definition.buckets ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`) : [`metric.${metric}`];
60
+ return names.map((name) => [name, Object.freeze({ category: definition.category })]);
61
+ }))))();
62
+ function projectUsefulMetric(input) {
63
+ try {
64
+ if (typeof input !== "object" || input === null || Array.isArray(input)) return null;
65
+ const prototype = Object.getPrototypeOf(input);
66
+ if (prototype !== Object.prototype && prototype !== null) return null;
67
+ const keys = Reflect.ownKeys(input);
68
+ if (keys.length < 1 || keys.length > 2 || keys.some((key) => key !== "metric" && key !== "value")) return null;
69
+ const descriptors = Object.getOwnPropertyDescriptors(input);
70
+ const metric = descriptors.metric;
71
+ if (!metric || !("value" in metric) || typeof metric.value !== "string" || !Object.hasOwn(metrics, metric.value)) return null;
72
+ const definition = metrics[metric.value];
73
+ let name = `metric.${metric.value}`;
74
+ if (definition.buckets) {
75
+ const value = descriptors.value;
76
+ if (keys.length !== 2 || !value || !("value" in value) || typeof value.value !== "number" || !Number.isFinite(value.value) || value.value < 0 || value.value > definition.maximum) return null;
77
+ const bucket = definition.buckets.find(([upper]) => value.value < upper);
78
+ name += `.${bucket[1]}`;
79
+ } else if (keys.length !== 1) {
80
+ return null;
81
+ }
82
+ return Object.freeze({
83
+ name,
84
+ category: definition.category,
85
+ phase: metric.value.endsWith(".started") ? "start" : "end",
86
+ outcome: definition.outcome,
87
+ modality: "system"
88
+ });
89
+ } catch {
90
+ return null;
91
+ }
92
+ }
5
93
  export {
6
94
  USEFUL_METRIC_EVENT_DEFINITIONS,
7
95
  projectUsefulMetric
@@ -1 +1 @@
1
- {"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
1
+ {"version":3,"sources":["../src/journey/metrics.ts"],"sourcesContent":["import type {\n SemanticJourneyCategory,\n SemanticJourneyEventDefinition,\n SemanticJourneyEventInput,\n SemanticJourneyOutcome,\n} from \"./types.js\";\n\ntype Bucket = readonly [upperExclusive: number, token: string];\ninterface MetricDefinition {\n readonly category: SemanticJourneyCategory;\n readonly outcome: SemanticJourneyOutcome;\n readonly buckets?: readonly Bucket[];\n readonly maximum?: number;\n}\n\nconst durationBuckets: readonly Bucket[] = [\n [100, \"lt100ms\"], [250, \"lt250ms\"], [500, \"lt500ms\"],\n [1000, \"lt1000ms\"], [2500, \"lt2500ms\"], [5000, \"lt5000ms\"],\n [10000, \"lt10000ms\"], [Infinity, \"gte10000ms\"],\n];\nconst duration = (category: SemanticJourneyCategory): MetricDefinition => ({\n category, outcome: \"unknown\", buckets: durationBuckets, maximum: 86_400_000,\n});\n// Fixed literal initialization is pure so hosts importing unrelated analytics\n// APIs can drop this optional metric module from their initial bundle.\nconst metrics: Readonly<Record<string, MetricDefinition>> = /* @__PURE__ */ (() => ({\n \"page.load\": duration(\"presentation\"),\n \"route.ready\": duration(\"presentation\"),\n \"world.ready\": duration(\"presentation\"),\n \"request.duration\": duration(\"request\"),\n \"vital.lcp\": duration(\"presentation\"),\n \"vital.fcp\": duration(\"presentation\"),\n \"vital.inp\": duration(\"interaction\"),\n \"vital.ttfb\": duration(\"request\"),\n \"vital.cls\": {\n category: \"presentation\", outcome: \"unknown\", maximum: 100,\n buckets: [[0.1, \"lt01\"], [0.25, \"lt025\"], [Infinity, \"gte025\"]],\n },\n \"episode.active-duration\": {\n category: \"state\", outcome: \"unknown\", maximum: 86_400_000,\n buckets: [[10000, \"lt10s\"], [60000, \"lt60s\"], [300000, \"lt300s\"],\n [900000, \"lt900s\"], [3600000, \"lt3600s\"], [Infinity, \"gte3600s\"]],\n },\n \"episode.started\": { category: \"state\", outcome: \"unknown\" },\n \"episode.completed\": { category: \"state\", outcome: \"unknown\" },\n \"request.started\": { category: \"request\", outcome: \"unknown\" },\n \"request.completed\": { category: \"request\", outcome: \"success\" },\n \"request.failed\": { category: \"request\", outcome: \"failure\" },\n \"request.cancelled\": { category: \"request\", outcome: \"cancelled\" },\n \"request.rejected\": { category: \"request\", outcome: \"denied\" },\n \"error.runtime\": { category: \"error\", outcome: \"failure\" },\n \"error.resource\": { category: \"error\", outcome: \"failure\" },\n \"error.render\": { category: \"error\", outcome: \"failure\" },\n \"error.unhandled\": { category: \"error\", outcome: \"failure\" },\n}))();\n\n/**\n * Fixed useful-metric catalogue entries for host catalogue composition and\n * collector allowlists. Buckets are part of event names so they survive the\n * existing aggregate wire format, which deliberately does not carry attributes.\n * This is not a collector or sender and has no browser/network side effects.\n */\nexport const USEFUL_METRIC_EVENT_DEFINITIONS: Readonly<\n Record<string, Readonly<SemanticJourneyEventDefinition>>\n> = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {\n const names = definition.buckets\n ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`)\n : [`metric.${metric}`];\n return names.map(name => [name, Object.freeze({ category: definition.category })]);\n}))))();\n\n/**\n * Projects one observation into a catalogue-controlled, identity-free event.\n * Accepts exactly { metric } for a counter or { metric, value } for a duration\n * in milliseconds (CLS is unitless). Rejects unknown/extra fields, accessors,\n * invalid numbers and legacy raw NFR payloads without reflecting their values.\n *\n * The host evaluates remote enablement, bounds observation frequency, tracks\n * this result with its semantic client, and owns disposal. Episode observations\n * are anonymous in-memory activity counts, never unique users or sessions.\n */\nexport function projectUsefulMetric(input: unknown): SemanticJourneyEventInput | null {\n try {\n if (typeof input !== \"object\" || input === null || Array.isArray(input)) return null;\n const prototype = Object.getPrototypeOf(input);\n if (prototype !== Object.prototype && prototype !== null) return null;\n const keys = Reflect.ownKeys(input);\n if (keys.length < 1 || keys.length > 2 || keys.some(key => key !== \"metric\" && key !== \"value\")) return null;\n const descriptors = Object.getOwnPropertyDescriptors(input);\n const metric = descriptors.metric;\n if (!metric || !(\"value\" in metric) || typeof metric.value !== \"string\"\n || !Object.hasOwn(metrics, metric.value)) return null;\n const definition = metrics[metric.value]!;\n let name = `metric.${metric.value}`;\n if (definition.buckets) {\n const value = descriptors.value;\n if (keys.length !== 2 || !value || !(\"value\" in value)\n || typeof value.value !== \"number\" || !Number.isFinite(value.value)\n || value.value < 0 || value.value > definition.maximum!) return null;\n const bucket = definition.buckets.find(([upper]) => value.value < upper)!;\n name += `.${bucket[1]}`;\n } else if (keys.length !== 1) {\n return null;\n }\n return Object.freeze({\n name, category: definition.category,\n phase: metric.value.endsWith(\".started\") ? \"start\" : \"end\",\n outcome: definition.outcome, modality: \"system\",\n });\n } catch {\n return null;\n }\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@plasius/analytics",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "description": "Local-space analytics client and React helpers for interaction/event tracking with configurable ingestion endpoints.",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -1,98 +0,0 @@
1
- "use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/journey/metrics.ts
2
- var durationBuckets = [
3
- [100, "lt100ms"],
4
- [250, "lt250ms"],
5
- [500, "lt500ms"],
6
- [1e3, "lt1000ms"],
7
- [2500, "lt2500ms"],
8
- [5e3, "lt5000ms"],
9
- [1e4, "lt10000ms"],
10
- [Infinity, "gte10000ms"]
11
- ];
12
- var duration = (category) => ({
13
- category,
14
- outcome: "unknown",
15
- buckets: durationBuckets,
16
- maximum: 864e5
17
- });
18
- var metrics = /* @__PURE__ */ (() => ({
19
- "page.load": duration("presentation"),
20
- "route.ready": duration("presentation"),
21
- "world.ready": duration("presentation"),
22
- "request.duration": duration("request"),
23
- "vital.lcp": duration("presentation"),
24
- "vital.fcp": duration("presentation"),
25
- "vital.inp": duration("interaction"),
26
- "vital.ttfb": duration("request"),
27
- "vital.cls": {
28
- category: "presentation",
29
- outcome: "unknown",
30
- maximum: 100,
31
- buckets: [[0.1, "lt01"], [0.25, "lt025"], [Infinity, "gte025"]]
32
- },
33
- "episode.active-duration": {
34
- category: "state",
35
- outcome: "unknown",
36
- maximum: 864e5,
37
- buckets: [
38
- [1e4, "lt10s"],
39
- [6e4, "lt60s"],
40
- [3e5, "lt300s"],
41
- [9e5, "lt900s"],
42
- [36e5, "lt3600s"],
43
- [Infinity, "gte3600s"]
44
- ]
45
- },
46
- "episode.started": { category: "state", outcome: "unknown" },
47
- "episode.completed": { category: "state", outcome: "unknown" },
48
- "request.started": { category: "request", outcome: "unknown" },
49
- "request.completed": { category: "request", outcome: "success" },
50
- "request.failed": { category: "request", outcome: "failure" },
51
- "request.cancelled": { category: "request", outcome: "cancelled" },
52
- "request.rejected": { category: "request", outcome: "denied" },
53
- "error.runtime": { category: "error", outcome: "failure" },
54
- "error.resource": { category: "error", outcome: "failure" },
55
- "error.render": { category: "error", outcome: "failure" },
56
- "error.unhandled": { category: "error", outcome: "failure" }
57
- }))();
58
- var USEFUL_METRIC_EVENT_DEFINITIONS = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {
59
- const names = definition.buckets ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`) : [`metric.${metric}`];
60
- return names.map((name) => [name, Object.freeze({ category: definition.category })]);
61
- }))))();
62
- function projectUsefulMetric(input) {
63
- try {
64
- if (typeof input !== "object" || input === null || Array.isArray(input)) return null;
65
- const prototype = Object.getPrototypeOf(input);
66
- if (prototype !== Object.prototype && prototype !== null) return null;
67
- const keys = Reflect.ownKeys(input);
68
- if (keys.length < 1 || keys.length > 2 || keys.some((key) => key !== "metric" && key !== "value")) return null;
69
- const descriptors = Object.getOwnPropertyDescriptors(input);
70
- const metric = descriptors.metric;
71
- if (!metric || !("value" in metric) || typeof metric.value !== "string" || !Object.hasOwn(metrics, metric.value)) return null;
72
- const definition = metrics[metric.value];
73
- let name = `metric.${metric.value}`;
74
- if (definition.buckets) {
75
- const value = descriptors.value;
76
- if (keys.length !== 2 || !value || !("value" in value) || typeof value.value !== "number" || !Number.isFinite(value.value) || value.value < 0 || value.value > definition.maximum) return null;
77
- const bucket = definition.buckets.find(([upper]) => value.value < upper);
78
- name += `.${bucket[1]}`;
79
- } else if (keys.length !== 1) {
80
- return null;
81
- }
82
- return Object.freeze({
83
- name,
84
- category: definition.category,
85
- phase: metric.value.endsWith(".started") ? "start" : "end",
86
- outcome: definition.outcome,
87
- modality: "system"
88
- });
89
- } catch (e) {
90
- return null;
91
- }
92
- }
93
-
94
-
95
-
96
-
97
- exports.USEFUL_METRIC_EVENT_DEFINITIONS = USEFUL_METRIC_EVENT_DEFINITIONS; exports.projectUsefulMetric = projectUsefulMetric;
98
- //# sourceMappingURL=chunk-5BHE32SK.cjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["/home/runner/work/analytics/analytics/dist/chunk-5BHE32SK.cjs","../src/journey/metrics.ts"],"names":[],"mappings":"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","file":"/home/runner/work/analytics/analytics/dist/chunk-5BHE32SK.cjs","sourcesContent":[null,"import type {\n SemanticJourneyCategory,\n SemanticJourneyEventDefinition,\n SemanticJourneyEventInput,\n SemanticJourneyOutcome,\n} from \"./types.js\";\n\ntype Bucket = readonly [upperExclusive: number, token: string];\ninterface MetricDefinition {\n readonly category: SemanticJourneyCategory;\n readonly outcome: SemanticJourneyOutcome;\n readonly buckets?: readonly Bucket[];\n readonly maximum?: number;\n}\n\nconst durationBuckets: readonly Bucket[] = [\n [100, \"lt100ms\"], [250, \"lt250ms\"], [500, \"lt500ms\"],\n [1000, \"lt1000ms\"], [2500, \"lt2500ms\"], [5000, \"lt5000ms\"],\n [10000, \"lt10000ms\"], [Infinity, \"gte10000ms\"],\n];\nconst duration = (category: SemanticJourneyCategory): MetricDefinition => ({\n category, outcome: \"unknown\", buckets: durationBuckets, maximum: 86_400_000,\n});\n// Fixed literal initialization is pure so hosts importing unrelated analytics\n// APIs can drop this optional metric module from their initial bundle.\nconst metrics: Readonly<Record<string, MetricDefinition>> = /* @__PURE__ */ (() => ({\n \"page.load\": duration(\"presentation\"),\n \"route.ready\": duration(\"presentation\"),\n \"world.ready\": duration(\"presentation\"),\n \"request.duration\": duration(\"request\"),\n \"vital.lcp\": duration(\"presentation\"),\n \"vital.fcp\": duration(\"presentation\"),\n \"vital.inp\": duration(\"interaction\"),\n \"vital.ttfb\": duration(\"request\"),\n \"vital.cls\": {\n category: \"presentation\", outcome: \"unknown\", maximum: 100,\n buckets: [[0.1, \"lt01\"], [0.25, \"lt025\"], [Infinity, \"gte025\"]],\n },\n \"episode.active-duration\": {\n category: \"state\", outcome: \"unknown\", maximum: 86_400_000,\n buckets: [[10000, \"lt10s\"], [60000, \"lt60s\"], [300000, \"lt300s\"],\n [900000, \"lt900s\"], [3600000, \"lt3600s\"], [Infinity, \"gte3600s\"]],\n },\n \"episode.started\": { category: \"state\", outcome: \"unknown\" },\n \"episode.completed\": { category: \"state\", outcome: \"unknown\" },\n \"request.started\": { category: \"request\", outcome: \"unknown\" },\n \"request.completed\": { category: \"request\", outcome: \"success\" },\n \"request.failed\": { category: \"request\", outcome: \"failure\" },\n \"request.cancelled\": { category: \"request\", outcome: \"cancelled\" },\n \"request.rejected\": { category: \"request\", outcome: \"denied\" },\n \"error.runtime\": { category: \"error\", outcome: \"failure\" },\n \"error.resource\": { category: \"error\", outcome: \"failure\" },\n \"error.render\": { category: \"error\", outcome: \"failure\" },\n \"error.unhandled\": { category: \"error\", outcome: \"failure\" },\n}))();\n\n/**\n * Fixed useful-metric catalogue entries for host catalogue composition and\n * collector allowlists. Buckets are part of event names so they survive the\n * existing aggregate wire format, which deliberately does not carry attributes.\n * This is not a collector or sender and has no browser/network side effects.\n */\nexport const USEFUL_METRIC_EVENT_DEFINITIONS: Readonly<\n Record<string, Readonly<SemanticJourneyEventDefinition>>\n> = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {\n const names = definition.buckets\n ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`)\n : [`metric.${metric}`];\n return names.map(name => [name, Object.freeze({ category: definition.category })]);\n}))))();\n\n/**\n * Projects one observation into a catalogue-controlled, identity-free event.\n * Accepts exactly { metric } for a counter or { metric, value } for a duration\n * in milliseconds (CLS is unitless). Rejects unknown/extra fields, accessors,\n * invalid numbers and legacy raw NFR payloads without reflecting their values.\n *\n * The host evaluates remote enablement, bounds observation frequency, tracks\n * this result with its semantic client, and owns disposal. Episode observations\n * are anonymous in-memory activity counts, never unique users or sessions.\n */\nexport function projectUsefulMetric(input: unknown): SemanticJourneyEventInput | null {\n try {\n if (typeof input !== \"object\" || input === null || Array.isArray(input)) return null;\n const prototype = Object.getPrototypeOf(input);\n if (prototype !== Object.prototype && prototype !== null) return null;\n const keys = Reflect.ownKeys(input);\n if (keys.length < 1 || keys.length > 2 || keys.some(key => key !== \"metric\" && key !== \"value\")) return null;\n const descriptors = Object.getOwnPropertyDescriptors(input);\n const metric = descriptors.metric;\n if (!metric || !(\"value\" in metric) || typeof metric.value !== \"string\"\n || !Object.hasOwn(metrics, metric.value)) return null;\n const definition = metrics[metric.value]!;\n let name = `metric.${metric.value}`;\n if (definition.buckets) {\n const value = descriptors.value;\n if (keys.length !== 2 || !value || !(\"value\" in value)\n || typeof value.value !== \"number\" || !Number.isFinite(value.value)\n || value.value < 0 || value.value > definition.maximum!) return null;\n const bucket = definition.buckets.find(([upper]) => value.value < upper)!;\n name += `.${bucket[1]}`;\n } else if (keys.length !== 1) {\n return null;\n }\n return Object.freeze({\n name, category: definition.category,\n phase: metric.value.endsWith(\".started\") ? \"start\" : \"end\",\n outcome: definition.outcome, modality: \"system\",\n });\n } catch {\n return null;\n }\n}\n"]}
@@ -1,98 +0,0 @@
1
- // src/journey/metrics.ts
2
- var durationBuckets = [
3
- [100, "lt100ms"],
4
- [250, "lt250ms"],
5
- [500, "lt500ms"],
6
- [1e3, "lt1000ms"],
7
- [2500, "lt2500ms"],
8
- [5e3, "lt5000ms"],
9
- [1e4, "lt10000ms"],
10
- [Infinity, "gte10000ms"]
11
- ];
12
- var duration = (category) => ({
13
- category,
14
- outcome: "unknown",
15
- buckets: durationBuckets,
16
- maximum: 864e5
17
- });
18
- var metrics = /* @__PURE__ */ (() => ({
19
- "page.load": duration("presentation"),
20
- "route.ready": duration("presentation"),
21
- "world.ready": duration("presentation"),
22
- "request.duration": duration("request"),
23
- "vital.lcp": duration("presentation"),
24
- "vital.fcp": duration("presentation"),
25
- "vital.inp": duration("interaction"),
26
- "vital.ttfb": duration("request"),
27
- "vital.cls": {
28
- category: "presentation",
29
- outcome: "unknown",
30
- maximum: 100,
31
- buckets: [[0.1, "lt01"], [0.25, "lt025"], [Infinity, "gte025"]]
32
- },
33
- "episode.active-duration": {
34
- category: "state",
35
- outcome: "unknown",
36
- maximum: 864e5,
37
- buckets: [
38
- [1e4, "lt10s"],
39
- [6e4, "lt60s"],
40
- [3e5, "lt300s"],
41
- [9e5, "lt900s"],
42
- [36e5, "lt3600s"],
43
- [Infinity, "gte3600s"]
44
- ]
45
- },
46
- "episode.started": { category: "state", outcome: "unknown" },
47
- "episode.completed": { category: "state", outcome: "unknown" },
48
- "request.started": { category: "request", outcome: "unknown" },
49
- "request.completed": { category: "request", outcome: "success" },
50
- "request.failed": { category: "request", outcome: "failure" },
51
- "request.cancelled": { category: "request", outcome: "cancelled" },
52
- "request.rejected": { category: "request", outcome: "denied" },
53
- "error.runtime": { category: "error", outcome: "failure" },
54
- "error.resource": { category: "error", outcome: "failure" },
55
- "error.render": { category: "error", outcome: "failure" },
56
- "error.unhandled": { category: "error", outcome: "failure" }
57
- }))();
58
- var USEFUL_METRIC_EVENT_DEFINITIONS = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {
59
- const names = definition.buckets ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`) : [`metric.${metric}`];
60
- return names.map((name) => [name, Object.freeze({ category: definition.category })]);
61
- }))))();
62
- function projectUsefulMetric(input) {
63
- try {
64
- if (typeof input !== "object" || input === null || Array.isArray(input)) return null;
65
- const prototype = Object.getPrototypeOf(input);
66
- if (prototype !== Object.prototype && prototype !== null) return null;
67
- const keys = Reflect.ownKeys(input);
68
- if (keys.length < 1 || keys.length > 2 || keys.some((key) => key !== "metric" && key !== "value")) return null;
69
- const descriptors = Object.getOwnPropertyDescriptors(input);
70
- const metric = descriptors.metric;
71
- if (!metric || !("value" in metric) || typeof metric.value !== "string" || !Object.hasOwn(metrics, metric.value)) return null;
72
- const definition = metrics[metric.value];
73
- let name = `metric.${metric.value}`;
74
- if (definition.buckets) {
75
- const value = descriptors.value;
76
- if (keys.length !== 2 || !value || !("value" in value) || typeof value.value !== "number" || !Number.isFinite(value.value) || value.value < 0 || value.value > definition.maximum) return null;
77
- const bucket = definition.buckets.find(([upper]) => value.value < upper);
78
- name += `.${bucket[1]}`;
79
- } else if (keys.length !== 1) {
80
- return null;
81
- }
82
- return Object.freeze({
83
- name,
84
- category: definition.category,
85
- phase: metric.value.endsWith(".started") ? "start" : "end",
86
- outcome: definition.outcome,
87
- modality: "system"
88
- });
89
- } catch {
90
- return null;
91
- }
92
- }
93
-
94
- export {
95
- USEFUL_METRIC_EVENT_DEFINITIONS,
96
- projectUsefulMetric
97
- };
98
- //# sourceMappingURL=chunk-OEVYIQET.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/journey/metrics.ts"],"sourcesContent":["import type {\n SemanticJourneyCategory,\n SemanticJourneyEventDefinition,\n SemanticJourneyEventInput,\n SemanticJourneyOutcome,\n} from \"./types.js\";\n\ntype Bucket = readonly [upperExclusive: number, token: string];\ninterface MetricDefinition {\n readonly category: SemanticJourneyCategory;\n readonly outcome: SemanticJourneyOutcome;\n readonly buckets?: readonly Bucket[];\n readonly maximum?: number;\n}\n\nconst durationBuckets: readonly Bucket[] = [\n [100, \"lt100ms\"], [250, \"lt250ms\"], [500, \"lt500ms\"],\n [1000, \"lt1000ms\"], [2500, \"lt2500ms\"], [5000, \"lt5000ms\"],\n [10000, \"lt10000ms\"], [Infinity, \"gte10000ms\"],\n];\nconst duration = (category: SemanticJourneyCategory): MetricDefinition => ({\n category, outcome: \"unknown\", buckets: durationBuckets, maximum: 86_400_000,\n});\n// Fixed literal initialization is pure so hosts importing unrelated analytics\n// APIs can drop this optional metric module from their initial bundle.\nconst metrics: Readonly<Record<string, MetricDefinition>> = /* @__PURE__ */ (() => ({\n \"page.load\": duration(\"presentation\"),\n \"route.ready\": duration(\"presentation\"),\n \"world.ready\": duration(\"presentation\"),\n \"request.duration\": duration(\"request\"),\n \"vital.lcp\": duration(\"presentation\"),\n \"vital.fcp\": duration(\"presentation\"),\n \"vital.inp\": duration(\"interaction\"),\n \"vital.ttfb\": duration(\"request\"),\n \"vital.cls\": {\n category: \"presentation\", outcome: \"unknown\", maximum: 100,\n buckets: [[0.1, \"lt01\"], [0.25, \"lt025\"], [Infinity, \"gte025\"]],\n },\n \"episode.active-duration\": {\n category: \"state\", outcome: \"unknown\", maximum: 86_400_000,\n buckets: [[10000, \"lt10s\"], [60000, \"lt60s\"], [300000, \"lt300s\"],\n [900000, \"lt900s\"], [3600000, \"lt3600s\"], [Infinity, \"gte3600s\"]],\n },\n \"episode.started\": { category: \"state\", outcome: \"unknown\" },\n \"episode.completed\": { category: \"state\", outcome: \"unknown\" },\n \"request.started\": { category: \"request\", outcome: \"unknown\" },\n \"request.completed\": { category: \"request\", outcome: \"success\" },\n \"request.failed\": { category: \"request\", outcome: \"failure\" },\n \"request.cancelled\": { category: \"request\", outcome: \"cancelled\" },\n \"request.rejected\": { category: \"request\", outcome: \"denied\" },\n \"error.runtime\": { category: \"error\", outcome: \"failure\" },\n \"error.resource\": { category: \"error\", outcome: \"failure\" },\n \"error.render\": { category: \"error\", outcome: \"failure\" },\n \"error.unhandled\": { category: \"error\", outcome: \"failure\" },\n}))();\n\n/**\n * Fixed useful-metric catalogue entries for host catalogue composition and\n * collector allowlists. Buckets are part of event names so they survive the\n * existing aggregate wire format, which deliberately does not carry attributes.\n * This is not a collector or sender and has no browser/network side effects.\n */\nexport const USEFUL_METRIC_EVENT_DEFINITIONS: Readonly<\n Record<string, Readonly<SemanticJourneyEventDefinition>>\n> = /* @__PURE__ */ (() => Object.freeze(Object.fromEntries(Object.entries(metrics).flatMap(([metric, definition]) => {\n const names = definition.buckets\n ? definition.buckets.map(([, bucket]) => `metric.${metric}.${bucket}`)\n : [`metric.${metric}`];\n return names.map(name => [name, Object.freeze({ category: definition.category })]);\n}))))();\n\n/**\n * Projects one observation into a catalogue-controlled, identity-free event.\n * Accepts exactly { metric } for a counter or { metric, value } for a duration\n * in milliseconds (CLS is unitless). Rejects unknown/extra fields, accessors,\n * invalid numbers and legacy raw NFR payloads without reflecting their values.\n *\n * The host evaluates remote enablement, bounds observation frequency, tracks\n * this result with its semantic client, and owns disposal. Episode observations\n * are anonymous in-memory activity counts, never unique users or sessions.\n */\nexport function projectUsefulMetric(input: unknown): SemanticJourneyEventInput | null {\n try {\n if (typeof input !== \"object\" || input === null || Array.isArray(input)) return null;\n const prototype = Object.getPrototypeOf(input);\n if (prototype !== Object.prototype && prototype !== null) return null;\n const keys = Reflect.ownKeys(input);\n if (keys.length < 1 || keys.length > 2 || keys.some(key => key !== \"metric\" && key !== \"value\")) return null;\n const descriptors = Object.getOwnPropertyDescriptors(input);\n const metric = descriptors.metric;\n if (!metric || !(\"value\" in metric) || typeof metric.value !== \"string\"\n || !Object.hasOwn(metrics, metric.value)) return null;\n const definition = metrics[metric.value]!;\n let name = `metric.${metric.value}`;\n if (definition.buckets) {\n const value = descriptors.value;\n if (keys.length !== 2 || !value || !(\"value\" in value)\n || typeof value.value !== \"number\" || !Number.isFinite(value.value)\n || value.value < 0 || value.value > definition.maximum!) return null;\n const bucket = definition.buckets.find(([upper]) => value.value < upper)!;\n name += `.${bucket[1]}`;\n } else if (keys.length !== 1) {\n return null;\n }\n return Object.freeze({\n name, category: definition.category,\n phase: metric.value.endsWith(\".started\") ? \"start\" : \"end\",\n outcome: definition.outcome, modality: \"system\",\n });\n } catch {\n return null;\n }\n}\n"],"mappings":"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","names":[]}