joist-codegen 2.3.0-next.6 → 2.3.0-next.60

package/build/codemods/index.cjs

@@ -0,0 +1,49 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./Codemod.cjs");
+const require_codemods_codemod_0001_rename_has_async_property = require("./codemod_0001-rename_has_async_property.cjs");
+const require_codemods_codemod_0002_rename_async_query_fields = require("./codemod_0002-rename_async_query_fields.cjs");
+const require_codemods_codemod_0003_rename_find_paginated = require("./codemod_0003-rename_find_paginated.cjs");
+require("../config.cjs");
+//#region src/codemods/index.ts
+const codemods = [
+	require_codemods_codemod_0001_rename_has_async_property.codemod_0001_rename_has_async_property,
+	require_codemods_codemod_0002_rename_async_query_fields.codemod_0002_rename_async_query_fields,
+	require_codemods_codemod_0003_rename_find_paginated.codemod_0003_rename_find_paginated
+];
+/** Prompts for and runs pending codemods for the user's project. */
+async function maybeRunTransforms(config) {
+	const { confirm } = await import("@inquirer/prompts");
+	const configCodemodVersion = config.codemodVersion;
+	const latestCodemodVersion = getLatestCodemodVersion();
+	if (configCodemodVersion >= latestCodemodVersion) return;
+	const mods = findApplicableCodemods(configCodemodVersion);
+	if (mods.length === 0) {
+		config.codemodVersion = latestCodemodVersion;
+		return;
+	}
+	console.log(`Your project is on Joist codemod version ${configCodemodVersion} and there ${mods.length === 1 ? "is" : "are"} ${mods.length} codemod${mods.length === 1 ? "" : "s"} to apply.`);
+	if (!await confirm({ message: `Would you like to run them?` })) {
+		config.codemodVersion = latestCodemodVersion;
+		return;
+	}
+	for (const mod of mods) {
+		if (!await confirm({ message: `Do you want to run ${mod.description}?` })) continue;
+		await mod.run(config);
+	}
+	console.log(`\n\n\nYou've been upgraded to Joist codemod version ${latestCodemodVersion}!`);
+	config.codemodVersion = latestCodemodVersion;
+}
+/** Returns the highest codemod counter known by this version of codegen. */
+function getLatestCodemodVersion() {
+	return codemods[codemods.length - 1]?.codemodVersion ?? 0;
+}
+/** Returns codemods that have not yet been applied to the user's project. */
+function findApplicableCodemods(codemodVersion) {
+	return codemods.filter((codemod) => codemod.codemodVersion > codemodVersion);
+}
+//#endregion
+exports.findApplicableCodemods = findApplicableCodemods;
+exports.getLatestCodemodVersion = getLatestCodemodVersion;
+exports.maybeRunTransforms = maybeRunTransforms;
+
+//# sourceMappingURL=index.cjs.map

package/build/codemods/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["codemod_0001_rename_has_async_property","codemod_0002_rename_async_query_fields","codemod_0003_rename_find_paginated"],"sources":["../../src/codemods/index.ts"],"sourcesContent":["import { type Config } from \"../config.ts\";\nimport { type Codemod } from \"./Codemod.ts\";\nimport { codemod_0001_rename_has_async_property } from \"./codemod_0001-rename_has_async_property.ts\";\nimport { codemod_0002_rename_async_query_fields } from \"./codemod_0002-rename_async_query_fields.ts\";\nimport { codemod_0003_rename_find_paginated } from \"./codemod_0003-rename_find_paginated.ts\";\n\nconst codemods: Codemod[] = [\n  codemod_0001_rename_has_async_property,\n  codemod_0002_rename_async_query_fields,\n  codemod_0003_rename_find_paginated,\n];\n\n/** Prompts for and runs pending codemods for the user's project. */\nexport async function maybeRunTransforms(config: Config): Promise<void> {\n  const { confirm } = await import(\"@inquirer/prompts\");\n  const configCodemodVersion = config.codemodVersion;\n  const latestCodemodVersion = getLatestCodemodVersion();\n\n  if (configCodemodVersion >= latestCodemodVersion) {\n    return;\n  }\n\n  const mods = findApplicableCodemods(configCodemodVersion);\n  if (mods.length === 0) {\n    config.codemodVersion = latestCodemodVersion;\n    return;\n  }\n\n  console.log(\n    `Your project is on Joist codemod version ${configCodemodVersion} and there ${mods.length === 1 ? \"is\" : \"are\"} ${mods.length} codemod${mods.length === 1 ? \"\" : \"s\"} to apply.`,\n  );\n\n  const run = await confirm({\n    message: `Would you like to run them?`,\n  });\n\n  if (!run) {\n    config.codemodVersion = latestCodemodVersion;\n    return;\n  }\n\n  for (const mod of mods) {\n    const run = await confirm({\n      message: `Do you want to run ${mod.description}?`,\n    });\n    if (!run) continue;\n    await mod.run(config);\n  }\n\n  console.log(`\\n\\n\\nYou've been upgraded to Joist codemod version ${latestCodemodVersion}!`);\n\n  config.codemodVersion = latestCodemodVersion;\n}\n\n/** Returns the highest codemod counter known by this version of codegen. */\nexport function getLatestCodemodVersion(): number {\n  return codemods[codemods.length - 1]?.codemodVersion ?? 0;\n}\n\n/** Returns codemods that have not yet been applied to the user's project. */\nexport function findApplicableCodemods(codemodVersion: number): Codemod[] {\n  return codemods.filter((codemod) => codemod.codemodVersion > codemodVersion);\n}\n"],"mappings":";;;;;;;AAMA,MAAM,WAAsB;CAC1BA,wDAAAA;CACAC,wDAAAA;CACAC,oDAAAA;AACF;;AAGA,eAAsB,mBAAmB,QAA+B;CACtE,MAAM,EAAE,YAAY,MAAM,OAAO;CACjC,MAAM,uBAAuB,OAAO;CACpC,MAAM,uBAAuB,wBAAwB;CAErD,IAAI,wBAAwB,sBAC1B;CAGF,MAAM,OAAO,uBAAuB,oBAAoB;CACxD,IAAI,KAAK,WAAW,GAAG;EACrB,OAAO,iBAAiB;EACxB;CACF;CAEA,QAAQ,IACN,4CAA4C,qBAAqB,aAAa,KAAK,WAAW,IAAI,OAAO,MAAM,GAAG,KAAK,OAAO,UAAU,KAAK,WAAW,IAAI,KAAK,IAAI,WACvK;CAMA,IAAI,CAAC,MAJa,QAAQ,EACxB,SAAS,8BACX,CAAC,GAES;EACR,OAAO,iBAAiB;EACxB;CACF;CAEA,KAAK,MAAM,OAAO,MAAM;EAItB,IAAI,CAAC,MAHa,QAAQ,EACxB,SAAS,sBAAsB,IAAI,YAAY,GACjD,CAAC,GACS;EACV,MAAM,IAAI,IAAI,MAAM;CACtB;CAEA,QAAQ,IAAI,uDAAuD,qBAAqB,EAAE;CAE1F,OAAO,iBAAiB;AAC1B;;AAGA,SAAgB,0BAAkC;CAChD,OAAO,SAAS,SAAS,SAAS,EAAE,EAAE,kBAAkB;AAC1D;;AAGA,SAAgB,uBAAuB,gBAAmC;CACxE,OAAO,SAAS,QAAQ,YAAY,QAAQ,iBAAiB,cAAc;AAC7E"}

package/build/codemods/index.d.cts

@@ -0,0 +1,12 @@
+import { Config } from "../config.cjs";
+import { Codemod } from "./Codemod.cjs";
+//#region src/codemods/index.d.ts
+/** Prompts for and runs pending codemods for the user's project. */
+declare function maybeRunTransforms(config: Config): Promise<void>;
+/** Returns the highest codemod counter known by this version of codegen. */
+declare function getLatestCodemodVersion(): number;
+/** Returns codemods that have not yet been applied to the user's project. */
+declare function findApplicableCodemods(codemodVersion: number): Codemod[];
+//#endregion
+export { findApplicableCodemods, getLatestCodemodVersion, maybeRunTransforms };
+//# sourceMappingURL=index.d.cts.map

package/build/codemods/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/codemods/index.ts"],"mappings":";;;;iBAasB,mBAAmB,QAAQ,SAAS;;iBA0C1C;;iBAKA,uBAAuB,yBAAyB"}

package/build/codemods/index.d.mts

@@ -0,0 +1,12 @@
+import { Config } from "../config.mjs";
+import { Codemod } from "./Codemod.mjs";
+//#region src/codemods/index.d.ts
+/** Prompts for and runs pending codemods for the user's project. */
+declare function maybeRunTransforms(config: Config): Promise<void>;
+/** Returns the highest codemod counter known by this version of codegen. */
+declare function getLatestCodemodVersion(): number;
+/** Returns codemods that have not yet been applied to the user's project. */
+declare function findApplicableCodemods(codemodVersion: number): Codemod[];
+//#endregion
+export { findApplicableCodemods, getLatestCodemodVersion, maybeRunTransforms };
+//# sourceMappingURL=index.d.mts.map

package/build/codemods/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/codemods/index.ts"],"mappings":";;;;iBAasB,mBAAmB,QAAQ,SAAS;;iBA0C1C;;iBAKA,uBAAuB,yBAAyB"}

package/build/codemods/index.js

@@ -1,54 +1,46 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.maybeRunTransforms = maybeRunTransforms;
-exports.getLatestCodemodVersion = getLatestCodemodVersion;
-exports.findApplicableCodemods = findApplicableCodemods;
-const codemod_0001_rename_has_async_property_1 = require("./codemod_0001-rename_has_async_property");
-const codemod_0002_rename_async_query_fields_1 = require("./codemod_0002-rename_async_query_fields");
-const codemod_0003_rename_find_paginated_1 = require("./codemod_0003-rename_find_paginated");
+import "./Codemod.js";
+import { codemod_0001_rename_has_async_property } from "./codemod_0001-rename_has_async_property.js";
+import { codemod_0002_rename_async_query_fields } from "./codemod_0002-rename_async_query_fields.js";
+import { codemod_0003_rename_find_paginated } from "./codemod_0003-rename_find_paginated.js";
+import "../config.js";
+//#region src/codemods/index.ts
 const codemods = [
-    codemod_0001_rename_has_async_property_1.codemod_0001_rename_has_async_property,
-    codemod_0002_rename_async_query_fields_1.codemod_0002_rename_async_query_fields,
-    codemod_0003_rename_find_paginated_1.codemod_0003_rename_find_paginated,
+	codemod_0001_rename_has_async_property,
+	codemod_0002_rename_async_query_fields,
+	codemod_0003_rename_find_paginated
 ];
 /** Prompts for and runs pending codemods for the user's project. */
 async function maybeRunTransforms(config) {
-    const { confirm } = await import("@inquirer/prompts");
-    const configCodemodVersion = config.codemodVersion;
-    const latestCodemodVersion = getLatestCodemodVersion();
-    if (configCodemodVersion >= latestCodemodVersion) {
-        return;
-    }
-    const mods = findApplicableCodemods(configCodemodVersion);
-    if (mods.length === 0) {
-        config.codemodVersion = latestCodemodVersion;
-        return;
-    }
-    console.log(`Your project is on Joist codemod version ${configCodemodVersion} and there ${mods.length === 1 ? "is" : "are"} ${mods.length} codemod${mods.length === 1 ? "" : "s"} to apply.`);
-    const run = await confirm({
-        message: `Would you like to run them?`,
-    });
-    if (!run) {
-        config.codemodVersion = latestCodemodVersion;
-        return;
-    }
-    for (const mod of mods) {
-        const run = await confirm({
-            message: `Do you want to run ${mod.description}?`,
-        });
-        if (!run)
-            continue;
-        await mod.run(config);
-    }
-    console.log(`\n\n\nYou've been upgraded to Joist codemod version ${latestCodemodVersion}!`);
-    config.codemodVersion = latestCodemodVersion;
+	const { confirm } = await import("@inquirer/prompts");
+	const configCodemodVersion = config.codemodVersion;
+	const latestCodemodVersion = getLatestCodemodVersion();
+	if (configCodemodVersion >= latestCodemodVersion) return;
+	const mods = findApplicableCodemods(configCodemodVersion);
+	if (mods.length === 0) {
+		config.codemodVersion = latestCodemodVersion;
+		return;
+	}
+	console.log(`Your project is on Joist codemod version ${configCodemodVersion} and there ${mods.length === 1 ? "is" : "are"} ${mods.length} codemod${mods.length === 1 ? "" : "s"} to apply.`);
+	if (!await confirm({ message: `Would you like to run them?` })) {
+		config.codemodVersion = latestCodemodVersion;
+		return;
+	}
+	for (const mod of mods) {
+		if (!await confirm({ message: `Do you want to run ${mod.description}?` })) continue;
+		await mod.run(config);
+	}
+	console.log(`\n\n\nYou've been upgraded to Joist codemod version ${latestCodemodVersion}!`);
+	config.codemodVersion = latestCodemodVersion;
 }
 /** Returns the highest codemod counter known by this version of codegen. */
 function getLatestCodemodVersion() {
-    return codemods[codemods.length - 1]?.codemodVersion ?? 0;
+	return codemods[codemods.length - 1]?.codemodVersion ?? 0;
 }
 /** Returns codemods that have not yet been applied to the user's project. */
 function findApplicableCodemods(codemodVersion) {
-    return codemods.filter((codemod) => codemod.codemodVersion > codemodVersion);
+	return codemods.filter((codemod) => codemod.codemodVersion > codemodVersion);
 }
+//#endregion
+export { findApplicableCodemods, getLatestCodemodVersion, maybeRunTransforms };
+
 //# sourceMappingURL=index.js.map

package/build/codemods/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codemods/index.ts"],"names":[],"mappings":";;AAaA,gDAuCC;AAGD,0DAEC;AAGD,wDAEC;AA5DD,qGAAkG;AAClG,qGAAkG;AAClG,6FAA0F;AAE1F,MAAM,QAAQ,GAAc;IAC1B,+EAAsC;IACtC,+EAAsC;IACtC,uEAAkC;CACnC,CAAC;AAEF,oEAAoE;AAC7D,KAAK,UAAU,kBAAkB,CAAC,MAAc;IACrD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACtD,MAAM,oBAAoB,GAAG,MAAM,CAAC,cAAc,CAAC;IACnD,MAAM,oBAAoB,GAAG,uBAAuB,EAAE,CAAC;IAEvD,IAAI,oBAAoB,IAAI,oBAAoB,EAAE,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,sBAAsB,CAAC,oBAAoB,CAAC,CAAC;IAC1D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,cAAc,GAAG,oBAAoB,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CACT,4CAA4C,oBAAoB,cAAc,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,WAAW,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,YAAY,CACjL,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACxB,OAAO,EAAE,6BAA6B;KACvC,CAAC,CAAC;IAEH,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,CAAC,cAAc,GAAG,oBAAoB,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;YACxB,OAAO,EAAE,sBAAsB,GAAG,CAAC,WAAW,GAAG;SAClD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,uDAAuD,oBAAoB,GAAG,CAAC,CAAC;IAE5F,MAAM,CAAC,cAAc,GAAG,oBAAoB,CAAC;AAC/C,CAAC;AAED,4EAA4E;AAC5E,SAAgB,uBAAuB;IACrC,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,cAAc,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,6EAA6E;AAC7E,SAAgB,sBAAsB,CAAC,cAAsB;IAC3D,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,GAAG,cAAc,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/codemods/index.ts"],"sourcesContent":["import { type Config } from \"../config.ts\";\nimport { type Codemod } from \"./Codemod.ts\";\nimport { codemod_0001_rename_has_async_property } from \"./codemod_0001-rename_has_async_property.ts\";\nimport { codemod_0002_rename_async_query_fields } from \"./codemod_0002-rename_async_query_fields.ts\";\nimport { codemod_0003_rename_find_paginated } from \"./codemod_0003-rename_find_paginated.ts\";\n\nconst codemods: Codemod[] = [\n  codemod_0001_rename_has_async_property,\n  codemod_0002_rename_async_query_fields,\n  codemod_0003_rename_find_paginated,\n];\n\n/** Prompts for and runs pending codemods for the user's project. */\nexport async function maybeRunTransforms(config: Config): Promise<void> {\n  const { confirm } = await import(\"@inquirer/prompts\");\n  const configCodemodVersion = config.codemodVersion;\n  const latestCodemodVersion = getLatestCodemodVersion();\n\n  if (configCodemodVersion >= latestCodemodVersion) {\n    return;\n  }\n\n  const mods = findApplicableCodemods(configCodemodVersion);\n  if (mods.length === 0) {\n    config.codemodVersion = latestCodemodVersion;\n    return;\n  }\n\n  console.log(\n    `Your project is on Joist codemod version ${configCodemodVersion} and there ${mods.length === 1 ? \"is\" : \"are\"} ${mods.length} codemod${mods.length === 1 ? \"\" : \"s\"} to apply.`,\n  );\n\n  const run = await confirm({\n    message: `Would you like to run them?`,\n  });\n\n  if (!run) {\n    config.codemodVersion = latestCodemodVersion;\n    return;\n  }\n\n  for (const mod of mods) {\n    const run = await confirm({\n      message: `Do you want to run ${mod.description}?`,\n    });\n    if (!run) continue;\n    await mod.run(config);\n  }\n\n  console.log(`\\n\\n\\nYou've been upgraded to Joist codemod version ${latestCodemodVersion}!`);\n\n  config.codemodVersion = latestCodemodVersion;\n}\n\n/** Returns the highest codemod counter known by this version of codegen. */\nexport function getLatestCodemodVersion(): number {\n  return codemods[codemods.length - 1]?.codemodVersion ?? 0;\n}\n\n/** Returns codemods that have not yet been applied to the user's project. */\nexport function findApplicableCodemods(codemodVersion: number): Codemod[] {\n  return codemods.filter((codemod) => codemod.codemodVersion > codemodVersion);\n}\n"],"mappings":";;;;;;AAMA,MAAM,WAAsB;CAC1B;CACA;CACA;AACF;;AAGA,eAAsB,mBAAmB,QAA+B;CACtE,MAAM,EAAE,YAAY,MAAM,OAAO;CACjC,MAAM,uBAAuB,OAAO;CACpC,MAAM,uBAAuB,wBAAwB;CAErD,IAAI,wBAAwB,sBAC1B;CAGF,MAAM,OAAO,uBAAuB,oBAAoB;CACxD,IAAI,KAAK,WAAW,GAAG;EACrB,OAAO,iBAAiB;EACxB;CACF;CAEA,QAAQ,IACN,4CAA4C,qBAAqB,aAAa,KAAK,WAAW,IAAI,OAAO,MAAM,GAAG,KAAK,OAAO,UAAU,KAAK,WAAW,IAAI,KAAK,IAAI,WACvK;CAMA,IAAI,CAAC,MAJa,QAAQ,EACxB,SAAS,8BACX,CAAC,GAES;EACR,OAAO,iBAAiB;EACxB;CACF;CAEA,KAAK,MAAM,OAAO,MAAM;EAItB,IAAI,CAAC,MAHa,QAAQ,EACxB,SAAS,sBAAsB,IAAI,YAAY,GACjD,CAAC,GACS;EACV,MAAM,IAAI,IAAI,MAAM;CACtB;CAEA,QAAQ,IAAI,uDAAuD,qBAAqB,EAAE;CAE1F,OAAO,iBAAiB;AAC1B;;AAGA,SAAgB,0BAAkC;CAChD,OAAO,SAAS,SAAS,SAAS,EAAE,EAAE,kBAAkB;AAC1D;;AAGA,SAAgB,uBAAuB,gBAAmC;CACxE,OAAO,SAAS,QAAQ,YAAY,QAAQ,iBAAiB,cAAc;AAC7E"}

package/build/config.cjs

@@ -0,0 +1,377 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_codemods_index = require("./codemods/index.cjs");
+const require_utils = require("./utils.cjs");
+const require_inheritance = require("./inheritance.cjs");
+const require_logger = require("./logger.cjs");
+require("./EntityDbMetadata.cjs");
+let joist_utils = require("joist-utils");
+let fs = require("fs");
+let path = require("path");
+let _dprint_formatter = require("@dprint/formatter");
+let _dprint_json = require("@dprint/json");
+let jsonc_parser = require("jsonc-parser");
+let zod = require("zod");
+//#region src/config.ts
+const jsonFormatter = (0, _dprint_formatter.createFromBuffer)((0, fs.readFileSync)((0, _dprint_json.getPath)()));
+const fieldConfig = zod.z.object({
+	derived: zod.z.optional(zod.z.union([zod.z.literal("sync"), zod.z.literal("async")])),
+	protected: zod.z.optional(zod.z.boolean()),
+	ignore: zod.z.optional(zod.z.boolean()),
+	superstruct: zod.z.optional(zod.z.string()),
+	zodSchema: zod.z.optional(zod.z.string()),
+	type: zod.z.optional(zod.z.string()),
+	serde: zod.z.optional(zod.z.string()),
+	stiDiscriminator: zod.z.optional(zod.z.record(zod.z.string(), zod.z.string())),
+	stiType: zod.z.optional(zod.z.string()),
+	notNull: zod.z.optional(zod.z.boolean()),
+	hasDefault: zod.z.optional(zod.z.boolean()),
+	lazy: zod.z.optional(zod.z.boolean())
+}).strict();
+const relationConfig = zod.z.object({
+	derived: zod.z.optional(zod.z.literal("async")),
+	polymorphic: zod.z.optional(zod.z.union([zod.z.literal("notNull"), zod.z.literal(true)])),
+	large: zod.z.optional(zod.z.boolean()),
+	orderBy: zod.z.optional(zod.z.string()),
+	/**
+	* Controls whether this collection's `.get`/`.load` hide soft-deleted entities.
+	*
+	* Defaults to `"exclude"` (soft-deleted entities are hidden); set to `"include"` to have
+	* this specific o2m/m2m always return soft-deleted entities from `.get`/`.load`.
+	*/
+	softDeletes: zod.z.optional(zod.z.union([zod.z.literal("include"), zod.z.literal("exclude")])),
+	stiType: zod.z.optional(zod.z.string()),
+	/**
+	* Allow specializing a base type relation (SmallPublisher.group: SmallPublisherGroup).
+	*
+	* Self-referential FKs also support `subType: "self"` that means each subtype will point
+	* at its own subtype.
+	*/
+	subType: zod.z.optional(zod.z.string()),
+	/** Allow skipping self-referential fields getting a `...Recursive` relation. */
+	skipRecursiveRelations: zod.z.optional(zod.z.boolean()),
+	notNull: zod.z.optional(zod.z.boolean()),
+	hasDefault: zod.z.optional(zod.z.boolean())
+}).strict();
+const uniqueByConfig = zod.z.union([
+	zod.z.string(),
+	zod.z.array(zod.z.string()),
+	zod.z.array(zod.z.array(zod.z.string()))
+]).transform(normalizeUniqueByConfig);
+const entityConfig = zod.z.object({
+	tag: zod.z.string(),
+	tableName: zod.z.optional(zod.z.string()),
+	fields: zod.z.optional(zod.z.record(zod.z.string(), fieldConfig)),
+	relations: zod.z.optional(zod.z.record(zod.z.string(), relationConfig)),
+	/** Whether this entity should be abstract, e.g. for inheritance a subtype must be instantiated instead of this type. */
+	abstract: zod.z.optional(zod.z.boolean()),
+	orderBy: zod.z.optional(zod.z.string()),
+	uniqueBy: zod.z.optional(uniqueByConfig)
+}).strict();
+const timestampConfig = zod.z.object({
+	/** The names to check for this timestamp, i.e. `created_at` `created`, etc. */
+	names: zod.z.array(zod.z.string()),
+	/** Whether this timestamp column is required to consider a table an entity, defaults to `false`. */
+	required: zod.z.optional(zod.z.boolean())
+}).strict();
+const config = zod.z.object({
+	/** The _build-time_ database URL for reading database metadata. */
+	databaseUrl: zod.z.optional(zod.z.string()),
+	/** Your application's request-level `Context` type. */
+	contextType: zod.z.optional(zod.z.string()),
+	/** Your application's database client's `Transaction` type. */
+	transactionType: zod.z.optional(zod.z.string()),
+	/**
+	* Allows the user to specify the `updated_at` / `created_at` column names to look up, and if they're optional.
+	*
+	* We default to looking for `updated_at`, `updatedAt`, `created_at`, `createdAt`, and optional to true,
+	* e.g. tables are not required to have both timestamp columns to be considered entities.
+	*
+	* These defaults are the most lenient, to facilitate running Joist against an existing schema and
+	* seeing all of your entities, regardless of your previous conventions.
+	*/
+	timestampColumns: zod.z.optional(zod.z.object({
+		createdAt: zod.z.optional(timestampConfig),
+		updatedAt: zod.z.optional(timestampConfig),
+		deletedAt: zod.z.optional(timestampConfig)
+	})),
+	/**
+	* Allows the user to have codegen output `Temporal` types instead of the base JS `Date`
+	*
+	* Additionally, allows for specifying the default time zone for `Temporal` types when converting dates to/from
+	* the database.
+	*/
+	temporal: zod.z.optional(zod.z.union([zod.z.boolean(), zod.z.object({ timeZone: zod.z.string() })])),
+	/**
+	* By default, we create a `flush_database` function for fast testing.
+	*
+	* However, if you don't want to use this, or you have your own bespoke function like we do
+	* that is more application-aware, then you can disable Joist's out-of-the-box one.
+	*
+	* If you have more than one test database, you can set `createFlushFunction` to the array
+	* of test database names, i.e. `mydb_test_1`, `mydb_test_2`, etc.
+	*/
+	createFlushFunction: zod.z.optional(zod.z.union([zod.z.boolean(), zod.z.array(zod.z.string())])),
+	entitiesDirectory: zod.z.string().default("./src/entities"),
+	codegenPlugins: zod.z.optional(zod.z.array(zod.z.string())),
+	entities: zod.z.record(zod.z.string(), entityConfig).default({}),
+	ignoredTables: zod.z.optional(zod.z.array(zod.z.string())),
+	/** The type of entity `id` fields; defaults to `tagged-string`. */
+	idType: zod.z.optional(zod.z.union([
+		zod.z.literal("tagged-string"),
+		zod.z.literal("untagged-string"),
+		zod.z.literal("number")
+	])),
+	/** The separator between entity tags and ids; defaults to `:`, and `""` disables the separator. */
+	tagDelimiter: zod.z.optional(zod.z.string()),
+	/** How we should support non-deferred foreign keys. */
+	nonDeferredForeignKeys: zod.z.optional(zod.z.union([
+		zod.z.literal("error"),
+		zod.z.literal("warn"),
+		zod.z.literal("ignore")
+	])),
+	/** Enables esm output. */
+	esm: zod.z.optional(zod.z.boolean()),
+	/** Controls the style of GraphQL pagination scaffolding. */
+	paginationStyle: zod.z.optional(zod.z.union([zod.z.literal("cursor"), zod.z.literal("limit")])).default("cursor"),
+	/** Enables documentation syncing between .md files and JSDocs. */
+	docs: zod.z.optional(zod.z.boolean()),
+	/** Installs Joist's bundled Agent Skills into `.claude/skills` and `.agents/skills`; on by default, set `false` to disable. */
+	skills: zod.z.optional(zod.z.boolean()),
+	/** Output a metadata-docs.ts file with entity/field documentation available at runtime. */
+	outputDocs: zod.z.optional(zod.z.boolean()),
+	/** Auto-set by probing the project's `tsconfig.json` file. */
+	allowImportingTsExtensions: zod.z.optional(zod.z.boolean()),
+	/** The latest Joist codemod counter that has been applied to this project. */
+	codemodVersion: zod.z.number().int().min(0).default(0),
+	/** A list of postgres schemas to use for finding tables */
+	schemas: zod.z.optional(zod.z.array(zod.z.string()))
+}).strict();
+const ormMaintainedFields = ["createdAt", "updatedAt"];
+/** Ensure the user doesn't have any typos in their config. */
+function warnInvalidConfigEntries(config, db) {
+	const entitiesByName = (0, joist_utils.groupBy)(db.entities, (e) => e.name);
+	for (const [entityName, entityConfig] of Object.entries(config.entities)) {
+		const entities = entitiesByName[entityName];
+		if (!entities) {
+			require_logger.logger.warn(`Found config for non-existent entity ${entityName}`);
+			continue;
+		}
+		const [entity] = entities;
+		const fields = [...entity.primitives, ...entity.enums];
+		for (const [name, config] of Object.entries(entityConfig.fields || {})) {
+			if (config.ignore) continue;
+			let field = fields.find((f) => f.fieldName === name);
+			if (!field && entity.stiDiscriminatorField) field = (require_inheritance.getStiEntities(db.entities).get(entity.name)?.subTypes)?.flatMap((st) => [...st.primitives, ...st.enums]).find((f) => f.fieldName === name);
+			if (!field) require_logger.logger.warn(`Found config for non-existent field ${entityName}.${name}`);
+		}
+		const relations = [
+			...entity.manyToOnes,
+			...entity.oneToManys,
+			...entity.manyToManys,
+			...entity.manyToManyEnums,
+			...entity.oneToOnes,
+			...entity.largeOneToManys,
+			...entity.largeManyToManys,
+			...entity.polymorphics
+		];
+		for (const [name, _] of Object.entries(entityConfig.relations || {})) {
+			let relation = relations.find((r) => r.fieldName === name);
+			if (!relation && entity.stiDiscriminatorField) relation = (require_inheritance.getStiEntities(db.entities).get(entity.name)?.subTypes)?.flatMap((entity) => [
+				...entity.manyToOnes,
+				...entity.oneToManys,
+				...entity.manyToManys,
+				...entity.oneToOnes,
+				...entity.largeOneToManys,
+				...entity.largeManyToManys,
+				...entity.polymorphics
+			])?.find((f) => f.fieldName === name);
+			if (!relation && entity.baseType) {
+				const baseType = entity.baseType;
+				relation = [
+					...baseType.manyToOnes,
+					...baseType.oneToManys,
+					...baseType.manyToManys,
+					...baseType.oneToOnes,
+					...baseType.largeOneToManys,
+					...baseType.largeManyToManys,
+					...baseType.polymorphics
+				].find((f) => f.fieldName === name);
+			}
+			if (!relation) require_logger.logger.warn(`Found config for non-existent relation ${entityName}.${name}`);
+		}
+		const uniqueFields = [
+			...entity.primitives,
+			...entity.enums,
+			...entity.pgEnums,
+			...entity.manyToOnes,
+			...entity.polymorphics
+		];
+		for (const uniqueBy of entityConfig.uniqueBy || []) for (const name of uniqueBy) {
+			const field = uniqueFields.find((f) => f.fieldName === name);
+			if (!field) require_logger.logger.warn(`Found uniqueBy for non-existent or non-queryable field ${entityName}.${name}`);
+			else if (field.kind === "primitive" && (field.derived || field.isArray || field.customSerde)) require_logger.logger.warn(`Found uniqueBy for unsupported primitive field ${entityName}.${name}`);
+			else if (field.kind === "enum" && (field.derived || field.isArray)) require_logger.logger.warn(`Found uniqueBy for unsupported enum field ${entityName}.${name}`);
+		}
+	}
+}
+function isGetterField(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.derived === "sync";
+}
+function isReactiveField(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.derived === "async";
+}
+function isReactiveReference(config, entity, fieldName) {
+	return config.entities[entity.name]?.relations?.[fieldName]?.derived === "async";
+}
+/** Returns true if this m2m relation is configured as a ReactiveManyToMany (derived: async). */
+function isReactiveManyToMany(config, entity, fieldName) {
+	return config.entities[entity.name]?.relations?.[fieldName]?.derived === "async";
+}
+function isProtected(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.protected === true;
+}
+/** Whether a column should be excluded from the default SELECT and exposed as a lazy-loaded `LazyField`. */
+function isLazyField(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.lazy === true;
+}
+function serdeConfig(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.serde;
+}
+function superstructConfig(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.superstruct;
+}
+function zodSchemaConfig(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.zodSchema;
+}
+function fieldTypeConfig(config, entity, fieldName) {
+	return config.entities[entity.name]?.fields?.[fieldName]?.type;
+}
+function isLargeCollection(config, entity, fieldName) {
+	return config.entities[entity.name]?.relations?.[fieldName]?.large === true;
+}
+/** Whether a collection should include (or exclude) soft-deleted entities from `.get`/`.load`. */
+function softDeletesConfig(config, entity, fieldName) {
+	return config.entities[entity.name]?.relations?.[fieldName]?.softDeletes;
+}
+function isFieldIgnored(config, entity, fieldName, notNull = false, hasDefault = false) {
+	const ignore = config.entities[entity.name]?.fields?.[fieldName]?.ignore === true;
+	if (ignore && notNull && !hasDefault) require_utils.fail(`notNull field ${entity.name}.${fieldName} cannot be ignored. Alter the column to be optional or have a default value prior to ignoring it.`);
+	return ignore;
+}
+function isFieldHasDefault(config, entity, fieldName) {
+	const entityConfig = config.entities[entity.name] ?? {};
+	return (entityConfig.fields?.[fieldName] ?? entityConfig.relations?.[fieldName] ?? {}).hasDefault === true;
+}
+const configPath = "./joist-config.json";
+async function loadConfig() {
+	if (await require_utils.trueIfResolved(fs.promises.access(configPath))) {
+		const content = await fs.promises.readFile(configPath);
+		const result = config.safeParse(stripLegacyConfigKeys(JSON.parse(content.toString())));
+		if (!result.success) throw new Error(`Invalid joist-config.json: ${result.error.issues.map((ze) => `${ze.path.map(String).join("/")} ${ze.message}`).join("\n")}`);
+		result.data.allowImportingTsExtensions ??= projectIsUsingEsmWithImports();
+		return result.data;
+	}
+	const initial = config.parse({ codemodVersion: require_codemods_index.getLatestCodemodVersion() });
+	initial.allowImportingTsExtensions ??= projectIsUsingEsmWithImports();
+	return initial;
+}
+/**
+* Writes the potentially-updated config entry back to `joist-config.json`.
+*
+* We format the output with prettier so it should both a) look nice and b) be deterministic,
+* such that no changes to the config show up as noops to the scm.
+*/
+async function writeConfig(config) {
+	const sorted = require_utils.sortKeys(config);
+	delete sorted.__tableToEntityName;
+	delete sorted.allowImportingTsExtensions;
+	if (sorted.paginationStyle === "cursor") delete sorted.paginationStyle;
+	const input = JSON.stringify(sorted);
+	const content = jsonFormatter.formatText({
+		filePath: "test.json",
+		fileText: input
+	});
+	await fs.promises.writeFile(configPath, content);
+}
+function stripStiPlaceholders(config, entities) {
+	for (const entity of entities) if (entity.inheritanceType === "sti" && entity.stiDiscriminatorValue) delete config.entities[entity.name];
+}
+/** Applies defaults to the timestamp config. */
+function getTimestampConfig(config) {
+	return {
+		createdAtConf: {
+			names: ["created_at", "createdAt"],
+			required: false,
+			...config?.timestampColumns?.createdAt
+		},
+		updatedAtConf: {
+			names: ["updated_at", "updatedAt"],
+			required: false,
+			...config?.timestampColumns?.updatedAt
+		},
+		deletedAtConf: {
+			names: ["deleted_at", "deletedAt"],
+			required: false,
+			...config?.timestampColumns?.deletedAt
+		}
+	};
+}
+function projectIsUsingEsmWithImports() {
+	const configPath = findTsConfigFile(process.cwd());
+	if (!configPath) return false;
+	try {
+		const errors = [];
+		const parsed = (0, jsonc_parser.parse)((0, fs.readFileSync)(configPath, "utf8"), errors, { allowTrailingComma: true });
+		if (errors.length > 0 || typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) return false;
+		const compilerOptions = parsed.compilerOptions;
+		return typeof compilerOptions === "object" && compilerOptions !== null && !Array.isArray(compilerOptions) && compilerOptions.allowImportingTsExtensions === true;
+	} catch {
+		return false;
+	}
+}
+/** Normalizes `uniqueBy` config sugar into runtime identity candidates. */
+function normalizeUniqueByConfig(uniqueBy) {
+	if (typeof uniqueBy === "string") return [[uniqueBy]];
+	if (uniqueBy.every((field) => typeof field === "string")) return [uniqueBy];
+	return uniqueBy;
+}
+function stripLegacyConfigKeys(raw) {
+	if (!raw || typeof raw !== "object" || Array.isArray(raw)) return raw;
+	const parsed = { ...raw };
+	delete parsed.version;
+	return parsed;
+}
+/** Finds the nearest `tsconfig.json` in `directory` or one of its ancestors. */
+function findTsConfigFile(directory) {
+	while (true) {
+		const fileName = (0, path.join)(directory, "tsconfig.json");
+		if ((0, fs.existsSync)(fileName)) return fileName;
+		const parent = (0, path.dirname)(directory);
+		if (parent === directory) return void 0;
+		directory = parent;
+	}
+}
+//#endregion
+exports.config = config;
+exports.fieldTypeConfig = fieldTypeConfig;
+exports.getTimestampConfig = getTimestampConfig;
+exports.isFieldHasDefault = isFieldHasDefault;
+exports.isFieldIgnored = isFieldIgnored;
+exports.isGetterField = isGetterField;
+exports.isLargeCollection = isLargeCollection;
+exports.isLazyField = isLazyField;
+exports.isProtected = isProtected;
+exports.isReactiveField = isReactiveField;
+exports.isReactiveManyToMany = isReactiveManyToMany;
+exports.isReactiveReference = isReactiveReference;
+exports.loadConfig = loadConfig;
+exports.ormMaintainedFields = ormMaintainedFields;
+exports.serdeConfig = serdeConfig;
+exports.softDeletesConfig = softDeletesConfig;
+exports.stripStiPlaceholders = stripStiPlaceholders;
+exports.superstructConfig = superstructConfig;
+exports.warnInvalidConfigEntries = warnInvalidConfigEntries;
+exports.writeConfig = writeConfig;
+exports.zodSchemaConfig = zodSchemaConfig;
+
+//# sourceMappingURL=config.cjs.map