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
package/package.json CHANGED
@@ -1,96 +1,100 @@
1
- {
2
- "name": "metal-orm",
3
- "version": "1.1.10",
4
- "type": "module",
5
- "types": "./dist/index.d.ts",
6
- "engines": {
7
- "node": ">=20.0.0"
8
- },
9
- "bin": {
10
- "metal-orm-gen": "./scripts/generate-entities.mjs"
11
- },
12
- "exports": {
13
- ".": {
14
- "types": "./dist/index.d.ts",
15
- "import": "./dist/index.js",
16
- "require": "./dist/index.cjs"
17
- }
18
- },
19
- "files": [
20
- "dist",
21
- "src",
22
- "global.d.ts",
23
- "scripts"
24
- ],
25
- "scripts": {
26
- "prepublishOnly": "npm run build",
27
- "build": "tsup",
28
- "check": "tsc --noEmit",
29
- "gen:entities": "node scripts/generate-entities.mjs",
30
- "test": "vitest --run",
31
- "test:watch": "vitest",
32
- "test:ui": "vitest --ui",
33
- "test:mysql": "vitest --run tests/e2e/mysql-memory.test.ts tests/e2e/decorators-mysql-memory.test.ts tests/e2e/save-graph-mysql-memory.test.ts",
34
- "test:mysql:optimized": "vitest --run --config tests/e2e/mysql/vitest.config.ts",
35
- "test:sqlite": "vitest --run tests/e2e/sqlite-memory.test.ts tests/e2e/decorators-sqlite-memory.test.ts tests/e2e/save-graph-sqlite-memory.test.ts",
36
- "test:pglite": "vitest --run tests/e2e/pglite-memory.test.ts",
37
- "test:e2e": "vitest --run tests/e2e",
38
- "show-sql": "node scripts/show-sql.mjs",
39
- "lint": "node scripts/run-eslint.mjs",
40
- "lint:fix": "node scripts/run-eslint.mjs --fix"
41
- },
42
- "peerDependencies": {
43
- "better-sqlite3": "^11.0.0",
44
- "ioredis": "^5.0.0",
45
- "keyv": "^5.6.0",
46
- "mysql2": "^3.9.0",
47
- "pg": "^8.0.0",
48
- "sqlite3": "^5.1.6",
49
- "tedious": "^19.0.0"
50
- },
51
- "peerDependenciesMeta": {
52
- "better-sqlite3": {
53
- "optional": true
54
- },
55
- "mysql2": {
56
- "optional": true
57
- },
58
- "pg": {
59
- "optional": true
60
- },
61
- "sqlite3": {
62
- "optional": true
63
- },
64
- "tedious": {
65
- "optional": true
66
- },
67
- "keyv": {
68
- "optional": true
69
- },
70
- "ioredis": {
71
- "optional": true
72
- }
73
- },
74
- "devDependencies": {
75
- "@electric-sql/pglite": "^0.4.2",
76
- "@typescript-eslint/eslint-plugin": "^8.58.0",
77
- "@typescript-eslint/parser": "^8.58.0",
78
- "@vitest/ui": "^4.1.2",
79
- "better-sqlite3": "^12.8.0",
80
- "eslint": "^10.1.0",
81
- "express": "^5.2.1",
82
- "ioredis": "^5.10.1",
83
- "ioredis-mock": "^8.13.1",
84
- "keyv": "^5.6.0",
85
- "mysql-memory-server": "^1.14.1",
86
- "mysql2": "^3.20.0",
87
- "pg": "^8.20.0",
88
- "sqlite3": "^6.0.1",
89
- "supertest": "^7.2.2",
90
- "tedious": "^19.2.1",
91
- "tsup": "^8.5.1",
92
- "tsx": "^4.21.0",
93
- "typescript": "^5.9.3",
94
- "vitest": "^4.1.2"
95
- }
96
- }
1
+ {
2
+ "name": "metal-orm",
3
+ "version": "1.1.16",
4
+ "type": "module",
5
+ "repository": {
6
+ "type": "git",
7
+ "url": "https://github.com/celsowm/metal-orm"
8
+ },
9
+ "types": "./dist/index.d.ts",
10
+ "engines": {
11
+ "node": ">=20.0.0"
12
+ },
13
+ "bin": {
14
+ "metal-orm-gen": "./scripts/generate-entities.mjs"
15
+ },
16
+ "exports": {
17
+ ".": {
18
+ "types": "./dist/index.d.ts",
19
+ "import": "./dist/index.js",
20
+ "require": "./dist/index.cjs"
21
+ }
22
+ },
23
+ "files": [
24
+ "dist",
25
+ "src",
26
+ "global.d.ts",
27
+ "scripts"
28
+ ],
29
+ "scripts": {
30
+ "prepublishOnly": "npm run build",
31
+ "build": "tsup",
32
+ "check": "tsc --noEmit -p tsconfig.check.json",
33
+ "gen:entities": "node scripts/generate-entities.mjs",
34
+ "test": "vitest --run",
35
+ "test:watch": "vitest",
36
+ "test:ui": "vitest --ui",
37
+ "test:mysql": "vitest --run tests/e2e/mysql-memory.test.ts tests/e2e/decorators-mysql-memory.test.ts tests/e2e/save-graph-mysql-memory.test.ts",
38
+ "test:mysql:optimized": "vitest --run --config tests/e2e/mysql/vitest.config.ts",
39
+ "test:sqlite": "vitest --run tests/e2e/sqlite-memory.test.ts tests/e2e/decorators-sqlite-memory.test.ts tests/e2e/save-graph-sqlite-memory.test.ts",
40
+ "test:pglite": "vitest --run tests/e2e/pglite-memory.test.ts",
41
+ "test:e2e": "vitest --run tests/e2e",
42
+ "show-sql": "node scripts/show-sql.mjs",
43
+ "lint": "node scripts/run-eslint.mjs",
44
+ "lint:fix": "node scripts/run-eslint.mjs --fix"
45
+ },
46
+ "peerDependencies": {
47
+ "better-sqlite3": "^12.11.1",
48
+ "ioredis": "^5.11.1",
49
+ "keyv": "^5.6.0",
50
+ "mysql2": "^3.22.5",
51
+ "pg": "^8.22.0",
52
+ "sqlite3": "^6.0.1",
53
+ "tedious": "^19.2.1"
54
+ },
55
+ "peerDependenciesMeta": {
56
+ "better-sqlite3": {
57
+ "optional": true
58
+ },
59
+ "mysql2": {
60
+ "optional": true
61
+ },
62
+ "pg": {
63
+ "optional": true
64
+ },
65
+ "sqlite3": {
66
+ "optional": true
67
+ },
68
+ "tedious": {
69
+ "optional": true
70
+ },
71
+ "keyv": {
72
+ "optional": true
73
+ },
74
+ "ioredis": {
75
+ "optional": true
76
+ }
77
+ },
78
+ "devDependencies": {
79
+ "@electric-sql/pglite": "^0.5.3",
80
+ "@typescript-eslint/eslint-plugin": "^8.62.0",
81
+ "@typescript-eslint/parser": "^8.62.0",
82
+ "@vitest/ui": "^4.1.9",
83
+ "better-sqlite3": "^12.11.1",
84
+ "eslint": "^10.6.0",
85
+ "express": "^5.2.1",
86
+ "ioredis": "^5.11.1",
87
+ "ioredis-mock": "^8.13.1",
88
+ "keyv": "^5.6.0",
89
+ "mysql-memory-server": "^1.14.1",
90
+ "mysql2": "^3.22.5",
91
+ "pg": "^8.22.0",
92
+ "sqlite3": "^6.0.1",
93
+ "supertest": "^7.2.2",
94
+ "tedious": "^19.2.1",
95
+ "tsup": "^8.5.1",
96
+ "tsx": "^4.22.4",
97
+ "typescript": "^5.9.3",
98
+ "vitest": "^4.1.9"
99
+ }
100
+ }
@@ -5,15 +5,20 @@ import { buildSchemaMetadata } from './schema.mjs';
5
5
  const escapeJsString = value => value.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
6
6
 
7
7
  const sanitizePropertyName = columnName => {
8
- if (!columnName) return '';
8
+ if (typeof columnName !== 'string' || !columnName) return '';
9
9
  return columnName
10
10
  .replace(/\s+/g, '_')
11
11
  .replace(/[^a-zA-Z0-9_$]/g, '_')
12
12
  .replace(/^[0-9]/, '_$&');
13
13
  };
14
14
 
15
+ const normalizeColumns = columns =>
16
+ (Array.isArray(columns) ? columns : []).filter(
17
+ column => column && typeof column.name === 'string' && column.name.trim().length > 0
18
+ );
19
+
15
20
  const formatJsDoc = comment => {
16
- if (!comment) return null;
21
+ if (typeof comment !== 'string') return null;
17
22
  const normalized = comment.replace(/\r\n?/g, '\n').trim();
18
23
  if (!normalized) return null;
19
24
  const lines = normalized.split('\n').map(line => line.replace(/\*\//g, '*\\/'));
@@ -152,7 +157,7 @@ const buildColumnRemarks = column => {
152
157
 
153
158
  const buildColumnDoc = column => {
154
159
  const entries = [];
155
- if (column.comment) {
160
+ if (typeof column.comment === 'string' && column.comment) {
156
161
  entries.push(column.comment);
157
162
  }
158
163
  const defaultValue = formatDefaultValueForDoc(column.default);
@@ -190,12 +195,13 @@ const renderColumnExpression = (column, tablePk, tableSchema, defaultSchema, pro
190
195
  : `col.default(${expr}, ${def.code})`;
191
196
  }
192
197
  }
193
- if (column.references) {
198
+ if (
199
+ column.references &&
200
+ typeof column.references.table === 'string' &&
201
+ typeof column.references.column === 'string'
202
+ ) {
194
203
  const refTable = normalizeReferenceTable(column.references.table, tableSchema, defaultSchema);
195
- const refParts = [
196
- `table: '${escapeJsString(refTable)}'`,
197
- `column: '${escapeJsString(column.references.column)}'`
198
- ];
204
+ const refParts = [`table: '${escapeJsString(refTable)}'`, `column: '${escapeJsString(column.references.column)}'`];
199
205
  if (column.references.onDelete) refParts.push(`onDelete: '${escapeJsString(column.references.onDelete)}'`);
200
206
  if (column.references.onUpdate) refParts.push(`onUpdate: '${escapeJsString(column.references.onUpdate)}'`);
201
207
  expr = `col.references(${expr}, { ${refParts.join(', ')} })`;
@@ -277,9 +283,10 @@ const renderEntityClassLines = ({ table, className, naming, relations, resolveCl
277
283
  lines.push(`@Entity(${entityOpts})`);
278
284
  lines.push(`export class ${className} {`);
279
285
 
280
- const columnPropertyNames = new Set(table.columns.map(col => sanitizePropertyName(col.name)));
286
+ const tableColumns = normalizeColumns(table.columns);
287
+ const columnPropertyNames = new Set(tableColumns.map(col => sanitizePropertyName(col.name)));
281
288
 
282
- for (const col of table.columns) {
289
+ for (const col of tableColumns) {
283
290
  const propertyName = sanitizePropertyName(col.name);
284
291
  const rendered = renderColumnExpression(col, table.primaryKey, table.schema, defaultSchema, propertyName);
285
292
  appendJsDoc(lines, rendered.comment, ' ');
@@ -414,7 +421,9 @@ const computeTableUsage = (table, relations, defaultSchema, treeConfig) => {
414
421
  needsTreeChildrenDecorator: false
415
422
  };
416
423
 
417
- for (const col of table.columns) {
424
+ const tableColumns = normalizeColumns(table.columns);
425
+
426
+ for (const col of tableColumns) {
418
427
  usage.needsCol = true;
419
428
  const rendered = renderColumnExpression(col, table.primaryKey, table.schema, defaultSchema);
420
429
  if (rendered.decorator === 'PrimaryKey') {
@@ -552,7 +561,7 @@ export const renderEntityFile = (schema, options) => {
552
561
 
553
562
  // Views only need col and Column decorator
554
563
  for (const view of views) {
555
- if (view.columns.length > 0) {
564
+ if (normalizeColumns(view.columns).length > 0) {
556
565
  aggregateUsage.needsCol = true;
557
566
  aggregateUsage.needsColumnDecorator = true;
558
567
  }