@modularizer/plat 0.16.1 → 0.17.1

package/dist/cli/format.js

@@ -0,0 +1,160 @@
+/**
+ * Built-in CLI output formatters. Pure (no node-only imports besides the optional terminal width),
+ * so the lightweight client package can ship them.
+ */
+export function formatJson(data) {
+    return JSON.stringify(data, null, 2);
+}
+export function formatYaml(data, indent = 0) {
+    const pad = '  '.repeat(indent);
+    if (data === null || data === undefined)
+        return pad + 'null';
+    if (typeof data === 'string')
+        return data.includes('\n') ? `|\n${data.split('\n').map(l => pad + '  ' + l).join('\n')}` : data;
+    if (typeof data !== 'object')
+        return String(data);
+    if (Array.isArray(data)) {
+        if (data.length === 0)
+            return '[]';
+        return data.map(item => {
+            if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
+                const entries = Object.entries(item);
+                const first = entries[0];
+                const rest = entries.slice(1);
+                let s = pad + '- ' + first[0] + ': ' + formatYaml(first[1], indent + 2);
+                for (const [k, v] of rest)
+                    s += '\n' + pad + '  ' + k + ': ' + formatYaml(v, indent + 2);
+                return s;
+            }
+            return pad + '- ' + formatYaml(item, indent + 1);
+        }).join('\n');
+    }
+    const entries = Object.entries(data);
+    if (entries.length === 0)
+        return '{}';
+    return entries.map(([k, v]) => {
+        if (typeof v === 'object' && v !== null)
+            return pad + k + ':\n' + formatYaml(v, indent + 1);
+        return pad + k + ': ' + formatYaml(v, indent);
+    }).join('\n');
+}
+export function formatHuman(data, indent = 0) {
+    const pad = '  '.repeat(indent);
+    if (data === null || data === undefined)
+        return pad + '\u2014';
+    if (typeof data !== 'object')
+        return pad + String(data);
+    if (Array.isArray(data)) {
+        if (data.length === 0)
+            return pad + '(empty)';
+        return data.map((item, i) => {
+            const prefix = pad + (i + 1) + '. ';
+            const body = formatHuman(item, 0).trimStart();
+            const contPad = ' '.repeat(prefix.length);
+            return prefix + body.split('\n').map((line, j) => j === 0 ? line : contPad + line).join('\n');
+        }).join('\n');
+    }
+    return Object.entries(data).map(([k, v]) => {
+        if (typeof v === 'object' && v !== null)
+            return pad + k + ':\n' + formatHuman(v, indent + 1);
+        return pad + k + ': ' + (v ?? '\u2014');
+    }).join('\n');
+}
+export function formatTable(data) {
+    let rows;
+    if (Array.isArray(data))
+        rows = data;
+    else if (typeof data === 'object' && data !== null) {
+        const vals = Object.values(data);
+        const arrVal = vals.find(v => Array.isArray(v));
+        if (arrVal)
+            rows = arrVal;
+        else
+            rows = [data];
+    }
+    else {
+        return String(data);
+    }
+    if (rows.length === 0)
+        return '(empty)';
+    if (typeof rows[0] !== 'object' || rows[0] === null)
+        return rows.map(String).join('\n');
+    const flatRows = rows.map(row => {
+        const flat = {};
+        for (const [k, v] of Object.entries(row)) {
+            flat[k] = typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v ?? '');
+        }
+        return flat;
+    });
+    const cols = Array.from(new Set(flatRows.flatMap(r => Object.keys(r))));
+    const termWidth = process.stdout.columns || 120;
+    const widths = {};
+    for (const col of cols) {
+        widths[col] = col.length;
+        for (const row of flatRows) {
+            widths[col] = Math.max(widths[col], (row[col] || '').length);
+        }
+    }
+    const borders = 1 + cols.length * 3;
+    let totalWidth = borders + cols.reduce((s, c) => s + widths[c], 0);
+    while (totalWidth > termWidth) {
+        let widest = cols[0], maxW = 0;
+        for (const c of cols) {
+            if (widths[c] > maxW) {
+                maxW = widths[c];
+                widest = c;
+            }
+        }
+        if (maxW <= 4)
+            break;
+        widths[widest] = Math.max(4, widths[widest] - 1);
+        totalWidth = borders + cols.reduce((s, c) => s + widths[c], 0);
+    }
+    const truncate = (s, w) => s.length > w ? s.slice(0, w - 1) + '\u2026' : s;
+    const hline = (left, mid, right) => left + cols.map(c => '\u2500'.repeat(widths[c] + 2)).join(mid) + right;
+    const dataRow = (row) => '\u2502' + cols.map(c => ' ' + truncate(row[c] || '', widths[c]).padEnd(widths[c]) + ' ').join('\u2502') + '\u2502';
+    const lines = [];
+    lines.push(hline('\u250c', '\u252c', '\u2510'));
+    lines.push('\u2502' + cols.map(c => ' ' + truncate(c, widths[c]).padEnd(widths[c]) + ' ').join('\u2502') + '\u2502');
+    lines.push(hline('\u251c', '\u253c', '\u2524'));
+    for (const row of flatRows)
+        lines.push(dataRow(row));
+    lines.push(hline('\u2514', '\u2534', '\u2518'));
+    return lines.join('\n');
+}
+export function formatCsv(data) {
+    let rows;
+    if (Array.isArray(data))
+        rows = data;
+    else if (typeof data === 'object' && data !== null) {
+        const arrVal = Object.values(data).find(v => Array.isArray(v));
+        if (arrVal)
+            rows = arrVal;
+        else
+            rows = [data];
+    }
+    else
+        return String(data);
+    if (rows.length === 0)
+        return '';
+    if (typeof rows[0] !== 'object' || rows[0] === null)
+        return rows.map(String).join('\n');
+    const cols = Array.from(new Set(rows.flatMap(r => Object.keys(r))));
+    const esc = (v) => {
+        const s = typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v ?? '');
+        return s.includes(',') || s.includes('"') || s.includes('\n') ? '"' + s.replace(/"/g, '""') + '"' : s;
+    };
+    const lines = [cols.join(',')];
+    for (const row of rows)
+        lines.push(cols.map(c => esc(row[c])).join(','));
+    return lines.join('\n');
+}
+/** Name → formatter. A CLI adds or replaces entries through `CliOptions.formatters`. */
+export const defaultFormatters = {
+    json: formatJson,
+    yaml: (data) => formatYaml(data),
+    table: formatTable,
+    csv: formatCsv,
+    human: (data) => formatHuman(data),
+};
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/cli/http.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Dependency-free HTTP transport for the CLI engine: plain `fetch`, nothing else.
+ * This is what the lightweight `@modularizer/plat-cli` package ships.
+ */
+import { type CliCall, type CliOptions } from './core.js';
+export interface HttpCallOptions {
+    baseUrl: string | (() => string | Promise<string>);
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    fetch?: typeof fetch;
+}
+/** Where the OpenAPI document lives on a plat server. */
+export declare function fetchSpec(baseUrl: string, fetchImpl?: typeof fetch): Promise<any>;
+/** `{id}` path params come from the input; GET/DELETE send the rest as a query string, others as JSON. */
+export declare function httpCall(options: HttpCallOptions): CliCall;
+export interface HttpCliOptions extends Omit<CliOptions, 'spec' | 'call'> {
+    baseUrl: HttpCallOptions['baseUrl'];
+    headers?: HttpCallOptions['headers'];
+    /** Default: fetch `/openapi.json` from `baseUrl`. */
+    spec?: CliOptions['spec'];
+    call?: CliOptions['call'];
+    fetch?: typeof fetch;
+}
+/** Run a CLI against a plat server over plain HTTP. */
+export declare function runHttpCli(options: HttpCliOptions, argv?: readonly string[]): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/cli/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/cli/http.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AAElE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACnG,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,yDAAyD;AACzD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAI9F;AAED,0GAA0G;AAC1G,wBAAgB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CA0B1D;AAED,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACvE,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACpC,qDAAqD;IACrD,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IACzB,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IACzB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,uDAAuD;AACvD,wBAAsB,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,GAAE,SAAS,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxH"}

package/dist/cli/http.js

@@ -0,0 +1,56 @@
+/**
+ * Dependency-free HTTP transport for the CLI engine: plain `fetch`, nothing else.
+ * This is what the lightweight `@modularizer/plat-cli` package ships.
+ */
+import { runCliCore } from './core.js';
+/** Where the OpenAPI document lives on a plat server. */
+export async function fetchSpec(baseUrl, fetchImpl = fetch) {
+    const res = await fetchImpl(new URL('/openapi.json', baseUrl));
+    if (!res.ok)
+        throw new Error(`Could not load ${new URL('/openapi.json', baseUrl)}: HTTP ${res.status}`);
+    return res.json();
+}
+/** `{id}` path params come from the input; GET/DELETE send the rest as a query string, others as JSON. */
+export function httpCall(options) {
+    return async (command, input) => {
+        const baseUrl = typeof options.baseUrl === 'function' ? await options.baseUrl() : options.baseUrl;
+        const extra = typeof options.headers === 'function' ? await options.headers() : options.headers;
+        const rest = { ...input };
+        const path = command.path.replace(/\{(\w+)\}/g, (_, key) => {
+            const value = rest[key];
+            delete rest[key];
+            return encodeURIComponent(String(value ?? ''));
+        });
+        const url = new URL(path, baseUrl);
+        const hasBody = command.method !== 'GET' && command.method !== 'DELETE' && command.method !== 'HEAD';
+        if (!hasBody) {
+            for (const [key, value] of Object.entries(rest)) {
+                url.searchParams.set(key, typeof value === 'object' ? JSON.stringify(value) : String(value));
+            }
+        }
+        const res = await (options.fetch ?? fetch)(url, {
+            method: command.method,
+            headers: { ...(hasBody ? { 'content-type': 'application/json' } : {}), ...extra },
+            ...(hasBody ? { body: JSON.stringify(rest) } : {}),
+        });
+        const text = await res.text();
+        if (!res.ok)
+            throw new Error(`${command.name}: HTTP ${res.status} ${text}`);
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    };
+}
+/** Run a CLI against a plat server over plain HTTP. */
+export async function runHttpCli(options, argv = process.argv.slice(2)) {
+    const { baseUrl, headers, fetch: fetchImpl, spec, call, ...core } = options;
+    await runCliCore({
+        ...core,
+        spec: spec ?? (async () => fetchSpec(typeof baseUrl === 'function' ? await baseUrl() : baseUrl, fetchImpl)),
+        call: call ?? httpCall({ baseUrl, headers, fetch: fetchImpl }),
+    }, argv);
+}
+//# sourceMappingURL=http.js.map

package/dist/cli/http.js.map

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

package/dist/cli/index.d.ts

@@ -1,11 +1,11 @@
-export * from './runtime';
-export * from './proxy';
-export * from './jwt-helper';
-export * from './commands/env';
-export * from './commands/gen';
-export * from './commands/api-proxy';
-export * from './commands/jwt-cmd';
-export * from './commands/init-project';
-export * from './commands/watch';
-export * from './commands/run';
+export * from './runtime.js';
+export * from './proxy.js';
+export * from './jwt-helper.js';
+export * from './commands/env.js';
+export * from './commands/gen.js';
+export * from './commands/api-proxy.js';
+export * from './commands/jwt-cmd.js';
+export * from './commands/init-project.js';
+export * from './commands/watch.js';
+export * from './commands/run.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/proxy.d.ts

@@ -1,5 +1,5 @@
-import type { Clientified } from '../types/client';
-import type { EndpointDef, HttpMethod } from '../types';
+import type { Clientified } from '../types/client.js';
+import type { EndpointDef, HttpMethod } from '../types/index.js';
 type ApiClass<T> = abstract new (...args: any[]) => T;
 export interface CliAuthContext {
     controllerName: string;

package/dist/cli/runtime.d.ts

@@ -4,14 +4,21 @@
  * Generated CLIs just pass in their spec — all arg parsing,
  * formatting, and dispatch lives here.
  */
-import { type OpenAPIClientConfig } from '../client/openapi-client';
-export interface RunCliOptions {
+import { type OpenAPIClientConfig } from '../client/openapi-client.js';
+import { type CliOptions } from './core.js';
+export interface RunCliOptions extends Partial<Omit<CliOptions, 'spec' | 'call'>> {
     /** Override base URL (default: spec.servers[0].url or env) */
     baseUrl?: string;
     /** Extra headers to send */
     headers?: Record<string, string>;
     /** OpenAPIClient config overrides */
     clientConfig?: Partial<OpenAPIClientConfig>;
+    /** Replace the default OpenAPIClient transport. */
+    call?: CliOptions['call'];
 }
+/**
+ * Run a CLI for `spec`. Every behaviour a CLI might want to change is an option (see `CliOptions`):
+ * extra commands, overrides, positional params, hooks, formatters, help. Do not hand-roll a CLI.
+ */
 export declare function runCli(spec: any, argvOrOptions?: string[] | RunCliOptions, maybeOptions?: RunCliOptions): Promise<void>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/cli/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAclF,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;CAC5C;AA2MD,wBAAsB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,YAAY,CAAC,EAAE,aAAa,iBA4D7G"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAGlF,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AAIpD,MAAM,WAAW,aAAc,SAAQ,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/E,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;IAC3C,mDAAmD;IACnD,IAAI,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;CAC1B;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,YAAY,CAAC,EAAE,aAAa,iBAyB7G"}

package/dist/cli/runtime.js

@@ -7,284 +7,33 @@
 import { OpenAPIClient } from '../client/openapi-client.js';
 import { createClientSideServerMQTTWebRTCTransportPlugin } from '../client-side-server/mqtt-webrtc.js';
 import { PLAT_AUTHORITY_URL } from '../client-side-server/authority-default.js';
-// ── extract commands from spec ─────────────────────────────
-function extractCommands(spec) {
-    const commands = [];
-    for (const [urlPath, methods] of Object.entries(spec.paths ?? {})) {
-        for (const [httpMethod, _op] of Object.entries(methods)) {
-            const op = _op;
-            if (!op.operationId)
-                continue;
-            const params = [];
-            if (op.parameters) {
-                for (const p of op.parameters) {
-                    params.push({ name: p.name, required: p.required ?? false });
-                }
-            }
-            if (op.requestBody?.content?.['application/json']?.schema?.properties) {
-                const schema = op.requestBody.content['application/json'].schema;
-                const reqSet = new Set(schema.required ?? []);
-                for (const name of Object.keys(schema.properties)) {
-                    params.push({ name, required: reqSet.has(name) });
-                }
-            }
-            commands.push({
-                name: op.operationId,
-                method: httpMethod.toUpperCase(),
-                path: urlPath,
-                summary: op.summary,
-                params,
-            });
-        }
-    }
-    return commands;
-}
-// ── arg parser ─────────────────────────────────────────────
-function parseArgs(argv) {
-    const input = {};
-    let format = 'json';
-    for (const arg of argv) {
-        const m = arg.match(/^--([\w-]+)=(.*)$/) || arg.match(/^--([\w-]+)$/);
-        if (!m)
-            continue;
-        if (m[1] === 'format') {
-            format = m[2] ?? 'json';
-            continue;
-        }
-        const key = m[1].replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-        let val = m[2] ?? true;
-        if (val === 'true')
-            val = true;
-        else if (val === 'false')
-            val = false;
-        else if (typeof val === 'string' && /^-?\d+(\.\d+)?$/.test(val))
-            val = Number(val);
-        else if (typeof val === 'string' && (val.startsWith('{') || val.startsWith('['))) {
-            try {
-                val = JSON.parse(val);
-            }
-            catch { }
-        }
-        input[key] = val;
-    }
-    return { input, format };
-}
-// ── formatters ─────────────────────────────────────────────
-function formatJson(data) {
-    return JSON.stringify(data, null, 2);
-}
-function formatYaml(data, indent = 0) {
-    const pad = '  '.repeat(indent);
-    if (data === null || data === undefined)
-        return pad + 'null';
-    if (typeof data === 'string')
-        return data.includes('\n') ? `|\n${data.split('\n').map(l => pad + '  ' + l).join('\n')}` : data;
-    if (typeof data !== 'object')
-        return String(data);
-    if (Array.isArray(data)) {
-        if (data.length === 0)
-            return '[]';
-        return data.map(item => {
-            if (typeof item === 'object' && item !== null && !Array.isArray(item)) {
-                const entries = Object.entries(item);
-                const first = entries[0];
-                const rest = entries.slice(1);
-                let s = pad + '- ' + first[0] + ': ' + formatYaml(first[1], indent + 2);
-                for (const [k, v] of rest)
-                    s += '\n' + pad + '  ' + k + ': ' + formatYaml(v, indent + 2);
-                return s;
-            }
-            return pad + '- ' + formatYaml(item, indent + 1);
-        }).join('\n');
-    }
-    const entries = Object.entries(data);
-    if (entries.length === 0)
-        return '{}';
-    return entries.map(([k, v]) => {
-        if (typeof v === 'object' && v !== null)
-            return pad + k + ':\n' + formatYaml(v, indent + 1);
-        return pad + k + ': ' + formatYaml(v, indent);
-    }).join('\n');
-}
-function formatHuman(data, indent = 0) {
-    const pad = '  '.repeat(indent);
-    if (data === null || data === undefined)
-        return pad + '\u2014';
-    if (typeof data !== 'object')
-        return pad + String(data);
-    if (Array.isArray(data)) {
-        if (data.length === 0)
-            return pad + '(empty)';
-        return data.map((item, i) => {
-            const prefix = pad + (i + 1) + '. ';
-            const body = formatHuman(item, 0).trimStart();
-            const contPad = ' '.repeat(prefix.length);
-            return prefix + body.split('\n').map((line, j) => j === 0 ? line : contPad + line).join('\n');
-        }).join('\n');
-    }
-    return Object.entries(data).map(([k, v]) => {
-        if (typeof v === 'object' && v !== null)
-            return pad + k + ':\n' + formatHuman(v, indent + 1);
-        return pad + k + ': ' + (v ?? '\u2014');
-    }).join('\n');
-}
-function formatTable(data) {
-    let rows;
-    if (Array.isArray(data))
-        rows = data;
-    else if (typeof data === 'object' && data !== null) {
-        const vals = Object.values(data);
-        const arrVal = vals.find(v => Array.isArray(v));
-        if (arrVal)
-            rows = arrVal;
-        else
-            rows = [data];
-    }
-    else {
-        return String(data);
-    }
-    if (rows.length === 0)
-        return '(empty)';
-    if (typeof rows[0] !== 'object' || rows[0] === null)
-        return rows.map(String).join('\n');
-    const flatRows = rows.map(row => {
-        const flat = {};
-        for (const [k, v] of Object.entries(row)) {
-            flat[k] = typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v ?? '');
-        }
-        return flat;
-    });
-    const cols = Array.from(new Set(flatRows.flatMap(r => Object.keys(r))));
-    const termWidth = process.stdout.columns || 120;
-    const widths = {};
-    for (const col of cols) {
-        widths[col] = col.length;
-        for (const row of flatRows) {
-            widths[col] = Math.max(widths[col], (row[col] || '').length);
-        }
-    }
-    const borders = 1 + cols.length * 3;
-    let totalWidth = borders + cols.reduce((s, c) => s + widths[c], 0);
-    while (totalWidth > termWidth) {
-        let widest = cols[0], maxW = 0;
-        for (const c of cols) {
-            if (widths[c] > maxW) {
-                maxW = widths[c];
-                widest = c;
-            }
-        }
-        if (maxW <= 4)
-            break;
-        widths[widest] = Math.max(4, widths[widest] - 1);
-        totalWidth = borders + cols.reduce((s, c) => s + widths[c], 0);
-    }
-    const truncate = (s, w) => s.length > w ? s.slice(0, w - 1) + '\u2026' : s;
-    const hline = (left, mid, right) => left + cols.map(c => '\u2500'.repeat(widths[c] + 2)).join(mid) + right;
-    const dataRow = (row) => '\u2502' + cols.map(c => ' ' + truncate(row[c] || '', widths[c]).padEnd(widths[c]) + ' ').join('\u2502') + '\u2502';
-    const lines = [];
-    lines.push(hline('\u250c', '\u252c', '\u2510'));
-    lines.push('\u2502' + cols.map(c => ' ' + truncate(c, widths[c]).padEnd(widths[c]) + ' ').join('\u2502') + '\u2502');
-    lines.push(hline('\u251c', '\u253c', '\u2524'));
-    for (const row of flatRows)
-        lines.push(dataRow(row));
-    lines.push(hline('\u2514', '\u2534', '\u2518'));
-    return lines.join('\n');
-}
-function formatCsv(data) {
-    let rows;
-    if (Array.isArray(data))
-        rows = data;
-    else if (typeof data === 'object' && data !== null) {
-        const arrVal = Object.values(data).find(v => Array.isArray(v));
-        if (arrVal)
-            rows = arrVal;
-        else
-            rows = [data];
-    }
-    else
-        return String(data);
-    if (rows.length === 0)
-        return '';
-    if (typeof rows[0] !== 'object' || rows[0] === null)
-        return rows.map(String).join('\n');
-    const cols = Array.from(new Set(rows.flatMap(r => Object.keys(r))));
-    const esc = (v) => {
-        const s = typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v ?? '');
-        return s.includes(',') || s.includes('"') || s.includes('\n') ? '"' + s.replace(/"/g, '""') + '"' : s;
-    };
-    const lines = [cols.join(',')];
-    for (const row of rows)
-        lines.push(cols.map(c => esc(row[c])).join(','));
-    return lines.join('\n');
-}
-function output(data, format) {
-    switch (format) {
-        case 'yaml':
-            console.log(formatYaml(data));
-            break;
-        case 'table':
-            console.log(formatTable(data));
-            break;
-        case 'csv':
-            console.log(formatCsv(data));
-            break;
-        case 'human':
-            console.log(formatHuman(data));
-            break;
-        default: console.log(formatJson(data));
-    }
-}
-// ── main entry point ───────────────────────────────────────
+import { runCliCore } from './core.js';
+/**
+ * Run a CLI for `spec`. Every behaviour a CLI might want to change is an option (see `CliOptions`):
+ * extra commands, overrides, positional params, hooks, formatters, help. Do not hand-roll a CLI.
+ */
 export async function runCli(spec, argvOrOptions, maybeOptions) {
     const argv = Array.isArray(argvOrOptions) ? argvOrOptions : process.argv.slice(2);
-    const options = Array.isArray(argvOrOptions) ? maybeOptions : argvOrOptions;
-    const commands = extractCommands(spec);
-    const [command, ...rest] = argv;
-    if (!command || command === 'help' || command === '--help') {
-        const title = spec.info?.title ?? 'API';
-        console.log(`${title} CLI\n`);
-        console.log('Usage: <command> [--key=value ...] [--format=json|yaml|table|csv|human]\n');
-        console.log('Commands:');
-        for (const cmd of commands) {
-            const params = cmd.params.map(p => p.required ? `--${p.name}` : `[--${p.name}]`).join(' ');
-            const summary = cmd.summary ? `  \u2014 ${cmd.summary}` : '';
-            console.log(`  ${cmd.name.padEnd(30)} ${params}${summary}`);
+    const options = (Array.isArray(argvOrOptions) ? maybeOptions : argvOrOptions) ?? {};
+    const { baseUrl: baseUrlOption, headers, clientConfig: clientOverrides, call, ...core } = options;
+    let client;
+    const defaultCall = async (command, input) => {
+        if (!client) {
+            const baseUrl = baseUrlOption ?? spec.servers?.[0]?.url ?? PLAT_AUTHORITY_URL;
+            const token = process.env.API_TOKEN;
+            const clientConfig = { ...clientOverrides };
+            if (baseUrl.startsWith('css://') && !clientConfig.transportPlugins?.length) {
+                clientConfig.transportPlugins = [createClientSideServerMQTTWebRTCTransportPlugin()];
+            }
+            client = new OpenAPIClient(spec, {
+                baseUrl,
+                headers: { ...headers, ...(token ? { authorization: `Bearer ${token}` } : {}) },
+                ...clientConfig,
+            });
         }
-        process.exit(0);
-    }
-    const matched = commands.find(c => c.name === command);
-    if (!matched) {
-        console.error(`Unknown command: ${command}. Run with --help for available commands.`);
-        process.exit(1);
-    }
-    const baseUrl = options?.baseUrl
-        ?? spec.servers?.[0]?.url
-        ?? PLAT_AUTHORITY_URL;
-    const token = process.env.API_TOKEN;
-    const clientConfig = {
-        ...options?.clientConfig,
+        const method = command.method.toLowerCase();
+        return client[method](command.path, input);
     };
-    if (baseUrl.startsWith('css://')
-        && !clientConfig.transportPlugins?.length) {
-        clientConfig.transportPlugins = [createClientSideServerMQTTWebRTCTransportPlugin()];
-    }
-    const client = new OpenAPIClient(spec, {
-        baseUrl,
-        headers: {
-            ...options?.headers,
-            ...(token ? { authorization: `Bearer ${token}` } : {}),
-        },
-        ...clientConfig,
-    });
-    const { input, format } = parseArgs(rest);
-    try {
-        const method = matched.method.toLowerCase();
-        const result = await client[method](matched.path, input);
-        output(result, format);
-    }
-    catch (err) {
-        console.error(err.message);
-        process.exit(1);
-    }
+    await runCliCore({ ...core, spec, call: call ?? defaultCall }, argv);
 }
 //# sourceMappingURL=runtime.js.map