@private.me/xbind 3.0.2 → 3.0.4

package/dist-standalone/cli/init.js

@@ -1,456 +1,2 @@
 #!/usr/bin/env node
-/* 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;
-    });
-}
+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{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});