joist-codegen 2.4.0-next.5 → 2.4.0-next.50

package/build/codemods/Codemod.d.cts

@@ -6,12 +6,11 @@ import { Config } from "../config.cjs";
  * This can either be traditional jscodeshift mods that change the AST, or
  * also "dumber" mods that `mv` files around.
  */
-type Codemod = {
+export type Codemod = {
   codemodVersion: number;
   name: string;
   description: string;
   run(config: Config): Promise<void>;
 };
 //#endregion
-export { Codemod };
 //# sourceMappingURL=Codemod.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Codemod.d.cts","names":[],"sources":["../../src/codemods/Codemod.ts"],"mappings":";;;;;;;;KAQY;EACV;EACA;EACA;EACA,IAAI,QAAQ,SAAS"}
+{"version":3,"file":"Codemod.d.cts","names":[],"sources":["../../src/codemods/Codemod.ts"],"mappings":";;;;;;;;YAQY;EACV;EACA;EACA;EACA,IAAI,QAAQ,SAAS"}

package/build/codemods/Codemod.d.mts

@@ -6,12 +6,11 @@ import { Config } from "../config.mjs";
  * This can either be traditional jscodeshift mods that change the AST, or
  * also "dumber" mods that `mv` files around.
  */
-type Codemod = {
+export type Codemod = {
   codemodVersion: number;
   name: string;
   description: string;
   run(config: Config): Promise<void>;
 };
 //#endregion
-export { Codemod };
 //# sourceMappingURL=Codemod.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Codemod.d.mts","names":[],"sources":["../../src/codemods/Codemod.ts"],"mappings":";;;;;;;;KAQY;EACV;EACA;EACA;EACA,IAAI,QAAQ,SAAS"}
+{"version":3,"file":"Codemod.d.mts","names":[],"sources":["../../src/codemods/Codemod.ts"],"mappings":";;;;;;;;YAQY;EACV;EACA;EACA;EACA,IAAI,QAAQ,SAAS"}

package/build/codemods/JscodeshiftMod.d.cts

@@ -1,7 +1,7 @@
 import { Config } from "../config.cjs";
 import { Codemod } from "./Codemod.cjs";
 //#region src/codemods/JscodeshiftMod.d.ts
-declare class JscodeshiftMod implements Codemod {
+export declare class JscodeshiftMod implements Codemod {
   codemodVersion: number;
   name: string;
   description: string;
@@ -10,5 +10,4 @@ declare class JscodeshiftMod implements Codemod {
   run(config: Config): Promise<void>;
 }
 //#endregion
-export { JscodeshiftMod };
 //# sourceMappingURL=JscodeshiftMod.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"JscodeshiftMod.d.cts","names":[],"sources":["../../src/codemods/JscodeshiftMod.ts"],"mappings":";;;cAQa,0BAA0B;EAE5B;EACA;EACA;UACC;EAJV,YACS,wBACA,cACA,qBACC,QAAO,QAAQ;EAGnB,IAAI,QAAQ,SAAS"}
+{"version":3,"file":"JscodeshiftMod.d.cts","names":[],"sources":["../../src/codemods/JscodeshiftMod.ts"],"mappings":";;;qBAQa,0BAA0B;EAE5B;EACA;EACA;UACC;EAJV,YACS,wBACA,cACA,qBACC,QAAO,QAAQ;EAGnB,IAAI,QAAQ,SAAS"}

package/build/codemods/JscodeshiftMod.d.mts

@@ -1,7 +1,7 @@
 import { Config } from "../config.mjs";
 import { Codemod } from "./Codemod.mjs";
 //#region src/codemods/JscodeshiftMod.d.ts
-declare class JscodeshiftMod implements Codemod {
+export declare class JscodeshiftMod implements Codemod {
   codemodVersion: number;
   name: string;
   description: string;
@@ -10,5 +10,4 @@ declare class JscodeshiftMod implements Codemod {
   run(config: Config): Promise<void>;
 }
 //#endregion
-export { JscodeshiftMod };
 //# sourceMappingURL=JscodeshiftMod.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"JscodeshiftMod.d.mts","names":[],"sources":["../../src/codemods/JscodeshiftMod.ts"],"mappings":";;;cAQa,0BAA0B;EAE5B;EACA;EACA;UACC;EAJV,YACS,wBACA,cACA,qBACC,QAAO,QAAQ;EAGnB,IAAI,QAAQ,SAAS"}
+{"version":3,"file":"JscodeshiftMod.d.mts","names":[],"sources":["../../src/codemods/JscodeshiftMod.ts"],"mappings":";;;qBAQa,0BAA0B;EAE5B;EACA;EACA;UACC;EAJV,YACS,wBACA,cACA,qBACC,QAAO,QAAQ;EAGnB,IAAI,QAAQ,SAAS"}

package/build/codemods/codemod_0001-rename_has_async_property.d.cts

@@ -1,9 +1,9 @@
 import { JscodeshiftMod } from "./JscodeshiftMod.cjs";
 import { Transform } from "jscodeshift";
 //#region src/codemods/codemod_0001-rename_has_async_property.d.ts
-declare const codemod_0001_rename_has_async_property: JscodeshiftMod;
+export declare const codemod_0001_rename_has_async_property: JscodeshiftMod;
 /** Find/replace the various `*AsyncProperty*` symbols with their `*Property*` counterparts. */
 declare const transform: Transform;
 //#endregion
-export { codemod_0001_rename_has_async_property, transform as default };
+export { transform as default };
 //# sourceMappingURL=codemod_0001-rename_has_async_property.d.cts.map

package/build/codemods/codemod_0001-rename_has_async_property.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"codemod_0001-rename_has_async_property.d.cts","names":[],"sources":["../../src/codemods/codemod_0001-rename_has_async_property.ts"],"mappings":";;;cAIa,wCAAsC;;cAgB7C,WAAW"}
+{"version":3,"file":"codemod_0001-rename_has_async_property.d.cts","names":[],"sources":["../../src/codemods/codemod_0001-rename_has_async_property.ts"],"mappings":";;;qBAIa,wCAAsC;;cAgB7C,WAAW"}

package/build/codemods/codemod_0001-rename_has_async_property.d.mts

@@ -1,9 +1,9 @@
 import { JscodeshiftMod } from "./JscodeshiftMod.mjs";
 import { Transform } from "jscodeshift";
 //#region src/codemods/codemod_0001-rename_has_async_property.d.ts
-declare const codemod_0001_rename_has_async_property: JscodeshiftMod;
+export declare const codemod_0001_rename_has_async_property: JscodeshiftMod;
 /** Find/replace the various `*AsyncProperty*` symbols with their `*Property*` counterparts. */
 declare const transform: Transform;
 //#endregion
-export { codemod_0001_rename_has_async_property, transform as default };
+export { transform as default };
 //# sourceMappingURL=codemod_0001-rename_has_async_property.d.mts.map

package/build/codemods/codemod_0001-rename_has_async_property.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"codemod_0001-rename_has_async_property.d.mts","names":[],"sources":["../../src/codemods/codemod_0001-rename_has_async_property.ts"],"mappings":";;;cAIa,wCAAsC;;cAgB7C,WAAW"}
+{"version":3,"file":"codemod_0001-rename_has_async_property.d.mts","names":[],"sources":["../../src/codemods/codemod_0001-rename_has_async_property.ts"],"mappings":";;;qBAIa,wCAAsC;;cAgB7C,WAAW"}

package/build/codemods/codemod_0002-rename_async_query_fields.d.cts

@@ -1,9 +1,9 @@
 import { JscodeshiftMod } from "./JscodeshiftMod.cjs";
 import { Transform } from "jscodeshift";
 //#region src/codemods/codemod_0002-rename_async_query_fields.d.ts
-declare const codemod_0002_rename_async_query_fields: JscodeshiftMod;
+export declare const codemod_0002_rename_async_query_fields: JscodeshiftMod;
 /** Find/replace the async query symbols with their async property/field counterparts. */
 declare const transform: Transform;
 //#endregion
-export { codemod_0002_rename_async_query_fields, transform as default };
+export { transform as default };
 //# sourceMappingURL=codemod_0002-rename_async_query_fields.d.cts.map

package/build/codemods/codemod_0002-rename_async_query_fields.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"codemod_0002-rename_async_query_fields.d.cts","names":[],"sources":["../../src/codemods/codemod_0002-rename_async_query_fields.ts"],"mappings":";;;cAIa,wCAAsC;;cAoB7C,WAAW"}
+{"version":3,"file":"codemod_0002-rename_async_query_fields.d.cts","names":[],"sources":["../../src/codemods/codemod_0002-rename_async_query_fields.ts"],"mappings":";;;qBAIa,wCAAsC;;cAoB7C,WAAW"}

package/build/codemods/codemod_0002-rename_async_query_fields.d.mts

@@ -1,9 +1,9 @@
 import { JscodeshiftMod } from "./JscodeshiftMod.mjs";
 import { Transform } from "jscodeshift";
 //#region src/codemods/codemod_0002-rename_async_query_fields.d.ts
-declare const codemod_0002_rename_async_query_fields: JscodeshiftMod;
+export declare const codemod_0002_rename_async_query_fields: JscodeshiftMod;
 /** Find/replace the async query symbols with their async property/field counterparts. */
 declare const transform: Transform;
 //#endregion
-export { codemod_0002_rename_async_query_fields, transform as default };
+export { transform as default };
 //# sourceMappingURL=codemod_0002-rename_async_query_fields.d.mts.map

package/build/codemods/codemod_0002-rename_async_query_fields.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"codemod_0002-rename_async_query_fields.d.mts","names":[],"sources":["../../src/codemods/codemod_0002-rename_async_query_fields.ts"],"mappings":";;;cAIa,wCAAsC;;cAoB7C,WAAW"}
+{"version":3,"file":"codemod_0002-rename_async_query_fields.d.mts","names":[],"sources":["../../src/codemods/codemod_0002-rename_async_query_fields.ts"],"mappings":";;;qBAIa,wCAAsC;;cAoB7C,WAAW"}

package/build/codemods/codemod_0003-rename_find_paginated.d.cts

@@ -1,9 +1,9 @@
 import { JscodeshiftMod } from "./JscodeshiftMod.cjs";
 import { Transform } from "jscodeshift";
 //#region src/codemods/codemod_0003-rename_find_paginated.d.ts
-declare const codemod_0003_rename_find_paginated: JscodeshiftMod;
+export declare const codemod_0003_rename_find_paginated: JscodeshiftMod;
 /** Rewrites EntityManager paginated find method calls to the now-paginated find APIs. */
 declare const transform: Transform;
 //#endregion
-export { codemod_0003_rename_find_paginated, transform as default };
+export { transform as default };
 //# sourceMappingURL=codemod_0003-rename_find_paginated.d.cts.map

package/build/codemods/codemod_0003-rename_find_paginated.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"codemod_0003-rename_find_paginated.d.cts","names":[],"sources":["../../src/codemods/codemod_0003-rename_find_paginated.ts"],"mappings":";;;cAIa,oCAAkC;;cAYzC,WAAW"}
+{"version":3,"file":"codemod_0003-rename_find_paginated.d.cts","names":[],"sources":["../../src/codemods/codemod_0003-rename_find_paginated.ts"],"mappings":";;;qBAIa,oCAAkC;;cAYzC,WAAW"}

package/build/codemods/codemod_0003-rename_find_paginated.d.mts

@@ -1,9 +1,9 @@
 import { JscodeshiftMod } from "./JscodeshiftMod.mjs";
 import { Transform } from "jscodeshift";
 //#region src/codemods/codemod_0003-rename_find_paginated.d.ts
-declare const codemod_0003_rename_find_paginated: JscodeshiftMod;
+export declare const codemod_0003_rename_find_paginated: JscodeshiftMod;
 /** Rewrites EntityManager paginated find method calls to the now-paginated find APIs. */
 declare const transform: Transform;
 //#endregion
-export { codemod_0003_rename_find_paginated, transform as default };
+export { transform as default };
 //# sourceMappingURL=codemod_0003-rename_find_paginated.d.mts.map

package/build/codemods/codemod_0003-rename_find_paginated.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"codemod_0003-rename_find_paginated.d.mts","names":[],"sources":["../../src/codemods/codemod_0003-rename_find_paginated.ts"],"mappings":";;;cAIa,oCAAkC;;cAYzC,WAAW"}
+{"version":3,"file":"codemod_0003-rename_find_paginated.d.mts","names":[],"sources":["../../src/codemods/codemod_0003-rename_find_paginated.ts"],"mappings":";;;qBAIa,oCAAkC;;cAYzC,WAAW"}

package/build/codemods/index.d.cts

@@ -2,11 +2,10 @@ 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>;
+export declare function maybeRunTransforms(config: Config): Promise<void>;
 /** Returns the highest codemod counter known by this version of codegen. */
-declare function getLatestCodemodVersion(): number;
+export declare function getLatestCodemodVersion(): number;
 /** Returns codemods that have not yet been applied to the user's project. */
-declare function findApplicableCodemods(codemodVersion: number): Codemod[];
+export declare function findApplicableCodemods(codemodVersion: number): Codemod[];
 //#endregion
-export { findApplicableCodemods, getLatestCodemodVersion, maybeRunTransforms };
 //# sourceMappingURL=index.d.cts.map

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

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

package/build/codemods/index.d.mts

@@ -2,11 +2,10 @@ 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>;
+export declare function maybeRunTransforms(config: Config): Promise<void>;
 /** Returns the highest codemod counter known by this version of codegen. */
-declare function getLatestCodemodVersion(): number;
+export declare function getLatestCodemodVersion(): number;
 /** Returns codemods that have not yet been applied to the user's project. */
-declare function findApplicableCodemods(codemodVersion: number): Codemod[];
+export declare function findApplicableCodemods(codemodVersion: number): Codemod[];
 //#endregion
-export { findApplicableCodemods, getLatestCodemodVersion, maybeRunTransforms };
 //# sourceMappingURL=index.d.mts.map

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

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

package/build/config.cjs

@@ -25,8 +25,13 @@ const fieldConfig = zod.z.object({
 	stiType: zod.z.optional(zod.z.union([zod.z.string(), zod.z.array(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();
+	lazy: zod.z.optional(zod.z.boolean()),
+	/** Mark the entity for read locking whenever the field's value is read. */
+	assertUnchanged: zod.z.optional(zod.z.boolean())
+}).strict().refine((field) => !field.assertUnchanged || !field.derived && !field.lazy && !field.ignore, {
+	message: "assertUnchanged requires a non-derived, non-lazy, non-ignored field",
+	path: ["assertUnchanged"]
+});
 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)])),
@@ -209,7 +214,7 @@ function warnInvalidConfigEntries(config, db) {
 		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 === "primitive" && (field.derived || 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}`);
 		}
 	}

package/build/config.cjs.map

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

package/build/config.d.cts

@@ -14,8 +14,9 @@ declare const fieldConfig: z.ZodObject<{
   notNull: z.ZodOptional<z.ZodBoolean>;
   hasDefault: z.ZodOptional<z.ZodBoolean>;
   lazy: z.ZodOptional<z.ZodBoolean>;
+  assertUnchanged: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
-type FieldConfig = z.infer<typeof fieldConfig>;
+export type FieldConfig = z.infer<typeof fieldConfig>;
 declare const relationConfig: z.ZodObject<{
   derived: z.ZodOptional<z.ZodLiteral<"async">>;
   polymorphic: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"notNull">, z.ZodLiteral<true>]>>;
@@ -28,7 +29,7 @@ declare const relationConfig: z.ZodObject<{
   notNull: z.ZodOptional<z.ZodBoolean>;
   hasDefault: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
-type RelationConfig = z.infer<typeof relationConfig>;
+export type RelationConfig = z.infer<typeof relationConfig>;
 declare const entityConfig: z.ZodObject<{
   tag: z.ZodString;
   tableName: z.ZodOptional<z.ZodString>;
@@ -45,6 +46,7 @@ declare const entityConfig: z.ZodObject<{
     notNull: z.ZodOptional<z.ZodBoolean>;
     hasDefault: z.ZodOptional<z.ZodBoolean>;
     lazy: z.ZodOptional<z.ZodBoolean>;
+    assertUnchanged: z.ZodOptional<z.ZodBoolean>;
   }, z.core.$strict>>>;
   relations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
     derived: z.ZodOptional<z.ZodLiteral<"async">>;
@@ -62,13 +64,13 @@ declare const entityConfig: z.ZodObject<{
   orderBy: z.ZodOptional<z.ZodString>;
   uniqueBy: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodArray<z.ZodString>>]>, z.ZodTransform<string[][], string | string[] | string[][]>>>;
 }, z.core.$strict>;
-type EntityConfig = z.infer<typeof entityConfig>;
+export type EntityConfig = z.infer<typeof entityConfig>;
 declare const timestampConfig: z.ZodObject<{
   names: z.ZodArray<z.ZodString>;
   required: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
-type TimestampConfig = z.infer<typeof timestampConfig>;
-declare const config: z.ZodObject<{
+export type TimestampConfig = z.infer<typeof timestampConfig>;
+export declare const config: z.ZodObject<{
   databaseUrl: z.ZodOptional<z.ZodString>;
   contextType: z.ZodOptional<z.ZodString>;
   transactionType: z.ZodOptional<z.ZodString>;
@@ -108,6 +110,7 @@ declare const config: z.ZodObject<{
       notNull: z.ZodOptional<z.ZodBoolean>;
       hasDefault: z.ZodOptional<z.ZodBoolean>;
       lazy: z.ZodOptional<z.ZodBoolean>;
+      assertUnchanged: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
     relations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
       derived: z.ZodOptional<z.ZodLiteral<"async">>;
@@ -138,44 +141,44 @@ declare const config: z.ZodObject<{
   codemodVersion: z.ZodDefault<z.ZodNumber>;
   schemas: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
-type Config = z.infer<typeof config> & {
+export type Config = z.infer<typeof config> & {
   __tableToEntityName?: Record<string, string>;
 };
-declare const ormMaintainedFields: string[];
+export declare const ormMaintainedFields: string[];
 /** Ensure the user doesn't have any typos in their config. */
-declare function warnInvalidConfigEntries(config: Config, db: DbMetadata): void;
-declare function isGetterField(config: Config, entity: Entity, fieldName: string): boolean;
-declare function isReactiveField(config: Config, entity: Entity, fieldName: string): boolean;
-declare function isReactiveReference(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function warnInvalidConfigEntries(config: Config, db: DbMetadata): void;
+export declare function isGetterField(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function isReactiveField(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function isReactiveReference(config: Config, entity: Entity, fieldName: string): boolean;
 /** Returns true if this m2m relation is configured as a ReactiveManyToMany (derived: async). */
-declare function isReactiveManyToMany(config: Config, entity: Entity, fieldName: string): boolean;
-declare function isProtected(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function isReactiveManyToMany(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function isProtected(config: Config, entity: Entity, fieldName: string): boolean;
 /** Whether a column should be excluded from the default SELECT and exposed as a lazy-loaded `LazyField`. */
-declare function isLazyField(config: Config, entity: Entity, fieldName: string): boolean;
-declare function serdeConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
-declare function superstructConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
-declare function zodSchemaConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
-declare function fieldTypeConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
-declare function isLargeCollection(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function isLazyField(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function serdeConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
+export declare function superstructConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
+export declare function zodSchemaConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
+export declare function fieldTypeConfig(config: Config, entity: Entity, fieldName: string): string | undefined;
+export declare function isLargeCollection(config: Config, entity: Entity, fieldName: string): boolean;
 /** Whether a collection should include (or exclude) soft-deleted entities from `.get`/`.load`. */
-declare function softDeletesConfig(config: Config, entity: Entity, fieldName: string): "include" | "exclude" | undefined;
-declare function isFieldIgnored(config: Config, entity: Entity, fieldName: string, notNull?: boolean, hasDefault?: boolean): boolean;
-declare function isFieldHasDefault(config: Config, entity: Entity, fieldName: string): boolean;
-declare function loadConfig(): Promise<Config>;
+export declare function softDeletesConfig(config: Config, entity: Entity, fieldName: string): "include" | "exclude" | undefined;
+export declare function isFieldIgnored(config: Config, entity: Entity, fieldName: string, notNull?: boolean, hasDefault?: boolean): boolean;
+export declare function isFieldHasDefault(config: Config, entity: Entity, fieldName: string): boolean;
+export declare function loadConfig(): Promise<Config>;
 /**
  * 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.
  */
-declare function writeConfig(config: Config): Promise<void>;
-declare function stripStiPlaceholders(config: Config, entities: EntityDbMetadata[]): void;
+export declare function writeConfig(config: Config): Promise<void>;
+export declare function stripStiPlaceholders(config: Config, entities: EntityDbMetadata[]): void;
 /** Applies defaults to the timestamp config. */
-declare function getTimestampConfig(config: Config): {
+export declare function getTimestampConfig(config: Config): {
   updatedAtConf: Required<TimestampConfig>;
   createdAtConf: Required<TimestampConfig>;
   deletedAtConf: Required<TimestampConfig>;
 };
 //#endregion
-export { Config, EntityConfig, FieldConfig, RelationConfig, TimestampConfig, config, fieldTypeConfig, getTimestampConfig, isFieldHasDefault, isFieldIgnored, isGetterField, isLargeCollection, isLazyField, isProtected, isReactiveField, isReactiveManyToMany, isReactiveReference, loadConfig, ormMaintainedFields, serdeConfig, softDeletesConfig, stripStiPlaceholders, superstructConfig, warnInvalidConfigEntries, writeConfig, zodSchemaConfig };
+export {};
 //# sourceMappingURL=config.d.cts.map

package/build/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;cAiBM,aAAW,EAAA;;;;;;;;;;;;;GAmBN,EAAA,KAAA;KAEC,cAAc,EAAE,aAAa;cAEnC,gBAAc,EAAA;;;;;;;;;;;GA8BT,EAAA,KAAA;KAEC,iBAAiB,EAAE,aAAa;cAMtC,cAAY,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAWP,EAAA,KAAA;KAEC,eAAe,EAAE,aAAa;cAEpC,iBAAe,EAAA;;;GAOV,EAAA,KAAA;KAEC,kBAAkB,EAAE,aAAa;cAEhC,QAAM,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqER,EAAA,KAAA;KAEC,SAAS,EAAE,aAAa;EAElC,sBAAsB;;cAGX;;iBAGG,yBAAyB,QAAQ,QAAQ,IAAI;iBA2F7C,cAAc,QAAQ,QAAQ,QAAQ,QAAQ;iBAI9C,gBAAgB,QAAQ,QAAQ,QAAQ,QAAQ;iBAIhD,oBAAoB,QAAQ,QAAQ,QAAQ,QAAQ;;iBAKpD,qBAAqB,QAAQ,QAAQ,QAAQ,QAAQ;iBAIrD,YAAY,QAAQ,QAAQ,QAAQ,QAAQ;;iBAK5C,YAAY,QAAQ,QAAQ,QAAQ,QAAQ;iBAI5C,YAAY,QAAQ,QAAQ,QAAQ,QAAQ;iBAI5C,kBAAkB,QAAQ,QAAQ,QAAQ,QAAQ;iBAIlD,gBAAgB,QAAQ,QAAQ,QAAQ,QAAQ;iBAIhD,gBAAgB,QAAQ,QAAQ,QAAQ,QAAQ;iBAIhD,kBAAkB,QAAQ,QAAQ,QAAQ,QAAQ;;iBAKlD,kBACd,QAAQ,QACR,QAAQ,QACR;iBAKc,eACd,QAAQ,QACR,QAAQ,QACR,mBACA,mBACA;iBAWc,kBAAkB,QAAQ,QAAQ,QAAQ,QAAQ;iBAQ5C,cAAc,QAAQ;;;;;;;iBA2BtB,YAAY,QAAQ,SAAS;iBAYnC,qBAAqB,QAAQ,QAAQ,UAAU;;iBAY/C,mBAAmB,QAAQ;EACzC,eAAe,SAAS;EACxB,eAAe,SAAS;EACxB,eAAe,SAAS"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../src/config.ts"],"mappings":";;;cAiBM,aAAW,EAAA;;;;;;;;;;;;;;GAyBb,EAAA,KAAA;YAEQ,cAAc,EAAE,aAAa;cAEnC,gBAAc,EAAA;;;;;;;;;;;GA8BT,EAAA,KAAA;YAEC,iBAAiB,EAAE,aAAa;cAMtC,cAAY,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAWP,EAAA,KAAA;YAEC,eAAe,EAAE,aAAa;cAEpC,iBAAe,EAAA;;;GAOV,EAAA,KAAA;YAEC,kBAAkB,EAAE,aAAa;qBAEhC,QAAM,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqER,EAAA,KAAA;YAEC,SAAS,EAAE,aAAa;EAElC,sBAAsB;;qBAGX;;wBAGG,yBAAyB,QAAQ,QAAQ,IAAI;wBA2F7C,cAAc,QAAQ,QAAQ,QAAQ,QAAQ;wBAI9C,gBAAgB,QAAQ,QAAQ,QAAQ,QAAQ;wBAIhD,oBAAoB,QAAQ,QAAQ,QAAQ,QAAQ;;wBAKpD,qBAAqB,QAAQ,QAAQ,QAAQ,QAAQ;wBAIrD,YAAY,QAAQ,QAAQ,QAAQ,QAAQ;;wBAK5C,YAAY,QAAQ,QAAQ,QAAQ,QAAQ;wBAI5C,YAAY,QAAQ,QAAQ,QAAQ,QAAQ;wBAI5C,kBAAkB,QAAQ,QAAQ,QAAQ,QAAQ;wBAIlD,gBAAgB,QAAQ,QAAQ,QAAQ,QAAQ;wBAIhD,gBAAgB,QAAQ,QAAQ,QAAQ,QAAQ;wBAIhD,kBAAkB,QAAQ,QAAQ,QAAQ,QAAQ;;wBAKlD,kBACd,QAAQ,QACR,QAAQ,QACR;wBAKc,eACd,QAAQ,QACR,QAAQ,QACR,mBACA,mBACA;wBAWc,kBAAkB,QAAQ,QAAQ,QAAQ,QAAQ;wBAQ5C,cAAc,QAAQ;;;;;;;wBA2BtB,YAAY,QAAQ,SAAS;wBAYnC,qBAAqB,QAAQ,QAAQ,UAAU;;wBAY/C,mBAAmB,QAAQ;EACzC,eAAe,SAAS;EACxB,eAAe,SAAS;EACxB,eAAe,SAAS"}