@private.me/xbind 3.0.2 → 3.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (221) hide show
  1. package/README.md +2366 -204
  2. package/README.md.backup +2121 -0
  3. package/dist-standalone/_deps/mldsa-wasm/dist/mldsa.js +1 -1920
  4. package/dist-standalone/_deps/shared/cjs/errors.js +1 -729
  5. package/dist-standalone/_deps/shared/cjs/index.js +1 -463
  6. package/dist-standalone/_deps/shared/cjs/types.js +1 -315
  7. package/dist-standalone/_deps/shared/errors.js +1 -244
  8. package/dist-standalone/_deps/shared/index.js +1 -72
  9. package/dist-standalone/_deps/shared/types.js +1 -86
  10. package/dist-standalone/_deps/ux-helpers/cjs/errors.js +1 -1
  11. package/dist-standalone/_deps/ux-helpers/cjs/index.js +1 -1
  12. package/dist-standalone/_deps/ux-helpers/cjs/pagination.js +1 -1
  13. package/dist-standalone/_deps/ux-helpers/cjs/progress.js +1 -1
  14. package/dist-standalone/_deps/ux-helpers/cjs/search.js +1 -1
  15. package/dist-standalone/_deps/ux-helpers/cjs/types.js +1 -1
  16. package/dist-standalone/_deps/ux-helpers/errors.js +1 -1
  17. package/dist-standalone/_deps/ux-helpers/index.js +1 -1
  18. package/dist-standalone/_deps/ux-helpers/pagination.js +1 -1
  19. package/dist-standalone/_deps/ux-helpers/progress.js +1 -1
  20. package/dist-standalone/_deps/ux-helpers/search.js +1 -1
  21. package/dist-standalone/_deps/xchange/auto-accept.js +1 -1
  22. package/dist-standalone/_deps/xchange/cjs/auto-accept.js +1 -1
  23. package/dist-standalone/_deps/xchange/cjs/errors.js +1 -1
  24. package/dist-standalone/_deps/xchange/cjs/index.js +1 -1
  25. package/dist-standalone/_deps/xchange/cjs/invite-client.js +1 -1
  26. package/dist-standalone/_deps/xchange/cjs/lazy-init.js +1 -1
  27. package/dist-standalone/_deps/xchange/cjs/trust-integration.js +1 -1
  28. package/dist-standalone/_deps/xchange/cjs/xchange.js +1 -1
  29. package/dist-standalone/_deps/xchange/errors.js +1 -1
  30. package/dist-standalone/_deps/xchange/index.js +1 -1
  31. package/dist-standalone/_deps/xchange/invite-client.js +1 -1
  32. package/dist-standalone/_deps/xchange/lazy-init.js +1 -1
  33. package/dist-standalone/_deps/xchange/trust-integration.js +1 -1
  34. package/dist-standalone/_deps/xchange/xchange.js +1 -1
  35. package/dist-standalone/_deps/xregistry/cjs/discovery.js +1 -1
  36. package/dist-standalone/_deps/xregistry/cjs/errors.js +1 -1
  37. package/dist-standalone/_deps/xregistry/cjs/index.js +1 -1
  38. package/dist-standalone/_deps/xregistry/cjs/registry.js +1 -1
  39. package/dist-standalone/_deps/xregistry/cjs/schema.js +1 -1
  40. package/dist-standalone/_deps/xregistry/cjs/types.js +1 -1
  41. package/dist-standalone/_deps/xregistry/discovery.js +1 -1
  42. package/dist-standalone/_deps/xregistry/errors.js +1 -1
  43. package/dist-standalone/_deps/xregistry/index.js +1 -1
  44. package/dist-standalone/_deps/xregistry/registry.js +1 -1
  45. package/dist-standalone/_deps/xregistry/schema.js +1 -1
  46. package/dist-standalone/_deps/xregistry/types.js +1 -1
  47. package/dist-standalone/agent-call.d.ts +2 -2
  48. package/dist-standalone/agent-call.js +1 -659
  49. package/dist-standalone/agent-sdk.js +1 -328
  50. package/dist-standalone/agent.d.ts +2 -0
  51. package/dist-standalone/agent.js +1 -1800
  52. package/dist-standalone/approval.js +1 -193
  53. package/dist-standalone/async-iterators.d.ts +3 -3
  54. package/dist-standalone/async-iterators.js +1 -382
  55. package/dist-standalone/auth.js +1 -219
  56. package/dist-standalone/auto-accept.js +1 -229
  57. package/dist-standalone/backup-config.js +1 -201
  58. package/dist-standalone/backup.js +1 -326
  59. package/dist-standalone/batch-operations.js +1 -388
  60. package/dist-standalone/cancellation.js +1 -477
  61. package/dist-standalone/checkpoint.js +1 -186
  62. package/dist-standalone/circuit-breaker.js +1 -468
  63. package/dist-standalone/cjs/agent-call.js +1 -701
  64. package/dist-standalone/cjs/agent-sdk.js +1 -332
  65. package/dist-standalone/cjs/agent.js +1 -1837
  66. package/dist-standalone/cjs/approval.js +1 -199
  67. package/dist-standalone/cjs/async-iterators.js +1 -392
  68. package/dist-standalone/cjs/auth.js +1 -225
  69. package/dist-standalone/cjs/auto-accept.js +1 -233
  70. package/dist-standalone/cjs/backup-config.js +1 -207
  71. package/dist-standalone/cjs/backup.js +1 -330
  72. package/dist-standalone/cjs/batch-operations.js +1 -397
  73. package/dist-standalone/cjs/cancellation.js +1 -490
  74. package/dist-standalone/cjs/checkpoint.js +1 -193
  75. package/dist-standalone/cjs/circuit-breaker.js +1 -476
  76. package/dist-standalone/cjs/cli/init.js +1 -492
  77. package/dist-standalone/cjs/config-validation.js +1 -522
  78. package/dist-standalone/cjs/connect.js +1 -312
  79. package/dist-standalone/cjs/connection-pool.js +1 -506
  80. package/dist-standalone/cjs/correlation-id.js +1 -339
  81. package/dist-standalone/cjs/crypto-utils.js +1 -176
  82. package/dist-standalone/cjs/debug-mode.js +1 -534
  83. package/dist-standalone/cjs/did-document.js +1 -101
  84. package/dist-standalone/cjs/did-privateme.js +1 -130
  85. package/dist-standalone/cjs/did-web.js +1 -201
  86. package/dist-standalone/cjs/discovery.js +1 -462
  87. package/dist-standalone/cjs/dual-mode.js +1 -251
  88. package/dist-standalone/cjs/email-templates.js +1 -313
  89. package/dist-standalone/cjs/email-transport.js +1 -239
  90. package/dist-standalone/cjs/envelope.js +1 -538
  91. package/dist-standalone/cjs/errors.js +1 -913
  92. package/dist-standalone/cjs/event-emitter.js +1 -461
  93. package/dist-standalone/cjs/gateway-state.js +1 -55
  94. package/dist-standalone/cjs/gateway-transport.js +1 -120
  95. package/dist-standalone/cjs/graceful-degradation.js +1 -403
  96. package/dist-standalone/cjs/guardrails.js +1 -223
  97. package/dist-standalone/cjs/health-check.js +1 -336
  98. package/dist-standalone/cjs/http-compat.js +1 -272
  99. package/dist-standalone/cjs/http-status-map.js +1 -571
  100. package/dist-standalone/cjs/identity.js +1 -645
  101. package/dist-standalone/cjs/index.js +1 -406
  102. package/dist-standalone/cjs/invitation.js +1 -421
  103. package/dist-standalone/cjs/invite.js +1 -328
  104. package/dist-standalone/cjs/key-agreement.js +1 -335
  105. package/dist-standalone/cjs/lazy-init.js +1 -300
  106. package/dist-standalone/cjs/logger.js +1 -291
  107. package/dist-standalone/cjs/loopback-transport.js +1 -0
  108. package/dist-standalone/cjs/mdns-discovery.js +1 -202
  109. package/dist-standalone/cjs/nonce-store.js +1 -80
  110. package/dist-standalone/cjs/pairing-manager.js +1 -223
  111. package/dist-standalone/cjs/plugin-system.js +1 -264
  112. package/dist-standalone/cjs/plugins/logging.js +1 -168
  113. package/dist-standalone/cjs/plugins/metrics.js +1 -181
  114. package/dist-standalone/cjs/plugins/validation.js +1 -302
  115. package/dist-standalone/cjs/policy.js +1 -320
  116. package/dist-standalone/cjs/progress-callbacks.js +1 -583
  117. package/dist-standalone/cjs/redis-nonce-store.js +1 -76
  118. package/dist-standalone/cjs/registry-middleware.js +1 -50
  119. package/dist-standalone/cjs/retry-strategies.js +1 -544
  120. package/dist-standalone/cjs/retry-transport.js +1 -102
  121. package/dist-standalone/cjs/runtime/browser.js +1 -533
  122. package/dist-standalone/cjs/runtime/edge.js +1 -526
  123. package/dist-standalone/cjs/runtime/react-native.js +1 -394
  124. package/dist-standalone/cjs/security-policy.js +1 -245
  125. package/dist-standalone/cjs/serialization.js +1 -1040
  126. package/dist-standalone/cjs/split-channel.js +1 -225
  127. package/dist-standalone/cjs/subscription-proof.js +1 -230
  128. package/dist-standalone/cjs/succession.js +1 -148
  129. package/dist-standalone/cjs/timeouts.js +1 -412
  130. package/dist-standalone/cjs/trace-context.js +1 -424
  131. package/dist-standalone/cjs/trace-spans.js +1 -495
  132. package/dist-standalone/cjs/transport.js +1 -63
  133. package/dist-standalone/cjs/trust-registry.js +1 -991
  134. package/dist-standalone/cjs/types/error-response.js +1 -56
  135. package/dist-standalone/cjs/vault-auth.js +1 -178
  136. package/dist-standalone/cjs/vault-store-loader.js +1 -194
  137. package/dist-standalone/cjs/verify.js +1 -25
  138. package/dist-standalone/cjs/version-info.js +1 -543
  139. package/dist-standalone/cjs/xfetch.js +1 -340
  140. package/dist-standalone/cli/init.js +1 -455
  141. package/dist-standalone/cli/setup.js +1 -514
  142. package/dist-standalone/cli/types.js +1 -27
  143. package/dist-standalone/cli/xbind.js +1 -148
  144. package/dist-standalone/config-validation.js +1 -513
  145. package/dist-standalone/connect.js +1 -274
  146. package/dist-standalone/connection-pool.js +1 -500
  147. package/dist-standalone/correlation-id.js +1 -326
  148. package/dist-standalone/crypto-utils.d.ts +2 -7
  149. package/dist-standalone/crypto-utils.js +1 -157
  150. package/dist-standalone/debug-mode.js +1 -510
  151. package/dist-standalone/did-document.js +1 -96
  152. package/dist-standalone/did-privateme.js +1 -121
  153. package/dist-standalone/did-web.js +1 -196
  154. package/dist-standalone/discovery.js +1 -458
  155. package/dist-standalone/dual-mode.js +1 -247
  156. package/dist-standalone/email-templates.js +1 -309
  157. package/dist-standalone/email-transport.d.ts +2 -2
  158. package/dist-standalone/email-transport.js +1 -232
  159. package/dist-standalone/envelope.js +1 -525
  160. package/dist-standalone/errors.d.ts +13 -3
  161. package/dist-standalone/errors.js +1 -896
  162. package/dist-standalone/event-emitter.js +1 -456
  163. package/dist-standalone/gateway-state.d.ts +1 -1
  164. package/dist-standalone/gateway-state.js +1 -51
  165. package/dist-standalone/gateway-transport.js +1 -116
  166. package/dist-standalone/graceful-degradation.js +1 -396
  167. package/dist-standalone/guardrails.js +1 -216
  168. package/dist-standalone/health-check.d.ts +5 -1
  169. package/dist-standalone/health-check.js +1 -332
  170. package/dist-standalone/http-compat.d.ts +1 -1
  171. package/dist-standalone/http-compat.js +1 -267
  172. package/dist-standalone/http-status-map.js +1 -561
  173. package/dist-standalone/identity.js +1 -619
  174. package/dist-standalone/index.d.ts +15 -4
  175. package/dist-standalone/index.js +1 -78
  176. package/dist-standalone/invitation.js +1 -415
  177. package/dist-standalone/invite.js +1 -324
  178. package/dist-standalone/key-agreement.js +1 -325
  179. package/dist-standalone/lazy-init.d.ts +11 -6
  180. package/dist-standalone/lazy-init.js +1 -295
  181. package/dist-standalone/logger.js +1 -285
  182. package/dist-standalone/loopback-transport.d.ts +87 -0
  183. package/dist-standalone/loopback-transport.js +1 -0
  184. package/dist-standalone/mdns-discovery.js +1 -195
  185. package/dist-standalone/nonce-store.js +1 -76
  186. package/dist-standalone/pairing-manager.js +1 -219
  187. package/dist-standalone/plugin-system.js +1 -257
  188. package/dist-standalone/plugins/logging.js +1 -163
  189. package/dist-standalone/plugins/metrics.d.ts +4 -4
  190. package/dist-standalone/plugins/metrics.js +1 -176
  191. package/dist-standalone/plugins/validation.js +1 -297
  192. package/dist-standalone/policy.js +1 -315
  193. package/dist-standalone/progress-callbacks.js +1 -576
  194. package/dist-standalone/redis-nonce-store.js +1 -72
  195. package/dist-standalone/registry-middleware.js +1 -47
  196. package/dist-standalone/retry-strategies.js +1 -534
  197. package/dist-standalone/retry-transport.js +1 -98
  198. package/dist-standalone/runtime/browser.js +1 -516
  199. package/dist-standalone/runtime/edge.js +1 -511
  200. package/dist-standalone/runtime/react-native.d.ts +1 -1
  201. package/dist-standalone/runtime/react-native.js +1 -383
  202. package/dist-standalone/security-policy.js +1 -239
  203. package/dist-standalone/serialization.js +1 -1031
  204. package/dist-standalone/split-channel.js +1 -219
  205. package/dist-standalone/subscription-proof.js +1 -224
  206. package/dist-standalone/succession.js +1 -142
  207. package/dist-standalone/timeouts.js +1 -398
  208. package/dist-standalone/trace-context.js +1 -414
  209. package/dist-standalone/trace-spans.js +1 -488
  210. package/dist-standalone/transport.js +1 -59
  211. package/dist-standalone/trust-registry.d.ts +3 -3
  212. package/dist-standalone/trust-registry.js +1 -950
  213. package/dist-standalone/types/error-response.js +1 -52
  214. package/dist-standalone/vault-auth.js +1 -174
  215. package/dist-standalone/vault-store-loader.d.ts +9 -0
  216. package/dist-standalone/vault-store-loader.js +1 -187
  217. package/dist-standalone/verify.js +1 -16
  218. package/dist-standalone/version-info.js +1 -530
  219. package/dist-standalone/xfetch.js +1 -335
  220. package/package.json +1 -1
  221. package/share1.dat +0 -0
@@ -1,526 +1 @@
1
- "use strict";
2
- /**
3
- * Edge Runtime Support for xBind
4
- *
5
- * Enables xBind to run on edge compute platforms:
6
- * - Cloudflare Workers
7
- * - Vercel Edge Functions
8
- * - Deno Deploy
9
- *
10
- * Key Features:
11
- * - Edge-compatible crypto operations (Web Crypto API only)
12
- * - KV storage integration for nonce stores and trust registry
13
- * - Size-optimized build (<1MB constraint)
14
- * - No Node.js dependencies (no fs, crypto, process)
15
- */
16
- Object.defineProperty(exports, "__esModule", { value: true });
17
- exports.EdgeTransportAdapter = exports.KVTrustRegistry = exports.KVNonceStore = exports.DenoKVAdapter = exports.VercelKVAdapter = exports.CloudflareKVAdapter = void 0;
18
- exports.detectRuntime = detectRuntime;
19
- exports.isEdgeRuntime = isEdgeRuntime;
20
- exports.validateEdgeRuntime = validateEdgeRuntime;
21
- exports.createEdgeAgent = createEdgeAgent;
22
- exports.checkBundleSize = checkBundleSize;
23
- exports.getOptimizationTips = getOptimizationTips;
24
- const shared_1 = require("../../_deps/shared/index.js");
25
- /**
26
- * Detect the current edge runtime environment.
27
- *
28
- * Detection order:
29
- * 1. Cloudflare Workers: globalThis.caches + EdgeRuntime
30
- * 2. Vercel Edge: process.env.VERCEL + EdgeRuntime
31
- * 3. Deno Deploy: globalThis.Deno
32
- * 4. Node.js: process.versions.node
33
- * 5. Unknown: fallback
34
- */
35
- function detectRuntime() {
36
- // SAFETY: Edge runtime detection requires checking for vendor-specific globals
37
- const global = globalThis;
38
- // Cloudflare Workers: Has global caches API and no process
39
- if (typeof global.caches !== 'undefined' &&
40
- typeof global.EdgeRuntime === 'string') {
41
- return 'cloudflare';
42
- }
43
- // Vercel Edge: Has EdgeRuntime and process.env.VERCEL
44
- if (typeof global.EdgeRuntime === 'string' &&
45
- typeof process !== 'undefined' &&
46
- process.env?.VERCEL === '1') {
47
- return 'vercel';
48
- }
49
- // Deno Deploy: Has global Deno object
50
- if (typeof global.Deno !== 'undefined') {
51
- return 'deno';
52
- }
53
- // Node.js: Has process.versions.node
54
- if (typeof process !== 'undefined' &&
55
- typeof process.versions?.node === 'string') {
56
- return 'node';
57
- }
58
- return 'unknown';
59
- }
60
- /**
61
- * Check if the current runtime is an edge environment.
62
- */
63
- function isEdgeRuntime() {
64
- const runtime = detectRuntime();
65
- return runtime === 'cloudflare' || runtime === 'vercel' || runtime === 'deno';
66
- }
67
- /**
68
- * Validate that the runtime supports required Web Crypto APIs.
69
- *
70
- * Edge runtimes MUST provide:
71
- * - crypto.subtle (Ed25519, X25519, AES-GCM, HMAC)
72
- * - crypto.getRandomValues()
73
- * - TextEncoder/TextDecoder
74
- */
75
- function validateEdgeRuntime() {
76
- // Check Web Crypto API
77
- if (typeof globalThis.crypto === 'undefined') {
78
- return (0, shared_1.err)('Missing globalThis.crypto');
79
- }
80
- if (typeof globalThis.crypto.subtle === 'undefined') {
81
- return (0, shared_1.err)('Missing crypto.subtle');
82
- }
83
- if (typeof globalThis.crypto.getRandomValues !== 'function') {
84
- return (0, shared_1.err)('Missing crypto.getRandomValues');
85
- }
86
- // Check required subtle crypto methods
87
- const requiredMethods = [
88
- 'generateKey',
89
- 'sign',
90
- 'verify',
91
- 'encrypt',
92
- 'decrypt',
93
- 'deriveBits',
94
- 'importKey',
95
- 'exportKey',
96
- ];
97
- for (const method of requiredMethods) {
98
- if (typeof globalThis.crypto.subtle[method] !== 'function') {
99
- return (0, shared_1.err)(`Missing crypto.subtle.${method}`);
100
- }
101
- }
102
- // Check TextEncoder/TextDecoder
103
- if (typeof globalThis.TextEncoder === 'undefined') {
104
- return (0, shared_1.err)('Missing TextEncoder');
105
- }
106
- if (typeof globalThis.TextDecoder === 'undefined') {
107
- return (0, shared_1.err)('Missing TextDecoder');
108
- }
109
- // Check fetch API
110
- if (typeof globalThis.fetch !== 'function') {
111
- return (0, shared_1.err)('Missing fetch API');
112
- }
113
- return (0, shared_1.ok)(undefined);
114
- }
115
- /**
116
- * Adapter for Cloudflare Workers KV.
117
- */
118
- class CloudflareKVAdapter {
119
- namespace;
120
- constructor(namespace) {
121
- this.namespace = namespace;
122
- }
123
- async get(key) {
124
- return await this.namespace.get(key);
125
- }
126
- async put(key, value, ttlSeconds) {
127
- const options = ttlSeconds ? { expirationTtl: ttlSeconds } : undefined;
128
- await this.namespace.put(key, value, options);
129
- }
130
- async delete(key) {
131
- await this.namespace.delete(key);
132
- }
133
- async list(prefix, limit) {
134
- const result = await this.namespace.list({ prefix, limit });
135
- return result.keys.map((k) => k.name);
136
- }
137
- }
138
- exports.CloudflareKVAdapter = CloudflareKVAdapter;
139
- /**
140
- * Adapter for Vercel KV (Redis).
141
- */
142
- class VercelKVAdapter {
143
- client;
144
- constructor(client) {
145
- this.client = client;
146
- }
147
- async get(key) {
148
- return await this.client.get(key);
149
- }
150
- async put(key, value, ttlSeconds) {
151
- const options = ttlSeconds ? { ex: ttlSeconds } : undefined;
152
- await this.client.set(key, value, options);
153
- }
154
- async delete(key) {
155
- await this.client.del(key);
156
- }
157
- async list(prefix, limit) {
158
- const pattern = prefix ? `${prefix}*` : '*';
159
- const allKeys = await this.client.keys(pattern);
160
- return limit ? allKeys.slice(0, limit) : allKeys;
161
- }
162
- }
163
- exports.VercelKVAdapter = VercelKVAdapter;
164
- /**
165
- * Adapter for Deno KV.
166
- */
167
- class DenoKVAdapter {
168
- kv;
169
- constructor(kv) {
170
- this.kv = kv;
171
- }
172
- async get(key) {
173
- const result = await this.kv.get([key]);
174
- return result.value;
175
- }
176
- async put(key, value, ttlSeconds) {
177
- const options = ttlSeconds ? { expireIn: ttlSeconds * 1000 } : undefined;
178
- await this.kv.set([key], value, options);
179
- }
180
- async delete(key) {
181
- await this.kv.delete([key]);
182
- }
183
- async list(prefix, limit) {
184
- const selector = { prefix: prefix ? [prefix] : [] };
185
- const keys = [];
186
- for await (const entry of this.kv.list(selector)) {
187
- keys.push(entry.key.join('/'));
188
- if (limit && keys.length >= limit)
189
- break;
190
- }
191
- return keys;
192
- }
193
- }
194
- exports.DenoKVAdapter = DenoKVAdapter;
195
- /* ── KV-Backed Nonce Store ── */
196
- /**
197
- * Nonce store implementation using KV storage.
198
- *
199
- * Suitable for edge runtimes where in-memory storage
200
- * is ephemeral across invocations.
201
- */
202
- class KVNonceStore {
203
- kv;
204
- ttlSeconds;
205
- constructor(kv, ttlMs = 10 * 60 * 1000) {
206
- this.kv = kv;
207
- this.ttlSeconds = Math.floor(ttlMs / 1000);
208
- }
209
- /**
210
- * Build composite key: xbind:nonce:{senderDid}:{nonce}:{shareGroupId}:{shareIndex}
211
- */
212
- buildKey(nonce, senderDid, shareContext) {
213
- const base = `xbind:nonce:${senderDid}:${nonce}`;
214
- if (!shareContext)
215
- return base;
216
- const groupId = shareContext.shareGroupId ?? '';
217
- const index = shareContext.shareIndex !== undefined ? String(shareContext.shareIndex) : '';
218
- return `${base}:${groupId}:${index}`;
219
- }
220
- async check(nonce, senderDid, shareContext) {
221
- const key = this.buildKey(nonce, senderDid, shareContext);
222
- const existing = await this.kv.get(key);
223
- if (existing !== null) {
224
- // Nonce already seen
225
- return false;
226
- }
227
- // Record nonce with TTL
228
- await this.kv.put(key, Date.now().toString(), this.ttlSeconds);
229
- return true;
230
- }
231
- cleanup() {
232
- // KV stores auto-expire via TTL, no manual cleanup needed
233
- }
234
- dispose() {
235
- // No resources to clean up
236
- }
237
- }
238
- exports.KVNonceStore = KVNonceStore;
239
- /* ── KV-Backed Trust Registry ── */
240
- /**
241
- * Trust registry implementation using KV storage.
242
- *
243
- * Stores DID registrations in edge KV for distributed lookups.
244
- * Simplified version suitable for edge runtimes - stores minimal metadata.
245
- */
246
- class KVTrustRegistry {
247
- kv;
248
- constructor(kv) {
249
- this.kv = kv;
250
- }
251
- /**
252
- * Build key: xbind:trust:{did}
253
- */
254
- buildKey(did) {
255
- return `xbind:trust:${did}`;
256
- }
257
- async register(did, publicKey, name, scopes, x25519PublicKey, mlKemPublicKey, mlDsaPublicKey, xchange, receiveScopes, sdkVersion, minEnvelopeVersion, maxEnvelopeVersion, ttlMs) {
258
- const key = this.buildKey(did);
259
- // Convert Uint8Arrays to base64 for JSON storage
260
- const toBase64 = (arr) => btoa(String.fromCharCode(...Array.from(arr)));
261
- const entry = {
262
- did,
263
- publicKey: toBase64(publicKey),
264
- name,
265
- scopes: scopes ?? [],
266
- x25519PublicKey: x25519PublicKey ? toBase64(x25519PublicKey) : undefined,
267
- mlKemPublicKey: mlKemPublicKey ? toBase64(mlKemPublicKey) : undefined,
268
- mlDsaPublicKey: mlDsaPublicKey ? toBase64(mlDsaPublicKey) : undefined,
269
- xchange: xchange ?? false,
270
- receiveScopes: receiveScopes ?? [],
271
- sdkVersion,
272
- minEnvelopeVersion,
273
- maxEnvelopeVersion,
274
- registeredAt: Date.now(),
275
- rotation_sequence: 0,
276
- };
277
- try {
278
- const ttlSeconds = ttlMs ? Math.floor(ttlMs / 1000) : undefined;
279
- await this.kv.put(key, JSON.stringify(entry), ttlSeconds);
280
- return (0, shared_1.ok)(undefined);
281
- }
282
- catch (e) {
283
- return (0, shared_1.err)('NETWORK_ERROR');
284
- }
285
- }
286
- async resolve(did) {
287
- const key = this.buildKey(did);
288
- try {
289
- const value = await this.kv.get(key);
290
- if (value === null) {
291
- return (0, shared_1.err)('NOT_FOUND');
292
- }
293
- const entry = JSON.parse(value);
294
- // Convert base64 back to Uint8Array
295
- const fromBase64 = (b64) => Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
296
- return (0, shared_1.ok)(fromBase64(entry.publicKey));
297
- }
298
- catch (e) {
299
- return (0, shared_1.err)('NETWORK_ERROR');
300
- }
301
- }
302
- async hasScope(did, scope) {
303
- const key = this.buildKey(did);
304
- try {
305
- const value = await this.kv.get(key);
306
- if (value === null)
307
- return false;
308
- const entry = JSON.parse(value);
309
- return entry.scopes?.includes(scope) ?? false;
310
- }
311
- catch {
312
- return false;
313
- }
314
- }
315
- async hasReceiveScope(did, scope) {
316
- const key = this.buildKey(did);
317
- try {
318
- const value = await this.kv.get(key);
319
- if (value === null)
320
- return false;
321
- const entry = JSON.parse(value);
322
- return entry.receiveScopes?.includes(scope) ?? false;
323
- }
324
- catch {
325
- return false;
326
- }
327
- }
328
- async revoke(did) {
329
- const key = this.buildKey(did);
330
- try {
331
- await this.kv.delete(key);
332
- return (0, shared_1.ok)(undefined);
333
- }
334
- catch (e) {
335
- return (0, shared_1.err)('NETWORK_ERROR');
336
- }
337
- }
338
- async list() {
339
- try {
340
- const keys = await this.kv.list('xbind:trust:', 1000);
341
- return keys.map((k) => k.replace('xbind:trust:', ''));
342
- }
343
- catch {
344
- return [];
345
- }
346
- }
347
- async getEntry(did) {
348
- const key = this.buildKey(did);
349
- try {
350
- const value = await this.kv.get(key);
351
- if (value === null) {
352
- return (0, shared_1.err)('NOT_FOUND');
353
- }
354
- const stored = JSON.parse(value);
355
- // Convert base64 back to Uint8Array
356
- const fromBase64 = (b64) => Uint8Array.from(atob(b64), (c) => c.charCodeAt(0));
357
- const entry = {
358
- did: stored.did,
359
- publicKey: fromBase64(stored.publicKey),
360
- name: stored.name,
361
- scopes: new Set(stored.scopes),
362
- receiveScopes: stored.receiveScopes ? new Set(stored.receiveScopes) : undefined,
363
- revoked: false,
364
- x25519PublicKey: stored.x25519PublicKey ? fromBase64(stored.x25519PublicKey) : undefined,
365
- mlKemPublicKey: stored.mlKemPublicKey ? fromBase64(stored.mlKemPublicKey) : undefined,
366
- mlDsaPublicKey: stored.mlDsaPublicKey ? fromBase64(stored.mlDsaPublicKey) : undefined,
367
- xchange: stored.xchange,
368
- rotation_sequence: stored.rotation_sequence,
369
- sdkVersion: stored.sdkVersion,
370
- minEnvelopeVersion: stored.minEnvelopeVersion,
371
- maxEnvelopeVersion: stored.maxEnvelopeVersion,
372
- };
373
- return (0, shared_1.ok)(entry);
374
- }
375
- catch (e) {
376
- return (0, shared_1.err)('NETWORK_ERROR');
377
- }
378
- }
379
- /** Additional methods for edge compatibility */
380
- async getFullEntry(did) {
381
- const key = this.buildKey(did);
382
- try {
383
- const value = await this.kv.get(key);
384
- if (value === null) {
385
- return (0, shared_1.err)('NOT_FOUND');
386
- }
387
- const entry = JSON.parse(value);
388
- return (0, shared_1.ok)(entry);
389
- }
390
- catch (e) {
391
- return (0, shared_1.err)('NETWORK_ERROR');
392
- }
393
- }
394
- dispose() {
395
- // No resources to clean up
396
- }
397
- }
398
- exports.KVTrustRegistry = KVTrustRegistry;
399
- /* ── Edge-Compatible Transport ── */
400
- /**
401
- * Edge-compatible HTTPS transport adapter.
402
- *
403
- * Uses standard fetch API (available in all edge runtimes).
404
- * Optimized for edge constraints:
405
- * - No Node.js http/https modules
406
- * - No setTimeout (uses AbortSignal.timeout)
407
- * - Minimal allocations
408
- */
409
- class EdgeTransportAdapter {
410
- baseUrl;
411
- timeoutMs;
412
- handlers = [];
413
- constructor(opts) {
414
- this.baseUrl = opts.baseUrl.replace(/\/$/, '');
415
- this.timeoutMs = opts.timeoutMs ?? 10_000;
416
- }
417
- async send(envelope, recipientDid) {
418
- const url = `${this.baseUrl}/deliver/${encodeURIComponent(recipientDid)}`;
419
- try {
420
- // Use AbortSignal.timeout (supported in modern edge runtimes)
421
- const controller = new AbortController();
422
- const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
423
- const response = await globalThis.fetch(url, {
424
- method: 'POST',
425
- headers: { 'Content-Type': 'application/json' },
426
- body: JSON.stringify(envelope),
427
- signal: controller.signal,
428
- });
429
- clearTimeout(timeoutId);
430
- if (!response.ok) {
431
- return (0, shared_1.err)(response.status === 404 ? 'RECIPIENT_UNREACHABLE' : 'SEND_FAILED');
432
- }
433
- return (0, shared_1.ok)(undefined);
434
- }
435
- catch (e) {
436
- if (e instanceof DOMException && e.name === 'AbortError') {
437
- return (0, shared_1.err)('TIMEOUT');
438
- }
439
- return (0, shared_1.err)('NETWORK_ERROR');
440
- }
441
- }
442
- onReceive(handler) {
443
- this.handlers.push(handler);
444
- }
445
- /**
446
- * Dispatch received envelope to all handlers.
447
- * Called by edge function handler when processing incoming requests.
448
- */
449
- dispatch(envelope) {
450
- for (const handler of this.handlers) {
451
- handler(envelope);
452
- }
453
- }
454
- dispose() {
455
- this.handlers = [];
456
- }
457
- }
458
- exports.EdgeTransportAdapter = EdgeTransportAdapter;
459
- /**
460
- * Create edge-compatible xBind components.
461
- *
462
- * Returns nonce store, trust registry, and transport adapter
463
- * configured for the edge runtime.
464
- *
465
- * @example
466
- * ```typescript
467
- * // Cloudflare Workers
468
- * const kv = new CloudflareKVAdapter(env.XBIND_KV);
469
- * const { nonceStore, trustRegistry, transport } = createEdgeAgent({
470
- * kv,
471
- * baseUrl: 'https://private.me/relay',
472
- * });
473
- *
474
- * const agent = new Agent({
475
- * identity: 'persistent',
476
- * nonceStore,
477
- * trustRegistry,
478
- * transport,
479
- * });
480
- * ```
481
- */
482
- function createEdgeAgent(opts) {
483
- const nonceStore = new KVNonceStore(opts.kv, opts.nonceTtlMs);
484
- const trustRegistry = new KVTrustRegistry(opts.kv);
485
- const transport = new EdgeTransportAdapter({
486
- baseUrl: opts.baseUrl,
487
- timeoutMs: opts.timeoutMs,
488
- });
489
- return {
490
- nonceStore,
491
- trustRegistry,
492
- transport,
493
- };
494
- }
495
- /* ── Size Optimization Helpers ── */
496
- /**
497
- * Check if the bundled size is within edge runtime limits.
498
- *
499
- * Cloudflare Workers: 1MB compressed limit
500
- * Vercel Edge: 1MB limit
501
- * Deno Deploy: 1MB limit
502
- */
503
- function checkBundleSize(bundleSizeBytes) {
504
- const MAX_SIZE_BYTES = 1024 * 1024; // 1MB
505
- if (bundleSizeBytes > MAX_SIZE_BYTES) {
506
- const sizeMB = (bundleSizeBytes / 1024 / 1024).toFixed(2);
507
- const limitMB = (MAX_SIZE_BYTES / 1024 / 1024).toFixed(2);
508
- return (0, shared_1.err)(`Bundle size ${sizeMB}MB exceeds edge runtime limit of ${limitMB}MB. ` +
509
- `Consider using tree-shaking or dynamic imports.`);
510
- }
511
- return (0, shared_1.ok)(undefined);
512
- }
513
- /**
514
- * Get edge-optimized build recommendations.
515
- */
516
- function getOptimizationTips() {
517
- return [
518
- '1. Use tree-shaking: Import only required functions',
519
- '2. Enable minification in bundler config',
520
- '3. Use dynamic imports for large dependencies (mlkem, mldsa)',
521
- '4. Exclude Node.js polyfills (crypto, fs, process)',
522
- '5. Use Brotli compression for Cloudflare Workers',
523
- '6. Consider splitting post-quantum crypto into separate bundle',
524
- '7. Use KV storage instead of in-memory caches',
525
- ];
526
- }
1
+ "use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.EdgeTransportAdapter=exports.KVTrustRegistry=exports.KVNonceStore=exports.DenoKVAdapter=exports.VercelKVAdapter=exports.CloudflareKVAdapter=void 0,exports.detectRuntime=detectRuntime,exports.isEdgeRuntime=isEdgeRuntime,exports.validateEdgeRuntime=validateEdgeRuntime,exports.createEdgeAgent=createEdgeAgent,exports.checkBundleSize=checkBundleSize,exports.getOptimizationTips=getOptimizationTips;const shared_1=require("../../_deps/shared/index.js");function detectRuntime(){const e=globalThis;return void 0!==e.caches&&"string"==typeof e.EdgeRuntime?"cloudflare":"string"==typeof e.EdgeRuntime&&"undefined"!=typeof process&&"1"===process.env?.VERCEL?"vercel":void 0!==e.Deno?"deno":"undefined"!=typeof process&&"string"==typeof process.versions?.node?"node":"unknown"}function isEdgeRuntime(){const e=detectRuntime();return"cloudflare"===e||"vercel"===e||"deno"===e}function validateEdgeRuntime(){if(void 0===globalThis.crypto)return(0,shared_1.err)("Missing globalThis.crypto");if(void 0===globalThis.crypto.subtle)return(0,shared_1.err)("Missing crypto.subtle");if("function"!=typeof globalThis.crypto.getRandomValues)return(0,shared_1.err)("Missing crypto.getRandomValues");const e=["generateKey","sign","verify","encrypt","decrypt","deriveBits","importKey","exportKey"];for(const t of e)if("function"!=typeof globalThis.crypto.subtle[t])return(0,shared_1.err)(`Missing crypto.subtle.${t}`);return void 0===globalThis.TextEncoder?(0,shared_1.err)("Missing TextEncoder"):void 0===globalThis.TextDecoder?(0,shared_1.err)("Missing TextDecoder"):"function"!=typeof globalThis.fetch?(0,shared_1.err)("Missing fetch API"):(0,shared_1.ok)(void 0)}class CloudflareKVAdapter{namespace;constructor(e){this.namespace=e}async get(e){return await this.namespace.get(e)}async put(e,t,r){const s=r?{expirationTtl:r}:void 0;await this.namespace.put(e,t,s)}async delete(e){await this.namespace.delete(e)}async list(e,t){return(await this.namespace.list({prefix:e,limit:t})).keys.map(e=>e.name)}}exports.CloudflareKVAdapter=CloudflareKVAdapter;class VercelKVAdapter{client;constructor(e){this.client=e}async get(e){return await this.client.get(e)}async put(e,t,r){const s=r?{ex:r}:void 0;await this.client.set(e,t,s)}async delete(e){await this.client.del(e)}async list(e,t){const r=e?`${e}*`:"*",s=await this.client.keys(r);return t?s.slice(0,t):s}}exports.VercelKVAdapter=VercelKVAdapter;class DenoKVAdapter{kv;constructor(e){this.kv=e}async get(e){return(await this.kv.get([e])).value}async put(e,t,r){const s=r?{expireIn:1e3*r}:void 0;await this.kv.set([e],t,s)}async delete(e){await this.kv.delete([e])}async list(e,t){const r={prefix:e?[e]:[]},s=[];for await(const e of this.kv.list(r))if(s.push(e.key.join("/")),t&&s.length>=t)break;return s}}exports.DenoKVAdapter=DenoKVAdapter;class KVNonceStore{kv;ttlSeconds;constructor(e,t=6e5){this.kv=e,this.ttlSeconds=Math.floor(t/1e3)}buildKey(e,t,r){const s=`xbind:nonce:${t}:${e}`;if(!r)return s;return`${s}:${r.shareGroupId??""}:${void 0!==r.shareIndex?String(r.shareIndex):""}`}async check(e,t,r){const s=this.buildKey(e,t,r);return null===await this.kv.get(s)&&(await this.kv.put(s,Date.now().toString(),this.ttlSeconds),!0)}cleanup(){}dispose(){}}exports.KVNonceStore=KVNonceStore;class KVTrustRegistry{kv;constructor(e){this.kv=e}buildKey(e){return`xbind:trust:${e}`}async register(e,t,r,s,i,n,o,a,c,d,l,u,p){const h=this.buildKey(e),y=e=>btoa(String.fromCharCode(...Array.from(e))),g={did:e,publicKey:y(t),name:r,scopes:s??[],x25519PublicKey:i?y(i):void 0,mlKemPublicKey:n?y(n):void 0,mlDsaPublicKey:o?y(o):void 0,xchange:a??!1,receiveScopes:c??[],sdkVersion:d,minEnvelopeVersion:l,maxEnvelopeVersion:u,registeredAt:Date.now(),rotation_sequence:0};try{const e=p?Math.floor(p/1e3):void 0;return await this.kv.put(h,JSON.stringify(g),e),(0,shared_1.ok)(void 0)}catch{return(0,shared_1.err)("NETWORK_ERROR")}}async resolve(e){const t=this.buildKey(e);try{const e=await this.kv.get(t);if(null===e)return(0,shared_1.err)("NOT_FOUND");const r=JSON.parse(e),s=e=>Uint8Array.from(atob(e),e=>e.charCodeAt(0));return(0,shared_1.ok)(s(r.publicKey))}catch{return(0,shared_1.err)("NETWORK_ERROR")}}async hasScope(e,t){const r=this.buildKey(e);try{const e=await this.kv.get(r);if(null===e)return!1;const s=JSON.parse(e);return s.scopes?.includes(t)??!1}catch{return!1}}async hasReceiveScope(e,t){const r=this.buildKey(e);try{const e=await this.kv.get(r);if(null===e)return!1;const s=JSON.parse(e);return s.receiveScopes?.includes(t)??!1}catch{return!1}}async revoke(e){const t=this.buildKey(e);try{return await this.kv.delete(t),(0,shared_1.ok)(void 0)}catch{return(0,shared_1.err)("NETWORK_ERROR")}}async list(){try{return(await this.kv.list("xbind:trust:",1e3)).map(e=>e.replace("xbind:trust:",""))}catch{return[]}}async getEntry(e){const t=this.buildKey(e);try{const e=await this.kv.get(t);if(null===e)return(0,shared_1.err)("NOT_FOUND");const r=JSON.parse(e),s=e=>Uint8Array.from(atob(e),e=>e.charCodeAt(0)),i={did:r.did,publicKey:s(r.publicKey),name:r.name,scopes:new Set(r.scopes),receiveScopes:r.receiveScopes?new Set(r.receiveScopes):void 0,revoked:!1,x25519PublicKey:r.x25519PublicKey?s(r.x25519PublicKey):void 0,mlKemPublicKey:r.mlKemPublicKey?s(r.mlKemPublicKey):void 0,mlDsaPublicKey:r.mlDsaPublicKey?s(r.mlDsaPublicKey):void 0,xchange:r.xchange,rotation_sequence:r.rotation_sequence,sdkVersion:r.sdkVersion,minEnvelopeVersion:r.minEnvelopeVersion,maxEnvelopeVersion:r.maxEnvelopeVersion};return(0,shared_1.ok)(i)}catch{return(0,shared_1.err)("NETWORK_ERROR")}}async getFullEntry(e){const t=this.buildKey(e);try{const e=await this.kv.get(t);if(null===e)return(0,shared_1.err)("NOT_FOUND");const r=JSON.parse(e);return(0,shared_1.ok)(r)}catch{return(0,shared_1.err)("NETWORK_ERROR")}}dispose(){}}exports.KVTrustRegistry=KVTrustRegistry;class EdgeTransportAdapter{baseUrl;timeoutMs;handlers=[];constructor(e){this.baseUrl=e.baseUrl.replace(/\/$/,""),this.timeoutMs=e.timeoutMs??1e4}async send(e,t){const r=`${this.baseUrl}/deliver/${encodeURIComponent(t)}`;try{const t=new AbortController,s=setTimeout(()=>t.abort(),this.timeoutMs),i=await globalThis.fetch(r,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(e),signal:t.signal});return clearTimeout(s),i.ok?(0,shared_1.ok)(void 0):(0,shared_1.err)(404===i.status?"RECIPIENT_UNREACHABLE":"SEND_FAILED")}catch(e){return e instanceof DOMException&&"AbortError"===e.name?(0,shared_1.err)("TIMEOUT"):(0,shared_1.err)("NETWORK_ERROR")}}onReceive(e){this.handlers.push(e)}dispatch(e){for(const t of this.handlers)t(e)}dispose(){this.handlers=[]}}function createEdgeAgent(e){return{nonceStore:new KVNonceStore(e.kv,e.nonceTtlMs),trustRegistry:new KVTrustRegistry(e.kv),transport:new EdgeTransportAdapter({baseUrl:e.baseUrl,timeoutMs:e.timeoutMs})}}function checkBundleSize(e){const t=1048576;if(e>t){const t=(e/1024/1024).toFixed(2),r=1..toFixed(2);return(0,shared_1.err)(`Bundle size ${t}MB exceeds edge runtime limit of ${r}MB. Consider using tree-shaking or dynamic imports.`)}return(0,shared_1.ok)(void 0)}function getOptimizationTips(){return["1. Use tree-shaking: Import only required functions","2. Enable minification in bundler config","3. Use dynamic imports for large dependencies (mlkem, mldsa)","4. Exclude Node.js polyfills (crypto, fs, process)","5. Use Brotli compression for Cloudflare Workers","6. Consider splitting post-quantum crypto into separate bundle","7. Use KV storage instead of in-memory caches"]}exports.EdgeTransportAdapter=EdgeTransportAdapter;