@resolid/cache 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022-present, Resolid Tech
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+# Resolid: Cache Package
+
+![GitHub License](https://img.shields.io/github/license/resolid/framework)
+![NPM Version](https://img.shields.io/npm/v/%40resolid/cache)
+
+<b>[Documentation](https://www.resolid.tech/docs/cache)</b> | [Framework Bundle](https://github.com/resolid/framework)
+
+## License
+
+MIT License (MIT). Please see [LICENSE](./LICENSE) for more information.

package/dist/index-DvzAtk0z.d.ts

@@ -0,0 +1,14 @@
+//#region src/types/index.d.ts
+type CacheStore = {
+  get: (key: string) => Promise<string | undefined>;
+  set: (key: string, value: string, ttl?: number) => Promise<boolean>;
+  del: (key: string) => Promise<boolean>;
+  clear: () => Promise<boolean>;
+  getMultiple?: (keys: string[]) => Promise<(string | undefined)[]>;
+  setMultiple?: (values: Record<string, string>, ttl?: number) => Promise<boolean>;
+  delMultiple?: (keys: string[]) => Promise<boolean>;
+  has?: (key: string) => Promise<boolean>;
+  dispose?: () => Promise<void> | void;
+};
+//#endregion
+export { CacheStore as t };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { t as CacheStore } from "./index-DvzAtk0z.js";
+
+//#region src/index.d.ts
+type CreateCacheOptions = {
+  store?: CacheStore;
+  defaultTtl?: number;
+};
+type CacheInstance = {
+  get: <T>(key: string, defaultValue?: T) => Promise<T | undefined>;
+  set: <T>(key: string, value: T, ttl?: number) => Promise<boolean>;
+  del: (key: string) => Promise<boolean>;
+  clear: () => Promise<boolean>;
+  getMultiple: <T>(keys: string[], defaultValue?: T) => Promise<(T | undefined)[]>;
+  setMultiple: <T>(values: Record<string, T>, ttl?: number) => Promise<boolean>;
+  delMultiple: (keys: string[]) => Promise<boolean>;
+  has: (key: string) => Promise<boolean>;
+  dispose: () => Promise<void> | void;
+};
+declare const createCache: (options?: CreateCacheOptions) => CacheInstance;
+//#endregion
+export { CacheInstance, CreateCacheOptions, createCache };

package/dist/index.js

@@ -0,0 +1 @@
+import{t as e}from"./null-cache-2iHFUXTp.js";import{t}from"./utils-CV58ddJF.js";import{destr as n}from"destr";const r=(r={})=>{let{defaultTtl:i,store:a=e}=r,o=async(e,r)=>{let i=await a.get(t(e));return i===void 0?r:n(i)},s=(e,n,r)=>a.set(t(e),JSON.stringify(n),r??i),c=e=>a.del(t(e));return{get:o,set:s,del:c,clear:()=>a.clear(),getMultiple:(e,r)=>typeof a.getMultiple==`function`?a.getMultiple(e.map(e=>t(e))).then(e=>e.map(e=>e===void 0?r:n(e))):Promise.all(e.map(e=>o(e,r))),setMultiple:(e,n)=>typeof a.setMultiple==`function`?a.setMultiple(Object.entries(e).reduce((e,[n,r])=>(e[t(n)]=JSON.stringify(r),e),{}),n):Promise.all(Object.entries(e).map(([e,t])=>s(e,t,n))).then(e=>e.every(Boolean)),delMultiple:e=>typeof a.delMultiple==`function`?a.delMultiple(e.map(e=>t(e))):Promise.all(e.map(c)).then(e=>e.every(Boolean)),has:async e=>typeof a.has==`function`?a.has(t(e)):o(e).then(e=>e!==void 0),dispose:async()=>{a.dispose&&await a.dispose()}}};export{r as createCache};

package/dist/null-cache-2iHFUXTp.js

@@ -0,0 +1 @@
+const e={get:async()=>{},set:async()=>!0,del:async()=>!0,clear:async()=>!0,getMultiple:async e=>e.map(()=>void 0),setMultiple:async()=>!0,delMultiple:async()=>!0,has:async()=>!1,dispose:async()=>{}};export{e as t};

package/dist/stores.d.ts

@@ -0,0 +1,9 @@
+import { t as CacheStore } from "./index-DvzAtk0z.js";
+
+//#region src/stores/memory-cache.d.ts
+declare const createMemoryCache: (maxSize?: number) => CacheStore;
+//#endregion
+//#region src/stores/null-cache.d.ts
+declare const nullCache: Required<CacheStore>;
+//#endregion
+export { createMemoryCache, nullCache };

package/dist/stores.js

@@ -0,0 +1 @@
+import{t as e}from"./null-cache-2iHFUXTp.js";import t from"quick-lru";const n=(e=1e3)=>{let n=new t({maxSize:e});return{get:async e=>n.get(e),set:async(e,t,r)=>(n.set(e,t,r?{maxAge:r*1e3}:void 0),!0),del:async e=>n.delete(e),clear:async()=>(n.clear(),!0),dispose:async()=>{n.clear()}}};export{n as createMemoryCache,e as nullCache};

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+import { t as CacheStore } from "./index-DvzAtk0z.js";
+export { CacheStore };

package/dist/types.js

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

package/dist/utils-CV58ddJF.js

@@ -0,0 +1 @@
+const e=e=>{let t=e.split(`?`)[0].replace(/[/\\]/g,`:`).replace(/:+/g,`:`).replace(/^:|:$/g,``);if(!t)throw Error(`Cache key cannot be empty after normalization`);return t};export{e as t};

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+//#region src/utils/index.d.ts
+declare const normalizeKey: (key: string) => string;
+//#endregion
+export { normalizeKey };

package/dist/utils.js

@@ -0,0 +1 @@
+import{t as e}from"./utils-CV58ddJF.js";export{e as normalizeKey};

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@resolid/cache",
+  "version": "0.1.0",
+  "private": false,
+  "description": "The Resolid Cache package.",
+  "keywords": [
+    "resolid",
+    "cache",
+    "cache manager"
+  ],
+  "homepage": "https://www.resolid.tech",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/resolid/framework.git",
+    "directory": "packages/cache"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Huijie Wei",
+    "email": "hello@resolid.tech"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./stores": {
+      "types": "./dist/stores.d.ts",
+      "import": "./dist/stores.js"
+    },
+    "./utils": {
+      "types": "./dist/utils.d.ts",
+      "import": "./dist/utils.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "destr": "^2.0.5",
+    "quick-lru": "^7.3.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "beta",
+    "tsdown": "^0.15.9",
+    "typescript": "^5.9.3",
+    "vitest": "beta"
+  },
+  "engines": {
+    "node": "^20.19.0 || ^22.13.0 || >=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}