joist-codegen 2.3.0-next.118 → 2.3.0-next.119

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport process from \"node:process\";\n\nimport { type ConnectionConfig, newPgConnectionConfig } from \"joist-utils\";\nimport { Client } from \"pg\";\nimport pgStructureModule from \"pg-structure\";\nimport { saveFiles } from \"ts-poet\";\n\nimport { assignTags } from \"./assignTags.ts\";\nimport { maybeRunTransforms } from \"./codemods/index.ts\";\nimport { type Config, loadConfig, stripStiPlaceholders, warnInvalidConfigEntries, writeConfig } from \"./config.ts\";\nimport {\n  type DbMetadata,\n  EntityDbMetadata,\n  failIfOverlappingFieldNames,\n  resolveNameConflicts,\n} from \"./EntityDbMetadata.ts\";\nimport { maybeSetForeignKeyOrdering } from \"./foreignKeyOrdering.ts\";\nimport { generateFiles } from \"./generate.ts\";\nimport { createFlushFunction } from \"./generateFlushFunction.ts\";\nimport { applyInheritanceUpdates } from \"./inheritance.ts\";\nimport { installSkills } from \"./installSkills.ts\";\nimport { loadEnumMetadata, loadPgEnumMetadata } from \"./loadMetadata.ts\";\nimport { LOG_LEVELS, loggerMaxWarningLevelHit } from \"./logger.ts\";\nimport { scanEntityFiles } from \"./scanEntityFiles.ts\";\nimport {\n  isEntityTable,\n  isEnumTable,\n  isJoinTable,\n  mapSimpleDbTypeToTypescriptType,\n  shouldIncludeSchema,\n} from \"./utils.ts\";\n\nconst { default: pgStructure } = pgStructureModule;\n\nexport {\n  type DbMetadata,\n  type EnumField,\n  makeEntity,\n  type ManyToManyField,\n  type ManyToOneField,\n  type OneToManyField,\n  type OneToOneField,\n  type PolymorphicField,\n  type PrimitiveField,\n  type PrimitiveTypescriptType,\n} from \"./EntityDbMetadata.ts\";\nexport type { EnumMetadata, EnumRow, EnumTableData, PgEnumData, PgEnumMetadata } from \"./loadMetadata.ts\";\nexport { dateCode, plainDateCode, plainDateTimeCode, zonedDateTimeCode } from \"./utils.ts\";\nexport { type Config, EntityDbMetadata, mapSimpleDbTypeToTypescriptType };\n\nexport async function joistCodegen() {\n  const config = await loadConfig();\n\n  maybeSetDatabaseUrl(config);\n  if (!process.env.DATABASE_URL && !process.env.DB_USER) {\n    console.log(`Database connection information not found, please set either:`);\n    console.log(`  - the DATABASE_URL env variable (i.e. using .env and dotenv), or`);\n    console.log(`  - the databaseUrl key in joist-config.json`);\n    return;\n  }\n  const pgConfig = newPgConnectionConfig();\n\n  const client = new Client(pgConfig);\n  await client.connect();\n\n  const dbMetadata = await loadSchemaMetadata(config, client);\n  const { entities, enums, totalTables } = dbMetadata;\n  console.log(\n    `Found ${totalTables} total tables, ${entities.length} entity tables, ${Object.entries(enums).length} enum tables`,\n  );\n  console.log(\"\");\n\n  // Look for STI tables to synthesize separate metas\n  applyInheritanceUpdates(config, dbMetadata);\n\n  // Now that all entities (incl. STI subtypes) are known, fix up any colliding codegen'd type names\n  resolveNameConflicts(config, dbMetadata);\n\n  // Assign any new tags and write them back to the config file\n  assignTags(config, dbMetadata);\n  validateTagDelimiter(config, entities);\n\n  // Scan `*.ts` files after we've expanded `Task` -> `TaskOld.ts`\n  await scanEntityFiles(config, dbMetadata);\n\n  // If we're not using deferred FKs, determine our DAG insert order\n  await maybeSetForeignKeyOrdering(config, dbMetadata.entities);\n\n  // Generate the flush function for tests\n  await maybeGenerateFlushFunctions(config, client, pgConfig, dbMetadata);\n\n  await client.end();\n\n  // Apply any codemods to the user's codebase, if we have them\n  await maybeRunTransforms(config);\n\n  // Do some warnings\n  for (const entity of entities) failIfOverlappingFieldNames(entity);\n  warnInvalidConfigEntries(config, dbMetadata);\n\n  // Finally actually generate the files (even if we found a fatal error)\n  await generateAndSaveFiles(config, dbMetadata);\n\n  // Install our bundled Agent Skills so coding agents can find them, unless explicitly disabled\n  if (config.skills !== false) await installSkills();\n\n  stripStiPlaceholders(config, entities);\n  await writeConfig(config);\n}\n\n/** Uses entities and enums from the `db` schema and saves them into our entities directory. */\nexport async function generateAndSaveFiles(config: Config, dbMeta: DbMetadata): Promise<void> {\n  const files = await generateFiles(config, dbMeta);\n  const esmExt = config.esm ? (config.allowImportingTsExtensions ? \"ts\" : \"js\") : \"\";\n  await saveFiles({\n    toolName: \"joist-codegen\",\n    directory: config.entitiesDirectory,\n    files,\n    toStringOpts: { importExtensions: esmExt || false },\n  });\n}\n\nasync function maybeGenerateFlushFunctions(config: Config, client: Client, pgConfig: ConnectionConfig, db: DbMetadata) {\n  // In graphql-service we have our own custom flush function, so allow skipping this\n  if (config.createFlushFunction !== false) {\n    // Look for multiple test databases\n    if (Array.isArray(config.createFlushFunction)) {\n      console.log(\"Creating flush_database functions\");\n      await Promise.all(\n        config.createFlushFunction.map(async (dbName) => {\n          const client = new Client({ ...pgConfig, database: dbName });\n          await client.connect();\n          await createFlushFunction(client, db);\n          await client.end();\n        }),\n      );\n    } else {\n      console.log(\"Creating flush_database function\");\n      await createFlushFunction(client, db);\n    }\n  }\n}\n\nasync function loadSchemaMetadata(config: Config, client: Client): Promise<DbMetadata> {\n  // Here we load all schemas, to avoid pg-structure failing on cross-schema foreign keys\n  // like our cyanaudit triggers (https://github.com/ozum/pg-structure/issues/85), and then\n  // later filter them non-public schema tables out.\n  const db = await pgStructure(client);\n  const enums = await loadEnumMetadata(db, client, config);\n  const pgEnums = await loadPgEnumMetadata(db, client, config);\n  const entities = db.tables\n    .filter((t) => isEntityTable(config, t))\n    .sortBy(\"name\")\n    .map((table) => new EntityDbMetadata(config, table, enums));\n  const totalTables = db.tables.length;\n  const joinTables = db.tables.filter((t) => isJoinTable(config, t)).map((t) => t.name);\n  const otherTables = db.tables\n    .filter(\n      (t) =>\n        shouldIncludeSchema(config, t) &&\n        !isEntityTable(config, t) &&\n        !isEnumTable(config, t) &&\n        !isJoinTable(config, t),\n    )\n    .map((t) => t.name);\n  const entitiesByName = Object.fromEntries(entities.map((e) => [e.name, e]));\n  return { entities, entitiesByName, enums, pgEnums, totalTables, joinTables, otherTables };\n}\n\nfunction maybeSetDatabaseUrl(config: Config): void {\n  if (!process.env.DATABASE_URL && config.databaseUrl) {\n    process.env.DATABASE_URL = config.databaseUrl;\n  }\n}\n\nexport function maybeSetExitCode(): void {\n  if (\n    !process.argv.includes(\"--always-exit-code-zero\") &&\n    // strict mode + warnings or greater\n    ((process.argv.includes(\"--strict\") && loggerMaxWarningLevelHit >= LOG_LEVELS.warn) ||\n      // otherwise errors or greater\n      loggerMaxWarningLevelHit >= LOG_LEVELS.error)\n  ) {\n    process.exitCode = 1;\n  }\n}\n\n/** Validates that tags can be parsed unambiguously with the configured delimiter. */\nfunction validateTagDelimiter(config: Config, entities: EntityDbMetadata[]): void {\n  const tagDelimiter = config.tagDelimiter ?? \":\";\n  for (const entity of entities) {\n    if (tagDelimiter !== \"\" && `${entity.tagName}${tagDelimiter}`.indexOf(tagDelimiter) !== entity.tagName.length) {\n      throw new Error(\n        `Tagged id delimiter '${tagDelimiter}' cannot occur in or overlap tag '${entity.tagName}' for ${entity.name}`,\n      );\n    } else if (tagDelimiter === \"\" && !/^[a-z]+$/i.test(entity.tagName)) {\n      throw new Error(`Delimiterless ids require an alphabetic tag, got '${entity.tagName}' for ${entity.name}`);\n    } else if (\n      tagDelimiter === \"\" &&\n      entity.primaryKey.columnType !== \"int\" &&\n      entity.primaryKey.columnType !== \"bigint\"\n    ) {\n      throw new Error(\n        `Delimiterless ids require an int or bigint primary key, got '${entity.primaryKey.columnType}' for ${entity.name}`,\n      );\n    }\n  }\n}\n\nif (typeof module !== \"undefined\" && require.main === module) {\n  joistCodegen()\n    .then(() => maybeSetExitCode())\n    .catch((err) => {\n      console.error(err);\n      process.exit(1);\n    });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { existsSync } from \"node:fs\";\nimport process from \"node:process\";\n\nimport { type ConnectionConfig, newPgConnectionConfig } from \"joist-utils\";\nimport { Client } from \"pg\";\nimport { saveFiles } from \"ts-poet\";\n\nimport { assignTags } from \"./assignTags.ts\";\nimport { maybeRunTransforms } from \"./codemods/index.ts\";\nimport { type Config, loadConfig, stripStiPlaceholders, warnInvalidConfigEntries, writeConfig } from \"./config.ts\";\nimport {\n  type DbMetadata,\n  EntityDbMetadata,\n  failIfOverlappingFieldNames,\n  resolveNameConflicts,\n} from \"./EntityDbMetadata.ts\";\nimport { maybeSetForeignKeyOrdering } from \"./foreignKeyOrdering.ts\";\nimport { generateFiles } from \"./generate.ts\";\nimport { createFlushFunction } from \"./generateFlushFunction.ts\";\nimport { applyInheritanceUpdates } from \"./inheritance.ts\";\nimport { installSkills } from \"./installSkills.ts\";\nimport { loadEnumMetadata, loadPgEnumMetadata } from \"./loadMetadata.ts\";\nimport { LOG_LEVELS, loggerMaxWarningLevelHit } from \"./logger.ts\";\nimport { loadPgMetadata } from \"./pgMetadata.ts\";\nimport { scanEntityFiles } from \"./scanEntityFiles.ts\";\nimport {\n  isEntityTable,\n  isEnumTable,\n  isJoinTable,\n  mapSimpleDbTypeToTypescriptType,\n  shouldIncludeSchema,\n  tableToEntityName,\n} from \"./utils.ts\";\n\nexport {\n  type DbMetadata,\n  type EnumField,\n  makeEntity,\n  type ManyToManyField,\n  type ManyToOneField,\n  type OneToManyField,\n  type OneToOneField,\n  type PolymorphicField,\n  type PrimitiveField,\n  type PrimitiveTypescriptType,\n} from \"./EntityDbMetadata.ts\";\nexport type { EnumMetadata, EnumRow, EnumTableData, PgEnumData, PgEnumMetadata } from \"./loadMetadata.ts\";\nexport { dateCode, plainDateCode, plainDateTimeCode, zonedDateTimeCode } from \"./utils.ts\";\nexport { type Config, EntityDbMetadata, mapSimpleDbTypeToTypescriptType };\n\nexport async function joistCodegen() {\n  // pg-structure used to load .env on import; keep that behavior for fixtures and apps\n  // that provide DATABASE_URL in a local .env without a separate dotenv bootstrap.\n  if (existsSync(\".env\")) process.loadEnvFile();\n  const config = await loadConfig();\n\n  maybeSetDatabaseUrl(config);\n  if (!process.env.DATABASE_URL && !process.env.DB_USER) {\n    console.log(`Database connection information not found, please set either:`);\n    console.log(`  - the DATABASE_URL env variable (i.e. using .env and dotenv), or`);\n    console.log(`  - the databaseUrl key in joist-config.json`);\n    return;\n  }\n  const pgConfig = newPgConnectionConfig();\n\n  const client = new Client(pgConfig);\n  await client.connect();\n\n  const dbMetadata = await loadSchemaMetadata(config, client);\n  const { entities, enums, totalTables } = dbMetadata;\n  console.log(\n    `Found ${totalTables} total tables, ${entities.length} entity tables, ${Object.entries(enums).length} enum tables`,\n  );\n  console.log(\"\");\n\n  // Look for STI tables to synthesize separate metas\n  applyInheritanceUpdates(config, dbMetadata);\n\n  // Now that all entities (incl. STI subtypes) are known, fix up any colliding codegen'd type names\n  resolveNameConflicts(config, dbMetadata);\n\n  // Assign any new tags and write them back to the config file\n  assignTags(config, dbMetadata);\n  validateTagDelimiter(config, entities);\n\n  // Scan `*.ts` files after we've expanded `Task` -> `TaskOld.ts`\n  await scanEntityFiles(config, dbMetadata);\n\n  // If we're not using deferred FKs, determine our DAG insert order\n  await maybeSetForeignKeyOrdering(config, dbMetadata.entities);\n\n  // Generate the flush function for tests\n  await maybeGenerateFlushFunctions(config, client, pgConfig, dbMetadata);\n\n  await client.end();\n\n  // Apply any codemods to the user's codebase, if we have them\n  await maybeRunTransforms(config);\n\n  // Do some warnings\n  for (const entity of entities) failIfOverlappingFieldNames(entity);\n  warnInvalidConfigEntries(config, dbMetadata);\n\n  // Finally actually generate the files (even if we found a fatal error)\n  await generateAndSaveFiles(config, dbMetadata);\n\n  // Install our bundled Agent Skills so coding agents can find them, unless explicitly disabled\n  if (config.skills !== false) await installSkills();\n\n  stripStiPlaceholders(config, entities);\n  await writeConfig(config);\n}\n\n/** Uses entities and enums from the `db` schema and saves them into our entities directory. */\nexport async function generateAndSaveFiles(config: Config, dbMeta: DbMetadata): Promise<void> {\n  const files = await generateFiles(config, dbMeta);\n  const esmExt = config.esm ? (config.allowImportingTsExtensions ? \"ts\" : \"js\") : \"\";\n  await saveFiles({\n    toolName: \"joist-codegen\",\n    directory: config.entitiesDirectory,\n    files,\n    toStringOpts: { importExtensions: esmExt || false },\n  });\n}\n\nasync function maybeGenerateFlushFunctions(config: Config, client: Client, pgConfig: ConnectionConfig, db: DbMetadata) {\n  // In graphql-service we have our own custom flush function, so allow skipping this\n  if (config.createFlushFunction !== false) {\n    // Look for multiple test databases\n    if (Array.isArray(config.createFlushFunction)) {\n      console.log(\"Creating flush_database functions\");\n      await Promise.all(\n        config.createFlushFunction.map(async (dbName) => {\n          const client = new Client({ ...pgConfig, database: dbName });\n          await client.connect();\n          await createFlushFunction(client, db);\n          await client.end();\n        }),\n      );\n    } else {\n      console.log(\"Creating flush_database function\");\n      await createFlushFunction(client, db);\n    }\n  }\n}\n\nasync function loadSchemaMetadata(config: Config, client: Client): Promise<DbMetadata> {\n  // Load all user schemas so cross-schema foreign keys can be resolved. Codegen filters\n  // non-public tables below; trigger functions in other schemas do not affect entities.\n  const db = await loadPgMetadata(client);\n  const enums = await loadEnumMetadata(db, client, config);\n  const pgEnums = await loadPgEnumMetadata(db, client, config);\n  // The order also controls generated exports; sorting physical table names puts book_reviews\n  // before books and changes initialization order for entity modules with circular imports.\n  const entities = db.tables\n    .filter((t) => isEntityTable(config, t))\n    .sort((a, b) => tableToEntityName(config, a).localeCompare(tableToEntityName(config, b)))\n    .map((table) => new EntityDbMetadata(config, table, enums));\n  const totalTables = db.tables.length;\n  const joinTables = db.tables.filter((t) => isJoinTable(config, t)).map((t) => t.name);\n  const otherTables = db.tables\n    .filter(\n      (t) =>\n        shouldIncludeSchema(config, t) &&\n        !isEntityTable(config, t) &&\n        !isEnumTable(config, t) &&\n        !isJoinTable(config, t),\n    )\n    .map((t) => t.name);\n  const entitiesByName = Object.fromEntries(entities.map((e) => [e.name, e]));\n  return { entities, entitiesByName, enums, pgEnums, totalTables, joinTables, otherTables };\n}\n\nfunction maybeSetDatabaseUrl(config: Config): void {\n  if (!process.env.DATABASE_URL && config.databaseUrl) {\n    process.env.DATABASE_URL = config.databaseUrl;\n  }\n}\n\nexport function maybeSetExitCode(): void {\n  if (\n    !process.argv.includes(\"--always-exit-code-zero\") &&\n    // strict mode + warnings or greater\n    ((process.argv.includes(\"--strict\") && loggerMaxWarningLevelHit >= LOG_LEVELS.warn) ||\n      // otherwise errors or greater\n      loggerMaxWarningLevelHit >= LOG_LEVELS.error)\n  ) {\n    process.exitCode = 1;\n  }\n}\n\n/** Validates that tags can be parsed unambiguously with the configured delimiter. */\nfunction validateTagDelimiter(config: Config, entities: EntityDbMetadata[]): void {\n  const tagDelimiter = config.tagDelimiter ?? \":\";\n  for (const entity of entities) {\n    if (tagDelimiter !== \"\" && `${entity.tagName}${tagDelimiter}`.indexOf(tagDelimiter) !== entity.tagName.length) {\n      throw new Error(\n        `Tagged id delimiter '${tagDelimiter}' cannot occur in or overlap tag '${entity.tagName}' for ${entity.name}`,\n      );\n    } else if (tagDelimiter === \"\" && !/^[a-z]+$/i.test(entity.tagName)) {\n      throw new Error(`Delimiterless ids require an alphabetic tag, got '${entity.tagName}' for ${entity.name}`);\n    } else if (\n      tagDelimiter === \"\" &&\n      entity.primaryKey.columnType !== \"int\" &&\n      entity.primaryKey.columnType !== \"bigint\"\n    ) {\n      throw new Error(\n        `Delimiterless ids require an int or bigint primary key, got '${entity.primaryKey.columnType}' for ${entity.name}`,\n      );\n    }\n  }\n}\n\nif (typeof module !== \"undefined\" && require.main === module) {\n  joistCodegen()\n    .then(() => maybeSetExitCode())\n    .catch((err) => {\n      console.error(err);\n      process.exit(1);\n    });\n}\n"],"mappings":"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"}

package/build/loadMetadata.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_pgMetadata = require("./pgMetadata.cjs");
 const require_utils = require("./utils.cjs");
 require("./index.cjs");
 const require_EntityDbMetadata = require("./EntityDbMetadata.cjs");
 let change_case = require("change-case");
-let pg_structure = require("pg-structure");
 require("pg");
 //#region src/loadMetadata.ts
 async function loadEnumMetadata(db, client, config) {
-	const promises = db.tables.filter((t) => require_utils.isEnumTable(config, t)).mapToArray(async (table) => {
+	const promises = db.tables.filter((t) => require_utils.isEnumTable(config, t)).map(async (table) => {
 		const rows = (await client.query(`SELECT * FROM ${table.name} ORDER BY id`)).rows.map((row) => row);
 		const extraPrimitives = new require_EntityDbMetadata.EntityDbMetadata(config, table).primitives.filter((p) => !["code", "name"].includes(p.fieldName));
 		return [table.name, {
@@ -22,7 +22,7 @@ async function loadEnumMetadata(db, client, config) {
 }
 async function loadPgEnumMetadata(db, client, config) {
 	return db.types.reduce((all, type) => {
-		if (type instanceof pg_structure.EnumType) return {
+		if (type instanceof require_pgMetadata.EnumType) return {
 			...all,
 			[type.name]: {
 				name: (0, change_case.pascalCase)(type.name),

package/build/loadMetadata.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loadMetadata.cjs","names":["isEnumTable","EntityDbMetadata","pascalCase","EnumType"],"sources":["../src/loadMetadata.ts"],"sourcesContent":["import { pascalCase } from \"change-case\";\nimport { type Client } from \"pg\";\nimport { type Db, EnumType, type Table } from \"pg-structure\";\n\nimport { type Config, EntityDbMetadata, type PrimitiveField } from \"./index.ts\";\nimport { isEnumTable } from \"./utils.ts\";\n\n/** A map from Enum table name to the rows currently in the table. */\nexport type EnumTableData = {\n  table: Table;\n  idType: \"integer\" | \"uuid\";\n  // Pascal case version of table name\n  name: string;\n  rows: EnumRow[];\n  extraPrimitives: PrimitiveField[];\n};\n\nexport type PgEnumData = {\n  name: string;\n  values: string[];\n};\n\nexport type EnumMetadata = Record<string, EnumTableData>;\nexport type PgEnumMetadata = Record<string, PgEnumData>;\n\nexport type EnumRow = { id: number; code: string; name: string; [key: string]: any };\n\nexport async function loadEnumMetadata(db: Db, client: Client, config: Config): Promise<EnumMetadata> {\n  const promises = db.tables\n    .filter((t) => isEnumTable(config, t))\n    .mapToArray(async (table) => {\n      const result = await client.query(`SELECT * FROM ${table.name} ORDER BY id`);\n      const rows = result.rows.map((row) => row as EnumRow);\n      // We're not really an entity, but appropriate EntityDbMetadata's `primitives` filtering\n      const extraPrimitives = new EntityDbMetadata(config, table).primitives.filter(\n        (p) => ![\"code\", \"name\"].includes(p.fieldName),\n      );\n      return [\n        table.name,\n        {\n          table,\n          idType: table.columns.get(\"id\")!.type.name === \"uuid\" ? \"uuid\" : \"integer\",\n          name: pascalCase(table.name), // use tableToEntityName?\n          rows,\n          extraPrimitives,\n        },\n      ] satisfies [string, EnumTableData];\n    });\n  return Object.fromEntries(await Promise.all(promises));\n}\n\nexport async function loadPgEnumMetadata(db: Db, client: Client, config: Config): Promise<PgEnumMetadata> {\n  return db.types.reduce((all, type) => {\n    if (type instanceof EnumType) {\n      return {\n        ...all,\n        [type.name]: {\n          name: pascalCase(type.name),\n          values: type.values,\n        },\n      };\n    }\n    return all;\n  }, {});\n}\n"],"mappings":";;;;;;;;AA2BA,eAAsB,iBAAiB,IAAQ,QAAgB,QAAuC;CACpG,MAAM,WAAW,GAAG,OACjB,QAAQ,MAAMA,cAAAA,YAAY,QAAQ,CAAC,CAAC,CAAC,CACrC,WAAW,OAAO,UAAU;EAE3B,MAAM,QAAO,MADQ,OAAO,MAAM,iBAAiB,MAAM,KAAK,aAAa,EAAA,CACvD,KAAK,KAAK,QAAQ,GAAc;EAEpD,MAAM,kBAAkB,IAAIC,yBAAAA,iBAAiB,QAAQ,KAAK,CAAC,CAAC,WAAW,QACpE,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAC/C;EACA,OAAO,CACL,MAAM,MACN;GACE;GACA,QAAQ,MAAM,QAAQ,IAAI,IAAI,CAAC,CAAE,KAAK,SAAS,SAAS,SAAS;GACjE,OAAA,GAAMC,YAAAA,WAAAA,CAAW,MAAM,IAAI;GAC3B;GACA;EACF,CACF;CACF,CAAC;CACH,OAAO,OAAO,YAAY,MAAM,QAAQ,IAAI,QAAQ,CAAC;AACvD;AAEA,eAAsB,mBAAmB,IAAQ,QAAgB,QAAyC;CACxG,OAAO,GAAG,MAAM,QAAQ,KAAK,SAAS;EACpC,IAAI,gBAAgBC,aAAAA,UAClB,OAAO;GACL,GAAG;IACF,KAAK,OAAO;IACX,OAAA,GAAMD,YAAAA,WAAAA,CAAW,KAAK,IAAI;IAC1B,QAAQ,KAAK;GACf;EACF;EAEF,OAAO;CACT,GAAG,CAAC,CAAC;AACP"}
+{"version":3,"file":"loadMetadata.cjs","names":["isEnumTable","EntityDbMetadata","pascalCase","EnumType"],"sources":["../src/loadMetadata.ts"],"sourcesContent":["import { pascalCase } from \"change-case\";\nimport { type Client } from \"pg\";\n\nimport { type Config, EntityDbMetadata, type PrimitiveField } from \"./index.ts\";\nimport { type Db, EnumType, type Table } from \"./pgMetadata.ts\";\nimport { isEnumTable } from \"./utils.ts\";\n\n/** A map from Enum table name to the rows currently in the table. */\nexport type EnumTableData = {\n  table: Table;\n  idType: \"integer\" | \"uuid\";\n  // Pascal case version of table name\n  name: string;\n  rows: EnumRow[];\n  extraPrimitives: PrimitiveField[];\n};\n\nexport type PgEnumData = {\n  name: string;\n  values: string[];\n};\n\nexport type EnumMetadata = Record<string, EnumTableData>;\nexport type PgEnumMetadata = Record<string, PgEnumData>;\n\nexport type EnumRow = { id: number; code: string; name: string; [key: string]: any };\n\nexport async function loadEnumMetadata(db: Db, client: Client, config: Config): Promise<EnumMetadata> {\n  const promises = db.tables\n    .filter((t) => isEnumTable(config, t))\n    .map(async (table) => {\n      const result = await client.query(`SELECT * FROM ${table.name} ORDER BY id`);\n      const rows = result.rows.map((row) => row as EnumRow);\n      // We're not really an entity, but appropriate EntityDbMetadata's `primitives` filtering\n      const extraPrimitives = new EntityDbMetadata(config, table).primitives.filter(\n        (p) => ![\"code\", \"name\"].includes(p.fieldName),\n      );\n      return [\n        table.name,\n        {\n          table,\n          idType: table.columns.get(\"id\")!.type.name === \"uuid\" ? \"uuid\" : \"integer\",\n          name: pascalCase(table.name), // use tableToEntityName?\n          rows,\n          extraPrimitives,\n        },\n      ] satisfies [string, EnumTableData];\n    });\n  return Object.fromEntries(await Promise.all(promises));\n}\n\nexport async function loadPgEnumMetadata(db: Db, client: Client, config: Config): Promise<PgEnumMetadata> {\n  return db.types.reduce((all, type) => {\n    if (type instanceof EnumType) {\n      return {\n        ...all,\n        [type.name]: {\n          name: pascalCase(type.name),\n          values: type.values,\n        },\n      };\n    }\n    return all;\n  }, {});\n}\n"],"mappings":";;;;;;;;AA2BA,eAAsB,iBAAiB,IAAQ,QAAgB,QAAuC;CACpG,MAAM,WAAW,GAAG,OACjB,QAAQ,MAAMA,cAAAA,YAAY,QAAQ,CAAC,CAAC,CAAC,CACrC,IAAI,OAAO,UAAU;EAEpB,MAAM,QAAO,MADQ,OAAO,MAAM,iBAAiB,MAAM,KAAK,aAAa,EAAA,CACvD,KAAK,KAAK,QAAQ,GAAc;EAEpD,MAAM,kBAAkB,IAAIC,yBAAAA,iBAAiB,QAAQ,KAAK,CAAC,CAAC,WAAW,QACpE,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAC/C;EACA,OAAO,CACL,MAAM,MACN;GACE;GACA,QAAQ,MAAM,QAAQ,IAAI,IAAI,CAAC,CAAE,KAAK,SAAS,SAAS,SAAS;GACjE,OAAA,GAAMC,YAAAA,WAAAA,CAAW,MAAM,IAAI;GAC3B;GACA;EACF,CACF;CACF,CAAC;CACH,OAAO,OAAO,YAAY,MAAM,QAAQ,IAAI,QAAQ,CAAC;AACvD;AAEA,eAAsB,mBAAmB,IAAQ,QAAgB,QAAyC;CACxG,OAAO,GAAG,MAAM,QAAQ,KAAK,SAAS;EACpC,IAAI,gBAAgBC,mBAAAA,UAClB,OAAO;GACL,GAAG;IACF,KAAK,OAAO;IACX,OAAA,GAAMD,YAAAA,WAAAA,CAAW,KAAK,IAAI;IAC1B,QAAQ,KAAK;GACf;EACF;EAEF,OAAO;CACT,GAAG,CAAC,CAAC;AACP"}

package/build/loadMetadata.d.cts

@@ -1,7 +1,7 @@
 import { Config } from "./config.cjs";
+import { Db, Table } from "./pgMetadata.cjs";
 import "./index.cjs";
 import { PrimitiveField } from "./EntityDbMetadata.cjs";
-import { Db, Table } from "pg-structure";
 import { Client } from "pg";
 //#region src/loadMetadata.d.ts
 /** A map from Enum table name to the rows currently in the table. */

package/build/loadMetadata.d.mts

@@ -1,7 +1,7 @@
 import { Config } from "./config.mjs";
+import { Db, Table } from "./pgMetadata.mjs";
 import "./index.mjs";
 import { PrimitiveField } from "./EntityDbMetadata.mjs";
-import { Db, Table } from "pg-structure";
 import { Client } from "pg";
 //#region src/loadMetadata.d.ts
 /** A map from Enum table name to the rows currently in the table. */

package/build/loadMetadata.js

@@ -1,12 +1,12 @@
+import { EnumType } from "./pgMetadata.js";
 import { isEnumTable } from "./utils.js";
 import "./index.js";
 import { EntityDbMetadata } from "./EntityDbMetadata.js";
 import { pascalCase } from "change-case";
-import { EnumType } from "pg-structure";
 import "pg";
 //#region src/loadMetadata.ts
 async function loadEnumMetadata(db, client, config) {
-	const promises = db.tables.filter((t) => isEnumTable(config, t)).mapToArray(async (table) => {
+	const promises = db.tables.filter((t) => isEnumTable(config, t)).map(async (table) => {
 		const rows = (await client.query(`SELECT * FROM ${table.name} ORDER BY id`)).rows.map((row) => row);
 		const extraPrimitives = new EntityDbMetadata(config, table).primitives.filter((p) => !["code", "name"].includes(p.fieldName));
 		return [table.name, {

package/build/loadMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"loadMetadata.js","names":[],"sources":["../src/loadMetadata.ts"],"sourcesContent":["import { pascalCase } from \"change-case\";\nimport { type Client } from \"pg\";\nimport { type Db, EnumType, type Table } from \"pg-structure\";\n\nimport { type Config, EntityDbMetadata, type PrimitiveField } from \"./index.ts\";\nimport { isEnumTable } from \"./utils.ts\";\n\n/** A map from Enum table name to the rows currently in the table. */\nexport type EnumTableData = {\n  table: Table;\n  idType: \"integer\" | \"uuid\";\n  // Pascal case version of table name\n  name: string;\n  rows: EnumRow[];\n  extraPrimitives: PrimitiveField[];\n};\n\nexport type PgEnumData = {\n  name: string;\n  values: string[];\n};\n\nexport type EnumMetadata = Record<string, EnumTableData>;\nexport type PgEnumMetadata = Record<string, PgEnumData>;\n\nexport type EnumRow = { id: number; code: string; name: string; [key: string]: any };\n\nexport async function loadEnumMetadata(db: Db, client: Client, config: Config): Promise<EnumMetadata> {\n  const promises = db.tables\n    .filter((t) => isEnumTable(config, t))\n    .mapToArray(async (table) => {\n      const result = await client.query(`SELECT * FROM ${table.name} ORDER BY id`);\n      const rows = result.rows.map((row) => row as EnumRow);\n      // We're not really an entity, but appropriate EntityDbMetadata's `primitives` filtering\n      const extraPrimitives = new EntityDbMetadata(config, table).primitives.filter(\n        (p) => ![\"code\", \"name\"].includes(p.fieldName),\n      );\n      return [\n        table.name,\n        {\n          table,\n          idType: table.columns.get(\"id\")!.type.name === \"uuid\" ? \"uuid\" : \"integer\",\n          name: pascalCase(table.name), // use tableToEntityName?\n          rows,\n          extraPrimitives,\n        },\n      ] satisfies [string, EnumTableData];\n    });\n  return Object.fromEntries(await Promise.all(promises));\n}\n\nexport async function loadPgEnumMetadata(db: Db, client: Client, config: Config): Promise<PgEnumMetadata> {\n  return db.types.reduce((all, type) => {\n    if (type instanceof EnumType) {\n      return {\n        ...all,\n        [type.name]: {\n          name: pascalCase(type.name),\n          values: type.values,\n        },\n      };\n    }\n    return all;\n  }, {});\n}\n"],"mappings":";;;;;;;AA2BA,eAAsB,iBAAiB,IAAQ,QAAgB,QAAuC;CACpG,MAAM,WAAW,GAAG,OACjB,QAAQ,MAAM,YAAY,QAAQ,CAAC,CAAC,CAAC,CACrC,WAAW,OAAO,UAAU;EAE3B,MAAM,QAAO,MADQ,OAAO,MAAM,iBAAiB,MAAM,KAAK,aAAa,EAAA,CACvD,KAAK,KAAK,QAAQ,GAAc;EAEpD,MAAM,kBAAkB,IAAI,iBAAiB,QAAQ,KAAK,CAAC,CAAC,WAAW,QACpE,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAC/C;EACA,OAAO,CACL,MAAM,MACN;GACE;GACA,QAAQ,MAAM,QAAQ,IAAI,IAAI,CAAC,CAAE,KAAK,SAAS,SAAS,SAAS;GACjE,MAAM,WAAW,MAAM,IAAI;GAC3B;GACA;EACF,CACF;CACF,CAAC;CACH,OAAO,OAAO,YAAY,MAAM,QAAQ,IAAI,QAAQ,CAAC;AACvD;AAEA,eAAsB,mBAAmB,IAAQ,QAAgB,QAAyC;CACxG,OAAO,GAAG,MAAM,QAAQ,KAAK,SAAS;EACpC,IAAI,gBAAgB,UAClB,OAAO;GACL,GAAG;IACF,KAAK,OAAO;IACX,MAAM,WAAW,KAAK,IAAI;IAC1B,QAAQ,KAAK;GACf;EACF;EAEF,OAAO;CACT,GAAG,CAAC,CAAC;AACP"}
+{"version":3,"file":"loadMetadata.js","names":[],"sources":["../src/loadMetadata.ts"],"sourcesContent":["import { pascalCase } from \"change-case\";\nimport { type Client } from \"pg\";\n\nimport { type Config, EntityDbMetadata, type PrimitiveField } from \"./index.ts\";\nimport { type Db, EnumType, type Table } from \"./pgMetadata.ts\";\nimport { isEnumTable } from \"./utils.ts\";\n\n/** A map from Enum table name to the rows currently in the table. */\nexport type EnumTableData = {\n  table: Table;\n  idType: \"integer\" | \"uuid\";\n  // Pascal case version of table name\n  name: string;\n  rows: EnumRow[];\n  extraPrimitives: PrimitiveField[];\n};\n\nexport type PgEnumData = {\n  name: string;\n  values: string[];\n};\n\nexport type EnumMetadata = Record<string, EnumTableData>;\nexport type PgEnumMetadata = Record<string, PgEnumData>;\n\nexport type EnumRow = { id: number; code: string; name: string; [key: string]: any };\n\nexport async function loadEnumMetadata(db: Db, client: Client, config: Config): Promise<EnumMetadata> {\n  const promises = db.tables\n    .filter((t) => isEnumTable(config, t))\n    .map(async (table) => {\n      const result = await client.query(`SELECT * FROM ${table.name} ORDER BY id`);\n      const rows = result.rows.map((row) => row as EnumRow);\n      // We're not really an entity, but appropriate EntityDbMetadata's `primitives` filtering\n      const extraPrimitives = new EntityDbMetadata(config, table).primitives.filter(\n        (p) => ![\"code\", \"name\"].includes(p.fieldName),\n      );\n      return [\n        table.name,\n        {\n          table,\n          idType: table.columns.get(\"id\")!.type.name === \"uuid\" ? \"uuid\" : \"integer\",\n          name: pascalCase(table.name), // use tableToEntityName?\n          rows,\n          extraPrimitives,\n        },\n      ] satisfies [string, EnumTableData];\n    });\n  return Object.fromEntries(await Promise.all(promises));\n}\n\nexport async function loadPgEnumMetadata(db: Db, client: Client, config: Config): Promise<PgEnumMetadata> {\n  return db.types.reduce((all, type) => {\n    if (type instanceof EnumType) {\n      return {\n        ...all,\n        [type.name]: {\n          name: pascalCase(type.name),\n          values: type.values,\n        },\n      };\n    }\n    return all;\n  }, {});\n}\n"],"mappings":";;;;;;;AA2BA,eAAsB,iBAAiB,IAAQ,QAAgB,QAAuC;CACpG,MAAM,WAAW,GAAG,OACjB,QAAQ,MAAM,YAAY,QAAQ,CAAC,CAAC,CAAC,CACrC,IAAI,OAAO,UAAU;EAEpB,MAAM,QAAO,MADQ,OAAO,MAAM,iBAAiB,MAAM,KAAK,aAAa,EAAA,CACvD,KAAK,KAAK,QAAQ,GAAc;EAEpD,MAAM,kBAAkB,IAAI,iBAAiB,QAAQ,KAAK,CAAC,CAAC,WAAW,QACpE,MAAM,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAC/C;EACA,OAAO,CACL,MAAM,MACN;GACE;GACA,QAAQ,MAAM,QAAQ,IAAI,IAAI,CAAC,CAAE,KAAK,SAAS,SAAS,SAAS;GACjE,MAAM,WAAW,MAAM,IAAI;GAC3B;GACA;EACF,CACF;CACF,CAAC;CACH,OAAO,OAAO,YAAY,MAAM,QAAQ,IAAI,QAAQ,CAAC;AACvD;AAEA,eAAsB,mBAAmB,IAAQ,QAAgB,QAAyC;CACxG,OAAO,GAAG,MAAM,QAAQ,KAAK,SAAS;EACpC,IAAI,gBAAgB,UAClB,OAAO;GACL,GAAG;IACF,KAAK,OAAO;IACX,MAAM,WAAW,KAAK,IAAI;IAC1B,QAAQ,KAAK;GACf;EACF;EAEF,OAAO;CACT,GAAG,CAAC,CAAC;AACP"}

package/build/pgMetadata.cjs

@@ -0,0 +1,301 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/pgMetadata.ts
+/** The small part of PostgreSQL's catalog model used by Joist codegen. */
+var Items = class extends Array {
+	byName;
+	/** Looks up a column by name without scanning the table on every call. */
+	get(name) {
+		this.byName ??= new Map(this.map((item) => [item.name, item]));
+		const item = this.byName.get(name);
+		if (!item) throw new Error(`No item named ${name}`);
+		return item;
+	}
+	/** Keep the name index current if more catalog rows arrive after a lookup. */
+	push(...items) {
+		const length = super.push(...items);
+		if (this.byName) for (const item of items) this.byName.set(item.name, item);
+		return length;
+	}
+};
+var EnumType = class {
+	name;
+	values;
+	shortName;
+	constructor(name, values) {
+		this.name = name;
+		this.values = values;
+	}
+};
+var Column = class {
+	name;
+	type;
+	notNull;
+	defaultValue;
+	isGenerated;
+	arrayDimension;
+	comment;
+	foreignKeys = [];
+	uniqueIndexes = [];
+	isPrimaryKey = false;
+	constructor(name, type, notNull, defaultValue, isGenerated, arrayDimension, comment) {
+		this.name = name;
+		this.type = type;
+		this.notNull = notNull;
+		this.defaultValue = defaultValue;
+		this.isGenerated = isGenerated;
+		this.arrayDimension = arrayDimension;
+		this.comment = comment;
+	}
+	get isForeignKey() {
+		return this.foreignKeys.length > 0;
+	}
+	get default() {
+		return this.defaultValue?.replace(/^('.*?')::.+$/, "$1") ?? null;
+	}
+	get commentData() {
+		const data = this.comment?.match(/\[pg-structure\]([\s\S]*?)\[\/pg-structure\]/)?.[1];
+		return data ? JSON.parse(data) : void 0;
+	}
+};
+var Index = class {
+	name;
+	columns;
+	isUnique;
+	isPartial;
+	constructor(name, columns, isUnique, isPartial) {
+		this.name = name;
+		this.columns = columns;
+		this.isUnique = isUnique;
+		this.isPartial = isPartial;
+	}
+};
+var ForeignKey = class {
+	name;
+	table;
+	referencedTable;
+	columns;
+	isDeferred;
+	isDeferrable;
+	onDelete;
+	constructor(name, table, referencedTable, columns, isDeferred, isDeferrable, onDelete) {
+		this.name = name;
+		this.table = table;
+		this.referencedTable = referencedTable;
+		this.columns = columns;
+		this.isDeferred = isDeferred;
+		this.isDeferrable = isDeferrable;
+		this.onDelete = onDelete;
+	}
+};
+var M2ORelation = class {
+	foreignKey;
+	type = "m2o";
+	constructor(foreignKey) {
+		this.foreignKey = foreignKey;
+	}
+	get sourceTable() {
+		return this.foreignKey.table;
+	}
+	get targetTable() {
+		return this.foreignKey.referencedTable;
+	}
+};
+var O2MRelation = class {
+	foreignKey;
+	type = "o2m";
+	constructor(foreignKey) {
+		this.foreignKey = foreignKey;
+	}
+	get sourceTable() {
+		return this.foreignKey.referencedTable;
+	}
+	get targetTable() {
+		return this.foreignKey.table;
+	}
+};
+var M2MRelation = class {
+	foreignKey;
+	targetForeignKey;
+	type = "m2m";
+	constructor(foreignKey, targetForeignKey) {
+		this.foreignKey = foreignKey;
+		this.targetForeignKey = targetForeignKey;
+	}
+	get sourceTable() {
+		return this.foreignKey.referencedTable;
+	}
+	get targetTable() {
+		return this.targetForeignKey.referencedTable;
+	}
+	get joinTable() {
+		return this.foreignKey.table;
+	}
+};
+var Table = class {
+	name;
+	schema;
+	columns = new Items();
+	indexes = new Items();
+	foreignKeys = [];
+	foreignKeysToThis = [];
+	uniqueConstraints = [];
+	primaryKey;
+	constructor(name, schema) {
+		this.name = name;
+		this.schema = schema;
+	}
+	get m2oRelations() {
+		return this.foreignKeys.map((fk) => new M2ORelation(fk));
+	}
+	get o2mRelations() {
+		return this.foreignKeysToThis.map((fk) => new O2MRelation(fk));
+	}
+	get m2mRelations() {
+		return this.foreignKeysToThis.flatMap((fk) => fk.table.foreignKeys.filter((other) => other !== fk).map((other) => new M2MRelation(fk, other)));
+	}
+};
+/**
+* Reads only the PostgreSQL catalog data used by codegen.
+*
+* Load tables and columns before constraints so each foreign key can link the same Table and Column
+* objects used by entity fields. For example, books.author_id and authors.id are joined through
+* the foreign key, while a trigger calling cyanaudit in another schema is irrelevant to codegen.
+*/
+async function loadPgMetadata(client) {
+	const tables = new Items();
+	const byOid = /* @__PURE__ */ new Map();
+	const columns = /* @__PURE__ */ new Map();
+	const tableRows = await client.query(`
+    SELECT c.oid, c.relname AS name, n.nspname AS schema
+    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
+    WHERE c.relkind IN ('r', 'p') AND n.nspname <> 'information_schema'
+      AND n.nspname NOT LIKE 'pg_%' AND NOT pg_is_other_temp_schema(n.oid)
+    ORDER BY n.nspname, c.relname
+  `);
+	for (const row of tableRows.rows) {
+		const table = new Table(row.name, { name: row.schema });
+		tables.push(table);
+		byOid.set(row.oid, table);
+		columns.set(row.oid, /* @__PURE__ */ new Map());
+	}
+	const enumRows = await client.query(`
+    SELECT t.oid, t.typname AS name, e.enumlabel AS value
+    FROM pg_type t JOIN pg_enum e ON e.enumtypid = t.oid
+    JOIN pg_namespace n ON n.oid = t.typnamespace
+    WHERE n.nspname <> 'information_schema' AND n.nspname NOT LIKE 'pg_%'
+    ORDER BY t.oid, e.enumsortorder
+  `);
+	const enums = /* @__PURE__ */ new Map();
+	for (const row of enumRows.rows) {
+		if (!enums.has(row.oid)) enums.set(row.oid, new EnumType(row.name, []));
+		enums.get(row.oid).values.push(row.value);
+	}
+	const columnRows = await client.query(`
+    SELECT a.attrelid AS "tableOid", a.attnum AS position, a.attname AS name,
+      COALESCE(NULLIF(t.typelem, 0), t.oid) AS "typeOid",
+      base.typname AS "typeName", a.attnotnull AS "notNull",
+      pg_get_expr(d.adbin, d.adrelid) AS "defaultValue", a.attgenerated AS generated,
+      a.attndims AS "arrayDimension", col_description(a.attrelid, a.attnum) AS comment
+    FROM pg_attribute a JOIN pg_type t ON t.oid = a.atttypid
+    JOIN pg_type base ON base.oid = COALESCE(NULLIF(t.typelem, 0), t.oid)
+    LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum
+    WHERE a.attrelid = ANY($1::oid[]) AND a.attnum > 0 AND NOT a.attisdropped
+    ORDER BY a.attrelid, a.attnum
+  `, [Array.from(byOid.keys())]);
+	for (const row of columnRows.rows) {
+		const type = enums.get(row.typeOid) ?? sqlType(row.typeName);
+		const column = new Column(row.name, type, row.notNull, row.defaultValue, row.generated !== "", row.arrayDimension, row.comment);
+		byOid.get(row.tableOid).columns.push(column);
+		columns.get(row.tableOid).set(row.position, column);
+	}
+	const indexRows = await client.query(`
+    SELECT i.indrelid AS "tableOid", i.indexrelid AS "indexOid", c.relname AS name,
+      i.indkey::int2[] AS positions, i.indisunique AS unique, i.indpred IS NOT NULL AS partial
+    FROM pg_index i JOIN pg_class c ON c.oid = i.indexrelid
+    WHERE i.indrelid = ANY($1::oid[])
+  `, [Array.from(byOid.keys())]);
+	const indexes = /* @__PURE__ */ new Map();
+	for (const row of indexRows.rows) {
+		const table = byOid.get(row.tableOid);
+		const index = new Index(row.name, row.positions.flatMap((pos) => columns.get(row.tableOid).get(pos) ?? []), row.unique, row.partial);
+		table.indexes.push(index);
+		indexes.set(row.indexOid, index);
+		if (row.unique) for (const column of index.columns) column.uniqueIndexes.push(index);
+	}
+	const constraintRows = await client.query(`
+    SELECT conrelid AS "tableOid", confrelid AS "targetOid", conindid AS "indexOid",
+      conname AS name, contype AS kind, conkey AS positions,
+      condeferred AS deferred, condeferrable AS deferrable, confdeltype AS "onDelete"
+    FROM pg_constraint WHERE conrelid = ANY($1::oid[]) AND contype IN ('p', 'u', 'f')
+    ORDER BY conrelid, conname
+  `, [Array.from(byOid.keys())]);
+	for (const row of constraintRows.rows) {
+		const table = byOid.get(row.tableOid);
+		const keys = (row.positions ?? []).map((pos) => columns.get(row.tableOid).get(pos));
+		if (row.kind === "p") {
+			table.primaryKey = { columns: keys };
+			for (const column of keys) column.isPrimaryKey = true;
+		} else if (row.kind === "u") table.uniqueConstraints.push({
+			columns: keys,
+			index: indexes.get(row.indexOid)
+		});
+		else {
+			const target = byOid.get(row.targetOid);
+			if (!target) continue;
+			const fk = new ForeignKey(row.name, table, target, keys, row.deferred, row.deferrable, deleteAction(row.onDelete));
+			table.foreignKeys.push(fk);
+			target.foreignKeysToThis.push(fk);
+			for (const column of keys) column.foreignKeys.push(fk);
+		}
+	}
+	return {
+		tables,
+		types: Array.from(enums.values())
+	};
+}
+/** Matches the type names codegen expects from PostgreSQL's builtin aliases. */
+function sqlType(name) {
+	switch (name) {
+		case "int2": return { name: "smallint" };
+		case "int4": return {
+			name: "integer",
+			shortName: "int"
+		};
+		case "int8": return { name: "bigint" };
+		case "bool": return { name: "boolean" };
+		case "float4": return { name: "real" };
+		case "float8": return { name: "double precision" };
+		case "varchar": return { name: "character varying" };
+		case "timestamptz": return { name: "timestamp with time zone" };
+		case "timestamp": return { name: "timestamp without time zone" };
+		case "time": return { name: "time without time zone" };
+		default: return {
+			name,
+			shortName: name
+		};
+	}
+}
+/** Decodes the pg_constraint foreign-key delete action. */
+function deleteAction(code) {
+	switch (code) {
+		case "a": return "NO ACTION";
+		case "r": return "RESTRICT";
+		case "c": return "CASCADE";
+		case "n": return "SET NULL";
+		case "d": return "SET DEFAULT";
+		default: throw new Error(`Unknown PostgreSQL delete action: ${code}`);
+	}
+}
+//#endregion
+exports.Column = Column;
+exports.EnumType = EnumType;
+exports.ForeignKey = ForeignKey;
+exports.Index = Index;
+exports.Items = Items;
+exports.M2MRelation = M2MRelation;
+exports.M2ORelation = M2ORelation;
+exports.O2MRelation = O2MRelation;
+exports.Table = Table;
+exports.loadPgMetadata = loadPgMetadata;
+
+//# sourceMappingURL=pgMetadata.cjs.map

package/build/pgMetadata.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgMetadata.cjs","names":[],"sources":["../src/pgMetadata.ts"],"sourcesContent":["import type { Client } from \"pg\";\n\n/** The small part of PostgreSQL's catalog model used by Joist codegen. */\nexport class Items<T extends { name: string }> extends Array<T> {\n  private byName?: Map<string, T>;\n\n  /** Looks up a column by name without scanning the table on every call. */\n  get(name: string): T {\n    // Catalog rows are appended before codegen reads them. Build the index on first lookup\n    // so derived arrays from filter/map can still be indexed without special handling.\n    this.byName ??= new Map(this.map((item) => [item.name, item]));\n    const item = this.byName.get(name);\n    if (!item) throw new Error(`No item named ${name}`);\n    return item;\n  }\n\n  /** Keep the name index current if more catalog rows arrive after a lookup. */\n  push(...items: T[]): number {\n    const length = super.push(...items);\n    if (this.byName) for (const item of items) this.byName.set(item.name, item);\n    return length;\n  }\n}\n\nexport type Action = \"NO ACTION\" | \"RESTRICT\" | \"CASCADE\" | \"SET NULL\" | \"SET DEFAULT\";\nexport type JSONData = string | number | boolean | null | JSONData[] | { [key: string]: JSONData };\n\nexport class EnumType {\n  readonly shortName?: string;\n  constructor(\n    public name: string,\n    public values: string[],\n  ) {}\n}\n\nexport class Column {\n  readonly foreignKeys: ForeignKey[] = [];\n  readonly uniqueIndexes: Index[] = [];\n  isPrimaryKey = false;\n\n  constructor(\n    public name: string,\n    public type: { name: string; shortName?: string } | EnumType,\n    public notNull: boolean,\n    public defaultValue: string | null,\n    public isGenerated: boolean,\n    public arrayDimension: number,\n    public comment: string | null,\n  ) {}\n\n  get isForeignKey(): boolean {\n    return this.foreignKeys.length > 0;\n  }\n\n  get default(): string | null {\n    return this.defaultValue?.replace(/^('.*?')::.+$/, \"$1\") ?? null;\n  }\n\n  get commentData(): JSONData | undefined {\n    const data = this.comment?.match(/\\[pg-structure\\]([\\s\\S]*?)\\[\\/pg-structure\\]/)?.[1];\n    return data ? (JSON.parse(data) as JSONData) : undefined;\n  }\n}\n\nexport class Index {\n  constructor(\n    public name: string,\n    public columns: Column[],\n    public isUnique: boolean,\n    public isPartial: boolean,\n  ) {}\n}\n\nexport class ForeignKey {\n  constructor(\n    public name: string,\n    public table: Table,\n    public referencedTable: Table,\n    public columns: Column[],\n    public isDeferred: boolean,\n    public isDeferrable: boolean,\n    public onDelete: Action,\n  ) {}\n}\n\nexport class M2ORelation {\n  readonly type = \"m2o\";\n\n  constructor(public foreignKey: ForeignKey) {}\n\n  get sourceTable(): Table {\n    return this.foreignKey.table;\n  }\n\n  get targetTable(): Table {\n    return this.foreignKey.referencedTable;\n  }\n}\n\nexport class O2MRelation {\n  readonly type = \"o2m\";\n\n  constructor(public foreignKey: ForeignKey) {}\n\n  get sourceTable(): Table {\n    return this.foreignKey.referencedTable;\n  }\n\n  get targetTable(): Table {\n    return this.foreignKey.table;\n  }\n}\n\nexport class M2MRelation {\n  readonly type = \"m2m\";\n\n  constructor(\n    public foreignKey: ForeignKey,\n    public targetForeignKey: ForeignKey,\n  ) {}\n\n  get sourceTable(): Table {\n    return this.foreignKey.referencedTable;\n  }\n\n  get targetTable(): Table {\n    return this.targetForeignKey.referencedTable;\n  }\n\n  get joinTable(): Table {\n    return this.foreignKey.table;\n  }\n}\n\nexport class Table {\n  readonly columns = new Items<Column>();\n  readonly indexes = new Items<Index>();\n  readonly foreignKeys: ForeignKey[] = [];\n  readonly foreignKeysToThis: ForeignKey[] = [];\n  readonly uniqueConstraints: { columns: Column[]; index: Index }[] = [];\n  primaryKey?: { columns: Column[] };\n\n  constructor(\n    public name: string,\n    public schema: { name: string },\n  ) {}\n\n  get m2oRelations(): M2ORelation[] {\n    return this.foreignKeys.map((fk) => new M2ORelation(fk));\n  }\n\n  get o2mRelations(): O2MRelation[] {\n    return this.foreignKeysToThis.map((fk) => new O2MRelation(fk));\n  }\n\n  get m2mRelations(): M2MRelation[] {\n    return this.foreignKeysToThis.flatMap((fk) =>\n      fk.table.foreignKeys.filter((other) => other !== fk).map((other) => new M2MRelation(fk, other)),\n    );\n  }\n}\n\nexport type Db = { tables: Items<Table>; types: EnumType[] };\n\n/**\n * Reads only the PostgreSQL catalog data used by codegen.\n *\n * Load tables and columns before constraints so each foreign key can link the same Table and Column\n * objects used by entity fields. For example, books.author_id and authors.id are joined through\n * the foreign key, while a trigger calling cyanaudit in another schema is irrelevant to codegen.\n */\nexport async function loadPgMetadata(client: Client): Promise<Db> {\n  const tables = new Items<Table>();\n  const byOid = new Map<number, Table>();\n  const columns = new Map<number, Map<number, Column>>();\n\n  const tableRows = await client.query<{ oid: number; name: string; schema: string }>(`\n    SELECT c.oid, c.relname AS name, n.nspname AS schema\n    FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace\n    WHERE c.relkind IN ('r', 'p') AND n.nspname <> 'information_schema'\n      AND n.nspname NOT LIKE 'pg_%' AND NOT pg_is_other_temp_schema(n.oid)\n    ORDER BY n.nspname, c.relname\n  `);\n  for (const row of tableRows.rows) {\n    const table = new Table(row.name, { name: row.schema });\n    tables.push(table);\n    byOid.set(row.oid, table);\n    columns.set(row.oid, new Map());\n  }\n\n  const enumRows = await client.query<{ oid: number; name: string; value: string }>(`\n    SELECT t.oid, t.typname AS name, e.enumlabel AS value\n    FROM pg_type t JOIN pg_enum e ON e.enumtypid = t.oid\n    JOIN pg_namespace n ON n.oid = t.typnamespace\n    WHERE n.nspname <> 'information_schema' AND n.nspname NOT LIKE 'pg_%'\n    ORDER BY t.oid, e.enumsortorder\n  `);\n  const enums = new Map<number, EnumType>();\n  for (const row of enumRows.rows) {\n    if (!enums.has(row.oid)) enums.set(row.oid, new EnumType(row.name, []));\n    enums.get(row.oid)!.values.push(row.value);\n  }\n\n  const columnRows = await client.query<{\n    tableOid: number;\n    position: number;\n    name: string;\n    typeOid: number;\n    typeName: string;\n    notNull: boolean;\n    defaultValue: string | null;\n    generated: string;\n    arrayDimension: number;\n    comment: string | null;\n  }>(\n    `\n    SELECT a.attrelid AS \"tableOid\", a.attnum AS position, a.attname AS name,\n      COALESCE(NULLIF(t.typelem, 0), t.oid) AS \"typeOid\",\n      base.typname AS \"typeName\", a.attnotnull AS \"notNull\",\n      pg_get_expr(d.adbin, d.adrelid) AS \"defaultValue\", a.attgenerated AS generated,\n      a.attndims AS \"arrayDimension\", col_description(a.attrelid, a.attnum) AS comment\n    FROM pg_attribute a JOIN pg_type t ON t.oid = a.atttypid\n    JOIN pg_type base ON base.oid = COALESCE(NULLIF(t.typelem, 0), t.oid)\n    LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum\n    WHERE a.attrelid = ANY($1::oid[]) AND a.attnum > 0 AND NOT a.attisdropped\n    ORDER BY a.attrelid, a.attnum\n  `,\n    [Array.from(byOid.keys())],\n  );\n  for (const row of columnRows.rows) {\n    const type = enums.get(row.typeOid) ?? sqlType(row.typeName);\n    const column = new Column(\n      row.name,\n      type,\n      row.notNull,\n      row.defaultValue,\n      row.generated !== \"\",\n      row.arrayDimension,\n      row.comment,\n    );\n    byOid.get(row.tableOid)!.columns.push(column);\n    columns.get(row.tableOid)!.set(row.position, column);\n  }\n\n  const indexRows = await client.query<{\n    tableOid: number;\n    indexOid: number;\n    name: string;\n    positions: number[];\n    unique: boolean;\n    partial: boolean;\n  }>(\n    `\n    SELECT i.indrelid AS \"tableOid\", i.indexrelid AS \"indexOid\", c.relname AS name,\n      i.indkey::int2[] AS positions, i.indisunique AS unique, i.indpred IS NOT NULL AS partial\n    FROM pg_index i JOIN pg_class c ON c.oid = i.indexrelid\n    WHERE i.indrelid = ANY($1::oid[])\n  `,\n    [Array.from(byOid.keys())],\n  );\n  const indexes = new Map<number, Index>();\n  for (const row of indexRows.rows) {\n    const table = byOid.get(row.tableOid)!;\n    const index = new Index(\n      row.name,\n      row.positions.flatMap((pos) => columns.get(row.tableOid)!.get(pos) ?? []),\n      row.unique,\n      row.partial,\n    );\n    table.indexes.push(index);\n    indexes.set(row.indexOid, index);\n    if (row.unique) for (const column of index.columns) column.uniqueIndexes.push(index);\n  }\n\n  const constraintRows = await client.query<{\n    tableOid: number;\n    targetOid: number;\n    indexOid: number;\n    name: string;\n    kind: string;\n    positions: number[] | null;\n    deferred: boolean;\n    deferrable: boolean;\n    onDelete: string;\n  }>(\n    `\n    SELECT conrelid AS \"tableOid\", confrelid AS \"targetOid\", conindid AS \"indexOid\",\n      conname AS name, contype AS kind, conkey AS positions,\n      condeferred AS deferred, condeferrable AS deferrable, confdeltype AS \"onDelete\"\n    FROM pg_constraint WHERE conrelid = ANY($1::oid[]) AND contype IN ('p', 'u', 'f')\n    ORDER BY conrelid, conname\n  `,\n    [Array.from(byOid.keys())],\n  );\n  for (const row of constraintRows.rows) {\n    const table = byOid.get(row.tableOid)!;\n    const keys = (row.positions ?? []).map((pos) => columns.get(row.tableOid)!.get(pos)!);\n    if (row.kind === \"p\") {\n      table.primaryKey = { columns: keys };\n      for (const column of keys) column.isPrimaryKey = true;\n    } else if (row.kind === \"u\") {\n      table.uniqueConstraints.push({ columns: keys, index: indexes.get(row.indexOid)! });\n    } else {\n      const target = byOid.get(row.targetOid);\n      if (!target) continue;\n      const fk = new ForeignKey(\n        row.name,\n        table,\n        target,\n        keys,\n        row.deferred,\n        row.deferrable,\n        deleteAction(row.onDelete),\n      );\n      table.foreignKeys.push(fk);\n      target.foreignKeysToThis.push(fk);\n      for (const column of keys) column.foreignKeys.push(fk);\n    }\n  }\n\n  return { tables, types: Array.from(enums.values()) };\n}\n\n/** Matches the type names codegen expects from PostgreSQL's builtin aliases. */\nfunction sqlType(name: string): { name: string; shortName?: string } {\n  switch (name) {\n    case \"int2\":\n      return { name: \"smallint\" };\n    case \"int4\":\n      return { name: \"integer\", shortName: \"int\" };\n    case \"int8\":\n      return { name: \"bigint\" };\n    case \"bool\":\n      return { name: \"boolean\" };\n    case \"float4\":\n      return { name: \"real\" };\n    case \"float8\":\n      return { name: \"double precision\" };\n    case \"varchar\":\n      return { name: \"character varying\" };\n    case \"timestamptz\":\n      return { name: \"timestamp with time zone\" };\n    case \"timestamp\":\n      return { name: \"timestamp without time zone\" };\n    case \"time\":\n      return { name: \"time without time zone\" };\n    default:\n      // Foreign-key serdes need shortName even for types with no PostgreSQL alias, such as uuid.\n      return { name, shortName: name };\n  }\n}\n\n/** Decodes the pg_constraint foreign-key delete action. */\nfunction deleteAction(code: string): Action {\n  switch (code) {\n    case \"a\":\n      return \"NO ACTION\";\n    case \"r\":\n      return \"RESTRICT\";\n    case \"c\":\n      return \"CASCADE\";\n    case \"n\":\n      return \"SET NULL\";\n    case \"d\":\n      return \"SET DEFAULT\";\n    default:\n      throw new Error(`Unknown PostgreSQL delete action: ${code}`);\n  }\n}\n"],"mappings":"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"}

package/build/pgMetadata.d.cts

@@ -0,0 +1,122 @@
+import { Client } from "pg";
+//#region src/pgMetadata.d.ts
+/** The small part of PostgreSQL's catalog model used by Joist codegen. */
+declare class Items<T extends {
+  name: string;
+}> extends Array<T> {
+  private byName?;
+  /** Looks up a column by name without scanning the table on every call. */
+  get(name: string): T;
+  /** Keep the name index current if more catalog rows arrive after a lookup. */
+  push(...items: T[]): number;
+}
+type Action = "NO ACTION" | "RESTRICT" | "CASCADE" | "SET NULL" | "SET DEFAULT";
+type JSONData = string | number | boolean | null | JSONData[] | {
+  [key: string]: JSONData;
+};
+declare class EnumType {
+  name: string;
+  values: string[];
+  readonly shortName?: string;
+  constructor(name: string, values: string[]);
+}
+declare class Column {
+  name: string;
+  type: {
+    name: string;
+    shortName?: string;
+  } | EnumType;
+  notNull: boolean;
+  defaultValue: string | null;
+  isGenerated: boolean;
+  arrayDimension: number;
+  comment: string | null;
+  readonly foreignKeys: ForeignKey[];
+  readonly uniqueIndexes: Index[];
+  isPrimaryKey: boolean;
+  constructor(name: string, type: {
+    name: string;
+    shortName?: string;
+  } | EnumType, notNull: boolean, defaultValue: string | null, isGenerated: boolean, arrayDimension: number, comment: string | null);
+  get isForeignKey(): boolean;
+  get default(): string | null;
+  get commentData(): JSONData | undefined;
+}
+declare class Index {
+  name: string;
+  columns: Column[];
+  isUnique: boolean;
+  isPartial: boolean;
+  constructor(name: string, columns: Column[], isUnique: boolean, isPartial: boolean);
+}
+declare class ForeignKey {
+  name: string;
+  table: Table;
+  referencedTable: Table;
+  columns: Column[];
+  isDeferred: boolean;
+  isDeferrable: boolean;
+  onDelete: Action;
+  constructor(name: string, table: Table, referencedTable: Table, columns: Column[], isDeferred: boolean, isDeferrable: boolean, onDelete: Action);
+}
+declare class M2ORelation {
+  foreignKey: ForeignKey;
+  readonly type = "m2o";
+  constructor(foreignKey: ForeignKey);
+  get sourceTable(): Table;
+  get targetTable(): Table;
+}
+declare class O2MRelation {
+  foreignKey: ForeignKey;
+  readonly type = "o2m";
+  constructor(foreignKey: ForeignKey);
+  get sourceTable(): Table;
+  get targetTable(): Table;
+}
+declare class M2MRelation {
+  foreignKey: ForeignKey;
+  targetForeignKey: ForeignKey;
+  readonly type = "m2m";
+  constructor(foreignKey: ForeignKey, targetForeignKey: ForeignKey);
+  get sourceTable(): Table;
+  get targetTable(): Table;
+  get joinTable(): Table;
+}
+declare class Table {
+  name: string;
+  schema: {
+    name: string;
+  };
+  readonly columns: Items<Column>;
+  readonly indexes: Items<Index>;
+  readonly foreignKeys: ForeignKey[];
+  readonly foreignKeysToThis: ForeignKey[];
+  readonly uniqueConstraints: {
+    columns: Column[];
+    index: Index;
+  }[];
+  primaryKey?: {
+    columns: Column[];
+  };
+  constructor(name: string, schema: {
+    name: string;
+  });
+  get m2oRelations(): M2ORelation[];
+  get o2mRelations(): O2MRelation[];
+  get m2mRelations(): M2MRelation[];
+}
+type Db = {
+  tables: Items<Table>;
+  types: EnumType[];
+};
+/**
+ * Reads only the PostgreSQL catalog data used by codegen.
+ *
+ * Load tables and columns before constraints so each foreign key can link the same Table and Column
+ * objects used by entity fields. For example, books.author_id and authors.id are joined through
+ * the foreign key, while a trigger calling cyanaudit in another schema is irrelevant to codegen.
+ */
+declare function loadPgMetadata(client: Client): Promise<Db>;
+//#endregion
+export { Action, Column, Db, EnumType, ForeignKey, Index, Items, JSONData, M2MRelation, M2ORelation, O2MRelation, Table, loadPgMetadata };
+//# sourceMappingURL=pgMetadata.d.cts.map

package/build/pgMetadata.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgMetadata.d.cts","names":[],"sources":["../src/pgMetadata.ts"],"mappings":";;;cAGa,MAAM;EAAY;WAAwB,MAAM;UACnD;;EAGR,IAAI,eAAe;;EAUnB,QAAQ,OAAO;;KAOL;KACA,8CAA8C;GAAgB,cAAc;;cAE3E;EAGF;EACA;WAHA;EACT,YACS,cACA;;cAIE;EAMF;EACA;IAAQ;IAAc;MAAuB;EAC7C;EACA;EACA;EACA;EACA;WAXA,aAAa;WACb,eAAe;EACxB;EAEA,YACS,cACA;IAAQ;IAAc;MAAuB,UAC7C,kBACA,6BACA,sBACA,wBACA;MAGL;MAIA;MAIA,eAAe;;cAMR;EAEF;EACA,SAAS;EACT;EACA;EAJT,YACS,cACA,SAAS,UACT,mBACA;;cAIE;EAEF;EACA,OAAO;EACP,iBAAiB;EACjB,SAAS;EACT;EACA;EACA,UAAU;EAPnB,YACS,cACA,OAAO,OACP,iBAAiB,OACjB,SAAS,UACT,qBACA,uBACA,UAAU;;cAIR;EAGQ,YAAY;WAFtB;EAET,YAAmB,YAAY;MAE3B,eAAe;MAIf,eAAe;;cAKR;EAGQ,YAAY;WAFtB;EAET,YAAmB,YAAY;MAE3B,eAAe;MAIf,eAAe;;cAKR;EAIF,YAAY;EACZ,kBAAkB;WAJlB;EAET,YACS,YAAY,YACZ,kBAAkB;MAGvB,eAAe;MAIf,eAAe;MAIf,aAAa;;cAKN;EASF;EACA;IAAU;;WATV,SAAO,MAAA;WACP,SAAO,MAAA;WACP,aAAa;WACb,mBAAmB;WACnB;IAAqB,SAAS;IAAU,OAAO;;EACxD;IAAe,SAAS;;EAExB,YACS,cACA;IAAU;;MAGf,gBAAgB;MAIhB,gBAAgB;MAIhB,gBAAgB;;KAOV;EAAO,QAAQ,MAAM;EAAQ,OAAO;;;;;;;;;iBAS1B,eAAe,QAAQ,SAAS,QAAQ"}