@zmdb/cli 1.0.0-beta.1

package/dist/repl.js

@@ -0,0 +1,265 @@
+import { existsSync } from 'node:fs';
+import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { start } from 'node:repl';
+import { moduleDefOf } from '@zmdb/app/modules';
+import { createApp } from '@zmdb/web/app';
+import { describeGraph, renderTree } from '@zmdb/web/devtools';
+/**
+ * Boot the real application and start a local, stream-only Node REPL.
+ *
+ * No socket or adapter is created. The caller owns the returned async resource;
+ * disposing it closes the prompt and runs the application's normal shutdown
+ * lifecycle.
+ */
+export async function createReplSession(rootModule, options) {
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stdout;
+    const stderr = options.stderr ?? (text => process.stderr.write(text));
+    const cwd = options.cwd ?? process.cwd();
+    const graph = describeGraph(rootModule);
+    const tokenRecords = providerTokensOf(rootModule);
+    const app = createApp(rootModule);
+    try {
+        await app.init();
+    }
+    catch (error) {
+        try {
+            await app[Symbol.asyncDispose]();
+        }
+        catch (cleanupError) {
+            throw new SuppressedError(cleanupError, error, 'REPL operation and application cleanup failed');
+        }
+        throw error;
+    }
+    let server;
+    try {
+        const scope = replScope(app, graph, tokenRecords);
+        stderr([
+            'zmdb repl — development shell with the application container',
+            `config: ${options.configPath}`,
+            'dialect: application-owned (the application does not read zmdb.config.ts)',
+            'database: application-owned (provider values are not inspected or printed)',
+            `module: ${options.moduleSpec} (${rootModule.name || '<anonymous>'})`,
+            'scope: app, container, get(tokenOrDescription), tokens, describe(), request(req), load(name)',
+            `tokens: ${scope.tokens.length === 0 ? '(none)' : scope.tokens.join(', ')}`,
+            `history: ${options.historyPath === null ? 'disabled' : (options.historyPath ?? 'disabled')}`,
+            '',
+        ].join('\n'));
+        server = start({
+            prompt: 'zmdb> ',
+            input,
+            output,
+            terminal: options.terminal,
+            ignoreUndefined: true,
+        });
+        const activeServer = server;
+        let closed = false;
+        const enteredLines = [];
+        if (options.historyPath !== null && options.historyPath !== undefined) {
+            activeServer.on('line', line => {
+                if (line.length > 0 && line !== '.exit') {
+                    enteredLines.unshift(line);
+                }
+            });
+        }
+        const historyReady = Promise.withResolvers();
+        const whenClosed = new Promise((resolveClosed, rejectClosed) => {
+            activeServer.once('exit', () => {
+                closed = true;
+                void historyReady.promise.then(flush => flush()).then(resolveClosed, rejectClosed);
+            });
+        });
+        Object.assign(activeServer.context, scope);
+        try {
+            const flushHistory = options.historyPath === null || options.historyPath === undefined
+                ? async () => { }
+                : await configureHistory(activeServer, options.historyPath, cwd, enteredLines);
+            historyReady.resolve(flushHistory);
+        }
+        catch (error) {
+            historyReady.resolve(async () => { });
+            throw error;
+        }
+        let disposed = false;
+        return {
+            app,
+            graph,
+            scope,
+            server: activeServer,
+            closed: whenClosed,
+            evaluate: source => evaluate(activeServer, source),
+            [Symbol.asyncDispose]: async () => {
+                if (disposed) {
+                    return;
+                }
+                disposed = true;
+                if (!closed) {
+                    activeServer.close();
+                }
+                let outcome;
+                try {
+                    await whenClosed;
+                    outcome = { ok: true };
+                }
+                catch (error) {
+                    outcome = { ok: false, error };
+                }
+                try {
+                    await app[Symbol.asyncDispose]();
+                }
+                catch (cleanupError) {
+                    if (!outcome.ok)
+                        throw new SuppressedError(cleanupError, outcome.error, 'REPL close and application cleanup failed');
+                    throw cleanupError;
+                }
+                if (!outcome.ok)
+                    throw outcome.error;
+            },
+        };
+    }
+    catch (error) {
+        server?.close();
+        try {
+            await app[Symbol.asyncDispose]();
+        }
+        catch (cleanupError) {
+            throw new SuppressedError(cleanupError, error, 'REPL operation and application cleanup failed');
+        }
+        throw error;
+    }
+}
+/** Resolve the default history path without ever making it relative to the project. */
+export function replHistoryPath(environment = process.env, homeDirectory = homedir()) {
+    const configured = environment['ZMDB_REPL_HISTORY'];
+    if (configured === undefined || configured.length === 0) {
+        return resolve(homeDirectory, '.zmdb_repl_history');
+    }
+    return isAbsolute(configured) ? configured : resolve(homeDirectory, configured);
+}
+function replScope(app, graph, records) {
+    const get = createGet(app, records);
+    const tokens = graph.providers.map(provider => provider.token).toSorted();
+    return {
+        app,
+        container: app.container,
+        get,
+        tokens,
+        describe: () => renderTree(graph, graph.providers.length <= 50 ? { providers: true } : undefined),
+        request: request => {
+            const input = typeof request === 'string' ? { method: 'GET', path: request, headers: {} } : request;
+            return app.handle(input);
+        },
+        load: async (name) => {
+            const matches = app.lazy.filter(handle => handle.name === name);
+            if (matches.length === 0) {
+                throw new Error(`zmdb repl: no lazy module named "${name}"`);
+            }
+            if (matches.length > 1) {
+                throw new Error(`zmdb repl: lazy module name "${name}" is ambiguous (${String(matches.length)} handles)`);
+            }
+            await matches[0]?.load();
+        },
+    };
+}
+function createGet(app, records) {
+    return (tokenOrDescription) => {
+        if (typeof tokenOrDescription !== 'string') {
+            return app.container.resolve(tokenOrDescription);
+        }
+        const matches = records.filter(record => record.description === tokenOrDescription);
+        if (matches.length === 0) {
+            throw new Error(`zmdb repl: no provider token is described as "${tokenOrDescription}"`);
+        }
+        if (matches.length > 1) {
+            throw new Error(`zmdb repl: token description "${tokenOrDescription}" is ambiguous (${String(matches.length)} distinct tokens)`);
+        }
+        const record = matches[0];
+        if (record === undefined) {
+            throw new Error(`zmdb repl: no provider token is described as "${tokenOrDescription}"`);
+        }
+        return app.container.resolve(record.token);
+    };
+}
+function providerTokensOf(rootModule) {
+    const seenModules = new Set();
+    const seenTokens = new Set();
+    const records = [];
+    const visit = (moduleClass) => {
+        if (seenModules.has(moduleClass)) {
+            return;
+        }
+        seenModules.add(moduleClass);
+        const definition = moduleDefOf(moduleClass);
+        for (const provider of definition?.providers ?? []) {
+            if (!seenTokens.has(provider.token)) {
+                seenTokens.add(provider.token);
+                records.push({ token: provider.token, description: provider.token.description });
+            }
+        }
+        for (const imported of definition?.imports ?? []) {
+            visit(typeof imported === 'function' ? imported : imported.module);
+        }
+    };
+    visit(rootModule);
+    return records;
+}
+async function configureHistory(server, historyPath, cwd, enteredLines) {
+    if (isWithin(projectRootOf(cwd), historyPath)) {
+        throw new Error(`zmdb repl: history path "${historyPath}" must be outside the project tree`);
+    }
+    await mkdir(dirname(historyPath), { recursive: true, mode: 0o700 });
+    let existing = '';
+    try {
+        existing = await readFile(historyPath, 'utf8');
+    }
+    catch (error) {
+        if (!isNotFound(error)) {
+            throw error;
+        }
+    }
+    await writeFile(historyPath, existing, { encoding: 'utf8', mode: 0o600 });
+    await chmod(historyPath, 0o600);
+    const existingLines = existing.split(/\r?\n/).filter(line => line.length > 0);
+    Reflect.set(server, 'history', existingLines);
+    return async () => {
+        const lines = [...enteredLines, ...existingLines];
+        await writeFile(historyPath, lines.join('\n'), { encoding: 'utf8', mode: 0o600 });
+        await chmod(historyPath, 0o600);
+    };
+}
+function projectRootOf(cwd) {
+    let current = resolve(cwd);
+    while (true) {
+        if (existsSync(resolve(current, 'package.json'))) {
+            return current;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return resolve(cwd);
+        }
+        current = parent;
+    }
+}
+function isWithin(base, target) {
+    const path = relative(resolve(base), resolve(target));
+    return path === '' || (!path.startsWith(`..${sep}`) && path !== '..' && !isAbsolute(path));
+}
+function isNotFound(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+function evaluate(server, source) {
+    const command = source.endsWith('\n') ? source : `${source}\n`;
+    return new Promise((resolveResult, rejectResult) => {
+        server.eval(command, server.context, 'zmdb-repl', (error, result) => {
+            if (error === null) {
+                resolveResult(result);
+            }
+            else {
+                rejectResult(error);
+            }
+        });
+    });
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,28 @@
+import { type ScaffoldKind, type ScaffoldName } from './templates/index.js';
+export interface ScaffoldOptions {
+    readonly cwd: string;
+    readonly kind: string;
+    readonly name: string;
+    readonly package?: string;
+    readonly dryRun?: boolean;
+}
+export interface ScaffoldFile {
+    readonly path: string;
+    readonly source: string;
+}
+export interface ScaffoldResult {
+    readonly kind: ScaffoldKind;
+    readonly name: ScaffoldName;
+    readonly target: string;
+    readonly files: readonly ScaffoldFile[];
+    readonly instructions: readonly string[];
+    readonly dryRun: boolean;
+}
+export declare class ScaffoldUsageError extends Error {
+}
+export declare class ScaffoldConflictError extends Error {
+}
+/** Resolve, format and write one scaffold without ever editing an existing file. */
+export declare function scaffold(options: ScaffoldOptions): Promise<ScaffoldResult>;
+export declare function renderScaffold(result: ScaffoldResult): string;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,YAAY,EAGlB,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAkBD,qBAAa,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,qBAAa,qBAAsB,SAAQ,KAAK;CAAG;AAEnD,oFAAoF;AACpF,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAgDhF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAO7D"}