metal-orm 1.0.51 → 1.0.52

package/README.md

@@ -74,20 +74,21 @@ MetalORM is a TypeScript-first, AST-driven SQL toolkit you can dial up or down d
 <a id="documentation"></a>
 ## Documentation 📚
 
-Full docs live in the `docs/` folder:
-
-- [Introduction](https://github.com/celsowm/metal-orm/blob/main/docs/index.md)
-- [Getting Started](https://github.com/celsowm/metal-orm/blob/main/docs/getting-started.md)
-- [Level 3 Backend Tutorial](https://github.com/celsowm/metal-orm/blob/main/docs/level-3-backend-tutorial.md)
-- [Schema Definition](https://github.com/celsowm/metal-orm/blob/main/docs/schema-definition.md)
-- [Query Builder](https://github.com/celsowm/metal-orm/blob/main/docs/query-builder.md)
-- [DML Operations](https://github.com/celsowm/metal-orm/blob/main/docs/dml-operations.md)
-- [Hydration & Entities](https://github.com/celsowm/metal-orm/blob/main/docs/hydration.md)
-- [Runtime & Unit of Work](https://github.com/celsowm/metal-orm/blob/main/docs/runtime.md)
-- [Advanced Features](https://github.com/celsowm/metal-orm/blob/main/docs/advanced-features.md)
-- [Multi-Dialect Support](https://github.com/celsowm/metal-orm/blob/main/docs/multi-dialect-support.md)
-- [Schema Generation (DDL)](https://github.com/celsowm/metal-orm/blob/main/docs/schema-generation.md)
-- [API Reference](https://github.com/celsowm/metal-orm/blob/main/docs/api-reference.md)
+Full docs live in the `docs/` folder:
+
+- [Introduction](https://github.com/celsowm/metal-orm/blob/main/docs/index.md)
+- [Getting Started](https://github.com/celsowm/metal-orm/blob/main/docs/getting-started.md)
+- [Level 3 Backend Tutorial](https://github.com/celsowm/metal-orm/blob/main/docs/level-3-backend-tutorial.md)
+- [Schema Definition](https://github.com/celsowm/metal-orm/blob/main/docs/schema-definition.md)
+- [Query Builder](https://github.com/celsowm/metal-orm/blob/main/docs/query-builder.md)
+- [DML Operations](https://github.com/celsowm/metal-orm/blob/main/docs/dml-operations.md)
+- [Hydration & Entities](https://github.com/celsowm/metal-orm/blob/main/docs/hydration.md)
+- [Runtime & Unit of Work](https://github.com/celsowm/metal-orm/blob/main/docs/runtime.md)
+- [Save Graph](https://github.com/celsowm/metal-orm/blob/main/docs/save-graph.md)
+- [Advanced Features](https://github.com/celsowm/metal-orm/blob/main/docs/advanced-features.md)
+- [Multi-Dialect Support](https://github.com/celsowm/metal-orm/blob/main/docs/multi-dialect-support.md)
+- [Schema Generation (DDL)](https://github.com/celsowm/metal-orm/blob/main/docs/schema-generation.md)
+- [API Reference](https://github.com/celsowm/metal-orm/blob/main/docs/api-reference.md)
 - [DB ➜ TS Type Mapping](https://github.com/celsowm/metal-orm/blob/main/docs/db-to-ts-types.md)
 
 ---

package/dist/index.cjs

@@ -163,6 +163,7 @@ __export(index_exports, {
   isValueOperandInput: () => isValueOperandInput,
   isWindowFunctionNode: () => isWindowFunctionNode,
   jsonPath: () => jsonPath,
+  jsonify: () => jsonify,
   lag: () => lag,
   lastValue: () => lastValue,
   lead: () => lead,
@@ -9521,18 +9522,30 @@ var runInTransaction = async (executor, action) => {
 
 // src/orm/save-graph.ts
 var toKey8 = (value) => value === null || value === void 0 ? "" : String(value);
-var pickColumns = (table, payload) => {
+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();
+  }
+  return value;
+};
+var pickColumns = (table, payload, options) => {
   const columns = {};
   for (const key of Object.keys(table.columns)) {
     if (payload[key] !== void 0) {
-      columns[key] = payload[key];
+      columns[key] = coerceColumnValue(table, key, payload[key], options);
     }
   }
   return columns;
 };
-var ensureEntity = (session, table, payload) => {
+var ensureEntity = (session, table, payload, options) => {
   const pk = findPrimaryKey(table);
-  const row = pickColumns(table, payload);
+  const row = pickColumns(table, payload, options);
   const pkValue = payload[pk];
   if (pkValue !== void 0 && pkValue !== null) {
     const tracked = session.getEntity(table, pkValue);
@@ -9545,10 +9558,10 @@ var ensureEntity = (session, table, payload) => {
   }
   return createEntityFromRow(session, table, row);
 };
-var assignColumns = (table, entity, payload) => {
+var assignColumns = (table, entity, payload, options) => {
   for (const key of Object.keys(table.columns)) {
     if (payload[key] !== void 0) {
-      entity[key] = payload[key];
+      entity[key] = coerceColumnValue(table, key, payload[key], options);
     }
   }
 };
@@ -9575,8 +9588,8 @@ var handleHasMany = async (session, root, relationName, relation, payload, optio
     const asObj = typeof item === "object" ? item : { [targetPk]: item };
     const pkValue = asObj[targetPk];
     const current = findInCollectionByPk(existing, targetPk, pkValue) ?? (pkValue !== void 0 && pkValue !== null ? session.getEntity(targetTable, pkValue) : void 0);
-    const entity = current ?? ensureEntity(session, targetTable, asObj);
-    assignColumns(targetTable, entity, asObj);
+    const entity = current ?? ensureEntity(session, targetTable, asObj, options);
+    assignColumns(targetTable, entity, asObj, options);
     await applyGraphToEntity(session, targetTable, entity, asObj, options);
     if (!isEntityInCollection(collection.getItems(), targetPk, entity)) {
       collection.attach(entity);
@@ -9651,8 +9664,8 @@ var handleBelongsToMany = async (session, root, relationName, relation, payload,
     }
     const asObj = item;
     const pkValue = asObj[targetPk];
-    const entity = pkValue !== void 0 && pkValue !== null ? session.getEntity(targetTable, pkValue) ?? ensureEntity(session, targetTable, asObj) : ensureEntity(session, targetTable, asObj);
-    assignColumns(targetTable, entity, asObj);
+    const entity = pkValue !== void 0 && pkValue !== null ? session.getEntity(targetTable, pkValue) ?? ensureEntity(session, targetTable, asObj, options) : ensureEntity(session, targetTable, asObj, options);
+    assignColumns(targetTable, entity, asObj, options);
     await applyGraphToEntity(session, targetTable, entity, asObj, options);
     if (!isEntityInCollection(collection.getItems(), targetPk, entity)) {
       collection.attach(entity);
@@ -9683,7 +9696,7 @@ var applyRelation = async (session, table, entity, relationName, relation, paylo
   }
 };
 var applyGraphToEntity = async (session, table, entity, payload, options) => {
-  assignColumns(table, entity, payload);
+  assignColumns(table, entity, payload, options);
   for (const [relationName, relation] of Object.entries(table.relations)) {
     if (!(relationName in payload)) continue;
     await applyRelation(session, table, entity, relationName, relation, payload[relationName], options);
@@ -9694,7 +9707,7 @@ var saveGraphInternal = async (session, entityClass, payload, options = {}) => {
   if (!table) {
     throw new Error("Entity metadata has not been bootstrapped");
   }
-  const root = ensureEntity(session, table, payload);
+  const root = ensureEntity(session, table, payload, options);
   await applyGraphToEntity(session, table, root, payload, options);
   return root;
 };
@@ -9877,13 +9890,6 @@ var OrmSession = class {
   async findMany(qb) {
     return executeHydrated(this, qb);
   }
-  /**
-   * Saves an entity graph (root + nested relations) based on a DTO-like 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
-   */
   async saveGraph(entityClass, payload, options) {
     const { transactional = true, ...graphOptions } = options ?? {};
     const execute = () => saveGraphInternal(this, entityClass, payload, graphOptions);
@@ -10084,6 +10090,17 @@ var Orm = class {
   }
 };
 
+// src/orm/jsonify.ts
+var jsonify = (value) => {
+  const record = value;
+  const result = {};
+  for (const key of Object.keys(record)) {
+    const entry = record[key];
+    result[key] = entry instanceof Date ? entry.toISOString() : entry;
+  }
+  return result;
+};
+
 // src/decorators/decorator-metadata.ts
 var METADATA_KEY = "metal-orm:decorators";
 var isStandardDecoratorContext = (value) => {
@@ -10968,6 +10985,7 @@ function createPooledExecutorFactory(opts) {
   isValueOperandInput,
   isWindowFunctionNode,
   jsonPath,
+  jsonify,
   lag,
   lastValue,
   lead,