@velaro/cli 1.2.0 → 1.4.9

package/lib/commands/workflow.js

@@ -1,98 +1,233 @@
-import { get, post }      from '../api.js';
-import { requireFeature } from '../subscription.js';
-import { runCommand }     from '../run.js';
-
-export const workflowCommand = {
-  command:  'workflow <subcommand>',
-  describe: 'Manage automation workflows',
-  builder:  (yargs) =>
-    yargs
-      .command(workflowListCommand)
-      .command(workflowGetCommand)
-      .command(workflowEnableCommand)
-      .command(workflowDisableCommand)
-      .demandCommand(1, 'Specify a subcommand: list, get, enable, disable'),
-  handler: () => {},
-};
-
-// ── list ───────────────────────────────────────────────────────────────────────
-
-const workflowListCommand = {
-  command:  'list',
-  describe: 'List all workflows',
-  handler:  runCommand(async () => {
-    await requireFeature('enableAutomation', 'Workflows');
-
-    const workflows = await get('/Workflows/List');
-    const rows = (workflows ?? []).filter(w => !w.isTemplate);
-
-    if (!rows.length) { console.log('No workflows found.'); return; }
-
-    const idW      = Math.max(...rows.map(w => String(w.id).length + 2));
-    const triggerW = Math.max('trigger'.length, ...rows.map(w => (w.triggerType ?? '—').length));
-
-    console.log(`\n${'id'.padStart(idW)}  status    ${'trigger'.padEnd(triggerW)}  name`);
-    console.log(`${'-'.repeat(idW)}  --------  ${'-'.repeat(triggerW)}  ----`);
-    for (const w of rows) {
-      const id      = `[${w.id}]`.padStart(idW);
-      const status  = w.enabled ? 'enabled ' : 'disabled';
-      const trigger = (w.triggerType ?? '—').padEnd(triggerW);
-      console.log(`${id}  ${status}  ${trigger}  ${w.name}`);
-    }
-    console.log(`\n${rows.length} workflow(s)`);
-  }),
-};
-
-// ── get ────────────────────────────────────────────────────────────────────────
-
-const workflowGetCommand = {
-  command:  'get <id>',
-  describe: 'Show workflow details',
-  builder:  (y) => y.positional('id', { type: 'number', describe: 'Workflow ID' }),
-  handler:  runCommand(async (argv) => {
-    await requireFeature('enableAutomation', 'Workflows');
-
-    const w = await get(`/Workflows/${argv.id}`);
-    if (!w) { console.error(`Workflow ${argv.id} not found.`); process.exit(1); }
-
-    console.log(`\n[${w.id}] ${w.name}`);
-    console.log(`  Status:  ${w.enabled ? 'enabled' : 'disabled'}`);
-    console.log(`  Trigger: ${w.triggerType ?? '—'}`);
-    if (w.nodes?.length) {
-      console.log(`  Nodes:   ${w.nodes.length}`);
-    }
-  }),
-};
-
-// ── enable / disable ──────────────────────────────────────────────────────────
-
-const workflowEnableCommand = {
-  command:  'enable <id>',
-  describe: 'Enable a workflow',
-  builder:  (y) => y.positional('id', { type: 'number', describe: 'Workflow ID' }),
-  handler:  runCommand(async (argv) => {
-    await requireFeature('enableAutomation', 'Workflows');
-    await post(`/Workflows/toggle/${argv.id}`, null);
-    console.log(`Workflow ${argv.id} enabled.`);
-  }),
-};
-
-const workflowDisableCommand = {
-  command:  'disable <id>',
-  describe: 'Disable a workflow',
-  builder:  (y) => y.positional('id', { type: 'number', describe: 'Workflow ID' }),
-  handler:  runCommand(async (argv) => {
-    await requireFeature('enableAutomation', 'Workflows');
-
-    const w = await get(`/Workflows/${argv.id}`);
-    if (!w) { console.error(`Workflow ${argv.id} not found.`); process.exit(1); }
-
-    if (!w.enabled) {
-      console.log(`Workflow ${argv.id} is already disabled.`);
-      return;
-    }
-
-    await post(`/Workflows/toggle/${argv.id}`, null);
-    console.log(`Workflow ${argv.id} disabled.`);
-  }),
-};
+import fs                          from 'node:fs';
+import { get, post, getCredentials, messagingGet } from '../api.js';
+import { requireFeature }          from '../subscription.js';
+import { runCommand }              from '../run.js';
+
+export const workflowCommand = {
+  command:  'workflow <subcommand>',
+  describe: 'Manage automation workflows',
+  builder:  (yargs) =>
+    yargs
+      .command(workflowListCommand)
+      .command(workflowGetCommand)
+      .command(workflowCreateCommand)
+      .command(workflowEnableCommand)
+      .command(workflowDisableCommand)
+      .command(workflowNodeOptionsCommand)
+      .command(workflowIntegrityScanCommand)
+      .demandCommand(1, 'Specify a subcommand: list, get, create, enable, disable, node-options, integrity-scan'),
+  handler: () => {},
+};
+
+// ── list ───────────────────────────────────────────────────────────────────────
+
+const workflowListCommand = {
+  command:  'list',
+  describe: 'List all workflows',
+  handler:  runCommand(async () => {
+    await requireFeature('enableAutomation', 'Workflows');
+
+    const workflows = await get('/Workflows/List');
+    const rows = (workflows ?? []).filter(w => !w.isTemplate);
+
+    if (!rows.length) { console.log('No workflows found.'); return; }
+
+    const idW      = Math.max(...rows.map(w => String(w.id).length + 2));
+    const triggerW = Math.max('trigger'.length, ...rows.map(w => (w.triggerType ?? '—').length));
+
+    console.log(`\n${'id'.padStart(idW)}  status    ${'trigger'.padEnd(triggerW)}  name`);
+    console.log(`${'-'.repeat(idW)}  --------  ${'-'.repeat(triggerW)}  ----`);
+    for (const w of rows) {
+      const id      = `[${w.id}]`.padStart(idW);
+      const status  = w.enabled ? 'enabled ' : 'disabled';
+      const trigger = (w.triggerType ?? '—').padEnd(triggerW);
+      console.log(`${id}  ${status}  ${trigger}  ${w.name}`);
+    }
+    console.log(`\n${rows.length} workflow(s)`);
+  }),
+};
+
+// ── get ────────────────────────────────────────────────────────────────────────
+
+const workflowGetCommand = {
+  command:  'get <id>',
+  describe: 'Show workflow details',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Workflow ID' }),
+  handler:  runCommand(async (argv) => {
+    await requireFeature('enableAutomation', 'Workflows');
+
+    const w = await get(`/Workflows/${argv.id}`);
+    if (!w) { console.error(`Workflow ${argv.id} not found.`); process.exit(1); }
+
+    console.log(`\n[${w.id}] ${w.name}`);
+    console.log(`  Status:  ${w.enabled ? 'enabled' : 'disabled'}`);
+    console.log(`  Trigger: ${w.triggerType ?? '—'}`);
+    if (w.nodes?.length) {
+      console.log(`  Nodes:   ${w.nodes.length}`);
+    }
+  }),
+};
+
+// ── create ────────────────────────────────────────────────────────────────────
+
+const workflowCreateCommand = {
+  command:  'create',
+  describe: 'Create a new workflow. Provide --name + --trigger, or --file path/to/workflow.json',
+  builder:  (y) =>
+    y
+      .option('name',     { type: 'string', describe: 'Workflow name (e.g. "Apple Messages — Inbound")' })
+      .option('trigger',  { type: 'string', describe: 'Trigger type (e.g. NewConversation, NewMessage, Scheduled)' })
+      .option('template', { type: 'number', describe: 'Template workflow ID to copy from' })
+      .option('file',     { type: 'string', describe: 'JSON file containing NewWorkflowForm body (overrides --name/--trigger)' })
+      .option('is-template', { type: 'boolean', default: false, describe: 'Create as reusable template' }),
+  handler:  runCommand(async (argv) => {
+    await requireFeature('enableAutomation', 'Workflows');
+
+    let body;
+    if (argv.file) {
+      const raw = fs.readFileSync(argv.file, 'utf8');
+      body = JSON.parse(raw);
+    } else {
+      if (!argv.trigger && !argv.template) {
+        console.error('Either --trigger or --template must be provided (or use --file).');
+        process.exit(1);
+      }
+      body = {
+        name:       argv.name ?? 'New Workflow',
+        trigger:    argv.trigger ?? null,
+        templateId: argv.template ?? null,
+        isTemplate: argv['is-template'] ?? false,
+      };
+    }
+
+    const id = await post('/Workflows', body);
+    console.log(`Workflow created: ${id}`);
+    console.log(`View: velaro workflow get ${id}`);
+  }),
+};
+
+// ── enable / disable ──────────────────────────────────────────────────────────
+
+const workflowEnableCommand = {
+  command:  'enable <id>',
+  describe: 'Enable a workflow',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Workflow ID' }),
+  handler:  runCommand(async (argv) => {
+    await requireFeature('enableAutomation', 'Workflows');
+    await post(`/Workflows/toggle/${argv.id}`, null);
+    console.log(`Workflow ${argv.id} enabled.`);
+  }),
+};
+
+const workflowDisableCommand = {
+  command:  'disable <id>',
+  describe: 'Disable a workflow',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Workflow ID' }),
+  handler:  runCommand(async (argv) => {
+    await requireFeature('enableAutomation', 'Workflows');
+
+    const w = await get(`/Workflows/${argv.id}`);
+    if (!w) { console.error(`Workflow ${argv.id} not found.`); process.exit(1); }
+
+    if (!w.enabled) {
+      console.log(`Workflow ${argv.id} is already disabled.`);
+      return;
+    }
+
+    await post(`/Workflows/toggle/${argv.id}`, null);
+    console.log(`Workflow ${argv.id} disabled.`);
+  }),
+};
+
+// ── node-options ───────────────────────────────────────────────────────────────
+
+const workflowNodeOptionsCommand = {
+  command:  'node-options <workflowId> <nodeId>',
+  describe: 'View or set options on a multiSelect ask-question node',
+  builder:  (y) =>
+    y
+      .positional('workflowId', { type: 'number', describe: 'Workflow ID' })
+      .positional('nodeId',     { type: 'number', describe: 'Node ID' })
+      .option('options',     { type: 'string', describe: 'JSON array of options: \'[{"label":"A","value":"a"}]\'' })
+      .option('min',         { type: 'number', describe: 'Minimum number of selections required' })
+      .option('max',         { type: 'number', describe: 'Maximum number of selections allowed (omit = no limit)' })
+      .option('dynamic-var', { type: 'string', describe: 'Variable to load options from at runtime, e.g. <<myList>>' })
+      .option('strategy',    { type: 'string', choices: ['both', 'paginate', 'cross-channel'], describe: 'Large list overflow strategy' }),
+  handler:  runCommand(async (argv) => {
+    await requireFeature('enableAutomation', 'Workflows');
+
+    const w = await get(`/Workflows/${argv.workflowId}`);
+    if (!w) { console.error(`Workflow ${argv.workflowId} not found.`); process.exit(1); }
+
+    const node = (w.nodes ?? []).find(n => n.id === argv.nodeId) ?? Object.values(w.nodes ?? {})[argv.nodeId];
+    if (!node) { console.error(`Node ${argv.nodeId} not found in workflow ${argv.workflowId}.`); process.exit(1); }
+    if (node.actionType !== 'askQuestion' || node.questionType !== 'multiSelect') {
+      console.error(`Node ${argv.nodeId} is not a multiSelect ask-question node (found: ${node.actionType}/${node.questionType}).`);
+      process.exit(1);
+    }
+
+    const hasChanges = argv.options || argv.min != null || argv.max != null || argv['dynamic-var'] || argv.strategy;
+
+    if (!hasChanges) {
+      // Read mode — print current config
+      console.log(`\nNode ${argv.nodeId} — multiSelect options:`);
+      const opts = Array.isArray(node.options) ? node.options : [];
+      if (opts.length) {
+        console.log(`\n  Static options (${opts.length}):`);
+        opts.forEach((o, i) => console.log(`    ${i + 1}. ${o.label} → "${o.value}"`));
+      }
+      console.log(`\n  Options source:    ${node.optionsSource ?? 'static'}`);
+      if (node.dynamicOptionsVariable) console.log(`  Dynamic variable:  ${node.dynamicOptionsVariable}`);
+      console.log(`  Min selections:    ${node.minSelections ?? '(none)'}`);
+      console.log(`  Max selections:    ${node.maxSelections ?? '(no limit)'}`);
+      console.log(`  Large list:        ${node.largeListStrategy ?? 'both (auto)'}`);
+      return;
+    }
+
+    // Update mode
+    const updated = { ...node };
+    if (argv.options) {
+      updated.options = JSON.parse(argv.options);
+      updated.optionsSource = 'static';
+    }
+    if (argv['dynamic-var']) {
+      updated.dynamicOptionsVariable = argv['dynamic-var'];
+      updated.optionsSource = 'dynamic';
+    }
+    if (argv.min != null)  updated.minSelections = argv.min;
+    if (argv.max != null)  updated.maxSelections = argv.max;
+    if (argv.strategy)     updated.largeListStrategy = argv.strategy;
+
+    await post(`/Workflows/${argv.workflowId}/node/${argv.nodeId}`, updated);
+    console.log(`Node ${argv.nodeId} updated.`);
+  }),
+};
+
+// ── integrity-scan (Velaro staff only) ──────────────────────────────────────────
+
+const workflowIntegrityScanCommand = {
+  command:  'integrity-scan <siteId>',
+  describe: 'Scan every workflow on a site for NodesBlob that fails to parse (Velaro staff only)',
+  builder:  (y) => y.positional('siteId', { type: 'number', describe: 'Site ID to scan' }),
+  handler:  runCommand(async (argv) => {
+    const creds = await getCredentials();
+    if (creds.siteId !== 1032) {
+      console.error('velaro workflow integrity-scan is only available to Velaro staff.');
+      process.exit(1);
+    }
+
+    const results = await messagingGet(`/SuperAdmin/workflows/integrity-scan?siteId=${argv.siteId}`);
+
+    if (!results?.length) {
+      console.log(`\nSite ${argv.siteId}: no corrupted workflows found.\n`);
+      return;
+    }
+
+    console.log(`\nSite ${argv.siteId}: ${results.length} corrupted workflow(s):\n`);
+    for (const r of results) {
+      console.log(`  [${r.id}] ${r.name}`);
+      console.log(`      Last modified: ${r.lastModified}`);
+      console.log(`      Error: ${r.error}\n`);
+    }
+  }),
+};

package/lib/config.js

@@ -1,83 +1,85 @@
-import { homedir } from 'os';
-import { join }    from 'path';
-import { readFileSync, writeFileSync, mkdirSync } from 'fs';
-
-const CONFIG_DIR  = join(homedir(), '.velaro');
-const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
-
-export const ENVS = {
-  prod: {
-    adminApiBase:     'https://api-admin-us-east.velaro.com',
-    messagingApiBase: 'https://velaro-messaging-api-staging.azurewebsites.net',
-  },
-  staging: {
-    adminApiBase:     'https://velaro-admin-staging.azurewebsites.net',
-    messagingApiBase: 'https://velaro-messaging-api-staging.azurewebsites.net',
-  },
-};
-
-// Legacy single-entry config — migrate transparently on first read.
-function migrate(raw) {
-  if (raw.envs) return raw; // already multi-env
-  const apiBase = raw.apiBase || '';
-  const env = apiBase.includes('staging') ? 'staging' : 'prod';
-  return {
-    activeEnv: env,
-    envs: {
-      [env]: {
-        adminApiBase:      ENVS[env].adminApiBase,
-        messagingApiBase:  ENVS[env].messagingApiBase,
-        velaroToken:       raw.velaroToken,
-        velaroExpires:     raw.velaroExpires,
-        entraRefreshToken: raw.entraRefreshToken,
-        siteId:            raw.siteId,
-        userName:          raw.userName,
-      },
-    },
-    _lastUpdateCheck: raw._lastUpdateCheck,
-    _latestVersion:   raw._latestVersion,
-  };
-}
-
-export function readConfig() {
-  try {
-    const raw = JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
-    return migrate(raw);
-  } catch {
-    return { activeEnv: 'prod', envs: {} };
-  }
-}
-
-export function writeConfig(data) {
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2), { mode: 0o600 });
-}
-
-export function getActiveEnv() {
-  return readConfig().activeEnv || 'prod';
-}
-
-export function setActiveEnv(env) {
-  if (!ENVS[env]) throw new Error(`Unknown environment "${env}". Use: prod, staging`);
-  const cfg = readConfig();
-  cfg.activeEnv = env;
-  writeConfig(cfg);
-}
-
-export function getEnvCredentials(env) {
-  const cfg = readConfig();
-  return cfg.envs?.[env] || null;
-}
-
-export function setEnvCredentials(env, creds) {
-  if (!ENVS[env]) throw new Error(`Unknown environment "${env}". Use: prod, staging`);
-  const cfg = readConfig();
-  cfg.envs = cfg.envs || {};
-  cfg.envs[env] = { ...ENVS[env], ...creds };
-  cfg.activeEnv = cfg.activeEnv || env;
-  writeConfig(cfg);
-}
-
-export function clearConfig() {
-  writeConfig({ activeEnv: 'prod', envs: {} });
-}
+import { homedir } from 'os';
+import { join }    from 'path';
+import { readFileSync, writeFileSync, mkdirSync } from 'fs';
+
+const CONFIG_DIR  = join(homedir(), '.velaro');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+// Each URL can be overridden per-environment via env var (e.g. for a one-off custom API base
+// without editing this file) — VELARO_ADMIN_API_PROD, VELARO_MESSAGING_API_STAGING, etc.
+export const ENVS = {
+  prod: {
+    adminApiBase:     process.env.VELARO_ADMIN_API_PROD     || 'https://api-admin-us-east.velaro.com',
+    messagingApiBase: process.env.VELARO_MESSAGING_API_PROD || 'https://api-messaging-us-east.velaro.com',
+  },
+  staging: {
+    adminApiBase:     process.env.VELARO_ADMIN_API_STAGING     || 'https://velaro-admin-staging.azurewebsites.net',
+    messagingApiBase: process.env.VELARO_MESSAGING_API_STAGING || 'https://velaro-messaging-api-staging.azurewebsites.net',
+  },
+};
+
+// Legacy single-entry config — migrate transparently on first read.
+function migrate(raw) {
+  if (raw.envs) return raw; // already multi-env
+  const apiBase = raw.apiBase || '';
+  const env = apiBase.includes('staging') ? 'staging' : 'prod';
+  return {
+    activeEnv: env,
+    envs: {
+      [env]: {
+        adminApiBase:      ENVS[env].adminApiBase,
+        messagingApiBase:  ENVS[env].messagingApiBase,
+        velaroToken:       raw.velaroToken,
+        velaroExpires:     raw.velaroExpires,
+        entraRefreshToken: raw.entraRefreshToken,
+        siteId:            raw.siteId,
+        userName:          raw.userName,
+      },
+    },
+    _lastUpdateCheck: raw._lastUpdateCheck,
+    _latestVersion:   raw._latestVersion,
+  };
+}
+
+export function readConfig() {
+  try {
+    const raw = JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+    return migrate(raw);
+  } catch {
+    return { activeEnv: 'prod', envs: {} };
+  }
+}
+
+export function writeConfig(data) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2), { mode: 0o600 });
+}
+
+export function getActiveEnv() {
+  return readConfig().activeEnv || 'prod';
+}
+
+export function setActiveEnv(env) {
+  if (!ENVS[env]) throw new Error(`Unknown environment "${env}". Use: prod, staging`);
+  const cfg = readConfig();
+  cfg.activeEnv = env;
+  writeConfig(cfg);
+}
+
+export function getEnvCredentials(env) {
+  const cfg = readConfig();
+  return cfg.envs?.[env] || null;
+}
+
+export function setEnvCredentials(env, creds) {
+  if (!ENVS[env]) throw new Error(`Unknown environment "${env}". Use: prod, staging`);
+  const cfg = readConfig();
+  cfg.envs = cfg.envs || {};
+  cfg.envs[env] = { ...ENVS[env], ...creds };
+  cfg.activeEnv = cfg.activeEnv || env;
+  writeConfig(cfg);
+}
+
+export function clearConfig() {
+  writeConfig({ activeEnv: 'prod', envs: {} });
+}