@velaro/cli 0.4.0 → 0.7.0

package/lib/commands/check.js

@@ -1,163 +1,163 @@
-/**
- * velaro check — full site health and configuration summary.
- *
- * Shows every feature area with:
- *   ✓  enabled and configured
- *   ⚠  enabled but nothing configured yet
- *   ✗  not on your plan
- */
-
-import { get }        from '../api.js';
-import { getSubscription } from '../subscription.js';
-import { runCommand } from '../run.js';
-
-const TICK  = '✓';
-const WARN  = '⚠';
-const CROSS = '✗';
-
-export const checkCommand = {
-  command:  'check',
-  describe: 'Show full site configuration and health summary',
-  handler:  runCommand(async () => {
-    const [sub, apiStatus] = await Promise.all([
-      getSubscription().catch(() => null),
-      get('/Status').catch(() => null),
-    ]);
-
-    if (!sub) {
-      console.error('Could not retrieve subscription. Check your login: velaro whoami');
-      process.exit(1);
-    }
-
-    const ok  = (msg) => console.log(`  ${TICK}  ${msg}`);
-    const warn = (msg) => console.log(`  ${WARN}  ${msg}`);
-    const off  = (msg) => console.log(`  ${CROSS}  ${msg}`);
-
-    console.log('\n── API Health ────────────────────────────────────────────────');
-    if (apiStatus) {
-      ok(`API reachable`);
-    } else {
-      warn('API did not respond to /Status');
-    }
-
-    // ── Deployments ─────────────────────────────────────────────────────────
-    console.log('\n── Deployments ───────────────────────────────────────────────');
-    try {
-      const [deps, teams] = await Promise.all([get('/Deployment'), get('/Teams/List')]);
-      const teamMap = Object.fromEntries((teams ?? []).map(t => [t.id, t.name]));
-      if (deps?.length) {
-        for (const d of deps) {
-          ok(`[${d.id}] "${d.displayName}"  →  team: ${teamMap[d.teamId] ?? `#${d.teamId}`}  (embed key: ${d.deploymentId})`);
-        }
-      } else {
-        warn('No deployments — create one in the admin UI to get your embed snippet.');
-      }
-    } catch { warn('Could not load deployments'); }
-
-    // ── AI Bots ──────────────────────────────────────────────────────────────
-    console.log('\n── AI Bots ───────────────────────────────────────────────────');
-    if (sub.enableAI) {
-      try {
-        const bots = await get('/AIConfiguration/list');
-        if (bots?.length) {
-          for (const b of bots) ok(`[${b.id}] "${b.name}"  model=${b.aiModel ?? 'default'}`);
-        } else {
-          warn('AI enabled but no bots configured. Run: velaro bot setup --name "My Bot"');
-        }
-      } catch { warn('Could not load bot list'); }
-    } else {
-      off('AI Bots — not on your plan  (upgrade at velaro.com/pricing)');
-    }
-
-    // ── Knowledge Base ───────────────────────────────────────────────────────
-    console.log('\n── Knowledge Base ────────────────────────────────────────────');
-    if (sub.enableKnowledgeBase) {
-      try {
-        const [qna, overrides] = await Promise.all([
-          get('/api/BotQnA').catch(() => []),
-          get('/Ticket/knowledge-overrides').catch(() => []),
-        ]);
-        ok(`${qna?.length ?? 0} Q&A pair(s)  ·  ${overrides?.length ?? 0} override(s)`);
-      } catch { warn('Could not load knowledge base'); }
-    } else {
-      off('Knowledge Base — not on your plan');
-    }
-
-    // ── Workflows ────────────────────────────────────────────────────────────
-    console.log('\n── Workflows ─────────────────────────────────────────────────');
-    if (sub.enableAutomation) {
-      try {
-        const workflows = (await get('/Workflows/List') ?? []).filter(w => !w.isTemplate);
-        const enabled   = workflows.filter(w => w.enabled).length;
-        const disabled  = workflows.length - enabled;
-        if (workflows.length) {
-          ok(`${workflows.length} workflow(s)  ·  ${enabled} enabled  ·  ${disabled} disabled`);
-          for (const w of workflows) {
-            const sym = w.enabled ? TICK : WARN;
-            console.log(`       ${sym}  [${w.id}] "${w.name}"  (${w.enabled ? 'on' : 'off'})`);
-          }
-        } else {
-          warn('Automation enabled but no workflows configured.');
-        }
-      } catch { warn('Could not load workflows'); }
-    } else {
-      off('Workflows — not on your plan');
-    }
-
-    // ── Routing Rules ────────────────────────────────────────────────────────
-    console.log('\n── Routing Rules ─────────────────────────────────────────────');
-    if (sub.enableWorkflowRules) {
-      try {
-        const rules = await get('/Rules/List');
-        if (rules?.length) {
-          ok(`${rules.length} routing rule(s) configured`);
-        } else {
-          warn('Routing rules enabled but none configured.');
-        }
-      } catch { warn('Could not load rules'); }
-    } else {
-      off('Routing Rules — not on your plan');
-    }
-
-    // ── Channels ─────────────────────────────────────────────────────────────
-    console.log('\n── Channels ──────────────────────────────────────────────────');
-    const channels = [
-      ['enableWeb',       'Web Chat'],
-      ['enableSms',       'SMS'],
-      ['enableEmail',     'Email'],
-      ['enableWhatsapp',  'WhatsApp'],
-      ['enableIvr',       'IVR / Voice'],
-      ['enableFacebook',  'Facebook Messenger'],
-      ['enableInstagram', 'Instagram'],
-      ['enableRcs',       'RCS'],
-    ];
-    for (const [flag, label] of channels) {
-      if (sub[flag]) ok(label); else off(`${label} — not on your plan`);
-    }
-
-    // ── IVR detail ───────────────────────────────────────────────────────────
-    if (sub.enableIvr) {
-      try {
-        const ivr = await get('/api/ivr/config');
-        if (ivr?.phoneNumber) {
-          console.log(`\n── IVR Config ────────────────────────────────────────────────`);
-          ok(`Phone: ${ivr.phoneNumber}`);
-          if (ivr.bridgeNumber) ok(`Bridge: ${ivr.bridgeNumber}`);
-          else warn('No bridge (transfer) number set — agents cannot receive transferred calls.');
-        }
-      } catch { /* IVR config is optional */ }
-    }
-
-    // ── Agents ───────────────────────────────────────────────────────────────
-    console.log('\n── Agents ────────────────────────────────────────────────────');
-    try {
-      const agents = await get('/Users/List');
-      const online  = (agents ?? []).filter(a => a.status === 'Available').length;
-      const away    = (agents ?? []).filter(a => a.status === 'Away').length;
-      const offline = (agents ?? []).length - online - away;
-      ok(`${agents?.length ?? 0} agent(s)  ·  ${online} online  ·  ${away} away  ·  ${offline} offline`);
-    } catch { warn('Could not load agents'); }
-
-    console.log('\n──────────────────────────────────────────────────────────────\n');
-  }),
-};
+/**
+ * velaro check — full site health and configuration summary.
+ *
+ * Shows every feature area with:
+ *   ✓  enabled and configured
+ *   ⚠  enabled but nothing configured yet
+ *   ✗  not on your plan
+ */
+
+import { get }        from '../api.js';
+import { getSubscription } from '../subscription.js';
+import { runCommand } from '../run.js';
+
+const TICK  = '✓';
+const WARN  = '⚠';
+const CROSS = '✗';
+
+export const checkCommand = {
+  command:  'check',
+  describe: 'Show full site configuration and health summary',
+  handler:  runCommand(async () => {
+    const [sub, apiStatus] = await Promise.all([
+      getSubscription().catch(() => null),
+      get('/Status').catch(() => null),
+    ]);
+
+    if (!sub) {
+      console.error('Could not retrieve subscription. Check your login: velaro whoami');
+      process.exit(1);
+    }
+
+    const ok  = (msg) => console.log(`  ${TICK}  ${msg}`);
+    const warn = (msg) => console.log(`  ${WARN}  ${msg}`);
+    const off  = (msg) => console.log(`  ${CROSS}  ${msg}`);
+
+    console.log('\n── API Health ────────────────────────────────────────────────');
+    if (apiStatus) {
+      ok(`API reachable`);
+    } else {
+      warn('API did not respond to /Status');
+    }
+
+    // ── Deployments ─────────────────────────────────────────────────────────
+    console.log('\n── Deployments ───────────────────────────────────────────────');
+    try {
+      const [deps, teams] = await Promise.all([get('/Deployment'), get('/Teams/List')]);
+      const teamMap = Object.fromEntries((teams ?? []).map(t => [t.id, t.name]));
+      if (deps?.length) {
+        for (const d of deps) {
+          ok(`[${d.id}] "${d.displayName}"  →  team: ${teamMap[d.teamId] ?? `#${d.teamId}`}  (embed key: ${d.deploymentId})`);
+        }
+      } else {
+        warn('No deployments — create one in the admin UI to get your embed snippet.');
+      }
+    } catch { warn('Could not load deployments'); }
+
+    // ── AI Bots ──────────────────────────────────────────────────────────────
+    console.log('\n── AI Bots ───────────────────────────────────────────────────');
+    if (sub.enableAI) {
+      try {
+        const bots = await get('/AIConfiguration/list');
+        if (bots?.length) {
+          for (const b of bots) ok(`[${b.id}] "${b.name}"  model=${b.aiModel ?? 'default'}`);
+        } else {
+          warn('AI enabled but no bots configured. Run: velaro bot setup --name "My Bot"');
+        }
+      } catch { warn('Could not load bot list'); }
+    } else {
+      off('AI Bots — not on your plan  (upgrade at velaro.com/pricing)');
+    }
+
+    // ── Knowledge Base ───────────────────────────────────────────────────────
+    console.log('\n── Knowledge Base ────────────────────────────────────────────');
+    if (sub.enableKnowledgeBase) {
+      try {
+        const [qna, overrides] = await Promise.all([
+          get('/api/BotQnA').catch(() => []),
+          get('/Ticket/knowledge-overrides').catch(() => []),
+        ]);
+        ok(`${qna?.length ?? 0} Q&A pair(s)  ·  ${overrides?.length ?? 0} override(s)`);
+      } catch { warn('Could not load knowledge base'); }
+    } else {
+      off('Knowledge Base — not on your plan');
+    }
+
+    // ── Workflows ────────────────────────────────────────────────────────────
+    console.log('\n── Workflows ─────────────────────────────────────────────────');
+    if (sub.enableAutomation) {
+      try {
+        const workflows = (await get('/Workflows/List') ?? []).filter(w => !w.isTemplate);
+        const enabled   = workflows.filter(w => w.enabled).length;
+        const disabled  = workflows.length - enabled;
+        if (workflows.length) {
+          ok(`${workflows.length} workflow(s)  ·  ${enabled} enabled  ·  ${disabled} disabled`);
+          for (const w of workflows) {
+            const sym = w.enabled ? TICK : WARN;
+            console.log(`       ${sym}  [${w.id}] "${w.name}"  (${w.enabled ? 'on' : 'off'})`);
+          }
+        } else {
+          warn('Automation enabled but no workflows configured.');
+        }
+      } catch { warn('Could not load workflows'); }
+    } else {
+      off('Workflows — not on your plan');
+    }
+
+    // ── Routing Rules ────────────────────────────────────────────────────────
+    console.log('\n── Routing Rules ─────────────────────────────────────────────');
+    if (sub.enableWorkflowRules) {
+      try {
+        const rules = await get('/Rules/List');
+        if (rules?.length) {
+          ok(`${rules.length} routing rule(s) configured`);
+        } else {
+          warn('Routing rules enabled but none configured.');
+        }
+      } catch { warn('Could not load rules'); }
+    } else {
+      off('Routing Rules — not on your plan');
+    }
+
+    // ── Channels ─────────────────────────────────────────────────────────────
+    console.log('\n── Channels ──────────────────────────────────────────────────');
+    const channels = [
+      ['enableWeb',       'Web Chat'],
+      ['enableSms',       'SMS'],
+      ['enableEmail',     'Email'],
+      ['enableWhatsapp',  'WhatsApp'],
+      ['enableIvr',       'IVR / Voice'],
+      ['enableFacebook',  'Facebook Messenger'],
+      ['enableInstagram', 'Instagram'],
+      ['enableRcs',       'RCS'],
+    ];
+    for (const [flag, label] of channels) {
+      if (sub[flag]) ok(label); else off(`${label} — not on your plan`);
+    }
+
+    // ── IVR detail ───────────────────────────────────────────────────────────
+    if (sub.enableIvr) {
+      try {
+        const ivr = await get('/api/ivr/config');
+        if (ivr?.phoneNumber) {
+          console.log(`\n── IVR Config ────────────────────────────────────────────────`);
+          ok(`Phone: ${ivr.phoneNumber}`);
+          if (ivr.bridgeNumber) ok(`Bridge: ${ivr.bridgeNumber}`);
+          else warn('No bridge (transfer) number set — agents cannot receive transferred calls.');
+        }
+      } catch { /* IVR config is optional */ }
+    }
+
+    // ── Agents ───────────────────────────────────────────────────────────────
+    console.log('\n── Agents ────────────────────────────────────────────────────');
+    try {
+      const agents = await get('/Users/List');
+      const online  = (agents ?? []).filter(a => a.status === 'Available').length;
+      const away    = (agents ?? []).filter(a => a.status === 'Away').length;
+      const offline = (agents ?? []).length - online - away;
+      ok(`${agents?.length ?? 0} agent(s)  ·  ${online} online  ·  ${away} away  ·  ${offline} offline`);
+    } catch { warn('Could not load agents'); }
+
+    console.log('\n──────────────────────────────────────────────────────────────\n');
+  }),
+};

package/lib/commands/deployment.js

@@ -1,107 +1,107 @@
-import { get, post }  from '../api.js';
-import { runCommand } from '../run.js';
-
-export const deploymentCommand = {
-  command:  'deployment <subcommand>',
-  describe: 'Manage chat widget deployments',
-  builder:  (yargs) =>
-    yargs
-      .command(deploymentListCommand)
-      .command(deploymentRenameCommand)
-      .command(deploymentAssignCommand)
-      .demandCommand(1, 'Specify a subcommand: list, rename, assign-team'),
-  handler: () => {},
-};
-
-// ── list ───────────────────────────────────────────────────────────────────────
-
-const deploymentListCommand = {
-  command:  'list',
-  describe: 'List chat widget deployments',
-  handler:  runCommand(async () => {
-    const [deployments, teams] = await Promise.all([
-      get('/Deployment'),
-      get('/Teams/List'),
-    ]);
-
-    if (!deployments?.length) {
-      console.log('No deployments found.');
-      console.log('\nA deployment is a chat widget embed — one per page or team you want to serve.');
-      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('team'.length,      ...rows.map(r => r.team.length));
-
-    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'team'.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} deployment(s)`);
-    console.log('\nThe embed-key goes in your widget JavaScript snippet.');
-  }),
-};
-
-// ── rename ─────────────────────────────────────────────────────────────────────
-
-const deploymentRenameCommand = {
-  command:  'rename <id> <name>',
-  describe: 'Rename a deployment',
-  builder:  (y) =>
-    y
-      .positional('id',   { type: 'number', describe: 'Deployment numeric ID' })
-      .positional('name', { type: 'string', describe: 'New display name' }),
-  handler: runCommand(async (argv) => {
-    const dep = await get(`/Deployment/${argv.id}`);
-    if (!dep) {
-      console.error(`Deployment ${argv.id} not found.`);
-      process.exit(1);
-    }
-
-    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
-    console.log(`Deployment ${argv.id} renamed to "${argv.name}".`);
-  }),
-};
-
-// ── assign-team ────────────────────────────────────────────────────────────────
-
-const deploymentAssignCommand = {
-  command:  'assign-team <id> <team-id>',
-  describe: 'Assign a team to a deployment',
-  builder:  (y) =>
-    y
-      .positional('id',      { type: 'number', describe: 'Deployment numeric ID' })
-      .positional('team-id', { type: 'number', describe: 'Team ID to assign' }),
-  handler: runCommand(async (argv) => {
-    const [dep, teams] = await Promise.all([
-      get(`/Deployment/${argv.id}`),
-      get('/Teams/List'),
-    ]);
-
-    if (!dep) {
-      console.error(`Deployment ${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(`Deployment ${argv.id} ("${dep.displayName}") assigned to team "${team.name}".`);
-  }),
-};
+import { get, post }  from '../api.js';
+import { runCommand } from '../run.js';
+
+export const deploymentCommand = {
+  command:  'deployment <subcommand>',
+  describe: 'Manage chat widget deployments',
+  builder:  (yargs) =>
+    yargs
+      .command(deploymentListCommand)
+      .command(deploymentRenameCommand)
+      .command(deploymentAssignCommand)
+      .demandCommand(1, 'Specify a subcommand: list, rename, assign-team'),
+  handler: () => {},
+};
+
+// ── list ───────────────────────────────────────────────────────────────────────
+
+const deploymentListCommand = {
+  command:  'list',
+  describe: 'List chat widget deployments',
+  handler:  runCommand(async () => {
+    const [deployments, teams] = await Promise.all([
+      get('/Deployment'),
+      get('/Teams/List'),
+    ]);
+
+    if (!deployments?.length) {
+      console.log('No deployments found.');
+      console.log('\nA deployment is a chat widget embed — one per page or team you want to serve.');
+      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('team'.length,      ...rows.map(r => r.team.length));
+
+    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'team'.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} deployment(s)`);
+    console.log('\nThe embed-key goes in your widget JavaScript snippet.');
+  }),
+};
+
+// ── rename ─────────────────────────────────────────────────────────────────────
+
+const deploymentRenameCommand = {
+  command:  'rename <id> <name>',
+  describe: 'Rename a deployment',
+  builder:  (y) =>
+    y
+      .positional('id',   { type: 'number', describe: 'Deployment numeric ID' })
+      .positional('name', { type: 'string', describe: 'New display name' }),
+  handler: runCommand(async (argv) => {
+    const dep = await get(`/Deployment/${argv.id}`);
+    if (!dep) {
+      console.error(`Deployment ${argv.id} not found.`);
+      process.exit(1);
+    }
+
+    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
+    console.log(`Deployment ${argv.id} renamed to "${argv.name}".`);
+  }),
+};
+
+// ── assign-team ────────────────────────────────────────────────────────────────
+
+const deploymentAssignCommand = {
+  command:  'assign-team <id> <team-id>',
+  describe: 'Assign a team to a deployment',
+  builder:  (y) =>
+    y
+      .positional('id',      { type: 'number', describe: 'Deployment numeric ID' })
+      .positional('team-id', { type: 'number', describe: 'Team ID to assign' }),
+  handler: runCommand(async (argv) => {
+    const [dep, teams] = await Promise.all([
+      get(`/Deployment/${argv.id}`),
+      get('/Teams/List'),
+    ]);
+
+    if (!dep) {
+      console.error(`Deployment ${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(`Deployment ${argv.id} ("${dep.displayName}") assigned to team "${team.name}".`);
+  }),
+};

package/lib/commands/env.js

@@ -0,0 +1,45 @@
+import { readConfig, setActiveEnv, getActiveEnv, ENVS } from '../config.js';
+import { runCommand } from '../run.js';
+
+export const envCommand = {
+  command:  'env [name]',
+  describe: 'Show or switch the active environment (prod/staging)',
+  builder:  (y) =>
+    y.positional('name', {
+      describe: 'Environment to switch to: prod or staging',
+      type:     'string',
+      choices:  ['prod', 'staging'],
+    }),
+
+  handler: runCommand(async (argv) => {
+    if (argv.name) {
+      setActiveEnv(argv.name);
+      console.log(`Switched to ${argv.name}.`);
+      console.log(`All velaro commands now target: ${ENVS[argv.name].adminApiBase}`);
+      return;
+    }
+
+    // Show status of all environments
+    const cfg    = readConfig();
+    const active = cfg.activeEnv || 'prod';
+    const envs   = cfg.envs || {};
+
+    console.log('Velaro environments:\n');
+    for (const [name, urls] of Object.entries(ENVS)) {
+      const creds   = envs[name];
+      const marker  = name === active ? '▶ ' : '  ';
+      const status  = creds?.velaroToken
+        ? `logged in as ${creds.userName ?? 'unknown'} (site ${creds.siteId})`
+        : 'not logged in';
+      const expiry  = creds?.velaroExpires
+        ? new Date(creds.velaroExpires) > new Date() ? '' : '  ⚠ token expired'
+        : '';
+      console.log(`${marker}${name.padEnd(10)} ${status}${expiry}`);
+      console.log(`          ${urls.adminApiBase}`);
+    }
+
+    console.log(`\nActive: ${active}`);
+    console.log('\nTo switch:  velaro env staging  |  velaro env prod');
+    console.log('To log in:  velaro login         |  velaro login --staging');
+  }),
+};