@kikiutils/shared 9.2.0 → 9.3.1

package/README.md

@@ -5,24 +5,25 @@
 [![codecov][codecov-src]][codecov-href]
 [![License][license-src]][license-href]
 
-A lightweight modular utility library for JavaScript and TypeScript, offering secure hashing, flexible logging, date utilities, Vue/web helpers, and more.
+A lightweight and modular utility library for modern JavaScript and TypeScript — includes secure hashing, flexible logging, datetime tools, Vue/web helpers, storage abstraction, and more.
 
 - [✨ Release Notes](./CHANGELOG.md)
 
 ## Features
 
-- 📋 Clipboard utilities for copying text and blobs to the clipboard (Browser only)
-- 📜 Simple and flexible logging with Consola and Pino
-- 🔒 Secure hash utilities: MD5, SHA3-224/256/384/512
-- 📅 Datetime utilities for formatting, ranges, and offsets
-- 🔢 Enum helpers to extract values and keys
-- 🌱 Environment variable checker with error handling (Node only)
-- 📈 Math utilities like percentage formatting and rounding
-- 💎 Number formatting (e.g. compact, currency, padding)
-- 🔤 String tools such as random string generation and casing helpers
-- 🌐 URL utilities for parsing and building query strings
-- 🧩 Vue 3 utilities
-- ⚙️ General-purpose utilities like value extractors and type guards
+- 📋 Clipboard utilities — copy text and blobs using the modern Clipboard API (Browser only)
+- 📜 Logging utilities — simple and extensible logging via Consola and Pino
+- 🔒 Crypto utilities — secure hashing functions: MD5, SHA3-224/256/384/512
+- 📅 Datetime utilities — manipulate, format, and offset dates and ranges
+- 🔢 Enum utilities — extract enum keys and values (number or string)
+- 🌱 Environment helpers — safe env var access with error handling (Node only)
+- 📈 Math utilities — rounding, formatting percentages, and ratios
+- 💎 Number utilities — number padding, compact display, currency formatting
+- 🔤 String utilities — casing, trimming, random string generation, etc.
+- 🌐 URL utilities — parse and construct query strings and redirect URLs
+- 🧩 Vue 3 utilities — composables like scroll preservation and key handling
+- 🖥️ Web utilities — browser DOM helpers (e.g. scroll to top, key matching)
+- 🗄️ Storage utilities — enhanced localStorage, Redis, and LRU abstractions
 - 📦 Modular by design — import only what you need via `@kikiutils/shared/<module>`
 
 ## Requirements
@@ -66,15 +67,15 @@ logger.info(value);
 
 Each module file includes function-level comments and usage examples.
 
-### [consola](./src/consola.ts)
-
-Console logger integration.
-
 ### [clipboard](./src/clipboard.ts)
 
 - `copyBlobToClipboard`
 - `copyTextToClipboard`
 
+### [consola](./src/consola.ts)
+
+Console logger integration.
+
 ### [crypto-hash](./src/crypto-hash.ts)
 
 - `cryptoMd5`, `cryptoMd5ToBuffer`
@@ -125,6 +126,22 @@ Pino logger integration.
 
 - `generateWithNestedRandomLength`
 
+### storage
+
+#### [enhanced-local](./src/storage/enhanced/local/index.ts)
+
+- `createKeyedEnhancedLocalStore`
+- `enhancedLocalStorage`
+
+#### [enhanced-redis](./src/storage/enhanced/redis/index.ts)
+
+- `createEnhancedRedisStorage`
+- `createKeyedEnhancedRedisStore`
+
+#### [lru/keyed-store](./src/storage/lru/keyed-store.ts)
+
+- `createKeyedLruStore`
+
 ### [string](./src/string.ts)
 
 - `randomString`

package/dist/env.cjs

@@ -22,9 +22,12 @@ class EnvironmentNotFoundError extends Error {
     }
 }
 /**
- * Retrieves the value of an environment variable, or throws an error if not set.
+ * Retrieves the value of an environment variable, or throws an error if it is not defined.
  *
- * @param {string} key - The environment variable key to check.
+ * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string
+ * value like `'0'` or `'false'` is considered a valid (defined) value.
+ *
+ * @param {string} key - The environment variable key to retrieve.
  *
  * @returns {string} The value of the environment variable.
  *
@@ -32,21 +35,15 @@ class EnvironmentNotFoundError extends Error {
  *
  * @example
  * ```typescript
- * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
- *
- * // When the environment variable 'API_KEY' is set:
- * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ * process.env.API_KEY = '';
+ * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
  *
- * // When the environment variable 'API_KEY' is not set:
- * try {
- *   const apiKey = checkAndGetEnvValue('API_KEY');
- * } catch (error) {
- *   console.error(error); // Missing environment variable: API_KEY
- * }
+ * delete process.env.API_KEY;
+ * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError
  * ```
  */
 function checkAndGetEnvValue(key) {
-    if (!process.env[key])
+    if (process.env[key] === undefined)
         throw new EnvironmentNotFoundError(key);
     return process.env[key];
 }

package/dist/env.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if not set.\n *\n * @param {string} key - The environment variable key to check.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * import { checkAndGetEnvValue } from '@kikiutils/shared/env';\n *\n * // When the environment variable 'API_KEY' is set:\n * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY\n *\n * // When the environment variable 'API_KEY' is not set:\n * try {\n *   const apiKey = checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n *   console.error(error); // Missing environment variable: API_KEY\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (!process.env[key]) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":";;AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC9D,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;;"}
+{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if it is not defined.\n *\n * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n *\n * @param {string} key - The environment variable key to retrieve.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered \"defined\")\n *\n * delete process.env.API_KEY;\n * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":";;AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC3E,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;;"}

package/dist/env.d.ts

@@ -15,9 +15,12 @@ export declare class EnvironmentNotFoundError extends Error {
     constructor(key: string);
 }
 /**
- * Retrieves the value of an environment variable, or throws an error if not set.
+ * Retrieves the value of an environment variable, or throws an error if it is not defined.
  *
- * @param {string} key - The environment variable key to check.
+ * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string
+ * value like `'0'` or `'false'` is considered a valid (defined) value.
+ *
+ * @param {string} key - The environment variable key to retrieve.
  *
  * @returns {string} The value of the environment variable.
  *
@@ -25,17 +28,11 @@ export declare class EnvironmentNotFoundError extends Error {
  *
  * @example
  * ```typescript
- * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
- *
- * // When the environment variable 'API_KEY' is set:
- * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ * process.env.API_KEY = '';
+ * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
  *
- * // When the environment variable 'API_KEY' is not set:
- * try {
- *   const apiKey = checkAndGetEnvValue('API_KEY');
- * } catch (error) {
- *   console.error(error); // Missing environment variable: API_KEY
- * }
+ * delete process.env.API_KEY;
+ * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError
  * ```
  */
 export declare function checkAndGetEnvValue(key: string): string;

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;OAIG;gBACS,GAAG,EAAE,MAAM;CAM1B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;OAIG;gBACS,GAAG,EAAE,MAAM;CAM1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/env.mjs

@@ -20,9 +20,12 @@ class EnvironmentNotFoundError extends Error {
     }
 }
 /**
- * Retrieves the value of an environment variable, or throws an error if not set.
+ * Retrieves the value of an environment variable, or throws an error if it is not defined.
  *
- * @param {string} key - The environment variable key to check.
+ * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string
+ * value like `'0'` or `'false'` is considered a valid (defined) value.
+ *
+ * @param {string} key - The environment variable key to retrieve.
  *
  * @returns {string} The value of the environment variable.
  *
@@ -30,21 +33,15 @@ class EnvironmentNotFoundError extends Error {
  *
  * @example
  * ```typescript
- * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
- *
- * // When the environment variable 'API_KEY' is set:
- * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ * process.env.API_KEY = '';
+ * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
  *
- * // When the environment variable 'API_KEY' is not set:
- * try {
- *   const apiKey = checkAndGetEnvValue('API_KEY');
- * } catch (error) {
- *   console.error(error); // Missing environment variable: API_KEY
- * }
+ * delete process.env.API_KEY;
+ * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError
  * ```
  */
 function checkAndGetEnvValue(key) {
-    if (!process.env[key])
+    if (process.env[key] === undefined)
         throw new EnvironmentNotFoundError(key);
     return process.env[key];
 }

package/dist/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if not set.\n *\n * @param {string} key - The environment variable key to check.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * import { checkAndGetEnvValue } from '@kikiutils/shared/env';\n *\n * // When the environment variable 'API_KEY' is set:\n * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY\n *\n * // When the environment variable 'API_KEY' is not set:\n * try {\n *   const apiKey = checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n *   console.error(error); // Missing environment variable: API_KEY\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (!process.env[key]) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC9D,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;"}
+{"version":3,"file":"env.mjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if it is not defined.\n *\n * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n *\n * @param {string} key - The environment variable key to retrieve.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered \"defined\")\n *\n * delete process.env.API_KEY;\n * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC3E,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;"}

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

@@ -0,0 +1,103 @@
+'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
+ * 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

@@ -0,0 +1 @@
+{"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 * 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,GAG5B,EAAA,CAAA,CAAA;AAED,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,CAAG,EAAA,IAAI,CAAG,EAAA,OAAO,EAAE;AAElH;;;;;;;;;;;AAWG;AACU,MAAA,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;KAC7D;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;KACpC;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;;AACzC,YAAA,MAAM;AACJ,gBAAA,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC;;AAE/E,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE,OAAO,OAAO;AACpD,QAAA;AACI,YAAA,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,CAAA,CAAA,CAAG,CAAC;;AAErF;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.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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
+ * enhancedLocalStorage.setItem('user', { name: 'user', createdAt: new Date() });
+ * const user = enhancedLocalStorage.getItem<{ name: string, createdAt: Date }>('user');
+ * ```
+ */
+export declare const enhancedLocalStorage: Readonly<{
+    /**
+     * Removes all items from localStorage.
+     */
+    clear: () => void;
+    /**
+     * 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<T = unknown>(key: string): T | 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: string) => boolean;
+    /**
+     * Returns the number of items stored in localStorage.
+     *
+     * @returns {number} The number of items stored in localStorage.
+     */
+    readonly length: number;
+    /**
+     * Removes a specific key from localStorage.
+     *
+     * @param {string} key - The key to remove.
+     */
+    removeItem: (key: string) => void;
+    /**
+     * 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: string, value: any) => void;
+}>;
+//# sourceMappingURL=core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../../src/storage/enhanced/local/core.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB;IAC7B;;OAEG;;IAEH;;;;;;;;OAQG;YACK,CAAC,iBAAiB,MAAM;IAIhC;;;;;;OAMG;mBACY,MAAM;IACrB;;;;OAIG;;IAIH;;;;OAIG;sBACe,MAAM;IACxB;;;;;OAKG;mBACY,MAAM,SAAS,GAAG;EACnC,CAAC"}

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

@@ -0,0 +1,101 @@
+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
+ * 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

@@ -0,0 +1 @@
+{"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 * 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,GAG5B,EAAA,CAAA,CAAA;AAED,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,CAAG,EAAA,IAAI,CAAG,EAAA,OAAO,EAAE;AAElH;;;;;;;;;;;AAWG;AACU,MAAA,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;KAC7D;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;KACpC;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;;AACzC,YAAA,MAAM;AACJ,gBAAA,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC;;AAE/E,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE,OAAO,OAAO;AACpD,QAAA;AACI,YAAA,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,CAAA,CAAA,CAAG,CAAC;;AAErF;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

@@ -0,0 +1,10 @@
+'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

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

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

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

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

@@ -0,0 +1 @@
+{"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

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

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

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

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

@@ -0,0 +1,39 @@
+'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
+ * 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

@@ -0,0 +1 @@
+{"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 * 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;;;;;;;;;;;;;;;;;AAiBG;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.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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
+ * const userStore = createKeyedEnhancedLocalStore<User>()((id: number) => `user:${id}`);
+ * userStore.setItem({ id: 123, name: 'user' }, 123);
+ * const user = userStore.getItem(123);
+ * ```
+ */
+export declare function createKeyedEnhancedLocalStore<D = unknown>(): <P extends any[]>(getKeyFunction: (...args: P) => string) => Readonly<{
+    getItem: (...args: P) => D | null;
+    hasItem: (...args: P) => boolean;
+    removeItem: (...args: P) => void;
+    /**
+     * Resolves the storage key from the given arguments.
+     *
+     * @returns {string} The final string key used internally.
+     */
+    resolveKey: (...args: P) => string;
+    setItem: (value: D, ...args: P) => void;
+}>;
+//# sourceMappingURL=keyed-store.d.ts.map