@nexusts/static 0.7.2

package/README.md

@@ -0,0 +1,41 @@
+# @nexusts/static
+
+> **NexusTS** — Bun-native fullstack framework
+
+## Description
+
+Static file serving (ETag / Range / MIME).
+
+ETag, Range (HTTP 206), MIME detection, path-traversal protection. Serve assets from a directory.
+
+## Install
+
+This module is part of the NexusTS monorepo. Each module is published as its own npm package under the `@nexusts/` scope.
+
+Most apps start with just the core:
+
+```bash
+bun add @nexusts/core
+```
+
+Then add this module only if you need it:
+
+```bash
+bun add @nexusts/static
+```
+
+## Peer dependencies
+
+**None.** No external dependencies.
+
+## Usage
+
+```typescript
+import { /* public API */ } from "@nexusts/static";
+```
+
+See the [user guide](../../docs/user-guide/static.md) and the [example app](../../examples/) for a working demo.
+
+## License
+
+MIT — see the root [LICENSE](../../LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Public API for `nexusjs/static`.
+ *
+ * Quick start:
+ *
+ *   // src/app/app.module.ts
+ *   import { Module } from 'nexusjs';
+ *   import { StaticModule } from 'nexusjs/static';
+ *
+ *   @Module({
+ *     imports: [
+ *       StaticModule.forRoot({
+ *         root: './public',
+ *         prefix: '/public',
+ *       }),
+ *     ],
+ *   })
+ *   export class AppModule {}
+ *
+ *   // any service that needs to mount the middleware on a sub-app
+ *   import { StaticService } from 'nexusjs/static';
+ *
+ *   @Injectable()
+ *   class CustomServer {
+ *     constructor(@Inject(StaticService.TOKEN) private static: StaticService) {}
+ *     mount(app: Hono) {
+ *       app.use('/public/*', this.static.middleware());
+ *     }
+ *   }
+ *
+ * Features:
+ *   - Path-traversal protection (no `..`, no absolute paths)
+ *   - ETag-based conditional GET (304 Not Modified)
+ *   - Range requests (HTTP 206) for video / large files
+ *   - Sensible `Cache-Control` defaults
+ *   - `index.html` fallback for directory requests
+ *   - MIME-type inference for common formats
+ */
+export { StaticService, type ServeStaticOptions } from "./static.service.js";
+export { StaticModule } from "./static.module.js";

package/dist/index.js

@@ -0,0 +1,218 @@
+// @bun
+var __legacyDecorateClassTS = function(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1;i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+
+// packages/static/src/static.service.ts
+import { createReadStream } from "fs";
+import { stat, open } from "fs/promises";
+import { resolve as pathResolve, normalize, join, sep } from "path";
+
+class StaticService {
+  static TOKEN = Symbol.for("nexus:StaticService");
+  #root;
+  #prefix;
+  #index;
+  #cacheControl;
+  #etag;
+  #range;
+  #maxFileSize;
+  constructor(options = {}) {
+    this.#root = pathResolve(options.root ?? "./public");
+    const prefix = options.prefix ?? "/";
+    this.#prefix = prefix === "/" ? "/" : prefix.replace(/\/$/, "");
+    this.#index = options.index === false ? false : options.index ?? "index.html";
+    this.#cacheControl = options.cacheControl ?? "public, max-age=3600";
+    this.#etag = options.etag ?? true;
+    this.#range = options.range ?? true;
+    this.#maxFileSize = options.maxFileSize ?? 100 * 1024 * 1024;
+  }
+  middleware() {
+    return async (c, next) => {
+      const url = new URL(c.req.url);
+      const pathname = decodeURIComponent(url.pathname);
+      if (!pathname.startsWith(this.#prefix)) {
+        return next();
+      }
+      const rel = pathname.slice(this.#prefix.length).replace(/^\//, "");
+      const safe = this.#safeResolve(rel);
+      if (!safe)
+        return next();
+      let statResult;
+      try {
+        statResult = await stat(safe);
+      } catch {
+        return next();
+      }
+      let filePath = safe;
+      if (statResult.isDirectory()) {
+        if (this.#index === false)
+          return next();
+        filePath = join(safe, this.#index);
+        try {
+          const idx = await stat(filePath);
+          if (!idx.isFile())
+            return next();
+        } catch {
+          return next();
+        }
+      }
+      let fileStat;
+      try {
+        fileStat = await stat(filePath);
+      } catch {
+        return next();
+      }
+      const size = fileStat.size;
+      if (size > this.#maxFileSize)
+        return next();
+      const etag = this.#etag ? `"${this.#computeEtag(filePath, size, fileStat.mtimeMs)}"` : null;
+      if (etag) {
+        const inm = c.req.header("if-none-match");
+        if (inm && inm === etag) {
+          return new Response(null, { status: 304 });
+        }
+        c.header("ETag", etag);
+      }
+      const range = c.req.header("range");
+      if (this.#range && range) {
+        const m = /^bytes=(\d*)-(\d*)$/.exec(range);
+        if (m) {
+          const start = m[1] ? Number(m[1]) : 0;
+          const end = m[2] ? Number(m[2]) : size - 1;
+          if (start >= size || end >= size || start > end) {
+            return new Response("Range Not Satisfiable", {
+              status: 416,
+              headers: { "Content-Range": `bytes */${size}` }
+            });
+          }
+          const slice = await this.#readSlice(filePath, start, end);
+          return new Response(slice, {
+            status: 206,
+            headers: {
+              "Content-Type": this.#mime(filePath),
+              "Content-Length": String(end - start + 1),
+              "Content-Range": `bytes ${start}-${end}/${size}`,
+              "Cache-Control": this.#cacheControl,
+              "Accept-Ranges": "bytes"
+            }
+          });
+        }
+      }
+      const body = createReadStream(filePath);
+      return new Response(body, {
+        status: 200,
+        headers: {
+          "Content-Type": this.#mime(filePath),
+          "Content-Length": String(size),
+          "Cache-Control": this.#cacheControl,
+          "Accept-Ranges": "bytes",
+          ...etag ? { ETag: etag } : {}
+        }
+      });
+    };
+  }
+  #safeResolve(rel) {
+    if (rel.includes(".."))
+      return null;
+    if (rel.startsWith("/") || /^[a-zA-Z]:/.test(rel))
+      return null;
+    const joined = join(this.#root, rel);
+    const norm = normalize(joined);
+    if (!norm.startsWith(this.#root + sep) && norm !== this.#root)
+      return null;
+    return norm;
+  }
+  #computeEtag(_path, size, mtimeMs) {
+    const bucket = Math.floor(mtimeMs / 1000);
+    const hash = `${size}-${bucket}`;
+    return Buffer.from(hash).toString("base64url");
+  }
+  async#readSlice(path, start, end) {
+    const fh = await open(path, "r");
+    try {
+      const length = end - start + 1;
+      const buf = Buffer.alloc(length);
+      await fh.read(buf, 0, length, start);
+      return buf;
+    } finally {
+      await fh.close();
+    }
+  }
+  #mime(path) {
+    const ext = path.slice(path.lastIndexOf(".") + 1).toLowerCase();
+    const map = {
+      html: "text/html; charset=utf-8",
+      htm: "text/html; charset=utf-8",
+      css: "text/css; charset=utf-8",
+      js: "application/javascript; charset=utf-8",
+      mjs: "application/javascript; charset=utf-8",
+      json: "application/json; charset=utf-8",
+      svg: "image/svg+xml",
+      png: "image/png",
+      jpeg: "image/jpeg",
+      jpg: "image/jpeg",
+      gif: "image/gif",
+      webp: "image/webp",
+      ico: "image/x-icon",
+      pdf: "application/pdf",
+      txt: "text/plain; charset=utf-8",
+      woff: "font/woff",
+      woff2: "font/woff2",
+      mp4: "video/mp4",
+      webm: "video/webm",
+      mp3: "audio/mpeg"
+    };
+    return map[ext] ?? "application/octet-stream";
+  }
+}
+// packages/static/src/static.module.ts
+import"reflect-metadata";
+import { Module } from "@nexusts/core";
+class StaticModule {
+  static forRoot(options = {}) {
+    class ConfiguredStaticModule {
+    }
+    ConfiguredStaticModule = __legacyDecorateClassTS([
+      Module({
+        providers: [
+          StaticService,
+          { provide: StaticService.TOKEN, useExisting: StaticService },
+          { provide: "STATIC_OPTIONS", useValue: options }
+        ],
+        exports: [StaticService, StaticService.TOKEN]
+      })
+    ], ConfiguredStaticModule);
+    Object.defineProperty(ConfiguredStaticModule, "name", {
+      value: "ConfiguredStaticModule"
+    });
+    return ConfiguredStaticModule;
+  }
+  static mount(options = {}) {
+    const svc = new StaticService(options);
+    return svc.middleware();
+  }
+}
+StaticModule = __legacyDecorateClassTS([
+  Module({
+    providers: [
+      StaticService,
+      { provide: StaticService.TOKEN, useExisting: StaticService }
+    ],
+    exports: [StaticService, StaticService.TOKEN]
+  })
+], StaticModule);
+export {
+  StaticService,
+  StaticModule
+};
+
+//# debugId=D088EA1AD2A5EE3164756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/static.service.ts", "../src/static.module.ts"],
+  "sourcesContent": [
+    "/**\n * Static file serving — middleware + helpers.\n *\n * Mirrors `@adonisjs/static` + `serve-static`. Built on the platform's\n * native filesystem (Bun.file() on Bun, node:fs elsewhere).\n */\n\nimport type { Context, MiddlewareHandler } from \"hono\";\nimport { createReadStream } from \"node:fs\";\nimport { stat, open } from \"node:fs/promises\";\nimport { resolve as pathResolve, normalize, join, sep } from \"node:path\";\n\n/** Configuration for `serveStatic`. */\nexport interface ServeStaticOptions {\n\t/** Filesystem root to serve files from. Default: `./public`. */\n\troot?: string;\n\t/** URL prefix. Default: `/`. */\n\tprefix?: string;\n\t/** Default file when a directory is requested. Default: `index.html`. */\n\tindex?: string | false;\n\t/** `Cache-Control` header. Default: `'public, max-age=3600'`. */\n\tcacheControl?: string;\n\t/** Enable ETag generation. Default: `true`. */\n\tetag?: boolean;\n\t/** Enable range requests (for video / large files). Default: `true`. */\n\trange?: boolean;\n\t/** Max file size in bytes; larger files return 404. Default: 100 MB. */\n\tmaxFileSize?: number;\n}\n\n/** StaticService — emits the `serveStatic` middleware. */\nexport class StaticService {\n\t/** DI token — use with `@Inject(StaticService.TOKEN)`. */\n\tstatic readonly TOKEN = Symbol.for(\"nexus:StaticService\");\n\n\t#root: string;\n\t#prefix: string;\n\t#index: string | false;\n\t#cacheControl: string;\n\t#etag: boolean;\n\t#range: boolean;\n\t#maxFileSize: number;\n\n\tconstructor(options: ServeStaticOptions = {}) {\n\t\tthis.#root = pathResolve(options.root ?? \"./public\");\n\t\t// Normalize prefix to always start with `/` and end without `/` (except root).\n\t\tconst prefix = options.prefix ?? \"/\";\n\t\tthis.#prefix = prefix === \"/\" ? \"/\" : prefix.replace(/\\/$/, \"\");\n\t\tthis.#index =\n\t\t\toptions.index === false ? false : (options.index ?? \"index.html\");\n\t\tthis.#cacheControl = options.cacheControl ?? \"public, max-age=3600\";\n\t\tthis.#etag = options.etag ?? true;\n\t\tthis.#range = options.range ?? true;\n\t\tthis.#maxFileSize = options.maxFileSize ?? 100 * 1024 * 1024;\n\t}\n\n\t/**\n\t * Build a Hono middleware that serves files from `root`.\n\t *\n\t *   app.use('/public/*', staticService.middleware());\n\t */\n\tmiddleware(): MiddlewareHandler {\n\t\treturn async (c, next) => {\n\t\t\tconst url = new URL(c.req.url);\n\t\t\tconst pathname = decodeURIComponent(url.pathname);\n\t\t\tif (!pathname.startsWith(this.#prefix)) {\n\t\t\t\treturn next();\n\t\t\t}\n\t\t\t// pathname e.g. \"/static/test.html\", prefix e.g. \"/static\"\n\t\t\t// → slice gives \"/test.html\". Strip leading \"/\" so\n\t\t\t// #safeResolve doesn't reject it as an absolute path.\n\t\t\tconst rel = pathname.slice(this.#prefix.length).replace(/^\\//, \"\");\n\t\t\tconst safe = this.#safeResolve(rel);\n\t\t\tif (!safe) return next();\n\n\t\t\tlet statResult: Awaited<ReturnType<typeof stat>>;\n\t\t\ttry {\n\t\t\t\tstatResult = await stat(safe);\n\t\t\t} catch {\n\t\t\t\treturn next();\n\t\t\t}\n\n\t\t\tlet filePath = safe;\n\t\t\tif (statResult.isDirectory()) {\n\t\t\t\tif (this.#index === false) return next();\n\t\t\t\tfilePath = join(safe, this.#index);\n\t\t\t\ttry {\n\t\t\t\t\tconst idx = await stat(filePath);\n\t\t\t\t\tif (!idx.isFile()) return next();\n\t\t\t\t} catch {\n\t\t\t\t\treturn next();\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Size guard.\n\t\t\tlet fileStat: Awaited<ReturnType<typeof stat>>;\n\t\t\ttry {\n\t\t\t\tfileStat = await stat(filePath);\n\t\t\t} catch {\n\t\t\t\treturn next();\n\t\t\t}\n\t\t\tconst size = fileStat.size;\n\t\t\tif (size > this.#maxFileSize) return next();\n\n\t\t\t// ETag.\n\t\t\tconst etag = this.#etag\n\t\t\t\t? `\"${this.#computeEtag(filePath, size, fileStat.mtimeMs)}\"`\n\t\t\t\t: null;\n\t\t\tif (etag) {\n\t\t\t\tconst inm = c.req.header(\"if-none-match\");\n\t\t\t\tif (inm && inm === etag) {\n\t\t\t\t\treturn new Response(null, { status: 304 });\n\t\t\t\t}\n\t\t\t\tc.header(\"ETag\", etag);\n\t\t\t}\n\n\t\t\t// Range requests.\n\t\t\tconst range = c.req.header(\"range\");\n\t\t\tif (this.#range && range) {\n\t\t\t\tconst m = /^bytes=(\\d*)-(\\d*)$/.exec(range);\n\t\t\t\tif (m) {\n\t\t\t\t\tconst start = m[1] ? Number(m[1]) : 0;\n\t\t\t\t\tconst end = m[2] ? Number(m[2]) : size - 1;\n\t\t\t\t\tif (start >= size || end >= size || start > end) {\n\t\t\t\t\t\treturn new Response(\"Range Not Satisfiable\", {\n\t\t\t\t\t\t\tstatus: 416,\n\t\t\t\t\t\t\theaders: { \"Content-Range\": `bytes */${size}` },\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t\tconst slice = await this.#readSlice(filePath, start, end);\n\t\t\t\t\treturn new Response(slice as BodyInit, {\n\t\t\t\t\t\tstatus: 206,\n\t\t\t\t\t\theaders: {\n\t\t\t\t\t\t\t\"Content-Type\": this.#mime(filePath),\n\t\t\t\t\t\t\t\"Content-Length\": String(end - start + 1),\n\t\t\t\t\t\t\t\"Content-Range\": `bytes ${start}-${end}/${size}`,\n\t\t\t\t\t\t\t\"Cache-Control\": this.#cacheControl,\n\t\t\t\t\t\t\t\"Accept-Ranges\": \"bytes\",\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// Full body.\n\t\t\tconst body = createReadStream(filePath);\n\t\t\treturn new Response(body as unknown as ReadableStream, {\n\t\t\t\tstatus: 200,\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": this.#mime(filePath),\n\t\t\t\t\t\"Content-Length\": String(size),\n\t\t\t\t\t\"Cache-Control\": this.#cacheControl,\n\t\t\t\t\t\"Accept-Ranges\": \"bytes\",\n\t\t\t\t\t...(etag ? { ETag: etag } : {}),\n\t\t\t\t},\n\t\t\t});\n\t\t};\n\t}\n\n\t// ===========================================================================\n\t// Internal\n\t// ===========================================================================\n\n\t#safeResolve(rel: string): string | null {\n\t\t// Reject path traversal: no `..`, no absolute paths, no drive letters.\n\t\tif (rel.includes(\"..\")) return null;\n\t\tif (rel.startsWith(\"/\") || /^[a-zA-Z]:/.test(rel)) return null;\n\t\tconst joined = join(this.#root, rel);\n\t\tconst norm = normalize(joined);\n\t\t// Make sure the result is still under `root`.\n\t\tif (!norm.startsWith(this.#root + sep) && norm !== this.#root) return null;\n\t\treturn norm;\n\t}\n\n\t#computeEtag(_path: string, size: number, mtimeMs: number): string {\n\t\t// Simple hash: size + mtime bucket.\n\t\tconst bucket = Math.floor(mtimeMs / 1000);\n\t\tconst hash = `${size}-${bucket}`;\n\t\treturn Buffer.from(hash).toString(\"base64url\");\n\t}\n\n\tasync #readSlice(path: string, start: number, end: number): Promise<Buffer> {\n\t\tconst fh = await open(path, \"r\");\n\t\ttry {\n\t\t\tconst length = end - start + 1;\n\t\t\tconst buf = Buffer.alloc(length);\n\t\t\tawait fh.read(buf, 0, length, start);\n\t\t\treturn buf;\n\t\t} finally {\n\t\t\tawait fh.close();\n\t\t}\n\t}\n\n\t#mime(path: string): string {\n\t\tconst ext = path.slice(path.lastIndexOf(\".\") + 1).toLowerCase();\n\t\tconst map: Record<string, string> = {\n\t\t\thtml: \"text/html; charset=utf-8\",\n\t\t\thtm: \"text/html; charset=utf-8\",\n\t\t\tcss: \"text/css; charset=utf-8\",\n\t\t\tjs: \"application/javascript; charset=utf-8\",\n\t\t\tmjs: \"application/javascript; charset=utf-8\",\n\t\t\tjson: \"application/json; charset=utf-8\",\n\t\t\tsvg: \"image/svg+xml\",\n\t\t\tpng: \"image/png\",\n\t\t\tjpeg: \"image/jpeg\",\n\t\t\tjpg: \"image/jpeg\",\n\t\t\tgif: \"image/gif\",\n\t\t\twebp: \"image/webp\",\n\t\t\tico: \"image/x-icon\",\n\t\t\tpdf: \"application/pdf\",\n\t\t\ttxt: \"text/plain; charset=utf-8\",\n\t\t\twoff: \"font/woff\",\n\t\t\twoff2: \"font/woff2\",\n\t\t\tmp4: \"video/mp4\",\n\t\t\twebm: \"video/webm\",\n\t\t\tmp3: \"audio/mpeg\",\n\t\t};\n\t\treturn map[ext] ?? \"application/octet-stream\";\n\t}\n}\n",
+    "/**\n * `StaticModule` — drop-in module for static file serving.\n *\n * Usage:\n *   @Module({\n *     imports: [\n *       StaticModule.forRoot({\n *         root: './public',\n *         prefix: '/public',\n *         cacheControl: 'public, max-age=86400',\n *       }),\n *     ],\n *   })\n *   export class AppModule {}\n *\n * Then `GET /public/*` serves files from `./public/*` with proper\n * Content-Type, ETag, and Range support.\n */\n\nimport \"reflect-metadata\";\nimport { Module } from \"@nexusts/core\";\nimport { StaticService } from \"./static.service.js\";\nimport type { ServeStaticOptions } from \"./static.service.js\";\n\n@Module({\n\tproviders: [\n\t\tStaticService,\n\t\t{ provide: StaticService.TOKEN, useExisting: StaticService },\n\t],\n\texports: [StaticService, StaticService.TOKEN],\n})\nexport class StaticModule {\n\tstatic forRoot(options: ServeStaticOptions = {}) {\n\t\t@Module({\n\t\t\tproviders: [\n\t\t\t\tStaticService,\n\t\t\t\t{ provide: StaticService.TOKEN, useExisting: StaticService },\n\t\t\t\t{ provide: \"STATIC_OPTIONS\", useValue: options },\n\t\t\t],\n\t\t\texports: [StaticService, StaticService.TOKEN],\n\t\t})\n\t\tclass ConfiguredStaticModule {}\n\n\t\tObject.defineProperty(ConfiguredStaticModule, \"name\", {\n\t\t\tvalue: \"ConfiguredStaticModule\",\n\t\t});\n\n\t\treturn ConfiguredStaticModule;\n\t}\n\n\t/**\n\t * Convenience: create a middleware handler and mount it directly\n\t * on the Hono app. Useful in `main.ts` to serve static files\n\t * without going through DI.\n\t *\n\t * ```ts\n\t * import { StaticModule } from 'nexusjs/static';\n\t * const app = new Application(AppModule);\n\t * app.server.app.use('/static/*', StaticModule.mount({\n\t *   root: './public',\n\t *   prefix: '/static',\n\t * }));\n\t * ```\n\t */\n\tstatic mount(options: ServeStaticOptions = {}) {\n\t\tconst svc = new StaticService(options);\n\t\treturn svc.middleware();\n\t}\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "D088EA1AD2A5EE3164756E2164756E21",
+  "names": []
+}

package/dist/static.module.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `StaticModule` — drop-in module for static file serving.
+ *
+ * Usage:
+ *   @Module({
+ *     imports: [
+ *       StaticModule.forRoot({
+ *         root: './public',
+ *         prefix: '/public',
+ *         cacheControl: 'public, max-age=86400',
+ *       }),
+ *     ],
+ *   })
+ *   export class AppModule {}
+ *
+ * Then `GET /public/*` serves files from `./public/*` with proper
+ * Content-Type, ETag, and Range support.
+ */
+import "reflect-metadata";
+import type { ServeStaticOptions } from "./static.service.js";
+export declare class StaticModule {
+    static forRoot(options?: ServeStaticOptions): {
+        new (): {};
+    };
+    /**
+     * Convenience: create a middleware handler and mount it directly
+     * on the Hono app. Useful in `main.ts` to serve static files
+     * without going through DI.
+     *
+     * ```ts
+     * import { StaticModule } from 'nexusjs/static';
+     * const app = new Application(AppModule);
+     * app.server.app.use('/static/*', StaticModule.mount({
+     *   root: './public',
+     *   prefix: '/static',
+     * }));
+     * ```
+     */
+    static mount(options?: ServeStaticOptions): import("hono").MiddlewareHandler;
+}

package/dist/static.service.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Static file serving — middleware + helpers.
+ *
+ * Mirrors `@adonisjs/static` + `serve-static`. Built on the platform's
+ * native filesystem (Bun.file() on Bun, node:fs elsewhere).
+ */
+import type { MiddlewareHandler } from "hono";
+/** Configuration for `serveStatic`. */
+export interface ServeStaticOptions {
+    /** Filesystem root to serve files from. Default: `./public`. */
+    root?: string;
+    /** URL prefix. Default: `/`. */
+    prefix?: string;
+    /** Default file when a directory is requested. Default: `index.html`. */
+    index?: string | false;
+    /** `Cache-Control` header. Default: `'public, max-age=3600'`. */
+    cacheControl?: string;
+    /** Enable ETag generation. Default: `true`. */
+    etag?: boolean;
+    /** Enable range requests (for video / large files). Default: `true`. */
+    range?: boolean;
+    /** Max file size in bytes; larger files return 404. Default: 100 MB. */
+    maxFileSize?: number;
+}
+/** StaticService — emits the `serveStatic` middleware. */
+export declare class StaticService {
+    #private;
+    /** DI token — use with `@Inject(StaticService.TOKEN)`. */
+    static readonly TOKEN: unique symbol;
+    constructor(options?: ServeStaticOptions);
+    /**
+     * Build a Hono middleware that serves files from `root`.
+     *
+     *   app.use('/public/*', staticService.middleware());
+     */
+    middleware(): MiddlewareHandler;
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@nexusts/static",
+  "version": "0.7.2",
+  "description": "Static file serving (ETag / Range / MIME)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "bun run ../../build.ts"
+  },
+  "keywords": ["nexusts", "framework", "bun"],
+  "license": "MIT",
+  
+  
+  "dependencies": {
+    "@nexusts/core": "file:../core"
+  }
+}