@platformatic/sql-mapper 3.62.2 → 3.62.3

package/index.d.ts

@@ -59,6 +59,11 @@ export interface DBEntityField {
    * An option that is true if field is a foreignKey key.
    */
   foreignKey?: boolean,
+  /**
+   * An option that is true if a foreign key field is stringified in mapper output
+   * because it references a primary key.
+   */
+  stringifyOutput?: boolean,
   /**
    * An option that is true if field is nullable.
    */

package/index.js

@@ -80,6 +80,29 @@ const defaultAutoTimestampFields = {
   updatedAt: 'updated_at'
 }
 
+function physicalEntityKey (schema, table) {
+  return `${schema ?? ''}\0${table}`
+}
+
+function markForeignKeysReferencingPrimaryKeys (entities) {
+  const entitiesByTable = new Map()
+
+  for (const entity of Object.values(entities)) {
+    entitiesByTable.set(physicalEntityKey(entity.schema, entity.table), entity)
+  }
+
+  for (const entity of Object.values(entities)) {
+    for (const relation of entity.relations) {
+      const foreignSchema = relation.foreign_table_schema ?? entity.schema
+      const foreignEntity = entitiesByTable.get(physicalEntityKey(foreignSchema, relation.foreign_table_name))
+
+      if (foreignEntity?.primaryKeys.has(relation.foreign_column_name)) {
+        entity.fields[relation.column_name].stringifyOutput = true
+      }
+    }
+  }
+}
+
 async function registerPostgreSQLExtensionTypes (db) {
   try {
     await db.registerTypeParser('vector', parseVector)
@@ -375,6 +398,8 @@ export async function connect ({
       }
     }
 
+    markForeignKeysReferencingPrimaryKeys(entities)
+
     const res = {
       db,
       sql,

package/lib/entity.js

@@ -104,8 +104,13 @@ function createMapper (
       let value = output[key]
       const newKey = fieldMapToRetrieve[key]
       // Do not convert Date objects: they are serialized according to the
-      // schema of the field, like non primary key columns
-      if (primaryKeys.has(key) && value !== null && value !== undefined && !(value instanceof Date)) {
+      // schema of the field, like other non-stringified columns
+      if (
+        (primaryKeys.has(key) || fields[key]?.stringifyOutput) &&
+        value !== null &&
+        value !== undefined &&
+        !(value instanceof Date)
+      ) {
         value = value.toString()
       }
       if (newKey && isVectorType(fields[key].sqlType)) {

package/lib/queries/pg.js

@@ -80,16 +80,27 @@ export async function listColumns (db, sql, table, schema) {
 
 export async function listConstraints (db, sql, table, schema) {
   const query = sql`
-    SELECT constraints.*, usage.*, usage2.table_name AS foreign_table_name, usage2.column_name AS foreign_column_name, usage2.table_schema AS foreign_table_schema
+    SELECT constraints.*, usage.*, foreign_usage.table_name AS foreign_table_name,
+      foreign_usage.column_name AS foreign_column_name, foreign_usage.table_schema AS foreign_table_schema
     FROM information_schema.table_constraints constraints
       JOIN information_schema.key_column_usage usage
-        ON constraints.constraint_name = usage.constraint_name
-        AND constraints.table_name = ${table}
-      JOIN information_schema.constraint_column_usage usage2
-        ON usage.constraint_name = usage2.constraint_name
-        AND ( usage.table_name = ${table}
-        AND usage.table_schema = ${schema} )
-    ORDER BY usage.constraint_name, usage.ordinal_position, usage2.table_name, usage2.column_name
+        ON constraints.constraint_catalog = usage.constraint_catalog
+        AND constraints.constraint_schema = usage.constraint_schema
+        AND constraints.constraint_name = usage.constraint_name
+        AND constraints.table_schema = usage.table_schema
+        AND constraints.table_name = usage.table_name
+      LEFT JOIN information_schema.referential_constraints referential
+        ON constraints.constraint_catalog = referential.constraint_catalog
+        AND constraints.constraint_schema = referential.constraint_schema
+        AND constraints.constraint_name = referential.constraint_name
+      LEFT JOIN information_schema.key_column_usage foreign_usage
+        ON referential.unique_constraint_catalog = foreign_usage.constraint_catalog
+        AND referential.unique_constraint_schema = foreign_usage.constraint_schema
+        AND referential.unique_constraint_name = foreign_usage.constraint_name
+        AND usage.position_in_unique_constraint = foreign_usage.ordinal_position
+    WHERE constraints.table_name = ${table}
+      AND constraints.table_schema = ${schema}
+    ORDER BY usage.constraint_name, usage.ordinal_position
   `
   const constraintsList = await db.query(query)
   return constraintsList

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platformatic/sql-mapper",
-  "version": "3.62.2",
+  "version": "3.62.3",
   "description": "A data mapper utility for SQL databases",
   "main": "index.js",
   "type": "module",
@@ -19,7 +19,7 @@
     "@opentelemetry/api": "^1.9.0",
     "cleaner-spec-reporter": "^0.5.0",
     "eslint": "9",
-    "fastify": "^5.7.0",
+    "fastify": "^5.0.0",
     "neostandard": "^0.12.0",
     "tstyche": "^6.2.0",
     "typescript": "^5.9.3"
@@ -33,10 +33,10 @@
     "@matteo.collina/sqlite-pool": "^0.7.0",
     "async-cache-dedupe": "^2.1.0",
     "camelcase": "^6.3.0",
-    "fastify-plugin": "^5.0.0",
+    "fastify-plugin": "^6.0.0",
     "inflected": "^2.1.0",
-    "@platformatic/telemetry": "3.62.2",
-    "@platformatic/foundation": "3.62.2"
+    "@platformatic/telemetry": "3.62.3",
+    "@platformatic/foundation": "3.62.3"
   },
   "engines": {
     "node": ">=22.19.0"