@develia/commons 0.4.12 → 0.4.13

package/package.json

@@ -1,56 +1,60 @@
-{
-  "name": "@develia/commons",
-  "version": "0.4.12",
-  "author": {
-    "name": "Antonio Gil Espinosa",
-    "email": "antonio.gil.espinosa@gmail.com",
-    "url": "https://antoniogilespinosa.com"
-  },
-  "type": "module",
-  "main": "./dist/cjs/index.js",
-  "module": "./dist/esm/index.js",
-  "types": "./dist/types/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/esm/index.js",
-      "require": "./dist/cjs/index.js",
-      "browser": "./dist/web/index.js"
-    },
-    "./array": {
-      "types": "./dist/types/array.d.ts",
-      "import": "./dist/esm/array.js",
-      "require": "./dist/cjs/array.js",
-      "browser": "./dist/web/array.js"
-    },
-    "./collections": {
-      "types": "./dist/types/collections/index.d.ts",
-      "import": "./dist/esm/collections/index.js",
-      "require": "./dist/cjs/collections/index.js",
-      "browser": "./dist/web/collections/index.js"
-    },
-    "./browser": {
-      "types": "./dist/types/browser/index.d.ts",
-      "import": "./dist/esm/browser/index.js",
-      "require": "./dist/cjs/browser/index.js",
-      "browser": "./dist/web/browser/index.js"
-    }
-  },
-  "license": "proprietary",
-  "devDependencies": {
-    "rimraf": "^6.0.1",
-    "typescript": "^5.1.3",
-    "jest": "^29.7.0"
-  },
-  "scripts": {
-    "clean": "rimraf dist || rm -rf dist",
-    "build:esm": "tsc -p tsconfig.esm.json",
-    "build:cjs": "tsc -p tsconfig.cjs.json",
-    "build:web": "tsc -p tsconfig.web.json",
-    "build": "npm run clean && npm run build:esm && npm run build:cjs  && npm run build:web"
-  },
-  "files": [
-    "dist",
-    "src"
-  ]
-}
+{
+  "name": "@develia/commons",
+  "version": "0.4.13",
+  "author": {
+    "name": "Antonio Gil Espinosa",
+    "email": "antonio.gil.espinosa@gmail.com",
+    "url": "https://antoniogilespinosa.com"
+  },
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "browser": "./dist/web/index.js"
+    },
+    "./array": {
+      "types": "./dist/types/array.d.ts",
+      "import": "./dist/esm/array.js",
+      "require": "./dist/cjs/array.js",
+      "browser": "./dist/web/array.js"
+    },
+    "./collections": {
+      "types": "./dist/types/collections/index.d.ts",
+      "import": "./dist/esm/collections/index.js",
+      "require": "./dist/cjs/collections/index.js",
+      "browser": "./dist/web/collections/index.js"
+    },
+    "./browser": {
+      "types": "./dist/types/browser/index.d.ts",
+      "import": "./dist/esm/browser/index.js",
+      "require": "./dist/cjs/browser/index.js",
+      "browser": "./dist/web/browser/index.js"
+    }
+  },
+  "license": "proprietary",
+  "devDependencies": {
+    "@jest/globals": "^30.4.1",
+    "@types/jest": "^30.0.0",
+    "jest": "^29.7.0",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.1.3"
+  },
+  "scripts": {
+    "clean": "rimraf dist || rm -rf dist",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:web": "tsc -p tsconfig.web.json",
+    "build": "npm run clean && npm run build:esm && npm run build:cjs  && npm run build:web",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ]
+}

package/src/browser/geo-location.ts

@@ -1,114 +1,114 @@
-// ─── Tipos ───────────────────────────────────────────────
-
-export interface GeoLocation {
-    latitude: number;
-    longitude: number;
-    accuracy: number;
-    altitude: number | null;
-    altitudeAccuracy: number | null;
-    heading: number | null;
-    speed: number | null;
-    timestamp: number;
-}
-
-export interface GeoLocationOptions {
-    enableHighAccuracy?: boolean;
-    timeout?: number;
-    maximumAge?: number;
-}
-
-// ─── Helpers ─────────────────────────────────────────────
-
-function positionToGeoLocation(position: GeolocationPosition): GeoLocation {
-    const {coords, timestamp} = position;
-    return {
-        latitude: coords.latitude,
-        longitude: coords.longitude,
-        accuracy: coords.accuracy,
-        altitude: coords.altitude,
-        altitudeAccuracy: coords.altitudeAccuracy,
-        heading: coords.heading,
-        speed: coords.speed,
-        timestamp,
-    };
-}
-
-function geolocationError(error: GeolocationPositionError): Error {
-    switch (error.code) {
-        case error.PERMISSION_DENIED:
-            return new Error('Has denegado el permiso de ubicación.');
-        case error.POSITION_UNAVAILABLE:
-            return new Error('No se pudo determinar tu ubicación.');
-        case error.TIMEOUT:
-            return new Error('Tiempo de espera agotado al obtener la ubicación.');
-        default:
-            return new Error('Error desconocido al obtener la ubicación.');
-    }
-}
-
-function requestPosition(options: PositionOptions): Promise<GeoLocation> {
-    return new Promise((resolve, reject) => {
-        navigator.geolocation.getCurrentPosition(
-            (position) => resolve(positionToGeoLocation(position)),
-            (error) => reject(geolocationError(error)),
-            options,
-        );
-    });
-}
-
-async function ensurePermission(): Promise<void> {
-    if (!navigator.permissions) return;
-
-    const permission = await navigator.permissions.query({name: 'geolocation'});
-
-    if (permission.state === 'denied') {
-        throw new Error(
-            'Permiso de ubicación denegado. Actívalo en la configuración del navegador.',
-        );
-    }
-
-    if (permission.state === 'prompt') {
-        await new Promise<void>((resolve, reject) => {
-            // Escuchar cambio de estado del permiso
-            permission.onchange = () => {
-                permission.onchange = null;
-                if (permission.state === 'granted') {
-                    resolve();
-                } else {
-                    reject(new Error('Has denegado el permiso de ubicación.'));
-                }
-            };
-
-            // Forzar el diálogo nativo del navegador
-            navigator.geolocation.getCurrentPosition(
-                () => {
-                    permission.onchange = null;
-                    resolve();
-                },
-                (error) => {
-                    permission.onchange = null;
-                    reject(geolocationError(error));
-                },
-                {timeout: 30000},
-            );
-        });
-    }
-}
-
-// ─── Función principal ──────────────────────────────────
-
-export default async function getGeoLocation(
-    options: GeoLocationOptions = {},
-): Promise<GeoLocation> {
-    if (!navigator.geolocation) {
-        throw new Error('Tu navegador no soporta geolocalización.');
-    }
-
-    await ensurePermission();
-
-    return requestPosition({
-        enableHighAccuracy: options.enableHighAccuracy ?? true,
-        timeout: options.timeout ?? 10000,
-        maximumAge: options.maximumAge ?? 0,
-    });
+// ─── Tipos ───────────────────────────────────────────────
+
+export interface GeoLocation {
+    latitude: number;
+    longitude: number;
+    accuracy: number;
+    altitude: number | null;
+    altitudeAccuracy: number | null;
+    heading: number | null;
+    speed: number | null;
+    timestamp: number;
+}
+
+export interface GeoLocationOptions {
+    enableHighAccuracy?: boolean;
+    timeout?: number;
+    maximumAge?: number;
+}
+
+// ─── Helpers ─────────────────────────────────────────────
+
+function positionToGeoLocation(position: GeolocationPosition): GeoLocation {
+    const {coords, timestamp} = position;
+    return {
+        latitude: coords.latitude,
+        longitude: coords.longitude,
+        accuracy: coords.accuracy,
+        altitude: coords.altitude,
+        altitudeAccuracy: coords.altitudeAccuracy,
+        heading: coords.heading,
+        speed: coords.speed,
+        timestamp,
+    };
+}
+
+function geolocationError(error: GeolocationPositionError): Error {
+    switch (error.code) {
+        case error.PERMISSION_DENIED:
+            return new Error('Has denegado el permiso de ubicación.');
+        case error.POSITION_UNAVAILABLE:
+            return new Error('No se pudo determinar tu ubicación.');
+        case error.TIMEOUT:
+            return new Error('Tiempo de espera agotado al obtener la ubicación.');
+        default:
+            return new Error('Error desconocido al obtener la ubicación.');
+    }
+}
+
+function requestPosition(options: PositionOptions): Promise<GeoLocation> {
+    return new Promise((resolve, reject) => {
+        navigator.geolocation.getCurrentPosition(
+            (position) => resolve(positionToGeoLocation(position)),
+            (error) => reject(geolocationError(error)),
+            options,
+        );
+    });
+}
+
+async function ensurePermission(): Promise<void> {
+    if (!navigator.permissions) return;
+
+    const permission = await navigator.permissions.query({name: 'geolocation'});
+
+    if (permission.state === 'denied') {
+        throw new Error(
+            'Permiso de ubicación denegado. Actívalo en la configuración del navegador.',
+        );
+    }
+
+    if (permission.state === 'prompt') {
+        await new Promise<void>((resolve, reject) => {
+            // Escuchar cambio de estado del permiso
+            permission.onchange = () => {
+                permission.onchange = null;
+                if (permission.state === 'granted') {
+                    resolve();
+                } else {
+                    reject(new Error('Has denegado el permiso de ubicación.'));
+                }
+            };
+
+            // Forzar el diálogo nativo del navegador
+            navigator.geolocation.getCurrentPosition(
+                () => {
+                    permission.onchange = null;
+                    resolve();
+                },
+                (error) => {
+                    permission.onchange = null;
+                    reject(geolocationError(error));
+                },
+                {timeout: 30000},
+            );
+        });
+    }
+}
+
+// ─── Función principal ──────────────────────────────────
+
+export default async function getGeoLocation(
+    options: GeoLocationOptions = {},
+): Promise<GeoLocation> {
+    if (!navigator.geolocation) {
+        throw new Error('Tu navegador no soporta geolocalización.');
+    }
+
+    await ensurePermission();
+
+    return requestPosition({
+        enableHighAccuracy: options.enableHighAccuracy ?? true,
+        timeout: options.timeout ?? 10000,
+        maximumAge: options.maximumAge ?? 0,
+    });
 }

package/src/browser/index.ts

@@ -1,3 +1,5 @@
+import {delay} from "../utilities.js";
+
 interface FetchIntoOptions {
     url?: string;
     fetchOptions?: RequestInit;
@@ -5,6 +7,41 @@ interface FetchIntoOptions {
     transition?: string;
 }
 
+export async function waitFor(
+    selector: string,
+    options: { timeout?: number } = {}
+): Promise<HTMLElement | null> {
+    const {timeout = 5000} = options;
+
+    const element = document.querySelector(selector);
+    if (element) {
+        return element as HTMLElement;
+    }
+
+    let observer: MutationObserver | undefined;
+    const timeoutPromise = delay(timeout).then(() => {
+        observer?.disconnect();
+        return null;
+    });
+
+    const observerPromise = new Promise<HTMLElement | null>((resolve) => {
+        observer = new MutationObserver(() => {
+            const element = document.querySelector(selector);
+            if (element) {
+                observer?.disconnect();
+                resolve(element as HTMLElement);
+            }
+        });
+
+        observer.observe(document.body, {
+            childList: true,
+            subtree: true,
+        });
+    });
+
+    return Promise.race([observerPromise, timeoutPromise]);
+}
+
 export async function fetchInto(
     selector: string,
     options: FetchIntoOptions = {}

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();
+    }
 }