metal-orm 1.1.10 → 1.1.16

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 (192) hide show
  1. package/README.md +758 -769
  2. package/dist/index.cjs +106 -43
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.d.cts +5 -5
  5. package/dist/index.d.ts +5 -5
  6. package/dist/index.js +106 -43
  7. package/dist/index.js.map +1 -1
  8. package/package.json +100 -96
  9. package/scripts/generate-entities/render.mjs +21 -12
  10. package/scripts/generate-entities/schema.mjs +209 -195
  11. package/scripts/generate-entities/tree-detection.mjs +159 -153
  12. package/scripts/inflection/pt-br.mjs +468 -468
  13. package/scripts/run-eslint.mjs +33 -34
  14. package/scripts/show-sql-seed.sql +102 -0
  15. package/scripts/show-sql.mjs +321 -325
  16. package/src/bulk/bulk-delete-executor.ts +3 -5
  17. package/src/bulk/bulk-insert-executor.ts +7 -7
  18. package/src/bulk/bulk-update-executor.ts +2 -2
  19. package/src/bulk/bulk-upsert-executor.ts +5 -7
  20. package/src/codegen/naming-strategy.ts +54 -54
  21. package/src/codegen/typescript.ts +482 -482
  22. package/src/core/ast/adapters.ts +1 -1
  23. package/src/core/ast/builders.ts +123 -123
  24. package/src/core/ast/expression-builders.ts +745 -745
  25. package/src/core/ast/expression-nodes.ts +304 -304
  26. package/src/core/ast/expression-visitor.ts +212 -212
  27. package/src/core/ast/expression.ts +20 -20
  28. package/src/core/ast/helpers.ts +14 -14
  29. package/src/core/ast/join.ts +18 -18
  30. package/src/core/ast/query.ts +200 -200
  31. package/src/core/ddl/dialects/base-schema-dialect.ts +1 -1
  32. package/src/core/ddl/dialects/mssql-schema-dialect.ts +1 -1
  33. package/src/core/ddl/dialects/mysql-schema-dialect.ts +1 -1
  34. package/src/core/ddl/dialects/postgres-schema-dialect.ts +1 -1
  35. package/src/core/ddl/dialects/render-reference.test.ts +70 -70
  36. package/src/core/ddl/dialects/sqlite-schema-dialect.ts +1 -1
  37. package/src/core/ddl/introspect/catalogs/index.ts +5 -5
  38. package/src/core/ddl/introspect/catalogs/postgres.ts +146 -146
  39. package/src/core/ddl/introspect/context.ts +15 -15
  40. package/src/core/ddl/introspect/functions/postgres.ts +35 -35
  41. package/src/core/ddl/introspect/mysql.ts +113 -36
  42. package/src/core/ddl/introspect/registry.ts +40 -40
  43. package/src/core/ddl/introspect/run-select.ts +35 -35
  44. package/src/core/ddl/introspect/utils.ts +56 -56
  45. package/src/core/ddl/naming-strategy.ts +16 -16
  46. package/src/core/ddl/schema-dialect.ts +56 -56
  47. package/src/core/ddl/schema-diff.ts +234 -234
  48. package/src/core/ddl/schema-generator.ts +1 -1
  49. package/src/core/ddl/schema-introspect.ts +25 -25
  50. package/src/core/ddl/sql-writing.ts +171 -171
  51. package/src/core/dialect/abstract.ts +541 -541
  52. package/src/core/dialect/base/cte-compiler.ts +33 -33
  53. package/src/core/dialect/base/function-table-formatter.ts +103 -103
  54. package/src/core/dialect/base/groupby-compiler.ts +21 -21
  55. package/src/core/dialect/base/join-compiler.ts +25 -25
  56. package/src/core/dialect/base/orderby-compiler.ts +35 -35
  57. package/src/core/dialect/base/pagination-strategy.ts +32 -32
  58. package/src/core/dialect/base/returning-strategy.ts +57 -57
  59. package/src/core/dialect/base/sql-dialect.ts +294 -294
  60. package/src/core/dialect/dialect-factory.ts +91 -91
  61. package/src/core/dialect/mssql/functions.ts +120 -120
  62. package/src/core/dialect/mssql/index.ts +317 -317
  63. package/src/core/dialect/mysql/functions.ts +103 -103
  64. package/src/core/dialect/mysql/index.ts +105 -105
  65. package/src/core/dialect/postgres/functions.ts +108 -108
  66. package/src/core/dialect/postgres/index.ts +91 -91
  67. package/src/core/dialect/sqlite/functions.ts +129 -129
  68. package/src/core/dialect/sqlite/index.ts +67 -67
  69. package/src/core/driver/database-driver.ts +19 -19
  70. package/src/core/driver/mssql-driver.ts +23 -23
  71. package/src/core/driver/mysql-driver.ts +23 -23
  72. package/src/core/driver/postgres-driver.ts +23 -23
  73. package/src/core/driver/sqlite-driver.ts +23 -23
  74. package/src/core/execution/db-executor.ts +92 -92
  75. package/src/core/execution/executors/better-sqlite3-executor.ts +94 -94
  76. package/src/core/execution/executors/mssql-executor.ts +184 -184
  77. package/src/core/execution/executors/mysql-executor.ts +88 -88
  78. package/src/core/execution/executors/postgres-executor.ts +26 -26
  79. package/src/core/execution/executors/sqlite-executor.ts +42 -42
  80. package/src/core/execution/pooling/pool-types.ts +30 -30
  81. package/src/core/execution/pooling/pool.ts +275 -275
  82. package/src/core/functions/array.ts +35 -35
  83. package/src/core/functions/control-flow.ts +79 -79
  84. package/src/core/functions/datetime.ts +237 -237
  85. package/src/core/functions/json.ts +70 -70
  86. package/src/core/functions/numeric.ts +297 -297
  87. package/src/core/functions/text.ts +334 -334
  88. package/src/core/functions/types.ts +33 -33
  89. package/src/core/hydration/types.ts +51 -51
  90. package/src/core/sql/sql-operator-config.ts +39 -39
  91. package/src/core/sql/sql.ts +152 -152
  92. package/src/decorators/column-decorator.ts +87 -87
  93. package/src/decorators/decorator-metadata.ts +143 -143
  94. package/src/decorators/entity.ts +93 -93
  95. package/src/decorators/index.ts +39 -39
  96. package/src/decorators/relations.ts +231 -231
  97. package/src/decorators/transformers/built-in/string-transformers.ts +231 -231
  98. package/src/decorators/transformers/transformer-decorators.ts +134 -134
  99. package/src/decorators/transformers/transformer-executor.ts +171 -171
  100. package/src/decorators/transformers/transformer-metadata.ts +73 -73
  101. package/src/decorators/validators/built-in/br-cep-validator.ts +55 -55
  102. package/src/decorators/validators/built-in/br-cnpj-validator.ts +105 -105
  103. package/src/decorators/validators/built-in/br-cpf-validator.ts +103 -103
  104. package/src/decorators/validators/country-validator-registry.ts +64 -64
  105. package/src/decorators/validators/country-validators-decorators.ts +203 -203
  106. package/src/decorators/validators/country-validators.ts +105 -105
  107. package/src/decorators/validators/validator-metadata.ts +59 -59
  108. package/src/dto/dto-types.ts +226 -226
  109. package/src/dto/filter-types.ts +141 -141
  110. package/src/dto/index.ts +95 -95
  111. package/src/dto/openapi/generators/base.ts +29 -29
  112. package/src/dto/openapi/generators/column.ts +37 -37
  113. package/src/dto/openapi/generators/dto.ts +91 -91
  114. package/src/dto/openapi/generators/filter.ts +75 -75
  115. package/src/dto/openapi/generators/nested-dto.ts +618 -618
  116. package/src/dto/openapi/generators/pagination.ts +111 -111
  117. package/src/dto/openapi/generators/relation-filter.ts +228 -228
  118. package/src/dto/openapi/index.ts +12 -12
  119. package/src/dto/openapi/types.ts +101 -101
  120. package/src/dto/openapi/utilities.ts +95 -95
  121. package/src/dto/pagination-utils.ts +150 -150
  122. package/src/dto/transform.ts +197 -197
  123. package/src/index.ts +86 -86
  124. package/src/orm/als.ts +58 -58
  125. package/src/orm/domain-event-bus.ts +119 -119
  126. package/src/orm/entity-context.ts +86 -86
  127. package/src/orm/entity-materializer.ts +159 -159
  128. package/src/orm/entity-meta.ts +97 -97
  129. package/src/orm/entity-registry.ts +39 -39
  130. package/src/orm/entity-relation-cache.ts +39 -39
  131. package/src/orm/execute.ts +194 -194
  132. package/src/orm/execution-context.ts +18 -18
  133. package/src/orm/hydration-context.ts +26 -26
  134. package/src/orm/hydration.ts +112 -112
  135. package/src/orm/identity-map.ts +61 -61
  136. package/src/orm/interceptor-pipeline.ts +16 -16
  137. package/src/orm/lazy-batch/belongs-to-many.ts +119 -119
  138. package/src/orm/lazy-batch/belongs-to.ts +108 -108
  139. package/src/orm/lazy-batch/has-many.ts +69 -69
  140. package/src/orm/lazy-batch/has-one.ts +68 -68
  141. package/src/orm/lazy-batch/shared.ts +125 -125
  142. package/src/orm/orm-session.ts +620 -620
  143. package/src/orm/orm.ts +34 -34
  144. package/src/orm/pooled-executor-factory.ts +121 -121
  145. package/src/orm/query-logger.ts +40 -40
  146. package/src/orm/relation-change-processor.ts +420 -420
  147. package/src/orm/relations/belongs-to.ts +143 -143
  148. package/src/orm/relations/has-many.ts +204 -204
  149. package/src/orm/relations/has-one.ts +174 -174
  150. package/src/orm/relations/many-to-many.ts +288 -288
  151. package/src/orm/relations/morph-many.ts +156 -156
  152. package/src/orm/relations/morph-one.ts +151 -151
  153. package/src/orm/relations/morph-to.ts +162 -162
  154. package/src/orm/runtime-types.ts +92 -92
  155. package/src/orm/save-graph.ts +561 -561
  156. package/src/orm/transaction-runner.ts +24 -24
  157. package/src/orm/unit-of-work.ts +426 -426
  158. package/src/query/index.ts +69 -69
  159. package/src/query/target.ts +46 -46
  160. package/src/query-builder/column-selector.ts +81 -81
  161. package/src/query-builder/delete.ts +141 -141
  162. package/src/query-builder/insert-query-state.ts +149 -149
  163. package/src/query-builder/insert.ts +117 -117
  164. package/src/query-builder/query-ast-service.ts +287 -287
  165. package/src/query-builder/query-resolution.ts +78 -78
  166. package/src/query-builder/raw-column-parser.ts +38 -38
  167. package/src/query-builder/relation-filter-utils.ts +153 -153
  168. package/src/query-builder/relation-join-planner.ts +10 -10
  169. package/src/query-builder/relation-manager.ts +87 -87
  170. package/src/query-builder/relation-projection-helper.ts +102 -102
  171. package/src/query-builder/relation-types.ts +9 -9
  172. package/src/query-builder/relation-utils.ts +15 -15
  173. package/src/query-builder/select/cte-facet.ts +40 -40
  174. package/src/query-builder/select/from-facet.ts +80 -80
  175. package/src/query-builder/select/join-facet.ts +62 -62
  176. package/src/query-builder/select/predicate-facet.ts +104 -104
  177. package/src/query-builder/select/projection-facet.ts +70 -70
  178. package/src/query-builder/select/relation-facet.ts +81 -81
  179. package/src/query-builder/select/setop-facet.ts +36 -36
  180. package/src/query-builder/select-helpers.ts +1 -1
  181. package/src/query-builder/select-query-builder-deps.ts +130 -130
  182. package/src/query-builder/select-query-state.ts +207 -207
  183. package/src/query-builder/update.ts +151 -151
  184. package/src/schema/column-types.ts +322 -322
  185. package/src/schema/table-guards.ts +37 -37
  186. package/src/schema/table.ts +281 -281
  187. package/src/tree/index.ts +13 -13
  188. package/src/tree/nested-set-strategy.ts +545 -545
  189. package/src/tree/tree-decorator.ts +397 -397
  190. package/src/tree/tree-manager.ts +754 -754
  191. package/src/tree/tree-query.ts +427 -427
  192. package/src/tree/tree-types.ts +299 -299
@@ -1,52 +1,61 @@
1
- import { detectTreeTable, mapTreeTables } from './tree-detection.mjs';
2
-
3
- const normalizeName = name => (typeof name === 'string' && name.includes('.') ? name.split('.').pop() : name);
4
-
5
- export const mapRelations = (tables, naming) => {
6
- const relationMap = new Map();
7
- const relationKeys = new Map();
8
- const fkIndex = new Map();
9
- const uniqueSingleColumns = new Map();
10
-
11
- for (const table of tables) {
12
- relationMap.set(table.name, []);
13
- relationKeys.set(table.name, new Set());
14
- for (const col of table.columns) {
15
- if (col.references) {
16
- const list = fkIndex.get(table.name) || [];
17
- list.push(col);
18
- fkIndex.set(table.name, list);
19
- }
20
- }
21
-
22
- const uniqueCols = new Set();
23
- if (Array.isArray(table.primaryKey) && table.primaryKey.length === 1) {
24
- uniqueCols.add(table.primaryKey[0]);
25
- }
26
- for (const col of table.columns) {
27
- if (col.unique) uniqueCols.add(col.name);
28
- }
29
- for (const idx of table.indexes || []) {
30
- if (!idx?.unique) continue;
31
- if (!Array.isArray(idx.columns) || idx.columns.length !== 1 || !idx.columns[0]?.column) continue;
32
- const columnName = idx.columns[0].column;
33
- if (idx.where) {
34
- const predicate = String(idx.where);
35
- const isNotNullOnly = new RegExp(`\\b${columnName}\\b\\s+is\\s+not\\s+null\\b`, 'i').test(predicate);
36
- if (!isNotNullOnly) continue;
37
- }
38
- uniqueCols.add(columnName);
39
- }
40
- uniqueSingleColumns.set(table.name, uniqueCols);
41
- }
42
-
43
- const findTable = name => {
44
- const norm = normalizeName(name);
45
- return tables.find(t => t.name === name || t.name === norm);
46
- };
47
-
1
+ import { detectTreeTable, mapTreeTables } from './tree-detection.mjs';
2
+
3
+ const normalizeName = name => (typeof name === 'string' && name.includes('.') ? name.split('.').pop() : name);
4
+ const normalizeTableColumns = columns =>
5
+ (Array.isArray(columns) ? columns : []).filter(
6
+ col => col && typeof col.name === 'string' && col.name.trim().length > 0
7
+ );
8
+ const normalizeTables = tables => (Array.isArray(tables) ? tables : []);
9
+
10
+ export const mapRelations = (tables, naming) => {
11
+ const relationMap = new Map();
12
+ const relationKeys = new Map();
13
+ const fkIndex = new Map();
14
+ const uniqueSingleColumns = new Map();
15
+ const normalizedTables = normalizeTables(tables).filter(
16
+ table => table && typeof table.name === 'string' && table.name.trim().length > 0
17
+ );
18
+
19
+ for (const table of normalizedTables) {
20
+ const tableColumns = normalizeTableColumns(table.columns);
21
+ relationMap.set(table.name, []);
22
+ relationKeys.set(table.name, new Set());
23
+ for (const col of tableColumns) {
24
+ if (col.references) {
25
+ const list = fkIndex.get(table.name) || [];
26
+ list.push(col);
27
+ fkIndex.set(table.name, list);
28
+ }
29
+ }
30
+
31
+ const uniqueCols = new Set();
32
+ if (Array.isArray(table.primaryKey) && table.primaryKey.length === 1) {
33
+ uniqueCols.add(table.primaryKey[0]);
34
+ }
35
+ for (const col of tableColumns) {
36
+ if (col.unique) uniqueCols.add(col.name);
37
+ }
38
+ for (const idx of table.indexes || []) {
39
+ if (!idx?.unique) continue;
40
+ if (!Array.isArray(idx.columns) || idx.columns.length !== 1 || !idx.columns[0]?.column) continue;
41
+ const columnName = idx.columns[0].column;
42
+ if (idx.where) {
43
+ const predicate = String(idx.where);
44
+ const isNotNullOnly = new RegExp(`\\b${columnName}\\b\\s+is\\s+not\\s+null\\b`, 'i').test(predicate);
45
+ if (!isNotNullOnly) continue;
46
+ }
47
+ uniqueCols.add(columnName);
48
+ }
49
+ uniqueSingleColumns.set(table.name, uniqueCols);
50
+ }
51
+
52
+ const findTable = name => {
53
+ const norm = normalizeName(name);
54
+ return normalizedTables.find(t => t.name === name || t.name === norm);
55
+ };
56
+
48
57
  const pivotTables = new Set();
49
- for (const table of tables) {
58
+ for (const table of normalizedTables) {
50
59
  const fkCols = fkIndex.get(table.name) || [];
51
60
  const hasSelfReference = fkCols.some(c => normalizeName(c.references.table) === table.name);
52
61
  const distinctTargets = Array.from(new Set(fkCols.map(c => normalizeName(c.references.table))));
@@ -55,150 +64,155 @@ export const mapRelations = (tables, naming) => {
55
64
  pivotTables.add(table.name);
56
65
  const targetA = findTable(a.references.table);
57
66
  const targetB = findTable(b.references.table);
58
- if (targetA && targetB) {
59
- const aKey = relationKeys.get(targetA.name);
60
- const bKey = relationKeys.get(targetB.name);
61
- const aProp = naming.belongsToManyProperty(targetB.name);
62
- const bProp = naming.belongsToManyProperty(targetA.name);
63
- if (!aKey.has(aProp)) {
64
- aKey.add(aProp);
65
- relationMap.get(targetA.name)?.push({
66
- kind: 'belongsToMany',
67
- property: aProp,
68
- target: targetB.name,
69
- pivotTable: table.name,
70
- pivotForeignKeyToRoot: a.name,
71
- pivotForeignKeyToTarget: b.name
72
- });
73
- }
74
- if (!bKey.has(bProp)) {
75
- bKey.add(bProp);
76
- relationMap.get(targetB.name)?.push({
77
- kind: 'belongsToMany',
78
- property: bProp,
79
- target: targetA.name,
80
- pivotTable: table.name,
81
- pivotForeignKeyToRoot: b.name,
82
- pivotForeignKeyToTarget: a.name
83
- });
84
- }
85
- }
86
- }
87
- }
88
-
89
- for (const table of tables) {
90
- const fkCols = fkIndex.get(table.name) || [];
91
- for (const fk of fkCols) {
92
- const targetTable = fk.references.table;
93
- const targetKey = normalizeName(targetTable);
94
- const belongsKey = relationKeys.get(table.name);
95
- const hasManyKey = targetKey ? relationKeys.get(targetKey) : undefined;
96
-
97
- if (!belongsKey || !hasManyKey) continue;
98
-
99
- const belongsProp = naming.belongsToProperty(fk.name, targetTable);
100
- if (!belongsKey.has(belongsProp)) {
101
- belongsKey.add(belongsProp);
102
- relationMap.get(table.name)?.push({
103
- kind: 'belongsTo',
104
- property: belongsProp,
105
- target: targetTable,
106
- foreignKey: fk.name
107
- });
108
- }
109
-
110
- // Skip generating HasMany/HasOne relations TO pivot tables
111
- // (pivot data is accessible via _pivot on BelongsToMany)
112
- if (pivotTables.has(table.name)) continue;
113
-
114
- const uniqueCols = uniqueSingleColumns.get(table.name);
115
- const isHasOne = Boolean(uniqueCols?.has(fk.name));
116
- const relationKind = isHasOne ? 'hasOne' : 'hasMany';
117
- const inverseProp = isHasOne ? naming.hasOneProperty(table.name) : naming.hasManyProperty(table.name);
118
- if (!hasManyKey.has(inverseProp)) {
119
- hasManyKey.add(inverseProp);
120
- relationMap.get(targetKey)?.push({
121
- kind: relationKind,
122
- property: inverseProp,
123
- target: table.name,
124
- foreignKey: fk.name
125
- });
126
- }
127
- }
128
- }
129
-
130
- return relationMap;
131
- };
132
-
133
- export const buildSchemaMetadata = (schema, naming) => {
134
- const tables = schema.tables.map(t => {
135
- const indexes = Array.isArray(t.indexes) ? t.indexes.map(idx => ({ ...idx })) : [];
136
- const uniqueSingleColumns = new Set(
137
- indexes
138
- .filter(idx => idx?.unique && !idx?.where && Array.isArray(idx.columns) && idx.columns.length === 1)
139
- .map(idx => idx.columns[0]?.column)
140
- .filter(Boolean)
141
- );
142
-
143
- return {
144
- name: t.name,
145
- schema: t.schema,
146
- columns: (t.columns || []).map(col => {
147
- const unique = col.unique !== undefined ? col.unique : uniqueSingleColumns.has(col.name) ? true : undefined;
148
- return { ...col, unique };
149
- }),
150
- primaryKey: t.primaryKey || [],
151
- indexes,
152
- isView: false
153
- };
154
- });
155
-
156
- const views = (schema.views || []).map(v => ({
157
- name: v.name,
158
- schema: v.schema,
159
- columns: (v.columns || []).map(col => ({ ...col })),
160
- primaryKey: [],
161
- indexes: [],
162
- isView: true,
163
- definition: v.definition,
164
- comment: v.comment
165
- }));
166
-
167
- const allEntities = [...tables, ...views];
168
-
169
- const classNames = new Map();
170
- allEntities.forEach(t => {
171
- const className = naming.classNameFromTable(t.name);
172
- classNames.set(t.name, className);
173
- if (t.schema) {
174
- const qualified = `${t.schema}.${t.name}`;
175
- if (!classNames.has(qualified)) {
176
- classNames.set(qualified, className);
177
- }
178
- }
179
- });
180
-
181
- const resolveClassName = target => {
182
- if (!target) return undefined;
183
- if (classNames.has(target)) return classNames.get(target);
184
- const fallback = target.split('.').pop();
185
- if (fallback && classNames.has(fallback)) {
186
- return classNames.get(fallback);
187
- }
188
- return undefined;
189
- };
190
-
191
- const relations = mapRelations(tables, naming);
192
-
193
- // Detect tree tables
194
- const treeConfigs = mapTreeTables(tables, naming);
195
-
196
- return {
197
- tables,
198
- views,
199
- classNames,
200
- relations,
201
- resolveClassName,
202
- treeConfigs
203
- };
204
- };
67
+ if (targetA && targetB) {
68
+ const aKey = relationKeys.get(targetA.name);
69
+ const bKey = relationKeys.get(targetB.name);
70
+ const aProp = naming.belongsToManyProperty(targetB.name);
71
+ const bProp = naming.belongsToManyProperty(targetA.name);
72
+ if (!aKey.has(aProp)) {
73
+ aKey.add(aProp);
74
+ relationMap.get(targetA.name)?.push({
75
+ kind: 'belongsToMany',
76
+ property: aProp,
77
+ target: targetB.name,
78
+ pivotTable: table.name,
79
+ pivotForeignKeyToRoot: a.name,
80
+ pivotForeignKeyToTarget: b.name
81
+ });
82
+ }
83
+ if (!bKey.has(bProp)) {
84
+ bKey.add(bProp);
85
+ relationMap.get(targetB.name)?.push({
86
+ kind: 'belongsToMany',
87
+ property: bProp,
88
+ target: targetA.name,
89
+ pivotTable: table.name,
90
+ pivotForeignKeyToRoot: b.name,
91
+ pivotForeignKeyToTarget: a.name
92
+ });
93
+ }
94
+ }
95
+ }
96
+ }
97
+
98
+ for (const table of normalizedTables) {
99
+ const fkCols = fkIndex.get(table.name) || [];
100
+ for (const fk of fkCols) {
101
+ const targetTable = fk.references.table;
102
+ const targetKey = normalizeName(targetTable);
103
+ const belongsKey = relationKeys.get(table.name);
104
+ const hasManyKey = targetKey ? relationKeys.get(targetKey) : undefined;
105
+
106
+ if (!belongsKey || !hasManyKey) continue;
107
+
108
+ const belongsProp = naming.belongsToProperty(fk.name, targetTable);
109
+ if (!belongsKey.has(belongsProp)) {
110
+ belongsKey.add(belongsProp);
111
+ relationMap.get(table.name)?.push({
112
+ kind: 'belongsTo',
113
+ property: belongsProp,
114
+ target: targetTable,
115
+ foreignKey: fk.name
116
+ });
117
+ }
118
+
119
+ // Skip generating HasMany/HasOne relations TO pivot tables
120
+ // (pivot data is accessible via _pivot on BelongsToMany)
121
+ if (pivotTables.has(table.name)) continue;
122
+
123
+ const uniqueCols = uniqueSingleColumns.get(table.name);
124
+ const isHasOne = Boolean(uniqueCols?.has(fk.name));
125
+ const relationKind = isHasOne ? 'hasOne' : 'hasMany';
126
+ const inverseProp = isHasOne ? naming.hasOneProperty(table.name) : naming.hasManyProperty(table.name);
127
+ if (!hasManyKey.has(inverseProp)) {
128
+ hasManyKey.add(inverseProp);
129
+ relationMap.get(targetKey)?.push({
130
+ kind: relationKind,
131
+ property: inverseProp,
132
+ target: table.name,
133
+ foreignKey: fk.name
134
+ });
135
+ }
136
+ }
137
+ }
138
+
139
+ return relationMap;
140
+ };
141
+
142
+ export const buildSchemaMetadata = (schema, naming) => {
143
+ const tables = normalizeTables(schema?.tables)
144
+ .filter(t => t && typeof t.name === 'string' && t.name.trim().length > 0)
145
+ .map(t => {
146
+ const columns = normalizeTableColumns(t.columns).map(col => ({ ...col }));
147
+ const indexes = Array.isArray(t.indexes) ? t.indexes.map(idx => ({ ...idx })) : [];
148
+ const uniqueSingleColumns = new Set(
149
+ indexes
150
+ .filter(idx => idx?.unique && !idx?.where && Array.isArray(idx.columns) && idx.columns.length === 1)
151
+ .map(idx => idx.columns[0]?.column)
152
+ .filter(Boolean)
153
+ );
154
+
155
+ return {
156
+ name: t.name,
157
+ schema: t.schema,
158
+ columns: columns.map(col => {
159
+ const unique = col.unique !== undefined ? col.unique : uniqueSingleColumns.has(col.name) ? true : undefined;
160
+ return { ...col, unique };
161
+ }),
162
+ primaryKey: t.primaryKey || [],
163
+ indexes,
164
+ isView: false
165
+ };
166
+ });
167
+
168
+ const views = normalizeTables(schema?.views)
169
+ .filter(v => v && typeof v.name === 'string' && v.name.trim().length > 0)
170
+ .map(v => ({
171
+ name: v.name,
172
+ schema: v.schema,
173
+ columns: normalizeTableColumns(v.columns).map(col => ({ ...col })),
174
+ primaryKey: [],
175
+ indexes: [],
176
+ isView: true,
177
+ definition: v.definition,
178
+ comment: v.comment
179
+ }));
180
+
181
+ const allEntities = [...tables, ...views];
182
+
183
+ const classNames = new Map();
184
+ allEntities.forEach(t => {
185
+ const className = naming.classNameFromTable(t.name);
186
+ classNames.set(t.name, className);
187
+ if (t.schema) {
188
+ const qualified = `${t.schema}.${t.name}`;
189
+ if (!classNames.has(qualified)) {
190
+ classNames.set(qualified, className);
191
+ }
192
+ }
193
+ });
194
+
195
+ const resolveClassName = target => {
196
+ if (!target) return undefined;
197
+ if (classNames.has(target)) return classNames.get(target);
198
+ const fallback = target.split('.').pop();
199
+ if (fallback && classNames.has(fallback)) {
200
+ return classNames.get(fallback);
201
+ }
202
+ return undefined;
203
+ };
204
+
205
+ const relations = mapRelations(tables, naming);
206
+
207
+ // Detect tree tables
208
+ const treeConfigs = mapTreeTables(tables, naming);
209
+
210
+ return {
211
+ tables,
212
+ views,
213
+ classNames,
214
+ relations,
215
+ resolveClassName,
216
+ treeConfigs
217
+ };
218
+ };