tina4-nodejs 3.9.4 → 3.10.2

package/CLAUDE.md

@@ -1,10 +1,10 @@
-# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.9.2)
+# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.2)
 
 > This file helps AI assistants (Claude, Copilot, Cursor, etc.) understand and work on this codebase effectively.
 
 ## What This Project Is
 
-Tina4 for Node.js/TypeScript v3.9.2 — a convention-over-configuration structural paradigm. **Not a framework.** The developer writes TypeScript; Tina4 is invisible infrastructure.
+Tina4 for Node.js/TypeScript v3.10.2 — a convention-over-configuration structural paradigm. **Not a framework.** The developer writes TypeScript; Tina4 is invisible infrastructure.
 
 The philosophy: zero ceremony, batteries included, file system as source of truth.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.9.4",
+  "version": "3.10.2",
   "type": "module",
   "description": "This is not a framework. Tina4 for Node.js/TypeScript — zero deps, 38 built-in features.",
   "keywords": ["tina4", "framework", "web", "api", "orm", "graphql", "websocket", "typescript"],

package/packages/core/src/server.ts

@@ -31,6 +31,9 @@ const BUILTIN_PUBLIC_DIR = resolve(__dirname, "..", "public");
 
 const TINA4_VERSION = "3.0.0";
 
+/** Cache Frond instances by template directory to avoid repeated instantiation. */
+const frondCache = new Map<string, InstanceType<any>>();
+
 /**
  * Test-bind each port in a subprocess to find one that is available.
  * Falls back to `start` if none of the candidates work.
@@ -94,18 +97,26 @@ async function renderErrorPage(
     const { Frond } = await import("@tina4/frond");
     const templateFile = `errors/${code}.twig`;
 
+    // Helper: get-or-create a cached Frond instance for a directory
+    const getCachedFrond = (dir: string) => {
+      let instance = frondCache.get(dir);
+      if (!instance) {
+        instance = new Frond(dir);
+        frondCache.set(dir, instance);
+      }
+      return instance;
+    };
+
     // 1. Try user override in the project's templates directory
     const userTemplatePath = join(templatesDir, templateFile);
     if (existsSync(userTemplatePath)) {
-      const frond = new Frond(templatesDir);
-      return frond.render(templateFile, data);
+      return getCachedFrond(templatesDir).render(templateFile, data);
     }
 
     // 2. Try built-in framework default
     const builtinTemplatePath = join(BUILTIN_ERROR_TEMPLATES_DIR, templateFile);
     if (existsSync(builtinTemplatePath)) {
-      const frond = new Frond(BUILTIN_ERROR_TEMPLATES_DIR);
-      return frond.render(templateFile, data);
+      return getCachedFrond(BUILTIN_ERROR_TEMPLATES_DIR).render(templateFile, data);
     }
 
     // 3. No template found

package/packages/frond/src/engine.ts

@@ -135,13 +135,67 @@ function resolveVar(expr: string, context: Record<string, unknown>): unknown {
     return items.map(item => evalExpr(item.trim(), context));
   }
 
-  // Dotted path with bracket access
-  const parts = expr.split(/\.|\[([^\]]+)\]/g).filter(p => p !== undefined && p !== "");
+  // Dotted path with bracket access — split on . and [...] but not . inside parentheses
+  const parts: string[] = [];
+  {
+    let current = "";
+    let depth = 0;
+    let inQuote: string | null = null;
+    for (let i = 0; i < expr.length; i++) {
+      const ch = expr[i];
+      if (inQuote) {
+        current += ch;
+        if (ch === inQuote) inQuote = null;
+        continue;
+      }
+      if (ch === '"' || ch === "'") { inQuote = ch; current += ch; continue; }
+      if (ch === '(') { depth++; current += ch; continue; }
+      if (ch === ')') { depth--; current += ch; continue; }
+      if (ch === '.' && depth === 0) {
+        if (current) parts.push(current);
+        current = "";
+        continue;
+      }
+      if (ch === '[' && depth === 0) {
+        if (current) parts.push(current);
+        current = "";
+        const end = expr.indexOf(']', i + 1);
+        if (end !== -1) {
+          parts.push(expr.slice(i + 1, end));
+          i = end;
+        }
+        continue;
+      }
+      current += ch;
+    }
+    if (current) parts.push(current);
+  }
 
   let value: unknown = context;
   for (const part of parts) {
     if (value === null || value === undefined) return null;
 
+    // Check for method call: name(args)
+    const methodMatch = part.match(/^(\w+)\s*\(([\s\S]*)?\)$/);
+    if (methodMatch) {
+      const methodName = methodMatch[1];
+      const rawArgs = methodMatch[2] || "";
+      if (typeof value === "object" && value !== null && methodName in (value as Record<string, unknown>)) {
+        const fn = (value as Record<string, unknown>)[methodName];
+        if (typeof fn === "function") {
+          if (rawArgs.trim()) {
+            const argParts = splitArgs(rawArgs);
+            const evalArgs = argParts.map(a => evalExpr(a.trim(), context));
+            value = fn.apply(value, evalArgs);
+          } else {
+            value = fn.call(value);
+          }
+          continue;
+        }
+      }
+      return null;
+    }
+
     let key: string | number = part.replace(/^['"]|['"]$/g, "");
     const asNum = parseInt(key, 10);
     if (!isNaN(asNum) && String(asNum) === key) {

package/packages/orm/src/baseModel.ts

@@ -3,6 +3,20 @@ import { validate as validateFields } from "./validation.js";
 import { QueryBuilder } from "./queryBuilder.js";
 import type { DatabaseAdapter, FieldDefinition, RelationshipDefinition } from "./types.js";
 
+/**
+ * Convert a snake_case name to camelCase.
+ */
+export function snakeToCamel(name: string): string {
+  return name.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+}
+
+/**
+ * Convert a camelCase name to snake_case.
+ */
+export function camelToSnake(name: string): string {
+  return name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+}
+
 /**
  * BaseModel provides instance methods for ORM models.
  * Models extend this class and define static properties.
@@ -17,6 +31,7 @@ import type { DatabaseAdapter, FieldDefinition, RelationshipDefinition } from ".
  *     static hasMany = [{ model: "Post", foreignKey: "author_id" }];
  *     static _db = "secondary";
  *     static fieldMapping = { firstName: "first_name", lastName: "last_name" };
+ *     static autoMap = true; // auto-generate fieldMapping from camelCase → snake_case
  *   }
  */
 export class BaseModel {
@@ -29,6 +44,12 @@ export class BaseModel {
   static belongsTo?: RelationshipDefinition[];
   static _db?: string;
 
+  /**
+   * When true, auto-generates fieldMapping entries from camelCase field names
+   * to snake_case DB column names. Explicit fieldMapping entries always win.
+   */
+  static autoMap: boolean = false;
+
   /**
    * Maps JS property names to database column names.
    * Example: { firstName: "first_name" } means the JS property `firstName`
@@ -46,6 +67,18 @@ export class BaseModel {
   constructor(data?: Record<string, unknown>) {
     if (data) {
       const ModelClass = this.constructor as typeof BaseModel;
+      // If autoMap is on, auto-generate fieldMapping from camelCase fields
+      if (ModelClass.autoMap) {
+        const fields = ModelClass.fields || {};
+        for (const key of Object.keys(fields)) {
+          if (!ModelClass.fieldMapping[key]) {
+            const snaked = camelToSnake(key);
+            if (snaked !== key) {
+              ModelClass.fieldMapping[key] = snaked;
+            }
+          }
+        }
+      }
       const reverseMapping = ModelClass.getReverseMapping();
       for (const [key, value] of Object.entries(data)) {
         // If this DB column has a mapping, use the JS property name instead

package/packages/orm/src/index.ts

@@ -38,7 +38,7 @@ export { generateCrudRoutes } from "./autoCrud.js";
 export { buildQuery, parseQueryString } from "./query.js";
 export { validate } from "./validation.js";
 export type { ValidationError } from "./validation.js";
-export { BaseModel } from "./baseModel.js";
+export { BaseModel, snakeToCamel, camelToSnake } from "./baseModel.js";
 export { QueryBuilder } from "./queryBuilder.js";
 export { SQLTranslator, QueryCache } from "./sqlTranslation.js";
 export { CachedDatabaseAdapter } from "./cachedDatabase.js";