metal-orm 1.1.11 → 1.1.18

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 (182) hide show
  1. package/README.md +758 -769
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.js.map +1 -1
  4. package/package.json +100 -96
  5. package/scripts/generate-entities/schema.mjs +122 -122
  6. package/scripts/generate-entities/tree-detection.mjs +92 -92
  7. package/scripts/inflection/pt-br.mjs +468 -468
  8. package/scripts/run-eslint.mjs +33 -34
  9. package/scripts/show-sql-seed.sql +102 -0
  10. package/scripts/show-sql.mjs +321 -325
  11. package/src/codegen/naming-strategy.ts +54 -54
  12. package/src/codegen/typescript.ts +482 -482
  13. package/src/core/ast/adapters.ts +1 -1
  14. package/src/core/ast/builders.ts +123 -123
  15. package/src/core/ast/expression-builders.ts +745 -745
  16. package/src/core/ast/expression-nodes.ts +304 -304
  17. package/src/core/ast/expression-visitor.ts +212 -212
  18. package/src/core/ast/expression.ts +20 -20
  19. package/src/core/ast/helpers.ts +14 -14
  20. package/src/core/ast/join.ts +18 -18
  21. package/src/core/ast/query.ts +200 -200
  22. package/src/core/ddl/dialects/base-schema-dialect.ts +1 -1
  23. package/src/core/ddl/dialects/mssql-schema-dialect.ts +1 -1
  24. package/src/core/ddl/dialects/mysql-schema-dialect.ts +1 -1
  25. package/src/core/ddl/dialects/postgres-schema-dialect.ts +1 -1
  26. package/src/core/ddl/dialects/render-reference.test.ts +70 -70
  27. package/src/core/ddl/dialects/sqlite-schema-dialect.ts +1 -1
  28. package/src/core/ddl/introspect/catalogs/index.ts +5 -5
  29. package/src/core/ddl/introspect/catalogs/postgres.ts +146 -146
  30. package/src/core/ddl/introspect/context.ts +15 -15
  31. package/src/core/ddl/introspect/functions/postgres.ts +35 -35
  32. package/src/core/ddl/introspect/registry.ts +40 -40
  33. package/src/core/ddl/introspect/run-select.ts +35 -35
  34. package/src/core/ddl/introspect/utils.ts +56 -56
  35. package/src/core/ddl/naming-strategy.ts +16 -16
  36. package/src/core/ddl/schema-dialect.ts +56 -56
  37. package/src/core/ddl/schema-diff.ts +234 -234
  38. package/src/core/ddl/schema-generator.ts +1 -1
  39. package/src/core/ddl/schema-introspect.ts +25 -25
  40. package/src/core/ddl/sql-writing.ts +171 -171
  41. package/src/core/dialect/abstract.ts +541 -541
  42. package/src/core/dialect/base/cte-compiler.ts +33 -33
  43. package/src/core/dialect/base/function-table-formatter.ts +103 -103
  44. package/src/core/dialect/base/groupby-compiler.ts +21 -21
  45. package/src/core/dialect/base/join-compiler.ts +25 -25
  46. package/src/core/dialect/base/orderby-compiler.ts +35 -35
  47. package/src/core/dialect/base/pagination-strategy.ts +32 -32
  48. package/src/core/dialect/base/returning-strategy.ts +57 -57
  49. package/src/core/dialect/base/sql-dialect.ts +294 -294
  50. package/src/core/dialect/dialect-factory.ts +91 -91
  51. package/src/core/dialect/mssql/functions.ts +120 -120
  52. package/src/core/dialect/mssql/index.ts +317 -317
  53. package/src/core/dialect/mysql/functions.ts +103 -103
  54. package/src/core/dialect/mysql/index.ts +105 -105
  55. package/src/core/dialect/postgres/functions.ts +108 -108
  56. package/src/core/dialect/postgres/index.ts +91 -91
  57. package/src/core/dialect/sqlite/functions.ts +129 -129
  58. package/src/core/dialect/sqlite/index.ts +67 -67
  59. package/src/core/driver/database-driver.ts +19 -19
  60. package/src/core/driver/mssql-driver.ts +23 -23
  61. package/src/core/driver/mysql-driver.ts +23 -23
  62. package/src/core/driver/postgres-driver.ts +23 -23
  63. package/src/core/driver/sqlite-driver.ts +23 -23
  64. package/src/core/execution/db-executor.ts +92 -92
  65. package/src/core/execution/executors/better-sqlite3-executor.ts +90 -90
  66. package/src/core/execution/executors/mssql-executor.ts +184 -184
  67. package/src/core/execution/executors/mysql-executor.ts +88 -88
  68. package/src/core/execution/executors/postgres-executor.ts +26 -26
  69. package/src/core/execution/executors/sqlite-executor.ts +42 -42
  70. package/src/core/execution/pooling/pool-types.ts +30 -30
  71. package/src/core/execution/pooling/pool.ts +275 -275
  72. package/src/core/functions/array.ts +35 -35
  73. package/src/core/functions/control-flow.ts +79 -79
  74. package/src/core/functions/datetime.ts +237 -237
  75. package/src/core/functions/json.ts +70 -70
  76. package/src/core/functions/numeric.ts +297 -297
  77. package/src/core/functions/text.ts +334 -334
  78. package/src/core/functions/types.ts +33 -33
  79. package/src/core/hydration/types.ts +51 -51
  80. package/src/core/sql/sql-operator-config.ts +39 -39
  81. package/src/core/sql/sql.ts +152 -152
  82. package/src/decorators/column-decorator.ts +87 -87
  83. package/src/decorators/decorator-metadata.ts +143 -143
  84. package/src/decorators/entity.ts +93 -93
  85. package/src/decorators/index.ts +39 -39
  86. package/src/decorators/relations.ts +231 -231
  87. package/src/decorators/transformers/built-in/string-transformers.ts +231 -231
  88. package/src/decorators/transformers/transformer-decorators.ts +134 -134
  89. package/src/decorators/transformers/transformer-executor.ts +171 -171
  90. package/src/decorators/transformers/transformer-metadata.ts +73 -73
  91. package/src/decorators/validators/built-in/br-cep-validator.ts +55 -55
  92. package/src/decorators/validators/built-in/br-cnpj-validator.ts +105 -105
  93. package/src/decorators/validators/built-in/br-cpf-validator.ts +103 -103
  94. package/src/decorators/validators/country-validator-registry.ts +64 -64
  95. package/src/decorators/validators/country-validators-decorators.ts +203 -203
  96. package/src/decorators/validators/country-validators.ts +105 -105
  97. package/src/decorators/validators/validator-metadata.ts +59 -59
  98. package/src/dto/dto-types.ts +226 -226
  99. package/src/dto/filter-types.ts +141 -141
  100. package/src/dto/index.ts +95 -95
  101. package/src/dto/openapi/generators/base.ts +29 -29
  102. package/src/dto/openapi/generators/column.ts +37 -37
  103. package/src/dto/openapi/generators/dto.ts +91 -91
  104. package/src/dto/openapi/generators/filter.ts +75 -75
  105. package/src/dto/openapi/generators/nested-dto.ts +618 -618
  106. package/src/dto/openapi/generators/pagination.ts +111 -111
  107. package/src/dto/openapi/generators/relation-filter.ts +228 -228
  108. package/src/dto/openapi/index.ts +12 -12
  109. package/src/dto/openapi/types.ts +101 -101
  110. package/src/dto/openapi/utilities.ts +95 -95
  111. package/src/dto/pagination-utils.ts +150 -150
  112. package/src/dto/transform.ts +197 -197
  113. package/src/index.ts +86 -86
  114. package/src/orm/als.ts +58 -58
  115. package/src/orm/domain-event-bus.ts +119 -119
  116. package/src/orm/entity-context.ts +86 -86
  117. package/src/orm/entity-materializer.ts +159 -159
  118. package/src/orm/entity-meta.ts +97 -97
  119. package/src/orm/entity-registry.ts +39 -39
  120. package/src/orm/entity-relation-cache.ts +39 -39
  121. package/src/orm/execute.ts +194 -194
  122. package/src/orm/execution-context.ts +18 -18
  123. package/src/orm/hydration-context.ts +26 -26
  124. package/src/orm/hydration.ts +112 -112
  125. package/src/orm/identity-map.ts +61 -61
  126. package/src/orm/interceptor-pipeline.ts +16 -16
  127. package/src/orm/lazy-batch/belongs-to-many.ts +119 -119
  128. package/src/orm/lazy-batch/belongs-to.ts +108 -108
  129. package/src/orm/lazy-batch/has-many.ts +69 -69
  130. package/src/orm/lazy-batch/has-one.ts +68 -68
  131. package/src/orm/lazy-batch/shared.ts +125 -125
  132. package/src/orm/orm-session.ts +620 -620
  133. package/src/orm/orm.ts +34 -34
  134. package/src/orm/pooled-executor-factory.ts +121 -121
  135. package/src/orm/query-logger.ts +40 -40
  136. package/src/orm/relation-change-processor.ts +420 -420
  137. package/src/orm/relations/belongs-to.ts +143 -143
  138. package/src/orm/relations/has-many.ts +204 -204
  139. package/src/orm/relations/has-one.ts +174 -174
  140. package/src/orm/relations/many-to-many.ts +288 -288
  141. package/src/orm/relations/morph-many.ts +156 -156
  142. package/src/orm/relations/morph-one.ts +151 -151
  143. package/src/orm/relations/morph-to.ts +162 -162
  144. package/src/orm/runtime-types.ts +92 -92
  145. package/src/orm/save-graph.ts +561 -561
  146. package/src/orm/transaction-runner.ts +24 -24
  147. package/src/orm/unit-of-work.ts +426 -426
  148. package/src/query/index.ts +69 -69
  149. package/src/query/target.ts +46 -46
  150. package/src/query-builder/column-selector.ts +81 -81
  151. package/src/query-builder/delete.ts +141 -141
  152. package/src/query-builder/insert-query-state.ts +149 -149
  153. package/src/query-builder/insert.ts +117 -117
  154. package/src/query-builder/query-ast-service.ts +287 -287
  155. package/src/query-builder/query-resolution.ts +78 -78
  156. package/src/query-builder/raw-column-parser.ts +38 -38
  157. package/src/query-builder/relation-filter-utils.ts +153 -153
  158. package/src/query-builder/relation-join-planner.ts +10 -10
  159. package/src/query-builder/relation-manager.ts +87 -87
  160. package/src/query-builder/relation-projection-helper.ts +102 -102
  161. package/src/query-builder/relation-types.ts +9 -9
  162. package/src/query-builder/relation-utils.ts +15 -15
  163. package/src/query-builder/select/cte-facet.ts +40 -40
  164. package/src/query-builder/select/from-facet.ts +80 -80
  165. package/src/query-builder/select/join-facet.ts +62 -62
  166. package/src/query-builder/select/predicate-facet.ts +104 -104
  167. package/src/query-builder/select/projection-facet.ts +70 -70
  168. package/src/query-builder/select/relation-facet.ts +81 -81
  169. package/src/query-builder/select/setop-facet.ts +36 -36
  170. package/src/query-builder/select-helpers.ts +1 -1
  171. package/src/query-builder/select-query-builder-deps.ts +130 -130
  172. package/src/query-builder/select-query-state.ts +207 -207
  173. package/src/query-builder/update.ts +151 -151
  174. package/src/schema/column-types.ts +322 -322
  175. package/src/schema/table-guards.ts +37 -37
  176. package/src/schema/table.ts +281 -281
  177. package/src/tree/index.ts +13 -13
  178. package/src/tree/nested-set-strategy.ts +545 -545
  179. package/src/tree/tree-decorator.ts +397 -397
  180. package/src/tree/tree-manager.ts +754 -754
  181. package/src/tree/tree-query.ts +427 -427
  182. 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