metal-orm 1.0.66 → 1.0.68

package/dist/index.cjs

@@ -658,10 +658,10 @@ var isWindowFunctionNode = (node) => isOperandNode(node) && node.type === "Windo
 var isExpressionSelectionNode = (node) => isFunctionNode(node) || isCaseExpressionNode(node) || isCastExpressionNode(node) || isWindowFunctionNode(node);
 
 // src/core/ast/expression-builders.ts
-var isLiteralValue = (value) => value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+var isLiteralValue = (value) => value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean" || value instanceof Date;
 var toLiteralNode = (value) => ({
   type: "Literal",
-  value
+  value: value instanceof Date ? value.toISOString() : value
 });
 var columnRefToNode = (col2) => {
   if (!col2.table) {
@@ -11724,14 +11724,28 @@ var runInTransaction = async (executor, action) => {
 // src/orm/save-graph.ts
 var toKey8 = (value) => value === null || value === void 0 ? "" : String(value);
 var coerceColumnValue = (table, columnName, value, options) => {
-  if (options.coerce !== "json") return value;
   if (value === null || value === void 0) return value;
   const column = table.columns[columnName];
   if (!column) return value;
   const normalized = normalizeColumnType(column.type);
   const isDateLikeColumn = normalized === "date" || normalized === "datetime" || normalized === "timestamp" || normalized === "timestamptz";
-  if (isDateLikeColumn && value instanceof Date) {
-    return value.toISOString();
+  if (!isDateLikeColumn) return value;
+  if (options.coerce === "json") {
+    if (value instanceof Date) {
+      return value.toISOString();
+    }
+    return value;
+  }
+  if (options.coerce === "json-in") {
+    if (value instanceof Date) return value;
+    if (typeof value === "string" || typeof value === "number") {
+      const date = new Date(value);
+      if (Number.isNaN(date.getTime())) {
+        throw new Error(`Invalid date value for column "${columnName}"`);
+      }
+      return date;
+    }
+    return value;
   }
   return value;
 };
@@ -11928,6 +11942,7 @@ var OrmSession = class {
   /** The relation change processor */
   relationChanges;
   interceptors;
+  saveGraphDefaults;
   /**
    * Creates a new OrmSession instance.
    * @param opts - Session options
@@ -12058,6 +12073,15 @@ var OrmSession = class {
   registerDomainEventHandler(type, handler) {
     this.domainEvents.on(type, handler);
   }
+  /**
+   * Sets default options applied to all saveGraph calls for this session.
+   * Per-call options override these defaults.
+   * @param defaults - Default saveGraph options for the session
+   */
+  withSaveGraphDefaults(defaults) {
+    this.saveGraphDefaults = { ...defaults };
+    return this;
+  }
   /**
    * Finds an entity by its primary key.
    * @template TCtor - The entity constructor type
@@ -12105,10 +12129,60 @@ var OrmSession = class {
     return executeHydrated(this, qb);
   }
   async saveGraph(entityClass, payload, options) {
-    const { transactional = true, ...graphOptions } = options ?? {};
+    const resolved = this.resolveSaveGraphOptions(options);
+    const { transactional = true, flush = false, ...graphOptions } = resolved;
     const execute = () => saveGraphInternal(this, entityClass, payload, graphOptions);
     if (!transactional) {
-      return execute();
+      const result = await execute();
+      if (flush) {
+        await this.flush();
+      }
+      return result;
+    }
+    return this.transaction(() => execute());
+  }
+  /**
+   * Saves an entity graph and flushes immediately (defaults to transactional: false).
+   * @param entityClass - Root entity constructor
+   * @param payload - DTO payload containing column values and nested relations
+   * @param options - Graph save options
+   * @returns The root entity instance
+   */
+  async saveGraphAndFlush(entityClass, payload, options) {
+    const merged = { ...options ?? {}, flush: true, transactional: options?.transactional ?? false };
+    return this.saveGraph(entityClass, payload, merged);
+  }
+  /**
+   * Updates an existing entity graph (requires a primary key in the payload).
+   * @param entityClass - Root entity constructor
+   * @param payload - DTO payload containing column values and nested relations
+   * @param options - Graph save options
+   * @returns The root entity instance or null if not found
+   */
+  async updateGraph(entityClass, payload, options) {
+    const table = getTableDefFromEntity(entityClass);
+    if (!table) {
+      throw new Error("Entity metadata has not been bootstrapped");
+    }
+    const primaryKey = findPrimaryKey(table);
+    const pkValue = payload[primaryKey];
+    if (pkValue === void 0 || pkValue === null) {
+      throw new Error(`updateGraph requires a primary key value for "${primaryKey}"`);
+    }
+    const resolved = this.resolveSaveGraphOptions(options);
+    const { transactional = true, flush = false, ...graphOptions } = resolved;
+    const execute = async () => {
+      const tracked = this.getEntity(table, pkValue);
+      const existing = tracked ?? await this.find(entityClass, pkValue);
+      if (!existing) return null;
+      return saveGraphInternal(this, entityClass, payload, graphOptions);
+    };
+    if (!transactional) {
+      const result = await execute();
+      if (result && flush) {
+        await this.flush();
+      }
+      return result;
     }
     return this.transaction(() => execute());
   }
@@ -12228,6 +12302,14 @@ var OrmSession = class {
       entityContext: this
     };
   }
+  /**
+   * Merges session defaults with per-call saveGraph options.
+   * @param options - Per-call saveGraph options
+   * @returns Combined options with per-call values taking precedence
+   */
+  resolveSaveGraphOptions(options) {
+    return { ...this.saveGraphDefaults ?? {}, ...options ?? {} };
+  }
 };
 var buildRelationChangeEntry = (root, relationKey, rootTable, relationName, relation, change) => ({
   root,