@velaro/cli 0.5.0 → 1.2.0

package/lib/commands/site.js

@@ -1,62 +1,62 @@
-import { get }       from '../api.js';
-import { runCommand } from '../run.js';
-
-const FEATURE_MAP = {
-  enableWeb:                'Web Chat',
-  enableSms:                'SMS',
-  enableEmail:              'Email',
-  enableWhatsapp:           'WhatsApp',
-  enableIvr:                'IVR / Voice',
-  enableFacebook:           'Facebook Messenger',
-  enableInstagram:          'Instagram',
-  enableAI:                 'AI Bots',
-  enableKnowledgeBase:      'Knowledge Base',
-  enableAutomation:         'Workflows',
-  enableWorkflowRules:      'Routing Rules',
-  enableChatTranslations:   'Chat Translation',
-  enableVideoChat:          'Video Chat',
-  enableTicketing:          'Ticketing',
-  enableAgentDashboard:     'Agent Dashboard',
-  enableMcpApi:             'MCP API Gateway',
-  enableOutboundCampaigns:  'Email Campaigns',
-  enableRcs:                'RCS Messaging',
-  enablePageWidgets:        'Page Widgets',
-  enableVisitorTracking:    'Visitor Tracking',
-};
-
-const STATUS_LABEL = { Available: 'online', Away: 'away', Offline: 'offline' };
-
-export const siteCommand = {
-  command:  'site',
-  describe: 'Show site overview: active features and agent availability',
-  handler:  runCommand(async () => {
-    const [sub, agents] = await Promise.all([
-      get('/Subscription'),
-      get('/Users/List'),
-    ]);
-
-    // Active features — friendly names only, no internal flag names
-    const active = Object.entries(FEATURE_MAP)
-      .filter(([key]) => sub[key] === true)
-      .map(([, label]) => label);
-
-    console.log('\nActive features:');
-    if (active.length) {
-      console.log('  ' + active.join('  ·  '));
-    } else {
-      console.log('  (none)');
-    }
-
-    if (sub.maxCreatedUsers) {
-      console.log(`\nAgent seats: ${sub.maxCreatedUsers} licensed`);
-    }
-
-    // Agent availability summary
-    const counts = { online: 0, away: 0, offline: 0 };
-    for (const a of agents) {
-      const key = STATUS_LABEL[a.status] ?? 'offline';
-      counts[key]++;
-    }
-    console.log(`Agent status: ${counts.online} online · ${counts.away} away · ${counts.offline} offline\n`);
-  }),
-};
+import { get }       from '../api.js';
+import { runCommand } from '../run.js';
+
+const FEATURE_MAP = {
+  enableWeb:                'Web Chat',
+  enableSms:                'SMS',
+  enableEmail:              'Email',
+  enableWhatsapp:           'WhatsApp',
+  enableIvr:                'IVR / Voice',
+  enableFacebook:           'Facebook Messenger',
+  enableInstagram:          'Instagram',
+  enableAI:                 'AI Bots',
+  enableKnowledgeBase:      'Knowledge Base',
+  enableAutomation:         'Workflows',
+  enableWorkflowRules:      'Routing Rules',
+  enableChatTranslations:   'Chat Translation',
+  enableVideoChat:          'Video Chat',
+  enableTicketing:          'Ticketing',
+  enableAgentDashboard:     'Agent Dashboard',
+  enableMcpApi:             'MCP API Gateway',
+  enableOutboundCampaigns:  'Email Campaigns',
+  enableRcs:                'RCS Messaging',
+  enablePageWidgets:        'Page Widgets',
+  enableVisitorTracking:    'Visitor Tracking',
+};
+
+const STATUS_LABEL = { Available: 'online', Away: 'away', Offline: 'offline' };
+
+export const siteCommand = {
+  command:  'site',
+  describe: 'Show site overview: active features and agent availability',
+  handler:  runCommand(async () => {
+    const [sub, agents] = await Promise.all([
+      get('/Subscription'),
+      get('/Users/List'),
+    ]);
+
+    // Active features — friendly names only, no internal flag names
+    const active = Object.entries(FEATURE_MAP)
+      .filter(([key]) => sub[key] === true)
+      .map(([, label]) => label);
+
+    console.log('\nActive features:');
+    if (active.length) {
+      console.log('  ' + active.join('  ·  '));
+    } else {
+      console.log('  (none)');
+    }
+
+    if (sub.maxCreatedUsers) {
+      console.log(`\nAgent seats: ${sub.maxCreatedUsers} licensed`);
+    }
+
+    // Agent availability summary
+    const counts = { online: 0, away: 0, offline: 0 };
+    for (const a of agents) {
+      const key = STATUS_LABEL[a.status] ?? 'offline';
+      counts[key]++;
+    }
+    console.log(`Agent status: ${counts.online} online · ${counts.away} away · ${counts.offline} offline\n`);
+  }),
+};

package/lib/commands/status.js

@@ -1,24 +1,24 @@
-import { readConfig, getActiveEnv, ENVS } from '../config.js';
-
-export const statusCommand = {
-  command:  'status',
-  describe: 'Check Velaro API health',
-  handler:  async () => {
-    const cfg     = readConfig();
-    const env     = getActiveEnv();
-    const apiBase = cfg.envs?.[env]?.adminApiBase ?? ENVS[env].adminApiBase;
-    process.stdout.write(`Checking ${apiBase}/Status ... `);
-    try {
-      const res = await fetch(`${apiBase}/Status`);
-      if (res.ok) {
-        console.log('OK');
-      } else {
-        console.log(`DEGRADED (HTTP ${res.status})`);
-        process.exit(1);
-      }
-    } catch (err) {
-      console.log(`UNREACHABLE: ${err.message}`);
-      process.exit(1);
-    }
-  },
-};
+import { readConfig, getActiveEnv, ENVS } from '../config.js';
+
+export const statusCommand = {
+  command:  'status',
+  describe: 'Check Velaro API health',
+  handler:  async () => {
+    const cfg     = readConfig();
+    const env     = getActiveEnv();
+    const apiBase = cfg.envs?.[env]?.adminApiBase ?? ENVS[env].adminApiBase;
+    process.stdout.write(`Checking ${apiBase}/Status ... `);
+    try {
+      const res = await fetch(`${apiBase}/Status`);
+      if (res.ok) {
+        console.log('OK');
+      } else {
+        console.log(`DEGRADED (HTTP ${res.status})`);
+        process.exit(1);
+      }
+    } catch (err) {
+      console.log(`UNREACHABLE: ${err.message}`);
+      process.exit(1);
+    }
+  },
+};

package/lib/commands/team.js

@@ -1,144 +1,144 @@
-import { get, post }  from '../api.js';
-import { runCommand } from '../run.js';
-
-export const teamCommand = {
-  command:  'team <subcommand>',
-  describe: 'View teams and manage widget placements (deployments)',
-  builder:  (yargs) =>
-    yargs
-      .command(teamListCommand)
-      .command(widgetListCommand)
-      .command(widgetRenameCommand)
-      .command(widgetAssignCommand)
-      .demandCommand(1, 'Specify a subcommand: list, widget'),
-  handler: () => {},
-};
-
-// ── team list ──────────────────────────────────────────────────────────────────
-// Shows teams and their widget placements inline — the mental model is:
-//   team = who handles conversations
-//   widget = which pages route to that team
-
-const teamListCommand = {
-  command:  'list',
-  describe: 'List teams and their widget placements',
-  handler:  runCommand(async () => {
-    const [teams, deployments] = await Promise.all([
-      get('/Teams/List'),
-      get('/Deployment'),
-    ]);
-
-    if (!teams?.length) {
-      console.log('No teams found.');
-      return;
-    }
-
-    // Group deployments by team
-    const byTeam = {};
-    for (const d of (deployments ?? [])) {
-      if (!byTeam[d.teamId]) byTeam[d.teamId] = [];
-      byTeam[d.teamId].push(d);
-    }
-
-    for (const t of teams) {
-      const widgets = byTeam[t.id] ?? [];
-      const routing = t.routingAction ? `  routing=${t.routingAction}` : '';
-      console.log(`\n[${t.id}] ${t.name}${routing}`);
-
-      if (widgets.length) {
-        for (const w of widgets) {
-          console.log(`     widget [${w.id}] "${w.displayName ?? 'unnamed'}"  key: ${w.deploymentId}`);
-        }
-      } else {
-        console.log(`     (no widgets assigned — conversations can reach this team via routing rules)`);
-      }
-    }
-
-    console.log(`\n${teams.length} team(s)  ·  ${(deployments ?? []).length} widget(s)`);
-    console.log('\nPaste a widget key into your page\'s embed snippet to route that page to its team.');
-  }),
-};
-
-// ── widget subcommands ─────────────────────────────────────────────────────────
-// "Widget" is the user-facing term. Internally these are deployments.
-// A widget is a snippet you paste on a page. The page routes to the widget's team.
-
-const widgetListCommand = {
-  command:  'widget list',
-  describe: 'List all widgets (embed snippets) and which team each routes to',
-  handler:  runCommand(async () => {
-    const [deployments, teams] = await Promise.all([
-      get('/Deployment'),
-      get('/Teams/List'),
-    ]);
-
-    if (!deployments?.length) {
-      console.log('No widgets found.');
-      console.log('\nCreate a widget in the Velaro admin under Deployments,');
-      console.log('then paste its embed snippet on the pages you want chat on.');
-      return;
-    }
-
-    const teamMap = Object.fromEntries((teams ?? []).map(t => [t.id, t.name]));
-    const rows    = deployments.map(d => ({
-      id:   `[${d.id}]`,
-      key:  d.deploymentId ?? '—',
-      team: teamMap[d.teamId] ?? `team ${d.teamId}`,
-      name: d.displayName ?? '(unnamed)',
-    }));
-
-    const idW   = Math.max(...rows.map(r => r.id.length));
-    const keyW  = Math.max('embed-key'.length, ...rows.map(r => r.key.length));
-    const teamW = Math.max('routes-to'.length, ...rows.map(r => r.team.length));
-
-    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'routes-to'.padEnd(teamW)}  name`);
-    console.log(`${'-'.repeat(idW)}  ${'-'.repeat(keyW)}  ${'-'.repeat(teamW)}  ----`);
-    for (const r of rows) {
-      console.log(`${r.id.padStart(idW)}  ${r.key.padEnd(keyW)}  ${r.team.padEnd(teamW)}  ${r.name}`);
-    }
-    console.log(`\n${rows.length} widget(s)`);
-  }),
-};
-
-const widgetRenameCommand = {
-  command:  'widget rename <id> <name>',
-  describe: 'Rename a widget',
-  builder:  (y) =>
-    y
-      .positional('id',   { type: 'number', describe: 'Widget ID' })
-      .positional('name', { type: 'string', describe: 'New name' }),
-  handler: runCommand(async (argv) => {
-    const dep = await get(`/Deployment/${argv.id}`);
-    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
-    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
-    console.log(`Widget ${argv.id} renamed to "${argv.name}".`);
-  }),
-};
-
-const widgetAssignCommand = {
-  command:  'widget assign <id> <team-id>',
-  describe: 'Point a widget at a different team (embed code stays the same)',
-  builder:  (y) =>
-    y
-      .positional('id',      { type: 'number', describe: 'Widget ID' })
-      .positional('team-id', { type: 'number', describe: 'Team ID to route to' }),
-  handler: runCommand(async (argv) => {
-    const [dep, teams] = await Promise.all([
-      get(`/Deployment/${argv.id}`),
-      get('/Teams/List'),
-    ]);
-
-    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
-
-    const team = (teams ?? []).find(t => t.id === argv['team-id']);
-    if (!team) {
-      console.error(`Team ${argv['team-id']} not found.`);
-      console.error('Run: velaro team list');
-      process.exit(1);
-    }
-
-    await post('/Deployment', { ...dep, id: argv.id, teamId: argv['team-id'] });
-    console.log(`Widget "${dep.displayName ?? dep.id}" now routes to team "${team.name}".`);
-    console.log('Your embed snippet is unchanged — no website edits needed.');
-  }),
-};
+import { get, post }  from '../api.js';
+import { runCommand } from '../run.js';
+
+export const teamCommand = {
+  command:  'team <subcommand>',
+  describe: 'View teams and manage widget placements (deployments)',
+  builder:  (yargs) =>
+    yargs
+      .command(teamListCommand)
+      .command(widgetListCommand)
+      .command(widgetRenameCommand)
+      .command(widgetAssignCommand)
+      .demandCommand(1, 'Specify a subcommand: list, widget'),
+  handler: () => {},
+};
+
+// ── team list ──────────────────────────────────────────────────────────────────
+// Shows teams and their widget placements inline — the mental model is:
+//   team = who handles conversations
+//   widget = which pages route to that team
+
+const teamListCommand = {
+  command:  'list',
+  describe: 'List teams and their widget placements',
+  handler:  runCommand(async () => {
+    const [teams, deployments] = await Promise.all([
+      get('/Teams/List'),
+      get('/Deployment'),
+    ]);
+
+    if (!teams?.length) {
+      console.log('No teams found.');
+      return;
+    }
+
+    // Group deployments by team
+    const byTeam = {};
+    for (const d of (deployments ?? [])) {
+      if (!byTeam[d.teamId]) byTeam[d.teamId] = [];
+      byTeam[d.teamId].push(d);
+    }
+
+    for (const t of teams) {
+      const widgets = byTeam[t.id] ?? [];
+      const routing = t.routingAction ? `  routing=${t.routingAction}` : '';
+      console.log(`\n[${t.id}] ${t.name}${routing}`);
+
+      if (widgets.length) {
+        for (const w of widgets) {
+          console.log(`     widget [${w.id}] "${w.displayName ?? 'unnamed'}"  key: ${w.deploymentId}`);
+        }
+      } else {
+        console.log(`     (no widgets assigned — conversations can reach this team via routing rules)`);
+      }
+    }
+
+    console.log(`\n${teams.length} team(s)  ·  ${(deployments ?? []).length} widget(s)`);
+    console.log('\nPaste a widget key into your page\'s embed snippet to route that page to its team.');
+  }),
+};
+
+// ── widget subcommands ─────────────────────────────────────────────────────────
+// "Widget" is the user-facing term. Internally these are deployments.
+// A widget is a snippet you paste on a page. The page routes to the widget's team.
+
+const widgetListCommand = {
+  command:  'widget list',
+  describe: 'List all widgets (embed snippets) and which team each routes to',
+  handler:  runCommand(async () => {
+    const [deployments, teams] = await Promise.all([
+      get('/Deployment'),
+      get('/Teams/List'),
+    ]);
+
+    if (!deployments?.length) {
+      console.log('No widgets found.');
+      console.log('\nCreate a widget in the Velaro admin under Deployments,');
+      console.log('then paste its embed snippet on the pages you want chat on.');
+      return;
+    }
+
+    const teamMap = Object.fromEntries((teams ?? []).map(t => [t.id, t.name]));
+    const rows    = deployments.map(d => ({
+      id:   `[${d.id}]`,
+      key:  d.deploymentId ?? '—',
+      team: teamMap[d.teamId] ?? `team ${d.teamId}`,
+      name: d.displayName ?? '(unnamed)',
+    }));
+
+    const idW   = Math.max(...rows.map(r => r.id.length));
+    const keyW  = Math.max('embed-key'.length, ...rows.map(r => r.key.length));
+    const teamW = Math.max('routes-to'.length, ...rows.map(r => r.team.length));
+
+    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'routes-to'.padEnd(teamW)}  name`);
+    console.log(`${'-'.repeat(idW)}  ${'-'.repeat(keyW)}  ${'-'.repeat(teamW)}  ----`);
+    for (const r of rows) {
+      console.log(`${r.id.padStart(idW)}  ${r.key.padEnd(keyW)}  ${r.team.padEnd(teamW)}  ${r.name}`);
+    }
+    console.log(`\n${rows.length} widget(s)`);
+  }),
+};
+
+const widgetRenameCommand = {
+  command:  'widget rename <id> <name>',
+  describe: 'Rename a widget',
+  builder:  (y) =>
+    y
+      .positional('id',   { type: 'number', describe: 'Widget ID' })
+      .positional('name', { type: 'string', describe: 'New name' }),
+  handler: runCommand(async (argv) => {
+    const dep = await get(`/Deployment/${argv.id}`);
+    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
+    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
+    console.log(`Widget ${argv.id} renamed to "${argv.name}".`);
+  }),
+};
+
+const widgetAssignCommand = {
+  command:  'widget assign <id> <team-id>',
+  describe: 'Point a widget at a different team (embed code stays the same)',
+  builder:  (y) =>
+    y
+      .positional('id',      { type: 'number', describe: 'Widget ID' })
+      .positional('team-id', { type: 'number', describe: 'Team ID to route to' }),
+  handler: runCommand(async (argv) => {
+    const [dep, teams] = await Promise.all([
+      get(`/Deployment/${argv.id}`),
+      get('/Teams/List'),
+    ]);
+
+    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
+
+    const team = (teams ?? []).find(t => t.id === argv['team-id']);
+    if (!team) {
+      console.error(`Team ${argv['team-id']} not found.`);
+      console.error('Run: velaro team list');
+      process.exit(1);
+    }
+
+    await post('/Deployment', { ...dep, id: argv.id, teamId: argv['team-id'] });
+    console.log(`Widget "${dep.displayName ?? dep.id}" now routes to team "${team.name}".`);
+    console.log('Your embed snippet is unchanged — no website edits needed.');
+  }),
+};

package/lib/commands/update.js

@@ -1,47 +1,47 @@
-import { execSync }    from 'child_process';
-import { createRequire } from 'module';
-
-const require = createRequire(import.meta.url);
-const { version: currentVersion } = require('../../package.json');
-
-const NPM_REGISTRY = 'https://registry.npmjs.org/@velaro/cli/latest';
-
-export const updateCommand = {
-  command:  'update',
-  describe: 'Update the Velaro CLI to the latest version',
-  handler:  async () => {
-    process.stdout.write('Checking for updates... ');
-
-    let latest;
-    try {
-      const res = await fetch(NPM_REGISTRY, { signal: AbortSignal.timeout(8000) });
-      const data = await res.json();
-      latest = data?.version;
-    } catch {
-      console.error('Could not reach npm registry. Check your connection and try again.');
-      process.exit(1);
-    }
-
-    if (!latest) {
-      console.error('Could not determine the latest version.');
-      process.exit(1);
-    }
-
-    if (latest === currentVersion) {
-      console.log(`already up to date (${currentVersion}).`);
-      return;
-    }
-
-    console.log(`${currentVersion} → ${latest}`);
-    console.log('Running: npm install -g @velaro/cli@latest\n');
-
-    try {
-      execSync('npm install -g @velaro/cli@latest', { stdio: 'inherit' });
-      console.log('\nUpdated successfully. Run velaro --version to confirm.');
-    } catch {
-      console.error('\nUpdate failed. Try running manually:');
-      console.error('  npm install -g @velaro/cli@latest');
-      process.exit(1);
-    }
-  },
-};
+import { execSync }    from 'child_process';
+import { createRequire } from 'module';
+
+const require = createRequire(import.meta.url);
+const { version: currentVersion } = require('../../package.json');
+
+const NPM_REGISTRY = 'https://registry.npmjs.org/@velaro/cli/latest';
+
+export const updateCommand = {
+  command:  'update',
+  describe: 'Update the Velaro CLI to the latest version',
+  handler:  async () => {
+    process.stdout.write('Checking for updates... ');
+
+    let latest;
+    try {
+      const res = await fetch(NPM_REGISTRY, { signal: AbortSignal.timeout(8000) });
+      const data = await res.json();
+      latest = data?.version;
+    } catch {
+      console.error('Could not reach npm registry. Check your connection and try again.');
+      process.exit(1);
+    }
+
+    if (!latest) {
+      console.error('Could not determine the latest version.');
+      process.exit(1);
+    }
+
+    if (latest === currentVersion) {
+      console.log(`already up to date (${currentVersion}).`);
+      return;
+    }
+
+    console.log(`${currentVersion} → ${latest}`);
+    console.log('Running: npm install -g @velaro/cli@latest\n');
+
+    try {
+      execSync('npm install -g @velaro/cli@latest', { stdio: 'inherit' });
+      console.log('\nUpdated successfully. Run velaro --version to confirm.');
+    } catch {
+      console.error('\nUpdate failed. Try running manually:');
+      console.error('  npm install -g @velaro/cli@latest');
+      process.exit(1);
+    }
+  },
+};

package/lib/commands/whoami.js

@@ -1,22 +1,22 @@
-import { readConfig } from '../config.js';
-
-export const whoamiCommand = {
-  command:  'whoami',
-  describe: 'Show current login and site info',
-  handler:  () => {
-    const cfg = readConfig();
-
-    if (!cfg?.velaroToken) {
-      console.error('Not logged in. Run: velaro login');
-      process.exit(1);
-    }
-
-    const expires = new Date(cfg.velaroExpires);
-    const minLeft = Math.round((expires - Date.now()) / 60000);
-
-    console.log(`User:    ${cfg.userName ?? '(unknown)'}`);
-    console.log(`Site ID: ${cfg.siteId   ?? '(unknown)'}`);
-    console.log(`API:     ${cfg.apiBase}`);
-    console.log(`Token:   ${expires > new Date() ? `valid (expires in ${minLeft}m)` : 'EXPIRED — run velaro login'}`);
-  },
-};
+import { readConfig } from '../config.js';
+
+export const whoamiCommand = {
+  command:  'whoami',
+  describe: 'Show current login and site info',
+  handler:  () => {
+    const cfg = readConfig();
+
+    if (!cfg?.velaroToken) {
+      console.error('Not logged in. Run: velaro login');
+      process.exit(1);
+    }
+
+    const expires = new Date(cfg.velaroExpires);
+    const minLeft = Math.round((expires - Date.now()) / 60000);
+
+    console.log(`User:    ${cfg.userName ?? '(unknown)'}`);
+    console.log(`Site ID: ${cfg.siteId   ?? '(unknown)'}`);
+    console.log(`API:     ${cfg.apiBase}`);
+    console.log(`Token:   ${expires > new Date() ? `valid (expires in ${minLeft}m)` : 'EXPIRED — run velaro login'}`);
+  },
+};