tina4-nodejs 3.10.4 → 3.10.6

package/CLAUDE.md

@@ -1,10 +1,10 @@
-# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.4)
+# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.6)
 
 > 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.10.4 — a convention-over-configuration structural paradigm. **Not a framework.** The developer writes TypeScript; Tina4 is invisible infrastructure.
+Tina4 for Node.js/TypeScript v3.10.6 — 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.10.4",
+  "version": "3.10.6",
   "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/wsdl.ts

@@ -161,6 +161,23 @@ export abstract class WSDLService {
 
   protected namespace: string = "http://tina4.com/wsdl";
 
+  /**
+   * Lifecycle hook: called before operation invocation.
+   * Override to validate, log, or modify the incoming request.
+   */
+  protected onRequest(_request: unknown): void {
+    // no-op — override in subclass
+  }
+
+  /**
+   * Lifecycle hook: called after operation returns.
+   * Override to transform, audit, or enrich the result.
+   * Must return the (possibly modified) result.
+   */
+  protected onResult(result: Record<string, unknown>): Record<string, unknown> {
+    return result;
+  }
+
   /** Discovered operations (populated on first use). */
   private _operations: Map<string, WSDLOperation> | null = null;
 
@@ -376,10 +393,15 @@ export abstract class WSDLService {
       }
     }
 
+    // Lifecycle hook: before invocation
+    this.onRequest(soapXml);
+
     // Invoke the method
     try {
-      const result = await (method as (...args: unknown[]) => Promise<unknown>).call(this, ...params);
-      return this.soapResponse(opName, result as Record<string, unknown>);
+      const rawResult = await (method as (...args: unknown[]) => Promise<unknown>).call(this, ...params);
+      // Lifecycle hook: after invocation — allow result transformation
+      const result = this.onResult(rawResult as Record<string, unknown>);
+      return this.soapResponse(opName, result);
     } catch (err) {
       const errMsg = err instanceof Error ? err.message : String(err);
       return this.soapFault("Server", errMsg);

package/packages/frond/src/engine.ts

@@ -219,9 +219,76 @@ function resolveVar(expr: string, context: Record<string, unknown>): unknown {
   return value;
 }
 
+function findOutsideQuotes(expr: string, needle: string): number {
+  let inQuote: string | null = null;
+  let depth = 0;
+  let i = 0;
+  while (i <= expr.length - needle.length) {
+    const ch = expr[i];
+    if ((ch === '"' || ch === "'") && depth === 0) {
+      if (inQuote === null) {
+        inQuote = ch;
+      } else if (ch === inQuote) {
+        inQuote = null;
+      }
+      i++;
+      continue;
+    }
+    if (inQuote) { i++; continue; }
+    if (ch === "(") depth++;
+    else if (ch === ")") depth--;
+    if (depth === 0 && expr.slice(i, i + needle.length) === needle) {
+      return i;
+    }
+    i++;
+  }
+  return -1;
+}
+
+function splitOutsideQuotes(expr: string, sep: string): string[] {
+  const parts: string[] = [];
+  let currentStart = 0;
+  let inQuote: string | null = null;
+  let depth = 0;
+  let i = 0;
+  while (i <= expr.length - sep.length) {
+    const ch = expr[i];
+    if ((ch === '"' || ch === "'") && depth === 0) {
+      if (inQuote === null) {
+        inQuote = ch;
+      } else if (ch === inQuote) {
+        inQuote = null;
+      }
+      i++;
+      continue;
+    }
+    if (inQuote) { i++; continue; }
+    if (ch === "(") depth++;
+    else if (ch === ")") depth--;
+    if (depth === 0 && expr.slice(i, i + sep.length) === sep) {
+      parts.push(expr.slice(currentStart, i));
+      i += sep.length;
+      currentStart = i;
+      continue;
+    }
+    i++;
+  }
+  parts.push(expr.slice(currentStart));
+  return parts;
+}
+
 function evalExpr(expr: string, context: Record<string, unknown>): unknown {
   expr = expr.trim();
 
+  // String literal early-return: if the entire expression is a single quoted
+  // string with no unescaped matching quotes inside, return its content.
+  if (expr.length >= 2) {
+    const q = expr[0];
+    if ((q === '"' || q === "'") && expr.endsWith(q) && !expr.slice(1, -1).includes(q)) {
+      return expr.slice(1, -1);
+    }
+  }
+
   // Ternary: condition ? true_val : false_val
   // Match carefully to handle nested ternaries
   const ternaryIdx = findTernary(expr);
@@ -245,7 +312,7 @@ function evalExpr(expr: string, context: Record<string, unknown>): unknown {
   }
 
   // Null coalescing: value ?? "default"
-  const qqIdx = expr.indexOf("??");
+  const qqIdx = findOutsideQuotes(expr, "??");
   if (qqIdx !== -1) {
     const left = expr.slice(0, qqIdx).trim();
     const right = expr.slice(qqIdx + 2).trim();
@@ -257,8 +324,8 @@ function evalExpr(expr: string, context: Record<string, unknown>): unknown {
   }
 
   // String concatenation with ~
-  if (expr.includes("~")) {
-    const parts = splitOnTilde(expr);
+  if (findOutsideQuotes(expr, "~") >= 0) {
+    const parts = splitOutsideQuotes(expr, "~");
     if (parts.length > 1) {
       return parts.map(p => {
         const v = evalExpr(p.trim(), context);
@@ -269,24 +336,44 @@ function evalExpr(expr: string, context: Record<string, unknown>): unknown {
 
   // Check for comparison/logical operators
   for (const op of [" not in ", " in ", " is not ", " is ", "!=", "==", ">=", "<=", ">", "<", " and ", " or ", " not "]) {
-    if (expr.includes(op)) {
+    if (findOutsideQuotes(expr, op) >= 0) {
       return evalComparison(expr, context);
     }
   }
 
-  // Function call: name("arg1", "arg2")
-  const fnMatch = expr.match(/^(\w+)\s*\(([\s\S]*)?\)$/);
+  // Function call: name("arg1", "arg2") — supports dotted names like user.t("key")
+  const fnMatch = expr.match(/^([\w.]+)\s*\(([\s\S]*)?\)$/);
   if (fnMatch) {
     const fnName = fnMatch[1];
     const rawArgs = fnMatch[2] || "";
-    const fn = context[fnName] ?? resolveVar(fnName, context);
-    if (typeof fn === "function") {
-      if (rawArgs.trim()) {
-        const parts = splitArgs(rawArgs);
-        const evalArgs = parts.map(a => evalExpr(a.trim(), context));
-        return fn(...evalArgs);
+
+    // Dotted function name: resolve object, then call method
+    if (fnName.includes(".")) {
+      const lastDot = fnName.lastIndexOf(".");
+      const objPath = fnName.slice(0, lastDot);
+      const methodName = fnName.slice(lastDot + 1);
+      const obj = resolveVar(objPath, context);
+      if (obj && typeof obj === "object" && methodName in (obj as Record<string, unknown>)) {
+        const method = (obj as Record<string, unknown>)[methodName];
+        if (typeof method === "function") {
+          if (rawArgs.trim()) {
+            const parts = splitArgs(rawArgs);
+            const evalArgs = parts.map(a => evalExpr(a.trim(), context));
+            return method.apply(obj, evalArgs);
+          }
+          return method.call(obj);
+        }
+      }
+    } else {
+      const fn = context[fnName] ?? resolveVar(fnName, context);
+      if (typeof fn === "function") {
+        if (rawArgs.trim()) {
+          const parts = splitArgs(rawArgs);
+          const evalArgs = parts.map(a => evalExpr(a.trim(), context));
+          return fn(...evalArgs);
+        }
+        return fn();
       }
-      return fn();
     }
   }