@forklaunch/hyper-express 0.5.19 → 0.5.20

package/lib/index.d.mts

@@ -1,6 +1,6 @@
 import * as _forklaunch_core_http from '@forklaunch/core/http';
-import { ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler, ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, DocsConfiguration, ForklaunchExpressLikeRouter, ForklaunchRouter, TypedMiddlewareDefinition } from '@forklaunch/core/http';
-import { Request, Response, MiddlewareNext, Server, MiddlewareHandler, ServerConstructorOptions, Router as Router$1 } from '@forklaunch/hyper-express-fork';
+import { ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler, DocsConfiguration, ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, ForklaunchExpressLikeRouter, ForklaunchRouter, TypedMiddlewareDefinition } from '@forklaunch/core/http';
+import { Request, Response, MiddlewareNext, ServerConstructorOptions, Server, MiddlewareHandler, Router as Router$1 } from '@forklaunch/hyper-express-fork';
 export { MiddlewareNext as NextFunction, Request, Response } from '@forklaunch/hyper-express-fork';
 import { AnySchemaValidator } from '@forklaunch/validator';
 import { BusboyConfig } from 'busboy';
@@ -703,6 +703,13 @@ declare const put: <SV extends AnySchemaValidator, Path extends `/${string}`, P
  */
 declare const trace: <SV extends AnySchemaValidator, Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(schemaValidator: SV, path: Path, contractDetails: ContractDetails<SV, "trace", Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, Request<LocalsObj>>, ...handlers: ExpressLikeSchemaHandler<SV, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, Request<LocalsObj>, Response<LocalsObj>, MiddlewareNext>[]) => _forklaunch_core_http.ExpressLikeTypedHandler<SV, "trace", Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, Request<LocalsObj>, Response<LocalsObj>, MiddlewareNext>;
 
+type ExpressOptions = {
+    docs?: DocsConfiguration;
+    busboy?: BusboyConfig;
+    server?: ServerConstructorOptions;
+    cors?: CorsOptions;
+};
+
 /**
  * Represents an application built on top of Hyper-Express and Forklaunch.
  * This class provides a high-performance web server implementation using uWebSockets.js
@@ -743,12 +750,7 @@ declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpre
      * );
      * ```
      */
-    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, configurationOptions?: {
-        docs?: DocsConfiguration;
-        busboy?: BusboyConfig;
-        server?: ServerConstructorOptions;
-        cors?: CorsOptions;
-    });
+    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, configurationOptions?: ExpressOptions);
     /**
      * Starts the server and sets up API documentation.
      * Supports multiple listening configurations including port, host, and UNIX socket path.
@@ -829,4 +831,4 @@ declare const handlers: {
     trace: typeof trace;
 };
 
-export { type App, Application, Router, forklaunchExpress, forklaunchRouter, handlers };
+export { type App, Application, type ExpressOptions, Router, forklaunchExpress, forklaunchRouter, handlers };

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 import * as _forklaunch_core_http from '@forklaunch/core/http';
-import { ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler, ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, DocsConfiguration, ForklaunchExpressLikeRouter, ForklaunchRouter, TypedMiddlewareDefinition } from '@forklaunch/core/http';
-import { Request, Response, MiddlewareNext, Server, MiddlewareHandler, ServerConstructorOptions, Router as Router$1 } from '@forklaunch/hyper-express-fork';
+import { ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler, DocsConfiguration, ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, ForklaunchExpressLikeRouter, ForklaunchRouter, TypedMiddlewareDefinition } from '@forklaunch/core/http';
+import { Request, Response, MiddlewareNext, ServerConstructorOptions, Server, MiddlewareHandler, Router as Router$1 } from '@forklaunch/hyper-express-fork';
 export { MiddlewareNext as NextFunction, Request, Response } from '@forklaunch/hyper-express-fork';
 import { AnySchemaValidator } from '@forklaunch/validator';
 import { BusboyConfig } from 'busboy';
@@ -703,6 +703,13 @@ declare const put: <SV extends AnySchemaValidator, Path extends `/${string}`, P
  */
 declare const trace: <SV extends AnySchemaValidator, Path extends `/${string}`, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>>(schemaValidator: SV, path: Path, contractDetails: ContractDetails<SV, "trace", Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, Request<LocalsObj>>, ...handlers: ExpressLikeSchemaHandler<SV, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, Request<LocalsObj>, Response<LocalsObj>, MiddlewareNext>[]) => _forklaunch_core_http.ExpressLikeTypedHandler<SV, "trace", Path, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, Request<LocalsObj>, Response<LocalsObj>, MiddlewareNext>;
 
+type ExpressOptions = {
+    docs?: DocsConfiguration;
+    busboy?: BusboyConfig;
+    server?: ServerConstructorOptions;
+    cors?: CorsOptions;
+};
+
 /**
  * Represents an application built on top of Hyper-Express and Forklaunch.
  * This class provides a high-performance web server implementation using uWebSockets.js
@@ -743,12 +750,7 @@ declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpre
      * );
      * ```
      */
-    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, configurationOptions?: {
-        docs?: DocsConfiguration;
-        busboy?: BusboyConfig;
-        server?: ServerConstructorOptions;
-        cors?: CorsOptions;
-    });
+    constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, configurationOptions?: ExpressOptions);
     /**
      * Starts the server and sets up API documentation.
      * Supports multiple listening configurations including port, host, and UNIX socket path.
@@ -829,4 +831,4 @@ declare const handlers: {
     trace: typeof trace;
 };
 
-export { type App, Application, Router, forklaunchExpress, forklaunchRouter, handlers };
+export { type App, Application, type ExpressOptions, Router, forklaunchExpress, forklaunchRouter, handlers };

package/lib/index.js

@@ -328,8 +328,14 @@ Correlation id: ${(0, import_http13.isForklaunchRequest)(req) ? req.context.corr
         this.internal.use(
           `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
           (0, import_express_api_reference.apiReference)({
-            content: openApi,
-            ...this.docsConfiguration
+            ...this.docsConfiguration,
+            sources: [
+              {
+                content: openApi,
+                title: "API Reference"
+              },
+              ...this.docsConfiguration?.sources ?? []
+            ]
           })
         );
       } else if (this.docsConfiguration?.type === "swagger") {

package/lib/index.mjs

@@ -320,8 +320,14 @@ Correlation id: ${isForklaunchRequest(req) ? req.context.correlationId : "No cor
         this.internal.use(
           `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
           apiReference({
-            content: openApi,
-            ...this.docsConfiguration
+            ...this.docsConfiguration,
+            sources: [
+              {
+                content: openApi,
+                title: "API Reference"
+              },
+              ...this.docsConfiguration?.sources ?? []
+            ]
           })
         );
       } else if (this.docsConfiguration?.type === "swagger") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/hyper-express",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "description": "Forklaunch framework for hyper-express.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -34,9 +34,9 @@
     "swagger-ui-dist": "^5.24.1",
     "swagger-ui-express": "^5.0.1",
     "uWebSockets.js": "github:uNetworking/uWebSockets.js#v20.44.0",
-    "@forklaunch/common": "0.3.9",
-    "@forklaunch/core": "0.9.9",
-    "@forklaunch/validator": "0.6.9"
+    "@forklaunch/common": "0.3.10",
+    "@forklaunch/core": "0.9.10",
+    "@forklaunch/validator": "0.6.10"
   },
   "devDependencies": {
     "@eslint/js": "^9.28.0",
@@ -46,14 +46,14 @@
     "@types/qs": "^6.14.0",
     "@types/swagger-ui-dist": "^3.30.5",
     "@types/swagger-ui-express": "^4.1.8",
-    "@typescript/native-preview": "7.0.0-dev.20250610.1",
+    "@typescript/native-preview": "7.0.0-dev.20250611.1",
     "jest": "^30.0.0",
     "kill-port-process": "^3.2.1",
     "prettier": "^3.5.3",
     "ts-jest": "^29.3.4",
     "ts-node": "^10.9.2",
     "tsup": "^8.5.0",
-    "tsx": "^4.19.4",
+    "tsx": "^4.20.1",
     "typedoc": "^0.28.5",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.34.0"