@develia/commons 0.4.14 → 0.4.16

package/dist/cjs/array.js

@@ -4,6 +4,15 @@ exports.pull = pull;
 exports.chunk = chunk;
 exports.clear = clear;
 exports.remove = remove;
+exports.pushIfAbsent = pushIfAbsent;
+/**
+ * Removes all given values from the provided array and returns the number of removed elements.
+ * The operation mutates the original array.
+ * @template T
+ * @param {Array<T>} array - The array to modify by removing specified items.
+ * @param {...T} items - The values to remove from the array.
+ * @return {number} The number of elements removed from the array.
+ */
 function pull(array, ...items) {
     let output = 0;
     for (const item of items) {
@@ -15,6 +24,13 @@ function pull(array, ...items) {
     }
     return output;
 }
+/**
+ * Splits an array into chunks of a given size.
+ * @template T
+ * @param {Array<T>} array - The array to split.
+ * @param {number} size - The size of each chunk.
+ * @return {Array<Array<T>>} The array of chunks.
+ */
 function chunk(array, size) {
     if (size <= 0)
         throw new Error("Size must be greater than 0");
@@ -24,16 +40,27 @@ function chunk(array, size) {
     }
     return result;
 }
+/**
+ * Removes all elements from the array, mutating it.
+ * @template T
+ * @param {Array<T>} array - The array to clear.
+ */
 function clear(array) {
     array.length = 0;
 }
+/**
+ * Removes all elements from the array that satisfy the predicate.
+ * The operation mutates the original array.
+ * @template T
+ * @return {Array<T>} An array of removed elements.
+ */
 function remove(array, predicate) {
     const removed = [];
     let i = 0;
     while (i < array.length) {
         if (predicate(array[i])) {
             removed.push(array[i]);
-            array.splice(i, 1);
+            array.splice(i, 1); // muta el array
         }
         else {
             i++;
@@ -41,4 +68,19 @@ function remove(array, predicate) {
     }
     return removed;
 }
+/**
+ * Adds an element to the array if it's not already present.
+ * The operation mutates the original array.
+ * @template T
+ * @param {Array<T>} array - The array to modify.
+ * @param {T} element - The element to add if absent.
+ * @return {boolean} True if the element was added, false otherwise.
+ */
+function pushIfAbsent(array, element) {
+    if (!array.includes(element)) {
+        array.push(element);
+        return true;
+    }
+    return false;
+}
 //# sourceMappingURL=array.js.map

package/dist/cjs/array.js.map

@@ -1 +1 @@
-{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/array.ts"],"names":[],"mappings":";;AAUA,oBAWC;AASD,sBAOC;AAOD,sBAEC;AAQD,wBAcC;AA1DD,SAAgB,IAAI,CAAI,KAAe,EAAE,GAAG,KAAe;IAEvD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACvB,MAAM,EAAE,CAAC;QACb,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AASD,SAAgB,KAAK,CAAI,KAAe,EAAE,IAAY;IAClD,IAAI,IAAI,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAOD,SAAgB,KAAK,CAAI,KAAe;IACpC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACrB,CAAC;AAQD,SAAgB,MAAM,CAAI,KAAe,EAAC,SAAuB;IAC7D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,CAAC,EAAE,CAAC;QACR,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/array.ts"],"names":[],"mappings":";;AAUA,oBAWC;AASD,sBAOC;AAOD,sBAEC;AAQD,wBAcC;AAUD,oCAMC;AAlFD;;;;;;;GAOG;AACH,SAAgB,IAAI,CAAI,KAAe,EAAE,GAAG,KAAe;IAEvD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACvB,MAAM,EAAE,CAAC;QACb,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CAAI,KAAe,EAAE,IAAY;IAClD,IAAI,IAAI,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,SAAgB,KAAK,CAAI,KAAe;IACpC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,MAAM,CAAI,KAAe,EAAC,SAAuB;IAC7D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACtB,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB;QACxC,CAAC;aAAM,CAAC;YACJ,CAAC,EAAE,CAAC;QACR,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY,CAAI,KAAe,EAAE,OAAU;IACvD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC","sourcesContent":["import type {Predicate} from \"./types.js\";\r\n\r\n/**\r\n * Removes all given values from the provided array and returns the number of removed elements.\r\n * The operation mutates the original array.\r\n * @template T\r\n * @param {Array<T>} array - The array to modify by removing specified items.\r\n * @param {...T} items - The values to remove from the array.\r\n * @return {number} The number of elements removed from the array.\r\n */\r\nexport function pull<T>(array: Array<T>, ...items: Array<T>): number {\r\n\r\n    let output = 0;\r\n    for (const item of items) {\r\n        const index = array.indexOf(item);\r\n        if (index !== -1) {\r\n            array.splice(index, 1);\r\n            output++;\r\n        }\r\n    }\r\n    return output;\r\n}\r\n\r\n/**\r\n * Splits an array into chunks of a given size.\r\n * @template T\r\n * @param {Array<T>} array - The array to split.\r\n * @param {number} size - The size of each chunk.\r\n * @return {Array<Array<T>>} The array of chunks.\r\n */\r\nexport function chunk<T>(array: Array<T>, size: number): Array<Array<T>> {\r\n    if (size <= 0) throw new Error(\"Size must be greater than 0\");\r\n    const result: Array<Array<T>> = [];\r\n    for (let i = 0; i < array.length; i += size) {\r\n        result.push(array.slice(i, i + size));\r\n    }\r\n    return result;\r\n}\r\n\r\n/**\r\n * Removes all elements from the array, mutating it.\r\n * @template T\r\n * @param {Array<T>} array - The array to clear.\r\n */\r\nexport function clear<T>(array: Array<T>): void {\r\n    array.length = 0;\r\n}\r\n\r\n/**\r\n * Removes all elements from the array that satisfy the predicate.\r\n * The operation mutates the original array.\r\n * @template T\r\n * @return {Array<T>} An array of removed elements.\r\n */\r\nexport function remove<T>(array: Array<T>,predicate: Predicate<T>): Array<T> {\r\n    const removed: Array<T> = [];\r\n    let i = 0;\r\n\r\n    while (i < array.length) {\r\n        if (predicate(array[i])) {\r\n            removed.push(array[i]);\r\n            array.splice(i, 1); // muta el array\r\n        } else {\r\n            i++;\r\n        }\r\n    }\r\n\r\n    return removed;\r\n}\r\n\r\n/**\r\n * Adds an element to the array if it's not already present.\r\n * The operation mutates the original array.\r\n * @template T\r\n * @param {Array<T>} array - The array to modify.\r\n * @param {T} element - The element to add if absent.\r\n * @return {boolean} True if the element was added, false otherwise.\r\n */\r\nexport function pushIfAbsent<T>(array: Array<T>, element: T): boolean {\r\n    if (!array.includes(element)) {\r\n        array.push(element);\r\n        return true;\r\n    }\r\n    return false;\r\n}"]}

package/dist/cjs/async-pool-executor.js

@@ -8,12 +8,21 @@ class AsyncPoolExecutor {
     set maxConcurrency(value) {
         this._maxConcurrency = value;
     }
+    /**
+     * @param {number} maxConcurrency - The maximum number of concurrent tasks allowed.
+     * @param {number} [checkInterval=50] - The interval, in milliseconds, to check for capacity to run new tasks. Defaults to 50 ms.
+     */
     constructor(maxConcurrency, checkInterval = 50) {
         this._taskQueue = [];
         this._maxConcurrency = maxConcurrency;
         this._checkIntervalMs = checkInterval;
         this._activeTasks = 0;
     }
+    /**
+     * Submits a deferred task to a queue for asynchronous execution and returns a Promise resolving to its result.
+     * @template T
+     * @param {Supplier<T>} task - The deferred task to be executed asynchronously.
+     */
     submit(task) {
         this._taskQueue.push(task);
         if (this._proccess != null)
@@ -39,6 +48,12 @@ class AsyncPoolExecutor {
             this._proccess = null;
         }, 0);
     }
+    /**
+     * Waits until all tasks (both queued and active) are completed.
+     * This method resolves only when there are no pending tasks.
+     *
+     * @return {Promise<void>} A promise that resolves when all tasks are complete.
+     */
     async shutdown() {
         while (this._taskQueue.length > 0 || this._activeTasks > 0) {
             await (0, utilities_js_1.delay)(this._checkIntervalMs);

package/dist/cjs/async-pool-executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"async-pool-executor.js","sourceRoot":"","sources":["../../src/async-pool-executor.ts"],"names":[],"mappings":";;AACA,iDAAqC;AAErC,MAAqB,iBAAiB;IAGlC,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IAED,IAAI,cAAc,CAAC,KAAa;QAC5B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IAEjC,CAAC;IAYD,YAAY,cAAsB,EAAE,gBAAwB,EAAE;QAPtD,eAAU,GAAyB,EAAE,CAAC;QAQ1C,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,gBAAgB,GAAG,aAAa,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IAC1B,CAAC;IAOM,MAAM,CAAC,IAAmB;QAE7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3B,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI;YACtB,OAAO;QAEX,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAEnC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAEhC,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBAC/C,MAAM,IAAA,oBAAK,EAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBACvC,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrC,IAAI,IAAI,EAAE,CAAC;oBACP,IAAI,CAAC,YAAY,EAAE,CAAC;oBACpB,UAAU,CAAC,KAAK,IAAI,EAAE;wBAClB,IAAI,CAAC;4BACD,MAAM,IAAI,EAAE,CAAC;wBACjB,CAAC;gCAAS,CAAC;4BACP,IAAI,CAAC,YAAY,EAAE,CAAC;wBACxB,CAAC;oBACL,CAAC,CAAC,CAAC;gBACP,CAAC;YAGL,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC,EAAE,CAAC,CAAC,CAAC;IAGV,CAAC;IASM,KAAK,CAAC,QAAQ;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAA,oBAAK,EAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ;AAjFD,oCAiFC"}
+{"version":3,"file":"async-pool-executor.js","sourceRoot":"","sources":["../../src/async-pool-executor.ts"],"names":[],"mappings":";;AACA,iDAAqC;AAErC,MAAqB,iBAAiB;IAGlC,IAAI,cAAc;QACd,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IAED,IAAI,cAAc,CAAC,KAAa;QAC5B,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IAEjC,CAAC;IAQD;;;OAGG;IACH,YAAY,cAAsB,EAAE,gBAAwB,EAAE;QAPtD,eAAU,GAAyB,EAAE,CAAC;QAQ1C,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,gBAAgB,GAAG,aAAa,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,IAAmB;QAE7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE3B,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI;YACtB,OAAO;QAEX,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAEnC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAEhC,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBAC/C,MAAM,IAAA,oBAAK,EAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBACvC,CAAC;gBAED,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrC,IAAI,IAAI,EAAE,CAAC;oBACP,IAAI,CAAC,YAAY,EAAE,CAAC;oBACpB,UAAU,CAAC,KAAK,IAAI,EAAE;wBAClB,IAAI,CAAC;4BACD,MAAM,IAAI,EAAE,CAAC;wBACjB,CAAC;gCAAS,CAAC;4BACP,IAAI,CAAC,YAAY,EAAE,CAAC;wBACxB,CAAC;oBACL,CAAC,CAAC,CAAC;gBACP,CAAC;YAGL,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC,EAAE,CAAC,CAAC,CAAC;IAGV,CAAC;IAGD;;;;;OAKG;IACI,KAAK,CAAC,QAAQ;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAA,oBAAK,EAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ;AAjFD,oCAiFC","sourcesContent":["import type {Supplier} from \"./types.js\";\r\nimport {delay} from \"./utilities.js\";\r\n\r\nexport default class AsyncPoolExecutor {\r\n    private _checkIntervalMs: number;\r\n\r\n    get maxConcurrency(): number {\r\n        return this._maxConcurrency;\r\n    }\r\n\r\n    set maxConcurrency(value: number) {\r\n        this._maxConcurrency = value;\r\n\r\n    }\r\n\r\n    private _proccess: any;\r\n    private _maxConcurrency: number;\r\n    private _activeTasks: number;\r\n    private _taskQueue: Array<Supplier<any>> = [];\r\n\r\n\r\n    /**\r\n     * @param {number} maxConcurrency - The maximum number of concurrent tasks allowed.\r\n     * @param {number} [checkInterval=50] - The interval, in milliseconds, to check for capacity to run new tasks. Defaults to 50 ms.\r\n     */\r\n    constructor(maxConcurrency: number, checkInterval: number = 50) {\r\n        this._maxConcurrency = maxConcurrency;\r\n        this._checkIntervalMs = checkInterval;\r\n        this._activeTasks = 0;\r\n    }\r\n\r\n    /**\r\n     * Submits a deferred task to a queue for asynchronous execution and returns a Promise resolving to its result.\r\n     * @template T\r\n     * @param {Supplier<T>} task - The deferred task to be executed asynchronously.\r\n     */\r\n    public submit(task: Supplier<any>): void {\r\n\r\n        this._taskQueue.push(task);\r\n\r\n        if (this._proccess != null)\r\n            return;\r\n\r\n        this._proccess = setTimeout(async () => {\r\n\r\n            while (this._taskQueue.length > 0) {\r\n\r\n                while (this._activeTasks >= this._maxConcurrency) {\r\n                    await delay(this._checkIntervalMs);\r\n                }\r\n\r\n                const task = this._taskQueue.shift();\r\n                if (task) {\r\n                    this._activeTasks++;\r\n                    setTimeout(async () => {\r\n                        try {\r\n                            await task();\r\n                        } finally {\r\n                            this._activeTasks--;\r\n                        }\r\n                    });\r\n                }\r\n\r\n\r\n            }\r\n\r\n            this._proccess = null;\r\n        }, 0);\r\n\r\n\r\n    }\r\n\r\n\r\n    /**\r\n     * Waits until all tasks (both queued and active) are completed.\r\n     * This method resolves only when there are no pending tasks.\r\n     *\r\n     * @return {Promise<void>} A promise that resolves when all tasks are complete.\r\n     */\r\n    public async shutdown(): Promise<void> {\r\n        while (this._taskQueue.length > 0 || this._activeTasks > 0) {\r\n            await delay(this._checkIntervalMs);\r\n        }\r\n    }\r\n}\r\n"]}

package/dist/cjs/browser/form-utilities.js

@@ -5,6 +5,13 @@ exports.submitForm = submitForm;
 exports.formToObject = formToObject;
 exports.objectToFormData = objectToFormData;
 exports.ajaxSubmission = ajaxSubmission;
+/**
+ * Submits a form via AJAX and returns a Promise that resolves to the Response object.
+ *
+ * @param {HTMLFormElement | string} selectorOrElement - The form element or selector.
+ * @return {Promise<Response>} A Promise that resolves to the Response object.
+ * @throws {Error} If the element is invalid.
+ */
 async function ajaxSubmit(selectorOrElement) {
     const form = typeof selectorOrElement === 'string'
         ? document.querySelector(selectorOrElement)
@@ -28,6 +35,11 @@ function submitForm(url, data, method = 'POST', target) {
     if (target) {
         form.target = target;
     }
+    /**
+     * Recursively appends inputs to the form, supporting nested keys and arrays.
+     * @param keyPrefix - Key path, e.g., 'user[name]' or 'tags[]'
+     * @param value - The value to append (can be nested)
+     */
     const appendInputs = (keyPrefix, value) => {
         if (Array.isArray(value)) {
             for (const val of value) {
@@ -76,6 +88,14 @@ function formToObject(form) {
     }
     return out;
 }
+/**
+ * Converts an object to `FormData` format recursively.
+ *
+ * @param {Record<string, any>} data - The object data to convert.
+ * @param {FormData} formData - The `FormData` instance to append data to.
+ * @param {string} parentKey - The parent key to append to child keys in the `FormData`.
+ * @returns {FormData} - The `FormData` instance with the converted data.
+ */
 function _objectToFormData(data, formData, parentKey = '') {
     for (const key in data) {
         if (data.hasOwnProperty(key)) {
@@ -108,6 +128,12 @@ function _objectToFormData(data, formData, parentKey = '') {
     }
     return formData;
 }
+/**
+ * Converts an object into FormData.
+ *
+ * @param {Record<string, any>} data - The object to be converted into FormData.
+ * @return {FormData} - The FormData object representing the converted data.
+ */
 function objectToFormData(data) {
     let formData = new FormData();
     return _objectToFormData(data, formData);

package/dist/cjs/browser/form-utilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"form-utilities.js","sourceRoot":"","sources":["../../../src/browser/form-utilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"form-utilities.js","sourceRoot":"","sources":["../../../src/browser/form-utilities.ts"],"names":[],"mappings":"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","sourcesContent":["import {type Consumer, type Optional} from \"../types.js\";\n\n\n/**\n * Submits a form via AJAX and returns a Promise that resolves to the Response object.\n *\n * @param {HTMLFormElement | string} selectorOrElement - The form element or selector.\n * @return {Promise<Response>} A Promise that resolves to the Response object.\n * @throws {Error} If the element is invalid.\n */\nexport async function ajaxSubmit(selectorOrElement: HTMLFormElement | string): Promise<Response> {\n\n    const form = typeof selectorOrElement === 'string'\n        ? document.querySelector(selectorOrElement)\n        : selectorOrElement;\n\n    if (!(form instanceof HTMLFormElement)) {\n        throw new Error(\"Invalid element.\");\n    }\n\n\n    const formData = new FormData(form);\n    const method = form.getAttribute('method') as string ?? form.method;\n    const action = form.getAttribute('action') as string ?? form.action;\n\n    return await fetch(action, {\n        method: method,\n        body: formData,\n    });\n}\n\n\nexport function submitForm(\n    url: string,\n    data: Record<string, any>,\n    method: 'POST' | 'GET' = 'POST',\n    target?: '_blank' | '_self' | '_parent' | '_top'\n): void {\n\n    const form = document.createElement('form');\n    form.method = method.toUpperCase();\n    form.action = url;\n    form.style.display = 'none';\n\n    if (target) {\n        form.target = target;\n    }\n\n    /**\n     * Recursively appends inputs to the form, supporting nested keys and arrays.\n     * @param keyPrefix - Key path, e.g., 'user[name]' or 'tags[]'\n     * @param value - The value to append (can be nested)\n     */\n    const appendInputs = (keyPrefix: string, value: any) => {\n        if (Array.isArray(value)) {\n            for (const val of value) {\n                appendInputs(`${keyPrefix}[]`, val);\n            }\n        } else if (typeof value === 'object' && value !== null) {\n            for (const subKey in value) {\n                if (value.hasOwnProperty(subKey)) {\n                    appendInputs(`${keyPrefix}[${subKey}]`, value[subKey]);\n                }\n            }\n        } else {\n            const input = document.createElement('input');\n            input.type = 'hidden';\n            input.name = keyPrefix;\n            input.value = String(value);\n            form.appendChild(input);\n        }\n    };\n\n    for (const key in data) {\n        if (data.hasOwnProperty(key)) {\n            appendInputs(key, data[key]);\n        }\n    }\n\n    document.body.appendChild(form);\n    form.submit();\n}\n\nexport function formToObject(form: HTMLFormElement): Record<string, FormDataEntryValue | FormDataEntryValue[]> {\n    const fd = new FormData(form);\n    const out: Record<string, FormDataEntryValue | FormDataEntryValue[]> = {};\n\n    for (const [key, value] of fd.entries()) {\n        if (key in out) {\n            const current = out[key];\n            if (Array.isArray(current)) {\n                current.push(value);\n            } else {\n                out[key] = [current, value];\n            }\n        } else {\n            out[key] = value;\n        }\n    }\n\n    return out;\n}\n\n/**\n * Converts an object to `FormData` format recursively.\n *\n * @param {Record<string, any>} data - The object data to convert.\n * @param {FormData} formData - The `FormData` instance to append data to.\n * @param {string} parentKey - The parent key to append to child keys in the `FormData`.\n * @returns {FormData} - The `FormData` instance with the converted data.\n */\nfunction _objectToFormData(data: Record<string, any>, formData: FormData, parentKey: string = ''): FormData {\n\n    for (const key in data) {\n        if (data.hasOwnProperty(key)) {\n            const value = data[key];\n\n            if (value instanceof Date) {\n                formData.append(parentKey ? `${parentKey}[${key}]` : key, value.toISOString());\n            } else if (value instanceof File) {\n                formData.append(parentKey ? `${parentKey}[${key}]` : key, value);\n            } else if (typeof value === 'object' && !Array.isArray(value)) {\n                _objectToFormData(value, formData, parentKey ? `${parentKey}[${key}]` : key);\n            } else if (Array.isArray(value)) {\n                for (let index = 0; index < value.length; index++) {\n                    const item = value[index];\n                    const arrayKey = `${parentKey ? `${parentKey}[${key}]` : key}[${index}]`;\n                    if (typeof item === 'object' && !Array.isArray(item)) {\n                        _objectToFormData(item, formData, arrayKey);\n                    } else {\n                        formData.append(arrayKey, item);\n                    }\n                }\n            } else {\n                formData.append(parentKey ? `${parentKey}[${key}]` : key, value);\n            }\n        }\n    }\n\n    return formData;\n}\n\n/**\n * Converts an object into FormData.\n *\n * @param {Record<string, any>} data - The object to be converted into FormData.\n * @return {FormData} - The FormData object representing the converted data.\n */\nexport function objectToFormData(data: Record<string, any>): FormData {\n    let formData = new FormData();\n    return _objectToFormData(data, formData);\n}\n\nexport function ajaxSubmission(\n    selectorOrElement: HTMLFormElement | string,\n    onSuccess: Optional<Consumer<any>> = undefined,\n    onFailure: Optional<Consumer<any>> = undefined\n): void {\n\n    const forms: HTMLFormElement[] = typeof selectorOrElement === 'string'\n            ? Array.from(document.querySelectorAll(selectorOrElement))\n                   .filter(el => el instanceof HTMLFormElement) as HTMLFormElement[]\n            : [selectorOrElement];\n\n    for (const form of forms) {\n        form.addEventListener('submit', async (event) => {\n            event.preventDefault();\n\n            try {\n                let result = await ajaxSubmit(event.currentTarget as HTMLFormElement);\n                if (onSuccess)\n                    onSuccess(result);\n            } catch (e) {\n                if (onFailure)\n                    onFailure(e);\n            }\n\n\n        });\n    }\n}"]}

package/dist/cjs/browser/geo-location.js

@@ -1,6 +1,8 @@
 "use strict";
+// ─── Tipos ───────────────────────────────────────────────
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = getGeoLocation;
+// ─── Helpers ─────────────────────────────────────────────
 function positionToGeoLocation(position) {
     const { coords, timestamp } = position;
     return {
@@ -40,6 +42,7 @@ async function ensurePermission() {
     }
     if (permission.state === 'prompt') {
         await new Promise((resolve, reject) => {
+            // Escuchar cambio de estado del permiso
             permission.onchange = () => {
                 permission.onchange = null;
                 if (permission.state === 'granted') {
@@ -49,6 +52,7 @@ async function ensurePermission() {
                     reject(new Error('Has denegado el permiso de ubicación.'));
                 }
             };
+            // Forzar el diálogo nativo del navegador
             navigator.geolocation.getCurrentPosition(() => {
                 permission.onchange = null;
                 resolve();
@@ -59,6 +63,7 @@ async function ensurePermission() {
         });
     }
 }
+// ─── Función principal ──────────────────────────────────
 async function getGeoLocation(options = {}) {
     if (!navigator.geolocation) {
         throw new Error('Tu navegador no soporta geolocalización.');

package/dist/cjs/browser/geo-location.js.map

@@ -1 +1 @@
-{"version":3,"file":"geo-location.js","sourceRoot":"","sources":["../../../src/browser/geo-location.ts"],"names":[],"mappings":";;AAmGA,iCAcC;AA5FD,SAAS,qBAAqB,CAAC,QAA6B;IACxD,MAAM,EAAC,MAAM,EAAE,SAAS,EAAC,GAAG,QAAQ,CAAC;IACrC,OAAO;QACH,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS;KACZ,CAAC;AACN,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA+B;IACrD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,KAAK,CAAC,iBAAiB;YACxB,OAAO,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC9D,KAAK,KAAK,CAAC,oBAAoB;YAC3B,OAAO,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,KAAK,KAAK,CAAC,OAAO;YACd,OAAO,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QAC1E;YACI,OAAO,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IACvE,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,OAAwB;IAC7C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,SAAS,CAAC,WAAW,CAAC,kBAAkB,CACpC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC,EACtD,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,EAC1C,OAAO,CACV,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC;AAED,KAAK,UAAU,gBAAgB;IAC3B,IAAI,CAAC,SAAS,CAAC,WAAW;QAAE,OAAO;IAEnC,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,EAAC,IAAI,EAAE,aAAa,EAAC,CAAC,CAAC;IAE5E,IAAI,UAAU,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACX,4EAA4E,CAC/E,CAAC;IACN,CAAC;IAED,IAAI,UAAU,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAExC,UAAU,CAAC,QAAQ,GAAG,GAAG,EAAE;gBACvB,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAC3B,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBACjC,OAAO,EAAE,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACJ,MAAM,CAAC,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC,CAAC;gBAC/D,CAAC;YACL,CAAC,CAAC;YAGF,SAAS,CAAC,WAAW,CAAC,kBAAkB,CACpC,GAAG,EAAE;gBACD,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAC3B,OAAO,EAAE,CAAC;YACd,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;gBACN,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAC3B,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;YACpC,CAAC,EACD,EAAC,OAAO,EAAE,KAAK,EAAC,CACnB,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;AACL,CAAC;AAIc,KAAK,UAAU,cAAc,CACxC,UAA8B,EAAE;IAEhC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,gBAAgB,EAAE,CAAC;IAEzB,OAAO,eAAe,CAAC;QACnB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;QACjC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;KACtC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"geo-location.js","sourceRoot":"","sources":["../../../src/browser/geo-location.ts"],"names":[],"mappings":"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","sourcesContent":["// ─── Tipos ───────────────────────────────────────────────\r\n\r\nexport interface GeoLocation {\r\n    latitude: number;\r\n    longitude: number;\r\n    accuracy: number;\r\n    altitude: number | null;\r\n    altitudeAccuracy: number | null;\r\n    heading: number | null;\r\n    speed: number | null;\r\n    timestamp: number;\r\n}\r\n\r\nexport interface GeoLocationOptions {\r\n    enableHighAccuracy?: boolean;\r\n    timeout?: number;\r\n    maximumAge?: number;\r\n}\r\n\r\n// ─── Helpers ─────────────────────────────────────────────\r\n\r\nfunction positionToGeoLocation(position: GeolocationPosition): GeoLocation {\r\n    const {coords, timestamp} = position;\r\n    return {\r\n        latitude: coords.latitude,\r\n        longitude: coords.longitude,\r\n        accuracy: coords.accuracy,\r\n        altitude: coords.altitude,\r\n        altitudeAccuracy: coords.altitudeAccuracy,\r\n        heading: coords.heading,\r\n        speed: coords.speed,\r\n        timestamp,\r\n    };\r\n}\r\n\r\nfunction geolocationError(error: GeolocationPositionError): Error {\r\n    switch (error.code) {\r\n        case error.PERMISSION_DENIED:\r\n            return new Error('Has denegado el permiso de ubicación.');\r\n        case error.POSITION_UNAVAILABLE:\r\n            return new Error('No se pudo determinar tu ubicación.');\r\n        case error.TIMEOUT:\r\n            return new Error('Tiempo de espera agotado al obtener la ubicación.');\r\n        default:\r\n            return new Error('Error desconocido al obtener la ubicación.');\r\n    }\r\n}\r\n\r\nfunction requestPosition(options: PositionOptions): Promise<GeoLocation> {\r\n    return new Promise((resolve, reject) => {\r\n        navigator.geolocation.getCurrentPosition(\r\n            (position) => resolve(positionToGeoLocation(position)),\r\n            (error) => reject(geolocationError(error)),\r\n            options,\r\n        );\r\n    });\r\n}\r\n\r\nasync function ensurePermission(): Promise<void> {\r\n    if (!navigator.permissions) return;\r\n\r\n    const permission = await navigator.permissions.query({name: 'geolocation'});\r\n\r\n    if (permission.state === 'denied') {\r\n        throw new Error(\r\n            'Permiso de ubicación denegado. Actívalo en la configuración del navegador.',\r\n        );\r\n    }\r\n\r\n    if (permission.state === 'prompt') {\r\n        await new Promise<void>((resolve, reject) => {\r\n            // Escuchar cambio de estado del permiso\r\n            permission.onchange = () => {\r\n                permission.onchange = null;\r\n                if (permission.state === 'granted') {\r\n                    resolve();\r\n                } else {\r\n                    reject(new Error('Has denegado el permiso de ubicación.'));\r\n                }\r\n            };\r\n\r\n            // Forzar el diálogo nativo del navegador\r\n            navigator.geolocation.getCurrentPosition(\r\n                () => {\r\n                    permission.onchange = null;\r\n                    resolve();\r\n                },\r\n                (error) => {\r\n                    permission.onchange = null;\r\n                    reject(geolocationError(error));\r\n                },\r\n                {timeout: 30000},\r\n            );\r\n        });\r\n    }\r\n}\r\n\r\n// ─── Función principal ──────────────────────────────────\r\n\r\nexport default async function getGeoLocation(\r\n    options: GeoLocationOptions = {},\r\n): Promise<GeoLocation> {\r\n    if (!navigator.geolocation) {\r\n        throw new Error('Tu navegador no soporta geolocalización.');\r\n    }\r\n\r\n    await ensurePermission();\r\n\r\n    return requestPosition({\r\n        enableHighAccuracy: options.enableHighAccuracy ?? true,\r\n        timeout: options.timeout ?? 10000,\r\n        maximumAge: options.maximumAge ?? 0,\r\n    });\r\n}"]}

package/dist/cjs/browser/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/browser/index.ts"],"names":[],"mappings":"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","sourcesContent":["import {delay} from \"../utilities.js\";\n\ninterface FetchIntoOptions {\n    url?: string;\n    fetchOptions?: RequestInit;\n    runScripts?: boolean;\n    transition?: string;\n}\n\nexport async function waitFor(\n    selector: string,\n    options: { timeout?: number } = {}\n): Promise<HTMLElement | null> {\n    const {timeout = 5000} = options;\n\n    const element = document.querySelector(selector);\n    if (element) {\n        return element as HTMLElement;\n    }\n\n    let observer: MutationObserver | undefined;\n    const timeoutPromise = delay(timeout).then(() => {\n        observer?.disconnect();\n        return null;\n    });\n\n    const observerPromise = new Promise<HTMLElement | null>((resolve) => {\n        observer = new MutationObserver(() => {\n            const element = document.querySelector(selector);\n            if (element) {\n                observer?.disconnect();\n                resolve(element as HTMLElement);\n            }\n        });\n\n        observer.observe(document.body, {\n            childList: true,\n            subtree: true,\n        });\n    });\n\n    return Promise.race([observerPromise, timeoutPromise]);\n}\n\nexport async function fetchInto(\n    selector: string,\n    options: FetchIntoOptions = {}\n): Promise<number> {\n    const {\n        url = window.location.href,\n        fetchOptions = {},\n        runScripts = false,\n        transition = null,\n    } = options;\n\n    const response = await fetch(url, fetchOptions);\n\n    if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n    }\n\n    const html = await response.text();\n    const doc = new DOMParser().parseFromString(html, \"text/html\");\n    const oldElements = document.querySelectorAll(selector);\n    let replacedCount = 0;\n\n    for (let i = 0; i < oldElements.length; i++) {\n        const oldEl = oldElements[i];\n        const newEl = doc.querySelector(selector);\n\n        if (!newEl) continue;\n\n        if (transition) {\n            oldEl.classList.add(transition);\n            await new Promise<void>((r) =>\n                requestAnimationFrame(() => requestAnimationFrame(() => r()))\n            );\n        }\n\n        oldEl.replaceWith(newEl.cloneNode(true));\n\n        if (runScripts) {\n            const scripts = newEl.querySelectorAll(\"script\");\n\n            for (let j = 0; j < scripts.length; j++) {\n                const script = scripts[j];\n                const fresh = document.createElement(\"script\");\n\n                if (script.src) {\n                    fresh.src = script.src;\n                } else {\n                    fresh.textContent = script.textContent;\n                }\n\n                const attrs = script.attributes;\n                for (let k = 0; k < attrs.length; k++) {\n                    if (attrs[k].name !== \"src\") {\n                        fresh.setAttribute(attrs[k].name, attrs[k].value);\n                    }\n                }\n\n                script.replaceWith(fresh);\n            }\n        }\n\n        replacedCount++;\n    }\n\n    return replacedCount;\n}\n\nexport * from './form-utilities.js';\n\nexport {default as NativeBridge} from \"./native-bridge.js\";\n\nexport {default as getGeoLocation} from './geo-location.js';"]}

package/dist/cjs/browser/native-bridge.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+// ─── Clase ──────────────────────────────────────────────
 class NativeBridge {
     constructor({ channel, timeout = 3000, callbackName = '__nativeResponseHandler' }) {
         this._pending = new Map();
@@ -10,6 +11,7 @@ class NativeBridge {
             throw new Error('Channel not found');
         }
         window[callbackName] = this._callback;
+        // Proxy: cualquier propiedad no existente se convierte en call()
         return new Proxy(this, {
             get(target, prop) {
                 if (prop in target) {
@@ -40,6 +42,7 @@ class NativeBridge {
         return new Promise((resolve, reject) => {
             const id = this._callId++;
             let timer = null;
+            // Solo crear timer si hay timeout
             if (effectiveTimeout !== null && effectiveTimeout > 0) {
                 timer = setTimeout(() => {
                     this._pending.delete(id);
@@ -53,9 +56,15 @@ class NativeBridge {
     send(method, data = null) {
         this._channel.postMessage(JSON.stringify({ method, data }));
     }
+    /**
+     * Número de llamadas pendientes
+     */
     get pendingCount() {
         return this._pending.size;
     }
+    /**
+     * Cancela todas las llamadas pendientes
+     */
     cancelAll() {
         for (const [, { reject, timer }] of this._pending) {
             if (timer !== null) {

package/dist/cjs/browser/native-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-bridge.js","sourceRoot":"","sources":["../../../src/browser/native-bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"native-bridge.js","sourceRoot":"","sources":["../../../src/browser/native-bridge.ts"],"names":[],"mappings":";;AAkBA,2DAA2D;AAE3D,MAAqB,YAAY;IAO7B,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,EAAE,YAAY,GAAG,yBAAyB,EAAiB;QANxF,aAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC1C,YAAO,GAAG,CAAC,CAAC;QAMhB,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QAExB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACzC,CAAC;QAEA,MAAc,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QAE/C,iEAAiE;QACjE,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE;YACnB,GAAG,CAAC,MAAoB,EAAE,IAAqB;gBAC3C,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;oBACjB,OAAQ,MAAc,CAAC,IAAI,CAAC,CAAC;gBACjC,CAAC;gBACD,OAAO,CAAC,IAAc,EAAE,OAAuB,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YACjG,CAAC;SACJ,CAA4B,CAAC;IAClC,CAAC;IAGO,SAAS,CAAC,EAAU,EAAE,KAAU,EAAE,MAAW;QAEjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO;QACX,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACzB,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAEzB,IAAI,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,MAAM,CAAC,KAAK,YAAY,KAAK,CAAA,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7E,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,OAAgB,IAAI,EAAE,OAAuB;QAG9D,MAAM,gBAAgB,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;QAEhF,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAE1B,IAAI,KAAK,GAAyC,IAAI,CAAC;YAEvD,kCAAkC;YAClC,IAAI,gBAAgB,KAAK,IAAI,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;gBACpD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACpB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACzB,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,gBAAgB,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC;gBACpE,CAAC,EAAE,gBAAgB,CAAC,CAAC;YACzB,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,QAAS,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACP,CAAC;IAGD,IAAI,CAAC,MAAc,EAAE,OAAgB,IAAI;QACrC,IAAI,CAAC,QAAS,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,SAAS;QACL,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,YAAY,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACJ;AAhGD,+BAgGC","sourcesContent":["// ─── Tipos ───────────────────────────────────────────────\r\ninterface BridgeOptions {\r\n    channel: Channel;\r\n    timeout?: number | null;\r\n    callbackName?: string;        // ← nuevo\r\n}\r\ninterface PendingCall {\r\n    resolve: (value: unknown) => void;\r\n    reject: (reason: Error) => void;\r\n    timer: ReturnType<typeof setTimeout> | null;\r\n}\r\n\r\ninterface Channel {\r\n    postMessage: (message: string) => void;\r\n}\r\n\r\n\r\n\r\n// ─── Clase ──────────────────────────────────────────────\r\n\r\nexport default class NativeBridge {\r\n    private _pending = new Map<number, PendingCall>();\r\n    private _callId = 0;\r\n    private readonly _defaultTimeout: number | null;\r\n    private readonly _channel: Channel;\r\n\r\n\r\n    constructor({ channel, timeout = 3000, callbackName = '__nativeResponseHandler' }: BridgeOptions) {\r\n        this._defaultTimeout = timeout;\r\n        this._channel = channel;\r\n\r\n        if (!this._channel) {\r\n            throw new Error('Channel not found');\r\n        }\r\n\r\n        (window as any)[callbackName] = this._callback;\r\n\r\n        // Proxy: cualquier propiedad no existente se convierte en call()\r\n        return new Proxy(this, {\r\n            get(target: NativeBridge, prop: string | symbol) {\r\n                if (prop in target) {\r\n                    return (target as any)[prop];\r\n                }\r\n                return (data?: unknown, timeout?: number | null) => target.call(String(prop), data, timeout);\r\n            },\r\n        }) as unknown as NativeBridge;\r\n    }\r\n\r\n\r\n    private _callback(id: number, error: any, result: any) {\r\n\r\n        const pending = this._pending.get(id);\r\n        if (!pending) {\r\n            return;\r\n        }\r\n\r\n        if (pending.timer !== null) {\r\n            clearTimeout(pending.timer);\r\n        }\r\n\r\n        this._pending.delete(id);\r\n\r\n        if (error) {\r\n            pending.reject(error instanceof Error? error : new Error(String(error)));\r\n        } else {\r\n            pending.resolve(result);\r\n        }\r\n    }\r\n\r\n    call(method: string, data: unknown = null, timeout?: number | null): Promise<unknown> {\r\n\r\n\r\n        const effectiveTimeout = timeout !== undefined ? timeout : this._defaultTimeout;\r\n\r\n        return new Promise<unknown>((resolve, reject) => {\r\n            const id = this._callId++;\r\n\r\n            let timer: ReturnType<typeof setTimeout> | null = null;\r\n\r\n            // Solo crear timer si hay timeout\r\n            if (effectiveTimeout !== null && effectiveTimeout > 0) {\r\n                timer = setTimeout(() => {\r\n                    this._pending.delete(id);\r\n                    reject(new Error(`Timeout (${effectiveTimeout}ms): ${method}`));\r\n                }, effectiveTimeout);\r\n            }\r\n\r\n            this._pending.set(id, { resolve, reject, timer });\r\n            this._channel!.postMessage(JSON.stringify({ id, method, data }));\r\n        });\r\n    }\r\n\r\n\r\n    send(method: string, data: unknown = null): void {\r\n        this._channel!.postMessage(JSON.stringify({ method, data }));\r\n    }\r\n\r\n    /**\r\n     * Número de llamadas pendientes\r\n     */\r\n    get pendingCount(): number {\r\n        return this._pending.size;\r\n    }\r\n\r\n    /**\r\n     * Cancela todas las llamadas pendientes\r\n     */\r\n    cancelAll(): void {\r\n        for (const [, { reject, timer }] of this._pending) {\r\n            if (timer !== null) {\r\n                clearTimeout(timer);\r\n            }\r\n            reject(new Error('Cancelled'));\r\n        }\r\n        this._pending.clear();\r\n    }\r\n}"]}

package/dist/cjs/cancellable-promise.js.map

@@ -1 +1 @@
-{"version":3,"file":"cancellable-promise.js","sourceRoot":"","sources":["../../src/cancellable-promise.ts"],"names":[],"mappings":";;AAMA,MAAqB,kBAAsB,SAAQ,OAAU;IAIzD,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACvB,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,YAAY,QAAuC;QAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtB,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC7C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,SAAkB,IAAI,KAAK,CAAC,mBAAmB,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAI,QAAiC;QACrD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CACpC,CAAC,SAAS,EAAE,EAAE;YACV,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,CAAC,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACN,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,CAAC,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC,CACJ,CAAC;IACN,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,SAAS,CAAI,QAAiC;QACvD,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,CAAC,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAI,QAAuC,EAAE,EAAU;QACrE,OAAO,IAAI,kBAAkB,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACzD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,CAAC,EAAE,EAAE,CAAC,CAAC;YAEP,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAtED,qCAsEC"}
+{"version":3,"file":"cancellable-promise.js","sourceRoot":"","sources":["../../src/cancellable-promise.ts"],"names":[],"mappings":";;AAMA,MAAqB,kBAAsB,SAAQ,OAAU;IAIzD,MAAM,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;QACvB,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,YAAY,QAAuC;QAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACtB,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC7C,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IAED,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,SAAkB,IAAI,KAAK,CAAC,mBAAmB,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAI,QAAiC;QACrD,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CACpC,CAAC,SAAS,EAAE,EAAE;YACV,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,CAAC,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACN,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,CAAC,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC,CACJ,CAAC;IACN,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,SAAS,CAAI,QAAiC;QACvD,IAAI,CAAC;YACD,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACvB,CAAC,CAAC,MAAM,EAAE,CAAC;YACf,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAI,QAAuC,EAAE,EAAU;QACrE,OAAO,IAAI,kBAAkB,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACzD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC;YAC1C,CAAC,EAAE,EAAE,CAAC,CAAC;YAEP,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAtED,qCAsEC","sourcesContent":["type CancellablePromiseExecutor<T> = (\r\n    resolve: (value: T | PromiseLike<T>) => void,\r\n    reject: (reason?: unknown) => void,\r\n    signal: AbortSignal\r\n) => void;\r\n\r\nexport default class CancellablePromise<T> extends Promise<T> {\r\n\r\n    private _controller: AbortController;\r\n\r\n    static get [Symbol.species]() {\r\n        return Promise;\r\n    }\r\n\r\n    constructor(executor: CancellablePromiseExecutor<T>) {\r\n        const controller = new AbortController();\r\n\r\n        super((resolve, reject) => {\r\n            controller.signal.addEventListener(\"abort\", () => {\r\n                reject(controller.signal.reason);\r\n            });\r\n\r\n            executor(resolve, reject, controller.signal);\r\n        });\r\n\r\n        this._controller = controller;\r\n    }\r\n\r\n    get cancelled(): boolean {\r\n        return this._controller.signal.aborted;\r\n    }\r\n\r\n    cancel(reason: unknown = new Error(\"Promesa cancelada\")): void {\r\n        if (!this.cancelled) {\r\n            this._controller.abort(reason);\r\n        }\r\n    }\r\n\r\n    static async compete<T>(promises: CancellablePromise<T>[]): Promise<T> {\r\n        return await Promise.race(promises).then(\r\n            (resultado) => {\r\n                for (const p of promises) {\r\n                    p.cancel();\r\n                }\r\n                return resultado;\r\n            },\r\n            (error) => {\r\n                for (const p of promises) {\r\n                    p.cancel();\r\n                }\r\n                throw error;\r\n            }\r\n        );\r\n    }\r\n\r\n    static async cooperate<T>(promises: CancellablePromise<T>[]): Promise<T[]> {\r\n        try {\r\n            return await Promise.all(promises);\r\n        } catch (error) {\r\n            for (const p of promises) {\r\n                p.cancel();\r\n            }\r\n            throw error;\r\n        }\r\n    }\r\n\r\n    static withTimeout<T>(executor: CancellablePromiseExecutor<T>, ms: number): CancellablePromise<T> {\r\n        return new CancellablePromise<T>((resolve, reject, signal) => {\r\n            const timer = setTimeout(() => {\r\n                reject(new Error(`Timeout: ${ms}ms`));\r\n            }, ms);\r\n\r\n            signal.addEventListener(\"abort\", () => clearTimeout(timer));\r\n            executor(resolve, reject, signal);\r\n        });\r\n    }\r\n}"]}

package/dist/cjs/clean-url-search-params.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 class CleanURLSearchParams extends URLSearchParams {
     constructor(params) {
+        // Filtrar `null` y `undefined` antes de pasarlos al constructor de URLSearchParams
         const cleanParams = Object.fromEntries(Object.entries(params || {}).filter(([_, value]) => value !== null && value !== undefined));
         super(cleanParams);
     }

package/dist/cjs/clean-url-search-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"clean-url-search-params.js","sourceRoot":"","sources":["../../src/clean-url-search-params.ts"],"names":[],"mappings":";;AAAA,MAAqB,oBAAqB,SAAQ,eAAe;IAC7D,YAAY,MAA4B;QAEpC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAClC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAC7F,CAAC;QAEF,KAAK,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC;CAGJ;AAXD,uCAWC"}
+{"version":3,"file":"clean-url-search-params.js","sourceRoot":"","sources":["../../src/clean-url-search-params.ts"],"names":[],"mappings":";;AAAA,MAAqB,oBAAqB,SAAQ,eAAe;IAC7D,YAAY,MAA4B;QACpC,mFAAmF;QACnF,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAClC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAC7F,CAAC;QAEF,KAAK,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC;CAGJ;AAXD,uCAWC","sourcesContent":["export default class CleanURLSearchParams extends URLSearchParams {\r\n    constructor(params?: Record<string, any>) {\r\n        // Filtrar `null` y `undefined` antes de pasarlos al constructor de URLSearchParams\r\n        const cleanParams = Object.fromEntries(\r\n            Object.entries(params || {}).filter(([_, value]) => value !== null && value !== undefined)\r\n        );\r\n\r\n        super(cleanParams);\r\n    }\r\n\r\n\r\n}"]}

package/dist/cjs/collections/cache-dictionary.js

@@ -1,18 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * A dictionary-like structure with caching and expiration capabilities.
+ * @template T - The type of the values stored in the cache.
+ */
 class CacheDictionary {
+    /**
+     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.
+     * @param {number | null} defaultDuration - Default duration in seconds for cache items.
+     */
     constructor(fallback = null, defaultDuration = null) {
         this.fallback = fallback;
         this.cache = {};
         this.defaultDuration = defaultDuration;
         this.expiration = {};
     }
+    /**
+     * Gets the expiration date for a specific key.
+     * @param {string} key - The key.
+     * @returns {Date | undefined} The expiration date or undefined.
+     */
     getExpiration(key) {
         return this.expiration[key];
     }
+    /**
+     * Sets a specific expiration date for a key.
+     * @param {string} key - The key.
+     * @param {Date | undefined} expiration - The expiration date.
+     */
     setExpiration(key, expiration) {
         this.expiration[key] = expiration;
     }
+    /**
+     * Sets a duration in seconds for a key's expiration.
+     * @param {string} key - The key.
+     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.
+     */
     setDuration(key, duration) {
         if (duration === null) {
             delete this.expiration[key];
@@ -23,6 +46,12 @@ class CacheDictionary {
             this.expiration[key] = expiration;
         }
     }
+    /**
+     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.
+     * If the item is expired, it's removed and null is returned.
+     * @param {string} key - The key to retrieve.
+     * @returns {T | null} The value or null if not found/expired.
+     */
     get(key) {
         if (!this.cache.hasOwnProperty(key)) {
             if (this.fallback) {
@@ -39,10 +68,20 @@ class CacheDictionary {
         }
         return this.cache[key];
     }
+    /**
+     * Sets a value in the cache with an optional duration.
+     * @param {string} key - The key.
+     * @param {T} value - The value to store.
+     * @param {number | null} duration - Duration in seconds.
+     */
     set(key, value, duration = null) {
         this.cache[key] = value;
         this.expiration[key] = this.calculateExpiration(duration);
     }
+    /**
+     * Removes an item from the cache.
+     * @param {string} key - The key to remove.
+     */
     remove(key) {
         delete this.cache[key];
         delete this.expiration[key];

package/dist/cjs/collections/cache-dictionary.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":";;AAAA,MAAqB,eAAe;IAMhC,YAAY,WAAwC,IAAI,EAAE,kBAAiC,IAAI;QAC3F,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACzB,CAAC;IAGM,aAAa,CAAC,GAAW;QAC5B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAEM,aAAa,CAAC,GAAW,EAAE,UAA4B;QAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;IACtC,CAAC;IAEM,WAAW,CAAC,GAAW,EAAE,QAAuB;QACnD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACJ,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;YAC9B,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC;YAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QACtC,CAAC;IACL,CAAC;IAEM,GAAG,CAAC,GAAW;QAClB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACJ,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAEM,GAAG,CAAC,GAAW,EAAE,KAAQ,EAAE,WAA0B,IAAI;QAC5D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAEM,MAAM,CAAC,GAAW;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAEO,SAAS,CAAC,GAAW;QACzB,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,UAAU,YAAY,IAAI,EAAE,CAAC;YAC7B,OAAO,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAEO,mBAAmB,CAAC,QAAuB;QAC/C,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;QAC9B,UAAU,CAAC,UAAU,CAAC,UAAU,CAAC,UAAU,EAAE,GAAG,QAAQ,CAAC,CAAC;QAC1D,OAAO,UAAU,CAAC;IACtB,CAAC;CACJ;AA7ED,kCA6EC"}
+{"version":3,"file":"cache-dictionary.js","sourceRoot":"","sources":["../../../src/collections/cache-dictionary.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * A dictionary-like structure with caching and expiration capabilities.\r\n * @template T - The type of the values stored in the cache.\r\n */\r\nexport default class CacheDictionary<T> {\r\n    private readonly fallback: ((key: string) => T) | null;\r\n    private readonly cache: { [key: string]: T };\r\n    private readonly defaultDuration: number | null;\r\n    private readonly expiration: { [key: string]: Date | undefined };\r\n\r\n    /**\r\n     * @param {((key: string) => T) | null} fallback - Optional function to call when a key is not found.\r\n     * @param {number | null} defaultDuration - Default duration in seconds for cache items.\r\n     */\r\n    constructor(fallback: ((key: string) => T) | null = null, defaultDuration: number | null = null) {\r\n        this.fallback = fallback;\r\n        this.cache = {};\r\n        this.defaultDuration = defaultDuration;\r\n        this.expiration = {};\r\n    }\r\n\r\n    /**\r\n     * Gets the expiration date for a specific key.\r\n     * @param {string} key - The key.\r\n     * @returns {Date | undefined} The expiration date or undefined.\r\n     */\r\n    public getExpiration(key: string): Date | undefined {\r\n        return this.expiration[key];\r\n    }\r\n\r\n    /**\r\n     * Sets a specific expiration date for a key.\r\n     * @param {string} key - The key.\r\n     * @param {Date | undefined} expiration - The expiration date.\r\n     */\r\n    public setExpiration(key: string, expiration: Date | undefined): void {\r\n        this.expiration[key] = expiration;\r\n    }\r\n\r\n    /**\r\n     * Sets a duration in seconds for a key's expiration.\r\n     * @param {string} key - The key.\r\n     * @param {number | null} duration - Duration in seconds. If null, expiration is removed.\r\n     */\r\n    public setDuration(key: string, duration: number | null): void {\r\n        if (duration === null) {\r\n            delete this.expiration[key];\r\n        } else {\r\n            const expiration = new Date();\r\n            expiration.setSeconds(expiration.getSeconds() + duration);\r\n            this.expiration[key] = expiration;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Gets a value from the cache. If not found and a fallback exists, it uses the fallback.\r\n     * If the item is expired, it's removed and null is returned.\r\n     * @param {string} key - The key to retrieve.\r\n     * @returns {T | null} The value or null if not found/expired.\r\n     */\r\n    public get(key: string): T | null {\r\n        if (!this.cache.hasOwnProperty(key)) {\r\n            if (this.fallback) {\r\n                this.cache[key] = this.fallback(key);\r\n                this.expiration[key] = this.calculateExpiration(this.defaultDuration);\r\n            } else {\r\n                return null;\r\n            }\r\n        }\r\n\r\n        if (this.isExpired(key)) {\r\n            this.remove(key);\r\n            return null;\r\n        }\r\n\r\n        return this.cache[key];\r\n    }\r\n\r\n    /**\r\n     * Sets a value in the cache with an optional duration.\r\n     * @param {string} key - The key.\r\n     * @param {T} value - The value to store.\r\n     * @param {number | null} duration - Duration in seconds.\r\n     */\r\n    public set(key: string, value: T, duration: number | null = null): void {\r\n        this.cache[key] = value;\r\n        this.expiration[key] = this.calculateExpiration(duration);\r\n    }\r\n\r\n    /**\r\n     * Removes an item from the cache.\r\n     * @param {string} key - The key to remove.\r\n     */\r\n    public remove(key: string): void {\r\n        delete this.cache[key];\r\n        delete this.expiration[key];\r\n    }\r\n\r\n    private isExpired(key: string): boolean {\r\n        const expiration = this.expiration[key];\r\n        if (expiration instanceof Date) {\r\n            return expiration < new Date();\r\n        }\r\n        return false;\r\n    }\r\n\r\n    private calculateExpiration(duration: number | null): Date | undefined {\r\n        if (duration === null) {\r\n            return undefined;\r\n        }\r\n\r\n        const expiration = new Date();\r\n        expiration.setSeconds(expiration.getSeconds() + duration);\r\n        return expiration;\r\n    }\r\n}"]}

package/dist/cjs/collections/default-map.js

@@ -1,19 +1,43 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * DefaultMap<K, V>
+ * A Map that automatically creates and saves a default value
+ * when accessing a non-existent key with get(key).
+ *
+ * @template K - The type of the keys.
+ * @template V - The type of the values.
+ * @example
+ *   const m = new DefaultMap<string, number>(() => 0);
+ *   m.get("a"); // 0
+ *   m.set("a", m.get("a") + 1); // 1
+ */
 class DefaultMap extends Map {
+    /**
+     * @param {UnaryFunction<K, V>} factoryMethod - Function that produces the default value for a key.
+     * @param {Optional<Iterable<[K, V]>>} entries - Initial entries.
+     */
     constructor(factoryMethod, entries = undefined) {
         super(entries);
         if (typeof factoryMethod !== "function") {
-            throw new TypeError("DefaultMap necesita una factory (key => defaultValue).");
+            throw new TypeError("DefaultMap needs a factory (key => defaultValue).");
         }
         this._factoryMethod = factoryMethod;
     }
+    /**
+     * Gets the value for the key. If it does not exist, it creates it using the factory,
+     * saves it, and returns it.
+     *
+     * @param {K} key - The key to get.
+     * @returns {V} The value associated with the key.
+     */
     get(key) {
         if (!super.has(key)) {
             const value = this._factoryMethod(key);
             super.set(key, value);
             return value;
         }
+        // ¡super.get puede devolver undefined si no existe! Pero ya comprobamos has(key)
         return super.get(key);
     }
 }

package/dist/cjs/collections/default-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-map.js","sourceRoot":"","sources":["../../../src/collections/default-map.ts"],"names":[],"mappings":";;AAWA,MAAqB,UAAiB,SAAQ,GAAS;IAOnD,YAAY,aAAkC,EAAE,UAAsC,SAAS;QAC3F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;YACtC,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;IACxC,CAAC;IAMQ,GAAG,CAAC,GAAM;QACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YACvC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAC3B,CAAC;CAGJ;AA9BD,6BA8BC"}
+{"version":3,"file":"default-map.js","sourceRoot":"","sources":["../../../src/collections/default-map.ts"],"names":[],"mappings":";;AAEA;;;;;;;;;;;GAWG;AACH,MAAqB,UAAiB,SAAQ,GAAS;IAGnD;;;OAGG;IACH,YAAY,aAAkC,EAAE,UAAsC,SAAS;QAC3F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,OAAO,aAAa,KAAK,UAAU,EAAE,CAAC;YACtC,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACM,GAAG,CAAC,GAAM;QACf,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YACvC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,iFAAiF;QACjF,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IAC3B,CAAC;CAGJ;AAjCD,6BAiCC","sourcesContent":["import type {Optional, UnaryFunction} from \"../types.js\";\r\n\r\n/**\r\n * DefaultMap<K, V>\r\n * A Map that automatically creates and saves a default value\r\n * when accessing a non-existent key with get(key).\r\n *\r\n * @template K - The type of the keys.\r\n * @template V - The type of the values.\r\n * @example\r\n *   const m = new DefaultMap<string, number>(() => 0);\r\n *   m.get(\"a\"); // 0\r\n *   m.set(\"a\", m.get(\"a\") + 1); // 1\r\n */\r\nexport default class DefaultMap<K, V> extends Map<K, V> {\r\n    private readonly _factoryMethod: (key: K) => V;\r\n\r\n    /**\r\n     * @param {UnaryFunction<K, V>} factoryMethod - Function that produces the default value for a key.\r\n     * @param {Optional<Iterable<[K, V]>>} entries - Initial entries.\r\n     */\r\n    constructor(factoryMethod: UnaryFunction<K, V>, entries: Optional<Iterable<[K, V]>> = undefined) {\r\n        super(entries);\r\n        if (typeof factoryMethod !== \"function\") {\r\n            throw new TypeError(\"DefaultMap needs a factory (key => defaultValue).\");\r\n        }\r\n        this._factoryMethod = factoryMethod;\r\n    }\r\n\r\n    /**\r\n     * Gets the value for the key. If it does not exist, it creates it using the factory,\r\n     * saves it, and returns it.\r\n     *\r\n     * @param {K} key - The key to get.\r\n     * @returns {V} The value associated with the key.\r\n     */\r\n    override get(key: K): V {\r\n        if (!super.has(key)) {\r\n            const value = this._factoryMethod(key);\r\n            super.set(key, value);\r\n            return value;\r\n        }\r\n        // ¡super.get puede devolver undefined si no existe! Pero ya comprobamos has(key)\r\n        return super.get(key)!;\r\n    }\r\n\r\n\r\n}\r\n"]}

package/dist/cjs/collections/default-weak-map.js

@@ -1,6 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-class DefaultMap extends WeakMap {
+/**
+ * DefaultWeakMap<K, V>
+ * A WeakMap that automatically creates and saves a default value
+ * when accessing a non-existent key with get(key).
+ *
+ * @template K - The type of the keys. Must be an object.
+ * @template V - The type of the values.
+ */
+class DefaultWeakMap extends WeakMap {
+    /**
+     * @param {UnaryFunction<K, V>} factoryMethod - Function that produces the default value for a key.
+     * @param {Optional<Iterable<[K, V]>>} entries - Initial entries.
+     */
     constructor(factoryMethod, entries = undefined) {
         super();
         if (entries != null) {
@@ -9,18 +21,26 @@ class DefaultMap extends WeakMap {
             }
         }
         if (typeof factoryMethod !== "function") {
-            throw new TypeError("DefaultMap necesita una factory (key => defaultValue).");
+            throw new TypeError("DefaultWeakMap needs a factory (key => defaultValue).");
         }
         this._factoryMethod = factoryMethod;
     }
+    /**
+     * Gets the value for the key. If it does not exist, it creates it using the factory,
+     * saves it, and returns it.
+     *
+     * @param {K} key - The key to get.
+     * @returns {V} The value associated with the key.
+     */
     get(key) {
         if (!super.has(key)) {
             const value = this._factoryMethod(key);
             super.set(key, value);
             return value;
         }
+        // ¡super.get puede devolver undefined si no existe! Pero ya comprobamos has(key)
         return super.get(key);
     }
 }
-exports.default = DefaultMap;
+exports.default = DefaultWeakMap;
 //# sourceMappingURL=default-weak-map.js.map