vortez-io 1.0.0

package/build/VIO.js

@@ -0,0 +1,219 @@
+import { Events } from "@netfeez/common";
+import RequestManager from "./RequestManager.js";
+import VIOError from "./VIOError.js";
+import Frame from "./Frame.js";
+import UTF8Codec from "./support/UTF8Codec.js";
+import LineCodec from "./support/LineParser.js";
+export class VIO extends Events {
+    mRequest;
+    vTransport;
+    constructor(dependencies) {
+        super();
+        this.mRequest = new RequestManager(dependencies);
+        this.mRequest.on('error', (error) => this.emit('error', error));
+        this.mRequest.on('send', this.sendRequest.bind(this));
+        this.vTransport = new Events.Emitter();
+    }
+    get transport() { return this.vTransport; }
+    async request(data, options) {
+        return this.mRequest.send(data, options);
+    }
+    event(name, data) {
+        this.sendEvent(name, data);
+    }
+    handle(data) {
+        try {
+            const frame = Frame.decode(data);
+            switch (frame.type) {
+                case 'RAW':
+                    this.handleRaw(frame);
+                    break;
+                case 'EVENT':
+                    this.handleEvent(frame);
+                    break;
+                case 'REQUEST':
+                    this.handleRequest(frame);
+                    break;
+                case 'RESPONSE':
+                    this.handleResponse(frame);
+                    break;
+                case 'ERROR':
+                    this.handleError(frame);
+                    break;
+                default:
+                    this.sendError(new VIOError(VIOError.Code.INVALID_DATA, 'Unknown frame type'));
+                    break;
+            }
+        }
+        catch (error) {
+            this.emit('error', error instanceof VIOError ? error : new VIOError(VIOError.Code.INVALID_DATA, 'Failed to decode frame'));
+        }
+    }
+    async handleRaw(frame) {
+        this.emit('raw', frame);
+    }
+    async handleEvent(frame) {
+        try {
+            if (frame.mode == 'BINARY' || frame.mode == 'CUSTOM') {
+                const data = new Uint8Array(frame.data);
+                this.emit('event', frame.identifier.id, frame.mode, data);
+            }
+            else if (frame.mode == 'JSON') {
+                const json = UTF8Codec.decode(new Uint8Array(frame.data));
+                const data = JSON.parse(json);
+                this.emit('event', frame.identifier.id, frame.mode, data);
+            }
+            else if (frame.mode == 'LINE') {
+                const data = LineCodec.decode(frame.data);
+                this.emit('event', frame.identifier.id, frame.mode, data);
+            }
+            else
+                this.sendError(new VIOError(VIOError.Code.UNKNOWN_MODE, `Unknown mode: ${frame.mode}`));
+        }
+        catch (error) {
+            this.emit('error', error instanceof VIOError ? error : new VIOError(VIOError.Code.INVALID_DATA, 'Failed to process event data'));
+        }
+    }
+    async handleRequest(frame) {
+        if (!frame.identifier.id)
+            return this.sendError(new VIOError(VIOError.Code.INVALID_HEADER, 'Request frame missing UUID'));
+        const uuid = frame.identifier.id;
+        try {
+            if (frame.mode == 'BINARY' || frame.mode == 'CUSTOM') {
+                const data = new Uint8Array(frame.data);
+                const done = (data) => this.sendResponse(uuid, data);
+                const fail = (error) => this.sendError(error, uuid);
+                this.emit('request', frame.mode, data, done, fail);
+            }
+            else if (frame.mode == 'JSON') {
+                const json = UTF8Codec.decode(new Uint8Array(frame.data));
+                const data = JSON.parse(json);
+                const done = (data) => this.sendResponse(uuid, data);
+                const fail = (error) => this.sendError(error, uuid);
+                this.emit('request', frame.mode, data, done, fail);
+            }
+            else if (frame.mode == 'LINE') {
+                const data = LineCodec.decode(frame.data);
+                const done = (data) => this.sendResponse(uuid, data);
+                const fail = (error) => this.sendError(error, uuid);
+                this.emit('request', frame.mode, data, done, fail);
+            }
+            else
+                this.sendError(new VIOError(VIOError.Code.UNKNOWN_MODE, `Unknown mode: ${frame.mode}`), uuid);
+        }
+        catch (error) {
+            this.sendError(new VIOError(VIOError.Code.INVALID_DATA, 'Failed to process request data'), uuid);
+        }
+    }
+    async handleResponse(frame) {
+        if (!frame.identifier.id)
+            return this.sendError(new VIOError(VIOError.Code.INVALID_HEADER, 'Response frame missing UUID'));
+        try {
+            if (frame.mode == 'BINARY' || frame.mode == 'CUSTOM') {
+                const data = new Uint8Array(frame.data);
+                this.mRequest.handle(frame.identifier.id, { mode: frame.mode, data });
+            }
+            else if (frame.mode == 'JSON') {
+                const json = UTF8Codec.decode(new Uint8Array(frame.data));
+                const data = JSON.parse(json);
+                this.mRequest.handle(frame.identifier.id, { mode: 'JSON', data });
+            }
+            else if (frame.mode == 'LINE') {
+                const data = LineCodec.decode(frame.data);
+                this.mRequest.handle(frame.identifier.id, { mode: 'LINE', data });
+            }
+            else
+                this.mRequest.handle(frame.identifier.id, undefined, new VIOError(VIOError.Code.UNKNOWN_MODE, `Unknown mode: ${frame.mode}`));
+        }
+        catch (error) {
+            this.mRequest.handle(frame.identifier.id, undefined, new VIOError(VIOError.Code.INVALID_DATA, 'Failed to process response data'));
+        }
+    }
+    async handleError(frame) {
+        try {
+            if (frame.identifier.type === 'NONE') {
+                const error = new VIOError(VIOError.Code.INVALID_DATA, 'Unknown error');
+                return this.emit('error', error);
+            }
+            if (frame.mode == 'BINARY' || frame.mode == 'CUSTOM') {
+                const data = new Uint8Array(frame.data);
+                const error = new VIOError(VIOError.Code.INVALID_DATA, `Error response with binary data: ${data.length} bytes`);
+                this.mRequest.handle(frame.identifier.id, undefined, error);
+            }
+            else if (frame.mode == 'JSON') {
+                const json = UTF8Codec.decode(new Uint8Array(frame.data));
+                const data = JSON.parse(json);
+                const error = new VIOError(VIOError.Code.INVALID_DATA, data.error || 'Unknown error');
+                this.mRequest.handle(frame.identifier.id, undefined, error);
+            }
+            else if (frame.mode == 'LINE') {
+                const data = LineCodec.decode(frame.data);
+                const error = new VIOError(VIOError.Code.INVALID_DATA, `Error response with line data: ${JSON.stringify(data)}`);
+                this.mRequest.handle(frame.identifier.id, undefined, error);
+            }
+            else {
+                const error = new VIOError(VIOError.Code.UNKNOWN_MODE, `Unknown mode: ${frame.mode}`);
+                this.mRequest.handle(frame.identifier.id, undefined, error);
+            }
+        }
+        catch (error) {
+            const vioError = new VIOError(VIOError.Code.INVALID_DATA, 'Failed to process error data');
+            if (frame.identifier.type === 'UUID')
+                this.mRequest.handle(frame.identifier.id, undefined, vioError);
+            this.emit('error', vioError);
+        }
+    }
+    sendEvent(name, data, mode) {
+        const { content, finalMode } = this.serialize(data, mode);
+        const frame = Frame.encode('EVENT', finalMode, content, { type: 'STRING', id: name });
+        try {
+            this.vTransport.emit('send', frame);
+        }
+        catch (err) {
+            this.vTransport.emit('transport:error', err instanceof Error ? err : new Error(String(err)), { stage: 'send', frameType: 'EVENT', info: { name } });
+        }
+    }
+    sendRequest(uuid, data, mode) {
+        const { content, finalMode } = this.serialize(data, mode);
+        const frame = Frame.encode('REQUEST', finalMode, content, { type: 'UUID', id: uuid });
+        try {
+            this.vTransport.emit('send', frame);
+        }
+        catch (err) {
+            this.vTransport.emit('transport:error', err instanceof Error ? err : new Error(String(err)), { stage: 'send', frameType: 'REQUEST', uuid, info: {} });
+        }
+    }
+    sendResponse(uuid, data, mode) {
+        const { content, finalMode } = this.serialize(data, mode);
+        const frame = Frame.encode('RESPONSE', finalMode, content, { type: 'UUID', id: uuid });
+        try {
+            this.vTransport.emit('send', frame);
+        }
+        catch (err) {
+            this.vTransport.emit('transport:error', err instanceof Error ? err : new Error(String(err)), { stage: 'send', frameType: 'RESPONSE', uuid, info: {} });
+        }
+    }
+    sendError(error, uuid) {
+        const json = JSON.stringify({ error: error.message, code: error.code });
+        const content = UTF8Codec.encode(json);
+        const frame = Frame.encode('ERROR', 'JSON', content, uuid ? { type: 'UUID', id: uuid } : { type: 'NONE' });
+        try {
+            this.vTransport.emit('send', frame);
+        }
+        catch (err) {
+            this.vTransport.emit('transport:error', err instanceof Error ? err : new Error(String(err)), { stage: 'send', frameType: 'ERROR', uuid, info: {} });
+        }
+    }
+    serialize(data, mode) {
+        if (data instanceof Uint8Array)
+            return { content: data, finalMode: 'BINARY' };
+        if (data instanceof ArrayBuffer)
+            return { content: new Uint8Array(data), finalMode: 'BINARY' };
+        if (mode === 'LINE')
+            return { content: LineCodec.encode(data), finalMode: 'LINE' };
+        const json = JSON.stringify(data ?? {});
+        return { content: UTF8Codec.encode(json), finalMode: 'JSON' };
+    }
+}
+export default VIO;
+//# sourceMappingURL=VIO.js.map

package/build/VIO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VIO.js","sourceRoot":"","sources":["../src/VIO.ts"],"names":[],"mappings":"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"}

package/build/VIOError.d.ts

@@ -0,0 +1,17 @@
+export declare class VIOError extends Error {
+    name: string;
+    code: VIOError.Code;
+    constructor(code: VIOError.Code, message: string);
+    toString(): string;
+}
+export declare namespace VIOError {
+    enum Code {
+        INVALID_HEADER = "INVALID_HEADER",
+        INVALID_UUID = "INVALID_UUID",
+        INVALID_DATA = "INVALID_DATA",
+        UNKNOWN_TYPE = "UNKNOWN_TYPE",
+        UNKNOWN_MODE = "UNKNOWN_MODE",
+        BUFFER_TOO_SHORT = "BUFFER_TOO_SHORT"
+    }
+}
+export default VIOError;

package/build/VIOError.js

@@ -0,0 +1,25 @@
+export class VIOError extends Error {
+    name = 'VIOError';
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'VIOError';
+        this.code = code;
+    }
+    toString() {
+        return `${this.name} [${this.code}]: ${this.message}`;
+    }
+}
+(function (VIOError) {
+    let Code;
+    (function (Code) {
+        Code["INVALID_HEADER"] = "INVALID_HEADER";
+        Code["INVALID_UUID"] = "INVALID_UUID";
+        Code["INVALID_DATA"] = "INVALID_DATA";
+        Code["UNKNOWN_TYPE"] = "UNKNOWN_TYPE";
+        Code["UNKNOWN_MODE"] = "UNKNOWN_MODE";
+        Code["BUFFER_TOO_SHORT"] = "BUFFER_TOO_SHORT";
+    })(Code = VIOError.Code || (VIOError.Code = {}));
+})(VIOError || (VIOError = {}));
+export default VIOError;
+//# sourceMappingURL=VIOError.js.map

package/build/VIOError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VIOError.js","sourceRoot":"","sources":["../src/VIOError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,GAAW,UAAU,CAAC;IAC1B,IAAI,CAAgB;IAC3B,YAAmB,IAAmB,EAAE,OAAe;QAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QACtE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IACM,QAAQ;QACX,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IAC1D,CAAC;CACJ;AACD,WAAiB,QAAQ;IACrB,IAAY,IAOX;IAPD,WAAY,IAAI;QACZ,yCAAiC,CAAA;QACjC,qCAA6B,CAAA;QAC7B,qCAA6B,CAAA;QAC7B,qCAA6B,CAAA;QAC7B,qCAA6B,CAAA;QAC7B,6CAAqC,CAAA;IACzC,CAAC,EAPW,IAAI,GAAJ,aAAI,KAAJ,aAAI,QAOf;AACL,CAAC,EATgB,QAAQ,KAAR,QAAQ,QASxB;AACD,eAAe,QAAQ,CAAC"}

package/build/VIOStrict.d.ts

@@ -0,0 +1,62 @@
+import { Events, Schema } from "@netfeez/common";
+import RequestManager from "./RequestManager.js";
+import VIO from "./VIO.js";
+import VIOError from "./VIOError.js";
+import { Frame } from "./Frame.js";
+export declare const RRSchema: Schema.Utils.FromObject<{
+    readonly name: {
+        readonly type: "string";
+        readonly required: true;
+    };
+    readonly content: {
+        readonly type: "object";
+        readonly required: true;
+    };
+}, undefined>;
+export declare class VIOStrict<const T extends any, const IEMap extends VIOStrict.EMap, const OEMap extends VIOStrict.EMap, const IRRMap extends VIOStrict.RRMap, const ORRMap extends VIOStrict.RRMap> {
+    protected inEMap: IEMap;
+    protected outEMap: OEMap;
+    protected inRRMap: IRRMap;
+    protected outRRMap: ORRMap;
+    protected readonly VIO: VIO<T>;
+    protected readonly vioEmitter: Events.Emitter<VIOStrict.VIOEventMap>;
+    protected readonly eventEmitter: Events.Emitter<VIOStrict.EventMap<IEMap>>;
+    protected readonly requestEmitter: Events.Emitter<VIOStrict.ReqEventMap<IRRMap>>;
+    constructor(dependencies: RequestManager.DEPENDENCIES<T>, inEMap: IEMap, outEMap: OEMap, inRRMap: IRRMap, outRRMap: ORRMap);
+    get trp(): Events<VIO.TransportEventMap>;
+    get vio(): Events<VIOStrict.VIOEventMap>;
+    get evt(): Events<VIOStrict.EventMap<IEMap>>;
+    get rqt(): Events<VIOStrict.ReqEventMap<IRRMap>>;
+    event<Name extends string & keyof OEMap>(name: Name, data: OEMap[Name]['infer']): void;
+    request<id extends string & keyof ORRMap>(action: id, data: ORRMap[id]['request']['inferToProcess'], options?: RequestManager.SendOptions): Promise<ORRMap[id]['response']['infer']>;
+    handle(data: ArrayBuffer | Uint8Array): void;
+    protected eventHandler(name: string, _mode: Frame.Mode, data: any): void;
+    protected requestHandler(mode: Frame.Mode, data: any, done: (data: any) => void, fail: (error: VIOError) => void): void;
+}
+export declare namespace VIOStrict {
+    interface EMap {
+        [name: string]: Schema<Schema.Property>;
+    }
+    interface RREntry {
+        request: Schema<Schema.Definition.Object>;
+        response: Schema<Schema.Definition.Object>;
+    }
+    interface RRMap {
+        [name: string]: RREntry;
+    }
+    type VIOEventMap = {
+        error: [error: VIOError];
+        raw: [frame: Frame];
+    };
+    type ReqEventMap<RRMap extends VIOStrict.RRMap> = {
+        [Name in string & keyof RRMap]: [
+            data: RRMap[Name]['request']['infer'],
+            respond: (data: RRMap[Name]['response']['inferToProcess']) => void,
+            reject: (error: VIOError) => void
+        ];
+    };
+    type EventMap<EMap extends VIOStrict.EMap> = {
+        [Name in string & keyof EMap]: [data: EMap[Name]['infer']];
+    };
+}
+export default VIOStrict;

package/build/VIOStrict.js

@@ -0,0 +1,103 @@
+import { Events, Schema } from "@netfeez/common";
+import VIO from "./VIO.js";
+import VIOError from "./VIOError.js";
+export const RRSchema = Schema.fromObject({
+    name: { type: 'string', required: true },
+    content: { type: 'object', required: true }
+});
+export class VIOStrict {
+    inEMap;
+    outEMap;
+    inRRMap;
+    outRRMap;
+    VIO;
+    vioEmitter;
+    eventEmitter;
+    requestEmitter;
+    constructor(dependencies, inEMap, outEMap, inRRMap, outRRMap) {
+        this.inEMap = inEMap;
+        this.outEMap = outEMap;
+        this.inRRMap = inRRMap;
+        this.outRRMap = outRRMap;
+        this.VIO = new VIO(dependencies);
+        this.vioEmitter = new Events.Emitter();
+        this.eventEmitter = new Events.Emitter();
+        this.requestEmitter = new Events.Emitter();
+        this.VIO.on('event', this.eventHandler.bind(this));
+        this.VIO.on('request', this.requestHandler.bind(this));
+        this.VIO.on('raw', (frame) => this.vioEmitter.emit('raw', frame));
+        this.VIO.on('error', (error) => this.vioEmitter.emit('error', error));
+    }
+    get trp() { return this.VIO.transport; }
+    get vio() { return this.vioEmitter; }
+    get evt() { return this.eventEmitter; }
+    get rqt() { return this.requestEmitter; }
+    event(name, data) {
+        const schema = this.outEMap[name];
+        if (!schema)
+            throw new VIOError(VIOError.Code.UNKNOWN_TYPE, `Unknown event type: ${String(name)}`);
+        const processedData = schema.processData(data);
+        this.VIO.event(name, processedData);
+    }
+    async request(action, data, options) {
+        const { request: RQS, response: RSS } = this.outRRMap[action];
+        if (!RQS)
+            throw new VIOError(VIOError.Code.UNKNOWN_TYPE, `Unknown request type: ${String(action)}`);
+        if (!RSS)
+            throw new VIOError(VIOError.Code.UNKNOWN_TYPE, `Unknown response type: ${String(action)}`);
+        const readyData = RQS.processData(data);
+        const toSend = RRSchema.processData({ name: action, content: readyData });
+        const response = await this.VIO.request(toSend, options);
+        if (response.mode !== 'JSON')
+            throw new VIOError(VIOError.Code.INVALID_DATA, `Invalid response mode: ${response.mode}`);
+        const parsed = RRSchema.processData(response.data);
+        if (parsed.name !== action)
+            throw new VIOError(VIOError.Code.INVALID_DATA, `Response action mismatch: expected ${action}, got ${parsed.name}`);
+        return RSS.processData(parsed.content);
+    }
+    handle(data) {
+        this.VIO.handle(data);
+    }
+    eventHandler(name, _mode, data) {
+        const schema = this.inEMap[name];
+        if (!schema)
+            throw new VIOError(VIOError.Code.UNKNOWN_TYPE, `Unknown event type: ${String(name)}`);
+        const processedData = schema.processData(data);
+        this.eventEmitter.emit(name, processedData);
+    }
+    requestHandler(mode, data, done, fail) {
+        if (mode !== 'JSON')
+            return fail(new VIOError(VIOError.Code.INVALID_DATA, `Invalid request mode: ${mode}`));
+        const parsed = RRSchema.processData(data);
+        const { name, content } = parsed;
+        const rrEntry = this.inRRMap[name];
+        if (!rrEntry)
+            return fail(new VIOError(VIOError.Code.UNKNOWN_TYPE, `Unknown request type: ${String(name)}`));
+        const { request: RQS, response: RSS } = rrEntry;
+        if (!RQS)
+            return fail(new VIOError(VIOError.Code.UNKNOWN_TYPE, `Missing request schema for type: ${String(name)}`));
+        if (!RSS)
+            return fail(new VIOError(VIOError.Code.UNKNOWN_TYPE, `Missing response schema for type: ${String(name)}`));
+        let processedRequest;
+        try {
+            processedRequest = RQS.processData(content);
+        }
+        catch (error) {
+            return fail(new VIOError(VIOError.Code.INVALID_DATA, `Failed to process request data for type ${String(name)}: ${error.message}`));
+        }
+        const respond = (responseData) => {
+            let readyResponse;
+            try {
+                readyResponse = RSS.processData(responseData);
+            }
+            catch (error) {
+                return fail(new VIOError(VIOError.Code.INVALID_DATA, `Failed to process response data for type ${String(name)}: ${error.message}`));
+            }
+            const toSend = RRSchema.processData({ name, content: readyResponse });
+            done(toSend);
+        };
+        this.requestEmitter.emit(name, processedRequest, respond, fail);
+    }
+}
+export default VIOStrict;
+//# sourceMappingURL=VIOStrict.js.map

package/build/VIOStrict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VIOStrict.js","sourceRoot":"","sources":["../src/VIOStrict.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,4 @@
+export { VIO, VIO as default } from "./VIO.js";
+export { VIOStrict } from "./VIOStrict.js";
+export { VIOError } from "./VIOError.js";
+export { Frame } from "./Frame.js";

package/build/index.js

@@ -0,0 +1,5 @@
+export { VIO, VIO as default } from "./VIO.js";
+export { VIOStrict } from "./VIOStrict.js";
+export { VIOError } from "./VIOError.js";
+export { Frame } from "./Frame.js";
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/build/support/LineParser.d.ts

@@ -0,0 +1,25 @@
+export declare class LineCodec {
+    /**
+     * Encodes a ContentMap into a Uint8Array containing line-based content.
+     * Each key-value pair in the ContentMap is converted into a block of text where the key is on the first line, followed by the value on subsequent lines.
+     * Lines are separated by \r\n, and key-value pairs are separated by \r\n\r\n.
+     * If a value contains multiple lines, each subsequent line after the first will start with a space character to indicate that it is a continuation of the previous line.
+     * @param data A ContentMap object where each key is a string and each value is the corresponding string value to be encoded.
+     * @returns A Uint8Array containing the UTF-8 encoded line-based content representing the input ContentMap.
+     */
+    static encode(data: LineCodec.ContentMap): Uint8Array;
+    /**
+     * Decodes a Uint8Array containing line-based content into a ContentMap.
+     * The input is expected to be UTF-8 encoded and formatted with lines separated by \r\n, and key-value pairs separated by \r\n\r\n.
+     * Values that span multiple lines should have subsequent lines starting with a space character.
+     * @param content A Uint8Array containing the UTF-8 encoded line-based content.
+     * @returns A ContentMap object where each key is a string and each value is the corresponding string value from the input, with multi-line values properly concatenated.
+     */
+    static decode(content: ArrayBuffer | Uint8Array): LineCodec.ContentMap;
+}
+export declare namespace LineCodec {
+    interface ContentMap {
+        [key: string]: string;
+    }
+}
+export default LineCodec;

package/build/support/LineParser.js

@@ -0,0 +1,50 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gemail.com>
+ * @license Apache-2.0
+ * @description Provides encoding and decoding functionality for line-based content used in the Vortez IO protocol.
+ *              The LineCodec class allows for converting between a ContentMap (a mapping of string keys to string values) and a line-based text format where each key-value pair is represented as a block of text with specific formatting rules.
+ *              This is useful for encoding structured data in a human-readable format that can be easily transmitted and parsed within the Vortez IO protocol.
+ */
+import UTF8Codec from "./UTF8Codec.js";
+export class LineCodec {
+    /**
+     * Encodes a ContentMap into a Uint8Array containing line-based content.
+     * Each key-value pair in the ContentMap is converted into a block of text where the key is on the first line, followed by the value on subsequent lines.
+     * Lines are separated by \r\n, and key-value pairs are separated by \r\n\r\n.
+     * If a value contains multiple lines, each subsequent line after the first will start with a space character to indicate that it is a continuation of the previous line.
+     * @param data A ContentMap object where each key is a string and each value is the corresponding string value to be encoded.
+     * @returns A Uint8Array containing the UTF-8 encoded line-based content representing the input ContentMap.
+     */
+    static encode(data) {
+        let content = '';
+        for (const [key, value] of Object.entries(data)) {
+            const valueProcessed = value.replace(/\r\n/g, '\r\n ');
+            content += `${key}\r\n${valueProcessed}\r\n\r\n`;
+        }
+        return UTF8Codec.encode(content);
+    }
+    /**
+     * Decodes a Uint8Array containing line-based content into a ContentMap.
+     * The input is expected to be UTF-8 encoded and formatted with lines separated by \r\n, and key-value pairs separated by \r\n\r\n.
+     * Values that span multiple lines should have subsequent lines starting with a space character.
+     * @param content A Uint8Array containing the UTF-8 encoded line-based content.
+     * @returns A ContentMap object where each key is a string and each value is the corresponding string value from the input, with multi-line values properly concatenated.
+     */
+    static decode(content) {
+        const view = content instanceof ArrayBuffer ? new Uint8Array(content) : content;
+        const decodedContent = UTF8Codec.decode(view);
+        const lines = decodedContent.split('\r\n\r\n');
+        const result = {};
+        for (const line of lines) {
+            const [key, ...valueParts] = line.split('\r\n');
+            if (!key)
+                continue;
+            const value = valueParts.join('\r\n').replace(/\r\n /g, '\r\n');
+            result[key] = value;
+        }
+        return result;
+    }
+}
+export default LineCodec;
+//# sourceMappingURL=LineParser.js.map

package/build/support/LineParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineParser.js","sourceRoot":"","sources":["../../src/support/LineParser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,MAAM,OAAO,SAAS;IAClB;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,CAAC,IAA0B;QAC3C,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvD,OAAO,IAAI,GAAG,GAAG,OAAO,cAAc,UAAU,CAAC;QACrD,CAAC;QACD,OAAO,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IACD;;;;;;OAMG;IACI,MAAM,CAAC,MAAM,CAAC,OAAiC;QAClD,MAAM,IAAI,GAAG,OAAO,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAChF,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAyB,EAAE,CAAC;QAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAChD,IAAI,CAAC,GAAG;gBAAE,SAAS;YACnB,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ;AAMD,eAAe,SAAS,CAAC"}

package/build/support/UTF8Codec.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@netfeez.dev>
+ * @license Apache-2.0
+ * @description UTF-8 encoder/decoder optimized for:
+ *              - predictable memory usage (pre-allocation)
+ *              - safe decoding (malformed/truncated input)
+ *              - zero external dependencies
+ *
+ * ⚠️ Fully standards-compliant behavior for replacement (U+FFFD)
+ */
+export declare class UTF8Codec {
+    private static readonly REPLACEMENT_CHAR;
+    /**
+     * Encodes a string into a UTF-8 byte array.
+     * @param text The string to encode.
+     * @returns A Uint8Array containing the UTF-8 encoded bytes of the input string.
+     */
+    static encode(text: string): Uint8Array;
+    /**
+     * Decodes a UTF-8 byte array into a string. Malformed sequences are replaced with the Unicode replacement character (U+FFFD).
+     * @param bytes The Uint8Array containing the UTF-8 encoded bytes to decode.
+     * @returns The decoded string, with any malformed sequences replaced by U+FFFD.
+     */
+    static decode(bytes: Uint8Array): string;
+    /**
+     * Writes the UTF-8 encoding of the replacement character (U+FFFD) to the output buffer at the specified offset.
+     * @param out The output buffer to write to.
+     * @param offset The offset in the buffer where the replacement character should be written.
+     * @returns The new offset after writing the replacement character.
+     */
+    protected static writeReplacement(out: Uint8Array, offset: number): number;
+}
+export default UTF8Codec;