@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
package/lib/cjs/index.js CHANGED
@@ -1,43 +1,18 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.createSemanticCapture = exports.getDocumentIdentity = exports.urlTemplate = exports.roleOf = exports.createHelpers = exports.SEMANTIC_CAPS = exports.defaultRecorders = exports.resourceErrorRecorder = exports.keysRecorder = exports.analyticsRecorder = exports.navigationRecorder = exports.lifecycleRecorder = exports.feedbackRecorder = exports.interactionsRecorder = void 0;
3
+ exports.createSemanticCapture = exports.getDocumentIdentity = exports.DEFAULT_SEMANTIC_CAP = void 0;
4
4
  var tslib_1 = require("tslib");
5
5
  var capture_1 = require("./capture");
6
- var interactions_1 = require("./recorders/interactions");
7
- Object.defineProperty(exports, "interactionsRecorder", { enumerable: true, get: function () { return interactions_1.interactionsRecorder; } });
8
- var feedback_1 = require("./recorders/feedback");
9
- Object.defineProperty(exports, "feedbackRecorder", { enumerable: true, get: function () { return feedback_1.feedbackRecorder; } });
10
- var navigation_1 = require("./recorders/navigation");
11
- Object.defineProperty(exports, "navigationRecorder", { enumerable: true, get: function () { return navigation_1.navigationRecorder; } });
12
- var lifecycle_1 = require("./recorders/lifecycle");
13
- Object.defineProperty(exports, "lifecycleRecorder", { enumerable: true, get: function () { return lifecycle_1.lifecycleRecorder; } });
14
- var keys_1 = require("./recorders/keys");
15
- Object.defineProperty(exports, "keysRecorder", { enumerable: true, get: function () { return keys_1.keysRecorder; } });
16
- var resource_error_1 = require("./recorders/resource-error");
17
- Object.defineProperty(exports, "resourceErrorRecorder", { enumerable: true, get: function () { return resource_error_1.resourceErrorRecorder; } });
18
- var analytics_1 = require("./recorders/analytics");
19
- Object.defineProperty(exports, "analyticsRecorder", { enumerable: true, get: function () { return analytics_1.analyticsRecorder; } });
20
- exports.defaultRecorders = [
21
- interactions_1.interactionsRecorder,
22
- feedback_1.feedbackRecorder,
23
- lifecycle_1.lifecycleRecorder,
24
- navigation_1.navigationRecorder,
25
- analytics_1.analyticsRecorder,
26
- keys_1.keysRecorder,
27
- resource_error_1.resourceErrorRecorder,
28
- ];
29
6
  tslib_1.__exportStar(require("./types"), exports);
30
7
  var capture_2 = require("./capture");
31
- Object.defineProperty(exports, "SEMANTIC_CAPS", { enumerable: true, get: function () { return capture_2.SEMANTIC_CAPS; } });
32
- var helpers_1 = require("./helpers");
33
- Object.defineProperty(exports, "createHelpers", { enumerable: true, get: function () { return helpers_1.createHelpers; } });
34
- Object.defineProperty(exports, "roleOf", { enumerable: true, get: function () { return helpers_1.roleOf; } });
35
- Object.defineProperty(exports, "urlTemplate", { enumerable: true, get: function () { return helpers_1.urlTemplate; } });
8
+ Object.defineProperty(exports, "DEFAULT_SEMANTIC_CAP", { enumerable: true, get: function () { return capture_2.DEFAULT_SEMANTIC_CAP; } });
36
9
  var identity_1 = require("./identity");
37
10
  Object.defineProperty(exports, "getDocumentIdentity", { enumerable: true, get: function () { return identity_1.getDocumentIdentity; } });
38
- function createSemanticCapture(config, host, recorders) {
39
- if (recorders === void 0) { recorders = exports.defaultRecorders; }
40
- return (0, capture_1.createCapture)(config, host, recorders);
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);
41
16
  }
42
17
  exports.createSemanticCapture = createSemanticCapture;
43
18
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;AAAA,qCAA0C;AAC1C,yDAAgE;AAU9D,qGAVO,mCAAoB,OAUP;AATtB,iDAAwD;AAUtD,iGAVO,2BAAgB,OAUP;AATlB,qDAA4D;AAW1D,mGAXO,+BAAkB,OAWP;AAVpB,mDAA0D;AASxD,kGATO,6BAAiB,OASP;AARnB,yCAAgD;AAW9C,6FAXO,mBAAY,OAWP;AAVd,6DAAmE;AAWjE,sGAXO,sCAAqB,OAWP;AAVvB,mDAA0D;AAQxD,kGARO,6BAAiB,OAQP;AAIN,QAAA,gBAAgB,GAAgC;IAC3D,mCAAoB;IACpB,2BAAgB;IAChB,6BAAiB;IACjB,+BAAkB;IAClB,6BAAiB;IACjB,mBAAY;IACZ,sCAAqB;CACtB,CAAC;AAEF,kDAAwB;AAExB,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,qCAA+D;AAAtD,wGAAA,aAAa,OAAA;AAAE,iGAAA,MAAM,OAAA;AAAE,sGAAA,WAAW,OAAA;AAC3C,uCAAiD;AAAxC,+GAAA,mBAAmB,OAAA;AAE5B,SAAgB,qBAAqB,CACnC,MAA6B,EAC7B,IAAkB,EAClB,SAAyD;IAAzD,0BAAA,EAAA,YAAyC,wBAAgB;IAEzD,OAAO,IAAA,uBAAa,EAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAChD,CAAC;AAND,sDAMC","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,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,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
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAG,CAAC,CAAC","sourcesContent":["import type { PrivacyConfig } from '@amplitude/session-replay-dom-privacy';\n\nexport const SEMANTIC_VERSION = 1;\nexport type NameSource =\n | 'aria-labelledby'\n | 'aria-label'\n | 'label-for'\n | 'label-wrap'\n | 'alt'\n | 'value'\n | 'title'\n | 'text'\n | 'placeholder'\n | 'masked'\n | 'unnamed';\nexport interface TargetDescription {\n id: number | null;\n role: string;\n name: string | null;\n}\nexport interface NamedTarget extends TargetDescription {\n name_source: NameSource;\n}\nexport type NavigationReason = 'load' | 'push' | 'replace' | 'pop' | 'hash' | 'title';\nexport interface RecordingSignal {\n state: 'start' | 'stop' | 'pause' | 'resume';\n reason: 'init' | 'new_session' | 'customer_stop' | 'sampled_out' | 'opt_out' | 'targeting' | 'focus' | 'error';\n}\nexport interface AnalyticsContext {\n present: boolean;\n autocapture: string[];\n}\n\nexport interface SemanticIdentity {\n readonly tab_id: string;\n readonly document_id: string;\n}\n\n/** Recorder payloads exclude version and identity, which are owned by the capture runtime. */\nexport interface SemanticPayloads {\n context: {\n sdk: string;\n mask: 'light' | 'medium' | 'conservative';\n css: { total: number; inlined: number; unreadable: number };\n viewport: { w: number; h: number };\n device: 'desktop' | 'tablet' | 'mobile';\n language: string;\n visibility_state: 'hidden' | 'visible';\n focused: boolean;\n user_agent: string;\n analytics_sdk: AnalyticsContext;\n caps_hit?: Partial<Record<SemanticFamily, number>>;\n };\n click: NamedTarget & {\n container: TargetDescription | null;\n states: string[];\n visible: boolean;\n key: string | null;\n selector?: string | null;\n attrs: Record<string, string>;\n url: string;\n heading: string | null;\n keyboard: boolean;\n modifiers: string[];\n trusted: boolean;\n };\n keys: { key: string; target: NamedTarget & { states: string[] } };\n 'resource-error': {\n rt: 'img' | 'css' | 'font' | 'script';\n count: number;\n container?: TargetDescription;\n path?: string;\n };\n field: NamedTarget & {\n states: string[];\n kind: string;\n value_state: 'empty' | 'filled';\n /** Unmasked native input/textarea value; omitted for sensitive and non-scalar controls. */\n value?: string;\n checked?: boolean;\n valid: boolean;\n validity: string[];\n masked: boolean;\n option_label: string | null;\n };\n submit: {\n form: TargetDescription;\n submitter: TargetDescription | null;\n valid: boolean;\n invalid_fields: { id: number | null; name: string | null; validity: string[] }[];\n prevented: boolean;\n };\n notice: {\n id: number | null;\n role: 'alert' | 'status' | 'log' | 'live';\n text: string | null;\n visible: boolean;\n region: { role: string; name: string | null } | null;\n cause_click_ts: number | null;\n };\n dialog: NamedTarget & {\n role: 'dialog' | 'alertdialog';\n state: 'open' | 'closed';\n modal: boolean;\n visible: boolean;\n cause_click_ts: number | null;\n };\n navigation: { url: string };\n recording: RecordingSignal;\n visibility: {\n state: 'hidden' | 'visible';\n };\n lifecycle: { type: 'pagehide' | 'pageshow' | 'pageshow_bfcache' | 'freeze' | 'resume' };\n 'amp-event': {\n event_type: string;\n insert_id: string | null;\n id: number | null;\n props: Record<string, string | number | null>;\n };\n}\nexport type SemanticFamily = keyof SemanticPayloads;\nexport type SemanticEvent = {\n [K in SemanticFamily]: { name: K; payload: SemanticPayloads[K] & SemanticIdentity & { v: 1 }; timestamp: number };\n}[SemanticFamily];\nexport interface SemanticCaptureConfig {\n enabled: boolean;\n sampleRate?: number;\n families?: Partial<Record<SemanticFamily, boolean>>;\n}\n/** Forward only after analytics enrichment/filtering has accepted this event for delivery. */\nexport interface AcceptedAnalyticsEvent {\n eventType: string;\n insertId?: string;\n properties: Record<string, unknown>;\n element?: Element;\n}\n/** Structural replay input; no dependency on a particular recorder implementation. */\nexport interface SemanticDomNode {\n id: number;\n type: number;\n tagName?: string;\n attributes?: Record<string, unknown>;\n childNodes?: SemanticDomNode[];\n}\nexport type SemanticDomChange =\n | { type: 'snapshot'; node: SemanticDomNode }\n | {\n type: 'mutation';\n adds: { parentId: number; node: SemanticDomNode }[];\n removes: { parentId: number; id: number }[];\n texts: { id: number }[];\n attributes: { id: number; attributes: Record<string, unknown> }[];\n };\nexport interface HostSignals {\n dom: SemanticDomChange;\n /** Accepted URL-plugin input, already filtered by the host URL policy. */\n url: { url: string; timestamp: number };\n snapshot: undefined;\n navigation: NavigationReason;\n recording: RecordingSignal;\n click: MouseEvent;\n analytics: AcceptedAnalyticsEvent;\n}\nexport type Cleanup = () => void;\n\n/** Host dependencies are injected: this package does not import rrweb or an analytics SDK. */\nexport interface SemanticHost {\n document: Document;\n window: Window;\n emit: (event: SemanticEvent) => void;\n getNodeId: (node: Node) => number;\n /** Resolve recorded nodes for notice/dialog enrichment. Requires notify('dom', ...). */\n getNode?: (id: number) => Node | null;\n getPrivacy: () => PrivacyConfig;\n getUrl: () => string;\n sdk: string;\n getAnalyticsContext?: () => AnalyticsContext;\n /** Stable document identity; called lazily for accepted events. Default is document-scoped memory only. */\n getIdentity?: () => SemanticIdentity;\n getSelector?: (element: Element) => string | null;\n /** True when the host forwards native clicks via notify('click', event). */\n externalClicks?: boolean;\n /** Override when the host supplies primary clicks but not auxclick. Defaults to externalClicks. */\n externalAuxClicks?: boolean;\n inlineStylesheet?: boolean;\n now?: () => number;\n random?: () => number;\n onError?: (error: unknown) => void;\n}\nexport interface SemanticHelpers {\n id: (element: Element) => number | null;\n blocked: (element: Element) => boolean;\n masked: (element: Element) => boolean;\n text: (element: Element, value?: string | null, limit?: number) => string | null;\n name: (element: Element) => { name: string | null; source: NameSource };\n role: (element: Element) => string;\n states: (element: Element) => string[];\n describe: (element: Element) => NamedTarget;\n actionable: (element: Element) => Element;\n container: (element: Element) => TargetDescription | null;\n visible: (element: Element) => boolean;\n heading: () => string | null;\n invalidateHeading?: () => void;\n url: (value?: string) => string;\n attributes: (element: Element) => Record<string, string>;\n}\nexport interface RecorderContext {\n /** Register resources immediately so failed setup can roll them back. */\n onCleanup: (cleanup: Cleanup) => void;\n host: SemanticHost;\n helpers: SemanticHelpers;\n now: () => number;\n enabled: (family: SemanticFamily) => boolean;\n /** Check session capacity without counting a dropped event. */\n hasCapacity: (family: SemanticFamily) => boolean;\n /** Check before expensive payload work. A rejected candidate increments the dropped count. */\n canEmit: (family: SemanticFamily) => boolean;\n emit: <K extends SemanticFamily>(family: K, payload: SemanticPayloads[K], timestamp?: number) => boolean;\n on: <K extends keyof HostSignals>(signal: K, callback: (value: HostSignals[K]) => void) => Cleanup;\n subscribe: (callback: (event: SemanticEvent) => void) => Cleanup;\n /** Peek until a context event successfully emits; runtime then clears these counts. */\n dropped: () => Partial<Record<SemanticFamily, number>>;\n /** Preserves page readiness when families are reconfigured mid-recording. */\n hasSnapshot?: () => boolean;\n}\n/** A factory owns its listeners/timers and returns complete teardown. */\nexport interface SemanticRecorder {\n families: readonly SemanticFamily[];\n setup: (context: RecorderContext) => Cleanup;\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"]}
@@ -1,13 +1,13 @@
1
- import { HostSignals, SemanticCaptureConfig, SemanticFamily, SemanticHost, SemanticRecorder } from './types';
2
- export declare const SEMANTIC_CAPS: Record<SemanticFamily, number>;
3
- export interface SemanticCapture {
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
4
  isActive: () => boolean;
5
5
  start: () => void;
6
6
  stop: () => void;
7
- updateConfig: (config: SemanticCaptureConfig) => void;
7
+ updateConfig: (config: SemanticCaptureConfig<P>) => void;
8
8
  resetSession: () => void;
9
9
  notify: <K extends keyof HostSignals>(signal: K, value: HostSignals[K]) => void;
10
10
  }
11
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;
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
13
  //# sourceMappingURL=capture.d.ts.map
@@ -1 +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"}
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"}