@getsoda/core 0.2.2 → 0.3.0
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.
- package/README.md +80 -0
- package/dist/app/app.d.ts +15 -5
- package/dist/app/app.d.ts.map +1 -1
- package/dist/app/app.js +31 -8
- package/dist/app/app.js.map +1 -1
- package/dist/app/index.d.ts +1 -1
- package/dist/app/index.d.ts.map +1 -1
- package/dist/config/config.d.ts.map +1 -1
- package/dist/config/config.js +2 -0
- package/dist/config/config.js.map +1 -1
- package/dist/di/errors.d.ts.map +1 -1
- package/dist/di/errors.js +2 -0
- package/dist/di/errors.js.map +1 -1
- package/dist/http/arguments.d.ts +19 -6
- package/dist/http/arguments.d.ts.map +1 -1
- package/dist/http/arguments.js +7 -0
- package/dist/http/arguments.js.map +1 -1
- package/dist/http/cookies.d.ts.map +1 -1
- package/dist/http/cookies.js +2 -0
- package/dist/http/cookies.js.map +1 -1
- package/dist/http/decorators.d.ts +12 -5
- package/dist/http/decorators.d.ts.map +1 -1
- package/dist/http/decorators.js +7 -2
- package/dist/http/decorators.js.map +1 -1
- package/dist/http/errors.d.ts +3 -1
- package/dist/http/errors.d.ts.map +1 -1
- package/dist/http/errors.js +2 -0
- package/dist/http/errors.js.map +1 -1
- package/dist/http/index.d.ts +6 -4
- package/dist/http/index.d.ts.map +1 -1
- package/dist/http/index.js +3 -2
- package/dist/http/index.js.map +1 -1
- package/dist/http/parsers.d.ts +4 -0
- package/dist/http/parsers.d.ts.map +1 -1
- package/dist/http/parsers.js +9 -5
- package/dist/http/parsers.js.map +1 -1
- package/dist/http/pipeline.d.ts +4 -5
- package/dist/http/pipeline.d.ts.map +1 -1
- package/dist/http/pipeline.js +2 -2
- package/dist/http/pipeline.js.map +1 -1
- package/dist/http/routes.d.ts +27 -2
- package/dist/http/routes.d.ts.map +1 -1
- package/dist/http/routes.js +34 -20
- package/dist/http/routes.js.map +1 -1
- package/dist/http/sse.d.ts +39 -0
- package/dist/http/sse.d.ts.map +1 -0
- package/dist/http/sse.js +89 -0
- package/dist/http/sse.js.map +1 -0
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/index.js.map +1 -1
- package/dist/openapi/decorators.d.ts +41 -0
- package/dist/openapi/decorators.d.ts.map +1 -0
- package/dist/openapi/decorators.js +29 -0
- package/dist/openapi/decorators.js.map +1 -0
- package/dist/openapi/document.d.ts +62 -0
- package/dist/openapi/document.d.ts.map +1 -0
- package/dist/openapi/document.js +135 -0
- package/dist/openapi/document.js.map +1 -0
- package/dist/openapi/index.d.ts +11 -0
- package/dist/openapi/index.d.ts.map +1 -0
- package/dist/openapi/index.js +8 -0
- package/dist/openapi/index.js.map +1 -0
- package/dist/openapi/module.d.ts +26 -0
- package/dist/openapi/module.d.ts.map +1 -0
- package/dist/openapi/module.js +73 -0
- package/dist/openapi/module.js.map +1 -0
- package/dist/routing/errors.d.ts.map +1 -1
- package/dist/routing/errors.js +2 -0
- package/dist/routing/errors.js.map +1 -1
- package/dist/testing/index.d.ts +46 -0
- package/dist/testing/index.d.ts.map +1 -0
- package/dist/testing/index.js +49 -0
- package/dist/testing/index.js.map +1 -0
- package/dist/utils/errors.d.ts +11 -0
- package/dist/utils/errors.d.ts.map +1 -0
- package/dist/utils/errors.js +22 -0
- package/dist/utils/errors.js.map +1 -0
- package/dist/utils/object.d.ts +4 -0
- package/dist/utils/object.d.ts.map +1 -1
- package/dist/utils/object.js +16 -0
- package/dist/utils/object.js.map +1 -1
- package/dist/websocket/decorators.d.ts +31 -0
- package/dist/websocket/decorators.d.ts.map +1 -0
- package/dist/websocket/decorators.js +43 -0
- package/dist/websocket/decorators.js.map +1 -0
- package/dist/websocket/gateway.d.ts +61 -0
- package/dist/websocket/gateway.d.ts.map +1 -0
- package/dist/websocket/gateway.js +142 -0
- package/dist/websocket/gateway.js.map +1 -0
- package/dist/websocket/index.d.ts +7 -0
- package/dist/websocket/index.d.ts.map +1 -0
- package/dist/websocket/index.js +6 -0
- package/dist/websocket/index.js.map +1 -0
- package/package.json +12 -1
- package/src/app/app.ts +69 -18
- package/src/app/index.ts +1 -1
- package/src/config/config.ts +2 -0
- package/src/di/errors.ts +3 -0
- package/src/http/arguments.ts +31 -6
- package/src/http/cookies.ts +2 -0
- package/src/http/decorators.ts +16 -8
- package/src/http/errors.ts +7 -0
- package/src/http/index.ts +6 -4
- package/src/http/parsers.ts +18 -7
- package/src/http/pipeline.ts +6 -6
- package/src/http/routes.ts +68 -29
- package/src/http/sse.ts +120 -0
- package/src/index.ts +1 -0
- package/src/openapi/decorators.ts +50 -0
- package/src/openapi/document.ts +221 -0
- package/src/openapi/index.ts +11 -0
- package/src/openapi/module.ts +95 -0
- package/src/routing/errors.ts +3 -0
- package/src/testing/index.ts +73 -0
- package/src/utils/errors.ts +25 -0
- package/src/utils/object.ts +23 -0
- package/src/websocket/decorators.ts +55 -0
- package/src/websocket/gateway.ts +213 -0
- package/src/websocket/index.ts +7 -0
package/dist/http/decorators.js
CHANGED
|
@@ -64,12 +64,12 @@ export const Controller = (path = '/') => (target, _context) => {
|
|
|
64
64
|
/**
|
|
65
65
|
* Creates the route decorator factory of one HTTP method (any method name, extensions included).
|
|
66
66
|
*/
|
|
67
|
-
const routeFactory = (method, decorator) => ((pathOrArgs, args) => (target, context) => {
|
|
67
|
+
const routeFactory = (method, decorator, sse = false) => ((pathOrArgs, args) => (target, context) => {
|
|
68
68
|
assertPublicMethod(decorator, context);
|
|
69
69
|
const path = typeof pathOrArgs === 'string' ? pathOrArgs : '/';
|
|
70
70
|
const list = typeof pathOrArgs === 'string' ? args : pathOrArgs;
|
|
71
71
|
// Decorators run bottom-up: unshift keeps the source order.
|
|
72
|
-
metadataOf(target).routes.unshift({ method, path, args: list });
|
|
72
|
+
metadataOf(target).routes.unshift({ method, path, args: list, sse });
|
|
73
73
|
});
|
|
74
74
|
/**
|
|
75
75
|
* Route for any method name, including extensions (`PROPFIND`, `REPORT`...).
|
|
@@ -92,6 +92,11 @@ export const Options = routeFactory('OPTIONS', 'Options');
|
|
|
92
92
|
export const Head = routeFactory('HEAD', 'Head');
|
|
93
93
|
/** Route for every method; a route for a concrete method on the same path wins. */
|
|
94
94
|
export const All = routeFactory('ALL', 'All');
|
|
95
|
+
/**
|
|
96
|
+
* `GET` route streaming server-sent events: the method returns an async
|
|
97
|
+
* iterable of `SseMessage`, such as an `async function*`. Like Nest's `@Sse()`.
|
|
98
|
+
*/
|
|
99
|
+
export const Sse = routeFactory('GET', 'Sse', true);
|
|
95
100
|
/**
|
|
96
101
|
* Status of the responses built from the returned value (not of a returned `Response`).
|
|
97
102
|
* Defaults to `201` for `POST` and `200` otherwise, as in Nest.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/http/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAKH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;
|
|
1
|
+
{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/http/decorators.ts"],"names":[],"mappings":"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"}
|
package/dist/http/errors.d.ts
CHANGED
|
@@ -10,8 +10,10 @@
|
|
|
10
10
|
* - `INVALID_STATUS`: `@HttpCode()` with a status a `Response` cannot have, or twice on one method.
|
|
11
11
|
* - `INVALID_HEADER`: `@Header()` with a name or value `Headers` rejects.
|
|
12
12
|
* - `UNKNOWN_PARAM`: `param('x')` in an argument list names no parameter of the route path.
|
|
13
|
+
* - `INVALID_PATH`: a WebSocket gateway path that is not static.
|
|
14
|
+
* - `DUPLICATE_ROUTE`: a gateway on the path of another gateway or route.
|
|
13
15
|
*/
|
|
14
|
-
export type ControllerErrorCode = 'NOT_A_CONTROLLER' | 'INVALID_HANDLER' | 'INVALID_STATUS' | 'INVALID_HEADER' | 'UNKNOWN_PARAM';
|
|
16
|
+
export type ControllerErrorCode = 'NOT_A_CONTROLLER' | 'INVALID_HANDLER' | 'INVALID_STATUS' | 'INVALID_HEADER' | 'UNKNOWN_PARAM' | 'INVALID_PATH' | 'DUPLICATE_ROUTE';
|
|
15
17
|
/**
|
|
16
18
|
* Error thrown by the controller decorators (when the class is defined) and by
|
|
17
19
|
* `controllerRoutes` (at startup), never while serving a request.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;
|
|
1
|
+
{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,cAAc,GACd,iBAAiB,CAAA;AAErB;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAItC,QAAQ,CAAC,IAAI,EAAE,mBAAmB;IAHpC,SAAkB,IAAI,qBAAoB;IAE1C,YACW,IAAI,EAAE,mBAAmB,EAClC,OAAO,EAAE,MAAM,EAIhB;CACF"}
|
package/dist/http/errors.js
CHANGED
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
* @module
|
|
3
3
|
* Errors raised while declaring and collecting controllers.
|
|
4
4
|
*/
|
|
5
|
+
import { hideFrameworkFrames } from '../utils/errors.js';
|
|
5
6
|
/**
|
|
6
7
|
* Error thrown by the controller decorators (when the class is defined) and by
|
|
7
8
|
* `controllerRoutes` (at startup), never while serving a request.
|
|
@@ -12,6 +13,7 @@ export class ControllerError extends Error {
|
|
|
12
13
|
constructor(code, message) {
|
|
13
14
|
super(message);
|
|
14
15
|
this.code = code;
|
|
16
|
+
hideFrameworkFrames(this);
|
|
15
17
|
}
|
|
16
18
|
}
|
|
17
19
|
//# sourceMappingURL=errors.js.map
|
package/dist/http/errors.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/http/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAsBxD;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAI7B,IAAI;IAHG,IAAI,GAAG,iBAAiB,CAAA;IAE1C,YACW,IAAyB,EAClC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAA;oBAHL,IAAI;QAIb,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAC3B,CAAC;CACF"}
|
package/dist/http/index.d.ts
CHANGED
|
@@ -3,12 +3,14 @@
|
|
|
3
3
|
* HTTP layer for Soda: controllers, route decorators, request context, validation, exceptions.
|
|
4
4
|
*/
|
|
5
5
|
export { body, context, cookie, form, header, param, query, value } from './arguments.ts';
|
|
6
|
-
export type { Argument, ArgumentFor, ArgumentKind, ArgumentValues } from './arguments.ts';
|
|
6
|
+
export type { Argument, ArgumentFor, ArgumentKind, ArgumentValues, RawParam } from './arguments.ts';
|
|
7
7
|
export { Context } from './context.ts';
|
|
8
8
|
export { CookieSigner, signed } from './cookies.ts';
|
|
9
9
|
export { ContextKey } from './context-key.ts';
|
|
10
10
|
export type { ContextParams, ParamNameOf } from './context.ts';
|
|
11
|
-
export { All, Controller, Delete, Get, Head, Header, HttpCode, Options, Patch, Post, Put, Route } from './decorators.ts';
|
|
11
|
+
export { All, Controller, Delete, Get, Head, Header, HttpCode, Options, Patch, Post, Put, Route, Sse } from './decorators.ts';
|
|
12
|
+
export { formatSseMessage } from './sse.ts';
|
|
13
|
+
export type { SseMessage } from './sse.ts';
|
|
12
14
|
export type { ArgumentsRouteDecorator, MethodMetadataDecorator, MethodRouteDecoratorFactory, RouteDecorator, RouteDecoratorFactory, RouteHandlerHint, RouteHandlerMethod, } from './decorators.ts';
|
|
13
15
|
export { ControllerError } from './errors.ts';
|
|
14
16
|
export type { ControllerErrorCode } from './errors.ts';
|
|
@@ -16,8 +18,8 @@ export { BadRequestException, ConflictException, ForbiddenException, HttpExcepti
|
|
|
16
18
|
export type { HttpExceptionBody, HttpExceptionOptions } from './exceptions.ts';
|
|
17
19
|
export { boolean, int, number, uuid } from './parsers.ts';
|
|
18
20
|
export type { Parsed, Parser, ParserOptions, ValueParser } from './parsers.ts';
|
|
19
|
-
export { buildRoutes, controllerRoutes } from './routes.ts';
|
|
20
|
-
export type { BuiltRoutes, ControllerRoutesOptions, MappedController } from './routes.ts';
|
|
21
|
+
export { buildRoutes, controllerRoutes, ROUTES } from './routes.ts';
|
|
22
|
+
export type { BuiltRoutes, ControllerRoutesOptions, MappedController, MappedRoute, RouteRegistry } from './routes.ts';
|
|
21
23
|
export type { InferOutput, StandardSchemaV1 } from './schema.ts';
|
|
22
24
|
export type { AnyParams, PathParams } from './types.ts';
|
|
23
25
|
export { Catch, createDecorator, UseFilters, UseGuards, UseInterceptors } from './enhancers.ts';
|
package/dist/http/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACzF,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACzF,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACnG,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAC7H,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,4BAA4B,EAC5B,iBAAiB,EACjB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAC9E,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACzD,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACnE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACrH,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAChE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC/F,YAAY,EACV,WAAW,EACX,WAAW,EACX,sBAAsB,EACtB,SAAS,EACT,eAAe,EACf,cAAc,EACd,UAAU,EACV,KAAK,EACL,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3F,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA"}
|
package/dist/http/index.js
CHANGED
|
@@ -6,11 +6,12 @@ export { body, context, cookie, form, header, param, query, value } from './argu
|
|
|
6
6
|
export { Context } from './context.js';
|
|
7
7
|
export { CookieSigner, signed } from './cookies.js';
|
|
8
8
|
export { ContextKey } from './context-key.js';
|
|
9
|
-
export { All, Controller, Delete, Get, Head, Header, HttpCode, Options, Patch, Post, Put, Route } from './decorators.js';
|
|
9
|
+
export { All, Controller, Delete, Get, Head, Header, HttpCode, Options, Patch, Post, Put, Route, Sse } from './decorators.js';
|
|
10
|
+
export { formatSseMessage } from './sse.js';
|
|
10
11
|
export { ControllerError } from './errors.js';
|
|
11
12
|
export { BadRequestException, ConflictException, ForbiddenException, HttpException, InternalServerErrorException, NotFoundException, PayloadTooLargeException, ServiceUnavailableException, TooManyRequestsException, UnauthorizedException, UnprocessableEntityException, UnsupportedMediaTypeException, } from './exceptions.js';
|
|
12
13
|
export { boolean, int, number, uuid } from './parsers.js';
|
|
13
|
-
export { buildRoutes, controllerRoutes } from './routes.js';
|
|
14
|
+
export { buildRoutes, controllerRoutes, ROUTES } from './routes.js';
|
|
14
15
|
export { Catch, createDecorator, UseFilters, UseGuards, UseInterceptors } from './enhancers.js';
|
|
15
16
|
export { cors } from './cors.js';
|
|
16
17
|
//# sourceMappingURL=index.js.map
|
package/dist/http/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEzF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAEzF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAC7H,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAW3C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,4BAA4B,EAC5B,iBAAiB,EACjB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAEzD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAInE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAiB/F,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA"}
|
package/dist/http/parsers.d.ts
CHANGED
|
@@ -17,6 +17,10 @@ import type { InferOutput, StandardSchemaV1 } from './schema.ts';
|
|
|
17
17
|
*/
|
|
18
18
|
export interface Parser<T> {
|
|
19
19
|
readonly parse: (value: string | undefined, name: string) => T;
|
|
20
|
+
/** JSON Schema of the accepted strings, for API descriptions such as OpenAPI. */
|
|
21
|
+
readonly jsonSchema?: Readonly<Record<string, unknown>>;
|
|
22
|
+
/** `true` when a missing value is accepted. */
|
|
23
|
+
readonly optional?: boolean;
|
|
20
24
|
}
|
|
21
25
|
/** What `param()`, `query()` and `header()` accept to convert a value. */
|
|
22
26
|
export type ValueParser<T> = Parser<T> | StandardSchemaV1<string | undefined, T>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/http/parsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,CAAA;
|
|
1
|
+
{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/http/parsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC,CAAA;IAC9D,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IACvD,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,0EAA0E;AAC1E,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC,CAAC,CAAA;AAEhF,8BAA8B;AAC9B,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,gBAAgB,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;AAE3G,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,SAAS,aAAa,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;CAAE,GAAG,CAAC,GAAG,SAAS,GAAG,CAAC,CAAA;AAMnG,yEAAyE;AACzE,eAAO,MAAM,OAAO,SAAU,MAAM,YAAY,MAAM,KAAG,mBAC6B,CAAA;AA6BtF;;;GAGG;AACH,eAAO,MAAM,GAAG,GAAI,KAAK,CAAC,CAAC,SAAS,aAAa,GAAG,EAAE,YAAY,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAU9D,CAAA;AAEhC,uDAAuD;AACvD,eAAO,MAAM,MAAM,GAAI,KAAK,CAAC,CAAC,SAAS,aAAa,GAAG,EAAE,YAAY,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAUjE,CAAA;AAEhC,6BAA6B;AAC7B,eAAO,MAAM,OAAO,GAAI,KAAK,CAAC,CAAC,SAAS,aAAa,GAAG,EAAE,YAAY,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAGjE,CAAA;AAElC,6CAA6C;AAC7C,eAAO,MAAM,IAAI,GAAI,KAAK,CAAC,CAAC,SAAS,aAAa,GAAG,EAAE,YAAY,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAG5F,CAAA;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,MAAM,GAAG,SAAS,QAAQ,MAAM,KAAG,MAAM,CAAC,CAAC,CACK,CAAA"}
|
package/dist/http/parsers.js
CHANGED
|
@@ -17,7 +17,9 @@ const NUMBER = /^-?(?:\d+\.?\d*|\.\d+)(?:[eE][-+]?\d+)?$/;
|
|
|
17
17
|
const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
|
|
18
18
|
/** The `400` of a value that is missing or not what a parser expects. */
|
|
19
19
|
export const failure = (name, expected) => new BadRequestException(`Validation failed for "${name}" (${expected} is expected)`);
|
|
20
|
-
const createParser = (expected, convert, options) => ({
|
|
20
|
+
const createParser = (expected, convert, options, jsonSchema) => ({
|
|
21
|
+
jsonSchema,
|
|
22
|
+
optional: options.optional === true,
|
|
21
23
|
parse: (value, name) => {
|
|
22
24
|
if (value === undefined) {
|
|
23
25
|
if (options.optional === true) {
|
|
@@ -39,16 +41,18 @@ const createParser = (expected, convert, options) => ({
|
|
|
39
41
|
export const int = (options) => createParser('integer string', (value) => {
|
|
40
42
|
const number = INTEGER.test(value) ? Number(value) : Number.NaN;
|
|
41
43
|
return Number.isSafeInteger(number) ? number : undefined;
|
|
42
|
-
}, options ?? {});
|
|
44
|
+
}, options ?? {}, { type: 'integer' });
|
|
43
45
|
/** Finite decimal number: `'1.5'`, `'-2'`, `'1e3'`. */
|
|
44
46
|
export const number = (options) => createParser('numeric string', (value) => {
|
|
45
47
|
const parsed = NUMBER.test(value) ? Number(value) : Number.NaN;
|
|
46
48
|
return Number.isFinite(parsed) ? parsed : undefined;
|
|
47
|
-
}, options ?? {});
|
|
49
|
+
}, options ?? {}, { type: 'number' });
|
|
48
50
|
/** `'true'` or `'false'`. */
|
|
49
|
-
export const boolean = (options) => createParser('boolean string', (value) => (value === 'true' ? true : value === 'false' ? false : undefined), options ?? {}
|
|
51
|
+
export const boolean = (options) => createParser('boolean string', (value) => (value === 'true' ? true : value === 'false' ? false : undefined), options ?? {}, {
|
|
52
|
+
type: 'boolean',
|
|
53
|
+
});
|
|
50
54
|
/** UUID of any version, case-insensitive. */
|
|
51
|
-
export const uuid = (options) => createParser('UUID string', (value) => (UUID.test(value) ? value : undefined), options ?? {});
|
|
55
|
+
export const uuid = (options) => createParser('UUID string', (value) => (UUID.test(value) ? value : undefined), options ?? {}, { type: 'string', format: 'uuid' });
|
|
52
56
|
/**
|
|
53
57
|
* Applies a parser or a synchronous Standard Schema to a raw value.
|
|
54
58
|
*/
|
package/dist/http/parsers.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/http/parsers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;
|
|
1
|
+
{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../src/http/parsers.ts"],"names":[],"mappings":"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"}
|
package/dist/http/pipeline.d.ts
CHANGED
|
@@ -16,9 +16,9 @@ import type { Handler } from '../routing/index.ts';
|
|
|
16
16
|
import { Context } from './context.ts';
|
|
17
17
|
import type { RouteInfo } from './context.ts';
|
|
18
18
|
import type { CallHandler, FilterLike, Guard, InterceptorLike } from './enhancers.ts';
|
|
19
|
-
type GuardStep = (ctx: Context) => unknown;
|
|
20
|
-
type InterceptorStep = (ctx: Context, next: CallHandler) => unknown;
|
|
21
|
-
interface FilterStep {
|
|
19
|
+
export type GuardStep = (ctx: Context) => unknown;
|
|
20
|
+
export type InterceptorStep = (ctx: Context, next: CallHandler) => unknown;
|
|
21
|
+
export interface FilterStep {
|
|
22
22
|
/** Empty: catches everything. */
|
|
23
23
|
readonly types: readonly ClassToken<unknown>[];
|
|
24
24
|
readonly handle: (error: unknown, ctx: Context) => Response | Promise<Response>;
|
|
@@ -50,12 +50,11 @@ export interface PipelineParts {
|
|
|
50
50
|
/** In the order they are tried: method, class, global. */
|
|
51
51
|
readonly filters: readonly FilterStep[];
|
|
52
52
|
readonly invoke: (ctx: Context) => unknown;
|
|
53
|
-
readonly respond: (value: unknown) => Response;
|
|
53
|
+
readonly respond: (value: unknown, ctx: Context) => Response;
|
|
54
54
|
readonly onError: (error: unknown, req: Request) => void;
|
|
55
55
|
}
|
|
56
56
|
/**
|
|
57
57
|
* Builds the route handler given to the router.
|
|
58
58
|
*/
|
|
59
59
|
export declare const createPipeline: (parts: PipelineParts) => Handler;
|
|
60
|
-
export {};
|
|
61
60
|
//# sourceMappingURL=pipeline.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/http/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,gBAAgB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAgC,UAAU,EAAE,KAAK,EAAe,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGhI,
|
|
1
|
+
{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/http/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,gBAAgB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAgC,UAAU,EAAE,KAAK,EAAe,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGhI,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;AACjD,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAA;AAE1E,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,CAAA;IAC9C,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAChF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAA;IAC3C,QAAQ,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,eAAe,KAAK,eAAe,CAAA;IACvE,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,UAAU,CAAA;CACpD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,iBACnB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,YACzB,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,KACpC,gBA2DF,CAAA;AAuDD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAA;IACjD,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAA;IAC5D,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CACzD;AAkBD;;GAEG;AACH,eAAO,MAAM,cAAc,UAAW,aAAa,KAAG,OA+CrD,CAAA"}
|
package/dist/http/pipeline.js
CHANGED
|
@@ -149,10 +149,10 @@ export const createPipeline = (parts) => {
|
|
|
149
149
|
const result = gate === undefined ? run(ctx) : gate.then(() => run(ctx));
|
|
150
150
|
if (isThenable(result)) {
|
|
151
151
|
return Promise.resolve(result)
|
|
152
|
-
.then(respond)
|
|
152
|
+
.then((value) => respond(value, ctx))
|
|
153
153
|
.catch((error) => fail(error, ctx));
|
|
154
154
|
}
|
|
155
|
-
return respond(result);
|
|
155
|
+
return respond(result, ctx);
|
|
156
156
|
}
|
|
157
157
|
catch (error) {
|
|
158
158
|
return fail(error, ctx);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/http/pipeline.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/http/pipeline.ts"],"names":[],"mappings":"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"}
|
package/dist/http/routes.d.ts
CHANGED
|
@@ -10,9 +10,13 @@
|
|
|
10
10
|
* ('', '/', '/') => '/'
|
|
11
11
|
* ```
|
|
12
12
|
*/
|
|
13
|
+
import { InjectionToken } from '../di/index.ts';
|
|
13
14
|
import type { Constructor, Container } from '../di/index.ts';
|
|
14
15
|
import type { RouteDefinition } from '../routing/index.ts';
|
|
16
|
+
import type { Argument } from './arguments.ts';
|
|
17
|
+
import type { RouteInfo } from './context.ts';
|
|
15
18
|
import type { FilterLike, Guard, InterceptorLike } from './enhancers.ts';
|
|
19
|
+
import type { BuiltGateway } from '../websocket/gateway.ts';
|
|
16
20
|
/**
|
|
17
21
|
* Options of `controllerRoutes`.
|
|
18
22
|
*/
|
|
@@ -28,13 +32,32 @@ export interface ControllerRoutesOptions {
|
|
|
28
32
|
/** Receives errors that no filter answered and that are not `HttpException`s (sent as 500). Defaults to `console.error`. */
|
|
29
33
|
readonly onError?: (error: unknown, req: Request) => void;
|
|
30
34
|
}
|
|
31
|
-
/** A
|
|
35
|
+
/** A route as declared: what startup logs and API descriptions (OpenAPI) show. */
|
|
36
|
+
export interface MappedRoute {
|
|
37
|
+
/** Controller, method name, HTTP method, full path and custom metadata. */
|
|
38
|
+
readonly info: RouteInfo;
|
|
39
|
+
/** Declared arguments; `undefined` when the method receives the context. */
|
|
40
|
+
readonly args: readonly Argument<unknown>[] | undefined;
|
|
41
|
+
/** Status of the responses built from returned values. */
|
|
42
|
+
readonly status: number;
|
|
43
|
+
/** Declared with `@Sse()`. */
|
|
44
|
+
readonly sse: boolean;
|
|
45
|
+
}
|
|
46
|
+
/** A controller and the routes made from it. */
|
|
32
47
|
export interface MappedController {
|
|
33
48
|
readonly controller: Constructor<unknown>;
|
|
34
49
|
/** Path of the controller, with the global prefix. */
|
|
35
50
|
readonly path: string;
|
|
36
|
-
readonly routes: readonly
|
|
51
|
+
readonly routes: readonly MappedRoute[];
|
|
52
|
+
}
|
|
53
|
+
/**
|
|
54
|
+
* The routes of the application, grouped by controller: `inject(ROUTES)`.
|
|
55
|
+
* Filled once the routes are built, so read it when serving, not in a constructor.
|
|
56
|
+
*/
|
|
57
|
+
export interface RouteRegistry {
|
|
58
|
+
readonly controllers: readonly MappedController[];
|
|
37
59
|
}
|
|
60
|
+
export declare const ROUTES: InjectionToken<RouteRegistry>;
|
|
38
61
|
/**
|
|
39
62
|
* Routes of every controller, and the guards, interceptors and filters created
|
|
40
63
|
* for them from classes (whose lifecycle hooks the application runs).
|
|
@@ -43,6 +66,8 @@ export interface BuiltRoutes {
|
|
|
43
66
|
readonly routes: RouteDefinition[];
|
|
44
67
|
/** In module order. */
|
|
45
68
|
readonly controllers: readonly MappedController[];
|
|
69
|
+
/** WebSocket gateways, in module order. */
|
|
70
|
+
readonly gateways: readonly BuiltGateway[];
|
|
46
71
|
/** In creation order. */
|
|
47
72
|
readonly enhancers: readonly unknown[];
|
|
48
73
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/http/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAgC,MAAM,gBAAgB,CAAA;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;
|
|
1
|
+
{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/http/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAgC,MAAM,gBAAgB,CAAA;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAI1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAW,SAAS,EAAE,MAAM,cAAc,CAAA;AAItD,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAQxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,0GAA0G;IAC1G,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAA;IAClC,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,eAAe,EAAE,CAAA;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IACxC,4HAA4H;IAC5H,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAA;CAC1D;AAiOD,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,CAAA;IACvD,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CACtB;AAED,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IACzC,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAClD;AAED,eAAO,MAAM,MAAM,+BAA8C,CAAA;AAEjE;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAA;IAClC,uBAAuB;IACvB,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACjD,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IAC1C,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,OAAO,EAAE,CAAA;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,cAAe,SAAS,YAAW,uBAAuB,KAAQ,WAQzF,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,cAAe,SAAS,YAAW,uBAAuB,KAAQ,eAAe,EACtE,CAAA"}
|
package/dist/http/routes.js
CHANGED
|
@@ -10,13 +10,18 @@
|
|
|
10
10
|
* ('', '/', '/') => '/'
|
|
11
11
|
* ```
|
|
12
12
|
*/
|
|
13
|
+
import { InjectionToken } from '../di/index.js';
|
|
13
14
|
import { parsePath } from '../routing/path.js';
|
|
15
|
+
import { methodNames } from '../utils/object.js';
|
|
14
16
|
import { isThenable } from '../utils/promise.js';
|
|
15
17
|
import { getControllerPath, getHandlerMetadata } from './decorators.js';
|
|
16
18
|
import { getClassEnhancers, getMethodEnhancers } from './enhancers.js';
|
|
17
19
|
import { ControllerError } from './errors.js';
|
|
18
20
|
import { createEnhancerResolver, createPipeline } from './pipeline.js';
|
|
19
21
|
import { createResponder } from './response.js';
|
|
22
|
+
import { createSseResponder } from './sse.js';
|
|
23
|
+
import { getGatewayPath } from '../websocket/decorators.js';
|
|
24
|
+
import { buildGateway } from '../websocket/gateway.js';
|
|
20
25
|
const STATUS_CREATED = 201;
|
|
21
26
|
const STATUS_OK = 200;
|
|
22
27
|
/** `'users/'` → `'/users'`, `'/'` → `''`. */
|
|
@@ -31,22 +36,6 @@ const joinPaths = (...parts) => {
|
|
|
31
36
|
}
|
|
32
37
|
return path || '/';
|
|
33
38
|
};
|
|
34
|
-
/**
|
|
35
|
-
* Public method names along the prototype chain, most derived first, without duplicates.
|
|
36
|
-
*/
|
|
37
|
-
const methodNames = (instance) => {
|
|
38
|
-
const names = [];
|
|
39
|
-
const seen = new Set(['constructor']);
|
|
40
|
-
for (let prototype = Object.getPrototypeOf(instance); prototype !== null && prototype !== Object.prototype; prototype = Object.getPrototypeOf(prototype)) {
|
|
41
|
-
for (const name of Object.getOwnPropertyNames(prototype)) {
|
|
42
|
-
if (!seen.has(name)) {
|
|
43
|
-
seen.add(name);
|
|
44
|
-
names.push(name);
|
|
45
|
-
}
|
|
46
|
-
}
|
|
47
|
-
}
|
|
48
|
-
return names;
|
|
49
|
-
};
|
|
50
39
|
/** Every `param()` must name a parameter of the full path, controller prefix included. */
|
|
51
40
|
const assertParamsExist = (args, path, name) => {
|
|
52
41
|
const names = new Set();
|
|
@@ -96,6 +85,9 @@ const resolveAll = (levels, globalResolve, moduleResolve) => {
|
|
|
96
85
|
class RoutesBuilder {
|
|
97
86
|
routes = [];
|
|
98
87
|
controllers = [];
|
|
88
|
+
gateways = [];
|
|
89
|
+
/** Routes of the controller being added. */
|
|
90
|
+
#mapped = [];
|
|
99
91
|
/** Guards, interceptors and filters created from classes, in creation order. */
|
|
100
92
|
enhancers = [];
|
|
101
93
|
#options;
|
|
@@ -111,17 +103,36 @@ class RoutesBuilder {
|
|
|
111
103
|
this.#onError = options.onError ?? ((error) => console.error(error));
|
|
112
104
|
}
|
|
113
105
|
addController(entry) {
|
|
106
|
+
const gatewayPath = getGatewayPath(entry.controller);
|
|
107
|
+
if (gatewayPath !== undefined) {
|
|
108
|
+
this.#addGateway(entry, gatewayPath);
|
|
109
|
+
return;
|
|
110
|
+
}
|
|
114
111
|
const controllerPath = getControllerPath(entry.controller);
|
|
115
112
|
if (controllerPath === undefined) {
|
|
116
113
|
throw new ControllerError('NOT_A_CONTROLLER', `${entry.controller.name} is listed in the controllers of ${entry.module.name} but has no @Controller()`);
|
|
117
114
|
}
|
|
118
115
|
const basePath = joinPaths(this.#options.prefix ?? '', controllerPath);
|
|
119
|
-
|
|
116
|
+
this.#mapped = [];
|
|
120
117
|
// The most derived function: an override without route decorators has no metadata.
|
|
121
118
|
for (const name of methodNames(entry.instance)) {
|
|
122
119
|
this.#addMethod(entry, basePath, name);
|
|
123
120
|
}
|
|
124
|
-
this.controllers.push({ controller: entry.controller, path: basePath, routes: this
|
|
121
|
+
this.controllers.push({ controller: entry.controller, path: basePath, routes: this.#mapped });
|
|
122
|
+
}
|
|
123
|
+
/** A gateway: its handshake gets the guards and filters of the class and the global ones. */
|
|
124
|
+
#addGateway(entry, gatewayPath) {
|
|
125
|
+
const local = this.#resolverOf(entry);
|
|
126
|
+
const controller = getClassEnhancers(entry.controller);
|
|
127
|
+
const options = this.#options;
|
|
128
|
+
this.gateways.push(buildGateway({
|
|
129
|
+
entry,
|
|
130
|
+
path: joinPaths(options.prefix ?? '', gatewayPath),
|
|
131
|
+
guards: resolveAll([options.guards ?? [], controller.guards, []], this.#global.guard, local.guard),
|
|
132
|
+
filters: resolveAll([options.filters ?? [], controller.filters, []], this.#global.filter, local.filter).reverse(),
|
|
133
|
+
metadata: controller.metadata,
|
|
134
|
+
onError: this.#onError,
|
|
135
|
+
}));
|
|
125
136
|
}
|
|
126
137
|
#resolverOf(entry) {
|
|
127
138
|
let resolver = this.#modules.get(entry.module);
|
|
@@ -154,6 +165,8 @@ class RoutesBuilder {
|
|
|
154
165
|
if (route.args !== undefined) {
|
|
155
166
|
assertParamsExist(route.args, path, `${entry.controller.name}.${name}`);
|
|
156
167
|
}
|
|
168
|
+
const status = statusOf(metadata, route);
|
|
169
|
+
this.#mapped.push({ info, args: route.args, status, sse: route.sse });
|
|
157
170
|
this.routes.push({
|
|
158
171
|
method: route.method,
|
|
159
172
|
path,
|
|
@@ -164,13 +177,14 @@ class RoutesBuilder {
|
|
|
164
177
|
interceptors,
|
|
165
178
|
filters,
|
|
166
179
|
invoke: createInvoker(instance, method, route.args),
|
|
167
|
-
respond:
|
|
180
|
+
respond: route.sse ? createSseResponder(metadata.headers, this.#onError) : createResponder(status, metadata.headers),
|
|
168
181
|
onError: this.#onError,
|
|
169
182
|
}),
|
|
170
183
|
});
|
|
171
184
|
}
|
|
172
185
|
}
|
|
173
186
|
}
|
|
187
|
+
export const ROUTES = new InjectionToken('ROUTES');
|
|
174
188
|
/**
|
|
175
189
|
* Builds the routes of every controller of `container`.
|
|
176
190
|
*/
|
|
@@ -179,7 +193,7 @@ export const buildRoutes = (container, options = {}) => {
|
|
|
179
193
|
for (const entry of container.controllers) {
|
|
180
194
|
builder.addController(entry);
|
|
181
195
|
}
|
|
182
|
-
return { routes: builder.routes, controllers: builder.controllers, enhancers: builder.enhancers };
|
|
196
|
+
return { routes: builder.routes, controllers: builder.controllers, gateways: builder.gateways, enhancers: builder.enhancers };
|
|
183
197
|
};
|
|
184
198
|
/**
|
|
185
199
|
* Route definitions of every controller of `container`, ready for `compileRoutes`.
|
package/dist/http/routes.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/http/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;
|
|
1
|
+
{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/http/routes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @module
|
|
3
|
+
* Server-sent events: a route decorated with `@Sse()` returns an async
|
|
4
|
+
* iterable of messages, streamed as `text/event-stream`, as Nest's `@Sse()`
|
|
5
|
+
* streams an observable.
|
|
6
|
+
*
|
|
7
|
+
* ```ts
|
|
8
|
+
* @Sse('ticks')
|
|
9
|
+
* async *ticks(): AsyncGenerator<SseMessage> {
|
|
10
|
+
* for (let i = 0; ; i++) {
|
|
11
|
+
* yield { data: { tick: i } }
|
|
12
|
+
* await Bun.sleep(1000)
|
|
13
|
+
* }
|
|
14
|
+
* }
|
|
15
|
+
* ```
|
|
16
|
+
*
|
|
17
|
+
* When the client disconnects, the iterator is returned: a generator runs its
|
|
18
|
+
* `finally` blocks. An error thrown while streaming ends the stream and is logged.
|
|
19
|
+
*/
|
|
20
|
+
import type { Context } from './context.ts';
|
|
21
|
+
/** One event. Fields are those of the `EventSource` protocol. */
|
|
22
|
+
export interface SseMessage {
|
|
23
|
+
/** A string is sent as is, anything else as JSON. */
|
|
24
|
+
readonly data: unknown;
|
|
25
|
+
/** Event name, listened to with `source.addEventListener(event, ...)`. */
|
|
26
|
+
readonly event?: string;
|
|
27
|
+
/** Sent back by the browser as `Last-Event-ID` when it reconnects. */
|
|
28
|
+
readonly id?: string;
|
|
29
|
+
/** Milliseconds the browser waits before reconnecting. */
|
|
30
|
+
readonly retry?: number;
|
|
31
|
+
}
|
|
32
|
+
/** A message in the event stream format, one `data:` line per line of data. */
|
|
33
|
+
export declare const formatSseMessage: (message: SseMessage) => string;
|
|
34
|
+
/**
|
|
35
|
+
* Creates the function streaming what an `@Sse()` route returns. `headers`
|
|
36
|
+
* come from `@Header()`; errors while streaming go to `onError`.
|
|
37
|
+
*/
|
|
38
|
+
export declare const createSseResponder: (headers: readonly [string, string][], onError: (error: unknown, req: Request) => void) => ((value: unknown, ctx: Context) => Response);
|
|
39
|
+
//# sourceMappingURL=sse.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/http/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,iEAAiE;AACjE,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAkBD,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,YAAa,UAAU,KAAG,MAuBtD,CAAA;AAKD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,YACpB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,WAC3B,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,KAC9C,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,QAAQ,CAiC7C,CAAA"}
|