@develia/commons 0.4.8 → 0.4.12

package/src/browser/native-bridge.ts

@@ -1,117 +1,117 @@
-// ─── Tipos ───────────────────────────────────────────────
-interface BridgeOptions {
-    channel: Channel;
-    timeout?: number | null;
-    callbackName?: string;        // ← nuevo
-}
-interface PendingCall {
-    resolve: (value: unknown) => void;
-    reject: (reason: Error) => void;
-    timer: ReturnType<typeof setTimeout> | null;
-}
-
-interface Channel {
-    postMessage: (message: string) => void;
-}
-
-
-
-// ─── Clase ──────────────────────────────────────────────
-
-export default class NativeBridge {
-    private _pending = new Map<number, PendingCall>();
-    private _callId = 0;
-    private readonly _defaultTimeout: number | null;
-    private readonly _channel: Channel;
-
-
-    constructor({ channel, timeout = 3000, callbackName = '__nativeResponseHandler' }: BridgeOptions) {
-        this._defaultTimeout = timeout;
-        this._channel = channel;
-
-        if (!this._channel) {
-            throw new Error('Channel not found');
-        }
-
-        (window as any)[callbackName] = this._callback;
-
-        // Proxy: cualquier propiedad no existente se convierte en call()
-        return new Proxy(this, {
-            get(target: NativeBridge, prop: string | symbol) {
-                if (prop in target) {
-                    return (target as any)[prop];
-                }
-                return (data?: unknown, timeout?: number | null) => target.call(String(prop), data, timeout);
-            },
-        }) as unknown as NativeBridge;
-    }
-
-
-    private _callback(id: number, error: any, result: any) {
-
-        const pending = this._pending.get(id);
-        if (!pending) {
-            return;
-        }
-
-        if (pending.timer !== null) {
-            clearTimeout(pending.timer);
-        }
-
-        this._pending.delete(id);
-
-        if (error) {
-            pending.reject(error instanceof Error? error : new Error(String(error)));
-        } else {
-            pending.resolve(result);
-        }
-    }
-
-    call(method: string, data: unknown = null, timeout?: number | null): Promise<unknown> {
-
-
-        const effectiveTimeout = timeout !== undefined ? timeout : this._defaultTimeout;
-
-        return new Promise<unknown>((resolve, reject) => {
-            const id = this._callId++;
-
-            let timer: ReturnType<typeof setTimeout> | null = null;
-
-            // Solo crear timer si hay timeout
-            if (effectiveTimeout !== null && effectiveTimeout > 0) {
-                timer = setTimeout(() => {
-                    this._pending.delete(id);
-                    reject(new Error(`Timeout (${effectiveTimeout}ms): ${method}`));
-                }, effectiveTimeout);
-            }
-
-            this._pending.set(id, { resolve, reject, timer });
-            this._channel!.postMessage(JSON.stringify({ id, method, data }));
-        });
-    }
-
-
-    send(method: string, data: unknown = null): void {
-        this._channel!.postMessage(JSON.stringify({ method, data }));
-    }
-
-    /**
-     * Número de llamadas pendientes
-     */
-    get pendingCount(): number {
-        return this._pending.size;
-    }
-
-    /**
-     * Cancela todas las llamadas pendientes
-     */
-    cancelAll(): void {
-        for (const [, { reject, timer }] of this._pending) {
-            if (timer !== null) {
-                clearTimeout(timer);
-            }
-            reject(new Error('Cancelled'));
-        }
-        this._pending.clear();
-    }
+// ─── Tipos ───────────────────────────────────────────────
+interface BridgeOptions {
+    channel: Channel;
+    timeout?: number | null;
+    callbackName?: string;        // ← nuevo
+}
+interface PendingCall {
+    resolve: (value: unknown) => void;
+    reject: (reason: Error) => void;
+    timer: ReturnType<typeof setTimeout> | null;
+}
+
+interface Channel {
+    postMessage: (message: string) => void;
+}
+
+
+
+// ─── Clase ──────────────────────────────────────────────
+
+export default class NativeBridge {
+    private _pending = new Map<number, PendingCall>();
+    private _callId = 0;
+    private readonly _defaultTimeout: number | null;
+    private readonly _channel: Channel;
+
+
+    constructor({ channel, timeout = 3000, callbackName = '__nativeResponseHandler' }: BridgeOptions) {
+        this._defaultTimeout = timeout;
+        this._channel = channel;
+
+        if (!this._channel) {
+            throw new Error('Channel not found');
+        }
+
+        (window as any)[callbackName] = this._callback;
+
+        // Proxy: cualquier propiedad no existente se convierte en call()
+        return new Proxy(this, {
+            get(target: NativeBridge, prop: string | symbol) {
+                if (prop in target) {
+                    return (target as any)[prop];
+                }
+                return (data?: unknown, timeout?: number | null) => target.call(String(prop), data, timeout);
+            },
+        }) as unknown as NativeBridge;
+    }
+
+
+    private _callback(id: number, error: any, result: any) {
+
+        const pending = this._pending.get(id);
+        if (!pending) {
+            return;
+        }
+
+        if (pending.timer !== null) {
+            clearTimeout(pending.timer);
+        }
+
+        this._pending.delete(id);
+
+        if (error) {
+            pending.reject(error instanceof Error? error : new Error(String(error)));
+        } else {
+            pending.resolve(result);
+        }
+    }
+
+    call(method: string, data: unknown = null, timeout?: number | null): Promise<unknown> {
+
+
+        const effectiveTimeout = timeout !== undefined ? timeout : this._defaultTimeout;
+
+        return new Promise<unknown>((resolve, reject) => {
+            const id = this._callId++;
+
+            let timer: ReturnType<typeof setTimeout> | null = null;
+
+            // Solo crear timer si hay timeout
+            if (effectiveTimeout !== null && effectiveTimeout > 0) {
+                timer = setTimeout(() => {
+                    this._pending.delete(id);
+                    reject(new Error(`Timeout (${effectiveTimeout}ms): ${method}`));
+                }, effectiveTimeout);
+            }
+
+            this._pending.set(id, { resolve, reject, timer });
+            this._channel!.postMessage(JSON.stringify({ id, method, data }));
+        });
+    }
+
+
+    send(method: string, data: unknown = null): void {
+        this._channel!.postMessage(JSON.stringify({ method, data }));
+    }
+
+    /**
+     * Número de llamadas pendientes
+     */
+    get pendingCount(): number {
+        return this._pending.size;
+    }
+
+    /**
+     * Cancela todas las llamadas pendientes
+     */
+    cancelAll(): void {
+        for (const [, { reject, timer }] of this._pending) {
+            if (timer !== null) {
+                clearTimeout(timer);
+            }
+            reject(new Error('Cancelled'));
+        }
+        this._pending.clear();
+    }
 }

package/src/cancellable-promise.ts

@@ -0,0 +1,77 @@
+type CancellablePromiseExecutor<T> = (
+    resolve: (value: T | PromiseLike<T>) => void,
+    reject: (reason?: unknown) => void,
+    signal: AbortSignal
+) => void;
+
+export default class CancellablePromise<T> extends Promise<T> {
+
+    private _controller: AbortController;
+
+    static get [Symbol.species]() {
+        return Promise;
+    }
+
+    constructor(executor: CancellablePromiseExecutor<T>) {
+        const controller = new AbortController();
+
+        super((resolve, reject) => {
+            controller.signal.addEventListener("abort", () => {
+                reject(controller.signal.reason);
+            });
+
+            executor(resolve, reject, controller.signal);
+        });
+
+        this._controller = controller;
+    }
+
+    get cancelled(): boolean {
+        return this._controller.signal.aborted;
+    }
+
+    cancel(reason: unknown = new Error("Promesa cancelada")): void {
+        if (!this.cancelled) {
+            this._controller.abort(reason);
+        }
+    }
+
+    static async compete<T>(promises: CancellablePromise<T>[]): Promise<T> {
+        return await Promise.race(promises).then(
+            (resultado) => {
+                for (const p of promises) {
+                    p.cancel();
+                }
+                return resultado;
+            },
+            (error) => {
+                for (const p of promises) {
+                    p.cancel();
+                }
+                throw error;
+            }
+        );
+    }
+
+    static async cooperate<T>(promises: CancellablePromise<T>[]): Promise<T[]> {
+        try {
+            return await Promise.all(promises);
+        } catch (error) {
+            for (const p of promises) {
+                p.cancel();
+            }
+            throw error;
+        }
+    }
+
+    static withTimeout<T>(executor: CancellablePromiseExecutor<T>, ms: number): CancellablePromise<T> {
+        return new CancellablePromise<T>((resolve, reject, signal) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Timeout: ${ms}ms`));
+            }, ms);
+
+            signal.addEventListener("abort", () => clearTimeout(timer));
+            executor(resolve, reject, signal);
+        });
+    }
+}

package/src/collections/index.ts

@@ -1,3 +1,3 @@
-export {default as DefaultWeakMap} from './default-weak-map.js'
-export {default as DefaultMap} from './default-map.js'
+export {default as DefaultWeakMap} from './default-weak-map.js'
+export {default as DefaultMap} from './default-map.js'
 export {default as CacheDictionary} from './cache-dictionary.js';

package/src/event-bus.ts

@@ -0,0 +1,84 @@
+// event.ts
+
+export abstract class Event {
+    readonly timestamp: Date;
+
+    protected constructor() {
+        this.timestamp = new Date();
+    }
+
+    toString(): string {
+        return `${this.constructor.name}(${this.timestamp.toISOString()})`;
+    }
+}
+
+type EventClass<T extends Event> = new (...args: any[]) => T;
+type Handler<T extends Event> = (event: T) => void;
+
+interface HandlerWrapper {
+    original: Function;
+    wrapped: (event: Event) => void;
+}
+
+export class EventBus {
+    private static _instance: EventBus | null = null;
+
+    static get shared(): EventBus {
+        return this._instance ??= new EventBus();
+    }
+
+    private _handlers = new Map<Function, HandlerWrapper[]>();
+
+    on<T extends Event>(type: EventClass<T>, handler: Handler<T>): void {
+        if (!this._handlers.has(type)) {
+            this._handlers.set(type, []);
+        }
+        this._handlers.get(type)!.push({
+            original: handler,
+            wrapped: (event: Event) => handler(event as T),
+        });
+    }
+
+    off<T extends Event>(type: EventClass<T>, handler: Handler<T>): void {
+        const handlers = this._handlers.get(type);
+        if (!handlers) return;
+
+        let index = handlers.findIndex((h) => h.original === handler);
+        if (index !== -1) {
+            handlers.splice(index, 1);
+        }
+    }
+
+    emit<T extends Event>(event: T): void {
+        const handlers = this._handlers.get(event.constructor);
+        if (!handlers) return;
+
+        for (const handler of [...handlers]) {
+            try {
+                handler.wrapped(event);
+            } catch (e) {
+                console.error(`[EventBus] Error en handler de ${event.constructor.name}:`, e);
+            }
+        }
+    }
+
+    once<T extends Event>(type: EventClass<T>, handler: Handler<T>): void {
+        const wrapper: Handler<T> = (event: T) => {
+            handler(event);
+            this.off(type, wrapper);
+        };
+        this.on(type, wrapper);
+    }
+
+    clear<T extends Event>(type: EventClass<T>): void {
+        this._handlers.delete(type);
+    }
+
+    clearAll(): void {
+        this._handlers.clear();
+    }
+
+    hasListeners<T extends Event>(type: EventClass<T>): boolean {
+        return (this._handlers.get(type)?.length ?? 0) > 0;
+    }
+}

package/src/index.ts

@@ -1,36 +1,38 @@
-// src/index.ts
-
-// ─── Types ───────────────────────────────────────────
-export * from './types.js';
-export {default as Type} from './type.js';
-export {default as TypeCode} from './type-code.js';
-
-// ─── Utilities ───────────────────────────────────────
-export * from './utilities.js';
-export * from './string.js';
-export * from './math.js';
-
-// ─── Data Structures ────────────────────────────────
-export {default as KeyValuePair} from './key-value-pair.js';
-export {default as Order} from './order.js';
-
-// ─── Async & Timing ─────────────────────────────────
-export {default as Timer} from './timer.js';
-export {default as TimeSpan} from './timespan.js';
-export {default as Stopwatch} from './stopwatch.js';
-export {default as AsyncPoolExecutor} from './async-pool-executor.js';
-
-// ─── Patterns ────────────────────────────────────────
-export {default as Lazy} from './lazy.js';
-export {default as from, From} from './from.js';
-
-// ─── Web ─────────────────────────────────────────────
-export {default as CleanURLSearchParams} from './clean-url-search-params.js';
-/** @deprecated  */
-export { ajaxSubmit, ajaxSubmission, submitForm , formToObject} from './browser/index.js';
-
-// ─── Deprecated ──────────────────────────────────────
-/** @deprecated  */
-export * from './array.js';
-/** @deprecated  */
+// src/index.ts
+
+// ─── Types ───────────────────────────────────────────
+export * from './types.js';
+export {default as Type} from './type.js';
+export {default as TypeCode} from './type-code.js';
+
+// ─── Utilities ───────────────────────────────────────
+export * from './utilities.js';
+export * from './string.js';
+export * from './math.js';
+export {default as CancellablePromise} from "./cancellable-promise.js";
+
+// ─── Data Structures ────────────────────────────────
+export {default as KeyValuePair} from './key-value-pair.js';
+export {default as Order} from './order.js';
+
+// ─── Async & Timing ─────────────────────────────────
+export {default as Timer} from './timer.js';
+export {default as TimeSpan} from './timespan.js';
+export {default as Stopwatch} from './stopwatch.js';
+export {default as AsyncPoolExecutor} from './async-pool-executor.js';
+
+// ─── Patterns ────────────────────────────────────────
+export {default as Lazy} from './lazy.js';
+export {default as from, From} from './from.js';
+export {EventBus, Event} from './event-bus.js';
+
+// ─── Web ─────────────────────────────────────────────
+export {default as CleanURLSearchParams} from './clean-url-search-params.js';
+/** @deprecated  */
+export {ajaxSubmit, ajaxSubmission, submitForm, formToObject} from './browser/index.js';
+
+// ─── Deprecated ──────────────────────────────────────
+/** @deprecated  */
+export * from './array.js';
+/** @deprecated  */
 export * from './collections/index.js';