@velaro/cli 0.7.0 → 1.4.8

package/lib/commands/billing.js

@@ -0,0 +1,138 @@
+// velaro billing — plan status, contracts, invoices, QB sync, subscription flags
+import { request } from '../api.js';
+
+function fmtCents(cents) {
+  return `$${(cents / 100).toFixed(2)}`;
+}
+
+function fmtDate(iso) {
+  if (!iso) return '—';
+  return iso.slice(0, 10);
+}
+
+// ── plan-status ───────────────────────────────────────────────────────────────
+
+async function planStatus() {
+  const s = await request('GET', '/BillingPayment/plan-status');
+
+  console.log(`\nPlan Status — Site ${s.siteId}\n${'─'.repeat(50)}`);
+
+  if (!s.subscription) {
+    console.log('  No subscription record found.');
+  } else {
+    const sub = s.subscription;
+    console.log(`  Seats:      ${sub.maxLicensedSeats}`);
+    console.log(`  Conv/mo:    ${sub.maxConversationsPerMonth || '∞'}`);
+    console.log(`  Self-serve: ${sub.enableSelfServeSeats ? 'YES' : 'no'}`);
+    console.log(`\n  Active flags (${sub.enabledFlags.length}):`);
+    if (sub.enabledFlags.length === 0) {
+      console.log('    none');
+    } else {
+      for (const f of sub.enabledFlags) console.log(`    ✓ ${f}`);
+    }
+  }
+
+  if (s.recentSessions?.length) {
+    console.log(`\n  Recent Stripe Sessions:`);
+    for (const p of s.recentSessions) {
+      console.log(`    [${p.id}] ${fmtCents(p.amountCents)}  ${p.status}  ${fmtDate(p.createdAt)}`);
+    }
+  }
+
+  if (s.recentInvoices?.length) {
+    console.log(`\n  Recent Invoices:`);
+    for (const i of s.recentInvoices) {
+      const qb = i.qboSyncStatus || 'not pushed';
+      const err = i.qboLastSyncError ? `  ERR: ${i.qboLastSyncError.slice(0, 60)}` : '';
+      console.log(`    ${i.invoiceNumber || i.id}  ${fmtCents(i.totalCents)}  ${i.status}  QB:${qb}${err}`);
+    }
+  }
+
+  if (s.deferredSchedules?.length) {
+    console.log(`\n  Deferred Revenue Schedules:`);
+    for (const d of s.deferredSchedules) {
+      const pct = d.totalCents > 0 ? Math.round((d.recognizedCents / d.totalCents) * 100) : 0;
+      console.log(`    ${d.startMonth}→${d.endMonth}  ${fmtCents(d.totalCents)}  ${pct}% recognized  ${d.status}`);
+    }
+  }
+  console.log('');
+}
+
+// ── contracts ─────────────────────────────────────────────────────────────────
+
+async function listContracts() {
+  const contracts = await request('GET', '/api/Contract');
+  if (!Array.isArray(contracts) || !contracts.length) {
+    console.log('No contracts found.');
+    return;
+  }
+  console.log(`\nContracts (${contracts.length})\n${'─'.repeat(60)}`);
+  for (const c of contracts) {
+    const monthly = c.totalMonthlyValue ? `  $${Number(c.totalMonthlyValue).toFixed(2)}/mo` : '';
+    const signed = c.signedAt ? `  signed ${fmtDate(c.signedAt)}` : '';
+    console.log(`  [${c.id}] ${c.status.padEnd(8)} "${c.title}"  ${c.customerEmail || ''}${monthly}${signed}`);
+  }
+  console.log('');
+}
+
+async function showContract(id) {
+  const c = await request('GET', `/api/Contract/${id}`);
+  console.log(`\nContract ${c.id}: "${c.title}"\n${'─'.repeat(50)}`);
+  console.log(`  Status:       ${c.status}`);
+  console.log(`  Customer:     ${c.customerName || '—'} <${c.customerEmail || '—'}>`);
+  if (c.customerCompany) console.log(`  Company:      ${c.customerCompany}`);
+  console.log(`  Monthly:      $${Number(c.totalMonthlyValue || 0).toFixed(2)}/mo  Setup: $${Number(c.setupFee || 0).toFixed(2)}`);
+  console.log(`  Service:      ${fmtDate(c.serviceStartDate)} → ${fmtDate(c.serviceEndDate)}`);
+  console.log(`  Activation:   ${c.subscriptionActivationMode}  activated: ${fmtDate(c.subscriptionActivatedAt)}`);
+  console.log(`  QB Customer:  ${c.qboCustomerId || 'not synced'}`);
+  console.log(`  QB Invoice:   ${c.qboInvoiceId || '—'}`);
+  if (c.signedAt) console.log(`  Signed:       ${fmtDate(c.signedAt)} by ${c.signedByEmail}`);
+  if (c.cancellationRequestedAt) console.log(`  ⚠️  Cancelled: ${fmtDate(c.cancellationRequestedAt)} by ${c.cancellationRequestedBy}`);
+  if (c.amendments?.length) console.log(`  Amendments:   ${c.amendments.length}`);
+  console.log('');
+}
+
+async function sendContract(id) {
+  await request('POST', `/api/Contract/${id}/send`);
+  console.log(`✅ Contract ${id} sent — signing link dispatched to customer.`);
+}
+
+// ── invoices ──────────────────────────────────────────────────────────────────
+
+async function listInvoices() {
+  const invoices = await request('GET', '/api/BillingInvoiceRecord');
+  if (!Array.isArray(invoices) || !invoices.length) {
+    console.log('No invoices found.');
+    return;
+  }
+  console.log(`\nInvoices (${invoices.length})\n${'─'.repeat(70)}`);
+  for (const i of invoices) {
+    const qb = `QB:${(i.qboSyncStatus || 'not pushed').padEnd(10)}`;
+    const attempts = i.qboSyncAttempts > 0 ? ` (${i.qboSyncAttempts}x)` : '';
+    console.log(`  [${i.id}] ${(i.invoiceNumber || '').padEnd(16)} ${fmtCents(i.totalCents).padEnd(10)} ${i.status.padEnd(8)} ${qb}${attempts}  ${fmtDate(i.createdAt)}`);
+    if (i.qboLastSyncError) console.log(`         QB error: ${i.qboLastSyncError.slice(0, 80)}`);
+  }
+  console.log('');
+}
+
+async function dispatchInvoice(id) {
+  await request('POST', `/api/BillingInvoiceRecord/${id}/dispatch`);
+  console.log(`✅ Invoice ${id} dispatched — email sent and status set to open.`);
+}
+
+// ── command export ────────────────────────────────────────────────────────────
+
+export const billingCommand = {
+  command: 'billing <subcommand>',
+  describe: 'Billing operations: plan status, contracts, invoices, QB sync',
+  builder: (yargs) =>
+    yargs
+      .command('plan-status', 'Show current plan flags, seats, QB sync state, and deferred revenue', {}, () => planStatus())
+      .command('contracts', 'List all contracts', {}, () => listContracts())
+      .command('contract <id>', 'Show a specific contract', {}, (args) => showContract(args.id))
+      .command('contract-send <id>', 'Send a contract to the customer for signing', {}, (args) => sendContract(args.id))
+      .command('invoices', 'List invoice records with QB sync status', {}, () => listInvoices())
+      .command('invoice-dispatch <id>', 'Email an invoice to the customer (sets status to open)', {}, (args) => dispatchInvoice(args.id))
+      .demandCommand(1, 'Specify a subcommand: plan-status | contracts | contract <id> | contract-send <id> | invoices | invoice-dispatch <id>'),
+  handler: () => {},
+};

package/lib/commands/bot.js

@@ -1,137 +1,141 @@
-import { readFileSync }   from 'fs';
-import { get, post }      from '../api.js';
-import { requireFeature } from '../subscription.js';
-import { runCommand }     from '../run.js';
-
-export const botCommand = {
-  command:  'bot <subcommand>',
-  describe: 'Manage AI bots',
-  builder:  (yargs) =>
-    yargs
-      .command(botListCommand)
-      .command(botGetCommand)
-      .command(botSetupCommand)
-      .command(botPromptCommand)
-      .demandCommand(1, 'Specify a subcommand: list, get, setup, prompt'),
-  handler: () => {},
-};
-
-// ── list ───────────────────────────────────────────────────────────────────────
-
-const botListCommand = {
-  command:  'list',
-  describe: 'List AI bots on your site',
-  handler:  runCommand(async () => {
-    await requireFeature('enableAI', 'AI Bots');
-
-    const bots = await get('/AIConfiguration/list');
-    if (!bots?.length) {
-      console.log('No bots found. Create one with: velaro bot setup --name "My Bot"');
-      return;
-    }
-    console.log(`Found ${bots.length} bot(s):\n`);
-    for (const b of bots) {
-      console.log(`  [${b.id}] ${b.name}  model=${b.aiModel ?? '(default)'}  status=${b.status ?? 'ready'}`);
-    }
-  }),
-};
-
-// ── get ────────────────────────────────────────────────────────────────────────
-
-const botGetCommand = {
-  command:  'get <id>',
-  describe: 'Show full configuration for a bot',
-  builder:  (y) => y.positional('id', { type: 'number', describe: 'Bot ID' }),
-  handler:  runCommand(async (argv) => {
-    await requireFeature('enableAI', 'AI Bots');
-
-    const bot = await get(`/AIConfiguration/${argv.id}`);
-    if (!bot) { console.error(`Bot ${argv.id} not found.`); process.exit(1); }
-
-    console.log(`\n[${bot.id}] ${bot.name}`);
-    console.log(`  Model:        ${bot.aiModel ?? '(default)'}`);
-    console.log(`  Tone:         ${bot.tone ?? '—'}`);
-    console.log(`  Reply length: ${bot.replyLength ?? '—'}`);
-    console.log(`  Status:       ${bot.status ?? 'ready'}`);
-    if (bot.prompt) {
-      console.log(`\nSystem prompt:\n`);
-      console.log(bot.prompt);
-    } else {
-      console.log(`\nSystem prompt: (none)`);
-    }
-  }),
-};
-
-// ── setup ──────────────────────────────────────────────────────────────────────
-
-const botSetupCommand = {
-  command:  'setup',
-  describe: 'Create or update an AI bot (upsert by name)',
-  builder:  (y) =>
-    y
-      .option('name',         { describe: 'Bot name',                                                              type: 'string', demandOption: true })
-      .option('prompt',       { describe: 'System prompt text (inline)',                                            type: 'string' })
-      .option('prompt-file',  { describe: 'Path to a file containing the system prompt',                           type: 'string' })
-      .option('model',        { describe: 'AI model',           choices: ['velaro-gpt-4o-mini','velaro-gpt-4o'],   type: 'string', default: 'velaro-gpt-4o-mini' })
-      .option('tone',         { describe: 'Response tone',      choices: ['Professional','Friendly','Formal','Casual'], default: 'Professional' })
-      .option('reply-length', { describe: 'Response length',    choices: ['Short','Medium','Long'],                default: 'Medium' })
-      .option('urls',         { describe: 'Comma-separated data source URLs',                                      type: 'string' })
-      .conflicts('prompt', 'prompt-file'),
-
-  handler: runCommand(async (argv) => {
-    await requireFeature('enableAI', 'AI Bots');
-
-    let promptText = argv.prompt;
-    if (argv['prompt-file']) {
-      promptText = readFileSync(argv['prompt-file'], 'utf8').trim();
-      console.log(`Read ${promptText.length} chars from ${argv['prompt-file']}`);
-    }
-
-    const payload = {
-      name:        argv.name,
-      aiModel:     argv.model,
-      tone:        argv.tone,
-      replyLength: argv['reply-length'],
-    };
-    if (promptText) payload.prompt   = promptText;
-    if (argv.urls)  payload.dataUrls = argv.urls.split(',').map((u) => u.trim()).filter(Boolean);
-
-    const result = await post('/AIConfiguration', payload);
-    console.log(`Saved: [${result.id}] ${result.name}`);
-  }),
-};
-
-// ── prompt ─────────────────────────────────────────────────────────────────────
-
-const botPromptCommand = {
-  command:  'prompt <id>',
-  describe: 'Get or update a bot\'s system prompt',
-  builder:  (y) =>
-    y
-      .positional('id', { type: 'number', describe: 'Bot ID' })
-      .option('set',    { describe: 'New prompt text (inline)',        type: 'string' })
-      .option('file',   { describe: 'Path to a .txt/.md prompt file', type: 'string' })
-      .conflicts('set', 'file'),
-
-  handler: runCommand(async (argv) => {
-    await requireFeature('enableAI', 'AI Bots');
-
-    const bot = await get(`/AIConfiguration/${argv.id}`);
-    if (!bot) { console.error(`Bot ${argv.id} not found.`); process.exit(1); }
-
-    if (!argv.set && !argv.file) {
-      // Read mode — print current prompt
-      console.log(bot.prompt ?? '(no system prompt set)');
-      return;
-    }
-
-    let promptText = argv.set;
-    if (argv.file) {
-      promptText = readFileSync(argv.file, 'utf8').trim();
-      console.log(`Read ${promptText.length} chars from ${argv.file}`);
-    }
-
-    await post('/AIConfiguration', { ...bot, prompt: promptText });
-    console.log(`Bot [${argv.id}] "${bot.name}" prompt updated (${promptText.length} chars).`);
-  }),
-};
+import { readFileSync }   from 'fs';
+import { messagingGet as get, messagingPost as post } from '../api.js';
+import { requireFeature } from '../subscription.js';
+import { runCommand }     from '../run.js';
+
+export const botCommand = {
+  command:  'bot <subcommand>',
+  describe: 'Manage AI bots',
+  builder:  (yargs) =>
+    yargs
+      .command(botListCommand)
+      .command(botGetCommand)
+      .command(botSetupCommand)
+      .command(botPromptCommand)
+      .demandCommand(1, 'Specify a subcommand: list, get, setup, prompt'),
+  handler: () => {},
+};
+
+// ── list ───────────────────────────────────────────────────────────────────────
+
+const botListCommand = {
+  command:  'list',
+  describe: 'List AI bots on your site',
+  handler:  runCommand(async () => {
+    await requireFeature('enableAI', 'AI Bots');
+
+    const bots = await get('/AIConfiguration/list');
+    if (!bots?.length) {
+      console.log('No bots found. Create one with: velaro bot setup --name "My Bot"');
+      return;
+    }
+    console.log(`Found ${bots.length} bot(s):\n`);
+    for (const b of bots) {
+      console.log(`  [${b.id}] ${b.name}  model=${b.aiModel ?? '(default)'}  status=${b.status ?? 'ready'}`);
+    }
+  }),
+};
+
+// ── get ────────────────────────────────────────────────────────────────────────
+
+const botGetCommand = {
+  command:  'get <id>',
+  describe: 'Show full configuration for a bot',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Bot ID' }),
+  handler:  runCommand(async (argv) => {
+    await requireFeature('enableAI', 'AI Bots');
+
+    // No GET /AIConfiguration/{id} route exists -- list + filter client-side, same pattern
+    // ai-config.js already uses.
+    const all = (await get('/AIConfiguration/list')) ?? [];
+    const bot = all.find((x) => x.id === argv.id);
+    if (!bot) { console.error(`Bot ${argv.id} not found.`); process.exitCode = 1; return; }
+
+    console.log(`\n[${bot.id}] ${bot.name}`);
+    console.log(`  Model:        ${bot.aiModel ?? '(default)'}`);
+    console.log(`  Tone:         ${bot.tone ?? '—'}`);
+    console.log(`  Reply length: ${bot.replyLength ?? '—'}`);
+    console.log(`  Status:       ${bot.status ?? 'ready'}`);
+    if (bot.prompt) {
+      console.log(`\nSystem prompt:\n`);
+      console.log(bot.prompt);
+    } else {
+      console.log(`\nSystem prompt: (none)`);
+    }
+  }),
+};
+
+// ── setup ──────────────────────────────────────────────────────────────────────
+
+const botSetupCommand = {
+  command:  'setup',
+  describe: 'Create or update an AI bot (upsert by name)',
+  builder:  (y) =>
+    y
+      .option('name',         { describe: 'Bot name',                                                              type: 'string', demandOption: true })
+      .option('prompt',       { describe: 'System prompt text (inline)',                                            type: 'string' })
+      .option('prompt-file',  { describe: 'Path to a file containing the system prompt',                           type: 'string' })
+      .option('model',        { describe: 'AI model',           choices: ['velaro-gpt-4o-mini','velaro-gpt-4o'],   type: 'string', default: 'velaro-gpt-4o-mini' })
+      .option('tone',         { describe: 'Response tone',      choices: ['Professional','Friendly','Formal','Casual'], default: 'Professional' })
+      .option('reply-length', { describe: 'Response length',    choices: ['Short','Medium','Long'],                default: 'Medium' })
+      .option('urls',         { describe: 'Comma-separated data source URLs',                                      type: 'string' })
+      .conflicts('prompt', 'prompt-file'),
+
+  handler: runCommand(async (argv) => {
+    await requireFeature('enableAI', 'AI Bots');
+
+    let promptText = argv.prompt;
+    if (argv['prompt-file']) {
+      promptText = readFileSync(argv['prompt-file'], 'utf8').trim();
+      console.log(`Read ${promptText.length} chars from ${argv['prompt-file']}`);
+    }
+
+    const payload = {
+      name:        argv.name,
+      aiModel:     argv.model,
+      tone:        argv.tone,
+      replyLength: argv['reply-length'],
+    };
+    if (promptText) payload.prompt   = promptText;
+    if (argv.urls)  payload.dataUrls = argv.urls.split(',').map((u) => u.trim()).filter(Boolean);
+
+    const result = await post('/AIConfiguration', payload);
+    console.log(`Saved: [${result.id}] ${result.name}`);
+  }),
+};
+
+// ── prompt ─────────────────────────────────────────────────────────────────────
+
+const botPromptCommand = {
+  command:  'prompt <id>',
+  describe: 'Get or update a bot\'s system prompt',
+  builder:  (y) =>
+    y
+      .positional('id', { type: 'number', describe: 'Bot ID' })
+      .option('set',    { describe: 'New prompt text (inline)',        type: 'string' })
+      .option('file',   { describe: 'Path to a .txt/.md prompt file', type: 'string' })
+      .conflicts('set', 'file'),
+
+  handler: runCommand(async (argv) => {
+    await requireFeature('enableAI', 'AI Bots');
+
+    const all = (await get('/AIConfiguration/list')) ?? [];
+    const bot = all.find((x) => x.id === argv.id);
+    if (!bot) { console.error(`Bot ${argv.id} not found.`); process.exitCode = 1; return; }
+
+    if (!argv.set && !argv.file) {
+      // Read mode — print current prompt
+      console.log(bot.prompt ?? '(no system prompt set)');
+      return;
+    }
+
+    let promptText = argv.set;
+    if (argv.file) {
+      promptText = readFileSync(argv.file, 'utf8').trim();
+      console.log(`Read ${promptText.length} chars from ${argv.file}`);
+    }
+
+    await post('/AIConfiguration', { ...bot, prompt: promptText });
+    console.log(`Bot [${argv.id}] "${bot.name}" prompt updated (${promptText.length} chars).`);
+  }),
+};

package/lib/commands/bundle.js

@@ -0,0 +1,168 @@
+// velaro bundle — manage Chat Experience Bundles (Bundle/* on velaro-messaging).
+// Site isolation is enforced server-side by BundleController's [Authorize]-scoped
+// SiteId (ClientControllerBase) — never passed by the client.
+import { messagingGet, messagingPost, messagingPut, messagingDel } from '../api.js';
+import { runCommand } from '../run.js';
+
+const get  = messagingGet;
+const post = messagingPost;
+const put  = messagingPut;
+const del  = messagingDel;
+
+export const bundleCommand = {
+  command:  'bundle <subcommand>',
+  describe: 'Manage Chat Experience Bundles — list, get, create, update, delete',
+  builder:  (yargs) =>
+    yargs
+      .command(bundleListCommand)
+      .command(bundleGetCommand)
+      .command(bundleGetDefaultCommand)
+      .command(bundleCreateCommand)
+      .command(bundleUpdateCommand)
+      .command(bundleDeleteCommand)
+      .demandCommand(1, 'Specify a subcommand: list, get, get-default, create, update, delete'),
+  handler: () => {},
+};
+
+function printBundle(b) {
+  console.log(`  id:                   ${b.id}`);
+  console.log(`  name:                 ${b.name}`);
+  console.log(`  isDefault:            ${b.isDefault}`);
+  console.log(`  chatWindowId:         ${b.chatWindowId ?? '(none)'}`);
+  console.log(`  preChatSurveyId:      ${b.preChatSurveyId ?? '(none)'}`);
+  console.log(`  postChatSurveyId:     ${b.postChatSurveyId ?? '(none)'}`);
+  console.log(`  offlineSurveyId:      ${b.offlineSurveyId ?? '(none)'}`);
+  console.log(`  defaultTeamId:        ${b.defaultTeamId ?? '(none)'}`);
+  console.log(`  personaId:            ${b.personaId ?? '(none)'}`);
+  console.log(`  aiConfigurationId:    ${b.aiConfigurationId ?? '(none)'}`);
+  console.log(`  showOnClosedLauncher: ${b.showOnClosedLauncher}`);
+  console.log(`  createdUtc:           ${b.createdUtc}`);
+  console.log(`  modifiedUtc:          ${b.modifiedUtc}`);
+}
+
+// ── list ─────────────────────────────────────────────────────────────────────
+
+const bundleListCommand = {
+  command:  'list',
+  describe: 'List all Chat Experience Bundles on the current site',
+  handler:  runCommand(async () => {
+    const bundles = (await get('/Bundle/list')) ?? [];
+    if (!bundles.length) { console.log('No experience bundles found.'); return; }
+
+    const idW = Math.max(2, ...bundles.map((b) => String(b.id).length));
+    console.log(`\n${'id'.padStart(idW)}  name`);
+    console.log(`${'-'.repeat(idW)}  ----`);
+    for (const b of bundles) {
+      const defaultNote = b.isDefault ? '  [default]' : '';
+      const closedNote  = b.showOnClosedLauncher ? '  [shows on closed launcher]' : '';
+      console.log(`${String(b.id).padStart(idW)}  ${b.name ?? '(unnamed)'}${defaultNote}${closedNote}`);
+    }
+    console.log(`\n${bundles.length} bundle(s)`);
+  }),
+};
+
+// ── get ──────────────────────────────────────────────────────────────────────
+
+const bundleGetCommand = {
+  command:  'get <id>',
+  describe: 'Get one Chat Experience Bundle by ID',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Bundle ID' }),
+  handler:  runCommand(async (argv) => {
+    const bundle = await get(`/Bundle/get/${argv.id}`);
+    printBundle(bundle);
+  }),
+};
+
+// ── get-default ──────────────────────────────────────────────────────────────
+
+const bundleGetDefaultCommand = {
+  command:  'get-default',
+  describe: "Get the current site's default Chat Experience Bundle",
+  handler:  runCommand(async () => {
+    const bundle = await get('/Bundle/default');
+    printBundle(bundle);
+  }),
+};
+
+// ── create ───────────────────────────────────────────────────────────────────
+
+function buildInputFromArgv(argv) {
+  const input = { name: argv.name };
+  if (argv.isDefault !== undefined) input.isDefault = argv.isDefault;
+  if (argv.chatWindowId !== undefined) input.chatWindowId = argv.chatWindowId;
+  if (argv.preChatSurveyId !== undefined) input.preChatSurveyId = argv.preChatSurveyId;
+  if (argv.postChatSurveyId !== undefined) input.postChatSurveyId = argv.postChatSurveyId;
+  if (argv.offlineSurveyId !== undefined) input.offlineSurveyId = argv.offlineSurveyId;
+  if (argv.defaultTeamId !== undefined) input.defaultTeamId = argv.defaultTeamId;
+  if (argv.personaId !== undefined) input.personaId = argv.personaId;
+  if (argv.aiConfigurationId !== undefined) input.aiConfigurationId = argv.aiConfigurationId;
+  // showOnClosedLauncher is nullable/apply-if-present server-side (ExperienceBundleInput
+  // doc comment) so it must only be sent when the caller actually passed the flag —
+  // never default it to false, which would silently revert an opted-in site.
+  if (argv.showOnClosedLauncher !== undefined) input.showOnClosedLauncher = argv.showOnClosedLauncher;
+  return input;
+}
+
+const bundleInputOptions = (y) =>
+  y
+    .option('name', { type: 'string', describe: 'Bundle name' })
+    .option('is-default', { type: 'boolean', describe: 'Make this the site default bundle' })
+    .option('chat-window-id', { type: 'number', describe: 'ChatWindow ID' })
+    .option('pre-chat-survey-id', { type: 'number', describe: 'Pre-chat Survey ID' })
+    .option('post-chat-survey-id', { type: 'number', describe: 'Post-chat Survey ID' })
+    .option('offline-survey-id', { type: 'number', describe: 'Offline Survey ID' })
+    .option('default-team-id', { type: 'number', describe: 'Default Team ID' })
+    .option('persona-id', { type: 'number', describe: 'Persona ID' })
+    .option('ai-configuration-id', { type: 'number', describe: 'AI Configuration ID' })
+    .option('show-on-closed-launcher', { type: 'boolean', describe: 'Show the postchat/offline survey on the closed launcher (AM-4013 Part 6)' });
+
+const bundleCreateCommand = {
+  command:  'create',
+  describe: 'Create a new Chat Experience Bundle',
+  builder:  (y) => bundleInputOptions(y).demandOption('name', 'Bundle name is required'),
+  handler:  runCommand(async (argv) => {
+    const bundle = await post('/Bundle/create', buildInputFromArgv(argv));
+    console.log(`Created bundle ${bundle.id}.`);
+    printBundle(bundle);
+  }),
+};
+
+// ── update ───────────────────────────────────────────────────────────────────
+
+const UPDATABLE_FIELDS = [
+  'isDefault', 'chatWindowId', 'preChatSurveyId', 'postChatSurveyId',
+  'offlineSurveyId', 'defaultTeamId', 'personaId', 'aiConfigurationId',
+];
+
+const bundleUpdateCommand = {
+  command:  'update <id>',
+  describe: 'Update an existing Chat Experience Bundle, including toggling --show-on-closed-launcher (AM-4013 Part 6). Only the flags you pass are changed — every other field is read from the bundle\'s current state first and re-sent unchanged, because ExperienceBundleService.UpdateBundleAsync applies those fields unconditionally and would otherwise null them out.',
+  builder:  (y) => bundleInputOptions(y.positional('id', { type: 'number', describe: 'Bundle ID' })),
+  handler:  runCommand(async (argv) => {
+    const current = await get(`/Bundle/get/${argv.id}`);
+
+    const input = { name: argv.name !== undefined ? argv.name : current.name };
+    for (const field of UPDATABLE_FIELDS) {
+      input[field] = argv[field] !== undefined ? argv[field] : current[field];
+    }
+    // showOnClosedLauncher is the one nullable/apply-if-present field server-side
+    // (ExperienceBundleInput doc comment) — only send it when explicitly passed.
+    if (argv.showOnClosedLauncher !== undefined) input.showOnClosedLauncher = argv.showOnClosedLauncher;
+
+    const bundle = await put(`/Bundle/update/${argv.id}`, input);
+    console.log(`Updated bundle ${bundle.id}.`);
+    printBundle(bundle);
+  }),
+};
+
+// ── delete ───────────────────────────────────────────────────────────────────
+
+const bundleDeleteCommand = {
+  command:  'delete <id>',
+  describe: 'Delete a Chat Experience Bundle (the default bundle cannot be deleted)',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Bundle ID' }),
+  handler:  runCommand(async (argv) => {
+    await del(`/Bundle/delete/${argv.id}`);
+    console.log(`Deleted bundle ${argv.id}.`);
+  }),
+};