grafeo-ogm 1.8.7 → 1.9.0

package/dist/cjs/cli/commands/db-seed.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDbSeed = runDbSeed;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_util_1 = require("node:util");
+const ogm_1 = require("../../ogm");
+const config_1 = require("../config");
+const driver_1 = require("../driver");
+const errors_1 = require("../errors");
+/** Idempotent-by-upsert example embedded in the no-seed-found message. */
+const SEED_EXAMPLE = `// seed.ts
+import type { OGM } from 'grafeo-ogm';
+
+export default async function seed(ogm: OGM) {
+  const Book = ogm.model('Book');
+  // upsert (not create) so repeated seeds converge instead of duplicating.
+  await Book.upsert({
+    where: { id: '1' },
+    create: { id: '1', title: 'Dune' },
+    update: { title: 'Dune' },
+  });
+}`;
+function parseDbSeedFlags(argv) {
+    try {
+        const { values } = (0, node_util_1.parseArgs)({
+            args: argv,
+            options: {
+                schema: { type: 'string' },
+                uri: { type: 'string' },
+                username: { type: 'string' },
+                database: { type: 'string' },
+                debug: { type: 'boolean' },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+        return values;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`db seed: ${message}`);
+    }
+}
+/**
+ * Resolve the seed entry point (cli-db-seed spec). Precedence: config `seed`
+ * → `./seed.ts` → `./seed.js`. A config-declared path that is missing is a
+ * pointed "not found" error; the zero-config miss instead shows the expected
+ * locations plus an upsert-based example.
+ */
+function resolveSeedPath(config, cwd) {
+    if (config.seed) {
+        const resolved = path.resolve(cwd, config.seed);
+        if (!fs.existsSync(resolved))
+            throw new errors_1.CliError(`Seed file not found: ${resolved}`);
+        return resolved;
+    }
+    for (const name of ['seed.ts', 'seed.js']) {
+        const candidate = path.join(cwd, name);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    throw new errors_1.CliError(`No seed script found. Looked for:\n` +
+        `  - "seed" in grafeo.config.ts\n` +
+        `  - ${path.join(cwd, 'seed.ts')}\n` +
+        `  - ${path.join(cwd, 'seed.js')}\n\n` +
+        `Create one (upsert keeps repeated runs idempotent):\n\n${SEED_EXAMPLE}`);
+}
+/** Load the seed module through jiti and pull out its default function. */
+async function loadSeedFn(seedPath) {
+    const { createJiti } = await Promise.resolve().then(() => __importStar(require('jiti')));
+    const jiti = createJiti(__filename);
+    let loaded;
+    try {
+        loaded = await jiti.import(seedPath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`Failed to load seed ${path.basename(seedPath)}: ${message}`);
+    }
+    const fn = loaded && typeof loaded === 'object' && 'default' in loaded
+        ? loaded.default
+        : loaded;
+    if (typeof fn !== 'function')
+        throw new errors_1.CliError(`Seed ${path.basename(seedPath)} must export a default async function ` +
+            `\`(ogm) => void\`.\n\n${SEED_EXAMPLE}`);
+    return fn;
+}
+async function runDbSeed(argv, io) {
+    const flags = parseDbSeedFlags(argv);
+    const { config } = await (0, config_1.loadConfigFile)(io.cwd);
+    const schemaPath = (0, config_1.resolveSchemaPath)(flags, config, io.cwd);
+    const typeDefs = fs.readFileSync(schemaPath, 'utf-8');
+    const connection = (0, config_1.resolveConnection)(flags, config, io.env);
+    // Resolve and load the seed BEFORE opening a connection, so a missing or
+    // broken seed fails without ever creating a driver.
+    const seedPath = resolveSeedPath(config, io.cwd);
+    const seed = await loadSeedFn(seedPath);
+    const driver = (0, driver_1.createDriver)(io, connection);
+    try {
+        // The OGM constructor parses the SDL synchronously and throws on an
+        // invalid schema — it lives inside this try so the driver created above
+        // is still closed in that case (cli-db-seed spec: close on any failure).
+        const ogm = new ogm_1.OGM({ typeDefs, driver });
+        await ogm.init();
+        io.out(`running seed ${seedPath}`);
+        try {
+            await seed(ogm);
+        }
+        finally {
+            ogm.close();
+        }
+        io.out('✓ seed complete');
+        return 0;
+    }
+    finally {
+        await driver.close();
+    }
+}
+//# sourceMappingURL=db-seed.js.map

package/dist/cjs/cli/commands/db-seed.js.map

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

package/dist/cjs/cli/commands/generate.d.ts

@@ -0,0 +1,3 @@
+import type { CliIO } from '../types';
+export declare function runGenerate(argv: string[], io: CliIO): Promise<number>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cjs/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,KAAK,EAAgB,MAAM,UAAU,CAAC;AAqLpD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC5E"}

package/dist/cjs/cli/commands/generate.js

@@ -0,0 +1,218 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGenerate = runGenerate;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_util_1 = require("node:util");
+const generate_types_1 = require("../../generator/generate-types");
+const config_1 = require("../config");
+const errors_1 = require("../errors");
+/** Local HH:MM:SS stamp prefixed to watch-mode lines (cli-generate spec). */
+function timeNow() {
+    return new Date().toTimeString().slice(0, 8);
+}
+/**
+ * Run the generator, naming the schema file in schema-related failures
+ * (cli-config error convention: "stderr names the schema file"). The error
+ * class is preserved so renderError still tags it (`SchemaParseError: …`) and
+ * `--debug` keeps a usable stack. Output-path errors are left untouched —
+ * naming the schema file there would mislead.
+ */
+async function runGenerator(typeDefs, outFile, config, schemaPath) {
+    try {
+        return await (0, generate_types_1.generateTypes)({ typeDefs, outFile, config: config.generate });
+    }
+    catch (error) {
+        if (error instanceof generate_types_1.SchemaParseError)
+            throw new generate_types_1.SchemaParseError(`${schemaPath}: ${error.message}`);
+        if (error instanceof generate_types_1.EmptySchemaError)
+            throw new generate_types_1.EmptySchemaError(`${schemaPath}: ${error.message}`);
+        throw error;
+    }
+}
+function parseGenerateFlags(argv) {
+    try {
+        const { values } = (0, node_util_1.parseArgs)({
+            args: argv,
+            options: {
+                schema: { type: 'string' },
+                out: { type: 'string' },
+                watch: { type: 'boolean' },
+                verify: { type: 'boolean' },
+                poll: { type: 'string' },
+                debug: { type: 'boolean' },
+            },
+            strict: true,
+            allowPositionals: false,
+        });
+        return values;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new errors_1.CliError(`generate: ${message}`);
+    }
+}
+async function generateOnce(schemaPath, outPath, config, io, opts) {
+    const typeDefs = fs.readFileSync(schemaPath, 'utf-8');
+    const result = await runGenerator(typeDefs, outPath, config, schemaPath);
+    for (const warning of result.warnings)
+        io.err(`warning: ${warning.message}`);
+    const stamp = opts?.timestamped ? `[${timeNow()}] ` : '';
+    io.out(`${stamp}✓ generated ${result.outputPath} (${result.typeCount} types, ` +
+        `${(result.fileSize / 1024).toFixed(1)} kB, ${result.durationMs} ms)`);
+}
+/**
+ * `--verify` (cli-generate spec): generate through the EXACT same
+ * `generateTypes()` pipeline (including its Prettier step) into a temp
+ * file, byte-compare against the configured output, and never write to
+ * it. Reusing the real pipeline is what makes verify-vs-generate drift
+ * structurally impossible.
+ */
+async function verifyOnce(schemaPath, outPath, config, io) {
+    const staleMessage = `Generated types are out of date. Run \`grafeo generate\`.`;
+    if (!fs.existsSync(outPath)) {
+        io.err(`error: output file does not exist: ${outPath}`);
+        io.err(staleMessage);
+        return 1;
+    }
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'grafeo-verify-'));
+    const tmpOut = path.join(tmpDir, path.basename(outPath));
+    try {
+        const typeDefs = fs.readFileSync(schemaPath, 'utf-8');
+        await runGenerator(typeDefs, tmpOut, config, schemaPath);
+        const expected = fs.readFileSync(tmpOut, 'utf-8');
+        const actual = fs.readFileSync(outPath, 'utf-8');
+        if (expected === actual) {
+            io.out(`✓ ${outPath} is up to date`);
+            return 0;
+        }
+        io.err(`error: ${outPath} is stale (schema changed since generation)`);
+        io.err(staleMessage);
+        return 1;
+    }
+    finally {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+}
+/**
+ * `--watch` (cli-generate spec): debounced re-generation on schema change.
+ * A failed regeneration prints the error and KEEPS WATCHING. `--poll <ms>`
+ * swaps fs.watch for fs.watchFile polling (documented fallback for
+ * platforms/editors where fs.watch misfires).
+ */
+async function watchLoop(schemaPath, outPath, config, io, pollMs) {
+    const DEBOUNCE_MS = 100;
+    let timer;
+    const regenerate = async () => {
+        try {
+            await generateOnce(schemaPath, outPath, config, io, {
+                timestamped: true,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            io.err(`watch: generation failed — ${message}`);
+            io.err('watch: still watching; fix the schema and save again');
+        }
+    };
+    const onChange = () => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => void regenerate(), DEBOUNCE_MS);
+        timer.unref?.();
+    };
+    let close;
+    if (pollMs !== undefined) {
+        fs.watchFile(schemaPath, { interval: pollMs }, onChange);
+        close = () => fs.unwatchFile(schemaPath, onChange);
+    }
+    else {
+        const watcher = fs.watch(schemaPath, onChange);
+        close = () => watcher.close();
+    }
+    io.out(`watching ${schemaPath} — Ctrl-C to stop`);
+    return new Promise((resolve) => {
+        const finish = () => {
+            if (timer)
+                clearTimeout(timer);
+            close();
+            resolve(0);
+        };
+        if (io.signal) {
+            if (io.signal.aborted)
+                return finish();
+            io.signal.addEventListener('abort', finish, { once: true });
+        }
+        // Without a signal (the real bin), the promise intentionally never
+        // resolves — the process runs until killed.
+    });
+}
+async function runGenerate(argv, io) {
+    const flags = parseGenerateFlags(argv);
+    if (flags.watch && flags.verify)
+        throw new errors_1.CliError('generate: --watch and --verify are mutually exclusive');
+    const { config } = await (0, config_1.loadConfigFile)(io.cwd);
+    const schemaPath = (0, config_1.resolveSchemaPath)(flags, config, io.cwd);
+    const outPath = (0, config_1.resolveOutPath)(flags, config, io.cwd);
+    if (flags.verify)
+        return verifyOnce(schemaPath, outPath, config, io);
+    let pollMs;
+    if (flags.poll !== undefined) {
+        pollMs = Math.trunc(Number(flags.poll));
+        if (!Number.isFinite(pollMs) || pollMs <= 0)
+            throw new errors_1.CliError('generate: --poll must be a positive integer (ms)');
+    }
+    if (pollMs !== undefined && !flags.watch)
+        throw new errors_1.CliError('generate: --poll only applies with --watch');
+    // Initial generation always runs (and in watch mode a broken schema at
+    // startup is reported but does not prevent watching).
+    if (flags.watch) {
+        try {
+            await generateOnce(schemaPath, outPath, config, io, {
+                timestamped: true,
+            });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            io.err(`watch: initial generation failed — ${message}`);
+        }
+        return watchLoop(schemaPath, outPath, config, io, pollMs);
+    }
+    await generateOnce(schemaPath, outPath, config, io);
+    return 0;
+}
+//# sourceMappingURL=generate.js.map

package/dist/cjs/cli/commands/generate.js.map

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

package/dist/cjs/cli/config.d.ts

@@ -0,0 +1,38 @@
+import type { GrafeoConfig, ResolvedConnection } from './types';
+export interface LoadedConfig {
+    config: GrafeoConfig;
+    /** Absolute path of the file that was loaded, if any. */
+    filePath?: string;
+}
+/**
+ * Discover and load grafeo.config.{ts,js,json} from `cwd`. TS/JS configs
+ * load through jiti (the CLI's single runtime dependency) so users get
+ * `grafeo.config.ts` without pre-compiling — the same DX as Prisma/Drizzle.
+ * Returns an empty config when no file exists; commands fall back to flags
+ * and defaults.
+ */
+export declare function loadConfigFile(cwd: string): Promise<LoadedConfig>;
+/**
+ * Resolve the SDL schema path. Precedence: flag > config > ./schema.graphql
+ * (zero-config default, only when the file actually exists). A flag/config
+ * path that doesn't exist is an error naming the resolved path; nothing at
+ * all is an error showing a minimal config example (cli-config spec).
+ */
+export declare function resolveSchemaPath(flags: {
+    schema?: string;
+}, config: GrafeoConfig, cwd: string): string;
+/** Resolve the codegen output path. Precedence: flag > config > default. */
+export declare function resolveOutPath(flags: {
+    out?: string;
+}, config: GrafeoConfig, cwd: string): string;
+/**
+ * Resolve the Neo4j connection per the cli-config spec. Precedence per
+ * setting: flag > config `database` block > NEO4J_* env var. The password
+ * has NO flag path by design.
+ */
+export declare function resolveConnection(flags: {
+    uri?: string;
+    username?: string;
+    database?: string;
+}, config: GrafeoConfig, env: NodeJS.ProcessEnv): ResolvedConnection;
+//# sourceMappingURL=config.d.ts.map

package/dist/cjs/cli/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAiBhE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA+BvE;AAsCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1B,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,GACV,MAAM,CAgBR;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAC5B,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,GACV,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7D,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,kBAAkB,CA8BpB"}

package/dist/cjs/cli/config.js

@@ -0,0 +1,173 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfigFile = loadConfigFile;
+exports.resolveSchemaPath = resolveSchemaPath;
+exports.resolveOutPath = resolveOutPath;
+exports.resolveConnection = resolveConnection;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const errors_1 = require("./errors");
+/** Discovery order — first match in the working directory wins. */
+const CONFIG_FILENAMES = [
+    'grafeo.config.ts',
+    'grafeo.config.js',
+    'grafeo.config.json',
+];
+const CONFIG_EXAMPLE = `// grafeo.config.ts
+import { defineConfig } from 'grafeo-ogm';
+
+export default defineConfig({
+  schema: './schema.graphql',
+  out: './src/grafeo.generated.ts',
+});`;
+/**
+ * Discover and load grafeo.config.{ts,js,json} from `cwd`. TS/JS configs
+ * load through jiti (the CLI's single runtime dependency) so users get
+ * `grafeo.config.ts` without pre-compiling — the same DX as Prisma/Drizzle.
+ * Returns an empty config when no file exists; commands fall back to flags
+ * and defaults.
+ */
+async function loadConfigFile(cwd) {
+    for (const name of CONFIG_FILENAMES) {
+        const filePath = path.join(cwd, name);
+        if (!fs.existsSync(filePath))
+            continue;
+        if (name.endsWith('.json'))
+            try {
+                const parsed = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+                return { config: parsed, filePath };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new errors_1.CliError(`Failed to parse ${name}: ${message}`);
+            }
+        const { createJiti } = await Promise.resolve().then(() => __importStar(require('jiti')));
+        const jiti = createJiti(__filename);
+        let loaded;
+        try {
+            loaded = await jiti.import(filePath);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new errors_1.CliError(`Failed to load ${name}: ${message}`);
+        }
+        const config = extractConfigExport(loaded, name);
+        return { config, filePath };
+    }
+    return { config: {} };
+}
+/** Keys a config object may legitimately carry. */
+const KNOWN_CONFIG_KEYS = new Set([
+    'schema',
+    'out',
+    'generate',
+    'database',
+    'seed',
+    'vectorIndexes',
+]);
+/**
+ * Pull the config object out of a jiti-loaded module. `export default {…}`
+ * arrives under `default`; CJS `module.exports = {…}` arrives as the
+ * namespace itself — accepted only when every key is a known config key,
+ * so a module that merely forgot its default export fails loudly instead
+ * of being silently treated as an (empty-ish) config.
+ */
+function extractConfigExport(loaded, name) {
+    const invalid = () => new errors_1.CliError(`${name} must export a configuration object as its default export.\n\n${CONFIG_EXAMPLE}`);
+    if (!loaded || typeof loaded !== 'object')
+        throw invalid();
+    if ('default' in loaded) {
+        const dflt = loaded.default;
+        if (!dflt || typeof dflt !== 'object')
+            throw invalid();
+        return dflt;
+    }
+    const keys = Object.keys(loaded);
+    if (keys.some((k) => !KNOWN_CONFIG_KEYS.has(k)))
+        throw invalid();
+    return loaded;
+}
+/**
+ * Resolve the SDL schema path. Precedence: flag > config > ./schema.graphql
+ * (zero-config default, only when the file actually exists). A flag/config
+ * path that doesn't exist is an error naming the resolved path; nothing at
+ * all is an error showing a minimal config example (cli-config spec).
+ */
+function resolveSchemaPath(flags, config, cwd) {
+    const declared = flags.schema ?? config.schema;
+    if (declared) {
+        const resolved = path.resolve(cwd, declared);
+        if (!fs.existsSync(resolved))
+            throw new errors_1.CliError(`Schema file not found: ${resolved}`);
+        return resolved;
+    }
+    const fallback = path.resolve(cwd, 'schema.graphql');
+    if (fs.existsSync(fallback))
+        return fallback;
+    throw new errors_1.CliError(`No schema found. Pass --schema <path>, set "schema" in grafeo.config.ts, ` +
+        `or create ./schema.graphql.\n\n${CONFIG_EXAMPLE}`);
+}
+/** Resolve the codegen output path. Precedence: flag > config > default. */
+function resolveOutPath(flags, config, cwd) {
+    return path.resolve(cwd, flags.out ?? config.out ?? 'grafeo.generated.ts');
+}
+/**
+ * Resolve the Neo4j connection per the cli-config spec. Precedence per
+ * setting: flag > config `database` block > NEO4J_* env var. The password
+ * has NO flag path by design.
+ */
+function resolveConnection(flags, config, env) {
+    const uri = flags.uri ?? config.database?.uri ?? env.NEO4J_URI;
+    const username = flags.username ?? config.database?.username ?? env.NEO4J_USERNAME;
+    const password = config.database?.password ?? env.NEO4J_PASSWORD;
+    const database = flags.database ?? config.database?.database ?? env.NEO4J_DATABASE;
+    const missing = [];
+    if (!uri)
+        missing.push('uri — pass --uri, set database.uri, or NEO4J_URI');
+    if (!username)
+        missing.push('username — pass --username, set database.username, or NEO4J_USERNAME');
+    if (!password)
+        missing.push('password — set database.password or NEO4J_PASSWORD (never a flag)');
+    if (missing.length > 0)
+        throw new errors_1.CliError(`Missing database connection settings:\n  - ${missing.join('\n  - ')}`);
+    return {
+        uri: uri,
+        username: username,
+        password: password,
+        database,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/cjs/cli/config.js.map

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

package/dist/cjs/cli/driver.d.ts

@@ -0,0 +1,12 @@
+import { type Driver } from 'neo4j-driver';
+import type { CliIO, ResolvedConnection } from './types';
+/**
+ * Obtain the driver for a db command. Production goes straight to
+ * `neo4j-driver`; tests inject a mock through `io.driverFactory` so no
+ * command ever touches a real database in the suite.
+ *
+ * Imported only by `db push` / `db seed` (themselves lazy-loaded from the
+ * router), so `grafeo generate` never pays the neo4j-driver load.
+ */
+export declare function createDriver(io: CliIO, connection: ResolvedConnection): Driver;
+//# sourceMappingURL=driver.d.ts.map

package/dist/cjs/cli/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../src/cli/driver.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,KAAK,EACT,UAAU,EAAE,kBAAkB,GAC7B,MAAM,CAMR"}

package/dist/cjs/cli/driver.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDriver = createDriver;
+const neo4j_driver_1 = __importDefault(require("neo4j-driver"));
+/**
+ * Obtain the driver for a db command. Production goes straight to
+ * `neo4j-driver`; tests inject a mock through `io.driverFactory` so no
+ * command ever touches a real database in the suite.
+ *
+ * Imported only by `db push` / `db seed` (themselves lazy-loaded from the
+ * router), so `grafeo generate` never pays the neo4j-driver load.
+ */
+function createDriver(io, connection) {
+    if (io.driverFactory)
+        return io.driverFactory(connection);
+    return neo4j_driver_1.default.driver(connection.uri, neo4j_driver_1.default.auth.basic(connection.username, connection.password));
+}
+//# sourceMappingURL=driver.js.map