@forjio/fulkruma-cli 0.4.0

package/dist/commands/webhooks.js

@@ -0,0 +1,125 @@
+/**
+ * `fulkruma webhooks …` — endpoints (list/create/update/delete) + events list.
+ */
+import { Command } from 'commander';
+import { getClient } from '../lib/client.js';
+import { formatOpts, getGlobalOpts, handleError } from '../lib/util.js';
+import { printJson, printResult } from '../lib/output.js';
+export const webhooksCommand = new Command('webhooks').description('Webhook endpoints and event history');
+const endpoints = new Command('endpoints').description('Manage webhook endpoints');
+endpoints
+    .command('list')
+    .description('List endpoints')
+    .action(async (_options, cmd) => {
+    const g = getGlobalOpts(cmd);
+    try {
+        const client = getClient(g);
+        const { endpoints: rows } = await client.webhooks.listEndpoints();
+        printResult(rows, [
+            { header: 'ID', accessor: (e) => e['id'] },
+            { header: 'URL', accessor: (e) => e['url'] },
+            { header: 'Active', accessor: (e) => e['active'] },
+            { header: 'Events', accessor: (e) => e['events']?.join(',') },
+        ], formatOpts(g));
+        process.exit(0);
+    }
+    catch (err) {
+        handleError(err, g);
+    }
+});
+endpoints
+    .command('create')
+    .description('Create an endpoint')
+    .requiredOption('--url <url>', 'destination URL')
+    .option('--events <list>', 'comma-separated event types', (v) => v.split(',').map((s) => s.trim()))
+    .option('--description <text>', 'human-readable description')
+    .action(async (options, cmd) => {
+    const g = getGlobalOpts(cmd);
+    try {
+        const client = getClient(g);
+        const { endpoint } = await client.webhooks.createEndpoint({
+            url: options.url,
+            events: options.events,
+            description: options.description,
+        });
+        printJson(endpoint);
+        process.exit(0);
+    }
+    catch (err) {
+        handleError(err, g);
+    }
+});
+endpoints
+    .command('update <id>')
+    .description('Update an endpoint')
+    .option('--url <url>', 'destination URL')
+    .option('--events <list>', 'comma-separated event types', (v) => v.split(',').map((s) => s.trim()))
+    .option('--description <text>', 'description')
+    .option('--active <bool>', 'true|false')
+    .action(async (id, options, cmd) => {
+    const g = getGlobalOpts(cmd);
+    try {
+        const client = getClient(g);
+        const patch = {};
+        for (const k of ['url', 'events', 'description']) {
+            if (options[k] !== undefined)
+                patch[k] = options[k];
+        }
+        if (options['active'] !== undefined) {
+            patch['active'] = options['active'] === 'true' || options['active'] === true;
+        }
+        const { endpoint } = await client.webhooks.updateEndpoint(id, patch);
+        printJson(endpoint);
+        process.exit(0);
+    }
+    catch (err) {
+        handleError(err, g);
+    }
+});
+endpoints
+    .command('delete <id>')
+    .description('Delete an endpoint')
+    .action(async (id, _options, cmd) => {
+    const g = getGlobalOpts(cmd);
+    try {
+        const client = getClient(g);
+        const result = await client.webhooks.deleteEndpoint(id);
+        printResult({ id, deleted: result.deleted }, [
+            { header: 'ID', accessor: (r) => r.id },
+            { header: 'Deleted', accessor: (r) => r.deleted },
+        ], formatOpts(g));
+        process.exit(0);
+    }
+    catch (err) {
+        handleError(err, g);
+    }
+});
+webhooksCommand.addCommand(endpoints);
+const events = new Command('events').description('Webhook event history');
+events
+    .command('list')
+    .description('List the 50 most recent webhook events')
+    .action(async (_options, cmd) => {
+    const g = getGlobalOpts(cmd);
+    try {
+        const client = getClient(g);
+        const result = await client.webhooks.listEvents();
+        if (g.json) {
+            printJson(result);
+        }
+        else {
+            printResult(result.events, [
+                { header: 'ID', accessor: (e) => e['id'] },
+                { header: 'Type', accessor: (e) => e['type'] },
+                { header: 'Status', accessor: (e) => e['status'] },
+                { header: 'Created', accessor: (e) => e['createdAt'] },
+            ], formatOpts(g));
+        }
+        process.exit(0);
+    }
+    catch (err) {
+        handleError(err, g);
+    }
+});
+webhooksCommand.addCommand(events);
+//# sourceMappingURL=webhooks.js.map

package/dist/commands/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/commands/webhooks.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;AAE1G,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;AAEnF,SAAS;KACN,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gBAAgB,CAAC;KAC7B,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE;IAC9B,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAClE,WAAW,CACT,IAAI,EACJ;YACE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAW,EAAE;YACpD,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAW,EAAE;YACtD,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAwB,EAAE;YACzE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,QAAQ,CAA0B,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE;SACxF,EACD,UAAU,CAAC,CAAC,CAAC,CACd,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,SAAS;KACN,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oBAAoB,CAAC;KACjC,cAAc,CAAC,aAAa,EAAE,iBAAiB,CAAC;KAChD,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;KAClG,MAAM,CAAC,sBAAsB,EAAE,4BAA4B,CAAC;KAC5D,MAAM,CAAC,KAAK,EAAE,OAAiE,EAAE,GAAG,EAAE,EAAE;IACvF,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC;YACxD,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QACH,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,SAAS;KACN,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,oBAAoB,CAAC;KACjC,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC;KACxC,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;KAClG,MAAM,CAAC,sBAAsB,EAAE,aAAa,CAAC;KAC7C,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC;KACvC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,OAAgC,EAAE,GAAG,EAAE,EAAE;IAClE,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAU,EAAE,CAAC;YAC1D,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS;gBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;QAC/E,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,CACvD,EAAE,EACF,KAA6D,CAC9D,CAAC;QACF,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,SAAS;KACN,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,oBAAoB,CAAC;KACjC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE;IAC1C,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACxD,WAAW,CACT,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAC/B;YACE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACvC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;SAClD,EACD,UAAU,CAAC,CAAC,CAAC,CACd,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAEtC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAE1E,MAAM;KACH,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,wCAAwC,CAAC;KACrD,MAAM,CACL,KAAK,EAAE,QAA+B,EAAE,GAAG,EAAE,EAAE;IAC7C,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAClD,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACX,SAAS,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,WAAW,CACT,MAAM,CAAC,MAAM,EACb;gBACE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAW,EAAE;gBACpD,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAW,EAAE;gBACxD,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAuB,EAAE;gBACxE,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAuB,EAAE;aAC7E,EACD,UAAU,CAAC,CAAC,CAAC,CACd,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;AACH,CAAC,CACF,CAAC;AAEJ,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @forjio/fulkruma-cli entrypoint.
+ *
+ * Wires the auth command + 10 product command groups (plus integrations,
+ * stats, webhooks, audit-log bonuses) on top of @forjio/fulkruma-node.
+ *
+ * Global flags:
+ *   --json              emit raw JSON instead of chalk tables
+ *   --profile <name>    select a credential profile (default: "default")
+ *   --base-url <url>    override the API base URL
+ *   --on-behalf-of <id> forward X-Fulkruma-On-Behalf-Of (platform admin only)
+ */
+import { Command } from 'commander';
+export declare function buildProgram(): Command;

package/dist/index.js

@@ -0,0 +1,77 @@
+/**
+ * @forjio/fulkruma-cli entrypoint.
+ *
+ * Wires the auth command + 10 product command groups (plus integrations,
+ * stats, webhooks, audit-log bonuses) on top of @forjio/fulkruma-node.
+ *
+ * Global flags:
+ *   --json              emit raw JSON instead of chalk tables
+ *   --profile <name>    select a credential profile (default: "default")
+ *   --base-url <url>    override the API base URL
+ *   --on-behalf-of <id> forward X-Fulkruma-On-Behalf-Of (platform admin only)
+ */
+import { Command } from 'commander';
+import { authCommand } from './commands/auth.js';
+import { productsCommand } from './commands/products.js';
+import { warehousesCommand } from './commands/warehouses.js';
+import { stockCommand } from './commands/stock.js';
+import { addressesCommand } from './commands/addresses.js';
+import { shipmentsCommand } from './commands/shipments.js';
+import { shippingCommand } from './commands/shipping.js';
+import { licensesCommand } from './commands/licenses.js';
+import { deliveriesCommand } from './commands/deliveries.js';
+import { billingCommand } from './commands/billing.js';
+import { apiKeysCommand } from './commands/api-keys.js';
+import { integrationsCommand } from './commands/integrations.js';
+import { statsCommand } from './commands/stats.js';
+import { webhooksCommand } from './commands/webhooks.js';
+import { auditLogCommand } from './commands/audit-log.js';
+import { buildApiCommand } from './commands/api.generated.js';
+const brand = process.env['FORJIO_BRAND'] ?? 'fulkruma';
+export function buildProgram() {
+    const program = new Command()
+        .name(brand)
+        .description(`CLI for ${brand} — part of the Forjio commerce suite.`)
+        .version('0.3.1')
+        .option('--json', 'emit JSON instead of human-readable tables')
+        .option('--profile <name>', 'credential profile name (default: "default")')
+        .option('--base-url <url>', 'override the Fulkruma API base URL')
+        .option('--on-behalf-of <accountId>', 'forward X-Fulkruma-On-Behalf-Of (platform admin keys only)');
+    program.addCommand(authCommand);
+    program.addCommand(productsCommand);
+    program.addCommand(warehousesCommand);
+    program.addCommand(stockCommand);
+    program.addCommand(addressesCommand);
+    program.addCommand(shipmentsCommand);
+    program.addCommand(shippingCommand);
+    program.addCommand(licensesCommand);
+    program.addCommand(deliveriesCommand);
+    program.addCommand(billingCommand);
+    program.addCommand(apiKeysCommand);
+    program.addCommand(integrationsCommand);
+    program.addCommand(statsCommand);
+    program.addCommand(webhooksCommand);
+    program.addCommand(auditLogCommand);
+    program.addCommand(buildApiCommand());
+    return program;
+}
+// Only auto-run when invoked as the CLI binary — not when imported by
+// tests via `buildProgram`. Detect by comparing the resolved entrypoint
+// of import.meta.url to argv[1].
+const isCliEntry = (() => {
+    if (process.env['FULKRUMA_DISABLE_AUTORUN'] === '1')
+        return false;
+    const argv1 = process.argv[1];
+    if (!argv1)
+        return false;
+    // bin/cli.js imports dist/index.js, which imports this file at runtime.
+    return /\/(bin\/cli\.js|dist\/index\.js)$/.test(argv1);
+})();
+if (isCliEntry) {
+    const program = buildProgram();
+    program.parseAsync(process.argv).catch((e) => {
+        console.error(e);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,UAAU,CAAC;AAExD,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,KAAK,CAAC;SACX,WAAW,CAAC,WAAW,KAAK,uCAAuC,CAAC;SACpE,OAAO,CAAC,OAAO,CAAC;SAChB,MAAM,CAAC,QAAQ,EAAE,4CAA4C,CAAC;SAC9D,MAAM,CAAC,kBAAkB,EAAE,8CAA8C,CAAC;SAC1E,MAAM,CAAC,kBAAkB,EAAE,oCAAoC,CAAC;SAChE,MAAM,CAAC,4BAA4B,EAAE,4DAA4D,CAAC,CAAC;IAEtG,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAChC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACrC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACtC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnC,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;IACpC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;IAEtC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sEAAsE;AACtE,wEAAwE;AACxE,iCAAiC;AACjC,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE;IACvB,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,wEAAwE;IACxE,OAAO,mCAAmC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC,CAAC,EAAE,CAAC;AAEL,IAAI,UAAU,EAAE,CAAC;IACf,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;QACpD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/apigen-call.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+export declare function callRoute(cmd: Command, method: string, path: string, query: Record<string, unknown>, body: Record<string, unknown> | undefined): Promise<void>;
+/** Bad input to a generated command (a missing field, a value the spec does not allow). */
+export declare function failRoute(cmd: Command, err: unknown): Promise<never>;

package/dist/lib/apigen-call.js

@@ -0,0 +1,34 @@
+/**
+ * How the generated `fulkruma api <area> <action>` commands (commands/api.generated.ts)
+ * make their call: this CLI's own credentials and client (the SDK's signed `request`),
+ * its own output and errors.
+ */
+import { randomUUID } from 'node:crypto';
+import { getClient } from './client.js';
+import { getGlobalOpts, handleError } from './util.js';
+import { printJson } from './output.js';
+export async function callRoute(cmd, method, path, query, body) {
+    const g = getGlobalOpts(cmd);
+    try {
+        const qs = new URLSearchParams(Object.entries(query).map(([k, v]) => [k, typeof v === 'string' ? v : JSON.stringify(v)])).toString();
+        const client = getClient(g);
+        const data = await client.request({
+            method: method,
+            path: qs ? `${path}?${qs}` : path,
+            // The server hashes an empty JSON body as '' (middleware/hmac-auth.ts), the SDK as
+            // '{}': send no body at all when no field was given, so the signatures agree.
+            body: body && Object.keys(body).length ? body : undefined,
+            idempotencyKey: method === 'GET' ? undefined : `idem_${randomUUID()}`,
+        });
+        printJson(data);
+        process.exit(0);
+    }
+    catch (err) {
+        handleError(err, g);
+    }
+}
+/** Bad input to a generated command (a missing field, a value the spec does not allow). */
+export async function failRoute(cmd, err) {
+    handleError(err, getGlobalOpts(cmd));
+}
+//# sourceMappingURL=apigen-call.js.map

package/dist/lib/apigen-call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apigen-call.js","sourceRoot":"","sources":["../../src/lib/apigen-call.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAY,EACZ,MAAc,EACd,IAAY,EACZ,KAA8B,EAC9B,IAAyC;IAEzC,MAAM,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,eAAe,CAC5B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAC5G,CAAC,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAU;YACzC,MAAM,EAAE,MAAgB;YACxB,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI;YACjC,mFAAmF;YACnF,8EAA8E;YAC9E,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACzD,cAAc,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,UAAU,EAAE,EAAE;SACtE,CAAC,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY,EAAE,GAAY;IACxD,WAAW,CAAC,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/lib/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * FulkrumaClient factory. Loads credentials from `~/.fulkruma/credentials`
+ * (or env) and constructs a SDK client with the active profile.
+ *
+ * Tests inject a fake client via `setClientFactory` so we never hit the
+ * network in unit tests.
+ */
+import { FulkrumaClient, FulkrumaError } from '@forjio/fulkruma-node';
+export interface GlobalOpts {
+    json?: boolean;
+    profile?: string;
+    baseUrl?: string;
+    onBehalfOf?: string;
+}
+export type ClientFactory = (opts: GlobalOpts) => FulkrumaClient;
+/** Test seam — vitest tests replace this with a mock. */
+export declare function setClientFactory(f: ClientFactory): void;
+/** Reset to default behaviour (load creds + new SDK client). */
+export declare function resetClientFactory(): void;
+export declare function getClient(opts: GlobalOpts): FulkrumaClient;
+export declare function isFulkrumaError(err: unknown): err is FulkrumaError;

package/dist/lib/client.js

@@ -0,0 +1,41 @@
+/**
+ * FulkrumaClient factory. Loads credentials from `~/.fulkruma/credentials`
+ * (or env) and constructs a SDK client with the active profile.
+ *
+ * Tests inject a fake client via `setClientFactory` so we never hit the
+ * network in unit tests.
+ */
+import { FulkrumaClient, FulkrumaError } from '@forjio/fulkruma-node';
+import { loadCredentials } from './credentials.js';
+let factory = (opts) => {
+    const creds = loadCredentials(opts.profile);
+    return new FulkrumaClient({
+        keyId: creds.keyId,
+        secret: creds.secret,
+        baseUrl: opts.baseUrl ?? process.env['FULKRUMA_BASE_URL'] ?? undefined,
+        onBehalfOf: opts.onBehalfOf,
+    });
+};
+/** Test seam — vitest tests replace this with a mock. */
+export function setClientFactory(f) {
+    factory = f;
+}
+/** Reset to default behaviour (load creds + new SDK client). */
+export function resetClientFactory() {
+    factory = (opts) => {
+        const creds = loadCredentials(opts.profile);
+        return new FulkrumaClient({
+            keyId: creds.keyId,
+            secret: creds.secret,
+            baseUrl: opts.baseUrl ?? process.env['FULKRUMA_BASE_URL'] ?? undefined,
+            onBehalfOf: opts.onBehalfOf,
+        });
+    };
+}
+export function getClient(opts) {
+    return factory(opts);
+}
+export function isFulkrumaError(err) {
+    return err instanceof FulkrumaError;
+}
+//# sourceMappingURL=client.js.map

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAWnD,IAAI,OAAO,GAAkB,CAAC,IAAI,EAAE,EAAE;IACpC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,cAAc,CAAC;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,SAAS;QACtE,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,yDAAyD;AACzD,MAAM,UAAU,gBAAgB,CAAC,CAAgB;IAC/C,OAAO,GAAG,CAAC,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,kBAAkB;IAChC,OAAO,GAAG,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,cAAc,CAAC;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,SAAS;YACtE,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,GAAG,YAAY,aAAa,CAAC;AACtC,CAAC"}

package/dist/lib/credentials.d.ts

@@ -0,0 +1,25 @@
+export interface Credentials {
+    keyId: string;
+    secret: string;
+}
+export interface StoredProfile extends Credentials {
+    profile: string;
+}
+export declare function credentialsPath(): string;
+export declare function resolveProfileName(explicit?: string): string;
+/** Load credentials from env or file. Throws if nothing is configured. */
+export declare function loadCredentials(profile?: string): StoredProfile;
+/** Try to load without throwing — returns null if no creds. */
+export declare function tryLoadCredentials(profile?: string): StoredProfile | null;
+/** Save credentials into a profile (creates or overwrites). */
+export declare function saveCredentials(input: {
+    profile?: string;
+    keyId: string;
+    secret: string;
+}): string;
+/** Clear a profile. Returns true if removed, false if it didn't exist. */
+export declare function clearCredentials(profile?: string): boolean;
+/** List profile names for diagnostics. */
+export declare function listProfiles(): string[];
+/** Mask the secret half of an API key for display. */
+export declare function maskKey(keyId: string): string;

package/dist/lib/credentials.js

@@ -0,0 +1,158 @@
+/**
+ * HMAC credentials store for Fulkruma CLI.
+ *
+ * Why not @forjio/sdk's `Session`? `Session` is OIDC-focused — refresh
+ * tokens, expiry, device-flow state. Fulkruma's CLI uses an AKIA-style
+ * HMAC key+secret (key_id + secret) issued from the dashboard, so we
+ * roll a small INI multi-profile store at `~/.fulkruma/credentials`,
+ * shaped like AWS' credentials file.
+ *
+ * Format:
+ *
+ *   [default]
+ *   key_id = AKIAFULK...
+ *   secret = ...
+ *
+ *   [staging]
+ *   key_id = AKIAFULK...
+ *   secret = ...
+ *
+ * Resolution order for the active profile:
+ *   1. `--profile <name>` global flag
+ *   2. `FULKRUMA_PROFILE` env var
+ *   3. `"default"`
+ *
+ * Direct env override (skips file entirely): `FULKRUMA_KEY_ID` +
+ * `FULKRUMA_SECRET`.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const DEFAULT_PROFILE = 'default';
+export function credentialsPath() {
+    return process.env['FULKRUMA_CREDENTIALS_FILE'] ?? join(homedir(), '.fulkruma', 'credentials');
+}
+export function resolveProfileName(explicit) {
+    return explicit ?? process.env['FULKRUMA_PROFILE'] ?? DEFAULT_PROFILE;
+}
+function parseIni(content) {
+    const profiles = new Map();
+    const order = [];
+    let current = null;
+    for (const rawLine of content.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#') || line.startsWith(';'))
+            continue;
+        if (line.startsWith('[') && line.endsWith(']')) {
+            current = line.slice(1, -1).trim();
+            if (!profiles.has(current)) {
+                profiles.set(current, new Map());
+                order.push(current);
+            }
+            continue;
+        }
+        const eq = line.indexOf('=');
+        if (eq <= 0 || current === null)
+            continue;
+        const key = line.slice(0, eq).trim();
+        const value = line.slice(eq + 1).trim();
+        profiles.get(current).set(key, value);
+    }
+    return { profiles, order };
+}
+function serializeIni(parsed) {
+    const blocks = [];
+    for (const name of parsed.order) {
+        const kv = parsed.profiles.get(name);
+        if (!kv)
+            continue;
+        const lines = [`[${name}]`];
+        for (const [k, v] of kv.entries())
+            lines.push(`${k} = ${v}`);
+        blocks.push(lines.join('\n'));
+    }
+    return blocks.join('\n\n') + '\n';
+}
+function readFile() {
+    const path = credentialsPath();
+    if (!existsSync(path))
+        return { profiles: new Map(), order: [] };
+    return parseIni(readFileSync(path, 'utf8'));
+}
+function writeFile(parsed) {
+    const path = credentialsPath();
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    writeFileSync(path, serializeIni(parsed), { encoding: 'utf8' });
+    try {
+        chmodSync(path, 0o600);
+    }
+    catch {
+        /* on Windows chmod is a no-op; ignore */
+    }
+}
+/** Load credentials from env or file. Throws if nothing is configured. */
+export function loadCredentials(profile) {
+    const envKey = process.env['FULKRUMA_KEY_ID'];
+    const envSecret = process.env['FULKRUMA_SECRET'];
+    if (envKey && envSecret) {
+        return { profile: '(env)', keyId: envKey, secret: envSecret };
+    }
+    const name = resolveProfileName(profile);
+    const { profiles } = readFile();
+    const kv = profiles.get(name);
+    if (!kv) {
+        throw new Error(`No credentials found for profile "${name}" at ${credentialsPath()}. ` +
+            `Run \`fulkruma auth login --key-id <id> --secret <secret>\` first.`);
+    }
+    const keyId = kv.get('key_id');
+    const secret = kv.get('secret');
+    if (!keyId || !secret) {
+        throw new Error(`Profile "${name}" is missing key_id or secret.`);
+    }
+    return { profile: name, keyId, secret };
+}
+/** Try to load without throwing — returns null if no creds. */
+export function tryLoadCredentials(profile) {
+    try {
+        return loadCredentials(profile);
+    }
+    catch {
+        return null;
+    }
+}
+/** Save credentials into a profile (creates or overwrites). */
+export function saveCredentials(input) {
+    const name = resolveProfileName(input.profile);
+    const parsed = readFile();
+    if (!parsed.profiles.has(name)) {
+        parsed.profiles.set(name, new Map());
+        parsed.order.push(name);
+    }
+    const kv = parsed.profiles.get(name);
+    kv.set('key_id', input.keyId);
+    kv.set('secret', input.secret);
+    writeFile(parsed);
+    return name;
+}
+/** Clear a profile. Returns true if removed, false if it didn't exist. */
+export function clearCredentials(profile) {
+    const name = resolveProfileName(profile);
+    const parsed = readFile();
+    if (!parsed.profiles.has(name))
+        return false;
+    parsed.profiles.delete(name);
+    parsed.order = parsed.order.filter((n) => n !== name);
+    writeFile(parsed);
+    return true;
+}
+/** List profile names for diagnostics. */
+export function listProfiles() {
+    return readFile().order.slice();
+}
+/** Mask the secret half of an API key for display. */
+export function maskKey(keyId) {
+    if (keyId.length <= 10)
+        return keyId;
+    return `${keyId.slice(0, 10)}…${keyId.slice(-4)}`;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/lib/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../../src/lib/credentials.ts"],"names":[],"mappings":"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"}

package/dist/lib/output.d.ts

@@ -0,0 +1,19 @@
+export interface Column<T> {
+    header: string;
+    accessor: (row: T) => string | number | boolean | null | undefined;
+    width?: number;
+}
+export interface FormatOptions {
+    json?: boolean;
+    noColor?: boolean;
+}
+export declare function formatTable<T>(rows: readonly T[], columns: readonly Column<T>[]): string;
+export declare function formatJson(data: unknown): string;
+export declare function printResult<T>(data: T | readonly T[], columns: readonly Column<T>[], opts?: FormatOptions): void;
+export declare function printJson(data: unknown): void;
+export declare function printMessage(msg: string, opts?: FormatOptions): void;
+export declare function printError(err: {
+    code?: string;
+    message: string;
+    requestId?: string;
+}, opts?: FormatOptions): void;

package/dist/lib/output.js

@@ -0,0 +1,69 @@
+/**
+ * Output helpers — chalk-styled table by default, raw JSON when --json
+ * is on. Mirrors plugipay's CLI output shape so shells scripts can rely
+ * on the same conventions across the Forjio family.
+ */
+import chalk from 'chalk';
+function cellValue(v) {
+    if (v === null || v === undefined || v === '')
+        return '–';
+    return String(v);
+}
+export function formatTable(rows, columns) {
+    if (columns.length === 0)
+        return '';
+    const stringRows = rows.map((row) => columns.map((col) => cellValue(col.accessor(row))));
+    const widths = columns.map((col, idx) => {
+        const dataMax = stringRows.reduce((max, r) => Math.max(max, (r[idx] ?? '').length), 0);
+        return Math.max(col.header.length, dataMax, col.width ?? 0);
+    });
+    const pad = (s, w) => s + ' '.repeat(Math.max(0, w - s.length));
+    const headerLine = columns
+        .map((c, i) => chalk.bold(pad(c.header, widths[i] ?? c.header.length)))
+        .join('  ');
+    const divider = widths.map((w) => '─'.repeat(w)).join('  ');
+    const bodyLines = stringRows.map((r) => r.map((cell, i) => pad(cell, widths[i] ?? cell.length)).join('  '));
+    return [headerLine, divider, ...bodyLines].join('\n');
+}
+export function formatJson(data) {
+    return JSON.stringify(data, null, 2);
+}
+export function printResult(data, columns, opts = {}) {
+    if (opts.json) {
+        process.stdout.write(`${formatJson(data)}\n`);
+        return;
+    }
+    if (Array.isArray(data) && data.length === 0) {
+        process.stdout.write(chalk.dim('(no results)\n'));
+        return;
+    }
+    const rows = Array.isArray(data) ? data : [data];
+    process.stdout.write(`${formatTable(rows, columns)}\n`);
+}
+export function printJson(data) {
+    process.stdout.write(`${formatJson(data)}\n`);
+}
+export function printMessage(msg, opts = {}) {
+    if (opts.json) {
+        process.stdout.write(`${formatJson({ ok: true, message: msg })}\n`);
+        return;
+    }
+    process.stdout.write(`${msg}\n`);
+}
+export function printError(err, opts = {}) {
+    if (opts.json) {
+        process.stderr.write(`${formatJson({
+            error: {
+                code: err.code ?? 'unknown',
+                message: err.message,
+                requestId: err.requestId,
+            },
+        })}\n`);
+        return;
+    }
+    process.stderr.write(`${chalk.red(`Error: ${err.code ?? 'error'} — ${err.message}`)}\n`);
+    if (err.requestId) {
+        process.stderr.write(`${chalk.dim(`Request ID: ${err.requestId}`)}\n`);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"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"}