@isdk/proxy 0.1.1

package/docs/interfaces/SiteCacheConfig.md

@@ -0,0 +1,61 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / SiteCacheConfig
+
+# Interface: SiteCacheConfig
+
+Defined in: [types.ts:16](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L16)
+
+站点级缓存配置
+
+## Properties
+
+### cookies?
+
+> `optional` **cookies**: [`KeyFilterConfig`](KeyFilterConfig.md)
+
+Defined in: [types.ts:22](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L22)
+
+Cookie 过滤配置
+
+***
+
+### forceCache?
+
+> `optional` **forceCache**: `boolean`
+
+Defined in: [types.ts:26](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L26)
+
+是否强制缓存一切响应（无视 no-store 等不缓存指令），用于极端的离线可用容错场景
+
+***
+
+### headers?
+
+> `optional` **headers**: [`KeyFilterConfig`](KeyFilterConfig.md)
+
+Defined in: [types.ts:20](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L20)
+
+请求头过滤配置
+
+***
+
+### query?
+
+> `optional` **query**: [`KeyFilterConfig`](KeyFilterConfig.md)
+
+Defined in: [types.ts:18](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L18)
+
+Query 参数过滤配置
+
+***
+
+### staleIfError?
+
+> `optional` **staleIfError**: `boolean`
+
+Defined in: [types.ts:24](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/types.ts#L24)
+
+当后端请求失败且存在旧缓存时，是否强制返回旧缓存（容错机制）

package/docs/interfaces/SmartCacheOptions.md

@@ -0,0 +1,41 @@
+[**@isdk/proxy**](../README.md)
+
+***
+
+[@isdk/proxy](../globals.md) / SmartCacheOptions
+
+# Interface: SmartCacheOptions
+
+Defined in: [core/SmartCache.ts:10](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/SmartCache.ts#L10)
+
+SmartCache 选项
+
+## Properties
+
+### maxMemorySize?
+
+> `optional` **maxMemorySize**: `number`
+
+Defined in: [core/SmartCache.ts:14](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/SmartCache.ts#L14)
+
+内存缓存阈值（字节）。响应体大小超过此值时，Body 将只存入磁盘，而 Meta 仍保留在内存。默认 1MB。
+
+***
+
+### memoryOptions?
+
+> `optional` **memoryOptions**: `Partial`\<`KeyvCacheableMemoryOptions`\>
+
+Defined in: [core/SmartCache.ts:16](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/SmartCache.ts#L16)
+
+透传给 L1 (Memory) 的高级配置
+
+***
+
+### storagePath?
+
+> `optional` **storagePath**: `string`
+
+Defined in: [core/SmartCache.ts:12](https://github.com/isdk/proxy.js/blob/bed37fa43507dcbe5cdfa453876163571399d761/src/core/SmartCache.ts#L12)
+
+磁盘缓存的物理路径。如果不提供，将默认使用系统临时目录。

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@isdk/proxy",
+  "version": "0.1.1",
+  "description": "A framework-agnostic, high-performance hybrid caching middleware with SWR, request collapsing, and stale-if-error support.",
+  "license": "MIT",
+  "author": "Riceball LEE <snowyu.lee@gmail.com>",
+  "homepage": "https://github.com/isdk/proxy.js",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/isdk/proxy.js.git"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "dependencies": {
+    "@cacheable/memory": "^2.0.8",
+    "@isdk/common-error": "^0.2.0",
+    "cacache": "^20.0.4",
+    "events-ex": "^2.3.1",
+    "http-cache-semantics": "^4.2.0",
+    "lodash-es": "^4.18.1",
+    "nanoid": "^5.1.11",
+    "util-ex": "^2.5.2"
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.7.3",
+    "@eslint/eslintrc": "^3.3.3",
+    "@eslint/js": "^9.39.2",
+    "@fastify/cookie": "^11.0.2",
+    "@fastify/formbody": "^8.0.2",
+    "@types/cacache": "^20.0.1",
+    "@types/http-cache-semantics": "^4.2.0",
+    "@types/jest": "^29.5.14",
+    "@types/jsdom": "^27.0.0",
+    "@types/lodash-es": "^4.17.12",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "~8.41.0",
+    "eslint": "^9.34.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-tsdoc": "^0.4.0",
+    "fastify": "^5.6.1",
+    "prettier": "^3.6.2",
+    "terser": "^5.44.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.20.5",
+    "type-fest": "^4.41.0",
+    "typedoc": "^0.28.16",
+    "typedoc-plugin-markdown": "^4.8.1",
+    "typescript": "~5.7.3",
+    "vite": "^7.1.4",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4",
+    "vitest-fetch-mock": "^0.4.5"
+  },
+  "files": [
+    "docs",
+    "dist"
+  ],
+  "keywords": [
+    "cache",
+    "swr",
+    "stale-while-revalidate",
+    "middleware",
+    "proxy",
+    "cacache",
+    "lru",
+    "request-collapsing",
+    "framework-agnostic",
+    "hybrid-cache"
+  ],
+  "maintainers": [
+    "Riceball LEE <snowyu.lee@gmail.com>"
+  ],
+  "engines": {
+    "node": ">=20.11.1"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build-fast": "tsup",
+    "build": "pnpm run build-fast --dts-resolve --dts && pnpm run doc:md",
+    "clean": "rm -fr web docs dist",
+    "doc": "typedoc --plugin none --out web",
+    "doc:md": "typedoc --plugin typedoc-plugin-markdown --out docs",
+    "style": "pnpm run format:base -c && pnpm run lint",
+    "style:fix": "pnpm run format:fix && pnpm run lint:fix",
+    "format": "pnpm run format:base -c",
+    "format:base": "prettier \"src/**/*.{ts,tsx,js,jsx,css,scss,sass,less,md}\"",
+    "format:fix": "pnpm run format:base --write",
+    "lint": "eslint .",
+    "lint:fix": "pnpm run lint --fix",
+    "test": "vitest run",
+    "release": "pnpm run clean && pnpm run build && git add -f docs && git ci -m 'docs: update API docs' && pnpm dlx commit-and-tag-version -s",
+    "release.alpha": "pnpm run release -- --prerelease alpha"
+  }
+}