vortez-io 1.0.1 → 2.0.0

package/build/strict/VIOStrict.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Strict typed wrapper around VIO event, request, and transport channels.
+ */
+import type Isomorphic from "../support/Isomorphic.js";
+import { Events } from "@netfeez/common";
+import VIO from "../VIO.js";
+import VIOError from "../VIOError.js";
+import Frame from "../Frame.js";
+import EventChannel from "./channel/EventChannel.js";
+import RequestChannel from "./channel/RequestChannel.js";
+import TransportChannel from "./channel/TransportChannel.js";
+export declare class VIOStrict<const TimeoutType extends any, const IEMap extends EventChannel.EMap, const OEMap extends EventChannel.EMap, const IRRMap extends RequestChannel.RRMap, const ORRMap extends RequestChannel.RRMap> extends Events<VIOStrict.EventMap> {
+    protected inEMap: IEMap;
+    protected outEMap: OEMap;
+    protected inRRMap: IRRMap;
+    protected outRRMap: ORRMap;
+    protected readonly VIO: VIO<TimeoutType>;
+    readonly event: EventChannel<TimeoutType, IEMap, OEMap>;
+    readonly request: RequestChannel<TimeoutType, IRRMap, ORRMap>;
+    readonly transport: TransportChannel<TimeoutType>;
+    constructor(dependencies: Isomorphic.DependencyList<TimeoutType>, inEMap: IEMap, outEMap: OEMap, inRRMap: IRRMap, outRRMap: ORRMap);
+    /**
+     * Sends a raw data frame through the transport layer.
+     * This method is used to send data that does not conform to the structured formats defined in the EventChannel or RequestChannel, allowing for more flexible communication when needed.
+     * The data should be provided as a Frame with mode 'RAW', and it will be sent through the VIO instance's transport layer.
+     * @param data The raw data frame to send, which should be a Frame with mode 'RAW'. The method will extract the data from the frame and send it through the transport layer.
+     *
+     * ⚠️ WARNING: Using this method can lead to runtime errors and unexpected behavior if the data is not recognized by the remote side.
+     * Use only when you are certain that the data will be handled correctly on the remote side.
+     *
+     * This is a convenience method: it delegates to `transport.send()` so callers
+     * can either call `vioStrict.raw(...)` or `vioStrict.transport.send(...)`.
+     *
+     * Semantics:
+     * - `raw(...)` / `transport.send(...)` send raw bytes through the transport
+     *   layer (same as sending a `RAW` frame).
+     * - `transport` also re-emits incoming `raw` frames from the underlying
+     *   `VIO` instance; `vioStrict` itself also emits `raw` (duplicated for
+     *   convenience).
+     *
+     * Use `raw` only when you intentionally want to bypass the typed
+     * `event`/`request` channels and exchange transport-level payloads.
+     *
+     * @param data The raw data to be sent, which can be an ArrayBuffer or Uint8Array.
+     */
+    raw(data: ArrayBuffer | Uint8Array): void;
+}
+export declare namespace VIOStrict {
+    type EventMap = {
+        raw: [data: Frame<'RAW'>];
+        error: [error: VIOError];
+    };
+}
+export default VIOStrict;

package/build/strict/VIOStrict.js

@@ -0,0 +1,56 @@
+import { Events } from "@netfeez/common";
+import VIO from "../VIO.js";
+import EventChannel from "./channel/EventChannel.js";
+import RequestChannel from "./channel/RequestChannel.js";
+import TransportChannel from "./channel/TransportChannel.js";
+export class VIOStrict extends Events {
+    inEMap;
+    outEMap;
+    inRRMap;
+    outRRMap;
+    VIO;
+    event;
+    request;
+    transport;
+    constructor(dependencies, inEMap, outEMap, inRRMap, outRRMap) {
+        super();
+        this.inEMap = inEMap;
+        this.outEMap = outEMap;
+        this.inRRMap = inRRMap;
+        this.outRRMap = outRRMap;
+        const vio = new VIO(dependencies);
+        this.VIO = vio;
+        this.event = new EventChannel(vio, inEMap, outEMap);
+        this.request = new RequestChannel(vio, inRRMap, outRRMap);
+        this.transport = new TransportChannel(vio);
+        vio.on('raw', (...args) => this.emit('raw', ...args));
+        vio.on('error', (...args) => this.emit('error', ...args));
+    }
+    /**
+     * Sends a raw data frame through the transport layer.
+     * This method is used to send data that does not conform to the structured formats defined in the EventChannel or RequestChannel, allowing for more flexible communication when needed.
+     * The data should be provided as a Frame with mode 'RAW', and it will be sent through the VIO instance's transport layer.
+     * @param data The raw data frame to send, which should be a Frame with mode 'RAW'. The method will extract the data from the frame and send it through the transport layer.
+     *
+     * ⚠️ WARNING: Using this method can lead to runtime errors and unexpected behavior if the data is not recognized by the remote side.
+     * Use only when you are certain that the data will be handled correctly on the remote side.
+     *
+     * This is a convenience method: it delegates to `transport.send()` so callers
+     * can either call `vioStrict.raw(...)` or `vioStrict.transport.send(...)`.
+     *
+     * Semantics:
+     * - `raw(...)` / `transport.send(...)` send raw bytes through the transport
+     *   layer (same as sending a `RAW` frame).
+     * - `transport` also re-emits incoming `raw` frames from the underlying
+     *   `VIO` instance; `vioStrict` itself also emits `raw` (duplicated for
+     *   convenience).
+     *
+     * Use `raw` only when you intentionally want to bypass the typed
+     * `event`/`request` channels and exchange transport-level payloads.
+     *
+     * @param data The raw data to be sent, which can be an ArrayBuffer or Uint8Array.
+     */
+    raw(data) { this.transport.send(data); }
+}
+export default VIOStrict;
+//# sourceMappingURL=VIOStrict.js.map

package/build/strict/VIOStrict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VIOStrict.js","sourceRoot":"","sources":["../../src/strict/VIOStrict.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,GAAG,MAAM,WAAW,CAAC;AAI5B,OAAO,YAAY,MAAM,2BAA2B,CAAC;AACrD,OAAO,cAAc,MAAM,6BAA6B,CAAC;AACzD,OAAO,gBAAgB,MAAM,+BAA+B,CAAC;AAE7D,MAAM,OAAO,SAMX,SAAQ,MAA0B;IASlB;IACA;IACA;IACA;IAXK,GAAG,CAAmB;IAEzB,KAAK,CAA0C;IAC/C,OAAO,CAA8C;IACrD,SAAS,CAAgC;IAEzD,YACI,YAAoD,EAC1C,MAAa,EACb,OAAc,EACd,OAAe,EACf,QAAgB;QAC1B,KAAK,EAAE,CAAC;QAJE,WAAM,GAAN,MAAM,CAAO;QACb,YAAO,GAAP,OAAO,CAAO;QACd,YAAO,GAAP,OAAO,CAAQ;QACf,aAAQ,GAAR,QAAQ,CAAQ;QAE1B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QAEf,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAE3C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IACD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACI,GAAG,CAAC,IAA8B,IAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CAClF;AAOD,eAAe,SAAS,CAAC"}

package/build/strict/channel/Channel.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Base abstract channel shared by strict VIO channel implementations.
+ */
+import { Events } from "@netfeez/common";
+import VIO from "../../VIO.js";
+export declare abstract class Channel<TimeoutType extends any, EventMap extends Events.EventMap> extends Events<EventMap> {
+    protected readonly VIO: VIO<TimeoutType>;
+    constructor(VIO: VIO<TimeoutType>);
+    /**
+     * Sends a message through the channel.
+     * The implementation of this method should handle the actual transmission of the message, whether it's through a WebSocket, HTTP request, or any other means.
+     * The arguments and return type can be defined based on the specific requirements of the channel implementation.
+     *
+     * ⚠️ IMPORTANT: The visibility of this method should be carefully considered based on how it will be used within the application.
+     * If the channel is intended to be used internally within a module or class, it may be appropriate to keep this method protected.
+     * However, if the channel needs to be accessed and handled from outside its defining class, it may need to be made public.
+     */
+    protected abstract send(...args: any[]): any;
+    /**
+     * Handles incoming messages for the channel.
+     * The implementation of this method should process the incoming data, validate it, and emit the appropriate events based on the EventMap defined for the channel.
+     * The arguments can be defined based on the specific requirements of the channel implementation, such as the raw data received and any metadata associated with it.
+     *
+     * ⚠️ IMPORTANT: The visibility of this method should be carefully considered based on how it will be used within the application.
+     * If the channel is intended to be used internally within a module or class, it may be appropriate to keep this method protected.
+     * However, if the channel needs to be accessed and handled from outside its defining class, it may need to be made public.
+     */
+    protected abstract handle(...args: any[]): any;
+}
+export declare namespace Channel { }
+export default Channel;

package/build/strict/channel/Channel.js

@@ -0,0 +1,16 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Base abstract channel shared by strict VIO channel implementations.
+ */
+import { Events } from "@netfeez/common";
+export class Channel extends Events {
+    VIO;
+    constructor(VIO) {
+        super();
+        this.VIO = VIO;
+    }
+}
+export default Channel;
+//# sourceMappingURL=Channel.js.map

package/build/strict/channel/Channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Channel.js","sourceRoot":"","sources":["../../../src/strict/channel/Channel.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzC,MAAM,OAAgB,OAGpB,SAAQ,MAAgB;IAEC;IADvB,YACuB,GAAqB;QACxC,KAAK,EAAE,CAAC;QADW,QAAG,GAAH,GAAG,CAAkB;IAC/B,CAAC;CAqBjB;AAED,eAAe,OAAO,CAAC"}

package/build/strict/channel/EventChannel.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Typed event channel for validating inbound and outbound event payloads.
+ */
+import type { Schema } from "@netfeez/common";
+import type VIO from "../../VIO.js";
+import Channel from "./Channel.js";
+import Frame from "../../Frame.js";
+export declare class EventChannel<const TimeoutType extends any, const IEMap extends EventChannel.EMap, const OEMap extends EventChannel.EMap> extends Channel<TimeoutType, EventChannel.EventMap<IEMap>> {
+    protected VIO: VIO<TimeoutType>;
+    protected inEMap: IEMap;
+    protected outEMap: OEMap;
+    constructor(VIO: VIO<TimeoutType>, inEMap: IEMap, outEMap: OEMap);
+    /**
+     * Sends a custom event to the remote side without validating the event name or data against the OEMap.
+     * This method should be used with caution, as it bypasses all type safety and validation checks.
+     * It is recommended to use the send method instead, which ensures that the event name and data conform to the defined schemas in the OEMap.
+     *
+     * ⚠️ WARNING: Using this method can lead to runtime errors and unexpected behavior if the event name or data is not recognized by the remote side.
+     * Use only when you are certain that the event will be handled correctly on the remote side.
+     *
+     * @param name The name of the event to send. Can be any string.
+     * @param data The data to send with the event. Can be any value.
+     */
+    custom(name: string, data: any): void;
+    /**
+     * Sends an event to the remote side.
+     * The event name must be defined in the OEMap, and the data must conform to the schema defined for that event. If the event name is not recognized, or if the data does not conform to the schema, a VIOError will be thrown.
+     * @param name The name of the event to send. Must be a key in the OEMap.
+     * @param data The data to send with the event. Must conform to the schema defined for the event in the OEMap.
+     * @throws VIOError if the event name is not recognized or if the data does not conform to the schema.
+     */
+    send<Name extends string & keyof OEMap>(name: Name, data: OEMap[Name]['infer']): void;
+    /**
+     * Handles incoming events by validating the event name and data against the IEMap, and then emitting the event if it is recognized. If the event name is not recognized, or if the data does not conform to the schema, a VIOError will be thrown.
+     * @param name The name of the incoming event. Must be a key in the IEMap.
+     * @param mode The mode of the incoming frame, which can be used for additional processing if needed.
+     * @param data The data associated with the incoming event. Must conform to the schema defined for the event in the IEMap.
+     * @throws VIOError if the event name is not recognized or if the data does not conform to the schema.
+     */
+    protected handle(name: string, mode: Frame.Mode, data: any): void;
+}
+export declare namespace EventChannel {
+    interface EMap {
+        [name: string]: Schema<Schema.Property>;
+    }
+    type EventMap<EMap extends EventChannel.EMap> = {
+        [Name in string & keyof EMap]: [data: EMap[Name]['infer']];
+    };
+}
+export default EventChannel;

package/build/strict/channel/EventChannel.js

@@ -0,0 +1,58 @@
+import Channel from "./Channel.js";
+import VIOError from "../../VIOError.js";
+export class EventChannel extends Channel {
+    VIO;
+    inEMap;
+    outEMap;
+    constructor(VIO, inEMap, outEMap) {
+        super(VIO);
+        this.VIO = VIO;
+        this.inEMap = inEMap;
+        this.outEMap = outEMap;
+        this.VIO.on('event', this.handle.bind(this));
+    }
+    /**
+     * Sends a custom event to the remote side without validating the event name or data against the OEMap.
+     * This method should be used with caution, as it bypasses all type safety and validation checks.
+     * It is recommended to use the send method instead, which ensures that the event name and data conform to the defined schemas in the OEMap.
+     *
+     * ⚠️ WARNING: Using this method can lead to runtime errors and unexpected behavior if the event name or data is not recognized by the remote side.
+     * Use only when you are certain that the event will be handled correctly on the remote side.
+     *
+     * @param name The name of the event to send. Can be any string.
+     * @param data The data to send with the event. Can be any value.
+     */
+    custom(name, data) {
+        this.VIO.event(name, data);
+    }
+    /**
+     * Sends an event to the remote side.
+     * The event name must be defined in the OEMap, and the data must conform to the schema defined for that event. If the event name is not recognized, or if the data does not conform to the schema, a VIOError will be thrown.
+     * @param name The name of the event to send. Must be a key in the OEMap.
+     * @param data The data to send with the event. Must conform to the schema defined for the event in the OEMap.
+     * @throws VIOError if the event name is not recognized or if the data does not conform to the schema.
+     */
+    send(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);
+    }
+    /**
+     * Handles incoming events by validating the event name and data against the IEMap, and then emitting the event if it is recognized. If the event name is not recognized, or if the data does not conform to the schema, a VIOError will be thrown.
+     * @param name The name of the incoming event. Must be a key in the IEMap.
+     * @param mode The mode of the incoming frame, which can be used for additional processing if needed.
+     * @param data The data associated with the incoming event. Must conform to the schema defined for the event in the IEMap.
+     * @throws VIOError if the event name is not recognized or if the data does not conform to the schema.
+     */
+    handle(name, mode, data) {
+        const schema = this.inEMap[name];
+        if (!schema)
+            throw new VIOError(VIOError.Code.UNKNOWN_TYPE, `Unknown event type: ${String(name)}`);
+        const processed = schema.processData(data);
+        this.emit(name, processed);
+    }
+}
+export default EventChannel;
+//# sourceMappingURL=EventChannel.js.map

package/build/strict/channel/EventChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventChannel.js","sourceRoot":"","sources":["../../../src/strict/channel/EventChannel.ts"],"names":[],"mappings":"AASA,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AAGzC,MAAM,OAAO,YAIX,SAAQ,OAAkD;IAE1C;IACA;IACA;IAHd,YACc,GAAqB,EACrB,MAAa,EACb,OAAc;QACxB,KAAK,CAAC,GAAG,CAAC,CAAC;QAHD,QAAG,GAAH,GAAG,CAAkB;QACrB,WAAM,GAAN,MAAM,CAAO;QACb,YAAO,GAAP,OAAO,CAAO;QAExB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IACD;;;;;;;;;;OAUG;IACI,MAAM,CAAC,IAAY,EAAE,IAAS;QACjC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD;;;;;;OAMG;IACa,IAAI,CAAoC,IAAU,EAAE,IAA0B;QAC1F,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,uBAAuB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnG,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxC,CAAC;IACD;;;;;;OAMG;IACgB,MAAM,CAAC,IAAY,EAAE,IAAgB,EAAE,IAAS;QAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,uBAAuB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnG,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/B,CAAC;CACJ;AASD,eAAe,YAAY,CAAC"}

package/build/strict/channel/RequestChannel.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Typed request channel for request/response validation and dispatch.
+ */
+import { Schema } from "@netfeez/common";
+import VIOError from "../../VIOError.js";
+import VIO from "../../VIO.js";
+import Channel from "./Channel.js";
+import type RequestManager from "../../RequestManager.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 RequestChannel<const TimeoutType extends any, const IRRMap extends RequestChannel.RRMap, const ORRMap extends RequestChannel.RRMap> extends Channel<TimeoutType, RequestChannel.EventMap<IRRMap>> {
+    protected VIO: VIO<TimeoutType>;
+    protected inRRMap: IRRMap;
+    protected outRRMap: ORRMap;
+    constructor(VIO: VIO<TimeoutType>, inRRMap: IRRMap, outRRMap: ORRMap);
+    /**
+     * Sends a request to the remote side and awaits a response. The request action must be defined in the ORRMap, and the request data must conform to the schema defined for that action. If the action is not recognized, or if the request data does not conform to the schema, a VIOError will be thrown. The method returns a promise that resolves with the response data processed according to the schema defined for the response of that action.
+     * @param action The name of the request action to send. Must be a key in the ORRMap.
+     * @param data The data to send with the request. Must conform to the schema defined for the request in the ORRMap.
+     * @param options Optional settings for sending the request, such as timeout duration and retry attempts.
+     * @returns A promise that resolves with the response data processed according to the schema defined for the response of the specified action.
+     * @throws VIOError if the action is not recognized or if the request data does not conform to the schema.
+     */
+    send<Action extends string & keyof ORRMap>(action: Action, data: ORRMap[Action]['request']['inferToProcess'], options?: RequestManager.SendOptions): Promise<ORRMap[Action]['response']['infer']>;
+    /**
+     * Handles incoming requests from the remote side.
+     * The request action must be defined in the IRRMap, and the request data must conform to the schema defined for that action.
+     * If the action is not recognized, or if the request data does not conform to the schema, the fail callback will be called with a VIOError.
+     * If the request is valid, the corresponding event will be emitted with the processed request data, a respond callback for sending the response, and a reject callback for handling errors.
+     * The respond callback should be called with the response data, which will be processed according to the schema defined for the response of that action before being sent back to the requester.
+     * The reject callback should be called with a VIOError if there is an error processing the request or preparing the response.
+     * @param mode The mode of the incoming request, which should be 'JSON' for valid requests.
+     * @param data The raw data of the incoming request, which should be processed according to the schema defined for the request action in the IRRMap.
+     * @param done A callback function that should be called with the response data once it is ready to be sent back to the requester. The response data will be processed according to the schema defined for the response of the request action in the IRRMap before being sent.
+     * @param fail A callback function that should be called with a VIOError if there is an error processing the request or preparing the response. This will send an error response back to the requester.
+     */
+    protected handle(mode: Frame.Mode, data: any, done: (data: any) => void, fail: (error: VIOError) => void): void;
+}
+export declare namespace RequestChannel {
+    interface RREntry {
+        request: Schema<Schema.Definition.Object>;
+        response: Schema<Schema.Definition.Object>;
+    }
+    interface RRMap {
+        [name: string]: RREntry;
+    }
+    type EventMap<RRMap extends RequestChannel.RRMap> = {
+        [Name in string & keyof RRMap]: [
+            data: RRMap[Name]['request']['infer'],
+            respond: (data: RRMap[Name]['response']['inferToProcess']) => void,
+            reject: (error: VIOError) => void
+        ];
+    };
+}
+export default RequestChannel;

package/build/strict/channel/RequestChannel.js

@@ -0,0 +1,96 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Typed request channel for request/response validation and dispatch.
+ */
+import { Schema } from "@netfeez/common";
+import VIOError from "../../VIOError.js";
+import Channel from "./Channel.js";
+export const RRSchema = Schema.fromObject({
+    name: { type: 'string', required: true },
+    content: { type: 'object', required: true }
+});
+export class RequestChannel extends Channel {
+    VIO;
+    inRRMap;
+    outRRMap;
+    constructor(VIO, inRRMap, outRRMap) {
+        super(VIO);
+        this.VIO = VIO;
+        this.inRRMap = inRRMap;
+        this.outRRMap = outRRMap;
+        this.VIO.on('request', this.handle.bind(this));
+    }
+    /**
+     * Sends a request to the remote side and awaits a response. The request action must be defined in the ORRMap, and the request data must conform to the schema defined for that action. If the action is not recognized, or if the request data does not conform to the schema, a VIOError will be thrown. The method returns a promise that resolves with the response data processed according to the schema defined for the response of that action.
+     * @param action The name of the request action to send. Must be a key in the ORRMap.
+     * @param data The data to send with the request. Must conform to the schema defined for the request in the ORRMap.
+     * @param options Optional settings for sending the request, such as timeout duration and retry attempts.
+     * @returns A promise that resolves with the response data processed according to the schema defined for the response of the specified action.
+     * @throws VIOError if the action is not recognized or if the request data does not conform to the schema.
+     */
+    async send(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);
+    }
+    /**
+     * Handles incoming requests from the remote side.
+     * The request action must be defined in the IRRMap, and the request data must conform to the schema defined for that action.
+     * If the action is not recognized, or if the request data does not conform to the schema, the fail callback will be called with a VIOError.
+     * If the request is valid, the corresponding event will be emitted with the processed request data, a respond callback for sending the response, and a reject callback for handling errors.
+     * The respond callback should be called with the response data, which will be processed according to the schema defined for the response of that action before being sent back to the requester.
+     * The reject callback should be called with a VIOError if there is an error processing the request or preparing the response.
+     * @param mode The mode of the incoming request, which should be 'JSON' for valid requests.
+     * @param data The raw data of the incoming request, which should be processed according to the schema defined for the request action in the IRRMap.
+     * @param done A callback function that should be called with the response data once it is ready to be sent back to the requester. The response data will be processed according to the schema defined for the response of the request action in the IRRMap before being sent.
+     * @param fail A callback function that should be called with a VIOError if there is an error processing the request or preparing the response. This will send an error response back to the requester.
+     */
+    handle(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.emit(name, processedRequest, respond, fail);
+    }
+}
+export default RequestChannel;
+//# sourceMappingURL=RequestChannel.js.map

package/build/strict/channel/RequestChannel.js.map

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

package/build/strict/channel/TransportChannel.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Transport channel bridge for raw frame send and receive events.
+ */
+import Frame from "../../Frame.js";
+import VIO from "../../VIO.js";
+import Channel from "./Channel.js";
+export declare class TransportChannel<TimeoutType extends any> extends Channel<TimeoutType, TransportChannel.EventMap> {
+    protected VIO: VIO<TimeoutType>;
+    constructor(VIO: VIO<TimeoutType>);
+    /**
+     * Sends a raw data frame through the transport layer.
+     * This method is used to send data that does not conform to the structured formats defined in the EventChannel or RequestChannel, allowing for more flexible communication when needed.
+     * The data should be provided as a Frame with mode 'RAW', and it will be sent through the VIO instance's transport layer.
+    * @param data The raw data frame to send, which should be a Frame with mode 'RAW'. The method will extract the data from the frame and send it through the transport layer.
+     *
+     * ⚠️ WARNING: Using this method can lead to runtime errors and unexpected behavior if the data is not recognized by the remote side.
+     * Use only when you are certain that the data will be handled correctly on the remote side.
+     *
+    * @param data The raw data to be sended, which can be an ArrayBuffer or Uint8Array.
+     */
+    send(data: ArrayBuffer | Uint8Array): void;
+    /**
+     * Handles incoming raw data frames by passing them to the VIO instance for processing. This method is called when raw data is received from the transport layer, and it should not be called directly by external code. The VIO instance will handle the raw data and emit the appropriate events based on the content of the frame.
+     * @param data The raw data frame received from the transport layer, which can be an ArrayBuffer or Uint8Array.
+     */
+    protected handle(data: ArrayBuffer | Uint8Array): void;
+}
+export declare namespace TransportChannel {
+    type EventMap = {
+        send: [frame: ArrayBuffer];
+        raw: [frame: Frame<'RAW'>];
+        error: [error: Error, context: VIO.ErrorContext];
+    };
+}
+export default TransportChannel;

package/build/strict/channel/TransportChannel.js

@@ -0,0 +1,30 @@
+import Channel from "./Channel.js";
+export class TransportChannel extends Channel {
+    VIO;
+    constructor(VIO) {
+        super(VIO);
+        this.VIO = VIO;
+        this.VIO.transport.on('send', (...args) => this.emit('send', ...args));
+        this.VIO.transport.on('error', (...args) => this.emit('error', ...args));
+        this.VIO.on('raw', (...args) => this.emit('raw', ...args));
+    }
+    /**
+     * Sends a raw data frame through the transport layer.
+     * This method is used to send data that does not conform to the structured formats defined in the EventChannel or RequestChannel, allowing for more flexible communication when needed.
+     * The data should be provided as a Frame with mode 'RAW', and it will be sent through the VIO instance's transport layer.
+    * @param data The raw data frame to send, which should be a Frame with mode 'RAW'. The method will extract the data from the frame and send it through the transport layer.
+     *
+     * ⚠️ WARNING: Using this method can lead to runtime errors and unexpected behavior if the data is not recognized by the remote side.
+     * Use only when you are certain that the data will be handled correctly on the remote side.
+     *
+    * @param data The raw data to be sended, which can be an ArrayBuffer or Uint8Array.
+     */
+    send(data) { this.VIO.raw(data); }
+    /**
+     * Handles incoming raw data frames by passing them to the VIO instance for processing. This method is called when raw data is received from the transport layer, and it should not be called directly by external code. The VIO instance will handle the raw data and emit the appropriate events based on the content of the frame.
+     * @param data The raw data frame received from the transport layer, which can be an ArrayBuffer or Uint8Array.
+     */
+    handle(data) { this.VIO.handle(data); }
+}
+export default TransportChannel;
+//# sourceMappingURL=TransportChannel.js.map

package/build/strict/channel/TransportChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportChannel.js","sourceRoot":"","sources":["../../../src/strict/channel/TransportChannel.ts"],"names":[],"mappings":"AAQA,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,MAAM,OAAO,gBAA0C,SAAQ,OAA+C;IACpF;IAAtB,YAAsB,GAAqB;QAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QAApC,QAAG,GAAH,GAAG,CAAkB;QACvC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD;;;;;;;;;;OAUG;IACa,IAAI,CAAC,IAA8B,IAAU,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClF;;;OAGG;IACgB,MAAM,CAAC,IAA8B,IAAU,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CAC7F;AAQD,eAAe,gBAAgB,CAAC"}

package/build/support/Isomorphic.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @module vortez-io
+ * @author NetFeez <netfeez.dev@gmail.com>
+ * @license Apache-2.0
+ * @description Isomorphic dependency types shared across runtime environments.
+ */
+export declare namespace Isomorphic {
+    type TimeoutHandler = () => void | Promise<void>;
+    type setTimeout<T> = (handler: TimeoutHandler, timeout: number) => T;
+    type clearTimeout<T> = (id: T) => void;
+    type createUUID = () => string;
+    interface DependencyList<TimeoutType extends any> {
+        setTimeout: Isomorphic.setTimeout<TimeoutType>;
+        clearTimeout: Isomorphic.clearTimeout<TimeoutType>;
+        createUUID?: Isomorphic.createUUID;
+    }
+}
+export default Isomorphic;

package/build/support/Isomorphic.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Isomorphic.js.map

package/build/support/Isomorphic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Isomorphic.js","sourceRoot":"","sources":["../../src/support/Isomorphic.ts"],"names":[],"mappings":""}

package/build/support/LineParser.js

@@ -1,10 +1,8 @@
 /**
  * @module vortez-io
- * @author NetFeez <netfeez.dev@gemail.com>
+ * @author NetFeez <netfeez.dev@gmail.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.
+ * @description Line-based content encoder and decoder for VIO.
  */
 import UTF8Codec from "./UTF8Codec.js";
 export class LineCodec {

package/build/support/LineParser.js.map

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

@@ -1,13 +1,8 @@
 /**
  * @module vortez-io
- * @author NetFeez <netfeez.dev@netfeez.dev>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @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)
+ * @description UTF-8 encoder and decoder with replacement-character handling.
  */
 export declare class UTF8Codec {
     private static readonly REPLACEMENT_CHAR;

package/build/support/UTF8Codec.js

@@ -1,13 +1,8 @@
 /**
  * @module vortez-io
- * @author NetFeez <netfeez.dev@netfeez.dev>
+ * @author NetFeez <netfeez.dev@gmail.com>
  * @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)
+ * @description UTF-8 encoder and decoder with replacement-character handling.
  */
 export class UTF8Codec {
     static REPLACEMENT_CHAR = '\uFFFD';