@danceroutine/tango-codegen 1.4.0 → 1.5.0

package/dist/commands/index.d.ts

@@ -2,3 +2,5 @@
  * Domain boundary barrel: centralizes this subdomain's public contract.
  */
 export { registerCodegenCommands } from './registerCodegenCommands';
+export { loadProjectModule } from './loadProjectModule';
+export { runGenerateRelationsCommand, withGenerateRelationsCommand } from './runGenerateRelationsCommand';

package/dist/commands/index.js

@@ -1,4 +1,5 @@
-import "../frameworks-Dfcrg0ZQ.js";
-import { registerCodegenCommands } from "../commands-lJSW2Kuf.js";
+import "../relations-uMuViSQC.js";
+import "../frameworks-CLOeazGj.js";
+import { loadProjectModule, registerCodegenCommands, runGenerateRelationsCommand, withGenerateRelationsCommand } from "../commands-CFAq4wXC.js";
 
-export { registerCodegenCommands };
+export { loadProjectModule, registerCodegenCommands, runGenerateRelationsCommand, withGenerateRelationsCommand };

package/dist/commands/loadProjectModule.d.ts

@@ -0,0 +1,15 @@
+import { ModelRegistry } from '@danceroutine/tango-schema';
+type ProjectModuleLoadResult = {
+    loaded: Record<string, unknown>;
+    modelTypeAccessors: Record<string, string>;
+    registry: ModelRegistry;
+};
+/**
+ * Load a Tango app module and discover model export accessors suitable for
+ * generated ambient type references.
+ */
+export declare function loadProjectModule(modulePath: string, options?: {
+    projectRoot?: string;
+    outputDir?: string;
+}): Promise<ProjectModuleLoadResult>;
+export {};

package/dist/commands/runGenerateRelationsCommand.d.ts

@@ -0,0 +1,11 @@
+import type { Argv } from 'yargs';
+type GenerateRelationsCommandArgs = {
+    models: string;
+    outDir: string;
+};
+/**
+ * Generate the app-local ambient relation registry from a finalized model graph.
+ */
+export declare function runGenerateRelationsCommand({ models, outDir }: GenerateRelationsCommandArgs): Promise<void>;
+export declare function withGenerateRelationsCommand(parser: Argv): Argv;
+export {};

package/dist/commands-CFAq4wXC.js

@@ -0,0 +1,297 @@
+import { __export } from "./chunk-BkvOhyD0.js";
+import { writeRelationRegistryArtifacts } from "./relations-uMuViSQC.js";
+import { FrameworkScaffoldRegistry, PACKAGE_MANAGER, SCAFFOLD_DATABASE_DIALECT, SUPPORTED_FRAMEWORK, scaffoldProject } from "./frameworks-CLOeazGj.js";
+import { GENERATED_RELATION_REGISTRY_DIRNAME, GENERATED_RELATION_REGISTRY_METADATA_FILENAME, GENERATED_RELATION_REGISTRY_TYPES_FILENAME, ModelRegistry } from "@danceroutine/tango-schema";
+import { extname, relative, resolve as resolve$1, resolve as resolve$2 } from "node:path";
+import { getLogger, getLogger as getLogger$1, getLogger as getLogger$2 } from "@danceroutine/tango-core";
+import { basename, basename as basename$1, join, resolve, resolve as resolve$3 } from "path/posix";
+import { spawnSync } from "child_process";
+import { pathToFileURL } from "node:url";
+import { createJiti } from "jiti";
+import { readFile, readdir } from "fs/promises";
+
+//#region src/commands/runInstall.ts
+function runInstall(packageManager, cwd) {
+	const argsByPackageManager = {
+		pnpm: ["install"],
+		npm: ["install"],
+		yarn: ["install"],
+		bun: ["install"]
+	};
+	const result = spawnSync(packageManager, [...argsByPackageManager[packageManager]], {
+		cwd,
+		stdio: "inherit",
+		env: process.env
+	});
+	if (result.status !== 0) throw new Error(`Dependency install failed with ${packageManager}. Exit code: ${String(result.status ?? "unknown")}.`);
+}
+
+//#endregion
+//#region src/commands/runNewCommand.ts
+async function runNewCommand({ path, name, framework, packageManager, dialect, install, force, seed: includeSeed }) {
+	const registry = FrameworkScaffoldRegistry.createDefault();
+	const strategy = registry.get(framework);
+	const requestedPath = path ?? name ?? "tango-app";
+	const projectName = name ?? basename$1(requestedPath);
+	const targetDir = resolve$3(process.cwd(), requestedPath);
+	const context = {
+		projectName,
+		targetDir,
+		framework,
+		packageManager,
+		dialect,
+		includeSeed
+	};
+	await scaffoldProject(context, strategy, { force });
+	if (install) runInstall(packageManager, targetDir);
+	const logger$1 = getLogger$2("tango.codegen");
+	logger$1.info(`Scaffold complete: ${targetDir}`);
+	logger$1.info(`Framework: ${strategy.name}`);
+	logger$1.info(`Run next: cd ${targetDir} && ${packageManager} run dev`);
+}
+function withNewCommand(parser) {
+	return parser.command("new [name]", "Bootstrap a new Tango project", (builder) => builder.positional("name", {
+		type: "string",
+		describe: "Project name (used as directory when --path is omitted)."
+	}).option("framework", {
+		type: "string",
+		choices: Object.values(SUPPORTED_FRAMEWORK),
+		demandOption: true,
+		describe: "Host framework scaffold to generate."
+	}).option("path", {
+		type: "string",
+		describe: "Target directory for generated project files."
+	}).option("package-manager", {
+		type: "string",
+		choices: Object.values(PACKAGE_MANAGER),
+		default: PACKAGE_MANAGER.PNPM,
+		describe: "Package manager used for follow-up instructions and optional install."
+	}).option("dialect", {
+		type: "string",
+		choices: Object.values(SCAFFOLD_DATABASE_DIALECT),
+		default: SCAFFOLD_DATABASE_DIALECT.SQLITE,
+		describe: "Database dialect default for generated config."
+	}).option("install", {
+		type: "boolean",
+		default: false,
+		describe: "Install dependencies after scaffolding."
+	}).option("force", {
+		type: "boolean",
+		default: false,
+		describe: "Allow writing into a non-empty target directory."
+	}).option("seed", {
+		type: "boolean",
+		default: true,
+		describe: "Include seed/bootstrap sample artifacts when supported by the framework strategy."
+	}), async ({ name, framework, path, packageManager, dialect, install, force, seed }) => {
+		await runNewCommand({
+			name,
+			framework,
+			path,
+			packageManager,
+			dialect,
+			install,
+			force,
+			seed
+		});
+	});
+}
+
+//#endregion
+//#region src/commands/loadProjectModule.ts
+const TS_EXTENSIONS = new Set([
+	".ts",
+	".tsx",
+	".mts",
+	".cts"
+]);
+function isTypeScriptModule(modulePath) {
+	return TS_EXTENSIONS.has(extname(modulePath).toLowerCase());
+}
+function isModelLike(value) {
+	return typeof value === "object" && value !== null && "metadata" in value && typeof value.metadata?.key === "string";
+}
+function toImportSpecifier(absoluteModulePath, outputDir) {
+	const relativePath = relative(outputDir, absoluteModulePath).replaceAll("\\", "/");
+	return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
+}
+function collectModelTypeAccessors(loaded, importSpecifier, accessors = new Map()) {
+	const models = [];
+	const registerAccessor = (model, accessor) => {
+		models.push(model);
+		const existing = accessors.get(model.metadata.key);
+		if (!existing || accessor.length < existing.length) accessors.set(model.metadata.key, accessor);
+	};
+	const inspectValue = (value, accessorSegments) => {
+		if (isModelLike(value)) {
+			const accessor = accessorSegments.map((segment) => `[${JSON.stringify(segment)}]`).join("");
+			registerAccessor(value, `typeof import(${JSON.stringify(importSpecifier)})${accessor}`);
+			return;
+		}
+		if (typeof value !== "object" || value === null) return;
+		for (const [key, nested] of Object.entries(value)) if (isModelLike(nested)) {
+			const accessor = [...accessorSegments, key].map((segment) => `[${JSON.stringify(segment)}]`).join("");
+			registerAccessor(nested, `typeof import(${JSON.stringify(importSpecifier)})${accessor}`);
+		}
+	};
+	for (const [key, value] of Object.entries(loaded)) inspectValue(value, [key]);
+	return {
+		accessors: Object.fromEntries(accessors),
+		models
+	};
+}
+async function loadProjectModule(modulePath, options) {
+	const projectRoot = options?.projectRoot ?? process.cwd();
+	const absoluteModulePath = resolve$2(projectRoot, modulePath);
+	const outputDir = options?.outputDir ?? resolve$2(projectRoot, ".tango");
+	const registry = new ModelRegistry();
+	const executeImport = async () => {
+		if (isTypeScriptModule(absoluteModulePath)) {
+			const jiti = createJiti(resolve$2(projectRoot, "tango.config.ts"), {
+				interopDefault: true,
+				moduleCache: false
+			});
+			return await jiti.import(absoluteModulePath);
+		}
+		return await import(pathToFileURL(absoluteModulePath).href);
+	};
+	const loaded = await ModelRegistry.runWithRegistry(registry, executeImport);
+	const collected = collectModelTypeAccessors(loaded, toImportSpecifier(absoluteModulePath, outputDir));
+	const effectiveRegistry = registry.values().length > 0 ? registry : collected.models.length > 0 ? ModelRegistry.getOwner(collected.models[0]) : registry;
+	return {
+		loaded,
+		modelTypeAccessors: collected.accessors,
+		registry: effectiveRegistry
+	};
+}
+
+//#endregion
+//#region src/commands/runGenerateRelationsCommand.ts
+const logger = getLogger$1("tango.codegen");
+async function runGenerateRelationsCommand({ models, outDir }) {
+	const outputDir = resolve$1(process.cwd(), outDir);
+	const { registry, modelTypeAccessors } = await loadProjectModule(models, { outputDir });
+	const written = await writeRelationRegistryArtifacts({
+		registry,
+		modelTypeAccessors,
+		outputDir
+	});
+	logger.info(`Generated relation registry: ${written.typesFilepath}`);
+	logger.info(`Generated relation metadata: ${written.metadataFilepath}`);
+}
+function withGenerateRelationsCommand(parser) {
+	return parser.command("relations", "Generate app-local ambient relation typing from Tango models", (builder) => builder.option("models", {
+		type: "string",
+		demandOption: true,
+		describe: "Path to the module exporting Tango Model definitions."
+	}).option("out-dir", {
+		type: "string",
+		default: GENERATED_RELATION_REGISTRY_DIRNAME,
+		describe: `Directory that receives ${GENERATED_RELATION_REGISTRY_TYPES_FILENAME} and ${GENERATED_RELATION_REGISTRY_METADATA_FILENAME}.`
+	}), async ({ models, outDir }) => {
+		await runGenerateRelationsCommand({
+			models,
+			outDir
+		});
+	});
+}
+
+//#endregion
+//#region src/commands/runInitCommand.ts
+async function detectPackageManager(targetDir) {
+	try {
+		const entries = await readdir(targetDir);
+		if (entries.includes("pnpm-lock.yaml")) return PACKAGE_MANAGER.PNPM;
+		if (entries.includes("package-lock.json")) return PACKAGE_MANAGER.NPM;
+		if (entries.includes("yarn.lock")) return PACKAGE_MANAGER.YARN;
+		if (entries.includes("bun.lockb") || entries.includes("bun.lock")) return PACKAGE_MANAGER.BUN;
+	} catch {}
+	return PACKAGE_MANAGER.PNPM;
+}
+async function runInitCommand({ framework, path, dialect, skipExisting, force }) {
+	const registry = FrameworkScaffoldRegistry.createDefault();
+	const strategy = registry.get(framework);
+	const targetDir = resolve(process.cwd(), path);
+	let projectName = basename(targetDir);
+	try {
+		const pkgPath = join(targetDir, "package.json");
+		const raw = await readFile(pkgPath, "utf8");
+		const pkg = JSON.parse(raw);
+		if (typeof pkg.name === "string" && pkg.name.length > 0) projectName = pkg.name;
+	} catch {}
+	const packageManager = await detectPackageManager(targetDir);
+	const context = {
+		projectName,
+		targetDir,
+		framework,
+		packageManager,
+		dialect,
+		includeSeed: true
+	};
+	await scaffoldProject(context, strategy, {
+		mode: "init",
+		skipExisting,
+		force
+	});
+	const logger$1 = getLogger("tango.codegen");
+	logger$1.info(`Tango init complete: ${targetDir}`);
+	logger$1.info(`Install dependencies: ${strategy.getTangoInstallOneLiner(packageManager, context)}`);
+	if (framework === SUPPORTED_FRAMEWORK.EXPRESS) logger$1.info("Mount Tango: import { registerTango } from './src/tango.js'; await registerTango(app);");
+	if (framework === SUPPORTED_FRAMEWORK.NUXT) logger$1.info("Wire Tango handlers: register Nitro serverHandlers in nuxt.config.ts and export NuxtAdapter-backed handlers from server/tango/.");
+}
+function withInitCommand(parser) {
+	return parser.command("init", "Add Tango to an existing project (only Tango-layer files)", (builder) => builder.option("framework", {
+		type: "string",
+		choices: Object.values(SUPPORTED_FRAMEWORK),
+		demandOption: true,
+		describe: "Host framework (express, next, or nuxt)."
+	}).option("path", {
+		type: "string",
+		default: ".",
+		describe: "Target directory (default: current directory)."
+	}).option("dialect", {
+		type: "string",
+		choices: Object.values(SCAFFOLD_DATABASE_DIALECT),
+		default: SCAFFOLD_DATABASE_DIALECT.SQLITE,
+		describe: "Database dialect for generated config."
+	}).option("skip-existing", {
+		type: "boolean",
+		default: true,
+		describe: "Do not overwrite existing files."
+	}).option("force", {
+		type: "boolean",
+		default: false,
+		describe: "Overwrite existing files when set."
+	}), async ({ framework, path, dialect, skipExisting, force }) => {
+		await runInitCommand({
+			framework,
+			path,
+			dialect,
+			skipExisting,
+			force
+		});
+	});
+}
+
+//#endregion
+//#region src/commands/registerCodegenCommands.ts
+function registerCodegenCommands(parser) {
+	const withTopLevelNew = withNewCommand(parser);
+	const withTopLevelInit = withInitCommand(withTopLevelNew);
+	const withTopLevelRelations = withGenerateRelationsCommand(withTopLevelInit);
+	return withTopLevelRelations.command("codegen <command>", "Code generation command group", (builder) => withGenerateRelationsCommand(withInitCommand(withNewCommand(builder))));
+}
+
+//#endregion
+//#region src/commands/index.ts
+var commands_exports = {};
+__export(commands_exports, {
+	loadProjectModule: () => loadProjectModule,
+	registerCodegenCommands: () => registerCodegenCommands,
+	runGenerateRelationsCommand: () => runGenerateRelationsCommand,
+	withGenerateRelationsCommand: () => withGenerateRelationsCommand
+});
+
+//#endregion
+export { commands_exports, loadProjectModule, registerCodegenCommands, runGenerateRelationsCommand, withGenerateRelationsCommand };
+//# sourceMappingURL=commands-CFAq4wXC.js.map

package/dist/commands-CFAq4wXC.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-CFAq4wXC.js","names":["packageManager: PackageManager","cwd: string","argsByPackageManager: Record<PackageManager, readonly string[]>","context: FrameworkScaffoldContext","parser: Argv","modulePath: string","value: unknown","absoluteModulePath: string","outputDir: string","loaded: Record<string, unknown>","importSpecifier: string","accessors: Map<string, string>","models: ModelLike[]","model: ModelLike","accessor: string","accessorSegments: readonly string[]","options?: { projectRoot?: string; outputDir?: string }","parser: Argv","targetDir: string","context: FrameworkScaffoldContext","parser: Argv","parser: Argv"],"sources":["../src/commands/runInstall.ts","../src/commands/runNewCommand.ts","../src/commands/loadProjectModule.ts","../src/commands/runGenerateRelationsCommand.ts","../src/commands/runInitCommand.ts","../src/commands/registerCodegenCommands.ts","../src/commands/index.ts"],"sourcesContent":["import { spawnSync } from 'child_process';\nimport type { PackageManager } from '../frameworks';\n\nexport function runInstall(packageManager: PackageManager, cwd: string): void {\n    const argsByPackageManager: Record<PackageManager, readonly string[]> = {\n        pnpm: ['install'],\n        npm: ['install'],\n        yarn: ['install'],\n        bun: ['install'],\n    };\n\n    const result = spawnSync(packageManager, [...argsByPackageManager[packageManager]], {\n        cwd,\n        stdio: 'inherit',\n        env: process.env,\n    });\n\n    if (result.status !== 0) {\n        throw new Error(\n            `Dependency install failed with ${packageManager}. Exit code: ${String(result.status ?? 'unknown')}.`\n        );\n    }\n}\n","import { getLogger } from '@danceroutine/tango-core';\nimport { basename, resolve } from 'path/posix';\nimport {\n    type SupportedFramework,\n    type PackageManager,\n    FrameworkScaffoldRegistry,\n    type FrameworkScaffoldContext,\n    scaffoldProject,\n} from '../frameworks';\nimport {\n    PACKAGE_MANAGER,\n    SCAFFOLD_DATABASE_DIALECT,\n    SUPPORTED_FRAMEWORK,\n    type ScaffoldDatabaseDialect,\n} from '../frameworks/contracts/FrameworkScaffoldStrategy';\nimport { runInstall } from './runInstall';\nimport type { Argv } from 'yargs';\n\ntype NewCommandArgs = {\n    name?: string;\n    framework: SupportedFramework;\n    path?: string;\n    packageManager: PackageManager;\n    dialect: ScaffoldDatabaseDialect;\n    install: boolean;\n    force: boolean;\n    seed: boolean;\n};\nexport async function runNewCommand({\n    path,\n    name,\n    framework,\n    packageManager,\n    dialect,\n    install,\n    force,\n    seed: includeSeed,\n}: NewCommandArgs): Promise<void> {\n    const registry = FrameworkScaffoldRegistry.createDefault();\n    const strategy = registry.get(framework)!;\n\n    const requestedPath = path ?? name ?? 'tango-app';\n    const projectName = name ?? basename(requestedPath);\n    const targetDir = resolve(process.cwd(), requestedPath);\n\n    const context: FrameworkScaffoldContext = {\n        projectName,\n        targetDir,\n        framework,\n        packageManager,\n        dialect,\n        includeSeed,\n    };\n\n    await scaffoldProject(context, strategy, { force });\n\n    if (install) {\n        runInstall(packageManager, targetDir);\n    }\n\n    const logger = getLogger('tango.codegen');\n    logger.info(`Scaffold complete: ${targetDir}`);\n    logger.info(`Framework: ${strategy.name}`);\n    logger.info(`Run next: cd ${targetDir} && ${packageManager} run dev`);\n}\nexport function withNewCommand(parser: Argv): Argv {\n    return parser.command(\n        'new [name]',\n        'Bootstrap a new Tango project',\n        (builder) =>\n            builder\n                .positional('name', {\n                    type: 'string',\n                    describe: 'Project name (used as directory when --path is omitted).',\n                })\n                .option('framework', {\n                    type: 'string',\n                    choices: Object.values(SUPPORTED_FRAMEWORK),\n                    demandOption: true,\n                    describe: 'Host framework scaffold to generate.',\n                })\n                .option('path', {\n                    type: 'string',\n                    describe: 'Target directory for generated project files.',\n                })\n                .option('package-manager', {\n                    type: 'string',\n                    choices: Object.values(PACKAGE_MANAGER),\n                    default: PACKAGE_MANAGER.PNPM,\n                    describe: 'Package manager used for follow-up instructions and optional install.',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: Object.values(SCAFFOLD_DATABASE_DIALECT),\n                    default: SCAFFOLD_DATABASE_DIALECT.SQLITE,\n                    describe: 'Database dialect default for generated config.',\n                })\n                .option('install', {\n                    type: 'boolean',\n                    default: false,\n                    describe: 'Install dependencies after scaffolding.',\n                })\n                .option('force', {\n                    type: 'boolean',\n                    default: false,\n                    describe: 'Allow writing into a non-empty target directory.',\n                })\n                .option('seed', {\n                    type: 'boolean',\n                    default: true,\n                    describe: 'Include seed/bootstrap sample artifacts when supported by the framework strategy.',\n                }),\n        async ({ name, framework, path, packageManager, dialect, install, force, seed }) => {\n            await runNewCommand({\n                name,\n                framework,\n                path,\n                packageManager,\n                dialect,\n                install,\n                force,\n                seed,\n            });\n        }\n    );\n}\n","import { extname, relative, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\nimport { createJiti } from 'jiti';\nimport { ModelRegistry } from '@danceroutine/tango-schema';\n\nconst TS_EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.cts']);\n\ntype ProjectModuleLoadResult = {\n    loaded: Record<string, unknown>;\n    modelTypeAccessors: Record<string, string>;\n    registry: ModelRegistry;\n};\n\ntype ModelLike = { metadata: { key: string } };\ntype CollectedModelAccessors = {\n    accessors: Record<string, string>;\n    models: ModelLike[];\n};\n\nfunction isTypeScriptModule(modulePath: string): boolean {\n    return TS_EXTENSIONS.has(extname(modulePath).toLowerCase());\n}\n\nfunction isModelLike(value: unknown): value is ModelLike {\n    return (\n        typeof value === 'object' &&\n        value !== null &&\n        'metadata' in value &&\n        typeof (value as { metadata?: { key?: unknown } }).metadata?.key === 'string'\n    );\n}\n\nfunction toImportSpecifier(absoluteModulePath: string, outputDir: string): string {\n    const relativePath = relative(outputDir, absoluteModulePath).replaceAll('\\\\', '/');\n    return relativePath.startsWith('.') ? relativePath : `./${relativePath}`;\n}\n\nfunction collectModelTypeAccessors(\n    loaded: Record<string, unknown>,\n    importSpecifier: string,\n    accessors: Map<string, string> = new Map()\n): CollectedModelAccessors {\n    const models: ModelLike[] = [];\n\n    const registerAccessor = (model: ModelLike, accessor: string): void => {\n        models.push(model);\n        const existing = accessors.get(model.metadata.key);\n        if (!existing || accessor.length < existing.length) {\n            accessors.set(model.metadata.key, accessor);\n        }\n    };\n\n    const inspectValue = (value: unknown, accessorSegments: readonly string[]): void => {\n        if (isModelLike(value)) {\n            const accessor = accessorSegments.map((segment) => `[${JSON.stringify(segment)}]`).join('');\n            registerAccessor(value, `typeof import(${JSON.stringify(importSpecifier)})${accessor}`);\n            return;\n        }\n\n        if (typeof value !== 'object' || value === null) {\n            return;\n        }\n\n        for (const [key, nested] of Object.entries(value)) {\n            if (isModelLike(nested)) {\n                const accessor = [...accessorSegments, key].map((segment) => `[${JSON.stringify(segment)}]`).join('');\n                registerAccessor(nested, `typeof import(${JSON.stringify(importSpecifier)})${accessor}`);\n            }\n        }\n    };\n\n    for (const [key, value] of Object.entries(loaded)) {\n        inspectValue(value, [key]);\n    }\n\n    return {\n        accessors: Object.fromEntries(accessors),\n        models,\n    };\n}\n\n/**\n * Load a Tango app module and discover model export accessors suitable for\n * generated ambient type references.\n */\nexport async function loadProjectModule(\n    modulePath: string,\n    options?: { projectRoot?: string; outputDir?: string }\n): Promise<ProjectModuleLoadResult> {\n    const projectRoot = options?.projectRoot ?? process.cwd();\n    const absoluteModulePath = resolve(projectRoot, modulePath);\n    const outputDir = options?.outputDir ?? resolve(projectRoot, '.tango');\n    const registry = new ModelRegistry();\n\n    const executeImport = async (): Promise<Record<string, unknown>> => {\n        if (isTypeScriptModule(absoluteModulePath)) {\n            const jiti = createJiti(resolve(projectRoot, 'tango.config.ts'), {\n                interopDefault: true,\n                moduleCache: false,\n            });\n            return (await jiti.import<Record<string, unknown>>(absoluteModulePath)) as Record<string, unknown>;\n        }\n\n        return (await import(pathToFileURL(absoluteModulePath).href)) as Record<string, unknown>;\n    };\n\n    const loaded = await ModelRegistry.runWithRegistry(registry, executeImport);\n    const collected = collectModelTypeAccessors(loaded, toImportSpecifier(absoluteModulePath, outputDir));\n    const effectiveRegistry =\n        registry.values().length > 0\n            ? registry\n            : collected.models.length > 0\n              ? (ModelRegistry.getOwner(collected.models[0] as never) as ModelRegistry)\n              : registry;\n\n    return {\n        loaded,\n        modelTypeAccessors: collected.accessors,\n        registry: effectiveRegistry,\n    };\n}\n","import { resolve } from 'node:path';\nimport { getLogger } from '@danceroutine/tango-core';\nimport {\n    GENERATED_RELATION_REGISTRY_DIRNAME,\n    GENERATED_RELATION_REGISTRY_METADATA_FILENAME,\n    GENERATED_RELATION_REGISTRY_TYPES_FILENAME,\n} from '@danceroutine/tango-schema';\nimport type { Argv } from 'yargs';\nimport { writeRelationRegistryArtifacts } from '../generators/relations';\nimport { loadProjectModule } from './loadProjectModule';\n\nconst logger = getLogger('tango.codegen');\n\ntype GenerateRelationsCommandArgs = {\n    models: string;\n    outDir: string;\n};\n\n/**\n * Generate the app-local ambient relation registry from a finalized model graph.\n */\nexport async function runGenerateRelationsCommand({ models, outDir }: GenerateRelationsCommandArgs): Promise<void> {\n    const outputDir = resolve(process.cwd(), outDir);\n    const { registry, modelTypeAccessors } = await loadProjectModule(models, { outputDir });\n    const written = await writeRelationRegistryArtifacts({\n        registry,\n        modelTypeAccessors,\n        outputDir,\n    });\n\n    logger.info(`Generated relation registry: ${written.typesFilepath}`);\n    logger.info(`Generated relation metadata: ${written.metadataFilepath}`);\n}\n\nexport function withGenerateRelationsCommand(parser: Argv): Argv {\n    return parser.command(\n        'relations',\n        'Generate app-local ambient relation typing from Tango models',\n        (builder) =>\n            builder\n                .option('models', {\n                    type: 'string',\n                    demandOption: true,\n                    describe: 'Path to the module exporting Tango Model definitions.',\n                })\n                .option('out-dir', {\n                    type: 'string',\n                    default: GENERATED_RELATION_REGISTRY_DIRNAME,\n                    describe: `Directory that receives ${GENERATED_RELATION_REGISTRY_TYPES_FILENAME} and ${GENERATED_RELATION_REGISTRY_METADATA_FILENAME}.`,\n                }),\n        async ({ models, outDir }) => {\n            await runGenerateRelationsCommand({\n                models,\n                outDir,\n            });\n        }\n    );\n}\n","import { getLogger } from '@danceroutine/tango-core';\nimport { readdir, readFile } from 'fs/promises';\nimport { resolve, basename, join } from 'path/posix';\nimport {\n    type PackageManager,\n    type SupportedFramework,\n    FrameworkScaffoldRegistry,\n    type FrameworkScaffoldContext,\n    scaffoldProject,\n} from '../frameworks';\nimport {\n    PACKAGE_MANAGER,\n    SCAFFOLD_DATABASE_DIALECT,\n    type ScaffoldDatabaseDialect,\n    SUPPORTED_FRAMEWORK,\n} from '../frameworks/contracts/FrameworkScaffoldStrategy';\nimport type { Argv } from 'yargs';\n\nasync function detectPackageManager(targetDir: string): Promise<PackageManager> {\n    try {\n        const entries = await readdir(targetDir);\n        if (entries.includes('pnpm-lock.yaml')) return PACKAGE_MANAGER.PNPM;\n        if (entries.includes('package-lock.json')) return PACKAGE_MANAGER.NPM;\n        if (entries.includes('yarn.lock')) return PACKAGE_MANAGER.YARN;\n        if (entries.includes('bun.lockb') || entries.includes('bun.lock')) return PACKAGE_MANAGER.BUN;\n    } catch {\n        // ENOENT or other: fall through to default\n    }\n    return PACKAGE_MANAGER.PNPM;\n}\ntype InitCommandArgs = {\n    framework: SupportedFramework;\n    path: string;\n    dialect: ScaffoldDatabaseDialect;\n    skipExisting: boolean;\n    force: boolean;\n};\nexport async function runInitCommand({\n    framework,\n    path,\n    dialect,\n    skipExisting,\n    force,\n}: InitCommandArgs): Promise<void> {\n    const registry = FrameworkScaffoldRegistry.createDefault();\n    const strategy = registry.get(framework)!;\n    const targetDir = resolve(process.cwd(), path);\n\n    let projectName = basename(targetDir);\n    try {\n        const pkgPath = join(targetDir, 'package.json');\n        const raw = await readFile(pkgPath, 'utf8');\n        const pkg = JSON.parse(raw) as { name?: string };\n        if (typeof pkg.name === 'string' && pkg.name.length > 0) {\n            projectName = pkg.name;\n        }\n    } catch {\n        // no package.json or invalid: keep basename\n    }\n\n    const packageManager = await detectPackageManager(targetDir);\n\n    const context: FrameworkScaffoldContext = {\n        projectName,\n        targetDir,\n        framework,\n        packageManager,\n        dialect,\n        includeSeed: true,\n    };\n\n    await scaffoldProject(context, strategy, {\n        mode: 'init',\n        skipExisting,\n        force,\n    });\n\n    const logger = getLogger('tango.codegen');\n    logger.info(`Tango init complete: ${targetDir}`);\n    logger.info(`Install dependencies: ${strategy.getTangoInstallOneLiner(packageManager, context)}`);\n    if (framework === SUPPORTED_FRAMEWORK.EXPRESS) {\n        logger.info(\"Mount Tango: import { registerTango } from './src/tango.js'; await registerTango(app);\");\n    }\n    if (framework === SUPPORTED_FRAMEWORK.NUXT) {\n        logger.info(\n            'Wire Tango handlers: register Nitro serverHandlers in nuxt.config.ts and export NuxtAdapter-backed handlers from server/tango/.'\n        );\n    }\n}\nexport function withInitCommand(parser: Argv): Argv {\n    return parser.command(\n        'init',\n        'Add Tango to an existing project (only Tango-layer files)',\n        (builder) =>\n            builder\n                .option('framework', {\n                    type: 'string',\n                    choices: Object.values(SUPPORTED_FRAMEWORK),\n                    demandOption: true,\n                    describe: 'Host framework (express, next, or nuxt).',\n                })\n                .option('path', {\n                    type: 'string',\n                    default: '.',\n                    describe: 'Target directory (default: current directory).',\n                })\n                .option('dialect', {\n                    type: 'string',\n                    choices: Object.values(SCAFFOLD_DATABASE_DIALECT),\n                    default: SCAFFOLD_DATABASE_DIALECT.SQLITE,\n                    describe: 'Database dialect for generated config.',\n                })\n                .option('skip-existing', {\n                    type: 'boolean',\n                    default: true,\n                    describe: 'Do not overwrite existing files.',\n                })\n                .option('force', {\n                    type: 'boolean',\n                    default: false,\n                    describe: 'Overwrite existing files when set.',\n                }),\n        async ({ framework, path, dialect, skipExisting, force }) => {\n            await runInitCommand({\n                framework,\n                path,\n                dialect,\n                skipExisting,\n                force,\n            });\n        }\n    );\n}\n","import type { Argv } from 'yargs';\nimport { withNewCommand } from './runNewCommand';\nimport { withGenerateRelationsCommand } from './runGenerateRelationsCommand';\nimport { withInitCommand } from './runInitCommand';\n\n/**\n * Register Tango project scaffolding commands on an existing CLI parser.\n */\nexport function registerCodegenCommands(parser: Argv): Argv {\n    const withTopLevelNew = withNewCommand(parser);\n    const withTopLevelInit = withInitCommand(withTopLevelNew);\n    const withTopLevelRelations = withGenerateRelationsCommand(withTopLevelInit);\n    return withTopLevelRelations.command('codegen <command>', 'Code generation command group', (builder) =>\n        withGenerateRelationsCommand(withInitCommand(withNewCommand(builder)))\n    );\n}\n","/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { registerCodegenCommands } from './registerCodegenCommands';\nexport { loadProjectModule } from './loadProjectModule';\nexport { runGenerateRelationsCommand, withGenerateRelationsCommand } from './runGenerateRelationsCommand';\n"],"mappings":"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"}

package/dist/frameworks/index.js

@@ -1,3 +1,3 @@
-import { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, FrameworkScaffoldStrategy, NextScaffoldStrategy, NuxtScaffoldStrategy, SCAFFOLD_TEMPLATE_CATEGORY, ScaffoldTemplateDescriptor, scaffoldProject } from "../frameworks-Dfcrg0ZQ.js";
+import { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, FrameworkScaffoldStrategy, NextScaffoldStrategy, NuxtScaffoldStrategy, SCAFFOLD_TEMPLATE_CATEGORY, ScaffoldTemplateDescriptor, scaffoldProject } from "../frameworks-CLOeazGj.js";
 
 export { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, FrameworkScaffoldStrategy, NextScaffoldStrategy, NuxtScaffoldStrategy, SCAFFOLD_TEMPLATE_CATEGORY, ScaffoldTemplateDescriptor, scaffoldProject };

package/dist/{frameworks-Dfcrg0ZQ.js → frameworks-CLOeazGj.js}

@@ -31,7 +31,7 @@ var ScaffoldTemplateDescriptor = class {
 //#endregion
 //#region package.json
 var name = "@danceroutine/tango-codegen";
-var version$1 = "1.4.0";
+var version$1 = "1.5.0";
 var description = "CLI for generating repositories, types, migrations, and OpenAPI specs for Tango";
 var type = "module";
 var main = "./dist/index.js";
@@ -83,14 +83,18 @@ var repository = {
 };
 var dependencies = {
 	"@danceroutine/tango-core": "workspace:*",
+	"@danceroutine/tango-schema": "workspace:*",
+	"jiti": "^2.6.1",
 	"yargs": "^17.7.2"
 };
 var devDependencies = {
+	"@danceroutine/tango-testing": "workspace:*",
 	"@types/yargs": "^17.0.33",
 	"@types/node": "^22.9.0",
 	"tsdown": "^0.4.0",
 	"typescript": "^5.6.3",
-	"vitest": "^4.0.6"
+	"vitest": "^4.0.6",
+	"zod": "^4.0.0"
 };
 var package_default = {
 	name,
@@ -248,6 +252,7 @@ var PackageJsonTemplateBuilder$2 = class extends TemplateBuilder {
 				typecheck: "tsc --noEmit",
 				"setup:schema": "node -e \"require('node:fs').mkdirSync('./.data',{recursive:true})\" && tango migrate --config ./tango.config.ts",
 				"make:migrations": "tango make:migrations --config ./tango.config.ts --models ./src/models/index.ts --name \"\${npm_config_name:-manual_change}\"",
+				"codegen:relations": "tango codegen relations --models ./src/models/index.ts",
 				prebootstrap: "node -e \"require('node:fs').mkdirSync('./.data',{recursive:true})\" && tango migrate --config ./tango.config.ts",
 				bootstrap: "tsx src/bootstrap.ts"
 			},
@@ -649,10 +654,13 @@ ${context.packageManager} run make:migrations --name initial
 ${context.packageManager} run dev
 \`\`\`
 
+\`make:migrations\` also refreshes the generated relation registry for the scaffolded model module. If you later change relation metadata without needing a new migration file, run \`${context.packageManager} run codegen:relations\`.
+
 ## Scripts
 
 - \`${context.packageManager} run dev\`
 - \`${context.packageManager} run make:migrations --name add_field\`
+- \`${context.packageManager} run codegen:relations\`
 - \`${context.packageManager} run setup:schema\`
 - \`${context.packageManager} run bootstrap\`
 - \`${context.packageManager} run typecheck\`
@@ -673,6 +681,7 @@ ${context.packageManager} run dev
 - \`src/openapi.ts\` OpenAPI document generation
 - \`src/bootstrap.ts\` seed utility for a larger demo dataset
 - \`migrations/\` checked-in Tango migrations
+- \`.tango/\` generated relation typing artifacts
 `;
 	}
 };
@@ -757,6 +766,7 @@ var PackageJsonTemplateBuilder$1 = class extends TemplateBuilder {
 				typecheck: "tsc --noEmit",
 				"setup:schema": "node -e \"require('node:fs').mkdirSync('./.data',{recursive:true})\" && tango migrate --config ./tango.config.ts",
 				"make:migrations": "tango make:migrations --config ./tango.config.ts --models ./src/lib/models/index.ts --name \"\${npm_config_name:-manual_change}\"",
+				"codegen:relations": "tango codegen relations --models ./src/lib/models/index.ts",
 				prebootstrap: "node -e \"require('node:fs').mkdirSync('./.data',{recursive:true})\" && tango migrate --config ./tango.config.ts",
 				bootstrap: "tsx scripts/bootstrap.ts"
 			},
@@ -1205,10 +1215,13 @@ ${context.packageManager} run make:migrations --name initial
 ${context.packageManager} run dev
 \`\`\`
 
+\`make:migrations\` also refreshes the generated relation registry for the scaffolded model module. If you later change relation metadata without needing a new migration file, run \`${context.packageManager} run codegen:relations\`.
+
 ## Scripts
 
 - \`${context.packageManager} run dev\`
 - \`${context.packageManager} run make:migrations --name add_field\`
+- \`${context.packageManager} run codegen:relations\`
 - \`${context.packageManager} run setup:schema\`
 - \`${context.packageManager} run bootstrap\`
 - \`${context.packageManager} run typecheck\`
@@ -1230,6 +1243,7 @@ ${context.packageManager} run dev
 - \`src/lib/openapi.ts\` OpenAPI document generation
 - \`scripts/bootstrap.ts\` seed utility for a larger demo dataset
 - \`migrations/\` checked-in Tango migrations
+- \`.tango/\` generated relation typing artifacts
 `;
 	}
 };
@@ -1291,6 +1305,7 @@ var PackageJsonTemplateBuilder = class extends TemplateBuilder {
 				typecheck: "NUXT_TELEMETRY_DISABLED=1 nuxt typecheck",
 				"setup:schema": "pnpm exec tango migrate --config ./tango.config.ts",
 				"make:migrations": "pnpm exec tango make:migrations --config ./tango.config.ts --models ./lib/models/index.ts --name \"\${npm_config_name:-manual_change}\"",
+				"codegen:relations": "pnpm exec tango codegen relations --models ./lib/models/index.ts",
 				prebootstrap: "pnpm run setup:schema",
 				bootstrap: "tsx scripts/bootstrap.ts"
 			},
@@ -1725,10 +1740,13 @@ ${context.packageManager} run make:migrations --name initial
 ${context.packageManager} run dev
 \`\`\`
 
+\`make:migrations\` also refreshes the generated relation registry for the scaffolded model module. If you later change relation metadata without needing a new migration file, run \`${context.packageManager} run codegen:relations\`.
+
 ## Scripts
 
 - \`${context.packageManager} run dev\`
 - \`${context.packageManager} run make:migrations --name add_field\`
+- \`${context.packageManager} run codegen:relations\`
 - \`${context.packageManager} run setup:schema\`
 - \`${context.packageManager} run bootstrap\`
 - \`${context.packageManager} run typecheck\`
@@ -1751,6 +1769,7 @@ ${context.packageManager} run dev
 - \`lib/openapi.ts\` OpenAPI document generation
 - \`scripts/bootstrap.ts\` seed utility for a larger demo dataset
 - \`migrations/\` checked-in Tango migrations
+- \`.tango/\` generated relation typing artifacts
 `;
 	}
 };
@@ -1886,4 +1905,4 @@ __export(frameworks_exports, {
 
 //#endregion
 export { ExpressScaffoldStrategy, FrameworkScaffoldRegistry, FrameworkScaffoldStrategy, NextScaffoldStrategy, NuxtScaffoldStrategy, PACKAGE_MANAGER, SCAFFOLD_DATABASE_DIALECT, SCAFFOLD_TEMPLATE_CATEGORY, SUPPORTED_FRAMEWORK, ScaffoldTemplateDescriptor, frameworks_exports, scaffoldProject };
-//# sourceMappingURL=frameworks-Dfcrg0ZQ.js.map
+//# sourceMappingURL=frameworks-CLOeazGj.js.map