tina4-nodejs 3.10.98 → 3.11.1

package/CLAUDE.md

@@ -1,4 +1,4 @@
-# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.97)
+# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.11.0)
 
 > This file helps AI assistants (Claude, Copilot, Cursor, etc.) understand and work on this codebase effectively.
 

package/package.json

@@ -1,6 +1,10 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.10.98",
+
+
+
+  "version": "3.11.1",
+
   "type": "module",
   "description": "Tina4 for Node.js/TypeScript — 54 built-in features, zero dependencies",
   "keywords": ["tina4", "framework", "web", "api", "orm", "graphql", "websocket", "typescript"],

package/packages/core/src/scss.ts

@@ -48,7 +48,7 @@ export class ScssCompiler {
   }
 
   /** Compile all .scss files in a directory into a single CSS output file. */
-  compileScss(scssDir: string = "src/scss", output: string = "public/css/default.css", minify: boolean = false): string {
+  compileScss(scssDir: string = "src/scss", output: string = "src/public/css/default.css", minify: boolean = false): string {
     const absDir = resolve(scssDir);
     if (!existsSync(absDir)) return "";
 
@@ -80,11 +80,19 @@ export class ScssCompiler {
       css = css.trim();
     }
 
-    // Write output
+    // Write output only if content changed (avoids triggering DevReload loops)
     const absOutput = resolve(output);
     const outDir = dirname(absOutput);
     if (!existsSync(outDir)) mkdirSync(outDir, { recursive: true });
-    writeFileSync(absOutput, css, "utf-8");
+    let existing: string | null = null;
+    try {
+      existing = existsSync(absOutput) ? readFileSync(absOutput, "utf-8") : null;
+    } catch {
+      existing = null;
+    }
+    if (existing !== css) {
+      writeFileSync(absOutput, css, "utf-8");
+    }
 
     return css;
   }

package/packages/frond/src/engine.ts

@@ -1085,7 +1085,20 @@ const BUILTIN_FILTERS: Record<string, FilterFn> = {
   last: (v) => Array.isArray(v) ? v[v.length - 1] ?? null : null,
   join: (v, sep) => Array.isArray(v) ? v.map(String).join(sep !== undefined ? String(sep) : ", ") : String(v),
   split: (v, sep) => String(v).split(sep !== undefined ? String(sep) : " "),
-  replace: (v, from, to) => from !== undefined && to !== undefined ? String(v).split(String(from)).join(String(to)) : String(v),
+  replace: (v: unknown, from?: unknown, to?: unknown) => {
+    const s = String(v);
+    if (from !== undefined && typeof from === 'object' && from !== null && !Array.isArray(from)) {
+      let result = s;
+      for (const [old, newVal] of Object.entries(from as Record<string, unknown>)) {
+        result = result.split(old).join(String(newVal));
+      }
+      return result;
+    }
+    if (from !== undefined && to !== undefined) {
+      return s.split(String(from)).join(String(to));
+    }
+    return s;
+  },
   default: (v, fallback) => (v !== null && v !== undefined && v !== "") ? v : (fallback !== undefined ? fallback : ""),
   raw: (v) => v,
   safe: (v) => v,

package/packages/orm/src/baseModel.ts

@@ -67,7 +67,7 @@ export class BaseModel {
    * 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;
+  static autoMap: boolean = true;
 
   /**
    * Maps JS property names to database column names.
@@ -563,13 +563,15 @@ export class BaseModel {
   /**
    * Convert to plain object (dictionary).
    * @param include Optional array of relationship names to include (supports dot notation for nesting).
+   * @param case_ Key casing: 'camel' (default, keys as-is) or 'snake' (convert via fieldMapping).
    */
-  toDict(include?: string[]): Record<string, unknown> {
+  toDict(include?: string[], case_: "camel" | "snake" = "camel"): Record<string, unknown> {
     const ModelClass = this.constructor as typeof BaseModel;
     const result: Record<string, unknown> = {};
     for (const key of Object.keys(ModelClass.fields)) {
       if (this[key] !== undefined) {
-        result[key] = this[key];
+        const outKey = case_ === "snake" ? (ModelClass.fieldMapping[key] ?? key) : key;
+        result[outKey] = this[key];
       }
     }
     // Include soft delete field
@@ -604,11 +606,11 @@ export class BaseModel {
           result[relName] = null;
         } else if (Array.isArray(data)) {
           result[relName] = (data as BaseModel[]).map((r) =>
-            r.toDict(nested.length > 0 ? nested : undefined),
+            r.toDict(nested.length > 0 ? nested : undefined, case_),
           );
         } else if (typeof (data as BaseModel).toDict === "function") {
           result[relName] = (data as BaseModel).toDict(
-            nested.length > 0 ? nested : undefined,
+            nested.length > 0 ? nested : undefined, case_,
           );
         }
       }
@@ -639,15 +641,15 @@ export class BaseModel {
   /**
    * Convert to an associative object (alias for toDict).
    */
-  toAssoc(include?: string[]): Record<string, unknown> {
-    return this.toDict(include);
+  toAssoc(include?: string[], case_: "camel" | "snake" = "camel"): Record<string, unknown> {
+    return this.toDict(include, case_);
   }
 
   /**
    * Convert to a plain object (alias for toDict).
    */
-  toObject(): Record<string, unknown> {
-    return this.toDict();
+  toObject(case_: "camel" | "snake" = "camel"): Record<string, unknown> {
+    return this.toDict(undefined, case_);
   }
 
   /**
@@ -668,8 +670,8 @@ export class BaseModel {
    * Convert to JSON string.
    * @param include Optional relationship names to include.
    */
-  toJson(include?: string[]): string {
-    return JSON.stringify(this.toDict(include));
+  toJson(include?: string[], case_: "camel" | "snake" = "camel"): string {
+    return JSON.stringify(this.toDict(include, case_));
   }
 
   /**