@adaas/a-server 0.0.23 → 0.0.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adaas/a-server",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "A-Server is a powerful server framework designed to work seamlessly with the A-Concept framework. This library provides a robust and flexible server implementation of A-Server, enabling developers to create scalable and efficient server-side applications using the A-Concept architecture.",
   "keywords": [
     "adaas",
@@ -289,11 +289,15 @@
     "echo-version": "echo $npm_package_version",
     "build": "tsup --config tsup.config.ts"
   },
-  "dependencies": {
-    "@adaas/a-concept": "^0.3.15",
-    "@adaas/a-utils": "^0.3.19"
+  "peerDependencies": {
+    "@adaas/a-concept": "^0.3.16",
+    "@adaas/a-frame": "^0.1.2",
+    "@adaas/a-utils": "^0.3.20"
   },
   "devDependencies": {
+    "@adaas/a-concept": "^0.3.15",
+    "@adaas/a-frame": "^0.1.2",
+    "@adaas/a-utils": "^0.3.19",
     "@types/chai": "^4.3.14",
     "@types/jest": "^29.5.12",
     "@types/mocha": "^10.0.6",

package/src/controllers/A-ServerHealthMonitor/A-ServerHealthMonitor.component.ts

@@ -1,9 +1,11 @@
-import { A_Component, A_Inject } from "@adaas/a-concept";
+import { A_Component, A_CONCEPT_ENV, A_Inject } from "@adaas/a-concept";
 import { A_ServerRouter } from "@adaas/a-server/router/A-ServerRouter.component";
 import { A_Request } from "@adaas/a-server/request/A-Request.entity";
 import { A_Response } from "@adaas/a-server/response/A-Response.entity";
 import { A_Config } from "@adaas/a-utils/a-config";
 import { A_ServerLogger } from "@adaas/a-server/logger/A-ServerLogger.component";
+import fs from "fs";
+import path from "path";
 
 
 
@@ -25,8 +27,9 @@ export class A_ServerHealthMonitor extends A_Component {
         @A_Inject(A_Response) response: A_Response,
         @A_Inject(A_ServerLogger) logger: A_ServerLogger
     ): Promise<any> {
-        const packageJSON = await import(`${config.get('A_CONCEPT_ROOT_FOLDER')}/package.json`,
-            { with: { type: 'json' } });
+        const rootFolder = config.get('A_CONCEPT_ROOT_FOLDER') || A_CONCEPT_ENV.A_CONCEPT_ROOT_FOLDER || process.cwd();
+        const pkgPath = path.join(rootFolder, 'package.json');
+        const packageJSON = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
 
 
         const exposedProperties: Array<string> = config.get('EXPOSED_PROPERTIES')?.split(',') || [
@@ -35,6 +38,6 @@ export class A_ServerHealthMonitor extends A_Component {
             'description',
         ];
 
-        exposedProperties.forEach(prop => response.add(prop, packageJSON.default[prop]));
+        exposedProperties.forEach(prop => response.add(prop, packageJSON[prop]));
     }
 }

package/src/lib/A-Response/A-Response.entity.ts

@@ -89,6 +89,10 @@ export class A_Response<_ResponseType = any> extends A_Entity<
      * Event listeners map for A_Response events
      */
     private _listeners: Map<A_ResponseFeatureNames, Set<A_Response_Listener>> = new Map();
+    /**
+     * Whether this response is operating as a persistent SSE stream
+     */
+    private _isStreaming: boolean = false;
 
 
     constructor(params: A_Response_Constructor, options?: A_Response_Options) {
@@ -158,6 +162,14 @@ export class A_Response<_ResponseType = any> extends A_Entity<
     get size(): number {
         return this.original.getHeader('Content-Length') as number || 0;
     }
+    /**
+     * Whether this response is in SSE streaming mode.
+     * When true the server container will NOT auto-send and destroy() will
+     * leave the underlying socket open.
+     */
+    get isStreaming(): boolean {
+        return this._isStreaming;
+    }
 
     // ======================================================================================
     // --------------------------------------------------------------------------
@@ -188,7 +200,7 @@ export class A_Response<_ResponseType = any> extends A_Entity<
      */
     async destroy(): Promise<any> {
 
-        if (!this.original.destroyed) {
+        if (!this.original.destroyed && !this._isStreaming) {
             this.original.end();
             this._listeners.clear();
             this.original.removeAllListeners();
@@ -312,6 +324,56 @@ export class A_Response<_ResponseType = any> extends A_Entity<
             }));
         }
     }
+    // ======================================================================================
+    // --------------------------------------------------------------------------
+    // A-Response SSE (Server-Sent Events) Methods
+    // --------------------------------------------------------------------------
+    // ======================================================================================
+    /**
+     * Upgrade this response to a persistent SSE stream.
+     * Sends the required headers and writes the initial `:ok` comment to flush
+     * the connection. After calling this the response will NOT be auto-closed
+     * by the server container or by destroy().
+     */
+    public sseOpen(): void {
+        if (this.headersSent || this._isStreaming) return;
+        this._isStreaming = true;
+        this.original.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            'Connection': 'keep-alive',
+            'X-Accel-Buffering': 'no',
+        });
+        this.original.write(':ok\n\n');
+        // Reset streaming flag when the client disconnects
+        this.original.once('close', () => {
+            this._isStreaming = false;
+        });
+    }
+    /**
+     * Write a named SSE event onto the open stream.
+     * Format: `event: <name>\ndata: <JSON>\n\n`
+     *
+     * Compatible with browser EventSource `addEventListener(name, handler)`.
+     *
+     * @returns false when the channel is no longer writable
+     */
+    public sseWrite(event: string, data?: any): boolean {
+        if (!this._isStreaming || this.original.destroyed) return false;
+        try {
+            return this.original.write(`event: ${event}\ndata: ${JSON.stringify(data ?? {})}\n\n`);
+        } catch {
+            return false;
+        }
+    }
+    /**
+     * Close the SSE stream gracefully.
+     */
+    public sseClose(): void {
+        if (!this._isStreaming || this.original.destroyed) return;
+        this._isStreaming = false;
+        this.original.end();
+    }
     /**
      * Write head with status and headers
      */

package/src/lib/A-Server/A-HttpServer.container.ts

@@ -197,7 +197,12 @@ export class A_HttpServer extends A_Service {
 
 
                     req.clearTimeout();
-                    await res.status(200).send();
+
+                    // For SSE streams the controller calls response.sseOpen() which keeps
+                    // the socket alive; skip the auto-send so we don't close it here.
+                    if (!res.isStreaming) {
+                        await res.status(200).send();
+                    }
 
                     resolve();
                 } catch (error) {