@zmdb/cli 1.0.0-beta.1

package/dist/args.js

@@ -0,0 +1,353 @@
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+const COMMON_OPTIONS = {
+    config: {
+        type: 'string',
+        valueName: 'path',
+        description: 'Use this config file instead of discovery.',
+    },
+    project: {
+        type: 'string',
+        valueName: 'tsconfig',
+        description: "Override the config's TypeScript project.",
+    },
+    json: {
+        type: 'boolean',
+        description: 'Write one machine-readable result document to stdout.',
+    },
+    yes: {
+        type: 'boolean',
+        description: 'Answer permitted prompts without reading stdin.',
+    },
+    force: {
+        type: 'boolean',
+        description: 'Permit destructive database operations where supported.',
+    },
+    help: {
+        type: 'boolean',
+        short: 'h',
+        description: 'Show help for this command.',
+    },
+    version: {
+        type: 'boolean',
+        description: 'Print the installed zmdb version.',
+    },
+};
+const DATABASE_COMMANDS = {
+    generate: {
+        usage: 'zmdb generate [--name <slug>]',
+        summary: 'Create a migration and update the stored snapshot.',
+        options: {
+            name: {
+                type: 'string',
+                valueName: 'slug',
+                description: 'Name the migration; otherwise derive a name from the plan.',
+            },
+        },
+        maximumPositionals: 0,
+    },
+    embed: {
+        usage: 'zmdb embed [--out <file>] [--with-down]',
+        summary: 'Compile SQLite migrations into a bundle-resident TypeScript module.',
+        options: {
+            out: {
+                type: 'string',
+                valueName: 'file',
+                description: 'Write this module instead of migrations/embedded.ts.',
+            },
+            'with-down': {
+                type: 'boolean',
+                description: 'Include down sections for development tooling.',
+            },
+        },
+        maximumPositionals: 0,
+    },
+    migrate: {
+        usage: 'zmdb migrate',
+        summary: 'Apply pending migrations.',
+        options: {},
+        maximumPositionals: 0,
+    },
+    rollback: {
+        usage: 'zmdb rollback [--to <version>]',
+        summary: 'Revert the latest migration or roll back to a version.',
+        options: {
+            to: {
+                type: 'string',
+                valueName: 'version',
+                description: 'Revert down to, but not including, this version.',
+            },
+        },
+        maximumPositionals: 0,
+    },
+    status: {
+        usage: 'zmdb status',
+        summary: 'List migration versions and their applied state.',
+        options: {},
+        maximumPositionals: 0,
+    },
+    push: {
+        usage: 'zmdb push --force --yes',
+        summary: 'Apply declaration changes directly to a development database.',
+        options: {},
+        maximumPositionals: 0,
+    },
+    check: {
+        usage: 'zmdb check',
+        summary: 'Report schema, migration and snapshot findings.',
+        options: {},
+        maximumPositionals: 0,
+    },
+    upgrade: {
+        usage: 'zmdb upgrade',
+        summary: 'Upgrade the stored snapshot format without touching a database.',
+        options: {},
+        maximumPositionals: 0,
+    },
+    export: {
+        usage: 'zmdb export',
+        summary: 'Print the declaration set as dialect DDL.',
+        options: {},
+        maximumPositionals: 0,
+    },
+    pull: {
+        usage: 'zmdb pull [--dry-run] [--check]',
+        summary: 'Write declarations from a live database catalogue.',
+        options: {
+            'dry-run': {
+                type: 'boolean',
+                description: 'Print every generated declaration and write nothing.',
+            },
+            check: {
+                type: 'boolean',
+                description: 'Exit non-zero when the generated declarations are not current.',
+            },
+        },
+        maximumPositionals: 0,
+    },
+    up: {
+        usage: 'zmdb up',
+        summary: 'Refused: use migrate for the database or upgrade for a snapshot.',
+        options: {},
+        maximumPositionals: 0,
+        hidden: true,
+    },
+};
+const APPLICATION_COMMANDS = {
+    client: {
+        usage: 'zmdb client generate [--check] [--watch]',
+        summary: 'Generate OpenAPI and a typed HTTP client from configured contracts.',
+        options: {
+            check: {
+                type: 'boolean',
+                description: 'Write nothing and fail when either generated artifact is stale.',
+            },
+            watch: {
+                type: 'boolean',
+                description: 'Regenerate after an input in the compiled contract dependency set changes.',
+            },
+        },
+        maximumPositionals: 1,
+    },
+    new: {
+        usage: 'zmdb new <project|schema|controller|module|repository|command> <name> [--package <pkg>]',
+        summary: 'Create a formatter-clean project or application component.',
+        options: {
+            package: {
+                type: 'string',
+                valueName: 'pkg',
+                description: 'Target this named package when invoked from a workspace.',
+            },
+            'dry-run': {
+                type: 'boolean',
+                description: 'Print every generated file and write nothing.',
+            },
+        },
+        maximumPositionals: 2,
+    },
+    modules: {
+        usage: 'zmdb modules [path#export] [--format tree|dot] [--providers]\n' +
+            '             [--module <name>] [--token <description>] [--depth <n>]',
+        summary: 'Describe application declarations without constructing providers.',
+        options: {
+            format: {
+                type: 'string',
+                valueName: 'tree|dot',
+                description: 'Choose the human-readable graph format.',
+            },
+            providers: {
+                type: 'boolean',
+                description: 'Include provider nodes.',
+            },
+            module: {
+                type: 'string',
+                valueName: 'name',
+                description: 'Limit output to one module.',
+            },
+            token: {
+                type: 'string',
+                valueName: 'description',
+                description: 'Limit output to providers matching a token description.',
+            },
+            depth: {
+                type: 'string',
+                valueName: 'n',
+                description: 'Limit traversal to a non-negative depth.',
+            },
+        },
+        maximumPositionals: 1,
+    },
+    repl: {
+        usage: 'zmdb repl [path#export] [--no-history]',
+        summary: 'Boot an application into a local interactive session.',
+        options: {
+            history: {
+                type: 'boolean',
+                default: true,
+                description: 'Use private REPL history; pass --no-history to disable it.',
+            },
+        },
+        maximumPositionals: 1,
+    },
+    studio: {
+        usage: 'zmdb studio [--port <port>]',
+        summary: 'Browse configured tables through a read-only loopback server.',
+        options: {
+            port: {
+                type: 'string',
+                valueName: 'port',
+                description: 'Bind this loopback port instead of selecting an ephemeral one.',
+            },
+        },
+        maximumPositionals: 0,
+    },
+};
+const COMMANDS = {
+    codegen: {
+        usage: 'zmdb codegen [--project <tsconfig>] [--check] [--watch]',
+        summary: 'Generate validator artifacts from a TypeScript project.',
+        options: {
+            check: { type: 'boolean', description: 'Write nothing and fail when generated artifacts are stale.' },
+            watch: { type: 'boolean', description: 'Regenerate on source changes using one compiler session.' },
+        },
+        maximumPositionals: 0,
+    },
+    ...DATABASE_COMMANDS,
+    ...APPLICATION_COMMANDS,
+};
+export function isCommand(command) {
+    return Object.hasOwn(COMMANDS, command);
+}
+export function parseCommand(command, argv, cwd) {
+    const definition = COMMANDS[command];
+    if (definition === undefined) {
+        return {
+            error: `unknown command "${command}"`,
+            command,
+            config: attemptedConfig(argv, cwd),
+            json: argv.includes('--json'),
+        };
+    }
+    try {
+        const { values, positionals } = parseArgs({
+            args: argv,
+            options: parseOptions({ ...COMMON_OPTIONS, ...definition.options }),
+            strict: true,
+            allowPositionals: true,
+            allowNegative: true,
+        });
+        if (positionals.length > definition.maximumPositionals) {
+            return {
+                error: `unexpected positional argument "${positionals[definition.maximumPositionals] ?? ''}"`,
+                command,
+                config: configValue(values, cwd),
+                json: values.json === true,
+            };
+        }
+        return {
+            parsed: {
+                command,
+                config: configValue(values, cwd),
+                ...(typeof values.project === 'string' ? { project: values.project } : {}),
+                json: values.json === true,
+                help: values.help === true,
+                version: values.version === true,
+                positionals,
+                values,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            error: parseError(error),
+            command,
+            config: attemptedConfig(argv, cwd),
+            json: argv.includes('--json'),
+        };
+    }
+}
+export function globalHelp() {
+    const commandRows = Object.entries(COMMANDS)
+        .filter(([, definition]) => definition.hidden !== true)
+        .map(([name, definition]) => `  ${name.padEnd(10)} ${definition.summary}`);
+    return [
+        'zmdb — schema and application developer tools.',
+        '',
+        'Usage:',
+        '  zmdb <command> [options]',
+        '',
+        'Commands:',
+        ...commandRows,
+        '',
+        'Run `zmdb <command> --help` for command-specific options.',
+        '',
+    ].join('\n');
+}
+export function commandHelp(command) {
+    const definition = COMMANDS[command];
+    if (definition === undefined)
+        return globalHelp();
+    const options = { ...COMMON_OPTIONS, ...definition.options };
+    const optionRows = Object.entries(options).map(([name, option]) => {
+        const longName = name === 'history' ? '--no-history' : `--${name}`;
+        const short = option.short === undefined ? '' : `-${option.short}, `;
+        const value = option.valueName === undefined ? '' : ` <${option.valueName}>`;
+        return `  ${`${short}${longName}${value}`.padEnd(30)} ${option.description}`;
+    });
+    return [definition.summary, '', 'Usage:', `  ${definition.usage}`, '', 'Options:', ...optionRows, ''].join('\n');
+}
+function parseOptions(definitions) {
+    const options = {};
+    for (const [name, definition] of Object.entries(definitions)) {
+        options[name] = {
+            type: definition.type,
+            ...(definition.short === undefined ? {} : { short: definition.short }),
+            ...(definition.default === undefined ? {} : { default: definition.default }),
+        };
+    }
+    return options;
+}
+function configValue(values, cwd) {
+    return resolve(cwd, typeof values.config === 'string' ? values.config : 'zmdb.config.ts');
+}
+function attemptedConfig(argv, cwd) {
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        if (argument === '--config') {
+            const value = argv[index + 1];
+            if (value !== undefined)
+                return resolve(cwd, value);
+        }
+        if (argument?.startsWith('--config='))
+            return resolve(cwd, argument.slice('--config='.length));
+    }
+    return resolve(cwd, 'zmdb.config.ts');
+}
+function parseError(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    const message = error.message.replace(/^Option usage error:\s*/i, '');
+    const unknown = /^Unknown option '([^']+)'/.exec(message);
+    return unknown === null ? message : `unknown option "${unknown[1] ?? ''}"`;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAA+D,MAAM,WAAW,CAAC;AAiBnG,MAAM,cAAc,GAAsB;IACxC,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,MAAM;QACjB,WAAW,EAAE,4CAA4C;KAC1D;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,UAAU;QACrB,WAAW,EAAE,2CAA2C;KACzD;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,uDAAuD;KACrE;IACD,GAAG,EAAE;QACH,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iDAAiD;KAC/D;IACD,KAAK,EAAE;QACL,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yDAAyD;KACvE;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,GAAG;QACV,WAAW,EAAE,6BAA6B;KAC3C;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,mCAAmC;KACjD;CACF,CAAC;AAEF,MAAM,iBAAiB,GAAgD;IACrE,QAAQ,EAAE;QACR,KAAK,EAAE,+BAA+B;QACtC,OAAO,EAAE,oDAAoD;QAC7D,OAAO,EAAE;YACP,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,yCAAyC;QAChD,OAAO,EAAE,qEAAqE;QAC9E,OAAO,EAAE;YACP,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,sDAAsD;aACpE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,2BAA2B;QACpC,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,CAAC;KACtB;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,gCAAgC;QACvC,OAAO,EAAE,wDAAwD;QACjE,OAAO,EAAE;YACP,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,SAAS;gBACpB,WAAW,EAAE,kDAAkD;aAChE;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,kDAAkD;QAC3D,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,CAAC;KACtB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,yBAAyB;QAChC,OAAO,EAAE,+DAA+D;QACxE,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,CAAC;KACtB;IACD,KAAK,EAAE;QACL,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,iDAAiD;QAC1D,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,CAAC;KACtB;IACD,OAAO,EAAE;QACP,KAAK,EAAE,cAAc;QACrB,OAAO,EAAE,iEAAiE;QAC1E,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,CAAC;KACtB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,aAAa;QACpB,OAAO,EAAE,2CAA2C;QACpD,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,CAAC;KACtB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,iCAAiC;QACxC,OAAO,EAAE,oDAAoD;QAC7D,OAAO,EAAE;YACP,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,sDAAsD;aACpE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,gEAAgE;aAC9E;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,EAAE,EAAE;QACF,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,kEAAkE;QAC3E,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,CAAC;QACrB,MAAM,EAAE,IAAI;KACb;CACF,CAAC;AAEF,MAAM,oBAAoB,GAAgD;IACxE,MAAM,EAAE;QACN,KAAK,EAAE,0CAA0C;QACjD,OAAO,EAAE,qEAAqE;QAC9E,OAAO,EAAE;YACP,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,iEAAiE;aAC/E;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,4EAA4E;aAC1F;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,GAAG,EAAE;QACH,KAAK,EAAE,yFAAyF;QAChG,OAAO,EAAE,4DAA4D;QACrE,OAAO,EAAE;YACP,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,KAAK;gBAChB,WAAW,EAAE,0DAA0D;aACxE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,+CAA+C;aAC7D;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,OAAO,EAAE;QACP,KAAK,EACH,gEAAgE;YAChE,sEAAsE;QACxE,OAAO,EAAE,mEAAmE;QAC5E,OAAO,EAAE;YACP,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,UAAU;gBACrB,WAAW,EAAE,yCAAyC;aACvD;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,yBAAyB;aACvC;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,6BAA6B;aAC3C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,aAAa;gBACxB,WAAW,EAAE,yDAAyD;aACvE;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,GAAG;gBACd,WAAW,EAAE,0CAA0C;aACxD;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,wCAAwC;QAC/C,OAAO,EAAE,uDAAuD;QAChE,OAAO,EAAE;YACP,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,IAAI;gBACb,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,MAAM,EAAE;QACN,KAAK,EAAE,6BAA6B;QACpC,OAAO,EAAE,+DAA+D;QACxE,OAAO,EAAE;YACP,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,SAAS,EAAE,MAAM;gBACjB,WAAW,EAAE,gEAAgE;aAC9E;SACF;QACD,kBAAkB,EAAE,CAAC;KACtB;CACF,CAAC;AAEF,MAAM,QAAQ,GAAgD;IAC5D,OAAO,EAAE;QACP,KAAK,EAAE,yDAAyD;QAChE,OAAO,EAAE,yDAAyD;QAClE,OAAO,EAAE;YACP,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,4DAA4D,EAAE;YACrG,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0DAA0D,EAAE;SACpG;QACD,kBAAkB,EAAE,CAAC;KACtB;IACD,GAAG,iBAAiB;IACpB,GAAG,oBAAoB;CACxB,CAAC;AAiBF,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,IAAuB,EAAE,GAAW;IAChF,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE,oBAAoB,OAAO,GAAG;YACrC,OAAO;YACP,MAAM,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC9B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;YACxC,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,YAAY,CAAC,EAAE,GAAG,cAAc,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;YACnE,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,IAAI;YACtB,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,IAAI,WAAW,CAAC,MAAM,GAAG,UAAU,CAAC,kBAAkB,EAAE,CAAC;YACvD,OAAO;gBACL,KAAK,EAAE,mCAAmC,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,EAAE,GAAG;gBAC7F,OAAO;gBACP,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC;gBAChC,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;aAC3B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE;gBACN,OAAO;gBACP,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC;gBAChC,GAAG,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1E,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;gBAC1B,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,IAAI;gBAC1B,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI;gBAChC,WAAW;gBACX,MAAM;aACP;SACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC;YACxB,OAAO;YACP,MAAM,EAAE,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC9B,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;SACzC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,IAAI,CAAC;SACtD,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7E,OAAO;QACL,gDAAgD;QAChD,EAAE;QACF,QAAQ;QACR,4BAA4B;QAC5B,EAAE;QACF,WAAW;QACX,GAAG,WAAW;QACd,EAAE;QACF,2DAA2D;QAC3D,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,EAAE,CAAC;IAClD,MAAM,OAAO,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;QAChE,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACnE,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC;QACrE,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,SAAS,GAAG,CAAC;QAC7E,OAAO,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnH,CAAC;AAED,SAAS,YAAY,CAAC,WAA8B;IAClD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,GAAG;YACd,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC;YACtE,GAAG,CAAC,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC;SAC7E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,MAAyC,EAAE,GAAW;IACzE,OAAO,OAAO,CAAC,GAAG,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;AAC5F,CAAC;AAED,SAAS,eAAe,CAAC,IAAuB,EAAE,GAAW;IAC3D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC9B,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;AAC7E,CAAC"}

package/dist/atomic.d.ts

@@ -0,0 +1,13 @@
+export interface AtomicWriteOperations {
+    readonly write: (path: string, text: string) => Promise<void>;
+    readonly rename: (from: string, to: string) => Promise<void>;
+    readonly remove: (path: string) => Promise<void>;
+}
+/**
+ * Replace one text file with a complete sibling written first.
+ *
+ * The temporary file lives in the destination directory, so `rename` is the
+ * atomic filesystem operation rather than a cross-device copy.
+ */
+export declare function writeTextAtomically(path: string, text: string, operations?: AtomicWriteOperations): Promise<void>;
+//# sourceMappingURL=atomic.d.ts.map

package/dist/atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../src/atomic.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAUD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,qBAAuC,GAClD,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/atomic.js

@@ -0,0 +1,28 @@
+import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import { basename, dirname, join } from 'node:path';
+const FILE_OPERATIONS = {
+    write: (path, text) => writeFile(path, text, { flag: 'wx' }),
+    rename,
+    remove: path => rm(path, { force: true }),
+};
+let temporaryFileSequence = 0;
+/**
+ * Replace one text file with a complete sibling written first.
+ *
+ * The temporary file lives in the destination directory, so `rename` is the
+ * atomic filesystem operation rather than a cross-device copy.
+ */
+export async function writeTextAtomically(path, text, operations = FILE_OPERATIONS) {
+    await mkdir(dirname(path), { recursive: true });
+    temporaryFileSequence += 1;
+    const temporary = join(dirname(path), `.${basename(path)}.${String(process.pid)}.${String(temporaryFileSequence)}.tmp`);
+    try {
+        await operations.write(temporary, text);
+        await operations.rename(temporary, path);
+    }
+    catch (error) {
+        await operations.remove(temporary);
+        throw error;
+    }
+}
+//# sourceMappingURL=atomic.js.map

package/dist/atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.js","sourceRoot":"","sources":["../src/atomic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQpD,MAAM,eAAe,GAA0B;IAC7C,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC5D,MAAM;IACN,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;CAC1C,CAAC;AAEF,IAAI,qBAAqB,GAAG,CAAC,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,IAAY,EACZ,UAAU,GAA0B,eAAe;IAEnD,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,qBAAqB,IAAI,CAAC,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,CACpB,OAAO,CAAC,IAAI,CAAC,EACb,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,qBAAqB,CAAC,MAAM,CACjF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxC,MAAM,UAAU,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from './index.js';
+process.exitCode = await runCli(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,OAAO,CAAC,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/commands/check.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig } from '@zmdb/compiler/config';
+import { type CheckResult } from '@zmdb/migrations/files';
+export type { CheckFinding, CheckFindingKind, CheckResult } from '@zmdb/migrations/files';
+export declare function checkProject(config: ResolvedConfig): Promise<CheckResult>;
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAyC,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIjG,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1F,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAG/E"}

package/dist/commands/check.js

@@ -0,0 +1,7 @@
+import { checkProject as checkMigrationProject } from '@zmdb/migrations/files';
+import { configuredMigrationDriver, reflectedMigrationProject } from '../migration-project.js';
+export async function checkProject(config) {
+    const driver = config.driver === undefined ? undefined : await configuredMigrationDriver(config);
+    return checkMigrationProject(reflectedMigrationProject(config, driver));
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,IAAI,qBAAqB,EAAoB,MAAM,wBAAwB,CAAC;AAEjG,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAI/F,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAsB;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACjG,OAAO,qBAAqB,CAAC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/commands/client.d.ts

@@ -0,0 +1,38 @@
+import type { ResolvedConfig } from '@zmdb/compiler/config';
+import { ReflectSession } from '@zmdb/compiler/reflect';
+export interface ClientGenerateResult {
+    readonly out: {
+        readonly openApi: string;
+        readonly client: string;
+    };
+    readonly operations: readonly string[];
+    readonly changed: boolean;
+    readonly contractFormat: 1;
+    readonly generatorVersion: string;
+}
+export interface HttpArtifactGeneration {
+    readonly result: ClientGenerateResult;
+    /** Missing or byte-different outputs before this run. */
+    readonly stale: readonly string[];
+    /** Exact project-source dependency set used for watch invalidation. */
+    readonly dependencies: readonly string[];
+}
+export interface GenerateHttpArtifactsOptions {
+    readonly check?: boolean;
+    /** A caller-owned session is retained and remains open after generation. */
+    readonly session?: ReflectSession;
+}
+export interface WatchHttpArtifactsOptions {
+    readonly debounceMs?: number;
+    readonly until?: Promise<unknown>;
+    readonly session?: ReflectSession;
+    readonly log?: (generation: HttpArtifactGeneration) => void;
+}
+/** Compile once, project both public artifacts, and write or check their exact bytes. */
+export declare function generateHttpArtifacts(config: ResolvedConfig, options?: GenerateHttpArtifactsOptions): Promise<HttpArtifactGeneration>;
+/**
+ * Keep one reflection session open and regenerate only after an input in the
+ * last compiled dependency set changes.
+ */
+export declare function watchHttpArtifacts(config: ResolvedConfig, options?: WatchHttpArtifactsOptions): Promise<HttpArtifactGeneration>;
+//# sourceMappingURL=client.d.ts.map

package/dist/commands/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/commands/client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAgC,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAgCxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE;QACZ,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,sBAAsB,KAAK,IAAI,CAAC;CAC7D;AAWD,yFAAyF;AACzF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,sBAAsB,CAAC,CAQjC;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,sBAAsB,CAAC,CAoFjC"}