@kya-os/checkpoint-shared 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,22 @@
1
1
  # @kya-os/checkpoint-shared
2
2
 
3
+ ## 1.1.0 — 2026-05-18
4
+
5
+ Phase-D.8b engine-surface cleanup.
6
+
7
+ ### Added
8
+
9
+ - `DetectionDetailSchema` / `DetectionDetail`, the canonical rich
10
+ detection payload emitted next to engine `Decision`.
11
+ - Deprecated `DetectionResult` remains as an alias of `DetectionDetail`
12
+ for one minor cycle while downstream packages migrate names.
13
+
14
+ ### Removed
15
+
16
+ - Retired `shouldEnforce` and `evaluateEnforcement`. Host packages now
17
+ read enforcement from `VerifyResult.decision` and keep any compatibility
18
+ policy fallback locally.
19
+
3
20
  ## 1.0.0 — 2026-05-15
4
21
 
5
22
  E-tracks Phase D — package rename. **BREAKING.**
@@ -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;
@@ -0,0 +1,175 @@
1
+ import canonicalize from 'canonicalize';
2
+ import { getPublicKeyAsync, signAsync } from '@noble/ed25519';
3
+ import { base58btc } from 'multiformats/bases/base58';
4
+
5
+ // src/canonical-signer/payload.ts
6
+ function canonicalSigningPayload(payload) {
7
+ const json = canonicalize(payload);
8
+ if (json === void 0) {
9
+ throw new Error("canonicalSigningPayload: payload contains non-serializable values");
10
+ }
11
+ return new TextEncoder().encode(json);
12
+ }
13
+ var REQUIRED_STRING_FIELDS = [
14
+ "aud",
15
+ "iss",
16
+ "sub",
17
+ "nonce",
18
+ "sessionId",
19
+ "requestHash",
20
+ "responseHash"
21
+ ];
22
+ function validateMcpIPayload(value) {
23
+ if (value === null || typeof value !== "object") {
24
+ throw new Error(`expected JSON object, got ${value === null ? "null" : typeof value}`);
25
+ }
26
+ const obj = value;
27
+ for (const field of REQUIRED_STRING_FIELDS) {
28
+ if (typeof obj[field] !== "string") {
29
+ throw new Error(`missing or non-string required field "${field}" (got ${typeof obj[field]})`);
30
+ }
31
+ }
32
+ if (typeof obj.ts !== "number" || !Number.isFinite(obj.ts)) {
33
+ throw new Error(`missing or non-finite-number required field "ts" (got ${typeof obj.ts})`);
34
+ }
35
+ return obj;
36
+ }
37
+ var ED25519_MULTICODEC_PREFIX = new Uint8Array([237, 1]);
38
+ async function parseSigningKey(seed) {
39
+ if (seed.length !== 32) {
40
+ throw new Error(`parseSigningKey: expected 32-byte Ed25519 seed, got ${seed.length} bytes`);
41
+ }
42
+ const publicKey = await getPublicKeyAsync(seed);
43
+ const multibaseBytes = new Uint8Array(ED25519_MULTICODEC_PREFIX.length + publicKey.length);
44
+ multibaseBytes.set(ED25519_MULTICODEC_PREFIX, 0);
45
+ multibaseBytes.set(publicKey, ED25519_MULTICODEC_PREFIX.length);
46
+ const multibase = base58btc.encode(multibaseBytes);
47
+ const did = `did:key:${multibase}`;
48
+ return {
49
+ // Defensive copy — see KeyMaterial.signingKey docstring. The Sign-1
50
+ // tests assert that mutating the input seed after this call does NOT
51
+ // mutate the held key material.
52
+ signingKey: Uint8Array.from(seed),
53
+ publicKey,
54
+ did,
55
+ // mcp-i-core PR #16: the verification-method id is the multibase value
56
+ // as a fragment. Anything else (`#keys-1`, `#1`, etc.) breaks H-1's
57
+ // stage2_did_key_fragment_resolution.
58
+ kid: `${did}#${multibase}`
59
+ };
60
+ }
61
+ function base64UrlEncode(bytes) {
62
+ return Buffer.from(bytes).toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
63
+ }
64
+ async function signMcpiEnvelope(payload, key) {
65
+ const header = { alg: "EdDSA", kid: key.kid };
66
+ const headerJson = JSON.stringify(header);
67
+ const headerB64 = base64UrlEncode(new TextEncoder().encode(headerJson));
68
+ const payloadB64 = base64UrlEncode(canonicalSigningPayload(payload));
69
+ const signingInput = new TextEncoder().encode(`${headerB64}.${payloadB64}`);
70
+ const signature = await signAsync(signingInput, key.signingKey);
71
+ const signatureB64 = base64UrlEncode(signature);
72
+ return `${headerB64}.${payloadB64}.${signatureB64}`;
73
+ }
74
+
75
+ // src/canonical-signer/parse.ts
76
+ var JwsParseError = class extends Error {
77
+ constructor(code, message) {
78
+ super(message);
79
+ this.code = code;
80
+ this.name = "JwsParseError";
81
+ }
82
+ };
83
+ function validateJwsHeader(value) {
84
+ if (value === null || typeof value !== "object") {
85
+ throw new Error(`expected JSON object, got ${value === null ? "null" : typeof value}`);
86
+ }
87
+ const obj = value;
88
+ if (typeof obj.alg !== "string" || obj.alg.length === 0) {
89
+ throw new Error(`missing or non-string required field "alg" (got ${typeof obj.alg})`);
90
+ }
91
+ if (typeof obj.kid !== "string" || obj.kid.length === 0) {
92
+ throw new Error(`missing or non-string required field "kid" (got ${typeof obj.kid})`);
93
+ }
94
+ if (obj.typ !== void 0 && typeof obj.typ !== "string") {
95
+ throw new Error(`optional field "typ" must be a string when present (got ${typeof obj.typ})`);
96
+ }
97
+ return obj;
98
+ }
99
+ function parseJwsCompact(jws) {
100
+ const parts = jws.split(".");
101
+ if (parts.length !== 3) {
102
+ throw new JwsParseError(
103
+ "WrongSegmentCount",
104
+ `Expected 3 dot-separated segments per RFC 7515 \xA7 3.1; got ${parts.length}`
105
+ );
106
+ }
107
+ const [headerB64, payloadB64, signatureB64] = parts;
108
+ let headerJson;
109
+ try {
110
+ headerJson = JSON.parse(base64UrlDecodeToString(headerB64));
111
+ } catch (cause) {
112
+ throw new JwsParseError("InvalidJson", `JWS header is not valid JSON: ${String(cause)}`);
113
+ }
114
+ let validatedHeader;
115
+ try {
116
+ validatedHeader = validateJwsHeader(headerJson);
117
+ } catch (cause) {
118
+ throw new JwsParseError(
119
+ "InvalidHeaderShape",
120
+ `JWS header does not match expected shape: ${cause.message}`
121
+ );
122
+ }
123
+ if (validatedHeader.alg !== "EdDSA") {
124
+ throw new JwsParseError(
125
+ "UnsupportedAlgorithm",
126
+ `Unsupported JWS alg "${validatedHeader.alg}"; Phase 1 only supports EdDSA`
127
+ );
128
+ }
129
+ const header = {
130
+ alg: "EdDSA",
131
+ kid: validatedHeader.kid,
132
+ ...validatedHeader.typ !== void 0 ? { typ: validatedHeader.typ } : {}
133
+ };
134
+ let payloadJson;
135
+ try {
136
+ payloadJson = JSON.parse(base64UrlDecodeToString(payloadB64));
137
+ } catch (cause) {
138
+ throw new JwsParseError("InvalidJson", `JWS payload is not valid JSON: ${String(cause)}`);
139
+ }
140
+ let payload;
141
+ try {
142
+ payload = validateMcpIPayload(payloadJson);
143
+ } catch (cause) {
144
+ throw new JwsParseError(
145
+ "InvalidPayloadShape",
146
+ `JWS payload does not match McpIPayload shape: ${cause.message}`
147
+ );
148
+ }
149
+ if (!BASE64URL_ALPHABET.test(signatureB64)) {
150
+ throw new JwsParseError(
151
+ "InvalidBase64",
152
+ `JWS signature segment contains characters outside the base64url alphabet (RFC 4648 \xA7 5)`
153
+ );
154
+ }
155
+ const signatureBytes = base64UrlDecodeToBytes(signatureB64);
156
+ if (signatureBytes.length !== 64) {
157
+ throw new JwsParseError(
158
+ "InvalidSignatureLength",
159
+ `Ed25519 signatures are 64 bytes (RFC 8032 \xA7 5.1.6); got ${signatureBytes.length}`
160
+ );
161
+ }
162
+ const signingInput = new TextEncoder().encode(`${headerB64}.${payloadB64}`);
163
+ return { header, payload, signatureBytes, signingInput };
164
+ }
165
+ var BASE64URL_ALPHABET = /^[A-Za-z0-9_-]+=*$/;
166
+ function base64UrlDecodeToBytes(s) {
167
+ const padded = s.replace(/-/g, "+").replace(/_/g, "/");
168
+ const padLen = padded.length % 4 === 0 ? 0 : 4 - padded.length % 4;
169
+ return new Uint8Array(Buffer.from(padded + "=".repeat(padLen), "base64"));
170
+ }
171
+ function base64UrlDecodeToString(s) {
172
+ return Buffer.from(base64UrlDecodeToBytes(s)).toString("utf-8");
173
+ }
174
+
175
+ export { JwsParseError, canonicalSigningPayload, parseJwsCompact, parseSigningKey, signMcpiEnvelope, validateMcpIPayload };