@private.me/xbind 1.3.5 → 3.0.0

package/dist-standalone/cjs/cli/init.js

@@ -1,487 +1,2 @@
 #!/usr/bin/env node
-"use strict";
-/* 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
- * ```
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initCommand = initCommand;
-exports.main = main;
-const node_util_1 = require("node:util");
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const node_child_process_1 = require("node:child_process");
-const readline = __importStar(require("node:readline/promises"));
-const node_process_1 = require("node:process");
-const invite_js_1 = require("../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: node_process_1.stdin, output: node_process_1.stdout });
-    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: node_process_1.stdin, output: node_process_1.stdout });
-    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 = (0, node_child_process_1.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
- */
-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 invite_js_1.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;
-            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
- */
-async function main(argv = process.argv.slice(2)) {
-    const { values } = (0, node_util_1.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;
-    });
-}
+"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,n,r){void 0===r&&(r=n);var i=Object.getOwnPropertyDescriptor(t,n);i&&!("get"in i?!t.__esModule:i.writable||i.configurable)||(i={enumerable:!0,get:function(){return t[n]}}),Object.defineProperty(e,r,i)}:function(e,t,n,r){void 0===r&&(r=n),e[r]=t[n]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),__importStar=this&&this.__importStar||function(){var e=function(t){return e=Object.getOwnPropertyNames||function(e){var t=[];for(var n in e)Object.prototype.hasOwnProperty.call(e,n)&&(t[t.length]=n);return t},e(t)};return function(t){if(t&&t.__esModule)return t;var n={};if(null!=t)for(var r=e(t),i=0;i<r.length;i++)"default"!==r[i]&&__createBinding(n,t,r[i]);return __setModuleDefault(n,t),n}}();Object.defineProperty(exports,"__esModule",{value:!0}),exports.initCommand=initCommand,exports.main=main;const node_util_1=require("node:util"),fs=__importStar(require("node:fs")),path=__importStar(require("node:path")),node_child_process_1=require("node:child_process"),readline=__importStar(require("node:readline/promises")),node_process_1=require("node:process"),invite_js_1=require("../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:node_process_1.stdin,output:node_process_1.stdout}),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:node_process_1.stdin,output:node_process_1.stdout}),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=(0,node_child_process_1.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)}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 invite_js_1.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.")}async function main(e=process.argv.slice(2)){const{values:t}=(0,node_util_1.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});

package/dist-standalone/cjs/config-validation.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.AGENT_CREATE_OPTIONS_DEFAULTS=exports.AGENT_OPTIONS_DEFAULTS=exports.ConfigValidationError=void 0,exports.validateAgentOptions=validateAgentOptions,exports.validateAgentCreateOptions=validateAgentCreateOptions,exports.getValidationDetails=getValidationDetails,exports.assertValidConfig=assertValidConfig,exports.assertValidCreateConfig=assertValidCreateConfig;const shared_1=require("../_deps/shared/index.js"),errors_js_1=require("./errors.js");class ConfigValidationError extends errors_js_1.XBindError{field;expected;actual;fix;constructor(t,e,r,i){super("CONFIG_INVALID",`Configuration validation failed for '${t}': Expected ${e}, got ${"object"==typeof r&&null!==r?JSON.stringify(r):String(r)}. ${i}`,"https://private.me/docs/xbind/api/configuration"),this.name="ConfigValidationError",this.field=t,this.expected=e,this.actual=r,this.fix=i}}function validateAgentOptions(t){if(!t||"object"!=typeof t)return(0,shared_1.err)(new ConfigValidationError("options","object",t,"Provide a configuration object with at least one option."));const e=t,r=[],i=[];if(void 0!==e.identity&&("string"!=typeof e.identity?r.push(new ConfigValidationError("identity","'persistent' | 'ephemeral'",e.identity,"Use 'persistent' for long-lived DIDs or 'ephemeral' for short-lived DIDs.")):"persistent"!==e.identity&&"ephemeral"!==e.identity&&r.push(new ConfigValidationError("identity","'persistent' | 'ephemeral'",e.identity,"Invalid identity mode. Use 'persistent' or 'ephemeral'."))),void 0!==e.identityTTL&&("number"!=typeof e.identityTTL?r.push(new ConfigValidationError("identityTTL","number (milliseconds)",e.identityTTL,"Provide TTL as a number in milliseconds (e.g., 3600000 for 1 hour).")):e.identityTTL<=0?r.push(new ConfigValidationError("identityTTL","positive number",e.identityTTL,"TTL must be greater than 0. Use at least 60000 (1 minute).")):e.identityTTL<6e4?i.push(`identityTTL is very short (${e.identityTTL}ms). Consider using at least 60000ms (1 minute) to avoid frequent re-registrations.`):e.identityTTL>864e5&&i.push(`identityTTL is very long (${e.identityTTL}ms). Consider using 'persistent' identity mode instead for long-lived agents.`),"persistent"===e.identity&&i.push("identityTTL is ignored for 'persistent' identity mode. Remove this option or switch to 'ephemeral' mode.")),void 0!==e.registry){const t="string"==typeof e.registry,i="object"==typeof e.registry&&null!==e.registry;if(t||i){if(t){const t=e.registry;try{const e=new URL(t);"http:"!==e.protocol&&"https:"!==e.protocol&&r.push(new ConfigValidationError("registry","HTTP(S) URL",t,"Registry URL must use HTTP or HTTPS protocol."))}catch{r.push(new ConfigValidationError("registry","valid URL",t,'Provide a valid URL (e.g., "https://private.me/registry").'))}}else if(i){const t=e.registry,i=["register","resolve"].filter(e=>!(e in t)||"function"!=typeof t[e]);i.length>0&&r.push(new ConfigValidationError("registry","TrustRegistry instance","object missing required methods",`TrustRegistry must implement ${i.join(", ")} method(s). Use HttpTrustRegistry or MemoryTrustRegistry.`))}}else r.push(new ConfigValidationError("registry","TrustRegistry instance or URL string",e.registry,'Provide either a registry URL (e.g., "https://private.me/registry") or a TrustRegistry instance.'))}if(void 0!==e.transport){const t=Array.isArray(e.transport);if("object"==typeof e.transport&&null!==e.transport&&!t||t)if(t){const t=e.transport;0===t.length&&r.push(new ConfigValidationError("transport","non-empty array",t,"Provide at least one transport adapter.")),t.forEach((t,e)=>{if("object"!=typeof t||null===t)r.push(new ConfigValidationError(`transport[${e}]`,"XailTransportAdapter",t,"Each transport must be a XailTransportAdapter instance."));else{"send"in t&&"function"==typeof t.send||r.push(new ConfigValidationError(`transport[${e}]`,"XailTransportAdapter with send() method","object missing send() method","Transport must implement send() method. Use HttpsTransportAdapter or custom adapter."))}})}else{const t=e.transport;"send"in t&&"function"==typeof t.send||r.push(new ConfigValidationError("transport","XailTransportAdapter with send() method","object missing send() method","Transport must implement send() method. Use HttpsTransportAdapter or custom adapter."))}else r.push(new ConfigValidationError("transport","XailTransportAdapter or XailTransportAdapter[]",e.transport,"Provide a single transport adapter or an array of adapters for split-channel security."))}if(void 0!==e.securityPolicy)if("object"!=typeof e.securityPolicy||null===e.securityPolicy)r.push(new ConfigValidationError("securityPolicy","SecurityPolicy instance",e.securityPolicy,"Provide a SecurityPolicy instance (e.g., DefaultSecurityPolicy or custom policy)."));else{const t=e.securityPolicy;"classify"in t&&"function"==typeof t.classify||r.push(new ConfigValidationError("securityPolicy","SecurityPolicy with classify() method","object missing classify() method","SecurityPolicy must implement classify() method. Use DefaultSecurityPolicy."))}if(void 0!==e.postQuantumSig&&"boolean"!=typeof e.postQuantumSig&&r.push(new ConfigValidationError("postQuantumSig","boolean",e.postQuantumSig,"Use true to enable ML-DSA-65 post-quantum signatures, or false to disable.")),void 0!==e.backupConfig)if("object"!=typeof e.backupConfig||null===e.backupConfig)r.push(new ConfigValidationError("backupConfig","BackupConfig object",e.backupConfig,"Provide a BackupConfig object with threshold (k) and totalShares (n) properties."));else{const t=e.backupConfig;"number"!=typeof t.threshold?r.push(new ConfigValidationError("backupConfig.threshold","number",t.threshold,"Threshold (k) must be a number representing shares needed for reconstruction.")):t.threshold<2&&r.push(new ConfigValidationError("backupConfig.threshold","number >= 2",t.threshold,"Threshold must be at least 2 for meaningful splitting.")),"number"!=typeof t.totalShares?r.push(new ConfigValidationError("backupConfig.totalShares","number",t.totalShares,"totalShares (n) must be a number representing total shares to create.")):t.totalShares<2&&r.push(new ConfigValidationError("backupConfig.totalShares","number >= 2",t.totalShares,"totalShares must be at least 2 for splitting.")),"number"==typeof t.threshold&&"number"==typeof t.totalShares&&t.threshold>t.totalShares&&r.push(new ConfigValidationError("backupConfig","threshold <= totalShares",`threshold=${t.threshold}, totalShares=${t.totalShares}`,`Threshold (${t.threshold}) cannot exceed totalShares (${t.totalShares}). Use threshold <= totalShares.`))}return r.length>0?(0,shared_1.err)(r[0]):(0,shared_1.ok)(e)}function validateAgentCreateOptions(t){if(!t||"object"!=typeof t)return(0,shared_1.err)(new ConfigValidationError("options","object",t,"Provide a configuration object with required fields: name, registry, transport."));const e=t,r=[];if(void 0===e.name?r.push(new ConfigValidationError("name","string (required)",void 0,'Provide a display name for the agent (e.g., "my-agent").')):"string"!=typeof e.name?r.push(new ConfigValidationError("name","string",e.name,"Agent name must be a string.")):0===e.name.trim().length?r.push(new ConfigValidationError("name","non-empty string",e.name,"Agent name cannot be empty or whitespace only.")):e.name.length>255&&r.push(new ConfigValidationError("name","string with length <= 255",e.name,`Agent name is too long (${e.name.length} characters). Use 255 characters or less.`)),void 0===e.registry)r.push(new ConfigValidationError("registry","TrustRegistry (required)",void 0,"Provide a TrustRegistry instance (e.g., new MemoryTrustRegistry() or new HttpTrustRegistry())."));else if("object"!=typeof e.registry||null===e.registry)r.push(new ConfigValidationError("registry","TrustRegistry instance",e.registry,"Registry must be a TrustRegistry instance, not a string or primitive value."));else{const t=e.registry,i=["register","resolve"].filter(e=>!(e in t)||"function"!=typeof t[e]);i.length>0&&r.push(new ConfigValidationError("registry","TrustRegistry instance","object missing required methods",`TrustRegistry must implement: ${i.join(", ")}. Use HttpTrustRegistry or MemoryTrustRegistry.`))}if(void 0===e.transport)r.push(new ConfigValidationError("transport","XailTransportAdapter or XailTransportAdapter[] (required)",void 0,"Provide a transport adapter (e.g., new HttpsTransportAdapter()) or array of adapters for split-channel."));else{const t=Array.isArray(e.transport);if("object"==typeof e.transport&&null!==e.transport&&!t||t)if(t){const t=e.transport;0===t.length&&r.push(new ConfigValidationError("transport","non-empty array",t,"Provide at least one transport adapter.")),t.forEach((t,e)=>{if("object"!=typeof t||null===t)r.push(new ConfigValidationError(`transport[${e}]`,"XailTransportAdapter",t,"Each transport must be a XailTransportAdapter instance."));else{"send"in t&&"function"==typeof t.send||r.push(new ConfigValidationError(`transport[${e}]`,"XailTransportAdapter with send() method","object missing send() method","Transport must implement send() method. Use HttpsTransportAdapter or custom adapter."))}})}else{const t=e.transport;"send"in t&&"function"==typeof t.send||r.push(new ConfigValidationError("transport","XailTransportAdapter with send() method","object missing send() method","Transport must implement send() method. Use HttpsTransportAdapter or custom adapter."))}else r.push(new ConfigValidationError("transport","XailTransportAdapter or XailTransportAdapter[]",e.transport,"Provide a single transport adapter or an array of adapters."))}if(void 0!==e.nonceStore)if("object"!=typeof e.nonceStore||null===e.nonceStore)r.push(new ConfigValidationError("nonceStore","NonceStore instance",e.nonceStore,"Provide a NonceStore instance (e.g., new MemoryNonceStore())."));else{const t=e.nonceStore,i=["check","cleanup"].filter(e=>!(e in t)||"function"!=typeof t[e]);i.length>0&&r.push(new ConfigValidationError("nonceStore","NonceStore instance","object missing required methods",`NonceStore must implement: ${i.join(", ")}. Use MemoryNonceStore.`))}if(void 0!==e.scopes)if(Array.isArray(e.scopes)){e.scopes.forEach((t,e)=>{"string"!=typeof t?r.push(new ConfigValidationError(`scopes[${e}]`,"string",t,"Each scope must be a string.")):0===t.trim().length&&r.push(new ConfigValidationError(`scopes[${e}]`,"non-empty string",t,"Scope cannot be empty or whitespace only."))})}else r.push(new ConfigValidationError("scopes","string[]",e.scopes,'Provide an array of scope strings (e.g., ["read", "write"]).'));if(void 0!==e.timestampWindowMs&&("number"!=typeof e.timestampWindowMs?r.push(new ConfigValidationError("timestampWindowMs","number (milliseconds)",e.timestampWindowMs,"Provide timestamp window as a number in milliseconds (e.g., 30000 for 30 seconds).")):e.timestampWindowMs<=0?r.push(new ConfigValidationError("timestampWindowMs","positive number",e.timestampWindowMs,"Timestamp window must be greater than 0. Use at least 1000 (1 second).")):e.timestampWindowMs<5e3?r.push(new ConfigValidationError("timestampWindowMs","number >= 5000",e.timestampWindowMs,"Timestamp window is very short. Use at least 5000ms (5 seconds) to account for clock skew.")):e.timestampWindowMs>3e5&&r.push(new ConfigValidationError("timestampWindowMs","number <= 300000",e.timestampWindowMs,"Timestamp window is very long. Consider using 300000ms (5 minutes) or less for security."))),void 0!==e.postQuantumSig&&"boolean"!=typeof e.postQuantumSig&&r.push(new ConfigValidationError("postQuantumSig","boolean",e.postQuantumSig,"Use true to enable ML-DSA-65 post-quantum signatures, or false to disable.")),void 0!==e.xchange&&"boolean"!=typeof e.xchange&&r.push(new ConfigValidationError("xchange","boolean",e.xchange,"Use true to advertise Xchange mode support, or false to disable.")),void 0!==e.securityPolicy)if("object"!=typeof e.securityPolicy||null===e.securityPolicy)r.push(new ConfigValidationError("securityPolicy","SecurityPolicy instance",e.securityPolicy,"Provide a SecurityPolicy instance (e.g., DefaultSecurityPolicy or custom policy)."));else{const t=e.securityPolicy;"classify"in t&&"function"==typeof t.classify||r.push(new ConfigValidationError("securityPolicy","SecurityPolicy with classify() method","object missing classify() method","SecurityPolicy must implement classify() method. Use DefaultSecurityPolicy."))}return r.length>0?(0,shared_1.err)(r[0]):(0,shared_1.ok)(e)}function getValidationDetails(t){const e=[],r=[],i=validateAgentOptions(t);if(i.ok||e.push(i.error),t&&"object"==typeof t){const e=t;"number"==typeof e.identityTTL&&(e.identityTTL<6e4&&e.identityTTL>0?r.push(`identityTTL is very short (${e.identityTTL}ms). Consider using at least 60000ms (1 minute).`):e.identityTTL>864e5&&r.push(`identityTTL is very long (${e.identityTTL}ms). Consider using 'persistent' identity mode instead.`),"persistent"===e.identity&&r.push("identityTTL is ignored for 'persistent' identity mode."))}return{valid:0===e.length,errors:e,warnings:r}}function assertValidConfig(t){const e=validateAgentOptions(t);if(!e.ok)throw e.error}function assertValidCreateConfig(t){const e=validateAgentCreateOptions(t);if(!e.ok)throw e.error}exports.ConfigValidationError=ConfigValidationError,exports.AGENT_OPTIONS_DEFAULTS={identity:"persistent",identityTTL:36e5,postQuantumSig:!1},exports.AGENT_CREATE_OPTIONS_DEFAULTS={timestampWindowMs:3e4,postQuantumSig:!1,xchange:!1,scopes:[]};