@amplitude/amp-semantic 0.2.0-codexsemantic-review-integration.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.
Files changed (89) hide show
  1. package/README.md +8 -237
  2. package/lib/cjs/capture.d.ts +5 -5
  3. package/lib/cjs/capture.d.ts.map +1 -1
  4. package/lib/cjs/capture.js +48 -56
  5. package/lib/cjs/capture.js.map +1 -1
  6. package/lib/cjs/index.d.ts +4 -13
  7. package/lib/cjs/index.d.ts.map +1 -1
  8. package/lib/cjs/index.js +7 -32
  9. package/lib/cjs/index.js.map +1 -1
  10. package/lib/cjs/types.d.ts +33 -235
  11. package/lib/cjs/types.d.ts.map +1 -1
  12. package/lib/cjs/types.js.map +1 -1
  13. package/lib/esm/capture.d.ts +5 -5
  14. package/lib/esm/capture.d.ts.map +1 -1
  15. package/lib/esm/capture.js +47 -55
  16. package/lib/esm/capture.js.map +1 -1
  17. package/lib/esm/index.d.ts +4 -13
  18. package/lib/esm/index.d.ts.map +1 -1
  19. package/lib/esm/index.js +6 -22
  20. package/lib/esm/index.js.map +1 -1
  21. package/lib/esm/types.d.ts +33 -235
  22. package/lib/esm/types.d.ts.map +1 -1
  23. package/lib/esm/types.js.map +1 -1
  24. package/package.json +8 -10
  25. package/lib/cjs/helpers.d.ts +0 -9
  26. package/lib/cjs/helpers.d.ts.map +0 -1
  27. package/lib/cjs/helpers.js +0 -469
  28. package/lib/cjs/helpers.js.map +0 -1
  29. package/lib/cjs/recorders/analytics.d.ts +0 -7
  30. package/lib/cjs/recorders/analytics.d.ts.map +0 -1
  31. package/lib/cjs/recorders/analytics.js +0 -95
  32. package/lib/cjs/recorders/analytics.js.map +0 -1
  33. package/lib/cjs/recorders/feedback.d.ts +0 -4
  34. package/lib/cjs/recorders/feedback.d.ts.map +0 -1
  35. package/lib/cjs/recorders/feedback.js +0 -611
  36. package/lib/cjs/recorders/feedback.js.map +0 -1
  37. package/lib/cjs/recorders/interactions.d.ts +0 -4
  38. package/lib/cjs/recorders/interactions.d.ts.map +0 -1
  39. package/lib/cjs/recorders/interactions.js +0 -320
  40. package/lib/cjs/recorders/interactions.js.map +0 -1
  41. package/lib/cjs/recorders/keys.d.ts +0 -4
  42. package/lib/cjs/recorders/keys.d.ts.map +0 -1
  43. package/lib/cjs/recorders/keys.js +0 -64
  44. package/lib/cjs/recorders/keys.js.map +0 -1
  45. package/lib/cjs/recorders/lifecycle.d.ts +0 -4
  46. package/lib/cjs/recorders/lifecycle.d.ts.map +0 -1
  47. package/lib/cjs/recorders/lifecycle.js +0 -86
  48. package/lib/cjs/recorders/lifecycle.js.map +0 -1
  49. package/lib/cjs/recorders/navigation.d.ts +0 -4
  50. package/lib/cjs/recorders/navigation.d.ts.map +0 -1
  51. package/lib/cjs/recorders/navigation.js +0 -18
  52. package/lib/cjs/recorders/navigation.js.map +0 -1
  53. package/lib/cjs/recorders/resource-error.d.ts +0 -4
  54. package/lib/cjs/recorders/resource-error.d.ts.map +0 -1
  55. package/lib/cjs/recorders/resource-error.js +0 -159
  56. package/lib/cjs/recorders/resource-error.js.map +0 -1
  57. package/lib/esm/helpers.d.ts +0 -9
  58. package/lib/esm/helpers.d.ts.map +0 -1
  59. package/lib/esm/helpers.js +0 -461
  60. package/lib/esm/helpers.js.map +0 -1
  61. package/lib/esm/recorders/analytics.d.ts +0 -7
  62. package/lib/esm/recorders/analytics.d.ts.map +0 -1
  63. package/lib/esm/recorders/analytics.js +0 -92
  64. package/lib/esm/recorders/analytics.js.map +0 -1
  65. package/lib/esm/recorders/feedback.d.ts +0 -4
  66. package/lib/esm/recorders/feedback.d.ts.map +0 -1
  67. package/lib/esm/recorders/feedback.js +0 -608
  68. package/lib/esm/recorders/feedback.js.map +0 -1
  69. package/lib/esm/recorders/interactions.d.ts +0 -4
  70. package/lib/esm/recorders/interactions.d.ts.map +0 -1
  71. package/lib/esm/recorders/interactions.js +0 -317
  72. package/lib/esm/recorders/interactions.js.map +0 -1
  73. package/lib/esm/recorders/keys.d.ts +0 -4
  74. package/lib/esm/recorders/keys.d.ts.map +0 -1
  75. package/lib/esm/recorders/keys.js +0 -61
  76. package/lib/esm/recorders/keys.js.map +0 -1
  77. package/lib/esm/recorders/lifecycle.d.ts +0 -4
  78. package/lib/esm/recorders/lifecycle.d.ts.map +0 -1
  79. package/lib/esm/recorders/lifecycle.js +0 -83
  80. package/lib/esm/recorders/lifecycle.js.map +0 -1
  81. package/lib/esm/recorders/navigation.d.ts +0 -4
  82. package/lib/esm/recorders/navigation.d.ts.map +0 -1
  83. package/lib/esm/recorders/navigation.js +0 -15
  84. package/lib/esm/recorders/navigation.js.map +0 -1
  85. package/lib/esm/recorders/resource-error.d.ts +0 -4
  86. package/lib/esm/recorders/resource-error.d.ts.map +0 -1
  87. package/lib/esm/recorders/resource-error.js +0 -156
  88. package/lib/esm/recorders/resource-error.js.map +0 -1
  89. package/schema.json +0 -1110
@@ -1,34 +1,19 @@
1
1
  import { __assign, __values } from "tslib";
2
- import { createHelpers } from './helpers';
3
2
  import { getDocumentIdentity } from './identity';
4
- export var SEMANTIC_CAPS = {
5
- click: 2000,
6
- keys: 1000,
7
- 'resource-error': 200,
8
- field: 1000,
9
- submit: 300,
10
- notice: 300,
11
- dialog: 300,
12
- 'amp-event': 500,
13
- context: 200,
14
- recording: 200,
15
- navigation: 200,
16
- visibility: 200,
17
- lifecycle: 200,
18
- };
3
+ export var DEFAULT_SEMANTIC_CAP = 200;
19
4
  /** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
20
- export function createCapture(config, host, recorders) {
5
+ export function createCapture(config, host, recorders, caps) {
21
6
  var _a;
7
+ if (caps === void 0) { caps = {}; }
22
8
  var settings = copyConfig(config);
23
9
  var active = false;
24
10
  var requested = false;
25
- var snapshotSeen = false;
11
+ var attachGeneration = 0;
26
12
  var sample;
27
13
  var cleanups = [];
28
14
  var counts = {};
29
15
  var dropped = {};
30
16
  var signals = new Map();
31
- var subscribers = new Set();
32
17
  var now = (_a = host.now) !== null && _a !== void 0 ? _a : Date.now;
33
18
  var report = function (error) {
34
19
  var _a;
@@ -48,7 +33,7 @@ export function createCapture(config, host, recorders) {
48
33
  }
49
34
  };
50
35
  var enabled = function (family) { var _a; return active && ((_a = settings.families) === null || _a === void 0 ? void 0 : _a[family]) !== false; };
51
- var hasCapacity = function (family) { var _a; return enabled(family) && ((_a = counts[family]) !== null && _a !== void 0 ? _a : 0) < SEMANTIC_CAPS[family]; };
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); };
52
37
  var canEmit = function (family) {
53
38
  var _a;
54
39
  if (!enabled(family))
@@ -60,13 +45,12 @@ export function createCapture(config, host, recorders) {
60
45
  };
61
46
  var context = {
62
47
  host: host,
63
- helpers: createHelpers(host),
64
48
  now: now,
65
- enabled: enabled,
66
49
  canEmit: canEmit,
67
- hasCapacity: hasCapacity,
68
50
  dropped: function () { return (__assign({}, dropped)); },
69
- hasSnapshot: function () { return snapshotSeen; },
51
+ clearDropped: function () {
52
+ dropped = {};
53
+ },
70
54
  emit: function (family, payload, timestamp) {
71
55
  var _a, _b;
72
56
  if (timestamp === void 0) { timestamp = now(); }
@@ -85,17 +69,17 @@ export function createCapture(config, host, recorders) {
85
69
  payload: __assign(__assign({}, payload), { v: 1, tab_id: identity.tab_id, document_id: identity.document_id }),
86
70
  timestamp: timestamp,
87
71
  };
88
- counts[family] = ((_b = counts[family]) !== null && _b !== void 0 ? _b : 0) + 1;
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;
89
75
  try {
90
76
  host.emit(event);
91
77
  }
92
78
  catch (error) {
79
+ reservedCounts[family] = reservedCounts[family] - 1;
93
80
  report(error);
94
81
  return false;
95
82
  }
96
- if (family === 'context')
97
- dropped = {};
98
- subscribers.forEach(function (subscriber) { return safely(function () { return subscriber(event); }); });
99
83
  return true;
100
84
  },
101
85
  on: function (signal, callback) {
@@ -111,20 +95,14 @@ export function createCapture(config, host, recorders) {
111
95
  registered.delete(listener);
112
96
  };
113
97
  },
114
- subscribe: function (callback) {
115
- subscribers.add(callback);
116
- return function () {
117
- subscribers.delete(callback);
118
- };
119
- },
120
98
  };
121
99
  var detach = function () {
122
100
  active = false;
101
+ attachGeneration += 1;
123
102
  var previous = cleanups;
124
103
  cleanups = [];
125
104
  previous.reverse().forEach(function (cleanup) { return safely(cleanup); });
126
105
  signals.clear();
127
- subscribers.clear();
128
106
  };
129
107
  var attach = function () {
130
108
  var e_1, _a;
@@ -138,41 +116,61 @@ export function createCapture(config, host, recorders) {
138
116
  sample = ((_c = host.random) !== null && _c !== void 0 ? _c : Math.random)();
139
117
  if (sample >= rate)
140
118
  return;
119
+ var myGeneration = attachGeneration + 1;
120
+ attachGeneration = myGeneration;
141
121
  active = true;
142
122
  var _loop_1 = function (recorder) {
143
123
  if (recorder.families.some(enabled)) {
144
124
  var acquired_1 = [];
145
- var scoped = __assign(__assign({}, context), { onCleanup: function (cleanup) {
125
+ var registerCleanup_1 = function (cleanup) {
126
+ if (!acquired_1.includes(cleanup))
146
127
  acquired_1.push(cleanup);
147
- }, on: function (signal, callback) {
128
+ };
129
+ var scoped = __assign(__assign({}, context), { onCleanup: registerCleanup_1, on: function (signal, callback) {
148
130
  var cleanup = context.on(signal, callback);
149
- acquired_1.push(cleanup);
150
- return cleanup;
151
- }, subscribe: function (callback) {
152
- var cleanup = context.subscribe(callback);
153
- acquired_1.push(cleanup);
131
+ registerCleanup_1(cleanup);
154
132
  return cleanup;
155
133
  } });
156
- var rollback = function () {
134
+ var rollback_1 = function () {
157
135
  acquired_1
158
136
  .splice(0)
159
137
  .reverse()
160
138
  .forEach(function (cleanup) { return safely(cleanup); });
161
139
  };
140
+ var unregisterRollback = function () {
141
+ var index = cleanups.lastIndexOf(rollback_1);
142
+ if (index >= 0)
143
+ cleanups.splice(index, 1);
144
+ };
162
145
  try {
163
- acquired_1.push(recorder.setup(scoped));
164
- cleanups.push(rollback);
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
+ }
165
158
  }
166
159
  catch (error) {
167
- rollback();
160
+ unregisterRollback();
161
+ rollback_1();
168
162
  report(error);
163
+ if (myGeneration !== attachGeneration)
164
+ return "break";
169
165
  }
170
166
  }
171
167
  };
172
168
  try {
173
169
  for (var recorders_1 = __values(recorders), recorders_1_1 = recorders_1.next(); !recorders_1_1.done; recorders_1_1 = recorders_1.next()) {
174
170
  var recorder = recorders_1_1.value;
175
- _loop_1(recorder);
171
+ var state_1 = _loop_1(recorder);
172
+ if (state_1 === "break")
173
+ break;
176
174
  }
177
175
  }
178
176
  catch (e_1_1) { e_1 = { error: e_1_1 }; }
@@ -191,7 +189,6 @@ export function createCapture(config, host, recorders) {
191
189
  },
192
190
  stop: function () {
193
191
  requested = false;
194
- snapshotSeen = false;
195
192
  detach();
196
193
  },
197
194
  updateConfig: function (next) {
@@ -202,20 +199,15 @@ export function createCapture(config, host, recorders) {
202
199
  resetSession: function () {
203
200
  detach();
204
201
  sample = undefined;
205
- snapshotSeen = false;
206
202
  counts = {};
207
203
  dropped = {};
208
204
  attach();
209
205
  },
210
206
  notify: function (signal, value) {
211
- var _a, _b, _c;
212
- if (signal === 'snapshot')
213
- snapshotSeen = true;
214
- if (signal === 'snapshot' || signal === 'navigation' || signal === 'url')
215
- (_b = (_a = context.helpers).invalidateHeading) === null || _b === void 0 ? void 0 : _b.call(_a);
207
+ var _a;
216
208
  if (!active)
217
209
  return;
218
- (_c = signals.get(signal)) === null || _c === void 0 ? void 0 : _c.forEach(function (callback) { return callback(value); });
210
+ (_a = signals.get(signal)) === null || _a === void 0 ? void 0 : _a.forEach(function (callback) { return callback(value); });
219
211
  },
220
212
  };
221
213
  }
@@ -1 +1 @@
1
- {"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHelpers } from './helpers';\nimport { 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 SEMANTIC_CAPS: Record<SemanticFamily, number> = {\n click: 2000,\n keys: 1000,\n 'resource-error': 200,\n field: 1000,\n submit: 300,\n notice: 300,\n dialog: 300,\n 'amp-event': 500,\n context: 200,\n recording: 200,\n navigation: 200,\n visibility: 200,\n lifecycle: 200,\n};\n\nexport interface SemanticCapture {\n isActive: () => boolean;\n start: () => void;\n stop: () => void;\n updateConfig: (config: SemanticCaptureConfig) => 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(\n config: SemanticCaptureConfig,\n host: SemanticHost,\n recorders: readonly SemanticRecorder[],\n): SemanticCapture {\n let settings = copyConfig(config);\n let active = false;\n let requested = false;\n let snapshotSeen = false;\n let sample: number | undefined;\n let cleanups: Cleanup[] = [];\n let counts: Partial<Record<SemanticFamily, number>> = {};\n let dropped: Partial<Record<SemanticFamily, number>> = {};\n const signals = new Map<keyof HostSignals, Set<(value: never) => void>>();\n const subscribers = new Set<(event: SemanticEvent) => 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) => active && settings.families?.[family] !== false;\n const hasCapacity = (family: SemanticFamily) => enabled(family) && (counts[family] ?? 0) < SEMANTIC_CAPS[family];\n const canEmit = (family: SemanticFamily): 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, 'onCleanup'> = {\n host,\n helpers: createHelpers(host),\n now,\n enabled,\n canEmit,\n hasCapacity,\n dropped: () => ({ ...dropped }),\n hasSnapshot: () => snapshotSeen,\n emit: <K extends SemanticFamily>(family: K, payload: SemanticPayloads[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;\n counts[family] = (counts[family] ?? 0) + 1;\n try {\n host.emit(event);\n } catch (error) {\n report(error);\n return false;\n }\n if (family === 'context') dropped = {};\n subscribers.forEach((subscriber) => safely(() => subscriber(event)));\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 subscribe: (callback) => {\n subscribers.add(callback);\n return () => {\n subscribers.delete(callback);\n };\n },\n };\n const detach = () => {\n active = false;\n const previous = cleanups;\n cleanups = [];\n previous.reverse().forEach((cleanup) => safely(cleanup));\n signals.clear();\n subscribers.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 active = true;\n for (const recorder of recorders) {\n if (recorder.families.some(enabled)) {\n const acquired: Cleanup[] = [];\n const scoped: RecorderContext = {\n ...context,\n onCleanup: (cleanup) => {\n acquired.push(cleanup);\n },\n on: (signal, callback) => {\n const cleanup = context.on(signal, callback);\n acquired.push(cleanup);\n return cleanup;\n },\n subscribe: (callback) => {\n const cleanup = context.subscribe(callback);\n acquired.push(cleanup);\n return cleanup;\n },\n };\n const rollback = () => {\n acquired\n .splice(0)\n .reverse()\n .forEach((cleanup) => safely(cleanup));\n };\n try {\n acquired.push(recorder.setup(scoped));\n cleanups.push(rollback);\n } catch (error) {\n rollback();\n report(error);\n }\n }\n }\n };\n return {\n isActive: () => active,\n start: () => {\n requested = true;\n attach();\n },\n stop: () => {\n requested = false;\n snapshotSeen = false;\n detach();\n },\n updateConfig: (next) => {\n detach();\n settings = copyConfig(next);\n attach();\n },\n resetSession: () => {\n detach();\n sample = undefined;\n snapshotSeen = false;\n counts = {};\n dropped = {};\n attach();\n },\n notify: (signal, value) => {\n if (signal === 'snapshot') snapshotSeen = true;\n if (signal === 'snapshot' || signal === 'navigation' || signal === 'url') context.helpers.invalidateHeading?.();\n if (!active) return;\n signals.get(signal)?.forEach((callback) => callback(value as never));\n },\n };\n}\n\nfunction copyConfig(config: SemanticCaptureConfig): SemanticCaptureConfig {\n return { ...config, families: config.families ? { ...config.families } : undefined };\n}\n"]}
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"]}
@@ -1,17 +1,8 @@
1
- import { interactionsRecorder } from './recorders/interactions';
2
- import { feedbackRecorder } from './recorders/feedback';
3
- import { navigationRecorder } from './recorders/navigation';
4
- import { lifecycleRecorder } from './recorders/lifecycle';
5
- import { keysRecorder } from './recorders/keys';
6
- import { resourceErrorRecorder } from './recorders/resource-error';
7
- import { analyticsRecorder } from './recorders/analytics';
8
- import type { SemanticCaptureConfig, SemanticHost, SemanticRecorder } from './types';
9
- export { interactionsRecorder, feedbackRecorder, lifecycleRecorder, navigationRecorder, analyticsRecorder, keysRecorder, resourceErrorRecorder, };
10
- export declare const defaultRecorders: readonly SemanticRecorder[];
1
+ import type { SemanticCaptureConfig, SemanticHost, SemanticPayloads, SemanticRecorder } from './types';
11
2
  export * from './types';
12
3
  export type { SemanticCapture } from './capture';
13
- export { SEMANTIC_CAPS } from './capture';
14
- export { createHelpers, roleOf, urlTemplate } from './helpers';
4
+ export { DEFAULT_SEMANTIC_CAP } from './capture';
15
5
  export { getDocumentIdentity } from './identity';
16
- export declare function createSemanticCapture(config: SemanticCaptureConfig, host: SemanticHost, recorders?: readonly SemanticRecorder[]): import("./capture").SemanticCapture;
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>;
17
8
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErF,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,CAAC;AACF,eAAO,MAAM,gBAAgB,EAAE,SAAS,gBAAgB,EAQvD,CAAC;AAEF,cAAc,SAAS,CAAC;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,YAAY,EAClB,SAAS,GAAE,SAAS,gBAAgB,EAAqB,uCAG1D"}
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,27 +1,11 @@
1
1
  import { createCapture } from './capture';
2
- import { interactionsRecorder } from './recorders/interactions';
3
- import { feedbackRecorder } from './recorders/feedback';
4
- import { navigationRecorder } from './recorders/navigation';
5
- import { lifecycleRecorder } from './recorders/lifecycle';
6
- import { keysRecorder } from './recorders/keys';
7
- import { resourceErrorRecorder } from './recorders/resource-error';
8
- import { analyticsRecorder } from './recorders/analytics';
9
- export { interactionsRecorder, feedbackRecorder, lifecycleRecorder, navigationRecorder, analyticsRecorder, keysRecorder, resourceErrorRecorder, };
10
- export var defaultRecorders = [
11
- interactionsRecorder,
12
- feedbackRecorder,
13
- lifecycleRecorder,
14
- navigationRecorder,
15
- analyticsRecorder,
16
- keysRecorder,
17
- resourceErrorRecorder,
18
- ];
19
2
  export * from './types';
20
- export { SEMANTIC_CAPS } from './capture';
21
- export { createHelpers, roleOf, urlTemplate } from './helpers';
3
+ export { DEFAULT_SEMANTIC_CAP } from './capture';
22
4
  export { getDocumentIdentity } from './identity';
23
- export function createSemanticCapture(config, host, recorders) {
24
- if (recorders === void 0) { recorders = defaultRecorders; }
25
- return createCapture(config, host, recorders);
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);
26
10
  }
27
11
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,CAAC;AACF,MAAM,CAAC,IAAM,gBAAgB,GAAgC;IAC3D,oBAAoB;IACpB,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,YAAY;IACZ,qBAAqB;CACtB,CAAC;AAEF,cAAc,SAAS,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,UAAU,qBAAqB,CACnC,MAA6B,EAC7B,IAAkB,EAClB,SAAyD;IAAzD,0BAAA,EAAA,4BAAyD;IAEzD,OAAO,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import { createCapture } from './capture';\nimport { interactionsRecorder } from './recorders/interactions';\nimport { feedbackRecorder } from './recorders/feedback';\nimport { navigationRecorder } from './recorders/navigation';\nimport { lifecycleRecorder } from './recorders/lifecycle';\nimport { keysRecorder } from './recorders/keys';\nimport { resourceErrorRecorder } from './recorders/resource-error';\nimport { analyticsRecorder } from './recorders/analytics';\nimport type { SemanticCaptureConfig, SemanticHost, SemanticRecorder } from './types';\n\nexport {\n interactionsRecorder,\n feedbackRecorder,\n lifecycleRecorder,\n navigationRecorder,\n analyticsRecorder,\n keysRecorder,\n resourceErrorRecorder,\n};\nexport const defaultRecorders: readonly SemanticRecorder[] = [\n interactionsRecorder,\n feedbackRecorder,\n lifecycleRecorder,\n navigationRecorder,\n analyticsRecorder,\n keysRecorder,\n resourceErrorRecorder,\n];\n\nexport * from './types';\nexport type { SemanticCapture } from './capture';\nexport { SEMANTIC_CAPS } from './capture';\nexport { createHelpers, roleOf, urlTemplate } from './helpers';\nexport { getDocumentIdentity } from './identity';\n\nexport function createSemanticCapture(\n config: SemanticCaptureConfig,\n host: SemanticHost,\n recorders: readonly SemanticRecorder[] = defaultRecorders,\n) {\n return createCapture(config, host, recorders);\n}\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,263 +1,61 @@
1
- import type { PrivacyConfig } from '@amplitude/session-replay-dom-privacy';
2
1
  export declare const SEMANTIC_VERSION = 1;
3
- export type NameSource = 'aria-labelledby' | 'aria-label' | 'label-for' | 'label-wrap' | 'alt' | 'value' | 'title' | 'text' | 'placeholder' | 'masked' | 'unnamed';
4
- export interface TargetDescription {
5
- id: number | null;
6
- role: string;
7
- name: string | null;
8
- }
9
- export interface NamedTarget extends TargetDescription {
10
- name_source: NameSource;
11
- }
12
- export type NavigationReason = 'load' | 'push' | 'replace' | 'pop' | 'hash' | 'title';
13
- export interface RecordingSignal {
14
- state: 'start' | 'stop' | 'pause' | 'resume';
15
- reason: 'init' | 'new_session' | 'customer_stop' | 'sampled_out' | 'opt_out' | 'targeting' | 'focus' | 'error';
16
- }
17
- export interface AnalyticsContext {
18
- present: boolean;
19
- autocapture: string[];
20
- }
21
2
  export interface SemanticIdentity {
22
3
  readonly tab_id: string;
23
4
  readonly document_id: string;
24
5
  }
25
- /** Recorder payloads exclude version and identity, which are owned by the capture runtime. */
26
- export interface SemanticPayloads {
27
- context: {
28
- sdk: string;
29
- mask: 'light' | 'medium' | 'conservative';
30
- css: {
31
- total: number;
32
- inlined: number;
33
- unreadable: number;
34
- };
35
- viewport: {
36
- w: number;
37
- h: number;
38
- };
39
- device: 'desktop' | 'tablet' | 'mobile';
40
- language: string;
41
- visibility_state: 'hidden' | 'visible';
42
- focused: boolean;
43
- user_agent: string;
44
- analytics_sdk: AnalyticsContext;
45
- caps_hit?: Partial<Record<SemanticFamily, number>>;
46
- };
47
- click: NamedTarget & {
48
- container: TargetDescription | null;
49
- states: string[];
50
- visible: boolean;
51
- key: string | null;
52
- selector?: string | null;
53
- attrs: Record<string, string>;
54
- url: string;
55
- heading: string | null;
56
- keyboard: boolean;
57
- modifiers: string[];
58
- trusted: boolean;
59
- };
60
- keys: {
61
- key: string;
62
- target: NamedTarget & {
63
- states: string[];
64
- };
65
- };
66
- 'resource-error': {
67
- rt: 'img' | 'css' | 'font' | 'script';
68
- count: number;
69
- container?: TargetDescription;
70
- path?: string;
71
- };
72
- field: NamedTarget & {
73
- states: string[];
74
- kind: string;
75
- value_state: 'empty' | 'filled';
76
- /** Unmasked native input/textarea value; omitted for sensitive and non-scalar controls. */
77
- value?: string;
78
- checked?: boolean;
79
- valid: boolean;
80
- validity: string[];
81
- masked: boolean;
82
- option_label: string | null;
83
- };
84
- submit: {
85
- form: TargetDescription;
86
- submitter: TargetDescription | null;
87
- valid: boolean;
88
- invalid_fields: {
89
- id: number | null;
90
- name: string | null;
91
- validity: string[];
92
- }[];
93
- prevented: boolean;
94
- };
95
- notice: {
96
- id: number | null;
97
- role: 'alert' | 'status' | 'log' | 'live';
98
- text: string | null;
99
- visible: boolean;
100
- region: {
101
- role: string;
102
- name: string | null;
103
- } | null;
104
- cause_click_ts: number | null;
105
- };
106
- dialog: NamedTarget & {
107
- role: 'dialog' | 'alertdialog';
108
- state: 'open' | 'closed';
109
- modal: boolean;
110
- visible: boolean;
111
- cause_click_ts: number | null;
112
- };
113
- navigation: {
114
- url: string;
115
- };
116
- recording: RecordingSignal;
117
- visibility: {
118
- state: 'hidden' | 'visible';
119
- };
120
- lifecycle: {
121
- type: 'pagehide' | 'pageshow' | 'pageshow_bfcache' | 'freeze' | 'resume';
122
- };
123
- 'amp-event': {
124
- event_type: string;
125
- insert_id: string | null;
126
- id: number | null;
127
- props: Record<string, string | number | null>;
128
- };
129
- }
130
- export type SemanticFamily = keyof SemanticPayloads;
131
- export type SemanticEvent = {
132
- [K in SemanticFamily]: {
133
- name: K;
134
- payload: SemanticPayloads[K] & SemanticIdentity & {
135
- v: 1;
136
- };
137
- timestamp: number;
138
- };
139
- }[SemanticFamily];
140
- export interface SemanticCaptureConfig {
6
+ /** Internal event envelope, independent of any event family or replay transport. */
7
+ export interface SemanticEventEnvelope<Name extends string, Payload extends object> {
8
+ name: Name;
9
+ timestamp: number;
10
+ payload: Payload & SemanticIdentity & {
11
+ v: typeof SEMANTIC_VERSION;
12
+ };
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> {
141
21
  enabled: boolean;
22
+ /** Additional sampling within recorded replay sessions. Defaults to 1. */
142
23
  sampleRate?: number;
143
- families?: Partial<Record<SemanticFamily, boolean>>;
24
+ /** Registered families are enabled unless explicitly false. */
25
+ families?: Partial<Record<SemanticFamily<P>, boolean>>;
144
26
  }
145
- /** Forward only after analytics enrichment/filtering has accepted this event for delivery. */
146
- export interface AcceptedAnalyticsEvent {
147
- eventType: string;
148
- insertId?: string;
149
- properties: Record<string, unknown>;
150
- element?: Element;
151
- }
152
- /** Structural replay input; no dependency on a particular recorder implementation. */
153
- export interface SemanticDomNode {
154
- id: number;
155
- type: number;
156
- tagName?: string;
157
- attributes?: Record<string, unknown>;
158
- childNodes?: SemanticDomNode[];
159
- }
160
- export type SemanticDomChange = {
161
- type: 'snapshot';
162
- node: SemanticDomNode;
163
- } | {
164
- type: 'mutation';
165
- adds: {
166
- parentId: number;
167
- node: SemanticDomNode;
168
- }[];
169
- removes: {
170
- parentId: number;
171
- id: number;
172
- }[];
173
- texts: {
174
- id: number;
175
- }[];
176
- attributes: {
177
- id: number;
178
- attributes: Record<string, unknown>;
179
- }[];
180
- };
181
27
  export interface HostSignals {
182
- dom: SemanticDomChange;
183
- /** Accepted URL-plugin input, already filtered by the host URL policy. */
184
- url: {
185
- url: string;
186
- timestamp: number;
187
- };
28
+ /** An accepted full snapshot, forwarded after the recorder is ready. */
188
29
  snapshot: undefined;
189
- navigation: NavigationReason;
190
- recording: RecordingSignal;
191
- click: MouseEvent;
192
- analytics: AcceptedAnalyticsEvent;
193
30
  }
194
31
  export type Cleanup = () => void;
195
- /** Host dependencies are injected: this package does not import rrweb or an analytics SDK. */
196
- export interface SemanticHost {
32
+ /** The host owns transport; the runtime has no rrweb dependency. */
33
+ export interface SemanticHost<P extends object = SemanticPayloads> {
197
34
  document: Document;
198
35
  window: Window;
199
- emit: (event: SemanticEvent) => void;
200
- getNodeId: (node: Node) => number;
201
- /** Resolve recorded nodes for notice/dialog enrichment. Requires notify('dom', ...). */
202
- getNode?: (id: number) => Node | null;
203
- getPrivacy: () => PrivacyConfig;
204
- getUrl: () => string;
205
- sdk: string;
206
- getAnalyticsContext?: () => AnalyticsContext;
207
- /** Stable document identity; called lazily for accepted events. Default is document-scoped memory only. */
36
+ emit: (event: SemanticEvent<P>) => void;
37
+ /** Called lazily for accepted events. Defaults to document-scoped memory only. */
208
38
  getIdentity?: () => SemanticIdentity;
209
- getSelector?: (element: Element) => string | null;
210
- /** True when the host forwards native clicks via notify('click', event). */
211
- externalClicks?: boolean;
212
- /** Override when the host supplies primary clicks but not auxclick. Defaults to externalClicks. */
213
- externalAuxClicks?: boolean;
214
- inlineStylesheet?: boolean;
215
39
  now?: () => number;
216
40
  random?: () => number;
217
41
  onError?: (error: unknown) => void;
218
42
  }
219
- export interface SemanticHelpers {
220
- id: (element: Element) => number | null;
221
- blocked: (element: Element) => boolean;
222
- masked: (element: Element) => boolean;
223
- text: (element: Element, value?: string | null, limit?: number) => string | null;
224
- name: (element: Element) => {
225
- name: string | null;
226
- source: NameSource;
227
- };
228
- role: (element: Element) => string;
229
- states: (element: Element) => string[];
230
- describe: (element: Element) => NamedTarget;
231
- actionable: (element: Element) => Element;
232
- container: (element: Element) => TargetDescription | null;
233
- visible: (element: Element) => boolean;
234
- heading: () => string | null;
235
- invalidateHeading?: () => void;
236
- url: (value?: string) => string;
237
- attributes: (element: Element) => Record<string, string>;
238
- }
239
- export interface RecorderContext {
43
+ export interface RecorderContext<P extends object = SemanticPayloads> {
240
44
  /** Register resources immediately so failed setup can roll them back. */
241
45
  onCleanup: (cleanup: Cleanup) => void;
242
- host: SemanticHost;
243
- helpers: SemanticHelpers;
46
+ host: SemanticHost<P>;
244
47
  now: () => number;
245
- enabled: (family: SemanticFamily) => boolean;
246
- /** Check session capacity without counting a dropped event. */
247
- hasCapacity: (family: SemanticFamily) => boolean;
248
48
  /** Check before expensive payload work. A rejected candidate increments the dropped count. */
249
- canEmit: (family: SemanticFamily) => boolean;
250
- emit: <K extends SemanticFamily>(family: K, payload: SemanticPayloads[K], timestamp?: number) => boolean;
49
+ canEmit: (family: SemanticFamily<P>) => boolean;
50
+ emit: <K extends SemanticFamily<P>>(family: K, payload: P[K], timestamp?: number) => boolean;
251
51
  on: <K extends keyof HostSignals>(signal: K, callback: (value: HostSignals[K]) => void) => Cleanup;
252
- subscribe: (callback: (event: SemanticEvent) => void) => Cleanup;
253
- /** Peek until a context event successfully emits; runtime then clears these counts. */
254
- dropped: () => Partial<Record<SemanticFamily, number>>;
255
- /** Preserves page readiness when families are reconfigured mid-recording. */
256
- hasSnapshot?: () => boolean;
52
+ /** Peek at dropped counts; a recorder can acknowledge them after successful delivery. */
53
+ dropped: () => Partial<Record<SemanticFamily<P>, number>>;
54
+ clearDropped: () => void;
257
55
  }
258
56
  /** A factory owns its listeners/timers and returns complete teardown. */
259
- export interface SemanticRecorder {
260
- families: readonly SemanticFamily[];
261
- setup: (context: RecorderContext) => Cleanup;
57
+ export interface SemanticRecorder<P extends object = SemanticPayloads> {
58
+ families: readonly SemanticFamily<P>[];
59
+ setup: (context: RecorderContext<P>) => Cleanup;
262
60
  }
263
61
  //# sourceMappingURL=types.d.ts.map