@private.me/xbind 3.0.1 → 3.0.2

package/dist-standalone/cli/init.js

@@ -1,2 +1,456 @@
 #!/usr/bin/env node
-import{parseArgs}from"node:util";import*as fs from"node:fs";import*as path from"node:path";import{spawn}from"node:child_process";import*as readline from"node:readline/promises";import{stdin as input,stdout as output}from"node:process";import{InviteService}from"../invite.js";function getTemplateDir(){let e=__dirname;for(;"/"!==e;){if(fs.existsSync(path.join(e,"package.json")))return path.join(e,"templates");e=path.dirname(e)}return path.join(__dirname,"../../templates")}const TEMPLATES={"node-typescript":{name:"Node.js + TypeScript",description:"Node.js with TypeScript, best for backend services",packageManager:"npm",entryPoint:"src/index.ts",startCommand:"npm run dev"},"node-javascript":{name:"Node.js + JavaScript",description:"Node.js with JavaScript, minimal setup",packageManager:"npm",entryPoint:"src/index.js",startCommand:"npm start"},deno:{name:"Deno",description:"Modern TypeScript runtime",packageManager:"deno",entryPoint:"mod.ts",startCommand:"deno run --allow-net --allow-env --allow-read mod.ts"},"cloudflare-worker":{name:"Cloudflare Worker",description:"Edge runtime on Cloudflare",packageManager:"npm",entryPoint:"src/index.ts",startCommand:"npm run dev"},"vercel-function":{name:"Vercel Function",description:"Serverless function on Vercel",packageManager:"npm",entryPoint:"api/xbind.ts",startCommand:"npm run dev"}};class Spinner{frames=["⠋","⠙","⠹","⠸","⠼","⠴","⠦","⠧","⠇","⠏"];currentFrame=0;intervalId;message;constructor(e){this.message=e}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(),process.stdout.write(`\r✅ ${e??this.message}\n`)}fail(e){this.stop(),process.stdout.write(`\r❌ ${e??this.message}\n`)}stop(){this.intervalId&&(clearInterval(this.intervalId),this.intervalId=void 0)}}function normalizeInviteUrl(e,t){return e.startsWith("http://")||e.startsWith("https://")?e:(e.startsWith("XBD-"),`${t}/invite/${e}`)}function isValidProjectName(e){return/^[a-z0-9-_]+$/i.test(e)&&e.length>0&&e.length<=100}async function prompt(e,t){const n=readline.createInterface({input:input,output:output}),r=await n.question(t?`${e} (${t}): `:`${e}: `);return n.close(),r.trim()||t||""}async function select(e,t,n=0){console.log(e),t.forEach((e,t)=>{const r=t===n?"→":" ";console.log(`  ${r} ${t+1}. ${e.label} - ${e.description}`)});const r=readline.createInterface({input:input,output:output}),i=await r.question(`Select (1-${t.length}): `);r.close();const o=parseInt(i.trim(),10)-1;return o>=0&&o<t.length?t[o]?.value??t[n]?.value??"":t[n]?.value??""}function runCommand(e,t,n){return new Promise((r,i)=>{const o=spawn(e,t,{cwd:n,stdio:"ignore",shell:!0});o.on("close",e=>{0===e?r():i(new Error(`Command failed with code ${e??"unknown"}`))}),o.on("error",i)})}async function copyTemplate(e,t,n){const r=path.join(getTemplateDir(),e),i=await fs.promises.readdir(r,{recursive:!0,withFileTypes:!0});for(const e of i)if(e.isFile()){const i=e.parentPath||e.path||r,o=path.relative(r,path.join(i,e.name)),s=path.join(r,o),a=path.join(t,o);await fs.promises.mkdir(path.dirname(a),{recursive:!0});let c=await fs.promises.readFile(s,"utf-8");n&&(c=c.replace(/{{INVITE_URL}}/g,n.url),c=c.replace(/{{INVITE_ID}}/g,n.id),c=c.replace(/{{SERVICE_NAME}}/g,n.from.name),c=c.replace(/{{SERVICE_DID}}/g,n.from.did),c=c.replace(/{{SERVICE_ENDPOINT}}/g,n.from.endpoint)),await fs.promises.writeFile(a,c,"utf-8")}}async function installDependencies(e,t){"npm"===t&&await runCommand("npm",["install"],e)}export async function initCommand(e={}){const t=e.registryUrl||"https://xbind.to";let n,r;if(e.invite){r=normalizeInviteUrl(e.invite,t);const i=new Spinner("Fetching invite details...");i.start();try{const e=new InviteService({inviteApiUrl:t}),o=await e.get(r);if(!o.ok)return i.fail(`Failed to fetch invite: ${o.error.message}`),o.error.hint&&console.error(`Hint: ${o.error.hint}`),void(process.exitCode=1);if(n=o.value,!n)return i.fail("Invalid invite data received"),void(process.exitCode=1);i.succeed(`Connected to ${n.from.name}`)}catch(e){return i.fail("Failed to fetch invite details"),console.error(e instanceof Error?e.message:String(e)),void(process.exitCode=1)}}let i=e.name,o=e.runtime;if(e.yes)i=i||"my-xbind-app",o=o||"node-typescript";else{if(!i){const e=n?`connect-${n.from.name}`:"my-xbind-app";i=await prompt("Project name",e)}o||(o=await select("\nSelect runtime:",Object.entries(TEMPLATES).map(([e,t])=>({value:e,label:t.name,description:t.description})),0))}if(!isValidProjectName(i))return console.error("❌ Invalid project name. Use only letters, numbers, hyphens, and underscores."),void(process.exitCode=1);const s=path.resolve(process.cwd(),i);if(fs.existsSync(s))return console.error(`❌ Directory "${i}" already exists.`),void(process.exitCode=1);if(!o||!TEMPLATES[o])return console.error("❌ Invalid runtime selection."),void(process.exitCode=1);const a=TEMPLATES[o];console.log(`\n📦 Creating ${a.name} project: ${i}`);const c=new Spinner("Creating project structure...");c.start();try{await fs.promises.mkdir(s,{recursive:!0}),await copyTemplate(o,s,n),c.succeed("Project structure created")}catch(e){return c.fail("Failed to create project structure"),console.error(e instanceof Error?e.message:String(e)),void(process.exitCode=1)}if("none"!==a.packageManager&&"test"!==process.env.NODE_ENV){const e=new Spinner("Installing dependencies...");e.start();try{await installDependencies(s,a.packageManager),e.succeed("Dependencies installed")}catch(t){e.fail("Failed to install dependencies"),console.error("You can install them manually later.")}}if(n||r){const e=n?.url||r||"";process.env.DEBUG_CLI&&console.log("[DEBUG] Writing .env file:",{invite:!!n,inviteUrl:r,finalInviteUrl:e,projectPath:s}),e&&await fs.promises.writeFile(path.join(s,".env"),`XBIND_INVITE_CODE=${e}\n`,"utf-8")}else process.env.DEBUG_CLI&&console.log("[DEBUG] Not writing .env file:",{invite:!!n,inviteUrl:r});console.log("\n✅ Ready!\n"),console.log("Next steps:"),console.log(`  cd ${i}`),console.log(`  ${a.startCommand}`),n?(console.log(`\n🔗 Connected to: ${n.from.name}`),console.log(`   DID: ${n.from.did}`)):console.log("\n💡 To connect to a service, get an invite code and update .env file.")}export async function main(e=process.argv.slice(2)){const{values:t}=parseArgs({args:e,options:{invite:{type:"string",short:"i"},name:{type:"string",short:"n"},runtime:{type:"string",short:"r"},yes:{type:"boolean",short:"y"},"registry-url":{type:"string"},help:{type:"boolean",short:"h"}}});t.help?console.log("\nXBind CLI - One-Line M2M Setup\n\nUsage:\n  npx xbind-init [options]\n\nOptions:\n  -i, --invite <url>       Invite URL or code\n  -n, --name <name>        Project name\n  -r, --runtime <runtime>  Runtime template (node-typescript, node-javascript, deno, cloudflare-worker, vercel-function)\n  -y, --yes                Skip interactive prompts (use defaults)\n  --registry-url <url>     Custom registry URL (default: https://xbind.to)\n  -h, --help               Show this help message\n\nExamples:\n  npx xbind-init --invite https://xbind.to/invite/XBD-abc123\n  npx xbind-init --invite XBD-abc123 --name my-app --runtime node-typescript\n  npx xbind-init --yes\n    ".trim()):await initCommand({invite:t.invite,name:t.name,runtime:t.runtime,yes:t.yes,"registry-url":t["registry-url"]})}const isDirectRun=process.argv[1]?.endsWith("init.ts")||process.argv[1]?.endsWith("init.js");isDirectRun&&main().catch(e=>{console.error("Fatal:",e instanceof Error?e.message:String(e)),process.exitCode=1});
+/* eslint-disable no-console */
+/**
+ * @module cli/init
+ * One-line CLI setup for XBind connections.
+ *
+ * Enables: npx xbind-init --invite <code>
+ *
+ * Flow:
+ * 1. Parse invite URL or code
+ * 2. Fetch invite details from registry server
+ * 3. Interactive prompts for: project name, runtime, TypeScript vs JavaScript
+ * 4. Generate project directory with template files
+ * 5. Install dependencies
+ * 6. Write .env file with XBIND_INVITE_CODE
+ * 7. Register with XBind registry (auto-accept flow)
+ * 8. Print success message with next steps
+ *
+ * @example
+ * ```bash
+ * npx xbind-init --invite https://xbind.to/invite/XBD-abc123
+ *
+ * # Prompts:
+ * # → Project name: my-xbind-app
+ * # → Runtime: node-typescript
+ * # Creating project...
+ * # Installing dependencies...
+ * # Registering with XBind...
+ * # ✅ Ready! Run: cd my-xbind-app && npm start
+ * ```
+ */
+import { parseArgs } from 'node:util';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { spawn } from 'node:child_process';
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { InviteService } from '../invite.js';
+// Get template directory path
+// In production, templates are at ../templates relative to dist/cli/init.js
+// We'll resolve this dynamically based on the package root
+function getTemplateDir() {
+    // Find package root by looking for package.json
+    let currentDir = __dirname;
+    while (currentDir !== '/') {
+        if (fs.existsSync(path.join(currentDir, 'package.json'))) {
+            return path.join(currentDir, 'templates');
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    // Fallback: assume we're in dist/cli and templates are in package root
+    return path.join(__dirname, '../../templates');
+}
+const TEMPLATES = {
+    'node-typescript': {
+        name: 'Node.js + TypeScript',
+        description: 'Node.js with TypeScript, best for backend services',
+        packageManager: 'npm',
+        entryPoint: 'src/index.ts',
+        startCommand: 'npm run dev',
+    },
+    'node-javascript': {
+        name: 'Node.js + JavaScript',
+        description: 'Node.js with JavaScript, minimal setup',
+        packageManager: 'npm',
+        entryPoint: 'src/index.js',
+        startCommand: 'npm start',
+    },
+    'deno': {
+        name: 'Deno',
+        description: 'Modern TypeScript runtime',
+        packageManager: 'deno',
+        entryPoint: 'mod.ts',
+        startCommand: 'deno run --allow-net --allow-env --allow-read mod.ts',
+    },
+    'cloudflare-worker': {
+        name: 'Cloudflare Worker',
+        description: 'Edge runtime on Cloudflare',
+        packageManager: 'npm',
+        entryPoint: 'src/index.ts',
+        startCommand: 'npm run dev',
+    },
+    'vercel-function': {
+        name: 'Vercel Function',
+        description: 'Serverless function on Vercel',
+        packageManager: 'npm',
+        entryPoint: 'api/xbind.ts',
+        startCommand: 'npm run dev',
+    },
+};
+/**
+ * Spinner for progress indication.
+ */
+class Spinner {
+    frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    currentFrame = 0;
+    intervalId;
+    message;
+    constructor(message) {
+        this.message = message;
+    }
+    start() {
+        this.intervalId = setInterval(() => {
+            const frame = this.frames[this.currentFrame];
+            process.stdout.write(`\r${frame} ${this.message}`);
+            this.currentFrame = (this.currentFrame + 1) % this.frames.length;
+        }, 80);
+    }
+    succeed(message) {
+        this.stop();
+        process.stdout.write(`\r✅ ${message ?? this.message}\n`);
+    }
+    fail(message) {
+        this.stop();
+        process.stdout.write(`\r❌ ${message ?? this.message}\n`);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+    }
+}
+/**
+ * Parse invite code/URL to extract invite ID.
+ *
+ * @param inviteInput - Invite URL or code
+ * @returns Invite URL
+ */
+function normalizeInviteUrl(inviteInput, registryUrl) {
+    // If it's already a full URL, return as-is
+    if (inviteInput.startsWith('http://') || inviteInput.startsWith('https://')) {
+        return inviteInput;
+    }
+    // If it starts with XBD-, treat as code
+    if (inviteInput.startsWith('XBD-')) {
+        return `${registryUrl}/invite/${inviteInput}`;
+    }
+    // Otherwise, assume it's an ID
+    return `${registryUrl}/invite/${inviteInput}`;
+}
+/**
+ * Validate project name.
+ *
+ * @param name - Project name
+ * @returns true if valid
+ */
+function isValidProjectName(name) {
+    return /^[a-z0-9-_]+$/i.test(name) && name.length > 0 && name.length <= 100;
+}
+/**
+ * Prompt user for input.
+ *
+ * @param question - Question text
+ * @param defaultValue - Default value
+ * @returns User input
+ */
+async function prompt(question, defaultValue) {
+    const rl = readline.createInterface({ input, output });
+    const answer = await rl.question(defaultValue ? `${question} (${defaultValue}): ` : `${question}: `);
+    rl.close();
+    return answer.trim() || defaultValue || '';
+}
+/**
+ * Prompt user to select from a list.
+ *
+ * @param question - Question text
+ * @param choices - Available choices
+ * @param defaultIndex - Default choice index
+ * @returns Selected choice
+ */
+async function select(question, choices, defaultIndex = 0) {
+    console.log(question);
+    choices.forEach((choice, i) => {
+        const prefix = i === defaultIndex ? '→' : ' ';
+        console.log(`  ${prefix} ${i + 1}. ${choice.label} - ${choice.description}`);
+    });
+    const rl = readline.createInterface({ input, output });
+    const answer = await rl.question(`Select (1-${choices.length}): `);
+    rl.close();
+    const selectedIndex = parseInt(answer.trim(), 10) - 1;
+    if (selectedIndex >= 0 && selectedIndex < choices.length) {
+        return choices[selectedIndex]?.value ?? choices[defaultIndex]?.value ?? '';
+    }
+    return choices[defaultIndex]?.value ?? '';
+}
+/**
+ * Run shell command.
+ *
+ * @param command - Command to run
+ * @param args - Command arguments
+ * @param cwd - Working directory
+ * @returns Promise that resolves when command completes
+ */
+function runCommand(command, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(command, args, {
+            cwd,
+            stdio: 'ignore',
+            shell: true,
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`Command failed with code ${code ?? 'unknown'}`));
+            }
+        });
+        proc.on('error', reject);
+    });
+}
+/**
+ * Copy template files to project directory.
+ *
+ * @param templateName - Template name
+ * @param projectPath - Project directory path
+ * @param invite - Invite details
+ */
+async function copyTemplate(templateName, projectPath, invite) {
+    const templateDir = path.join(getTemplateDir(), templateName);
+    // Read all files in template directory
+    const files = await fs.promises.readdir(templateDir, { recursive: true, withFileTypes: true });
+    for (const file of files) {
+        if (file.isFile()) {
+            // Get the parent path from the file dirent
+            // Note: file.parentPath was added in Node.js 20.1.0, file.path is deprecated
+            const parentPath = file.parentPath || file.path || templateDir;
+            const relativePath = path.relative(templateDir, path.join(parentPath, file.name));
+            const sourcePath = path.join(templateDir, relativePath);
+            const destPath = path.join(projectPath, relativePath);
+            // Create directory if it doesn't exist
+            await fs.promises.mkdir(path.dirname(destPath), { recursive: true });
+            // Read template file
+            let content = await fs.promises.readFile(sourcePath, 'utf-8');
+            // Replace placeholders
+            if (invite) {
+                content = content.replace(/{{INVITE_URL}}/g, invite.url);
+                content = content.replace(/{{INVITE_ID}}/g, invite.id);
+                content = content.replace(/{{SERVICE_NAME}}/g, invite.from.name);
+                content = content.replace(/{{SERVICE_DID}}/g, invite.from.did);
+                content = content.replace(/{{SERVICE_ENDPOINT}}/g, invite.from.endpoint);
+            }
+            // Write to destination
+            await fs.promises.writeFile(destPath, content, 'utf-8');
+        }
+    }
+}
+/**
+ * Install dependencies.
+ *
+ * @param projectPath - Project directory
+ * @param packageManager - Package manager to use
+ */
+async function installDependencies(projectPath, packageManager) {
+    if (packageManager === 'npm') {
+        await runCommand('npm', ['install'], projectPath);
+    }
+    else if (packageManager === 'deno') {
+        // Deno doesn't need install, it auto-downloads
+    }
+    // 'none' for templates that don't need dependencies
+}
+/**
+ * Main init command.
+ *
+ * @param options - Init options
+ */
+export async function initCommand(options = {}) {
+    const registryUrl = options.registryUrl || 'https://xbind.to';
+    // Step 1: Get invite details
+    let invite;
+    let inviteUrl;
+    if (options.invite) {
+        inviteUrl = normalizeInviteUrl(options.invite, registryUrl);
+        const spinner = new Spinner('Fetching invite details...');
+        spinner.start();
+        try {
+            const inviteService = new InviteService({ inviteApiUrl: registryUrl });
+            const inviteResult = await inviteService.get(inviteUrl);
+            if (!inviteResult.ok) {
+                spinner.fail(`Failed to fetch invite: ${inviteResult.error.message}`);
+                if (inviteResult.error.hint) {
+                    console.error(`Hint: ${inviteResult.error.hint}`);
+                }
+                process.exitCode = 1;
+                return;
+            }
+            invite = inviteResult.value;
+            // TypeScript narrowing: invite is guaranteed to be defined here
+            if (!invite) {
+                spinner.fail('Invalid invite data received');
+                process.exitCode = 1;
+                return;
+            }
+            spinner.succeed(`Connected to ${invite.from.name}`);
+        }
+        catch (error) {
+            spinner.fail('Failed to fetch invite details');
+            console.error(error instanceof Error ? error.message : String(error));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    // Step 2: Prompt for project details (if not in --yes mode)
+    let projectName = options.name;
+    let runtime = options.runtime;
+    if (!options.yes) {
+        // Prompt for project name
+        if (!projectName) {
+            const suggestedName = invite ? `connect-${invite.from.name}` : 'my-xbind-app';
+            projectName = await prompt('Project name', suggestedName);
+        }
+        // Prompt for runtime
+        if (!runtime) {
+            runtime = (await select('\nSelect runtime:', Object.entries(TEMPLATES).map(([value, meta]) => ({
+                value,
+                label: meta.name,
+                description: meta.description,
+            })), 0));
+        }
+    }
+    else {
+        // In --yes mode, use defaults
+        projectName = projectName || 'my-xbind-app';
+        runtime = runtime || 'node-typescript';
+    }
+    // Validate project name (applies to both modes)
+    if (!isValidProjectName(projectName)) {
+        console.error('❌ Invalid project name. Use only letters, numbers, hyphens, and underscores.');
+        process.exitCode = 1;
+        return;
+    }
+    // Check if directory exists (applies to both modes)
+    const projectPath = path.resolve(process.cwd(), projectName);
+    if (fs.existsSync(projectPath)) {
+        console.error(`❌ Directory "${projectName}" already exists.`);
+        process.exitCode = 1;
+        return;
+    }
+    if (!runtime || !TEMPLATES[runtime]) {
+        console.error('❌ Invalid runtime selection.');
+        process.exitCode = 1;
+        return;
+    }
+    const template = TEMPLATES[runtime];
+    console.log(`\n📦 Creating ${template.name} project: ${projectName}`);
+    // Step 3: Create project directory
+    const createSpinner = new Spinner('Creating project structure...');
+    createSpinner.start();
+    try {
+        await fs.promises.mkdir(projectPath, { recursive: true });
+        await copyTemplate(runtime, projectPath, invite);
+        createSpinner.succeed('Project structure created');
+    }
+    catch (error) {
+        createSpinner.fail('Failed to create project structure');
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+        return;
+    }
+    // Step 4: Install dependencies
+    if (template.packageManager !== 'none' && process.env.NODE_ENV !== 'test') {
+        const installSpinner = new Spinner('Installing dependencies...');
+        installSpinner.start();
+        try {
+            await installDependencies(projectPath, template.packageManager);
+            installSpinner.succeed('Dependencies installed');
+        }
+        catch (error) {
+            installSpinner.fail('Failed to install dependencies');
+            console.error('You can install them manually later.');
+            // Don't exit, continue
+        }
+    }
+    // Step 5: Write .env file with invite code (if provided)
+    if (invite || inviteUrl) {
+        const finalInviteUrl = invite?.url || inviteUrl || '';
+        if (process.env.DEBUG_CLI) {
+            console.log('[DEBUG] Writing .env file:', { invite: !!invite, inviteUrl, finalInviteUrl, projectPath });
+        }
+        if (finalInviteUrl) {
+            await fs.promises.writeFile(path.join(projectPath, '.env'), `XBIND_INVITE_CODE=${finalInviteUrl}\n`, 'utf-8');
+        }
+    }
+    else if (process.env.DEBUG_CLI) {
+        console.log('[DEBUG] Not writing .env file:', { invite: !!invite, inviteUrl });
+    }
+    // Step 6: Print success message
+    console.log('\n✅ Ready!\n');
+    console.log('Next steps:');
+    console.log(`  cd ${projectName}`);
+    console.log(`  ${template.startCommand}`);
+    if (invite) {
+        console.log(`\n🔗 Connected to: ${invite.from.name}`);
+        console.log(`   DID: ${invite.from.did}`);
+    }
+    else {
+        console.log('\n💡 To connect to a service, get an invite code and update .env file.');
+    }
+}
+/**
+ * CLI entry point.
+ *
+ * @param argv - Command-line arguments
+ */
+export async function main(argv = process.argv.slice(2)) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            invite: { type: 'string', short: 'i' },
+            name: { type: 'string', short: 'n' },
+            runtime: { type: 'string', short: 'r' },
+            yes: { type: 'boolean', short: 'y' },
+            'registry-url': { type: 'string' },
+            help: { type: 'boolean', short: 'h' },
+        },
+    });
+    if (values.help) {
+        console.log(`
+XBind CLI - One-Line M2M Setup
+
+Usage:
+  npx xbind-init [options]
+
+Options:
+  -i, --invite <url>       Invite URL or code
+  -n, --name <name>        Project name
+  -r, --runtime <runtime>  Runtime template (node-typescript, node-javascript, deno, cloudflare-worker, vercel-function)
+  -y, --yes                Skip interactive prompts (use defaults)
+  --registry-url <url>     Custom registry URL (default: https://xbind.to)
+  -h, --help               Show this help message
+
+Examples:
+  npx xbind-init --invite https://xbind.to/invite/XBD-abc123
+  npx xbind-init --invite XBD-abc123 --name my-app --runtime node-typescript
+  npx xbind-init --yes
+    `.trim());
+        return;
+    }
+    await initCommand({
+        invite: values.invite,
+        name: values.name,
+        runtime: values.runtime,
+        yes: values.yes,
+        'registry-url': values['registry-url'],
+    });
+}
+// Auto-run if executed directly
+const isDirectRun = process.argv[1]?.endsWith('init.ts') || process.argv[1]?.endsWith('init.js');
+if (isDirectRun) {
+    main().catch((error) => {
+        console.error('Fatal:', error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}