tina4-nodejs 3.9.4 → 3.10.1

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.1)
 
 > 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.1 — 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.1",
   "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/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";