@forklaunch/express 0.5.18 → 0.5.20

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/lib/index.d.mts +11 -9
  2. package/lib/index.d.ts +11 -9
  3. package/lib/index.js +8 -2
  4. package/lib/index.mjs +8 -2
  5. package/package.json +6 -6
package/lib/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
  import * as _forklaunch_core_http from '@forklaunch/core/http';
2
- import { ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, DocsConfiguration, ForklaunchExpressLikeRouter, TypedMiddlewareDefinition, ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler } from '@forklaunch/core/http';
2
+ import { DocsConfiguration, ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, ForklaunchExpressLikeRouter, TypedMiddlewareDefinition, ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler } from '@forklaunch/core/http';
3
3
  import { AnySchemaValidator, LiteralSchema, IdiomaticSchema, SchemaResolve } from '@forklaunch/validator';
4
4
  import { OptionsText, OptionsJson, OptionsUrlencoded } from 'body-parser';
5
5
  import { BusboyConfig } from 'busboy';
@@ -10,6 +10,15 @@ import { Server } from 'http';
10
10
  import express from 'express-serve-static-core';
11
11
  import { ParsedQs } from 'qs';
12
12
 
13
+ type ExpressOptions = {
14
+ docs?: DocsConfiguration;
15
+ busboy?: BusboyConfig;
16
+ text?: OptionsText;
17
+ json?: OptionsJson;
18
+ urlencoded?: OptionsUrlencoded;
19
+ cors?: CorsOptions;
20
+ };
21
+
13
22
  /**
14
23
  * Application class that sets up an Express server with Forklaunch routers and middleware.
15
24
  * This class extends ForklaunchExpressLikeApplication to provide Express-specific functionality.
@@ -30,14 +39,7 @@ declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpre
30
39
  * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics.
31
40
  * @param {DocsConfiguration} [docsConfiguration] - Optional configuration for API documentation (Swagger/Scalar).
32
41
  */
33
- constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: {
34
- docs?: DocsConfiguration;
35
- busboy?: BusboyConfig;
36
- text?: OptionsText;
37
- json?: OptionsJson;
38
- urlencoded?: OptionsUrlencoded;
39
- cors?: CorsOptions;
40
- });
42
+ constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: ExpressOptions);
41
43
  /**
42
44
  * Starts the Express server and sets up API documentation (Swagger/Scalar).
43
45
  * This method is overloaded to support various ways of starting the server.
package/lib/index.d.ts CHANGED
@@ -1,5 +1,5 @@
1
1
  import * as _forklaunch_core_http from '@forklaunch/core/http';
2
- import { ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, DocsConfiguration, ForklaunchExpressLikeRouter, TypedMiddlewareDefinition, ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler } from '@forklaunch/core/http';
2
+ import { DocsConfiguration, ForklaunchExpressLikeApplication, OpenTelemetryCollector, MetricsDefinition, ForklaunchExpressLikeRouter, TypedMiddlewareDefinition, ParamsObject, ResponsesObject, Body, QueryObject, HeadersObject, ContractDetails, ExpressLikeSchemaHandler } from '@forklaunch/core/http';
3
3
  import { AnySchemaValidator, LiteralSchema, IdiomaticSchema, SchemaResolve } from '@forklaunch/validator';
4
4
  import { OptionsText, OptionsJson, OptionsUrlencoded } from 'body-parser';
5
5
  import { BusboyConfig } from 'busboy';
@@ -10,6 +10,15 @@ import { Server } from 'http';
10
10
  import express from 'express-serve-static-core';
11
11
  import { ParsedQs } from 'qs';
12
12
 
13
+ type ExpressOptions = {
14
+ docs?: DocsConfiguration;
15
+ busboy?: BusboyConfig;
16
+ text?: OptionsText;
17
+ json?: OptionsJson;
18
+ urlencoded?: OptionsUrlencoded;
19
+ cors?: CorsOptions;
20
+ };
21
+
13
22
  /**
14
23
  * Application class that sets up an Express server with Forklaunch routers and middleware.
15
24
  * This class extends ForklaunchExpressLikeApplication to provide Express-specific functionality.
@@ -30,14 +39,7 @@ declare class Application<SV extends AnySchemaValidator> extends ForklaunchExpre
30
39
  * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics.
31
40
  * @param {DocsConfiguration} [docsConfiguration] - Optional configuration for API documentation (Swagger/Scalar).
32
41
  */
33
- constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: {
34
- docs?: DocsConfiguration;
35
- busboy?: BusboyConfig;
36
- text?: OptionsText;
37
- json?: OptionsJson;
38
- urlencoded?: OptionsUrlencoded;
39
- cors?: CorsOptions;
40
- });
42
+ constructor(schemaValidator: SV, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options?: ExpressOptions);
41
43
  /**
42
44
  * Starts the Express server and sets up API documentation (Swagger/Scalar).
43
45
  * This method is overloaded to support various ways of starting the server.
package/lib/index.js CHANGED
@@ -184,8 +184,14 @@ var Application = class extends import_http3.ForklaunchExpressLikeApplication {
184
184
  this.internal.use(
185
185
  `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
186
186
  (0, import_express_api_reference.apiReference)({
187
- content: openApi,
188
- ...this.docsConfiguration
187
+ ...this.docsConfiguration,
188
+ sources: [
189
+ {
190
+ content: openApi,
191
+ title: "API Reference"
192
+ },
193
+ ...this.docsConfiguration?.sources ?? []
194
+ ]
189
195
  })
190
196
  );
191
197
  } else if (this.docsConfiguration.type === "swagger") {
package/lib/index.mjs CHANGED
@@ -155,8 +155,14 @@ var Application = class extends ForklaunchExpressLikeApplication {
155
155
  this.internal.use(
156
156
  `/api/${process.env.VERSION ?? "v1"}${process.env.DOCS_PATH ?? "/docs"}`,
157
157
  apiReference({
158
- content: openApi,
159
- ...this.docsConfiguration
158
+ ...this.docsConfiguration,
159
+ sources: [
160
+ {
161
+ content: openApi,
162
+ title: "API Reference"
163
+ },
164
+ ...this.docsConfiguration?.sources ?? []
165
+ ]
160
166
  })
161
167
  );
162
168
  } else if (this.docsConfiguration.type === "swagger") {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forklaunch/express",
3
- "version": "0.5.18",
3
+ "version": "0.5.20",
4
4
  "description": "Forklaunch framework for express.",
5
5
  "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
6
6
  "bugs": {
@@ -34,9 +34,9 @@
34
34
  "multer": "2.0.1",
35
35
  "qs": "^6.14.0",
36
36
  "swagger-ui-express": "^5.0.1",
37
- "@forklaunch/common": "0.3.8",
38
- "@forklaunch/validator": "0.6.8",
39
- "@forklaunch/core": "0.9.8"
37
+ "@forklaunch/common": "0.3.10",
38
+ "@forklaunch/validator": "0.6.10",
39
+ "@forklaunch/core": "0.9.10"
40
40
  },
41
41
  "devDependencies": {
42
42
  "@eslint/js": "^9.28.0",
@@ -48,8 +48,8 @@
48
48
  "@types/jest": "^29.5.14",
49
49
  "@types/qs": "^6.14.0",
50
50
  "@types/swagger-ui-express": "^4.1.8",
51
- "@typescript/native-preview": "7.0.0-dev.20250609.1",
52
- "jest": "^29.7.0",
51
+ "@typescript/native-preview": "7.0.0-dev.20250611.1",
52
+ "jest": "^30.0.0",
53
53
  "kill-port-process": "^3.2.1",
54
54
  "prettier": "^3.5.3",
55
55
  "ts-jest": "^29.3.4",