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,34 +1,33 @@
1
- #!/usr/bin/env node
2
- import path from 'node:path';
3
- import { spawn } from 'node:child_process';
4
-
5
- const [, , ...userArgs] = process.argv;
6
-
7
- const TARGETS = {
8
- src: ['./src'],
9
- all: ['./src', './tests', './scripts', './playground'],
10
- playground: ['./playground'],
11
- 'src/core': ['./src/core'],
12
- };
13
-
14
- const [firstArg, ...restArgs] = userArgs;
15
- const hasTarget = firstArg && !firstArg.startsWith('-');
16
-
17
- const targetKey = hasTarget ? firstArg : 'all';
18
- const extraArgs = hasTarget ? restArgs : userArgs;
19
-
20
- const paths = TARGETS[targetKey] ?? [targetKey];
21
-
22
- if (paths.length === 0) {
23
- console.error(`Unknown lint target: ${targetKey}`);
24
- process.exit(1);
25
- }
26
-
27
- const eslintArgs = [...paths, '--ext', '.ts,.tsx,.mjs', ...extraArgs];
28
-
29
- const eslintBinBase = path.join(process.cwd(), 'node_modules', '.bin', 'eslint');
30
- const executable = process.platform === 'win32' ? `${eslintBinBase}.cmd` : eslintBinBase;
31
-
32
- const child = spawn(executable, eslintArgs, { stdio: 'inherit', shell: true });
33
-
34
- child.on('exit', (code) => process.exit(code));
1
+ #!/usr/bin/env node
2
+ import path from 'node:path';
3
+ import { spawn } from 'node:child_process';
4
+
5
+ const [, , ...userArgs] = process.argv;
6
+
7
+ const TARGETS = {
8
+ src: ['./src'],
9
+ all: ['./src', './scripts'],
10
+ 'src/core': ['./src/core'],
11
+ };
12
+
13
+ const [firstArg, ...restArgs] = userArgs;
14
+ const hasTarget = firstArg && !firstArg.startsWith('-');
15
+
16
+ const targetKey = hasTarget ? firstArg : 'all';
17
+ const extraArgs = hasTarget ? restArgs : userArgs;
18
+
19
+ const paths = TARGETS[targetKey] ?? [targetKey];
20
+
21
+ if (paths.length === 0) {
22
+ console.error(`Unknown lint target: ${targetKey}`);
23
+ process.exit(1);
24
+ }
25
+
26
+ const eslintArgs = [...paths, '--ext', '.ts,.tsx,.mjs', ...extraArgs];
27
+
28
+ const eslintBinBase = path.join(process.cwd(), 'node_modules', '.bin', 'eslint');
29
+ const executable = process.platform === 'win32' ? `${eslintBinBase}.cmd` : eslintBinBase;
30
+
31
+ const child = spawn(executable, eslintArgs, { stdio: 'inherit', shell: true });
32
+
33
+ child.on('exit', (code) => process.exit(code));
@@ -0,0 +1,102 @@
1
+ DROP TABLE IF EXISTS project_assignments;
2
+ DROP TABLE IF EXISTS projects;
3
+ DROP TABLE IF EXISTS user_roles;
4
+ DROP TABLE IF EXISTS roles;
5
+ DROP TABLE IF EXISTS profiles;
6
+ DROP TABLE IF EXISTS orders;
7
+ DROP TABLE IF EXISTS users;
8
+
9
+ -- Core tables
10
+ CREATE TABLE users (
11
+ id INTEGER PRIMARY KEY,
12
+ name TEXT,
13
+ role TEXT,
14
+ settings TEXT,
15
+ deleted_at TEXT
16
+ );
17
+
18
+ CREATE TABLE orders (
19
+ id INTEGER PRIMARY KEY,
20
+ user_id INTEGER,
21
+ total INTEGER,
22
+ status TEXT
23
+ );
24
+
25
+ CREATE TABLE profiles (
26
+ id INTEGER PRIMARY KEY,
27
+ user_id INTEGER,
28
+ bio TEXT,
29
+ twitter TEXT
30
+ );
31
+
32
+ CREATE TABLE roles (
33
+ id INTEGER PRIMARY KEY,
34
+ name TEXT,
35
+ level TEXT
36
+ );
37
+
38
+ -- N:N join table with extra attributes ("rich association")
39
+ CREATE TABLE user_roles (
40
+ id INTEGER PRIMARY KEY,
41
+ user_id INTEGER,
42
+ role_id INTEGER,
43
+ assigned_at TEXT, -- when the role was assigned
44
+ is_active BOOLEAN -- current vs historical
45
+ );
46
+
47
+ -- Projects for ternary relationship
48
+ CREATE TABLE projects (
49
+ id INTEGER PRIMARY KEY,
50
+ name TEXT,
51
+ client TEXT
52
+ );
53
+
54
+ -- Ternary link: user + project + role
55
+ CREATE TABLE project_assignments (
56
+ id INTEGER PRIMARY KEY,
57
+ project_id INTEGER,
58
+ user_id INTEGER,
59
+ role_id INTEGER,
60
+ assigned_at TEXT
61
+ );
62
+
63
+ -- Users
64
+ INSERT INTO users VALUES (1, 'Alice Engineer', 'admin', '{"theme":"dark"}', NULL);
65
+ INSERT INTO users VALUES (2, 'Bob Manager', 'user', '{"theme":"light"}', NULL);
66
+ INSERT INTO users VALUES (3, 'Charlie Intern', 'user', '{"theme":"dark"}', '2023-01-01');
67
+ INSERT INTO users VALUES (4, 'David CTO', 'admin', '{"notifications":true}', NULL);
68
+
69
+ -- Orders
70
+ INSERT INTO orders VALUES (101, 1, 500, 'completed');
71
+ INSERT INTO orders VALUES (102, 1, 120, 'pending');
72
+ INSERT INTO orders VALUES (103, 2, 900, 'completed');
73
+ INSERT INTO orders VALUES (104, 3, 50, 'cancelled');
74
+ INSERT INTO orders VALUES (105, 1, 300, 'completed');
75
+
76
+ -- Profiles (1:1 with users)
77
+ INSERT INTO profiles VALUES (1, 1, 'Lead Systems Engineer with API obsession', '@alice_engineer');
78
+ INSERT INTO profiles VALUES (2, 2, 'Operations manager who optimizes everything', '@bob_ops');
79
+ INSERT INTO profiles VALUES (3, 3, 'Intern documenting every experiment', '@charlie_docs');
80
+ INSERT INTO profiles VALUES (4, 4, 'CTO crafting scalable futures', '@david_cto');
81
+
82
+ -- Roles
83
+ INSERT INTO roles VALUES (1, 'admin', 'platform');
84
+ INSERT INTO roles VALUES (2, 'manager', 'operations');
85
+ INSERT INTO roles VALUES (3, 'intern', 'learning');
86
+ INSERT INTO roles VALUES (4, 'viewer', 'guest'); -- extra role for projects
87
+
88
+ -- User roles (N:N with attributes on the edge)
89
+ INSERT INTO user_roles VALUES (1, 1, 1, '2022-01-01', 1); -- Alice is Admin (active)
90
+ INSERT INTO user_roles VALUES (2, 1, 2, '2022-06-01', 0); -- Alice was Manager (inactive)
91
+ INSERT INTO user_roles VALUES (3, 2, 2, '2023-01-15', 1); -- Bob is Manager (active)
92
+ INSERT INTO user_roles VALUES (4, 3, 3, '2023-08-20', 1); -- Charlie is Intern (active)
93
+
94
+ -- Projects
95
+ INSERT INTO projects VALUES (10, 'Alpha Redesign', 'Acme Corp');
96
+ INSERT INTO projects VALUES (20, 'Beta Migration', 'Globex');
97
+
98
+ -- Ternary: who has which role in which project
99
+ INSERT INTO project_assignments VALUES (1, 10, 1, 2, '2023-09-01'); -- Alice is manager on Alpha
100
+ INSERT INTO project_assignments VALUES (2, 10, 2, 4, '2023-09-05'); -- Bob is viewer on Alpha
101
+ INSERT INTO project_assignments VALUES (3, 20, 3, 3, '2023-10-01'); -- Charlie is intern on Beta
102
+ INSERT INTO project_assignments VALUES (4, 20, 1, 1, '2023-10-01'); -- Alice is admin on Beta