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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (59) hide show
  1. package/build/EntityDbMetadata.cjs +43 -13
  2. package/build/EntityDbMetadata.cjs.map +1 -1
  3. package/build/EntityDbMetadata.d.cts +4 -2
  4. package/build/EntityDbMetadata.d.cts.map +1 -1
  5. package/build/EntityDbMetadata.d.mts +4 -2
  6. package/build/EntityDbMetadata.d.mts.map +1 -1
  7. package/build/EntityDbMetadata.js +41 -11
  8. package/build/EntityDbMetadata.js.map +1 -1
  9. package/build/generateEntitiesFile.cjs +0 -1
  10. package/build/generateEntitiesFile.cjs.map +1 -1
  11. package/build/generateEntitiesFile.d.cts +1 -1
  12. package/build/generateEntitiesFile.d.mts +1 -1
  13. package/build/generateEntitiesFile.js +0 -1
  14. package/build/generateEntitiesFile.js.map +1 -1
  15. package/build/generateEntityCodegenFile.cjs +1 -0
  16. package/build/generateEntityCodegenFile.cjs.map +1 -1
  17. package/build/generateEntityCodegenFile.d.cts.map +1 -1
  18. package/build/generateEntityCodegenFile.d.mts.map +1 -1
  19. package/build/generateEntityCodegenFile.js +1 -0
  20. package/build/generateEntityCodegenFile.js.map +1 -1
  21. package/build/generateMetadataFile.cjs +23 -17
  22. package/build/generateMetadataFile.cjs.map +1 -1
  23. package/build/generateMetadataFile.d.cts.map +1 -1
  24. package/build/generateMetadataFile.d.mts.map +1 -1
  25. package/build/generateMetadataFile.js +23 -17
  26. package/build/generateMetadataFile.js.map +1 -1
  27. package/build/index.cjs +5 -5
  28. package/build/index.cjs.map +1 -1
  29. package/build/index.d.cts.map +1 -1
  30. package/build/index.d.mts.map +1 -1
  31. package/build/index.js +6 -5
  32. package/build/index.js.map +1 -1
  33. package/build/inheritance.cjs +1 -0
  34. package/build/inheritance.cjs.map +1 -1
  35. package/build/inheritance.d.cts.map +1 -1
  36. package/build/inheritance.d.mts.map +1 -1
  37. package/build/inheritance.js +1 -0
  38. package/build/inheritance.js.map +1 -1
  39. package/build/loadMetadata.cjs +3 -3
  40. package/build/loadMetadata.cjs.map +1 -1
  41. package/build/loadMetadata.d.cts +1 -1
  42. package/build/loadMetadata.d.mts +1 -1
  43. package/build/loadMetadata.js +2 -2
  44. package/build/loadMetadata.js.map +1 -1
  45. package/build/pgMetadata.cjs +301 -0
  46. package/build/pgMetadata.cjs.map +1 -0
  47. package/build/pgMetadata.d.cts +122 -0
  48. package/build/pgMetadata.d.cts.map +1 -0
  49. package/build/pgMetadata.d.mts +122 -0
  50. package/build/pgMetadata.d.mts.map +1 -0
  51. package/build/pgMetadata.js +291 -0
  52. package/build/pgMetadata.js.map +1 -0
  53. package/build/utils.cjs +0 -1
  54. package/build/utils.cjs.map +1 -1
  55. package/build/utils.d.cts +1 -1
  56. package/build/utils.d.mts +1 -1
  57. package/build/utils.js +0 -1
  58. package/build/utils.js.map +1 -1
  59. package/package.json +12 -3
@@ -0,0 +1,301 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ //#region src/pgMetadata.ts
3
+ /** The small part of PostgreSQL's catalog model used by Joist codegen. */
4
+ var Items = class extends Array {
5
+ byName;
6
+ /** Looks up a column by name without scanning the table on every call. */
7
+ get(name) {
8
+ this.byName ??= new Map(this.map((item) => [item.name, item]));
9
+ const item = this.byName.get(name);
10
+ if (!item) throw new Error(`No item named ${name}`);
11
+ return item;
12
+ }
13
+ /** Keep the name index current if more catalog rows arrive after a lookup. */
14
+ push(...items) {
15
+ const length = super.push(...items);
16
+ if (this.byName) for (const item of items) this.byName.set(item.name, item);
17
+ return length;
18
+ }
19
+ };
20
+ var EnumType = class {
21
+ name;
22
+ values;
23
+ shortName;
24
+ constructor(name, values) {
25
+ this.name = name;
26
+ this.values = values;
27
+ }
28
+ };
29
+ var Column = class {
30
+ name;
31
+ type;
32
+ notNull;
33
+ defaultValue;
34
+ isGenerated;
35
+ arrayDimension;
36
+ comment;
37
+ foreignKeys = [];
38
+ uniqueIndexes = [];
39
+ isPrimaryKey = false;
40
+ constructor(name, type, notNull, defaultValue, isGenerated, arrayDimension, comment) {
41
+ this.name = name;
42
+ this.type = type;
43
+ this.notNull = notNull;
44
+ this.defaultValue = defaultValue;
45
+ this.isGenerated = isGenerated;
46
+ this.arrayDimension = arrayDimension;
47
+ this.comment = comment;
48
+ }
49
+ get isForeignKey() {
50
+ return this.foreignKeys.length > 0;
51
+ }
52
+ get default() {
53
+ return this.defaultValue?.replace(/^('.*?')::.+$/, "$1") ?? null;
54
+ }
55
+ get commentData() {
56
+ const data = this.comment?.match(/\[pg-structure\]([\s\S]*?)\[\/pg-structure\]/)?.[1];
57
+ return data ? JSON.parse(data) : void 0;
58
+ }
59
+ };
60
+ var Index = class {
61
+ name;
62
+ columns;
63
+ isUnique;
64
+ isPartial;
65
+ constructor(name, columns, isUnique, isPartial) {
66
+ this.name = name;
67
+ this.columns = columns;
68
+ this.isUnique = isUnique;
69
+ this.isPartial = isPartial;
70
+ }
71
+ };
72
+ var ForeignKey = class {
73
+ name;
74
+ table;
75
+ referencedTable;
76
+ columns;
77
+ isDeferred;
78
+ isDeferrable;
79
+ onDelete;
80
+ constructor(name, table, referencedTable, columns, isDeferred, isDeferrable, onDelete) {
81
+ this.name = name;
82
+ this.table = table;
83
+ this.referencedTable = referencedTable;
84
+ this.columns = columns;
85
+ this.isDeferred = isDeferred;
86
+ this.isDeferrable = isDeferrable;
87
+ this.onDelete = onDelete;
88
+ }
89
+ };
90
+ var M2ORelation = class {
91
+ foreignKey;
92
+ type = "m2o";
93
+ constructor(foreignKey) {
94
+ this.foreignKey = foreignKey;
95
+ }
96
+ get sourceTable() {
97
+ return this.foreignKey.table;
98
+ }
99
+ get targetTable() {
100
+ return this.foreignKey.referencedTable;
101
+ }
102
+ };
103
+ var O2MRelation = class {
104
+ foreignKey;
105
+ type = "o2m";
106
+ constructor(foreignKey) {
107
+ this.foreignKey = foreignKey;
108
+ }
109
+ get sourceTable() {
110
+ return this.foreignKey.referencedTable;
111
+ }
112
+ get targetTable() {
113
+ return this.foreignKey.table;
114
+ }
115
+ };
116
+ var M2MRelation = class {
117
+ foreignKey;
118
+ targetForeignKey;
119
+ type = "m2m";
120
+ constructor(foreignKey, targetForeignKey) {
121
+ this.foreignKey = foreignKey;
122
+ this.targetForeignKey = targetForeignKey;
123
+ }
124
+ get sourceTable() {
125
+ return this.foreignKey.referencedTable;
126
+ }
127
+ get targetTable() {
128
+ return this.targetForeignKey.referencedTable;
129
+ }
130
+ get joinTable() {
131
+ return this.foreignKey.table;
132
+ }
133
+ };
134
+ var Table = class {
135
+ name;
136
+ schema;
137
+ columns = new Items();
138
+ indexes = new Items();
139
+ foreignKeys = [];
140
+ foreignKeysToThis = [];
141
+ uniqueConstraints = [];
142
+ primaryKey;
143
+ constructor(name, schema) {
144
+ this.name = name;
145
+ this.schema = schema;
146
+ }
147
+ get m2oRelations() {
148
+ return this.foreignKeys.map((fk) => new M2ORelation(fk));
149
+ }
150
+ get o2mRelations() {
151
+ return this.foreignKeysToThis.map((fk) => new O2MRelation(fk));
152
+ }
153
+ get m2mRelations() {
154
+ return this.foreignKeysToThis.flatMap((fk) => fk.table.foreignKeys.filter((other) => other !== fk).map((other) => new M2MRelation(fk, other)));
155
+ }
156
+ };
157
+ /**
158
+ * Reads only the PostgreSQL catalog data used by codegen.
159
+ *
160
+ * Load tables and columns before constraints so each foreign key can link the same Table and Column
161
+ * objects used by entity fields. For example, books.author_id and authors.id are joined through
162
+ * the foreign key, while a trigger calling cyanaudit in another schema is irrelevant to codegen.
163
+ */
164
+ async function loadPgMetadata(client) {
165
+ const tables = new Items();
166
+ const byOid = /* @__PURE__ */ new Map();
167
+ const columns = /* @__PURE__ */ new Map();
168
+ const tableRows = await client.query(`
169
+ SELECT c.oid, c.relname AS name, n.nspname AS schema
170
+ FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
171
+ WHERE c.relkind IN ('r', 'p') AND n.nspname <> 'information_schema'
172
+ AND n.nspname NOT LIKE 'pg_%' AND NOT pg_is_other_temp_schema(n.oid)
173
+ ORDER BY n.nspname, c.relname
174
+ `);
175
+ for (const row of tableRows.rows) {
176
+ const table = new Table(row.name, { name: row.schema });
177
+ tables.push(table);
178
+ byOid.set(row.oid, table);
179
+ columns.set(row.oid, /* @__PURE__ */ new Map());
180
+ }
181
+ const enumRows = await client.query(`
182
+ SELECT t.oid, t.typname AS name, e.enumlabel AS value
183
+ FROM pg_type t JOIN pg_enum e ON e.enumtypid = t.oid
184
+ JOIN pg_namespace n ON n.oid = t.typnamespace
185
+ WHERE n.nspname <> 'information_schema' AND n.nspname NOT LIKE 'pg_%'
186
+ ORDER BY t.oid, e.enumsortorder
187
+ `);
188
+ const enums = /* @__PURE__ */ new Map();
189
+ for (const row of enumRows.rows) {
190
+ if (!enums.has(row.oid)) enums.set(row.oid, new EnumType(row.name, []));
191
+ enums.get(row.oid).values.push(row.value);
192
+ }
193
+ const columnRows = await client.query(`
194
+ SELECT a.attrelid AS "tableOid", a.attnum AS position, a.attname AS name,
195
+ COALESCE(NULLIF(t.typelem, 0), t.oid) AS "typeOid",
196
+ base.typname AS "typeName", a.attnotnull AS "notNull",
197
+ pg_get_expr(d.adbin, d.adrelid) AS "defaultValue", a.attgenerated AS generated,
198
+ a.attndims AS "arrayDimension", col_description(a.attrelid, a.attnum) AS comment
199
+ FROM pg_attribute a JOIN pg_type t ON t.oid = a.atttypid
200
+ JOIN pg_type base ON base.oid = COALESCE(NULLIF(t.typelem, 0), t.oid)
201
+ LEFT JOIN pg_attrdef d ON d.adrelid = a.attrelid AND d.adnum = a.attnum
202
+ WHERE a.attrelid = ANY($1::oid[]) AND a.attnum > 0 AND NOT a.attisdropped
203
+ ORDER BY a.attrelid, a.attnum
204
+ `, [Array.from(byOid.keys())]);
205
+ for (const row of columnRows.rows) {
206
+ const type = enums.get(row.typeOid) ?? sqlType(row.typeName);
207
+ const column = new Column(row.name, type, row.notNull, row.defaultValue, row.generated !== "", row.arrayDimension, row.comment);
208
+ byOid.get(row.tableOid).columns.push(column);
209
+ columns.get(row.tableOid).set(row.position, column);
210
+ }
211
+ const indexRows = await client.query(`
212
+ SELECT i.indrelid AS "tableOid", i.indexrelid AS "indexOid", c.relname AS name,
213
+ i.indkey::int2[] AS positions, i.indisunique AS unique, i.indpred IS NOT NULL AS partial
214
+ FROM pg_index i JOIN pg_class c ON c.oid = i.indexrelid
215
+ WHERE i.indrelid = ANY($1::oid[])
216
+ `, [Array.from(byOid.keys())]);
217
+ const indexes = /* @__PURE__ */ new Map();
218
+ for (const row of indexRows.rows) {
219
+ const table = byOid.get(row.tableOid);
220
+ const index = new Index(row.name, row.positions.flatMap((pos) => columns.get(row.tableOid).get(pos) ?? []), row.unique, row.partial);
221
+ table.indexes.push(index);
222
+ indexes.set(row.indexOid, index);
223
+ if (row.unique) for (const column of index.columns) column.uniqueIndexes.push(index);
224
+ }
225
+ const constraintRows = await client.query(`
226
+ SELECT conrelid AS "tableOid", confrelid AS "targetOid", conindid AS "indexOid",
227
+ conname AS name, contype AS kind, conkey AS positions,
228
+ condeferred AS deferred, condeferrable AS deferrable, confdeltype AS "onDelete"
229
+ FROM pg_constraint WHERE conrelid = ANY($1::oid[]) AND contype IN ('p', 'u', 'f')
230
+ ORDER BY conrelid, conname
231
+ `, [Array.from(byOid.keys())]);
232
+ for (const row of constraintRows.rows) {
233
+ const table = byOid.get(row.tableOid);
234
+ const keys = (row.positions ?? []).map((pos) => columns.get(row.tableOid).get(pos));
235
+ if (row.kind === "p") {
236
+ table.primaryKey = { columns: keys };
237
+ for (const column of keys) column.isPrimaryKey = true;
238
+ } else if (row.kind === "u") table.uniqueConstraints.push({
239
+ columns: keys,
240
+ index: indexes.get(row.indexOid)
241
+ });
242
+ else {
243
+ const target = byOid.get(row.targetOid);
244
+ if (!target) continue;
245
+ const fk = new ForeignKey(row.name, table, target, keys, row.deferred, row.deferrable, deleteAction(row.onDelete));
246
+ table.foreignKeys.push(fk);
247
+ target.foreignKeysToThis.push(fk);
248
+ for (const column of keys) column.foreignKeys.push(fk);
249
+ }
250
+ }
251
+ return {
252
+ tables,
253
+ types: Array.from(enums.values())
254
+ };
255
+ }
256
+ /** Matches the type names codegen expects from PostgreSQL's builtin aliases. */
257
+ function sqlType(name) {
258
+ switch (name) {
259
+ case "int2": return { name: "smallint" };
260
+ case "int4": return {
261
+ name: "integer",
262
+ shortName: "int"
263
+ };
264
+ case "int8": return { name: "bigint" };
265
+ case "bool": return { name: "boolean" };
266
+ case "float4": return { name: "real" };
267
+ case "float8": return { name: "double precision" };
268
+ case "varchar": return { name: "character varying" };
269
+ case "timestamptz": return { name: "timestamp with time zone" };
270
+ case "timestamp": return { name: "timestamp without time zone" };
271
+ case "time": return { name: "time without time zone" };
272
+ default: return {
273
+ name,
274
+ shortName: name
275
+ };
276
+ }
277
+ }
278
+ /** Decodes the pg_constraint foreign-key delete action. */
279
+ function deleteAction(code) {
280
+ switch (code) {
281
+ case "a": return "NO ACTION";
282
+ case "r": return "RESTRICT";
283
+ case "c": return "CASCADE";
284
+ case "n": return "SET NULL";
285
+ case "d": return "SET DEFAULT";
286
+ default: throw new Error(`Unknown PostgreSQL delete action: ${code}`);
287
+ }
288
+ }
289
+ //#endregion
290
+ exports.Column = Column;
291
+ exports.EnumType = EnumType;
292
+ exports.ForeignKey = ForeignKey;
293
+ exports.Index = Index;
294
+ exports.Items = Items;
295
+ exports.M2MRelation = M2MRelation;
296
+ exports.M2ORelation = M2ORelation;
297
+ exports.O2MRelation = O2MRelation;
298
+ exports.Table = Table;
299
+ exports.loadPgMetadata = loadPgMetadata;
300
+
301
+ //# sourceMappingURL=pgMetadata.cjs.map
@@ -0,0 +1 @@
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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"}
@@ -0,0 +1,122 @@
1
+ import { Client } from "pg";
2
+ //#region src/pgMetadata.d.ts
3
+ /** The small part of PostgreSQL's catalog model used by Joist codegen. */
4
+ declare class Items<T extends {
5
+ name: string;
6
+ }> extends Array<T> {
7
+ private byName?;
8
+ /** Looks up a column by name without scanning the table on every call. */
9
+ get(name: string): T;
10
+ /** Keep the name index current if more catalog rows arrive after a lookup. */
11
+ push(...items: T[]): number;
12
+ }
13
+ type Action = "NO ACTION" | "RESTRICT" | "CASCADE" | "SET NULL" | "SET DEFAULT";
14
+ type JSONData = string | number | boolean | null | JSONData[] | {
15
+ [key: string]: JSONData;
16
+ };
17
+ declare class EnumType {
18
+ name: string;
19
+ values: string[];
20
+ readonly shortName?: string;
21
+ constructor(name: string, values: string[]);
22
+ }
23
+ declare class Column {
24
+ name: string;
25
+ type: {
26
+ name: string;
27
+ shortName?: string;
28
+ } | EnumType;
29
+ notNull: boolean;
30
+ defaultValue: string | null;
31
+ isGenerated: boolean;
32
+ arrayDimension: number;
33
+ comment: string | null;
34
+ readonly foreignKeys: ForeignKey[];
35
+ readonly uniqueIndexes: Index[];
36
+ isPrimaryKey: boolean;
37
+ constructor(name: string, type: {
38
+ name: string;
39
+ shortName?: string;
40
+ } | EnumType, notNull: boolean, defaultValue: string | null, isGenerated: boolean, arrayDimension: number, comment: string | null);
41
+ get isForeignKey(): boolean;
42
+ get default(): string | null;
43
+ get commentData(): JSONData | undefined;
44
+ }
45
+ declare class Index {
46
+ name: string;
47
+ columns: Column[];
48
+ isUnique: boolean;
49
+ isPartial: boolean;
50
+ constructor(name: string, columns: Column[], isUnique: boolean, isPartial: boolean);
51
+ }
52
+ declare class ForeignKey {
53
+ name: string;
54
+ table: Table;
55
+ referencedTable: Table;
56
+ columns: Column[];
57
+ isDeferred: boolean;
58
+ isDeferrable: boolean;
59
+ onDelete: Action;
60
+ constructor(name: string, table: Table, referencedTable: Table, columns: Column[], isDeferred: boolean, isDeferrable: boolean, onDelete: Action);
61
+ }
62
+ declare class M2ORelation {
63
+ foreignKey: ForeignKey;
64
+ readonly type = "m2o";
65
+ constructor(foreignKey: ForeignKey);
66
+ get sourceTable(): Table;
67
+ get targetTable(): Table;
68
+ }
69
+ declare class O2MRelation {
70
+ foreignKey: ForeignKey;
71
+ readonly type = "o2m";
72
+ constructor(foreignKey: ForeignKey);
73
+ get sourceTable(): Table;
74
+ get targetTable(): Table;
75
+ }
76
+ declare class M2MRelation {
77
+ foreignKey: ForeignKey;
78
+ targetForeignKey: ForeignKey;
79
+ readonly type = "m2m";
80
+ constructor(foreignKey: ForeignKey, targetForeignKey: ForeignKey);
81
+ get sourceTable(): Table;
82
+ get targetTable(): Table;
83
+ get joinTable(): Table;
84
+ }
85
+ declare class Table {
86
+ name: string;
87
+ schema: {
88
+ name: string;
89
+ };
90
+ readonly columns: Items<Column>;
91
+ readonly indexes: Items<Index>;
92
+ readonly foreignKeys: ForeignKey[];
93
+ readonly foreignKeysToThis: ForeignKey[];
94
+ readonly uniqueConstraints: {
95
+ columns: Column[];
96
+ index: Index;
97
+ }[];
98
+ primaryKey?: {
99
+ columns: Column[];
100
+ };
101
+ constructor(name: string, schema: {
102
+ name: string;
103
+ });
104
+ get m2oRelations(): M2ORelation[];
105
+ get o2mRelations(): O2MRelation[];
106
+ get m2mRelations(): M2MRelation[];
107
+ }
108
+ type Db = {
109
+ tables: Items<Table>;
110
+ types: EnumType[];
111
+ };
112
+ /**
113
+ * Reads only the PostgreSQL catalog data used by codegen.
114
+ *
115
+ * Load tables and columns before constraints so each foreign key can link the same Table and Column
116
+ * objects used by entity fields. For example, books.author_id and authors.id are joined through
117
+ * the foreign key, while a trigger calling cyanaudit in another schema is irrelevant to codegen.
118
+ */
119
+ declare function loadPgMetadata(client: Client): Promise<Db>;
120
+ //#endregion
121
+ export { Action, Column, Db, EnumType, ForeignKey, Index, Items, JSONData, M2MRelation, M2ORelation, O2MRelation, Table, loadPgMetadata };
122
+ //# sourceMappingURL=pgMetadata.d.cts.map
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,122 @@
1
+ import { Client } from "pg";
2
+ //#region src/pgMetadata.d.ts
3
+ /** The small part of PostgreSQL's catalog model used by Joist codegen. */
4
+ declare class Items<T extends {
5
+ name: string;
6
+ }> extends Array<T> {
7
+ private byName?;
8
+ /** Looks up a column by name without scanning the table on every call. */
9
+ get(name: string): T;
10
+ /** Keep the name index current if more catalog rows arrive after a lookup. */
11
+ push(...items: T[]): number;
12
+ }
13
+ type Action = "NO ACTION" | "RESTRICT" | "CASCADE" | "SET NULL" | "SET DEFAULT";
14
+ type JSONData = string | number | boolean | null | JSONData[] | {
15
+ [key: string]: JSONData;
16
+ };
17
+ declare class EnumType {
18
+ name: string;
19
+ values: string[];
20
+ readonly shortName?: string;
21
+ constructor(name: string, values: string[]);
22
+ }
23
+ declare class Column {
24
+ name: string;
25
+ type: {
26
+ name: string;
27
+ shortName?: string;
28
+ } | EnumType;
29
+ notNull: boolean;
30
+ defaultValue: string | null;
31
+ isGenerated: boolean;
32
+ arrayDimension: number;
33
+ comment: string | null;
34
+ readonly foreignKeys: ForeignKey[];
35
+ readonly uniqueIndexes: Index[];
36
+ isPrimaryKey: boolean;
37
+ constructor(name: string, type: {
38
+ name: string;
39
+ shortName?: string;
40
+ } | EnumType, notNull: boolean, defaultValue: string | null, isGenerated: boolean, arrayDimension: number, comment: string | null);
41
+ get isForeignKey(): boolean;
42
+ get default(): string | null;
43
+ get commentData(): JSONData | undefined;
44
+ }
45
+ declare class Index {
46
+ name: string;
47
+ columns: Column[];
48
+ isUnique: boolean;
49
+ isPartial: boolean;
50
+ constructor(name: string, columns: Column[], isUnique: boolean, isPartial: boolean);
51
+ }
52
+ declare class ForeignKey {
53
+ name: string;
54
+ table: Table;
55
+ referencedTable: Table;
56
+ columns: Column[];
57
+ isDeferred: boolean;
58
+ isDeferrable: boolean;
59
+ onDelete: Action;
60
+ constructor(name: string, table: Table, referencedTable: Table, columns: Column[], isDeferred: boolean, isDeferrable: boolean, onDelete: Action);
61
+ }
62
+ declare class M2ORelation {
63
+ foreignKey: ForeignKey;
64
+ readonly type = "m2o";
65
+ constructor(foreignKey: ForeignKey);
66
+ get sourceTable(): Table;
67
+ get targetTable(): Table;
68
+ }
69
+ declare class O2MRelation {
70
+ foreignKey: ForeignKey;
71
+ readonly type = "o2m";
72
+ constructor(foreignKey: ForeignKey);
73
+ get sourceTable(): Table;
74
+ get targetTable(): Table;
75
+ }
76
+ declare class M2MRelation {
77
+ foreignKey: ForeignKey;
78
+ targetForeignKey: ForeignKey;
79
+ readonly type = "m2m";
80
+ constructor(foreignKey: ForeignKey, targetForeignKey: ForeignKey);
81
+ get sourceTable(): Table;
82
+ get targetTable(): Table;
83
+ get joinTable(): Table;
84
+ }
85
+ declare class Table {
86
+ name: string;
87
+ schema: {
88
+ name: string;
89
+ };
90
+ readonly columns: Items<Column>;
91
+ readonly indexes: Items<Index>;
92
+ readonly foreignKeys: ForeignKey[];
93
+ readonly foreignKeysToThis: ForeignKey[];
94
+ readonly uniqueConstraints: {
95
+ columns: Column[];
96
+ index: Index;
97
+ }[];
98
+ primaryKey?: {
99
+ columns: Column[];
100
+ };
101
+ constructor(name: string, schema: {
102
+ name: string;
103
+ });
104
+ get m2oRelations(): M2ORelation[];
105
+ get o2mRelations(): O2MRelation[];
106
+ get m2mRelations(): M2MRelation[];
107
+ }
108
+ type Db = {
109
+ tables: Items<Table>;
110
+ types: EnumType[];
111
+ };
112
+ /**
113
+ * Reads only the PostgreSQL catalog data used by codegen.
114
+ *
115
+ * Load tables and columns before constraints so each foreign key can link the same Table and Column
116
+ * objects used by entity fields. For example, books.author_id and authors.id are joined through
117
+ * the foreign key, while a trigger calling cyanaudit in another schema is irrelevant to codegen.
118
+ */
119
+ declare function loadPgMetadata(client: Client): Promise<Db>;
120
+ //#endregion
121
+ export { Action, Column, Db, EnumType, ForeignKey, Index, Items, JSONData, M2MRelation, M2ORelation, O2MRelation, Table, loadPgMetadata };
122
+ //# sourceMappingURL=pgMetadata.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pgMetadata.d.mts","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"}