tina4-nodejs 3.10.68 → 3.10.70

package/CLAUDE.md

@@ -1,10 +1,10 @@
-# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.42)
+# CLAUDE.md — AI Developer Guide for tina4-nodejs (v3.10.70)
 
 > 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.42 — 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.10.70 — 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.
 
@@ -240,6 +240,7 @@ req.cookies: Record<string, string>       // parsed from Cookie header
 req.contentType: string                   // from content-type header
 req.query: Record<string, string>         // query string params
 response.xml(content, status?): Tina4Response
+response.stream(generator, contentType?: string, status?: number): void  // SSE/streaming
 ```
 
 ### Queue
@@ -677,7 +678,7 @@ When adding new features, add a corresponding `test/<feature>.test.ts` file.
 
 ## v3 Features Summary
 
-- **44 built-in features**, zero third-party dependencies
+- **45 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)
@@ -695,6 +696,7 @@ When adding new features, add a corresponding `test/<feature>.test.ts` file.
 - **SameSite=Lax** default on session cookies (`TINA4_SESSION_SAMESITE`)
 - **`tina4 init`** generates Dockerfile and .dockerignore
 - **Gallery**: 7 interactive examples with Try It deploy at `/_dev/`
+- **SSE/Streaming**: `response.stream()` for Server-Sent Events — pass an async generator, framework handles chunked transfer encoding and keep-alive
 
 ## Don'ts
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.10.68",
+  "version": "3.10.70",
   "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/core/src/response.ts

@@ -242,6 +242,40 @@ export function createResponse(res: ServerResponse): Tina4Response {
     return response.render(name, data, status, templateDir);
   };
 
+  /**
+   * Stream response from an async generator for Server-Sent Events (SSE).
+   *
+   * Usage:
+   *   export default async function (req, res) {
+   *     res.stream(async function* () {
+   *       for (let i = 0; i < 10; i++) {
+   *         yield `data: message ${i}\n\n`;
+   *         await new Promise(r => setTimeout(r, 1000));
+   *       }
+   *     }());
+   *   }
+   */
+  (response as any).stream = async function (
+    source: AsyncIterable<string | Buffer>,
+    contentType: string = "text/event-stream",
+  ): Promise<Tina4Response> {
+    if (res.headersSent) return response;
+    res.writeHead(200, {
+      "Content-Type": contentType,
+      "Cache-Control": "no-cache",
+      "Connection": "keep-alive",
+      "X-Accel-Buffering": "no",
+    });
+
+    for await (const chunk of source) {
+      const data = typeof chunk === "string" ? chunk : chunk.toString();
+      res.write(data);
+    }
+
+    res.end();
+    return response;
+  };
+
   return response;
 }
 

package/packages/core/src/types.ts

@@ -54,6 +54,8 @@ export interface Tina4ResponseMethods {
   error(code: string, message: string, status?: number): Tina4Response;
   render(template: string, data?: Record<string, unknown>, status?: number, templateDir?: string): Promise<Tina4Response>;
   template(name: string, data?: Record<string, unknown>, status?: number, templateDir?: string): Promise<Tina4Response>;
+  /** Stream response from an async generator (SSE or chunked). */
+  stream(source: AsyncIterable<string | Buffer>, contentType?: string): Promise<Tina4Response>;
   /** The underlying ServerResponse for advanced use */
   raw: ServerResponse;
 }