tina4-nodejs 3.13.91 → 3.13.94

package/CLAUDE.md

@@ -1,10 +1,10 @@
-# CLAUDE.md - AI Developer Guide for tina4-nodejs (v3.13.91)
+# CLAUDE.md - AI Developer Guide for tina4-nodejs (v3.13.94)
 
 > 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.13.91 - The Intelligent Native Application 4ramework. A convention-over-configuration structural paradigm. The developer writes TypeScript; Tina4 is invisible infrastructure.
+Tina4 for Node.js/TypeScript v3.13.94 - The Intelligent Native Application 4ramework. A convention-over-configuration structural paradigm. The developer writes TypeScript; Tina4 is invisible infrastructure.
 
 The philosophy: zero ceremony, batteries included, file system as source of truth.
 
@@ -649,6 +649,19 @@ await db.executeMany(sql, paramSets): Promise<unknown[]>          // wrapped in
 await db.insert(table, data): Promise<DatabaseWriteResult>
 await db.update(table, data, filter?, params?): Promise<DatabaseWriteResult>
 await db.delete(table, filter?, params?): Promise<DatabaseWriteResult>
+await db.truncate(table): Promise<DatabaseWriteResult>   // remove every row, explicitly
+await db.primaryKey(table): Promise<string[]>            // introspected PK columns (cached)
+
+// A WRITE WITH NO FILTER IS AN ERROR, not a full-table operation (3.13.94).
+// update(table, data) with no filter takes the primary key out of `data` and uses
+// it as the WHERE clause; with neither a filter nor the COMPLETE primary key in
+// `data` it THROWS instead of silently changing nothing. delete(table) with no
+// filter throws too -- truncate(table) is the explicit whole-table spelling.
+// A failed write now throws rather than resolving to { success: false,
+// affectedRows: 0 }, which a caller who did not inspect the result never saw.
+// primaryKey() returns an ARRAY: a primary key may span several columns, and
+// EVERY key column goes into the WHERE. A composite key keyed on only its first
+// column would match every row sharing that value.
 
 // Last-write metadata — SYNCHRONOUS (no await)
 db.getLastId(): string | number
@@ -1244,7 +1257,7 @@ When adding new features, add a corresponding `test/<feature>.test.ts` file.
 ## v3 Features Summary
 
 - **98 built-in features**, zero third-party dependencies
-- **5,932 tests** passing across 190 files (build + typecheck green)
+- **6,230 tests** passing, 0 failed, across 198 files (build + typecheck green) - measured 2026-07-29 on Ubuntu 24.04.4 LTS x86_64, Node 24.18.0, live services, TINA4_REQUIRE_SERVICES=1; Firebird excluded by design
 - **Race-safe `getNextId()`** with atomic sequence table (`tina4_sequences`) for SQLite/MySQL/MSSQL; PostgreSQL auto-creates sequences
 - **Frond template engine optimizations**: pre-compiled regexes, lazy loop context (copy-on-write), filter chain caching, path split caching, inline common filters (11-15% speedup)
 - **Production server auto-detect**: `npx tina4nodejs serve --production` auto-uses cluster mode

package/README.md

@@ -107,7 +107,7 @@ Tina4 Node.js runs at **93% of raw Node.js speed** while providing 98 built-in f
 
 ## Cross-Framework Parity
 
-Tina4 ships identical features across four languages: same architecture, same conventions, same 97 features:
+Tina4 ships identical features across four languages: same architecture, same conventions, same 98 features:
 
 | | Python | PHP | Ruby | Node.js |
 |---|--------|-----|------|---------|

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.13.91",
+  "version": "3.13.94",
   "type": "module",
   "description": "Tina4 for Node.js/TypeScript - 54 built-in features, zero dependencies",
   "keywords": [
@@ -24,25 +24,25 @@
     "packages/*"
   ],
   "main": "packages/core/dist/index.js",
-  "types": "packages/core/src/index.ts",
+  "types": "./types/core/src/index.d.ts",
   "exports": {
     ".": {
-      "types": "./packages/core/src/index.ts",
+      "types": "./types/core/src/index.d.ts",
       "import": "./packages/core/dist/index.js",
       "default": "./packages/core/dist/index.js"
     },
     "./orm": {
-      "types": "./packages/orm/src/index.ts",
+      "types": "./types/orm/src/index.d.ts",
       "import": "./packages/orm/dist/index.js",
       "default": "./packages/orm/dist/index.js"
     },
     "./swagger": {
-      "types": "./packages/swagger/src/index.ts",
+      "types": "./types/swagger/src/index.d.ts",
       "import": "./packages/swagger/dist/index.js",
       "default": "./packages/swagger/dist/index.js"
     },
     "./frond": {
-      "types": "./packages/frond/src/engine.ts",
+      "types": "./types/frond/src/engine.d.ts",
       "import": "./packages/frond/dist/index.js",
       "default": "./packages/frond/dist/index.js"
     }
@@ -66,20 +66,22 @@
     "COMPARISON.md",
     "BENCHMARK_REPORT.md",
     "CARBONAH.md",
-    "README.md"
+    "README.md",
+    "types"
   ],
   "bin": {
     "tina4nodejs": "packages/cli/dist/bin.js"
   },
   "scripts": {
-    "build": "npm run build --workspaces",
+    "build": "npm run build --workspaces && npm run build:types",
     "clean": "rm -rf packages/*/dist",
     "pretest": "npm run build",
     "test": "tsx test/run-all.ts && npm run test:i18n",
     "test:i18n": "vitest run test/i18n.test.ts test/i18n-leaf-alias.test.ts",
     "typecheck": "tsc -p tsconfig.typecheck.json",
     "prepublishOnly": "npm run build",
-    "prepare": "npm run build"
+    "prepare": "npm run build",
+    "build:types": "tsc -p tsconfig.types.json"
   },
   "engines": {
     "node": ">=22.0.0"
@@ -93,6 +95,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "@types/pg": "^8.20.0",
     "esbuild": "^0.24.0",
     "mongodb": "^6.0.0",
     "tsx": "^4.19.0",