joist-codegen 2.4.0-next.4 → 2.4.0-next.40

package/build/config.d.mts

@@ -15,7 +15,7 @@ declare const fieldConfig: z.ZodObject<{
   hasDefault: z.ZodOptional<z.ZodBoolean>;
   lazy: 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 +28,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>;
@@ -62,13 +62,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>;
@@ -138,44 +138,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.mts.map

package/build/config.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","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.mts","names":[],"sources":["../src/config.ts"],"mappings":";;;cAiBM,aAAW,EAAA;;;;;;;;;;;;;GAmBN,EAAA,KAAA;YAEC,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"}

package/build/config.js

@@ -208,7 +208,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) logger.warn(`Found uniqueBy for non-existent or non-queryable field ${entityName}.${name}`);
-			else if (field.kind === "primitive" && (field.derived || field.isArray || field.customSerde)) logger.warn(`Found uniqueBy for unsupported primitive field ${entityName}.${name}`);
+			else if (field.kind === "primitive" && (field.derived || field.customSerde)) logger.warn(`Found uniqueBy for unsupported primitive field ${entityName}.${name}`);
 			else if (field.kind === "enum" && (field.derived || field.isArray)) logger.warn(`Found uniqueBy for unsupported enum field ${entityName}.${name}`);
 		}
 	}

package/build/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":["fs"],"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":";;;;;;;;;;;;;AAeA,MAAM,gBAAgB,iBAAiB,aAAa,QAAQ,CAAC,CAAC;AAE9D,MAAM,cAAc,EACjB,OAAO;CAEN,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,MAAM,GAAG,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC;CACpE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC;CACjC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;CAC9B,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC;CAClC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;CAChC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;CAC3B,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC;CAC5B,kBAAkB,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,CAAC;CAC7D,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAE9D,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;CAE/B,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;CAElC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;AAC9B,CAAC,CAAC,CACD,OAAO;AAIV,MAAM,iBAAiB,EACpB,OAAO;CAEN,SAAS,EAAE,SAAS,EAAE,QAAQ,OAAO,CAAC;CACtC,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,SAAS,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC;CACxE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC;CAC7B,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;;;;;;;CAO9B,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,SAAS,GAAG,EAAE,QAAQ,SAAS,CAAC,CAAC,CAAC;CAE7E,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;;;;;;;CAO9D,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;;CAE9B,wBAAwB,EAAE,SAAS,EAAE,QAAQ,CAAC;CAE9C,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;CAE/B,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;AACpC,CAAC,CAAC,CACD,OAAO;AAIV,MAAM,iBAAiB,EACpB,MAAM;CAAC,EAAE,OAAO;CAAG,EAAE,MAAM,EAAE,OAAO,CAAC;CAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAAC,CAAC,CAAC,CACtE,UAAU,uBAAuB;AAEpC,MAAM,eAAe,EAClB,OAAO;CACN,KAAK,EAAE,OAAO;CACd,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;CAChC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAAC;CACpD,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC;;CAE1D,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;CAChC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC;CAC9B,UAAU,EAAE,SAAS,cAAc;AACrC,CAAC,CAAC,CACD,OAAO;AAIV,MAAM,kBAAkB,EACrB,OAAO;;CAEN,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC;;CAEzB,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC;AAClC,CAAC,CAAC,CACD,OAAO;AAIV,MAAa,SAAS,EACnB,OAAO;;CAEN,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC;;CAElC,aAAa,EAAE,SAAS,EAAE,OAAO,CAAC;;CAElC,iBAAiB,EAAE,SAAS,EAAE,OAAO,CAAC;;;;;;;;;;CAUtC,kBAAkB,EAAE,SAClB,EAAE,OAAO;EACP,WAAW,EAAE,SAAS,eAAe;EACrC,WAAW,EAAE,SAAS,eAAe;EACrC,WAAW,EAAE,SAAS,eAAe;CACvC,CAAC,CACH;;;;;;;CAOA,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;CAU/E,qBAAqB,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CAC3E,mBAAmB,EAAE,OAAO,CAAC,CAAC,QAAQ,gBAAgB;CACtD,gBAAgB,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC;CACvD,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;;CAE7C,QAAQ,EAAE,SAAS,EAAE,MAAM;EAAC,EAAE,QAAQ,eAAe;EAAG,EAAE,QAAQ,iBAAiB;EAAG,EAAE,QAAQ,QAAQ;CAAC,CAAC,CAAC;;CAE3G,cAAc,EAAE,SAAS,EAAE,OAAO,CAAC;;CAEnC,wBAAwB,EAAE,SAAS,EAAE,MAAM;EAAC,EAAE,QAAQ,OAAO;EAAG,EAAE,QAAQ,MAAM;EAAG,EAAE,QAAQ,QAAQ;CAAC,CAAC,CAAC;;CAExG,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC;;CAE3B,iBAAiB,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,QAAQ,QAAQ,GAAG,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,QAAQ;;CAEhG,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC;;CAE5B,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;;CAE9B,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAC;;CAElC,4BAA4B,EAAE,SAAS,EAAE,QAAQ,CAAC;;CAElD,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;;CAGjD,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC,CAAC,CACD,OAAO;AAOV,MAAa,sBAAsB,CAAC,aAAa,WAAW;;AAG5D,SAAgB,yBAAyB,QAAgB,IAAsB;CAC7E,MAAM,iBAAiB,QAAQ,GAAG,WAAW,MAAM,EAAE,IAAI;CACzD,KAAK,MAAM,CAAC,YAAY,iBAAiB,OAAO,QAAQ,OAAO,QAAQ,GAAG;EACxE,MAAM,WAAW,eAAe;EAChC,IAAI,CAAC,UAAU;GACb,OAAO,KAAK,wCAAwC,YAAY;GAChE;EACF;EAEA,MAAM,CAAC,UAAU;EAGjB,MAAM,SAAS,CAAC,GAAG,OAAO,YAAY,GAAG,OAAO,KAAK;EACrD,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,aAAa,UAAU,CAAC,CAAC,GAAG;GACtE,IAAI,OAAO,QAAQ;GACnB,IAAI,QAAQ,OAAO,MAAM,MAAM,EAAE,cAAc,IAAI;GAEnD,IAAI,CAAC,SAAS,OAAO,uBAEnB,SADoB,eAAe,GAAG,QAAQ,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,SAAA,EAC7C,SAAS,OAAO,CAAC,GAAG,GAAG,YAAY,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,cAAc,IAAI;GAExG,IAAI,CAAC,OAAO,OAAO,KAAK,uCAAuC,WAAW,GAAG,MAAM;EACrF;EAGA,MAAM,YAAY;GAChB,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;EACZ;EACA,KAAK,MAAM,CAAC,MAAM,MAAM,OAAO,QAAQ,aAAa,aAAa,CAAC,CAAC,GAAG;GACpE,IAAI,WAAW,UAAU,MAAM,MAAM,EAAE,cAAc,IAAI;GAEzD,IAAI,CAAC,YAAY,OAAO,uBAEtB,YADoB,eAAe,GAAG,QAAQ,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,SAAA,EAE9D,SAAS,WAAW;IACpB,GAAG,OAAO;IACV,GAAG,OAAO;IACV,GAAG,OAAO;IACV,GAAG,OAAO;IACV,GAAG,OAAO;IACV,GAAG,OAAO;IACV,GAAG,OAAO;GACZ,CAAC,CAAC,EACA,MAAM,MAAM,EAAE,cAAc,IAAI;GAGtC,IAAI,CAAC,YAAY,OAAO,UAAU;IAChC,MAAM,WAAW,OAAO;IACxB,WAAW;KACT,GAAG,SAAS;KACZ,GAAG,SAAS;KACZ,GAAG,SAAS;KACZ,GAAG,SAAS;KACZ,GAAG,SAAS;KACZ,GAAG,SAAS;KACZ,GAAG,SAAS;IACd,CAAC,CAAC,MAAM,MAAM,EAAE,cAAc,IAAI;GACpC;GAEA,IAAI,CAAC,UAAU,OAAO,KAAK,0CAA0C,WAAW,GAAG,MAAM;EAC3F;EAEA,MAAM,eAAe;GACnB,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;GACV,GAAG,OAAO;EACZ;EACA,KAAK,MAAM,YAAY,aAAa,YAAY,CAAC,GAC/C,KAAK,MAAM,QAAQ,UAAU;GAC3B,MAAM,QAAQ,aAAa,MAAM,MAAM,EAAE,cAAc,IAAI;GAC3D,IAAI,CAAC,OACH,OAAO,KAAK,0DAA0D,WAAW,GAAG,MAAM;QACrF,IAAI,MAAM,SAAS,gBAAgB,MAAM,WAAW,MAAM,WAAW,MAAM,cAChF,OAAO,KAAK,kDAAkD,WAAW,GAAG,MAAM;QAC7E,IAAI,MAAM,SAAS,WAAW,MAAM,WAAW,MAAM,UAC1D,OAAO,KAAK,6CAA6C,WAAW,GAAG,MAAM;EAEjF;CAEJ;AACF;AAEA,SAAgB,cAAc,QAAgB,QAAgB,WAA4B;CACxF,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE,YAAY;AACxE;AAEA,SAAgB,gBAAgB,QAAgB,QAAgB,WAA4B;CAC1F,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE,YAAY;AACxE;AAEA,SAAgB,oBAAoB,QAAgB,QAAgB,WAA4B;CAC9F,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,YAAY,UAAU,EAAE,YAAY;AAC3E;;AAGA,SAAgB,qBAAqB,QAAgB,QAAgB,WAA4B;CAC/F,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,YAAY,UAAU,EAAE,YAAY;AAC3E;AAEA,SAAgB,YAAY,QAAgB,QAAgB,WAA4B;CACtF,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE,cAAc;AAC1E;;AAGA,SAAgB,YAAY,QAAgB,QAAgB,WAA4B;CACtF,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE,SAAS;AACrE;AAEA,SAAgB,YAAY,QAAgB,QAAgB,WAAuC;CACjG,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE;AAC5D;AAEA,SAAgB,kBAAkB,QAAgB,QAAgB,WAAuC;CACvG,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE;AAC5D;AAEA,SAAgB,gBAAgB,QAAgB,QAAgB,WAAuC;CACrG,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE;AAC5D;AAEA,SAAgB,gBAAgB,QAAgB,QAAgB,WAAuC;CACrG,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE;AAC5D;AAEA,SAAgB,kBAAkB,QAAgB,QAAgB,WAA4B;CAC5F,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,YAAY,UAAU,EAAE,UAAU;AACzE;;AAGA,SAAgB,kBACd,QACA,QACA,WACmC;CACnC,OAAO,OAAO,SAAS,OAAO,KAAK,EAAE,YAAY,UAAU,EAAE;AAC/D;AAEA,SAAgB,eACd,QACA,QACA,WACA,UAAmB,OACnB,aAAsB,OACb;CACT,MAAM,SAAS,OAAO,SAAS,OAAO,KAAK,EAAE,SAAS,UAAU,EAAE,WAAW;CAC7E,IAAI,UAAU,WAAW,CAAC,YACxB,KACE,iBAAiB,OAAO,KAAK,GAAG,UAAU,kGAC5C;CAEF,OAAO;AACT;AAEA,SAAgB,kBAAkB,QAAgB,QAAgB,WAA4B;CAC5F,MAAM,eAAe,OAAO,SAAS,OAAO,SAAS,CAAC;CAEtD,QADoB,aAAa,SAAS,cAAc,aAAa,YAAY,cAAc,CAAC,EAAA,CAC7E,eAAe;AACpC;AAEA,MAAM,aAAa;AAEnB,eAAsB,aAA8B;CAElD,IAAI,MADiB,eAAeA,SAAG,OAAO,UAAU,CAAC,GAC7C;EACV,MAAM,UAAU,MAAMA,SAAG,SAAS,UAAU;EAC5C,MAAM,SAAS,OAAO,UAAU,sBAAsB,KAAK,MAAM,QAAQ,SAAS,CAAC,CAAC,CAAC;EACrF,IAAI,CAAC,OAAO,SACV,MAAM,IAAI,MACR,8BAA8B,OAAO,MAAM,OACxC,KAAK,OAAO,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,KAAK,GAAG,EAAE,GAAG,GAAG,SAAS,CAAC,CAC7D,KAAK,IAAI,GACd;EAEF,OAAO,KAAK,+BAA+B,6BAA6B;EACxE,OAAO,OAAO;CAChB;CAEA,MAAM,UAAU,OAAO,MAAM,EAAE,gBAAgB,wBAAwB,EAAE,CAAC;CAC1E,QAAQ,+BAA+B,6BAA6B;CACpE,OAAO;AACT;;;;;;;AAQA,eAAsB,YAAY,QAA+B;CAC/D,MAAM,SAA0B,SAAS,MAAM;CAC/C,OAAO,OAAO;CACd,OAAO,OAAO;CACd,IAAI,OAAO,oBAAoB,UAC7B,OAAO,OAAO;CAEhB,MAAM,QAAQ,KAAK,UAAU,MAAM;CACnC,MAAM,UAAU,cAAc,WAAW;EAAE,UAAU;EAAa,UAAU;CAAM,CAAC;CACnF,MAAMA,SAAG,UAAU,YAAY,OAAO;AACxC;AAEA,SAAgB,qBAAqB,QAAgB,UAAoC;CAIvF,KAAK,MAAM,UAAU,UACnB,IAAI,OAAO,oBAAoB,SAAS,OAAO,uBAC7C,OAAO,OAAO,SAAS,OAAO;AAGpC;;AAGA,SAAgB,mBAAmB,QAIjC;CACA,OAAO;EACL,eAAe;GACb,OAAO,CAAC,cAAc,WAAW;GACjC,UAAU;GACV,GAAG,QAAQ,kBAAkB;EAC/B;EACA,eAAe;GACb,OAAO,CAAC,cAAc,WAAW;GACjC,UAAU;GACV,GAAG,QAAQ,kBAAkB;EAC/B;EACA,eAAe;GACb,OAAO,CAAC,cAAc,WAAW;GACjC,UAAU;GACV,GAAG,QAAQ,kBAAkB;EAC/B;CACF;AACF;AAEA,SAAS,+BAAwC;CAE/C,MAAM,aAAa,iBAAiB,QAAQ,IAAI,CAAC;CACjD,IAAI,CAAC,YACH,OAAO;CAET,IAAI;EAGF,MAAM,SAAuB,CAAC;EAC9B,MAAM,SAAkB,MAAM,aAAa,YAAY,MAAM,GAAG,QAAQ,EAAE,oBAAoB,KAAK,CAAC;EACpG,IAAI,OAAO,SAAS,KAAK,OAAO,WAAW,YAAY,WAAW,QAAQ,MAAM,QAAQ,MAAM,GAAG,OAAO;EACxG,MAAM,kBAAmB,OAAmC;EAC5D,OACE,OAAO,oBAAoB,YAC3B,oBAAoB,QACpB,CAAC,MAAM,QAAQ,eAAe,KAC7B,gBAA4C,+BAA+B;CAEhF,QAAQ;EACN,OAAO;CACT;AACF;;AAGA,SAAS,wBAAwB,UAAsD;CACrF,IAAI,OAAO,aAAa,UAAU,OAAO,CAAC,CAAC,QAAQ,CAAC;CACpD,IAAI,SAAS,OAAO,UAAU,OAAO,UAAU,QAAQ,GAAG,OAAO,CAAC,QAAQ;CAC1E,OAAO;AACT;AAEA,SAAS,sBAAsB,KAAuB;CACpD,IAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,GAAG,GACtD,OAAO;CAGT,MAAM,SAAS,EAAE,GAAI,IAAgC;CACrD,OAAO,OAAO;CACd,OAAO;AACT;;AAGA,SAAS,iBAAiB,WAAuC;CAC/D,OAAO,MAAM;EACX,MAAM,WAAW,KAAK,WAAW,eAAe;EAChD,IAAI,WAAW,QAAQ,GAAG,OAAO;EACjC,MAAM,SAAS,QAAQ,SAAS;EAChC,IAAI,WAAW,WAAW,OAAO,KAAA;EACjC,YAAY;CACd;AACF"}
+{"version":3,"file":"config.js","names":["fs"],"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.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/docs/cache.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"cache.cjs","names":["join","tmpdir","#cachePath","#entries","createHash"],"sources":["../../src/docs/cache.ts"],"sourcesContent":["import { createHash } from \"crypto\";\nimport { promises as fs } from \"fs\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\n\nconst CACHE_VERSION = 1;\nconst CACHE_DIR = join(tmpdir(), \"joist-codegen-cache\");\n\n/** A tuple of .ts and .md mtimes for an entity, used for caching. */\ninterface CacheEntry {\n  tsMtime: number;\n  mdMtime: number; // -1 when .md doesn't exist\n}\n\n/** The shape of the JSON file we write to disk for caching per-entity file modification times. */\ninterface CacheFile {\n  version: number;\n  entities: Record<string, CacheEntry>;\n}\n\n/** A simple mtime-based cache for docs syncing, to skip processing when neither .ts nor .md has changed. */\nexport class DocsCache {\n  #entries: Record<string, CacheEntry>;\n  #cachePath: string;\n\n  private constructor(cachePath: string, entries: Record<string, CacheEntry>) {\n    this.#cachePath = cachePath;\n    this.#entries = entries;\n  }\n\n  static async load(): Promise<DocsCache> {\n    const cachePath = getCachePath();\n    try {\n      const raw = JSON.parse(await fs.readFile(cachePath, \"utf-8\")) as CacheFile;\n      if (raw.version === CACHE_VERSION) {\n        return new DocsCache(cachePath, raw.entities);\n      }\n    } catch {\n      // Missing or corrupt — start fresh\n    }\n    return new DocsCache(cachePath, {});\n  }\n\n  /** Returns true if both file mtimes match the cached values (i.e. skip processing). */\n  isUpToDate(entityName: string, tsMtime: number, mdMtime: number): boolean {\n    const cached = this.#entries[entityName];\n    return !!cached && cached.tsMtime === Math.floor(tsMtime) && cached.mdMtime === Math.floor(mdMtime);\n  }\n\n  /** Record the current mtimes for an entity after processing it. */\n  update(entityName: string, tsMtime: number, mdMtime: number): void {\n    this.#entries[entityName] = { tsMtime: Math.floor(tsMtime), mdMtime: Math.floor(mdMtime) };\n  }\n\n  async save(): Promise<void> {\n    const data: CacheFile = { version: CACHE_VERSION, entities: this.#entries };\n    await fs.mkdir(CACHE_DIR, { recursive: true });\n    await fs.writeFile(this.#cachePath, JSON.stringify(data), \"utf-8\");\n  }\n}\n\n/** Stat a file and return its mtimeMs, or -1 if it doesn't exist. */\nexport async function getMtime(filePath: string): Promise<number> {\n  try {\n    return (await fs.stat(filePath)).mtimeMs;\n  } catch {\n    return -1;\n  }\n}\n\nfunction getCachePath(): string {\n  const hash = createHash(\"sha256\").update(process.cwd()).digest(\"hex\").slice(0, 16);\n  return join(CACHE_DIR, `${hash}.json`);\n}\n"],"mappings":";;;;;;AAKA,MAAM,gBAAgB;AACtB,MAAM,aAAA,GAAYA,KAAAA,KAAAA,EAAAA,GAAKC,GAAAA,OAAAA,CAAO,GAAG,qBAAqB;;AAetD,IAAa,YAAb,MAAa,UAAU;CACrB;CACA;CAEA,YAAoB,WAAmB,SAAqC;EAC1E,KAAKC,aAAa;EAClB,KAAKC,WAAW;CAClB;CAEA,aAAa,OAA2B;EACtC,MAAM,YAAY,aAAa;EAC/B,IAAI;GACF,MAAM,MAAM,KAAK,MAAM,MAAM,GAAA,SAAG,SAAS,WAAW,OAAO,CAAC;GAC5D,IAAI,IAAI,YAAY,eAClB,OAAO,IAAI,UAAU,WAAW,IAAI,QAAQ;EAEhD,QAAQ,CAER;EACA,OAAO,IAAI,UAAU,WAAW,CAAC,CAAC;CACpC;;CAGA,WAAW,YAAoB,SAAiB,SAA0B;EACxE,MAAM,SAAS,KAAKA,SAAS;EAC7B,OAAO,CAAC,CAAC,UAAU,OAAO,YAAY,KAAK,MAAM,OAAO,KAAK,OAAO,YAAY,KAAK,MAAM,OAAO;CACpG;;CAGA,OAAO,YAAoB,SAAiB,SAAuB;EACjE,KAAKA,SAAS,cAAc;GAAE,SAAS,KAAK,MAAM,OAAO;GAAG,SAAS,KAAK,MAAM,OAAO;EAAE;CAC3F;CAEA,MAAM,OAAsB;EAC1B,MAAM,OAAkB;GAAE,SAAS;GAAe,UAAU,KAAKA;EAAS;EAC1E,MAAM,GAAA,SAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,MAAM,GAAA,SAAG,UAAU,KAAKD,YAAY,KAAK,UAAU,IAAI,GAAG,OAAO;CACnE;AACF;;AAGA,eAAsB,SAAS,UAAmC;CAChE,IAAI;EACF,QAAQ,MAAM,GAAA,SAAG,KAAK,QAAQ,EAAA,CAAG;CACnC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,eAAuB;CAC9B,MAAM,QAAA,GAAOE,OAAAA,WAAAA,CAAW,QAAQ,CAAC,CAAC,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;CACjF,QAAA,GAAOJ,KAAAA,KAAAA,CAAK,WAAW,GAAG,KAAK,MAAM;AACvC"}
+{"version":3,"file":"cache.cjs","names":["join","tmpdir","createHash"],"sources":["../../src/docs/cache.ts"],"sourcesContent":["import { createHash } from \"crypto\";\nimport { promises as fs } from \"fs\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\n\nconst CACHE_VERSION = 1;\nconst CACHE_DIR = join(tmpdir(), \"joist-codegen-cache\");\n\n/** A tuple of .ts and .md mtimes for an entity, used for caching. */\ninterface CacheEntry {\n  tsMtime: number;\n  mdMtime: number; // -1 when .md doesn't exist\n}\n\n/** The shape of the JSON file we write to disk for caching per-entity file modification times. */\ninterface CacheFile {\n  version: number;\n  entities: Record<string, CacheEntry>;\n}\n\n/** A simple mtime-based cache for docs syncing, to skip processing when neither .ts nor .md has changed. */\nexport class DocsCache {\n  #entries: Record<string, CacheEntry>;\n  #cachePath: string;\n\n  private constructor(cachePath: string, entries: Record<string, CacheEntry>) {\n    this.#cachePath = cachePath;\n    this.#entries = entries;\n  }\n\n  static async load(): Promise<DocsCache> {\n    const cachePath = getCachePath();\n    try {\n      const raw = JSON.parse(await fs.readFile(cachePath, \"utf-8\")) as CacheFile;\n      if (raw.version === CACHE_VERSION) {\n        return new DocsCache(cachePath, raw.entities);\n      }\n    } catch {\n      // Missing or corrupt — start fresh\n    }\n    return new DocsCache(cachePath, {});\n  }\n\n  /** Returns true if both file mtimes match the cached values (i.e. skip processing). */\n  isUpToDate(entityName: string, tsMtime: number, mdMtime: number): boolean {\n    const cached = this.#entries[entityName];\n    return !!cached && cached.tsMtime === Math.floor(tsMtime) && cached.mdMtime === Math.floor(mdMtime);\n  }\n\n  /** Record the current mtimes for an entity after processing it. */\n  update(entityName: string, tsMtime: number, mdMtime: number): void {\n    this.#entries[entityName] = { tsMtime: Math.floor(tsMtime), mdMtime: Math.floor(mdMtime) };\n  }\n\n  async save(): Promise<void> {\n    const data: CacheFile = { version: CACHE_VERSION, entities: this.#entries };\n    await fs.mkdir(CACHE_DIR, { recursive: true });\n    await fs.writeFile(this.#cachePath, JSON.stringify(data), \"utf-8\");\n  }\n}\n\n/** Stat a file and return its mtimeMs, or -1 if it doesn't exist. */\nexport async function getMtime(filePath: string): Promise<number> {\n  try {\n    return (await fs.stat(filePath)).mtimeMs;\n  } catch {\n    return -1;\n  }\n}\n\nfunction getCachePath(): string {\n  const hash = createHash(\"sha256\").update(process.cwd()).digest(\"hex\").slice(0, 16);\n  return join(CACHE_DIR, `${hash}.json`);\n}\n"],"mappings":";;;;;;AAKA,MAAM,gBAAgB;AACtB,MAAM,aAAA,GAAYA,KAAAA,KAAAA,EAAAA,GAAKC,GAAAA,OAAAA,CAAO,GAAG,qBAAqB;;AAetD,IAAa,YAAb,MAAa,UAAU;CACrB;CACA;CAEA,YAAoB,WAAmB,SAAqC;EAC1E,KAAK,aAAa;EAClB,KAAK,WAAW;CAClB;CAEA,aAAa,OAA2B;EACtC,MAAM,YAAY,aAAa;EAC/B,IAAI;GACF,MAAM,MAAM,KAAK,MAAM,MAAM,GAAA,SAAG,SAAS,WAAW,OAAO,CAAC;GAC5D,IAAI,IAAI,YAAY,eAClB,OAAO,IAAI,UAAU,WAAW,IAAI,QAAQ;EAEhD,QAAQ,CAER;EACA,OAAO,IAAI,UAAU,WAAW,CAAC,CAAC;CACpC;;CAGA,WAAW,YAAoB,SAAiB,SAA0B;EACxE,MAAM,SAAS,KAAK,SAAS;EAC7B,OAAO,CAAC,CAAC,UAAU,OAAO,YAAY,KAAK,MAAM,OAAO,KAAK,OAAO,YAAY,KAAK,MAAM,OAAO;CACpG;;CAGA,OAAO,YAAoB,SAAiB,SAAuB;EACjE,KAAK,SAAS,cAAc;GAAE,SAAS,KAAK,MAAM,OAAO;GAAG,SAAS,KAAK,MAAM,OAAO;EAAE;CAC3F;CAEA,MAAM,OAAsB;EAC1B,MAAM,OAAkB;GAAE,SAAS;GAAe,UAAU,KAAK;EAAS;EAC1E,MAAM,GAAA,SAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,MAAM,GAAA,SAAG,UAAU,KAAK,YAAY,KAAK,UAAU,IAAI,GAAG,OAAO;CACnE;AACF;;AAGA,eAAsB,SAAS,UAAmC;CAChE,IAAI;EACF,QAAQ,MAAM,GAAA,SAAG,KAAK,QAAQ,EAAA,CAAG;CACnC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,eAAuB;CAC9B,MAAM,QAAA,GAAOC,OAAAA,WAAAA,CAAW,QAAQ,CAAC,CAAC,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;CACjF,QAAA,GAAOF,KAAAA,KAAAA,CAAK,WAAW,GAAG,KAAK,MAAM;AACvC"}

package/build/docs/cache.d.cts

@@ -1,6 +1,6 @@
 //#region src/docs/cache.d.ts
 /** A simple mtime-based cache for docs syncing, to skip processing when neither .ts nor .md has changed. */
-declare class DocsCache {
+export declare class DocsCache {
   #private;
   private constructor();
   static load(): Promise<DocsCache>;
@@ -11,7 +11,6 @@ declare class DocsCache {
   save(): Promise<void>;
 }
 /** Stat a file and return its mtimeMs, or -1 if it doesn't exist. */
-declare function getMtime(filePath: string): Promise<number>;
+export declare function getMtime(filePath: string): Promise<number>;
 //#endregion
-export { DocsCache, getMtime };
 //# sourceMappingURL=cache.d.cts.map

package/build/docs/cache.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.cts","names":[],"sources":["../../src/docs/cache.ts"],"mappings":";;cAqBa;;UAIJ;SAKM,QAAQ,QAAQ;;EAc7B,WAAW,oBAAoB,iBAAiB;;EAMhD,OAAO,oBAAoB,iBAAiB;EAItC,QAAQ;;;iBAQM,SAAS,mBAAmB"}
+{"version":3,"file":"cache.d.cts","names":[],"sources":["../../src/docs/cache.ts"],"mappings":";;qBAqBa;;UAIJ;SAKM,QAAQ,QAAQ;;EAc7B,WAAW,oBAAoB,iBAAiB;;EAMhD,OAAO,oBAAoB,iBAAiB;EAItC,QAAQ;;;wBAQM,SAAS,mBAAmB"}

package/build/docs/cache.d.mts

@@ -1,6 +1,6 @@
 //#region src/docs/cache.d.ts
 /** A simple mtime-based cache for docs syncing, to skip processing when neither .ts nor .md has changed. */
-declare class DocsCache {
+export declare class DocsCache {
   #private;
   private constructor();
   static load(): Promise<DocsCache>;
@@ -11,7 +11,6 @@ declare class DocsCache {
   save(): Promise<void>;
 }
 /** Stat a file and return its mtimeMs, or -1 if it doesn't exist. */
-declare function getMtime(filePath: string): Promise<number>;
+export declare function getMtime(filePath: string): Promise<number>;
 //#endregion
-export { DocsCache, getMtime };
 //# sourceMappingURL=cache.d.mts.map

package/build/docs/cache.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.mts","names":[],"sources":["../../src/docs/cache.ts"],"mappings":";;cAqBa;;UAIJ;SAKM,QAAQ,QAAQ;;EAc7B,WAAW,oBAAoB,iBAAiB;;EAMhD,OAAO,oBAAoB,iBAAiB;EAItC,QAAQ;;;iBAQM,SAAS,mBAAmB"}
+{"version":3,"file":"cache.d.mts","names":[],"sources":["../../src/docs/cache.ts"],"mappings":";;qBAqBa;;UAIJ;SAKM,QAAQ,QAAQ;;EAc7B,WAAW,oBAAoB,iBAAiB;;EAMhD,OAAO,oBAAoB,iBAAiB;EAItC,QAAQ;;;wBAQM,SAAS,mBAAmB"}

package/build/docs/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","names":["#cachePath","#entries","fs"],"sources":["../../src/docs/cache.ts"],"sourcesContent":["import { createHash } from \"crypto\";\nimport { promises as fs } from \"fs\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\n\nconst CACHE_VERSION = 1;\nconst CACHE_DIR = join(tmpdir(), \"joist-codegen-cache\");\n\n/** A tuple of .ts and .md mtimes for an entity, used for caching. */\ninterface CacheEntry {\n  tsMtime: number;\n  mdMtime: number; // -1 when .md doesn't exist\n}\n\n/** The shape of the JSON file we write to disk for caching per-entity file modification times. */\ninterface CacheFile {\n  version: number;\n  entities: Record<string, CacheEntry>;\n}\n\n/** A simple mtime-based cache for docs syncing, to skip processing when neither .ts nor .md has changed. */\nexport class DocsCache {\n  #entries: Record<string, CacheEntry>;\n  #cachePath: string;\n\n  private constructor(cachePath: string, entries: Record<string, CacheEntry>) {\n    this.#cachePath = cachePath;\n    this.#entries = entries;\n  }\n\n  static async load(): Promise<DocsCache> {\n    const cachePath = getCachePath();\n    try {\n      const raw = JSON.parse(await fs.readFile(cachePath, \"utf-8\")) as CacheFile;\n      if (raw.version === CACHE_VERSION) {\n        return new DocsCache(cachePath, raw.entities);\n      }\n    } catch {\n      // Missing or corrupt — start fresh\n    }\n    return new DocsCache(cachePath, {});\n  }\n\n  /** Returns true if both file mtimes match the cached values (i.e. skip processing). */\n  isUpToDate(entityName: string, tsMtime: number, mdMtime: number): boolean {\n    const cached = this.#entries[entityName];\n    return !!cached && cached.tsMtime === Math.floor(tsMtime) && cached.mdMtime === Math.floor(mdMtime);\n  }\n\n  /** Record the current mtimes for an entity after processing it. */\n  update(entityName: string, tsMtime: number, mdMtime: number): void {\n    this.#entries[entityName] = { tsMtime: Math.floor(tsMtime), mdMtime: Math.floor(mdMtime) };\n  }\n\n  async save(): Promise<void> {\n    const data: CacheFile = { version: CACHE_VERSION, entities: this.#entries };\n    await fs.mkdir(CACHE_DIR, { recursive: true });\n    await fs.writeFile(this.#cachePath, JSON.stringify(data), \"utf-8\");\n  }\n}\n\n/** Stat a file and return its mtimeMs, or -1 if it doesn't exist. */\nexport async function getMtime(filePath: string): Promise<number> {\n  try {\n    return (await fs.stat(filePath)).mtimeMs;\n  } catch {\n    return -1;\n  }\n}\n\nfunction getCachePath(): string {\n  const hash = createHash(\"sha256\").update(process.cwd()).digest(\"hex\").slice(0, 16);\n  return join(CACHE_DIR, `${hash}.json`);\n}\n"],"mappings":";;;;;AAKA,MAAM,gBAAgB;AACtB,MAAM,YAAY,KAAK,OAAO,GAAG,qBAAqB;;AAetD,IAAa,YAAb,MAAa,UAAU;CACrB;CACA;CAEA,YAAoB,WAAmB,SAAqC;EAC1E,KAAKA,aAAa;EAClB,KAAKC,WAAW;CAClB;CAEA,aAAa,OAA2B;EACtC,MAAM,YAAY,aAAa;EAC/B,IAAI;GACF,MAAM,MAAM,KAAK,MAAM,MAAMC,SAAG,SAAS,WAAW,OAAO,CAAC;GAC5D,IAAI,IAAI,YAAY,eAClB,OAAO,IAAI,UAAU,WAAW,IAAI,QAAQ;EAEhD,QAAQ,CAER;EACA,OAAO,IAAI,UAAU,WAAW,CAAC,CAAC;CACpC;;CAGA,WAAW,YAAoB,SAAiB,SAA0B;EACxE,MAAM,SAAS,KAAKD,SAAS;EAC7B,OAAO,CAAC,CAAC,UAAU,OAAO,YAAY,KAAK,MAAM,OAAO,KAAK,OAAO,YAAY,KAAK,MAAM,OAAO;CACpG;;CAGA,OAAO,YAAoB,SAAiB,SAAuB;EACjE,KAAKA,SAAS,cAAc;GAAE,SAAS,KAAK,MAAM,OAAO;GAAG,SAAS,KAAK,MAAM,OAAO;EAAE;CAC3F;CAEA,MAAM,OAAsB;EAC1B,MAAM,OAAkB;GAAE,SAAS;GAAe,UAAU,KAAKA;EAAS;EAC1E,MAAMC,SAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,MAAMA,SAAG,UAAU,KAAKF,YAAY,KAAK,UAAU,IAAI,GAAG,OAAO;CACnE;AACF;;AAGA,eAAsB,SAAS,UAAmC;CAChE,IAAI;EACF,QAAQ,MAAME,SAAG,KAAK,QAAQ,EAAA,CAAG;CACnC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,eAAuB;CAC9B,MAAM,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;CACjF,OAAO,KAAK,WAAW,GAAG,KAAK,MAAM;AACvC"}
+{"version":3,"file":"cache.js","names":["fs"],"sources":["../../src/docs/cache.ts"],"sourcesContent":["import { createHash } from \"crypto\";\nimport { promises as fs } from \"fs\";\nimport { tmpdir } from \"os\";\nimport { join } from \"path\";\n\nconst CACHE_VERSION = 1;\nconst CACHE_DIR = join(tmpdir(), \"joist-codegen-cache\");\n\n/** A tuple of .ts and .md mtimes for an entity, used for caching. */\ninterface CacheEntry {\n  tsMtime: number;\n  mdMtime: number; // -1 when .md doesn't exist\n}\n\n/** The shape of the JSON file we write to disk for caching per-entity file modification times. */\ninterface CacheFile {\n  version: number;\n  entities: Record<string, CacheEntry>;\n}\n\n/** A simple mtime-based cache for docs syncing, to skip processing when neither .ts nor .md has changed. */\nexport class DocsCache {\n  #entries: Record<string, CacheEntry>;\n  #cachePath: string;\n\n  private constructor(cachePath: string, entries: Record<string, CacheEntry>) {\n    this.#cachePath = cachePath;\n    this.#entries = entries;\n  }\n\n  static async load(): Promise<DocsCache> {\n    const cachePath = getCachePath();\n    try {\n      const raw = JSON.parse(await fs.readFile(cachePath, \"utf-8\")) as CacheFile;\n      if (raw.version === CACHE_VERSION) {\n        return new DocsCache(cachePath, raw.entities);\n      }\n    } catch {\n      // Missing or corrupt — start fresh\n    }\n    return new DocsCache(cachePath, {});\n  }\n\n  /** Returns true if both file mtimes match the cached values (i.e. skip processing). */\n  isUpToDate(entityName: string, tsMtime: number, mdMtime: number): boolean {\n    const cached = this.#entries[entityName];\n    return !!cached && cached.tsMtime === Math.floor(tsMtime) && cached.mdMtime === Math.floor(mdMtime);\n  }\n\n  /** Record the current mtimes for an entity after processing it. */\n  update(entityName: string, tsMtime: number, mdMtime: number): void {\n    this.#entries[entityName] = { tsMtime: Math.floor(tsMtime), mdMtime: Math.floor(mdMtime) };\n  }\n\n  async save(): Promise<void> {\n    const data: CacheFile = { version: CACHE_VERSION, entities: this.#entries };\n    await fs.mkdir(CACHE_DIR, { recursive: true });\n    await fs.writeFile(this.#cachePath, JSON.stringify(data), \"utf-8\");\n  }\n}\n\n/** Stat a file and return its mtimeMs, or -1 if it doesn't exist. */\nexport async function getMtime(filePath: string): Promise<number> {\n  try {\n    return (await fs.stat(filePath)).mtimeMs;\n  } catch {\n    return -1;\n  }\n}\n\nfunction getCachePath(): string {\n  const hash = createHash(\"sha256\").update(process.cwd()).digest(\"hex\").slice(0, 16);\n  return join(CACHE_DIR, `${hash}.json`);\n}\n"],"mappings":";;;;;AAKA,MAAM,gBAAgB;AACtB,MAAM,YAAY,KAAK,OAAO,GAAG,qBAAqB;;AAetD,IAAa,YAAb,MAAa,UAAU;CACrB;CACA;CAEA,YAAoB,WAAmB,SAAqC;EAC1E,KAAK,aAAa;EAClB,KAAK,WAAW;CAClB;CAEA,aAAa,OAA2B;EACtC,MAAM,YAAY,aAAa;EAC/B,IAAI;GACF,MAAM,MAAM,KAAK,MAAM,MAAMA,SAAG,SAAS,WAAW,OAAO,CAAC;GAC5D,IAAI,IAAI,YAAY,eAClB,OAAO,IAAI,UAAU,WAAW,IAAI,QAAQ;EAEhD,QAAQ,CAER;EACA,OAAO,IAAI,UAAU,WAAW,CAAC,CAAC;CACpC;;CAGA,WAAW,YAAoB,SAAiB,SAA0B;EACxE,MAAM,SAAS,KAAK,SAAS;EAC7B,OAAO,CAAC,CAAC,UAAU,OAAO,YAAY,KAAK,MAAM,OAAO,KAAK,OAAO,YAAY,KAAK,MAAM,OAAO;CACpG;;CAGA,OAAO,YAAoB,SAAiB,SAAuB;EACjE,KAAK,SAAS,cAAc;GAAE,SAAS,KAAK,MAAM,OAAO;GAAG,SAAS,KAAK,MAAM,OAAO;EAAE;CAC3F;CAEA,MAAM,OAAsB;EAC1B,MAAM,OAAkB;GAAE,SAAS;GAAe,UAAU,KAAK;EAAS;EAC1E,MAAMA,SAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;EAC7C,MAAMA,SAAG,UAAU,KAAK,YAAY,KAAK,UAAU,IAAI,GAAG,OAAO;CACnE;AACF;;AAGA,eAAsB,SAAS,UAAmC;CAChE,IAAI;EACF,QAAQ,MAAMA,SAAG,KAAK,QAAQ,EAAA,CAAG;CACnC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,eAAuB;CAC9B,MAAM,OAAO,WAAW,QAAQ,CAAC,CAAC,OAAO,QAAQ,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;CACjF,OAAO,KAAK,WAAW,GAAG,KAAK,MAAM;AACvC"}

package/build/docs/generate-metadata-docs.d.cts

@@ -3,7 +3,6 @@ import { ParsedDoc } from "./markdown.cjs";
 import { CodegenFile } from "ts-poet";
 //#region src/docs/generate-metadata-docs.d.ts
 /** Creates the `metadata-docs.ts` runtime artifact to access docs. */
-declare function generateMetadataDocsFile(dbMeta: DbMetadata, docsByEntity: Record<string, ParsedDoc>): CodegenFile;
+export declare function generateMetadataDocsFile(dbMeta: DbMetadata, docsByEntity: Record<string, ParsedDoc>): CodegenFile;
 //#endregion
-export { generateMetadataDocsFile };
 //# sourceMappingURL=generate-metadata-docs.d.cts.map

package/build/docs/generate-metadata-docs.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-metadata-docs.d.cts","names":[],"sources":["../../src/docs/generate-metadata-docs.ts"],"mappings":";;;;;iBAMgB,yBAAyB,QAAQ,YAAY,cAAc,eAAe,aAAa"}
+{"version":3,"file":"generate-metadata-docs.d.cts","names":[],"sources":["../../src/docs/generate-metadata-docs.ts"],"mappings":";;;;;wBAMgB,yBAAyB,QAAQ,YAAY,cAAc,eAAe,aAAa"}

package/build/docs/generate-metadata-docs.d.mts

@@ -3,7 +3,6 @@ import { ParsedDoc } from "./markdown.mjs";
 import { CodegenFile } from "ts-poet";
 //#region src/docs/generate-metadata-docs.d.ts
 /** Creates the `metadata-docs.ts` runtime artifact to access docs. */
-declare function generateMetadataDocsFile(dbMeta: DbMetadata, docsByEntity: Record<string, ParsedDoc>): CodegenFile;
+export declare function generateMetadataDocsFile(dbMeta: DbMetadata, docsByEntity: Record<string, ParsedDoc>): CodegenFile;
 //#endregion
-export { generateMetadataDocsFile };
 //# sourceMappingURL=generate-metadata-docs.d.mts.map

package/build/docs/generate-metadata-docs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-metadata-docs.d.mts","names":[],"sources":["../../src/docs/generate-metadata-docs.ts"],"mappings":";;;;;iBAMgB,yBAAyB,QAAQ,YAAY,cAAc,eAAe,aAAa"}
+{"version":3,"file":"generate-metadata-docs.d.mts","names":[],"sources":["../../src/docs/generate-metadata-docs.ts"],"mappings":";;;;;wBAMgB,yBAAyB,QAAQ,YAAY,cAAc,eAAe,aAAa"}

package/build/docs/index.d.cts

@@ -3,14 +3,14 @@ import { generateMetadataDocsFile } from "./generate-metadata-docs.cjs";
 import { buildJSDocBlock, generatedTag } from "./parsing.cjs";
 //#region src/docs/index.d.ts
 /** Loads each entity's parsed `.md` doc, i.e. for injecting into codegen JSDocs & runtime metadata. */
-declare function loadEntityDocs(entitiesDir: string, entityNames: string[]): Promise<Record<string, ParsedDoc>>;
+export declare function loadEntityDocs(entitiesDir: string, entityNames: string[]): Promise<Record<string, ParsedDoc>>;
 /**
  * Run the full docs sync pipeline with mtime-based caching:
  * 1. backfill .md from .ts JSDocs
  * 2. sync .md back into .ts JSDocs
  * 3. save the cache
  */
-declare function syncDocs(entitiesDir: string, entityNames: string[]): Promise<void>;
+export declare function syncDocs(entitiesDir: string, entityNames: string[]): Promise<void>;
 //#endregion
-export { type ParsedDoc, buildJSDocBlock, generateMetadataDocsFile, generatedTag, loadEntityDocs, syncDocs };
+export { type ParsedDoc, buildJSDocBlock, generateMetadataDocsFile, generatedTag };
 //# sourceMappingURL=index.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/docs/index.ts"],"mappings":";;;;;iBAWsB,eAAe,qBAAqB,wBAAwB,QAAQ,eAAe;;;;;;;iBAiBnF,SAAS,qBAAqB,wBAAwB"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/docs/index.ts"],"mappings":";;;;;wBAWsB,eAAe,qBAAqB,wBAAwB,QAAQ,eAAe;;;;;;;wBAiBnF,SAAS,qBAAqB,wBAAwB"}

package/build/docs/index.d.mts

@@ -3,14 +3,14 @@ import { generateMetadataDocsFile } from "./generate-metadata-docs.mjs";
 import { buildJSDocBlock, generatedTag } from "./parsing.mjs";
 //#region src/docs/index.d.ts
 /** Loads each entity's parsed `.md` doc, i.e. for injecting into codegen JSDocs & runtime metadata. */
-declare function loadEntityDocs(entitiesDir: string, entityNames: string[]): Promise<Record<string, ParsedDoc>>;
+export declare function loadEntityDocs(entitiesDir: string, entityNames: string[]): Promise<Record<string, ParsedDoc>>;
 /**
  * Run the full docs sync pipeline with mtime-based caching:
  * 1. backfill .md from .ts JSDocs
  * 2. sync .md back into .ts JSDocs
  * 3. save the cache
  */
-declare function syncDocs(entitiesDir: string, entityNames: string[]): Promise<void>;
+export declare function syncDocs(entitiesDir: string, entityNames: string[]): Promise<void>;
 //#endregion
-export { type ParsedDoc, buildJSDocBlock, generateMetadataDocsFile, generatedTag, loadEntityDocs, syncDocs };
+export { type ParsedDoc, buildJSDocBlock, generateMetadataDocsFile, generatedTag };
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/docs/index.ts"],"mappings":";;;;;iBAWsB,eAAe,qBAAqB,wBAAwB,QAAQ,eAAe;;;;;;;iBAiBnF,SAAS,qBAAqB,wBAAwB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/docs/index.ts"],"mappings":";;;;;wBAWsB,eAAe,qBAAqB,wBAAwB,QAAQ,eAAe;;;;;;;wBAiBnF,SAAS,qBAAqB,wBAAwB"}

package/build/docs/markdown.d.cts

@@ -1,20 +1,20 @@
 //#region src/docs/markdown.d.ts
-interface ParsedDoc {
+export interface ParsedDoc {
   overview: string;
   fields: Record<string, string>;
 }
 /** Read and parse a .md file if it exists, returning undefined if it doesn't. */
-declare function maybeReadMarkdownFile(filePath: string): Promise<ParsedDoc | undefined>;
+export declare function maybeReadMarkdownFile(filePath: string): Promise<ParsedDoc | undefined>;
 /** Reads a basic `overview` and per-field docs out of md content. */
-declare function parseMarkdownContent(content: string): ParsedDoc;
+export declare function parseMarkdownContent(content: string): ParsedDoc;
 /** Create a new .md file from scratch (used only for initial backfill when no .md exists). */
-declare function writeMarkdownDoc(filePath: string, overview: string, fields?: Record<string, string>): Promise<void>;
+export declare function writeMarkdownDoc(filePath: string, overview: string, fields?: Record<string, string>): Promise<void>;
 /**
  * Update an existing .md file, merging in new/changed content without stomping user content.
  * If the file doesn't exist, creates it from scratch.
  */
-declare function updateMarkdownDoc(filePath: string, overview: string | undefined, fields: Record<string, string>): Promise<void>;
-declare function getMarkdownFilePath(entitiesDir: string, entityName: string): string;
+export declare function updateMarkdownDoc(filePath: string, overview: string | undefined, fields: Record<string, string>): Promise<void>;
+export declare function getMarkdownFilePath(entitiesDir: string, entityName: string): string;
 /**
  * Merge updates into an existing .md file, preserving all user content.
  *
@@ -24,9 +24,9 @@ declare function getMarkdownFilePath(entitiesDir: string, entityName: string): s
  * - All other content (custom sections, tables, etc.) is preserved verbatim
  */
 declare function mergeMarkdownContent(existing: string, overview: string | undefined, fields: Record<string, string>): string;
-declare const testing: {
+export declare const testing: {
   mergeMarkdownContent: typeof mergeMarkdownContent;
 };
 //#endregion
-export { ParsedDoc, getMarkdownFilePath, maybeReadMarkdownFile, parseMarkdownContent, testing, updateMarkdownDoc, writeMarkdownDoc };
+export {};
 //# sourceMappingURL=markdown.d.cts.map

package/build/docs/markdown.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.cts","names":[],"sources":["../../src/docs/markdown.ts"],"mappings":";UAKiB;EACf;EACA,QAAQ;;;iBAIY,sBAAsB,mBAAmB,QAAQ;;iBAUvD,qBAAqB,kBAAkB;;iBAiDjC,iBACpB,kBACA,kBACA,SAAS,yBACR;;;;;iBAgCmB,kBACpB,kBACA,8BACA,QAAQ,yBACP;iBAkBa,oBAAoB,qBAAqB;;;;;;;;;iBAqBhD,qBAAqB,kBAAkB,8BAA8B,QAAQ;cA+EzE;+BAAA"}
+{"version":3,"file":"markdown.d.cts","names":[],"sources":["../../src/docs/markdown.ts"],"mappings":";iBAKiB;EACf;EACA,QAAQ;;;wBAIY,sBAAsB,mBAAmB,QAAQ;;wBAUvD,qBAAqB,kBAAkB;;wBAiDjC,iBACpB,kBACA,kBACA,SAAS,yBACR;;;;;wBAgCmB,kBACpB,kBACA,8BACA,QAAQ,yBACP;wBAkBa,oBAAoB,qBAAqB;;;;;;;;;iBAqBhD,qBAAqB,kBAAkB,8BAA8B,QAAQ;qBA+EzE;+BAAA"}

package/build/docs/markdown.d.mts

@@ -1,20 +1,20 @@
 //#region src/docs/markdown.d.ts
-interface ParsedDoc {
+export interface ParsedDoc {
   overview: string;
   fields: Record<string, string>;
 }
 /** Read and parse a .md file if it exists, returning undefined if it doesn't. */
-declare function maybeReadMarkdownFile(filePath: string): Promise<ParsedDoc | undefined>;
+export declare function maybeReadMarkdownFile(filePath: string): Promise<ParsedDoc | undefined>;
 /** Reads a basic `overview` and per-field docs out of md content. */
-declare function parseMarkdownContent(content: string): ParsedDoc;
+export declare function parseMarkdownContent(content: string): ParsedDoc;
 /** Create a new .md file from scratch (used only for initial backfill when no .md exists). */
-declare function writeMarkdownDoc(filePath: string, overview: string, fields?: Record<string, string>): Promise<void>;
+export declare function writeMarkdownDoc(filePath: string, overview: string, fields?: Record<string, string>): Promise<void>;
 /**
  * Update an existing .md file, merging in new/changed content without stomping user content.
  * If the file doesn't exist, creates it from scratch.
  */
-declare function updateMarkdownDoc(filePath: string, overview: string | undefined, fields: Record<string, string>): Promise<void>;
-declare function getMarkdownFilePath(entitiesDir: string, entityName: string): string;
+export declare function updateMarkdownDoc(filePath: string, overview: string | undefined, fields: Record<string, string>): Promise<void>;
+export declare function getMarkdownFilePath(entitiesDir: string, entityName: string): string;
 /**
  * Merge updates into an existing .md file, preserving all user content.
  *
@@ -24,9 +24,9 @@ declare function getMarkdownFilePath(entitiesDir: string, entityName: string): s
  * - All other content (custom sections, tables, etc.) is preserved verbatim
  */
 declare function mergeMarkdownContent(existing: string, overview: string | undefined, fields: Record<string, string>): string;
-declare const testing: {
+export declare const testing: {
   mergeMarkdownContent: typeof mergeMarkdownContent;
 };
 //#endregion
-export { ParsedDoc, getMarkdownFilePath, maybeReadMarkdownFile, parseMarkdownContent, testing, updateMarkdownDoc, writeMarkdownDoc };
+export {};
 //# sourceMappingURL=markdown.d.mts.map

package/build/docs/markdown.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.mts","names":[],"sources":["../../src/docs/markdown.ts"],"mappings":";UAKiB;EACf;EACA,QAAQ;;;iBAIY,sBAAsB,mBAAmB,QAAQ;;iBAUvD,qBAAqB,kBAAkB;;iBAiDjC,iBACpB,kBACA,kBACA,SAAS,yBACR;;;;;iBAgCmB,kBACpB,kBACA,8BACA,QAAQ,yBACP;iBAkBa,oBAAoB,qBAAqB;;;;;;;;;iBAqBhD,qBAAqB,kBAAkB,8BAA8B,QAAQ;cA+EzE;+BAAA"}
+{"version":3,"file":"markdown.d.mts","names":[],"sources":["../../src/docs/markdown.ts"],"mappings":";iBAKiB;EACf;EACA,QAAQ;;;wBAIY,sBAAsB,mBAAmB,QAAQ;;wBAUvD,qBAAqB,kBAAkB;;wBAiDjC,iBACpB,kBACA,kBACA,SAAS,yBACR;;;;;wBAgCmB,kBACpB,kBACA,8BACA,QAAQ,yBACP;wBAkBa,oBAAoB,qBAAqB;;;;;;;;;iBAqBhD,qBAAqB,kBAAkB,8BAA8B,QAAQ;qBA+EzE;+BAAA"}

package/build/docs/parsing.d.cts

@@ -11,20 +11,20 @@ type Commented = ASTNode & {
   end?: number;
   loc?: namedTypes.SourceLocation | null;
 };
-type MemberKind = "property" | "getter" | "setter" | "method";
-interface MemberInfo {
+export type MemberKind = "property" | "getter" | "setter" | "method";
+export interface MemberInfo {
   kind: MemberKind;
   name: string;
   doc: string | undefined;
   node: Commented;
 }
-interface SourceEdit {
+export interface SourceEdit {
   start: number;
   end: number;
   text: string;
 }
 /** Parse an entity .ts file and extract class + member JSDoc. */
-declare function parseEntityJSDocs(source: string): {
+export declare function parseEntityJSDocs(source: string): {
   classDoc: string | undefined;
   classNode: Commented | undefined;
   members: MemberInfo[];
@@ -36,13 +36,13 @@ declare function parseEntityJSDocs(source: string): {
  * (This is bizarre, but this `SourceEdit` + `applyEdits` leaves all existing formatting
  * alone better than doing a `node.toSource()` or other AST-based updates. :grimmacing:)
  */
-declare function buildJSDocEdit(node: Commented, text: string): SourceEdit;
+export declare function buildJSDocEdit(node: Commented, text: string): SourceEdit;
 /** Apply edits to source by splicing in reverse order. */
-declare function applyEdits(source: string, edits: SourceEdit[]): string;
+export declare function applyEdits(source: string, edits: SourceEdit[]): string;
 /** Build a JSDoc block comment string from plain text. */
-declare function buildJSDocBlock(text: string, indent: number): string;
+export declare function buildJSDocBlock(text: string, indent: number): string;
 /** The `@generated Entity.md` marker, i.e. so readers know a JSDoc is sourced from (and edited in) the `.md`. */
-declare function generatedTag(entityName: string): string;
+export declare function generatedTag(entityName: string): string;
 //#endregion
-export { MemberInfo, MemberKind, SourceEdit, applyEdits, buildJSDocBlock, buildJSDocEdit, generatedTag, parseEntityJSDocs };
+export {};
 //# sourceMappingURL=parsing.d.cts.map

package/build/docs/parsing.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"parsing.d.cts","names":[],"sources":["../../src/docs/parsing.ts"],"mappings":";;;KAKK,eAAe,WAAW,eAAe,WAAW,cAAc,WAAW,QAAQ,WAAW;EACnG;EACA;;KAGG,YAAY;EACf,WAAW;EACX;EACA;EACA,MAAM,WAAW;;KAGP;UAEK;EACf,MAAM;EACN;EACA;EACA,MAAM;;UAGS;EACf;EACA;EACA;;;iBAIc,kBAAkB;;;;;;;;;;;;iBAuDlB,eAAe,MAAM,WAAW,eAAe;;iBAW/C,WAAW,gBAAgB,OAAO;;iBAUlC,gBAAgB,cAAc;;iBAQ9B,aAAa"}
+{"version":3,"file":"parsing.d.cts","names":[],"sources":["../../src/docs/parsing.ts"],"mappings":";;;KAKK,eAAe,WAAW,eAAe,WAAW,cAAc,WAAW,QAAQ,WAAW;EACnG;EACA;;KAGG,YAAY;EACf,WAAW;EACX;EACA;EACA,MAAM,WAAW;;YAGP;iBAEK;EACf,MAAM;EACN;EACA;EACA,MAAM;;iBAGS;EACf;EACA;EACA;;;wBAIc,kBAAkB;;;;;;;;;;;;wBAuDlB,eAAe,MAAM,WAAW,eAAe;;wBAW/C,WAAW,gBAAgB,OAAO;;wBAUlC,gBAAgB,cAAc;;wBAQ9B,aAAa"}