@amplitude/amp-semantic 0.0.0-stage → 0.2.0-codexsemantic-review-integration.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/LICENSE +21 -0
- package/README.md +245 -2
- package/lib/cjs/capture.d.ts +13 -0
- package/lib/cjs/capture.d.ts.map +1 -0
- package/lib/cjs/capture.js +229 -0
- package/lib/cjs/capture.js.map +1 -0
- package/lib/cjs/helpers.d.ts +9 -0
- package/lib/cjs/helpers.d.ts.map +1 -0
- package/lib/cjs/helpers.js +469 -0
- package/lib/cjs/helpers.js.map +1 -0
- package/lib/cjs/identity.d.ts +4 -0
- package/lib/cjs/identity.d.ts.map +1 -0
- package/lib/cjs/identity.js +27 -0
- package/lib/cjs/identity.js.map +1 -0
- package/lib/cjs/index.d.ts +17 -0
- package/lib/cjs/index.d.ts.map +1 -0
- package/lib/cjs/index.js +43 -0
- package/lib/cjs/index.js.map +1 -0
- package/lib/cjs/recorders/analytics.d.ts +7 -0
- package/lib/cjs/recorders/analytics.d.ts.map +1 -0
- package/lib/cjs/recorders/analytics.js +95 -0
- package/lib/cjs/recorders/analytics.js.map +1 -0
- package/lib/cjs/recorders/feedback.d.ts +4 -0
- package/lib/cjs/recorders/feedback.d.ts.map +1 -0
- package/lib/cjs/recorders/feedback.js +611 -0
- package/lib/cjs/recorders/feedback.js.map +1 -0
- package/lib/cjs/recorders/interactions.d.ts +4 -0
- package/lib/cjs/recorders/interactions.d.ts.map +1 -0
- package/lib/cjs/recorders/interactions.js +320 -0
- package/lib/cjs/recorders/interactions.js.map +1 -0
- package/lib/cjs/recorders/keys.d.ts +4 -0
- package/lib/cjs/recorders/keys.d.ts.map +1 -0
- package/lib/cjs/recorders/keys.js +64 -0
- package/lib/cjs/recorders/keys.js.map +1 -0
- package/lib/cjs/recorders/lifecycle.d.ts +4 -0
- package/lib/cjs/recorders/lifecycle.d.ts.map +1 -0
- package/lib/cjs/recorders/lifecycle.js +86 -0
- package/lib/cjs/recorders/lifecycle.js.map +1 -0
- package/lib/cjs/recorders/navigation.d.ts +4 -0
- package/lib/cjs/recorders/navigation.d.ts.map +1 -0
- package/lib/cjs/recorders/navigation.js +18 -0
- package/lib/cjs/recorders/navigation.js.map +1 -0
- package/lib/cjs/recorders/resource-error.d.ts +4 -0
- package/lib/cjs/recorders/resource-error.d.ts.map +1 -0
- package/lib/cjs/recorders/resource-error.js +159 -0
- package/lib/cjs/recorders/resource-error.js.map +1 -0
- package/lib/cjs/types.d.ts +263 -0
- package/lib/cjs/types.d.ts.map +1 -0
- package/lib/cjs/types.js +5 -0
- package/lib/cjs/types.js.map +1 -0
- package/lib/esm/capture.d.ts +13 -0
- package/lib/esm/capture.d.ts.map +1 -0
- package/lib/esm/capture.js +225 -0
- package/lib/esm/capture.js.map +1 -0
- package/lib/esm/helpers.d.ts +9 -0
- package/lib/esm/helpers.d.ts.map +1 -0
- package/lib/esm/helpers.js +461 -0
- package/lib/esm/helpers.js.map +1 -0
- package/lib/esm/identity.d.ts +4 -0
- package/lib/esm/identity.d.ts.map +1 -0
- package/lib/esm/identity.js +23 -0
- package/lib/esm/identity.js.map +1 -0
- package/lib/esm/index.d.ts +17 -0
- package/lib/esm/index.d.ts.map +1 -0
- package/lib/esm/index.js +27 -0
- package/lib/esm/index.js.map +1 -0
- package/lib/esm/recorders/analytics.d.ts +7 -0
- package/lib/esm/recorders/analytics.d.ts.map +1 -0
- package/lib/esm/recorders/analytics.js +92 -0
- package/lib/esm/recorders/analytics.js.map +1 -0
- package/lib/esm/recorders/feedback.d.ts +4 -0
- package/lib/esm/recorders/feedback.d.ts.map +1 -0
- package/lib/esm/recorders/feedback.js +608 -0
- package/lib/esm/recorders/feedback.js.map +1 -0
- package/lib/esm/recorders/interactions.d.ts +4 -0
- package/lib/esm/recorders/interactions.d.ts.map +1 -0
- package/lib/esm/recorders/interactions.js +317 -0
- package/lib/esm/recorders/interactions.js.map +1 -0
- package/lib/esm/recorders/keys.d.ts +4 -0
- package/lib/esm/recorders/keys.d.ts.map +1 -0
- package/lib/esm/recorders/keys.js +61 -0
- package/lib/esm/recorders/keys.js.map +1 -0
- package/lib/esm/recorders/lifecycle.d.ts +4 -0
- package/lib/esm/recorders/lifecycle.d.ts.map +1 -0
- package/lib/esm/recorders/lifecycle.js +83 -0
- package/lib/esm/recorders/lifecycle.js.map +1 -0
- package/lib/esm/recorders/navigation.d.ts +4 -0
- package/lib/esm/recorders/navigation.d.ts.map +1 -0
- package/lib/esm/recorders/navigation.js +15 -0
- package/lib/esm/recorders/navigation.js.map +1 -0
- package/lib/esm/recorders/resource-error.d.ts +4 -0
- package/lib/esm/recorders/resource-error.d.ts.map +1 -0
- package/lib/esm/recorders/resource-error.js +156 -0
- package/lib/esm/recorders/resource-error.js.map +1 -0
- package/lib/esm/types.d.ts +263 -0
- package/lib/esm/types.d.ts.map +1 -0
- package/lib/esm/types.js +2 -0
- package/lib/esm/types.js.map +1 -0
- package/package.json +35 -3
- package/schema.json +1110 -0
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { HostSignals, SemanticCaptureConfig, SemanticFamily, SemanticHost, SemanticRecorder } from './types';
|
|
2
|
+
export declare const SEMANTIC_CAPS: Record<SemanticFamily, number>;
|
|
3
|
+
export interface SemanticCapture {
|
|
4
|
+
isActive: () => boolean;
|
|
5
|
+
start: () => void;
|
|
6
|
+
stop: () => void;
|
|
7
|
+
updateConfig: (config: SemanticCaptureConfig) => 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(config: SemanticCaptureConfig, host: SemanticHost, recorders: readonly SemanticRecorder[]): SemanticCapture;
|
|
13
|
+
//# sourceMappingURL=capture.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/capture.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,WAAW,EAEX,qBAAqB,EAErB,cAAc,EACd,YAAY,EAEZ,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAcxD,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,YAAY,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,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,CAC3B,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,YAAY,EAClB,SAAS,EAAE,SAAS,gBAAgB,EAAE,GACrC,eAAe,CAyKjB"}
|
|
@@ -0,0 +1,225 @@
|
|
|
1
|
+
import { __assign, __values } from "tslib";
|
|
2
|
+
import { createHelpers } from './helpers';
|
|
3
|
+
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
|
+
};
|
|
19
|
+
/** Composable runtime. Sampling and caps belong to a session, listeners to a recording. */
|
|
20
|
+
export function createCapture(config, host, recorders) {
|
|
21
|
+
var _a;
|
|
22
|
+
var settings = copyConfig(config);
|
|
23
|
+
var active = false;
|
|
24
|
+
var requested = false;
|
|
25
|
+
var snapshotSeen = false;
|
|
26
|
+
var sample;
|
|
27
|
+
var cleanups = [];
|
|
28
|
+
var counts = {};
|
|
29
|
+
var dropped = {};
|
|
30
|
+
var signals = new Map();
|
|
31
|
+
var subscribers = new Set();
|
|
32
|
+
var now = (_a = host.now) !== null && _a !== void 0 ? _a : Date.now;
|
|
33
|
+
var report = function (error) {
|
|
34
|
+
var _a;
|
|
35
|
+
try {
|
|
36
|
+
(_a = host.onError) === null || _a === void 0 ? void 0 : _a.call(host, error);
|
|
37
|
+
}
|
|
38
|
+
catch (_b) {
|
|
39
|
+
/* Diagnostics must not affect the host. */
|
|
40
|
+
}
|
|
41
|
+
};
|
|
42
|
+
var safely = function (fn) {
|
|
43
|
+
try {
|
|
44
|
+
fn();
|
|
45
|
+
}
|
|
46
|
+
catch (error) {
|
|
47
|
+
report(error);
|
|
48
|
+
}
|
|
49
|
+
};
|
|
50
|
+
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]; };
|
|
52
|
+
var canEmit = function (family) {
|
|
53
|
+
var _a;
|
|
54
|
+
if (!enabled(family))
|
|
55
|
+
return false;
|
|
56
|
+
if (hasCapacity(family))
|
|
57
|
+
return true;
|
|
58
|
+
dropped[family] = ((_a = dropped[family]) !== null && _a !== void 0 ? _a : 0) + 1;
|
|
59
|
+
return false;
|
|
60
|
+
};
|
|
61
|
+
var context = {
|
|
62
|
+
host: host,
|
|
63
|
+
helpers: createHelpers(host),
|
|
64
|
+
now: now,
|
|
65
|
+
enabled: enabled,
|
|
66
|
+
canEmit: canEmit,
|
|
67
|
+
hasCapacity: hasCapacity,
|
|
68
|
+
dropped: function () { return (__assign({}, dropped)); },
|
|
69
|
+
hasSnapshot: function () { return snapshotSeen; },
|
|
70
|
+
emit: function (family, payload, timestamp) {
|
|
71
|
+
var _a, _b;
|
|
72
|
+
if (timestamp === void 0) { timestamp = now(); }
|
|
73
|
+
if (!canEmit(family))
|
|
74
|
+
return false;
|
|
75
|
+
var identity;
|
|
76
|
+
try {
|
|
77
|
+
identity = (_a = host.getIdentity) === null || _a === void 0 ? void 0 : _a.call(host);
|
|
78
|
+
}
|
|
79
|
+
catch (error) {
|
|
80
|
+
report(error);
|
|
81
|
+
}
|
|
82
|
+
identity !== null && identity !== void 0 ? identity : (identity = getDocumentIdentity(host.document, host.window));
|
|
83
|
+
var event = {
|
|
84
|
+
name: family,
|
|
85
|
+
payload: __assign(__assign({}, payload), { v: 1, tab_id: identity.tab_id, document_id: identity.document_id }),
|
|
86
|
+
timestamp: timestamp,
|
|
87
|
+
};
|
|
88
|
+
counts[family] = ((_b = counts[family]) !== null && _b !== void 0 ? _b : 0) + 1;
|
|
89
|
+
try {
|
|
90
|
+
host.emit(event);
|
|
91
|
+
}
|
|
92
|
+
catch (error) {
|
|
93
|
+
report(error);
|
|
94
|
+
return false;
|
|
95
|
+
}
|
|
96
|
+
if (family === 'context')
|
|
97
|
+
dropped = {};
|
|
98
|
+
subscribers.forEach(function (subscriber) { return safely(function () { return subscriber(event); }); });
|
|
99
|
+
return true;
|
|
100
|
+
},
|
|
101
|
+
on: function (signal, callback) {
|
|
102
|
+
var listeners = signals.get(signal);
|
|
103
|
+
if (!listeners) {
|
|
104
|
+
listeners = new Set();
|
|
105
|
+
signals.set(signal, listeners);
|
|
106
|
+
}
|
|
107
|
+
var listener = function (value) { return safely(function () { return callback(value); }); };
|
|
108
|
+
listeners.add(listener);
|
|
109
|
+
var registered = listeners;
|
|
110
|
+
return function () {
|
|
111
|
+
registered.delete(listener);
|
|
112
|
+
};
|
|
113
|
+
},
|
|
114
|
+
subscribe: function (callback) {
|
|
115
|
+
subscribers.add(callback);
|
|
116
|
+
return function () {
|
|
117
|
+
subscribers.delete(callback);
|
|
118
|
+
};
|
|
119
|
+
},
|
|
120
|
+
};
|
|
121
|
+
var detach = function () {
|
|
122
|
+
active = false;
|
|
123
|
+
var previous = cleanups;
|
|
124
|
+
cleanups = [];
|
|
125
|
+
previous.reverse().forEach(function (cleanup) { return safely(cleanup); });
|
|
126
|
+
signals.clear();
|
|
127
|
+
subscribers.clear();
|
|
128
|
+
};
|
|
129
|
+
var attach = function () {
|
|
130
|
+
var e_1, _a;
|
|
131
|
+
var _b, _c;
|
|
132
|
+
if (active || !requested || !settings.enabled)
|
|
133
|
+
return;
|
|
134
|
+
var rate = (_b = settings.sampleRate) !== null && _b !== void 0 ? _b : 1;
|
|
135
|
+
if (!Number.isFinite(rate) || rate <= 0 || rate > 1)
|
|
136
|
+
return;
|
|
137
|
+
if (sample === undefined)
|
|
138
|
+
sample = ((_c = host.random) !== null && _c !== void 0 ? _c : Math.random)();
|
|
139
|
+
if (sample >= rate)
|
|
140
|
+
return;
|
|
141
|
+
active = true;
|
|
142
|
+
var _loop_1 = function (recorder) {
|
|
143
|
+
if (recorder.families.some(enabled)) {
|
|
144
|
+
var acquired_1 = [];
|
|
145
|
+
var scoped = __assign(__assign({}, context), { onCleanup: function (cleanup) {
|
|
146
|
+
acquired_1.push(cleanup);
|
|
147
|
+
}, on: function (signal, callback) {
|
|
148
|
+
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);
|
|
154
|
+
return cleanup;
|
|
155
|
+
} });
|
|
156
|
+
var rollback = function () {
|
|
157
|
+
acquired_1
|
|
158
|
+
.splice(0)
|
|
159
|
+
.reverse()
|
|
160
|
+
.forEach(function (cleanup) { return safely(cleanup); });
|
|
161
|
+
};
|
|
162
|
+
try {
|
|
163
|
+
acquired_1.push(recorder.setup(scoped));
|
|
164
|
+
cleanups.push(rollback);
|
|
165
|
+
}
|
|
166
|
+
catch (error) {
|
|
167
|
+
rollback();
|
|
168
|
+
report(error);
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
};
|
|
172
|
+
try {
|
|
173
|
+
for (var recorders_1 = __values(recorders), recorders_1_1 = recorders_1.next(); !recorders_1_1.done; recorders_1_1 = recorders_1.next()) {
|
|
174
|
+
var recorder = recorders_1_1.value;
|
|
175
|
+
_loop_1(recorder);
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
catch (e_1_1) { e_1 = { error: e_1_1 }; }
|
|
179
|
+
finally {
|
|
180
|
+
try {
|
|
181
|
+
if (recorders_1_1 && !recorders_1_1.done && (_a = recorders_1.return)) _a.call(recorders_1);
|
|
182
|
+
}
|
|
183
|
+
finally { if (e_1) throw e_1.error; }
|
|
184
|
+
}
|
|
185
|
+
};
|
|
186
|
+
return {
|
|
187
|
+
isActive: function () { return active; },
|
|
188
|
+
start: function () {
|
|
189
|
+
requested = true;
|
|
190
|
+
attach();
|
|
191
|
+
},
|
|
192
|
+
stop: function () {
|
|
193
|
+
requested = false;
|
|
194
|
+
snapshotSeen = 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
|
+
snapshotSeen = false;
|
|
206
|
+
counts = {};
|
|
207
|
+
dropped = {};
|
|
208
|
+
attach();
|
|
209
|
+
},
|
|
210
|
+
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);
|
|
216
|
+
if (!active)
|
|
217
|
+
return;
|
|
218
|
+
(_c = signals.get(signal)) === null || _c === void 0 ? void 0 : _c.forEach(function (callback) { return callback(value); });
|
|
219
|
+
},
|
|
220
|
+
};
|
|
221
|
+
}
|
|
222
|
+
function copyConfig(config) {
|
|
223
|
+
return __assign(__assign({}, config), { families: config.families ? __assign({}, config.families) : undefined });
|
|
224
|
+
}
|
|
225
|
+
//# 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 { 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"]}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { SemanticHelpers, SemanticHost } from './types';
|
|
2
|
+
export declare function truncate(value: string, limit: number): string;
|
|
3
|
+
/** Only path-shaped information leaves the browser, including hash router paths. */
|
|
4
|
+
export declare function urlTemplate(value: string, base?: string): string;
|
|
5
|
+
export declare function roleOf(element: Element): string;
|
|
6
|
+
/** ARIA treats unknown nonempty tokens as true, alongside grammar and spelling. */
|
|
7
|
+
export declare function isAriaInvalid(element: Element): boolean;
|
|
8
|
+
export declare function createHelpers(host: SemanticHost): SemanticHelpers;
|
|
9
|
+
//# sourceMappingURL=helpers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,eAAe,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA+DpE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAA8B,GAAG,MAAM,CA2BrF;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAuD/C;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAyPjE"}
|