@leyyo/common 1.0.13 → 1.2.2

package/dist/event/event.common.js

@@ -0,0 +1,308 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventCommon = void 0;
+const internal_1 = require("../internal");
+const node_events_1 = __importDefault(require("node:events"));
+const event_error_1 = require("./event.error");
+/** @inheritDoc */
+class EventCommon {
+    constructor(lyy) {
+        this.lyy = lyy;
+        this._bufferLimitAll = 0;
+        this.native = new node_events_1.default();
+    }
+    _possibleBufferSize(event) {
+        if (this._bufferLimit.has(event)) {
+            return this._bufferLimit.get(event);
+        }
+        return this._bufferLimitAll;
+    }
+    _checkBasic(event) {
+        return ['string', 'symbol'].includes(typeof event);
+    }
+    _checkEvent(event, method, silent) {
+        if (!['string', 'symbol'].includes(typeof event)) {
+            if (silent) {
+                return false;
+            }
+            throw new event_error_1.EventError('Invalid event name, not allowed type', { where: `${internal_1.FQN}.EventCommon`, method, type: typeof event });
+        }
+        else if (typeof event === 'string' && (event.trim() !== event || event === '')) {
+            throw new event_error_1.EventError('Invalid event name, with space', { where: `${internal_1.FQN}.EventCommon`, method, event });
+        }
+        return true;
+    }
+    _checkCallback(listener, method, silent) {
+        if (typeof listener !== 'function') {
+            if (silent) {
+                return false;
+            }
+            throw new event_error_1.EventError('Invalid event function', { where: `${internal_1.FQN}.EventCommon`, method, type: typeof listener });
+        }
+        return true;
+    }
+    _checkSize(size, method, silent) {
+        if (typeof size !== 'number' || !Number.isInteger(size) || size < 0) {
+            if (silent) {
+                return false;
+            }
+            throw new event_error_1.EventError('Invalid event size', { where: `${internal_1.FQN}.EventCommon`, method, type: typeof size, value: size });
+        }
+        return true;
+    }
+    /** @inheritDoc */
+    get $secure() {
+        return this;
+    }
+    /** @inheritDoc */
+    get $back() {
+        return this;
+    }
+    /** @inheritDoc */
+    $init() {
+        this.lyy.$secure.$lazyRun(() => {
+        });
+        this._bufferLimit = this.lyy.repo.newMap(`${internal_1.FQN}.EventCommon.bufferLimit`);
+        this._listenerMap = this.lyy.repo.newMap(`${internal_1.FQN}.EventCommon.maxListeners`);
+        this._bufferMap = this.lyy.repo.newMap(`${internal_1.FQN}.EventCommon.bufferMap`);
+        this._bufferOnceMap = this.lyy.repo.newMap(`${internal_1.FQN}.EventCommon.bufferOnceMap`);
+    }
+    // region buffer
+    /** @inheritDoc */
+    bufferSize(event, size) {
+        this._checkEvent(event, 'bufferSize');
+        this._checkSize(size, 'bufferSize');
+        this._bufferLimit.set(event, size);
+        return this;
+    }
+    /** @inheritDoc */
+    bufferSizeAll(size) {
+        this._checkSize(size, 'bufferSizeAll');
+        this._bufferLimitAll = size;
+        return this;
+    }
+    /** @inheritDoc */
+    clearBuffer(event) {
+        this._checkEvent(event, 'clearBuffer');
+        let size = 0;
+        if (this._bufferMap.has(event)) {
+            size = this._bufferMap.get(event).length;
+            this._bufferMap.delete(event);
+        }
+        return size;
+    }
+    /** @inheritDoc */
+    clearBufferAll() {
+        let size = 0;
+        Array.from(this._bufferMap.values()).forEach(arr => {
+            size += arr.length;
+        });
+        return size;
+    }
+    /** @inheritDoc */
+    hasBuffer(event) {
+        if (!this._checkBasic(event)) {
+            return false;
+        }
+        return this._bufferMap.has(event);
+    }
+    // endregion buffer
+    // region cast
+    /** @inheritDoc */
+    as() {
+        return this;
+    }
+    // endregion cast
+    // region register
+    _checkListenerSize(event) {
+        if (this._listenerMap.has(event)) {
+            let [max, current] = this._listenerMap.get(event);
+            current++;
+            this._listenerMap.set(event, [max, current]);
+            if (current >= max) {
+                console.log(`Listener size!, event: ${event}, current: ${current}, max: ${max}`);
+            }
+        }
+    }
+    _callBuffer(event, listener) {
+        if (this._bufferMap.has(event)) {
+            this._bufferMap.forEach(args => {
+                listener(...args);
+            });
+            this._bufferMap.delete(event);
+        }
+    }
+    _callBufferOnce(event, listener) {
+        if (this._bufferOnceMap.has(event)) {
+            listener(...this._bufferOnceMap.get(event));
+            this._bufferOnceMap.delete(event);
+        }
+    }
+    /** @inheritDoc */
+    addListener(event, listener) {
+        return this.on(event, listener);
+    }
+    /** @inheritDoc */
+    on(event, listener) {
+        this._checkEvent(event, 'on');
+        this._checkCallback(listener, 'on');
+        this._checkListenerSize(event);
+        this.native.on(event, listener);
+        this._callBuffer(event, listener);
+        return this;
+    }
+    /** @inheritDoc */
+    overwrite(event, listener) {
+        this._checkEvent(event, 'on');
+        this._checkCallback(listener, 'on');
+        this.native.removeAllListeners(event);
+        this.native.on(event, listener);
+        this._callBuffer(event, listener);
+        return this;
+    }
+    /** @inheritDoc */
+    once(event, listener) {
+        this._checkEvent(event, 'once');
+        this._checkCallback(listener, 'once');
+        this.native.once(event, listener);
+        this._callBufferOnce(event, listener);
+        return this;
+    }
+    /** @inheritDoc */
+    prependListener(event, listener) {
+        this._checkEvent(event, 'prependListener');
+        this._checkCallback(listener, 'prependListener');
+        this.native.prependListener(event, listener);
+        return this;
+    }
+    /** @inheritDoc */
+    prependOnceListener(event, listener) {
+        this._checkEvent(event, 'prependOnceListener');
+        this._checkCallback(listener, 'prependOnceListener');
+        this.native.prependOnceListener(event, listener);
+        return this;
+    }
+    // endregion register
+    // region get
+    /** @inheritDoc */
+    eventNames() {
+        return this.native.eventNames();
+    }
+    /** @inheritDoc */
+    getMaxListeners() {
+        return this.native.getMaxListeners();
+    }
+    /** @inheritDoc */
+    listenerCount(event, listener) {
+        this._checkEvent(event, 'listenerCount');
+        return this.native.listenerCount(event, listener);
+    }
+    /** @inheritDoc */
+    listeners(event) {
+        if (!this._checkBasic(event)) {
+            return [];
+        }
+        return this.native.listeners(event);
+    }
+    hasListener(event) {
+        if (!this._checkBasic(event)) {
+            return false;
+        }
+    }
+    /** @inheritDoc */
+    rawListeners(event) {
+        this._checkEvent(event, 'rawListeners');
+        return this.native.rawListeners(event);
+    }
+    // endregion get
+    // region remove
+    /** @inheritDoc */
+    off(event, listener) {
+        this._checkEvent(event, 'off');
+        this._checkCallback(listener, 'off');
+        this._bufferMap.delete(event);
+        this.native.off(event, listener);
+        return this;
+    }
+    /** @inheritDoc */
+    removeAllListeners(event) {
+        if (event !== undefined) {
+            this._checkEvent(event, 'removeListener');
+            this._bufferMap.delete(event);
+        }
+        this.native.removeAllListeners(event);
+        return this;
+    }
+    /** @inheritDoc */
+    removeListener(event, listener, clearBuffer) {
+        this._checkEvent(event, 'removeListener');
+        this._checkCallback(listener, 'removeListener');
+        if (clearBuffer) {
+            this._bufferMap.delete(event);
+        }
+        this.native.removeListener(event, listener);
+        return this;
+    }
+    // endregion remove
+    // region emit
+    /** @inheritDoc */
+    emitOnce(event, ...args) {
+        return false;
+    }
+    /** @inheritDoc */
+    emit(event, ...args) {
+        if (!this._checkBasic(event)) {
+            return false;
+        }
+        if (!this.native.emit(event, ...args)) {
+            const size = this._possibleBufferSize(event);
+            if (!size) {
+                return false;
+            }
+            let buffer;
+            if (!this._bufferMap.has(event)) {
+                buffer = [];
+                this._bufferMap.set(event, buffer);
+            }
+            else {
+                buffer = this._bufferMap.get(event);
+                if (buffer.length === size) {
+                    buffer.shift();
+                }
+            }
+            buffer.push(args);
+            if (!this._bufferOnceMap.has(event)) {
+                this._bufferOnceMap.set(event, args);
+            }
+        }
+        return true;
+    }
+    // endregion emit
+    // region set
+    /** @inheritDoc */
+    setMaxListeners(p1, p2) {
+        let event;
+        let max;
+        if (['string', 'symbol'].includes(typeof p1)) {
+            event = p1;
+            this._checkSize(p2, 'setMaxListeners');
+            max = p2;
+        }
+        else {
+            this._checkSize(p1, 'setMaxListeners');
+            max = p1;
+        }
+        if (!event) {
+            this.native.setMaxListeners(max);
+        }
+        else {
+            this._listenerMap.set(event, [max, 0]);
+        }
+        return this;
+    }
+}
+exports.EventCommon = EventCommon;
+//# sourceMappingURL=event.common.js.map

package/dist/event/event.common.js.map

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

package/dist/event/event.error.d.ts

@@ -0,0 +1,3 @@
+import { InvalidValueError } from "../error";
+export declare class EventError extends InvalidValueError {
+}

package/dist/event/event.error.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventError = void 0;
+const error_1 = require("../error");
+class EventError extends error_1.InvalidValueError {
+}
+exports.EventError = EventError;
+//# sourceMappingURL=event.error.js.map

package/dist/event/event.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.error.js","sourceRoot":"","sources":["../../src/event/event.error.ts"],"names":[],"mappings":";;;AAAA,oCAA2C;AAE3C,MAAa,UAAW,SAAQ,yBAAiB;CAChD;AADD,gCACC"}

package/dist/event/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/event/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/event/index.types.d.ts

@@ -0,0 +1,261 @@
+import type { Fnc, InitLike, ShiftMain, ShiftSecure } from "../shared";
+import EventEmitter from "node:events";
+export interface EventCommonLike<N extends EventNameDef = EventNameDef> extends ShiftSecure<EventCommonSecure<N>> {
+    /**
+     * Native event emitter
+     * */
+    readonly native: EventEmitter;
+    /**
+     * Cast event emitter to easy use with typed event names
+     *
+     * @return {EventCommonLike} - this
+     * */
+    as<M extends EventNameDef>(): EventCommonLike<M>;
+    /**
+     * Buffer size for given event if event was not defined yet
+     *
+     * @param {string} event - event name
+     * @param {number} size - size of buffer
+     * @return {EventCommonLike} - this
+     *
+     * @default `0` so no buffer
+     * */
+    bufferSize(event: N, size: number): EventCommonLike<N>;
+    /**
+     * Buffer size for all events if event was not defined yet
+     *
+     * @param {number} size - size of buffer
+     * @return {EventCommonLike} - this
+     *
+     * @default `0` so no buffer
+     * */
+    bufferSizeAll(size: number): EventCommonLike<N>;
+    /**
+     * Clear buffer for given event
+     *
+     * @param {string} event - event name
+     * @return {number}
+     * */
+    clearBuffer(event: N): number;
+    /**
+     * Clear buffer for given event
+     *
+     * @param {string} event - event name
+     * @return {number}
+     * */
+    hasBuffer(event: N): boolean;
+    /**
+     * Clear buffer for all events
+     *
+     * @return {number}
+     * */
+    clearBufferAll(): number;
+    /**
+     * Adds the listener function to the end of the listeners array for the event named eventName.
+     * No checks are made to see if the listener has already been added.
+     * Multiple calls passing the same combination of eventName and listener will result in the listener being added, and called, multiple times
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.on}
+     * */
+    on(event: N, listener: Fnc): EventCommonLike<N>;
+    /**
+     * Same with {@link on} but, it clears previos listeners
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @return {EventCommonLike} - this
+     * */
+    overwrite(event: N, listener: Fnc): EventCommonLike<N>;
+    /**
+     * Adds a one-time listener function for the event named eventName.
+     * The next time eventName is triggered, this listener is removed and then invoked.
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.once}
+     * */
+    once(event: N, listener: Fnc): EventCommonLike<N>;
+    /**
+     * Alias for emitter
+     * @see #on
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.addListener}
+     * */
+    addListener(event: N, listener: Fnc): EventCommonLike<N>;
+    /**
+     * Synchronously calls each of the listeners registered for the event named eventName,
+     * in the order they were registered, passing the supplied arguments to each.
+     * Returns true if the event had listeners, false otherwise.
+     *
+     * @param {string} event - event name
+     * @param {...any} args - variadic arguments
+     * @return {boolean} - true: if event had listeners
+     *
+     * {@link NodeJS.EventEmitter.emit}
+     * */
+    emit(event: N, ...args: Array<unknown>): boolean;
+    /**
+     * Emit once
+     *
+     * {@link emit}
+     *
+     * @param {string} event - event name
+     * @param {...any} args - variadic arguments
+     * @return {boolean} - true: if event had listeners
+     * */
+    emitOnce(event: N, ...args: Array<unknown>): boolean;
+    /**
+     * Return all registered event names
+     *
+     * @return {Array<string>} - event names
+     *
+     * {@link NodeJS.EventEmitter.eventNames}
+     * */
+    eventNames(): Array<N>;
+    /**
+     * Returns the current max listener value for the EventEmitter which is either set by emitter.
+     * setMaxListeners(n) or defaults to EventEmitter.
+     *
+     * @return {number}
+     *
+     * {@link NodeJS.EventEmitter.getMaxListeners}
+     * */
+    getMaxListeners(): number;
+    /**
+     * Returns the number of listeners listening for the event named eventName.
+     * If listener is provided, it will return how many times the listener is found in the list of the listeners of the event.
+     *
+     * @param {string} event - event name
+     * @param {function?} listener - optional listener
+     * @return {number} - listener counts for given event
+     *
+     * {@link NodeJS.EventEmitter.listenerCount}
+     * */
+    listenerCount(event: N, listener?: Fnc): number;
+    /**
+     * Returns a copy of the array of listeners for the event named eventName.
+     *
+     * @param {string} event - event name
+     * @return {Array<function>} - array of listeners
+     *
+     * {@link NodeJS.EventEmitter.listeners}
+     * */
+    listeners(event: N): Array<Fnc>;
+    /**
+     * Has a listener
+     *
+     * @param {string} event - event name
+     * @return {boolean} - exists?
+     * */
+    hasListener(event: N): boolean;
+    /**
+     * Alias for emitter. removeListener
+     * @see #removeListener
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.off}
+     * */
+    off(event: N, listener: Fnc): EventCommonLike<N>;
+    /**
+     * Adds the listener function to the beginning of the listeners array for the event named eventName.
+     *
+     * No checks are made to see if the listener has already been added.
+     * Multiple calls passing the same combination of eventName and listener will result in the listener being added, and called, multiple times.
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.prependListener}
+     * */
+    prependListener(event: N, listener: Fnc): EventCommonLike<N>;
+    /**
+     *
+     * Adds a one-time listener function for the event named eventName to the beginning of the listeners array.
+     * The next time eventName is triggered, this listener is removed, and then invoked.
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.prependOnceListener}
+     * */
+    prependOnceListener(event: N, listener: Fnc): EventCommonLike<N>;
+    /**
+     * Returns a copy of the array of listeners for the event named eventName,
+     * including any wrappers (such as those created by .once()).
+     *
+     * @param {string} event - event name
+     * @return {Array<function>} - Array of listeners
+     *
+     * {@link NodeJS.EventEmitter.rawListeners}
+     * */
+    rawListeners(event: N): Array<Fnc>;
+    /**
+     * Removes all listeners, or those of the specified eventName.
+     *
+     * It is bad practice to remove listeners added elsewhere in the code,
+     * particularly when the EventEmitter instance was created by some other component or module (e. g. sockets or file streams).
+     *
+     * @param {string} event - event name
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.removeAllListeners}
+     * */
+    removeAllListeners(event?: N): EventCommonLike<N>;
+    /**
+     * Removes the specified listener from the listener array for the event named eventName
+     *
+     * @param {string} event - event name
+     * @param {function} listener - callback function
+     * @param {boolean?} clearBuffer - clears buffer
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.removeListener}
+     * */
+    removeListener(event: N, listener: Fnc, clearBuffer?: boolean): EventCommonLike<N>;
+    /**
+     * By default EventEmitters will print a warning
+     * if more than 10 listeners are added for a particular event.
+     *
+     * This is a useful default that helps finding memory leaks.
+     *
+     * The emitter. setMaxListeners() method allows the limit to be modified for this specific EventEmitter instance.
+     *
+     * The value can be set to Infinity (or 0) to indicate an unlimited number of listeners.
+     *
+     * @param {number} max - maximum number of listener
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.setMaxListeners}
+     * */
+    setMaxListeners(max: number): EventCommonLike<N>;
+    /**
+     * Set a maximum listener for a specific event
+     *
+     * @param {string} event - event name
+     * @param {number} max - maximum number of listener
+     * @return {EventCommonLike} - this
+     *
+     * {@link NodeJS.EventEmitter.setMaxListeners}
+     * */
+    setMaxListeners(event: N, max: number): EventCommonLike<N>;
+}
+/**
+ * Secure event methods
+ * */
+export type EventCommonSecure<N extends EventNameDef = EventNameDef> = ShiftMain<EventCommonLike<N>> & InitLike;
+export type EventNameDef = string | symbol;

package/dist/{hook → event}/index.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.types.js","sourceRoot":"","sources":["../../src/hook/index.types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.types.js","sourceRoot":"","sources":["../../src/event/index.types.ts"],"names":[],"mappings":""}

package/dist/hub/hub.channel.d.ts

@@ -0,0 +1,27 @@
+import type { HubChannelLike, HubType } from "./index.types";
+import type { RepoCommonLike } from "../repo";
+export declare class HubChannel<T extends HubType = string, C extends string = string> implements HubChannelLike<T, C> {
+    readonly type: T;
+    protected _items: Map<C, unknown>;
+    /**
+     * Default constructor
+     *
+     * Responsibilities
+     * - Create repositories => ie: callbacks
+     * - Trigger clear pending operation
+     * */
+    constructor(type: T, repo: RepoCommonLike);
+    protected _validName(value: unknown, method?: keyof HubChannelLike, throwable?: boolean): boolean;
+    /** @inheritDoc */
+    get names(): Array<C>;
+    /** @inheritDoc */
+    has(name: C): boolean;
+    /** @inheritDoc */
+    get<V>(name: C): V;
+    /** @inheritDoc */
+    as<F extends string = string>(): HubChannelLike<T, C | F>;
+    /** @inheritDoc */
+    set<V>(name: C, value: V): boolean;
+    /** @inheritDoc */
+    delete(name: C): boolean;
+}