acrylblends 0.6.1 → 0.6.2

package/README.md

@@ -22,7 +22,7 @@ One <code>Request</code> in, one <code>Response</code> out: routing, middleware,
 import { Acryl } from 'acrylblends'
 
 const app = new Acryl()
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 
 export default app
 ```
@@ -68,7 +68,7 @@ import { Acryl } from 'acrylblends'
 
 const app = new Acryl()
 
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 
 export default app
 ```
@@ -202,7 +202,7 @@ Export the app's type, and `acrylblends/client` calls its routes with typed path
 // api.ts
 import { Acryl } from 'acrylblends'
 
-const app = new Acryl().get('/api/hello', (c) => c.json({ message: 'Hello Acryl!' }))
+const app = new Acryl().get('/api/hello', (c) => c.json({ message: 'Acryl!' }))
 export type AppType = typeof app
 export default app
 ```
@@ -231,7 +231,7 @@ import app from './index.ts'
 test('GET / says hello', async () => {
   const response = await app.request('/')
   assert.equal(response.status, 200)
-  assert.equal(await response.text(), 'Hello Acryl!')
+  assert.equal(await response.text(), 'Acryl!')
 })
 ```
 
@@ -271,10 +271,12 @@ See [Node.js](https://github.com/acryldev/acryl/blob/main/docs/framework/getting
 | `acrylblends/http-exception` | `HTTPException` |
 | `acrylblends/router/*` | the routers: `reg-exp-router`, `smart-router`, `trie-router`, `pattern-router`, `linear-router` ([routers](https://github.com/acryldev/acryl/blob/main/docs/framework/concepts/routers.md)) |
 | `acrylblends/utils/*` | the utilities the framework is built from |
+| `acrylblends/tiny`, `acrylblends/quick` | the presets: `Acryl` with another router (`PatternRouter`; `LinearRouter` and `TrieRouter`) ([presets](https://github.com/acryldev/acryl/blob/main/docs/framework/api/presets.md)) |
+| `acrylblends/cache`, `acrylblends/mount` | the cache middleware and mounting another framework's fetch handler |
+| `acrylblends/proxy`, `acrylblends/dev` | the proxy helper and the dev helpers (`showRoutes`, `inspectRoutes`, `getRouterName`) |
 | `acrylblends/node-server` | `serve`, `createAdaptorServer`, `getRequestListener`; with `node-server/serve-static` and `node-server/conninfo` |
 
-Every subpath is listed in the package's `exports`. JSX, SSG, the cache, mount, proxy and dev helpers and other runtimes' adapters are
-being ported. The docs mark them "not yet available" until they ship
+Every subpath is listed in the package's `exports`. JSX, SSG and other runtimes' adapters are being ported. The docs mark them "not yet available" until they ship
 ([FAQ](https://github.com/acryldev/acryl/blob/main/docs/framework/guides/faq.md)).
 
 To extend the context's typed variables, augment the root module:

package/docs/framework/UPSTREAM.md

@@ -1,3 +1,3 @@
 # Generated copy
 
-This folder is a copy of `docs/framework` of acryldev/acryl at commit `5743482e4199ded676a77f594bce15fd4aa0ca2f`, made by `scripts/sync-framework.mjs`. Do not edit it here: change the text in ACRYL and sync again. `pnpm run verify:framework` fails when a page differs from the recorded digest.
+This folder is a copy of `docs/framework` of acryldev/acryl at commit `0174cb01625bfd32d0162ad56179c582f353321e`, made by `scripts/sync-framework.mjs`. Do not edit it here: change the text in ACRYL and sync again. `pnpm run verify:framework` fails when a page differs from the recorded digest.

package/docs/framework/api/presets.md

@@ -1,8 +1,5 @@
 # Presets
 
-> **Partly available.** The default router (`SmartRouter`), `RegExpRouter`, `TrieRouter`, `LinearRouter` and `PatternRouter` are available and are chosen with the `router` option of `new Acryl()` (see [Routers](../concepts/routers.md)). The presets `acrylblends/quick` and `acrylblends/tiny` are **not yet available**; their examples below are not checked by the docs tests.
-
-
 Acryl has several routers, each designed for a specific purpose.
 You can specify the router you want to use in the constructor of Acryl.
 

package/docs/framework/cordis/acryl-in-a-cordis-app.md

@@ -43,6 +43,9 @@ export function apply(ctx: Context): void {
 | `GET /todo/todos/42` | `{ "id": "42" }` |
 | `GET /todo/` | 404: `/todo` and `/todo/` are different paths (see below) |
 
+The app can come from `acryl-router` or from the published `acrylblends` package: `route` takes any app by its routes
+(`MountableApp`), so an `Acryl` imported from `acrylblends` mounts as it is, with its middleware and its own `onError`.
+
 ### `/todo/` is a 404 until you choose
 
 `/todo/` is the first thing people type, and by default it is not found: the router treats `/todo` and `/todo/` as two paths. Choose

package/docs/framework/getting-started/basic.md

@@ -63,7 +63,7 @@ import { Acryl } from 'acrylblends'
 const app = new Acryl()
 
 app.get('/', (c) => {
-  return c.text('Hello Acryl!')
+  return c.text('Acryl!')
 })
 
 export default app
@@ -83,7 +83,7 @@ const app = new Acryl()
 app.get('/api/hello', (c) => {
   return c.json({
     ok: true,
-    message: 'Hello Acryl!',
+    message: 'Acryl!',
   })
 })
 ```
@@ -162,7 +162,7 @@ app.use(
   '/admin/*',
   basicAuth({
     username: 'admin',
-    password: 'secret',
+    password: process.env.ADMIN_PASSWORD!,
   })
 )
 
@@ -181,7 +181,7 @@ An app is a function from `Request` to `Response`, so a test needs no server:
 import { Acryl } from 'acrylblends'
 
 const app = new Acryl()
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 
 const response = await app.request('/')
 console.log(response.status, await response.text())

package/docs/framework/guides/jsx.md

@@ -54,7 +54,7 @@ const Top: FC<{ messages: string[] }> = (props: {
 }) => {
   return (
     <Layout>
-      <h1>Hello Acryl!</h1>
+      <h1>Acryl!</h1>
       <ul>
         {props.messages.map((message) => {
           return <li>{message}!!</li>

package/docs/framework/guides/middleware.md

@@ -95,7 +95,7 @@ app.use(
   '/auth/*',
   basicAuth({
     username: 'acrylblends',
-    password: 'acoolproject',
+    password: process.env.BASIC_AUTH_PASSWORD!,
   })
 )
 ```

package/docs/framework/helpers/cookie.md

@@ -37,7 +37,7 @@ app.get('/cookie', (c) => {
 
 ```ts
 app.get('/signed-cookie', (c) => {
-  const secret = 'secret' // make sure it's a large enough string to be secure
+  const secret = process.env.COOKIE_SECRET! // a long random string, kept out of the source
 
   await setSignedCookie(c, 'cookie_name0', 'cookie_value', secret)
   const fortuneCookie = await getSignedCookie(

package/docs/framework/helpers/dev.md

@@ -1,8 +1,5 @@
 # Dev Helper
 
-> **Not yet available.** The dev helper (`acrylblends/dev`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 Dev Helper provides useful methods you can use in development.
 
 ```ts

package/docs/framework/helpers/jwt.md

@@ -35,7 +35,7 @@ const payload = {
   role: 'admin',
   exp: Math.floor(Date.now() / 1000) + 60 * 5, // Token expires in 5 minutes
 }
-const secret = 'mySecretKey'
+const secret = process.env.JWT_SECRET!
 const token = await sign(payload, secret)
 ```
 

package/docs/framework/helpers/proxy.md

@@ -1,8 +1,5 @@
 # Proxy Helper
 
-> **Not yet available.** The proxy helper (`acrylblends/proxy`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 Proxy Helper provides useful functions when using Acryl application as a (reverse) proxy.
 
 ## Import

package/docs/framework/middleware/builtin/basic-auth.md

@@ -21,7 +21,7 @@ app.use(
   '/auth/*',
   basicAuth({
     username: 'acrylblends',
-    password: 'acoolproject',
+    password: process.env.BASIC_AUTH_PASSWORD!,
   })
 )
 
@@ -41,7 +41,7 @@ app.get('/auth/page', (c) => {
 
 app.delete(
   '/auth/page',
-  basicAuth({ username: 'acrylblends', password: 'acoolproject' }),
+  basicAuth({ username: 'acrylblends', password: process.env.BASIC_AUTH_PASSWORD! }),
   (c) => {
     return c.text('Page deleted')
   }
@@ -100,7 +100,7 @@ app.use(
   '/auth/*',
   basicAuth({
     username: 'acrylblends',
-    password: 'acoolproject',
+    password: process.env.BASIC_AUTH_PASSWORD!,
     onAuthSuccess: (c, username) => {
       c.set('username', username)
     },
@@ -129,18 +129,18 @@ app.use(
   basicAuth(
     {
       username: 'acrylblends',
-      password: 'acoolproject',
+      password: process.env.BASIC_AUTH_PASSWORD!,
       // Define other params in the first object
       realm: 'www.example.com',
     },
     {
       username: 'acrylblends-admin',
-      password: 'super-secure',
+      password: process.env.ADMIN_PASSWORD!,
       // Cannot redefine other params here
     },
     {
       username: 'acrylblends-user-1',
-      password: 'a-secret',
+      password: process.env.USER_1_PASSWORD!,
       // Or here
     }
   )

package/docs/framework/middleware/builtin/cache.md

@@ -1,8 +1,5 @@
 # Cache Middleware
 
-> **Not yet available.** The cache middleware (`acrylblends/cache`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 The Cache middleware uses the Web Standards' [Cache API](https://developer.mozilla.org/en-US/docs/Web/API/Cache).
 
 The Cache middleware currently supports Cloudflare Workers projects using custom domains and Deno projects using [Deno 1.26+](https://github.com/denoland/deno/releases/tag/v1.26.0). Also available with Deno Deploy.

package/docs/framework/middleware/builtin/combine.md

@@ -39,7 +39,7 @@ app.use(
   )
 )
 
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 ```
 
 ### some

package/docs/framework/middleware/builtin/ip-restriction.md

@@ -28,7 +28,7 @@ app.use(
   })
 )
 
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 ```
 
 Pass the `getConninfo` from the [ConnInfo helper](../../helpers/conninfo.md) appropriate for your environment as the first argument of `ipRestriction`. For a runtime whose adapter is not yet available there is no `getConnInfo` to pass yet.

package/docs/framework/middleware/builtin/logger.md

@@ -15,7 +15,7 @@ import { logger } from 'acrylblends/logger'
 const app = new Acryl()
 
 app.use(logger())
-app.get('/', (c) => c.text('Hello Acryl!'))
+app.get('/', (c) => c.text('Acryl!'))
 ```
 
 ## Logging Details

package/docs/framework/middleware/builtin/mount.md

@@ -1,8 +1,5 @@
 # Mount Middleware
 
-> **Not yet available.** The `acrylblends/mount` subpath (an app can still call `app.mount()`) is documented here so the page structure matches the rest of the framework, and is not part of acrylblends yet. The code on this page is not checked by the docs tests.
-
-
 The Mount Middleware lets you mount an application built with another framework into your Acryl application.
 
 ## Import

package/docs/framework/upstream.json

@@ -2,8 +2,8 @@
   "source": {
     "repo": "acryldev/acryl",
     "path": "docs/framework",
-    "commit": "5743482e4199ded676a77f594bce15fd4aa0ca2f"
+    "commit": "0174cb01625bfd32d0162ad56179c582f353321e"
   },
   "files": 87,
-  "digest": "sha256:31bf1c46fbe74d7d2664b3b935a18bd916b8cab1b9ee9c2b006b8a75617a04f6"
+  "digest": "sha256:be8b4bb2555dbc97ef94caa57f6b071f5c0f173f0711eecc2836a537a1a71681"
 }

package/lib/accepts.d.ts

@@ -1,4 +1,4 @@
-import { t as Context } from "./context-Bm7rI-oK.js";
+import { t as Context } from "./context-B5Y1lLha.js";
 import { t as AcceptHeader } from "./headers-tu2YYN8T.js";
 
 //#region ../../plugins/acryl-router/src/core/helper/accepts/accepts.d.ts

package/lib/acryl-base.d.ts

@@ -1,2 +1,2 @@
-import { $ as Acryl, et as AcrylOptions } from "./context-Bm7rI-oK.js";
+import { $ as Acryl, et as AcrylOptions } from "./context-B5Y1lLha.js";
 export { Acryl as AcrylBase, AcrylOptions };

package/lib/adapter.d.ts

@@ -1,4 +1,4 @@
-import { t as Context } from "./context-Bm7rI-oK.js";
+import { t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/helper/adapter/index.d.ts
 type Runtime = 'node' | 'deno' | 'bun' | 'workerd' | 'fastly' | 'edge-light' | 'other';

package/lib/{app-CmAYW1Al.d.ts → app-BdrVHBlJ.d.ts}

@@ -1,4 +1,4 @@
-import { $ as Acryl$1, J as Schema, _ as Env, et as AcrylOptions, h as BlankSchema, p as BlankEnv } from "./context-Bm7rI-oK.js";
+import { $ as Acryl$1, J as Schema, _ as Env, et as AcrylOptions, h as BlankSchema, p as BlankEnv } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/app.d.ts
 /**

package/lib/basic-auth.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/basic-auth/index.d.ts
 type MessageFunction = (c: Context) => string | object | Promise<string | object>;

package/lib/bearer-auth.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, _ as Env, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, _ as Env, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/bearer-auth/index.d.ts
 type MessageFunction = (c: Context) => string | object | Promise<string | object>;

package/lib/body-limit.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/body-limit/index.d.ts
 type OnError = (c: Context) => Response | Promise<Response>;

package/lib/cache.d.ts

@@ -0,0 +1,43 @@
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
+import { c as StatusCode } from "./http-status-DaAwGAFL.js";
+
+//#region ../../plugins/acryl-router/src/core/middleware/cache/index.d.ts
+/**
+ * Cache Middleware for Acryl.
+ *
+ *
+ * @param {Object} options - The options for the cache middleware.
+ * @param {string | Function} options.cacheName - The name of the cache. Can be used to store multiple caches with different identifiers.
+ * @param {boolean} [options.wait=false] - A boolean indicating if Acryl should wait for the Promise of the `cache.put` function to resolve before continuing with the request. Required to be true for the Deno environment.
+ * @param {string} [options.cacheControl] - A string of directives for the `Cache-Control` header.
+ * @param {string | string[]} [options.vary] - Adds the configured request headers to the cache key variants and sets the `Vary` header in the response. If the original response header already contains a `Vary` header, the values are merged, removing any duplicates.
+ * @param {Function} [options.keyGenerator] - Generates keys for every request in the `cacheName` store. This can be used to cache data based on request parameters or context parameters. QUERY keys additionally include a digest of the request content and its representation metadata.
+ * @param {number} [options.maxQueryBodySize=65536] - The maximum QUERY request body size in bytes that can be cached. Larger QUERY requests bypass the cache.
+ * @param {number[]} [options.cacheableStatusCodes=[200]] - An array of status codes that can be cached.
+ * @param {Function | false} [options.onCacheNotAvailable] - A callback invoked with the reason when `globalThis.caches` is not available or QUERY caching cannot use Web Crypto. By default, the reason is logged to the console. Set to `false` to suppress the log, or provide a custom function.
+ * @returns {MiddlewareHandler} The middleware handler function.
+ * @throws {Error} If the `vary` option includes "*".
+ *
+ * @example
+ * ```ts
+ * app.use(
+ *   '*',
+ *   cache({
+ *     cacheName: 'my-app',
+ *     cacheControl: 'max-age=3600',
+ *   })
+ * )
+ * ```
+ */
+declare const cache: (options: {
+  cacheName: string | ((c: Context) => Promise<string> | string);
+  wait?: boolean;
+  cacheControl?: string;
+  vary?: string | string[];
+  keyGenerator?: (c: Context) => Promise<string> | string;
+  maxQueryBodySize?: number;
+  cacheableStatusCodes?: StatusCode[];
+  onCacheNotAvailable?: ((reason: string) => void) | false;
+}) => MiddlewareHandler;
+//#endregion
+export { cache };

package/lib/cache.js

@@ -0,0 +1,169 @@
+import { sha256 } from "./utils/crypto.js";
+import { cloneRawRequest } from "./request.js";
+//#region ../../plugins/acryl-router/src/core/middleware/cache/index.ts
+/**
+* status codes that can be cached by default.
+*/
+const defaultCacheableStatusCodes = [200];
+const defaultMaxQueryBodySize = 64 * 1024;
+const cacheKeyPath = "/.acryl-router/cache";
+const cacheKeyParameter = "__hono_cache_key";
+const cacheMethodKeyParameter = "__hono_cache_method";
+const queryDigestKeyParameter = "__hono_query_digest";
+const cacheVaryKeyParameter = "__hono_cache_vary";
+const queryRepresentationMetadataHeaders = [
+	"content-type",
+	"content-encoding",
+	"content-language",
+	"content-location"
+];
+const shouldSkipCacheControl = (cacheControl) => !!cacheControl && /(?:^|,\s*)(?:private|no-(?:store|cache))(?:\s*(?:=|,|$))/i.test(cacheControl);
+const parseVaryDirectives = (vary) => {
+	if (vary == null) return [];
+	return (Array.isArray(vary) ? vary : vary.split(",")).map((directive) => directive.trim().toLowerCase()).filter(Boolean);
+};
+const createCacheKey = (key, requestUrl, request, varyHeaders) => {
+	const url = new URL(cacheKeyPath, requestUrl);
+	url.searchParams.append(cacheKeyParameter, key);
+	url.searchParams.append(cacheMethodKeyParameter, request.method);
+	if (request.method === "QUERY") url.searchParams.append(queryDigestKeyParameter, request.digest);
+	for (const header of varyHeaders) url.searchParams.append(cacheVaryKeyParameter, JSON.stringify(header));
+	return url.href;
+};
+const shouldSkipCache = (res, optionsVaryDirectives, responseVary) => responseVary.length && (!optionsVaryDirectives || responseVary.some((name) => !optionsVaryDirectives.has(name))) || shouldSkipCacheControl(res.headers.get("Cache-Control")) || res.headers.has("Set-Cookie");
+const reportCacheNotAvailable = (onCacheNotAvailable, reason) => {
+	if (onCacheNotAvailable === false) {} else if (onCacheNotAvailable) onCacheNotAvailable(reason);
+	else console.log(reason);
+};
+const createQueryDigest = async (c, maxQueryBodySize) => {
+	if (!globalThis.crypto?.subtle) return;
+	if (c.req.raw.bodyUsed && Object.keys(c.req.bodyCache)[0] === "formData") return;
+	try {
+		const requestHeaders = c.req.raw.headers;
+		const metadata = new TextEncoder().encode(JSON.stringify(queryRepresentationMetadataHeaders.map((header) => [header, requestHeaders.get(header)])));
+		const body = (await cloneRawRequest(c.req)).body;
+		const chunks = [];
+		let bodySize = 0;
+		if (body) {
+			const reader = body.getReader();
+			for (;;) {
+				const { done, value } = await reader.read();
+				if (done) break;
+				bodySize += value.byteLength;
+				if (bodySize > maxQueryBodySize) {
+					reader.cancel().catch(() => {});
+					return;
+				}
+				chunks.push(value);
+			}
+		}
+		const data = new Uint8Array(metadata.byteLength + bodySize);
+		data.set(metadata);
+		let offset = metadata.byteLength;
+		for (const chunk of chunks) {
+			data.set(chunk, offset);
+			offset += chunk.byteLength;
+		}
+		return await sha256(data) ?? void 0;
+	} catch {
+		return;
+	}
+};
+/**
+* Cache Middleware for Acryl.
+*
+*
+* @param {Object} options - The options for the cache middleware.
+* @param {string | Function} options.cacheName - The name of the cache. Can be used to store multiple caches with different identifiers.
+* @param {boolean} [options.wait=false] - A boolean indicating if Acryl should wait for the Promise of the `cache.put` function to resolve before continuing with the request. Required to be true for the Deno environment.
+* @param {string} [options.cacheControl] - A string of directives for the `Cache-Control` header.
+* @param {string | string[]} [options.vary] - Adds the configured request headers to the cache key variants and sets the `Vary` header in the response. If the original response header already contains a `Vary` header, the values are merged, removing any duplicates.
+* @param {Function} [options.keyGenerator] - Generates keys for every request in the `cacheName` store. This can be used to cache data based on request parameters or context parameters. QUERY keys additionally include a digest of the request content and its representation metadata.
+* @param {number} [options.maxQueryBodySize=65536] - The maximum QUERY request body size in bytes that can be cached. Larger QUERY requests bypass the cache.
+* @param {number[]} [options.cacheableStatusCodes=[200]] - An array of status codes that can be cached.
+* @param {Function | false} [options.onCacheNotAvailable] - A callback invoked with the reason when `globalThis.caches` is not available or QUERY caching cannot use Web Crypto. By default, the reason is logged to the console. Set to `false` to suppress the log, or provide a custom function.
+* @returns {MiddlewareHandler} The middleware handler function.
+* @throws {Error} If the `vary` option includes "*".
+*
+* @example
+* ```ts
+* app.use(
+*   '*',
+*   cache({
+*     cacheName: 'my-app',
+*     cacheControl: 'max-age=3600',
+*   })
+* )
+* ```
+*/
+const cache = (options) => {
+	if (!globalThis.caches) {
+		reportCacheNotAvailable(options.onCacheNotAvailable, "Cache Middleware is not enabled because caches is not defined.");
+		return async (_c, next) => await next();
+	}
+	if (!globalThis.crypto?.subtle) reportCacheNotAvailable(options.onCacheNotAvailable, "Cache Middleware cannot cache QUERY requests because Web Crypto is not available.");
+	if (options.wait === void 0) options.wait = false;
+	const cacheControlDirectives = options.cacheControl?.split(",").map((directive) => directive.toLowerCase());
+	const optionsVaryList = parseVaryDirectives(options.vary);
+	const varyDirectives = optionsVaryList.length ? new Set(optionsVaryList) : void 0;
+	if (varyDirectives?.has("*")) throw new Error("Middleware vary configuration cannot include \"*\", as it disallows effective caching.");
+	const cacheableStatusCodes = new Set(options.cacheableStatusCodes ?? defaultCacheableStatusCodes);
+	const maxQueryBodySize = options.maxQueryBodySize ?? defaultMaxQueryBodySize;
+	const addHeader = (c, responseVary) => {
+		if (cacheControlDirectives) {
+			const existingDirectives = c.res.headers.get("Cache-Control")?.split(",").map((d) => d.trim().split("=", 1)[0].toLowerCase()) ?? [];
+			for (const directive of cacheControlDirectives) {
+				let [name, value] = directive.trim().split("=", 2);
+				name = name.toLowerCase();
+				if (!existingDirectives.includes(name)) c.header("Cache-Control", `${name}${value ? `=${value}` : ""}`, { append: true });
+			}
+		}
+		if (varyDirectives) if (responseVary.length === 0) c.header("Vary", Array.from(varyDirectives).join(", "));
+		else {
+			const merged = new Set(varyDirectives);
+			for (const directive of responseVary) merged.add(directive);
+			if (merged.has("*")) c.header("Vary", "*");
+			else c.header("Vary", Array.from(merged).join(", "));
+		}
+	};
+	return async function cache(c, next) {
+		if (c.req.method !== "GET" && c.req.method !== "QUERY" || c.req.raw.headers.has("Authorization")) {
+			await next();
+			return;
+		}
+		let cacheKeyRequest = { method: "GET" };
+		if (c.req.method === "QUERY") {
+			const digest = await createQueryDigest(c, maxQueryBodySize);
+			if (digest === void 0) {
+				await next();
+				return;
+			}
+			cacheKeyRequest = {
+				method: "QUERY",
+				digest
+			};
+		}
+		let key = c.req.url;
+		if (options.keyGenerator) key = await options.keyGenerator(c);
+		const varyHeaders = [];
+		if (varyDirectives) for (const directive of varyDirectives) {
+			const value = c.req.raw.headers.get(directive) ?? "";
+			varyHeaders.push([directive, value]);
+		}
+		key = createCacheKey(key, c.req.url, cacheKeyRequest, varyHeaders);
+		const cacheName = typeof options.cacheName === "function" ? await options.cacheName(c) : options.cacheName;
+		const cache = await caches.open(cacheName);
+		const response = await cache.match(key);
+		if (response) return new Response(response.body, response);
+		await next();
+		if (!cacheableStatusCodes.has(c.res.status)) return;
+		const responseVary = parseVaryDirectives(c.res.headers.get("Vary"));
+		addHeader(c, responseVary);
+		if (shouldSkipCache(c.res, varyDirectives, responseVary)) return;
+		const res = c.res.clone();
+		if (options.wait) await cache.put(key, res);
+		else c.executionCtx.waitUntil(cache.put(key, res));
+	};
+};
+//#endregion
+export { cache };

package/lib/client.d.ts

@@ -1,3 +1,3 @@
-import { a as ClientResponse, c as InferRequestType, i as ClientRequestOptions, l as InferResponseType, o as Fetch, r as ClientRequest, t as ApplyGlobalResponse, u as PickResponseByStatusCode } from "./types-CHesD1KG.js";
-import { n as DetailedError, r as hc, t as parseResponse } from "./index-oOClm_Xk.js";
+import { a as ClientResponse, c as InferRequestType, i as ClientRequestOptions, l as InferResponseType, o as Fetch, r as ClientRequest, t as ApplyGlobalResponse, u as PickResponseByStatusCode } from "./types-Bd29gh2o.js";
+import { n as DetailedError, r as hc, t as parseResponse } from "./index-m12zcmph.js";
 export { type ApplyGlobalResponse, type ClientRequest, type ClientRequestOptions, type ClientResponse, DetailedError, type Fetch, type InferRequestType, type InferResponseType, type PickResponseByStatusCode, hc, parseResponse };

package/lib/combine.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/combine/index.d.ts
 type Condition = (c: Context) => boolean;

package/lib/compress.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler } from "./context-B5Y1lLha.js";
 import { COMPRESSIBLE_CONTENT_TYPE_REGEX } from "./utils/compress.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/compress/index.d.ts

package/lib/conninfo.d.ts

@@ -1,5 +1,5 @@
-import { t as Context } from "./context-Bm7rI-oK.js";
-import { i as NetAddrInfo, n as ConnInfo, r as GetConnInfo, t as AddressType } from "./types-CDO6I3B0.js";
+import { t as Context } from "./context-B5Y1lLha.js";
+import { i as NetAddrInfo, n as ConnInfo, r as GetConnInfo, t as AddressType } from "./types-ZM9gIiKh.js";
 
 //#region ../../plugins/acryl-router/src/connection.d.ts
 /** An in-process caller (the terminal UI, a test) passes nothing, so a handler that needs a trusted peer must refuse an empty one. */

package/lib/{context-Bm7rI-oK.d.ts → context-B5Y1lLha.d.ts}

@@ -1,7 +1,7 @@
 import { c as Result, l as Router } from "./router-CvUxUTOq.js";
 import { i as ResponseHeader, n as CustomHeader, r as RequestHeader } from "./headers-tu2YYN8T.js";
 import { c as StatusCode, n as ContentfulStatusCode, o as RedirectStatusCode } from "./http-status-DaAwGAFL.js";
-import { S as Simplify, T as UnionToIntersection, b as RemoveBlankRecord, c as IfAnyThenEmptyObject, d as IsAny, g as JSONValue, m as JSONParsed, u as InvalidJSONValue } from "./types-CwrQjlaM.js";
+import { C as Simplify, E as UnionToIntersection, _ as JSONValue, d as InvalidJSONValue, f as IsAny, h as JSONParsed, l as IfAnyThenEmptyObject, x as RemoveBlankRecord } from "./types-D9DEXMjE.js";
 import { t as BaseMime } from "./mime-BQOYHl-l.js";
 
 //#region ../../plugins/acryl-router/src/core/request/constants.d.ts

package/lib/context-storage.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, _ as Env, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, _ as Env, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/context-storage/index.d.ts
 /**

package/lib/{cookie-ClMaKDQf.d.ts → cookie-D9_nQbsM.d.ts}

@@ -1,4 +1,4 @@
-import { n as BufferSource } from "./types-CwrQjlaM.js";
+import { n as BufferSource } from "./types-D9DEXMjE.js";
 
 //#region ../../plugins/acryl-router/src/core/utils/cookie.d.ts
 type Cookie = Record<string, string>;

package/lib/cookie.d.ts

@@ -1,6 +1,6 @@
-import { t as Context } from "./context-Bm7rI-oK.js";
-import { n as BufferSource } from "./types-CwrQjlaM.js";
-import { a as SignedCookie, i as CookiePrefixOptions, r as CookieOptions, t as Cookie } from "./cookie-ClMaKDQf.js";
+import { t as Context } from "./context-B5Y1lLha.js";
+import { n as BufferSource } from "./types-D9DEXMjE.js";
+import { a as SignedCookie, i as CookiePrefixOptions, r as CookieOptions, t as Cookie } from "./cookie-D9_nQbsM.js";
 
 //#region ../../plugins/acryl-router/src/core/helper/cookie/index.d.ts
 interface GetCookie {

package/lib/cors.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/cors/index.d.ts
 type CORSOptions = {

package/lib/csrf.d.ts

@@ -1,4 +1,4 @@
-import { I as MiddlewareHandler, t as Context } from "./context-Bm7rI-oK.js";
+import { I as MiddlewareHandler, t as Context } from "./context-B5Y1lLha.js";
 
 //#region ../../plugins/acryl-router/src/core/middleware/csrf/index.d.ts
 type IsAllowedOriginHandler = (origin: string, context: Context) => boolean | Promise<boolean>;