tina4-nodejs 3.10.41 → 3.10.44

package/CLAUDE.md

@@ -1,10 +1,10 @@
-# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.41)
+# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.42)
 
 > 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.41 — a convention-over-configuration structural paradigm. **Not a framework.** The developer writes TypeScript; Tina4 is invisible infrastructure.
+Tina4 for Node.js/TypeScript v3.10.42 — 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.
 
@@ -587,7 +587,7 @@ When adding new features, add a corresponding `test/<feature>.test.ts` file.
 
 ## v3 Features Summary
 
-- **38 built-in features**, zero third-party dependencies
+- **44 built-in features**, zero third-party dependencies
 - **1,812 tests** passing across all modules
 - **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)

package/README.md

@@ -6,7 +6,7 @@
 <p align="center">54 built-in features. Zero dependencies. One import, everything works.</p>
 <p align="center">
   <a href="https://www.npmjs.com/package/tina4-nodejs"><img src="https://img.shields.io/npm/v/tina4-nodejs?color=7b1fa2&label=npm" alt="npm"></a>
-  <img src="https://img.shields.io/badge/tests-1%2C950%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/tests-1%2C812%20passing-brightgreen" alt="Tests">
   <img src="https://img.shields.io/badge/features-54-blue" alt="Features">
   <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="Zero Deps">
   <a href="https://tina4.com"><img src="https://img.shields.io/badge/docs-tina4.com-7b1fa2" alt="Docs"></a>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.10.41",
+  "version": "3.10.44",
   "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/cli/src/bin.ts

@@ -8,6 +8,7 @@ import { listRoutes } from "./commands/routes.js";
 import { runTests } from "./commands/test.js";
 import { generate } from "./commands/generate.js";
 import { runSeeds } from "./commands/seed.js";
+import { execSync } from "node:child_process";
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -24,18 +25,55 @@ const HELP = `
     tina4nodejs migrate:rollback      Roll back the last batch of migrations
     tina4nodejs routes                List all registered routes
     tina4nodejs test [file]           Run project tests
-    tina4nodejs generate <what> <name> Generate scaffolding (model, route, migration, middleware)
     tina4nodejs seed [file]           Run database seed files from src/seeds/
     tina4nodejs ai                    Install AI coding assistant context files
     tina4nodejs help                  Show this help message
 
+  Generators:
+    tina4nodejs generate model <Name> [--fields "name:string,price:float"]
+    tina4nodejs generate route <name> [--model Name]
+    tina4nodejs generate crud <Name> [--fields "..."]   Model + migration + routes + form + view + test
+    tina4nodejs generate migration <description>
+    tina4nodejs generate middleware <Name>
+    tina4nodejs generate test <name>
+    tina4nodejs generate form <Name> [--fields "..."]   Form template with inputs matching model fields
+    tina4nodejs generate view <Name> [--fields "..."]   List + detail templates for viewing records
+    tina4nodejs generate auth                           Login/register/logout routes + User model + templates
+
+  Field types: string, int, float, bool, text, datetime
+  Table names: singular by default (Product → product)
+
   Options:
     --port <number>      Server port (default: 7148)
+    --no-browser         Don't open the browser on serve
     --all                Install AI context for all tools (with ai command)
     --force              Overwrite existing AI context files (with ai command)
     --help               Show this help message
 `;
 
+// ── Port-kill helper ────────────────────────────────────────────────
+
+function killProcessOnPort(port: number): boolean {
+  try {
+    const result = execSync(`lsof -ti :${port}`, { encoding: "utf-8", timeout: 5000 }).trim();
+    if (result) {
+      const pids = result.split("\n");
+      for (const pid of pids) {
+        try {
+          process.kill(parseInt(pid, 10), "SIGTERM");
+        } catch {
+          // ignore ProcessLookupError / PermissionError
+        }
+      }
+      console.log(`  Killed existing process on port ${port} (PID: ${pids.join(", ")})`);
+      return true;
+    }
+  } catch {
+    // lsof not found or no process on port — that's fine
+  }
+  return false;
+}
+
 async function main(): Promise<void> {
   switch (command) {
     case "init": {
@@ -46,7 +84,12 @@ async function main(): Promise<void> {
     case "serve": {
       const portIndex = args.indexOf("--port");
       const port = portIndex !== -1 ? parseInt(args[portIndex + 1], 10) : 7148;
-      await serveProject({ port });
+      const noBrowser = args.includes("--no-browser");
+
+      // Kill any existing process on the port
+      killProcessOnPort(port);
+
+      await serveProject({ port, noBrowser });
       break;
     }
     case "migrate": {
@@ -76,8 +119,9 @@ async function main(): Promise<void> {
     }
     case "generate": {
       const what = args[1];
-      const genName = args[2];
-      await generate(what, genName);
+      const genName = args[2] || "";
+      const extraArgs = args.slice(3);
+      await generate(what, genName, extraArgs);
       break;
     }
     case "seed": {