@kya-os/checkpoint-shared 1.0.0 → 1.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.
@@ -0,0 +1,191 @@
1
+ // src/beacon-types/index.ts
2
+ function isRecord(input) {
3
+ return typeof input === "object" && input !== null && !Array.isArray(input);
4
+ }
5
+ function toRecord(input) {
6
+ return isRecord(input) ? input : {};
7
+ }
8
+ function numberOr(value, fallback) {
9
+ return typeof value === "number" && Number.isFinite(value) && value !== 0 ? value : fallback;
10
+ }
11
+ function stringOr(value, fallback) {
12
+ return typeof value === "string" ? value : fallback;
13
+ }
14
+ function isBeaconTags(value) {
15
+ return isRecord(value) && Object.values(value).every(
16
+ (entry) => typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean"
17
+ );
18
+ }
19
+ function isLogLevel(value) {
20
+ return value === "error" || value === "warn" || value === "info" || value === "debug";
21
+ }
22
+ function isBeaconWorkerMessageType(value) {
23
+ return value === "init" || value === "collect" || value === "flush" || value === "config" || value === "status" || value === "error";
24
+ }
25
+ function parseRetryStrategy(input) {
26
+ const strategy = toRecord(input);
27
+ return {
28
+ maxAttempts: numberOr(strategy.maxAttempts, 3),
29
+ baseDelay: numberOr(strategy.baseDelay, 1e3),
30
+ maxDelay: numberOr(strategy.maxDelay, 3e4),
31
+ factor: numberOr(strategy.factor, 2),
32
+ jitter: strategy.jitter !== false
33
+ };
34
+ }
35
+ function parseCircuitBreakerConfig(input) {
36
+ const config = toRecord(input);
37
+ return {
38
+ threshold: numberOr(config.threshold, 5),
39
+ timeout: numberOr(config.timeout, 6e4),
40
+ resetTimeout: numberOr(config.resetTimeout, 3e4)
41
+ };
42
+ }
43
+ function parseOfflineQueueEntry(input) {
44
+ if (!isRecord(input)) {
45
+ throw new Error("Invalid offline queue entry");
46
+ }
47
+ const entry = input;
48
+ return {
49
+ id: stringOr(entry.id, `${Date.now()}_${Math.random().toString(36).substr(2, 9)}`),
50
+ events: Array.isArray(entry.events) ? entry.events : [],
51
+ timestamp: numberOr(entry.timestamp, Date.now()),
52
+ expiresAt: numberOr(entry.expiresAt, Date.now() + 864e5),
53
+ // 24 hours
54
+ retryCount: numberOr(entry.retryCount, 0),
55
+ size: numberOr(entry.size, 0)
56
+ };
57
+ }
58
+ function parseBeaconWorkerMessage(input) {
59
+ if (!isRecord(input)) {
60
+ throw new Error("Invalid beacon worker message");
61
+ }
62
+ const msg = input;
63
+ const messageId = stringOr(msg.messageId) ?? stringOr(msg.id) ?? crypto.randomUUID();
64
+ return {
65
+ type: isBeaconWorkerMessageType(msg.type) ? msg.type : "init",
66
+ data: msg.data,
67
+ payload: msg.payload,
68
+ messageId,
69
+ timestamp: numberOr(msg.timestamp, Date.now()),
70
+ id: stringOr(msg.id, messageId)
71
+ };
72
+ }
73
+ function isMessagePriority(value) {
74
+ return value === "low" || value === "normal" || value === "high" || value === "critical";
75
+ }
76
+ function isWorkerMessageType(value) {
77
+ return value === "request" || value === "response" || value === "error" || value === "heartbeat" || value === "status";
78
+ }
79
+ function isWorkerErrorType(value) {
80
+ return value === "initialization" || value === "runtime" || value === "communication" || value === "timeout" || value === "memory" || value === "network" || value === "permission" || value === "validation" || value === "processing" || value === "unknown";
81
+ }
82
+ function parseWorkerMessage(input) {
83
+ const msg = input && typeof input === "object" ? input : null;
84
+ if (!msg) {
85
+ throw new Error("Invalid worker message");
86
+ }
87
+ return {
88
+ id: msg.id || crypto.randomUUID(),
89
+ type: isWorkerMessageType(msg.type) ? msg.type : "request",
90
+ action: msg.action,
91
+ payload: msg.payload,
92
+ timestamp: msg.timestamp || Date.now(),
93
+ compressed: msg.compressed,
94
+ priority: isMessagePriority(msg.priority) ? msg.priority : "normal",
95
+ correlationId: msg.correlationId
96
+ };
97
+ }
98
+ function parseWorkerError(input) {
99
+ const error = input && typeof input === "object" ? input : {};
100
+ return {
101
+ type: isWorkerErrorType(error.type) ? error.type : "unknown",
102
+ code: typeof error.code === "string" ? error.code : void 0,
103
+ message: typeof error.message === "string" ? error.message : "Worker error",
104
+ stack: typeof error.stack === "string" ? error.stack : void 0,
105
+ timestamp: typeof error.timestamp === "number" ? error.timestamp : Date.now(),
106
+ recoverable: error.recoverable !== false,
107
+ retryAfter: typeof error.retryAfter === "number" ? error.retryAfter : void 0,
108
+ context: error.context
109
+ };
110
+ }
111
+ function parseWorkerPoolConfig(input) {
112
+ const config = input && typeof input === "object" ? input : {};
113
+ return {
114
+ maxWorkers: config.maxWorkers ?? 4,
115
+ minWorkers: config.minWorkers ?? 1,
116
+ workerIdleTimeout: config.workerIdleTimeout ?? 3e4,
117
+ taskQueueSize: config.taskQueueSize ?? 100,
118
+ resourceLimits: config.resourceLimits ?? {},
119
+ autoScale: config.autoScale ?? true,
120
+ scaleUpThreshold: config.scaleUpThreshold ?? 75,
121
+ scaleDownThreshold: config.scaleDownThreshold ?? 25
122
+ };
123
+ }
124
+ function parseResourceUsage(input) {
125
+ const usage = input && typeof input === "object" ? input : {};
126
+ return {
127
+ memory: usage.memory ?? { used: 0, limit: 0, percentage: 0 },
128
+ cpu: usage.cpu ?? { usage: 0, limit: 100 },
129
+ tasks: usage.tasks ?? { pending: 0, active: 0, completed: 0, failed: 0 },
130
+ activeWorkers: usage.activeWorkers ?? 0
131
+ };
132
+ }
133
+ var ResourceUsageSchema = {
134
+ parse: parseResourceUsage
135
+ };
136
+ var WorkerPoolConfigSchema = {
137
+ parse: parseWorkerPoolConfig
138
+ };
139
+ function parseWorkerCapabilities(input) {
140
+ const cap = toRecord(input);
141
+ const csp = toRecord(cap.csp);
142
+ const performance = toRecord(cap.performance);
143
+ return {
144
+ workerAPI: cap.workerAPI !== false,
145
+ sharedArrayBuffer: cap.sharedArrayBuffer === true,
146
+ transferableObjects: cap.transferableObjects === true,
147
+ offscreenCanvas: cap.offscreenCanvas === true,
148
+ webAssembly: cap.webAssembly === true,
149
+ atomics: cap.atomics === true,
150
+ bigInt: cap.bigInt === true,
151
+ csp: {
152
+ workerSrc: csp.workerSrc === true,
153
+ scriptSrc: csp.scriptSrc === true,
154
+ blobUrls: csp.blobUrls === true,
155
+ inlineWorkers: csp.inlineWorkers === true
156
+ },
157
+ performance: {
158
+ memory: performance.memory === true,
159
+ measureUserAgentSpecificMemory: performance.measureUserAgentSpecificMemory === true
160
+ }
161
+ };
162
+ }
163
+ function parseBeaconConfig(input) {
164
+ const config = toRecord(input);
165
+ if (typeof config.projectId !== "string" || config.projectId.length === 0) {
166
+ throw new Error("Project ID is required");
167
+ }
168
+ return {
169
+ projectId: config.projectId,
170
+ environment: stringOr(config.environment),
171
+ tags: isBeaconTags(config.tags) ? config.tags : void 0,
172
+ enabled: config.enabled !== false,
173
+ debug: config.debug === true,
174
+ logLevel: isLogLevel(config.logLevel) ? config.logLevel : "error",
175
+ respectDoNotTrack: config.respectDoNotTrack !== false,
176
+ anonymizeIp: config.anonymizeIp === true,
177
+ sessionTimeout: numberOr(config.sessionTimeout, 18e5),
178
+ // 30 minutes
179
+ sessionCookieName: stringOr(config.sessionCookieName, "_as_beacon_session"),
180
+ batchSize: numberOr(config.batchSize, 10),
181
+ flushInterval: numberOr(config.flushInterval, 5e3),
182
+ maxQueueSize: numberOr(config.maxQueueSize, 100),
183
+ retryAttempts: numberOr(config.retryAttempts, 3),
184
+ retryDelay: numberOr(config.retryDelay, 2e3),
185
+ useWorker: config.useWorker !== false,
186
+ workerUrl: stringOr(config.workerUrl),
187
+ workerConfig: isRecord(config.workerConfig) ? config.workerConfig : void 0
188
+ };
189
+ }
190
+
191
+ export { ResourceUsageSchema, WorkerPoolConfigSchema, parseBeaconConfig, parseBeaconWorkerMessage, parseCircuitBreakerConfig, parseOfflineQueueEntry, parseResourceUsage, parseRetryStrategy, parseWorkerCapabilities, parseWorkerError, parseWorkerMessage, parseWorkerPoolConfig };
@@ -1,8 +1,9 @@
1
- interface DetectionResult {
1
+ interface BrowserDetectionResult {
2
2
  category: AgentCategory;
3
3
  confidence: ConfidenceLevel;
4
4
  agent?: AgentInfo;
5
5
  }
6
+
6
7
  type AgentCategory = 'human' | 'bot' | 'agent';
7
8
  type ConfidenceLevel = 'low' | 'medium' | 'high' | 'very_high';
8
9
  interface AgentInfo {
@@ -315,4 +316,4 @@ declare const RULE_CACHE: {
315
316
  readonly TIMESTAMP_KEY: "agentshield_rules_timestamp";
316
317
  };
317
318
 
318
- export { type AgentCategory, type AgentInfo, type BatchEvent, type BeaconBatch, type BeaconCollectorData, type BeaconConfig, type BeaconEvent, type BeaconEventType, type BeaconMetadata, type BeaconWorkerMessage, type BeaconWorkerMessageType, type CircuitBreakerConfig, type CircuitBreakerState, type ConfidenceLevel, type ConnectionType, DEFAULT_CONFIG, type DetectionResult, ERROR_TYPES, type FallbackOptions, Guards, type MessagePriority, type NetworkInfo, type OfflineQueueEntry, type ProtocolVersion, RULE_CACHE, type ResourceUsage, type RetryStrategy, type TransportConfig, type TransportMetrics, type TransportOptions, type TransportResponse, type TransportState, type WorkerAction, type WorkerCapabilities, type WorkerConfig, type WorkerError, type WorkerErrorType, type WorkerHealthStatus, type WorkerMessage, type WorkerMessageType, type WorkerMetrics, type WorkerPoolConfig, type WorkerState, type WorkerTask, parseBeaconConfig, parseBeaconWorkerMessage, parseCircuitBreakerConfig, parseFallbackOptions, parseOfflineQueueEntry, parseResourceUsage, parseRetryStrategy, parseWorkerCapabilities, parseWorkerConfig, parseWorkerError, parseWorkerMessage, parseWorkerPoolConfig, parseWorkerTask, validateBeaconBatch, validateBeaconConfig, validateBeaconEvent };
319
+ export { type AgentCategory, type AgentInfo, type BatchEvent, type BeaconBatch, type BeaconCollectorData, type BeaconConfig, type BeaconEvent, type BeaconEventType, type BeaconMetadata, type BeaconWorkerMessage, type BeaconWorkerMessageType, type BrowserDetectionResult, type CircuitBreakerConfig, type CircuitBreakerState, type ConfidenceLevel, type ConnectionType, DEFAULT_CONFIG, type BrowserDetectionResult as DetectionResult, ERROR_TYPES, type FallbackOptions, Guards, type MessagePriority, type NetworkInfo, type OfflineQueueEntry, type ProtocolVersion, RULE_CACHE, type ResourceUsage, type RetryStrategy, type TransportConfig, type TransportMetrics, type TransportOptions, type TransportResponse, type TransportState, type WorkerAction, type WorkerCapabilities, type WorkerConfig, type WorkerError, type WorkerErrorType, type WorkerHealthStatus, type WorkerMessage, type WorkerMessageType, type WorkerMetrics, type WorkerPoolConfig, type WorkerState, type WorkerTask, parseBeaconConfig, parseBeaconWorkerMessage, parseCircuitBreakerConfig, parseFallbackOptions, parseOfflineQueueEntry, parseResourceUsage, parseRetryStrategy, parseWorkerCapabilities, parseWorkerConfig, parseWorkerError, parseWorkerMessage, parseWorkerPoolConfig, parseWorkerTask, validateBeaconBatch, validateBeaconConfig, validateBeaconEvent };
package/dist/browser.d.ts CHANGED
@@ -1,8 +1,9 @@
1
- interface DetectionResult {
1
+ interface BrowserDetectionResult {
2
2
  category: AgentCategory;
3
3
  confidence: ConfidenceLevel;
4
4
  agent?: AgentInfo;
5
5
  }
6
+
6
7
  type AgentCategory = 'human' | 'bot' | 'agent';
7
8
  type ConfidenceLevel = 'low' | 'medium' | 'high' | 'very_high';
8
9
  interface AgentInfo {
@@ -315,4 +316,4 @@ declare const RULE_CACHE: {
315
316
  readonly TIMESTAMP_KEY: "agentshield_rules_timestamp";
316
317
  };
317
318
 
318
- export { type AgentCategory, type AgentInfo, type BatchEvent, type BeaconBatch, type BeaconCollectorData, type BeaconConfig, type BeaconEvent, type BeaconEventType, type BeaconMetadata, type BeaconWorkerMessage, type BeaconWorkerMessageType, type CircuitBreakerConfig, type CircuitBreakerState, type ConfidenceLevel, type ConnectionType, DEFAULT_CONFIG, type DetectionResult, ERROR_TYPES, type FallbackOptions, Guards, type MessagePriority, type NetworkInfo, type OfflineQueueEntry, type ProtocolVersion, RULE_CACHE, type ResourceUsage, type RetryStrategy, type TransportConfig, type TransportMetrics, type TransportOptions, type TransportResponse, type TransportState, type WorkerAction, type WorkerCapabilities, type WorkerConfig, type WorkerError, type WorkerErrorType, type WorkerHealthStatus, type WorkerMessage, type WorkerMessageType, type WorkerMetrics, type WorkerPoolConfig, type WorkerState, type WorkerTask, parseBeaconConfig, parseBeaconWorkerMessage, parseCircuitBreakerConfig, parseFallbackOptions, parseOfflineQueueEntry, parseResourceUsage, parseRetryStrategy, parseWorkerCapabilities, parseWorkerConfig, parseWorkerError, parseWorkerMessage, parseWorkerPoolConfig, parseWorkerTask, validateBeaconBatch, validateBeaconConfig, validateBeaconEvent };
319
+ export { type AgentCategory, type AgentInfo, type BatchEvent, type BeaconBatch, type BeaconCollectorData, type BeaconConfig, type BeaconEvent, type BeaconEventType, type BeaconMetadata, type BeaconWorkerMessage, type BeaconWorkerMessageType, type BrowserDetectionResult, type CircuitBreakerConfig, type CircuitBreakerState, type ConfidenceLevel, type ConnectionType, DEFAULT_CONFIG, type BrowserDetectionResult as DetectionResult, ERROR_TYPES, type FallbackOptions, Guards, type MessagePriority, type NetworkInfo, type OfflineQueueEntry, type ProtocolVersion, RULE_CACHE, type ResourceUsage, type RetryStrategy, type TransportConfig, type TransportMetrics, type TransportOptions, type TransportResponse, type TransportState, type WorkerAction, type WorkerCapabilities, type WorkerConfig, type WorkerError, type WorkerErrorType, type WorkerHealthStatus, type WorkerMessage, type WorkerMessageType, type WorkerMetrics, type WorkerPoolConfig, type WorkerState, type WorkerTask, parseBeaconConfig, parseBeaconWorkerMessage, parseCircuitBreakerConfig, parseFallbackOptions, parseOfflineQueueEntry, parseResourceUsage, parseRetryStrategy, parseWorkerCapabilities, parseWorkerConfig, parseWorkerError, parseWorkerMessage, parseWorkerPoolConfig, parseWorkerTask, validateBeaconBatch, validateBeaconConfig, validateBeaconEvent };
package/dist/browser.js CHANGED
@@ -1,2 +1 @@
1
- 'use strict';function t(r){if(!r||typeof r!="object")return false;let e=r,n=e.metadata;return !!(e.type&&typeof e.type=="string"&&e.data&&typeof e.data=="object"&&n&&typeof n=="object"&&n.sessionId&&n.timestamp)}function o(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string")}function a(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string"&&Array.isArray(e.events)&&e.events.every(n=>t(n))&&e.sessionId&&typeof e.sessionId=="string"&&e.batchId&&e.timestamp&&typeof e.timestamp=="number")}function s(r){let e=r&&typeof r=="object"?r:{};if(!e.projectId||typeof e.projectId!="string")throw new Error("Project ID is required");return {projectId:e.projectId,environment:e.environment,tags:e.tags,enabled:e.enabled!==false,debug:e.debug===true,logLevel:e.logLevel||"error",respectDoNotTrack:e.respectDoNotTrack!==false,anonymizeIp:e.anonymizeIp===true,sessionTimeout:e.sessionTimeout||18e5,sessionCookieName:e.sessionCookieName||"_as_beacon_session",batchSize:e.batchSize||10,flushInterval:e.flushInterval||5e3,maxQueueSize:e.maxQueueSize||100,retryAttempts:e.retryAttempts||3,retryDelay:e.retryDelay||2e3,useWorker:e.useWorker!==false,workerUrl:e.workerUrl,workerConfig:e.workerConfig}}var i={isBeaconEvent:t,isBeaconConfig:o,isBeaconBatch:a,isWorkerMessage(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.id&&e.type&&["request","response","error","heartbeat","status"].includes(e.type)&&typeof e.timestamp=="number")},isWorkerError(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.type&&e.message&&typeof e.timestamp=="number"&&typeof e.recoverable=="boolean")},isWorkerCapabilities(r){if(!r||typeof r!="object")return false;let e=r;return typeof e.workerAPI=="boolean"&&typeof e.sharedArrayBuffer=="boolean"&&typeof e.transferableObjects=="boolean"&&typeof e.offscreenCanvas=="boolean"}};function u(r){let e=r&&typeof r=="object"?r:{};return {enabled:e.enabled!==false,url:e.url,heartbeatInterval:e.heartbeatInterval||5e3,maxUnhealthyCount:e.maxUnhealthyCount||3,maxRetries:e.maxRetries||3,retryDelay:e.retryDelay||1e3,messageTimeout:e.messageTimeout||3e4,compressionThreshold:e.compressionThreshold||1024,allowFallback:e.allowFallback!==false,crossOriginIsolated:e.crossOriginIsolated===true}}function m(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker message");return {id:e.id||crypto.randomUUID(),type:e.type||"request",action:e.action,payload:e.payload,timestamp:e.timestamp||Date.now(),compressed:e.compressed===true,priority:e.priority||"normal",correlationId:e.correlationId}}function c(r){let e=r;return !e||typeof e!="object"?{type:"unknown",message:String(r),timestamp:Date.now(),recoverable:false}:{type:e.type||"unknown",message:e.message||"Unknown error",stack:e.stack,timestamp:e.timestamp||Date.now(),recoverable:!!e.recoverable}}function d(r){let e=r&&typeof r=="object"?r:{};return {workerAPI:e.workerAPI!==false,sharedArrayBuffer:e.sharedArrayBuffer===true,transferableObjects:e.transferableObjects===true,offscreenCanvas:e.offscreenCanvas===true,webAssembly:e.webAssembly===true,atomics:e.atomics===true,bigInt:e.bigInt===true,csp:e.csp||{workerSrc:false,scriptSrc:false,blobUrls:false,inlineWorkers:false},performance:e.performance||{memory:false,measureUserAgentSpecificMemory:false}}}function l(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker task");return {id:e.id||crypto.randomUUID(),type:e.type||"process",data:e.data,priority:e.priority||"normal",createdAt:e.createdAt||Date.now(),startedAt:e.startedAt,completedAt:e.completedAt,error:e.error,maxRetries:e.maxRetries,retries:e.retries,timeout:e.timeout}}function b(r){let e=r&&typeof r=="object"?r:{};return {useRequestIdleCallback:e.useRequestIdleCallback!==false,idleTimeout:e.idleTimeout||1e4,chunkSize:e.chunkSize||10,throttleMs:e.throttleMs||16,maxExecutionTime:e.maxExecutionTime||50}}function f(r){let e=r&&typeof r=="object"?r:{};return {maxAttempts:e.maxAttempts||3,baseDelay:e.baseDelay||1e3,maxDelay:e.maxDelay||3e4,factor:e.factor||2,jitter:e.jitter!==false}}function p(r){let e=r&&typeof r=="object"?r:{};return {threshold:e.threshold||5,timeout:e.timeout||6e4,resetTimeout:e.resetTimeout||3e4}}function g(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid offline queue entry");return {id:e.id||`${Date.now()}_${Math.random().toString(36).substr(2,9)}`,events:Array.isArray(e.events)?e.events:[],timestamp:e.timestamp||Date.now(),expiresAt:e.expiresAt||Date.now()+864e5,retryCount:e.retryCount||0,size:e.size||0}}function k(r){let e=r&&typeof r=="object"?r:{};return {memoryUsage:e.memoryUsage||0,cpuUsage:e.cpuUsage||0,taskCount:e.taskCount||0,activeWorkers:e.activeWorkers||0,pendingTasks:e.pendingTasks||0,completedTasks:e.completedTasks||0,failedTasks:e.failedTasks||0,averageTaskDuration:e.averageTaskDuration||0}}function y(r){let e=r&&typeof r=="object"?r:{};return {maxWorkers:e.maxWorkers||4,minWorkers:e.minWorkers||1,workerIdleTimeout:e.workerIdleTimeout||6e4,taskQueueSize:e.taskQueueSize||100,resourceLimits:e.resourceLimits||{}}}function w(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid beacon worker message");return {type:e.type||"collect",data:e.data,messageId:e.messageId||crypto.randomUUID(),timestamp:e.timestamp||Date.now()}}var h={batchSize:10,flushInterval:5e3,sessionTimeout:18e5,sessionCookieName:"_as_beacon_session",retryAttempts:3,retryDelay:2e3},x={NETWORK:"network",VALIDATION:"validation",TIMEOUT:"timeout",UNKNOWN:"unknown"},T={DEFAULT_DURATION:36e5,MAX_DURATION:864e5,MIN_DURATION:6e4,STORAGE_KEY:"agentshield_rules",TIMESTAMP_KEY:"agentshield_rules_timestamp"};exports.DEFAULT_CONFIG=h;exports.ERROR_TYPES=x;exports.Guards=i;exports.RULE_CACHE=T;exports.parseBeaconConfig=s;exports.parseBeaconWorkerMessage=w;exports.parseCircuitBreakerConfig=p;exports.parseFallbackOptions=b;exports.parseOfflineQueueEntry=g;exports.parseResourceUsage=k;exports.parseRetryStrategy=f;exports.parseWorkerCapabilities=d;exports.parseWorkerConfig=u;exports.parseWorkerError=c;exports.parseWorkerMessage=m;exports.parseWorkerPoolConfig=y;exports.parseWorkerTask=l;exports.validateBeaconBatch=a;exports.validateBeaconConfig=o;exports.validateBeaconEvent=t;//# sourceMappingURL=browser.js.map
2
- //# sourceMappingURL=browser.js.map
1
+ 'use strict';function t(r){if(!r||typeof r!="object")return false;let e=r,n=e.metadata;return !!(e.type&&typeof e.type=="string"&&e.data&&typeof e.data=="object"&&n&&typeof n=="object"&&n.sessionId&&n.timestamp)}function o(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string")}function a(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string"&&Array.isArray(e.events)&&e.events.every(n=>t(n))&&e.sessionId&&typeof e.sessionId=="string"&&e.batchId&&e.timestamp&&typeof e.timestamp=="number")}function s(r){let e=r&&typeof r=="object"?r:{};if(!e.projectId||typeof e.projectId!="string")throw new Error("Project ID is required");return {projectId:e.projectId,environment:e.environment,tags:e.tags,enabled:e.enabled!==false,debug:e.debug===true,logLevel:e.logLevel||"error",respectDoNotTrack:e.respectDoNotTrack!==false,anonymizeIp:e.anonymizeIp===true,sessionTimeout:e.sessionTimeout||18e5,sessionCookieName:e.sessionCookieName||"_as_beacon_session",batchSize:e.batchSize||10,flushInterval:e.flushInterval||5e3,maxQueueSize:e.maxQueueSize||100,retryAttempts:e.retryAttempts||3,retryDelay:e.retryDelay||2e3,useWorker:e.useWorker!==false,workerUrl:e.workerUrl,workerConfig:e.workerConfig}}var i={isBeaconEvent:t,isBeaconConfig:o,isBeaconBatch:a,isWorkerMessage(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.id&&e.type&&["request","response","error","heartbeat","status"].includes(e.type)&&typeof e.timestamp=="number")},isWorkerError(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.type&&e.message&&typeof e.timestamp=="number"&&typeof e.recoverable=="boolean")},isWorkerCapabilities(r){if(!r||typeof r!="object")return false;let e=r;return typeof e.workerAPI=="boolean"&&typeof e.sharedArrayBuffer=="boolean"&&typeof e.transferableObjects=="boolean"&&typeof e.offscreenCanvas=="boolean"}};function u(r){let e=r&&typeof r=="object"?r:{};return {enabled:e.enabled!==false,url:e.url,heartbeatInterval:e.heartbeatInterval||5e3,maxUnhealthyCount:e.maxUnhealthyCount||3,maxRetries:e.maxRetries||3,retryDelay:e.retryDelay||1e3,messageTimeout:e.messageTimeout||3e4,compressionThreshold:e.compressionThreshold||1024,allowFallback:e.allowFallback!==false,crossOriginIsolated:e.crossOriginIsolated===true}}function m(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker message");return {id:e.id||crypto.randomUUID(),type:e.type||"request",action:e.action,payload:e.payload,timestamp:e.timestamp||Date.now(),compressed:e.compressed===true,priority:e.priority||"normal",correlationId:e.correlationId}}function c(r){let e=r;return !e||typeof e!="object"?{type:"unknown",message:String(r),timestamp:Date.now(),recoverable:false}:{type:e.type||"unknown",message:e.message||"Unknown error",stack:e.stack,timestamp:e.timestamp||Date.now(),recoverable:!!e.recoverable}}function d(r){let e=r&&typeof r=="object"?r:{};return {workerAPI:e.workerAPI!==false,sharedArrayBuffer:e.sharedArrayBuffer===true,transferableObjects:e.transferableObjects===true,offscreenCanvas:e.offscreenCanvas===true,webAssembly:e.webAssembly===true,atomics:e.atomics===true,bigInt:e.bigInt===true,csp:e.csp||{workerSrc:false,scriptSrc:false,blobUrls:false,inlineWorkers:false},performance:e.performance||{memory:false,measureUserAgentSpecificMemory:false}}}function l(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker task");return {id:e.id||crypto.randomUUID(),type:e.type||"process",data:e.data,priority:e.priority||"normal",createdAt:e.createdAt||Date.now(),startedAt:e.startedAt,completedAt:e.completedAt,error:e.error,maxRetries:e.maxRetries,retries:e.retries,timeout:e.timeout}}function b(r){let e=r&&typeof r=="object"?r:{};return {useRequestIdleCallback:e.useRequestIdleCallback!==false,idleTimeout:e.idleTimeout||1e4,chunkSize:e.chunkSize||10,throttleMs:e.throttleMs||16,maxExecutionTime:e.maxExecutionTime||50}}function f(r){let e=r&&typeof r=="object"?r:{};return {maxAttempts:e.maxAttempts||3,baseDelay:e.baseDelay||1e3,maxDelay:e.maxDelay||3e4,factor:e.factor||2,jitter:e.jitter!==false}}function p(r){let e=r&&typeof r=="object"?r:{};return {threshold:e.threshold||5,timeout:e.timeout||6e4,resetTimeout:e.resetTimeout||3e4}}function g(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid offline queue entry");return {id:e.id||`${Date.now()}_${Math.random().toString(36).substr(2,9)}`,events:Array.isArray(e.events)?e.events:[],timestamp:e.timestamp||Date.now(),expiresAt:e.expiresAt||Date.now()+864e5,retryCount:e.retryCount||0,size:e.size||0}}function k(r){let e=r&&typeof r=="object"?r:{};return {memoryUsage:e.memoryUsage||0,cpuUsage:e.cpuUsage||0,taskCount:e.taskCount||0,activeWorkers:e.activeWorkers||0,pendingTasks:e.pendingTasks||0,completedTasks:e.completedTasks||0,failedTasks:e.failedTasks||0,averageTaskDuration:e.averageTaskDuration||0}}function y(r){let e=r&&typeof r=="object"?r:{};return {maxWorkers:e.maxWorkers||4,minWorkers:e.minWorkers||1,workerIdleTimeout:e.workerIdleTimeout||6e4,taskQueueSize:e.taskQueueSize||100,resourceLimits:e.resourceLimits||{}}}function w(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid beacon worker message");return {type:e.type||"collect",data:e.data,messageId:e.messageId||crypto.randomUUID(),timestamp:e.timestamp||Date.now()}}var h={batchSize:10,flushInterval:5e3,sessionTimeout:18e5,sessionCookieName:"_as_beacon_session",retryAttempts:3,retryDelay:2e3},x={NETWORK:"network",VALIDATION:"validation",TIMEOUT:"timeout",UNKNOWN:"unknown"},T={DEFAULT_DURATION:36e5,MAX_DURATION:864e5,MIN_DURATION:6e4,STORAGE_KEY:"agentshield_rules",TIMESTAMP_KEY:"agentshield_rules_timestamp"};exports.DEFAULT_CONFIG=h;exports.ERROR_TYPES=x;exports.Guards=i;exports.RULE_CACHE=T;exports.parseBeaconConfig=s;exports.parseBeaconWorkerMessage=w;exports.parseCircuitBreakerConfig=p;exports.parseFallbackOptions=b;exports.parseOfflineQueueEntry=g;exports.parseResourceUsage=k;exports.parseRetryStrategy=f;exports.parseWorkerCapabilities=d;exports.parseWorkerConfig=u;exports.parseWorkerError=c;exports.parseWorkerMessage=m;exports.parseWorkerPoolConfig=y;exports.parseWorkerTask=l;exports.validateBeaconBatch=a;exports.validateBeaconConfig=o;exports.validateBeaconEvent=t;
package/dist/browser.mjs CHANGED
@@ -1,2 +1 @@
1
- function t(r){if(!r||typeof r!="object")return false;let e=r,n=e.metadata;return !!(e.type&&typeof e.type=="string"&&e.data&&typeof e.data=="object"&&n&&typeof n=="object"&&n.sessionId&&n.timestamp)}function o(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string")}function a(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string"&&Array.isArray(e.events)&&e.events.every(n=>t(n))&&e.sessionId&&typeof e.sessionId=="string"&&e.batchId&&e.timestamp&&typeof e.timestamp=="number")}function s(r){let e=r&&typeof r=="object"?r:{};if(!e.projectId||typeof e.projectId!="string")throw new Error("Project ID is required");return {projectId:e.projectId,environment:e.environment,tags:e.tags,enabled:e.enabled!==false,debug:e.debug===true,logLevel:e.logLevel||"error",respectDoNotTrack:e.respectDoNotTrack!==false,anonymizeIp:e.anonymizeIp===true,sessionTimeout:e.sessionTimeout||18e5,sessionCookieName:e.sessionCookieName||"_as_beacon_session",batchSize:e.batchSize||10,flushInterval:e.flushInterval||5e3,maxQueueSize:e.maxQueueSize||100,retryAttempts:e.retryAttempts||3,retryDelay:e.retryDelay||2e3,useWorker:e.useWorker!==false,workerUrl:e.workerUrl,workerConfig:e.workerConfig}}var i={isBeaconEvent:t,isBeaconConfig:o,isBeaconBatch:a,isWorkerMessage(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.id&&e.type&&["request","response","error","heartbeat","status"].includes(e.type)&&typeof e.timestamp=="number")},isWorkerError(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.type&&e.message&&typeof e.timestamp=="number"&&typeof e.recoverable=="boolean")},isWorkerCapabilities(r){if(!r||typeof r!="object")return false;let e=r;return typeof e.workerAPI=="boolean"&&typeof e.sharedArrayBuffer=="boolean"&&typeof e.transferableObjects=="boolean"&&typeof e.offscreenCanvas=="boolean"}};function u(r){let e=r&&typeof r=="object"?r:{};return {enabled:e.enabled!==false,url:e.url,heartbeatInterval:e.heartbeatInterval||5e3,maxUnhealthyCount:e.maxUnhealthyCount||3,maxRetries:e.maxRetries||3,retryDelay:e.retryDelay||1e3,messageTimeout:e.messageTimeout||3e4,compressionThreshold:e.compressionThreshold||1024,allowFallback:e.allowFallback!==false,crossOriginIsolated:e.crossOriginIsolated===true}}function m(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker message");return {id:e.id||crypto.randomUUID(),type:e.type||"request",action:e.action,payload:e.payload,timestamp:e.timestamp||Date.now(),compressed:e.compressed===true,priority:e.priority||"normal",correlationId:e.correlationId}}function c(r){let e=r;return !e||typeof e!="object"?{type:"unknown",message:String(r),timestamp:Date.now(),recoverable:false}:{type:e.type||"unknown",message:e.message||"Unknown error",stack:e.stack,timestamp:e.timestamp||Date.now(),recoverable:!!e.recoverable}}function d(r){let e=r&&typeof r=="object"?r:{};return {workerAPI:e.workerAPI!==false,sharedArrayBuffer:e.sharedArrayBuffer===true,transferableObjects:e.transferableObjects===true,offscreenCanvas:e.offscreenCanvas===true,webAssembly:e.webAssembly===true,atomics:e.atomics===true,bigInt:e.bigInt===true,csp:e.csp||{workerSrc:false,scriptSrc:false,blobUrls:false,inlineWorkers:false},performance:e.performance||{memory:false,measureUserAgentSpecificMemory:false}}}function l(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker task");return {id:e.id||crypto.randomUUID(),type:e.type||"process",data:e.data,priority:e.priority||"normal",createdAt:e.createdAt||Date.now(),startedAt:e.startedAt,completedAt:e.completedAt,error:e.error,maxRetries:e.maxRetries,retries:e.retries,timeout:e.timeout}}function b(r){let e=r&&typeof r=="object"?r:{};return {useRequestIdleCallback:e.useRequestIdleCallback!==false,idleTimeout:e.idleTimeout||1e4,chunkSize:e.chunkSize||10,throttleMs:e.throttleMs||16,maxExecutionTime:e.maxExecutionTime||50}}function f(r){let e=r&&typeof r=="object"?r:{};return {maxAttempts:e.maxAttempts||3,baseDelay:e.baseDelay||1e3,maxDelay:e.maxDelay||3e4,factor:e.factor||2,jitter:e.jitter!==false}}function p(r){let e=r&&typeof r=="object"?r:{};return {threshold:e.threshold||5,timeout:e.timeout||6e4,resetTimeout:e.resetTimeout||3e4}}function g(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid offline queue entry");return {id:e.id||`${Date.now()}_${Math.random().toString(36).substr(2,9)}`,events:Array.isArray(e.events)?e.events:[],timestamp:e.timestamp||Date.now(),expiresAt:e.expiresAt||Date.now()+864e5,retryCount:e.retryCount||0,size:e.size||0}}function k(r){let e=r&&typeof r=="object"?r:{};return {memoryUsage:e.memoryUsage||0,cpuUsage:e.cpuUsage||0,taskCount:e.taskCount||0,activeWorkers:e.activeWorkers||0,pendingTasks:e.pendingTasks||0,completedTasks:e.completedTasks||0,failedTasks:e.failedTasks||0,averageTaskDuration:e.averageTaskDuration||0}}function y(r){let e=r&&typeof r=="object"?r:{};return {maxWorkers:e.maxWorkers||4,minWorkers:e.minWorkers||1,workerIdleTimeout:e.workerIdleTimeout||6e4,taskQueueSize:e.taskQueueSize||100,resourceLimits:e.resourceLimits||{}}}function w(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid beacon worker message");return {type:e.type||"collect",data:e.data,messageId:e.messageId||crypto.randomUUID(),timestamp:e.timestamp||Date.now()}}var h={batchSize:10,flushInterval:5e3,sessionTimeout:18e5,sessionCookieName:"_as_beacon_session",retryAttempts:3,retryDelay:2e3},x={NETWORK:"network",VALIDATION:"validation",TIMEOUT:"timeout",UNKNOWN:"unknown"},T={DEFAULT_DURATION:36e5,MAX_DURATION:864e5,MIN_DURATION:6e4,STORAGE_KEY:"agentshield_rules",TIMESTAMP_KEY:"agentshield_rules_timestamp"};export{h as DEFAULT_CONFIG,x as ERROR_TYPES,i as Guards,T as RULE_CACHE,s as parseBeaconConfig,w as parseBeaconWorkerMessage,p as parseCircuitBreakerConfig,b as parseFallbackOptions,g as parseOfflineQueueEntry,k as parseResourceUsage,f as parseRetryStrategy,d as parseWorkerCapabilities,u as parseWorkerConfig,c as parseWorkerError,m as parseWorkerMessage,y as parseWorkerPoolConfig,l as parseWorkerTask,a as validateBeaconBatch,o as validateBeaconConfig,t as validateBeaconEvent};//# sourceMappingURL=browser.mjs.map
2
- //# sourceMappingURL=browser.mjs.map
1
+ function t(r){if(!r||typeof r!="object")return false;let e=r,n=e.metadata;return !!(e.type&&typeof e.type=="string"&&e.data&&typeof e.data=="object"&&n&&typeof n=="object"&&n.sessionId&&n.timestamp)}function o(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string")}function a(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.projectId&&typeof e.projectId=="string"&&Array.isArray(e.events)&&e.events.every(n=>t(n))&&e.sessionId&&typeof e.sessionId=="string"&&e.batchId&&e.timestamp&&typeof e.timestamp=="number")}function s(r){let e=r&&typeof r=="object"?r:{};if(!e.projectId||typeof e.projectId!="string")throw new Error("Project ID is required");return {projectId:e.projectId,environment:e.environment,tags:e.tags,enabled:e.enabled!==false,debug:e.debug===true,logLevel:e.logLevel||"error",respectDoNotTrack:e.respectDoNotTrack!==false,anonymizeIp:e.anonymizeIp===true,sessionTimeout:e.sessionTimeout||18e5,sessionCookieName:e.sessionCookieName||"_as_beacon_session",batchSize:e.batchSize||10,flushInterval:e.flushInterval||5e3,maxQueueSize:e.maxQueueSize||100,retryAttempts:e.retryAttempts||3,retryDelay:e.retryDelay||2e3,useWorker:e.useWorker!==false,workerUrl:e.workerUrl,workerConfig:e.workerConfig}}var i={isBeaconEvent:t,isBeaconConfig:o,isBeaconBatch:a,isWorkerMessage(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.id&&e.type&&["request","response","error","heartbeat","status"].includes(e.type)&&typeof e.timestamp=="number")},isWorkerError(r){if(!r||typeof r!="object")return false;let e=r;return !!(e.type&&e.message&&typeof e.timestamp=="number"&&typeof e.recoverable=="boolean")},isWorkerCapabilities(r){if(!r||typeof r!="object")return false;let e=r;return typeof e.workerAPI=="boolean"&&typeof e.sharedArrayBuffer=="boolean"&&typeof e.transferableObjects=="boolean"&&typeof e.offscreenCanvas=="boolean"}};function u(r){let e=r&&typeof r=="object"?r:{};return {enabled:e.enabled!==false,url:e.url,heartbeatInterval:e.heartbeatInterval||5e3,maxUnhealthyCount:e.maxUnhealthyCount||3,maxRetries:e.maxRetries||3,retryDelay:e.retryDelay||1e3,messageTimeout:e.messageTimeout||3e4,compressionThreshold:e.compressionThreshold||1024,allowFallback:e.allowFallback!==false,crossOriginIsolated:e.crossOriginIsolated===true}}function m(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker message");return {id:e.id||crypto.randomUUID(),type:e.type||"request",action:e.action,payload:e.payload,timestamp:e.timestamp||Date.now(),compressed:e.compressed===true,priority:e.priority||"normal",correlationId:e.correlationId}}function c(r){let e=r;return !e||typeof e!="object"?{type:"unknown",message:String(r),timestamp:Date.now(),recoverable:false}:{type:e.type||"unknown",message:e.message||"Unknown error",stack:e.stack,timestamp:e.timestamp||Date.now(),recoverable:!!e.recoverable}}function d(r){let e=r&&typeof r=="object"?r:{};return {workerAPI:e.workerAPI!==false,sharedArrayBuffer:e.sharedArrayBuffer===true,transferableObjects:e.transferableObjects===true,offscreenCanvas:e.offscreenCanvas===true,webAssembly:e.webAssembly===true,atomics:e.atomics===true,bigInt:e.bigInt===true,csp:e.csp||{workerSrc:false,scriptSrc:false,blobUrls:false,inlineWorkers:false},performance:e.performance||{memory:false,measureUserAgentSpecificMemory:false}}}function l(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid worker task");return {id:e.id||crypto.randomUUID(),type:e.type||"process",data:e.data,priority:e.priority||"normal",createdAt:e.createdAt||Date.now(),startedAt:e.startedAt,completedAt:e.completedAt,error:e.error,maxRetries:e.maxRetries,retries:e.retries,timeout:e.timeout}}function b(r){let e=r&&typeof r=="object"?r:{};return {useRequestIdleCallback:e.useRequestIdleCallback!==false,idleTimeout:e.idleTimeout||1e4,chunkSize:e.chunkSize||10,throttleMs:e.throttleMs||16,maxExecutionTime:e.maxExecutionTime||50}}function f(r){let e=r&&typeof r=="object"?r:{};return {maxAttempts:e.maxAttempts||3,baseDelay:e.baseDelay||1e3,maxDelay:e.maxDelay||3e4,factor:e.factor||2,jitter:e.jitter!==false}}function p(r){let e=r&&typeof r=="object"?r:{};return {threshold:e.threshold||5,timeout:e.timeout||6e4,resetTimeout:e.resetTimeout||3e4}}function g(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid offline queue entry");return {id:e.id||`${Date.now()}_${Math.random().toString(36).substr(2,9)}`,events:Array.isArray(e.events)?e.events:[],timestamp:e.timestamp||Date.now(),expiresAt:e.expiresAt||Date.now()+864e5,retryCount:e.retryCount||0,size:e.size||0}}function k(r){let e=r&&typeof r=="object"?r:{};return {memoryUsage:e.memoryUsage||0,cpuUsage:e.cpuUsage||0,taskCount:e.taskCount||0,activeWorkers:e.activeWorkers||0,pendingTasks:e.pendingTasks||0,completedTasks:e.completedTasks||0,failedTasks:e.failedTasks||0,averageTaskDuration:e.averageTaskDuration||0}}function y(r){let e=r&&typeof r=="object"?r:{};return {maxWorkers:e.maxWorkers||4,minWorkers:e.minWorkers||1,workerIdleTimeout:e.workerIdleTimeout||6e4,taskQueueSize:e.taskQueueSize||100,resourceLimits:e.resourceLimits||{}}}function w(r){let e=r;if(!e||typeof e!="object")throw new Error("Invalid beacon worker message");return {type:e.type||"collect",data:e.data,messageId:e.messageId||crypto.randomUUID(),timestamp:e.timestamp||Date.now()}}var h={batchSize:10,flushInterval:5e3,sessionTimeout:18e5,sessionCookieName:"_as_beacon_session",retryAttempts:3,retryDelay:2e3},x={NETWORK:"network",VALIDATION:"validation",TIMEOUT:"timeout",UNKNOWN:"unknown"},T={DEFAULT_DURATION:36e5,MAX_DURATION:864e5,MIN_DURATION:6e4,STORAGE_KEY:"agentshield_rules",TIMESTAMP_KEY:"agentshield_rules_timestamp"};export{h as DEFAULT_CONFIG,x as ERROR_TYPES,i as Guards,T as RULE_CACHE,s as parseBeaconConfig,w as parseBeaconWorkerMessage,p as parseCircuitBreakerConfig,b as parseFallbackOptions,g as parseOfflineQueueEntry,k as parseResourceUsage,f as parseRetryStrategy,d as parseWorkerCapabilities,u as parseWorkerConfig,c as parseWorkerError,m as parseWorkerMessage,y as parseWorkerPoolConfig,l as parseWorkerTask,a as validateBeaconBatch,o as validateBeaconConfig,t as validateBeaconEvent};
@@ -0,0 +1,40 @@
1
+ interface McpIPayload {
2
+ aud: string;
3
+ iss: string;
4
+ sub: string;
5
+ nonce: string;
6
+ sessionId: string;
7
+ ts: number;
8
+ requestHash: string;
9
+ responseHash: string;
10
+ }
11
+ declare function canonicalSigningPayload(payload: McpIPayload): Uint8Array;
12
+ declare function validateMcpIPayload(value: unknown): McpIPayload;
13
+
14
+ interface KeyMaterial {
15
+ signingKey: Uint8Array;
16
+ publicKey: Uint8Array;
17
+ did: string;
18
+ kid: string;
19
+ }
20
+ declare function parseSigningKey(seed: Uint8Array): Promise<KeyMaterial>;
21
+
22
+ declare function signMcpiEnvelope(payload: McpIPayload, key: KeyMaterial): Promise<string>;
23
+
24
+ interface ParsedJws {
25
+ header: {
26
+ alg: 'EdDSA';
27
+ kid: string;
28
+ typ?: string;
29
+ };
30
+ payload: McpIPayload;
31
+ signatureBytes: Uint8Array;
32
+ signingInput: Uint8Array;
33
+ }
34
+ declare class JwsParseError extends Error {
35
+ readonly code: 'WrongSegmentCount' | 'InvalidBase64' | 'InvalidJson' | 'InvalidHeaderShape' | 'InvalidPayloadShape' | 'UnsupportedAlgorithm' | 'InvalidSignatureLength';
36
+ constructor(code: 'WrongSegmentCount' | 'InvalidBase64' | 'InvalidJson' | 'InvalidHeaderShape' | 'InvalidPayloadShape' | 'UnsupportedAlgorithm' | 'InvalidSignatureLength', message: string);
37
+ }
38
+ declare function parseJwsCompact(jws: string): ParsedJws;
39
+
40
+ export { JwsParseError, type KeyMaterial, type McpIPayload, type ParsedJws, canonicalSigningPayload, parseJwsCompact, parseSigningKey, signMcpiEnvelope, validateMcpIPayload };
@@ -0,0 +1,40 @@
1
+ interface McpIPayload {
2
+ aud: string;
3
+ iss: string;
4
+ sub: string;
5
+ nonce: string;
6
+ sessionId: string;
7
+ ts: number;
8
+ requestHash: string;
9
+ responseHash: string;
10
+ }
11
+ declare function canonicalSigningPayload(payload: McpIPayload): Uint8Array;
12
+ declare function validateMcpIPayload(value: unknown): McpIPayload;
13
+
14
+ interface KeyMaterial {
15
+ signingKey: Uint8Array;
16
+ publicKey: Uint8Array;
17
+ did: string;
18
+ kid: string;
19
+ }
20
+ declare function parseSigningKey(seed: Uint8Array): Promise<KeyMaterial>;
21
+
22
+ declare function signMcpiEnvelope(payload: McpIPayload, key: KeyMaterial): Promise<string>;
23
+
24
+ interface ParsedJws {
25
+ header: {
26
+ alg: 'EdDSA';
27
+ kid: string;
28
+ typ?: string;
29
+ };
30
+ payload: McpIPayload;
31
+ signatureBytes: Uint8Array;
32
+ signingInput: Uint8Array;
33
+ }
34
+ declare class JwsParseError extends Error {
35
+ readonly code: 'WrongSegmentCount' | 'InvalidBase64' | 'InvalidJson' | 'InvalidHeaderShape' | 'InvalidPayloadShape' | 'UnsupportedAlgorithm' | 'InvalidSignatureLength';
36
+ constructor(code: 'WrongSegmentCount' | 'InvalidBase64' | 'InvalidJson' | 'InvalidHeaderShape' | 'InvalidPayloadShape' | 'UnsupportedAlgorithm' | 'InvalidSignatureLength', message: string);
37
+ }
38
+ declare function parseJwsCompact(jws: string): ParsedJws;
39
+
40
+ export { JwsParseError, type KeyMaterial, type McpIPayload, type ParsedJws, canonicalSigningPayload, parseJwsCompact, parseSigningKey, signMcpiEnvelope, validateMcpIPayload };
@@ -0,0 +1,186 @@
1
+ 'use strict';
2
+
3
+ var canonicalize = require('canonicalize');
4
+ var ed25519 = require('@noble/ed25519');
5
+ var base58 = require('multiformats/bases/base58');
6
+
7
+ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
8
+
9
+ var canonicalize__default = /*#__PURE__*/_interopDefault(canonicalize);
10
+
11
+ // src/canonical-signer/payload.ts
12
+ function canonicalSigningPayload(payload) {
13
+ const json = canonicalize__default.default(payload);
14
+ if (json === void 0) {
15
+ throw new Error("canonicalSigningPayload: payload contains non-serializable values");
16
+ }
17
+ return new TextEncoder().encode(json);
18
+ }
19
+ var REQUIRED_STRING_FIELDS = [
20
+ "aud",
21
+ "iss",
22
+ "sub",
23
+ "nonce",
24
+ "sessionId",
25
+ "requestHash",
26
+ "responseHash"
27
+ ];
28
+ function validateMcpIPayload(value) {
29
+ if (value === null || typeof value !== "object") {
30
+ throw new Error(`expected JSON object, got ${value === null ? "null" : typeof value}`);
31
+ }
32
+ const obj = value;
33
+ for (const field of REQUIRED_STRING_FIELDS) {
34
+ if (typeof obj[field] !== "string") {
35
+ throw new Error(`missing or non-string required field "${field}" (got ${typeof obj[field]})`);
36
+ }
37
+ }
38
+ if (typeof obj.ts !== "number" || !Number.isFinite(obj.ts)) {
39
+ throw new Error(`missing or non-finite-number required field "ts" (got ${typeof obj.ts})`);
40
+ }
41
+ return obj;
42
+ }
43
+ var ED25519_MULTICODEC_PREFIX = new Uint8Array([237, 1]);
44
+ async function parseSigningKey(seed) {
45
+ if (seed.length !== 32) {
46
+ throw new Error(`parseSigningKey: expected 32-byte Ed25519 seed, got ${seed.length} bytes`);
47
+ }
48
+ const publicKey = await ed25519.getPublicKeyAsync(seed);
49
+ const multibaseBytes = new Uint8Array(ED25519_MULTICODEC_PREFIX.length + publicKey.length);
50
+ multibaseBytes.set(ED25519_MULTICODEC_PREFIX, 0);
51
+ multibaseBytes.set(publicKey, ED25519_MULTICODEC_PREFIX.length);
52
+ const multibase = base58.base58btc.encode(multibaseBytes);
53
+ const did = `did:key:${multibase}`;
54
+ return {
55
+ // Defensive copy — see KeyMaterial.signingKey docstring. The Sign-1
56
+ // tests assert that mutating the input seed after this call does NOT
57
+ // mutate the held key material.
58
+ signingKey: Uint8Array.from(seed),
59
+ publicKey,
60
+ did,
61
+ // mcp-i-core PR #16: the verification-method id is the multibase value
62
+ // as a fragment. Anything else (`#keys-1`, `#1`, etc.) breaks H-1's
63
+ // stage2_did_key_fragment_resolution.
64
+ kid: `${did}#${multibase}`
65
+ };
66
+ }
67
+ function base64UrlEncode(bytes) {
68
+ return Buffer.from(bytes).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
69
+ }
70
+ async function signMcpiEnvelope(payload, key) {
71
+ const header = { alg: "EdDSA", kid: key.kid };
72
+ const headerJson = JSON.stringify(header);
73
+ const headerB64 = base64UrlEncode(new TextEncoder().encode(headerJson));
74
+ const payloadB64 = base64UrlEncode(canonicalSigningPayload(payload));
75
+ const signingInput = new TextEncoder().encode(`${headerB64}.${payloadB64}`);
76
+ const signature = await ed25519.signAsync(signingInput, key.signingKey);
77
+ const signatureB64 = base64UrlEncode(signature);
78
+ return `${headerB64}.${payloadB64}.${signatureB64}`;
79
+ }
80
+
81
+ // src/canonical-signer/parse.ts
82
+ var JwsParseError = class extends Error {
83
+ constructor(code, message) {
84
+ super(message);
85
+ this.code = code;
86
+ this.name = "JwsParseError";
87
+ }
88
+ };
89
+ function validateJwsHeader(value) {
90
+ if (value === null || typeof value !== "object") {
91
+ throw new Error(`expected JSON object, got ${value === null ? "null" : typeof value}`);
92
+ }
93
+ const obj = value;
94
+ if (typeof obj.alg !== "string" || obj.alg.length === 0) {
95
+ throw new Error(`missing or non-string required field "alg" (got ${typeof obj.alg})`);
96
+ }
97
+ if (typeof obj.kid !== "string" || obj.kid.length === 0) {
98
+ throw new Error(`missing or non-string required field "kid" (got ${typeof obj.kid})`);
99
+ }
100
+ if (obj.typ !== void 0 && typeof obj.typ !== "string") {
101
+ throw new Error(`optional field "typ" must be a string when present (got ${typeof obj.typ})`);
102
+ }
103
+ return obj;
104
+ }
105
+ function parseJwsCompact(jws) {
106
+ const parts = jws.split(".");
107
+ if (parts.length !== 3) {
108
+ throw new JwsParseError(
109
+ "WrongSegmentCount",
110
+ `Expected 3 dot-separated segments per RFC 7515 \xA7 3.1; got ${parts.length}`
111
+ );
112
+ }
113
+ const [headerB64, payloadB64, signatureB64] = parts;
114
+ let headerJson;
115
+ try {
116
+ headerJson = JSON.parse(base64UrlDecodeToString(headerB64));
117
+ } catch (cause) {
118
+ throw new JwsParseError("InvalidJson", `JWS header is not valid JSON: ${String(cause)}`);
119
+ }
120
+ let validatedHeader;
121
+ try {
122
+ validatedHeader = validateJwsHeader(headerJson);
123
+ } catch (cause) {
124
+ throw new JwsParseError(
125
+ "InvalidHeaderShape",
126
+ `JWS header does not match expected shape: ${cause.message}`
127
+ );
128
+ }
129
+ if (validatedHeader.alg !== "EdDSA") {
130
+ throw new JwsParseError(
131
+ "UnsupportedAlgorithm",
132
+ `Unsupported JWS alg "${validatedHeader.alg}"; Phase 1 only supports EdDSA`
133
+ );
134
+ }
135
+ const header = {
136
+ alg: "EdDSA",
137
+ kid: validatedHeader.kid,
138
+ ...validatedHeader.typ !== void 0 ? { typ: validatedHeader.typ } : {}
139
+ };
140
+ let payloadJson;
141
+ try {
142
+ payloadJson = JSON.parse(base64UrlDecodeToString(payloadB64));
143
+ } catch (cause) {
144
+ throw new JwsParseError("InvalidJson", `JWS payload is not valid JSON: ${String(cause)}`);
145
+ }
146
+ let payload;
147
+ try {
148
+ payload = validateMcpIPayload(payloadJson);
149
+ } catch (cause) {
150
+ throw new JwsParseError(
151
+ "InvalidPayloadShape",
152
+ `JWS payload does not match McpIPayload shape: ${cause.message}`
153
+ );
154
+ }
155
+ if (!BASE64URL_ALPHABET.test(signatureB64)) {
156
+ throw new JwsParseError(
157
+ "InvalidBase64",
158
+ `JWS signature segment contains characters outside the base64url alphabet (RFC 4648 \xA7 5)`
159
+ );
160
+ }
161
+ const signatureBytes = base64UrlDecodeToBytes(signatureB64);
162
+ if (signatureBytes.length !== 64) {
163
+ throw new JwsParseError(
164
+ "InvalidSignatureLength",
165
+ `Ed25519 signatures are 64 bytes (RFC 8032 \xA7 5.1.6); got ${signatureBytes.length}`
166
+ );
167
+ }
168
+ const signingInput = new TextEncoder().encode(`${headerB64}.${payloadB64}`);
169
+ return { header, payload, signatureBytes, signingInput };
170
+ }
171
+ var BASE64URL_ALPHABET = /^[A-Za-z0-9_-]+=*$/;
172
+ function base64UrlDecodeToBytes(s) {
173
+ const padded = s.replace(/-/g, "+").replace(/_/g, "/");
174
+ const padLen = padded.length % 4 === 0 ? 0 : 4 - padded.length % 4;
175
+ return new Uint8Array(Buffer.from(padded + "=".repeat(padLen), "base64"));
176
+ }
177
+ function base64UrlDecodeToString(s) {
178
+ return Buffer.from(base64UrlDecodeToBytes(s)).toString("utf-8");
179
+ }
180
+
181
+ exports.JwsParseError = JwsParseError;
182
+ exports.canonicalSigningPayload = canonicalSigningPayload;
183
+ exports.parseJwsCompact = parseJwsCompact;
184
+ exports.parseSigningKey = parseSigningKey;
185
+ exports.signMcpiEnvelope = signMcpiEnvelope;
186
+ exports.validateMcpIPayload = validateMcpIPayload;