@kabyeon/nexusjs 0.6.5

package/dist/sse/sse.d.ts

@@ -0,0 +1,24 @@
+import type { SseStreamController } from "./types.js";
+/**
+ * The `sse()` helper.
+ *
+ * @param c  Hono context. Pass via `@Req()` in a controller.
+ * @param handler  Callback that pushes events onto the stream.
+ * @returns A `Response` with `text/event-stream` content type.
+ */
+export declare function sse(c: any, handler: (stream: SseStreamController) => void | Promise<void>): Response;
+/**
+ * `sseJson()` — convenience alias for `sse()`. Object payloads are
+ * auto-JSON-stringified in either form.
+ */
+export declare const sseJson: typeof sse;
+/**
+ * Extract the `Last-Event-ID` header from a Hono context. Returns
+ * `null` if the header is missing.
+ */
+export declare function getLastEventId(c: {
+    req: {
+        header(name: string): string | undefined;
+    };
+}): string | null;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/sse/sse.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,GAAG,CAClB,CAAC,EAAE,GAAG,EACN,OAAO,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC5D,QAAQ,CAaV;AAED;;;GAGG;AACH,eAAO,MAAM,OAAO,YAAM,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE;IAAE,GAAG,EAAE;QAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAGtG"}

package/dist/sse/types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * `nexusjs/sse` — Server-Sent Events.
+ *
+ *   @Get('/events')
+ *   events() {
+ *     return sse((stream) => {
+ *       const id = setInterval(() => {
+ *         stream.send({ event: 'tick', data: Date.now() });
+ *       }, 1000);
+ *       stream.onClose(() => clearInterval(id));
+ *     });
+ *   }
+ *
+ *   // Or with reconnection support:
+ *   @Get('/events')
+ *   events(@LastEventId() lastId: string | null) {
+ *     return sse(async (stream) => {
+ *       // Replay events with id > lastId (if you have them).
+ *       // Then continue with the live stream.
+ *     });
+ *   }
+ *
+ * Features:
+ *   - Type-safe event payloads
+ *   - Auto-cleanup on client disconnect
+ *   - Last-Event-ID support for reconnection
+ *   - JSON helpers (auto-stringify objects)
+ *   - `retry:` hint to control client reconnect timing
+ */
+import "reflect-metadata";
+import { METADATA_KEY } from "../core/constants.js";
+/**
+ * A single SSE event. The shape mirrors the wire format:
+ *
+ *   - `id`    — event id (used for `Last-Event-ID` reconnection)
+ *   - `event` — event name (client subscribes via EventSource.addEventListener)
+ *   - `data`  — payload (string, object, or number)
+ *   - `retry` — reconnect delay in ms (sent as `retry: <ms>`)
+ *
+ * `data` accepts anything JSON-serializable. Objects are auto-stringified
+ * via `JSON.stringify`. Strings are sent verbatim (one `data:` line per
+ * newline).
+ */
+export interface SseEvent<T = unknown> {
+    id?: string | number;
+    event?: string;
+    data: T;
+    /** Reconnect delay (ms) hint. */
+    retry?: number;
+}
+/**
+ * Per-stream controller. Returned to the `sse()` callback.
+ *
+ *   const stream = new SseStream(api);
+ *   stream.send({ data: 'hello' });                // data-only event
+ *   stream.send({ event: 'tick', data: { x: 1 } });
+ *   stream.close();
+ */
+export interface SseStreamController {
+    /** Push an event. Safe to call after `close()` (no-op). */
+    send<T = unknown>(event: SseEvent<T> | string): void;
+    /** Close the stream. Idempotent. Awaits pending writes. */
+    close(): void | Promise<void>;
+    /** True after `close()` has been called. */
+    get closed(): boolean;
+    /** Register a callback to run on client disconnect (or `close()`). */
+    onClose(cb: () => void): void;
+    /** Sleep for `ms` milliseconds (preserves the connection). */
+    sleep(ms: number): Promise<void>;
+}
+/** Marks a controller method as an SSE endpoint. OpenAPI hint. */
+export declare function SseEventMeta(options?: {
+    name?: string;
+    description?: string;
+}): MethodDecorator;
+/**
+ * `@LastEventId()` — inject the `Last-Event-ID` header from the
+ * client's reconnect attempt. `null` if the header is missing.
+ */
+export declare function LastEventId(): ParameterDecorator;
+export declare const SSE_META = "nexus:sse:event";
+export declare const SSE_LAST_EVENT_ID_META = "nexus:sse:lastEventId";
+export { METADATA_KEY };
+//# sourceMappingURL=types.d.ts.map

package/dist/sse/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sse/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAMpD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,OAAO;IACpC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;IACR,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IACnC,2DAA2D;IAC3D,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACrD,2DAA2D;IAC3D,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,4CAA4C;IAC5C,IAAI,MAAM,IAAI,OAAO,CAAC;IACtB,sEAAsE;IACtE,OAAO,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC9B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAMD,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,eAAe,CASnG;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,kBAAkB,CAQhD;AAED,eAAO,MAAM,QAAQ,oBAAoB,CAAC;AAC1C,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/static/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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";
+//# sourceMappingURL=index.d.ts.map

package/dist/static/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/static/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/static/index.js

@@ -0,0 +1,313 @@
+// @bun
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+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;
+};
+var __legacyDecorateParamTS = (index, decorator) => (target, key) => decorator(target, key, index);
+var __legacyMetadataTS = (k, v) => {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+    return Reflect.metadata(k, v);
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/core/constants.ts
+var METADATA_KEY, PARAM_TYPES, HTTP_METHODS;
+var init_constants = __esm(() => {
+  METADATA_KEY = {
+    CONTROLLER: "nexus:controller",
+    INJECTABLE: "nexus:injectable",
+    REPOSITORY: "nexus:repository",
+    MODULE: "nexus:module",
+    ROUTES: "nexus:routes",
+    PARAMS: "nexus:params",
+    VALIDATE: "nexus:validate",
+    PARAMTYPES: "design:paramtypes",
+    TYPE: "design:type",
+    RETURNTYPE: "design:returntype",
+    INJECT: "nexus:inject"
+  };
+  PARAM_TYPES = {
+    REQUEST: 0,
+    RESPONSE: 1,
+    NEXT: 2,
+    BODY: 3,
+    QUERY: 4,
+    PARAM: 5,
+    HEADERS: 6,
+    CTX: 7,
+    USER: 8
+  };
+  HTTP_METHODS = [
+    "GET",
+    "POST",
+    "PUT",
+    "DELETE",
+    "PATCH",
+    "OPTIONS",
+    "HEAD"
+  ];
+});
+
+// src/static/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";
+  }
+}
+// src/static/static.module.ts
+import"reflect-metadata";
+
+// src/core/decorators/module.ts
+init_constants();
+import"reflect-metadata";
+function Module(options = {}) {
+  return (target) => {
+    Reflect.defineMetadata(METADATA_KEY.MODULE, options, target);
+  };
+}
+function getModuleOptions(target) {
+  return Reflect.getMetadata(METADATA_KEY.MODULE, target) ?? {};
+}
+
+// src/static/static.module.ts
+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=C32AAEEE9103D3BF64756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/static/index.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/core/constants.ts", "../src/static/static.service.ts", "../src/static/static.module.ts", "../src/core/decorators/module.ts"],
+  "sourcesContent": [
+    "/**\n * Metadata keys used by reflect-metadata for storing decorator data.\n *\n * These constants are the contract between decorators and the framework\n * core (DI container, router, validator).\n */\nexport const METADATA_KEY = {\n\t/** Marks a class as a Nest-style controller, stores route prefix. */\n\tCONTROLLER: \"nexus:controller\",\n\n\t/** Marks a class as an injectable provider. */\n\tINJECTABLE: \"nexus:injectable\",\n\n\t/** Marks a class as a repository. */\n\tREPOSITORY: \"nexus:repository\",\n\n\t/** Marks a class as a module. Stores module options. */\n\tMODULE: \"nexus:module\",\n\n\t/** HTTP method routes registered on a controller (Get/Post/...). */\n\tROUTES: \"nexus:routes\",\n\n\t/** Method parameter type metadata (body/query/param/headers/ctx). */\n\tPARAMS: \"nexus:params\",\n\n\t/** Validation schema per method (Zod schema or class). */\n\tVALIDATE: \"nexus:validate\",\n\n\t/** Class-level design:paramtypes (built-in). */\n\tPARAMTYPES: \"design:paramtypes\",\n\n\t/** Class-level design:type (built-in). */\n\tTYPE: \"design:type\",\n\n\t/** Class-level design:returntype (built-in). */\n\tRETURNTYPE: \"design:returntype\",\n\n\t/** Provider token to inject for a parameter (for custom tokens). */\n\tINJECT: \"nexus:inject\",\n} as const;\n\nexport type MetadataKey = (typeof METADATA_KEY)[keyof typeof METADATA_KEY];\n\n/** Available parameter decorator locations. */\nexport const PARAM_TYPES = {\n\tREQUEST: 0,\n\tRESPONSE: 1,\n\tNEXT: 2,\n\tBODY: 3,\n\tQUERY: 4,\n\tPARAM: 5,\n\tHEADERS: 6,\n\tCTX: 7,\n\tUSER: 8,\n} as const;\n\nexport type ParamType = (typeof PARAM_TYPES)[keyof typeof PARAM_TYPES];\n\n/** HTTP methods supported by the router. */\nexport const HTTP_METHODS = [\n\t\"GET\",\n\t\"POST\",\n\t\"PUT\",\n\t\"DELETE\",\n\t\"PATCH\",\n\t\"OPTIONS\",\n\t\"HEAD\",\n] as const;\nexport type HttpMethod = (typeof HTTP_METHODS)[number];\n",
+    "/**\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 \"../core/decorators/module.js\";\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",
+    "/**\n * @Module decorator.\n *\n * Marks a class as a Nest-style module: a logical grouping of\n * controllers and providers with explicit imports/exports.\n *\n * @example\n * ```ts\n * @Module({\n *   imports: [UserModule],\n *   controllers: [UserController],\n *   providers: [UserService],\n *   exports: [UserService],\n * })\n * class AppModule {}\n * ```\n */\nimport \"reflect-metadata\";\nimport { METADATA_KEY } from \"../constants.js\";\nimport type { ModuleOptions, Type } from \"../di/tokens.js\";\n\nexport function Module(options: ModuleOptions = {}): ClassDecorator {\n\treturn (target: object) => {\n\t\tReflect.defineMetadata(METADATA_KEY.MODULE, options, target);\n\t};\n}\n\n/** Read the @Module options from a class. */\nexport function getModuleOptions(target: Type<any>): ModuleOptions {\n\treturn Reflect.getMetadata(METADATA_KEY.MODULE, target) ?? {};\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "C32AAEEE9103D3BF64756E2164756E21",
+  "names": []
+}

package/dist/static/static.module.d.ts

@@ -0,0 +1,41 @@
+/**
+ * `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;
+}
+//# sourceMappingURL=static.module.d.ts.map

package/dist/static/static.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.module.d.ts","sourceRoot":"","sources":["../../src/static/static.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,qBAOa,YAAY;IACxB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,kBAAuB;;;IAkB/C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,GAAE,kBAAuB;CAI7C"}

package/dist/static/static.service.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=static.service.d.ts.map

package/dist/static/static.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.service.d.ts","sourceRoot":"","sources":["../../src/static/static.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAKvD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IAClC,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0DAA0D;AAC1D,qBAAa,aAAa;;IACzB,0DAA0D;IAC1D,MAAM,CAAC,QAAQ,CAAC,KAAK,gBAAqC;gBAU9C,OAAO,GAAE,kBAAuB;IAa5C;;;;OAIG;IACH,UAAU,IAAI,iBAAiB;CA6J/B"}

package/dist/tracing/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export { Trace, getTraceOptions, type TraceOptions } from "./trace.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tracing/decorators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tracing/decorators/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/tracing/decorators/trace.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `@Trace()` — class-method decorator that wraps the call in a span.
+ *
+ * Usage:
+ *   class UserService {
+ *     @Trace()                  // span name = class.method
+ *     async findById(id: string) { ... }
+ *
+ *     @Trace("user.lookup")     // explicit span name
+ *     async lookup(name: string) { ... }
+ *
+ *     @Trace({ name: "user.cache.get", attributes: { cache: "lru" } })
+ *     async getFromCache(key: string) { ... }
+ *   }
+ *
+ * The decorator reads the `TracingService` from the global registry
+ * (set by `TracingModule.forRoot()`). When no service is registered
+ * the decorator is a pass-through.
+ *
+ * Sync methods stay sync; async methods stay async. The decorator
+ * detects `AsyncFunction` and uses `withSpan` / `withSpanSync` accordingly.
+ */
+import type { SpanOptions } from "../types.js";
+export type TraceOptions = string | undefined | (SpanOptions & {
+    name: string;
+});
+/**
+ * Method decorator: wrap a call in a span.
+ *
+ * The decorator works on both async and sync methods. The wrapped
+ * function preserves `this` so decorators on classes still see the
+ * right instance.
+ */
+export declare function Trace(opts?: TraceOptions): (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/** Read the @Trace options for a given method (used by OpenAPI integration). */
+export declare function getTraceOptions(target: object, method: string): TraceOptions | undefined;
+//# sourceMappingURL=trace.d.ts.map

package/dist/tracing/decorators/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/tracing/decorators/trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAc,WAAW,EAAE,MAAM,aAAa,CAAC;AAG3D,MAAM,MAAM,YAAY,GACrB,MAAM,GACN,SAAS,GACT,CAAC,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIpC;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,IACvB,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,YAAY,kBAAkB,wBAyC7F;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAExF"}