@nestia/core 2.4.3 → 3.0.0-dev.20231209

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 (67) hide show
  1. package/lib/decorators/EncryptedBody.js +13 -11
  2. package/lib/decorators/EncryptedBody.js.map +1 -1
  3. package/lib/decorators/EncryptedRoute.js +29 -12
  4. package/lib/decorators/EncryptedRoute.js.map +1 -1
  5. package/lib/decorators/internal/get_binary_body.d.ts +1 -0
  6. package/lib/decorators/internal/get_binary_body.js +66 -0
  7. package/lib/decorators/internal/get_binary_body.js.map +1 -0
  8. package/package.json +3 -3
  9. package/src/decorators/DynamicModule.ts +39 -39
  10. package/src/decorators/EncryptedBody.ts +17 -12
  11. package/src/decorators/EncryptedController.ts +38 -38
  12. package/src/decorators/EncryptedModule.ts +79 -79
  13. package/src/decorators/EncryptedRoute.ts +38 -14
  14. package/src/decorators/PlainBody.ts +72 -72
  15. package/src/decorators/TypedBody.ts +59 -59
  16. package/src/decorators/TypedException.ts +89 -89
  17. package/src/decorators/TypedHeaders.ts +69 -69
  18. package/src/decorators/TypedParam.ts +65 -65
  19. package/src/decorators/TypedQuery.ts +246 -246
  20. package/src/decorators/TypedRoute.ts +144 -144
  21. package/src/decorators/internal/EncryptedConstant.ts +4 -4
  22. package/src/decorators/internal/NoTransformConfigureError.ts +8 -8
  23. package/src/decorators/internal/get_binary_body.ts +18 -0
  24. package/src/decorators/internal/get_path_and_querify.ts +103 -103
  25. package/src/decorators/internal/get_path_and_stringify.ts +91 -91
  26. package/src/decorators/internal/get_text_body.ts +20 -20
  27. package/src/decorators/internal/headers_to_object.ts +13 -13
  28. package/src/decorators/internal/load_controller.ts +51 -51
  29. package/src/decorators/internal/route_error.ts +45 -45
  30. package/src/decorators/internal/validate_request_body.ts +57 -57
  31. package/src/decorators/internal/validate_request_headers.ts +68 -68
  32. package/src/decorators/internal/validate_request_query.ts +56 -56
  33. package/src/index.ts +5 -5
  34. package/src/module.ts +14 -14
  35. package/src/options/INestiaTransformOptions.ts +17 -17
  36. package/src/options/INestiaTransformProject.ts +7 -7
  37. package/src/options/IRequestBodyValidator.ts +20 -20
  38. package/src/options/IRequestHeadersValidator.ts +22 -22
  39. package/src/options/IRequestQueryValidator.ts +20 -20
  40. package/src/options/IResponseBodyQuerifier.ts +25 -25
  41. package/src/options/IResponseBodyStringifier.ts +25 -25
  42. package/src/programmers/PlainBodyProgrammer.ts +52 -52
  43. package/src/programmers/TypedBodyProgrammer.ts +108 -108
  44. package/src/programmers/TypedExceptionProgrammer.ts +72 -72
  45. package/src/programmers/TypedHeadersProgrammer.ts +56 -56
  46. package/src/programmers/TypedParamProgrammer.ts +24 -24
  47. package/src/programmers/TypedQueryBodyProgrammer.ts +56 -56
  48. package/src/programmers/TypedQueryProgrammer.ts +56 -56
  49. package/src/programmers/TypedQueryRouteProgrammer.ts +51 -51
  50. package/src/programmers/TypedRouteProgrammer.ts +51 -51
  51. package/src/programmers/http/HttpAssertQuerifyProgrammer.ts +58 -58
  52. package/src/programmers/http/HttpIsQuerifyProgrammer.ts +62 -62
  53. package/src/programmers/http/HttpQuerifyProgrammer.ts +96 -96
  54. package/src/programmers/http/HttpValidateQuerifyProgrammer.ts +63 -63
  55. package/src/programmers/internal/CoreMetadataUtil.ts +21 -21
  56. package/src/transform.ts +35 -35
  57. package/src/transformers/FileTransformer.ts +66 -66
  58. package/src/transformers/MethodTransformer.ts +94 -94
  59. package/src/transformers/NodeTransformer.ts +16 -16
  60. package/src/transformers/ParameterDecoratorTransformer.ts +121 -121
  61. package/src/transformers/ParameterTransformer.ts +48 -48
  62. package/src/transformers/TypedExceptionTransformer.ts +49 -49
  63. package/src/transformers/TypedRouteTransformer.ts +95 -95
  64. package/src/typings/Creator.ts +3 -3
  65. package/src/utils/ExceptionManager.ts +112 -112
  66. package/src/utils/Singleton.ts +20 -20
  67. package/src/utils/SourceFinder.ts +57 -57
@@ -1,91 +1,91 @@
1
- import { InternalServerErrorException } from "@nestjs/common";
2
- import typia, { IValidation, TypeGuardError } from "typia";
3
-
4
- import { IResponseBodyStringifier } from "../../options/IResponseBodyStringifier";
5
- import { NoTransformConfigureError } from "./NoTransformConfigureError";
6
-
7
- /**
8
- * @internal
9
- */
10
- export const get_path_and_stringify =
11
- (method: string) =>
12
- (...args: any[]): [string | string[] | undefined, (input: any) => string] => {
13
- const path: string | string[] | null | undefined =
14
- args[0] === undefined ||
15
- typeof args[0] === "string" ||
16
- Array.isArray(args[0])
17
- ? args[0]
18
- : null;
19
- const functor: IResponseBodyStringifier<any> | undefined =
20
- path === null ? args[0] : args[1];
21
- return [path ?? undefined, take(method)(functor)];
22
- };
23
-
24
- /**
25
- * @internal
26
- */
27
- const take =
28
- (method: string) =>
29
- <T>(functor?: IResponseBodyStringifier<T> | null) => {
30
- if (functor === undefined) throw NoTransformConfigureError(method);
31
- else if (functor === null) return JSON.stringify;
32
- else if (functor.type === "stringify") return functor.stringify;
33
- else if (functor.type === "assert") return assert(functor.assert);
34
- else if (functor.type === "is") return is(functor.is);
35
- else if (functor.type === "validate") return validate(functor.validate);
36
- throw new Error(
37
- `Error on nestia.core.${method}(): invalid typed stringify function.`,
38
- );
39
- };
40
-
41
- /**
42
- * @internal
43
- */
44
- const assert =
45
- <T>(closure: (data: T) => string) =>
46
- (data: T) => {
47
- try {
48
- return closure(data);
49
- } catch (exp) {
50
- if (typia.is<TypeGuardError>(exp))
51
- throw new InternalServerErrorException({
52
- path: exp.path,
53
- reason: exp.message,
54
- expected: exp.expected,
55
- value: exp.value,
56
- message: MESSAGE,
57
- });
58
- throw exp;
59
- }
60
- };
61
-
62
- /**
63
- * @internal
64
- */
65
- const is =
66
- <T>(closure: (data: T) => string | null) =>
67
- (data: T) => {
68
- const result: string | null = closure(data);
69
- if (result === null) throw new InternalServerErrorException(MESSAGE);
70
- return result;
71
- };
72
-
73
- /**
74
- * @internal
75
- */
76
- const validate =
77
- <T>(closure: (data: T) => IValidation<string>) =>
78
- (data: T) => {
79
- const result: IValidation<string> = closure(data);
80
- if (result.success === false)
81
- throw new InternalServerErrorException({
82
- errors: result.errors,
83
- message: MESSAGE,
84
- });
85
- return result.data;
86
- };
87
-
88
- /**
89
- * @internal
90
- */
91
- const MESSAGE = "Response body data is not following the promised type.";
1
+ import { InternalServerErrorException } from "@nestjs/common";
2
+ import typia, { IValidation, TypeGuardError } from "typia";
3
+
4
+ import { IResponseBodyStringifier } from "../../options/IResponseBodyStringifier";
5
+ import { NoTransformConfigureError } from "./NoTransformConfigureError";
6
+
7
+ /**
8
+ * @internal
9
+ */
10
+ export const get_path_and_stringify =
11
+ (method: string) =>
12
+ (...args: any[]): [string | string[] | undefined, (input: any) => string] => {
13
+ const path: string | string[] | null | undefined =
14
+ args[0] === undefined ||
15
+ typeof args[0] === "string" ||
16
+ Array.isArray(args[0])
17
+ ? args[0]
18
+ : null;
19
+ const functor: IResponseBodyStringifier<any> | undefined =
20
+ path === null ? args[0] : args[1];
21
+ return [path ?? undefined, take(method)(functor)];
22
+ };
23
+
24
+ /**
25
+ * @internal
26
+ */
27
+ const take =
28
+ (method: string) =>
29
+ <T>(functor?: IResponseBodyStringifier<T> | null) => {
30
+ if (functor === undefined) throw NoTransformConfigureError(method);
31
+ else if (functor === null) return JSON.stringify;
32
+ else if (functor.type === "stringify") return functor.stringify;
33
+ else if (functor.type === "assert") return assert(functor.assert);
34
+ else if (functor.type === "is") return is(functor.is);
35
+ else if (functor.type === "validate") return validate(functor.validate);
36
+ throw new Error(
37
+ `Error on nestia.core.${method}(): invalid typed stringify function.`,
38
+ );
39
+ };
40
+
41
+ /**
42
+ * @internal
43
+ */
44
+ const assert =
45
+ <T>(closure: (data: T) => string) =>
46
+ (data: T) => {
47
+ try {
48
+ return closure(data);
49
+ } catch (exp) {
50
+ if (typia.is<TypeGuardError>(exp))
51
+ throw new InternalServerErrorException({
52
+ path: exp.path,
53
+ reason: exp.message,
54
+ expected: exp.expected,
55
+ value: exp.value,
56
+ message: MESSAGE,
57
+ });
58
+ throw exp;
59
+ }
60
+ };
61
+
62
+ /**
63
+ * @internal
64
+ */
65
+ const is =
66
+ <T>(closure: (data: T) => string | null) =>
67
+ (data: T) => {
68
+ const result: string | null = closure(data);
69
+ if (result === null) throw new InternalServerErrorException(MESSAGE);
70
+ return result;
71
+ };
72
+
73
+ /**
74
+ * @internal
75
+ */
76
+ const validate =
77
+ <T>(closure: (data: T) => IValidation<string>) =>
78
+ (data: T) => {
79
+ const result: IValidation<string> = closure(data);
80
+ if (result.success === false)
81
+ throw new InternalServerErrorException({
82
+ errors: result.errors,
83
+ message: MESSAGE,
84
+ });
85
+ return result.data;
86
+ };
87
+
88
+ /**
89
+ * @internal
90
+ */
91
+ const MESSAGE = "Response body data is not following the promised type.";
@@ -1,20 +1,20 @@
1
- import type express from "express";
2
- import type { FastifyRequest } from "fastify";
3
- import raw from "raw-body";
4
-
5
- /**
6
- * @internal
7
- */
8
- export const get_text_body = async (
9
- request: express.Request | FastifyRequest,
10
- ): Promise<string> =>
11
- isExpressRequest(request)
12
- ? (await raw(request)).toString("utf8")
13
- : (request.body as string);
14
-
15
- /**
16
- * @internal
17
- */
18
- const isExpressRequest = (
19
- request: express.Request | FastifyRequest,
20
- ): request is express.Request => (request as express.Request).app !== undefined;
1
+ import type express from "express";
2
+ import type { FastifyRequest } from "fastify";
3
+ import raw from "raw-body";
4
+
5
+ /**
6
+ * @internal
7
+ */
8
+ export const get_text_body = async (
9
+ request: express.Request | FastifyRequest,
10
+ ): Promise<string> =>
11
+ isExpressRequest(request)
12
+ ? (await raw(request)).toString("utf8")
13
+ : (request.body as string);
14
+
15
+ /**
16
+ * @internal
17
+ */
18
+ const isExpressRequest = (
19
+ request: express.Request | FastifyRequest,
20
+ ): request is express.Request => (request as express.Request).app !== undefined;
@@ -1,13 +1,13 @@
1
- import http from "http";
2
-
3
- /**
4
- * @internal
5
- */
6
- export function headers_to_object(
7
- headers: http.IncomingHttpHeaders,
8
- ): Record<string, string> {
9
- const output: Record<string, string> = {};
10
- for (const [key, value] of Object.entries(headers))
11
- output[key] = value instanceof Array ? value[0] : value || "";
12
- return output;
13
- }
1
+ import http from "http";
2
+
3
+ /**
4
+ * @internal
5
+ */
6
+ export function headers_to_object(
7
+ headers: http.IncomingHttpHeaders,
8
+ ): Record<string, string> {
9
+ const output: Record<string, string> = {};
10
+ for (const [key, value] of Object.entries(headers))
11
+ output[key] = value instanceof Array ? value[0] : value || "";
12
+ return output;
13
+ }
@@ -1,51 +1,51 @@
1
- import is_ts_node from "detect-ts-node";
2
-
3
- import { Creator } from "../../typings/Creator";
4
- import { SourceFinder } from "../../utils/SourceFinder";
5
-
6
- /**
7
- * @internal
8
- */
9
- export const load_controllers = async (
10
- path: string | string[] | { include: string[]; exclude?: string[] },
11
- ): Promise<Creator<object>[]> => {
12
- const sources: string[] = await SourceFinder.find({
13
- include: Array.isArray(path)
14
- ? path
15
- : typeof path === "object"
16
- ? path.include
17
- : [path],
18
- exclude:
19
- typeof path === "object" && !Array.isArray(path)
20
- ? path.exclude ?? []
21
- : [],
22
- filter:
23
- EXTENSION === "ts"
24
- ? (file) =>
25
- file.substring(file.length - 3) === ".ts" &&
26
- file.substring(file.length - 5) !== ".d.ts"
27
- : (flle) => flle.substring(flle.length - 3) === ".js",
28
- });
29
- return mount(sources);
30
- };
31
-
32
- /**
33
- * @internal
34
- */
35
- async function mount(sources: string[]): Promise<any[]> {
36
- const controllers: any[] = [];
37
- for (const file of sources) {
38
- const external: any = await import(file);
39
- for (const key in external) {
40
- const instance: Creator<object> = external[key];
41
- if (Reflect.getMetadata("path", instance) !== undefined)
42
- controllers.push(instance);
43
- }
44
- }
45
- return controllers;
46
- }
47
-
48
- /**
49
- * @internal
50
- */
51
- const EXTENSION = is_ts_node ? "ts" : "js";
1
+ import is_ts_node from "detect-ts-node";
2
+
3
+ import { Creator } from "../../typings/Creator";
4
+ import { SourceFinder } from "../../utils/SourceFinder";
5
+
6
+ /**
7
+ * @internal
8
+ */
9
+ export const load_controllers = async (
10
+ path: string | string[] | { include: string[]; exclude?: string[] },
11
+ ): Promise<Creator<object>[]> => {
12
+ const sources: string[] = await SourceFinder.find({
13
+ include: Array.isArray(path)
14
+ ? path
15
+ : typeof path === "object"
16
+ ? path.include
17
+ : [path],
18
+ exclude:
19
+ typeof path === "object" && !Array.isArray(path)
20
+ ? path.exclude ?? []
21
+ : [],
22
+ filter:
23
+ EXTENSION === "ts"
24
+ ? (file) =>
25
+ file.substring(file.length - 3) === ".ts" &&
26
+ file.substring(file.length - 5) !== ".d.ts"
27
+ : (flle) => flle.substring(flle.length - 3) === ".js",
28
+ });
29
+ return mount(sources);
30
+ };
31
+
32
+ /**
33
+ * @internal
34
+ */
35
+ async function mount(sources: string[]): Promise<any[]> {
36
+ const controllers: any[] = [];
37
+ for (const file of sources) {
38
+ const external: any = await import(file);
39
+ for (const key in external) {
40
+ const instance: Creator<object> = external[key];
41
+ if (Reflect.getMetadata("path", instance) !== undefined)
42
+ controllers.push(instance);
43
+ }
44
+ }
45
+ return controllers;
46
+ }
47
+
48
+ /**
49
+ * @internal
50
+ */
51
+ const EXTENSION = is_ts_node ? "ts" : "js";
@@ -1,45 +1,45 @@
1
- import { HttpException } from "@nestjs/common";
2
- import express from "express";
3
- import type { FastifyRequest } from "fastify";
4
- import { throwError } from "rxjs";
5
-
6
- import { ExceptionManager } from "../../utils/ExceptionManager";
7
-
8
- /**
9
- * @internal
10
- */
11
- export function route_error(
12
- request: express.Request | FastifyRequest,
13
- error: any,
14
- ) {
15
- error = (() => {
16
- // HTTP-ERROR
17
- if (error instanceof HttpException) return error;
18
-
19
- // CUSTOM-REGISTERED ERROR
20
- for (const [creator, closure] of ExceptionManager.tuples)
21
- if (error instanceof creator) return closure(error);
22
-
23
- // MAYBE INTERNAL ERROR
24
- return error;
25
- })();
26
-
27
- try {
28
- error.method = request.method;
29
- error.path =
30
- (request as express.Request).path ??
31
- (request as FastifyRequest).routeOptions?.url ??
32
- (request as FastifyRequest).routerPath;
33
- } catch {}
34
-
35
- setTimeout(() => {
36
- for (const listener of ExceptionManager.listeners) {
37
- try {
38
- const res: any | Promise<any> = listener(error);
39
- if (typeof res === "object" && typeof res.catch === "function")
40
- res.catch(() => {});
41
- } catch {}
42
- }
43
- }, 0);
44
- return throwError(() => error);
45
- }
1
+ import { HttpException } from "@nestjs/common";
2
+ import express from "express";
3
+ import type { FastifyRequest } from "fastify";
4
+ import { throwError } from "rxjs";
5
+
6
+ import { ExceptionManager } from "../../utils/ExceptionManager";
7
+
8
+ /**
9
+ * @internal
10
+ */
11
+ export function route_error(
12
+ request: express.Request | FastifyRequest,
13
+ error: any,
14
+ ) {
15
+ error = (() => {
16
+ // HTTP-ERROR
17
+ if (error instanceof HttpException) return error;
18
+
19
+ // CUSTOM-REGISTERED ERROR
20
+ for (const [creator, closure] of ExceptionManager.tuples)
21
+ if (error instanceof creator) return closure(error);
22
+
23
+ // MAYBE INTERNAL ERROR
24
+ return error;
25
+ })();
26
+
27
+ try {
28
+ error.method = request.method;
29
+ error.path =
30
+ (request as express.Request).path ??
31
+ (request as FastifyRequest).routeOptions?.url ??
32
+ (request as FastifyRequest).routerPath;
33
+ } catch {}
34
+
35
+ setTimeout(() => {
36
+ for (const listener of ExceptionManager.listeners) {
37
+ try {
38
+ const res: any | Promise<any> = listener(error);
39
+ if (typeof res === "object" && typeof res.catch === "function")
40
+ res.catch(() => {});
41
+ } catch {}
42
+ }
43
+ }, 0);
44
+ return throwError(() => error);
45
+ }
@@ -1,57 +1,57 @@
1
- import { BadRequestException } from "@nestjs/common";
2
- import typia, { IValidation, TypeGuardError } from "typia";
3
-
4
- import { IRequestBodyValidator } from "../../options/IRequestBodyValidator";
5
- import { NoTransformConfigureError } from "./NoTransformConfigureError";
6
-
7
- export const validate_request_body =
8
- (method: string) =>
9
- <T>(validator?: IRequestBodyValidator<T>) => {
10
- if (!validator) return () => NoTransformConfigureError(method);
11
- else if (validator.type === "assert") return assert(validator.assert);
12
- else if (validator.type === "is") return is(validator.is);
13
- else if (validator.type === "validate") return validate(validator.validate);
14
- return () =>
15
- new Error(`Error on nestia.core.${method}(): invalid typed validator.`);
16
- };
17
-
18
- const assert =
19
- <T>(closure: (data: T) => T) =>
20
- (input: T) => {
21
- try {
22
- closure(input);
23
- return null;
24
- } catch (exp) {
25
- if (typia.is<TypeGuardError>(exp)) {
26
- return new BadRequestException({
27
- path: exp.path,
28
- reason: exp.message,
29
- expected: exp.expected,
30
- value: exp.value,
31
- message: MESSAGE,
32
- });
33
- }
34
- throw exp;
35
- }
36
- };
37
-
38
- const is =
39
- <T>(closure: (data: T) => boolean) =>
40
- (input: T) => {
41
- const success: boolean = closure(input);
42
- return success ? null : new BadRequestException(MESSAGE);
43
- };
44
-
45
- const validate =
46
- <T>(closure: (data: T) => IValidation<T>) =>
47
- (input: T) => {
48
- const result: IValidation<T> = closure(input);
49
- return result.success
50
- ? null
51
- : new BadRequestException({
52
- errors: result.errors,
53
- message: MESSAGE,
54
- });
55
- };
56
-
57
- const MESSAGE = "Request body data is not following the promised type.";
1
+ import { BadRequestException } from "@nestjs/common";
2
+ import typia, { IValidation, TypeGuardError } from "typia";
3
+
4
+ import { IRequestBodyValidator } from "../../options/IRequestBodyValidator";
5
+ import { NoTransformConfigureError } from "./NoTransformConfigureError";
6
+
7
+ export const validate_request_body =
8
+ (method: string) =>
9
+ <T>(validator?: IRequestBodyValidator<T>) => {
10
+ if (!validator) return () => NoTransformConfigureError(method);
11
+ else if (validator.type === "assert") return assert(validator.assert);
12
+ else if (validator.type === "is") return is(validator.is);
13
+ else if (validator.type === "validate") return validate(validator.validate);
14
+ return () =>
15
+ new Error(`Error on nestia.core.${method}(): invalid typed validator.`);
16
+ };
17
+
18
+ const assert =
19
+ <T>(closure: (data: T) => T) =>
20
+ (input: T) => {
21
+ try {
22
+ closure(input);
23
+ return null;
24
+ } catch (exp) {
25
+ if (typia.is<TypeGuardError>(exp)) {
26
+ return new BadRequestException({
27
+ path: exp.path,
28
+ reason: exp.message,
29
+ expected: exp.expected,
30
+ value: exp.value,
31
+ message: MESSAGE,
32
+ });
33
+ }
34
+ throw exp;
35
+ }
36
+ };
37
+
38
+ const is =
39
+ <T>(closure: (data: T) => boolean) =>
40
+ (input: T) => {
41
+ const success: boolean = closure(input);
42
+ return success ? null : new BadRequestException(MESSAGE);
43
+ };
44
+
45
+ const validate =
46
+ <T>(closure: (data: T) => IValidation<T>) =>
47
+ (input: T) => {
48
+ const result: IValidation<T> = closure(input);
49
+ return result.success
50
+ ? null
51
+ : new BadRequestException({
52
+ errors: result.errors,
53
+ message: MESSAGE,
54
+ });
55
+ };
56
+
57
+ const MESSAGE = "Request body data is not following the promised type.";