@myapihq/cli 1.0.16 → 1.0.17

package/src/commands/workflow.ts

@@ -1,18 +1,26 @@
 import { workflow as sdkWorkflow } from '@myapihq/sdk';
 import { requireConfig } from '../config.js';
-import { success, error, printTable } from '../output.js';
+import { success, error, printTable, info, printJson } from '../output.js';
 
 export async function list(flags: Record<string, string | boolean>) {
   const config = requireConfig();
-  const workflows = await sdkWorkflow.listWorkflows(config.api_key);
-  printTable(workflows as unknown as Record<string, unknown>[]);
+  const orgId = (flags.org as string) || config.default_org;
+  if (!orgId) error("Missing required arguments.\nUsage: myapi workflow list --org <id>\n(Or set defaults via: myapi config set-org <id>)");
+  
+  const workflows = await sdkWorkflow.listWorkflows(config.api_key, orgId);
+  if (flags.json) printJson(workflows);
+  else printTable(workflows as unknown as Record<string, unknown>[]);
 }
 
 export async function create(flags: Record<string, string | boolean>) {
-  if (!flags['org-id'] || !flags.name || !flags['endpoint-id'] || !flags.steps) {
-    error("Missing --org-id, --name, --endpoint-id, or --steps flags");
-  }
   const config = requireConfig();
+  const orgId = (flags.org as string) || config.default_org;
+  const name = flags.name as string;
+  const endpointId = flags['endpoint-id'] as string;
+  
+  if (!orgId || !name || !endpointId || !flags.steps) {
+    error("Missing required arguments.\nUsage: myapi workflow create --name <name> --endpoint-id <id> --steps <json> --org <id>\n(Or set defaults via: myapi config set-org <id>)");
+  }
   
   let steps;
   try {
@@ -21,34 +29,63 @@ export async function create(flags: Record<string, string | boolean>) {
     error("Invalid JSON for --steps");
   }
   
-  const wf = await sdkWorkflow.createWorkflow(config.api_key, {
-    org_id: flags['org-id'] as string,
-    name: flags.name as string,
-    trigger_config: { endpoint_id: flags['endpoint-id'] as string },
+  const wf = await sdkWorkflow.createWorkflow(config.api_key, orgId, {
+    name,
+    trigger_config: { endpoint_id: endpointId },
     steps
   });
   
-  await sdkWorkflow.enableWorkflow(config.api_key, wf.id);
+  await sdkWorkflow.enableWorkflow(config.api_key, orgId, wf.id);
   success(`Workflow created and enabled! ID: ${wf.id}`);
 }
 
 export async function enable(id: string, flags: Record<string, string | boolean>) {
-  if (!id) error("Missing id");
   const config = requireConfig();
-  await sdkWorkflow.enableWorkflow(config.api_key, id);
+  const orgId = (flags.org as string) || config.default_org;
+  if (!orgId || !id) error("Missing required arguments.\nUsage: myapi workflow enable <id> --org <id>\n(Or set defaults via: myapi config set-org <id>)");
+  
+  await sdkWorkflow.enableWorkflow(config.api_key, orgId, id);
   success(`Workflow ${id} enabled`);
 }
 
 export async function disable(id: string, flags: Record<string, string | boolean>) {
-  if (!id) error("Missing id");
   const config = requireConfig();
-  await sdkWorkflow.disableWorkflow(config.api_key, id);
+  const orgId = (flags.org as string) || config.default_org;
+  if (!orgId || !id) error("Missing required arguments.\nUsage: myapi workflow disable <id> --org <id>\n(Or set defaults via: myapi config set-org <id>)");
+  
+  await sdkWorkflow.disableWorkflow(config.api_key, orgId, id);
   success(`Workflow ${id} disabled`);
 }
 
 export async function runs(id: string, flags: Record<string, string | boolean>) {
-  if (!id) error("Missing id");
   const config = requireConfig();
-  const runs = await sdkWorkflow.listWorkflowRuns(config.api_key, id);
-  printTable(runs as unknown as Record<string, unknown>[]);
+  const orgId = (flags.org as string) || config.default_org;
+  if (!orgId || !id) error("Missing required arguments.\nUsage: myapi workflow runs <id> --org <id>\n(Or set defaults via: myapi config set-org <id>)");
+  
+  const wRuns = await sdkWorkflow.listWorkflowRuns(config.api_key, orgId, id);
+  if (flags.json) printJson(wRuns);
+  else printTable(wRuns as unknown as Record<string, unknown>[]);
+}
+
+export async function run(subcommand: string | undefined, args: string[], flags: Record<string, string | boolean>) {
+  if (!subcommand || (flags.help && !subcommand)) {
+    info('Usage: myapi workflow <subcommand>\n\nSubcommands:\n  list       List all workflows\n  create     Create and enable a new workflow\n  enable     Enable a workflow\n  disable    Disable a workflow\n  runs       List recent executions (runs) of a workflow\n\nNote: All workflow commands require the --org <id> flag.');
+    return;
+  }
+  
+  if (flags.help) {
+    if (subcommand === 'list') info('Usage: myapi workflow list --org <id> [--json]\n\nLists all workflows in your organization, showing their ID, name, status, and attached webhook endpoint.');
+    else if (subcommand === 'create') info('Usage: myapi workflow create --name <name> --endpoint-id <id> --steps <json_array> --org <id>\n\nCreates a new webhook-triggered workflow and immediately enables it.\n\nArguments:\n  --name          A friendly name for your workflow.\n  --endpoint-id   The UUID of the my-webhook-api endpoint that will trigger this workflow.\n  --steps         A raw JSON array defining the actions to take when triggered.\n\nExample Steps Payload:\n  \'[{"type": "send_email", "from": "hello@example.com", "to": "{{payload.user.email}}", "subject": "Welcome!", "template_id": "abc-123"}]\n  \'[{"type": "slack_message", "webhook_url": "https://hooks.slack.com/...", "text": "New lead: {{payload.name}}"}]\'');
+    else if (subcommand === 'enable') info('Usage: myapi workflow enable <id> --org <id>\n\nActivates a disabled workflow so it begins listening to its webhook trigger again.');
+    else if (subcommand === 'disable') info('Usage: myapi workflow disable <id> --org <id>\n\nPauses a workflow. The attached webhook will still accept data, but the workflow steps will not execute.');
+    else if (subcommand === 'runs') info('Usage: myapi workflow runs <workflow_id> --org <id> [--json]\n\nLists the 100 most recent executions of the specified workflow, including completion status and any error messages.');
+    return;
+  }
+
+  if (subcommand === 'list') await list(flags);
+  else if (subcommand === 'create') await create(flags);
+  else if (subcommand === 'enable') await enable(args[0], flags);
+  else if (subcommand === 'disable') await disable(args[0], flags);
+  else if (subcommand === 'runs') await runs(args[0], flags);
+  else error(`Unknown subcommand: ${subcommand}. Run "myapi workflow --help" for a list of valid subcommands.`);
 }

package/src/index.ts

@@ -3,6 +3,12 @@
 import { parseArgs } from './utils.js';
 import { error, info } from './output.js';
 import { MyApiError } from '@myapihq/sdk';
+import updateNotifier from 'update-notifier';
+import * as fs from 'fs';
+import * as path from 'path';
+
+const pkgPath = new URL('../package.json', import.meta.url);
+const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
 import * as keysCmd from './commands/keys.js';
 import * as billingCmd from './commands/billing.js';
 import * as orgCmd from './commands/org.js';
@@ -10,8 +16,13 @@ import * as setupCmd from './commands/setup.js';
 import * as configCmd from './commands/config.js';
 import * as domainCmd from './commands/domain.js';
 import * as funnelCmd from './commands/funnel.js';
+import * as urlCmd from './commands/url.js';
+import * as webhookCmd from './commands/webhook.js';
+import * as workflowCmd from './commands/workflow.js';
 
 async function main() {
+  updateNotifier({ pkg }).notify();
+
   const { args, flags } = parseArgs(process.argv.slice(2));
   if (args.length === 0) { printHelp(); process.exit(0); }
   const [command, subcommand, ...restArgs] = args;
@@ -66,6 +77,15 @@ async function main() {
       case 'funnel':
         await funnelCmd.run(subcommand, restArgs, flags);
         break;
+      case 'url':
+        await urlCmd.run(subcommand, restArgs, flags);
+        break;
+      case 'webhook':
+        await webhookCmd.run(subcommand, restArgs, flags);
+        break;
+      case 'workflow':
+        await workflowCmd.run(subcommand, restArgs, flags);
+        break;
       default:
         printHelp();
         process.exit(0);
@@ -92,6 +112,9 @@ Commands:
   config       Manage CLI defaults like org_id and domain
   domain       Manage domain configurations
   funnel       Manage headless funnels and pages
+  url          Shorten URLs and manage links
+  webhook      Manage inbound webhooks
+  workflow     Manage workflow automations
 
 Run "myapi <command> --help" for subcommand help.`);
 }