tina4-nodejs 3.10.5 → 3.10.10

package/CLAUDE.md

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

@@ -341,19 +341,39 @@ function evalExpr(expr: string, context: Record<string, unknown>): unknown {
     }
   }
 
-  // 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();
     }
   }
 

package/packages/orm/src/migration.ts

@@ -127,18 +127,34 @@ const MIGRATION_TABLE = "tina4_migration";
  * Ensure the migration tracking table exists with batch support.
  */
 export function ensureMigrationTable(): void {
-  const adapter = getAdapter() as SQLiteAdapter;
+  const adapter = getAdapter();
   if (!adapter.tableExists(MIGRATION_TABLE)) {
-    adapter.createTable(MIGRATION_TABLE, {
-      id: { type: "integer", primaryKey: true, autoIncrement: true },
-      name: { type: "string", required: true },
-      batch: { type: "integer", required: true },
-      applied_at: { type: "datetime", default: "now" },
-    });
+    if (isFirebirdAdapter(adapter)) {
+      // Firebird: no AUTOINCREMENT, no TEXT type, use generator for IDs
+      try {
+        adapter.execute("CREATE GENERATOR GEN_TINA4_MIGRATION_ID");
+        try { adapter.execute("COMMIT"); } catch { /* ignore */ }
+      } catch {
+        // Generator may already exist
+      }
+      adapter.execute(`CREATE TABLE "${MIGRATION_TABLE}" (
+        id INTEGER NOT NULL PRIMARY KEY,
+        name VARCHAR(500) NOT NULL,
+        batch INTEGER NOT NULL DEFAULT 1,
+        applied_at VARCHAR(50) NOT NULL
+      )`);
+    } else {
+      (adapter as SQLiteAdapter).createTable(MIGRATION_TABLE, {
+        id: { type: "integer", primaryKey: true, autoIncrement: true },
+        name: { type: "string", required: true },
+        batch: { type: "integer", required: true },
+        applied_at: { type: "datetime", default: "now" },
+      });
+    }
   } else {
     // Ensure batch column exists on older tables that only had passed/description
     try {
-      const cols = adapter.getTableColumns(MIGRATION_TABLE);
+      const cols = (adapter as SQLiteAdapter).getTableColumns(MIGRATION_TABLE);
       const colNames = new Set(cols.map((c) => c.name));
       if (!colNames.has("batch")) {
         adapter.execute(`ALTER TABLE "${MIGRATION_TABLE}" ADD COLUMN batch INTEGER NOT NULL DEFAULT 1`);
@@ -177,10 +193,22 @@ export function isMigrationApplied(name: string): boolean {
  */
 export function recordMigration(name: string, batch: number): void {
   const adapter = getAdapter();
-  adapter.execute(
-    `INSERT INTO "${MIGRATION_TABLE}" (name, batch) VALUES (?, ?)`,
-    [name, batch],
-  );
+  if (isFirebirdAdapter(adapter)) {
+    // Firebird: generate ID from sequence
+    const rows = adapter.query<{ NEXT_ID: number }>(
+      "SELECT GEN_ID(GEN_TINA4_MIGRATION_ID, 1) AS NEXT_ID FROM RDB$DATABASE",
+    );
+    const nextId = rows[0]?.NEXT_ID ?? 1;
+    adapter.execute(
+      `INSERT INTO "${MIGRATION_TABLE}" (id, name, batch) VALUES (?, ?, ?)`,
+      [nextId, name, batch],
+    );
+  } else {
+    adapter.execute(
+      `INSERT INTO "${MIGRATION_TABLE}" (name, batch) VALUES (?, ?)`,
+      [name, batch],
+    );
+  }
 }
 
 /**
@@ -438,12 +466,28 @@ export async function migrate(
 
   // Ensure tracking table with batch support
   if (!db.tableExists(MIGRATION_TABLE)) {
-    db.execute(`CREATE TABLE IF NOT EXISTS "${MIGRATION_TABLE}" (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      name TEXT NOT NULL,
-      batch INTEGER NOT NULL DEFAULT 1,
-      applied_at TEXT NOT NULL
-    )`);
+    if (isFirebirdAdapter(db)) {
+      // Firebird: no AUTOINCREMENT, no TEXT type, use generator for IDs
+      try {
+        db.execute("CREATE GENERATOR GEN_TINA4_MIGRATION_ID");
+        try { db.execute("COMMIT"); } catch { /* ignore */ }
+      } catch {
+        // Generator may already exist
+      }
+      db.execute(`CREATE TABLE "${MIGRATION_TABLE}" (
+        id INTEGER NOT NULL PRIMARY KEY,
+        name VARCHAR(500) NOT NULL,
+        batch INTEGER NOT NULL DEFAULT 1,
+        applied_at VARCHAR(50) NOT NULL
+      )`);
+    } else {
+      db.execute(`CREATE TABLE IF NOT EXISTS "${MIGRATION_TABLE}" (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL,
+        batch INTEGER NOT NULL DEFAULT 1,
+        applied_at TEXT NOT NULL
+      )`);
+    }
   } else {
     // Migrate old schema: if table has 'description' + 'passed' columns, migrate data
     try {
@@ -538,10 +582,22 @@ export async function migrate(
       // Record as applied with batch number
       const now = new Date().toISOString();
       try {
-        db.execute(
-          `INSERT INTO "${MIGRATION_TABLE}" (name, batch, applied_at) VALUES (?, ?, ?)`,
-          [migrationId, currentBatch, now],
-        );
+        if (isFirebirdAdapter(db)) {
+          // Firebird: generate ID from sequence
+          const idRows = db.query<{ NEXT_ID: number }>(
+            "SELECT GEN_ID(GEN_TINA4_MIGRATION_ID, 1) AS NEXT_ID FROM RDB$DATABASE",
+          );
+          const nextId = idRows[0]?.NEXT_ID ?? 1;
+          db.execute(
+            `INSERT INTO "${MIGRATION_TABLE}" (id, name, batch, applied_at) VALUES (?, ?, ?, ?)`,
+            [nextId, migrationId, currentBatch, now],
+          );
+        } else {
+          db.execute(
+            `INSERT INTO "${MIGRATION_TABLE}" (name, batch, applied_at) VALUES (?, ?, ?)`,
+            [migrationId, currentBatch, now],
+          );
+        }
       } catch {
         // Old schema fallback — try description/content/passed columns
         db.execute(