@rg-dev/stdlib 1.0.21 → 1.0.22

package/lib/node-env.cjs

@@ -187,6 +187,8 @@ var require_command_exists2 = __commonJS({
 // src/node-env.ts
 var node_env_exports = {};
 __export(node_env_exports, {
+  SSEClient: () => SSEClient,
+  SSEResponse: () => SSEResponse,
   checkCommandExistsOrThrow: () => checkCommandExistsOrThrow,
   checkIfDirExistsOrThrow: () => checkIfDirExistsOrThrow,
   checkIfFileExistsOrThrow: () => checkIfFileExistsOrThrow,
@@ -200,6 +202,126 @@ var fs = __toESM(require("fs-extra"), 1);
 var import_os = __toESM(require("os"), 1);
 var import_path = __toESM(require("path"), 1);
 var import_command_exists = __toESM(require_command_exists2(), 1);
+
+// src/SSEResponse.ts
+var SSEResponse = class {
+  res;
+  isOpen = true;
+  constructor(res) {
+    this.res = res;
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+  }
+  flushHeaders() {
+    var _a;
+    (_a = this.res) == null ? void 0 : _a.flushHeaders();
+  }
+  /** Send JSON to client, optionally with a custom event type */
+  emit(data, event) {
+    if (!this.isOpen)
+      return;
+    try {
+      let payload = "";
+      if (event) {
+        payload += `event: ${event}
+`;
+      }
+      payload += `data: ${JSON.stringify(data)}
+
+`;
+      if (this.res.writable) {
+        this.res.write(payload);
+      }
+    } catch (e) {
+      console.log("SSE Write error", e);
+    }
+  }
+  /** Close the SSE connection */
+  close() {
+    if (!this.isOpen) {
+      return;
+    }
+    this.isOpen = false;
+    if (!this.res.writableEnded) {
+      this.res.end();
+    }
+  }
+};
+
+// src/SSEClient.ts
+var import_events = require("events");
+var SSEClient = class extends import_events.EventEmitter {
+  url;
+  payload;
+  headers;
+  controller;
+  constructor(options) {
+    super();
+    this.url = options.url;
+    this.payload = options.payload || {};
+    this.headers = {
+      "Content-Type": "application/json",
+      Accept: "*/*",
+      ...options.headers
+    };
+    this.controller = new AbortController();
+  }
+  async connect() {
+    try {
+      const res = await fetch(this.url, {
+        method: "POST",
+        headers: this.headers,
+        body: JSON.stringify(this.payload),
+        signal: this.controller.signal
+      });
+      if (!res.ok) {
+        const data = await res.text();
+        this.emit("error", new Error(`HTTP error: ${res.status} ${data}`));
+        return;
+      }
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder("utf-8");
+      let buffer = "";
+      let eventName = "message";
+      while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+          break;
+        buffer += decoder.decode(value, { stream: true });
+        let lines = buffer.split("\n");
+        buffer = lines.pop();
+        for (let line of lines) {
+          line = line.trim();
+          if (!line)
+            continue;
+          if (line.startsWith("event:")) {
+            eventName = line.slice(6).trim();
+          } else if (line.startsWith("data:")) {
+            let data = line.slice(5).trim();
+            try {
+              data = JSON.parse(data);
+            } catch {
+            }
+            this.emit(eventName, data);
+            eventName = "message";
+          }
+        }
+      }
+      this.emit("end");
+    } catch (err) {
+      if (err.name !== "AbortError") {
+        this.emit("error", err);
+      }
+    }
+  }
+  close() {
+    this.controller.abort();
+    this.emit("close");
+  }
+};
+
+// src/node-env.ts
 function isWindows() {
   return import_os.default.platform() === "win32";
 }

package/lib/node-env.d.cts

@@ -1,3 +1,32 @@
+import { Response } from 'express';
+import { EventEmitter } from 'events';
+
+declare class SSEResponse<Events extends string = 'message'> {
+    private res;
+    private isOpen;
+    constructor(res: Response);
+    flushHeaders(): void;
+    /** Send JSON to client, optionally with a custom event type */
+    emit(data: unknown, event?: Events): void;
+    /** Close the SSE connection */
+    close(): void;
+}
+
+interface SSEClientOptions {
+    url: string;
+    payload?: Record<string, any>;
+    headers?: Record<string, string>;
+}
+declare class SSEClient extends EventEmitter {
+    private url;
+    private payload;
+    private headers;
+    private controller;
+    constructor(options: SSEClientOptions);
+    connect(): Promise<void>;
+    close(): void;
+}
+
 declare function isWindows(): boolean;
 declare function chmodPlusX(filePath: string): void;
 declare function checkIfDirExistsOrThrow(path: string): Promise<void>;
@@ -6,4 +35,4 @@ declare function throwIfDirNotEmpty(dir_path: string): Promise<void>;
 declare function checkCommandExistsOrThrow(cmd: string): Promise<void>;
 declare function checkIfFileExistsOrThrow(the_path: string): Promise<void>;
 
-export { checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, isWindows, throwIfDirNotEmpty };
+export { SSEClient, SSEResponse, checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, isWindows, throwIfDirNotEmpty };

package/lib/node-env.d.ts

@@ -1,3 +1,32 @@
+import { Response } from 'express';
+import { EventEmitter } from 'events';
+
+declare class SSEResponse<Events extends string = 'message'> {
+    private res;
+    private isOpen;
+    constructor(res: Response);
+    flushHeaders(): void;
+    /** Send JSON to client, optionally with a custom event type */
+    emit(data: unknown, event?: Events): void;
+    /** Close the SSE connection */
+    close(): void;
+}
+
+interface SSEClientOptions {
+    url: string;
+    payload?: Record<string, any>;
+    headers?: Record<string, string>;
+}
+declare class SSEClient extends EventEmitter {
+    private url;
+    private payload;
+    private headers;
+    private controller;
+    constructor(options: SSEClientOptions);
+    connect(): Promise<void>;
+    close(): void;
+}
+
 declare function isWindows(): boolean;
 declare function chmodPlusX(filePath: string): void;
 declare function checkIfDirExistsOrThrow(path: string): Promise<void>;
@@ -6,4 +35,4 @@ declare function throwIfDirNotEmpty(dir_path: string): Promise<void>;
 declare function checkCommandExistsOrThrow(cmd: string): Promise<void>;
 declare function checkIfFileExistsOrThrow(the_path: string): Promise<void>;
 
-export { checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, isWindows, throwIfDirNotEmpty };
+export { SSEClient, SSEResponse, checkCommandExistsOrThrow, checkIfDirExistsOrThrow, checkIfFileExistsOrThrow, chmodPlusX, createTempDir, isWindows, throwIfDirNotEmpty };

package/lib/node-env.js

@@ -191,6 +191,126 @@ var import_command_exists = __toESM(require_command_exists2(), 1);
 import * as fs from "fs-extra";
 import os from "os";
 import path from "path";
+
+// src/SSEResponse.ts
+var SSEResponse = class {
+  res;
+  isOpen = true;
+  constructor(res) {
+    this.res = res;
+    res.setHeader("Content-Type", "text/event-stream");
+    res.setHeader("Cache-Control", "no-cache");
+    res.setHeader("Connection", "keep-alive");
+  }
+  flushHeaders() {
+    var _a;
+    (_a = this.res) == null ? void 0 : _a.flushHeaders();
+  }
+  /** Send JSON to client, optionally with a custom event type */
+  emit(data, event) {
+    if (!this.isOpen)
+      return;
+    try {
+      let payload = "";
+      if (event) {
+        payload += `event: ${event}
+`;
+      }
+      payload += `data: ${JSON.stringify(data)}
+
+`;
+      if (this.res.writable) {
+        this.res.write(payload);
+      }
+    } catch (e) {
+      console.log("SSE Write error", e);
+    }
+  }
+  /** Close the SSE connection */
+  close() {
+    if (!this.isOpen) {
+      return;
+    }
+    this.isOpen = false;
+    if (!this.res.writableEnded) {
+      this.res.end();
+    }
+  }
+};
+
+// src/SSEClient.ts
+import { EventEmitter } from "events";
+var SSEClient = class extends EventEmitter {
+  url;
+  payload;
+  headers;
+  controller;
+  constructor(options) {
+    super();
+    this.url = options.url;
+    this.payload = options.payload || {};
+    this.headers = {
+      "Content-Type": "application/json",
+      Accept: "*/*",
+      ...options.headers
+    };
+    this.controller = new AbortController();
+  }
+  async connect() {
+    try {
+      const res = await fetch(this.url, {
+        method: "POST",
+        headers: this.headers,
+        body: JSON.stringify(this.payload),
+        signal: this.controller.signal
+      });
+      if (!res.ok) {
+        const data = await res.text();
+        this.emit("error", new Error(`HTTP error: ${res.status} ${data}`));
+        return;
+      }
+      const reader = res.body.getReader();
+      const decoder = new TextDecoder("utf-8");
+      let buffer = "";
+      let eventName = "message";
+      while (true) {
+        const { value, done } = await reader.read();
+        if (done)
+          break;
+        buffer += decoder.decode(value, { stream: true });
+        let lines = buffer.split("\n");
+        buffer = lines.pop();
+        for (let line of lines) {
+          line = line.trim();
+          if (!line)
+            continue;
+          if (line.startsWith("event:")) {
+            eventName = line.slice(6).trim();
+          } else if (line.startsWith("data:")) {
+            let data = line.slice(5).trim();
+            try {
+              data = JSON.parse(data);
+            } catch {
+            }
+            this.emit(eventName, data);
+            eventName = "message";
+          }
+        }
+      }
+      this.emit("end");
+    } catch (err) {
+      if (err.name !== "AbortError") {
+        this.emit("error", err);
+      }
+    }
+  }
+  close() {
+    this.controller.abort();
+    this.emit("close");
+  }
+};
+
+// src/node-env.ts
 function isWindows() {
   return os.platform() === "win32";
 }
@@ -256,6 +376,8 @@ function removeQuotes(str) {
   }
 }
 export {
+  SSEClient,
+  SSEResponse,
   checkCommandExistsOrThrow,
   checkIfDirExistsOrThrow,
   checkIfFileExistsOrThrow,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rg-dev/stdlib",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
@@ -11,9 +11,6 @@
   "files": [
     "lib"
   ],
-
-  
-
   "typesVersions": {
     "*": {
       "lib/common-env": [
@@ -58,6 +55,7 @@
     "@types/node": "^18.19.3",
     "builtin-modules": "^3.3.0",
     "command-exists": "^1.2.9",
+    "express": "^5.1.0",
     "node-fetch": "^3.3.2",
     "tsup": "^8.0.1",
     "typescript": "^4.9.5"