@amplitude/amp-semantic 0.2.0-sr-bfcache-pageshow-snapshot.0 → 0.2.0

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/README.md CHANGED
@@ -1,44 +1,17 @@
1
1
  # @amplitude/amp-semantic
2
2
 
3
- Package foundation for semantic event capture in Amplitude. This increment establishes
4
- workspace packaging, CommonJS/ESM builds, TypeScript declarations, linting, tests, and
5
- the shared event envelope. It does not collect or emit events.
3
+ Internal, composable semantic capture runtime for Amplitude. This increment installs no production event recorders and is not connected to Session Replay.
6
4
 
7
- ## Public contracts
5
+ The host supplies a document, window, and transport callback. `createSemanticCapture` accepts typed recorder factories and optional per-family budgets (200 events per session by default). With no recorders supplied it emits nothing and installs no browser listeners.
8
6
 
9
- - `SEMANTIC_VERSION`: payload envelope version (`1`).
10
- - `SemanticIdentity`: `tab_id` and `document_id` correlation fields.
11
- - `SemanticEventEnvelope<Name, Payload>`: a typed name, timestamp, and payload
12
- containing the caller's fields plus version and identity.
7
+ The runtime owns opt-in sampling, start/stop and session reset, event version/timestamp/identity stamping, host signals, subscriptions, exception isolation, and cleanup rollback. Sampling and caps survive stop/start and reset only for a new session. Identity is allocated lazily when an event is accepted; its fallback is document-scoped memory, with no storage access.
13
8
 
14
- No event families are defined or registered. The package has no browser listeners,
15
- DOM observers, storage access, identity generation, capture runtime, or Session Replay
16
- integration. It is not yet a usable capture SDK.
9
+ Recorders register teardown immediately with `onCleanup` when setup can fail. `canEmit` lets them avoid expensive payload work at capacity. `dropped` returns delivery-cap diagnostics; recorders acknowledge successfully delivered diagnostics with `clearDropped`.
17
10
 
18
- ## Incremental implementation
11
+ The `snapshot` host signal describes an accepted full snapshot; the runtime does not subscribe to rrweb itself. The host remains responsible for privacy-safe payloads, recording consent, transport, and any persisted tab identity.
19
12
 
20
- 1. **This PR:** package structure and shared envelope contracts.
21
- 2. **Context and visibility:** capture runtime, sampling/caps, identity generation,
22
- recorders, event schemas, Session Replay integration, and a local test page.
23
- 3. **Dialog and notice:** rrweb mutation input, DOM enrichment, and feedback recorders.
24
- 4. Additional event families in later PRs.
25
-
26
- The existing full implementation remains available in PR #2082. Each event increment
27
- should add its contracts, implementation, documentation, and validation together.
13
+ Context, Session Replay integration, and visibility are added in separate follow-up PRs. No analytics SDK depends on this package in this increment.
28
14
 
29
15
  ## Development
30
16
 
31
- From the repository root:
32
-
33
- ```sh
34
- pnpm install
35
- pnpm build
36
- pnpm --filter @amplitude/amp-semantic typecheck
37
- pnpm --filter @amplitude/amp-semantic test --runInBand
38
- pnpm --filter @amplitude/amp-semantic lint
39
- ```
40
-
41
- The package build cleans `lib` before generating `lib/cjs` and `lib/esm`, avoiding stale
42
- recorders when switching between incremental branches. Runtime dependencies are limited
43
- to the workspace-standard TypeScript helper library; event-specific dependencies arrive
44
- with their implementations.
17
+ From the repository root, install dependencies and build with Node 24, `pnpm install`, and `pnpm build`. Run `pnpm --filter @amplitude/amp-semantic test` for runtime lifecycle and public contract tests.
@@ -0,0 +1,13 @@
1
+ import { HostSignals, SemanticCaptureConfig, SemanticFamily, SemanticHost, SemanticPayloads, SemanticRecorder } from './types';
2
+ export declare const DEFAULT_SEMANTIC_CAP = 200;
3
+ export interface SemanticCapture<P extends object = SemanticPayloads> {
4
+ isActive: () => boolean;
5
+ start: () => void;
6
+ stop: () => void;
7
+ updateConfig: (config: SemanticCaptureConfig<P>) => void;
8
+ resetSession: () => void;
9
+ notify: <K extends keyof HostSignals>(signal: K, value: HostSignals[K]) => void;
10
+ }
11
+ /** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
12
+ export declare function createCapture<P extends object = SemanticPayloads>(config: SemanticCaptureConfig<P>, host: SemanticHost<P>, recorders: readonly SemanticRecorder<P>[], caps?: Partial<Record<SemanticFamily<P>, number>>): SemanticCapture<P>;
13
+ //# sourceMappingURL=capture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EAErB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,gBAAgB;IAClE,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,YAAY,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACjF;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,gBAAgB,EAC/D,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAChC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,EACzC,IAAI,GAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAM,GACpD,eAAe,CAAC,CAAC,CAAC,CA4KpB"}
@@ -0,0 +1,221 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.createCapture = exports.DEFAULT_SEMANTIC_CAP = void 0;
4
+ var tslib_1 = require("tslib");
5
+ var identity_1 = require("./identity");
6
+ exports.DEFAULT_SEMANTIC_CAP = 200;
7
+ /** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
8
+ function createCapture(config, host, recorders, caps) {
9
+ var _a;
10
+ if (caps === void 0) { caps = {}; }
11
+ var settings = copyConfig(config);
12
+ var active = false;
13
+ var requested = false;
14
+ var attachGeneration = 0;
15
+ var sample;
16
+ var cleanups = [];
17
+ var counts = {};
18
+ var dropped = {};
19
+ var signals = new Map();
20
+ var now = (_a = host.now) !== null && _a !== void 0 ? _a : Date.now;
21
+ var report = function (error) {
22
+ var _a;
23
+ try {
24
+ (_a = host.onError) === null || _a === void 0 ? void 0 : _a.call(host, error);
25
+ }
26
+ catch (_b) {
27
+ /* Diagnostics must not affect the host. */
28
+ }
29
+ };
30
+ var safely = function (fn) {
31
+ try {
32
+ fn();
33
+ }
34
+ catch (error) {
35
+ report(error);
36
+ }
37
+ };
38
+ var enabled = function (family) { var _a; return active && ((_a = settings.families) === null || _a === void 0 ? void 0 : _a[family]) !== false; };
39
+ var hasCapacity = function (family) { var _a, _b; return enabled(family) && ((_a = counts[family]) !== null && _a !== void 0 ? _a : 0) < ((_b = caps[family]) !== null && _b !== void 0 ? _b : exports.DEFAULT_SEMANTIC_CAP); };
40
+ var canEmit = function (family) {
41
+ var _a;
42
+ if (!enabled(family))
43
+ return false;
44
+ if (hasCapacity(family))
45
+ return true;
46
+ dropped[family] = ((_a = dropped[family]) !== null && _a !== void 0 ? _a : 0) + 1;
47
+ return false;
48
+ };
49
+ var context = {
50
+ host: host,
51
+ now: now,
52
+ canEmit: canEmit,
53
+ dropped: function () { return (tslib_1.__assign({}, dropped)); },
54
+ clearDropped: function () {
55
+ dropped = {};
56
+ },
57
+ emit: function (family, payload, timestamp) {
58
+ var _a, _b;
59
+ if (timestamp === void 0) { timestamp = now(); }
60
+ if (!canEmit(family))
61
+ return false;
62
+ var identity;
63
+ try {
64
+ identity = (_a = host.getIdentity) === null || _a === void 0 ? void 0 : _a.call(host);
65
+ }
66
+ catch (error) {
67
+ report(error);
68
+ }
69
+ identity !== null && identity !== void 0 ? identity : (identity = (0, identity_1.getDocumentIdentity)(host.document, host.window));
70
+ var event = {
71
+ name: family,
72
+ payload: tslib_1.__assign(tslib_1.__assign({}, payload), { v: 1, tab_id: identity.tab_id, document_id: identity.document_id }),
73
+ timestamp: timestamp,
74
+ };
75
+ // Reserve capacity before calling a host that may emit reentrantly.
76
+ var reservedCounts = counts;
77
+ reservedCounts[family] = ((_b = reservedCounts[family]) !== null && _b !== void 0 ? _b : 0) + 1;
78
+ try {
79
+ host.emit(event);
80
+ }
81
+ catch (error) {
82
+ reservedCounts[family] = reservedCounts[family] - 1;
83
+ report(error);
84
+ return false;
85
+ }
86
+ return true;
87
+ },
88
+ on: function (signal, callback) {
89
+ var listeners = signals.get(signal);
90
+ if (!listeners) {
91
+ listeners = new Set();
92
+ signals.set(signal, listeners);
93
+ }
94
+ var listener = function (value) { return safely(function () { return callback(value); }); };
95
+ listeners.add(listener);
96
+ var registered = listeners;
97
+ return function () {
98
+ registered.delete(listener);
99
+ };
100
+ },
101
+ };
102
+ var detach = function () {
103
+ active = false;
104
+ attachGeneration += 1;
105
+ var previous = cleanups;
106
+ cleanups = [];
107
+ previous.reverse().forEach(function (cleanup) { return safely(cleanup); });
108
+ signals.clear();
109
+ };
110
+ var attach = function () {
111
+ var e_1, _a;
112
+ var _b, _c;
113
+ if (active || !requested || !settings.enabled)
114
+ return;
115
+ var rate = (_b = settings.sampleRate) !== null && _b !== void 0 ? _b : 1;
116
+ if (!Number.isFinite(rate) || rate <= 0 || rate > 1)
117
+ return;
118
+ if (sample === undefined)
119
+ sample = ((_c = host.random) !== null && _c !== void 0 ? _c : Math.random)();
120
+ if (sample >= rate)
121
+ return;
122
+ var myGeneration = attachGeneration + 1;
123
+ attachGeneration = myGeneration;
124
+ active = true;
125
+ var _loop_1 = function (recorder) {
126
+ if (recorder.families.some(enabled)) {
127
+ var acquired_1 = [];
128
+ var registerCleanup_1 = function (cleanup) {
129
+ if (!acquired_1.includes(cleanup))
130
+ acquired_1.push(cleanup);
131
+ };
132
+ var scoped = tslib_1.__assign(tslib_1.__assign({}, context), { onCleanup: registerCleanup_1, on: function (signal, callback) {
133
+ var cleanup = context.on(signal, callback);
134
+ registerCleanup_1(cleanup);
135
+ return cleanup;
136
+ } });
137
+ var rollback_1 = function () {
138
+ acquired_1
139
+ .splice(0)
140
+ .reverse()
141
+ .forEach(function (cleanup) { return safely(cleanup); });
142
+ };
143
+ var unregisterRollback = function () {
144
+ var index = cleanups.lastIndexOf(rollback_1);
145
+ if (index >= 0)
146
+ cleanups.splice(index, 1);
147
+ };
148
+ try {
149
+ // Register rollback before setup so reentrant stop/reset can tear listeners down.
150
+ cleanups.push(rollback_1);
151
+ var setupCleanup = recorder.setup(scoped);
152
+ if (active && myGeneration === attachGeneration) {
153
+ registerCleanup_1(setupCleanup);
154
+ }
155
+ if (!active || myGeneration !== attachGeneration) {
156
+ unregisterRollback();
157
+ rollback_1();
158
+ if (myGeneration !== attachGeneration)
159
+ return "break";
160
+ }
161
+ }
162
+ catch (error) {
163
+ unregisterRollback();
164
+ rollback_1();
165
+ report(error);
166
+ if (myGeneration !== attachGeneration)
167
+ return "break";
168
+ }
169
+ }
170
+ };
171
+ try {
172
+ for (var recorders_1 = tslib_1.__values(recorders), recorders_1_1 = recorders_1.next(); !recorders_1_1.done; recorders_1_1 = recorders_1.next()) {
173
+ var recorder = recorders_1_1.value;
174
+ var state_1 = _loop_1(recorder);
175
+ if (state_1 === "break")
176
+ break;
177
+ }
178
+ }
179
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
180
+ finally {
181
+ try {
182
+ if (recorders_1_1 && !recorders_1_1.done && (_a = recorders_1.return)) _a.call(recorders_1);
183
+ }
184
+ finally { if (e_1) throw e_1.error; }
185
+ }
186
+ };
187
+ return {
188
+ isActive: function () { return active; },
189
+ start: function () {
190
+ requested = true;
191
+ attach();
192
+ },
193
+ stop: function () {
194
+ requested = false;
195
+ detach();
196
+ },
197
+ updateConfig: function (next) {
198
+ detach();
199
+ settings = copyConfig(next);
200
+ attach();
201
+ },
202
+ resetSession: function () {
203
+ detach();
204
+ sample = undefined;
205
+ counts = {};
206
+ dropped = {};
207
+ attach();
208
+ },
209
+ notify: function (signal, value) {
210
+ var _a;
211
+ if (!active)
212
+ return;
213
+ (_a = signals.get(signal)) === null || _a === void 0 ? void 0 : _a.forEach(function (callback) { return callback(value); });
214
+ },
215
+ };
216
+ }
217
+ exports.createCapture = createCapture;
218
+ function copyConfig(config) {
219
+ return tslib_1.__assign(tslib_1.__assign({}, config), { families: config.families ? tslib_1.__assign({}, config.families) : undefined });
220
+ }
221
+ //# sourceMappingURL=capture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":";;;;AAAA,uCAAiD;AAapC,QAAA,oBAAoB,GAAG,GAAG,CAAC;AAWxC,2FAA2F;AAC3F,SAAgB,aAAa,CAC3B,MAAgC,EAChC,IAAqB,EACrB,SAAyC,EACzC,IAAqD;;IAArD,qBAAA,EAAA,SAAqD;IAErD,IAAI,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,MAA0B,CAAC;IAC/B,IAAI,QAAQ,GAAc,EAAE,CAAC;IAC7B,IAAI,MAAM,GAA+C,EAAE,CAAC;IAC5D,IAAI,OAAO,GAA+C,EAAE,CAAC;IAC7D,IAAM,OAAO,GAAG,IAAI,GAAG,EAAkD,CAAC;IAC1E,IAAM,GAAG,GAAG,MAAA,IAAI,CAAC,GAAG,mCAAI,IAAI,CAAC,GAAG,CAAC;IACjC,IAAM,MAAM,GAAG,UAAC,KAAc;;QAC5B,IAAI;YACF,MAAA,IAAI,CAAC,OAAO,qDAAG,KAAK,CAAC,CAAC;SACvB;QAAC,WAAM;YACN,2CAA2C;SAC5C;IACH,CAAC,CAAC;IACF,IAAM,MAAM,GAAG,UAAC,EAAc;QAC5B,IAAI;YACF,EAAE,EAAE,CAAC;SACN;QAAC,OAAO,KAAK,EAAE;YACd,MAAM,CAAC,KAAK,CAAC,CAAC;SACf;IACH,CAAC,CAAC;IACF,IAAM,OAAO,GAAG,UAAC,MAAyB,YAAK,OAAA,MAAM,IAAI,CAAA,MAAA,QAAQ,CAAC,QAAQ,0CAAG,MAAM,CAAC,MAAK,KAAK,CAAA,EAAA,CAAC;IAC/F,IAAM,WAAW,GAAG,UAAC,MAAyB,gBAC5C,OAAA,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAA,MAAM,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,MAAA,IAAI,CAAC,MAAM,CAAC,mCAAI,4BAAoB,CAAC,CAAA,EAAA,CAAC;IACpF,IAAM,OAAO,GAAG,UAAC,MAAyB;;QACxC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,IAAI,WAAW,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAA,OAAO,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IACF,IAAM,OAAO,GAA0C;QACrD,IAAI,MAAA;QACJ,GAAG,KAAA;QACH,OAAO,SAAA;QACP,OAAO,EAAE,cAAM,OAAA,sBAAM,OAAO,EAAG,EAAhB,CAAgB;QAC/B,YAAY,EAAE;YACZ,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QACD,IAAI,EAAE,UAA8B,MAAS,EAAE,OAAa,EAAE,SAAiB;;YAAjB,0BAAA,EAAA,YAAY,GAAG,EAAE;YAC7E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACnC,IAAI,QAAQ,CAAC;YACb,IAAI;gBACF,QAAQ,GAAG,MAAA,IAAI,CAAC,WAAW,oDAAI,CAAC;aACjC;YAAC,OAAO,KAAK,EAAE;gBACd,MAAM,CAAC,KAAK,CAAC,CAAC;aACf;YACD,QAAQ,aAAR,QAAQ,cAAR,QAAQ,IAAR,QAAQ,GAAK,IAAA,8BAAmB,EAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAC;YAC7D,IAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,MAAM;gBACZ,OAAO,wCAAO,OAAO,KAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,GAAE;gBACzF,SAAS,WAAA;aACU,CAAC;YACtB,oEAAoE;YACpE,IAAM,cAAc,GAAG,MAAM,CAAC;YAC9B,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,MAAA,cAAc,CAAC,MAAM,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC3D,IAAI;gBACF,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aAClB;YAAC,OAAO,KAAK,EAAE;gBACd,cAAc,CAAC,MAAM,CAAC,GAAI,cAAc,CAAC,MAAM,CAAY,GAAG,CAAC,CAAC;gBAChE,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,OAAO,KAAK,CAAC;aACd;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,EAAE,EAAE,UAAC,MAAM,EAAE,QAAQ;YACnB,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,SAAS,EAAE;gBACd,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;aAChC;YACD,IAAM,QAAQ,GAAG,UAAC,KAAY,IAAK,OAAA,MAAM,CAAC,cAAM,OAAA,QAAQ,CAAC,KAAK,CAAC,EAAf,CAAe,CAAC,EAA7B,CAA6B,CAAC;YACjE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACxB,IAAM,UAAU,GAAG,SAAS,CAAC;YAC7B,OAAO;gBACL,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;IACF,IAAM,MAAM,GAAG;QACb,MAAM,GAAG,KAAK,CAAC;QACf,gBAAgB,IAAI,CAAC,CAAC;QACtB,IAAM,QAAQ,GAAG,QAAQ,CAAC;QAC1B,QAAQ,GAAG,EAAE,CAAC;QACd,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,UAAC,OAAO,IAAK,OAAA,MAAM,CAAC,OAAO,CAAC,EAAf,CAAe,CAAC,CAAC;QACzD,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC;IACF,IAAM,MAAM,GAAG;;;QACb,IAAI,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,OAAO;YAAE,OAAO;QACtD,IAAM,IAAI,GAAG,MAAA,QAAQ,CAAC,UAAU,mCAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;YAAE,OAAO;QAC5D,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,GAAG,CAAC,MAAA,IAAI,CAAC,MAAM,mCAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClE,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO;QAC3B,IAAM,YAAY,GAAG,gBAAgB,GAAG,CAAC,CAAC;QAC1C,gBAAgB,GAAG,YAAY,CAAC;QAChC,MAAM,GAAG,IAAI,CAAC;gCACH,QAAQ;YACjB,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;gBACnC,IAAM,UAAQ,GAAc,EAAE,CAAC;gBAC/B,IAAM,iBAAe,GAAG,UAAC,OAAgB;oBACvC,IAAI,CAAC,UAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;wBAAE,UAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC1D,CAAC,CAAC;gBACF,IAAM,MAAM,yCACP,OAAO,KACV,SAAS,EAAE,iBAAe,EAC1B,EAAE,EAAE,UAAC,MAAM,EAAE,QAAQ;wBACnB,IAAM,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;wBAC7C,iBAAe,CAAC,OAAO,CAAC,CAAC;wBACzB,OAAO,OAAO,CAAC;oBACjB,CAAC,GACF,CAAC;gBACF,IAAM,UAAQ,GAAG;oBACf,UAAQ;yBACL,MAAM,CAAC,CAAC,CAAC;yBACT,OAAO,EAAE;yBACT,OAAO,CAAC,UAAC,OAAO,IAAK,OAAA,MAAM,CAAC,OAAO,CAAC,EAAf,CAAe,CAAC,CAAC;gBAC3C,CAAC,CAAC;gBACF,IAAM,kBAAkB,GAAG;oBACzB,IAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,UAAQ,CAAC,CAAC;oBAC7C,IAAI,KAAK,IAAI,CAAC;wBAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5C,CAAC,CAAC;gBACF,IAAI;oBACF,kFAAkF;oBAClF,QAAQ,CAAC,IAAI,CAAC,UAAQ,CAAC,CAAC;oBACxB,IAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC5C,IAAI,MAAM,IAAI,YAAY,KAAK,gBAAgB,EAAE;wBAC/C,iBAAe,CAAC,YAAY,CAAC,CAAC;qBAC/B;oBACD,IAAI,CAAC,MAAM,IAAI,YAAY,KAAK,gBAAgB,EAAE;wBAChD,kBAAkB,EAAE,CAAC;wBACrB,UAAQ,EAAE,CAAC;wBACX,IAAI,YAAY,KAAK,gBAAgB;2CAAQ;qBAC9C;iBACF;gBAAC,OAAO,KAAK,EAAE;oBACd,kBAAkB,EAAE,CAAC;oBACrB,UAAQ,EAAE,CAAC;oBACX,MAAM,CAAC,KAAK,CAAC,CAAC;oBACd,IAAI,YAAY,KAAK,gBAAgB;uCAAQ;iBAC9C;aACF;;;YA3CH,KAAuB,IAAA,cAAA,iBAAA,SAAS,CAAA,oCAAA;gBAA3B,IAAM,QAAQ,sBAAA;sCAAR,QAAQ;;;aA4ClB;;;;;;;;;IACH,CAAC,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,cAAM,OAAA,MAAM,EAAN,CAAM;QACtB,KAAK,EAAE;YACL,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,EAAE,CAAC;QACX,CAAC;QACD,IAAI,EAAE;YACJ,SAAS,GAAG,KAAK,CAAC;YAClB,MAAM,EAAE,CAAC;QACX,CAAC;QACD,YAAY,EAAE,UAAC,IAAI;YACjB,MAAM,EAAE,CAAC;YACT,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC5B,MAAM,EAAE,CAAC;QACX,CAAC;QACD,YAAY,EAAE;YACZ,MAAM,EAAE,CAAC;YACT,MAAM,GAAG,SAAS,CAAC;YACnB,MAAM,GAAG,EAAE,CAAC;YACZ,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,CAAC;QACX,CAAC;QACD,MAAM,EAAE,UAAC,MAAM,EAAE,KAAK;;YACpB,IAAI,CAAC,MAAM;gBAAE,OAAO;YACpB,MAAA,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,0CAAE,OAAO,CAAC,UAAC,QAAQ,IAAK,OAAA,QAAQ,CAAC,KAAc,CAAC,EAAxB,CAAwB,CAAC,CAAC;QACvE,CAAC;KACF,CAAC;AACJ,CAAC;AAjLD,sCAiLC;AAED,SAAS,UAAU,CAAmB,MAAgC;IACpE,6CAAY,MAAM,KAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,sBAAM,MAAM,CAAC,QAAQ,EAAG,CAAC,CAAC,SAAS,IAAG;AACvF,CAAC","sourcesContent":["import { getDocumentIdentity } from './identity';\nimport {\n Cleanup,\n HostSignals,\n RecorderContext,\n SemanticCaptureConfig,\n SemanticEvent,\n SemanticFamily,\n SemanticHost,\n SemanticPayloads,\n SemanticRecorder,\n} from './types';\n\nexport const DEFAULT_SEMANTIC_CAP = 200;\n\nexport interface SemanticCapture<P extends object = SemanticPayloads> {\n isActive: () => boolean;\n start: () => void;\n stop: () => void;\n updateConfig: (config: SemanticCaptureConfig<P>) => void;\n resetSession: () => void;\n notify: <K extends keyof HostSignals>(signal: K, value: HostSignals[K]) => void;\n}\n\n/** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */\nexport function createCapture<P extends object = SemanticPayloads>(\n config: SemanticCaptureConfig<P>,\n host: SemanticHost<P>,\n recorders: readonly SemanticRecorder<P>[],\n caps: Partial<Record<SemanticFamily<P>, number>> = {},\n): SemanticCapture<P> {\n let settings = copyConfig(config);\n let active = false;\n let requested = false;\n let attachGeneration = 0;\n let sample: number | undefined;\n let cleanups: Cleanup[] = [];\n let counts: Partial<Record<SemanticFamily<P>, number>> = {};\n let dropped: Partial<Record<SemanticFamily<P>, number>> = {};\n const signals = new Map<keyof HostSignals, Set<(value: never) => void>>();\n const now = host.now ?? Date.now;\n const report = (error: unknown) => {\n try {\n host.onError?.(error);\n } catch {\n /* Diagnostics must not affect the host. */\n }\n };\n const safely = (fn: () => void) => {\n try {\n fn();\n } catch (error) {\n report(error);\n }\n };\n const enabled = (family: SemanticFamily<P>) => active && settings.families?.[family] !== false;\n const hasCapacity = (family: SemanticFamily<P>) =>\n enabled(family) && (counts[family] ?? 0) < (caps[family] ?? DEFAULT_SEMANTIC_CAP);\n const canEmit = (family: SemanticFamily<P>): boolean => {\n if (!enabled(family)) return false;\n if (hasCapacity(family)) return true;\n dropped[family] = (dropped[family] ?? 0) + 1;\n return false;\n };\n const context: Omit<RecorderContext<P>, 'onCleanup'> = {\n host,\n now,\n canEmit,\n dropped: () => ({ ...dropped }),\n clearDropped: () => {\n dropped = {};\n },\n emit: <K extends SemanticFamily<P>>(family: K, payload: P[K], timestamp = now()): boolean => {\n if (!canEmit(family)) return false;\n let identity;\n try {\n identity = host.getIdentity?.();\n } catch (error) {\n report(error);\n }\n identity ??= getDocumentIdentity(host.document, host.window);\n const event = {\n name: family,\n payload: { ...payload, v: 1, tab_id: identity.tab_id, document_id: identity.document_id },\n timestamp,\n } as SemanticEvent<P>;\n // Reserve capacity before calling a host that may emit reentrantly.\n const reservedCounts = counts;\n reservedCounts[family] = (reservedCounts[family] ?? 0) + 1;\n try {\n host.emit(event);\n } catch (error) {\n reservedCounts[family] = (reservedCounts[family] as number) - 1;\n report(error);\n return false;\n }\n return true;\n },\n on: (signal, callback) => {\n let listeners = signals.get(signal);\n if (!listeners) {\n listeners = new Set();\n signals.set(signal, listeners);\n }\n const listener = (value: never) => safely(() => callback(value));\n listeners.add(listener);\n const registered = listeners;\n return () => {\n registered.delete(listener);\n };\n },\n };\n const detach = () => {\n active = false;\n attachGeneration += 1;\n const previous = cleanups;\n cleanups = [];\n previous.reverse().forEach((cleanup) => safely(cleanup));\n signals.clear();\n };\n const attach = () => {\n if (active || !requested || !settings.enabled) return;\n const rate = settings.sampleRate ?? 1;\n if (!Number.isFinite(rate) || rate <= 0 || rate > 1) return;\n if (sample === undefined) sample = (host.random ?? Math.random)();\n if (sample >= rate) return;\n const myGeneration = attachGeneration + 1;\n attachGeneration = myGeneration;\n active = true;\n for (const recorder of recorders) {\n if (recorder.families.some(enabled)) {\n const acquired: Cleanup[] = [];\n const registerCleanup = (cleanup: Cleanup) => {\n if (!acquired.includes(cleanup)) acquired.push(cleanup);\n };\n const scoped: RecorderContext<P> = {\n ...context,\n onCleanup: registerCleanup,\n on: (signal, callback) => {\n const cleanup = context.on(signal, callback);\n registerCleanup(cleanup);\n return cleanup;\n },\n };\n const rollback = () => {\n acquired\n .splice(0)\n .reverse()\n .forEach((cleanup) => safely(cleanup));\n };\n const unregisterRollback = () => {\n const index = cleanups.lastIndexOf(rollback);\n if (index >= 0) cleanups.splice(index, 1);\n };\n try {\n // Register rollback before setup so reentrant stop/reset can tear listeners down.\n cleanups.push(rollback);\n const setupCleanup = recorder.setup(scoped);\n if (active && myGeneration === attachGeneration) {\n registerCleanup(setupCleanup);\n }\n if (!active || myGeneration !== attachGeneration) {\n unregisterRollback();\n rollback();\n if (myGeneration !== attachGeneration) break;\n }\n } catch (error) {\n unregisterRollback();\n rollback();\n report(error);\n if (myGeneration !== attachGeneration) break;\n }\n }\n }\n };\n return {\n isActive: () => active,\n start: () => {\n requested = true;\n attach();\n },\n stop: () => {\n requested = false;\n detach();\n },\n updateConfig: (next) => {\n detach();\n settings = copyConfig(next);\n attach();\n },\n resetSession: () => {\n detach();\n sample = undefined;\n counts = {};\n dropped = {};\n attach();\n },\n notify: (signal, value) => {\n if (!active) return;\n signals.get(signal)?.forEach((callback) => callback(value as never));\n },\n };\n}\n\nfunction copyConfig<P extends object>(config: SemanticCaptureConfig<P>): SemanticCaptureConfig<P> {\n return { ...config, families: config.families ? { ...config.families } : undefined };\n}\n"]}
@@ -0,0 +1,4 @@
1
+ import type { SemanticIdentity } from './types';
2
+ /** No storage or listeners. Hosts can supply persistent tab identity through getIdentity. */
3
+ export declare function getDocumentIdentity(document: Document, scope: Window): SemanticIdentity;
4
+ //# sourceMappingURL=identity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgBhD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAOvF"}
@@ -0,0 +1,27 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getDocumentIdentity = void 0;
4
+ var identities = new WeakMap();
5
+ function uuid(scope) {
6
+ try {
7
+ return scope.crypto.randomUUID();
8
+ }
9
+ catch (_a) {
10
+ // Correlation IDs, not credentials. Also supports HTTP and older browsers.
11
+ return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (character) {
12
+ var value = (Math.random() * 16) | 0;
13
+ return (character === 'x' ? value : (value & 0x3) | 0x8).toString(16);
14
+ });
15
+ }
16
+ }
17
+ /** No storage or listeners. Hosts can supply persistent tab identity through getIdentity. */
18
+ function getDocumentIdentity(document, scope) {
19
+ var identity = identities.get(document);
20
+ if (!identity) {
21
+ identity = Object.freeze({ tab_id: uuid(scope), document_id: uuid(scope) });
22
+ identities.set(document, identity);
23
+ }
24
+ return identity;
25
+ }
26
+ exports.getDocumentIdentity = getDocumentIdentity;
27
+ //# sourceMappingURL=identity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":";;;AAEA,IAAM,UAAU,GAAG,IAAI,OAAO,EAA8B,CAAC;AAE7D,SAAS,IAAI,CAAC,KAAa;IACzB,IAAI;QACF,OAAO,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;KAClC;IAAC,WAAM;QACN,2EAA2E;QAC3E,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAC,SAAS;YACvE,IAAM,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;KACJ;AACH,CAAC;AAED,6FAA6F;AAC7F,SAAgB,mBAAmB,CAAC,QAAkB,EAAE,KAAa;IACnE,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE;QACb,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5E,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;KACpC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAPD,kDAOC","sourcesContent":["import type { SemanticIdentity } from './types';\n\nconst identities = new WeakMap<Document, SemanticIdentity>();\n\nfunction uuid(scope: Window): string {\n try {\n return scope.crypto.randomUUID();\n } catch {\n // Correlation IDs, not credentials. Also supports HTTP and older browsers.\n return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (character) => {\n const value = (Math.random() * 16) | 0;\n return (character === 'x' ? value : (value & 0x3) | 0x8).toString(16);\n });\n }\n}\n\n/** No storage or listeners. Hosts can supply persistent tab identity through getIdentity. */\nexport function getDocumentIdentity(document: Document, scope: Window): SemanticIdentity {\n let identity = identities.get(document);\n if (!identity) {\n identity = Object.freeze({ tab_id: uuid(scope), document_id: uuid(scope) });\n identities.set(document, identity);\n }\n return identity;\n}\n"]}
@@ -1,3 +1,8 @@
1
- export { SEMANTIC_VERSION } from './types';
2
- export type { SemanticIdentity, SemanticEventEnvelope } from './types';
1
+ import type { SemanticCaptureConfig, SemanticHost, SemanticPayloads, SemanticRecorder } from './types';
2
+ export * from './types';
3
+ export type { SemanticCapture } from './capture';
4
+ export { DEFAULT_SEMANTIC_CAP } from './capture';
5
+ export { getDocumentIdentity } from './identity';
6
+ /** Starts only the supplied recorders; no event families are installed by default. */
7
+ export declare function createSemanticCapture<P extends object = SemanticPayloads>(config: SemanticCaptureConfig<P>, host: SemanticHost<P>, recorders?: readonly SemanticRecorder<P>[], caps?: Partial<Record<Extract<keyof P, string>, number>>): import("./capture").SemanticCapture<P>;
3
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvG,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,gBAAgB,EACvE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAChC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,SAAS,GAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAO,EAC9C,IAAI,GAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAM,0CAG7D"}
package/lib/cjs/index.js CHANGED
@@ -1,6 +1,18 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.SEMANTIC_VERSION = void 0;
4
- var types_1 = require("./types");
5
- Object.defineProperty(exports, "SEMANTIC_VERSION", { enumerable: true, get: function () { return types_1.SEMANTIC_VERSION; } });
3
+ exports.createSemanticCapture = exports.getDocumentIdentity = exports.DEFAULT_SEMANTIC_CAP = void 0;
4
+ var tslib_1 = require("tslib");
5
+ var capture_1 = require("./capture");
6
+ tslib_1.__exportStar(require("./types"), exports);
7
+ var capture_2 = require("./capture");
8
+ Object.defineProperty(exports, "DEFAULT_SEMANTIC_CAP", { enumerable: true, get: function () { return capture_2.DEFAULT_SEMANTIC_CAP; } });
9
+ var identity_1 = require("./identity");
10
+ Object.defineProperty(exports, "getDocumentIdentity", { enumerable: true, get: function () { return identity_1.getDocumentIdentity; } });
11
+ /** Starts only the supplied recorders; no event families are installed by default. */
12
+ function createSemanticCapture(config, host, recorders, caps) {
13
+ if (recorders === void 0) { recorders = []; }
14
+ if (caps === void 0) { caps = {}; }
15
+ return (0, capture_1.createCapture)(config, host, recorders, caps);
16
+ }
17
+ exports.createSemanticCapture = createSemanticCapture;
6
18
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,iCAA2C;AAAlC,yGAAA,gBAAgB,OAAA","sourcesContent":["export { SEMANTIC_VERSION } from './types';\nexport type { SemanticIdentity, SemanticEventEnvelope } from './types';\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,qCAA0C;AAG1C,kDAAwB;AAExB,qCAAiD;AAAxC,+GAAA,oBAAoB,OAAA;AAC7B,uCAAiD;AAAxC,+GAAA,mBAAmB,OAAA;AAE5B,sFAAsF;AACtF,SAAgB,qBAAqB,CACnC,MAAgC,EAChC,IAAqB,EACrB,SAA8C,EAC9C,IAA4D;IAD5D,0BAAA,EAAA,cAA8C;IAC9C,qBAAA,EAAA,SAA4D;IAE5D,OAAO,IAAA,uBAAa,EAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAPD,sDAOC","sourcesContent":["import { createCapture } from './capture';\nimport type { SemanticCaptureConfig, SemanticHost, SemanticPayloads, SemanticRecorder } from './types';\n\nexport * from './types';\nexport type { SemanticCapture } from './capture';\nexport { DEFAULT_SEMANTIC_CAP } from './capture';\nexport { getDocumentIdentity } from './identity';\n\n/** Starts only the supplied recorders; no event families are installed by default. */\nexport function createSemanticCapture<P extends object = SemanticPayloads>(\n config: SemanticCaptureConfig<P>,\n host: SemanticHost<P>,\n recorders: readonly SemanticRecorder<P>[] = [],\n caps: Partial<Record<Extract<keyof P, string>, number>> = {},\n) {\n return createCapture(config, host, recorders, caps);\n}\n"]}
@@ -1,6 +1,4 @@
1
- /** Version of the shared semantic payload envelope. */
2
1
  export declare const SEMANTIC_VERSION = 1;
3
- /** Correlation identifiers supplied by a future capture host. */
4
2
  export interface SemanticIdentity {
5
3
  readonly tab_id: string;
6
4
  readonly document_id: string;
@@ -13,4 +11,51 @@ export interface SemanticEventEnvelope<Name extends string, Payload extends obje
13
11
  v: typeof SEMANTIC_VERSION;
14
12
  };
15
13
  }
14
+ /** Runtime consumers supply a map of event names to payload objects. */
15
+ export type SemanticPayloads = Record<string, object>;
16
+ export type SemanticFamily<P extends object = SemanticPayloads> = Extract<keyof P, string>;
17
+ export type SemanticEvent<P extends object = SemanticPayloads> = {
18
+ [K in SemanticFamily<P>]: SemanticEventEnvelope<K, P[K] & object>;
19
+ }[SemanticFamily<P>];
20
+ export interface SemanticCaptureConfig<P extends object = SemanticPayloads> {
21
+ enabled: boolean;
22
+ /** Additional sampling within recorded replay sessions. Defaults to 1. */
23
+ sampleRate?: number;
24
+ /** Registered families are enabled unless explicitly false. */
25
+ families?: Partial<Record<SemanticFamily<P>, boolean>>;
26
+ }
27
+ export interface HostSignals {
28
+ /** An accepted full snapshot, forwarded after the recorder is ready. */
29
+ snapshot: undefined;
30
+ }
31
+ export type Cleanup = () => void;
32
+ /** The host owns transport; the runtime has no rrweb dependency. */
33
+ export interface SemanticHost<P extends object = SemanticPayloads> {
34
+ document: Document;
35
+ window: Window;
36
+ emit: (event: SemanticEvent<P>) => void;
37
+ /** Called lazily for accepted events. Defaults to document-scoped memory only. */
38
+ getIdentity?: () => SemanticIdentity;
39
+ now?: () => number;
40
+ random?: () => number;
41
+ onError?: (error: unknown) => void;
42
+ }
43
+ export interface RecorderContext<P extends object = SemanticPayloads> {
44
+ /** Register resources immediately so failed setup can roll them back. */
45
+ onCleanup: (cleanup: Cleanup) => void;
46
+ host: SemanticHost<P>;
47
+ now: () => number;
48
+ /** Check before expensive payload work. A rejected candidate increments the dropped count. */
49
+ canEmit: (family: SemanticFamily<P>) => boolean;
50
+ emit: <K extends SemanticFamily<P>>(family: K, payload: P[K], timestamp?: number) => boolean;
51
+ on: <K extends keyof HostSignals>(signal: K, callback: (value: HostSignals[K]) => void) => Cleanup;
52
+ /** Peek at dropped counts; a recorder can acknowledge them after successful delivery. */
53
+ dropped: () => Partial<Record<SemanticFamily<P>, number>>;
54
+ clearDropped: () => void;
55
+ }
56
+ /** A factory owns its listeners/timers and returns complete teardown. */
57
+ export interface SemanticRecorder<P extends object = SemanticPayloads> {
58
+ families: readonly SemanticFamily<P>[];
59
+ setup: (context: RecorderContext<P>) => Cleanup;
60
+ }
16
61
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,oFAAoF;AACpF,MAAM,WAAW,qBAAqB,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM;IAChF,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG;QAAE,CAAC,EAAE,OAAO,gBAAgB,CAAA;KAAE,CAAC;CACtE"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
package/lib/cjs/types.js CHANGED
@@ -1,6 +1,5 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SEMANTIC_VERSION = void 0;
4
- /** Version of the shared semantic payload envelope. */
5
4
  exports.SEMANTIC_VERSION = 1;
6
5
  //# sourceMappingURL=types.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AAC1C,QAAA,gBAAgB,GAAG,CAAC,CAAC","sourcesContent":["/** Version of the shared semantic payload envelope. */\nexport const SEMANTIC_VERSION = 1;\n\n/** Correlation identifiers supplied by a future capture host. */\nexport interface SemanticIdentity {\n readonly tab_id: string;\n readonly document_id: string;\n}\n\n/** Internal event envelope, independent of any event family or replay transport. */\nexport interface SemanticEventEnvelope<Name extends string, Payload extends object> {\n name: Name;\n timestamp: number;\n payload: Payload & SemanticIdentity & { v: typeof SEMANTIC_VERSION };\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAAa,QAAA,gBAAgB,GAAG,CAAC,CAAC","sourcesContent":["export const SEMANTIC_VERSION = 1;\nexport interface SemanticIdentity {\n readonly tab_id: string;\n readonly document_id: string;\n}\n/** Internal event envelope, independent of any event family or replay transport. */\nexport interface SemanticEventEnvelope<Name extends string, Payload extends object> {\n name: Name;\n timestamp: number;\n payload: Payload & SemanticIdentity & { v: typeof SEMANTIC_VERSION };\n}\n\n/** Runtime consumers supply a map of event names to payload objects. */\nexport type SemanticPayloads = Record<string, object>;\nexport type SemanticFamily<P extends object = SemanticPayloads> = Extract<keyof P, string>;\nexport type SemanticEvent<P extends object = SemanticPayloads> = {\n [K in SemanticFamily<P>]: SemanticEventEnvelope<K, P[K] & object>;\n}[SemanticFamily<P>];\nexport interface SemanticCaptureConfig<P extends object = SemanticPayloads> {\n enabled: boolean;\n /** Additional sampling within recorded replay sessions. Defaults to 1. */\n sampleRate?: number;\n /** Registered families are enabled unless explicitly false. */\n families?: Partial<Record<SemanticFamily<P>, boolean>>;\n}\nexport interface HostSignals {\n /** An accepted full snapshot, forwarded after the recorder is ready. */\n snapshot: undefined;\n}\nexport type Cleanup = () => void;\n/** The host owns transport; the runtime has no rrweb dependency. */\nexport interface SemanticHost<P extends object = SemanticPayloads> {\n document: Document;\n window: Window;\n emit: (event: SemanticEvent<P>) => void;\n /** Called lazily for accepted events. Defaults to document-scoped memory only. */\n getIdentity?: () => SemanticIdentity;\n now?: () => number;\n random?: () => number;\n onError?: (error: unknown) => void;\n}\nexport interface RecorderContext<P extends object = SemanticPayloads> {\n /** Register resources immediately so failed setup can roll them back. */\n onCleanup: (cleanup: Cleanup) => void;\n host: SemanticHost<P>;\n now: () => number;\n /** Check before expensive payload work. A rejected candidate increments the dropped count. */\n canEmit: (family: SemanticFamily<P>) => boolean;\n emit: <K extends SemanticFamily<P>>(family: K, payload: P[K], timestamp?: number) => boolean;\n on: <K extends keyof HostSignals>(signal: K, callback: (value: HostSignals[K]) => void) => Cleanup;\n /** Peek at dropped counts; a recorder can acknowledge them after successful delivery. */\n dropped: () => Partial<Record<SemanticFamily<P>, number>>;\n clearDropped: () => void;\n}\n/** A factory owns its listeners/timers and returns complete teardown. */\nexport interface SemanticRecorder<P extends object = SemanticPayloads> {\n families: readonly SemanticFamily<P>[];\n setup: (context: RecorderContext<P>) => Cleanup;\n}\n"]}
@@ -0,0 +1,13 @@
1
+ import { HostSignals, SemanticCaptureConfig, SemanticFamily, SemanticHost, SemanticPayloads, SemanticRecorder } from './types';
2
+ export declare const DEFAULT_SEMANTIC_CAP = 200;
3
+ export interface SemanticCapture<P extends object = SemanticPayloads> {
4
+ isActive: () => boolean;
5
+ start: () => void;
6
+ stop: () => void;
7
+ updateConfig: (config: SemanticCaptureConfig<P>) => void;
8
+ resetSession: () => void;
9
+ notify: <K extends keyof HostSignals>(signal: K, value: HostSignals[K]) => void;
10
+ }
11
+ /** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
12
+ export declare function createCapture<P extends object = SemanticPayloads>(config: SemanticCaptureConfig<P>, host: SemanticHost<P>, recorders: readonly SemanticRecorder<P>[], caps?: Partial<Record<SemanticFamily<P>, number>>): SemanticCapture<P>;
13
+ //# sourceMappingURL=capture.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EAErB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,gBAAgB;IAClE,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,YAAY,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzD,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;CACjF;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,GAAG,gBAAgB,EAC/D,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAChC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAE,EACzC,IAAI,GAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAM,GACpD,eAAe,CAAC,CAAC,CAAC,CA4KpB"}
@@ -0,0 +1,217 @@
1
+ import { __assign, __values } from "tslib";
2
+ import { getDocumentIdentity } from './identity';
3
+ export var DEFAULT_SEMANTIC_CAP = 200;
4
+ /** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
5
+ export function createCapture(config, host, recorders, caps) {
6
+ var _a;
7
+ if (caps === void 0) { caps = {}; }
8
+ var settings = copyConfig(config);
9
+ var active = false;
10
+ var requested = false;
11
+ var attachGeneration = 0;
12
+ var sample;
13
+ var cleanups = [];
14
+ var counts = {};
15
+ var dropped = {};
16
+ var signals = new Map();
17
+ var now = (_a = host.now) !== null && _a !== void 0 ? _a : Date.now;
18
+ var report = function (error) {
19
+ var _a;
20
+ try {
21
+ (_a = host.onError) === null || _a === void 0 ? void 0 : _a.call(host, error);
22
+ }
23
+ catch (_b) {
24
+ /* Diagnostics must not affect the host. */
25
+ }
26
+ };
27
+ var safely = function (fn) {
28
+ try {
29
+ fn();
30
+ }
31
+ catch (error) {
32
+ report(error);
33
+ }
34
+ };
35
+ var enabled = function (family) { var _a; return active && ((_a = settings.families) === null || _a === void 0 ? void 0 : _a[family]) !== false; };
36
+ var hasCapacity = function (family) { var _a, _b; return enabled(family) && ((_a = counts[family]) !== null && _a !== void 0 ? _a : 0) < ((_b = caps[family]) !== null && _b !== void 0 ? _b : DEFAULT_SEMANTIC_CAP); };
37
+ var canEmit = function (family) {
38
+ var _a;
39
+ if (!enabled(family))
40
+ return false;
41
+ if (hasCapacity(family))
42
+ return true;
43
+ dropped[family] = ((_a = dropped[family]) !== null && _a !== void 0 ? _a : 0) + 1;
44
+ return false;
45
+ };
46
+ var context = {
47
+ host: host,
48
+ now: now,
49
+ canEmit: canEmit,
50
+ dropped: function () { return (__assign({}, dropped)); },
51
+ clearDropped: function () {
52
+ dropped = {};
53
+ },
54
+ emit: function (family, payload, timestamp) {
55
+ var _a, _b;
56
+ if (timestamp === void 0) { timestamp = now(); }
57
+ if (!canEmit(family))
58
+ return false;
59
+ var identity;
60
+ try {
61
+ identity = (_a = host.getIdentity) === null || _a === void 0 ? void 0 : _a.call(host);
62
+ }
63
+ catch (error) {
64
+ report(error);
65
+ }
66
+ identity !== null && identity !== void 0 ? identity : (identity = getDocumentIdentity(host.document, host.window));
67
+ var event = {
68
+ name: family,
69
+ payload: __assign(__assign({}, payload), { v: 1, tab_id: identity.tab_id, document_id: identity.document_id }),
70
+ timestamp: timestamp,
71
+ };
72
+ // Reserve capacity before calling a host that may emit reentrantly.
73
+ var reservedCounts = counts;
74
+ reservedCounts[family] = ((_b = reservedCounts[family]) !== null && _b !== void 0 ? _b : 0) + 1;
75
+ try {
76
+ host.emit(event);
77
+ }
78
+ catch (error) {
79
+ reservedCounts[family] = reservedCounts[family] - 1;
80
+ report(error);
81
+ return false;
82
+ }
83
+ return true;
84
+ },
85
+ on: function (signal, callback) {
86
+ var listeners = signals.get(signal);
87
+ if (!listeners) {
88
+ listeners = new Set();
89
+ signals.set(signal, listeners);
90
+ }
91
+ var listener = function (value) { return safely(function () { return callback(value); }); };
92
+ listeners.add(listener);
93
+ var registered = listeners;
94
+ return function () {
95
+ registered.delete(listener);
96
+ };
97
+ },
98
+ };
99
+ var detach = function () {
100
+ active = false;
101
+ attachGeneration += 1;
102
+ var previous = cleanups;
103
+ cleanups = [];
104
+ previous.reverse().forEach(function (cleanup) { return safely(cleanup); });
105
+ signals.clear();
106
+ };
107
+ var attach = function () {
108
+ var e_1, _a;
109
+ var _b, _c;
110
+ if (active || !requested || !settings.enabled)
111
+ return;
112
+ var rate = (_b = settings.sampleRate) !== null && _b !== void 0 ? _b : 1;
113
+ if (!Number.isFinite(rate) || rate <= 0 || rate > 1)
114
+ return;
115
+ if (sample === undefined)
116
+ sample = ((_c = host.random) !== null && _c !== void 0 ? _c : Math.random)();
117
+ if (sample >= rate)
118
+ return;
119
+ var myGeneration = attachGeneration + 1;
120
+ attachGeneration = myGeneration;
121
+ active = true;
122
+ var _loop_1 = function (recorder) {
123
+ if (recorder.families.some(enabled)) {
124
+ var acquired_1 = [];
125
+ var registerCleanup_1 = function (cleanup) {
126
+ if (!acquired_1.includes(cleanup))
127
+ acquired_1.push(cleanup);
128
+ };
129
+ var scoped = __assign(__assign({}, context), { onCleanup: registerCleanup_1, on: function (signal, callback) {
130
+ var cleanup = context.on(signal, callback);
131
+ registerCleanup_1(cleanup);
132
+ return cleanup;
133
+ } });
134
+ var rollback_1 = function () {
135
+ acquired_1
136
+ .splice(0)
137
+ .reverse()
138
+ .forEach(function (cleanup) { return safely(cleanup); });
139
+ };
140
+ var unregisterRollback = function () {
141
+ var index = cleanups.lastIndexOf(rollback_1);
142
+ if (index >= 0)
143
+ cleanups.splice(index, 1);
144
+ };
145
+ try {
146
+ // Register rollback before setup so reentrant stop/reset can tear listeners down.
147
+ cleanups.push(rollback_1);
148
+ var setupCleanup = recorder.setup(scoped);
149
+ if (active && myGeneration === attachGeneration) {
150
+ registerCleanup_1(setupCleanup);
151
+ }
152
+ if (!active || myGeneration !== attachGeneration) {
153
+ unregisterRollback();
154
+ rollback_1();
155
+ if (myGeneration !== attachGeneration)
156
+ return "break";
157
+ }
158
+ }
159
+ catch (error) {
160
+ unregisterRollback();
161
+ rollback_1();
162
+ report(error);
163
+ if (myGeneration !== attachGeneration)
164
+ return "break";
165
+ }
166
+ }
167
+ };
168
+ try {
169
+ for (var recorders_1 = __values(recorders), recorders_1_1 = recorders_1.next(); !recorders_1_1.done; recorders_1_1 = recorders_1.next()) {
170
+ var recorder = recorders_1_1.value;
171
+ var state_1 = _loop_1(recorder);
172
+ if (state_1 === "break")
173
+ break;
174
+ }
175
+ }
176
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
177
+ finally {
178
+ try {
179
+ if (recorders_1_1 && !recorders_1_1.done && (_a = recorders_1.return)) _a.call(recorders_1);
180
+ }
181
+ finally { if (e_1) throw e_1.error; }
182
+ }
183
+ };
184
+ return {
185
+ isActive: function () { return active; },
186
+ start: function () {
187
+ requested = true;
188
+ attach();
189
+ },
190
+ stop: function () {
191
+ requested = false;
192
+ detach();
193
+ },
194
+ updateConfig: function (next) {
195
+ detach();
196
+ settings = copyConfig(next);
197
+ attach();
198
+ },
199
+ resetSession: function () {
200
+ detach();
201
+ sample = undefined;
202
+ counts = {};
203
+ dropped = {};
204
+ attach();
205
+ },
206
+ notify: function (signal, value) {
207
+ var _a;
208
+ if (!active)
209
+ return;
210
+ (_a = signals.get(signal)) === null || _a === void 0 ? void 0 : _a.forEach(function (callback) { return callback(value); });
211
+ },
212
+ };
213
+ }
214
+ function copyConfig(config) {
215
+ return __assign(__assign({}, config), { families: config.families ? __assign({}, config.families) : undefined });
216
+ }
217
+ //# sourceMappingURL=capture.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"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","sourcesContent":["import { getDocumentIdentity } from './identity';\nimport {\n Cleanup,\n HostSignals,\n RecorderContext,\n SemanticCaptureConfig,\n SemanticEvent,\n SemanticFamily,\n SemanticHost,\n SemanticPayloads,\n SemanticRecorder,\n} from './types';\n\nexport const DEFAULT_SEMANTIC_CAP = 200;\n\nexport interface SemanticCapture<P extends object = SemanticPayloads> {\n isActive: () => boolean;\n start: () => void;\n stop: () => void;\n updateConfig: (config: SemanticCaptureConfig<P>) => void;\n resetSession: () => void;\n notify: <K extends keyof HostSignals>(signal: K, value: HostSignals[K]) => void;\n}\n\n/** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */\nexport function createCapture<P extends object = SemanticPayloads>(\n config: SemanticCaptureConfig<P>,\n host: SemanticHost<P>,\n recorders: readonly SemanticRecorder<P>[],\n caps: Partial<Record<SemanticFamily<P>, number>> = {},\n): SemanticCapture<P> {\n let settings = copyConfig(config);\n let active = false;\n let requested = false;\n let attachGeneration = 0;\n let sample: number | undefined;\n let cleanups: Cleanup[] = [];\n let counts: Partial<Record<SemanticFamily<P>, number>> = {};\n let dropped: Partial<Record<SemanticFamily<P>, number>> = {};\n const signals = new Map<keyof HostSignals, Set<(value: never) => void>>();\n const now = host.now ?? Date.now;\n const report = (error: unknown) => {\n try {\n host.onError?.(error);\n } catch {\n /* Diagnostics must not affect the host. */\n }\n };\n const safely = (fn: () => void) => {\n try {\n fn();\n } catch (error) {\n report(error);\n }\n };\n const enabled = (family: SemanticFamily<P>) => active && settings.families?.[family] !== false;\n const hasCapacity = (family: SemanticFamily<P>) =>\n enabled(family) && (counts[family] ?? 0) < (caps[family] ?? DEFAULT_SEMANTIC_CAP);\n const canEmit = (family: SemanticFamily<P>): boolean => {\n if (!enabled(family)) return false;\n if (hasCapacity(family)) return true;\n dropped[family] = (dropped[family] ?? 0) + 1;\n return false;\n };\n const context: Omit<RecorderContext<P>, 'onCleanup'> = {\n host,\n now,\n canEmit,\n dropped: () => ({ ...dropped }),\n clearDropped: () => {\n dropped = {};\n },\n emit: <K extends SemanticFamily<P>>(family: K, payload: P[K], timestamp = now()): boolean => {\n if (!canEmit(family)) return false;\n let identity;\n try {\n identity = host.getIdentity?.();\n } catch (error) {\n report(error);\n }\n identity ??= getDocumentIdentity(host.document, host.window);\n const event = {\n name: family,\n payload: { ...payload, v: 1, tab_id: identity.tab_id, document_id: identity.document_id },\n timestamp,\n } as SemanticEvent<P>;\n // Reserve capacity before calling a host that may emit reentrantly.\n const reservedCounts = counts;\n reservedCounts[family] = (reservedCounts[family] ?? 0) + 1;\n try {\n host.emit(event);\n } catch (error) {\n reservedCounts[family] = (reservedCounts[family] as number) - 1;\n report(error);\n return false;\n }\n return true;\n },\n on: (signal, callback) => {\n let listeners = signals.get(signal);\n if (!listeners) {\n listeners = new Set();\n signals.set(signal, listeners);\n }\n const listener = (value: never) => safely(() => callback(value));\n listeners.add(listener);\n const registered = listeners;\n return () => {\n registered.delete(listener);\n };\n },\n };\n const detach = () => {\n active = false;\n attachGeneration += 1;\n const previous = cleanups;\n cleanups = [];\n previous.reverse().forEach((cleanup) => safely(cleanup));\n signals.clear();\n };\n const attach = () => {\n if (active || !requested || !settings.enabled) return;\n const rate = settings.sampleRate ?? 1;\n if (!Number.isFinite(rate) || rate <= 0 || rate > 1) return;\n if (sample === undefined) sample = (host.random ?? Math.random)();\n if (sample >= rate) return;\n const myGeneration = attachGeneration + 1;\n attachGeneration = myGeneration;\n active = true;\n for (const recorder of recorders) {\n if (recorder.families.some(enabled)) {\n const acquired: Cleanup[] = [];\n const registerCleanup = (cleanup: Cleanup) => {\n if (!acquired.includes(cleanup)) acquired.push(cleanup);\n };\n const scoped: RecorderContext<P> = {\n ...context,\n onCleanup: registerCleanup,\n on: (signal, callback) => {\n const cleanup = context.on(signal, callback);\n registerCleanup(cleanup);\n return cleanup;\n },\n };\n const rollback = () => {\n acquired\n .splice(0)\n .reverse()\n .forEach((cleanup) => safely(cleanup));\n };\n const unregisterRollback = () => {\n const index = cleanups.lastIndexOf(rollback);\n if (index >= 0) cleanups.splice(index, 1);\n };\n try {\n // Register rollback before setup so reentrant stop/reset can tear listeners down.\n cleanups.push(rollback);\n const setupCleanup = recorder.setup(scoped);\n if (active && myGeneration === attachGeneration) {\n registerCleanup(setupCleanup);\n }\n if (!active || myGeneration !== attachGeneration) {\n unregisterRollback();\n rollback();\n if (myGeneration !== attachGeneration) break;\n }\n } catch (error) {\n unregisterRollback();\n rollback();\n report(error);\n if (myGeneration !== attachGeneration) break;\n }\n }\n }\n };\n return {\n isActive: () => active,\n start: () => {\n requested = true;\n attach();\n },\n stop: () => {\n requested = false;\n detach();\n },\n updateConfig: (next) => {\n detach();\n settings = copyConfig(next);\n attach();\n },\n resetSession: () => {\n detach();\n sample = undefined;\n counts = {};\n dropped = {};\n attach();\n },\n notify: (signal, value) => {\n if (!active) return;\n signals.get(signal)?.forEach((callback) => callback(value as never));\n },\n };\n}\n\nfunction copyConfig<P extends object>(config: SemanticCaptureConfig<P>): SemanticCaptureConfig<P> {\n return { ...config, families: config.families ? { ...config.families } : undefined };\n}\n"]}
@@ -0,0 +1,4 @@
1
+ import type { SemanticIdentity } from './types';
2
+ /** No storage or listeners. Hosts can supply persistent tab identity through getIdentity. */
3
+ export declare function getDocumentIdentity(document: Document, scope: Window): SemanticIdentity;
4
+ //# sourceMappingURL=identity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAgBhD,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAOvF"}
@@ -0,0 +1,23 @@
1
+ var identities = new WeakMap();
2
+ function uuid(scope) {
3
+ try {
4
+ return scope.crypto.randomUUID();
5
+ }
6
+ catch (_a) {
7
+ // Correlation IDs, not credentials. Also supports HTTP and older browsers.
8
+ return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (character) {
9
+ var value = (Math.random() * 16) | 0;
10
+ return (character === 'x' ? value : (value & 0x3) | 0x8).toString(16);
11
+ });
12
+ }
13
+ }
14
+ /** No storage or listeners. Hosts can supply persistent tab identity through getIdentity. */
15
+ export function getDocumentIdentity(document, scope) {
16
+ var identity = identities.get(document);
17
+ if (!identity) {
18
+ identity = Object.freeze({ tab_id: uuid(scope), document_id: uuid(scope) });
19
+ identities.set(document, identity);
20
+ }
21
+ return identity;
22
+ }
23
+ //# sourceMappingURL=identity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/identity.ts"],"names":[],"mappings":"AAEA,IAAM,UAAU,GAAG,IAAI,OAAO,EAA8B,CAAC;AAE7D,SAAS,IAAI,CAAC,KAAa;IACzB,IAAI;QACF,OAAO,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;KAClC;IAAC,WAAM;QACN,2EAA2E;QAC3E,OAAO,sCAAsC,CAAC,OAAO,CAAC,OAAO,EAAE,UAAC,SAAS;YACvE,IAAM,KAAK,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,CAAC,SAAS,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;KACJ;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mBAAmB,CAAC,QAAkB,EAAE,KAAa;IACnE,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,EAAE;QACb,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC5E,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;KACpC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import type { SemanticIdentity } from './types';\n\nconst identities = new WeakMap<Document, SemanticIdentity>();\n\nfunction uuid(scope: Window): string {\n try {\n return scope.crypto.randomUUID();\n } catch {\n // Correlation IDs, not credentials. Also supports HTTP and older browsers.\n return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (character) => {\n const value = (Math.random() * 16) | 0;\n return (character === 'x' ? value : (value & 0x3) | 0x8).toString(16);\n });\n }\n}\n\n/** No storage or listeners. Hosts can supply persistent tab identity through getIdentity. */\nexport function getDocumentIdentity(document: Document, scope: Window): SemanticIdentity {\n let identity = identities.get(document);\n if (!identity) {\n identity = Object.freeze({ tab_id: uuid(scope), document_id: uuid(scope) });\n identities.set(document, identity);\n }\n return identity;\n}\n"]}
@@ -1,3 +1,8 @@
1
- export { SEMANTIC_VERSION } from './types';
2
- export type { SemanticIdentity, SemanticEventEnvelope } from './types';
1
+ import type { SemanticCaptureConfig, SemanticHost, SemanticPayloads, SemanticRecorder } from './types';
2
+ export * from './types';
3
+ export type { SemanticCapture } from './capture';
4
+ export { DEFAULT_SEMANTIC_CAP } from './capture';
5
+ export { getDocumentIdentity } from './identity';
6
+ /** Starts only the supplied recorders; no event families are installed by default. */
7
+ export declare function createSemanticCapture<P extends object = SemanticPayloads>(config: SemanticCaptureConfig<P>, host: SemanticHost<P>, recorders?: readonly SemanticRecorder<P>[], caps?: Partial<Record<Extract<keyof P, string>, number>>): import("./capture").SemanticCapture<P>;
3
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEvG,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,gBAAgB,EACvE,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAChC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,EACrB,SAAS,GAAE,SAAS,gBAAgB,CAAC,CAAC,CAAC,EAAO,EAC9C,IAAI,GAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAM,0CAG7D"}
package/lib/esm/index.js CHANGED
@@ -1,2 +1,11 @@
1
- export { SEMANTIC_VERSION } from './types';
1
+ import { createCapture } from './capture';
2
+ export * from './types';
3
+ export { DEFAULT_SEMANTIC_CAP } from './capture';
4
+ export { getDocumentIdentity } from './identity';
5
+ /** Starts only the supplied recorders; no event families are installed by default. */
6
+ export function createSemanticCapture(config, host, recorders, caps) {
7
+ if (recorders === void 0) { recorders = []; }
8
+ if (caps === void 0) { caps = {}; }
9
+ return createCapture(config, host, recorders, caps);
10
+ }
2
11
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC","sourcesContent":["export { SEMANTIC_VERSION } from './types';\nexport type { SemanticIdentity, SemanticEventEnvelope } from './types';\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,sFAAsF;AACtF,MAAM,UAAU,qBAAqB,CACnC,MAAgC,EAChC,IAAqB,EACrB,SAA8C,EAC9C,IAA4D;IAD5D,0BAAA,EAAA,cAA8C;IAC9C,qBAAA,EAAA,SAA4D;IAE5D,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { createCapture } from './capture';\nimport type { SemanticCaptureConfig, SemanticHost, SemanticPayloads, SemanticRecorder } from './types';\n\nexport * from './types';\nexport type { SemanticCapture } from './capture';\nexport { DEFAULT_SEMANTIC_CAP } from './capture';\nexport { getDocumentIdentity } from './identity';\n\n/** Starts only the supplied recorders; no event families are installed by default. */\nexport function createSemanticCapture<P extends object = SemanticPayloads>(\n config: SemanticCaptureConfig<P>,\n host: SemanticHost<P>,\n recorders: readonly SemanticRecorder<P>[] = [],\n caps: Partial<Record<Extract<keyof P, string>, number>> = {},\n) {\n return createCapture(config, host, recorders, caps);\n}\n"]}
@@ -1,6 +1,4 @@
1
- /** Version of the shared semantic payload envelope. */
2
1
  export declare const SEMANTIC_VERSION = 1;
3
- /** Correlation identifiers supplied by a future capture host. */
4
2
  export interface SemanticIdentity {
5
3
  readonly tab_id: string;
6
4
  readonly document_id: string;
@@ -13,4 +11,51 @@ export interface SemanticEventEnvelope<Name extends string, Payload extends obje
13
11
  v: typeof SEMANTIC_VERSION;
14
12
  };
15
13
  }
14
+ /** Runtime consumers supply a map of event names to payload objects. */
15
+ export type SemanticPayloads = Record<string, object>;
16
+ export type SemanticFamily<P extends object = SemanticPayloads> = Extract<keyof P, string>;
17
+ export type SemanticEvent<P extends object = SemanticPayloads> = {
18
+ [K in SemanticFamily<P>]: SemanticEventEnvelope<K, P[K] & object>;
19
+ }[SemanticFamily<P>];
20
+ export interface SemanticCaptureConfig<P extends object = SemanticPayloads> {
21
+ enabled: boolean;
22
+ /** Additional sampling within recorded replay sessions. Defaults to 1. */
23
+ sampleRate?: number;
24
+ /** Registered families are enabled unless explicitly false. */
25
+ families?: Partial<Record<SemanticFamily<P>, boolean>>;
26
+ }
27
+ export interface HostSignals {
28
+ /** An accepted full snapshot, forwarded after the recorder is ready. */
29
+ snapshot: undefined;
30
+ }
31
+ export type Cleanup = () => void;
32
+ /** The host owns transport; the runtime has no rrweb dependency. */
33
+ export interface SemanticHost<P extends object = SemanticPayloads> {
34
+ document: Document;
35
+ window: Window;
36
+ emit: (event: SemanticEvent<P>) => void;
37
+ /** Called lazily for accepted events. Defaults to document-scoped memory only. */
38
+ getIdentity?: () => SemanticIdentity;
39
+ now?: () => number;
40
+ random?: () => number;
41
+ onError?: (error: unknown) => void;
42
+ }
43
+ export interface RecorderContext<P extends object = SemanticPayloads> {
44
+ /** Register resources immediately so failed setup can roll them back. */
45
+ onCleanup: (cleanup: Cleanup) => void;
46
+ host: SemanticHost<P>;
47
+ now: () => number;
48
+ /** Check before expensive payload work. A rejected candidate increments the dropped count. */
49
+ canEmit: (family: SemanticFamily<P>) => boolean;
50
+ emit: <K extends SemanticFamily<P>>(family: K, payload: P[K], timestamp?: number) => boolean;
51
+ on: <K extends keyof HostSignals>(signal: K, callback: (value: HostSignals[K]) => void) => Cleanup;
52
+ /** Peek at dropped counts; a recorder can acknowledge them after successful delivery. */
53
+ dropped: () => Partial<Record<SemanticFamily<P>, number>>;
54
+ clearDropped: () => void;
55
+ }
56
+ /** A factory owns its listeners/timers and returns complete teardown. */
57
+ export interface SemanticRecorder<P extends object = SemanticPayloads> {
58
+ families: readonly SemanticFamily<P>[];
59
+ setup: (context: RecorderContext<P>) => Cleanup;
60
+ }
16
61
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,oFAAoF;AACpF,MAAM,WAAW,qBAAqB,CAAC,IAAI,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM;IAChF,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG;QAAE,CAAC,EAAE,OAAO,gBAAgB,CAAA;KAAE,CAAC;CACtE"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
package/lib/esm/types.js CHANGED
@@ -1,3 +1,2 @@
1
- /** Version of the shared semantic payload envelope. */
2
1
  export var SEMANTIC_VERSION = 1;
3
2
  //# sourceMappingURL=types.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,CAAC,IAAM,gBAAgB,GAAG,CAAC,CAAC","sourcesContent":["/** Version of the shared semantic payload envelope. */\nexport const SEMANTIC_VERSION = 1;\n\n/** Correlation identifiers supplied by a future capture host. */\nexport interface SemanticIdentity {\n readonly tab_id: string;\n readonly document_id: string;\n}\n\n/** Internal event envelope, independent of any event family or replay transport. */\nexport interface SemanticEventEnvelope<Name extends string, Payload extends object> {\n name: Name;\n timestamp: number;\n payload: Payload & SemanticIdentity & { v: typeof SEMANTIC_VERSION };\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,IAAM,gBAAgB,GAAG,CAAC,CAAC","sourcesContent":["export const SEMANTIC_VERSION = 1;\nexport interface SemanticIdentity {\n readonly tab_id: string;\n readonly document_id: string;\n}\n/** Internal event envelope, independent of any event family or replay transport. */\nexport interface SemanticEventEnvelope<Name extends string, Payload extends object> {\n name: Name;\n timestamp: number;\n payload: Payload & SemanticIdentity & { v: typeof SEMANTIC_VERSION };\n}\n\n/** Runtime consumers supply a map of event names to payload objects. */\nexport type SemanticPayloads = Record<string, object>;\nexport type SemanticFamily<P extends object = SemanticPayloads> = Extract<keyof P, string>;\nexport type SemanticEvent<P extends object = SemanticPayloads> = {\n [K in SemanticFamily<P>]: SemanticEventEnvelope<K, P[K] & object>;\n}[SemanticFamily<P>];\nexport interface SemanticCaptureConfig<P extends object = SemanticPayloads> {\n enabled: boolean;\n /** Additional sampling within recorded replay sessions. Defaults to 1. */\n sampleRate?: number;\n /** Registered families are enabled unless explicitly false. */\n families?: Partial<Record<SemanticFamily<P>, boolean>>;\n}\nexport interface HostSignals {\n /** An accepted full snapshot, forwarded after the recorder is ready. */\n snapshot: undefined;\n}\nexport type Cleanup = () => void;\n/** The host owns transport; the runtime has no rrweb dependency. */\nexport interface SemanticHost<P extends object = SemanticPayloads> {\n document: Document;\n window: Window;\n emit: (event: SemanticEvent<P>) => void;\n /** Called lazily for accepted events. Defaults to document-scoped memory only. */\n getIdentity?: () => SemanticIdentity;\n now?: () => number;\n random?: () => number;\n onError?: (error: unknown) => void;\n}\nexport interface RecorderContext<P extends object = SemanticPayloads> {\n /** Register resources immediately so failed setup can roll them back. */\n onCleanup: (cleanup: Cleanup) => void;\n host: SemanticHost<P>;\n now: () => number;\n /** Check before expensive payload work. A rejected candidate increments the dropped count. */\n canEmit: (family: SemanticFamily<P>) => boolean;\n emit: <K extends SemanticFamily<P>>(family: K, payload: P[K], timestamp?: number) => boolean;\n on: <K extends keyof HostSignals>(signal: K, callback: (value: HostSignals[K]) => void) => Cleanup;\n /** Peek at dropped counts; a recorder can acknowledge them after successful delivery. */\n dropped: () => Partial<Record<SemanticFamily<P>, number>>;\n clearDropped: () => void;\n}\n/** A factory owns its listeners/timers and returns complete teardown. */\nexport interface SemanticRecorder<P extends object = SemanticPayloads> {\n families: readonly SemanticFamily<P>[];\n setup: (context: RecorderContext<P>) => Cleanup;\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@amplitude/amp-semantic",
3
- "version": "0.2.0-sr-bfcache-pageshow-snapshot.0",
3
+ "version": "0.2.0",
4
4
  "description": "Shared package foundation for Amplitude semantic event capture",
5
5
  "license": "MIT",
6
6
  "main": "lib/cjs/index.js",