@private.me/xbind 3.0.0 → 3.0.2

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 (217) hide show
  1. package/README.md +55 -7
  2. package/dist-standalone/_deps/mldsa-wasm/dist/mldsa.js +1920 -1
  3. package/dist-standalone/_deps/shared/cjs/errors.js +729 -1
  4. package/dist-standalone/_deps/shared/cjs/index.js +463 -1
  5. package/dist-standalone/_deps/shared/cjs/types.js +315 -1
  6. package/dist-standalone/_deps/shared/errors.js +244 -1
  7. package/dist-standalone/_deps/shared/index.js +72 -1
  8. package/dist-standalone/_deps/shared/types.js +86 -1
  9. package/dist-standalone/_deps/ux-helpers/cjs/errors.js +1 -1
  10. package/dist-standalone/_deps/ux-helpers/cjs/index.js +1 -1
  11. package/dist-standalone/_deps/ux-helpers/cjs/pagination.js +1 -1
  12. package/dist-standalone/_deps/ux-helpers/cjs/progress.js +1 -1
  13. package/dist-standalone/_deps/ux-helpers/cjs/search.js +1 -1
  14. package/dist-standalone/_deps/ux-helpers/cjs/types.js +1 -1
  15. package/dist-standalone/_deps/ux-helpers/errors.js +1 -1
  16. package/dist-standalone/_deps/ux-helpers/index.js +1 -1
  17. package/dist-standalone/_deps/ux-helpers/pagination.js +1 -1
  18. package/dist-standalone/_deps/ux-helpers/progress.js +1 -1
  19. package/dist-standalone/_deps/ux-helpers/search.js +1 -1
  20. package/dist-standalone/_deps/xchange/auto-accept.js +1 -1
  21. package/dist-standalone/_deps/xchange/cjs/auto-accept.js +1 -1
  22. package/dist-standalone/_deps/xchange/cjs/errors.js +1 -1
  23. package/dist-standalone/_deps/xchange/cjs/index.js +1 -1
  24. package/dist-standalone/_deps/xchange/cjs/invite-client.js +1 -1
  25. package/dist-standalone/_deps/xchange/cjs/lazy-init.js +1 -1
  26. package/dist-standalone/_deps/xchange/cjs/trust-integration.js +1 -1
  27. package/dist-standalone/_deps/xchange/cjs/xchange.js +1 -1
  28. package/dist-standalone/_deps/xchange/errors.js +1 -1
  29. package/dist-standalone/_deps/xchange/index.js +1 -1
  30. package/dist-standalone/_deps/xchange/invite-client.js +1 -1
  31. package/dist-standalone/_deps/xchange/lazy-init.js +1 -1
  32. package/dist-standalone/_deps/xchange/trust-integration.js +1 -1
  33. package/dist-standalone/_deps/xchange/xchange.js +1 -1
  34. package/dist-standalone/_deps/xregistry/cjs/discovery.js +1 -1
  35. package/dist-standalone/_deps/xregistry/cjs/errors.js +1 -1
  36. package/dist-standalone/_deps/xregistry/cjs/index.js +1 -1
  37. package/dist-standalone/_deps/xregistry/cjs/registry.js +1 -1
  38. package/dist-standalone/_deps/xregistry/cjs/schema.js +1 -1
  39. package/dist-standalone/_deps/xregistry/cjs/types.js +1 -1
  40. package/dist-standalone/_deps/xregistry/discovery.js +1 -1
  41. package/dist-standalone/_deps/xregistry/errors.js +1 -1
  42. package/dist-standalone/_deps/xregistry/index.js +1 -1
  43. package/dist-standalone/_deps/xregistry/registry.js +1 -1
  44. package/dist-standalone/_deps/xregistry/schema.js +1 -1
  45. package/dist-standalone/_deps/xregistry/types.js +1 -1
  46. package/dist-standalone/agent-call.js +659 -1
  47. package/dist-standalone/agent-sdk.js +328 -1
  48. package/dist-standalone/agent.js +1800 -1
  49. package/dist-standalone/approval.js +193 -1
  50. package/dist-standalone/async-iterators.js +382 -1
  51. package/dist-standalone/auth.js +219 -1
  52. package/dist-standalone/auto-accept.js +229 -1
  53. package/dist-standalone/backup-config.js +201 -1
  54. package/dist-standalone/backup.js +326 -1
  55. package/dist-standalone/batch-operations.js +388 -1
  56. package/dist-standalone/cancellation.js +477 -1
  57. package/dist-standalone/checkpoint.js +186 -1
  58. package/dist-standalone/circuit-breaker.js +468 -1
  59. package/dist-standalone/cjs/agent-call.js +701 -1
  60. package/dist-standalone/cjs/agent-sdk.js +332 -1
  61. package/dist-standalone/cjs/agent.js +1837 -1
  62. package/dist-standalone/cjs/approval.js +199 -1
  63. package/dist-standalone/cjs/async-iterators.js +392 -1
  64. package/dist-standalone/cjs/auth.js +225 -1
  65. package/dist-standalone/cjs/auto-accept.js +233 -1
  66. package/dist-standalone/cjs/backup-config.js +207 -1
  67. package/dist-standalone/cjs/backup.js +330 -1
  68. package/dist-standalone/cjs/batch-operations.js +397 -1
  69. package/dist-standalone/cjs/cancellation.js +490 -1
  70. package/dist-standalone/cjs/checkpoint.js +193 -1
  71. package/dist-standalone/cjs/circuit-breaker.js +476 -1
  72. package/dist-standalone/cjs/cli/init.js +492 -1
  73. package/dist-standalone/cjs/config-validation.js +522 -1
  74. package/dist-standalone/cjs/connect.js +312 -1
  75. package/dist-standalone/cjs/connection-pool.js +506 -1
  76. package/dist-standalone/cjs/correlation-id.js +339 -1
  77. package/dist-standalone/cjs/crypto-utils.js +176 -1
  78. package/dist-standalone/cjs/debug-mode.js +534 -1
  79. package/dist-standalone/cjs/did-document.js +101 -1
  80. package/dist-standalone/cjs/did-privateme.js +130 -1
  81. package/dist-standalone/cjs/did-web.js +201 -1
  82. package/dist-standalone/cjs/discovery.js +462 -1
  83. package/dist-standalone/cjs/dual-mode.js +251 -1
  84. package/dist-standalone/cjs/email-templates.js +313 -1
  85. package/dist-standalone/cjs/email-transport.js +239 -1
  86. package/dist-standalone/cjs/envelope.js +538 -1
  87. package/dist-standalone/cjs/errors.js +913 -1
  88. package/dist-standalone/cjs/event-emitter.js +461 -1
  89. package/dist-standalone/cjs/gateway-state.js +55 -1
  90. package/dist-standalone/cjs/gateway-transport.js +120 -1
  91. package/dist-standalone/cjs/graceful-degradation.js +403 -1
  92. package/dist-standalone/cjs/guardrails.js +223 -1
  93. package/dist-standalone/cjs/health-check.js +336 -1
  94. package/dist-standalone/cjs/http-compat.js +272 -1
  95. package/dist-standalone/cjs/http-status-map.js +571 -1
  96. package/dist-standalone/cjs/identity.js +645 -1
  97. package/dist-standalone/cjs/index.js +406 -1
  98. package/dist-standalone/cjs/invitation.js +421 -1
  99. package/dist-standalone/cjs/invite.js +328 -1
  100. package/dist-standalone/cjs/key-agreement.js +335 -1
  101. package/dist-standalone/cjs/lazy-init.js +300 -1
  102. package/dist-standalone/cjs/logger.js +291 -1
  103. package/dist-standalone/cjs/mdns-discovery.js +202 -1
  104. package/dist-standalone/cjs/nonce-store.js +80 -1
  105. package/dist-standalone/cjs/pairing-manager.js +223 -1
  106. package/dist-standalone/cjs/plugin-system.js +264 -1
  107. package/dist-standalone/cjs/plugins/logging.js +168 -1
  108. package/dist-standalone/cjs/plugins/metrics.js +181 -1
  109. package/dist-standalone/cjs/plugins/validation.js +302 -1
  110. package/dist-standalone/cjs/policy.js +320 -1
  111. package/dist-standalone/cjs/progress-callbacks.js +583 -1
  112. package/dist-standalone/cjs/redis-nonce-store.js +76 -1
  113. package/dist-standalone/cjs/registry-middleware.js +50 -1
  114. package/dist-standalone/cjs/retry-strategies.js +544 -1
  115. package/dist-standalone/cjs/retry-transport.js +102 -1
  116. package/dist-standalone/cjs/runtime/browser.js +533 -1
  117. package/dist-standalone/cjs/runtime/edge.js +526 -1
  118. package/dist-standalone/cjs/runtime/react-native.js +394 -1
  119. package/dist-standalone/cjs/security-policy.js +245 -1
  120. package/dist-standalone/cjs/serialization.js +1040 -1
  121. package/dist-standalone/cjs/split-channel.js +225 -1
  122. package/dist-standalone/cjs/subscription-proof.js +230 -1
  123. package/dist-standalone/cjs/succession.js +148 -1
  124. package/dist-standalone/cjs/timeouts.js +412 -1
  125. package/dist-standalone/cjs/trace-context.js +424 -1
  126. package/dist-standalone/cjs/trace-spans.js +495 -1
  127. package/dist-standalone/cjs/transport.js +63 -1
  128. package/dist-standalone/cjs/trust-registry.js +991 -1
  129. package/dist-standalone/cjs/types/error-response.js +56 -1
  130. package/dist-standalone/cjs/vault-auth.js +178 -1
  131. package/dist-standalone/cjs/vault-store-loader.js +194 -1
  132. package/dist-standalone/cjs/verify.js +25 -1
  133. package/dist-standalone/cjs/version-info.js +543 -1
  134. package/dist-standalone/cjs/xfetch.js +340 -1
  135. package/dist-standalone/cli/init.js +455 -1
  136. package/dist-standalone/cli/setup.js +514 -1
  137. package/dist-standalone/cli/types.js +27 -1
  138. package/dist-standalone/cli/xbind.js +148 -1
  139. package/dist-standalone/config-validation.js +513 -1
  140. package/dist-standalone/connect.js +274 -1
  141. package/dist-standalone/connection-pool.js +500 -1
  142. package/dist-standalone/correlation-id.js +326 -1
  143. package/dist-standalone/crypto-utils.js +157 -1
  144. package/dist-standalone/debug-mode.js +510 -1
  145. package/dist-standalone/did-document.js +96 -1
  146. package/dist-standalone/did-privateme.js +121 -1
  147. package/dist-standalone/did-web.js +196 -1
  148. package/dist-standalone/discovery.js +458 -1
  149. package/dist-standalone/dual-mode.js +247 -1
  150. package/dist-standalone/email-templates.js +309 -1
  151. package/dist-standalone/email-transport.js +232 -1
  152. package/dist-standalone/envelope.js +525 -1
  153. package/dist-standalone/errors.js +896 -1
  154. package/dist-standalone/event-emitter.js +456 -1
  155. package/dist-standalone/gateway-state.js +51 -1
  156. package/dist-standalone/gateway-transport.js +116 -1
  157. package/dist-standalone/graceful-degradation.js +396 -1
  158. package/dist-standalone/guardrails.js +216 -1
  159. package/dist-standalone/health-check.js +332 -1
  160. package/dist-standalone/http-compat.js +267 -1
  161. package/dist-standalone/http-status-map.js +561 -1
  162. package/dist-standalone/identity.js +619 -1
  163. package/dist-standalone/index.js +78 -1
  164. package/dist-standalone/invitation.js +415 -1
  165. package/dist-standalone/invite.js +324 -1
  166. package/dist-standalone/key-agreement.js +325 -1
  167. package/dist-standalone/lazy-init.js +295 -1
  168. package/dist-standalone/logger.js +285 -1
  169. package/dist-standalone/mdns-discovery.js +195 -1
  170. package/dist-standalone/nonce-store.js +76 -1
  171. package/dist-standalone/pairing-manager.js +219 -1
  172. package/dist-standalone/plugin-system.js +257 -1
  173. package/dist-standalone/plugins/logging.d.ts +84 -0
  174. package/dist-standalone/plugins/logging.js +163 -0
  175. package/dist-standalone/plugins/metrics.d.ts +111 -0
  176. package/dist-standalone/plugins/metrics.js +176 -0
  177. package/dist-standalone/plugins/validation.d.ts +104 -0
  178. package/dist-standalone/plugins/validation.js +297 -0
  179. package/dist-standalone/policy.js +315 -1
  180. package/dist-standalone/progress-callbacks.js +576 -1
  181. package/dist-standalone/redis-nonce-store.js +72 -1
  182. package/dist-standalone/registry-middleware.js +47 -1
  183. package/dist-standalone/retry-strategies.js +534 -1
  184. package/dist-standalone/retry-transport.js +98 -1
  185. package/dist-standalone/runtime/browser.d.ts +311 -0
  186. package/dist-standalone/runtime/browser.js +516 -0
  187. package/dist-standalone/runtime/edge.d.ts +282 -0
  188. package/dist-standalone/runtime/edge.js +511 -0
  189. package/dist-standalone/runtime/react-native.d.ts +157 -0
  190. package/dist-standalone/runtime/react-native.js +383 -0
  191. package/dist-standalone/security-policy.js +239 -1
  192. package/dist-standalone/serialization.js +1031 -1
  193. package/dist-standalone/split-channel.js +219 -1
  194. package/dist-standalone/subscription-proof.js +224 -1
  195. package/dist-standalone/succession.js +142 -1
  196. package/dist-standalone/timeouts.js +398 -1
  197. package/dist-standalone/trace-context.js +414 -1
  198. package/dist-standalone/trace-spans.js +488 -1
  199. package/dist-standalone/transport.js +59 -1
  200. package/dist-standalone/trust-registry.js +950 -1
  201. package/dist-standalone/types/error-response.d.ts +209 -0
  202. package/dist-standalone/types/error-response.js +52 -0
  203. package/dist-standalone/vault-auth.js +174 -1
  204. package/dist-standalone/vault-store-loader.js +187 -1
  205. package/dist-standalone/verify.js +16 -1
  206. package/dist-standalone/version-info.js +530 -1
  207. package/dist-standalone/xfetch.js +335 -1
  208. package/package.json +4 -10
  209. package/share1.dat +0 -0
  210. package/dist-standalone/_deps/mldsa-wasm/LICENSE +0 -24
  211. package/dist-standalone/_deps/mldsa-wasm/package.json +0 -46
  212. package/dist-standalone/_deps/shared/cjs/package.json +0 -1
  213. package/dist-standalone/_deps/ux-helpers/cjs/package.json +0 -1
  214. package/dist-standalone/_deps/xchange/cjs/package.json +0 -1
  215. package/dist-standalone/_deps/xregistry/cjs/package.json +0 -1
  216. package/dist-standalone/cjs/package.json +0 -3
  217. package/dist-standalone/package.json +0 -10
@@ -1 +1,247 @@
1
- import{ok,err}from"./_deps/shared/index.js";export var DualModeErrorCode;!function(a){a.BOTH_FAILED="DUAL_MODE_BOTH_FAILED",a.XBIND_FAILED="DUAL_MODE_XBIND_FAILED",a.FALLBACK_FAILED="DUAL_MODE_FALLBACK_FAILED",a.INVALID_CONFIG="DUAL_MODE_INVALID_CONFIG"}(DualModeErrorCode||(DualModeErrorCode={}));export class DualModeAdapter{xbind;fallback;metrics;constructor(a={}){this.xbind=a.xbind||null,this.fallback=a.fallback||null,this.metrics={totalCalls:0,xbindCalls:0,fallbackCalls:0,xbindPercentage:0,lastCall:(new Date).toISOString(),lastCallMethod:"xbind"}}setXBind(a){this.xbind=a}removeFallback(){this.fallback=null}async call(a,r={}){if(this.metrics.totalCalls++,this.xbind)try{const e=await this.callViaXBind(a,r);if(e.ok)return this.metrics.xbindCalls++,this.updateMetrics("xbind"),e;if(this.fallback){const t=await this.callViaFallback(a,r);return t.ok?(this.metrics.fallbackCalls++,this.updateMetrics("fallback"),t):err({code:DualModeErrorCode.BOTH_FAILED,message:"Both XBind and fallback failed",xbindError:e.error,fallbackError:t.error})}return err({code:DualModeErrorCode.XBIND_FAILED,message:"XBind failed and no fallback configured",xbindError:e.error})}catch(e){if(this.fallback){const e=await this.callViaFallback(a,r);if(e.ok)return this.metrics.fallbackCalls++,this.updateMetrics("fallback"),e}return err({code:DualModeErrorCode.XBIND_FAILED,message:e instanceof Error?e.message:"XBind exception",xbindError:e})}if(this.fallback){const e=await this.callViaFallback(a,r);return e.ok?(this.metrics.fallbackCalls++,this.updateMetrics("fallback"),e):err({code:DualModeErrorCode.FALLBACK_FAILED,message:"Fallback failed",fallbackError:e.error})}return err({code:DualModeErrorCode.INVALID_CONFIG,message:"Neither XBind nor fallback configured"})}getMetrics(){return{...this.metrics}}resetMetrics(){this.metrics={totalCalls:0,xbindCalls:0,fallbackCalls:0,xbindPercentage:0,lastCall:(new Date).toISOString(),lastCallMethod:"xbind"}}async callViaXBind(a,r){if(!this.xbind)return err({message:"XBind not configured"});try{return await this.xbind.send({to:this.xbind.did,payload:{action:a,params:r},scope:a})}catch(a){return err({message:a instanceof Error?a.message:"Unknown error"})}}async callViaFallback(a,r){if(!this.fallback)return err({message:"Fallback not configured"});try{const e=`${this.fallback.url}/${a}`,t=this.fallback.method||"POST",l={"Content-Type":"application/json",...this.fallback.headers};"api-key"===this.fallback.type&&this.fallback.key&&(l.Authorization=`Bearer ${this.fallback.key}`);const i=await fetch(e,{method:t,headers:l,body:"GET"!==t?JSON.stringify(r):void 0});if(!i.ok)return err({message:`HTTP ${i.status}`});const s=await i.json();return ok(s)}catch(a){return err({message:a instanceof Error?a.message:"Network error"})}}updateMetrics(a){this.metrics.lastCall=(new Date).toISOString(),this.metrics.lastCallMethod=a,this.metrics.xbindPercentage=this.metrics.totalCalls>0?this.metrics.xbindCalls/this.metrics.totalCalls*100:0}}
1
+ /**
2
+ * @module dual-mode
3
+ * Dual-mode adapter: XBind + API key fallback.
4
+ *
5
+ * Enables zero-downtime migration:
6
+ * - Try XBind first
7
+ * - Fall back to API key if unavailable
8
+ * - Track usage metrics
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * const adapter = new DualModeAdapter({
13
+ * xbind: xbindAgent,
14
+ * fallback: {
15
+ * type: 'api-key',
16
+ * key: process.env.API_KEY,
17
+ * url: 'https://api.example.com',
18
+ * },
19
+ * });
20
+ *
21
+ * // Will try xBind, fall back to API key
22
+ * const result = await adapter.call('createCharge', { amount: 100 });
23
+ * ```
24
+ */
25
+ import { ok, err } from"./_deps/shared/index.js";
26
+ /**
27
+ * Dual-mode error codes.
28
+ */
29
+ export var DualModeErrorCode;
30
+ (function (DualModeErrorCode) {
31
+ DualModeErrorCode["BOTH_FAILED"] = "DUAL_MODE_BOTH_FAILED";
32
+ DualModeErrorCode["XBIND_FAILED"] = "DUAL_MODE_XBIND_FAILED";
33
+ DualModeErrorCode["FALLBACK_FAILED"] = "DUAL_MODE_FALLBACK_FAILED";
34
+ DualModeErrorCode["INVALID_CONFIG"] = "DUAL_MODE_INVALID_CONFIG";
35
+ })(DualModeErrorCode || (DualModeErrorCode = {}));
36
+ /**
37
+ * Dual-mode adapter.
38
+ *
39
+ * Tries XBind first, falls back to API key if unavailable.
40
+ */
41
+ export class DualModeAdapter {
42
+ xbind;
43
+ fallback;
44
+ metrics;
45
+ /**
46
+ * Create dual-mode adapter.
47
+ *
48
+ * @param options - Configuration
49
+ * @param options.xbind - xBind agent (optional, can be added later)
50
+ * @param options.fallback - Fallback config (optional, can be removed later)
51
+ */
52
+ constructor(options = {}) {
53
+ this.xbind = options.xbind || null;
54
+ this.fallback = options.fallback || null;
55
+ this.metrics = {
56
+ totalCalls: 0,
57
+ xbindCalls: 0,
58
+ fallbackCalls: 0,
59
+ xbindPercentage: 0,
60
+ lastCall: new Date().toISOString(),
61
+ lastCallMethod: 'xbind',
62
+ };
63
+ }
64
+ /**
65
+ * Set xBind agent (for gradual rollout).
66
+ *
67
+ * @param agent - xBind agent
68
+ */
69
+ setXBind(agent) {
70
+ this.xbind = agent;
71
+ }
72
+ /**
73
+ * Remove fallback (complete migration).
74
+ */
75
+ removeFallback() {
76
+ this.fallback = null;
77
+ }
78
+ /**
79
+ * Call an action (tries XBind first, falls back if needed).
80
+ *
81
+ * @param action - Action name
82
+ * @param params - Action parameters
83
+ * @returns Result or error
84
+ *
85
+ * @example
86
+ * ```ts
87
+ * const result = await adapter.call('createCharge', {
88
+ * amount: 100,
89
+ * currency: 'USD',
90
+ * });
91
+ * ```
92
+ */
93
+ async call(action, params = {}) {
94
+ this.metrics.totalCalls++;
95
+ // Try XBind first
96
+ if (this.xbind) {
97
+ try {
98
+ const result = await this.callViaXBind(action, params);
99
+ if (result.ok) {
100
+ this.metrics.xbindCalls++;
101
+ this.updateMetrics('xbind');
102
+ return result;
103
+ }
104
+ // XBind failed, try fallback if available
105
+ if (this.fallback) {
106
+ const fallbackResult = await this.callViaFallback(action, params);
107
+ if (fallbackResult.ok) {
108
+ this.metrics.fallbackCalls++;
109
+ this.updateMetrics('fallback');
110
+ return fallbackResult;
111
+ }
112
+ // Both failed
113
+ return err({
114
+ code: DualModeErrorCode.BOTH_FAILED,
115
+ message: 'Both XBind and fallback failed',
116
+ xbindError: result.error,
117
+ fallbackError: fallbackResult.error,
118
+ });
119
+ }
120
+ // No fallback, return XBind error
121
+ return err({
122
+ code: DualModeErrorCode.XBIND_FAILED,
123
+ message: 'XBind failed and no fallback configured',
124
+ xbindError: result.error,
125
+ });
126
+ }
127
+ catch (error) {
128
+ // XBind exception, try fallback
129
+ if (this.fallback) {
130
+ const fallbackResult = await this.callViaFallback(action, params);
131
+ if (fallbackResult.ok) {
132
+ this.metrics.fallbackCalls++;
133
+ this.updateMetrics('fallback');
134
+ return fallbackResult;
135
+ }
136
+ }
137
+ return err({
138
+ code: DualModeErrorCode.XBIND_FAILED,
139
+ message: error instanceof Error ? error.message : 'XBind exception',
140
+ xbindError: error,
141
+ });
142
+ }
143
+ }
144
+ // No xBind, try fallback only
145
+ if (this.fallback) {
146
+ const result = await this.callViaFallback(action, params);
147
+ if (result.ok) {
148
+ this.metrics.fallbackCalls++;
149
+ this.updateMetrics('fallback');
150
+ return result;
151
+ }
152
+ return err({
153
+ code: DualModeErrorCode.FALLBACK_FAILED,
154
+ message: 'Fallback failed',
155
+ fallbackError: result.error,
156
+ });
157
+ }
158
+ // Neither XBind nor fallback configured
159
+ return err({
160
+ code: DualModeErrorCode.INVALID_CONFIG,
161
+ message: 'Neither XBind nor fallback configured',
162
+ });
163
+ }
164
+ /**
165
+ * Get usage metrics.
166
+ *
167
+ * @returns Current metrics
168
+ */
169
+ getMetrics() {
170
+ return { ...this.metrics };
171
+ }
172
+ /**
173
+ * Reset metrics.
174
+ */
175
+ resetMetrics() {
176
+ this.metrics = {
177
+ totalCalls: 0,
178
+ xbindCalls: 0,
179
+ fallbackCalls: 0,
180
+ xbindPercentage: 0,
181
+ lastCall: new Date().toISOString(),
182
+ lastCallMethod: 'xbind',
183
+ };
184
+ }
185
+ /**
186
+ * Call via XBind.
187
+ */
188
+ async callViaXBind(action, params) {
189
+ if (!this.xbind) {
190
+ return err({ message: 'XBind not configured' });
191
+ }
192
+ try {
193
+ const result = await this.xbind.send({
194
+ to: this.xbind.did, // TODO: Get target DID from connection
195
+ payload: { action, params },
196
+ scope: action,
197
+ });
198
+ return result;
199
+ }
200
+ catch (error) {
201
+ return err({ message: error instanceof Error ? error.message : 'Unknown error' });
202
+ }
203
+ }
204
+ /**
205
+ * Call via fallback (API key, OAuth, etc.).
206
+ */
207
+ async callViaFallback(action, params) {
208
+ if (!this.fallback) {
209
+ return err({ message: 'Fallback not configured' });
210
+ }
211
+ try {
212
+ const url = `${this.fallback.url}/${action}`;
213
+ const method = this.fallback.method || 'POST';
214
+ const headers = {
215
+ 'Content-Type': 'application/json',
216
+ ...this.fallback.headers,
217
+ };
218
+ // Add auth header based on type
219
+ if (this.fallback.type === 'api-key' && this.fallback.key) {
220
+ headers['Authorization'] = `Bearer ${this.fallback.key}`;
221
+ }
222
+ const response = await fetch(url, {
223
+ method,
224
+ headers,
225
+ body: method !== 'GET' ? JSON.stringify(params) : undefined,
226
+ });
227
+ if (!response.ok) {
228
+ return err({ message: `HTTP ${response.status}` });
229
+ }
230
+ const data = await response.json();
231
+ return ok(data);
232
+ }
233
+ catch (error) {
234
+ return err({ message: error instanceof Error ? error.message : 'Network error' });
235
+ }
236
+ }
237
+ /**
238
+ * Update metrics after a call.
239
+ */
240
+ updateMetrics(method) {
241
+ this.metrics.lastCall = new Date().toISOString();
242
+ this.metrics.lastCallMethod = method;
243
+ this.metrics.xbindPercentage = this.metrics.totalCalls > 0
244
+ ? (this.metrics.xbindCalls / this.metrics.totalCalls) * 100
245
+ : 0;
246
+ }
247
+ }
@@ -1 +1,309 @@
1
- const PRIVACY_MASK_SVG='\n<svg width="32" height="32" viewBox="0 0 300 600" xmlns="http://www.w3.org/2000/svg">\n <defs>\n <linearGradient id="maskGradient" x1="0%" y1="0%" x2="100%" y2="100%">\n <stop offset="0%" style="stop-color:#10B981;stop-opacity:1" />\n <stop offset="100%" style="stop-color:#059669;stop-opacity:1" />\n </linearGradient>\n </defs>\n \x3c!-- Top curve --\x3e\n <path d="M50 100 Q150 50 250 100 L250 300 Q150 350 50 300 Z" fill="url(#maskGradient)"/>\n \x3c!-- Eye holes --\x3e\n <ellipse cx="100" cy="180" rx="25" ry="35" fill="#FFFFFF"/>\n <ellipse cx="200" cy="180" rx="25" ry="35" fill="#FFFFFF"/>\n \x3c!-- Bottom z-shape --\x3e\n <path d="M270 575 L230 575 L270 525 L230 525" stroke="#10B981" stroke-width="8" fill="none"/>\n</svg>\n';export function renderInviteEmail(n){return`\n<!DOCTYPE html>\n<html lang="en">\n<head>\n <meta charset="UTF-8">\n <meta name="viewport" content="width=device-width, initial-scale=1.0">\n <title>${escapeHtml(n.agentName)} wants to connect</title>\n <style>\n @import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;600;700&family=DM+Mono:wght@400;500&display=swap');\n \n body {\n margin: 0;\n padding: 0;\n font-family: 'Outfit', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;\n background-color: #F9FAFB;\n color: #1F2937;\n }\n \n .container {\n max-width: 600px;\n margin: 0 auto;\n background-color: #FFFFFF;\n }\n \n .header {\n background: linear-gradient(135deg, #10B981 0%, #059669 100%);\n padding: 40px 24px;\n text-align: center;\n }\n \n .logo {\n margin-bottom: 16px;\n }\n \n .header h1 {\n margin: 0;\n font-size: 24px;\n font-weight: 700;\n color: #FFFFFF;\n line-height: 1.3;\n }\n \n .content {\n padding: 40px 24px;\n }\n \n .content p {\n margin: 0 0 16px 0;\n font-size: 16px;\n line-height: 1.6;\n color: #374151;\n }\n \n .agent-info {\n background-color: #F3F4F6;\n border-left: 4px solid #10B981;\n padding: 16px;\n margin: 24px 0;\n border-radius: 4px;\n }\n \n .agent-name {\n font-size: 18px;\n font-weight: 600;\n color: #1F2937;\n margin-bottom: 8px;\n }\n \n .did {\n font-family: 'DM Mono', 'Courier New', monospace;\n font-size: 12px;\n color: #6B7280;\n word-break: break-all;\n line-height: 1.5;\n }\n \n .message-box {\n background-color: #F9FAFB;\n border: 1px solid #E5E7EB;\n padding: 16px;\n margin: 24px 0;\n border-radius: 8px;\n font-style: italic;\n color: #4B5563;\n }\n \n .cta-container {\n text-align: center;\n margin: 32px 0;\n }\n \n .cta-button {\n display: inline-block;\n background-color: #10B981;\n color: #FFFFFF;\n text-decoration: none;\n padding: 14px 32px;\n border-radius: 8px;\n font-size: 16px;\n font-weight: 600;\n transition: background-color 0.2s;\n }\n \n .cta-button:hover {\n background-color: #059669;\n }\n \n .footer {\n padding: 24px;\n text-align: center;\n border-top: 1px solid #E5E7EB;\n }\n \n .tagline {\n font-size: 14px;\n color: #6B7280;\n margin-bottom: 12px;\n }\n \n .brand {\n font-size: 12px;\n color: #9CA3AF;\n }\n \n .security-note {\n font-size: 13px;\n color: #6B7280;\n margin-top: 24px;\n padding-top: 24px;\n border-top: 1px solid #E5E7EB;\n }\n </style>\n</head>\n<body>\n <div class="container">\n \x3c!-- Header --\x3e\n <div class="header">\n <div class="logo">${PRIVACY_MASK_SVG}</div>\n <h1>${escapeHtml(n.agentName)} wants to connect</h1>\n </div>\n \n \x3c!-- Content --\x3e\n <div class="content">\n <p>You've been invited to establish an authenticated agent-to-agent connection.</p>\n \n \x3c!-- Agent Info --\x3e\n <div class="agent-info">\n <div class="agent-name">From: ${escapeHtml(n.agentName)}</div>\n <div class="did">DID: ${escapeHtml(n.did)}</div>\n </div>\n \n ${n.message?`\n \x3c!-- Custom Message --\x3e\n <div class="message-box">\n "${escapeHtml(n.message)}"\n </div>\n `:""}\n \n <p>Click below to accept this invitation and establish a secure connection. No API keys or manual configuration required.</p>\n \n \x3c!-- CTA Button --\x3e\n <div class="cta-container">\n <a href="${escapeHtml(n.acceptUrl)}" class="cta-button">\n Accept Invitation\n </a>\n </div>\n \n \x3c!-- Security Note --\x3e\n <div class="security-note">\n <strong>🔒 Secure connection:</strong> This invitation uses cryptographic identity (DID) instead of shared secrets. Your agent will verify the sender's signature before establishing trust.\n </div>\n </div>\n \n \x3c!-- Footer --\x3e\n <div class="footer">\n <div class="tagline">APIs have keys. ACIs have identity.</div>\n <div class="brand">\n <strong>private<span style="color: #10B981;">.me</span></strong> • Authenticated Agent Communication\n </div>\n </div>\n </div>\n</body>\n</html>\n `.trim()}export function renderAcceptedEmail(n){return`\n<!DOCTYPE html>\n<html lang="en">\n<head>\n <meta charset="UTF-8">\n <meta name="viewport" content="width=device-width, initial-scale=1.0">\n <title>Connection Accepted</title>\n <style>\n @import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;600;700&family=DM+Mono:wght@400;500&display=swap');\n body {\n margin: 0;\n padding: 0;\n font-family: 'Outfit', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;\n background-color: #F9FAFB;\n color: #1F2937;\n }\n .container {\n max-width: 600px;\n margin: 0 auto;\n background-color: #FFFFFF;\n }\n .header {\n background: linear-gradient(135deg, #10B981 0%, #059669 100%);\n padding: 40px 24px;\n text-align: center;\n color: #FFFFFF;\n }\n .content {\n padding: 40px 24px;\n }\n .success-icon {\n font-size: 48px;\n text-align: center;\n margin-bottom: 16px;\n }\n .agent-name {\n font-weight: 600;\n color: #10B981;\n }\n </style>\n</head>\n<body>\n <div class="container">\n <div class="header">\n <div class="logo">${PRIVACY_MASK_SVG}</div>\n <h1>Connection Established</h1>\n </div>\n <div class="content">\n <div class="success-icon">✅</div>\n <p><span class="agent-name">${escapeHtml(n.recipientName)}</span> has accepted your invitation.</p>\n <p>You can now send authenticated messages to:</p>\n <div style="font-family: 'DM Mono', monospace; font-size: 12px; color: #6B7280; padding: 16px; background: #F3F4F6; border-radius: 8px; margin: 16px 0;">\n ${escapeHtml(n.did)}\n </div>\n <p style="margin-top: 24px; padding-top: 24px; border-top: 1px solid #E5E7EB; font-size: 14px; color: #6B7280;">\n APIs have keys. ACIs have identity.\n </p>\n </div>\n </div>\n</body>\n</html>\n `.trim()}function escapeHtml(n){const e={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#039;"};return n.replace(/[&<>"']/g,n=>e[n]||n)}
1
+ /**
2
+ * @module email-templates
3
+ * Branded HTML email templates for xBind invitations.
4
+ *
5
+ * Uses Private.Me brand guidelines:
6
+ * - Colors: Green #10B981, Ink #1F2937, White #FFFFFF
7
+ * - Fonts: Outfit (display), DM Mono (code/DIDs)
8
+ * - Logo: Privacy Mask SVG
9
+ * - Tagline: "APIs have keys. ACIs have identity."
10
+ */
11
+ /**
12
+ * Privacy Mask logo SVG (complete with bottom z-shape).
13
+ * Per brand guidelines section 02.5.
14
+ */
15
+ const PRIVACY_MASK_SVG = `
16
+ <svg width="32" height="32" viewBox="0 0 300 600" xmlns="http://www.w3.org/2000/svg">
17
+ <defs>
18
+ <linearGradient id="maskGradient" x1="0%" y1="0%" x2="100%" y2="100%">
19
+ <stop offset="0%" style="stop-color:#10B981;stop-opacity:1" />
20
+ <stop offset="100%" style="stop-color:#059669;stop-opacity:1" />
21
+ </linearGradient>
22
+ </defs>
23
+ <!-- Top curve -->
24
+ <path d="M50 100 Q150 50 250 100 L250 300 Q150 350 50 300 Z" fill="url(#maskGradient)"/>
25
+ <!-- Eye holes -->
26
+ <ellipse cx="100" cy="180" rx="25" ry="35" fill="#FFFFFF"/>
27
+ <ellipse cx="200" cy="180" rx="25" ry="35" fill="#FFFFFF"/>
28
+ <!-- Bottom z-shape -->
29
+ <path d="M270 575 L230 575 L270 525 L230 525" stroke="#10B981" stroke-width="8" fill="none"/>
30
+ </svg>
31
+ `;
32
+ /**
33
+ * Render invitation email with branded template.
34
+ *
35
+ * @param data - Template data
36
+ * @returns Rendered HTML email
37
+ */
38
+ export function renderInviteEmail(data) {
39
+ return `
40
+ <!DOCTYPE html>
41
+ <html lang="en">
42
+ <head>
43
+ <meta charset="UTF-8">
44
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
45
+ <title>${escapeHtml(data.agentName)} wants to connect</title>
46
+ <style>
47
+ @import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;600;700&family=DM+Mono:wght@400;500&display=swap');
48
+
49
+ body {
50
+ margin: 0;
51
+ padding: 0;
52
+ font-family: 'Outfit', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
53
+ background-color: #F9FAFB;
54
+ color: #1F2937;
55
+ }
56
+
57
+ .container {
58
+ max-width: 600px;
59
+ margin: 0 auto;
60
+ background-color: #FFFFFF;
61
+ }
62
+
63
+ .header {
64
+ background: linear-gradient(135deg, #10B981 0%, #059669 100%);
65
+ padding: 40px 24px;
66
+ text-align: center;
67
+ }
68
+
69
+ .logo {
70
+ margin-bottom: 16px;
71
+ }
72
+
73
+ .header h1 {
74
+ margin: 0;
75
+ font-size: 24px;
76
+ font-weight: 700;
77
+ color: #FFFFFF;
78
+ line-height: 1.3;
79
+ }
80
+
81
+ .content {
82
+ padding: 40px 24px;
83
+ }
84
+
85
+ .content p {
86
+ margin: 0 0 16px 0;
87
+ font-size: 16px;
88
+ line-height: 1.6;
89
+ color: #374151;
90
+ }
91
+
92
+ .agent-info {
93
+ background-color: #F3F4F6;
94
+ border-left: 4px solid #10B981;
95
+ padding: 16px;
96
+ margin: 24px 0;
97
+ border-radius: 4px;
98
+ }
99
+
100
+ .agent-name {
101
+ font-size: 18px;
102
+ font-weight: 600;
103
+ color: #1F2937;
104
+ margin-bottom: 8px;
105
+ }
106
+
107
+ .did {
108
+ font-family: 'DM Mono', 'Courier New', monospace;
109
+ font-size: 12px;
110
+ color: #6B7280;
111
+ word-break: break-all;
112
+ line-height: 1.5;
113
+ }
114
+
115
+ .message-box {
116
+ background-color: #F9FAFB;
117
+ border: 1px solid #E5E7EB;
118
+ padding: 16px;
119
+ margin: 24px 0;
120
+ border-radius: 8px;
121
+ font-style: italic;
122
+ color: #4B5563;
123
+ }
124
+
125
+ .cta-container {
126
+ text-align: center;
127
+ margin: 32px 0;
128
+ }
129
+
130
+ .cta-button {
131
+ display: inline-block;
132
+ background-color: #10B981;
133
+ color: #FFFFFF;
134
+ text-decoration: none;
135
+ padding: 14px 32px;
136
+ border-radius: 8px;
137
+ font-size: 16px;
138
+ font-weight: 600;
139
+ transition: background-color 0.2s;
140
+ }
141
+
142
+ .cta-button:hover {
143
+ background-color: #059669;
144
+ }
145
+
146
+ .footer {
147
+ padding: 24px;
148
+ text-align: center;
149
+ border-top: 1px solid #E5E7EB;
150
+ }
151
+
152
+ .tagline {
153
+ font-size: 14px;
154
+ color: #6B7280;
155
+ margin-bottom: 12px;
156
+ }
157
+
158
+ .brand {
159
+ font-size: 12px;
160
+ color: #9CA3AF;
161
+ }
162
+
163
+ .security-note {
164
+ font-size: 13px;
165
+ color: #6B7280;
166
+ margin-top: 24px;
167
+ padding-top: 24px;
168
+ border-top: 1px solid #E5E7EB;
169
+ }
170
+ </style>
171
+ </head>
172
+ <body>
173
+ <div class="container">
174
+ <!-- Header -->
175
+ <div class="header">
176
+ <div class="logo">${PRIVACY_MASK_SVG}</div>
177
+ <h1>${escapeHtml(data.agentName)} wants to connect</h1>
178
+ </div>
179
+
180
+ <!-- Content -->
181
+ <div class="content">
182
+ <p>You've been invited to establish an authenticated agent-to-agent connection.</p>
183
+
184
+ <!-- Agent Info -->
185
+ <div class="agent-info">
186
+ <div class="agent-name">From: ${escapeHtml(data.agentName)}</div>
187
+ <div class="did">DID: ${escapeHtml(data.did)}</div>
188
+ </div>
189
+
190
+ ${data.message ? `
191
+ <!-- Custom Message -->
192
+ <div class="message-box">
193
+ "${escapeHtml(data.message)}"
194
+ </div>
195
+ ` : ''}
196
+
197
+ <p>Click below to accept this invitation and establish a secure connection. No API keys or manual configuration required.</p>
198
+
199
+ <!-- CTA Button -->
200
+ <div class="cta-container">
201
+ <a href="${escapeHtml(data.acceptUrl)}" class="cta-button">
202
+ Accept Invitation
203
+ </a>
204
+ </div>
205
+
206
+ <!-- Security Note -->
207
+ <div class="security-note">
208
+ <strong>🔒 Secure connection:</strong> This invitation uses cryptographic identity (DID) instead of shared secrets. Your agent will verify the sender's signature before establishing trust.
209
+ </div>
210
+ </div>
211
+
212
+ <!-- Footer -->
213
+ <div class="footer">
214
+ <div class="tagline">APIs have keys. ACIs have identity.</div>
215
+ <div class="brand">
216
+ <strong>private<span style="color: #10B981;">.me</span></strong> • Authenticated Agent Communication
217
+ </div>
218
+ </div>
219
+ </div>
220
+ </body>
221
+ </html>
222
+ `.trim();
223
+ }
224
+ /**
225
+ * Render connection accepted confirmation email.
226
+ *
227
+ * @param data - Template data
228
+ * @returns Rendered HTML email
229
+ */
230
+ export function renderAcceptedEmail(data) {
231
+ return `
232
+ <!DOCTYPE html>
233
+ <html lang="en">
234
+ <head>
235
+ <meta charset="UTF-8">
236
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
237
+ <title>Connection Accepted</title>
238
+ <style>
239
+ @import url('https://fonts.googleapis.com/css2?family=Outfit:wght@400;600;700&family=DM+Mono:wght@400;500&display=swap');
240
+ body {
241
+ margin: 0;
242
+ padding: 0;
243
+ font-family: 'Outfit', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
244
+ background-color: #F9FAFB;
245
+ color: #1F2937;
246
+ }
247
+ .container {
248
+ max-width: 600px;
249
+ margin: 0 auto;
250
+ background-color: #FFFFFF;
251
+ }
252
+ .header {
253
+ background: linear-gradient(135deg, #10B981 0%, #059669 100%);
254
+ padding: 40px 24px;
255
+ text-align: center;
256
+ color: #FFFFFF;
257
+ }
258
+ .content {
259
+ padding: 40px 24px;
260
+ }
261
+ .success-icon {
262
+ font-size: 48px;
263
+ text-align: center;
264
+ margin-bottom: 16px;
265
+ }
266
+ .agent-name {
267
+ font-weight: 600;
268
+ color: #10B981;
269
+ }
270
+ </style>
271
+ </head>
272
+ <body>
273
+ <div class="container">
274
+ <div class="header">
275
+ <div class="logo">${PRIVACY_MASK_SVG}</div>
276
+ <h1>Connection Established</h1>
277
+ </div>
278
+ <div class="content">
279
+ <div class="success-icon">✅</div>
280
+ <p><span class="agent-name">${escapeHtml(data.recipientName)}</span> has accepted your invitation.</p>
281
+ <p>You can now send authenticated messages to:</p>
282
+ <div style="font-family: 'DM Mono', monospace; font-size: 12px; color: #6B7280; padding: 16px; background: #F3F4F6; border-radius: 8px; margin: 16px 0;">
283
+ ${escapeHtml(data.did)}
284
+ </div>
285
+ <p style="margin-top: 24px; padding-top: 24px; border-top: 1px solid #E5E7EB; font-size: 14px; color: #6B7280;">
286
+ APIs have keys. ACIs have identity.
287
+ </p>
288
+ </div>
289
+ </div>
290
+ </body>
291
+ </html>
292
+ `.trim();
293
+ }
294
+ /**
295
+ * Escape HTML special characters to prevent injection.
296
+ *
297
+ * @param text - Text to escape
298
+ * @returns Escaped text
299
+ */
300
+ function escapeHtml(text) {
301
+ const map = {
302
+ '&': '&amp;',
303
+ '<': '&lt;',
304
+ '>': '&gt;',
305
+ '"': '&quot;',
306
+ "'": '&#039;',
307
+ };
308
+ return text.replace(/[&<>"']/g, (char) => map[char] || char);
309
+ }