@velaro/cli 1.2.0 → 1.4.8

package/lib/commands/ingest.js

@@ -1,31 +1,31 @@
-import { getCredentials, post } from '../api.js';
-import { runCommand }           from '../run.js';
-
-export const ingestCommand = {
-  command:  'ingest',
-  describe: 'Trigger knowledge base ingestion for a completed scraper job',
-  builder:  (y) =>
-    y.option('job-id', {
-      describe:     'Scraper job ID to ingest',
-      type:         'string',
-      demandOption: true,
-    }),
-
-  handler: runCommand(async (argv) => {
-    // Single credential resolution — avoids double readConfig() from calling readConfig()
-    // here and again inside post() → getCredentials().
-    const creds = await getCredentials();
-
-    console.log(`Triggering ingestion for job ${argv['job-id']} on site ${creds.siteId}...`);
-
-    const result = await post('/AzureIndexes/IngestJobDirect', {
-      siteId: creds.siteId,
-      jobId:  argv['job-id'],
-    });
-
-    console.log('Ingestion started.');
-    console.log(`  Job ID: ${result.jobId}`);
-    console.log(`  Index:  ${result.physicalIndex}`);
-    console.log('\nEmbedding runs in the background. Check logs for completion.');
-  }),
-};
+import { getCredentials, post } from '../api.js';
+import { runCommand }           from '../run.js';
+
+export const ingestCommand = {
+  command:  'ingest',
+  describe: 'Trigger knowledge base ingestion for a completed scraper job',
+  builder:  (y) =>
+    y.option('job-id', {
+      describe:     'Scraper job ID to ingest',
+      type:         'string',
+      demandOption: true,
+    }),
+
+  handler: runCommand(async (argv) => {
+    // Single credential resolution — avoids double readConfig() from calling readConfig()
+    // here and again inside post() → getCredentials().
+    const creds = await getCredentials();
+
+    console.log(`Triggering ingestion for job ${argv['job-id']} on site ${creds.siteId}...`);
+
+    const result = await post('/AzureIndexes/IngestJobDirect', {
+      siteId: creds.siteId,
+      jobId:  argv['job-id'],
+    });
+
+    console.log('Ingestion started.');
+    console.log(`  Job ID: ${result.jobId}`);
+    console.log(`  Index:  ${result.physicalIndex}`);
+    console.log('\nEmbedding runs in the background. Check logs for completion.');
+  }),
+};

package/lib/commands/inline-widget-config.js

@@ -0,0 +1,126 @@
+import { get, post, del, request } from '../api.js';
+import { runCommand }               from '../run.js';
+
+const RESET = '\x1b[0m';
+const GRN   = '\x1b[32m';
+const YEL   = '\x1b[33m';
+const CYN   = '\x1b[36m';
+
+function formatConfig(c) {
+  const enabled = c.enabled ? `${GRN}enabled${RESET}` : `${YEL}disabled${RESET}`;
+  return `  #${c.id} | ${CYN}${c.integration}${RESET} / ${c.recordType} | ${enabled}`;
+}
+
+// -- list ---------------------------------------------------------------------
+
+const listCommand = {
+  command:  'list',
+  describe: 'List Inline Data Widget configs for this site',
+  builder:  (y) => y,
+  handler:  runCommand(async () => {
+    const data = await get('/InlineWidgetConfig');
+    const configs = Array.isArray(data) ? data : [];
+    if (!configs.length) {
+      console.log('\nNo Inline Data Widget configs. All integrations use text narration (default behavior).\n');
+      return;
+    }
+    console.log(`\nInline Data Widget Configs (${configs.length})\n`);
+    for (const c of configs) console.log(formatConfig(c));
+    console.log('');
+  }),
+};
+
+// -- eligible ---------------------------------------------------------------------
+
+const eligibleCommand = {
+  command:  'eligible',
+  describe: 'List (integration, recordType) combinations eligible for Inline Data Widgets on this site',
+  builder:  (y) => y,
+  handler:  runCommand(async () => {
+    const data = await get('/InlineWidgetConfig/eligible');
+    const pairs = Array.isArray(data) ? data : [];
+    if (!pairs.length) {
+      console.log('\nNo eligible integration/record-type combinations for this site yet.\n');
+      return;
+    }
+    console.log(`\nEligible for Inline Data Widgets (${pairs.length})\n`);
+    for (const p of pairs) console.log(`  ${CYN}${p.integration}${RESET} / ${p.recordType}`);
+    console.log('');
+  }),
+};
+
+// -- create ---------------------------------------------------------------------
+
+const createCommand = {
+  command:  'create',
+  describe: 'Create an Inline Data Widget config (opts a record type into inline card rendering)',
+  builder:  (y) =>
+    y
+      .option('integration', { type: 'string', describe: 'Integration slug, e.g. NetSuite', demandOption: true })
+      .option('record-type', { type: 'string', describe: 'Record type, e.g. Order', demandOption: true })
+      .option('disabled',    { type: 'boolean', describe: 'Create disabled instead of the default enabled', default: false }),
+  handler:  runCommand(async (argv) => {
+    const c = await post('/InlineWidgetConfig', {
+      integration: argv.integration,
+      recordType:  argv.recordType,
+      enabled:     !argv.disabled,
+    });
+    console.log(`\nCreated Inline Data Widget config #${c.id} (${c.integration}/${c.recordType}, ${c.enabled ? 'enabled' : 'disabled'})\n`);
+  }),
+};
+
+// -- update ---------------------------------------------------------------------
+
+const updateCommand = {
+  command:  'update <id>',
+  describe: 'Update an existing Inline Data Widget config',
+  builder:  (y) =>
+    y
+      .positional('id',   { type: 'number', describe: 'Config ID' })
+      .option('enable',   { type: 'boolean', describe: 'Enable the config' })
+      .option('disable',  { type: 'boolean', describe: 'Disable the config' }),
+  handler:  runCommand(async (argv) => {
+    const body = {};
+    if (argv.enable)  body.enabled = true;
+    if (argv.disable) body.enabled = false;
+
+    if (!Object.keys(body).length) {
+      console.error('No fields to update. Pass --enable or --disable.');
+      process.exitCode = 1;
+      return;
+    }
+
+    const c = await request('PUT', `/InlineWidgetConfig/${argv.id}`, body);
+    console.log(`\nUpdated Inline Data Widget config #${c.id}\n`);
+    console.log(formatConfig(c));
+    console.log('');
+  }),
+};
+
+// -- delete ---------------------------------------------------------------------
+
+const deleteCommand = {
+  command:  'delete <id>',
+  describe: 'Delete an Inline Data Widget config (reverts that record type to text narration)',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Config ID' }),
+  handler:  runCommand(async (argv) => {
+    await del(`/InlineWidgetConfig/${argv.id}`);
+    console.log(`\nConfig #${argv.id} deleted.\n`);
+  }),
+};
+
+// -- root command ---------------------------------------------------------------
+
+export const inlineWidgetConfigCommand = {
+  command:  'inline-widget-config <subcommand>',
+  describe: 'Manage per-site Inline Data Widgets config (inline chat card vs. text narration for integration record lookups)',
+  builder:  (yargs) =>
+    yargs
+      .command(listCommand)
+      .command(eligibleCommand)
+      .command(createCommand)
+      .command(updateCommand)
+      .command(deleteCommand)
+      .demandCommand(1, 'Specify a subcommand: list, eligible, create, update, delete'),
+  handler: () => {},
+};

package/lib/commands/integration.js

@@ -0,0 +1,93 @@
+import { messagingRequest } from '../api.js';
+
+const RESET = '\x1b[0m';
+const DIM   = '\x1b[2m';
+const RED   = '\x1b[31m';
+const YEL   = '\x1b[33m';
+const GRN   = '\x1b[32m';
+const CYN   = '\x1b[36m';
+
+function colourise(status) {
+  if (status === 'Healthy')        return `${GRN}Healthy${RESET}`;
+  if (status === 'Degraded')       return `${YEL}Degraded${RESET}`;
+  if (status === 'Failed')         return `${RED}Failed${RESET}`;
+  if (status === 'NotConfigured')  return `${DIM}NotConfigured${RESET}`;
+  return status ?? '?';
+}
+
+function formatRow(item) {
+  const ts  = item.checkedAt ? new Date(item.checkedAt).toISOString().replace('T', ' ').slice(0, 19) : '-';
+  const ms  = item.latencyMs != null ? `${item.latencyMs}ms` : '-';
+  const slug = (item.slug ?? '?').padEnd(14);
+  return `  ${CYN}${slug}${RESET}  ${colourise(item.status).padEnd(20)}  ${ms.padStart(7)}  ${DIM}${ts}${RESET}  ${item.detail ?? ''}`;
+}
+
+async function healthHandler(argv) {
+  const slug = argv.slug ? encodeURIComponent(argv.slug) : null;
+
+  if (argv.run) {
+    if (!slug) {
+      console.error('Error: --run requires a slug. Example: velaro integration health --slug WhatsApp --run');
+      process.exitCode = 1;
+      return;
+    }
+    const result = await messagingRequest('POST', `/Integration/Health/${slug}/run`);
+    console.log(`\nManual probe — ${argv.slug}\n`);
+    console.log(formatRow(result));
+    console.log('');
+    return;
+  }
+
+  if (argv.reset) {
+    if (!slug) {
+      console.error('Error: --reset requires a slug. Example: velaro integration health --slug WhatsApp --reset');
+      process.exitCode = 1;
+      return;
+    }
+    const result = await messagingRequest('POST', `/Integration/Health/${slug}/reset-circuit`);
+    console.log(`\nCircuit reset — ${argv.slug}\n`);
+    console.log(formatRow(result));
+    console.log('');
+    return;
+  }
+
+  const path = slug ? `/Integration/Health/${slug}` : '/Integration/Health';
+  const data = await messagingRequest('GET', path);
+
+  if (slug) {
+    if (!data) {
+      console.log(`\nNo recorded probe for ${argv.slug}. Try: velaro integration health --slug ${argv.slug} --run\n`);
+      return;
+    }
+    console.log(`\nIntegration health — ${argv.slug}\n`);
+    console.log(formatRow(data));
+    console.log('');
+    return;
+  }
+
+  const items = Array.isArray(data) ? data : [];
+  if (items.length === 0) {
+    console.log('\nNo integration health results recorded yet. The scheduler runs every 15 minutes.\n');
+    return;
+  }
+  console.log(`\n${items.length} integration health result(s)\n`);
+  for (const item of items) console.log(formatRow(item));
+  console.log('');
+}
+
+export const integrationCommand = {
+  command:  'integration <subcommand>',
+  describe: 'Integration health probes (synthetic monitoring)',
+  builder: y => y
+    .command({
+      command:  'health',
+      describe: 'List or run integration health probes',
+      builder: yy => yy
+        .option('slug', { describe: 'Integration slug (WhatsApp, NetSuite, ...). Omit to list all.', type: 'string' })
+        .option('run',   { describe: 'Trigger the probe now (requires --slug)', type: 'boolean', default: false })
+        .option('reset', { describe: 'Reset circuit breaker for (slug, site) — Velaro admin only (requires --slug)', type: 'boolean', default: false }),
+      handler: healthHandler,
+    })
+    .demandCommand(1, 'Specify a subcommand. Try: velaro integration health'),
+  handler: () => {},
+};