@kya-os/checkpoint-shared 1.4.0 → 1.5.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 (161) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/dist/beacon-types/index.d.mts +441 -432
  3. package/dist/beacon-types/index.d.mts.map +1 -0
  4. package/dist/beacon-types/index.d.ts +441 -432
  5. package/dist/beacon-types/index.d.ts.map +1 -0
  6. package/dist/beacon-types/index.js +198 -182
  7. package/dist/beacon-types/index.mjs +197 -179
  8. package/dist/beacon-types/index.mjs.map +1 -0
  9. package/dist/browser-posture-cookie-Dmq9Brf_.d.mts +5 -0
  10. package/dist/browser-posture-cookie-Dmq9Brf_.d.mts.map +1 -0
  11. package/dist/browser-posture-cookie-Dmq9Brf_.d.ts +5 -0
  12. package/dist/browser-posture-cookie-Dmq9Brf_.d.ts.map +1 -0
  13. package/dist/browser-posture-cookie.d.mts +2 -0
  14. package/dist/browser-posture-cookie.d.ts +2 -0
  15. package/dist/browser-posture-cookie.js +1 -0
  16. package/dist/browser-posture-cookie.mjs +2 -0
  17. package/dist/browser-posture-cookie.mjs.map +1 -0
  18. package/dist/browser-posture-report.d.mts +48 -44
  19. package/dist/browser-posture-report.d.mts.map +1 -0
  20. package/dist/browser-posture-report.d.ts +48 -44
  21. package/dist/browser-posture-report.d.ts.map +1 -0
  22. package/dist/browser-posture-report.js +1 -1
  23. package/dist/browser-posture-report.mjs +2 -1
  24. package/dist/browser-posture-report.mjs.map +1 -0
  25. package/dist/browser-posture.d.mts +80 -75
  26. package/dist/browser-posture.d.mts.map +1 -0
  27. package/dist/browser-posture.d.ts +80 -75
  28. package/dist/browser-posture.d.ts.map +1 -0
  29. package/dist/browser-posture.js +159 -18993
  30. package/dist/browser-posture.mjs +158 -18990
  31. package/dist/browser-posture.mjs.map +1 -0
  32. package/dist/browser.d.mts +323 -316
  33. package/dist/browser.d.mts.map +1 -0
  34. package/dist/browser.d.ts +323 -316
  35. package/dist/browser.d.ts.map +1 -0
  36. package/dist/browser.js +1 -1
  37. package/dist/browser.mjs +2 -1
  38. package/dist/browser.mjs.map +1 -0
  39. package/dist/canonical-signer/index.d.mts +38 -33
  40. package/dist/canonical-signer/index.d.mts.map +1 -0
  41. package/dist/canonical-signer/index.d.ts +38 -33
  42. package/dist/canonical-signer/index.d.ts.map +1 -0
  43. package/dist/canonical-signer/index.js +411 -181
  44. package/dist/canonical-signer/index.mjs +383 -175
  45. package/dist/canonical-signer/index.mjs.map +1 -0
  46. package/dist/clearance.d.mts +30 -0
  47. package/dist/clearance.d.mts.map +1 -0
  48. package/dist/clearance.d.ts +30 -0
  49. package/dist/clearance.d.ts.map +1 -0
  50. package/dist/clearance.js +120 -0
  51. package/dist/clearance.mjs +112 -0
  52. package/dist/clearance.mjs.map +1 -0
  53. package/dist/client-ip-1y2iXAYW.js +237 -0
  54. package/dist/client-ip-HOfe6ucV.mjs +215 -0
  55. package/dist/client-ip-HOfe6ucV.mjs.map +1 -0
  56. package/dist/deploy/index.d.mts +339 -339
  57. package/dist/deploy/index.d.mts.map +1 -0
  58. package/dist/deploy/index.d.ts +339 -339
  59. package/dist/deploy/index.d.ts.map +1 -0
  60. package/dist/deploy/index.js +505 -413
  61. package/dist/deploy/index.mjs +504 -410
  62. package/dist/deploy/index.mjs.map +1 -0
  63. package/dist/errors/index.d.mts +101 -101
  64. package/dist/errors/index.d.mts.map +1 -0
  65. package/dist/errors/index.d.ts +101 -101
  66. package/dist/errors/index.d.ts.map +1 -0
  67. package/dist/errors/index.js +341 -314
  68. package/dist/errors/index.mjs +340 -311
  69. package/dist/errors/index.mjs.map +1 -0
  70. package/dist/external-jr_S4iSS.d.mts +4187 -0
  71. package/dist/external-jr_S4iSS.d.mts.map +1 -0
  72. package/dist/external-jr_S4iSS.d.ts +4187 -0
  73. package/dist/external-jr_S4iSS.d.ts.map +1 -0
  74. package/dist/gateway/index.d.mts +138 -132
  75. package/dist/gateway/index.d.mts.map +1 -0
  76. package/dist/gateway/index.d.ts +138 -132
  77. package/dist/gateway/index.d.ts.map +1 -0
  78. package/dist/gateway/index.js +117 -81
  79. package/dist/gateway/index.mjs +116 -78
  80. package/dist/gateway/index.mjs.map +1 -0
  81. package/dist/gateway-client-ip.d.mts +59 -0
  82. package/dist/gateway-client-ip.d.mts.map +1 -0
  83. package/dist/gateway-client-ip.d.ts +59 -0
  84. package/dist/gateway-client-ip.d.ts.map +1 -0
  85. package/dist/gateway-client-ip.js +149 -0
  86. package/dist/gateway-client-ip.mjs +139 -0
  87. package/dist/gateway-client-ip.mjs.map +1 -0
  88. package/dist/index.d.mts +14895 -14240
  89. package/dist/index.d.mts.map +1 -0
  90. package/dist/index.d.ts +14895 -14240
  91. package/dist/index.d.ts.map +1 -0
  92. package/dist/index.js +15180 -31025
  93. package/dist/index.mjs +15065 -30942
  94. package/dist/index.mjs.map +1 -0
  95. package/dist/mcpi/agentshield-api/index.d.mts +45 -44
  96. package/dist/mcpi/agentshield-api/index.d.mts.map +1 -0
  97. package/dist/mcpi/agentshield-api/index.d.ts +45 -44
  98. package/dist/mcpi/agentshield-api/index.d.ts.map +1 -0
  99. package/dist/mcpi/agentshield-api/index.js +0 -2
  100. package/dist/mcpi/agentshield-api/index.mjs +1 -1
  101. package/dist/mcpi/approval-grant/index.d.mts +63 -61
  102. package/dist/mcpi/approval-grant/index.d.mts.map +1 -0
  103. package/dist/mcpi/approval-grant/index.d.ts +63 -61
  104. package/dist/mcpi/approval-grant/index.d.ts.map +1 -0
  105. package/dist/mcpi/approval-grant/index.js +220 -140
  106. package/dist/mcpi/approval-grant/index.mjs +219 -137
  107. package/dist/mcpi/approval-grant/index.mjs.map +1 -0
  108. package/dist/mcpi/dashboard-config/index.d.mts +2323 -2318
  109. package/dist/mcpi/dashboard-config/index.d.mts.map +1 -0
  110. package/dist/mcpi/dashboard-config/index.d.ts +2323 -2318
  111. package/dist/mcpi/dashboard-config/index.d.ts.map +1 -0
  112. package/dist/mcpi/dashboard-config/index.js +605 -458
  113. package/dist/mcpi/dashboard-config/index.mjs +604 -455
  114. package/dist/mcpi/dashboard-config/index.mjs.map +1 -0
  115. package/dist/mcpi/multibase-ed25519.d.mts +10 -8
  116. package/dist/mcpi/multibase-ed25519.d.mts.map +1 -0
  117. package/dist/mcpi/multibase-ed25519.d.ts +10 -8
  118. package/dist/mcpi/multibase-ed25519.d.ts.map +1 -0
  119. package/dist/mcpi/multibase-ed25519.js +182 -106
  120. package/dist/mcpi/multibase-ed25519.mjs +181 -103
  121. package/dist/mcpi/multibase-ed25519.mjs.map +1 -0
  122. package/dist/patterns-CkRVOdtV.js +243 -0
  123. package/dist/patterns-DzkGy_qk.mjs +173 -0
  124. package/dist/patterns-DzkGy_qk.mjs.map +1 -0
  125. package/dist/project-verification-key-C3L5rd8a.js +41 -0
  126. package/dist/project-verification-key-CgSVX9_m.mjs +37 -0
  127. package/dist/project-verification-key-CgSVX9_m.mjs.map +1 -0
  128. package/dist/rolldown-runtime-iY2fYEqi.mjs +19 -0
  129. package/dist/schemas-BmjNLAE7.js +5677 -0
  130. package/dist/schemas-DxY-dk9y.mjs +5511 -0
  131. package/dist/schemas-DxY-dk9y.mjs.map +1 -0
  132. package/dist/signals/index.d.mts +125 -115
  133. package/dist/signals/index.d.mts.map +1 -0
  134. package/dist/signals/index.d.ts +125 -115
  135. package/dist/signals/index.d.ts.map +1 -0
  136. package/dist/signals/index.js +1693 -1536
  137. package/dist/signals/index.mjs +1692 -1533
  138. package/dist/signals/index.mjs.map +1 -0
  139. package/dist/test-fixtures/index.d.mts +124 -119
  140. package/dist/test-fixtures/index.d.mts.map +1 -0
  141. package/dist/test-fixtures/index.d.ts +124 -119
  142. package/dist/test-fixtures/index.d.ts.map +1 -0
  143. package/dist/test-fixtures/index.js +460 -228
  144. package/dist/test-fixtures/index.mjs +459 -225
  145. package/dist/test-fixtures/index.mjs.map +1 -0
  146. package/dist/tool-protection/index.d.mts +343 -343
  147. package/dist/tool-protection/index.d.mts.map +1 -0
  148. package/dist/tool-protection/index.d.ts +343 -343
  149. package/dist/tool-protection/index.d.ts.map +1 -0
  150. package/dist/tool-protection/index.js +366 -285
  151. package/dist/tool-protection/index.mjs +365 -282
  152. package/dist/tool-protection/index.mjs.map +1 -0
  153. package/fixtures/bot-signal-resolution.json +142 -0
  154. package/fixtures/browser-posture-claims.json +421 -0
  155. package/fixtures/browser-posture-headers.json +46 -0
  156. package/fixtures/detection/reason-codes.json +10 -1
  157. package/fixtures/kya-http/challenge.delegation.fetcher-200.json +9 -3
  158. package/fixtures/kya-http/challenge.delegation.full.json +9 -3
  159. package/fixtures/kya-http/challenge.delegation.minimal.json +9 -3
  160. package/fixtures/kya-http/error-codes.json +7 -2
  161. package/package.json +20 -6
@@ -1,438 +1,447 @@
1
- type JsonPrimitive = string | number | boolean | null;
2
- type JsonValue = JsonPrimitive | JsonValue[] | {
3
- [key: string]: JsonValue | undefined;
1
+ //#region src/beacon-types/index.d.ts
2
+ export type JsonPrimitive = string | number | boolean | null;
3
+ export type JsonValue = JsonPrimitive | JsonValue[] | {
4
+ [key: string]: JsonValue | undefined;
4
5
  };
5
- type BeaconPrimitive = JsonPrimitive;
6
- type BeaconJsonValue = JsonValue;
7
- type BeaconCustomData = Record<string, JsonValue | undefined>;
8
- type BeaconPayload = BeaconCollectorData | BeaconCustomData | null;
9
- type WorkerPayload = unknown;
10
- declare function isBeaconIdentity(value: unknown): value is BeaconIdentity;
11
- interface NetworkInformationLike extends EventTarget {
12
- type?: string;
13
- effectiveType?: string;
14
- downlink?: number;
15
- rtt?: number;
16
- saveData?: boolean;
17
- }
18
- interface NavigatorWithNetworkInformation extends Navigator {
19
- connection?: NetworkInformationLike;
20
- mozConnection?: NetworkInformationLike;
21
- webkitConnection?: NetworkInformationLike;
22
- deviceMemory?: number;
23
- vendorSub: string;
24
- doNotTrack: string | null;
25
- msDoNotTrack?: string | null;
26
- }
27
- interface WindowWithBeaconMetadata extends Window {
28
- doNotTrack?: string | null;
29
- __NEXT_DATA__?: {
30
- buildId?: string;
31
- };
32
- }
33
- interface TrustedTypePolicyLike {
34
- createScriptURL(url: string): string;
35
- createScript(script: string): string;
36
- }
37
- interface WindowWithTrustedTypes extends Window {
38
- trustedTypes?: {
39
- createPolicy(name: string, rules: {
40
- createScriptURL?: (url: string) => string;
41
- createScript?: (script: string) => string;
42
- }): TrustedTypePolicyLike;
43
- };
44
- }
45
- interface PerformanceMemoryInfo {
46
- usedJSHeapSize: number;
47
- totalJSHeapSize: number;
48
- jsHeapSizeLimit: number;
49
- }
50
- interface PerformanceWithMemory extends Performance {
51
- memory?: PerformanceMemoryInfo;
52
- measureUserAgentSpecificMemory?: () => Promise<unknown>;
53
- }
54
- interface LargestContentfulPaintEntry extends PerformanceEntry {
55
- renderTime?: number;
56
- loadTime?: number;
57
- }
58
- interface BeaconIdentity {
59
- userId: string;
60
- }
61
- interface BeaconConfig {
62
- projectId: string;
63
- identity?: BeaconIdentity;
64
- endpoint?: string;
65
- environment?: 'development' | 'staging' | 'production' | string;
66
- tags?: Record<string, string | number | boolean>;
67
- enabled?: boolean;
68
- debug?: boolean;
69
- logLevel?: 'error' | 'warn' | 'info' | 'debug';
70
- respectDoNotTrack?: boolean;
71
- anonymizeIp?: boolean;
72
- sessionTimeout?: number;
73
- sessionCookieName?: string;
74
- batchSize?: number;
75
- flushInterval?: number;
76
- collectorDeadlineMs?: number;
77
- maxQueueSize?: number;
78
- retryAttempts?: number;
79
- retryDelay?: number;
80
- useWorker?: boolean;
81
- enableWebWorker?: boolean;
82
- workerUrl?: string;
83
- workerConfig?: WorkerConfig;
84
- lazySignalsUrl?: string;
85
- }
86
- interface BeaconEvent {
87
- type: BeaconEventType;
88
- data: BeaconCollectorData;
89
- metadata: BeaconMetadata;
90
- }
91
- interface BeaconMetadata {
92
- sessionId: string;
93
- timestamp: number;
94
- eventName?: string;
95
- identity?: BeaconIdentity;
96
- [key: string]: unknown;
97
- }
98
- interface IAgentShieldBeacon {
99
- collect(eventType: string, data?: BeaconPayload): Promise<void>;
100
- trackEvent(eventName: string, eventData?: BeaconPayload): Promise<void>;
101
- trackPageview(pageData?: BeaconPayload): Promise<void>;
102
- trackPageUnload(): Promise<void>;
103
- updateConfig(updates: Partial<BeaconConfig>): void;
104
- destroy(): Promise<void>;
105
- }
106
- interface BeaconResponse {
107
- status: 'success' | 'error';
108
- message?: string;
109
- error?: {
110
- code: string;
111
- message: string;
112
- };
113
- }
114
- interface BrowserContext {
115
- browser: {
116
- name: string;
117
- version: string;
118
- engine: string;
119
- };
120
- os: {
121
- name: string;
122
- version: string;
123
- };
124
- device: {
125
- type: 'desktop' | 'mobile' | 'tablet' | 'tv' | 'unknown';
126
- vendor?: string;
127
- model?: string;
128
- };
129
- screen: {
130
- width: number;
131
- height: number;
132
- pixelRatio: number;
133
- colorDepth: number;
134
- };
135
- connection?: {
136
- type: 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
137
- effectiveType?: '2g' | '3g' | '4g' | '5g';
138
- downlink?: number;
139
- rtt?: number;
140
- saveData?: boolean;
141
- };
142
- }
143
- interface PerformanceMetrics {
144
- pageLoadTime?: number;
145
- domContentLoadedTime?: number;
146
- timeToInteractive?: number;
147
- firstPaintTime?: number;
148
- firstContentfulPaintTime?: number;
149
- largestContentfulPaintTime?: number;
150
- dnsLookupTime?: number;
151
- tcpConnectionTime?: number;
152
- serverResponseTime?: number;
153
- resources?: {
154
- scripts: number;
155
- stylesheets: number;
156
- images: number;
157
- fonts: number;
158
- total: number;
159
- };
160
- }
161
- interface SessionData {
162
- id: string;
163
- startTime: number;
164
- lastActivity: number;
165
- pageViews: number;
166
- eventCount: number;
167
- duration: number;
168
- isNew: boolean;
169
- }
170
- interface TransportConfig {
171
- batchSize: number;
172
- flushInterval: number;
173
- maxRetries: number;
174
- retryDelayBase: number;
175
- offlineQueueSize: number;
176
- useCompression: boolean;
177
- compressionThreshold: number;
178
- networkAdaptation: boolean;
179
- dedupWindow: number;
180
- }
181
- interface TransportOptions {
182
- immediate?: boolean;
183
- priority?: 'low' | 'normal' | 'high' | 'critical';
184
- retry?: boolean;
185
- timeout?: number;
186
- }
187
- interface TransportResponse {
188
- success: boolean;
189
- timestamp: number;
190
- batchId?: string;
191
- error?: string;
192
- }
193
- type TransportState = 'idle' | 'sending' | 'offline' | 'paused' | 'error';
194
- interface TransportMetrics {
195
- eventsSent: number;
196
- eventsFailed: number;
197
- eventsQueued: number;
198
- batchesSent: number;
199
- batchesFailed: number;
200
- bytesTransferred: number;
201
- compressionRatio?: number;
202
- averageLatency?: number;
203
- lastSuccessTimestamp?: number;
204
- lastErrorTimestamp?: number;
205
- }
206
- interface BatchEvent {
207
- id: string;
208
- event: BeaconEvent;
209
- timestamp: number;
210
- retryCount: number;
211
- hash: string;
212
- priority: 'low' | 'normal' | 'high' | 'critical';
213
- }
214
- type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
215
- interface NetworkInfo {
216
- type?: string;
217
- effectiveType?: string;
6
+ export type BeaconPrimitive = JsonPrimitive;
7
+ export type BeaconJsonValue = JsonValue;
8
+ export type BeaconCustomData = Record<string, JsonValue | undefined>;
9
+ export type BeaconPayload = BeaconCollectorData | BeaconCustomData | null;
10
+ export type WorkerPayload = unknown;
11
+ export declare function isBeaconIdentity(value: unknown): value is BeaconIdentity;
12
+ export interface NetworkInformationLike extends EventTarget {
13
+ type?: string;
14
+ effectiveType?: string;
15
+ downlink?: number;
16
+ rtt?: number;
17
+ saveData?: boolean;
18
+ }
19
+ export interface NavigatorWithNetworkInformation extends Navigator {
20
+ connection?: NetworkInformationLike;
21
+ mozConnection?: NetworkInformationLike;
22
+ webkitConnection?: NetworkInformationLike;
23
+ deviceMemory?: number;
24
+ vendorSub: string;
25
+ doNotTrack: string | null;
26
+ msDoNotTrack?: string | null;
27
+ }
28
+ export interface WindowWithBeaconMetadata extends Window {
29
+ doNotTrack?: string | null;
30
+ __NEXT_DATA__?: {
31
+ buildId?: string;
32
+ };
33
+ }
34
+ export interface TrustedTypePolicyLike {
35
+ createScriptURL(url: string): string;
36
+ createScript(script: string): string;
37
+ }
38
+ export interface WindowWithTrustedTypes extends Window {
39
+ trustedTypes?: {
40
+ createPolicy(name: string, rules: {
41
+ createScriptURL?: (url: string) => string;
42
+ createScript?: (script: string) => string;
43
+ }): TrustedTypePolicyLike;
44
+ };
45
+ }
46
+ export interface PerformanceMemoryInfo {
47
+ usedJSHeapSize: number;
48
+ totalJSHeapSize: number;
49
+ jsHeapSizeLimit: number;
50
+ }
51
+ export interface PerformanceWithMemory extends Performance {
52
+ memory?: PerformanceMemoryInfo;
53
+ measureUserAgentSpecificMemory?: () => Promise<unknown>;
54
+ }
55
+ export interface LargestContentfulPaintEntry extends PerformanceEntry {
56
+ renderTime?: number;
57
+ loadTime?: number;
58
+ }
59
+ export interface BeaconIdentity {
60
+ userId: string;
61
+ }
62
+ export interface BeaconConfig {
63
+ projectId: string;
64
+ identity?: BeaconIdentity;
65
+ endpoint?: string;
66
+ environment?: 'development' | 'staging' | 'production' | string;
67
+ tags?: Record<string, string | number | boolean>;
68
+ enabled?: boolean;
69
+ debug?: boolean;
70
+ logLevel?: 'error' | 'warn' | 'info' | 'debug';
71
+ respectDoNotTrack?: boolean;
72
+ anonymizeIp?: boolean;
73
+ stripUrlFragment?: boolean;
74
+ scrubQueryParams?: string[];
75
+ dropQueryParams?: boolean;
76
+ sessionTimeout?: number;
77
+ sessionCookieName?: string;
78
+ batchSize?: number;
79
+ flushInterval?: number;
80
+ collectorDeadlineMs?: number;
81
+ maxQueueSize?: number;
82
+ retryAttempts?: number;
83
+ retryDelay?: number;
84
+ postureRetryScheduleMs?: number[];
85
+ useWorker?: boolean;
86
+ enableWebWorker?: boolean;
87
+ workerUrl?: string;
88
+ workerConfig?: WorkerConfig;
89
+ lazySignalsUrl?: string;
90
+ }
91
+ export interface BeaconEvent {
92
+ type: BeaconEventType;
93
+ data: BeaconCollectorData;
94
+ metadata: BeaconMetadata;
95
+ }
96
+ export interface BeaconMetadata {
97
+ sessionId: string;
98
+ timestamp: number;
99
+ eventName?: string;
100
+ identity?: BeaconIdentity;
101
+ [key: string]: unknown;
102
+ }
103
+ export interface IAgentShieldBeacon {
104
+ collect(eventType: string, data?: BeaconPayload): Promise<void>;
105
+ trackEvent(eventName: string, eventData?: BeaconPayload): Promise<void>;
106
+ trackPageview(pageData?: BeaconPayload): Promise<void>;
107
+ trackPageUnload(): Promise<void>;
108
+ updateConfig(updates: Partial<BeaconConfig>): void;
109
+ destroy(): Promise<void>;
110
+ }
111
+ export interface BeaconResponse {
112
+ status: 'success' | 'error';
113
+ message?: string;
114
+ error?: {
115
+ code: string;
116
+ message: string;
117
+ };
118
+ }
119
+ export interface BrowserContext {
120
+ browser: {
121
+ name: string;
122
+ version: string;
123
+ engine: string;
124
+ };
125
+ os: {
126
+ name: string;
127
+ version: string;
128
+ };
129
+ device: {
130
+ type: 'desktop' | 'mobile' | 'tablet' | 'tv' | 'unknown';
131
+ vendor?: string;
132
+ model?: string;
133
+ };
134
+ screen: {
135
+ width: number;
136
+ height: number;
137
+ pixelRatio: number;
138
+ colorDepth: number;
139
+ };
140
+ connection?: {
141
+ type: 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
142
+ effectiveType?: '2g' | '3g' | '4g' | '5g';
218
143
  downlink?: number;
219
144
  rtt?: number;
220
145
  saveData?: boolean;
221
- }
222
- type MessagePriority = 'low' | 'normal' | 'high' | 'critical';
223
- type WorkerErrorType = 'initialization' | 'runtime' | 'communication' | 'timeout' | 'memory' | 'network' | 'permission' | 'validation' | 'processing' | 'unknown';
224
- type WorkerAction = 'process' | 'init' | 'terminate' | 'pause' | 'resume' | 'status' | 'health';
225
- type WorkerMessageType = 'request' | 'response' | 'error' | 'heartbeat' | 'status';
226
- interface WorkerMessage {
227
- id: string;
228
- type: 'request' | 'response' | 'error' | 'heartbeat' | 'status';
229
- action?: string;
230
- payload?: WorkerPayload;
231
- timestamp: number;
232
- compressed?: boolean;
233
- priority?: MessagePriority;
234
- correlationId?: string;
235
- }
236
- type WorkerState = 'idle' | 'initializing' | 'ready' | 'processing' | 'busy' | 'error' | 'terminating' | 'terminated';
237
- type WorkerHealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
238
- interface WorkerMetrics {
239
- tasksProcessed: number;
240
- tasksFailed: number;
241
- averageProcessingTime?: number;
242
- memoryUsage?: number;
243
- cpuUsage?: number;
244
- healthStatus: WorkerHealthStatus;
245
- lastHealthCheck: number;
246
- restartCount: number;
247
- errorRate?: number;
248
- errorCount: number;
249
- messageQueueSize: number;
250
- startTime: number;
251
- uptime: number;
252
- averageTaskTime?: number;
253
- lastTaskTime?: number;
254
- }
255
- interface WorkerError {
256
- type: WorkerErrorType;
257
- code?: string;
258
- message: string;
259
- stack?: string;
260
- timestamp: number;
261
- recoverable: boolean;
262
- retryAfter?: number;
263
- context?: Record<string, unknown>;
264
- }
265
- interface WorkerCapabilities {
266
- workerAPI: boolean;
267
- sharedArrayBuffer: boolean;
268
- transferableObjects: boolean;
269
- offscreenCanvas: boolean;
270
- webAssembly: boolean;
271
- atomics: boolean;
272
- bigInt: boolean;
273
- csp: {
274
- workerSrc: boolean;
275
- scriptSrc: boolean;
276
- blobUrls: boolean;
277
- inlineWorkers: boolean;
278
- };
279
- performance: {
280
- memory: boolean;
281
- measureUserAgentSpecificMemory: boolean;
282
- };
283
- }
284
- interface WorkerTask {
285
- id: string;
286
- type: string;
287
- data: WorkerPayload;
288
- priority: 'low' | 'normal' | 'high' | 'critical';
289
- createdAt: number;
290
- startedAt?: number;
291
- completedAt?: number;
292
- error?: WorkerError;
293
- maxRetries?: number;
294
- retries?: number;
295
- timeout?: number;
296
- }
297
- interface FallbackOptions {
298
- useRequestIdleCallback: boolean;
299
- idleTimeout: number;
300
- chunkSize: number;
301
- throttleMs: number;
302
- maxExecutionTime: number;
303
- }
304
- interface ResourceUsage {
305
- memory: {
306
- used: number;
307
- limit: number;
308
- percentage: number;
309
- };
310
- cpu: {
311
- usage: number;
312
- limit: number;
313
- };
314
- tasks: {
315
- pending: number;
316
- active: number;
317
- completed: number;
318
- failed: number;
319
- };
320
- activeWorkers: number;
321
- }
322
- interface WorkerPoolConfig {
323
- maxWorkers: number;
324
- minWorkers: number;
325
- workerIdleTimeout: number;
326
- taskQueueSize: number;
327
- resourceLimits: Record<string, number>;
328
- autoScale?: boolean;
329
- scaleUpThreshold?: number;
330
- scaleDownThreshold?: number;
331
- }
332
- type BeaconWorkerMessageType = 'init' | 'collect' | 'flush' | 'config' | 'status' | 'error' | 'response';
333
- type ProtocolVersion = '1.0' | '1.1' | '2.0';
334
- interface BeaconWorkerMessage {
335
- type: BeaconWorkerMessageType;
336
- data?: WorkerPayload;
337
- payload?: WorkerPayload;
338
- messageId: string;
339
- timestamp: number;
340
- id: string;
341
- }
342
- interface WorkerConfig {
343
- enabled?: boolean;
344
- url?: string;
345
- heartbeatInterval?: number;
346
- maxUnhealthyCount?: number;
347
- maxRetries?: number;
348
- retryDelay?: number;
349
- restartDelay?: number;
350
- messageTimeout?: number;
351
- compressionThreshold?: number;
352
- allowFallback?: boolean;
353
- crossOriginIsolated?: boolean;
354
- maxRestartAttempts?: number;
355
- terminationTimeout?: number;
356
- taskTimeout?: number;
357
- fallbackDelay?: number;
358
- enableFallback?: boolean;
359
- initTimeoutMs?: number;
360
- }
361
- interface CircuitBreakerConfig {
362
- threshold: number;
363
- timeout: number;
364
- resetTimeout: number;
365
- }
366
- type CircuitBreakerState = 'closed' | 'open' | 'half-open';
367
- interface RetryStrategy {
368
- maxAttempts: number;
369
- baseDelay: number;
370
- maxDelay: number;
371
- factor: number;
372
- jitter: boolean;
373
- }
374
- interface OfflineQueueEntry {
375
- id: string;
376
- events: BeaconEvent[];
377
- timestamp: number;
378
- expiresAt: number;
379
- retryCount: number;
380
- size: number;
381
- }
382
- interface BeaconBatch {
383
- projectId: string;
384
- events: BeaconEvent[];
385
- sessionId: string;
386
- batchId: string;
387
- timestamp: number;
388
- }
389
- interface BeaconCollectorData {
390
- userAgent?: string;
391
- language?: string;
392
- platform?: string;
393
- screenResolution?: string;
394
- viewport?: string;
395
- cookiesEnabled?: boolean;
396
- doNotTrack?: boolean;
397
- timezone?: string;
398
- referrer?: string;
399
- url?: string;
400
- title?: string;
401
- vendor?: string;
402
- pageLoadTime?: number;
403
- domContentLoadedTime?: number;
404
- firstPaintTime?: number;
405
- firstContentfulPaintTime?: number;
406
- connectionType?: string;
407
- sessionId?: string;
408
- timestamp?: number;
409
- [key: string]: unknown;
410
- }
411
- type BeaconEventType = 'pageview' | 'pageunload' | 'heartbeat' | 'custom' | 'error' | 'performance';
412
- declare function parseRetryStrategy(input: unknown): RetryStrategy;
413
- declare function parseCircuitBreakerConfig(input: unknown): CircuitBreakerConfig;
414
- declare function parseOfflineQueueEntry(input: unknown): OfflineQueueEntry;
415
- declare function parseBeaconWorkerMessage(input: unknown): BeaconWorkerMessage;
416
- declare function parseWorkerMessage(input: unknown): WorkerMessage;
417
- declare function parseWorkerError(input: unknown): WorkerError;
418
- declare function parseWorkerPoolConfig(input: unknown): WorkerPoolConfig;
419
- declare function parseResourceUsage(input: unknown): ResourceUsage;
420
- declare const ResourceUsageSchema: {
421
- parse: typeof parseResourceUsage;
146
+ };
147
+ }
148
+ export interface PerformanceMetrics {
149
+ pageLoadTime?: number;
150
+ domContentLoadedTime?: number;
151
+ timeToInteractive?: number;
152
+ firstPaintTime?: number;
153
+ firstContentfulPaintTime?: number;
154
+ largestContentfulPaintTime?: number;
155
+ dnsLookupTime?: number;
156
+ tcpConnectionTime?: number;
157
+ serverResponseTime?: number;
158
+ resources?: {
159
+ scripts: number;
160
+ stylesheets: number;
161
+ images: number;
162
+ fonts: number;
163
+ total: number;
164
+ };
165
+ }
166
+ export interface SessionData {
167
+ id: string;
168
+ startTime: number;
169
+ lastActivity: number;
170
+ pageViews: number;
171
+ eventCount: number;
172
+ duration: number;
173
+ isNew: boolean;
174
+ }
175
+ export interface TransportConfig {
176
+ batchSize: number;
177
+ flushInterval: number;
178
+ maxRetries: number;
179
+ retryDelayBase: number;
180
+ offlineQueueSize: number;
181
+ useCompression: boolean;
182
+ compressionThreshold: number;
183
+ networkAdaptation: boolean;
184
+ dedupWindow: number;
185
+ anonymizeIp?: boolean;
186
+ }
187
+ export interface TransportOptions {
188
+ immediate?: boolean;
189
+ priority?: 'low' | 'normal' | 'high' | 'critical';
190
+ retry?: boolean;
191
+ timeout?: number;
192
+ }
193
+ export interface TransportResponse {
194
+ success: boolean;
195
+ timestamp: number;
196
+ batchId?: string;
197
+ error?: string;
198
+ }
199
+ export type TransportState = 'idle' | 'sending' | 'offline' | 'paused' | 'error';
200
+ export interface TransportMetrics {
201
+ eventsSent: number;
202
+ eventsFailed: number;
203
+ eventsQueued: number;
204
+ batchesSent: number;
205
+ batchesFailed: number;
206
+ bytesTransferred: number;
207
+ compressionRatio?: number;
208
+ averageLatency?: number;
209
+ lastSuccessTimestamp?: number;
210
+ lastErrorTimestamp?: number;
211
+ }
212
+ export interface BatchEvent {
213
+ id: string;
214
+ event: BeaconEvent;
215
+ timestamp: number;
216
+ retryCount: number;
217
+ hash: string;
218
+ priority: 'low' | 'normal' | 'high' | 'critical';
219
+ }
220
+ export type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
221
+ export interface NetworkInfo {
222
+ type?: string;
223
+ effectiveType?: string;
224
+ downlink?: number;
225
+ rtt?: number;
226
+ saveData?: boolean;
227
+ }
228
+ export type MessagePriority = 'low' | 'normal' | 'high' | 'critical';
229
+ export type WorkerErrorType = 'initialization' | 'runtime' | 'communication' | 'timeout' | 'memory' | 'network' | 'permission' | 'validation' | 'processing' | 'unknown';
230
+ export type WorkerAction = 'process' | 'init' | 'terminate' | 'pause' | 'resume' | 'status' | 'health';
231
+ export type WorkerMessageType = 'request' | 'response' | 'error' | 'heartbeat' | 'status';
232
+ export interface WorkerMessage {
233
+ id: string;
234
+ type: 'request' | 'response' | 'error' | 'heartbeat' | 'status';
235
+ action?: string;
236
+ payload?: WorkerPayload;
237
+ timestamp: number;
238
+ compressed?: boolean;
239
+ priority?: MessagePriority;
240
+ correlationId?: string;
241
+ }
242
+ export type WorkerState = 'idle' | 'initializing' | 'ready' | 'processing' | 'busy' | 'error' | 'terminating' | 'terminated';
243
+ export type WorkerHealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
244
+ export interface WorkerMetrics {
245
+ tasksProcessed: number;
246
+ tasksFailed: number;
247
+ averageProcessingTime?: number;
248
+ memoryUsage?: number;
249
+ cpuUsage?: number;
250
+ healthStatus: WorkerHealthStatus;
251
+ lastHealthCheck: number;
252
+ restartCount: number;
253
+ errorRate?: number;
254
+ errorCount: number;
255
+ messageQueueSize: number;
256
+ startTime: number;
257
+ uptime: number;
258
+ averageTaskTime?: number;
259
+ lastTaskTime?: number;
260
+ }
261
+ export interface WorkerError {
262
+ type: WorkerErrorType;
263
+ code?: string;
264
+ message: string;
265
+ stack?: string;
266
+ timestamp: number;
267
+ recoverable: boolean;
268
+ retryAfter?: number;
269
+ context?: Record<string, unknown>;
270
+ }
271
+ export interface WorkerCapabilities {
272
+ workerAPI: boolean;
273
+ sharedArrayBuffer: boolean;
274
+ transferableObjects: boolean;
275
+ offscreenCanvas: boolean;
276
+ webAssembly: boolean;
277
+ atomics: boolean;
278
+ bigInt: boolean;
279
+ csp: {
280
+ workerSrc: boolean;
281
+ scriptSrc: boolean;
282
+ blobUrls: boolean;
283
+ inlineWorkers: boolean;
284
+ };
285
+ performance: {
286
+ memory: boolean;
287
+ measureUserAgentSpecificMemory: boolean;
288
+ };
289
+ }
290
+ export interface WorkerTask {
291
+ id: string;
292
+ type: string;
293
+ data: WorkerPayload;
294
+ priority: 'low' | 'normal' | 'high' | 'critical';
295
+ createdAt: number;
296
+ startedAt?: number;
297
+ completedAt?: number;
298
+ error?: WorkerError;
299
+ maxRetries?: number;
300
+ retries?: number;
301
+ timeout?: number;
302
+ }
303
+ export interface FallbackOptions {
304
+ useRequestIdleCallback: boolean;
305
+ idleTimeout: number;
306
+ chunkSize: number;
307
+ throttleMs: number;
308
+ maxExecutionTime: number;
309
+ }
310
+ export interface ResourceUsage {
311
+ memory: {
312
+ used: number;
313
+ limit: number;
314
+ percentage: number;
315
+ };
316
+ cpu: {
317
+ usage: number;
318
+ limit: number;
319
+ };
320
+ tasks: {
321
+ pending: number;
322
+ active: number;
323
+ completed: number;
324
+ failed: number;
325
+ };
326
+ activeWorkers: number;
327
+ }
328
+ export interface WorkerPoolConfig {
329
+ maxWorkers: number;
330
+ minWorkers: number;
331
+ workerIdleTimeout: number;
332
+ taskQueueSize: number;
333
+ resourceLimits: Record<string, number>;
334
+ autoScale?: boolean;
335
+ scaleUpThreshold?: number;
336
+ scaleDownThreshold?: number;
337
+ }
338
+ export type BeaconWorkerMessageType = 'init' | 'collect' | 'flush' | 'config' | 'status' | 'error' | 'response' | 'posture';
339
+ export type ProtocolVersion = '1.0' | '1.1' | '2.0';
340
+ export interface BeaconWorkerMessage {
341
+ type: BeaconWorkerMessageType;
342
+ data?: WorkerPayload;
343
+ payload?: WorkerPayload;
344
+ messageId: string;
345
+ timestamp: number;
346
+ id: string;
347
+ }
348
+ export interface WorkerConfig {
349
+ enabled?: boolean;
350
+ url?: string;
351
+ heartbeatInterval?: number;
352
+ maxUnhealthyCount?: number;
353
+ maxRetries?: number;
354
+ retryDelay?: number;
355
+ restartDelay?: number;
356
+ messageTimeout?: number;
357
+ compressionThreshold?: number;
358
+ allowFallback?: boolean;
359
+ crossOriginIsolated?: boolean;
360
+ maxRestartAttempts?: number;
361
+ terminationTimeout?: number;
362
+ taskTimeout?: number;
363
+ fallbackDelay?: number;
364
+ enableFallback?: boolean;
365
+ initTimeoutMs?: number;
366
+ }
367
+ export interface CircuitBreakerConfig {
368
+ threshold: number;
369
+ timeout: number;
370
+ resetTimeout: number;
371
+ }
372
+ export type CircuitBreakerState = 'closed' | 'open' | 'half-open';
373
+ export interface RetryStrategy {
374
+ maxAttempts: number;
375
+ baseDelay: number;
376
+ maxDelay: number;
377
+ factor: number;
378
+ jitter: boolean;
379
+ }
380
+ export interface OfflineQueueEntry {
381
+ id: string;
382
+ events: BeaconEvent[];
383
+ timestamp: number;
384
+ expiresAt: number;
385
+ retryCount: number;
386
+ size: number;
387
+ }
388
+ export interface BeaconBatch {
389
+ projectId: string;
390
+ events: BeaconEvent[];
391
+ sessionId: string;
392
+ batchId: string;
393
+ timestamp: number;
394
+ anonymizeIp?: boolean;
395
+ nonce?: string;
396
+ nonceEcho?: boolean;
397
+ }
398
+ export interface BeaconCollectorData {
399
+ userAgent?: string;
400
+ language?: string;
401
+ platform?: string;
402
+ screenResolution?: string;
403
+ viewport?: string;
404
+ cookiesEnabled?: boolean;
405
+ doNotTrack?: boolean;
406
+ timezone?: string;
407
+ referrer?: string;
408
+ url?: string;
409
+ title?: string;
410
+ vendor?: string;
411
+ pageLoadTime?: number;
412
+ domContentLoadedTime?: number;
413
+ firstPaintTime?: number;
414
+ firstContentfulPaintTime?: number;
415
+ connectionType?: string;
416
+ sessionId?: string;
417
+ timestamp?: number;
418
+ [key: string]: unknown;
419
+ }
420
+ export type BeaconEventType = 'pageview' | 'pageunload' | 'heartbeat' | 'custom' | 'error' | 'performance';
421
+ export declare function parseRetryStrategy(input: unknown): RetryStrategy;
422
+ export declare function parseCircuitBreakerConfig(input: unknown): CircuitBreakerConfig;
423
+ export declare function parseOfflineQueueEntry(input: unknown): OfflineQueueEntry;
424
+ export declare function parseBeaconWorkerMessage(input: unknown): BeaconWorkerMessage;
425
+ export declare function parseWorkerMessage(input: unknown): WorkerMessage;
426
+ export declare function parseWorkerError(input: unknown): WorkerError;
427
+ export declare function parseWorkerPoolConfig(input: unknown): WorkerPoolConfig;
428
+ export declare function parseResourceUsage(input: unknown): ResourceUsage;
429
+ export declare const ResourceUsageSchema: {
430
+ parse: typeof parseResourceUsage;
422
431
  };
423
- declare const WorkerPoolConfigSchema: {
424
- parse: typeof parseWorkerPoolConfig;
432
+ export declare const WorkerPoolConfigSchema: {
433
+ parse: typeof parseWorkerPoolConfig;
425
434
  };
426
- declare function parseWorkerCapabilities(input: unknown): WorkerCapabilities;
427
- declare function parseBeaconConfig(input: unknown): BeaconConfig;
428
- declare class AgentShieldBeacon implements IAgentShieldBeacon {
429
- constructor(config: BeaconConfig);
430
- collect(eventType: string, data?: BeaconPayload): Promise<void>;
431
- trackEvent(eventName: string, eventData?: BeaconPayload): Promise<void>;
432
- trackPageview(pageData?: BeaconPayload): Promise<void>;
433
- trackPageUnload(): Promise<void>;
434
- updateConfig(updates: Partial<BeaconConfig>): void;
435
- destroy(): Promise<void>;
436
- }
437
-
438
- export { AgentShieldBeacon, type BatchEvent, type BeaconBatch, type BeaconCollectorData, type BeaconConfig, type BeaconCustomData, type BeaconEvent, type BeaconEventType, type BeaconIdentity, type BeaconJsonValue, type BeaconMetadata, type BeaconPayload, type BeaconPrimitive, type BeaconResponse, type BeaconWorkerMessage, type BeaconWorkerMessageType, type BrowserContext, type CircuitBreakerConfig, type CircuitBreakerState, type ConnectionType, type FallbackOptions, type IAgentShieldBeacon, type JsonPrimitive, type JsonValue, type LargestContentfulPaintEntry, type MessagePriority, type NavigatorWithNetworkInformation, type NetworkInfo, type NetworkInformationLike, type OfflineQueueEntry, type PerformanceMemoryInfo, type PerformanceMetrics, type PerformanceWithMemory, type ProtocolVersion, type ResourceUsage, ResourceUsageSchema, type RetryStrategy, type SessionData, type TransportConfig, type TransportMetrics, type TransportOptions, type TransportResponse, type TransportState, type TrustedTypePolicyLike, type WindowWithBeaconMetadata, type WindowWithTrustedTypes, type WorkerAction, type WorkerCapabilities, type WorkerConfig, type WorkerError, type WorkerErrorType, type WorkerHealthStatus, type WorkerMessage, type WorkerMessageType, type WorkerMetrics, type WorkerPayload, type WorkerPoolConfig, WorkerPoolConfigSchema, type WorkerState, type WorkerTask, isBeaconIdentity, parseBeaconConfig, parseBeaconWorkerMessage, parseCircuitBreakerConfig, parseOfflineQueueEntry, parseResourceUsage, parseRetryStrategy, parseWorkerCapabilities, parseWorkerError, parseWorkerMessage, parseWorkerPoolConfig };
435
+ export declare function parseWorkerCapabilities(input: unknown): WorkerCapabilities;
436
+ export declare function parseBeaconConfig(input: unknown): BeaconConfig;
437
+ export declare class AgentShieldBeacon implements IAgentShieldBeacon {
438
+ constructor(config: BeaconConfig);
439
+ collect(eventType: string, data?: BeaconPayload): Promise<void>;
440
+ trackEvent(eventName: string, eventData?: BeaconPayload): Promise<void>;
441
+ trackPageview(pageData?: BeaconPayload): Promise<void>;
442
+ trackPageUnload(): Promise<void>;
443
+ updateConfig(updates: Partial<BeaconConfig>): void;
444
+ destroy(): Promise<void>;
445
+ }
446
+ //#endregion
447
+ //# sourceMappingURL=index.d.mts.map