libmodulor 0.20.0 → 0.22.0

package/dist/esm/utils/http/NDJSONStreamManager.js

@@ -0,0 +1,42 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var NDJSONStreamManager_1;
+import { injectable } from 'inversify';
+import { NDJSON_DATA_SEP } from './nd-json.js';
+let NDJSONStreamManager = class NDJSONStreamManager {
+    static { NDJSONStreamManager_1 = this; }
+    static DEFAULT_ENCODING = 'utf-8';
+    async exec({ encoding = NDJSONStreamManager_1.DEFAULT_ENCODING, onData, reader, }) {
+        const decoder = new TextDecoder(encoding);
+        let buffer = '';
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                return;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            const parts = buffer.split(NDJSON_DATA_SEP);
+            // Remove the last part that is potentially not complete yet.
+            buffer = parts.pop() ?? '';
+            for (const part of parts) {
+                const lines = part.split(NDJSON_DATA_SEP);
+                for (const line of lines) {
+                    try {
+                        onData(JSON.parse(line));
+                    }
+                    catch (_err) {
+                        // Ignore invalid message
+                    }
+                }
+            }
+        }
+    }
+};
+NDJSONStreamManager = NDJSONStreamManager_1 = __decorate([
+    injectable()
+], NDJSONStreamManager);
+export { NDJSONStreamManager };

package/dist/esm/utils/http/SSEStreamManager.d.ts

@@ -0,0 +1,12 @@
+import type { HTTPAPICallExecutorResBody, Worker } from '../../std/index.js';
+type Encoding = 'utf-8';
+interface I<D extends object = object> {
+    encoding?: Encoding | undefined;
+    onData: (data: D) => Promise<void>;
+    reader: ReturnType<HTTPAPICallExecutorResBody['getReader']>;
+}
+export declare class SSEStreamManager implements Worker<I, Promise<void>> {
+    private static DEFAULT_ENCODING;
+    exec({ encoding, onData, reader, }: I): Promise<void>;
+}
+export {};

package/dist/esm/utils/http/SSEStreamManager.js

@@ -0,0 +1,57 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var SSEStreamManager_1;
+import { injectable } from 'inversify';
+import { throwCustomError } from '../../error/index.js';
+import { isSSEError, parseDataLine, SSE_DATA_SEP, SSE_MSG_SEP } from './sse.js';
+let SSEStreamManager = class SSEStreamManager {
+    static { SSEStreamManager_1 = this; }
+    static DEFAULT_ENCODING = 'utf-8';
+    async exec({ encoding = SSEStreamManager_1.DEFAULT_ENCODING, onData, reader, }) {
+        const decoder = new TextDecoder(encoding);
+        let buffer = '';
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done) {
+                return;
+            }
+            buffer += decoder.decode(value, { stream: true });
+            const parts = buffer.split(SSE_MSG_SEP);
+            // Remove the last part that is potentially not complete yet.
+            buffer = parts.pop() ?? '';
+            for (const part of parts) {
+                const lines = part.split(SSE_DATA_SEP);
+                let data = '';
+                for (const line of lines) {
+                    data += parseDataLine(line);
+                }
+                if (!data) {
+                    continue;
+                }
+                let parsedData;
+                try {
+                    parsedData = JSON.parse(data);
+                }
+                catch (_err) {
+                    // Ignore invalid message
+                    continue;
+                }
+                if (isSSEError(parsedData)) {
+                    const { message, status } = parsedData;
+                    throwCustomError(message, status);
+                }
+                else {
+                    onData(parsedData);
+                }
+            }
+        }
+    }
+};
+SSEStreamManager = SSEStreamManager_1 = __decorate([
+    injectable()
+], SSEStreamManager);
+export { SSEStreamManager };

package/dist/esm/utils/http/nd-json.d.ts

@@ -0,0 +1 @@
+export declare const NDJSON_DATA_SEP = "\n";

package/dist/esm/utils/http/nd-json.js

@@ -0,0 +1,2 @@
+// https://github.com/ndjson/ndjson-spec
+export const NDJSON_DATA_SEP = '\n';

package/dist/esm/utils/http/sse.d.ts

@@ -0,0 +1,14 @@
+import type { ErrorMessage, HTTPStatusNumber } from '../../dt/index.js';
+export declare const SSE_HEADERS: [string, string][];
+export declare const SSE_DATA_PREFIX = "data:";
+export declare const SSE_DATA_SEP = "\n";
+export declare const SSE_MSG_SEP = "\n\n";
+export type SSEStreamDataCleanUpFunc = () => void;
+export interface SSEError {
+    message: ErrorMessage;
+    status: HTTPStatusNumber;
+}
+export declare function fmtSSEError(err: SSEError): string;
+export declare function fmtSingleDataMsg<D extends object = object>(data: D): string;
+export declare function isSSEError(err: unknown): err is SSEError;
+export declare function parseDataLine(line: string): string;

package/dist/esm/utils/http/sse.js

@@ -0,0 +1,24 @@
+// https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events
+export const SSE_HEADERS = [
+    ['Cache-Control', 'no-cache'],
+    ['Content-Type', 'text/event-stream'],
+    ['Connection', 'keep-alive'],
+];
+export const SSE_DATA_PREFIX = 'data:';
+export const SSE_DATA_SEP = '\n';
+export const SSE_MSG_SEP = '\n\n';
+export function fmtSSEError(err) {
+    return `${SSE_DATA_PREFIX} ${JSON.stringify(err)}${SSE_MSG_SEP}`;
+}
+export function fmtSingleDataMsg(data) {
+    return `${SSE_DATA_PREFIX} ${JSON.stringify(data)}${SSE_MSG_SEP}`;
+}
+export function isSSEError(err) {
+    return 'message' in err && 'status' in err;
+}
+export function parseDataLine(line) {
+    if (!line.startsWith(SSE_DATA_PREFIX)) {
+        return '';
+    }
+    return `${line.slice(SSE_DATA_PREFIX.length).trim()}${SSE_DATA_SEP}`;
+}

package/dist/esm/utils/http/status.d.ts

@@ -0,0 +1,4 @@
+import type { HTTPStatusNumber } from '../../dt/index.js';
+export declare function isError(status: HTTPStatusNumber): boolean;
+export declare function isClientError(status: HTTPStatusNumber): boolean;
+export declare function isServerError(status: HTTPStatusNumber): boolean;

package/dist/esm/utils/http/status.js

@@ -0,0 +1,9 @@
+export function isError(status) {
+    return status >= 400;
+}
+export function isClientError(status) {
+    return status >= 400 && status < 500;
+}
+export function isServerError(status) {
+    return status >= 500;
+}

package/dist/esm/utils/index.d.ts

@@ -1,17 +1,23 @@
 export { sleep } from './async/sleep.js';
+export type { AbortFunc, RegisterAbortFunc } from './async/types.js';
 export type { Clearable } from './concerns/Clearable.js';
 export type { Initializable } from './concerns/Initializable.js';
 export type { SrcImporter } from './esm/srcImporter.js';
 export { fromFormData, toFormData } from './http/form-data.js';
 export { HTTPRequestBuilder } from './http/HTTPRequestBuilder.js';
 export { toJSON } from './http/json.js';
+export { NDJSONStreamManager } from './http/NDJSONStreamManager.js';
 export { fromQueryParams, toQueryParams } from './http/query-params.js';
+export { SSEStreamManager } from './http/SSEStreamManager.js';
+export { fmtSingleDataMsg, fmtSSEError, isSSEError, parseDataLine, SSE_HEADERS, } from './http/sse.js';
+export { isClientError, isError, isServerError } from './http/status.js';
 export type { HTTPDataEnvelope, HTTPReqData } from './http/types.js';
 export { bindProvider } from './ioc/bindProvider.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
 export type { Class } from './ioc/types.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';
 export { baseFromSquareUnit, type CoreUnit, isSquareUnit, type SquareableUnit, type SquareUnit, type Unit, } from './numbers/units.js';
+export type { StreamConfig, StreamOnClose, StreamOnData, StreamOnDone, } from './streams/types.js';
 export { capitalize, isCapitalized } from './strings/capitalize.js';
 export { humanize } from './strings/humanize.js';
 export { truncate } from './strings/truncate.js';

package/dist/esm/utils/index.js

@@ -2,7 +2,11 @@ export { sleep } from './async/sleep.js';
 export { fromFormData, toFormData } from './http/form-data.js';
 export { HTTPRequestBuilder } from './http/HTTPRequestBuilder.js';
 export { toJSON } from './http/json.js';
+export { NDJSONStreamManager } from './http/NDJSONStreamManager.js';
 export { fromQueryParams, toQueryParams } from './http/query-params.js';
+export { SSEStreamManager } from './http/SSEStreamManager.js';
+export { fmtSingleDataMsg, fmtSSEError, isSSEError, parseDataLine, SSE_HEADERS, } from './http/sse.js';
+export { isClientError, isError, isServerError } from './http/status.js';
 export { bindProvider } from './ioc/bindProvider.js';
 export { CONTAINER_OPTS } from './ioc/container.js';
 export { fmt as fmtNumber } from './numbers/fmt.js';

package/dist/esm/utils/streams/types.d.ts

@@ -0,0 +1,17 @@
+export type StreamOnClose = () => Promise<void>;
+export type StreamOnData<D extends object> = (data: D) => Promise<void>;
+export type StreamOnDone = () => Promise<void>;
+export interface StreamConfig<D extends object> {
+    /**
+     * When the consumer closes the stream
+     */
+    onClose: StreamOnClose;
+    /**
+     * When the provider sends data
+     */
+    onData: StreamOnData<D>;
+    /**
+     * When the provider is done sending data
+     */
+    onDone: StreamOnDone;
+}

package/dist/esm/utils/streams/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "libmodulor",
     "description": "A TypeScript library to create platform-agnostic applications",
-    "version": "0.20.0",
+    "version": "0.22.0",
     "license": "LGPL-3.0",
     "author": "Chafik H'nini <chafik.hnini@gmail.com>",
     "homepage": "https://libmodulor.c100k.eu",
@@ -81,31 +81,31 @@
         "lint:ci": "biome check"
     },
     "devDependencies": {
-        "@biomejs/biome": "^2.1.2"
+        "@biomejs/biome": "^2.2.7"
     },
     "peerDependencies": {
-        "@hono/node-server": "^1.17.1",
-        "@modelcontextprotocol/sdk": "^1.16.0",
-        "@stricli/core": "^1.2.0",
+        "@hono/node-server": "^1.19.5",
+        "@modelcontextprotocol/sdk": "^1.20.1",
+        "@stricli/core": "^1.2.4",
         "buffer": "^6.0.3",
         "cookie-parser": "^1.4.7",
         "express": "^5.1.0",
         "express-fileupload": "^1.5.2",
-        "fast-check": "^4.2.0",
+        "fast-check": "^4.3.0",
         "helmet": "^8.1.0",
-        "hono": "^4.8.5",
-        "inversify": "^7.6.1",
-        "jose": "^6.0.12",
+        "hono": "^4.10.2",
+        "inversify": "^7.10.3",
+        "jose": "^6.1.0",
         "knex": "^3.1.0",
-        "next": "^15.4.2",
+        "next": "^15.5.6",
         "pg": "^8.16.3",
-        "react": "^19.1.0",
-        "react-dom": "^19.1.0",
-        "react-native": "^0.79.5",
+        "react": "^19.2.0",
+        "react-dom": "^19.2.0",
+        "react-native": "^0.81.5",
         "reflect-metadata": "^0.2.2",
         "sqlite3": "^5.1.7",
-        "typescript": "^5.8.3",
-        "vite": "^6.3.5",
+        "typescript": "^5.9.3",
+        "vite": "^6.4.1",
         "vitest": "^3.2.4"
     },
     "peerDependenciesMeta": {

package/pnpm-workspace.yaml

@@ -1,3 +1,4 @@
+minimumReleaseAge: 2880
 packages:
   - examples/basic
   - examples/standalone