tina4-nodejs 3.1.2 → 3.2.1

package/README.md

@@ -42,7 +42,35 @@ cd my-app && tina4 serve
 
 Open http://localhost:7148 — your app is running.
 
-> **Alternative** (without Rust CLI): `npm install tina4-nodejs` then create `app.ts`
+<details>
+<summary><strong>Without the Tina4 CLI</strong></summary>
+
+```bash
+# 1. Create project
+mkdir my-app && cd my-app
+npm init -y
+npm install tina4-nodejs
+
+# 2. Create entry point
+cat > app.ts << 'EOF'
+import { startServer } from "tina4-nodejs";
+startServer({ port: 7148, host: "0.0.0.0" });
+EOF
+
+# 3. Create .env
+echo 'TINA4_DEBUG=true' > .env
+echo 'TINA4_LOG_LEVEL=ALL' >> .env
+
+# 4. Create route directory
+mkdir -p src/routes
+
+# 5. Run
+npx tsx app.ts
+```
+
+Open http://localhost:7148
+
+</details>
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.1.2",
+  "version": "3.2.1",
   "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/errorOverlay.ts

@@ -166,22 +166,24 @@ export function renderErrorOverlay(error: Error, request?: any): string {
   // ── Request info ──
   const requestPairs: Array<[string, string]> = [];
   if (request != null) {
-    for (const attr of ["method", "url", "path"]) {
-      if (request[attr] != null) requestPairs.push([attr, String(request[attr])]);
+    for (const attr of ["method", "url", "path", "ip"]) {
+      requestPairs.push([attr, request[attr] != null ? String(request[attr]) : "(none)"]);
     }
-    if (request.headers && typeof request.headers === "object") {
-      for (const [hk, hv] of Object.entries(request.headers)) {
-        requestPairs.push([`headers.${hk}`, String(hv)]);
-      }
-    }
-    if (request.params && typeof request.params === "object") {
-      for (const [pk, pv] of Object.entries(request.params)) {
-        requestPairs.push([`params.${pk}`, String(pv)]);
-      }
-    }
-    if (request.query && typeof request.query === "object") {
-      for (const [qk, qv] of Object.entries(request.query)) {
-        requestPairs.push([`query.${qk}`, String(qv)]);
+    const dictFields: Array<[string, unknown]> = [
+      ["headers", request.headers],
+      ["params", request.params],
+      ["query", request.query],
+      ["body", request.body],
+    ];
+    for (const [label, val] of dictFields) {
+      if (val != null && typeof val === "object" && Object.keys(val as object).length > 0) {
+        for (const [k, v] of Object.entries(val as Record<string, unknown>)) {
+          requestPairs.push([`${label}.${k}`, String(v)]);
+        }
+      } else if (val != null && typeof val === "string" && val !== "") {
+        requestPairs.push([label, val]);
+      } else {
+        requestPairs.push([label, val == null ? "(none)" : "(empty)"]);
       }
     }
   }

package/packages/core/src/routeDiscovery.ts

@@ -44,7 +44,8 @@ export async function discoverRoutes(routesDir: string): Promise<RouteDefinition
 
 function filePathToPattern(relativePath: string): string {
   // Remove the filename (get.ts, post.ts, etc.) to get the directory path
-  const parts = relativePath.split("/").slice(0, -1);
+  // Normalise backslashes for Windows compatibility
+  const parts = relativePath.replace(/\\/g, "/").split("/").slice(0, -1);
 
   // Convert directory segments to URL pattern
   // File system uses [id] notation, but URL patterns use {id} to match Python

package/packages/core/src/server.ts

@@ -553,7 +553,21 @@ ${reset}
           if (!proceed || res.raw.writableEnded) return;
         }
 
-        const result = await match.handler(req, res);
+        // Support (), (response), (request), or (request, response) handler signatures
+        // When 1 param: if named request/req, pass request; otherwise pass response
+        let result: unknown;
+        if (match.handler.length === 0) {
+          result = await (match.handler as any)();
+        } else if (match.handler.length === 1) {
+          const fnStr = match.handler.toString();
+          const paramMatch = fnStr.match(/^(?:async\s+)?(?:function\s*)?\(?\s*(\w+)/);
+          const paramName = paramMatch?.[1]?.toLowerCase() ?? "";
+          result = (paramName === "request" || paramName === "req")
+            ? await match.handler(req as any)
+            : await match.handler(res as any);
+        } else {
+          result = await match.handler(req, res);
+        }
 
         // If the route exports a template and the handler returned a plain object,
         // render it through the template engine instead of sending as JSON.