@nestia/core 4.4.1 → 4.4.2-dev.20241217

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 (88) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +87 -87
  3. package/lib/programmers/TypedBodyProgrammer.js +1 -2
  4. package/lib/programmers/TypedBodyProgrammer.js.map +1 -1
  5. package/lib/programmers/TypedQueryBodyProgrammer.js +6 -6
  6. package/lib/programmers/TypedQueryBodyProgrammer.js.map +1 -1
  7. package/lib/programmers/TypedQueryProgrammer.js +5 -5
  8. package/lib/programmers/TypedQueryProgrammer.js.map +1 -1
  9. package/lib/programmers/TypedQueryRouteProgrammer.js +5 -5
  10. package/lib/programmers/TypedQueryRouteProgrammer.js.map +1 -1
  11. package/lib/programmers/TypedRouteProgrammer.js +1 -2
  12. package/lib/programmers/TypedRouteProgrammer.js.map +1 -1
  13. package/package.json +3 -3
  14. package/src/adaptors/WebSocketAdaptor.ts +426 -426
  15. package/src/decorators/DynamicModule.ts +43 -43
  16. package/src/decorators/EncryptedBody.ts +101 -101
  17. package/src/decorators/EncryptedController.ts +38 -38
  18. package/src/decorators/EncryptedModule.ts +100 -100
  19. package/src/decorators/EncryptedRoute.ts +219 -219
  20. package/src/decorators/NoTransformConfigurationError.ts +32 -32
  21. package/src/decorators/PlainBody.ts +79 -79
  22. package/src/decorators/SwaggerCustomizer.ts +115 -115
  23. package/src/decorators/SwaggerExample.ts +100 -100
  24. package/src/decorators/TypedBody.ts +59 -59
  25. package/src/decorators/TypedException.ts +128 -128
  26. package/src/decorators/TypedFormData.ts +195 -195
  27. package/src/decorators/TypedHeaders.ts +64 -64
  28. package/src/decorators/TypedParam.ts +77 -77
  29. package/src/decorators/TypedQuery.ts +245 -245
  30. package/src/decorators/TypedRoute.ts +214 -214
  31. package/src/decorators/WebSocketRoute.ts +242 -242
  32. package/src/decorators/internal/EncryptedConstant.ts +4 -4
  33. package/src/decorators/internal/IWebSocketRouteReflect.ts +23 -23
  34. package/src/decorators/internal/NoTransformConfigureError.ts +2 -2
  35. package/src/decorators/internal/get_path_and_querify.ts +108 -108
  36. package/src/decorators/internal/get_path_and_stringify.ts +122 -122
  37. package/src/decorators/internal/get_text_body.ts +20 -20
  38. package/src/decorators/internal/headers_to_object.ts +13 -13
  39. package/src/decorators/internal/is_request_body_undefined.ts +14 -14
  40. package/src/decorators/internal/load_controller.ts +49 -49
  41. package/src/decorators/internal/route_error.ts +45 -45
  42. package/src/decorators/internal/validate_request_body.ts +74 -74
  43. package/src/decorators/internal/validate_request_form_data.ts +77 -77
  44. package/src/decorators/internal/validate_request_headers.ts +86 -86
  45. package/src/decorators/internal/validate_request_query.ts +74 -74
  46. package/src/index.ts +5 -5
  47. package/src/module.ts +21 -21
  48. package/src/options/INestiaTransformOptions.ts +38 -38
  49. package/src/options/INestiaTransformProject.ts +8 -8
  50. package/src/options/IRequestBodyValidator.ts +20 -20
  51. package/src/options/IRequestFormDataProps.ts +27 -27
  52. package/src/options/IRequestHeadersValidator.ts +22 -22
  53. package/src/options/IRequestQueryValidator.ts +20 -20
  54. package/src/options/IResponseBodyQuerifier.ts +25 -25
  55. package/src/options/IResponseBodyStringifier.ts +30 -30
  56. package/src/programmers/PlainBodyProgrammer.ts +70 -70
  57. package/src/programmers/TypedBodyProgrammer.ts +142 -143
  58. package/src/programmers/TypedFormDataBodyProgrammer.ts +118 -118
  59. package/src/programmers/TypedHeadersProgrammer.ts +63 -63
  60. package/src/programmers/TypedParamProgrammer.ts +33 -33
  61. package/src/programmers/TypedQueryBodyProgrammer.ts +112 -106
  62. package/src/programmers/TypedQueryProgrammer.ts +114 -108
  63. package/src/programmers/TypedQueryRouteProgrammer.ts +105 -99
  64. package/src/programmers/TypedRouteProgrammer.ts +94 -95
  65. package/src/programmers/http/HttpAssertQuerifyProgrammer.ts +72 -72
  66. package/src/programmers/http/HttpIsQuerifyProgrammer.ts +75 -75
  67. package/src/programmers/http/HttpQuerifyProgrammer.ts +108 -108
  68. package/src/programmers/http/HttpValidateQuerifyProgrammer.ts +76 -76
  69. package/src/programmers/internal/CoreMetadataUtil.ts +21 -21
  70. package/src/transform.ts +35 -35
  71. package/src/transformers/FileTransformer.ts +110 -110
  72. package/src/transformers/MethodTransformer.ts +103 -103
  73. package/src/transformers/NodeTransformer.ts +23 -23
  74. package/src/transformers/ParameterDecoratorTransformer.ts +143 -143
  75. package/src/transformers/ParameterTransformer.ts +57 -57
  76. package/src/transformers/TypedRouteTransformer.ts +85 -85
  77. package/src/transformers/WebSocketRouteTransformer.ts +120 -120
  78. package/src/typings/Creator.ts +3 -3
  79. package/src/typings/get-function-location.d.ts +7 -7
  80. package/src/utils/ArrayUtil.ts +7 -7
  81. package/src/utils/ExceptionManager.ts +112 -112
  82. package/src/utils/Singleton.ts +20 -20
  83. package/src/utils/SourceFinder.ts +57 -57
  84. package/src/utils/VersioningStrategy.ts +27 -27
  85. package/lib/programmers/internal/LlmValidatePredicator.d.ts +0 -5
  86. package/lib/programmers/internal/LlmValidatePredicator.js +0 -18
  87. package/lib/programmers/internal/LlmValidatePredicator.js.map +0 -1
  88. package/src/programmers/internal/LlmValidatePredicator.ts +0 -16
@@ -1,70 +1,70 @@
1
- import ts from "typescript";
2
- import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
3
- import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
4
- import { AssertProgrammer } from "typia/lib/programmers/AssertProgrammer";
5
- import { Metadata } from "typia/lib/schemas/metadata/Metadata";
6
- import { TransformerError } from "typia/lib/transformers/TransformerError";
7
-
8
- import { INestiaTransformContext } from "../options/INestiaTransformProject";
9
-
10
- export namespace PlainBodyProgrammer {
11
- export const generate = (props: {
12
- context: INestiaTransformContext;
13
- modulo: ts.LeftHandSideExpression;
14
- type: ts.Type;
15
- }): ts.Expression => {
16
- const result = MetadataFactory.analyze({
17
- checker: props.context.checker,
18
- transformer: props.context.transformer,
19
- options: {
20
- escape: false,
21
- constant: true,
22
- absorb: true,
23
- validate,
24
- },
25
- collection: new MetadataCollection(),
26
- type: props.type,
27
- });
28
- if (result.success === false)
29
- throw TransformerError.from({
30
- code: "nestia.core.TypedParam",
31
- errors: result.errors,
32
- });
33
- return AssertProgrammer.write({
34
- context: {
35
- ...props.context,
36
- options: {
37
- numeric: false,
38
- finite: false,
39
- functional: false,
40
- },
41
- },
42
- modulo: props.modulo,
43
- config: {
44
- equals: false,
45
- guard: false,
46
- },
47
- type: props.type,
48
- name: undefined,
49
- });
50
- };
51
- }
52
-
53
- const validate = (metadata: Metadata): string[] => {
54
- const errors: string[] = [];
55
- const insert = (msg: string) => errors.push(msg);
56
-
57
- const expected: number =
58
- (metadata.atomics.some((a) => a.type === "string") ? 1 : 0) +
59
- metadata.templates.length +
60
- metadata.constants
61
- .filter((c) => c.type === "string")
62
- .map((c) => c.values.length)
63
- .reduce((a, b) => a + b, 0);
64
- if (expected === 0 || expected !== metadata.size())
65
- insert(`only string type is allowed`);
66
- if (metadata.nullable === true) insert(`do not allow nullable type`);
67
- else if (metadata.any === true) insert(`do not allow any type`);
68
-
69
- return errors;
70
- };
1
+ import ts from "typescript";
2
+ import { MetadataCollection } from "typia/lib/factories/MetadataCollection";
3
+ import { MetadataFactory } from "typia/lib/factories/MetadataFactory";
4
+ import { AssertProgrammer } from "typia/lib/programmers/AssertProgrammer";
5
+ import { Metadata } from "typia/lib/schemas/metadata/Metadata";
6
+ import { TransformerError } from "typia/lib/transformers/TransformerError";
7
+
8
+ import { INestiaTransformContext } from "../options/INestiaTransformProject";
9
+
10
+ export namespace PlainBodyProgrammer {
11
+ export const generate = (props: {
12
+ context: INestiaTransformContext;
13
+ modulo: ts.LeftHandSideExpression;
14
+ type: ts.Type;
15
+ }): ts.Expression => {
16
+ const result = MetadataFactory.analyze({
17
+ checker: props.context.checker,
18
+ transformer: props.context.transformer,
19
+ options: {
20
+ escape: false,
21
+ constant: true,
22
+ absorb: true,
23
+ validate,
24
+ },
25
+ collection: new MetadataCollection(),
26
+ type: props.type,
27
+ });
28
+ if (result.success === false)
29
+ throw TransformerError.from({
30
+ code: "nestia.core.TypedParam",
31
+ errors: result.errors,
32
+ });
33
+ return AssertProgrammer.write({
34
+ context: {
35
+ ...props.context,
36
+ options: {
37
+ numeric: false,
38
+ finite: false,
39
+ functional: false,
40
+ },
41
+ },
42
+ modulo: props.modulo,
43
+ config: {
44
+ equals: false,
45
+ guard: false,
46
+ },
47
+ type: props.type,
48
+ name: undefined,
49
+ });
50
+ };
51
+ }
52
+
53
+ const validate = (metadata: Metadata): string[] => {
54
+ const errors: string[] = [];
55
+ const insert = (msg: string) => errors.push(msg);
56
+
57
+ const expected: number =
58
+ (metadata.atomics.some((a) => a.type === "string") ? 1 : 0) +
59
+ metadata.templates.length +
60
+ metadata.constants
61
+ .filter((c) => c.type === "string")
62
+ .map((c) => c.values.length)
63
+ .reduce((a, b) => a + b, 0);
64
+ if (expected === 0 || expected !== metadata.size())
65
+ insert(`only string type is allowed`);
66
+ if (metadata.nullable === true) insert(`do not allow nullable type`);
67
+ else if (metadata.any === true) insert(`do not allow any type`);
68
+
69
+ return errors;
70
+ };
@@ -1,143 +1,142 @@
1
- import ts from "typescript";
2
- import { JsonMetadataFactory } from "typia/lib/factories/JsonMetadataFactory";
3
- import { AssertProgrammer } from "typia/lib/programmers/AssertProgrammer";
4
- import { IsProgrammer } from "typia/lib/programmers/IsProgrammer";
5
- import { ValidateProgrammer } from "typia/lib/programmers/ValidateProgrammer";
6
- import { LlmSchemaProgrammer } from "typia/lib/programmers/llm/LlmSchemaProgrammer";
7
- import { MiscAssertCloneProgrammer } from "typia/lib/programmers/misc/MiscAssertCloneProgrammer";
8
- import { MiscAssertPruneProgrammer } from "typia/lib/programmers/misc/MiscAssertPruneProgrammer";
9
- import { MiscValidateCloneProgrammer } from "typia/lib/programmers/misc/MiscValidateCloneProgrammer";
10
- import { MiscValidatePruneProgrammer } from "typia/lib/programmers/misc/MiscValidatePruneProgrammer";
11
- import { ITypiaContext } from "typia/lib/transformers/ITypiaContext";
12
-
13
- import { INestiaTransformContext } from "../options/INestiaTransformProject";
14
- import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
15
- import { LlmValidatePredicator } from "./internal/LlmValidatePredicator";
16
-
17
- export namespace TypedBodyProgrammer {
18
- export const generate = (props: {
19
- context: INestiaTransformContext;
20
- modulo: ts.LeftHandSideExpression;
21
- type: ts.Type;
22
- }): ts.ObjectLiteralExpression => {
23
- // VALIDATE TYPE
24
- JsonMetadataFactory.analyze({
25
- method: "@nestia.core.TypedBody",
26
- checker: props.context.checker,
27
- transformer: props.context.transformer,
28
- type: props.type,
29
- validate: LlmValidatePredicator.is(props.context.options.llm)
30
- ? LlmSchemaProgrammer.validate({
31
- model: props.context.options.llm.model,
32
- config: {
33
- strict: props.context.options.llm.strict,
34
- recursive: props.context.options.llm.recursive,
35
- },
36
- })
37
- : undefined,
38
- });
39
-
40
- // GENERATE VALIDATION PLAN
41
- const check =
42
- (key: IRequestBodyValidator<any>["type"]) =>
43
- (equals: boolean) =>
44
- (
45
- programmer: (next: {
46
- context: ITypiaContext;
47
- modulo: ts.LeftHandSideExpression;
48
- config: {
49
- equals: boolean;
50
- guard: boolean;
51
- };
52
- type: ts.Type;
53
- name: string | undefined;
54
- }) => ts.Expression,
55
- ) =>
56
- ts.factory.createObjectLiteralExpression([
57
- ts.factory.createPropertyAssignment(
58
- ts.factory.createIdentifier("type"),
59
- ts.factory.createStringLiteral(key),
60
- ),
61
- ts.factory.createPropertyAssignment(
62
- ts.factory.createIdentifier(key),
63
- programmer({
64
- context: {
65
- ...props.context,
66
- options: {
67
- numeric: false,
68
- finite: false,
69
- functional: false,
70
- },
71
- },
72
- modulo: props.modulo,
73
- config: {
74
- equals,
75
- guard: false,
76
- },
77
- type: props.type,
78
- name: undefined,
79
- }),
80
- ),
81
- ]);
82
- const misc =
83
- (key: IRequestBodyValidator<any>["type"]) =>
84
- (
85
- programmer: (next: {
86
- context: ITypiaContext;
87
- modulo: ts.LeftHandSideExpression;
88
- type: ts.Type;
89
- name: string | undefined;
90
- }) => ts.Expression,
91
- ) =>
92
- ts.factory.createObjectLiteralExpression([
93
- ts.factory.createPropertyAssignment(
94
- ts.factory.createIdentifier("type"),
95
- ts.factory.createStringLiteral(key),
96
- ),
97
- ts.factory.createPropertyAssignment(
98
- ts.factory.createIdentifier(key),
99
- programmer({
100
- context: {
101
- ...props.context,
102
- options: {
103
- numeric: false,
104
- finite: false,
105
- functional: false,
106
- },
107
- },
108
- modulo: props.modulo,
109
- type: props.type,
110
- name: undefined,
111
- }),
112
- ),
113
- ]);
114
-
115
- //----
116
- // RETURNS
117
- //----
118
- const category = props.context.options.validate;
119
- // NORMAL
120
- if (category === "is") return check("is")(false)(IsProgrammer.write);
121
- else if (category === "validate")
122
- return check("validate")(false)(ValidateProgrammer.write);
123
- // STRICT
124
- else if (category === "validateEquals")
125
- return check("validate")(true)(ValidateProgrammer.write);
126
- else if (category === "equals")
127
- return check("is")(true)(IsProgrammer.write);
128
- else if (category === "assertEquals")
129
- return check("assert")(true)(AssertProgrammer.write);
130
- // CLONE
131
- else if (category === "assertClone")
132
- return misc("assert")(MiscAssertCloneProgrammer.write);
133
- else if (category === "validateClone")
134
- return misc("validate")(MiscValidateCloneProgrammer.write);
135
- // PRUNE
136
- else if (category === "assertPrune")
137
- return misc("assert")(MiscAssertPruneProgrammer.write);
138
- else if (category === "validatePrune")
139
- return misc("validate")(MiscValidatePruneProgrammer.write);
140
- // DEFAULT
141
- return check("assert")(false)(AssertProgrammer.write);
142
- };
143
- }
1
+ import ts from "typescript";
2
+ import { JsonMetadataFactory } from "typia/lib/factories/JsonMetadataFactory";
3
+ import { AssertProgrammer } from "typia/lib/programmers/AssertProgrammer";
4
+ import { IsProgrammer } from "typia/lib/programmers/IsProgrammer";
5
+ import { ValidateProgrammer } from "typia/lib/programmers/ValidateProgrammer";
6
+ import { LlmSchemaProgrammer } from "typia/lib/programmers/llm/LlmSchemaProgrammer";
7
+ import { MiscAssertCloneProgrammer } from "typia/lib/programmers/misc/MiscAssertCloneProgrammer";
8
+ import { MiscAssertPruneProgrammer } from "typia/lib/programmers/misc/MiscAssertPruneProgrammer";
9
+ import { MiscValidateCloneProgrammer } from "typia/lib/programmers/misc/MiscValidateCloneProgrammer";
10
+ import { MiscValidatePruneProgrammer } from "typia/lib/programmers/misc/MiscValidatePruneProgrammer";
11
+ import { ITypiaContext } from "typia/lib/transformers/ITypiaContext";
12
+
13
+ import { INestiaTransformContext } from "../options/INestiaTransformProject";
14
+ import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
15
+
16
+ export namespace TypedBodyProgrammer {
17
+ export const generate = (props: {
18
+ context: INestiaTransformContext;
19
+ modulo: ts.LeftHandSideExpression;
20
+ type: ts.Type;
21
+ }): ts.ObjectLiteralExpression => {
22
+ // VALIDATE TYPE
23
+ JsonMetadataFactory.analyze({
24
+ method: "@nestia.core.TypedBody",
25
+ checker: props.context.checker,
26
+ transformer: props.context.transformer,
27
+ type: props.type,
28
+ validate: props.context.options.llm
29
+ ? LlmSchemaProgrammer.validate({
30
+ model: props.context.options.llm.model,
31
+ config: {
32
+ strict: props.context.options.llm.strict,
33
+ recursive: props.context.options.llm.recursive,
34
+ },
35
+ })
36
+ : undefined,
37
+ });
38
+
39
+ // GENERATE VALIDATION PLAN
40
+ const check =
41
+ (key: IRequestBodyValidator<any>["type"]) =>
42
+ (equals: boolean) =>
43
+ (
44
+ programmer: (next: {
45
+ context: ITypiaContext;
46
+ modulo: ts.LeftHandSideExpression;
47
+ config: {
48
+ equals: boolean;
49
+ guard: boolean;
50
+ };
51
+ type: ts.Type;
52
+ name: string | undefined;
53
+ }) => ts.Expression,
54
+ ) =>
55
+ ts.factory.createObjectLiteralExpression([
56
+ ts.factory.createPropertyAssignment(
57
+ ts.factory.createIdentifier("type"),
58
+ ts.factory.createStringLiteral(key),
59
+ ),
60
+ ts.factory.createPropertyAssignment(
61
+ ts.factory.createIdentifier(key),
62
+ programmer({
63
+ context: {
64
+ ...props.context,
65
+ options: {
66
+ numeric: false,
67
+ finite: false,
68
+ functional: false,
69
+ },
70
+ },
71
+ modulo: props.modulo,
72
+ config: {
73
+ equals,
74
+ guard: false,
75
+ },
76
+ type: props.type,
77
+ name: undefined,
78
+ }),
79
+ ),
80
+ ]);
81
+ const misc =
82
+ (key: IRequestBodyValidator<any>["type"]) =>
83
+ (
84
+ programmer: (next: {
85
+ context: ITypiaContext;
86
+ modulo: ts.LeftHandSideExpression;
87
+ type: ts.Type;
88
+ name: string | undefined;
89
+ }) => ts.Expression,
90
+ ) =>
91
+ ts.factory.createObjectLiteralExpression([
92
+ ts.factory.createPropertyAssignment(
93
+ ts.factory.createIdentifier("type"),
94
+ ts.factory.createStringLiteral(key),
95
+ ),
96
+ ts.factory.createPropertyAssignment(
97
+ ts.factory.createIdentifier(key),
98
+ programmer({
99
+ context: {
100
+ ...props.context,
101
+ options: {
102
+ numeric: false,
103
+ finite: false,
104
+ functional: false,
105
+ },
106
+ },
107
+ modulo: props.modulo,
108
+ type: props.type,
109
+ name: undefined,
110
+ }),
111
+ ),
112
+ ]);
113
+
114
+ //----
115
+ // RETURNS
116
+ //----
117
+ const category = props.context.options.validate;
118
+ // NORMAL
119
+ if (category === "is") return check("is")(false)(IsProgrammer.write);
120
+ else if (category === "validate")
121
+ return check("validate")(false)(ValidateProgrammer.write);
122
+ // STRICT
123
+ else if (category === "validateEquals")
124
+ return check("validate")(true)(ValidateProgrammer.write);
125
+ else if (category === "equals")
126
+ return check("is")(true)(IsProgrammer.write);
127
+ else if (category === "assertEquals")
128
+ return check("assert")(true)(AssertProgrammer.write);
129
+ // CLONE
130
+ else if (category === "assertClone")
131
+ return misc("assert")(MiscAssertCloneProgrammer.write);
132
+ else if (category === "validateClone")
133
+ return misc("validate")(MiscValidateCloneProgrammer.write);
134
+ // PRUNE
135
+ else if (category === "assertPrune")
136
+ return misc("assert")(MiscAssertPruneProgrammer.write);
137
+ else if (category === "validatePrune")
138
+ return misc("validate")(MiscValidatePruneProgrammer.write);
139
+ // DEFAULT
140
+ return check("assert")(false)(AssertProgrammer.write);
141
+ };
142
+ }