@ontrails/cli 1.0.0-beta.0

package/dist/commander/to-commander.js

@@ -0,0 +1,148 @@
+/**
+ * Adapt framework-agnostic CliCommand[] to a Commander program.
+ */
+import { exitCodeMap, isTrailsError } from '@ontrails/core';
+import { Command, Option } from 'commander';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Build the flag string portion of a Commander Option. */
+const buildFlagArgument = (flag) => {
+    if (flag.variadic) {
+        return flag.required ? '<values...>' : '[values...]';
+    }
+    return flag.required ? '<value>' : '[value]';
+};
+const buildFlagString = (flag) => {
+    const long = `--${flag.name}`;
+    const short = flag.short ? `-${flag.short}` : undefined;
+    if (flag.type === 'boolean') {
+        return short ? `${short}, ${long}` : long;
+    }
+    const argPart = buildFlagArgument(flag);
+    return short ? `${short}, ${long} ${argPart}` : `${long} ${argPart}`;
+};
+/** Build a Commander Option from a CliFlag. */
+const buildOption = (flag) => {
+    const opt = new Option(buildFlagString(flag), flag.description);
+    if (flag.choices) {
+        opt.choices(flag.choices);
+    }
+    if (flag.default !== undefined) {
+        opt.default(flag.default);
+    }
+    if (flag.type === 'number' || flag.type === 'number[]') {
+        opt.argParser(parseFloat);
+    }
+    return opt;
+};
+/** Add positional args to a Commander subcommand. */
+const buildArgTemplate = (arg) => {
+    if (arg.variadic) {
+        return arg.required ? `<${arg.name}...>` : `[${arg.name}...]`;
+    }
+    return arg.required ? `<${arg.name}>` : `[${arg.name}]`;
+};
+const addArgs = (sub, cmd) => {
+    for (const arg of cmd.args) {
+        const template = buildArgTemplate(arg);
+        sub.argument(template, arg.description);
+    }
+};
+/** Collect positional args from Commander's action callback into a record. */
+const collectPositionalArgs = (cmd, actionArgs) => {
+    const parsedArgs = {};
+    for (let i = 0; i < cmd.args.length; i += 1) {
+        const argDef = cmd.args[i];
+        if (argDef) {
+            parsedArgs[argDef.name] = actionArgs[i];
+        }
+    }
+    return parsedArgs;
+};
+/** Handle execution errors with appropriate exit codes. */
+const handleError = (error) => {
+    if (error instanceof Error) {
+        process.stderr.write(`Error: ${error.message}\n`);
+        if (isTrailsError(error)) {
+            process.exit(exitCodeMap[error.category]);
+        }
+    }
+    else {
+        process.stderr.write(`Error: ${String(error)}\n`);
+    }
+    process.exit(8);
+};
+/** Wire a CliCommand's action to a Commander subcommand. */
+const wireAction = (sub, cmd) => {
+    sub.action(async (...actionArgs) => {
+        const opts = sub.opts();
+        const parsedArgs = collectPositionalArgs(cmd, actionArgs);
+        try {
+            await cmd.execute(parsedArgs, opts);
+        }
+        catch (error) {
+            handleError(error);
+        }
+    });
+};
+/** Attach a subcommand to its group or to the top-level program. */
+const attachToGroup = (sub, cmd, program, groups) => {
+    if (cmd.group) {
+        let groupCmd = groups.get(cmd.group);
+        if (!groupCmd) {
+            groupCmd = new Command(cmd.group);
+            groups.set(cmd.group, groupCmd);
+            program.addCommand(groupCmd);
+        }
+        groupCmd.addCommand(sub);
+    }
+    else {
+        program.addCommand(sub);
+    }
+};
+/** Apply options to a Commander program. */
+const applyOptions = (program, options) => {
+    if (options?.name) {
+        program.name(options.name);
+    }
+    if (options?.version) {
+        program.version(options.version);
+    }
+    if (options?.description) {
+        program.description(options.description);
+    }
+};
+// ---------------------------------------------------------------------------
+// toCommander
+// ---------------------------------------------------------------------------
+/**
+ * Convert CliCommand[] into a configured Commander program.
+ *
+ * Groups commands by their `group` field into parent/subcommand structure.
+ * Wires each command's `.action()` to call `execute()` and handle errors.
+ */
+/** Build a Commander subcommand from a CliCommand. */
+const buildSubcommand = (cmd) => {
+    const sub = new Command(cmd.name);
+    if (cmd.description) {
+        sub.description(cmd.description);
+    }
+    for (const flag of cmd.flags) {
+        sub.addOption(buildOption(flag));
+    }
+    addArgs(sub, cmd);
+    wireAction(sub, cmd);
+    return sub;
+};
+export const toCommander = (commands, options) => {
+    const program = new Command();
+    applyOptions(program, options);
+    const groups = new Map();
+    for (const cmd of commands) {
+        const sub = buildSubcommand(cmd);
+        attachToGroup(sub, cmd, program, groups);
+    }
+    return program;
+};
+//# sourceMappingURL=to-commander.js.map

package/dist/commander/to-commander.js.map

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

package/dist/flags.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Flag derivation from surface-agnostic fields and reusable flag presets.
+ */
+import type { Field } from '@ontrails/core';
+import type { z } from 'zod';
+import type { CliFlag } from './command.js';
+/** Convert derived fields to CLI flags. */
+export declare const toFlags: (fields: readonly Field[]) => CliFlag[];
+/** Derive CLI flags from a Zod input schema. */
+export declare const deriveFlags: (schema: z.ZodType) => CliFlag[];
+/** Flags for output mode selection: --output, --json, --jsonl */
+export declare const outputModePreset: () => CliFlag[];
+/** Flag for working directory override: --cwd */
+export declare const cwdPreset: () => CliFlag[];
+/** Flag for dry-run mode: --dry-run */
+export declare const dryRunPreset: () => CliFlag[];
+//# sourceMappingURL=flags.d.ts.map

package/dist/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAiD5C,2CAA2C;AAC3C,eAAO,MAAM,OAAO,GAAI,QAAQ,SAAS,KAAK,EAAE,KAAG,OAAO,EACnC,CAAC;AA2HxB,gDAAgD;AAChD,eAAO,MAAM,WAAW,GAAI,QAAQ,CAAC,CAAC,OAAO,KAAG,OAAO,EAYtD,CAAC;AAMF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB,QAAO,OAAO,EAyB1C,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,SAAS,QAAO,OAAO,EAQnC,CAAC;AAEF,uCAAuC;AACvC,eAAO,MAAM,YAAY,QAAO,OAAO,EAStC,CAAC"}

package/dist/flags.js

@@ -0,0 +1,180 @@
+/**
+ * Flag derivation from surface-agnostic fields and reusable flag presets.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Convert camelCase to kebab-case. */
+const toKebab = (str) => str.replaceAll(/[A-Z]/g, (ch) => `-${ch.toLowerCase()}`);
+const fieldTypeToCliFlag = {
+    boolean: { type: 'boolean', variadic: false },
+    enum: { type: 'string', variadic: false },
+    multiselect: { type: 'string[]', variadic: true },
+    number: { type: 'number', variadic: false },
+    string: { type: 'string', variadic: false },
+};
+/** Convert a derived field into a CLI flag descriptor. */
+const toCliFlag = (field) => {
+    const shape = fieldTypeToCliFlag[field.type];
+    return {
+        choices: field.options?.map((option) => option.value),
+        default: field.default,
+        description: field.label,
+        name: toKebab(field.name),
+        required: field.required,
+        type: shape.type,
+        variadic: shape.variadic,
+    };
+};
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/** Convert derived fields to CLI flags. */
+export const toFlags = (fields) => fields.map(toCliFlag);
+/** Get the inner type from an optional or default wrapper. */
+const getInnerType = (current) => current._zod.def['innerType'];
+/** Propagate description from an inner type. */
+const propagateDescription = (inner, state) => {
+    if (inner.description) {
+        state.description = inner.description;
+    }
+};
+/** Step one unwrap level for optional/default fields. */
+const unwrapStep = (current, state) => {
+    const defType = current._zod.def['type'];
+    if (defType !== 'optional' && defType !== 'default') {
+        return null;
+    }
+    state.required = false;
+    if (defType === 'default') {
+        state.defaultValue = current._zod.def['defaultValue'];
+    }
+    const inner = getInnerType(current);
+    propagateDescription(inner, state);
+    return inner;
+};
+/** Unwrap optional/default wrappers, collecting metadata. */
+const unwrap = (schema) => {
+    const state = {
+        defaultValue: undefined,
+        description: schema.description,
+        required: true,
+    };
+    let current = schema;
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const next = unwrapStep(current, state);
+        if (next === null) {
+            break;
+        }
+        current = next;
+    }
+    return { ...state, inner: current };
+};
+const flagShapeByDef = {
+    array: (schema) => {
+        const element = schema._zod.def['element'];
+        const elementType = element._zod.def['type'];
+        if (elementType === 'number') {
+            return { type: 'number[]', variadic: true };
+        }
+        return { type: 'string[]', variadic: true };
+    },
+    boolean: () => ({ type: 'boolean', variadic: false }),
+    enum: (schema) => {
+        const entries = schema._zod.def['entries'];
+        return {
+            choices: Object.values(entries),
+            type: 'string',
+            variadic: false,
+        };
+    },
+    number: () => ({ type: 'number', variadic: false }),
+    string: () => ({ type: 'string', variadic: false }),
+};
+/** Derive the CLI flag shape for an unwrapped Zod field. */
+const deriveFlagShape = (schema) => {
+    const defType = schema._zod.def['type'];
+    const deriveShape = flagShapeByDef[defType];
+    return deriveShape
+        ? deriveShape(schema)
+        : { type: 'string', variadic: false };
+};
+/** Derive a single CLI flag from an object shape entry. */
+const deriveFlag = (key, value) => {
+    const { inner, required, defaultValue, description } = unwrap(value);
+    const { choices, type, variadic } = deriveFlagShape(inner);
+    return {
+        choices,
+        default: defaultValue,
+        description: description ?? inner.description,
+        name: toKebab(key),
+        required,
+        type,
+        variadic,
+    };
+};
+/** Derive CLI flags from a Zod input schema. */
+export const deriveFlags = (schema) => {
+    const zod = schema;
+    if (zod._zod.def['type'] !== 'object') {
+        return [];
+    }
+    const shape = zod._zod.def['shape'];
+    if (!shape) {
+        return [];
+    }
+    return Object.entries(shape).map(([key, value]) => deriveFlag(key, value));
+};
+// ---------------------------------------------------------------------------
+// Presets
+// ---------------------------------------------------------------------------
+/** Flags for output mode selection: --output, --json, --jsonl */
+export const outputModePreset = () => [
+    {
+        choices: ['text', 'json', 'jsonl'],
+        default: 'text',
+        description: 'Output format',
+        name: 'output',
+        required: false,
+        short: 'o',
+        type: 'string',
+        variadic: false,
+    },
+    {
+        description: 'Shorthand for --output json',
+        name: 'json',
+        required: false,
+        type: 'boolean',
+        variadic: false,
+    },
+    {
+        description: 'Shorthand for --output jsonl',
+        name: 'jsonl',
+        required: false,
+        type: 'boolean',
+        variadic: false,
+    },
+];
+/** Flag for working directory override: --cwd */
+export const cwdPreset = () => [
+    {
+        description: 'Working directory override',
+        name: 'cwd',
+        required: false,
+        type: 'string',
+        variadic: false,
+    },
+];
+/** Flag for dry-run mode: --dry-run */
+export const dryRunPreset = () => [
+    {
+        default: false,
+        description: 'Execute without side effects',
+        name: 'dry-run',
+        required: false,
+        type: 'boolean',
+        variadic: false,
+    },
+];
+//# sourceMappingURL=flags.js.map

package/dist/flags.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { AnyTrail, CliCommand, CliFlag, CliArg } from './command.js';
+export { buildCliCommands } from './build.js';
+export type { BuildCliCommandsOptions, ActionResultContext } from './build.js';
+export { deriveFlags, outputModePreset, cwdPreset, dryRunPreset, } from './flags.js';
+export { output, resolveOutputMode } from './output.js';
+export type { OutputMode } from './output.js';
+export { defaultOnResult } from './on-result.js';
+export { passthroughResolver, isInteractive } from './prompt.js';
+export type { Field, InputResolver, ResolveInputOptions } from './prompt.js';
+export { autoIterateLayer, dateShortcutsLayer } from './layers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAG/E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAG7E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Build
+export { buildCliCommands } from './build.js';
+// Flags
+export { deriveFlags, outputModePreset, cwdPreset, dryRunPreset, } from './flags.js';
+// Output
+export { output, resolveOutputMode } from './output.js';
+// onResult
+export { defaultOnResult } from './on-result.js';
+// Prompt
+export { passthroughResolver, isInteractive } from './prompt.js';
+// Layers
+export { autoIterateLayer, dateShortcutsLayer } from './layers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,QAAQ;AACR,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG9C,QAAQ;AACR,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGxD,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,SAAS;AACT,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGjE,SAAS;AACT,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/layers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI-specific layers shipped with @ontrails/cli.
+ */
+import type { Layer } from '@ontrails/core';
+/**
+ * Automatically iterates paginated results when --all flag is present.
+ *
+ * When a trail's output matches the pagination pattern (items, hasMore,
+ * nextCursor) and the input contains `all: true`, this layer repeatedly
+ * calls the implementation with incrementing cursors and collects all items.
+ */
+export declare const autoIterateLayer: Layer;
+/**
+ * Expands date shortcut strings into ISO date ranges.
+ *
+ * When a trail's input has `since` or `until` fields, this layer
+ * checks for shortcuts like "today", "yesterday", "7d", "30d",
+ * "this-week", "this-month" and expands them to ISO 8601 dates.
+ */
+export declare const dateShortcutsLayer: Layer;
+//# sourceMappingURL=layers.d.ts.map

package/dist/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../src/layers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAkB,KAAK,EAAS,MAAM,gBAAgB,CAAC;AAiHnE;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAsB9B,CAAC;AA4DF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAiBhC,CAAC"}

package/dist/layers.js

@@ -0,0 +1,156 @@
+/**
+ * CLI-specific layers shipped with @ontrails/cli.
+ */
+import { Result } from '@ontrails/core';
+/** Check if a trail's output schema looks like a paginated response. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const isPaginatedOutput = (trail) => {
+    if (!trail.output) {
+        return false;
+    }
+    const s = trail.output;
+    const defType = s._zod.def['type'];
+    if (defType !== 'object') {
+        return false;
+    }
+    const shape = s._zod.def['shape'];
+    if (!shape) {
+        return false;
+    }
+    return 'items' in shape && 'hasMore' in shape && 'nextCursor' in shape;
+};
+/** Check if a trail's input schema has since/until fields. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const hasDateRangeFields = (trail) => {
+    const s = trail.input;
+    const defType = s._zod.def['type'];
+    if (defType !== 'object') {
+        return false;
+    }
+    const shape = s._zod.def['shape'];
+    if (!shape) {
+        return false;
+    }
+    return 'since' in shape || 'until' in shape;
+};
+/** Fetch one page and extract items. Returns error result or page data. */
+const fetchPage = async (inp, cursor, implementation, ctx) => {
+    const pageInput = { ...inp, cursor };
+    const result = await implementation(pageInput, ctx);
+    if (result.isErr()) {
+        return result;
+    }
+    return Result.ok(result.value);
+};
+/** Accumulate items from a page and return the next cursor if there are more. */
+const accumulatePage = (page, allItems) => {
+    allItems.push(...page.items);
+    return page.hasMore && page.nextCursor ? page.nextCursor : undefined;
+};
+/** Collect all pages into a single result. */
+const collectAllPages = async (inp, implementation, ctx) => {
+    const allItems = [];
+    let cursor;
+    for (;;) {
+        const pageResult = await fetchPage(inp, cursor, implementation, ctx);
+        if (pageResult.isErr()) {
+            return pageResult;
+        }
+        cursor = accumulatePage(pageResult.value, allItems);
+        if (cursor === undefined) {
+            break;
+        }
+    }
+    return Result.ok({ hasMore: false, items: allItems });
+};
+/**
+ * Automatically iterates paginated results when --all flag is present.
+ *
+ * When a trail's output matches the pagination pattern (items, hasMore,
+ * nextCursor) and the input contains `all: true`, this layer repeatedly
+ * calls the implementation with incrementing cursors and collects all items.
+ */
+export const autoIterateLayer = {
+    description: 'Auto-paginate results when --all flag is set',
+    name: 'autoIterate',
+    wrap(trail, implementation) {
+        if (!isPaginatedOutput(trail)) {
+            return implementation;
+        }
+        return (input, ctx) => {
+            const inp = input;
+            if (!inp.all) {
+                return implementation(input, ctx);
+            }
+            return collectAllPages(inp, implementation, ctx);
+        };
+    },
+};
+// ---------------------------------------------------------------------------
+// dateShortcutsLayer
+// ---------------------------------------------------------------------------
+/** Build a date relative to today with a day offset. */
+const daysAgo = (days) => {
+    const now = new Date();
+    return new Date(now.getFullYear(), now.getMonth(), now.getDate() - days).toISOString();
+};
+const dateShortcuts = {
+    'this-month': () => {
+        const now = new Date();
+        return new Date(now.getFullYear(), now.getMonth(), 1).toISOString();
+    },
+    'this-week': () => {
+        const now = new Date();
+        const dayOfWeek = now.getDay();
+        const diff = dayOfWeek === 0 ? 6 : dayOfWeek - 1;
+        return daysAgo(diff);
+    },
+    today: () => daysAgo(0),
+    yesterday: () => daysAgo(1),
+};
+/** Expand a date shortcut to an ISO date string. */
+const expandDateShortcut = (shortcut) => {
+    const handler = dateShortcuts[shortcut];
+    if (handler) {
+        return handler();
+    }
+    const match = /^(\d+)d$/.exec(shortcut);
+    if (match?.[1]) {
+        return daysAgo(Number(match[1]));
+    }
+    return undefined;
+};
+/** Expand since/until shortcuts in an input record. */
+const expandDateFields = (inp) => {
+    const modified = { ...inp };
+    for (const field of ['since', 'until']) {
+        if (typeof inp[field] === 'string') {
+            const expanded = expandDateShortcut(inp[field]);
+            if (expanded) {
+                modified[field] = expanded;
+            }
+        }
+    }
+    return modified;
+};
+/**
+ * Expands date shortcut strings into ISO date ranges.
+ *
+ * When a trail's input has `since` or `until` fields, this layer
+ * checks for shortcuts like "today", "yesterday", "7d", "30d",
+ * "this-week", "this-month" and expands them to ISO 8601 dates.
+ */
+export const dateShortcutsLayer = {
+    description: 'Expand date shortcuts (today, 7d, etc.) to ISO dates',
+    name: 'dateShortcuts',
+    wrap(trail, implementation) {
+        if (!hasDateRangeFields(trail)) {
+            return implementation;
+        }
+        return (input, ctx) => {
+            const modified = expandDateFields(input);
+            return implementation(modified, ctx);
+        };
+    },
+};
+//# sourceMappingURL=layers.js.map

package/dist/layers.js.map

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

package/dist/on-result.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Default result handler for CLI commands.
+ */
+import type { ActionResultContext } from './build.js';
+/**
+ * The batteries-included result handler.
+ *
+ * - On error: throws the error (lets the program's error handler produce exit code)
+ * - On success: resolves output mode from flags, pipes value through `output()`
+ */
+export declare const defaultOnResult: (ctx: ActionResultContext) => Promise<void>;
+//# sourceMappingURL=on-result.d.ts.map

package/dist/on-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-result.d.ts","sourceRoot":"","sources":["../src/on-result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOtD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,mBAAmB,KACvB,OAAO,CAAC,IAAI,CAOd,CAAC"}

package/dist/on-result.js

@@ -0,0 +1,21 @@
+/**
+ * Default result handler for CLI commands.
+ */
+import { output, resolveOutputMode } from './output.js';
+// ---------------------------------------------------------------------------
+// defaultOnResult
+// ---------------------------------------------------------------------------
+/**
+ * The batteries-included result handler.
+ *
+ * - On error: throws the error (lets the program's error handler produce exit code)
+ * - On success: resolves output mode from flags, pipes value through `output()`
+ */
+export const defaultOnResult = async (ctx) => {
+    if (ctx.result.isErr()) {
+        throw ctx.result.error;
+    }
+    const { mode } = resolveOutputMode(ctx.flags);
+    await output(ctx.result.value, mode);
+};
+//# sourceMappingURL=on-result.js.map

package/dist/on-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"on-result.js","sourceRoot":"","sources":["../src/on-result.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAExD,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAClC,GAAwB,EACT,EAAE;IACjB,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;QACvB,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC;IACzB,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9C,MAAM,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC"}