@velaro/cli 1.2.0 → 1.4.8

package/lib/commands/widget-container.js

@@ -0,0 +1,152 @@
+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';
+const DIM   = '\x1b[2m';
+
+function formatContainer(c) {
+  const enabled = c.isEnabled ? `${GRN}enabled${RESET}` : `${YEL}disabled${RESET}`;
+  const widgets = (c.widgetIds ?? []).length;
+  return `  #${c.id} | ${CYN}${c.name}${RESET} | style:${c.style} | pos:${c.position} | widgets:${widgets} | ${enabled}\n` +
+         `     ${DIM}containerId: ${c.containerId}${RESET}`;
+}
+
+// ── list ─────────────────────────────────────────────────────────────────────
+
+const listCommand = {
+  command:  'list',
+  describe: 'List all widget containers for this site',
+  builder:  (y) => y,
+  handler:  runCommand(async () => {
+    const data = await get('/PageWidgetContainers');
+    const containers = Array.isArray(data) ? data : [];
+    if (!containers.length) {
+      console.log('\nNo widget containers configured.\n');
+      return;
+    }
+    console.log(`\nWidget Containers (${containers.length})\n`);
+    for (const c of containers) console.log(formatContainer(c));
+    console.log('');
+  }),
+};
+
+// ── create ───────────────────────────────────────────────────────────────────
+
+const createCommand = {
+  command:  'create',
+  describe: 'Create a new widget container',
+  builder:  (y) =>
+    y
+      .option('name',     { type: 'string',  describe: 'Container name', demandOption: true })
+      .option('style',    { type: 'string',  describe: 'drawer | cluster | tabs', demandOption: true,
+                            choices: ['drawer', 'cluster', 'tabs'] })
+      .option('position', { type: 'string',  describe: 'Position, e.g. bottom-right', default: 'bottom-right' })
+      .option('color',    { type: 'string',  describe: 'Primary hex color, e.g. #2563eb', default: '#2563eb' }),
+  handler:  runCommand(async (argv) => {
+    const c = await post('/PageWidgetContainers', {
+      name:         argv.name,
+      style:        argv.style,
+      position:     argv.position,
+      primaryColor: argv.color,
+      widgetIds:    [],
+      isEnabled:    true,
+    });
+    console.log(`\nCreated container "${c.name}" (id:${c.id})`);
+    console.log(`  containerId: ${c.containerId}`);
+    console.log(`\nEmbed snippet:`);
+    console.log(`  <script>`);
+    console.log(`    window.__velaro_pw_container = { siteId: "YOUR_SITE_ID", containerId: "${c.containerId}" };`);
+    console.log(`  </script>`);
+    console.log(`  <script src="https://messaging.velaro.com/widget.js" async></script>\n`);
+  }),
+};
+
+// ── update ───────────────────────────────────────────────────────────────────
+
+const updateCommand = {
+  command:  'update <id>',
+  describe: 'Update an existing widget container',
+  builder:  (y) =>
+    y
+      .positional('id',      { type: 'number', describe: 'Container ID' })
+      .option('name',        { type: 'string' })
+      .option('style',       { type: 'string', choices: ['drawer', 'cluster', 'tabs'] })
+      .option('position',    { type: 'string' })
+      .option('color',       { type: 'string', describe: 'Primary hex color' })
+      .option('enable',      { type: 'boolean', describe: 'Enable the container' })
+      .option('disable',     { type: 'boolean', describe: 'Disable the container' })
+      .option('widgets',     { type: 'string',  describe: 'Comma-separated widgetId UUIDs (replaces current list)' }),
+  handler:  runCommand(async (argv) => {
+    const body = {};
+    if (argv.name)         body.name         = argv.name;
+    if (argv.style)        body.style        = argv.style;
+    if (argv.position)     body.position     = argv.position;
+    if (argv.color)        body.primaryColor = argv.color;
+    if (argv.enable)       body.isEnabled    = true;
+    if (argv.disable)      body.isEnabled    = false;
+    if (argv.widgets)      body.widgetIds    = argv.widgets.split(',').map(s => s.trim()).filter(Boolean);
+
+    if (!Object.keys(body).length) {
+      console.error('No fields to update. Pass at least one option.');
+      process.exitCode = 1;
+      return;
+    }
+
+    const c = await request('PUT', `/PageWidgetContainers/${argv.id}`, body);
+    console.log(`\nUpdated container "${c.name}" (id:${c.id})\n`);
+    console.log(formatContainer(c));
+    console.log('');
+  }),
+};
+
+// ── delete ───────────────────────────────────────────────────────────────────
+
+const deleteCommand = {
+  command:  'delete <id>',
+  describe: 'Soft-delete a widget container',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Container ID' }),
+  handler:  runCommand(async (argv) => {
+    await del(`/PageWidgetContainers/${argv.id}`);
+    console.log(`\nContainer #${argv.id} deleted.\n`);
+  }),
+};
+
+// ── embed ─────────────────────────────────────────────────────────────────────
+
+const embedCommand = {
+  command:  'embed <id>',
+  describe: 'Print the embed snippet for a container',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Container ID' }),
+  handler:  runCommand(async (argv) => {
+    const c = await get(`/PageWidgetContainers/${argv.id}`);
+    console.log(`\nEmbed snippet for "${c.name}" (containerId: ${c.containerId}):\n`);
+    console.log(`<script>`);
+    console.log(`  window.__velaro_pw_container = {`);
+    console.log(`    siteId:      "YOUR_SITE_ID",`);
+    console.log(`    containerId: "${c.containerId}"`);
+    console.log(`  };`);
+    console.log(`</script>`);
+    console.log(`<script src="https://messaging.velaro.com/widget.js" async></script>\n`);
+    console.log(`Widgets in container (${(c.widgetIds || []).length}): ${(c.widgetIds || []).join(', ') || 'none'}`);
+    console.log('');
+  }),
+};
+
+// ── root command ──────────────────────────────────────────────────────────────
+
+export const widgetContainerCommand = {
+  command:  'widget-container <subcommand>',
+  describe: 'Manage page widget containers (group multiple widgets into a drawer, cluster, or tab strip)',
+  builder:  (yargs) =>
+    yargs
+      .command(listCommand)
+      .command(createCommand)
+      .command(updateCommand)
+      .command(deleteCommand)
+      .command(embedCommand)
+      .demandCommand(1, 'Specify a subcommand: list, create, update, delete, embed'),
+  handler: () => {},
+};

package/lib/commands/woocommerce.js

@@ -0,0 +1,240 @@
+/**
+ * velaro woocommerce — WooCommerce store management
+ *
+ *   velaro woocommerce status              Show connection status for the current site
+ *   velaro woocommerce connect <storeUrl>  Start the WooCommerce store connection flow
+ *   velaro woocommerce disconnect          Disconnect the WooCommerce store
+ *   velaro woocommerce skills              List available WooCommerce AI skills
+ *   velaro woocommerce orders              Search orders by email or order ID
+ *   velaro woocommerce products            Search the product catalog
+ *   velaro woocommerce logs                View integration activity logs
+ */
+
+import { request } from '../api.js';
+
+const GRN  = '\x1b[32m';
+const RED  = '\x1b[31m';
+const CYN  = '\x1b[36m';
+const YLW  = '\x1b[33m';
+const DIM  = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RST  = '\x1b[0m';
+
+// ── status ────────────────────────────────────────────────────────────────────
+
+async function statusHandler(_argv) {
+  // /WooCommerce/billing/status resolves site from the JWT — no siteId param needed.
+  // Returns: billingStatus, planName, oauthConnected, hasActiveSubscription.
+  const r = await request('GET', `/WooCommerce/billing/status`);
+  if (!r) {
+    console.log('\nNo WooCommerce connection found for this site.\n');
+    return;
+  }
+  const connected = r.oauthConnected ?? r.hasActiveSubscription ?? false;
+  const statusLabel = connected ? `${GRN}connected${RST}` : `${RED}not connected${RST}`;
+  console.log(`\n${BOLD}WooCommerce Status${RST}\n`);
+  console.log(`  Status:    ${statusLabel}`);
+  if (r.planName)          console.log(`  Plan:           ${r.planName}`);
+  if (r.billingStatus)     console.log(`  Billing:        ${r.billingStatus}`);
+  if (r.oauthConnectedAt)  console.log(`  OAuth Connected:${DIM}${new Date(r.oauthConnectedAt).toLocaleString()}${RST}`);
+  console.log('');
+}
+
+// ── connect ───────────────────────────────────────────────────────────────────
+
+async function connectHandler(argv) {
+  if (!argv.storeUrl) {
+    console.error(`${RED}✗ <storeUrl> is required (e.g. velaro woocommerce connect https://mystore.com)${RST}`);
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    const r = await request('GET', `/WooCommerce/auth/start?storeUrl=${encodeURIComponent(argv.storeUrl)}`);
+    if (!r?.authUrl) {
+      console.error(`${RED}✗ Server did not return an authUrl — check that the store URL is correct${RST}`);
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`\n${BOLD}WooCommerce Connection Flow${RST}\n`);
+    console.log(`  Visit this URL in your browser to authorize Velaro:\n`);
+    console.log(`  ${CYN}${r.authUrl}${RST}\n`);
+    console.log(`  ${DIM}WooCommerce will redirect back to Velaro after approval.${RST}\n`);
+  } catch (e) {
+    console.error(`\n${RED}✗ Failed to start connection: ${e.message}${RST}\n`);
+    process.exitCode = 1;
+  }
+}
+
+// ── disconnect ────────────────────────────────────────────────────────────────
+
+async function disconnectHandler(argv) {
+  const params = argv.site ? `?siteId=${argv.site}` : '';
+  try {
+    await request('POST', `/WooCommerce/auth/disconnect${params}`, {});
+    console.log(`\n${GRN}✓ WooCommerce store disconnected${RST}\n`);
+  } catch (e) {
+    console.error(`\n${RED}✗ Disconnect failed: ${e.message}${RST}\n`);
+    process.exitCode = 1;
+  }
+}
+
+// ── skills ────────────────────────────────────────────────────────────────────
+
+async function skillsHandler(argv) {
+  const params = argv.site ? `?siteId=${argv.site}` : '';
+  const data = await request('GET', `/AI/Skills${params}`);
+  const skills = Array.isArray(data) ? data : (data?.skills ?? []);
+  const wooSkills = skills.filter(s => s.category === 'WooCommerce');
+  if (wooSkills.length === 0) {
+    console.log(`\n${YLW}No WooCommerce skills available for this site.${RST}`);
+    console.log(`${DIM}Enable in SuperAdmin → Subscription: EnableWooCommerce (core/read), EnableWooCommerceWrite (write tier), EnableDestructiveAiSkills (cancel/refund/coupon).${RST}\n`);
+    return;
+  }
+  console.log(`\n${BOLD}${wooSkills.length} WooCommerce AI skill(s)${RST}\n`);
+  for (const s of wooSkills) {
+    const tier = s.tier ? ` ${DIM}[${s.tier}]${RST}` : '';
+    const gate = s.subscriptionFlag ? ` ${DIM}(${s.subscriptionFlag})${RST}` : '';
+    console.log(`  ${BOLD}${s.toolName ?? s.name}${RST}${tier}${gate}`);
+    if (s.displayName && s.displayName !== s.toolName) console.log(`    ${DIM}${s.displayName}${RST}`);
+  }
+  console.log('');
+}
+
+// ── orders ────────────────────────────────────────────────────────────────────
+
+async function ordersHandler(argv) {
+  if (!argv.email && !argv.id) {
+    console.error(`${RED}✗ --email or --id is required${RST}`);
+    process.exitCode = 1;
+    return;
+  }
+  const q = argv.id ?? argv.email;
+  const limit = Math.min(50, argv.limit ?? 10);
+  const orders = await request('GET', `/WooCommerce/data/orders/search?q=${encodeURIComponent(q)}&limit=${limit}`);
+  if (!Array.isArray(orders) || orders.length === 0) {
+    console.log(`\nNo orders found for "${q}".\n`);
+    return;
+  }
+  console.log(`\n${BOLD}${orders.length} order(s)${RST}\n`);
+  for (const o of orders) {
+    const date = (o.dateCreated ?? o.date_created ?? '').slice(0, 10);
+    const total = o.total ?? o.grandTotal ?? '0.00';
+    const status = o.status ?? 'unknown';
+    console.log(`  [#${o.id ?? o.orderId}]  ${status.padEnd(14)}  $${String(total).padStart(9)}  ${DIM}${date}${RST}`);
+    if (argv.verbose && o.billingEmail) console.log(`             ${DIM}${o.billingEmail}${RST}`);
+  }
+  console.log('');
+}
+
+// ── products ──────────────────────────────────────────────────────────────────
+
+async function productsHandler(argv) {
+  if (!argv.query) {
+    console.error(`${RED}✗ --query is required${RST}`);
+    process.exitCode = 1;
+    return;
+  }
+  const limit = Math.min(50, argv.limit ?? 10);
+  const products = await request('GET', `/WooCommerce/data/products?search=${encodeURIComponent(argv.query)}&limit=${limit}`);
+  if (!Array.isArray(products) || products.length === 0) {
+    console.log(`\nNo products found for "${argv.query}".\n`);
+    return;
+  }
+  console.log(`\n${BOLD}${products.length} product(s)${RST}\n`);
+  for (const p of products) {
+    const stock = p.stockStatus === 'instock' ? `${GRN}in stock${RST}` : `${RED}${p.stockStatus ?? 'unknown'}${RST}`;
+    console.log(`  [${p.sku ?? p.id}]  ${BOLD}${p.name}${RST}  $${p.price}  ${stock}`);
+    if (p.permalink) console.log(`            ${DIM}${p.permalink}${RST}`);
+  }
+  console.log('');
+}
+
+// ── logs ──────────────────────────────────────────────────────────────────────
+
+async function logsHandler(argv) {
+  const params = new URLSearchParams();
+  if (argv.severity) params.set('severity', argv.severity);
+  if (argv.search)   params.set('search', argv.search);
+  params.set('pageSize', String(Math.min(100, argv.pageSize ?? 25)));
+  const data = await request('GET', `/Integration/Logs/WooCommerce?${params}`);
+  const items = data?.items ?? [];
+  if (items.length === 0) {
+    console.log('\nNo WooCommerce activity log entries found.\n');
+    return;
+  }
+  console.log(`\n${BOLD}${items.length} of ${data.total} WooCommerce activity entries${RST}\n`);
+  for (const item of items) {
+    const ts  = new Date(item.createdAt).toISOString().replace('T', ' ').slice(0, 19);
+    const sev = item.severity === 'Error'   ? `${RED}${item.severity}${RST}  ` :
+                item.severity === 'Warning' ? `${YLW}${item.severity}${RST}` :
+                `${DIM}${item.severity}${RST}  `;
+    console.log(`  ${DIM}${ts}${RST}  ${sev}  [${item.category ?? '?'}]  ${item.message ?? ''}`);
+    if (item.additionalInfo) console.log(`           ${DIM}${item.additionalInfo}${RST}`);
+  }
+  if (data.total > items.length) console.log(`\n  ${DIM}${data.total - items.length} more — use --page-size to see more${RST}`);
+  console.log('');
+}
+
+// ── command export ────────────────────────────────────────────────────────────
+
+export const woocommerceCommand = {
+  command:  'woocommerce <subcommand>',
+  describe: 'WooCommerce store management',
+  builder: y => y
+    .command({
+      command:  'status',
+      describe: 'Show WooCommerce connection status for the current site',
+      builder: yy => yy,
+      handler: statusHandler,
+    })
+    .command({
+      command:  'connect <storeUrl>',
+      describe: 'Start the WooCommerce store connection flow',
+      builder: yy => yy
+        .positional('storeUrl', { describe: 'WooCommerce store URL (e.g. https://mystore.com)', type: 'string' }),
+      handler: connectHandler,
+    })
+    .command({
+      command:  'disconnect',
+      describe: 'Disconnect the WooCommerce store',
+      builder: yy => yy
+        .option('site', { describe: 'Site ID (optional)', type: 'number' }),
+      handler: disconnectHandler,
+    })
+    .command({
+      command:  'skills',
+      describe: 'List available WooCommerce AI skills for this site',
+      builder: yy => yy
+        .option('site', { describe: 'Site ID (optional)', type: 'number' }),
+      handler: skillsHandler,
+    })
+    .command({
+      command:  'orders',
+      describe: 'Search WooCommerce orders by email or order ID',
+      builder: yy => yy
+        .option('email',   { describe: 'Customer email address', type: 'string' })
+        .option('id',      { describe: 'Order ID', type: 'number' })
+        .option('limit',   { describe: 'Max results (default 10)', type: 'number', default: 10 })
+        .option('verbose', { describe: 'Show additional fields', type: 'boolean', default: false }),
+      handler: ordersHandler,
+    })
+    .command({
+      command:  'products',
+      describe: 'Search the WooCommerce product catalog',
+      builder: yy => yy
+        .option('query', { describe: 'Search term', type: 'string' })
+        .option('limit', { describe: 'Max results (default 10)', type: 'number', default: 10 }),
+      handler: productsHandler,
+    })
+    .command({
+      command:  'logs',
+      describe: 'View WooCommerce integration activity logs',
+      builder: yy => yy
+        .option('severity',  { describe: 'Filter by severity (Error, Warning, Info)', type: 'string' })
+        .option('search',    { describe: 'Search within log messages', type: 'string' })
+        .option('page-size', { describe: 'Number of entries to return (max 100)', type: 'number', default: 25 }),
+      handler: logsHandler,
+    })
+    .demandCommand(1, 'Specify a subcommand. Run "velaro woocommerce --help" for options.'),
+  handler: () => {},
+};