@kikiutils/shared 12.0.0 → 13.0.1

package/dist/random.cjs

@@ -1,31 +0,0 @@
-'use strict';
-
-/**
- * Generates a value using a provided generator function, where the input length
- * is determined by two levels of nested random ranges:
- *
- * 1. First, a random number (`innerMin`) is chosen between `minMin` and `minMax`.
- * 2. Then, a final length is chosen between `Math.max(innerMin, maxMin)` and `maxMax`.
- * 3. The generator is called with the final length and its result is returned.
- *
- * This function supports any return type by using a generic type parameter.
- *
- * @template T - The return type of the generator function
- *
- * @param {(length: number) => T} generator - A function that accepts a length and returns a value of type T
- * @param {number} minMin - Lower bound of the first random range
- * @param {number} minMax - Upper bound of the first random range
- * @param {number} maxMin - Lower bound of the second random range
- * @param {number} maxMax - Upper bound of the second random range
- *
- * @returns {T} The result of the generator function using the computed final length
- */
-function generateWithNestedRandomLength(generator, minMin, minMax, maxMin, maxMax) {
-    const random = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
-    const innerMin = random(minMin, minMax);
-    const finalLength = random(Math.max(innerMin, maxMin), maxMax);
-    return generator(finalLength);
-}
-
-exports.generateWithNestedRandomLength = generateWithNestedRandomLength;
-//# sourceMappingURL=random.cjs.map

package/dist/random.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"random.cjs","sources":["../src/random.ts"],"sourcesContent":["/**\n * Generates a value using a provided generator function, where the input length\n * is determined by two levels of nested random ranges:\n *\n * 1. First, a random number (`innerMin`) is chosen between `minMin` and `minMax`.\n * 2. Then, a final length is chosen between `Math.max(innerMin, maxMin)` and `maxMax`.\n * 3. The generator is called with the final length and its result is returned.\n *\n * This function supports any return type by using a generic type parameter.\n *\n * @template T - The return type of the generator function\n *\n * @param {(length: number) => T} generator - A function that accepts a length and returns a value of type T\n * @param {number} minMin - Lower bound of the first random range\n * @param {number} minMax - Upper bound of the first random range\n * @param {number} maxMin - Lower bound of the second random range\n * @param {number} maxMax - Upper bound of the second random range\n *\n * @returns {T} The result of the generator function using the computed final length\n */\nexport function generateWithNestedRandomLength<T = string>(\n    generator: (length: number) => T,\n    minMin: number,\n    minMax: number,\n    maxMin: number,\n    maxMax: number,\n) {\n    const random = (min: number, max: number) => Math.floor(Math.random() * (max - min + 1)) + min;\n    const innerMin = random(minMin, minMax);\n    const finalLength = random(Math.max(innerMin, maxMin), maxMax);\n    return generator(finalLength);\n}\n"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,8BAA8B,CAC1C,SAAgC,EAChC,MAAc,EACd,MAAc,EACd,MAAc,EACd,MAAc,EAAA;AAEd,IAAA,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,GAAW,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;IAC9F,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;AACvC,IAAA,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC;AAC9D,IAAA,OAAO,SAAS,CAAC,WAAW,CAAC;AACjC;;;;"}

package/dist/random.mjs

@@ -1,29 +0,0 @@
-/**
- * Generates a value using a provided generator function, where the input length
- * is determined by two levels of nested random ranges:
- *
- * 1. First, a random number (`innerMin`) is chosen between `minMin` and `minMax`.
- * 2. Then, a final length is chosen between `Math.max(innerMin, maxMin)` and `maxMax`.
- * 3. The generator is called with the final length and its result is returned.
- *
- * This function supports any return type by using a generic type parameter.
- *
- * @template T - The return type of the generator function
- *
- * @param {(length: number) => T} generator - A function that accepts a length and returns a value of type T
- * @param {number} minMin - Lower bound of the first random range
- * @param {number} minMax - Upper bound of the first random range
- * @param {number} maxMin - Lower bound of the second random range
- * @param {number} maxMax - Upper bound of the second random range
- *
- * @returns {T} The result of the generator function using the computed final length
- */
-function generateWithNestedRandomLength(generator, minMin, minMax, maxMin, maxMax) {
-    const random = (min, max) => Math.floor(Math.random() * (max - min + 1)) + min;
-    const innerMin = random(minMin, minMax);
-    const finalLength = random(Math.max(innerMin, maxMin), maxMax);
-    return generator(finalLength);
-}
-
-export { generateWithNestedRandomLength };
-//# sourceMappingURL=random.mjs.map

package/dist/random.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"random.mjs","sources":["../src/random.ts"],"sourcesContent":["/**\n * Generates a value using a provided generator function, where the input length\n * is determined by two levels of nested random ranges:\n *\n * 1. First, a random number (`innerMin`) is chosen between `minMin` and `minMax`.\n * 2. Then, a final length is chosen between `Math.max(innerMin, maxMin)` and `maxMax`.\n * 3. The generator is called with the final length and its result is returned.\n *\n * This function supports any return type by using a generic type parameter.\n *\n * @template T - The return type of the generator function\n *\n * @param {(length: number) => T} generator - A function that accepts a length and returns a value of type T\n * @param {number} minMin - Lower bound of the first random range\n * @param {number} minMax - Upper bound of the first random range\n * @param {number} maxMin - Lower bound of the second random range\n * @param {number} maxMax - Upper bound of the second random range\n *\n * @returns {T} The result of the generator function using the computed final length\n */\nexport function generateWithNestedRandomLength<T = string>(\n    generator: (length: number) => T,\n    minMin: number,\n    minMax: number,\n    maxMin: number,\n    maxMax: number,\n) {\n    const random = (min: number, max: number) => Math.floor(Math.random() * (max - min + 1)) + min;\n    const innerMin = random(minMin, minMax);\n    const finalLength = random(Math.max(innerMin, maxMin), maxMax);\n    return generator(finalLength);\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;AAmBG;AACG,SAAU,8BAA8B,CAC1C,SAAgC,EAChC,MAAc,EACd,MAAc,EACd,MAAc,EACd,MAAc,EAAA;AAEd,IAAA,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,GAAW,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG;IAC9F,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;AACvC,IAAA,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC;AAC9D,IAAA,OAAO,SAAS,CAAC,WAAW,CAAC;AACjC;;;;"}

package/dist/storage/enhanced/local/core.cjs

@@ -1,105 +0,0 @@
-'use strict';
-
-const superjson = require('superjson');
-
-var StorageValueEncodingType;
-(function (StorageValueEncodingType) {
-    StorageValueEncodingType["Json"] = "0";
-    StorageValueEncodingType["String"] = "1";
-})(StorageValueEncodingType || (StorageValueEncodingType = {}));
-const customValueHeader = '​⁠';
-const customValueHeaderLength = customValueHeader.length + 1;
-const toCustomValue = (type, payload) => `${customValueHeader}${type}${payload}`;
-/**
- * An enhanced localStorage wrapper that supports storing
- * complex data types (e.g. Dates, Maps, Sets) using SuperJSON encoding.
- *
- * This utility preserves type structure when saving and retrieving values.
- *
- * @example
- * ```typescript
- * import { enhancedLocalStorage } from '@kikiutils/shared/storage/enhanced/local';
- *
- * enhancedLocalStorage.setItem('user', { name: 'user', createdAt: new Date() });
- * const user = enhancedLocalStorage.getItem<{ name: string, createdAt: Date }>('user');
- * ```
- */
-const enhancedLocalStorage = Object.freeze({
-    /**
-     * Removes all items from localStorage.
-     */
-    clear: () => window.localStorage.clear(),
-    /**
-     * Retrieves a value by key and decodes it using SuperJSON or raw string.
-     *
-     * @template T - The expected type of the value
-     *
-     * @param {string} key - The key of the value to retrieve
-     *
-     * @returns {null | T} The decoded value or null if not found
-     */
-    getItem(key) {
-        const rawValue = window.localStorage.getItem(key);
-        return rawValue ? decodeStorageValue(rawValue) : null;
-    },
-    /**
-     * Checks whether a key exists in localStorage.
-     *
-     * @param {string} key - The key to check
-     *
-     * @returns {boolean} True if the key exists, false otherwise
-     */
-    hasItem: (key) => window.localStorage.getItem(key) !== null,
-    /**
-     * Returns the number of items stored in localStorage.
-     *
-     * @returns {number} The number of items stored in localStorage
-     */
-    get length() {
-        return window.localStorage.length;
-    },
-    /**
-     * Removes a specific key from localStorage.
-     *
-     * @param {string} key - The key to remove
-     */
-    removeItem: (key) => window.localStorage.removeItem(key),
-    /**
-     * Stores a value in localStorage with automatic serialization.
-     *
-     * @param {string} key - The key to store the value under
-     * @param {any} value - The value to store
-     */
-    setItem: (key, value) => window.localStorage.setItem(key, encodeToStorageValue(value)),
-});
-function decodeStorageValue(data) {
-    if (!isCustomFormat(data))
-        return data;
-    const payload = data.substring(customValueHeaderLength);
-    const type = data.charAt(customValueHeader.length);
-    switch (type) {
-        case StorageValueEncodingType.Json:
-            try {
-                return superjson.deserialize(JSON.parse(payload));
-            }
-            catch {
-                throw new Error('[EnhancedLocalStorage] Failed to parse JSON payload');
-            }
-        case StorageValueEncodingType.String: return payload;
-        default:
-            throw new Error(`[EnhancedLocalStorage] Unknown encoding type: ${type}`);
-    }
-}
-function encodeToStorageValue(value) {
-    if (typeof value === 'string')
-        return toCustomValue(StorageValueEncodingType.String, value);
-    return toCustomValue(StorageValueEncodingType.Json, JSON.stringify(superjson.serialize(value)));
-}
-function isCustomFormat(data) {
-    return (data.length >= customValueHeaderLength
-        && data[0] === customValueHeader[0]
-        && data[1] === customValueHeader[1]);
-}
-
-exports.enhancedLocalStorage = enhancedLocalStorage;
-//# sourceMappingURL=core.cjs.map

package/dist/storage/enhanced/local/core.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.cjs","sources":["../../../../src/storage/enhanced/local/core.ts"],"sourcesContent":["import {\n    deserialize,\n    serialize,\n} from 'superjson';\n\nenum StorageValueEncodingType {\n    Json = '0',\n    String = '1',\n}\n\nconst customValueHeader = '​⁠';\nconst customValueHeaderLength = customValueHeader.length + 1;\nconst toCustomValue = (type: StorageValueEncodingType, payload: string) => `${customValueHeader}${type}${payload}`;\n\n/**\n * An enhanced localStorage wrapper that supports storing\n * complex data types (e.g. Dates, Maps, Sets) using SuperJSON encoding.\n *\n * This utility preserves type structure when saving and retrieving values.\n *\n * @example\n * ```typescript\n * import { enhancedLocalStorage } from '@kikiutils/shared/storage/enhanced/local';\n *\n * enhancedLocalStorage.setItem('user', { name: 'user', createdAt: new Date() });\n * const user = enhancedLocalStorage.getItem<{ name: string, createdAt: Date }>('user');\n * ```\n */\nexport const enhancedLocalStorage = Object.freeze({\n    /**\n     * Removes all items from localStorage.\n     */\n    clear: () => window.localStorage.clear(),\n    /**\n     * Retrieves a value by key and decodes it using SuperJSON or raw string.\n     *\n     * @template T - The expected type of the value\n     *\n     * @param {string} key - The key of the value to retrieve\n     *\n     * @returns {null | T} The decoded value or null if not found\n     */\n    getItem<T = unknown>(key: string) {\n        const rawValue = window.localStorage.getItem(key);\n        return rawValue ? decodeStorageValue(rawValue) as T : null;\n    },\n    /**\n     * Checks whether a key exists in localStorage.\n     *\n     * @param {string} key - The key to check\n     *\n     * @returns {boolean} True if the key exists, false otherwise\n     */\n    hasItem: (key: string) => window.localStorage.getItem(key) !== null,\n    /**\n     * Returns the number of items stored in localStorage.\n     *\n     * @returns {number} The number of items stored in localStorage\n     */\n    get length() {\n        return window.localStorage.length;\n    },\n    /**\n     * Removes a specific key from localStorage.\n     *\n     * @param {string} key - The key to remove\n     */\n    removeItem: (key: string) => window.localStorage.removeItem(key),\n    /**\n     * Stores a value in localStorage with automatic serialization.\n     *\n     * @param {string} key - The key to store the value under\n     * @param {any} value - The value to store\n     */\n    setItem: (key: string, value: any) => window.localStorage.setItem(key, encodeToStorageValue(value)),\n});\n\nfunction decodeStorageValue(data: string) {\n    if (!isCustomFormat(data)) return data;\n    const payload = data.substring(customValueHeaderLength);\n    const type = data.charAt(customValueHeader.length);\n    switch (type) {\n        case StorageValueEncodingType.Json:\n            try {\n                return deserialize(JSON.parse(payload));\n            } catch {\n                throw new Error('[EnhancedLocalStorage] Failed to parse JSON payload');\n            }\n        case StorageValueEncodingType.String: return payload;\n        default:\n            throw new Error(`[EnhancedLocalStorage] Unknown encoding type: ${type}`);\n    }\n}\n\nfunction encodeToStorageValue(value: any) {\n    if (typeof value === 'string') return toCustomValue(StorageValueEncodingType.String, value);\n    return toCustomValue(StorageValueEncodingType.Json, JSON.stringify(serialize(value)));\n}\n\nfunction isCustomFormat(data: string) {\n    return (\n        data.length >= customValueHeaderLength\n        && data[0] === customValueHeader[0]\n        && data[1] === customValueHeader[1]\n    );\n}\n"],"names":["deserialize","serialize"],"mappings":";;;;AAKA,IAAK,wBAGJ;AAHD,CAAA,UAAK,wBAAwB,EAAA;AACzB,IAAA,wBAAA,CAAA,MAAA,CAAA,GAAA,GAAU;AACV,IAAA,wBAAA,CAAA,QAAA,CAAA,GAAA,GAAY;AAChB,CAAC,EAHI,wBAAwB,KAAxB,wBAAwB,GAAA,EAAA,CAAA,CAAA;AAK7B,MAAM,iBAAiB,GAAG,IAAI;AAC9B,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC;AAC5D,MAAM,aAAa,GAAG,CAAC,IAA8B,EAAE,OAAe,KAAK,CAAA,EAAG,iBAAiB,CAAA,EAAG,IAAI,CAAA,EAAG,OAAO,EAAE;AAElH;;;;;;;;;;;;;AAaG;AACI,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAC9C;;AAEG;IACH,KAAK,EAAE,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE;AACxC;;;;;;;;AAQG;AACH,IAAA,OAAO,CAAc,GAAW,EAAA;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;AACjD,QAAA,OAAO,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAM,GAAG,IAAI;IAC9D,CAAC;AACD;;;;;;AAMG;AACH,IAAA,OAAO,EAAE,CAAC,GAAW,KAAK,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI;AACnE;;;;AAIG;AACH,IAAA,IAAI,MAAM,GAAA;AACN,QAAA,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM;IACrC,CAAC;AACD;;;;AAIG;AACH,IAAA,UAAU,EAAE,CAAC,GAAW,KAAK,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;AAChE;;;;;AAKG;IACH,OAAO,EAAE,CAAC,GAAW,EAAE,KAAU,KAAK,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACtG,CAAA;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAA;AACpC,IAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;AAAE,QAAA,OAAO,IAAI;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC;IAClD,QAAQ,IAAI;QACR,KAAK,wBAAwB,CAAC,IAAI;AAC9B,YAAA,IAAI;gBACA,OAAOA,qBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3C;AAAE,YAAA,MAAM;AACJ,gBAAA,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC;YAC1E;AACJ,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE,OAAO,OAAO;AACpD,QAAA;AACI,YAAA,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,CAAA,CAAE,CAAC;;AAEpF;AAEA,SAAS,oBAAoB,CAAC,KAAU,EAAA;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC;AAC3F,IAAA,OAAO,aAAa,CAAC,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAACC,mBAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACzF;AAEA,SAAS,cAAc,CAAC,IAAY,EAAA;AAChC,IAAA,QACI,IAAI,CAAC,MAAM,IAAI;AACZ,WAAA,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC;WAC/B,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC;AAE3C;;;;"}

package/dist/storage/enhanced/local/core.mjs

@@ -1,103 +0,0 @@
-import { serialize, deserialize } from 'superjson';
-
-var StorageValueEncodingType;
-(function (StorageValueEncodingType) {
-    StorageValueEncodingType["Json"] = "0";
-    StorageValueEncodingType["String"] = "1";
-})(StorageValueEncodingType || (StorageValueEncodingType = {}));
-const customValueHeader = '​⁠';
-const customValueHeaderLength = customValueHeader.length + 1;
-const toCustomValue = (type, payload) => `${customValueHeader}${type}${payload}`;
-/**
- * An enhanced localStorage wrapper that supports storing
- * complex data types (e.g. Dates, Maps, Sets) using SuperJSON encoding.
- *
- * This utility preserves type structure when saving and retrieving values.
- *
- * @example
- * ```typescript
- * import { enhancedLocalStorage } from '@kikiutils/shared/storage/enhanced/local';
- *
- * enhancedLocalStorage.setItem('user', { name: 'user', createdAt: new Date() });
- * const user = enhancedLocalStorage.getItem<{ name: string, createdAt: Date }>('user');
- * ```
- */
-const enhancedLocalStorage = Object.freeze({
-    /**
-     * Removes all items from localStorage.
-     */
-    clear: () => window.localStorage.clear(),
-    /**
-     * Retrieves a value by key and decodes it using SuperJSON or raw string.
-     *
-     * @template T - The expected type of the value
-     *
-     * @param {string} key - The key of the value to retrieve
-     *
-     * @returns {null | T} The decoded value or null if not found
-     */
-    getItem(key) {
-        const rawValue = window.localStorage.getItem(key);
-        return rawValue ? decodeStorageValue(rawValue) : null;
-    },
-    /**
-     * Checks whether a key exists in localStorage.
-     *
-     * @param {string} key - The key to check
-     *
-     * @returns {boolean} True if the key exists, false otherwise
-     */
-    hasItem: (key) => window.localStorage.getItem(key) !== null,
-    /**
-     * Returns the number of items stored in localStorage.
-     *
-     * @returns {number} The number of items stored in localStorage
-     */
-    get length() {
-        return window.localStorage.length;
-    },
-    /**
-     * Removes a specific key from localStorage.
-     *
-     * @param {string} key - The key to remove
-     */
-    removeItem: (key) => window.localStorage.removeItem(key),
-    /**
-     * Stores a value in localStorage with automatic serialization.
-     *
-     * @param {string} key - The key to store the value under
-     * @param {any} value - The value to store
-     */
-    setItem: (key, value) => window.localStorage.setItem(key, encodeToStorageValue(value)),
-});
-function decodeStorageValue(data) {
-    if (!isCustomFormat(data))
-        return data;
-    const payload = data.substring(customValueHeaderLength);
-    const type = data.charAt(customValueHeader.length);
-    switch (type) {
-        case StorageValueEncodingType.Json:
-            try {
-                return deserialize(JSON.parse(payload));
-            }
-            catch {
-                throw new Error('[EnhancedLocalStorage] Failed to parse JSON payload');
-            }
-        case StorageValueEncodingType.String: return payload;
-        default:
-            throw new Error(`[EnhancedLocalStorage] Unknown encoding type: ${type}`);
-    }
-}
-function encodeToStorageValue(value) {
-    if (typeof value === 'string')
-        return toCustomValue(StorageValueEncodingType.String, value);
-    return toCustomValue(StorageValueEncodingType.Json, JSON.stringify(serialize(value)));
-}
-function isCustomFormat(data) {
-    return (data.length >= customValueHeaderLength
-        && data[0] === customValueHeader[0]
-        && data[1] === customValueHeader[1]);
-}
-
-export { enhancedLocalStorage };
-//# sourceMappingURL=core.mjs.map

package/dist/storage/enhanced/local/core.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.mjs","sources":["../../../../src/storage/enhanced/local/core.ts"],"sourcesContent":["import {\n    deserialize,\n    serialize,\n} from 'superjson';\n\nenum StorageValueEncodingType {\n    Json = '0',\n    String = '1',\n}\n\nconst customValueHeader = '​⁠';\nconst customValueHeaderLength = customValueHeader.length + 1;\nconst toCustomValue = (type: StorageValueEncodingType, payload: string) => `${customValueHeader}${type}${payload}`;\n\n/**\n * An enhanced localStorage wrapper that supports storing\n * complex data types (e.g. Dates, Maps, Sets) using SuperJSON encoding.\n *\n * This utility preserves type structure when saving and retrieving values.\n *\n * @example\n * ```typescript\n * import { enhancedLocalStorage } from '@kikiutils/shared/storage/enhanced/local';\n *\n * enhancedLocalStorage.setItem('user', { name: 'user', createdAt: new Date() });\n * const user = enhancedLocalStorage.getItem<{ name: string, createdAt: Date }>('user');\n * ```\n */\nexport const enhancedLocalStorage = Object.freeze({\n    /**\n     * Removes all items from localStorage.\n     */\n    clear: () => window.localStorage.clear(),\n    /**\n     * Retrieves a value by key and decodes it using SuperJSON or raw string.\n     *\n     * @template T - The expected type of the value\n     *\n     * @param {string} key - The key of the value to retrieve\n     *\n     * @returns {null | T} The decoded value or null if not found\n     */\n    getItem<T = unknown>(key: string) {\n        const rawValue = window.localStorage.getItem(key);\n        return rawValue ? decodeStorageValue(rawValue) as T : null;\n    },\n    /**\n     * Checks whether a key exists in localStorage.\n     *\n     * @param {string} key - The key to check\n     *\n     * @returns {boolean} True if the key exists, false otherwise\n     */\n    hasItem: (key: string) => window.localStorage.getItem(key) !== null,\n    /**\n     * Returns the number of items stored in localStorage.\n     *\n     * @returns {number} The number of items stored in localStorage\n     */\n    get length() {\n        return window.localStorage.length;\n    },\n    /**\n     * Removes a specific key from localStorage.\n     *\n     * @param {string} key - The key to remove\n     */\n    removeItem: (key: string) => window.localStorage.removeItem(key),\n    /**\n     * Stores a value in localStorage with automatic serialization.\n     *\n     * @param {string} key - The key to store the value under\n     * @param {any} value - The value to store\n     */\n    setItem: (key: string, value: any) => window.localStorage.setItem(key, encodeToStorageValue(value)),\n});\n\nfunction decodeStorageValue(data: string) {\n    if (!isCustomFormat(data)) return data;\n    const payload = data.substring(customValueHeaderLength);\n    const type = data.charAt(customValueHeader.length);\n    switch (type) {\n        case StorageValueEncodingType.Json:\n            try {\n                return deserialize(JSON.parse(payload));\n            } catch {\n                throw new Error('[EnhancedLocalStorage] Failed to parse JSON payload');\n            }\n        case StorageValueEncodingType.String: return payload;\n        default:\n            throw new Error(`[EnhancedLocalStorage] Unknown encoding type: ${type}`);\n    }\n}\n\nfunction encodeToStorageValue(value: any) {\n    if (typeof value === 'string') return toCustomValue(StorageValueEncodingType.String, value);\n    return toCustomValue(StorageValueEncodingType.Json, JSON.stringify(serialize(value)));\n}\n\nfunction isCustomFormat(data: string) {\n    return (\n        data.length >= customValueHeaderLength\n        && data[0] === customValueHeader[0]\n        && data[1] === customValueHeader[1]\n    );\n}\n"],"names":[],"mappings":";;AAKA,IAAK,wBAGJ;AAHD,CAAA,UAAK,wBAAwB,EAAA;AACzB,IAAA,wBAAA,CAAA,MAAA,CAAA,GAAA,GAAU;AACV,IAAA,wBAAA,CAAA,QAAA,CAAA,GAAA,GAAY;AAChB,CAAC,EAHI,wBAAwB,KAAxB,wBAAwB,GAAA,EAAA,CAAA,CAAA;AAK7B,MAAM,iBAAiB,GAAG,IAAI;AAC9B,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC;AAC5D,MAAM,aAAa,GAAG,CAAC,IAA8B,EAAE,OAAe,KAAK,CAAA,EAAG,iBAAiB,CAAA,EAAG,IAAI,CAAA,EAAG,OAAO,EAAE;AAElH;;;;;;;;;;;;;AAaG;AACI,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAC9C;;AAEG;IACH,KAAK,EAAE,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE;AACxC;;;;;;;;AAQG;AACH,IAAA,OAAO,CAAc,GAAW,EAAA;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;AACjD,QAAA,OAAO,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAM,GAAG,IAAI;IAC9D,CAAC;AACD;;;;;;AAMG;AACH,IAAA,OAAO,EAAE,CAAC,GAAW,KAAK,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI;AACnE;;;;AAIG;AACH,IAAA,IAAI,MAAM,GAAA;AACN,QAAA,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM;IACrC,CAAC;AACD;;;;AAIG;AACH,IAAA,UAAU,EAAE,CAAC,GAAW,KAAK,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;AAChE;;;;;AAKG;IACH,OAAO,EAAE,CAAC,GAAW,EAAE,KAAU,KAAK,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACtG,CAAA;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAA;AACpC,IAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;AAAE,QAAA,OAAO,IAAI;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC;IAClD,QAAQ,IAAI;QACR,KAAK,wBAAwB,CAAC,IAAI;AAC9B,YAAA,IAAI;gBACA,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC3C;AAAE,YAAA,MAAM;AACJ,gBAAA,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC;YAC1E;AACJ,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE,OAAO,OAAO;AACpD,QAAA;AACI,YAAA,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,CAAA,CAAE,CAAC;;AAEpF;AAEA,SAAS,oBAAoB,CAAC,KAAU,EAAA;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC;AAC3F,IAAA,OAAO,aAAa,CAAC,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACzF;AAEA,SAAS,cAAc,CAAC,IAAY,EAAA;AAChC,IAAA,QACI,IAAI,CAAC,MAAM,IAAI;AACZ,WAAA,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC;WAC/B,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC;AAE3C;;;;"}

package/dist/storage/enhanced/local/index.cjs

@@ -1,10 +0,0 @@
-'use strict';
-
-const core = require('./core.cjs');
-const keyedStore = require('./keyed-store.cjs');
-
-
-
-exports.enhancedLocalStorage = core.enhancedLocalStorage;
-exports.createKeyedEnhancedLocalStore = keyedStore.createKeyedEnhancedLocalStore;
-//# sourceMappingURL=index.cjs.map

package/dist/storage/enhanced/local/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}

package/dist/storage/enhanced/local/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/storage/enhanced/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,eAAe,CAAC"}

package/dist/storage/enhanced/local/index.mjs

@@ -1,3 +0,0 @@
-export { enhancedLocalStorage } from './core.mjs';
-export { createKeyedEnhancedLocalStore } from './keyed-store.mjs';
-//# sourceMappingURL=index.mjs.map

package/dist/storage/enhanced/local/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/storage/enhanced/local/keyed-store.cjs

@@ -1,41 +0,0 @@
-'use strict';
-
-const core = require('./core.cjs');
-
-/**
- * Creates a reusable, type-safe storage interface based on `enhancedLocalStorage`
- * and a dynamic key-generation function.
- *
- * This utility allows you to abstract away key construction logic and work directly
- * with scoped key-value operations like `getItem`, `setItem`, and `removeItem`.
- *
- * @template D - The value type to store
- *
- * @returns A factory that accepts a key generator function and returns a scoped storage interface
- *
- * @example
- * ```typescript
- * import { createKeyedEnhancedLocalStore } from '@kikiutils/shared/storage/enhanced/local';
- *
- * const userStore = createKeyedEnhancedLocalStore<User>()((id: number) => `user:${id}`);
- * userStore.setItem({ id: 123, name: 'user' }, 123);
- * const user = userStore.getItem(123);
- * ```
- */
-function createKeyedEnhancedLocalStore() {
-    return (getKeyFunction) => Object.freeze({
-        getItem: (...args) => core.enhancedLocalStorage.getItem(getKeyFunction(...args)),
-        hasItem: (...args) => core.enhancedLocalStorage.hasItem(getKeyFunction(...args)),
-        removeItem: (...args) => core.enhancedLocalStorage.removeItem(getKeyFunction(...args)),
-        /**
-         * Resolves the storage key from the given arguments.
-         *
-         * @returns {string} The final string key used internally
-         */
-        resolveKey: (...args) => getKeyFunction(...args),
-        setItem: (value, ...args) => core.enhancedLocalStorage.setItem(getKeyFunction(...args), value),
-    });
-}
-
-exports.createKeyedEnhancedLocalStore = createKeyedEnhancedLocalStore;
-//# sourceMappingURL=keyed-store.cjs.map

package/dist/storage/enhanced/local/keyed-store.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"keyed-store.cjs","sources":["../../../../src/storage/enhanced/local/keyed-store.ts"],"sourcesContent":["import { enhancedLocalStorage } from './core';\n\n/**\n * Creates a reusable, type-safe storage interface based on `enhancedLocalStorage`\n * and a dynamic key-generation function.\n *\n * This utility allows you to abstract away key construction logic and work directly\n * with scoped key-value operations like `getItem`, `setItem`, and `removeItem`.\n *\n * @template D - The value type to store\n *\n * @returns A factory that accepts a key generator function and returns a scoped storage interface\n *\n * @example\n * ```typescript\n * import { createKeyedEnhancedLocalStore } from '@kikiutils/shared/storage/enhanced/local';\n *\n * const userStore = createKeyedEnhancedLocalStore<User>()((id: number) => `user:${id}`);\n * userStore.setItem({ id: 123, name: 'user' }, 123);\n * const user = userStore.getItem(123);\n * ```\n */\nexport function createKeyedEnhancedLocalStore<D = unknown>() {\n    return <P extends any[]>(getKeyFunction: (...args: P) => string) => Object.freeze({\n        getItem: (...args: P) => enhancedLocalStorage.getItem<D>(getKeyFunction(...args)),\n        hasItem: (...args: P) => enhancedLocalStorage.hasItem(getKeyFunction(...args)),\n        removeItem: (...args: P) => enhancedLocalStorage.removeItem(getKeyFunction(...args)),\n        /**\n         * Resolves the storage key from the given arguments.\n         *\n         * @returns {string} The final string key used internally\n         */\n        resolveKey: (...args: P) => getKeyFunction(...args),\n        setItem: (value: D, ...args: P) => enhancedLocalStorage.setItem(getKeyFunction(...args), value),\n    });\n}\n"],"names":["enhancedLocalStorage"],"mappings":";;;;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;SACa,6BAA6B,GAAA;IACzC,OAAO,CAAkB,cAAsC,KAAK,MAAM,CAAC,MAAM,CAAC;AAC9E,QAAA,OAAO,EAAE,CAAC,GAAG,IAAO,KAAKA,yBAAoB,CAAC,OAAO,CAAI,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;AACjF,QAAA,OAAO,EAAE,CAAC,GAAG,IAAO,KAAKA,yBAAoB,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9E,QAAA,UAAU,EAAE,CAAC,GAAG,IAAO,KAAKA,yBAAoB,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;AACpF;;;;AAIG;QACH,UAAU,EAAE,CAAC,GAAG,IAAO,KAAK,cAAc,CAAC,GAAG,IAAI,CAAC;QACnD,OAAO,EAAE,CAAC,KAAQ,EAAE,GAAG,IAAO,KAAKA,yBAAoB,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC;AAClG,KAAA,CAAC;AACN;;;;"}

package/dist/storage/enhanced/local/keyed-store.mjs

@@ -1,39 +0,0 @@
-import { enhancedLocalStorage } from './core.mjs';
-
-/**
- * Creates a reusable, type-safe storage interface based on `enhancedLocalStorage`
- * and a dynamic key-generation function.
- *
- * This utility allows you to abstract away key construction logic and work directly
- * with scoped key-value operations like `getItem`, `setItem`, and `removeItem`.
- *
- * @template D - The value type to store
- *
- * @returns A factory that accepts a key generator function and returns a scoped storage interface
- *
- * @example
- * ```typescript
- * import { createKeyedEnhancedLocalStore } from '@kikiutils/shared/storage/enhanced/local';
- *
- * const userStore = createKeyedEnhancedLocalStore<User>()((id: number) => `user:${id}`);
- * userStore.setItem({ id: 123, name: 'user' }, 123);
- * const user = userStore.getItem(123);
- * ```
- */
-function createKeyedEnhancedLocalStore() {
-    return (getKeyFunction) => Object.freeze({
-        getItem: (...args) => enhancedLocalStorage.getItem(getKeyFunction(...args)),
-        hasItem: (...args) => enhancedLocalStorage.hasItem(getKeyFunction(...args)),
-        removeItem: (...args) => enhancedLocalStorage.removeItem(getKeyFunction(...args)),
-        /**
-         * Resolves the storage key from the given arguments.
-         *
-         * @returns {string} The final string key used internally
-         */
-        resolveKey: (...args) => getKeyFunction(...args),
-        setItem: (value, ...args) => enhancedLocalStorage.setItem(getKeyFunction(...args), value),
-    });
-}
-
-export { createKeyedEnhancedLocalStore };
-//# sourceMappingURL=keyed-store.mjs.map

package/dist/storage/enhanced/local/keyed-store.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"keyed-store.mjs","sources":["../../../../src/storage/enhanced/local/keyed-store.ts"],"sourcesContent":["import { enhancedLocalStorage } from './core';\n\n/**\n * Creates a reusable, type-safe storage interface based on `enhancedLocalStorage`\n * and a dynamic key-generation function.\n *\n * This utility allows you to abstract away key construction logic and work directly\n * with scoped key-value operations like `getItem`, `setItem`, and `removeItem`.\n *\n * @template D - The value type to store\n *\n * @returns A factory that accepts a key generator function and returns a scoped storage interface\n *\n * @example\n * ```typescript\n * import { createKeyedEnhancedLocalStore } from '@kikiutils/shared/storage/enhanced/local';\n *\n * const userStore = createKeyedEnhancedLocalStore<User>()((id: number) => `user:${id}`);\n * userStore.setItem({ id: 123, name: 'user' }, 123);\n * const user = userStore.getItem(123);\n * ```\n */\nexport function createKeyedEnhancedLocalStore<D = unknown>() {\n    return <P extends any[]>(getKeyFunction: (...args: P) => string) => Object.freeze({\n        getItem: (...args: P) => enhancedLocalStorage.getItem<D>(getKeyFunction(...args)),\n        hasItem: (...args: P) => enhancedLocalStorage.hasItem(getKeyFunction(...args)),\n        removeItem: (...args: P) => enhancedLocalStorage.removeItem(getKeyFunction(...args)),\n        /**\n         * Resolves the storage key from the given arguments.\n         *\n         * @returns {string} The final string key used internally\n         */\n        resolveKey: (...args: P) => getKeyFunction(...args),\n        setItem: (value: D, ...args: P) => enhancedLocalStorage.setItem(getKeyFunction(...args), value),\n    });\n}\n"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;;;;;;AAmBG;SACa,6BAA6B,GAAA;IACzC,OAAO,CAAkB,cAAsC,KAAK,MAAM,CAAC,MAAM,CAAC;AAC9E,QAAA,OAAO,EAAE,CAAC,GAAG,IAAO,KAAK,oBAAoB,CAAC,OAAO,CAAI,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;AACjF,QAAA,OAAO,EAAE,CAAC,GAAG,IAAO,KAAK,oBAAoB,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;AAC9E,QAAA,UAAU,EAAE,CAAC,GAAG,IAAO,KAAK,oBAAoB,CAAC,UAAU,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,CAAC;AACpF;;;;AAIG;QACH,UAAU,EAAE,CAAC,GAAG,IAAO,KAAK,cAAc,CAAC,GAAG,IAAI,CAAC;QACnD,OAAO,EAAE,CAAC,KAAQ,EAAE,GAAG,IAAO,KAAK,oBAAoB,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC;AAClG,KAAA,CAAC;AACN;;;;"}

package/dist/storage/enhanced/redis/core.cjs

@@ -1,144 +0,0 @@
-'use strict';
-
-const node_buffer = require('node:buffer');
-const ioredis = require('ioredis');
-const superjson = require('superjson');
-
-var StorageValueEncodingType;
-(function (StorageValueEncodingType) {
-    StorageValueEncodingType[StorageValueEncodingType["Buffer"] = 0] = "Buffer";
-    StorageValueEncodingType[StorageValueEncodingType["Json"] = 1] = "Json";
-    StorageValueEncodingType[StorageValueEncodingType["String"] = 2] = "String";
-})(StorageValueEncodingType || (StorageValueEncodingType = {}));
-const customValueHeader = node_buffer.Buffer.of(0xE2, 0x81, 0xA0);
-const customValueHeaderLength = customValueHeader.byteLength + 1;
-/**
- * Creates an enhanced Redis-based storage interface using SuperJSON encoding.
- *
- * This utility provides a typed, serializable key-value store backed by Redis,
- * supporting TTL operations and safe deserialization of complex types (e.g. Date, Map).
- *
- * @param {Redis | string} ioRedisInstanceOrUrl - Either an existing `ioredis` instance or a Redis connection string
- *
- * @returns A frozen object that wraps Redis commands with typed get/set logic and encoding
- *
- * @example
- * ```typescript
- * import { createEnhancedRedisStorage } from '@kikiutils/shared/storage/enhanced/redis';
- *
- * const redisStorage = createEnhancedRedisStorage('redis://localhost');
- * await redisStorage.setItem('user:1', { name: 'user' });
- * const user = await redisStorage.getItem<{ name: string }>('user:1');
- * ```
- */
-function createEnhancedRedisStorage(ioRedisInstanceOrUrl) {
-    const instance = ioRedisInstanceOrUrl instanceof ioredis.Redis ? ioRedisInstanceOrUrl : new ioredis.Redis(ioRedisInstanceOrUrl);
-    return Object.freeze({
-        /**
-         * Retrieves a value from Redis and decodes it.
-         *
-         * @template T - The expected return type
-         *
-         * @param {string} key - The Redis key
-         *
-         * @returns {Promise<null | T>} The decoded value or null if not found
-         */
-        async getItem(key) {
-            const rawValue = await instance.getBuffer(key);
-            return rawValue ? decodeStorageValue(rawValue) : null;
-        },
-        /**
-         * Gets the remaining TTL (in seconds) for a given key.
-         *
-         * @param {string} key - The Redis key
-         *
-         * @returns {Promise<number>} The number of seconds until the key expires, or -1 if no expiration is set
-         */
-        getItemTtl: (key) => instance.ttl(key),
-        /**
-         * Checks whether a key exists in Redis.
-         *
-         * @param {string} key - The Redis key
-         *
-         * @returns {Promise<boolean>} True if the key exists, false otherwise
-         */
-        hasItem: async (key) => await instance.exists(key) === 1,
-        /**
-         * The underlying Redis instance, exposed for advanced operations.
-         * Use with caution; most use cases should rely on the wrapper methods.
-         *
-         * @returns {Redis} The underlying Redis instance
-         */
-        get instance() {
-            return instance;
-        },
-        /**
-         * Removes a key from Redis.
-         *
-         * @param {string} key - The Redis key to delete
-         *
-         * @returns {Promise<boolean>} A Promise that resolves to `true` if the key was removed,
-         * or `false` if it did not exist.
-         */
-        removeItem: async (key) => await instance.del(key) === 1,
-        /**
-         * Stores a value in Redis without expiration.
-         *
-         * @param {string} key - The Redis key
-         * @param {any} value - The value to store. Will be serialized
-         */
-        setItem: (key, value) => instance.set(key, encodeToStorageValue(value)),
-        /**
-         * Stores a value in Redis with a time-to-live (TTL).
-         *
-         * @param {string} key - The Redis key
-         * @param {number} seconds - Expiration time in seconds
-         * @param {any} value - The value to store. Will be serialized
-         */
-        setItemWithTtl(key, seconds, value) {
-            return instance.setex(key, seconds, encodeToStorageValue(value));
-        },
-    });
-}
-function decodeStorageValue(data) {
-    if (!isCustomFormat(data))
-        return data;
-    const payload = data.subarray(customValueHeaderLength);
-    const type = data[customValueHeader.byteLength];
-    switch (type) {
-        case StorageValueEncodingType.Buffer: return payload;
-        case StorageValueEncodingType.Json:
-            try {
-                return superjson.deserialize(JSON.parse(payload.toString()));
-            }
-            catch {
-                throw new Error('[RedisStorage] Failed to parse JSON payload');
-            }
-        case StorageValueEncodingType.String: return payload.toString();
-        default:
-            throw new Error(`[RedisStorage] Unknown encoding type: ${type}`);
-    }
-}
-function encodeToStorageValue(value) {
-    if (node_buffer.Buffer.isBuffer(value))
-        return toCustomValue(StorageValueEncodingType.Buffer, value);
-    if (typeof value === 'string')
-        return toCustomValue(StorageValueEncodingType.String, node_buffer.Buffer.from(value));
-    return toCustomValue(StorageValueEncodingType.Json, node_buffer.Buffer.from(JSON.stringify(superjson.serialize(value))));
-}
-function isCustomFormat(buffer) {
-    return (buffer.length >= customValueHeaderLength
-        && buffer[0] === customValueHeader[0]
-        && buffer[1] === customValueHeader[1]
-        && buffer[2] === customValueHeader[2]);
-}
-function toCustomValue(type, payload) {
-    return node_buffer.Buffer.concat([
-        customValueHeader,
-        node_buffer.Buffer.of(type),
-        payload,
-    ]);
-}
-
-exports.createEnhancedRedisStorage = createEnhancedRedisStorage;
-//# sourceMappingURL=core.cjs.map

package/dist/storage/enhanced/redis/core.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.cjs","sources":["../../../../src/storage/enhanced/redis/core.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\n\nimport { Redis } from 'ioredis';\nimport {\n    deserialize,\n    serialize,\n} from 'superjson';\n\nenum StorageValueEncodingType {\n    Buffer = 0,\n    Json = 1,\n    String = 2,\n}\n\nconst customValueHeader = Buffer.of(\n    0xE2,\n    0x81,\n    0xA0,\n);\n\nconst customValueHeaderLength = customValueHeader.byteLength + 1;\n\n/**\n * Creates an enhanced Redis-based storage interface using SuperJSON encoding.\n *\n * This utility provides a typed, serializable key-value store backed by Redis,\n * supporting TTL operations and safe deserialization of complex types (e.g. Date, Map).\n *\n * @param {Redis | string} ioRedisInstanceOrUrl - Either an existing `ioredis` instance or a Redis connection string\n *\n * @returns A frozen object that wraps Redis commands with typed get/set logic and encoding\n *\n * @example\n * ```typescript\n * import { createEnhancedRedisStorage } from '@kikiutils/shared/storage/enhanced/redis';\n *\n * const redisStorage = createEnhancedRedisStorage('redis://localhost');\n * await redisStorage.setItem('user:1', { name: 'user' });\n * const user = await redisStorage.getItem<{ name: string }>('user:1');\n * ```\n */\nexport function createEnhancedRedisStorage(ioRedisInstanceOrUrl: Redis | string) {\n    const instance = ioRedisInstanceOrUrl instanceof Redis ? ioRedisInstanceOrUrl : new Redis(ioRedisInstanceOrUrl);\n    return Object.freeze({\n        /**\n         * Retrieves a value from Redis and decodes it.\n         *\n         * @template T - The expected return type\n         *\n         * @param {string} key - The Redis key\n         *\n         * @returns {Promise<null | T>} The decoded value or null if not found\n         */\n        async getItem<T = unknown>(key: string) {\n            const rawValue = await instance.getBuffer(key);\n            return rawValue ? decodeStorageValue(rawValue) as T : null;\n        },\n        /**\n         * Gets the remaining TTL (in seconds) for a given key.\n         *\n         * @param {string} key - The Redis key\n         *\n         * @returns {Promise<number>} The number of seconds until the key expires, or -1 if no expiration is set\n         */\n        getItemTtl: (key: string) => instance.ttl(key),\n        /**\n         * Checks whether a key exists in Redis.\n         *\n         * @param {string} key - The Redis key\n         *\n         * @returns {Promise<boolean>} True if the key exists, false otherwise\n         */\n        hasItem: async (key: string) => await instance.exists(key) === 1,\n        /**\n         * The underlying Redis instance, exposed for advanced operations.\n         * Use with caution; most use cases should rely on the wrapper methods.\n         *\n         * @returns {Redis} The underlying Redis instance\n         */\n        get instance() {\n            return instance;\n        },\n        /**\n         * Removes a key from Redis.\n         *\n         * @param {string} key - The Redis key to delete\n         *\n         * @returns {Promise<boolean>} A Promise that resolves to `true` if the key was removed,\n         * or `false` if it did not exist.\n         */\n        removeItem: async (key: string) => await instance.del(key) === 1,\n        /**\n         * Stores a value in Redis without expiration.\n         *\n         * @param {string} key - The Redis key\n         * @param {any} value - The value to store. Will be serialized\n         */\n        setItem: (key: string, value: any) => instance.set(key, encodeToStorageValue(value)),\n        /**\n         * Stores a value in Redis with a time-to-live (TTL).\n         *\n         * @param {string} key - The Redis key\n         * @param {number} seconds - Expiration time in seconds\n         * @param {any} value - The value to store. Will be serialized\n         */\n        setItemWithTtl(key: string, seconds: number, value: any) {\n            return instance.setex(key, seconds, encodeToStorageValue(value));\n        },\n    });\n}\n\nfunction decodeStorageValue(data: Buffer) {\n    if (!isCustomFormat(data)) return data;\n    const payload = data.subarray(customValueHeaderLength);\n    const type = data[customValueHeader.byteLength];\n    switch (type) {\n        case StorageValueEncodingType.Buffer: return payload;\n        case StorageValueEncodingType.Json:\n            try {\n                return deserialize(JSON.parse(payload.toString()));\n            } catch {\n                throw new Error('[RedisStorage] Failed to parse JSON payload');\n            }\n        case StorageValueEncodingType.String: return payload.toString();\n        default:\n            throw new Error(`[RedisStorage] Unknown encoding type: ${type}`);\n    }\n}\n\nfunction encodeToStorageValue(value: any) {\n    if (Buffer.isBuffer(value)) return toCustomValue(StorageValueEncodingType.Buffer, value);\n    if (typeof value === 'string') return toCustomValue(StorageValueEncodingType.String, Buffer.from(value));\n    return toCustomValue(StorageValueEncodingType.Json, Buffer.from(JSON.stringify(serialize(value))));\n}\n\nfunction isCustomFormat(buffer: Buffer) {\n    return (\n        buffer.length >= customValueHeaderLength\n        && buffer[0] === customValueHeader[0]\n        && buffer[1] === customValueHeader[1]\n        && buffer[2] === customValueHeader[2]\n    );\n}\n\nfunction toCustomValue(type: StorageValueEncodingType, payload: Buffer) {\n    return Buffer.concat([\n        customValueHeader,\n        Buffer.of(type),\n        payload,\n    ]);\n}\n"],"names":["Buffer","Redis","deserialize","serialize"],"mappings":"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"}