@kikiutils/shared 13.6.1 → 14.0.0

package/dist/storages/lru/keyed-store.d.ts

@@ -0,0 +1,22 @@
+import { LRUCache } from "lru-cache";
+
+//#region src/storages/lru/keyed-store.d.ts
+declare function createLruKeyedStore<D = unknown>(lruInstance: LRUCache<any, any, any>): <P extends any[]>(keyFn: (...args: P) => string) => Readonly<{
+  /**
+   * Return a value from the cache. Will update the recency of the cache entry found.
+   *
+   * If the key is not found, returns `null`.
+   */
+  getItem(...args: P): NonNullable<D> | null;
+  getItemTtl: (...args: P) => number;
+  hasItem: (...args: P) => boolean;
+  removeItem: (...args: P) => boolean;
+  /**
+   * Resolves the full cache key from the given arguments.
+   */
+  resolveKey: (...args: P) => string;
+  setItem: (value: D, ...args: P) => LRUCache<any, any, any>;
+}>;
+//#endregion
+export { createLruKeyedStore };
+//# sourceMappingURL=keyed-store.d.ts.map

package/dist/storages/lru/keyed-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-store.d.ts","names":[],"sources":["../../../src/storages/lru/keyed-store.ts"],"sourcesContent":[],"mappings":";;;iBAEgB,8CAA8C,6DAChB,iBAAY;;AAD1D;;;;EAO0B,OAAA,CAAA,GAAA,IAAA,EAAD,CAAC,CAAA,EAAA,WAAA,CAAA,CAAA,CAAA,GAAA,IAAA;EAAA,UAAA,EAAA,CAAA,GAAA,IAAA,EAII,CAJJ,EAAA,GAAA,MAAA;EAII,OAAA,EAAA,CAAA,GAAA,IAAA,EACH,CADG,EAAA,GAAA,OAAA;EACH,UAAA,EAAA,CAAA,GAAA,IAAA,EACG,CADH,EAAA,GAAA,OAAA;EACG;;;EAKO,UAAA,EAAA,CAAA,GAAA,IAAA,EADP,CACO,EAAA,GAAA,MAAA;EAAC,OAAA,EAAA,CAAA,KAAA,EAAb,CAAa,EAAA,GAAA,IAAA,EAAD,CAAC,EAAA,GAAA,QAAA,CAAA,GAAA,EAAA,GAAA,EAAA,GAAA,CAAA;CAjBoB,CAAA"}

package/dist/storages/lru/keyed-store.js

@@ -0,0 +1,17 @@
+//#region src/storages/lru/keyed-store.ts
+function createLruKeyedStore(lruInstance) {
+	return (keyFn) => Object.freeze({
+		getItem(...args) {
+			return lruInstance.get(keyFn(...args)) ?? null;
+		},
+		getItemTtl: (...args) => lruInstance.getRemainingTTL(keyFn(...args)),
+		hasItem: (...args) => lruInstance.has(keyFn(...args)),
+		removeItem: (...args) => lruInstance.delete(keyFn(...args)),
+		resolveKey: (...args) => keyFn(...args),
+		setItem: (value, ...args) => lruInstance.set(keyFn(...args), value)
+	});
+}
+
+//#endregion
+export { createLruKeyedStore };
+//# sourceMappingURL=keyed-store.js.map

package/dist/storages/lru/keyed-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-store.js","names":[],"sources":["../../../src/storages/lru/keyed-store.ts"],"sourcesContent":["import type { LRUCache } from 'lru-cache';\n\nexport function createLruKeyedStore<D = unknown>(lruInstance: LRUCache<any, any, any>) {\n    return <P extends any[]>(keyFn: (...args: P) => string) => Object.freeze({\n        /**\n         * Return a value from the cache. Will update the recency of the cache entry found.\n         *\n         * If the key is not found, returns `null`.\n         */\n        getItem(...args: P) {\n            const rawValue = lruInstance.get(keyFn(...args));\n            return rawValue as D ?? null;\n        },\n        getItemTtl: (...args: P) => lruInstance.getRemainingTTL(keyFn(...args)),\n        hasItem: (...args: P) => lruInstance.has(keyFn(...args)),\n        removeItem: (...args: P) => lruInstance.delete(keyFn(...args)),\n        /**\n         * Resolves the full cache key from the given arguments.\n         */\n        resolveKey: (...args: P) => keyFn(...args),\n        setItem: (value: D, ...args: P) => lruInstance.set(keyFn(...args), value),\n    });\n}\n"],"mappings":";AAEA,SAAgB,oBAAiC,aAAsC;AACnF,SAAyB,UAAkC,OAAO,OAAO;EAMrE,QAAQ,GAAG,MAAS;AAEhB,UADiB,YAAY,IAAI,MAAM,GAAG,KAAK,CAAC,IACxB;;EAE5B,aAAa,GAAG,SAAY,YAAY,gBAAgB,MAAM,GAAG,KAAK,CAAC;EACvE,UAAU,GAAG,SAAY,YAAY,IAAI,MAAM,GAAG,KAAK,CAAC;EACxD,aAAa,GAAG,SAAY,YAAY,OAAO,MAAM,GAAG,KAAK,CAAC;EAI9D,aAAa,GAAG,SAAY,MAAM,GAAG,KAAK;EAC1C,UAAU,OAAU,GAAG,SAAY,YAAY,IAAI,MAAM,GAAG,KAAK,EAAE,MAAM;EAC5E,CAAC"}

package/dist/storages/redis/keyed-store.d.ts

@@ -0,0 +1,16 @@
+import { MaybeReadonly, Nullable } from "../../types/index.js";
+import { RedisLikeStorage } from "./types.js";
+
+//#region src/storages/redis/keyed-store.d.ts
+declare function createRedisKeyedStore<D = unknown>(storage: MaybeReadonly<RedisLikeStorage>): <P extends any[]>(keyFn: (...args: P) => string) => Readonly<{
+  getItem: (...args: P) => Promise<Nullable<D>>;
+  getItemTtl: (...args: P) => Promise<number>;
+  hasItem: (...args: P) => Promise<boolean>;
+  removeItem: (...args: P) => Promise<boolean>;
+  resolveKey: (...args: P) => string;
+  setItem: (value: D, ...args: P) => Promise<boolean>;
+  setItemWithTtl(ttlSeconds: number, value: D, ...args: P): Promise<boolean>;
+}>;
+//#endregion
+export { createRedisKeyedStore };
+//# sourceMappingURL=keyed-store.d.ts.map

package/dist/storages/redis/keyed-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-store.d.ts","names":[],"sources":["../../../src/storages/redis/keyed-store.ts"],"sourcesContent":[],"mappings":";;;;iBAIgB,4CAA4C,cAAc,uDAC5B,iBAAY;qBAC/B,MAAC,QAAA,SAAA;EAFZ,UAAA,EAAA,CAAA,GAAA,IAAA,EAGc,CAHd,EAAqB,GAGN,OAHM,CAAA,MAAA,CAAA;EAAqC,OAAA,EAAA,CAAA,GAAA,IAAA,EAI/C,CAJ+C,EAAA,GAI9C,OAJ8C,CAAA,OAAA,CAAA;EAAd,UAAA,EAAA,CAAA,GAAA,IAAA,EAK9B,CAL8B,EAAA,GAK7B,OAL6B,CAAA,OAAA,CAAA;EACd,UAAA,EAAA,CAAA,GAAA,IAAA,EAKhB,CALgB,EAAA,GAAA,MAAA;EACnB,OAAA,EAAA,CAAA,KAAA,EAKF,CALE,EAAA,GAAA,IAAA,EAKU,CALV,EAAA,GAKW,OALX,CAAA,OAAA,CAAA;EAAC,cAAA,CAAA,UAAA,EAAA,MAAA,EAAA,KAAA,EAMsB,CANtB,EAAA,GAAA,IAAA,EAMkC,CANlC,CAAA,EAMmC,OANnC,CAAA,OAAA,CAAA;CAAA,CAAA"}

package/dist/storages/redis/keyed-store.js

@@ -0,0 +1,18 @@
+//#region src/storages/redis/keyed-store.ts
+function createRedisKeyedStore(storage) {
+	return (keyFn) => Object.freeze({
+		getItem: (...args) => storage.getItem(keyFn(...args)),
+		getItemTtl: (...args) => storage.getItemTtl(keyFn(...args)),
+		hasItem: (...args) => storage.hasItem(keyFn(...args)),
+		removeItem: (...args) => storage.removeItem(keyFn(...args)),
+		resolveKey: (...args) => keyFn(...args),
+		setItem: (value, ...args) => storage.setItem(keyFn(...args), value),
+		setItemWithTtl(ttlSeconds, value, ...args) {
+			return storage.setItemWithTtl(keyFn(...args), ttlSeconds, value);
+		}
+	});
+}
+
+//#endregion
+export { createRedisKeyedStore };
+//# sourceMappingURL=keyed-store.js.map

package/dist/storages/redis/keyed-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyed-store.js","names":[],"sources":["../../../src/storages/redis/keyed-store.ts"],"sourcesContent":["import type { MaybeReadonly } from '../../types';\n\nimport type { RedisLikeStorage } from './types';\n\nexport function createRedisKeyedStore<D = unknown>(storage: MaybeReadonly<RedisLikeStorage>) {\n    return <P extends any[]>(keyFn: (...args: P) => string) => Object.freeze({\n        getItem: (...args: P) => storage.getItem<D>(keyFn(...args)),\n        getItemTtl: (...args: P) => storage.getItemTtl(keyFn(...args)),\n        hasItem: (...args: P) => storage.hasItem(keyFn(...args)),\n        removeItem: (...args: P) => storage.removeItem(keyFn(...args)),\n        resolveKey: (...args: P) => keyFn(...args),\n        setItem: (value: D, ...args: P) => storage.setItem(keyFn(...args), value),\n        setItemWithTtl(ttlSeconds: number, value: D, ...args: P) {\n            return storage.setItemWithTtl(keyFn(...args), ttlSeconds, value);\n        },\n    });\n}\n"],"mappings":";AAIA,SAAgB,sBAAmC,SAA0C;AACzF,SAAyB,UAAkC,OAAO,OAAO;EACrE,UAAU,GAAG,SAAY,QAAQ,QAAW,MAAM,GAAG,KAAK,CAAC;EAC3D,aAAa,GAAG,SAAY,QAAQ,WAAW,MAAM,GAAG,KAAK,CAAC;EAC9D,UAAU,GAAG,SAAY,QAAQ,QAAQ,MAAM,GAAG,KAAK,CAAC;EACxD,aAAa,GAAG,SAAY,QAAQ,WAAW,MAAM,GAAG,KAAK,CAAC;EAC9D,aAAa,GAAG,SAAY,MAAM,GAAG,KAAK;EAC1C,UAAU,OAAU,GAAG,SAAY,QAAQ,QAAQ,MAAM,GAAG,KAAK,EAAE,MAAM;EACzE,eAAe,YAAoB,OAAU,GAAG,MAAS;AACrD,UAAO,QAAQ,eAAe,MAAM,GAAG,KAAK,EAAE,YAAY,MAAM;;EAEvE,CAAC"}

package/dist/storages/redis/msgpack.d.ts

@@ -0,0 +1,7 @@
+import { RedisLikeAdapter, RedisLikeStorage } from "./types.js";
+
+//#region src/storages/redis/msgpack.d.ts
+declare function createRedisMsgpackStorage(adapter: RedisLikeAdapter): Readonly<RedisLikeStorage>;
+//#endregion
+export { createRedisMsgpackStorage };
+//# sourceMappingURL=msgpack.d.ts.map

package/dist/storages/redis/msgpack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack.d.ts","names":[],"sources":["../../../src/storages/redis/msgpack.ts"],"sourcesContent":[],"mappings":";;;iBAegB,yBAAA,UAAmC,mBAAmB,SAAS"}

package/dist/storages/redis/msgpack.js

@@ -0,0 +1,23 @@
+import { decode, encode, isNativeAccelerationEnabled } from "msgpackr";
+
+//#region src/storages/redis/msgpack.ts
+if (!isNativeAccelerationEnabled) console.warn("Native acceleration not enabled for msgpackr, verify that install finished properly");
+function createRedisMsgpackStorage(adapter) {
+	return Object.freeze({
+		async getItem(key) {
+			const rawValue = await adapter.getBuffer(key);
+			return rawValue ? decode(rawValue) : null;
+		},
+		getItemTtl: (key) => adapter.ttl(key),
+		hasItem: (key) => adapter.has(key),
+		removeItem: async (key) => await adapter.delete(key) === 1,
+		setItem: async (key, value) => await adapter.setBuffer(key, encode(value)) === "OK",
+		async setItemWithTtl(key, ttlSeconds, value) {
+			return await adapter.setBufferEx(key, ttlSeconds, encode(value)) === "OK";
+		}
+	});
+}
+
+//#endregion
+export { createRedisMsgpackStorage };
+//# sourceMappingURL=msgpack.js.map

package/dist/storages/redis/msgpack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgpack.js","names":[],"sources":["../../../src/storages/redis/msgpack.ts"],"sourcesContent":["import {\n    decode,\n    encode,\n    isNativeAccelerationEnabled,\n} from 'msgpackr';\n\nimport type {\n    RedisLikeAdapter,\n    RedisLikeStorage,\n} from './types';\n\nif (!isNativeAccelerationEnabled) {\n    console.warn('Native acceleration not enabled for msgpackr, verify that install finished properly');\n}\n\nexport function createRedisMsgpackStorage(adapter: RedisLikeAdapter): Readonly<RedisLikeStorage> {\n    return Object.freeze({\n        async getItem<T = unknown>(key: string) {\n            const rawValue = await adapter.getBuffer(key);\n            return rawValue ? decode(rawValue) as T : null;\n        },\n        getItemTtl: (key: string) => adapter.ttl(key),\n        hasItem: (key: string) => adapter.has(key),\n        removeItem: async (key: string) => await adapter.delete(key) === 1,\n        setItem: async (key: string, value: any) => await adapter.setBuffer(key, encode(value)) === 'OK',\n        async setItemWithTtl(key: string, ttlSeconds: number, value: any) {\n            return await adapter.setBufferEx(key, ttlSeconds, encode(value)) === 'OK';\n        },\n    });\n}\n"],"mappings":";;;AAWA,IAAI,CAAC,4BACD,SAAQ,KAAK,sFAAsF;AAGvG,SAAgB,0BAA0B,SAAuD;AAC7F,QAAO,OAAO,OAAO;EACjB,MAAM,QAAqB,KAAa;GACpC,MAAM,WAAW,MAAM,QAAQ,UAAU,IAAI;AAC7C,UAAO,WAAW,OAAO,SAAS,GAAQ;;EAE9C,aAAa,QAAgB,QAAQ,IAAI,IAAI;EAC7C,UAAU,QAAgB,QAAQ,IAAI,IAAI;EAC1C,YAAY,OAAO,QAAgB,MAAM,QAAQ,OAAO,IAAI,KAAK;EACjE,SAAS,OAAO,KAAa,UAAe,MAAM,QAAQ,UAAU,KAAK,OAAO,MAAM,CAAC,KAAK;EAC5F,MAAM,eAAe,KAAa,YAAoB,OAAY;AAC9D,UAAO,MAAM,QAAQ,YAAY,KAAK,YAAY,OAAO,MAAM,CAAC,KAAK;;EAE5E,CAAC"}

package/dist/storages/redis/types.d.ts

@@ -0,0 +1,22 @@
+import { Nullable } from "../../types/index.js";
+
+//#region src/storages/redis/types.d.ts
+interface RedisLikeAdapter {
+  delete: (key: string) => Promise<number>;
+  getBuffer: (key: string) => Promise<Nullable<Uint8Array>>;
+  has: (key: string) => Promise<boolean>;
+  setBuffer: (key: string, value: Uint8Array) => Promise<'OK' | void>;
+  setBufferEx: (key: string, ttlSeconds: number, value: Uint8Array) => Promise<'OK' | void>;
+  ttl: (key: string) => Promise<number>;
+}
+interface RedisLikeStorage {
+  getItem: <T = unknown>(key: string) => Promise<Nullable<T>>;
+  getItemTtl: (key: string) => Promise<number>;
+  hasItem: (key: string) => Promise<boolean>;
+  removeItem: (key: string) => Promise<boolean>;
+  setItem: (key: string, value: any) => Promise<boolean>;
+  setItemWithTtl: (key: string, ttlSeconds: number, value: any) => Promise<boolean>;
+}
+//#endregion
+export { RedisLikeAdapter, RedisLikeStorage };
+//# sourceMappingURL=types.d.ts.map

package/dist/storages/redis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/storages/redis/types.ts"],"sourcesContent":[],"mappings":";;;UAEiB,gBAAA;2BACY;EADZ,SAAA,EAAA,CAAA,GAAA,EAAA,MAAgB,EAAA,GAED,OAFC,CAEO,QAFP,CAEgB,UAFhB,CAAA,CAAA;EACJ,GAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAEH,OAFG,CAAA,OAAA,CAAA;EACoB,SAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAEb,UAFa,EAAA,GAEE,OAFF,CAAA,IAAA,GAAA,IAAA,CAAA;EAAT,WAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,UAAA,EAAA,MAAA,EAAA,KAAA,EAGkB,UAHlB,EAAA,GAGiC,OAHjC,CAAA,IAAA,GAAA,IAAA,CAAA;EAAR,GAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAIN,OAJM,CAAA,MAAA,CAAA;;AAEI,UAKnB,gBAAA,CALmB;EAAe,OAAA,EAAA,CAAA,IAAA,OAAA,CAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAMR,OANQ,CAMA,QANA,CAMS,CANT,CAAA,CAAA;EACO,UAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAMzB,OANyB,CAAA,MAAA,CAAA;EAAe,OAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAO3C,OAP2C,CAAA,OAAA,CAAA;EAC/C,UAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAOO,OAPP,CAAA,OAAA,CAAA;EAAO,OAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,KAAA,EAAA,GAAA,EAAA,GAQS,OART,CAAA,OAAA,CAAA;EAGhB,cAAA,EAAA,CAAA,GAAgB,EAAA,MAAA,EAAA,UAAA,EAAA,MAAA,EAAA,KAAA,EAAA,GAAA,EAAA,GAMoC,OANpC,CAAA,OAAA,CAAA"}

package/dist/storages/redis/types.js

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kikiutils/shared",
   "type": "module",
-  "version": "13.6.1",
+  "version": "14.0.0",
   "description": "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.",
   "author": "kiki-kanri",
   "license": "MIT",
@@ -35,26 +35,6 @@
   "exports": {
     "./*": "./dist/*.js",
     "./package.json": "./package.json",
-    "./storage/enhanced/local": {
-      "types": "./dist/storage/enhanced/local/index.d.ts",
-      "import": "./dist/storage/enhanced/local/index.js",
-      "require": null
-    },
-    "./storage/enhanced/local/index": {
-      "types": null,
-      "import": null,
-      "require": null
-    },
-    "./storage/enhanced/redis": {
-      "types": "./dist/storage/enhanced/redis/index.d.ts",
-      "import": "./dist/storage/enhanced/redis/index.js",
-      "require": null
-    },
-    "./storage/enhanced/redis/index": {
-      "types": null,
-      "import": null,
-      "require": null
-    },
     "./types": {
       "types": "./dist/types/index.d.ts",
       "import": null,
@@ -99,9 +79,9 @@
     "decimal.js": "^10.6.0",
     "element-plus": "^2.11.3",
     "fs-extra": "^11.3.2",
-    "ioredis": "^5.7.0",
-    "lru-cache": "^11.2.1",
+    "lru-cache": "^11.2.4",
     "millify": "^6.1.0",
+    "msgpackr": "^1.11.5",
     "node-ssh": "^13.2.1",
     "pino": "^10.0.0",
     "pino-pretty": "^13.1.1",
@@ -146,15 +126,15 @@
     "fs-extra": {
       "optional": true
     },
-    "ioredis": {
-      "optional": true
-    },
     "lru-cache": {
       "optional": true
     },
     "millify": {
       "optional": true
     },
+    "msgpackr": {
+      "optional": true
+    },
     "node-ssh": {
       "optional": true
     },
@@ -194,15 +174,14 @@
     "depcheck": "^1.4.7",
     "element-plus": "^2.11.9",
     "fs-extra": "^11.3.2",
-    "ioredis": "^5.8.2",
     "jsdom": "^27.2.0",
     "lru-cache": "^11.2.4",
     "millify": "^6.1.0",
+    "msgpackr": "^1.11.5",
     "node-ssh": "^13.2.1",
     "pino": "^10.1.0",
     "pino-pretty": "^13.1.3",
     "publint": "^0.3.15",
-    "redis": "^5.10.0",
     "superjson": "^2.2.6",
     "ts-unused-exports": "^11.0.1",
     "tsdown": "^0.16.8",
@@ -216,6 +195,7 @@
     "onlyBuiltDependencies": [
       "cpu-features",
       "esbuild",
+      "msgpackr-extract",
       "ssh2",
       "vue-demi"
     ]

package/src/storages/lru/keyed-store.ts

@@ -0,0 +1,23 @@
+import type { LRUCache } from 'lru-cache';
+
+export function createLruKeyedStore<D = unknown>(lruInstance: LRUCache<any, any, any>) {
+    return <P extends any[]>(keyFn: (...args: P) => string) => Object.freeze({
+        /**
+         * Return a value from the cache. Will update the recency of the cache entry found.
+         *
+         * If the key is not found, returns `null`.
+         */
+        getItem(...args: P) {
+            const rawValue = lruInstance.get(keyFn(...args));
+            return rawValue as D ?? null;
+        },
+        getItemTtl: (...args: P) => lruInstance.getRemainingTTL(keyFn(...args)),
+        hasItem: (...args: P) => lruInstance.has(keyFn(...args)),
+        removeItem: (...args: P) => lruInstance.delete(keyFn(...args)),
+        /**
+         * Resolves the full cache key from the given arguments.
+         */
+        resolveKey: (...args: P) => keyFn(...args),
+        setItem: (value: D, ...args: P) => lruInstance.set(keyFn(...args), value),
+    });
+}

package/src/storages/redis/keyed-store.ts

@@ -0,0 +1,17 @@
+import type { MaybeReadonly } from '../../types';
+
+import type { RedisLikeStorage } from './types';
+
+export function createRedisKeyedStore<D = unknown>(storage: MaybeReadonly<RedisLikeStorage>) {
+    return <P extends any[]>(keyFn: (...args: P) => string) => Object.freeze({
+        getItem: (...args: P) => storage.getItem<D>(keyFn(...args)),
+        getItemTtl: (...args: P) => storage.getItemTtl(keyFn(...args)),
+        hasItem: (...args: P) => storage.hasItem(keyFn(...args)),
+        removeItem: (...args: P) => storage.removeItem(keyFn(...args)),
+        resolveKey: (...args: P) => keyFn(...args),
+        setItem: (value: D, ...args: P) => storage.setItem(keyFn(...args), value),
+        setItemWithTtl(ttlSeconds: number, value: D, ...args: P) {
+            return storage.setItemWithTtl(keyFn(...args), ttlSeconds, value);
+        },
+    });
+}

package/src/storages/redis/msgpack.ts

@@ -0,0 +1,30 @@
+import {
+    decode,
+    encode,
+    isNativeAccelerationEnabled,
+} from 'msgpackr';
+
+import type {
+    RedisLikeAdapter,
+    RedisLikeStorage,
+} from './types';
+
+if (!isNativeAccelerationEnabled) {
+    console.warn('Native acceleration not enabled for msgpackr, verify that install finished properly');
+}
+
+export function createRedisMsgpackStorage(adapter: RedisLikeAdapter): Readonly<RedisLikeStorage> {
+    return Object.freeze({
+        async getItem<T = unknown>(key: string) {
+            const rawValue = await adapter.getBuffer(key);
+            return rawValue ? decode(rawValue) as T : null;
+        },
+        getItemTtl: (key: string) => adapter.ttl(key),
+        hasItem: (key: string) => adapter.has(key),
+        removeItem: async (key: string) => await adapter.delete(key) === 1,
+        setItem: async (key: string, value: any) => await adapter.setBuffer(key, encode(value)) === 'OK',
+        async setItemWithTtl(key: string, ttlSeconds: number, value: any) {
+            return await adapter.setBufferEx(key, ttlSeconds, encode(value)) === 'OK';
+        },
+    });
+}

package/src/storages/redis/types.ts

@@ -0,0 +1,19 @@
+import type { Nullable } from '../../types';
+
+export interface RedisLikeAdapter {
+    delete: (key: string) => Promise<number>;
+    getBuffer: (key: string) => Promise<Nullable<Uint8Array>>;
+    has: (key: string) => Promise<boolean>;
+    setBuffer: (key: string, value: Uint8Array) => Promise<'OK' | void>;
+    setBufferEx: (key: string, ttlSeconds: number, value: Uint8Array) => Promise<'OK' | void>;
+    ttl: (key: string) => Promise<number>;
+}
+
+export interface RedisLikeStorage {
+    getItem: <T = unknown>(key: string) => Promise<Nullable<T>>;
+    getItemTtl: (key: string) => Promise<number>;
+    hasItem: (key: string) => Promise<boolean>;
+    removeItem: (key: string) => Promise<boolean>;
+    setItem: (key: string, value: any) => Promise<boolean>;
+    setItemWithTtl: (key: string, ttlSeconds: number, value: any) => Promise<boolean>;
+}

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

@@ -1,61 +0,0 @@
-//#region src/storage/enhanced/local/core.d.ts
-/**
- * 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');
- * ```
- */
-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;
-}>;
-//#endregion
-export { enhancedLocalStorage };
-//# sourceMappingURL=core.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.ts","names":[],"sources":["../../../../src/storage/enhanced/local/core.ts"],"sourcesContent":[],"mappings":";;AA4BA;;;;;;;;;;;;;cAAa,sBAAoB;;;;;;;;;;;;;;qCAcG"}

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

@@ -1,63 +0,0 @@
-import { deserialize, serialize } from "superjson";
-
-//#region src/storage/enhanced/local/core.ts
-var StorageValueEncodingType = /* @__PURE__ */ function(StorageValueEncodingType$1) {
-	StorageValueEncodingType$1["Json"] = "0";
-	StorageValueEncodingType$1["String"] = "1";
-	return StorageValueEncodingType$1;
-}(StorageValueEncodingType || {});
-const customValueHeader = "​⁠";
-const customValueHeaderLength = 3;
-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({
-	clear: () => window.localStorage.clear(),
-	getItem(key) {
-		const rawValue = window.localStorage.getItem(key);
-		return rawValue ? decodeStorageValue(rawValue) : null;
-	},
-	hasItem: (key) => window.localStorage.getItem(key) !== null,
-	get length() {
-		return window.localStorage.length;
-	},
-	removeItem: (key) => window.localStorage.removeItem(key),
-	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(2);
-	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];
-}
-
-//#endregion
-export { enhancedLocalStorage };
-//# sourceMappingURL=core.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"core.js","names":[],"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"],"mappings":";;;AAKA,IAAK,gFAAL;AACI;AACA;;EAFC;AAKL,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAChC,MAAM,iBAAiB,MAAgC,YAAoB,GAAG,oBAAoB,OAAO;;;;;;;;;;;;;;;AAgBzG,MAAa,uBAAuB,OAAO,OAAO;CAI9C,aAAa,OAAO,aAAa,OAAO;CAUxC,QAAqB,KAAa;EAC9B,MAAM,WAAW,OAAO,aAAa,QAAQ,IAAI;AACjD,SAAO,WAAW,mBAAmB,SAAS,GAAQ;;CAS1D,UAAU,QAAgB,OAAO,aAAa,QAAQ,IAAI,KAAK;CAM/D,IAAI,SAAS;AACT,SAAO,OAAO,aAAa;;CAO/B,aAAa,QAAgB,OAAO,aAAa,WAAW,IAAI;CAOhE,UAAU,KAAa,UAAe,OAAO,aAAa,QAAQ,KAAK,qBAAqB,MAAM,CAAC;CACtG,CAAC;AAEF,SAAS,mBAAmB,MAAc;AACtC,KAAI,CAAC,eAAe,KAAK,CAAE,QAAO;CAClC,MAAM,UAAU,KAAK,UAAU,wBAAwB;CACvD,MAAM,OAAO,KAAK,OAAO,EAAyB;AAClD,SAAQ,MAAR;EACI,KAAK,yBAAyB,KAC1B,KAAI;AACA,UAAO,YAAY,KAAK,MAAM,QAAQ,CAAC;UACnC;AACJ,SAAM,IAAI,MAAM,sDAAsD;;EAE9E,KAAK,yBAAyB,OAAQ,QAAO;EAC7C,QACI,OAAM,IAAI,MAAM,iDAAiD,OAAO;;;AAIpF,SAAS,qBAAqB,OAAY;AACtC,KAAI,OAAO,UAAU,SAAU,QAAO,cAAc,yBAAyB,QAAQ,MAAM;AAC3F,QAAO,cAAc,yBAAyB,MAAM,KAAK,UAAU,UAAU,MAAM,CAAC,CAAC;;AAGzF,SAAS,eAAe,MAAc;AAClC,QACI,KAAK,UAAU,2BACZ,KAAK,OAAO,kBAAkB,MAC9B,KAAK,OAAO,kBAAkB"}

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

@@ -1,3 +0,0 @@
-import { enhancedLocalStorage } from "./core.js";
-import { createKeyedEnhancedLocalStore } from "./keyed-store.js";
-export { createKeyedEnhancedLocalStore, enhancedLocalStorage };

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

@@ -1,4 +0,0 @@
-import { enhancedLocalStorage } from "./core.js";
-import { createKeyedEnhancedLocalStore } from "./keyed-store.js";
-
-export { createKeyedEnhancedLocalStore, enhancedLocalStorage };

package/dist/storage/enhanced/local/keyed-store.d.ts

@@ -1,36 +0,0 @@
-//#region src/storage/enhanced/local/keyed-store.d.ts
-/**
- * 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);
- * ```
- */
-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;
-}>;
-//#endregion
-export { createKeyedEnhancedLocalStore };
-//# sourceMappingURL=keyed-store.d.ts.map

package/dist/storage/enhanced/local/keyed-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keyed-store.d.ts","names":[],"sources":["../../../../src/storage/enhanced/local/keyed-store.ts"],"sourcesContent":[],"mappings":";;AAsBA;;;;;;;;;;;;;;;;;;;iBAAgB,0FACuC,iBAAY;qBACxC,MAAC;qBACD;wBACG;;;;;;wBAMA;mBACL,YAAY"}

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

@@ -1,36 +0,0 @@
-import { enhancedLocalStorage } from "./core.js";
-
-//#region src/storage/enhanced/local/keyed-store.ts
-/**
-* 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)),
-		resolveKey: (...args) => getKeyFunction(...args),
-		setItem: (value, ...args) => enhancedLocalStorage.setItem(getKeyFunction(...args), value)
-	});
-}
-
-//#endregion
-export { createKeyedEnhancedLocalStore };
-//# sourceMappingURL=keyed-store.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"keyed-store.js","names":[],"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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,gCAA6C;AACzD,SAAyB,mBAA2C,OAAO,OAAO;EAC9E,UAAU,GAAG,SAAY,qBAAqB,QAAW,eAAe,GAAG,KAAK,CAAC;EACjF,UAAU,GAAG,SAAY,qBAAqB,QAAQ,eAAe,GAAG,KAAK,CAAC;EAC9E,aAAa,GAAG,SAAY,qBAAqB,WAAW,eAAe,GAAG,KAAK,CAAC;EAMpF,aAAa,GAAG,SAAY,eAAe,GAAG,KAAK;EACnD,UAAU,OAAU,GAAG,SAAY,qBAAqB,QAAQ,eAAe,GAAG,KAAK,EAAE,MAAM;EAClG,CAAC"}