@velaro/cli 1.4.80 → 1.4.82

package/bin/velaro.js

@@ -92,6 +92,7 @@ import { supportCommand }           from '../lib/commands/support.js';
 import { routingCommand }           from '../lib/commands/routing.js';
 import { diagnosticsCommand }       from '../lib/commands/diagnostics.js';
 import { aiSpendCommand }           from '../lib/commands/ai-spend.js';
+import { statusPageCommand }        from '../lib/commands/status-page.js';
 import { emailInboxCommand }        from '../lib/commands/email-inbox.js';
 import { callbackCommand }          from '../lib/commands/callback.js';
 import { caseCommand }              from '../lib/commands/case.js';
@@ -104,6 +105,7 @@ import { featureDiscoveryCommand }  from '../lib/commands/feature-discovery.js';
 import { tourPolicyCommand }  from '../lib/commands/tour-policy.js';
 import { scraperCommand }      from '../lib/commands/scraper.js';
 import { campaignsCommand }         from '../lib/commands/campaigns.js';
+import { senderDomainHealthCommand } from '../lib/commands/sender-domain-health.js';
 import { contactsCommand }          from '../lib/commands/contacts.js';
 import { contactListCommand }       from '../lib/commands/contact-list.js';
 import { startUpdateCheck }  from '../lib/update-check.js';
@@ -209,6 +211,7 @@ await yargs(hideBin(process.argv))
   .command(routingCommand)
   .command(diagnosticsCommand)
   .command(aiSpendCommand)
+  .command(statusPageCommand)
   .command(emailInboxCommand)
   .command(callbackCommand)
   .command(caseCommand)
@@ -221,6 +224,7 @@ await yargs(hideBin(process.argv))
   .command({ command: 'scraper', desc: 'Velaro staff: scraper / upload / chunk usage for any site', builder: scraperCommand, handler: () => {} })
   .command({ command: 'tour-policy', desc: 'Velaro staff: guided-tour auto-open policy (versioned, rollback-able)', builder: tourPolicyCommand, handler: () => {} })
   .command(campaignsCommand)
+  .command(senderDomainHealthCommand)
   .command(contactsCommand)
   .command(contactListCommand)
   .demandCommand(1, 'Specify a command. Run "velaro --help" for options.')

package/lib/commands/sender-domain-health.js

@@ -0,0 +1,58 @@
+/**
+ * velaro sender-domain-health - registration expiry, DNS and email-provider state for your sending domains
+ *
+ *   velaro sender-domain-health show        Health + plain-language history
+ *   velaro sender-domain-health settings    View or change warning days / grace days
+ */
+import { request } from '../api.js';
+import { runCommand } from '../run.js';
+
+async function showHandler() {
+  const r = await request('GET', '/SenderDomains/Health');
+  const domains = r.domains ?? [];
+  if (domains.length === 0) { console.log('No sender domains.'); return; }
+  for (const d of domains) {
+    const exp = d.registrationExpiresOn ? `${d.registrationExpiresOn.slice(0, 10)} (${d.daysToExpiry} days)` : 'unknown';
+    console.log(`${d.domainName}  [${d.healthStatus}]  status=${d.status}  registration expires: ${exp}`);
+    if (d.healthDetail) console.log(`   ${d.healthDetail}`);
+  }
+  const open = r.notices ?? [];
+  if (open.length) {
+    console.log('\nAction needed:');
+    for (const n of open) console.log(` - ${n.domainName}: ${n.message}\n     What to do: ${n.remedy}`);
+  }
+  console.log(`\nWarnings start at ${r.settings.thresholds.join('/')} days; sending pauses ${r.settings.graceDays} days after expiry${r.settings.usingAccountDefault ? ' (account default)' : ''}.`);
+}
+
+async function settingsHandler(argv) {
+  if (argv.reset) { console.log(JSON.stringify(await request('PUT', '/SenderDomains/Health/Settings', { reset: true }))); return; }
+  if (argv.thresholds === undefined && argv.graceDays === undefined) {
+    const r = await request('GET', '/SenderDomains/Health');
+    console.log(JSON.stringify(r.settings, null, 2));
+    return;
+  }
+  console.log(JSON.stringify(await request('PUT', '/SenderDomains/Health/Settings', { thresholds: argv.thresholds, graceDays: argv.graceDays })));
+}
+
+async function dismissHandler(argv) {
+  console.log(JSON.stringify(await request('POST', `/SenderDomains/Health/Events/${argv.id}/Dismiss`, {})));
+}
+
+export const senderDomainHealthCommand = {
+  command: 'sender-domain-health <subcommand>',
+  describe: 'Sender domain health: registration expiry, DNS, email-provider state',
+  builder: y => y
+    .command({ command: 'show', describe: 'Health and history for your sender domains', handler: runCommand(showHandler) })
+    .command({
+      command: 'settings', describe: 'View or change warning days and grace days',
+      builder: yy => yy
+        .option('thresholds', { type: 'string', describe: 'Comma-separated days before expiry, e.g. 60,30,14,7,3,1' })
+        .option('grace-days', { type: 'number', describe: 'Days after expiry before sending pauses (0-90)' })
+        .option('reset', { type: 'boolean', describe: 'Go back to the account default' }),
+      handler: runCommand(settingsHandler),
+    })
+    .command({ command: 'dismiss <id>', describe: 'Dismiss a notice (do not remind me)', handler: runCommand(dismissHandler) })
+    .demandCommand(1, 'Specify a subcommand: show | settings | dismiss')
+    .strict(),
+  handler: () => {},
+};

package/lib/commands/status-page.js

@@ -0,0 +1,95 @@
+import { messagingRequest } from '../api.js';
+
+const COMPONENTS = 'Messaging, Voice & Calls, AI Assistant, Database, API, Integrations, Email Campaigns, Velaro Sign, Velaro Forms, Agent Console, Core API, Chat Engagement';
+const TOKENS = 'AffectedServices is a comma-separated list of component names (' + COMPONENTS + ') plus optional uptime tokens: "counts-uptime" forces the incident to count against uptime, "no-uptime-impact" forces it not to. Default: only a core chat outage counts.';
+
+const listCommand = {
+  command: 'list',
+  describe: 'List status incidents (SuperAdmin, velaro-messaging GET /superadmin/status-incidents)',
+  builder: (y) => y.option('filter', { type: 'string', default: 'active', choices: ['active', 'resolved', 'all'] }).option('json', { type: 'boolean', default: false }),
+  handler: async (argv) => {
+    const rows = await messagingRequest('GET', `/superadmin/status-incidents?filter=${argv.filter}`);
+    if (argv.json) { console.log(JSON.stringify(rows, null, 2)); return; }
+    for (const r of rows ?? []) console.log(`#${r.id}  ${r.status}  ${r.incidentType}/${r.severity}  ${r.title}  [${r.affectedServices ?? ''}]`);
+  },
+};
+
+const createCommand = {
+  command: 'create',
+  describe: 'Create a status incident. ' + TOKENS,
+  builder: (y) => y
+    .option('title', { type: 'string', demandOption: true })
+    .option('description', { type: 'string', default: '' })
+    .option('status', { type: 'string', default: 'Investigating', describe: 'Investigating, Identified, Monitoring, Resolved' })
+    .option('type', { type: 'string', default: 'Incident', describe: 'Incident or Maintenance' })
+    .option('severity', { type: 'string', default: 'Minor', describe: 'Minor or Major' })
+    .option('services', { type: 'string', default: '', describe: 'AffectedServices CSV. ' + TOKENS })
+    .option('regions', { type: 'string', default: '' })
+    .option('exclude-from-uptime', { type: 'boolean', default: false })
+    .option('hidden', { type: 'boolean', default: false, describe: 'Hide from the public page' }),
+  handler: async (argv) => {
+    const r = await messagingRequest('POST', '/superadmin/status-incidents', {
+      title: argv.title, description: argv.description, status: argv.status, incidentType: argv.type, severity: argv.severity,
+      affectedServices: argv.services, affectedRegions: argv.regions, excludeFromUptime: argv.excludeFromUptime, isVisibleToCustomers: !argv.hidden,
+    });
+    console.log(`Created incident #${r.id}: ${r.title}`);
+  },
+};
+
+const updateCommand = {
+  command: 'update <id>',
+  describe: 'Update a status incident (pass every field you want kept). ' + TOKENS,
+  builder: (y) => y
+    .positional('id', { type: 'number' })
+    .option('title', { type: 'string' }).option('description', { type: 'string' })
+    .option('status', { type: 'string' }).option('type', { type: 'string' }).option('severity', { type: 'string' })
+    .option('services', { type: 'string', describe: 'AffectedServices CSV. ' + TOKENS })
+    .option('regions', { type: 'string' })
+    .option('end-time', { type: 'string', describe: 'ISO timestamp the incident ended' })
+    .option('exclude-from-uptime', { type: 'boolean' })
+    .option('hidden', { type: 'boolean' }),
+  handler: async (argv) => {
+    const body = {
+      title: argv.title, description: argv.description, status: argv.status, incidentType: argv.type, severity: argv.severity,
+      affectedServices: argv.services, affectedRegions: argv.regions, endTime: argv.endTime,
+      excludeFromUptime: argv.excludeFromUptime ?? false, isVisibleToCustomers: argv.hidden === undefined ? true : !argv.hidden,
+    };
+    const r = await messagingRequest('PUT', `/superadmin/status-incidents/${argv.id}`, body);
+    console.log(`Updated incident #${r?.id ?? argv.id}`);
+  },
+};
+
+const deleteCommand = {
+  command: 'delete <id>',
+  describe: 'Delete a status incident or clear an override',
+  builder: (y) => y.positional('id', { type: 'number' }),
+  handler: async (argv) => {
+    await messagingRequest('DELETE', `/superadmin/status-incidents/${argv.id}`);
+    console.log(`Deleted incident #${argv.id}`);
+  },
+};
+
+const overrideCommand = {
+  command: 'override',
+  describe: 'Force a public status page component to a status (POST /superadmin/status-overrides). Components: ' + COMPONENTS + '. Clear with: velaro status-page delete <id>',
+  builder: (y) => y
+    .option('component', { type: 'string', demandOption: true, describe: COMPONENTS })
+    .option('status', { type: 'string', demandOption: true, choices: ['operational', 'degraded', 'outage', 'maintenance'] })
+    .option('note', { type: 'string', default: '' })
+    .option('expires-at', { type: 'string', describe: 'ISO timestamp the override auto-clears' })
+    .option('counts-against-uptime', { type: 'boolean', describe: 'true adds counts-uptime, false adds no-uptime-impact; omit for default' }),
+  handler: async (argv) => {
+    const r = await messagingRequest('POST', '/superadmin/status-overrides', {
+      component: argv.component, status: argv.status, note: argv.note, expiresAt: argv.expiresAt ?? null, countsAgainstUptime: argv.countsAgainstUptime ?? null,
+    });
+    console.log(`Override #${r.id} created: ${r.title}`);
+  },
+};
+
+export const statusPageCommand = {
+  command: 'status-page <subcommand>',
+  describe: 'Public status page incidents and component overrides (SuperAdmin only)',
+  builder: (y) => y.command(listCommand).command(createCommand).command(updateCommand).command(deleteCommand).command(overrideCommand)
+    .demandCommand(1, 'Specify a subcommand: list, create, update, delete, override').strict(),
+  handler: () => {},
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/cli",
-  "version": "1.4.80",
+  "version": "1.4.82",
   "description": "Velaro Workspace v20 — command-line interface for managing bots, knowledge base ingestion, MCP API keys, search indexes, and ops health.",
   "type": "module",
   "bin": {