@aruvili/api 0.1.0

package/src/utils/resolver.js

@@ -0,0 +1,58 @@
+import { registry } from '../registry.js';
+import { getTableName } from '@meta/core';
+import { query } from '../db.js';
+/**
+ * Resolves all Link fields for a list of document records in a single batch, preventing N+1 queries.
+ */
+export async function resolveLinkFields(doctypeName, records) {
+    if (records.length === 0)
+        return records;
+    const definition = await registry.get(doctypeName);
+    if (!definition)
+        return records;
+    // Identify fields of type Link
+    const linkFields = definition.fields.filter(f => f.fieldtype === 'Link' && f.options);
+    if (linkFields.length === 0)
+        return records;
+    // Deep clone to prevent mutating original parameters
+    const resolved = JSON.parse(JSON.stringify(records));
+    for (const field of linkFields) {
+        const targetDocType = field.options;
+        const fieldname = field.fieldname;
+        // Collect all unique referenced names
+        const ids = Array.from(new Set(resolved.map((r) => r[fieldname]).filter((v) => typeof v === 'string' && v.trim() !== '')));
+        if (ids.length === 0)
+            continue;
+        // Retrieve target configuration to locate its title field
+        const targetDef = await registry.get(targetDocType);
+        const titleField = targetDef?.title_field || 'name';
+        const targetTable = getTableName(targetDocType);
+        try {
+            // Fetch key and title mappings in a single batch query
+            const sql = `SELECT name, ${titleField} AS title FROM ${targetTable} WHERE name = ANY($1)`;
+            const res = await query(sql, [ids]);
+            const map = new Map();
+            for (const row of res.rows) {
+                map.set(row.name, {
+                    name: row.name,
+                    title_field_value: String(row.title)
+                });
+            }
+            // Merge results
+            for (const record of resolved) {
+                const val = record[fieldname];
+                if (val && map.has(val)) {
+                    record[fieldname] = map.get(val);
+                }
+                else if (val) {
+                    record[fieldname] = { name: val, title_field_value: val };
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Failed to resolve link field '${fieldname}' pointing to '${targetDocType}':`, err);
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=resolver.js.map

package/src/utils/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["resolver.ts"],"names":[],"mappings":"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"}

package/src/utils/resolver.ts

@@ -0,0 +1,65 @@
+import { registry } from '../registry.js';
+import { getTableName } from '@aruvili/core';
+import { query } from '../db.js';
+
+/**
+ * Resolves all Link fields for a list of document records in a single batch, preventing N+1 queries.
+ */
+export async function resolveLinkFields(doctypeName: string, records: any[]): Promise<any[]> {
+  if (records.length === 0) return records;
+
+  const definition = await registry.get(doctypeName);
+  if (!definition) return records;
+
+  // Identify fields of type Link
+  const linkFields = definition.fields.filter(f => f.fieldtype === 'Link' && f.options);
+  if (linkFields.length === 0) return records;
+
+  // Deep clone to prevent mutating original parameters
+  const resolved = JSON.parse(JSON.stringify(records));
+
+  for (const field of linkFields) {
+    const targetDocType = field.options!;
+    const fieldname = field.fieldname;
+
+    // Collect all unique referenced names
+    const ids = Array.from(
+      new Set(resolved.map((r: any) => r[fieldname]).filter((v: any) => typeof v === 'string' && v.trim() !== ''))
+    );
+
+    if (ids.length === 0) continue;
+
+    // Retrieve target configuration to locate its title field
+    const targetDef = await registry.get(targetDocType);
+    const titleField = targetDef?.title_field || 'name';
+    const targetTable = getTableName(targetDocType);
+
+    try {
+      // Fetch key and title mappings in a single batch query
+      const sql = `SELECT name, ${titleField} AS title FROM ${targetTable} WHERE name = ANY($1)`;
+      const res = await query(sql, [ids]);
+
+      const map = new Map<string, { name: string; title_field_value: string }>();
+      for (const row of res.rows) {
+        map.set(row.name, {
+          name: row.name,
+          title_field_value: String(row.title)
+        });
+      }
+
+      // Merge results
+      for (const record of resolved) {
+        const val = record[fieldname];
+        if (val && map.has(val)) {
+          record[fieldname] = map.get(val);
+        } else if (val) {
+          record[fieldname] = { name: val, title_field_value: val };
+        }
+      }
+    } catch (err) {
+      console.error(`Failed to resolve link field '${fieldname}' pointing to '${targetDocType}':`, err);
+    }
+  }
+
+  return resolved;
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "rootDir": "./src",
+    "outDir": "./dist"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["src/**/*.test.ts"]
+}