@eggjs/koa-static-cache 6.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 - present eggjs and the contributors.
+Copyright (c) 2013 Jonathan Ong me@jongleberry.com
+
+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,144 @@
+# Koa Static Cache
+
+[![NPM version][npm-image]][npm-url]
+[![Node.js CI](https://github.com/eggjs/koa-static-cache/actions/workflows/nodejs.yml/badge.svg)](https://github.com/eggjs/koa-static-cache/actions/workflows/nodejs.yml)
+[![Test coverage][codecov-image]][codecov-url]
+[![Known Vulnerabilities][snyk-image]][snyk-url]
+[![npm download][download-image]][download-url]
+[![Node.js Version](https://img.shields.io/node/v/@eggjs/koa-static-cache.svg?style=flat)](https://nodejs.org/en/download/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](https://makeapullrequest.com)
+
+[npm-image]: https://img.shields.io/npm/v/@eggjs/koa-static-cache.svg?style=flat-square
+[npm-url]: https://npmjs.org/package/@eggjs/koa-static-cache
+[codecov-image]: https://img.shields.io/codecov/c/github/eggjs/koa-static-cache.svg?style=flat-square
+[codecov-url]: https://codecov.io/github/eggjs/koa-static-cache?branch=master
+[snyk-image]: https://snyk.io/test/npm/@eggjs/koa-static-cache/badge.svg?style=flat-square
+[snyk-url]: https://snyk.io/test/npm/@eggjs/koa-static-cache
+[download-image]: https://img.shields.io/npm/dm/@eggjs/koa-static-cache.svg?style=flat-square
+[download-url]: https://npmjs.org/package/@eggjs/koa-static-cache
+
+Static cache middleware for koa.
+
+Differences between this library and other libraries such as [static](https://github.com/koajs/static):
+
+- There is no directory or `index.html` support.
+- You may optionally store the data in memory - it streams by default.
+- Caches the assets on initialization - you need to restart the process to update the assets.(can turn off with options.preload = false)
+- Uses MD5 hash sum as an ETag.
+- Uses `.gz` files if present on disk, like nginx gzip_static module
+
+> Forked from https://github.com/koajs/static-cache, refactor with TypeScript to support CommonJS and ESM both.
+
+## Installation
+
+```bash
+npm install @eggjs/koa-static-cache
+```
+
+## API
+
+### staticCache([options])
+
+```js
+const path = require('path');
+const { staticCache } = require('@eggjs/koa-static-cache');
+
+app.use(staticCache(path.join(__dirname, 'public'), {
+  maxAge: 365 * 24 * 60 * 60
+}));
+```
+
+- `options.dir` (str) - the directory you wish to serve, default to `process.cwd`.
+- `options.maxAge` (int) - cache control max age for the files, `0` by default.
+- `options.cacheControl` (str) - optional cache control header. Overrides `options.maxAge`.
+- `options.buffer` (bool) - store the files in memory instead of streaming from the filesystem on each request.
+- `options.gzip` (bool) - when request's accept-encoding include gzip, files will compressed by gzip.
+- `options.usePrecompiledGzip` (bool) - try use gzip files, loaded from disk, like nginx gzip_static
+- `options.alias` (obj) - object map of aliases. See below.
+- `options.prefix` (str) - the url prefix you wish to add, default to `''`.
+- `options.dynamic` (bool) - dynamic load file which not cached on initialization.
+- `options.filter` (function | array) - filter files at init dir, for example - skip non build (source) files. If array set - allow only listed files
+- `options.preload` (bool) - caches the assets on initialization or not, default to `true`. always work together with `options.dynamic`.
+- `options.files` (obj) - optional files object. See below.
+
+### Aliases
+
+For example, if you have this `alias` object:
+
+```js
+const options = {
+  alias: {
+    '/favicon.png': '/favicon-32.png'
+  }
+}
+```
+
+Then requests to `/favicon.png` will actually return `/favicon-32.png` without redirects or anything.
+This is particularly important when serving [favicons](https://github.com/audreyr/favicon-cheat-sheet) as you don't want to store duplicate images.
+
+### Files
+
+You can pass in an optional files object.
+This allows you to do two things:
+
+#### Combining directories into a single middleware
+
+Instead of doing:
+
+```js
+app.use(staticCache('/public/js'))
+app.use(staticCache('/public/css'))
+```
+
+You can do this:
+
+```js
+const files = {};
+
+// Mount the middleware
+app.use(staticCache('/public/js', {}, files));
+
+// Add additional files
+staticCache('/public/css', {}, files);
+```
+
+The benefit is that you'll have one less function added to the stack as well as doing one hash lookup instead of two.
+
+#### Editing the files object
+
+For example, if you want to change the max age of `/package.json`, you can do the following:
+
+```js
+const files = {};
+
+app.use(staticCache('/public', {
+  maxAge: 60 * 60 * 24 * 365
+}, files));
+
+files['/package.json'].maxAge = 60 * 60 * 24 * 30;
+```
+
+#### Using a LRU cache to avoid OOM when dynamic mode enabled
+
+You can pass in a lru cache instance which has tow methods: `get(key)` and `set(key, value)`.
+
+```js
+const LRU = require('lru-cache');
+const files = new LRU({ max: 1000 });
+
+app.use(staticCache({
+  dir: '/public',
+  dynamic: true,
+  files,
+}));
+```
+
+## License
+
+[MIT](LICENSE)
+
+## Contributors
+
+[![Contributors](https://contrib.rocks/image?repo=eggjs/koa-static-cache)](https://github.com/eggjs/koa-static-cache/graphs/contributors)
+
+Made with [contributors-img](https://contrib.rocks).

package/dist/commonjs/index.d.ts

@@ -0,0 +1,99 @@
+export type FileFilter = (path: string) => boolean;
+export interface FileMeta {
+    maxAge?: number;
+    cacheControl?: string;
+    buffer?: Buffer;
+    zipBuffer?: Buffer;
+    type?: string;
+    mime?: string;
+    mtime?: Date;
+    path?: string;
+    md5?: string;
+    length?: number;
+}
+export interface FileMap {
+    [path: string]: FileMeta;
+}
+export interface FileStore {
+    get(key: string): unknown;
+    set(key: string, value: unknown): void;
+}
+export interface Options {
+    /**
+     * The root directory from which to serve static assets
+     * Default to `process.cwd`
+     */
+    dir?: string;
+    /**
+     * The max age for cache control
+     * Default to `0`
+     */
+    maxAge?: number;
+    /**
+     * The cache control header for static files
+     * Default to `undefined`
+     * Overrides `options.maxAge`
+     */
+    cacheControl?: string;
+    /**
+     * store the files in memory instead of streaming from the filesystem on each request
+     */
+    buffer?: boolean;
+    /**
+     * when request's accept-encoding include gzip, files will compressed by gzip
+     * Default to `false`
+     */
+    gzip?: boolean;
+    /**
+     * try use gzip files, loaded from disk, like nginx gzip_static
+     * Default to `false`
+     */
+    usePrecompiledGzip?: boolean;
+    /**
+     * object map of aliases
+     * Default to `{}`
+     */
+    alias?: Record<string, string>;
+    /**
+     * the url prefix you wish to add
+     * Default to `''`
+     */
+    prefix?: string;
+    /**
+     * filter files at init dir, for example - skip non build (source) files.
+     * If array set - allow only listed files
+     * Default to `undefined`
+     */
+    filter?: FileFilter | string[];
+    /**
+     * dynamic load file which not cached on initialization
+     * Default to `false
+     */
+    dynamic?: boolean;
+    /**
+     * caches the assets on initialization or not,
+     * always work together with `options.dynamic`
+     * Default to `true`
+     */
+    preload?: boolean;
+    /**
+     * file store for caching
+     * Default to `undefined`
+     */
+    files?: FileMap | FileStore;
+}
+type Next = () => Promise<void>;
+export declare class FileManager {
+    store?: FileStore;
+    map?: FileMap;
+    constructor(store?: FileStore | FileMap);
+    get(key: string): unknown;
+    set(key: string, value: FileMeta): void;
+}
+type MiddlewareFunc = (ctx: any, next: Next) => Promise<void> | void;
+export declare function staticCache(): MiddlewareFunc;
+export declare function staticCache(dir: string): MiddlewareFunc;
+export declare function staticCache(options: Options): MiddlewareFunc;
+export declare function staticCache(dir: string, options: Options): MiddlewareFunc;
+export declare function staticCache(dir: string, options: Options, files: FileMap | FileStore): MiddlewareFunc;
+export {};

package/dist/commonjs/index.js

@@ -0,0 +1,225 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileManager = void 0;
+exports.staticCache = staticCache;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_util_1 = require("node:util");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_fs_1 = require("node:fs");
+const node_zlib_1 = __importDefault(require("node:zlib"));
+const node_path_1 = __importDefault(require("node:path"));
+const mime_types_1 = __importDefault(require("mime-types"));
+const compressible_1 = __importDefault(require("compressible"));
+const fs_readdir_recursive_1 = __importDefault(require("fs-readdir-recursive"));
+const utility_1 = require("utility");
+const debug = (0, node_util_1.debuglog)('@eggjs/koa-static-cache');
+const gzip = (0, node_util_1.promisify)(node_zlib_1.default.gzip);
+class FileManager {
+    store;
+    map;
+    constructor(store) {
+        if (store && typeof store.set === 'function' && typeof store.get === 'function') {
+            this.store = store;
+        }
+        else {
+            this.map = store || Object.create(null);
+        }
+    }
+    get(key) {
+        return this.store ? this.store.get(key) : this.map[key];
+    }
+    set(key, value) {
+        if (this.store) {
+            return this.store.set(key, value);
+        }
+        this.map[key] = value;
+    }
+}
+exports.FileManager = FileManager;
+function staticCache(dirOrOptions, options = {}, filesStoreOrMap) {
+    let dir = '';
+    if (typeof dirOrOptions === 'string') {
+        // dir priority than options.dir
+        dir = dirOrOptions;
+    }
+    else if (dirOrOptions) {
+        options = dirOrOptions;
+    }
+    if (!dir && options.dir) {
+        dir = options.dir;
+    }
+    if (!dir) {
+        // default to process.cwd
+        dir = process.cwd();
+    }
+    dir = node_path_1.default.normalize(dir);
+    debug('staticCache dir: %s', dir);
+    // prefix must be ASCII code
+    options.prefix = (options.prefix ?? '').replace(/\/*$/, '/');
+    const files = new FileManager(filesStoreOrMap ?? options.files);
+    const enableGzip = !!options.gzip;
+    const filePrefix = node_path_1.default.normalize(options.prefix.replace(/^\//, ''));
+    // option.filter
+    let fileFilter = () => { return true; };
+    if (Array.isArray(options.filter)) {
+        fileFilter = (file) => {
+            return options.filter.includes(file);
+        };
+    }
+    if (typeof options.filter === 'function') {
+        fileFilter = options.filter;
+    }
+    if (options.preload !== false) {
+        (0, fs_readdir_recursive_1.default)(dir).filter(fileFilter).forEach(name => {
+            loadFile(name, dir, options, files);
+        });
+    }
+    return async (ctx, next) => {
+        // only accept HEAD and GET
+        if (ctx.method !== 'HEAD' && ctx.method !== 'GET')
+            return await next();
+        // check prefix first to avoid calculate
+        if (!ctx.path.startsWith(options.prefix))
+            return await next();
+        // decode for `/%E4%B8%AD%E6%96%87`
+        // normalize for `//index`
+        let filename = node_path_1.default.normalize((0, utility_1.decodeURIComponent)(ctx.path));
+        // check alias
+        if (options.alias && options.alias[filename]) {
+            filename = options.alias[filename];
+        }
+        let file = files.get(filename);
+        // try to load file
+        if (!file) {
+            if (!options.dynamic)
+                return await next();
+            if (node_path_1.default.basename(filename)[0] === '.')
+                return await next();
+            if (filename.charAt(0) === node_path_1.default.sep) {
+                filename = filename.slice(1);
+            }
+            // trim prefix
+            if (options.prefix !== '/') {
+                if (filename.indexOf(filePrefix) !== 0) {
+                    return await next();
+                }
+                filename = filename.slice(filePrefix.length);
+            }
+            const fullpath = node_path_1.default.join(dir, filename);
+            // files that can be accessed should be under options.dir
+            if (!fullpath.startsWith(dir)) {
+                return await next();
+            }
+            const stats = await (0, utility_1.exists)(fullpath);
+            if (!stats)
+                return await next();
+            if (!stats.isFile())
+                return await next();
+            file = loadFile(filename, dir, options, files);
+        }
+        ctx.status = 200;
+        if (enableGzip)
+            ctx.vary('Accept-Encoding');
+        if (!file.buffer) {
+            const stats = await promises_1.default.stat(file.path);
+            if (stats.mtime.getTime() !== file.mtime.getTime()) {
+                file.mtime = stats.mtime;
+                file.md5 = undefined;
+                file.length = stats.size;
+            }
+        }
+        ctx.response.lastModified = file.mtime;
+        if (file.md5) {
+            ctx.response.etag = file.md5;
+        }
+        if (ctx.fresh) {
+            ctx.status = 304;
+            return;
+        }
+        ctx.type = file.type;
+        ctx.length = file.zipBuffer ? file.zipBuffer.length : file.length;
+        ctx.set('cache-control', file.cacheControl ?? 'public, max-age=' + file.maxAge);
+        if (file.md5)
+            ctx.set('content-md5', file.md5);
+        if (ctx.method === 'HEAD') {
+            return;
+        }
+        const acceptGzip = ctx.acceptsEncodings('gzip') === 'gzip';
+        if (file.zipBuffer) {
+            if (acceptGzip) {
+                ctx.set('content-encoding', 'gzip');
+                ctx.body = file.zipBuffer;
+            }
+            else {
+                ctx.body = file.buffer;
+            }
+            return;
+        }
+        const shouldGzip = enableGzip
+            && file.length > 1024
+            && acceptGzip
+            && (0, compressible_1.default)(file.type);
+        if (file.buffer) {
+            if (shouldGzip) {
+                const gzFile = files.get(filename + '.gz');
+                if (options.usePrecompiledGzip && gzFile && gzFile.buffer) {
+                    // if .gz file already read from disk
+                    file.zipBuffer = gzFile.buffer;
+                }
+                else {
+                    file.zipBuffer = await gzip(file.buffer);
+                }
+                ctx.set('content-encoding', 'gzip');
+                ctx.body = file.zipBuffer;
+            }
+            else {
+                ctx.body = file.buffer;
+            }
+            return;
+        }
+        const stream = (0, node_fs_1.createReadStream)(file.path);
+        // update file hash
+        if (!file.md5) {
+            const hash = node_crypto_1.default.createHash('md5');
+            stream.on('data', hash.update.bind(hash));
+            stream.on('end', () => {
+                file.md5 = hash.digest('base64');
+            });
+        }
+        ctx.body = stream;
+        // enable gzip will remove content length
+        if (shouldGzip) {
+            ctx.remove('content-length');
+            ctx.set('content-encoding', 'gzip');
+            ctx.body = stream.pipe(node_zlib_1.default.createGzip());
+        }
+    };
+}
+/**
+ * load file and add file content to cache
+ */
+function loadFile(name, dir, options, fileManager) {
+    const pathname = node_path_1.default.normalize(node_path_1.default.join(options.prefix, name));
+    if (!fileManager.get(pathname)) {
+        fileManager.set(pathname, {});
+    }
+    const obj = fileManager.get(pathname);
+    const filename = obj.path = node_path_1.default.join(dir, name);
+    const stats = (0, node_fs_1.statSync)(filename);
+    const buffer = (0, node_fs_1.readFileSync)(filename);
+    obj.cacheControl = options.cacheControl;
+    obj.maxAge = obj.maxAge ? obj.maxAge : options.maxAge || 0;
+    obj.type = obj.mime = mime_types_1.default.lookup(pathname) || 'application/octet-stream';
+    obj.mtime = stats.mtime;
+    obj.length = stats.size;
+    obj.md5 = node_crypto_1.default.createHash('md5').update(buffer).digest('base64');
+    debug('file: %s', JSON.stringify(obj, null, 2));
+    if (options.buffer) {
+        obj.buffer = buffer;
+    }
+    return obj;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7O0FBeUlBLGtDQWdMQztBQXpURCw4REFBaUM7QUFDakMseUNBQWdEO0FBQ2hELGdFQUFrQztBQUNsQyxxQ0FBbUU7QUFDbkUsMERBQTZCO0FBQzdCLDBEQUE2QjtBQUM3Qiw0REFBOEI7QUFDOUIsZ0VBQXdDO0FBQ3hDLGdGQUEyQztBQUMzQyxxQ0FBK0U7QUFFL0UsTUFBTSxLQUFLLEdBQUcsSUFBQSxvQkFBUSxFQUFDLHlCQUF5QixDQUFDLENBQUM7QUFFbEQsTUFBTSxJQUFJLEdBQUcsSUFBQSxxQkFBUyxFQUFDLG1CQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7QUE2RmxDLE1BQWEsV0FBVztJQUN0QixLQUFLLENBQWE7SUFDbEIsR0FBRyxDQUFXO0lBRWQsWUFBWSxLQUEyQjtRQUNyQyxJQUFJLEtBQUssSUFBSSxPQUFPLEtBQUssQ0FBQyxHQUFHLEtBQUssVUFBVSxJQUFJLE9BQU8sS0FBSyxDQUFDLEdBQUcsS0FBSyxVQUFVLEVBQUUsQ0FBQztZQUNoRixJQUFJLENBQUMsS0FBSyxHQUFHLEtBQWtCLENBQUM7UUFDbEMsQ0FBQzthQUFNLENBQUM7WUFDTixJQUFJLENBQUMsR0FBRyxHQUFHLEtBQUssSUFBSSxNQUFNLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBQzFDLENBQUM7SUFDSCxDQUFDO0lBRUQsR0FBRyxDQUFDLEdBQVc7UUFDYixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzNELENBQUM7SUFFRCxHQUFHLENBQUMsR0FBVyxFQUFFLEtBQWU7UUFDOUIsSUFBSSxJQUFJLENBQUMsS0FBSyxFQUFF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

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,99 @@
+export type FileFilter = (path: string) => boolean;
+export interface FileMeta {
+    maxAge?: number;
+    cacheControl?: string;
+    buffer?: Buffer;
+    zipBuffer?: Buffer;
+    type?: string;
+    mime?: string;
+    mtime?: Date;
+    path?: string;
+    md5?: string;
+    length?: number;
+}
+export interface FileMap {
+    [path: string]: FileMeta;
+}
+export interface FileStore {
+    get(key: string): unknown;
+    set(key: string, value: unknown): void;
+}
+export interface Options {
+    /**
+     * The root directory from which to serve static assets
+     * Default to `process.cwd`
+     */
+    dir?: string;
+    /**
+     * The max age for cache control
+     * Default to `0`
+     */
+    maxAge?: number;
+    /**
+     * The cache control header for static files
+     * Default to `undefined`
+     * Overrides `options.maxAge`
+     */
+    cacheControl?: string;
+    /**
+     * store the files in memory instead of streaming from the filesystem on each request
+     */
+    buffer?: boolean;
+    /**
+     * when request's accept-encoding include gzip, files will compressed by gzip
+     * Default to `false`
+     */
+    gzip?: boolean;
+    /**
+     * try use gzip files, loaded from disk, like nginx gzip_static
+     * Default to `false`
+     */
+    usePrecompiledGzip?: boolean;
+    /**
+     * object map of aliases
+     * Default to `{}`
+     */
+    alias?: Record<string, string>;
+    /**
+     * the url prefix you wish to add
+     * Default to `''`
+     */
+    prefix?: string;
+    /**
+     * filter files at init dir, for example - skip non build (source) files.
+     * If array set - allow only listed files
+     * Default to `undefined`
+     */
+    filter?: FileFilter | string[];
+    /**
+     * dynamic load file which not cached on initialization
+     * Default to `false
+     */
+    dynamic?: boolean;
+    /**
+     * caches the assets on initialization or not,
+     * always work together with `options.dynamic`
+     * Default to `true`
+     */
+    preload?: boolean;
+    /**
+     * file store for caching
+     * Default to `undefined`
+     */
+    files?: FileMap | FileStore;
+}
+type Next = () => Promise<void>;
+export declare class FileManager {
+    store?: FileStore;
+    map?: FileMap;
+    constructor(store?: FileStore | FileMap);
+    get(key: string): unknown;
+    set(key: string, value: FileMeta): void;
+}
+type MiddlewareFunc = (ctx: any, next: Next) => Promise<void> | void;
+export declare function staticCache(): MiddlewareFunc;
+export declare function staticCache(dir: string): MiddlewareFunc;
+export declare function staticCache(options: Options): MiddlewareFunc;
+export declare function staticCache(dir: string, options: Options): MiddlewareFunc;
+export declare function staticCache(dir: string, options: Options, files: FileMap | FileStore): MiddlewareFunc;
+export {};

package/dist/esm/index.js

@@ -0,0 +1,217 @@
+import crypto from 'node:crypto';
+import { debuglog, promisify } from 'node:util';
+import fs from 'node:fs/promises';
+import { createReadStream, statSync, readFileSync } from 'node:fs';
+import zlib from 'node:zlib';
+import path from 'node:path';
+import mime from 'mime-types';
+import compressible from 'compressible';
+import readDir from 'fs-readdir-recursive';
+import { exists, decodeURIComponent as safeDecodeURIComponent } from 'utility';
+const debug = debuglog('@eggjs/koa-static-cache');
+const gzip = promisify(zlib.gzip);
+export class FileManager {
+    store;
+    map;
+    constructor(store) {
+        if (store && typeof store.set === 'function' && typeof store.get === 'function') {
+            this.store = store;
+        }
+        else {
+            this.map = store || Object.create(null);
+        }
+    }
+    get(key) {
+        return this.store ? this.store.get(key) : this.map[key];
+    }
+    set(key, value) {
+        if (this.store) {
+            return this.store.set(key, value);
+        }
+        this.map[key] = value;
+    }
+}
+export function staticCache(dirOrOptions, options = {}, filesStoreOrMap) {
+    let dir = '';
+    if (typeof dirOrOptions === 'string') {
+        // dir priority than options.dir
+        dir = dirOrOptions;
+    }
+    else if (dirOrOptions) {
+        options = dirOrOptions;
+    }
+    if (!dir && options.dir) {
+        dir = options.dir;
+    }
+    if (!dir) {
+        // default to process.cwd
+        dir = process.cwd();
+    }
+    dir = path.normalize(dir);
+    debug('staticCache dir: %s', dir);
+    // prefix must be ASCII code
+    options.prefix = (options.prefix ?? '').replace(/\/*$/, '/');
+    const files = new FileManager(filesStoreOrMap ?? options.files);
+    const enableGzip = !!options.gzip;
+    const filePrefix = path.normalize(options.prefix.replace(/^\//, ''));
+    // option.filter
+    let fileFilter = () => { return true; };
+    if (Array.isArray(options.filter)) {
+        fileFilter = (file) => {
+            return options.filter.includes(file);
+        };
+    }
+    if (typeof options.filter === 'function') {
+        fileFilter = options.filter;
+    }
+    if (options.preload !== false) {
+        readDir(dir).filter(fileFilter).forEach(name => {
+            loadFile(name, dir, options, files);
+        });
+    }
+    return async (ctx, next) => {
+        // only accept HEAD and GET
+        if (ctx.method !== 'HEAD' && ctx.method !== 'GET')
+            return await next();
+        // check prefix first to avoid calculate
+        if (!ctx.path.startsWith(options.prefix))
+            return await next();
+        // decode for `/%E4%B8%AD%E6%96%87`
+        // normalize for `//index`
+        let filename = path.normalize(safeDecodeURIComponent(ctx.path));
+        // check alias
+        if (options.alias && options.alias[filename]) {
+            filename = options.alias[filename];
+        }
+        let file = files.get(filename);
+        // try to load file
+        if (!file) {
+            if (!options.dynamic)
+                return await next();
+            if (path.basename(filename)[0] === '.')
+                return await next();
+            if (filename.charAt(0) === path.sep) {
+                filename = filename.slice(1);
+            }
+            // trim prefix
+            if (options.prefix !== '/') {
+                if (filename.indexOf(filePrefix) !== 0) {
+                    return await next();
+                }
+                filename = filename.slice(filePrefix.length);
+            }
+            const fullpath = path.join(dir, filename);
+            // files that can be accessed should be under options.dir
+            if (!fullpath.startsWith(dir)) {
+                return await next();
+            }
+            const stats = await exists(fullpath);
+            if (!stats)
+                return await next();
+            if (!stats.isFile())
+                return await next();
+            file = loadFile(filename, dir, options, files);
+        }
+        ctx.status = 200;
+        if (enableGzip)
+            ctx.vary('Accept-Encoding');
+        if (!file.buffer) {
+            const stats = await fs.stat(file.path);
+            if (stats.mtime.getTime() !== file.mtime.getTime()) {
+                file.mtime = stats.mtime;
+                file.md5 = undefined;
+                file.length = stats.size;
+            }
+        }
+        ctx.response.lastModified = file.mtime;
+        if (file.md5) {
+            ctx.response.etag = file.md5;
+        }
+        if (ctx.fresh) {
+            ctx.status = 304;
+            return;
+        }
+        ctx.type = file.type;
+        ctx.length = file.zipBuffer ? file.zipBuffer.length : file.length;
+        ctx.set('cache-control', file.cacheControl ?? 'public, max-age=' + file.maxAge);
+        if (file.md5)
+            ctx.set('content-md5', file.md5);
+        if (ctx.method === 'HEAD') {
+            return;
+        }
+        const acceptGzip = ctx.acceptsEncodings('gzip') === 'gzip';
+        if (file.zipBuffer) {
+            if (acceptGzip) {
+                ctx.set('content-encoding', 'gzip');
+                ctx.body = file.zipBuffer;
+            }
+            else {
+                ctx.body = file.buffer;
+            }
+            return;
+        }
+        const shouldGzip = enableGzip
+            && file.length > 1024
+            && acceptGzip
+            && compressible(file.type);
+        if (file.buffer) {
+            if (shouldGzip) {
+                const gzFile = files.get(filename + '.gz');
+                if (options.usePrecompiledGzip && gzFile && gzFile.buffer) {
+                    // if .gz file already read from disk
+                    file.zipBuffer = gzFile.buffer;
+                }
+                else {
+                    file.zipBuffer = await gzip(file.buffer);
+                }
+                ctx.set('content-encoding', 'gzip');
+                ctx.body = file.zipBuffer;
+            }
+            else {
+                ctx.body = file.buffer;
+            }
+            return;
+        }
+        const stream = createReadStream(file.path);
+        // update file hash
+        if (!file.md5) {
+            const hash = crypto.createHash('md5');
+            stream.on('data', hash.update.bind(hash));
+            stream.on('end', () => {
+                file.md5 = hash.digest('base64');
+            });
+        }
+        ctx.body = stream;
+        // enable gzip will remove content length
+        if (shouldGzip) {
+            ctx.remove('content-length');
+            ctx.set('content-encoding', 'gzip');
+            ctx.body = stream.pipe(zlib.createGzip());
+        }
+    };
+}
+/**
+ * load file and add file content to cache
+ */
+function loadFile(name, dir, options, fileManager) {
+    const pathname = path.normalize(path.join(options.prefix, name));
+    if (!fileManager.get(pathname)) {
+        fileManager.set(pathname, {});
+    }
+    const obj = fileManager.get(pathname);
+    const filename = obj.path = path.join(dir, name);
+    const stats = statSync(filename);
+    const buffer = readFileSync(filename);
+    obj.cacheControl = options.cacheControl;
+    obj.maxAge = obj.maxAge ? obj.maxAge : options.maxAge || 0;
+    obj.type = obj.mime = mime.lookup(pathname) || 'application/octet-stream';
+    obj.mtime = stats.mtime;
+    obj.length = stats.size;
+    obj.md5 = crypto.createHash('md5').update(buffer).digest('base64');
+    debug('file: %s', JSON.stringify(obj, null, 2));
+    if (options.buffer) {
+        obj.buffer = buffer;
+    }
+    return obj;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ2pDLE9BQU8sRUFBRSxRQUFRLEVBQUUsU0FBUyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBQ2hELE9BQU8sRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2xDLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxRQUFRLEVBQUUsWUFBWSxFQUFFLE1BQU0sU0FBUyxDQUFDO0FBQ25FLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQUM3QixPQUFPLElBQUksTUFBTSxXQUFXLENBQUM7QUFDN0IsT0FBTyxJQUFJLE1BQU0sWUFBWSxDQUFDO0FBQzlCLE9BQU8sWUFBWSxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLE9BQU8sTUFBTSxzQkFBc0IsQ0FBQztBQUMzQyxPQUFPLEVBQUUsTUFBTSxFQUFFLGtCQUFrQixJQUFJLHNCQUFzQixFQUFFLE1BQU0sU0FBUyxDQUFDO0FBRS9FLE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyx5QkFBeUIsQ0FBQyxDQUFDO0FBRWxELE1BQU0sSUFBSSxHQUFHLFNBQVMsQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7QUE2RmxDLE1BQU0sT0FBTyxXQUFXO0lBQ3RCLEtBQUssQ0FBYTtJQUNsQixHQUFHLENBQVc7SUFFZCxZQUFZLEtBQTJCO1FBQ3JDLElBQUksS0FBSyxJQUFJLE9BQU8sS0FBSyxDQUFDLEdBQUcsS0FBSyxVQUFVLElBQUksT0FBTyxLQUFLLENBQUMsR0FBRyxLQUFLLFVBQVUsRUFBRSxDQUFDO1lBQ2hGLElBQUksQ0FBQyxLQUFLLEdBQUcsS0FBa0IsQ0FBQztRQUNsQyxDQUFDO2FBQU0sQ0FBQztZQUNOLElBQUksQ0FBQyxHQUFHLEdBQUcsS0FBSyxJQUFJLE1BQU0sQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUM7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

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "@eggjs/koa-static-cache",
+  "version": "6.0.0"
+}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@eggjs/koa-static-cache",
+  "description": "Static cache middleware for koa",
+  "version": "6.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "koa",
+    "middleware",
+    "file",
+    "static",
+    "cache",
+    "gzip",
+    "sendfile"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eggjs/koa-static-cache.git"
+  },
+  "bugs": {
+    "url": "https://github.com/eggjs/koa-static-cache/issues"
+  },
+  "engines": {
+    "node": ">= 18.19.0"
+  },
+  "dependencies": {
+    "compressible": "^2.0.18",
+    "fs-readdir-recursive": "^1.1.0",
+    "mime-types": "^2.1.35",
+    "utility": "^2.4.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.17.1",
+    "@eggjs/bin": "7",
+    "@eggjs/koa": "^2.20.6",
+    "@eggjs/supertest": "^8.1.1",
+    "@eggjs/tsconfig": "1",
+    "@types/compressible": "^2.0.2",
+    "@types/fs-readdir-recursive": "^1.1.3",
+    "@types/mime-types": "^2.1.4",
+    "@types/mocha": "10",
+    "@types/node": "22",
+    "eslint": "8",
+    "eslint-config-egg": "14",
+    "rimraf": "6",
+    "tshy": "3",
+    "tshy-after": "1",
+    "typescript": "5",
+    "ylru": "^2.0.0"
+  },
+  "scripts": {
+    "lint": "eslint --cache src test --ext .ts",
+    "pretest": "npm run clean && npm run lint -- --fix",
+    "test": "egg-bin test",
+    "preci": "npm run clean &&  npm run lint",
+    "ci": "egg-bin cov",
+    "postci": "npm run prepublishOnly && npm run clean",
+    "clean": "rimraf dist",
+    "prepublishOnly": "tshy && tshy-after && attw --pack"
+  },
+  "type": "module",
+  "tshy": {
+    "exports": {
+      ".": "./src/index.ts",
+      "./package.json": "./package.json"
+    }
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "types": "./dist/commonjs/index.d.ts",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/esm/index.js"
+}

package/src/index.ts

@@ -0,0 +1,341 @@
+import crypto from 'node:crypto';
+import { debuglog, promisify } from 'node:util';
+import fs from 'node:fs/promises';
+import { createReadStream, statSync, readFileSync } from 'node:fs';
+import zlib from 'node:zlib';
+import path from 'node:path';
+import mime from 'mime-types';
+import compressible from 'compressible';
+import readDir from 'fs-readdir-recursive';
+import { exists, decodeURIComponent as safeDecodeURIComponent } from 'utility';
+
+const debug = debuglog('@eggjs/koa-static-cache');
+
+const gzip = promisify(zlib.gzip);
+
+export type FileFilter = (path: string) => boolean;
+
+export interface FileMeta {
+  maxAge?: number;
+  cacheControl?: string;
+  buffer?: Buffer;
+  zipBuffer?: Buffer;
+  type?: string;
+  mime?: string;
+  mtime?: Date;
+  path?: string;
+  md5?: string;
+  length?: number;
+}
+
+export interface FileMap {
+  [path: string]: FileMeta;
+}
+
+export interface FileStore {
+  get(key: string): unknown;
+  set(key: string, value: unknown): void;
+}
+
+export interface Options {
+  /**
+   * The root directory from which to serve static assets
+   * Default to `process.cwd`
+   */
+  dir?: string;
+  /**
+   * The max age for cache control
+   * Default to `0`
+   */
+  maxAge?: number;
+  /**
+   * The cache control header for static files
+   * Default to `undefined`
+   * Overrides `options.maxAge`
+   */
+  cacheControl?: string;
+  /**
+   * store the files in memory instead of streaming from the filesystem on each request
+   */
+  buffer?: boolean;
+  /**
+   * when request's accept-encoding include gzip, files will compressed by gzip
+   * Default to `false`
+   */
+  gzip?: boolean;
+  /**
+   * try use gzip files, loaded from disk, like nginx gzip_static
+   * Default to `false`
+   */
+  usePrecompiledGzip?: boolean;
+  /**
+   * object map of aliases
+   * Default to `{}`
+   */
+  alias?: Record<string, string>;
+  /**
+   * the url prefix you wish to add
+   * Default to `''`
+   */
+  prefix?: string;
+  /**
+   * filter files at init dir, for example - skip non build (source) files.
+   * If array set - allow only listed files
+   * Default to `undefined`
+   */
+  filter?: FileFilter | string[];
+  /**
+   * dynamic load file which not cached on initialization
+   * Default to `false
+   */
+  dynamic?: boolean;
+  /**
+   * caches the assets on initialization or not,
+   * always work together with `options.dynamic`
+   * Default to `true`
+   */
+  preload?: boolean;
+  /**
+   * file store for caching
+   * Default to `undefined`
+   */
+  files?: FileMap | FileStore;
+}
+
+type Next = () => Promise<void>;
+
+export class FileManager {
+  store?: FileStore;
+  map?: FileMap;
+
+  constructor(store?: FileStore | FileMap) {
+    if (store && typeof store.set === 'function' && typeof store.get === 'function') {
+      this.store = store as FileStore;
+    } else {
+      this.map = store || Object.create(null);
+    }
+  }
+
+  get(key: string) {
+    return this.store ? this.store.get(key) : this.map![key];
+  }
+
+  set(key: string, value: FileMeta) {
+    if (this.store) {
+      return this.store.set(key, value);
+    }
+    this.map![key] = value;
+  }
+}
+
+type MiddlewareFunc = (ctx: any, next: Next) => Promise<void> | void;
+
+export function staticCache(): MiddlewareFunc;
+export function staticCache(dir: string): MiddlewareFunc;
+export function staticCache(options: Options): MiddlewareFunc;
+export function staticCache(dir: string, options: Options): MiddlewareFunc;
+export function staticCache(dir: string, options: Options, files: FileMap | FileStore): MiddlewareFunc;
+export function staticCache(
+  dirOrOptions?: string | Options,
+  options: Options = {},
+  filesStoreOrMap?: FileMap | FileStore,
+): MiddlewareFunc {
+  let dir = '';
+  if (typeof dirOrOptions === 'string') {
+    // dir priority than options.dir
+    dir = dirOrOptions;
+  } else if (dirOrOptions) {
+    options = dirOrOptions;
+  }
+  if (!dir && options.dir) {
+    dir = options.dir;
+  }
+  if (!dir) {
+    // default to process.cwd
+    dir = process.cwd();
+  }
+  dir = path.normalize(dir);
+  debug('staticCache dir: %s', dir);
+
+  // prefix must be ASCII code
+  options.prefix = (options.prefix ?? '').replace(/\/*$/, '/');
+  const files = new FileManager(filesStoreOrMap ?? options.files);
+  const enableGzip = !!options.gzip;
+  const filePrefix = path.normalize(options.prefix.replace(/^\//, ''));
+
+  // option.filter
+  let fileFilter: FileFilter = () => { return true; };
+  if (Array.isArray(options.filter)) {
+    fileFilter = (file: string) => {
+      return (options.filter as string[]).includes(file);
+    };
+  }
+  if (typeof options.filter === 'function') {
+    fileFilter = options.filter;
+  }
+
+  if (options.preload !== false) {
+    readDir(dir).filter(fileFilter).forEach(name => {
+      loadFile(name, dir, options, files);
+    });
+  }
+
+  return async (ctx: any, next: Next) => {
+    // only accept HEAD and GET
+    if (ctx.method !== 'HEAD' && ctx.method !== 'GET') return await next();
+    // check prefix first to avoid calculate
+    if (!ctx.path.startsWith(options.prefix)) return await next();
+
+    // decode for `/%E4%B8%AD%E6%96%87`
+    // normalize for `//index`
+    let filename = path.normalize(safeDecodeURIComponent(ctx.path));
+
+    // check alias
+    if (options.alias && options.alias[filename]) {
+      filename = options.alias[filename];
+    }
+
+    let file = files.get(filename) as FileMeta;
+    // try to load file
+    if (!file) {
+      if (!options.dynamic) return await next();
+      if (path.basename(filename)[0] === '.') return await next();
+      if (filename.charAt(0) === path.sep) {
+        filename = filename.slice(1);
+      }
+
+      // trim prefix
+      if (options.prefix !== '/') {
+        if (filename.indexOf(filePrefix) !== 0) {
+          return await next();
+        }
+        filename = filename.slice(filePrefix.length);
+      }
+
+      const fullpath = path.join(dir, filename);
+      // files that can be accessed should be under options.dir
+      if (!fullpath.startsWith(dir)) {
+        return await next();
+      }
+
+      const stats = await exists(fullpath);
+      if (!stats) return await next();
+      if (!stats.isFile()) return await next();
+
+      file = loadFile(filename, dir, options, files);
+    }
+
+    ctx.status = 200;
+
+    if (enableGzip) ctx.vary('Accept-Encoding');
+
+    if (!file.buffer) {
+      const stats = await fs.stat(file.path!);
+      if (stats.mtime.getTime() !== file.mtime!.getTime()) {
+        file.mtime = stats.mtime;
+        file.md5 = undefined;
+        file.length = stats.size;
+      }
+    }
+
+    ctx.response.lastModified = file.mtime;
+    if (file.md5) {
+      ctx.response.etag = file.md5;
+    }
+
+    if (ctx.fresh) {
+      ctx.status = 304;
+      return;
+    }
+
+    ctx.type = file.type;
+    ctx.length = file.zipBuffer ? file.zipBuffer.length : file.length!;
+    ctx.set('cache-control', file.cacheControl ?? 'public, max-age=' + file.maxAge);
+    if (file.md5) ctx.set('content-md5', file.md5);
+
+    if (ctx.method === 'HEAD') {
+      return;
+    }
+
+    const acceptGzip = ctx.acceptsEncodings('gzip') === 'gzip';
+
+    if (file.zipBuffer) {
+      if (acceptGzip) {
+        ctx.set('content-encoding', 'gzip');
+        ctx.body = file.zipBuffer;
+      } else {
+        ctx.body = file.buffer;
+      }
+      return;
+    }
+
+    const shouldGzip = enableGzip
+      && file.length! > 1024
+      && acceptGzip
+      && compressible(file.type!);
+
+    if (file.buffer) {
+      if (shouldGzip) {
+
+        const gzFile = files.get(filename + '.gz') as FileMeta;
+        if (options.usePrecompiledGzip && gzFile && gzFile.buffer) {
+          // if .gz file already read from disk
+          file.zipBuffer = gzFile.buffer;
+        } else {
+          file.zipBuffer = await gzip(file.buffer);
+        }
+        ctx.set('content-encoding', 'gzip');
+        ctx.body = file.zipBuffer;
+      } else {
+        ctx.body = file.buffer;
+      }
+      return;
+    }
+
+    const stream = createReadStream(file.path!);
+
+    // update file hash
+    if (!file.md5) {
+      const hash = crypto.createHash('md5');
+      stream.on('data', hash.update.bind(hash));
+      stream.on('end', () => {
+        file.md5 = hash.digest('base64');
+      });
+    }
+
+    ctx.body = stream;
+    // enable gzip will remove content length
+    if (shouldGzip) {
+      ctx.remove('content-length');
+      ctx.set('content-encoding', 'gzip');
+      ctx.body = stream.pipe(zlib.createGzip());
+    }
+  };
+}
+
+/**
+ * load file and add file content to cache
+ */
+function loadFile(name: string, dir: string, options: Options, fileManager: FileManager) {
+  const pathname = path.normalize(path.join(options.prefix!, name));
+  if (!fileManager.get(pathname)) {
+    fileManager.set(pathname, {});
+  }
+  const obj = fileManager.get(pathname) as FileMeta;
+  const filename = obj.path = path.join(dir, name);
+  const stats = statSync(filename);
+  const buffer = readFileSync(filename);
+
+  obj.cacheControl = options.cacheControl;
+  obj.maxAge = obj.maxAge ? obj.maxAge : options.maxAge || 0;
+  obj.type = obj.mime = mime.lookup(pathname) || 'application/octet-stream';
+  obj.mtime = stats.mtime;
+  obj.length = stats.size;
+  obj.md5 = crypto.createHash('md5').update(buffer).digest('base64');
+
+  debug('file: %s', JSON.stringify(obj, null, 2));
+  if (options.buffer) {
+    obj.buffer = buffer;
+  }
+  return obj;
+}