@nestia/core 10.0.2 → 11.0.0-dev.20260312

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 (117) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +93 -93
  3. package/lib/adaptors/WebSocketAdaptor.js.map +1 -1
  4. package/lib/decorators/DynamicModule.js +54 -10
  5. package/lib/decorators/DynamicModule.js.map +1 -1
  6. package/lib/decorators/EncryptedBody.js +2 -2
  7. package/lib/decorators/EncryptedBody.js.map +1 -1
  8. package/lib/decorators/EncryptedController.d.ts +1 -1
  9. package/lib/decorators/EncryptedModule.d.ts +1 -1
  10. package/lib/decorators/EncryptedModule.js +54 -10
  11. package/lib/decorators/EncryptedModule.js.map +1 -1
  12. package/lib/decorators/EncryptedRoute.js +2 -2
  13. package/lib/decorators/EncryptedRoute.js.map +1 -1
  14. package/lib/decorators/HumanRoute.d.ts +1 -2
  15. package/lib/decorators/HumanRoute.js +1 -2
  16. package/lib/decorators/HumanRoute.js.map +1 -1
  17. package/lib/decorators/NoTransformConfigurationError.js +1 -1
  18. package/lib/decorators/NoTransformConfigurationError.js.map +1 -1
  19. package/lib/decorators/SwaggerCustomizer.d.ts +1 -1
  20. package/lib/decorators/TypedFormData.js.map +1 -1
  21. package/lib/decorators/TypedParam.js +1 -1
  22. package/lib/decorators/TypedParam.js.map +1 -1
  23. package/lib/decorators/internal/get_path_and_querify.js +1 -1
  24. package/lib/decorators/internal/get_path_and_querify.js.map +1 -1
  25. package/lib/decorators/internal/get_path_and_stringify.js +1 -1
  26. package/lib/decorators/internal/get_path_and_stringify.js.map +1 -1
  27. package/lib/decorators/internal/headers_to_object.js.map +1 -1
  28. package/lib/decorators/internal/validate_request_body.js +1 -1
  29. package/lib/decorators/internal/validate_request_body.js.map +1 -1
  30. package/lib/decorators/internal/validate_request_form_data.js +1 -1
  31. package/lib/decorators/internal/validate_request_form_data.js.map +1 -1
  32. package/lib/decorators/internal/validate_request_headers.js +1 -1
  33. package/lib/decorators/internal/validate_request_headers.js.map +1 -1
  34. package/lib/decorators/internal/validate_request_query.js +1 -1
  35. package/lib/decorators/internal/validate_request_query.js.map +1 -1
  36. package/lib/module.d.ts +1 -0
  37. package/lib/module.js +1 -0
  38. package/lib/module.js.map +1 -1
  39. package/lib/options/INestiaTransformProject.d.ts +1 -1
  40. package/lib/programmers/PlainBodyProgrammer.js +5 -8
  41. package/lib/programmers/PlainBodyProgrammer.js.map +1 -1
  42. package/lib/programmers/TypedBodyProgrammer.js +15 -23
  43. package/lib/programmers/TypedBodyProgrammer.js.map +1 -1
  44. package/lib/programmers/TypedFormDataBodyProgrammer.js +11 -20
  45. package/lib/programmers/TypedFormDataBodyProgrammer.js.map +1 -1
  46. package/lib/programmers/TypedHeadersProgrammer.js +4 -6
  47. package/lib/programmers/TypedHeadersProgrammer.js.map +1 -1
  48. package/lib/programmers/TypedParamProgrammer.js +2 -2
  49. package/lib/programmers/TypedParamProgrammer.js.map +1 -1
  50. package/lib/programmers/TypedQueryBodyProgrammer.js +11 -17
  51. package/lib/programmers/TypedQueryBodyProgrammer.js.map +1 -1
  52. package/lib/programmers/TypedQueryProgrammer.js +11 -17
  53. package/lib/programmers/TypedQueryProgrammer.js.map +1 -1
  54. package/lib/programmers/TypedQueryRouteProgrammer.js +8 -11
  55. package/lib/programmers/TypedQueryRouteProgrammer.js.map +1 -1
  56. package/lib/programmers/TypedRouteProgrammer.js +10 -15
  57. package/lib/programmers/TypedRouteProgrammer.js.map +1 -1
  58. package/lib/programmers/http/HttpAssertQuerifyProgrammer.d.ts +1 -1
  59. package/lib/programmers/http/HttpAssertQuerifyProgrammer.js +5 -7
  60. package/lib/programmers/http/HttpAssertQuerifyProgrammer.js.map +1 -1
  61. package/lib/programmers/http/HttpIsQuerifyProgrammer.d.ts +1 -1
  62. package/lib/programmers/http/HttpIsQuerifyProgrammer.js +5 -7
  63. package/lib/programmers/http/HttpIsQuerifyProgrammer.js.map +1 -1
  64. package/lib/programmers/http/HttpQuerifyProgrammer.d.ts +1 -1
  65. package/lib/programmers/http/HttpQuerifyProgrammer.js +13 -19
  66. package/lib/programmers/http/HttpQuerifyProgrammer.js.map +1 -1
  67. package/lib/programmers/http/HttpValidateQuerifyProgrammer.d.ts +1 -1
  68. package/lib/programmers/http/HttpValidateQuerifyProgrammer.js +6 -8
  69. package/lib/programmers/http/HttpValidateQuerifyProgrammer.js.map +1 -1
  70. package/lib/programmers/internal/CoreMetadataUtil.d.ts +3 -3
  71. package/lib/programmers/internal/CoreMetadataUtil.js.map +1 -1
  72. package/lib/transform.d.ts +1 -1
  73. package/lib/transform.js.map +1 -1
  74. package/lib/transformers/FileTransformer.js +2 -2
  75. package/lib/transformers/FileTransformer.js.map +1 -1
  76. package/lib/transformers/MethodTransformer.js.map +1 -1
  77. package/lib/transformers/ParameterDecoratorTransformer.js +1 -1
  78. package/lib/transformers/ParameterDecoratorTransformer.js.map +1 -1
  79. package/lib/transformers/TypedRouteTransformer.js +1 -1
  80. package/lib/transformers/TypedRouteTransformer.js.map +1 -1
  81. package/lib/transformers/WebSocketRouteTransformer.js +1 -1
  82. package/lib/transformers/WebSocketRouteTransformer.js.map +1 -1
  83. package/package.json +34 -26
  84. package/src/adaptors/WebSocketAdaptor.ts +429 -429
  85. package/src/decorators/EncryptedBody.ts +96 -97
  86. package/src/decorators/EncryptedController.ts +40 -40
  87. package/src/decorators/EncryptedModule.ts +98 -98
  88. package/src/decorators/EncryptedRoute.ts +212 -213
  89. package/src/decorators/HumanRoute.ts +21 -22
  90. package/src/decorators/NoTransformConfigurationError.ts +34 -34
  91. package/src/decorators/SwaggerCustomizer.ts +97 -97
  92. package/src/decorators/TypedFormData.ts +187 -195
  93. package/src/decorators/TypedRoute.ts +196 -196
  94. package/src/decorators/internal/headers_to_object.ts +11 -11
  95. package/src/module.ts +23 -22
  96. package/src/options/INestiaTransformOptions.ts +34 -34
  97. package/src/options/INestiaTransformProject.ts +10 -8
  98. package/src/programmers/PlainBodyProgrammer.ts +72 -70
  99. package/src/programmers/TypedBodyProgrammer.ts +144 -142
  100. package/src/programmers/TypedFormDataBodyProgrammer.ts +118 -118
  101. package/src/programmers/TypedHeadersProgrammer.ts +65 -63
  102. package/src/programmers/TypedParamProgrammer.ts +33 -33
  103. package/src/programmers/TypedQueryBodyProgrammer.ts +111 -109
  104. package/src/programmers/TypedQueryProgrammer.ts +113 -111
  105. package/src/programmers/TypedQueryRouteProgrammer.ts +104 -102
  106. package/src/programmers/TypedRouteProgrammer.ts +96 -94
  107. package/src/programmers/http/HttpAssertQuerifyProgrammer.ts +74 -72
  108. package/src/programmers/http/HttpIsQuerifyProgrammer.ts +77 -75
  109. package/src/programmers/http/HttpQuerifyProgrammer.ts +110 -108
  110. package/src/programmers/http/HttpValidateQuerifyProgrammer.ts +78 -76
  111. package/src/programmers/internal/CoreMetadataUtil.ts +21 -21
  112. package/src/transform.ts +35 -35
  113. package/src/transformers/FileTransformer.ts +109 -110
  114. package/src/transformers/MethodTransformer.ts +103 -103
  115. package/src/transformers/ParameterDecoratorTransformer.ts +143 -143
  116. package/src/transformers/TypedRouteTransformer.ts +85 -85
  117. package/src/transformers/WebSocketRouteTransformer.ts +120 -120
@@ -1,118 +1,118 @@
1
- import ts from "typescript";
2
- import { LiteralFactory } from "typia/lib/factories/LiteralFactory";
3
- import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
4
- import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
5
- import { HttpAssertFormDataProgrammer } from "typia/lib/programmers/http/HttpAssertFormDataProgrammer";
6
- import { HttpFormDataProgrammer } from "typia/lib/programmers/http/HttpFormDataProgrammer";
7
- import { HttpIsFormDataProgrammer } from "typia/lib/programmers/http/HttpIsFormDataProgrammer";
8
- import { HttpValidateFormDataProgrammer } from "typia/lib/programmers/http/HttpValidateFormDataProgrammer";
9
- import { Metadata } from "typia/lib/schemas/metadata/Metadata";
10
- import { ITypiaContext } from "typia/lib/transformers/ITypiaContext";
11
- import { TransformerError } from "typia/lib/transformers/TransformerError";
12
-
13
- import { INestiaTransformContext } from "../options/INestiaTransformProject";
14
- import { IRequestFormDataProps } from "../options/IRequestFormDataProps";
15
-
16
- export namespace TypedFormDataBodyProgrammer {
17
- export const generate = (props: {
18
- context: INestiaTransformContext;
19
- modulo: ts.LeftHandSideExpression;
20
- type: ts.Type;
21
- }): ts.ObjectLiteralExpression => {
22
- // VALIDATE TYPE
23
- const collection: MetadataCollection = new MetadataCollection();
24
- const result = MetadataFactory.analyze({
25
- checker: props.context.checker,
26
- transformer: props.context.transformer,
27
- options: {
28
- escape: false,
29
- constant: true,
30
- absorb: true,
31
- validate: HttpFormDataProgrammer.validate,
32
- },
33
- type: props.type,
34
- collection,
35
- });
36
- if (result.success === false)
37
- throw TransformerError.from({
38
- code: "nestia.core.TypedFormData.Body",
39
- errors: result.errors,
40
- });
41
-
42
- const files: IRequestFormDataProps.IFile[] =
43
- result.data.objects[0].type.properties
44
- .filter(
45
- (p) =>
46
- isFile(p.value) || p.value.arrays.some((a) => isFile(a.type.value)),
47
- )
48
- .map((p) => ({
49
- name: p.key.constants[0].values[0].value as string,
50
- limit: !!p.value.natives.length ? 1 : null,
51
- }));
52
-
53
- // GENERATE VALIDATION PLAN
54
- const parameter =
55
- (key: IRequestFormDataProps<any>["validator"]["type"]) =>
56
- (
57
- programmer: (next: {
58
- context: ITypiaContext;
59
- modulo: ts.LeftHandSideExpression;
60
- type: ts.Type;
61
- name: string | undefined;
62
- }) => ts.Expression,
63
- ) =>
64
- ts.factory.createObjectLiteralExpression(
65
- [
66
- ts.factory.createPropertyAssignment(
67
- ts.factory.createIdentifier("files"),
68
- LiteralFactory.write(files),
69
- ),
70
- ts.factory.createPropertyAssignment(
71
- ts.factory.createIdentifier("validator"),
72
- ts.factory.createObjectLiteralExpression(
73
- [
74
- ts.factory.createPropertyAssignment(
75
- ts.factory.createIdentifier("type"),
76
- ts.factory.createStringLiteral(key),
77
- ),
78
- ts.factory.createPropertyAssignment(
79
- ts.factory.createIdentifier(key),
80
- programmer({
81
- context: {
82
- ...props.context,
83
- options: {
84
- numeric: false,
85
- finite: false,
86
- functional: false,
87
- },
88
- },
89
- modulo: props.modulo,
90
- type: props.type,
91
- name: undefined,
92
- }),
93
- ),
94
- ],
95
- true,
96
- ),
97
- ),
98
- ],
99
- true,
100
- );
101
-
102
- // RETURNS
103
- const category = props.context.options.validate;
104
- if (category === "is" || category === "equals")
105
- return parameter("is")(HttpIsFormDataProgrammer.write);
106
- else if (
107
- category === "validate" ||
108
- category === "validateEquals" ||
109
- category === "validateClone" ||
110
- category === "validatePrune"
111
- )
112
- return parameter("validate")(HttpValidateFormDataProgrammer.write);
113
- return parameter("assert")(HttpAssertFormDataProgrammer.write);
114
- };
115
- }
116
-
117
- const isFile = (meta: Metadata) =>
118
- meta.natives.some(({ name }) => name === "File" || name === "Blob");
1
+ import {
2
+ HttpAssertFormDataProgrammer,
3
+ HttpFormDataProgrammer,
4
+ HttpIsFormDataProgrammer,
5
+ HttpValidateFormDataProgrammer,
6
+ ITypiaContext,
7
+ LiteralFactory,
8
+ MetadataCollection,
9
+ MetadataFactory,
10
+ MetadataSchema,
11
+ TransformerError,
12
+ } from "@typia/core";
13
+ import ts from "typescript";
14
+
15
+ import { INestiaTransformContext } from "../options/INestiaTransformProject";
16
+ import { IRequestFormDataProps } from "../options/IRequestFormDataProps";
17
+
18
+ export namespace TypedFormDataBodyProgrammer {
19
+ export const generate = (props: {
20
+ context: INestiaTransformContext;
21
+ modulo: ts.LeftHandSideExpression;
22
+ type: ts.Type;
23
+ }): ts.ObjectLiteralExpression => {
24
+ // VALIDATE TYPE
25
+ const storage: MetadataCollection = new MetadataCollection();
26
+ const result = MetadataFactory.analyze({
27
+ checker: props.context.checker,
28
+ transformer: props.context.transformer,
29
+ options: {
30
+ escape: false,
31
+ constant: true,
32
+ absorb: true,
33
+ validate: HttpFormDataProgrammer.validate,
34
+ },
35
+ type: props.type,
36
+ components: storage,
37
+ });
38
+ if (result.success === false)
39
+ throw TransformerError.from({
40
+ code: "nestia.core.TypedFormData.Body",
41
+ errors: result.errors,
42
+ });
43
+
44
+ const files: IRequestFormDataProps.IFile[] =
45
+ result.data.objects[0]!.type.properties.filter(
46
+ (p) =>
47
+ isFile(p.value) || p.value.arrays.some((a) => isFile(a.type.value)),
48
+ ).map((p) => ({
49
+ name: p.key.constants[0]!.values[0]!.value as string,
50
+ limit: !!p.value.natives.length ? 1 : null,
51
+ }));
52
+
53
+ // GENERATE VALIDATION PLAN
54
+ const parameter =
55
+ (key: IRequestFormDataProps<any>["validator"]["type"]) =>
56
+ (
57
+ programmer: (next: {
58
+ context: ITypiaContext;
59
+ modulo: ts.LeftHandSideExpression;
60
+ type: ts.Type;
61
+ name: string | undefined;
62
+ }) => ts.Expression,
63
+ ) =>
64
+ ts.factory.createObjectLiteralExpression(
65
+ [
66
+ ts.factory.createPropertyAssignment(
67
+ ts.factory.createIdentifier("files"),
68
+ LiteralFactory.write(files),
69
+ ),
70
+ ts.factory.createPropertyAssignment(
71
+ ts.factory.createIdentifier("validator"),
72
+ ts.factory.createObjectLiteralExpression(
73
+ [
74
+ ts.factory.createPropertyAssignment(
75
+ ts.factory.createIdentifier("type"),
76
+ ts.factory.createStringLiteral(key),
77
+ ),
78
+ ts.factory.createPropertyAssignment(
79
+ ts.factory.createIdentifier(key),
80
+ programmer({
81
+ context: {
82
+ ...props.context,
83
+ options: {
84
+ numeric: false,
85
+ finite: false,
86
+ functional: false,
87
+ },
88
+ },
89
+ modulo: props.modulo,
90
+ type: props.type,
91
+ name: undefined,
92
+ }),
93
+ ),
94
+ ],
95
+ true,
96
+ ),
97
+ ),
98
+ ],
99
+ true,
100
+ );
101
+
102
+ // RETURNS
103
+ const category = props.context.options.validate;
104
+ if (category === "is" || category === "equals")
105
+ return parameter("is")(HttpIsFormDataProgrammer.write);
106
+ else if (
107
+ category === "validate" ||
108
+ category === "validateEquals" ||
109
+ category === "validateClone" ||
110
+ category === "validatePrune"
111
+ )
112
+ return parameter("validate")(HttpValidateFormDataProgrammer.write);
113
+ return parameter("assert")(HttpAssertFormDataProgrammer.write);
114
+ };
115
+ }
116
+
117
+ const isFile = (meta: MetadataSchema) =>
118
+ meta.natives.some(({ name }) => name === "File" || name === "Blob");
@@ -1,63 +1,65 @@
1
- import ts from "typescript";
2
- import { HttpAssertHeadersProgrammer } from "typia/lib/programmers/http/HttpAssertHeadersProgrammer";
3
- import { HttpIsHeadersProgrammer } from "typia/lib/programmers/http/HttpIsHeadersProgrammer";
4
- import { HttpValidateHeadersProgrammer } from "typia/lib/programmers/http/HttpValidateHeadersProgrammer";
5
- import { ITypiaContext } from "typia/lib/transformers/ITypiaContext";
6
-
7
- import { INestiaTransformContext } from "../options/INestiaTransformProject";
8
- import { IRequestHeadersValidator } from "../options/IRequestHeadersValidator";
9
-
10
- export namespace TypedHeadersProgrammer {
11
- export const generate = (props: {
12
- context: INestiaTransformContext;
13
- modulo: ts.LeftHandSideExpression;
14
- type: ts.Type;
15
- }): ts.Expression => {
16
- // GENERATE VALIDATION PLAN
17
- const parameter =
18
- (key: IRequestHeadersValidator<any>["type"]) =>
19
- (
20
- programmer: (next: {
21
- context: ITypiaContext;
22
- modulo: ts.LeftHandSideExpression;
23
- type: ts.Type;
24
- name: string | undefined;
25
- }) => ts.Expression,
26
- ) =>
27
- ts.factory.createObjectLiteralExpression([
28
- ts.factory.createPropertyAssignment(
29
- ts.factory.createIdentifier("type"),
30
- ts.factory.createStringLiteral(key),
31
- ),
32
- ts.factory.createPropertyAssignment(
33
- ts.factory.createIdentifier(key),
34
- programmer({
35
- context: {
36
- ...props.context,
37
- options: {
38
- numeric: false,
39
- finite: false,
40
- functional: false,
41
- },
42
- },
43
- modulo: props.modulo,
44
- type: props.type,
45
- name: undefined,
46
- }),
47
- ),
48
- ]);
49
-
50
- // RETURNS
51
- const category = props.context.options.validate;
52
- if (category === "is" || category === "equals")
53
- return parameter("is")(HttpIsHeadersProgrammer.write);
54
- else if (
55
- category === "validate" ||
56
- category === "validateEquals" ||
57
- category === "validateClone" ||
58
- category === "validatePrune"
59
- )
60
- return parameter("validate")(HttpValidateHeadersProgrammer.write);
61
- return parameter("assert")(HttpAssertHeadersProgrammer.write);
62
- };
63
- }
1
+ import {
2
+ HttpAssertHeadersProgrammer,
3
+ HttpIsHeadersProgrammer,
4
+ HttpValidateHeadersProgrammer,
5
+ ITypiaContext,
6
+ } from "@typia/core";
7
+ import ts from "typescript";
8
+
9
+ import { INestiaTransformContext } from "../options/INestiaTransformProject";
10
+ import { IRequestHeadersValidator } from "../options/IRequestHeadersValidator";
11
+
12
+ export namespace TypedHeadersProgrammer {
13
+ export const generate = (props: {
14
+ context: INestiaTransformContext;
15
+ modulo: ts.LeftHandSideExpression;
16
+ type: ts.Type;
17
+ }): ts.Expression => {
18
+ // GENERATE VALIDATION PLAN
19
+ const parameter =
20
+ (key: IRequestHeadersValidator<any>["type"]) =>
21
+ (
22
+ programmer: (next: {
23
+ context: ITypiaContext;
24
+ modulo: ts.LeftHandSideExpression;
25
+ type: ts.Type;
26
+ name: string | undefined;
27
+ }) => ts.Expression,
28
+ ) =>
29
+ ts.factory.createObjectLiteralExpression([
30
+ ts.factory.createPropertyAssignment(
31
+ ts.factory.createIdentifier("type"),
32
+ ts.factory.createStringLiteral(key),
33
+ ),
34
+ ts.factory.createPropertyAssignment(
35
+ ts.factory.createIdentifier(key),
36
+ programmer({
37
+ context: {
38
+ ...props.context,
39
+ options: {
40
+ numeric: false,
41
+ finite: false,
42
+ functional: false,
43
+ },
44
+ },
45
+ modulo: props.modulo,
46
+ type: props.type,
47
+ name: undefined,
48
+ }),
49
+ ),
50
+ ]);
51
+
52
+ // RETURNS
53
+ const category = props.context.options.validate;
54
+ if (category === "is" || category === "equals")
55
+ return parameter("is")(HttpIsHeadersProgrammer.write);
56
+ else if (
57
+ category === "validate" ||
58
+ category === "validateEquals" ||
59
+ category === "validateClone" ||
60
+ category === "validatePrune"
61
+ )
62
+ return parameter("validate")(HttpValidateHeadersProgrammer.write);
63
+ return parameter("assert")(HttpAssertHeadersProgrammer.write);
64
+ };
65
+ }
@@ -1,33 +1,33 @@
1
- import ts from "typescript";
2
- import { HttpParameterProgrammer } from "typia/lib/programmers/http/HttpParameterProgrammer";
3
-
4
- import { INestiaTransformContext } from "../options/INestiaTransformProject";
5
-
6
- export namespace TypedParamProgrammer {
7
- export const generate = (props: {
8
- context: INestiaTransformContext;
9
- modulo: ts.LeftHandSideExpression;
10
- arguments: readonly ts.Expression[];
11
- type: ts.Type;
12
- }): readonly ts.Expression[] => {
13
- // ALREADY BEING TRANSFORMED
14
- if (props.arguments.length !== 1) return props.arguments;
15
- return [
16
- props.arguments[0],
17
- HttpParameterProgrammer.write({
18
- context: {
19
- ...props.context,
20
- options: {
21
- numeric: true,
22
- },
23
- },
24
- modulo: props.modulo,
25
- type: props.type,
26
- name: undefined,
27
- }),
28
- ...(props.context.options?.validate?.startsWith("validate")
29
- ? [ts.factory.createTrue()]
30
- : []),
31
- ];
32
- };
33
- }
1
+ import { HttpParameterProgrammer } from "@typia/core";
2
+ import ts from "typescript";
3
+
4
+ import { INestiaTransformContext } from "../options/INestiaTransformProject";
5
+
6
+ export namespace TypedParamProgrammer {
7
+ export const generate = (props: {
8
+ context: INestiaTransformContext;
9
+ modulo: ts.LeftHandSideExpression;
10
+ arguments: readonly ts.Expression[];
11
+ type: ts.Type;
12
+ }): readonly ts.Expression[] => {
13
+ // ALREADY BEING TRANSFORMED
14
+ if (props.arguments.length !== 1) return props.arguments;
15
+ return [
16
+ props.arguments[0]!,
17
+ HttpParameterProgrammer.write({
18
+ context: {
19
+ ...props.context,
20
+ options: {
21
+ numeric: true,
22
+ },
23
+ },
24
+ modulo: props.modulo,
25
+ type: props.type,
26
+ name: undefined,
27
+ }),
28
+ ...(props.context.options?.validate?.startsWith("validate")
29
+ ? [ts.factory.createTrue()]
30
+ : []),
31
+ ];
32
+ };
33
+ }