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,325 +1,321 @@
1
- #!/usr/bin/env node
2
- import path from 'path';
3
- import process from 'process';
4
- import fs from 'fs';
5
- import os from 'os';
6
- import { spawnSync } from 'child_process';
7
- import { pathToFileURL } from 'url';
8
- import { createRequire } from 'module';
9
-
10
- import {
11
- SqliteDialect,
12
- PostgresDialect,
13
- MySqlDialect,
14
- SqlServerDialect,
15
- Orm,
16
- OrmSession
17
- } from '../dist/index.js';
18
-
19
- const require = createRequire(import.meta.url);
20
- const useStdin = process.argv.includes('--stdin');
21
-
22
- const usage = `Usage: npm run show-sql -- <builder-module> [--dialect=sqlite|postgres|mysql|mssql] [--db=path/to/db.sqlite] [--hydrate] [--e2e]
23
- npm run show-sql -- --stdin [--dialect=sqlite|postgres|mysql|mssql] [--db=path/to/db.sqlite] [--hydrate] [--e2e] < code.mjs
24
- cat code.mjs | npm run show-sql -- --stdin [--dialect=sqlite|postgres|mysql|mssql] [--db=path/to/db.sqlite] [--hydrate] [--e2e]
25
-
26
- The module should export either:
27
- - default: SelectQueryBuilder instance
28
- - builder: SelectQueryBuilder instance
29
- - build(): SelectQueryBuilder (sync or async)
30
-
31
- Example builder module:
32
- import { SelectQueryBuilder, defineTable, col } from '../dist/index.js';
33
- const users = defineTable('users', { id: col.primaryKey(col.int()), name: col.varchar(255) });
34
- export const build = () => new SelectQueryBuilder(users).select({ id: users.columns.id }).limit(5);
35
-
36
- Example stdin usage:
37
- npm run show-sql -- --stdin <<'EOF'
38
- import { SelectQueryBuilder, defineTable, col } from './dist/index.js';
39
- const users = defineTable('users', { id: col.primaryKey(col.int()), name: col.varchar(255) });
40
- export default new SelectQueryBuilder(users).select({ id: users.columns.id }).limit(5);
41
- EOF
42
-
43
- Options:
44
- --hydrate Executes the builder and prints hydrated results (requires sqlite3 if dialect=sqlite).
45
- --e2e Shortcut to execute the builder (like --hydrate) even when you mainly want SQL output; auto-installs sqlite3 to a temp dir if missing.
46
- --db Use a specific SQLite database file instead of the in-memory seeded database.
47
- `;
48
-
49
- const args = process.argv.slice(2);
50
- const modulePath = args.find(a => !a.startsWith('--'));
51
- const dialectArg = args.find(a => a.startsWith('--dialect='))?.split('=')[1] ?? 'sqlite';
52
- const dbPathArg = args.find(a => a.startsWith('--db='))?.split('=')[1];
53
- const hydrate = args.includes('--hydrate');
54
- const e2e = args.includes('--e2e');
55
- const shouldExecute = hydrate || e2e || !!dbPathArg;
56
- const isSqliteDialect = dialectArg.toLowerCase() === 'sqlite';
57
-
58
- if (!modulePath && !useStdin) {
59
- console.error(usage);
60
- process.exit(1);
61
- }
62
-
63
- const dialect = (() => {
64
- switch (dialectArg.toLowerCase()) {
65
- case 'sqlite':
66
- return new SqliteDialect();
67
- case 'postgres':
68
- case 'pg':
69
- return new PostgresDialect();
70
- case 'mysql':
71
- return new MySqlDialect();
72
- case 'mssql':
73
- case 'sqlserver':
74
- return new SqlServerDialect();
75
- default:
76
- console.warn(`Unknown dialect "${dialectArg}", defaulting to sqlite.`);
77
- return new SqliteDialect();
78
- }
79
- })();
80
-
81
- const readStdin = () => {
82
- return new Promise((resolve, reject) => {
83
- let data = '';
84
- process.stdin.setEncoding('utf8');
85
- process.stdin.on('data', chunk => data += chunk);
86
- process.stdin.on('end', () => resolve(data));
87
- process.stdin.on('error', reject);
88
- });
89
- };
90
-
91
- const transformImports = (code) => {
92
- // Transform relative imports to absolute file URLs
93
- const cwd = process.cwd();
94
- return code.replace(
95
- /from\s+['"](\.[^'"]+)['"]/g,
96
- (match, relativePath) => {
97
- const absolutePath = path.resolve(cwd, relativePath);
98
- const fileUrl = pathToFileURL(absolutePath).href;
99
- return `from '${fileUrl}'`;
100
- }
101
- );
102
- };
103
-
104
-
105
- const loadBuilder = async () => {
106
- if (useStdin) {
107
- const code = await readStdin();
108
- if (!code.trim()) {
109
- console.error('No code provided via stdin.');
110
- process.exit(1);
111
- }
112
-
113
- // Transform relative imports to absolute file URLs
114
- const transformedCode = transformImports(code);
115
-
116
- // Create a data URL module from the code
117
- const dataUrl = `data:text/javascript;base64,${Buffer.from(transformedCode).toString('base64')}`;
118
- const mod = await import(dataUrl);
119
-
120
- const candidate = mod.default ?? mod.builder ?? mod.build;
121
- if (typeof candidate === 'function') {
122
- return await candidate();
123
- }
124
- return candidate;
125
- }
126
-
127
- const resolved = path.resolve(modulePath);
128
- const mod = await import(pathToFileURL(resolved).href);
129
-
130
- const candidate = mod.default ?? mod.builder ?? mod.build;
131
- if (typeof candidate === 'function') {
132
- return await candidate();
133
- }
134
- return candidate;
135
- };
136
-
137
- const builder = await loadBuilder();
138
- if (!builder || typeof builder.execute !== 'function') {
139
- console.error('Builder module must export a SelectQueryBuilder instance or a function that returns one.');
140
- process.exit(1);
141
- }
142
-
143
- // --- SQLite Support & Execution Logic ---
144
-
145
- let sqlite3 = null;
146
- const sqliteTempDir = path.join(os.tmpdir(), 'metal-orm-sqlite');
147
-
148
- const tryRequireSqlite3 = () => {
149
- const candidatePaths = [undefined, process.cwd(), sqliteTempDir];
150
- for (const candidate of candidatePaths) {
151
- try {
152
- const resolved = candidate
153
- ? require.resolve('sqlite3', { paths: [candidate] })
154
- : require.resolve('sqlite3');
155
- return require(resolved);
156
- } catch {
157
- /* try next path */
158
- }
159
- }
160
- return null;
161
- };
162
-
163
- const installSqlite3Temp = () => {
164
- fs.mkdirSync(sqliteTempDir, { recursive: true });
165
- const resolvedNpmCli = (() => {
166
- try {
167
- return require.resolve('npm/bin/npm-cli.js');
168
- } catch {
169
- const bundled = path.join(
170
- path.dirname(process.execPath),
171
- 'node_modules',
172
- 'npm',
173
- 'bin',
174
- 'npm-cli.js'
175
- );
176
- if (fs.existsSync(bundled)) {
177
- return bundled;
178
- }
179
- return process.env.npm_execpath;
180
- }
181
- })();
182
-
183
- const npmCommand = resolvedNpmCli ? process.execPath
184
- : process.platform === 'win32'
185
- ? 'npm.cmd'
186
- : 'npm';
187
-
188
- const npmArgs = resolvedNpmCli
189
- ? [resolvedNpmCli, 'install', 'sqlite3', '--no-save', '--no-package-lock', '--prefix', sqliteTempDir]
190
- : ['install', 'sqlite3', '--no-save', '--no-package-lock', '--prefix', sqliteTempDir];
191
-
192
- const result = spawnSync(npmCommand, npmArgs, {
193
- stdio: 'inherit'
194
- });
195
-
196
- if (result.error) {
197
- throw new Error(`Failed to install sqlite3: ${result.error.message}`);
198
- }
199
-
200
- if (result.status !== 0) {
201
- throw new Error(`Failed to install sqlite3 (exit code ${result.status ?? 'unknown'}).`);
202
- }
203
-
204
- const mod = tryRequireSqlite3();
205
- if (!mod) {
206
- throw new Error('sqlite3 installation completed but module could not be required.');
207
- }
208
- return mod;
209
- };
210
-
211
- const ensureSqlite3 = () => {
212
- if (sqlite3) return sqlite3;
213
-
214
- const existing = tryRequireSqlite3();
215
- if (existing) {
216
- sqlite3 = existing;
217
- return sqlite3;
218
- }
219
-
220
- if (!isSqliteDialect || !shouldExecute) {
221
- return null;
222
- }
223
-
224
- console.log('sqlite3 not found; installing locally for SQLite execution (no package.json changes)...');
225
- sqlite3 = installSqlite3Temp();
226
- return sqlite3;
227
- };
228
-
229
- const getSeedSql = () => {
230
- try {
231
- const seedPath = path.join(process.cwd(), 'playground/shared/playground/data/seed.ts');
232
- const content = fs.readFileSync(seedPath, 'utf8');
233
- // Extract content between backticks
234
- const match = content.match(/`([\s\S]*)`/);
235
- return match ? match[1] : null;
236
- } catch (e) {
237
- console.warn('Could not load seed data:', e.message);
238
- return null;
239
- }
240
- };
241
-
242
- const initDb = async () => {
243
- const sqlite = ensureSqlite3();
244
- if (!sqlite) {
245
- console.error("SQLite support requires 'sqlite3'. Please install it to use this feature.");
246
- process.exit(1);
247
- }
248
-
249
- const dbLocation = dbPathArg || ':memory:';
250
- const db = new sqlite.Database(dbLocation);
251
-
252
- if (!dbPathArg) {
253
- // If using in-memory (or no specific DB file provided), try to load seed data
254
- const seedSql = getSeedSql();
255
- if (seedSql) {
256
- await new Promise((resolve, reject) => {
257
- db.exec(seedSql, (err) => {
258
- if (err) reject(err);
259
- else resolve();
260
- });
261
- });
262
- }
263
- }
264
-
265
- return db;
266
- };
267
-
268
- let dbInstance = null;
269
-
270
- const executor = {
271
- async executeSql(sql, params) {
272
- if (!shouldExecute) {
273
- return [];
274
- }
275
-
276
- if (!dbInstance) {
277
- dbInstance = await initDb();
278
- }
279
-
280
- return new Promise((resolve, reject) => {
281
- dbInstance.all(sql, params, (err, rows) => {
282
- if (err) {
283
- reject(err);
284
- return;
285
- }
286
-
287
- const safeRows = rows ?? [];
288
- const columns = safeRows.length ? Object.keys(safeRows[0]) : [];
289
- const values = safeRows.map(row => columns.map(col => row[col]));
290
-
291
- resolve([{ columns, values }]);
292
- });
293
- });
294
- }
295
- };
296
-
297
- const factory = {
298
- createExecutor: () => executor,
299
- createTransactionalExecutor: () => executor
300
- };
301
- const orm = new Orm({ dialect, executorFactory: factory });
302
- const session = new OrmSession({
303
- orm,
304
- executor,
305
- queryLogger(entry) {
306
- console.log('\n--- SQL ---');
307
- console.log(entry.sql);
308
- if (entry.params?.length) {
309
- console.log('Params:', entry.params);
310
- }
311
- console.log('-----------');
312
- }
313
- });
314
-
315
- try {
316
- const result = await builder.execute(session);
317
- if (shouldExecute) {
318
- console.log('\n--- Results ---');
319
- console.log(JSON.stringify(result, null, 2));
320
- console.log('---------------');
321
- }
322
- } catch (err) {
323
- console.error('\nError executing query:', err.message);
324
- process.exit(1);
325
- }
1
+ #!/usr/bin/env node
2
+ import path from 'path';
3
+ import process from 'process';
4
+ import fs from 'fs';
5
+ import os from 'os';
6
+ import { spawnSync } from 'child_process';
7
+ import { pathToFileURL } from 'url';
8
+ import { createRequire } from 'module';
9
+
10
+ import {
11
+ SqliteDialect,
12
+ PostgresDialect,
13
+ MySqlDialect,
14
+ SqlServerDialect,
15
+ Orm,
16
+ OrmSession
17
+ } from '../dist/index.js';
18
+
19
+ const require = createRequire(import.meta.url);
20
+ const useStdin = process.argv.includes('--stdin');
21
+
22
+ const usage = `Usage: npm run show-sql -- <builder-module> [--dialect=sqlite|postgres|mysql|mssql] [--db=path/to/db.sqlite] [--hydrate] [--e2e]
23
+ npm run show-sql -- --stdin [--dialect=sqlite|postgres|mysql|mssql] [--db=path/to/db.sqlite] [--hydrate] [--e2e] < code.mjs
24
+ cat code.mjs | npm run show-sql -- --stdin [--dialect=sqlite|postgres|mysql|mssql] [--db=path/to/db.sqlite] [--hydrate] [--e2e]
25
+
26
+ The module should export either:
27
+ - default: SelectQueryBuilder instance
28
+ - builder: SelectQueryBuilder instance
29
+ - build(): SelectQueryBuilder (sync or async)
30
+
31
+ Example builder module:
32
+ import { SelectQueryBuilder, defineTable, col } from '../dist/index.js';
33
+ const users = defineTable('users', { id: col.primaryKey(col.int()), name: col.varchar(255) });
34
+ export const build = () => new SelectQueryBuilder(users).select({ id: users.columns.id }).limit(5);
35
+
36
+ Example stdin usage:
37
+ npm run show-sql -- --stdin <<'EOF'
38
+ import { SelectQueryBuilder, defineTable, col } from './dist/index.js';
39
+ const users = defineTable('users', { id: col.primaryKey(col.int()), name: col.varchar(255) });
40
+ export default new SelectQueryBuilder(users).select({ id: users.columns.id }).limit(5);
41
+ EOF
42
+
43
+ Options:
44
+ --hydrate Executes the builder and prints hydrated results (requires sqlite3 if dialect=sqlite).
45
+ --e2e Shortcut to execute the builder (like --hydrate) even when you mainly want SQL output; auto-installs sqlite3 to a temp dir if missing.
46
+ --db Use a specific SQLite database file instead of the in-memory seeded database.
47
+ `;
48
+
49
+ const args = process.argv.slice(2);
50
+ const modulePath = args.find(a => !a.startsWith('--'));
51
+ const dialectArg = args.find(a => a.startsWith('--dialect='))?.split('=')[1] ?? 'sqlite';
52
+ const dbPathArg = args.find(a => a.startsWith('--db='))?.split('=')[1];
53
+ const hydrate = args.includes('--hydrate');
54
+ const e2e = args.includes('--e2e');
55
+ const shouldExecute = hydrate || e2e || !!dbPathArg;
56
+ const isSqliteDialect = dialectArg.toLowerCase() === 'sqlite';
57
+
58
+ if (!modulePath && !useStdin) {
59
+ console.error(usage);
60
+ process.exit(1);
61
+ }
62
+
63
+ const dialect = (() => {
64
+ switch (dialectArg.toLowerCase()) {
65
+ case 'sqlite':
66
+ return new SqliteDialect();
67
+ case 'postgres':
68
+ case 'pg':
69
+ return new PostgresDialect();
70
+ case 'mysql':
71
+ return new MySqlDialect();
72
+ case 'mssql':
73
+ case 'sqlserver':
74
+ return new SqlServerDialect();
75
+ default:
76
+ console.warn(`Unknown dialect "${dialectArg}", defaulting to sqlite.`);
77
+ return new SqliteDialect();
78
+ }
79
+ })();
80
+
81
+ const readStdin = () => {
82
+ return new Promise((resolve, reject) => {
83
+ let data = '';
84
+ process.stdin.setEncoding('utf8');
85
+ process.stdin.on('data', chunk => data += chunk);
86
+ process.stdin.on('end', () => resolve(data));
87
+ process.stdin.on('error', reject);
88
+ });
89
+ };
90
+
91
+ const transformImports = (code) => {
92
+ // Transform relative imports to absolute file URLs
93
+ const cwd = process.cwd();
94
+ return code.replace(
95
+ /from\s+['"](\.[^'"]+)['"]/g,
96
+ (match, relativePath) => {
97
+ const absolutePath = path.resolve(cwd, relativePath);
98
+ const fileUrl = pathToFileURL(absolutePath).href;
99
+ return `from '${fileUrl}'`;
100
+ }
101
+ );
102
+ };
103
+
104
+
105
+ const loadBuilder = async () => {
106
+ if (useStdin) {
107
+ const code = await readStdin();
108
+ if (!code.trim()) {
109
+ console.error('No code provided via stdin.');
110
+ process.exit(1);
111
+ }
112
+
113
+ // Transform relative imports to absolute file URLs
114
+ const transformedCode = transformImports(code);
115
+
116
+ // Create a data URL module from the code
117
+ const dataUrl = `data:text/javascript;base64,${Buffer.from(transformedCode).toString('base64')}`;
118
+ const mod = await import(dataUrl);
119
+
120
+ const candidate = mod.default ?? mod.builder ?? mod.build;
121
+ if (typeof candidate === 'function') {
122
+ return await candidate();
123
+ }
124
+ return candidate;
125
+ }
126
+
127
+ const resolved = path.resolve(modulePath);
128
+ const mod = await import(pathToFileURL(resolved).href);
129
+
130
+ const candidate = mod.default ?? mod.builder ?? mod.build;
131
+ if (typeof candidate === 'function') {
132
+ return await candidate();
133
+ }
134
+ return candidate;
135
+ };
136
+
137
+ const builder = await loadBuilder();
138
+ if (!builder || typeof builder.execute !== 'function') {
139
+ console.error('Builder module must export a SelectQueryBuilder instance or a function that returns one.');
140
+ process.exit(1);
141
+ }
142
+
143
+ // --- SQLite Support & Execution Logic ---
144
+
145
+ let sqlite3 = null;
146
+ const sqliteTempDir = path.join(os.tmpdir(), 'metal-orm-sqlite');
147
+
148
+ const tryRequireSqlite3 = () => {
149
+ const candidatePaths = [undefined, process.cwd(), sqliteTempDir];
150
+ for (const candidate of candidatePaths) {
151
+ try {
152
+ const resolved = candidate
153
+ ? require.resolve('sqlite3', { paths: [candidate] })
154
+ : require.resolve('sqlite3');
155
+ return require(resolved);
156
+ } catch {
157
+ /* try next path */
158
+ }
159
+ }
160
+ return null;
161
+ };
162
+
163
+ const installSqlite3Temp = () => {
164
+ fs.mkdirSync(sqliteTempDir, { recursive: true });
165
+ const resolvedNpmCli = (() => {
166
+ try {
167
+ return require.resolve('npm/bin/npm-cli.js');
168
+ } catch {
169
+ const bundled = path.join(
170
+ path.dirname(process.execPath),
171
+ 'node_modules',
172
+ 'npm',
173
+ 'bin',
174
+ 'npm-cli.js'
175
+ );
176
+ if (fs.existsSync(bundled)) {
177
+ return bundled;
178
+ }
179
+ return process.env.npm_execpath;
180
+ }
181
+ })();
182
+
183
+ const npmCommand = resolvedNpmCli ? process.execPath
184
+ : process.platform === 'win32'
185
+ ? 'npm.cmd'
186
+ : 'npm';
187
+
188
+ const npmArgs = resolvedNpmCli
189
+ ? [resolvedNpmCli, 'install', 'sqlite3', '--no-save', '--no-package-lock', '--prefix', sqliteTempDir]
190
+ : ['install', 'sqlite3', '--no-save', '--no-package-lock', '--prefix', sqliteTempDir];
191
+
192
+ const result = spawnSync(npmCommand, npmArgs, {
193
+ stdio: 'inherit'
194
+ });
195
+
196
+ if (result.error) {
197
+ throw new Error(`Failed to install sqlite3: ${result.error.message}`);
198
+ }
199
+
200
+ if (result.status !== 0) {
201
+ throw new Error(`Failed to install sqlite3 (exit code ${result.status ?? 'unknown'}).`);
202
+ }
203
+
204
+ const mod = tryRequireSqlite3();
205
+ if (!mod) {
206
+ throw new Error('sqlite3 installation completed but module could not be required.');
207
+ }
208
+ return mod;
209
+ };
210
+
211
+ const ensureSqlite3 = () => {
212
+ if (sqlite3) return sqlite3;
213
+
214
+ const existing = tryRequireSqlite3();
215
+ if (existing) {
216
+ sqlite3 = existing;
217
+ return sqlite3;
218
+ }
219
+
220
+ if (!isSqliteDialect || !shouldExecute) {
221
+ return null;
222
+ }
223
+
224
+ console.log('sqlite3 not found; installing locally for SQLite execution (no package.json changes)...');
225
+ sqlite3 = installSqlite3Temp();
226
+ return sqlite3;
227
+ };
228
+
229
+ const getSeedSql = () => {
230
+ try {
231
+ return fs.readFileSync(new URL('./show-sql-seed.sql', import.meta.url), 'utf8');
232
+ } catch (e) {
233
+ console.warn('Could not load seed data:', e.message);
234
+ return null;
235
+ }
236
+ };
237
+
238
+ const initDb = async () => {
239
+ const sqlite = ensureSqlite3();
240
+ if (!sqlite) {
241
+ console.error("SQLite support requires 'sqlite3'. Please install it to use this feature.");
242
+ process.exit(1);
243
+ }
244
+
245
+ const dbLocation = dbPathArg || ':memory:';
246
+ const db = new sqlite.Database(dbLocation);
247
+
248
+ if (!dbPathArg) {
249
+ // If using in-memory (or no specific DB file provided), try to load seed data
250
+ const seedSql = getSeedSql();
251
+ if (seedSql) {
252
+ await new Promise((resolve, reject) => {
253
+ db.exec(seedSql, (err) => {
254
+ if (err) reject(err);
255
+ else resolve();
256
+ });
257
+ });
258
+ }
259
+ }
260
+
261
+ return db;
262
+ };
263
+
264
+ let dbInstance = null;
265
+
266
+ const executor = {
267
+ async executeSql(sql, params) {
268
+ if (!shouldExecute) {
269
+ return [];
270
+ }
271
+
272
+ if (!dbInstance) {
273
+ dbInstance = await initDb();
274
+ }
275
+
276
+ return new Promise((resolve, reject) => {
277
+ dbInstance.all(sql, params, (err, rows) => {
278
+ if (err) {
279
+ reject(err);
280
+ return;
281
+ }
282
+
283
+ const safeRows = rows ?? [];
284
+ const columns = safeRows.length ? Object.keys(safeRows[0]) : [];
285
+ const values = safeRows.map(row => columns.map(col => row[col]));
286
+
287
+ resolve([{ columns, values }]);
288
+ });
289
+ });
290
+ }
291
+ };
292
+
293
+ const factory = {
294
+ createExecutor: () => executor,
295
+ createTransactionalExecutor: () => executor
296
+ };
297
+ const orm = new Orm({ dialect, executorFactory: factory });
298
+ const session = new OrmSession({
299
+ orm,
300
+ executor,
301
+ queryLogger(entry) {
302
+ console.log('\n--- SQL ---');
303
+ console.log(entry.sql);
304
+ if (entry.params?.length) {
305
+ console.log('Params:', entry.params);
306
+ }
307
+ console.log('-----------');
308
+ }
309
+ });
310
+
311
+ try {
312
+ const result = await builder.execute(session);
313
+ if (shouldExecute) {
314
+ console.log('\n--- Results ---');
315
+ console.log(JSON.stringify(result, null, 2));
316
+ console.log('---------------');
317
+ }
318
+ } catch (err) {
319
+ console.error('\nError executing query:', err.message);
320
+ process.exit(1);
321
+ }