metal-orm 1.0.43 → 1.0.45

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 (85) hide show
  1. package/README.md +700 -557
  2. package/dist/index.cjs +896 -476
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.d.cts +1146 -275
  5. package/dist/index.d.ts +1146 -275
  6. package/dist/index.js +896 -474
  7. package/dist/index.js.map +1 -1
  8. package/package.json +1 -1
  9. package/src/core/ast/adapters.ts +8 -2
  10. package/src/core/ast/builders.ts +105 -81
  11. package/src/core/ast/expression-builders.ts +430 -390
  12. package/src/core/ast/expression-visitor.ts +47 -8
  13. package/src/core/ast/helpers.ts +23 -0
  14. package/src/core/ast/join-node.ts +17 -1
  15. package/src/core/ddl/dialects/base-schema-dialect.ts +7 -1
  16. package/src/core/ddl/dialects/index.ts +1 -0
  17. package/src/core/ddl/dialects/mssql-schema-dialect.ts +1 -0
  18. package/src/core/ddl/dialects/mysql-schema-dialect.ts +1 -0
  19. package/src/core/ddl/dialects/postgres-schema-dialect.ts +1 -0
  20. package/src/core/ddl/dialects/sqlite-schema-dialect.ts +1 -0
  21. package/src/core/ddl/introspect/catalogs/index.ts +1 -0
  22. package/src/core/ddl/introspect/catalogs/postgres.ts +2 -0
  23. package/src/core/ddl/introspect/context.ts +6 -0
  24. package/src/core/ddl/introspect/functions/postgres.ts +13 -0
  25. package/src/core/ddl/introspect/mssql.ts +11 -0
  26. package/src/core/ddl/introspect/mysql.ts +2 -0
  27. package/src/core/ddl/introspect/postgres.ts +14 -0
  28. package/src/core/ddl/introspect/registry.ts +14 -0
  29. package/src/core/ddl/introspect/run-select.ts +13 -0
  30. package/src/core/ddl/introspect/sqlite.ts +22 -0
  31. package/src/core/ddl/introspect/utils.ts +18 -0
  32. package/src/core/ddl/naming-strategy.ts +6 -0
  33. package/src/core/ddl/schema-dialect.ts +19 -6
  34. package/src/core/ddl/schema-diff.ts +22 -0
  35. package/src/core/ddl/schema-generator.ts +22 -0
  36. package/src/core/ddl/schema-plan-executor.ts +6 -0
  37. package/src/core/ddl/schema-types.ts +6 -0
  38. package/src/core/dialect/abstract.ts +2 -2
  39. package/src/core/execution/pooling/pool.ts +12 -7
  40. package/src/core/functions/datetime.ts +57 -33
  41. package/src/core/functions/numeric.ts +95 -30
  42. package/src/core/functions/standard-strategy.ts +35 -0
  43. package/src/core/functions/text.ts +83 -22
  44. package/src/core/functions/types.ts +23 -8
  45. package/src/decorators/bootstrap.ts +16 -4
  46. package/src/decorators/column.ts +17 -0
  47. package/src/decorators/decorator-metadata.ts +27 -0
  48. package/src/decorators/entity.ts +8 -0
  49. package/src/decorators/index.ts +3 -0
  50. package/src/decorators/relations.ts +32 -0
  51. package/src/orm/als.ts +34 -9
  52. package/src/orm/entity-context.ts +54 -0
  53. package/src/orm/entity-metadata.ts +122 -9
  54. package/src/orm/execute.ts +15 -0
  55. package/src/orm/lazy-batch.ts +158 -98
  56. package/src/orm/relations/has-many.ts +44 -0
  57. package/src/orm/save-graph.ts +45 -0
  58. package/src/query/index.ts +74 -0
  59. package/src/query/target.ts +46 -0
  60. package/src/query-builder/delete-query-state.ts +30 -0
  61. package/src/query-builder/delete.ts +64 -19
  62. package/src/query-builder/hydration-manager.ts +46 -0
  63. package/src/query-builder/insert-query-state.ts +30 -0
  64. package/src/query-builder/insert.ts +46 -2
  65. package/src/query-builder/query-ast-service.ts +5 -0
  66. package/src/query-builder/query-resolution.ts +78 -0
  67. package/src/query-builder/raw-column-parser.ts +5 -0
  68. package/src/query-builder/relation-alias.ts +7 -0
  69. package/src/query-builder/relation-conditions.ts +61 -48
  70. package/src/query-builder/relation-service.ts +68 -63
  71. package/src/query-builder/relation-utils.ts +3 -0
  72. package/src/query-builder/select/cte-facet.ts +40 -0
  73. package/src/query-builder/select/from-facet.ts +80 -0
  74. package/src/query-builder/select/join-facet.ts +62 -0
  75. package/src/query-builder/select/predicate-facet.ts +103 -0
  76. package/src/query-builder/select/projection-facet.ts +69 -0
  77. package/src/query-builder/select/relation-facet.ts +81 -0
  78. package/src/query-builder/select/setop-facet.ts +36 -0
  79. package/src/query-builder/select-helpers.ts +13 -0
  80. package/src/query-builder/select-query-builder-deps.ts +19 -1
  81. package/src/query-builder/select-query-state.ts +2 -1
  82. package/src/query-builder/select.ts +795 -1163
  83. package/src/query-builder/update-query-state.ts +52 -0
  84. package/src/query-builder/update.ts +69 -19
  85. package/src/schema/table-guards.ts +31 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "metal-orm",
3
- "version": "1.0.43",
3
+ "version": "1.0.45",
4
4
  "type": "module",
5
5
  "types": "./dist/index.d.ts",
6
6
  "engines": {
@@ -2,13 +2,19 @@ import { ColumnDef } from '../../schema/column.js';
2
2
  import { TableDef } from '../../schema/table.js';
3
3
  import { ColumnRef, TableRef } from './types.js';
4
4
 
5
+ /**
6
+ * Type guard to check if an object has an alias property
7
+ */
8
+ const hasAlias = (obj: unknown): obj is { alias?: string } =>
9
+ typeof obj === 'object' && obj !== null && 'alias' in obj;
10
+
5
11
  /**
6
12
  * Adapts a schema ColumnDef to an AST-friendly ColumnRef.
7
13
  */
8
14
  export const toColumnRef = (col: ColumnRef | ColumnDef): ColumnRef => ({
9
15
  name: col.name,
10
16
  table: col.table,
11
- alias: (col as ColumnRef).alias
17
+ alias: hasAlias(col) ? col.alias : undefined
12
18
  });
13
19
 
14
20
  /**
@@ -17,5 +23,5 @@ export const toColumnRef = (col: ColumnRef | ColumnDef): ColumnRef => ({
17
23
  export const toTableRef = (table: TableRef | TableDef): TableRef => ({
18
24
  name: table.name,
19
25
  schema: table.schema,
20
- alias: (table as TableRef).alias
26
+ alias: hasAlias(table) ? table.alias : undefined
21
27
  });
@@ -1,81 +1,105 @@
1
- import { ColumnNode, OperandNode } from './expression-nodes.js';
2
- import { TableNode, FunctionTableNode, DerivedTableNode } from './query.js';
3
- import { ColumnRef, TableRef } from './types.js';
4
-
5
- /**
6
- * Builds or normalizes a column AST node from a column definition or existing node
7
- * @param table - Table definition providing a default table name
8
- * @param column - Column definition or existing column node
9
- */
10
- export const buildColumnNode = (table: TableRef, column: ColumnRef | ColumnNode): ColumnNode => {
11
- if ((column as ColumnNode).type === 'Column') {
12
- return column as ColumnNode;
13
- }
14
-
15
- const def = column as ColumnRef;
16
- const baseTable = def.table
17
- ? table.alias && def.table === table.name
18
- ? table.alias
19
- : def.table
20
- : table.alias || table.name;
21
-
22
- return {
23
- type: 'Column',
24
- table: baseTable,
25
- name: def.name
26
- };
27
- };
28
-
29
- /**
30
- * Builds column AST nodes for a list of column names
31
- * @param table - Table definition providing the table name
32
- * @param names - Column names
33
- */
34
- export const buildColumnNodes = (table: TableRef, names: string[]): ColumnNode[] =>
35
- names.map(name => ({
36
- type: 'Column',
37
- table: table.alias || table.name,
38
- name
39
- }));
40
-
41
- /**
42
- * Builds a table AST node for the provided table definition
43
- * @param table - Table definition
44
- */
45
- export const createTableNode = (table: TableRef): TableNode => ({
46
- type: 'Table',
47
- name: table.name
48
- });
49
-
50
- /**
51
- * Creates a FunctionTable node for expressions like `function_name(args...)` used in FROM
52
- */
53
- export const fnTable = (
54
- name: string,
55
- args: OperandNode[] = [],
56
- alias?: string,
57
- opts?: { lateral?: boolean; withOrdinality?: boolean; columnAliases?: string[]; schema?: string }
58
- ): FunctionTableNode => ({
59
- type: 'FunctionTable',
60
- name,
61
- args,
62
- alias,
63
- lateral: opts?.lateral,
64
- withOrdinality: opts?.withOrdinality,
65
- columnAliases: opts?.columnAliases,
66
- schema: opts?.schema
67
- });
68
-
69
- /**
70
- * Creates a derived table node wrapping a subquery.
71
- */
72
- export const derivedTable = (
73
- query: import('./query.js').SelectQueryNode,
74
- alias: string,
75
- columnAliases?: string[]
76
- ): DerivedTableNode => ({
77
- type: 'DerivedTable',
78
- query,
79
- alias,
80
- columnAliases
81
- });
1
+ import { ColumnNode, OperandNode } from './expression-nodes.js';
2
+ import { TableNode, FunctionTableNode, DerivedTableNode } from './query.js';
3
+ import { ColumnRef, TableRef } from './types.js';
4
+
5
+ /**
6
+ * Type guard to check if a column is already a ColumnNode
7
+ */
8
+ const isColumnNode = (col: ColumnRef | ColumnNode): col is ColumnNode =>
9
+ 'type' in col && col.type === 'Column';
10
+
11
+ /**
12
+ * Resolves the appropriate table name for a column reference
13
+ * @param def - Column reference definition
14
+ * @param table - Table reference providing context
15
+ * @returns The resolved table name to use
16
+ */
17
+ const resolveTableName = (def: ColumnRef, table: TableRef): string => {
18
+ // If column doesn't specify a table, use the table's alias or name
19
+ if (!def.table) {
20
+ return table.alias || table.name;
21
+ }
22
+
23
+ // If column specifies the base table name and table has an alias, use the alias
24
+ if (table.alias && def.table === table.name) {
25
+ return table.alias;
26
+ }
27
+
28
+ // Otherwise use the table specified in the column definition
29
+ return def.table;
30
+ };
31
+
32
+ /**
33
+ * Builds or normalizes a column AST node from a column definition or existing node
34
+ * @param table - Table definition providing a default table name
35
+ * @param column - Column definition or existing column node
36
+ */
37
+ export const buildColumnNode = (table: TableRef, column: ColumnRef | ColumnNode): ColumnNode => {
38
+ if (isColumnNode(column)) {
39
+ return column;
40
+ }
41
+
42
+ const def = column as ColumnRef;
43
+ const baseTable = resolveTableName(def, table);
44
+
45
+ return {
46
+ type: 'Column',
47
+ table: baseTable,
48
+ name: def.name
49
+ };
50
+ };
51
+
52
+ /**
53
+ * Builds column AST nodes for a list of column names
54
+ * @param table - Table definition providing the table name
55
+ * @param names - Column names
56
+ */
57
+ export const buildColumnNodes = (table: TableRef, names: string[]): ColumnNode[] =>
58
+ names.map(name => ({
59
+ type: 'Column',
60
+ table: table.alias || table.name,
61
+ name
62
+ }));
63
+
64
+ /**
65
+ * Builds a table AST node for the provided table definition
66
+ * @param table - Table definition
67
+ */
68
+ export const createTableNode = (table: TableRef): TableNode => ({
69
+ type: 'Table',
70
+ name: table.name,
71
+ schema: (table as unknown as { schema?: string }).schema
72
+ });
73
+
74
+ /**
75
+ * Creates a FunctionTable node for expressions like `function_name(args...)` used in FROM
76
+ */
77
+ export const fnTable = (
78
+ name: string,
79
+ args: OperandNode[] = [],
80
+ alias?: string,
81
+ opts?: { lateral?: boolean; withOrdinality?: boolean; columnAliases?: string[]; schema?: string }
82
+ ): FunctionTableNode => ({
83
+ type: 'FunctionTable',
84
+ name,
85
+ args,
86
+ alias,
87
+ lateral: opts?.lateral,
88
+ withOrdinality: opts?.withOrdinality,
89
+ columnAliases: opts?.columnAliases,
90
+ schema: opts?.schema
91
+ });
92
+
93
+ /**
94
+ * Creates a derived table node wrapping a subquery.
95
+ */
96
+ export const derivedTable = (
97
+ query: import('./query.js').SelectQueryNode,
98
+ alias: string,
99
+ columnAliases?: string[]
100
+ ): DerivedTableNode => ({
101
+ type: 'DerivedTable',
102
+ query,
103
+ alias,
104
+ columnAliases
105
+ });