@sinch/cli 0.3.2 → 0.3.4

package/scripts/postinstall.js

@@ -0,0 +1,197 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall.js — runs on `npm install -g @sinch/cli`
+ *
+ * 1. Writes ~/.sinch/completions.json (command tree for PowerShell)
+ * 2. Installs shell completion into the user's profile (PowerShell, zsh, or bash)
+ *
+ * Silent failure on ALL errors — must never break `npm install`.
+ *
+ * Keep COMPLETION_COMMANDS in sync with src/index.ts.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const { spawn } = require('child_process');
+
+const SINCH_DIR = path.join(os.homedir(), '.sinch');
+
+// Keep in sync with COMPLETION_COMMANDS in src/index.ts.
+// The postAction hook overwrites completions.json on every CLI run, so drift self-heals.
+const COMPLETION_COMMANDS = {
+  functions: ['init', 'list', 'deploy', 'download', 'dev', 'status', 'logs', 'delete', 'docs'],
+  templates: ['list', 'show', 'node', 'csharp', 'python'],
+  voice: ['callback-url', 'get-callbacks', 'set-callback'],
+  secrets: ['list', 'add', 'get', 'delete', 'clear'],
+  auth: ['login', 'status', 'logout'],
+  sip: ['trunks', 'endpoints', 'acls', 'countries', 'credential-lists', 'calls'],
+  numbers: ['active', 'available', 'regions'],
+  fax: ['send', 'list', 'get', 'cancel', 'auth-status', 'status'],
+  conversation: ['send', 'messages', 'contacts', 'conversations', 'apps', 'webhooks'],
+  skills: ['install', 'list', 'uninstall', 'update'],
+  config: ['--set', '--get', '--list'],
+  completion: ['--shell', '--install'],
+};
+
+const SENTINEL_START = '# ── Sinch CLI completion ──';
+const SENTINEL_END = '# ── End Sinch CLI completion ──';
+
+function getVersion() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+    return pkg.version || '0.0.0';
+  } catch {
+    return '0.0.0';
+  }
+}
+
+function writeCompletionsJson(version) {
+  const filePath = path.join(SINCH_DIR, 'completions.json');
+  fs.writeFileSync(filePath, JSON.stringify({ version, commands: COMPLETION_COMMANDS }, null, 2));
+}
+
+function getPowerShellCompletionScript() {
+  return `${SENTINEL_START}
+# PowerShell completion for Sinch CLI
+# Reads command tree from ~/.sinch/completions.json (auto-updated by CLI)
+
+Register-ArgumentCompleter -Native -CommandName sinch -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    try {
+        $jsonPath = Join-Path $env:USERPROFILE '.sinch' 'completions.json'
+        if (-not (Test-Path $jsonPath)) { return }
+
+        $data = Get-Content $jsonPath -Raw | ConvertFrom-Json
+        $line = $commandAst.CommandElements
+        $command = if ($line.Count -gt 1) { $line[1].Value } else { "" }
+
+        if ($line.Count -eq 2) {
+            $mainCommands = @($data.commands.PSObject.Properties.Name) + @('--version', '--help')
+            $mainCommands | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+            }
+        }
+        elseif ($line.Count -eq 3 -and $data.commands.$command) {
+            @($data.commands.$command) | Where-Object { $_ -like "$wordToComplete*" } | ForEach-Object {
+                [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
+            }
+        }
+    }
+    catch {
+        # Silently fail — prevents PowerShell startup errors
+    }
+}
+${SENTINEL_END}`;
+}
+
+// --- Profile installation helpers ---
+
+function shellEscapePath(p) {
+  return "'" + p.replace(/'/g, "'\\''") + "'";
+}
+
+function upsertBlock(content, block) {
+  const pattern =
+    SENTINEL_START.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') +
+    '[\\s\\S]*?' +
+    SENTINEL_END.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const replaced = content.replace(new RegExp(pattern, 'g'), block.trim());
+  if (replaced !== content) return replaced;
+  return content + (content && !content.endsWith('\n') ? '\n' : '') + '\n' + block.trim() + '\n';
+}
+
+function tryShell(cmd) {
+  return new Promise((resolve) => {
+    const ps = spawn(cmd, ['-NoProfile', '-Command', '$PROFILE'], {
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    let out = '';
+    ps.stdout.on('data', (d) => (out += d.toString()));
+    ps.on('close', (code) => resolve(code === 0 ? out.trim() : null));
+    ps.on('error', () => resolve(null));
+  });
+}
+
+async function installPowerShellCompletion() {
+  const completionFile = path.join(SINCH_DIR, 'sinch-completion.ps1');
+  fs.writeFileSync(completionFile, getPowerShellCompletionScript());
+
+  const profilePath = (await tryShell('pwsh')) ?? (await tryShell('powershell'));
+  if (!profilePath) return;
+
+  // Validate profile path is within user's home directory
+  const resolved = path.resolve(profilePath);
+  if (!resolved.startsWith(os.homedir())) return;
+
+  fs.mkdirSync(path.dirname(resolved), { recursive: true });
+
+  let content = '';
+  try {
+    content = fs.readFileSync(resolved, 'utf8');
+  } catch {
+    // Profile doesn't exist yet — will be created
+  }
+
+  const sourceLine = `. ${shellEscapePath(completionFile.replace(/\\/g, '\\\\'))}`;
+  const block = `${SENTINEL_START}\n${sourceLine}\n${SENTINEL_END}`;
+  fs.writeFileSync(resolved, upsertBlock(content, block));
+}
+
+function installBashZshCompletion() {
+  const completionFile = path.join(SINCH_DIR, 'sinch-completion.bash');
+  const sourceLine = `source ${shellEscapePath(completionFile)}`;
+  const block = `${SENTINEL_START}\n${sourceLine}\n${SENTINEL_END}`;
+
+  const home = os.homedir();
+  const zshrc = path.join(home, '.zshrc');
+  const bashrc = path.join(home, '.bashrc');
+
+  const rcFiles = [];
+  if (process.platform === 'darwin') {
+    rcFiles.push(zshrc);
+    if (fs.existsSync(bashrc)) rcFiles.push(bashrc);
+  } else {
+    if (fs.existsSync(bashrc)) rcFiles.push(bashrc);
+    if (fs.existsSync(zshrc)) rcFiles.push(zshrc);
+    if (rcFiles.length === 0) rcFiles.push(bashrc);
+  }
+
+  for (const rcFile of rcFiles) {
+    let content = '';
+    try {
+      content = fs.readFileSync(rcFile, 'utf8');
+    } catch {
+      // File doesn't exist yet — will be created
+    }
+    fs.writeFileSync(rcFile, upsertBlock(content, block));
+  }
+}
+
+// --- Main ---
+
+async function main() {
+  // Only run on global installs or when forced by setup-dev.js
+  if (process.env.npm_config_global !== 'true' && !process.env.SINCH_FORCE_POSTINSTALL) {
+    return;
+  }
+
+  try {
+    fs.mkdirSync(SINCH_DIR, { recursive: true });
+
+    const version = getVersion();
+    writeCompletionsJson(version);
+
+    if (process.platform === 'win32') {
+      await installPowerShellCompletion();
+    } else {
+      installBashZshCompletion();
+    }
+  } catch {
+    // Silent failure — never break npm install
+  }
+}
+
+main();

package/scripts/setup-dev.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+const { execSync, spawn } = require('child_process');
+
+const SINCH_BIN = path.join(os.homedir(), '.sinch', 'bin');
+const BINARY_NAME = process.platform === 'win32' ? 'sinch.exe' : 'sinch';
+const BINARY_SRC = path.join(__dirname, '..', 'dist', 'sinch-bun.exe');
+const BINARY_DEST = path.join(SINCH_BIN, BINARY_NAME);
+
+async function setup() {
+  console.log('\n🔧 Setting up Sinch CLI development environment\n');
+
+  // 1. Copy Bun binary to ~/.sinch/bin/
+  console.log('📦 Installing Bun binary...');
+  await fs.ensureDir(SINCH_BIN);
+
+  if (await fs.pathExists(BINARY_SRC)) {
+    await fs.copy(BINARY_SRC, BINARY_DEST, { overwrite: true });
+    if (process.platform !== 'win32') {
+      await fs.chmod(BINARY_DEST, 0o755);
+    }
+    console.log(`   ✅ Installed to ${BINARY_DEST}`);
+  } else {
+    console.log('   ⚠️  Bun binary not found — run "npm run build:binary" first');
+    console.log(`   Expected at: ${BINARY_SRC}`);
+  }
+
+  // 2. Generate PowerShell profile additions
+  if (process.platform === 'win32') {
+    await setupPowerShell();
+  } else {
+    await setupShell();
+  }
+
+  // 3. Install shell completions
+  console.log('\n🔧 Installing shell completions...');
+  try {
+    await installCompletions();
+    console.log('   ✅ Completions installed');
+  } catch (e) {
+    console.log(`   ⚠️  Completion install failed: ${e.message}`);
+  }
+
+  // 4. Smoke test
+  console.log('\n🧪 Smoke test...');
+  try {
+    const version = execSync(`"${BINARY_DEST}" --version`, { encoding: 'utf8' }).trim();
+    console.log(`   ✅ sinch binary v${version}`);
+  } catch (e) {
+    console.log(`   ⚠️  Binary smoke test failed: ${e.message}`);
+  }
+
+  try {
+    const devVersion = execSync('sinch --version', { encoding: 'utf8' }).trim();
+    console.log(`   ✅ sinch dev (npm link) v${devVersion}`);
+  } catch (e) {
+    console.log(`   ⚠️  npm link not set up: ${e.message}`);
+  }
+
+  console.log('\n✨ Setup complete!\n');
+  console.log('Commands:');
+  console.log('  s            → Fast Bun binary (for daily use)');
+  console.log('  sf <cmd>     → Shortcut for "s functions <cmd>"');
+  console.log('  sd <cmd>     → Dev version via npm link (for CLI development)');
+  console.log('  sinch <cmd>  → Same as sd (npm-linked)');
+  console.log('');
+
+  if (process.platform === 'win32') {
+    console.log('⚡ Restart PowerShell or run: . $PROFILE');
+  } else {
+    console.log('⚡ Restart your shell or run: source ~/.bashrc');
+  }
+  console.log('');
+}
+
+async function setupPowerShell() {
+  console.log('\n🖥️  Setting up PowerShell aliases...');
+
+  const profileSnippet = `
+# ── Sinch CLI aliases (auto-generated by sinch-cli setup) ──
+function s { & "$env:USERPROFILE\\.sinch\\bin\\sinch.exe" @args }
+function sf { & "$env:USERPROFILE\\.sinch\\bin\\sinch.exe" functions @args }
+function sd { & sinch @args }
+# ── End Sinch CLI aliases ──
+`.trim();
+
+  // Find PowerShell profile
+  const profilePath = await getPowerShellProfilePath();
+
+  if (!profilePath) {
+    console.log('   ⚠️  Could not detect PowerShell profile path');
+    console.log('   Add these to your PowerShell profile manually:\n');
+    console.log(profileSnippet);
+    return;
+  }
+
+  // Read existing profile
+  let profileContent = '';
+  if (await fs.pathExists(profilePath)) {
+    profileContent = await fs.readFile(profilePath, 'utf8');
+  }
+
+  // Check if already installed
+  if (profileContent.includes('Sinch CLI aliases')) {
+    // Replace existing block
+    const replaced = profileContent.replace(
+      /# ── Sinch CLI aliases.*?# ── End Sinch CLI aliases ──/s,
+      profileSnippet
+    );
+    await fs.writeFile(profilePath, replaced);
+    console.log(`   ✅ Updated aliases in ${profilePath}`);
+  } else {
+    // Append
+    await fs.writeFile(profilePath, profileContent + '\n\n' + profileSnippet + '\n');
+    console.log(`   ✅ Added aliases to ${profilePath}`);
+  }
+}
+
+async function setupShell() {
+  console.log('\n🖥️  Setting up shell aliases...');
+
+  const snippet = `
+# ── Sinch CLI aliases (auto-generated by sinch-cli setup) ──
+alias s='$HOME/.sinch/bin/sinch'
+sf() { $HOME/.sinch/bin/sinch functions "$@"; }
+alias sd='sinch'
+# ── End Sinch CLI aliases ──
+`.trim();
+
+  // Try .bashrc, then .zshrc
+  const rcFile = (await fs.pathExists(path.join(os.homedir(), '.zshrc')))
+    ? path.join(os.homedir(), '.zshrc')
+    : path.join(os.homedir(), '.bashrc');
+
+  let content = '';
+  if (await fs.pathExists(rcFile)) {
+    content = await fs.readFile(rcFile, 'utf8');
+  }
+
+  if (content.includes('Sinch CLI aliases')) {
+    const replaced = content.replace(
+      /# ── Sinch CLI aliases.*?# ── End Sinch CLI aliases ──/s,
+      snippet
+    );
+    await fs.writeFile(rcFile, replaced);
+    console.log(`   ✅ Updated aliases in ${rcFile}`);
+  } else {
+    await fs.writeFile(rcFile, content + '\n\n' + snippet + '\n');
+    console.log(`   ✅ Added aliases to ${rcFile}`);
+  }
+}
+
+async function installCompletions() {
+  execSync('node scripts/postinstall.js', {
+    cwd: path.join(__dirname, '..'),
+    env: { ...process.env, SINCH_FORCE_POSTINSTALL: '1' },
+    stdio: 'pipe',
+  });
+}
+
+function getPowerShellProfilePath() {
+  return new Promise((resolve) => {
+    // Try pwsh first, then powershell
+    const tryShell = (cmd) => {
+      return new Promise((res) => {
+        const ps = spawn(cmd, ['-NoProfile', '-Command', '$PROFILE'], {
+          stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let out = '';
+        ps.stdout.on('data', (d) => (out += d.toString()));
+        ps.on('close', (code) => res(code === 0 ? out.trim() : null));
+        ps.on('error', () => res(null));
+      });
+    };
+
+    tryShell('pwsh').then((p) => {
+      if (p) return resolve(p);
+      tryShell('powershell').then((p2) => resolve(p2));
+    });
+  });
+}
+
+setup().catch((err) => {
+  console.error('Setup failed:', err.message);
+  process.exit(1);
+});

package/scripts/smoke-test.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+
+/**
+ * Smoke test for the Bun-compiled binary.
+ * Verifies the binary works for key code paths that could differ from Node.js.
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const rawBinary =
+  process.argv[2] ||
+  path.join(os.homedir(), '.sinch', 'bin', process.platform === 'win32' ? 'sinch.exe' : 'sinch');
+const BINARY = path.resolve(rawBinary);
+
+let passed = 0;
+let failed = 0;
+
+function test(name, fn) {
+  try {
+    fn();
+    console.log(`  ✅ ${name}`);
+    passed++;
+  } catch (e) {
+    console.log(`  ❌ ${name}: ${e.message}`);
+    failed++;
+  }
+}
+
+function run(args) {
+  return execSync(`"${BINARY}" ${args}`, {
+    encoding: 'utf8',
+    timeout: 10000,
+    env: { ...process.env, CI: '1' },
+  }).trim();
+}
+
+console.log(`\n🧪 Smoke testing: ${BINARY}\n`);
+
+test('--version returns semver', () => {
+  const version = run('--version');
+  if (!/^\d+\.\d+\.\d+/.test(version)) {
+    throw new Error(`Got: ${version}`);
+  }
+});
+
+test('--help shows all top-level commands', () => {
+  const help = run('--help');
+  const required = ['functions', 'templates', 'voice', 'auth', 'config', 'fax', 'sip', 'numbers'];
+  for (const cmd of required) {
+    if (!help.includes(cmd)) {
+      throw new Error(`Missing command: ${cmd}`);
+    }
+  }
+});
+
+test('functions --help shows subcommands', () => {
+  const help = run('functions --help');
+  const required = ['init', 'list', 'deploy', 'dev', 'status', 'logs'];
+  for (const cmd of required) {
+    if (!help.includes(cmd)) {
+      throw new Error(`Missing subcommand: ${cmd}`);
+    }
+  }
+});
+
+test('fax --help shows subcommands', () => {
+  const help = run('fax --help');
+  if (!help.includes('send') || !help.includes('list')) {
+    throw new Error('Missing fax subcommands');
+  }
+});
+
+test('sip --help shows subcommands', () => {
+  const help = run('sip --help');
+  if (!help.includes('trunks') || !help.includes('endpoints')) {
+    throw new Error('Missing sip subcommands');
+  }
+});
+
+test('config --help shows subcommands', () => {
+  const help = run('config --help');
+  if (!help.includes('set') || !help.includes('get') || !help.includes('profile')) {
+    throw new Error('Missing config subcommands');
+  }
+});
+
+console.log(`\n${passed} passed, ${failed} failed\n`);
+process.exit(failed > 0 ? 1 : 0);

package/dist/index.d.ts

@@ -1 +0,0 @@
-#!/usr/bin/env node