metal-orm 1.1.9 → 1.1.11

package/src/index.ts

@@ -9,13 +9,13 @@ export * from './schema/types.js';
 export * from './query-builder/select.js';
 export * from './query-builder/select-helpers.js';
 export * from './query-builder/insert.js';
-export * from './query-builder/update.js';
-export * from './query-builder/delete.js';
-export * from './query-builder/procedure-call.js';
-export * from './query/index.js';
-export * from './core/ast/expression.js';
-export * from './core/ast/procedure.js';
-export * from './core/ast/window-functions.js';
+export * from './query-builder/update.js';
+export * from './query-builder/delete.js';
+export * from './query-builder/procedure-call.js';
+export * from './query/index.js';
+export * from './core/ast/expression.js';
+export * from './core/ast/procedure.js';
+export * from './core/ast/window-functions.js';
 export * from './core/hydration/types.js';
 export * from './core/dialect/mysql/index.js';
 export * from './core/dialect/mssql/index.js';
@@ -43,8 +43,11 @@ export * from './orm/lazy-batch.js';
 export * from './orm/relations/has-many.js';
 export * from './orm/relations/belongs-to.js';
 export * from './orm/relations/many-to-many.js';
-export * from './orm/execute.js';
-export * from './orm/execute-procedure.js';
+export * from './orm/relations/morph-one.js';
+export * from './orm/relations/morph-many.js';
+export * from './orm/relations/morph-to.js';
+export * from './orm/execute.js';
+export * from './orm/execute-procedure.js';
 export type { EntityContext } from './orm/entity-context.js';
 export type { PrimaryKey as EntityPrimaryKey } from './orm/entity-context.js';
 export * from './orm/execution-context.js';
@@ -64,6 +67,7 @@ export * from './core/execution/pooling/pool.js';
 export * from './core/execution/executors/postgres-executor.js';
 export * from './core/execution/executors/mysql-executor.js';
 export * from './core/execution/executors/sqlite-executor.js';
+export * from './core/execution/executors/better-sqlite3-executor.js';
 export * from './core/execution/executors/mssql-executor.js';
 
 // NEW: first-class pooling integration
@@ -77,3 +81,6 @@ export * from './tree/index.js';
 
 // Cache module
 export * from './cache/index.js';
+
+// Bulk operations module
+export * from './bulk/index.js';

package/src/orm/entity-hydration.ts

@@ -1,72 +1,116 @@
-import { TableDef } from '../schema/table.js';
-import { RelationKinds } from '../schema/relation.js';
-import { findPrimaryKey } from '../query-builder/hydration-planner.js';
-import { EntityMeta } from './entity-meta.js';
-
-/**
- * Type representing an array of database rows.
- */
-type Rows = Record<string, unknown>[];
-
-/**
- * Converts a value to a string key.
- * @param value - The value to convert
- * @returns String representation of the value
- */
-const toKey = (value: unknown): string => (value === null || value === undefined ? '' : String(value));
-
-/**
- * Populates the hydration cache with relation data from the database row.
- * @template TTable - The table type
- * @param entity - The entity instance
- * @param row - The database row
- * @param meta - The entity metadata
- */
-export const populateHydrationCache = <TTable extends TableDef>(
-  entity: Record<string, unknown>,
-  row: Record<string, unknown>,
-  meta: EntityMeta<TTable>
-): void => {
-  for (const relationName of Object.keys(meta.table.relations)) {
-    const relation = meta.table.relations[relationName];
-    const data = row[relationName];
-    if (relation.type === RelationKinds.HasOne) {
-      const localKey = relation.localKey || findPrimaryKey(meta.table);
-      const rootValue = entity[localKey];
-      if (rootValue === undefined || rootValue === null) continue;
-      if (!data || typeof data !== 'object') continue;
-      const cache = new Map<string, Record<string, unknown>>();
-      cache.set(toKey(rootValue), data as Record<string, unknown>);
-      meta.relationHydration.set(relationName, cache);
-      meta.relationCache.set(relationName, Promise.resolve(cache));
-      continue;
-    }
-
-    if (!Array.isArray(data)) continue;
-
-    if (relation.type === RelationKinds.HasMany || relation.type === RelationKinds.BelongsToMany) {
-      const localKey = relation.localKey || findPrimaryKey(meta.table);
-      const rootValue = entity[localKey];
-      if (rootValue === undefined || rootValue === null) continue;
-      const cache = new Map<string, Rows>();
-      cache.set(toKey(rootValue), data as Rows);
-      meta.relationHydration.set(relationName, cache);
-      meta.relationCache.set(relationName, Promise.resolve(cache));
-      continue;
-    }
-
-    if (relation.type === RelationKinds.BelongsTo) {
-      const targetKey = relation.localKey || findPrimaryKey(relation.target);
-      const cache = new Map<string, Record<string, unknown>>();
-      for (const item of data) {
-        const pkValue = item[targetKey];
-        if (pkValue === undefined || pkValue === null) continue;
-        cache.set(toKey(pkValue), item);
-      }
-      if (cache.size) {
-        meta.relationHydration.set(relationName, cache);
-        meta.relationCache.set(relationName, Promise.resolve(cache));
-      }
-    }
-  }
-};
+import { TableDef } from '../schema/table.js';
+import { RelationKinds, MorphToRelation } from '../schema/relation.js';
+import { findPrimaryKey } from '../query-builder/hydration-planner.js';
+import { EntityMeta } from './entity-meta.js';
+
+/**
+ * Type representing an array of database rows.
+ */
+type Rows = Record<string, unknown>[];
+
+/**
+ * Converts a value to a string key.
+ * @param value - The value to convert
+ * @returns String representation of the value
+ */
+const toKey = (value: unknown): string => (value === null || value === undefined ? '' : String(value));
+
+/**
+ * Populates the hydration cache with relation data from the database row.
+ * @template TTable - The table type
+ * @param entity - The entity instance
+ * @param row - The database row
+ * @param meta - The entity metadata
+ */
+export const populateHydrationCache = <TTable extends TableDef>(
+  entity: Record<string, unknown>,
+  row: Record<string, unknown>,
+  meta: EntityMeta<TTable>
+): void => {
+  for (const relationName of Object.keys(meta.table.relations)) {
+    const relation = meta.table.relations[relationName];
+    const data = row[relationName];
+    if (relation.type === RelationKinds.HasOne) {
+      const localKey = relation.localKey || findPrimaryKey(meta.table);
+      const rootValue = entity[localKey];
+      if (rootValue === undefined || rootValue === null) continue;
+      if (!data || typeof data !== 'object') continue;
+      const cache = new Map<string, Record<string, unknown>>();
+      cache.set(toKey(rootValue), data as Record<string, unknown>);
+      meta.relationHydration.set(relationName, cache);
+      meta.relationCache.set(relationName, Promise.resolve(cache));
+      continue;
+    }
+
+    if (!Array.isArray(data)) continue;
+
+    if (relation.type === RelationKinds.HasMany || relation.type === RelationKinds.BelongsToMany) {
+      const localKey = relation.localKey || findPrimaryKey(meta.table);
+      const rootValue = entity[localKey];
+      if (rootValue === undefined || rootValue === null) continue;
+      const cache = new Map<string, Rows>();
+      cache.set(toKey(rootValue), data as Rows);
+      meta.relationHydration.set(relationName, cache);
+      meta.relationCache.set(relationName, Promise.resolve(cache));
+      continue;
+    }
+
+    if (relation.type === RelationKinds.BelongsTo) {
+      const targetKey = relation.localKey || findPrimaryKey(relation.target);
+      const cache = new Map<string, Record<string, unknown>>();
+      for (const item of data) {
+        const pkValue = item[targetKey];
+        if (pkValue === undefined || pkValue === null) continue;
+        cache.set(toKey(pkValue), item);
+      }
+      if (cache.size) {
+        meta.relationHydration.set(relationName, cache);
+        meta.relationCache.set(relationName, Promise.resolve(cache));
+      }
+    }
+  }
+
+  // Second pass for morph relations (data may not be arrays)
+  for (const relationName of Object.keys(meta.table.relations)) {
+    const relation = meta.table.relations[relationName];
+    const data = row[relationName];
+
+    if (relation.type === RelationKinds.MorphOne) {
+      const localKey = relation.localKey || findPrimaryKey(meta.table);
+      const rootValue = entity[localKey];
+      if (rootValue === undefined || rootValue === null) continue;
+      if (!data || typeof data !== 'object') continue;
+      const cache = new Map<string, Record<string, unknown>>();
+      cache.set(toKey(rootValue), data as Record<string, unknown>);
+      meta.relationHydration.set(relationName, cache);
+      meta.relationCache.set(relationName, Promise.resolve(cache));
+      continue;
+    }
+
+    if (relation.type === RelationKinds.MorphMany) {
+      if (!Array.isArray(data)) continue;
+      const localKey = relation.localKey || findPrimaryKey(meta.table);
+      const rootValue = entity[localKey];
+      if (rootValue === undefined || rootValue === null) continue;
+      const cache = new Map<string, Rows>();
+      cache.set(toKey(rootValue), data as Rows);
+      meta.relationHydration.set(relationName, cache);
+      meta.relationCache.set(relationName, Promise.resolve(cache));
+      continue;
+    }
+
+    if (relation.type === RelationKinds.MorphTo) {
+      if (!data || typeof data !== 'object') continue;
+      const morphTo = relation as MorphToRelation;
+      const typeValue = entity[morphTo.typeField];
+      const idValue = entity[morphTo.idField];
+      if (!typeValue || idValue === undefined || idValue === null) continue;
+      const compositeKey = `${toKey(typeValue)}:${toKey(idValue)}`;
+      const cache = new Map<string, Record<string, unknown>>();
+      cache.set(compositeKey, data as Record<string, unknown>);
+      meta.relationHydration.set(relationName, cache);
+      meta.relationCache.set(relationName, Promise.resolve(cache));
+      continue;
+    }
+  }
+};