@private.me/xbind 3.0.2 → 3.0.4

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 (222) hide show
  1. package/README.md +2366 -204
  2. package/dist-standalone/_deps/mldsa-wasm/dist/mldsa.js +1 -1920
  3. package/dist-standalone/_deps/shared/cjs/errors.js +1 -729
  4. package/dist-standalone/_deps/shared/cjs/index.js +1 -463
  5. package/dist-standalone/_deps/shared/cjs/types.js +1 -315
  6. package/dist-standalone/_deps/shared/errors.js +1 -244
  7. package/dist-standalone/_deps/shared/index.js +1 -72
  8. package/dist-standalone/_deps/shared/types.js +1 -86
  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.d.ts +2 -2
  47. package/dist-standalone/agent-call.js +1 -659
  48. package/dist-standalone/agent-sdk.js +1 -328
  49. package/dist-standalone/agent.d.ts +2 -0
  50. package/dist-standalone/agent.js +1 -1800
  51. package/dist-standalone/approval.js +1 -193
  52. package/dist-standalone/async-iterators.d.ts +3 -3
  53. package/dist-standalone/async-iterators.js +1 -382
  54. package/dist-standalone/auth.js +1 -219
  55. package/dist-standalone/auto-accept.js +1 -229
  56. package/dist-standalone/backup-config.js +1 -201
  57. package/dist-standalone/backup.js +1 -326
  58. package/dist-standalone/batch-operations.js +1 -388
  59. package/dist-standalone/cancellation.js +1 -477
  60. package/dist-standalone/checkpoint.js +1 -186
  61. package/dist-standalone/circuit-breaker.js +1 -468
  62. package/dist-standalone/cjs/agent-call.js +1 -701
  63. package/dist-standalone/cjs/agent-sdk.js +1 -332
  64. package/dist-standalone/cjs/agent.js +1 -1837
  65. package/dist-standalone/cjs/approval.js +1 -199
  66. package/dist-standalone/cjs/async-iterators.js +1 -392
  67. package/dist-standalone/cjs/auth.js +1 -225
  68. package/dist-standalone/cjs/auto-accept.js +1 -233
  69. package/dist-standalone/cjs/backup-config.js +1 -207
  70. package/dist-standalone/cjs/backup.js +1 -330
  71. package/dist-standalone/cjs/batch-operations.js +1 -397
  72. package/dist-standalone/cjs/cancellation.js +1 -490
  73. package/dist-standalone/cjs/checkpoint.js +1 -193
  74. package/dist-standalone/cjs/circuit-breaker.js +1 -476
  75. package/dist-standalone/cjs/cli/init.js +1 -492
  76. package/dist-standalone/cjs/config-validation.js +1 -522
  77. package/dist-standalone/cjs/connect.js +1 -312
  78. package/dist-standalone/cjs/connection-pool.js +1 -506
  79. package/dist-standalone/cjs/correlation-id.js +1 -339
  80. package/dist-standalone/cjs/crypto-utils.js +1 -176
  81. package/dist-standalone/cjs/debug-mode.js +1 -534
  82. package/dist-standalone/cjs/did-document.js +1 -101
  83. package/dist-standalone/cjs/did-privateme.js +1 -130
  84. package/dist-standalone/cjs/did-web.js +1 -201
  85. package/dist-standalone/cjs/discovery.js +1 -462
  86. package/dist-standalone/cjs/dual-mode.js +1 -251
  87. package/dist-standalone/cjs/email-templates.js +1 -313
  88. package/dist-standalone/cjs/email-transport.js +1 -239
  89. package/dist-standalone/cjs/envelope.js +1 -538
  90. package/dist-standalone/cjs/errors.js +1 -913
  91. package/dist-standalone/cjs/event-emitter.js +1 -461
  92. package/dist-standalone/cjs/gateway-state.js +1 -55
  93. package/dist-standalone/cjs/gateway-transport.js +1 -120
  94. package/dist-standalone/cjs/graceful-degradation.js +1 -403
  95. package/dist-standalone/cjs/guardrails.js +1 -223
  96. package/dist-standalone/cjs/health-check.js +1 -336
  97. package/dist-standalone/cjs/http-compat.js +1 -272
  98. package/dist-standalone/cjs/http-status-map.js +1 -571
  99. package/dist-standalone/cjs/identity.js +1 -645
  100. package/dist-standalone/cjs/index.js +1 -406
  101. package/dist-standalone/cjs/invitation.js +1 -421
  102. package/dist-standalone/cjs/invite.js +1 -328
  103. package/dist-standalone/cjs/key-agreement.js +1 -335
  104. package/dist-standalone/cjs/lazy-init.js +1 -300
  105. package/dist-standalone/cjs/logger.js +1 -291
  106. package/dist-standalone/cjs/loopback-transport.js +1 -0
  107. package/dist-standalone/cjs/mdns-discovery.js +1 -202
  108. package/dist-standalone/cjs/nonce-store.js +1 -80
  109. package/dist-standalone/cjs/pairing-manager.js +1 -223
  110. package/dist-standalone/cjs/plugin-system.js +1 -264
  111. package/dist-standalone/cjs/plugins/logging.js +1 -168
  112. package/dist-standalone/cjs/plugins/metrics.js +1 -181
  113. package/dist-standalone/cjs/plugins/validation.js +1 -302
  114. package/dist-standalone/cjs/policy.js +1 -320
  115. package/dist-standalone/cjs/progress-callbacks.js +1 -583
  116. package/dist-standalone/cjs/redis-nonce-store.js +1 -76
  117. package/dist-standalone/cjs/registry-middleware.js +1 -50
  118. package/dist-standalone/cjs/retry-strategies.js +1 -544
  119. package/dist-standalone/cjs/retry-transport.js +1 -102
  120. package/dist-standalone/cjs/runtime/browser.js +1 -533
  121. package/dist-standalone/cjs/runtime/edge.js +1 -526
  122. package/dist-standalone/cjs/runtime/react-native.js +1 -394
  123. package/dist-standalone/cjs/security-policy.js +1 -245
  124. package/dist-standalone/cjs/serialization.js +1 -1040
  125. package/dist-standalone/cjs/split-channel.js +1 -225
  126. package/dist-standalone/cjs/subscription-proof.js +1 -230
  127. package/dist-standalone/cjs/succession.js +1 -148
  128. package/dist-standalone/cjs/timeouts.js +1 -412
  129. package/dist-standalone/cjs/trace-context.js +1 -424
  130. package/dist-standalone/cjs/trace-spans.js +1 -495
  131. package/dist-standalone/cjs/transport.js +1 -63
  132. package/dist-standalone/cjs/trust-registry.js +1 -991
  133. package/dist-standalone/cjs/types/error-response.js +1 -56
  134. package/dist-standalone/cjs/vault-auth.js +1 -178
  135. package/dist-standalone/cjs/vault-store-loader.js +1 -194
  136. package/dist-standalone/cjs/verify.js +1 -25
  137. package/dist-standalone/cjs/version-info.js +1 -543
  138. package/dist-standalone/cjs/xfetch.js +1 -340
  139. package/dist-standalone/cli/init.js +1 -455
  140. package/dist-standalone/cli/setup.js +1 -514
  141. package/dist-standalone/cli/types.js +1 -27
  142. package/dist-standalone/cli/xbind.js +1 -148
  143. package/dist-standalone/config-validation.js +1 -513
  144. package/dist-standalone/connect.js +1 -274
  145. package/dist-standalone/connection-pool.js +1 -500
  146. package/dist-standalone/correlation-id.js +1 -326
  147. package/dist-standalone/crypto-utils.d.ts +2 -7
  148. package/dist-standalone/crypto-utils.js +1 -157
  149. package/dist-standalone/debug-mode.js +1 -510
  150. package/dist-standalone/did-document.js +1 -96
  151. package/dist-standalone/did-privateme.js +1 -121
  152. package/dist-standalone/did-web.js +1 -196
  153. package/dist-standalone/discovery.js +1 -458
  154. package/dist-standalone/dual-mode.js +1 -247
  155. package/dist-standalone/email-templates.js +1 -309
  156. package/dist-standalone/email-transport.d.ts +2 -2
  157. package/dist-standalone/email-transport.js +1 -232
  158. package/dist-standalone/envelope.js +1 -525
  159. package/dist-standalone/errors.d.ts +13 -3
  160. package/dist-standalone/errors.js +1 -896
  161. package/dist-standalone/event-emitter.js +1 -456
  162. package/dist-standalone/gateway-state.d.ts +1 -1
  163. package/dist-standalone/gateway-state.js +1 -51
  164. package/dist-standalone/gateway-transport.js +1 -116
  165. package/dist-standalone/graceful-degradation.js +1 -396
  166. package/dist-standalone/guardrails.js +1 -216
  167. package/dist-standalone/health-check.d.ts +5 -1
  168. package/dist-standalone/health-check.js +1 -332
  169. package/dist-standalone/http-compat.d.ts +1 -1
  170. package/dist-standalone/http-compat.js +1 -267
  171. package/dist-standalone/http-status-map.js +1 -561
  172. package/dist-standalone/identity.js +1 -619
  173. package/dist-standalone/index.d.ts +15 -4
  174. package/dist-standalone/index.js +1 -78
  175. package/dist-standalone/invitation.js +1 -415
  176. package/dist-standalone/invite.js +1 -324
  177. package/dist-standalone/key-agreement.js +1 -325
  178. package/dist-standalone/lazy-init.d.ts +11 -6
  179. package/dist-standalone/lazy-init.js +1 -295
  180. package/dist-standalone/logger.js +1 -285
  181. package/dist-standalone/loopback-transport.d.ts +87 -0
  182. package/dist-standalone/loopback-transport.js +1 -0
  183. package/dist-standalone/mdns-discovery.js +1 -195
  184. package/dist-standalone/nonce-store.js +1 -76
  185. package/dist-standalone/pairing-manager.js +1 -219
  186. package/dist-standalone/plugin-system.js +1 -257
  187. package/dist-standalone/plugins/logging.js +1 -163
  188. package/dist-standalone/plugins/metrics.d.ts +4 -4
  189. package/dist-standalone/plugins/metrics.js +1 -176
  190. package/dist-standalone/plugins/validation.js +1 -297
  191. package/dist-standalone/policy.js +1 -315
  192. package/dist-standalone/progress-callbacks.js +1 -576
  193. package/dist-standalone/redis-nonce-store.js +1 -72
  194. package/dist-standalone/registry-middleware.js +1 -47
  195. package/dist-standalone/retry-strategies.js +1 -534
  196. package/dist-standalone/retry-transport.js +1 -98
  197. package/dist-standalone/runtime/browser.js +1 -516
  198. package/dist-standalone/runtime/edge.js +1 -511
  199. package/dist-standalone/runtime/react-native.d.ts +1 -1
  200. package/dist-standalone/runtime/react-native.js +1 -383
  201. package/dist-standalone/security-policy.js +1 -239
  202. package/dist-standalone/serialization.js +1 -1031
  203. package/dist-standalone/split-channel.d.ts +1 -1
  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.d.ts +1 -1
  211. package/dist-standalone/transport.js +1 -59
  212. package/dist-standalone/trust-registry.d.ts +3 -3
  213. package/dist-standalone/trust-registry.js +1 -950
  214. package/dist-standalone/types/error-response.js +1 -52
  215. package/dist-standalone/vault-auth.js +1 -174
  216. package/dist-standalone/vault-store-loader.d.ts +9 -0
  217. package/dist-standalone/vault-store-loader.js +1 -187
  218. package/dist-standalone/verify.js +1 -16
  219. package/dist-standalone/version-info.js +1 -530
  220. package/dist-standalone/xfetch.js +1 -335
  221. package/package.json +1 -1
  222. package/share1.dat +0 -0
@@ -1,515 +1,2 @@
1
1
  #!/usr/bin/env node
2
- /* eslint-disable no-console */
3
- /**
4
- * @module cli/setup
5
- * xBind setup command - creates deployment identity.
6
- *
7
- * Flow:
8
- * 1. Check if identity exists (~/.xbind/identity.json)
9
- * 2. Prompt for service name and email
10
- * 3. Generate DID (did:key format, Ed25519)
11
- * 4. Generate DeploymentID (DEP-YYYYMM-XXXXXXXXXX)
12
- * 5. Create account on server (POST /auth/signup)
13
- * 6. Send email verification code (6-digit)
14
- * 7. Prompt user to enter code
15
- * 8. Verify code on server
16
- * 9. Store identity locally
17
- * 10. Display success message
18
- *
19
- * @example
20
- * ```bash
21
- * npx xbind setup --name my-service
22
- * # → Prompts for email
23
- * # → Generates DID + DeploymentID
24
- * # → Creates server account
25
- * # → Sends verification email
26
- * # → Prompts for 6-digit code
27
- * # → Saves to ~/.xbind/identity.json
28
- * ```
29
- */
30
- import { parseArgs } from 'node:util';
31
- import * as fs from 'node:fs';
32
- import * as path from 'node:path';
33
- import * as os from 'node:os';
34
- import * as readline from 'node:readline/promises';
35
- import { stdin as input, stdout as output } from 'node:process';
36
- import { randomBytes } from 'node:crypto';
37
- import { ExitCode, Colors } from './types.js';
38
- /**
39
- * Get identity storage path.
40
- */
41
- function getIdentityPath() {
42
- return path.join(os.homedir(), '.xbind', 'identity.json');
43
- }
44
- /**
45
- * Ensure .xbind directory exists.
46
- */
47
- async function ensureXBindDir() {
48
- const xbindDir = path.join(os.homedir(), '.xbind');
49
- try {
50
- await fs.promises.mkdir(xbindDir, { recursive: true, mode: 0o700 });
51
- }
52
- catch (error) {
53
- const err = error;
54
- throw new Error(`Cannot create .xbind directory: ${err.message}`);
55
- }
56
- }
57
- /**
58
- * Check if identity exists.
59
- */
60
- async function identityExists() {
61
- try {
62
- await fs.promises.access(getIdentityPath(), fs.constants.F_OK);
63
- return true;
64
- }
65
- catch {
66
- return false;
67
- }
68
- }
69
- /**
70
- * Read existing identity.
71
- */
72
- async function readIdentity() {
73
- try {
74
- const data = await fs.promises.readFile(getIdentityPath(), 'utf-8');
75
- return JSON.parse(data);
76
- }
77
- catch {
78
- return null;
79
- }
80
- }
81
- /**
82
- * Write identity to disk.
83
- */
84
- async function writeIdentity(identity) {
85
- await ensureXBindDir();
86
- await fs.promises.writeFile(getIdentityPath(), JSON.stringify(identity, null, 2), { mode: 0o600 });
87
- }
88
- /**
89
- * Spinner for progress indication.
90
- */
91
- class Spinner {
92
- frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
93
- currentFrame = 0;
94
- intervalId;
95
- message;
96
- useColors;
97
- constructor(message, useColors = true) {
98
- this.message = message;
99
- this.useColors = useColors && process.stdout.isTTY;
100
- }
101
- start() {
102
- this.intervalId = setInterval(() => {
103
- const frame = this.frames[this.currentFrame];
104
- process.stdout.write(`\r${frame} ${this.message}`);
105
- this.currentFrame = (this.currentFrame + 1) % this.frames.length;
106
- }, 80);
107
- }
108
- succeed(message) {
109
- this.stop();
110
- const check = this.useColors ? `${Colors.GREEN}✅${Colors.RESET}` : '✅';
111
- process.stdout.write(`\r${check} ${message ?? this.message}\n`);
112
- }
113
- fail(message) {
114
- this.stop();
115
- const cross = this.useColors ? `${Colors.RED}❌${Colors.RESET}` : '❌';
116
- process.stdout.write(`\r${cross} ${message ?? this.message}\n`);
117
- }
118
- stop() {
119
- if (this.intervalId) {
120
- clearInterval(this.intervalId);
121
- this.intervalId = undefined;
122
- }
123
- }
124
- }
125
- /**
126
- * Prompt user for input.
127
- */
128
- async function prompt(question, defaultValue) {
129
- const rl = readline.createInterface({ input, output });
130
- const answer = await rl.question(defaultValue ? `${question} (${defaultValue}): ` : `${question}: `);
131
- rl.close();
132
- return answer.trim() || defaultValue || '';
133
- }
134
- /**
135
- * Validate email format.
136
- */
137
- function isValidEmail(email) {
138
- return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email);
139
- }
140
- /**
141
- * Validate service name.
142
- */
143
- function isValidServiceName(name) {
144
- return /^[a-zA-Z][a-zA-Z0-9-]{2,63}$/.test(name);
145
- }
146
- /**
147
- * Generate DID (did:key format with Ed25519).
148
- * Uses xBind identity module's generateIdentity.
149
- */
150
- async function generateDID() {
151
- // Import identity module
152
- const { generateIdentity } = await import('../identity.js');
153
- const identityResult = await generateIdentity();
154
- if (!identityResult.ok) {
155
- throw new Error('Failed to generate identity');
156
- }
157
- const identity = identityResult.value;
158
- // Export keys to raw bytes then convert to base64 for storage
159
- const publicKeyRaw = new Uint8Array(await crypto.subtle.exportKey('raw', identity.publicKey));
160
- const privateKeyJwk = await crypto.subtle.exportKey('jwk', identity.privateKey);
161
- // For Ed25519, the private key in JWK format contains 'd' which is the 32-byte seed
162
- if (!privateKeyJwk.d) {
163
- throw new Error('Failed to export private key');
164
- }
165
- const publicKeyBase64 = Buffer.from(publicKeyRaw).toString('base64');
166
- const privateKeyBase64 = privateKeyJwk.d; // Already base64url encoded
167
- return {
168
- did: identity.did,
169
- publicKey: publicKeyBase64,
170
- privateKey: privateKeyBase64,
171
- };
172
- }
173
- /**
174
- * Generate DeploymentID (DEP-YYYYMM-XXXXXXXXXX format).
175
- */
176
- function generateDeploymentID() {
177
- const now = new Date();
178
- const year = now.getUTCFullYear();
179
- const month = String(now.getUTCMonth() + 1).padStart(2, '0');
180
- // 10 hex digits for collision resistance (40 bits entropy)
181
- const randomHex = randomBytes(5).toString('hex').toUpperCase();
182
- return `DEP-${year}${month}-${randomHex}`;
183
- }
184
- /**
185
- * Create account on server.
186
- */
187
- async function createServerAccount(did, deploymentId, email, apiUrl) {
188
- const url = `${apiUrl}/auth/signup`;
189
- try {
190
- const response = await fetch(url, {
191
- method: 'POST',
192
- headers: { 'Content-Type': 'application/json' },
193
- body: JSON.stringify({ did, deploymentId, email, method: 'code' }),
194
- });
195
- if (!response.ok) {
196
- const error = await response.json().catch(() => ({
197
- code: 'UNKNOWN',
198
- message: `Server returned ${response.status}`,
199
- }));
200
- return { success: false, error };
201
- }
202
- const data = await response.json();
203
- return { success: true, account: data.account };
204
- }
205
- catch (error) {
206
- return {
207
- success: false,
208
- error: {
209
- code: 'NETWORK_ERROR',
210
- message: error instanceof Error ? error.message : 'Network request failed',
211
- hint: 'Check that the server is running and accessible',
212
- },
213
- };
214
- }
215
- }
216
- /**
217
- * Send email verification code.
218
- */
219
- async function sendVerificationCode(email, apiUrl) {
220
- const url = `${apiUrl}/auth/send-verification-code`;
221
- try {
222
- const response = await fetch(url, {
223
- method: 'POST',
224
- headers: { 'Content-Type': 'application/json' },
225
- body: JSON.stringify({ email }),
226
- });
227
- if (!response.ok) {
228
- const error = await response.json().catch(() => ({ message: `HTTP ${response.status}` }));
229
- return { success: false, error: error.message };
230
- }
231
- return { success: true };
232
- }
233
- catch (error) {
234
- return {
235
- success: false,
236
- error: error instanceof Error ? error.message : 'Network error',
237
- };
238
- }
239
- }
240
- /**
241
- * Verify email code on server.
242
- */
243
- async function verifyEmailCode(email, code, apiUrl) {
244
- const url = `${apiUrl}/auth/verify-email-code`;
245
- try {
246
- const response = await fetch(url, {
247
- method: 'POST',
248
- headers: { 'Content-Type': 'application/json' },
249
- body: JSON.stringify({ email, code }),
250
- });
251
- if (!response.ok) {
252
- const error = await response.json().catch(() => ({ message: `HTTP ${response.status}` }));
253
- return { success: false, error: error.message };
254
- }
255
- return { success: true };
256
- }
257
- catch (error) {
258
- return {
259
- success: false,
260
- error: error instanceof Error ? error.message : 'Network error',
261
- };
262
- }
263
- }
264
- /**
265
- * Output success message (human-readable).
266
- */
267
- function outputSuccess(identity, useColors) {
268
- const green = useColors ? Colors.GREEN : '';
269
- const gray = useColors ? Colors.GRAY : '';
270
- const blue = useColors ? Colors.BLUE : '';
271
- const reset = useColors ? Colors.RESET : '';
272
- console.log(`${green}✅ Identity created successfully${reset}\n`);
273
- console.log(`Service Name: ${identity.name}`);
274
- console.log(`DID: ${green}${identity.did}${reset}`);
275
- console.log(`DeploymentID: ${identity.deploymentId}`);
276
- console.log(`Email: ${identity.email} ${identity.emailVerified ? green + '(verified)' + reset : gray + '(unverified)' + reset}`);
277
- console.log(`Storage: ${gray}${getIdentityPath()}${reset}\n`);
278
- console.log(`${blue}ℹ️ Next steps:${reset}`);
279
- console.log(` 1. Connect to a service: xbind connect <service-name>`);
280
- console.log(` 2. Generate an invite: xbind invite <service-name>`);
281
- console.log(` 3. Check connection status: xbind status`);
282
- }
283
- /**
284
- * Output success message (JSON).
285
- */
286
- function outputSuccessJSON(identity) {
287
- console.log(JSON.stringify({
288
- status: 'initialized',
289
- did: identity.did,
290
- deploymentId: identity.deploymentId,
291
- name: identity.name,
292
- email: identity.email,
293
- emailVerified: identity.emailVerified,
294
- storagePath: getIdentityPath(),
295
- createdAt: identity.createdAt,
296
- }));
297
- }
298
- /**
299
- * Output error message.
300
- */
301
- function outputError(message, details, hint, useColors = true) {
302
- const red = useColors ? Colors.RED : '';
303
- const gray = useColors ? Colors.GRAY : '';
304
- const blue = useColors ? Colors.BLUE : '';
305
- const reset = useColors ? Colors.RESET : '';
306
- console.error(`${red}❌ Error: ${message}${reset}`);
307
- if (details) {
308
- console.error(`\n${details}`);
309
- }
310
- if (hint) {
311
- console.error(`\n${blue}ℹ️ ${hint}${reset}`);
312
- }
313
- }
314
- /**
315
- * Main setup command.
316
- */
317
- export async function setupCommand(options = {}) {
318
- const useColors = !options['no-color'] && process.stdout.isTTY;
319
- const apiUrl = options['api-url'] || process.env.XBIND_API_URL || 'http://localhost:3001';
320
- // Step 1: Check if identity exists
321
- if (!options.force && (await identityExists())) {
322
- const existing = await readIdentity();
323
- outputError('Identity already exists', `An xBind identity is already configured for this device.\n\nStorage: ${getIdentityPath()}\nDID: ${existing?.did || 'unknown'}`, 'To create a new identity, use:\n xbind setup --force', useColors);
324
- process.exit(ExitCode.USER_ERROR);
325
- }
326
- // Step 2: Prompt for service name
327
- let serviceName = options.name;
328
- if (!serviceName) {
329
- const defaultName = `xbind-${Date.now()}`;
330
- serviceName = await prompt('Service name', defaultName);
331
- }
332
- if (!isValidServiceName(serviceName)) {
333
- outputError('Invalid service name', `Service names must:\n • Start with a letter\n • Contain only letters, numbers, hyphens\n • Be 3-64 characters long\n\nExample: billing-service, api-v2, payments-prod`, undefined, useColors);
334
- process.exit(ExitCode.USER_ERROR);
335
- }
336
- // Step 3: Prompt for email
337
- let email = options.email;
338
- if (!email) {
339
- email = await prompt('Email address');
340
- }
341
- if (!isValidEmail(email)) {
342
- outputError('Invalid email format', 'Email must be a valid email address.\n\nExample: user@example.com', undefined, useColors);
343
- process.exit(ExitCode.USER_ERROR);
344
- }
345
- // Step 4: Generate DID
346
- const spinner1 = new Spinner('Generating DID...', useColors);
347
- if (!options.json)
348
- spinner1.start();
349
- let didInfo;
350
- try {
351
- didInfo = await generateDID();
352
- if (!options.json)
353
- spinner1.succeed('DID generated');
354
- }
355
- catch (error) {
356
- if (!options.json)
357
- spinner1.fail('Failed to generate DID');
358
- outputError('DID generation failed', error instanceof Error ? error.message : 'Unknown error', 'Ensure crypto dependencies are installed', useColors);
359
- process.exit(ExitCode.SYSTEM_ERROR);
360
- }
361
- // Step 5: Generate DeploymentID
362
- const deploymentId = generateDeploymentID();
363
- // Step 6: Create server account
364
- const spinner2 = new Spinner('Creating account on server...', useColors);
365
- if (!options.json)
366
- spinner2.start();
367
- const accountResult = await createServerAccount(didInfo.did, deploymentId, email, apiUrl);
368
- if (!accountResult.success) {
369
- if (!options.json)
370
- spinner2.fail('Failed to create account');
371
- outputError(accountResult.error?.code || 'Account creation failed', accountResult.error?.message, accountResult.error?.hint || `Check server at ${apiUrl}`, useColors);
372
- process.exit(ExitCode.SYSTEM_ERROR);
373
- }
374
- if (!options.json)
375
- spinner2.succeed('Account created on server');
376
- // Step 7: Send verification email
377
- const spinner3 = new Spinner('Sending verification email...', useColors);
378
- if (!options.json)
379
- spinner3.start();
380
- const sendResult = await sendVerificationCode(email, apiUrl);
381
- if (!sendResult.success) {
382
- if (!options.json)
383
- spinner3.fail('Failed to send verification email');
384
- outputError('Email verification failed', sendResult.error, 'You can verify later using: xbind verify-email', useColors);
385
- // Continue anyway - email verification not required for basic setup
386
- }
387
- else {
388
- if (!options.json)
389
- spinner3.succeed('Verification email sent');
390
- // Step 8: Prompt for verification code
391
- if (!options.json) {
392
- const cyan = useColors ? Colors.CYAN : '';
393
- const reset = useColors ? Colors.RESET : '';
394
- console.log(`\n${cyan}→ Check your email for a 6-digit verification code${reset}`);
395
- }
396
- const code = await prompt('Enter verification code (or press Enter to skip)');
397
- if (code) {
398
- const spinner4 = new Spinner('Verifying code...', useColors);
399
- if (!options.json)
400
- spinner4.start();
401
- const verifyResult = await verifyEmailCode(email, code, apiUrl);
402
- if (!verifyResult.success) {
403
- if (!options.json)
404
- spinner4.fail('Verification failed');
405
- outputError('Invalid verification code', verifyResult.error, 'You can verify later using: xbind verify-email', useColors);
406
- // Continue anyway - save identity with emailVerified: false
407
- }
408
- else {
409
- if (!options.json)
410
- spinner4.succeed('Email verified');
411
- }
412
- }
413
- }
414
- // Step 9: Save identity locally
415
- const identity = {
416
- did: didInfo.did,
417
- deploymentId,
418
- name: serviceName,
419
- email,
420
- emailVerified: accountResult.account?.emailVerified || false,
421
- publicKey: didInfo.publicKey,
422
- privateKey: didInfo.privateKey,
423
- createdAt: new Date().toISOString(),
424
- updatedAt: new Date().toISOString(),
425
- };
426
- try {
427
- await writeIdentity(identity);
428
- }
429
- catch (error) {
430
- outputError('Failed to save identity', error instanceof Error ? error.message : 'Unknown error', `Check permissions on ${getIdentityPath()}`, useColors);
431
- process.exit(ExitCode.SYSTEM_ERROR);
432
- }
433
- // Step 10: Output success
434
- if (options.json) {
435
- outputSuccessJSON(identity);
436
- }
437
- else {
438
- console.log(''); // blank line
439
- outputSuccess(identity, useColors);
440
- }
441
- }
442
- /**
443
- * CLI entry point.
444
- */
445
- export async function main(argv = process.argv.slice(2)) {
446
- const { values } = parseArgs({
447
- args: argv,
448
- options: {
449
- name: { type: 'string', short: 'n' },
450
- email: { type: 'string', short: 'e' },
451
- pair: { type: 'boolean', short: 'p' },
452
- force: { type: 'boolean', short: 'f' },
453
- 'api-url': { type: 'string' },
454
- json: { type: 'boolean' },
455
- 'no-color': { type: 'boolean' },
456
- debug: { type: 'boolean' },
457
- help: { type: 'boolean', short: 'h' },
458
- },
459
- });
460
- if (values.help) {
461
- console.log(`
462
- xBind Setup - Create Deployment Identity
463
-
464
- Usage:
465
- xbind setup [options]
466
-
467
- Options:
468
- -n, --name <string> Service name (default: xbind-<timestamp>)
469
- -e, --email <email> Email address for account
470
- -p, --pair Display QR code for mobile pairing
471
- -f, --force Overwrite existing identity
472
- --api-url <url> Server API URL (default: http://localhost:3001)
473
- --json Output JSON only (no human-readable text)
474
- --no-color Disable colored output
475
- --debug Show detailed error information
476
- -h, --help Show this help message
477
-
478
- Examples:
479
- xbind setup --name billing-service
480
- xbind setup --name my-app --email user@example.com
481
- xbind setup --force
482
- `.trim());
483
- return;
484
- }
485
- try {
486
- await setupCommand({
487
- name: values.name,
488
- email: values.email,
489
- pair: values.pair,
490
- force: values.force,
491
- 'api-url': values['api-url'],
492
- json: values.json,
493
- 'no-color': values['no-color'],
494
- debug: values.debug,
495
- });
496
- }
497
- catch (error) {
498
- const useColors = !values['no-color'] && process.stderr.isTTY;
499
- const red = useColors ? Colors.RED : '';
500
- const reset = useColors ? Colors.RESET : '';
501
- console.error(`${red}❌ Fatal error: ${error instanceof Error ? error.message : String(error)}${reset}`);
502
- if (values.debug && error instanceof Error && error.stack) {
503
- console.error(error.stack);
504
- }
505
- process.exit(ExitCode.SYSTEM_ERROR);
506
- }
507
- }
508
- // Auto-run if executed directly
509
- const isDirectRun = process.argv[1]?.endsWith('setup.ts') || process.argv[1]?.endsWith('setup.js');
510
- if (isDirectRun) {
511
- main().catch((error) => {
512
- console.error('Fatal:', error instanceof Error ? error.message : String(error));
513
- process.exitCode = ExitCode.SYSTEM_ERROR;
514
- });
515
- }
2
+ import{parseArgs}from"node:util";import*as fs from"node:fs";import*as path from"node:path";import*as os from"node:os";import*as readline from"node:readline/promises";import{stdin as input,stdout as output}from"node:process";import{randomBytes}from"node:crypto";import{ExitCode,Colors}from"./types.js";function getIdentityPath(){return path.join(os.homedir(),".xbind","identity.json")}async function ensureXBindDir(){const e=path.join(os.homedir(),".xbind");try{await fs.promises.mkdir(e,{recursive:!0,mode:448})}catch(e){throw new Error(`Cannot create .xbind directory: ${e.message}`)}}async function identityExists(){try{return await fs.promises.access(getIdentityPath(),fs.constants.F_OK),!0}catch{return!1}}async function readIdentity(){try{const e=await fs.promises.readFile(getIdentityPath(),"utf-8");return JSON.parse(e)}catch{return null}}async function writeIdentity(e){await ensureXBindDir(),await fs.promises.writeFile(getIdentityPath(),JSON.stringify(e,null,2),{mode:384})}class Spinner{frames=["⠋","⠙","⠹","⠸","⠼","⠴","⠦","⠧","⠇","⠏"];currentFrame=0;intervalId;message;useColors;constructor(e,t=!0){this.message=e,this.useColors=t&&process.stdout.isTTY}start(){this.intervalId=setInterval(()=>{const e=this.frames[this.currentFrame];process.stdout.write(`\r${e} ${this.message}`),this.currentFrame=(this.currentFrame+1)%this.frames.length},80)}succeed(e){this.stop();const t=this.useColors?`${Colors.GREEN}✅${Colors.RESET}`:"✅";process.stdout.write(`\r${t} ${e??this.message}\n`)}fail(e){this.stop();const t=this.useColors?`${Colors.RED}❌${Colors.RESET}`:"❌";process.stdout.write(`\r${t} ${e??this.message}\n`)}stop(){this.intervalId&&(clearInterval(this.intervalId),this.intervalId=void 0)}}async function prompt(e,t){const o=readline.createInterface({input:input,output:output}),r=await o.question(t?`${e} (${t}): `:`${e}: `);return o.close(),r.trim()||t||""}function isValidEmail(e){return/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e)}function isValidServiceName(e){return/^[a-zA-Z][a-zA-Z0-9-]{2,63}$/.test(e)}async function generateDID(){const{generateIdentity:e}=await import("../identity.js"),t=await e();if(!t.ok)throw new Error("Failed to generate identity");const o=t.value,r=new Uint8Array(await crypto.subtle.exportKey("raw",o.publicKey)),n=await crypto.subtle.exportKey("jwk",o.privateKey);if(!n.d)throw new Error("Failed to export private key");const s=Buffer.from(r).toString("base64"),i=n.d;return{did:o.did,publicKey:s,privateKey:i}}function generateDeploymentID(){const e=new Date;return`DEP-${e.getUTCFullYear()}${String(e.getUTCMonth()+1).padStart(2,"0")}-${randomBytes(5).toString("hex").toUpperCase()}`}async function createServerAccount(e,t,o,r){const n=`${r}/auth/signup`;try{const r=await fetch(n,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({did:e,deploymentId:t,email:o,method:"code"})});if(!r.ok){return{success:!1,error:await r.json().catch(()=>({code:"UNKNOWN",message:`Server returned ${r.status}`}))}}return{success:!0,account:(await r.json()).account}}catch(e){return{success:!1,error:{code:"NETWORK_ERROR",message:e instanceof Error?e.message:"Network request failed",hint:"Check that the server is running and accessible"}}}}async function sendVerificationCode(e,t){const o=`${t}/auth/send-verification-code`;try{const t=await fetch(o,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({email:e})});if(!t.ok){return{success:!1,error:(await t.json().catch(()=>({message:`HTTP ${t.status}`}))).message}}return{success:!0}}catch(e){return{success:!1,error:e instanceof Error?e.message:"Network error"}}}async function verifyEmailCode(e,t,o){const r=`${o}/auth/verify-email-code`;try{const o=await fetch(r,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({email:e,code:t})});if(!o.ok){return{success:!1,error:(await o.json().catch(()=>({message:`HTTP ${o.status}`}))).message}}return{success:!0}}catch(e){return{success:!1,error:e instanceof Error?e.message:"Network error"}}}function outputSuccess(e,t){const o=t?Colors.GREEN:"",r=t?Colors.GRAY:"",n=t?Colors.BLUE:"",s=t?Colors.RESET:"";console.log(`${o}✅ Identity created successfully${s}\n`),console.log(`Service Name: ${e.name}`),console.log(`DID: ${o}${e.did}${s}`),console.log(`DeploymentID: ${e.deploymentId}`),console.log(`Email: ${e.email} ${e.emailVerified?o+"(verified)"+s:r+"(unverified)"+s}`),console.log(`Storage: ${r}${getIdentityPath()}${s}\n`),console.log(`${n}ℹ️ Next steps:${s}`),console.log(" 1. Connect to a service: xbind connect <service-name>"),console.log(" 2. Generate an invite: xbind invite <service-name>"),console.log(" 3. Check connection status: xbind status")}function outputSuccessJSON(e){console.log(JSON.stringify({status:"initialized",did:e.did,deploymentId:e.deploymentId,name:e.name,email:e.email,emailVerified:e.emailVerified,storagePath:getIdentityPath(),createdAt:e.createdAt}))}function outputError(e,t,o,r=!0){const n=r?Colors.RED:"",s=r?Colors.BLUE:"",i=r?Colors.RESET:"";console.error(`${n}❌ Error: ${e}${i}`),t&&console.error(`\n${t}`),o&&console.error(`\n${s}ℹ️ ${o}${i}`)}export async function setupCommand(e={}){const t=!e["no-color"]&&process.stdout.isTTY,o=e["api-url"]||process.env.XBIND_API_URL||"http://localhost:3001";if(!e.force&&await identityExists()){const e=await readIdentity();outputError("Identity already exists",`An xBind identity is already configured for this device.\n\nStorage: ${getIdentityPath()}\nDID: ${e?.did||"unknown"}`,"To create a new identity, use:\n xbind setup --force",t),process.exit(ExitCode.USER_ERROR)}let r=e.name;if(!r){const e=`xbind-${Date.now()}`;r=await prompt("Service name",e)}isValidServiceName(r)||(outputError("Invalid service name","Service names must:\n • Start with a letter\n • Contain only letters, numbers, hyphens\n • Be 3-64 characters long\n\nExample: billing-service, api-v2, payments-prod",void 0,t),process.exit(ExitCode.USER_ERROR));let n=e.email;n||(n=await prompt("Email address")),isValidEmail(n)||(outputError("Invalid email format","Email must be a valid email address.\n\nExample: user@example.com",void 0,t),process.exit(ExitCode.USER_ERROR));const s=new Spinner("Generating DID...",t);let i;e.json||s.start();try{i=await generateDID(),e.json||s.succeed("DID generated")}catch(o){e.json||s.fail("Failed to generate DID"),outputError("DID generation failed",o instanceof Error?o.message:"Unknown error","Ensure crypto dependencies are installed",t),process.exit(ExitCode.SYSTEM_ERROR)}const a=generateDeploymentID(),c=new Spinner("Creating account on server...",t);e.json||c.start();const d=await createServerAccount(i.did,a,n,o);d.success||(e.json||c.fail("Failed to create account"),outputError(d.error?.code||"Account creation failed",d.error?.message,d.error?.hint||`Check server at ${o}`,t),process.exit(ExitCode.SYSTEM_ERROR)),e.json||c.succeed("Account created on server");const l=new Spinner("Sending verification email...",t);e.json||l.start();const u=await sendVerificationCode(n,o);if(u.success){if(e.json||l.succeed("Verification email sent"),!e.json){const e=t?Colors.CYAN:"",o=t?Colors.RESET:"";console.log(`\n${e}→ Check your email for a 6-digit verification code${o}`)}const r=await prompt("Enter verification code (or press Enter to skip)");if(r){const s=new Spinner("Verifying code...",t);e.json||s.start();const i=await verifyEmailCode(n,r,o);i.success?e.json||s.succeed("Email verified"):(e.json||s.fail("Verification failed"),outputError("Invalid verification code",i.error,"You can verify later using: xbind verify-email",t))}}else e.json||l.fail("Failed to send verification email"),outputError("Email verification failed",u.error,"You can verify later using: xbind verify-email",t);const p={did:i.did,deploymentId:a,name:r,email:n,emailVerified:d.account?.emailVerified||!1,publicKey:i.publicKey,privateKey:i.privateKey,createdAt:(new Date).toISOString(),updatedAt:(new Date).toISOString()};try{await writeIdentity(p)}catch(e){outputError("Failed to save identity",e instanceof Error?e.message:"Unknown error",`Check permissions on ${getIdentityPath()}`,t),process.exit(ExitCode.SYSTEM_ERROR)}e.json?outputSuccessJSON(p):(console.log(""),outputSuccess(p,t))}export async function main(e=process.argv.slice(2)){const{values:t}=parseArgs({args:e,options:{name:{type:"string",short:"n"},email:{type:"string",short:"e"},pair:{type:"boolean",short:"p"},force:{type:"boolean",short:"f"},"api-url":{type:"string"},json:{type:"boolean"},"no-color":{type:"boolean"},debug:{type:"boolean"},help:{type:"boolean",short:"h"}}});if(t.help)console.log("\nxBind Setup - Create Deployment Identity\n\nUsage:\n xbind setup [options]\n\nOptions:\n -n, --name <string> Service name (default: xbind-<timestamp>)\n -e, --email <email> Email address for account\n -p, --pair Display QR code for mobile pairing\n -f, --force Overwrite existing identity\n --api-url <url> Server API URL (default: http://localhost:3001)\n --json Output JSON only (no human-readable text)\n --no-color Disable colored output\n --debug Show detailed error information\n -h, --help Show this help message\n\nExamples:\n xbind setup --name billing-service\n xbind setup --name my-app --email user@example.com\n xbind setup --force\n ".trim());else try{await setupCommand({name:t.name,email:t.email,pair:t.pair,force:t.force,"api-url":t["api-url"],json:t.json,"no-color":t["no-color"],debug:t.debug})}catch(e){const o=!t["no-color"]&&process.stderr.isTTY,r=o?Colors.RED:"",n=o?Colors.RESET:"";console.error(`${r}❌ Fatal error: ${e instanceof Error?e.message:String(e)}${n}`),t.debug&&e instanceof Error&&e.stack&&console.error(e.stack),process.exit(ExitCode.SYSTEM_ERROR)}}const isDirectRun=process.argv[1]?.endsWith("setup.ts")||process.argv[1]?.endsWith("setup.js");isDirectRun&&main().catch(e=>{console.error("Fatal:",e instanceof Error?e.message:String(e)),process.exitCode=ExitCode.SYSTEM_ERROR});
@@ -1,27 +1 @@
1
- /**
2
- * @module cli/types
3
- * Shared types for xBind CLI commands.
4
- */
5
- /**
6
- * Exit codes for CLI commands.
7
- */
8
- export const ExitCode = {
9
- SUCCESS: 0,
10
- USER_ERROR: 1,
11
- SYSTEM_ERROR: 2,
12
- AUTH_ERROR: 3,
13
- BILLING_ERROR: 4,
14
- USER_CANCELED: 130,
15
- };
16
- /**
17
- * ANSI color codes (only used if TTY detected).
18
- */
19
- export const Colors = {
20
- RED: '\x1b[31m',
21
- GREEN: '\x1b[32m',
22
- YELLOW: '\x1b[33m',
23
- BLUE: '\x1b[34m',
24
- CYAN: '\x1b[36m',
25
- GRAY: '\x1b[90m',
26
- RESET: '\x1b[0m',
27
- };
1
+ export const ExitCode={SUCCESS:0,USER_ERROR:1,SYSTEM_ERROR:2,AUTH_ERROR:3,BILLING_ERROR:4,USER_CANCELED:130};export const Colors={RED:"",GREEN:"",YELLOW:"",BLUE:"",CYAN:"",GRAY:"",RESET:""};