@nestia/sdk 4.6.1-dev.20250117 → 4.6.2

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 (122) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +92 -87
  3. package/assets/bundle/api/HttpError.ts +1 -1
  4. package/assets/bundle/api/IConnection.ts +1 -1
  5. package/assets/bundle/api/Primitive.ts +1 -1
  6. package/assets/bundle/api/Resolved.ts +1 -1
  7. package/assets/bundle/api/index.ts +4 -4
  8. package/assets/bundle/api/module.ts +6 -6
  9. package/assets/bundle/distribute/README.md +37 -37
  10. package/assets/bundle/distribute/package.json +28 -28
  11. package/assets/bundle/distribute/tsconfig.json +109 -109
  12. package/assets/bundle/e2e/index.ts +42 -42
  13. package/assets/config/nestia.config.ts +97 -97
  14. package/lib/INestiaConfig.d.ts +2 -2
  15. package/lib/analyses/GenericAnalyzer.js +1 -1
  16. package/lib/executable/internal/NestiaConfigLoader.js +4 -4
  17. package/lib/executable/sdk.js +12 -12
  18. package/lib/generates/SdkGenerator.js +2 -2
  19. package/lib/generates/SdkGenerator.js.map +1 -1
  20. package/lib/generates/internal/SdkHttpNamespaceProgrammer.js +3 -3
  21. package/lib/generates/internal/SdkHttpNamespaceProgrammer.js.map +1 -1
  22. package/lib/generates/internal/SdkHttpRouteProgrammer.js +1 -1
  23. package/lib/generates/internal/SdkTypeTagProgrammer.js +3 -16
  24. package/lib/generates/internal/SdkTypeTagProgrammer.js.map +1 -1
  25. package/lib/generates/internal/SdkWebSocketNamespaceProgrammer.js +3 -3
  26. package/lib/generates/internal/SdkWebSocketNamespaceProgrammer.js.map +1 -1
  27. package/lib/generates/internal/SwaggerOperationResponseComposer.js +1 -1
  28. package/lib/generates/internal/SwaggerOperationResponseComposer.js.map +1 -1
  29. package/package.json +7 -7
  30. package/src/INestiaConfig.ts +271 -271
  31. package/src/NestiaSdkApplication.ts +307 -307
  32. package/src/NestiaSwaggerComposer.ts +138 -138
  33. package/src/analyses/AccessorAnalyzer.ts +67 -67
  34. package/src/analyses/ConfigAnalyzer.ts +155 -155
  35. package/src/analyses/ExceptionAnalyzer.ts +154 -154
  36. package/src/analyses/GenericAnalyzer.ts +49 -49
  37. package/src/analyses/ImportAnalyzer.ts +171 -171
  38. package/src/analyses/PathAnalyzer.ts +69 -69
  39. package/src/analyses/ReflectControllerAnalyzer.ts +105 -105
  40. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  41. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +71 -71
  42. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +348 -348
  43. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +127 -127
  44. package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
  45. package/src/analyses/ReflectWebSocketOperationAnalyzer.ts +172 -172
  46. package/src/analyses/SecurityAnalyzer.ts +25 -25
  47. package/src/analyses/TypedHttpRouteAnalyzer.ts +186 -186
  48. package/src/analyses/TypedWebSocketRouteAnalyzer.ts +18 -18
  49. package/src/decorators/OperationMetadata.ts +15 -15
  50. package/src/executable/internal/CommandParser.ts +15 -15
  51. package/src/executable/internal/NestiaConfigLoader.ts +78 -78
  52. package/src/executable/internal/NestiaSdkCommand.ts +103 -103
  53. package/src/executable/sdk.ts +75 -75
  54. package/src/generates/CloneGenerator.ts +66 -66
  55. package/src/generates/E2eGenerator.ts +32 -32
  56. package/src/generates/SdkGenerator.ts +159 -159
  57. package/src/generates/SwaggerGenerator.ts +292 -292
  58. package/src/generates/internal/E2eFileProgrammer.ts +183 -183
  59. package/src/generates/internal/FilePrinter.ts +53 -53
  60. package/src/generates/internal/ImportDictionary.ts +147 -147
  61. package/src/generates/internal/SdkAliasCollection.ts +185 -185
  62. package/src/generates/internal/SdkDistributionComposer.ts +103 -103
  63. package/src/generates/internal/SdkFileProgrammer.ts +116 -116
  64. package/src/generates/internal/SdkHttpCloneProgrammer.ts +124 -124
  65. package/src/generates/internal/SdkHttpCloneReferencer.ts +71 -71
  66. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +301 -301
  67. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +529 -529
  68. package/src/generates/internal/SdkHttpRouteProgrammer.ts +117 -117
  69. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +362 -362
  70. package/src/generates/internal/SdkImportWizard.ts +55 -55
  71. package/src/generates/internal/SdkRouteDirectory.ts +18 -18
  72. package/src/generates/internal/SdkTypeProgrammer.ts +377 -377
  73. package/src/generates/internal/SdkTypeTagProgrammer.ts +102 -120
  74. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +362 -363
  75. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +265 -265
  76. package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
  77. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  78. package/src/generates/internal/SwaggerOperationParameterComposer.ts +177 -177
  79. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  80. package/src/index.ts +4 -4
  81. package/src/module.ts +3 -3
  82. package/src/structures/INestiaProject.ts +13 -13
  83. package/src/structures/INestiaSdkInput.ts +20 -20
  84. package/src/structures/IReflectApplication.ts +8 -8
  85. package/src/structures/IReflectController.ts +15 -15
  86. package/src/structures/IReflectHttpOperation.ts +26 -26
  87. package/src/structures/IReflectHttpOperationException.ts +19 -19
  88. package/src/structures/IReflectHttpOperationParameter.ts +81 -81
  89. package/src/structures/IReflectHttpOperationSuccess.ts +22 -22
  90. package/src/structures/IReflectOperationError.ts +26 -26
  91. package/src/structures/IReflectType.ts +4 -4
  92. package/src/structures/IReflectTypeImport.ts +4 -4
  93. package/src/structures/IReflectWebSocketOperation.ts +17 -17
  94. package/src/structures/IReflectWebSocketOperationParameter.ts +38 -38
  95. package/src/structures/ITypedApplication.ts +11 -11
  96. package/src/structures/ITypedHttpRoute.ts +30 -30
  97. package/src/structures/ITypedHttpRouteException.ts +15 -15
  98. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  99. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  100. package/src/structures/ITypedWebSocketRoute.ts +20 -20
  101. package/src/structures/ITypedWebSocketRouteParameter.ts +3 -3
  102. package/src/structures/MethodType.ts +5 -5
  103. package/src/structures/ParamCategory.ts +1 -1
  104. package/src/structures/TypeEntry.ts +22 -22
  105. package/src/transform.ts +9 -9
  106. package/src/transformers/IOperationMetadata.ts +44 -44
  107. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  108. package/src/transformers/SdkOperationProgrammer.ts +209 -209
  109. package/src/transformers/SdkOperationTransformer.ts +253 -253
  110. package/src/transformers/TextPlainValidator.ts +17 -17
  111. package/src/typings/get-function-location.d.ts +7 -7
  112. package/src/utils/ArrayUtil.ts +26 -26
  113. package/src/utils/FileRetriever.ts +22 -22
  114. package/src/utils/MapUtil.ts +14 -14
  115. package/src/utils/MetadataUtil.ts +26 -26
  116. package/src/utils/PathUtil.ts +10 -10
  117. package/src/utils/SourceFinder.ts +66 -66
  118. package/src/utils/StringUtil.ts +17 -17
  119. package/src/utils/StripEnums.ts +5 -5
  120. package/src/utils/VersioningStrategy.ts +28 -28
  121. package/src/validators/HttpHeadersValidator.ts +34 -34
  122. package/src/validators/HttpQueryValidator.ts +34 -34
@@ -1,71 +1,71 @@
1
- import { TypedException } from "@nestia/core";
2
- import { JsonMetadataFactory } from "typia/lib/factories/JsonMetadataFactory";
3
-
4
- import { IReflectController } from "../structures/IReflectController";
5
- import { IReflectHttpOperationException } from "../structures/IReflectHttpOperationException";
6
- import { IReflectOperationError } from "../structures/IReflectOperationError";
7
- import { IOperationMetadata } from "../transformers/IOperationMetadata";
8
-
9
- export namespace ReflectHttpOperationExceptionAnalyzer {
10
- export interface IContext {
11
- controller: IReflectController;
12
- function: Function;
13
- functionName: string;
14
- httpMethod: string;
15
- metadata: IOperationMetadata;
16
- errors: IReflectOperationError[];
17
- }
18
- export const analyze = (
19
- ctx: IContext,
20
- ): Record<string, IReflectHttpOperationException> => {
21
- const preconfigured: TypedException.IProps<any>[] = analyzePreconfigured(
22
- ctx.function,
23
- )
24
- .slice()
25
- .reverse();
26
- const errors: IReflectOperationError[] = [];
27
- const exceptions: IReflectHttpOperationException[] = preconfigured
28
- .map((pre, i) => {
29
- const matched: IOperationMetadata.IException | null =
30
- ctx.metadata.exceptions[i];
31
- if (matched === undefined) {
32
- errors.push({
33
- file: ctx.controller.file,
34
- class: ctx.controller.class.name,
35
- function: ctx.functionName,
36
- from: `exception (status: ${pre.status})`,
37
- contents: ["Unable to find exception type."],
38
- });
39
- return null;
40
- } else if (matched.type === null) {
41
- errors.push({
42
- file: ctx.controller.file,
43
- class: ctx.controller.class.name,
44
- function: ctx.functionName,
45
- from: `exception (status: ${pre.status})`,
46
- contents: ["Failed to get the type info."],
47
- });
48
- }
49
- const schema: IOperationMetadata.ISchema | null = matched.primitive
50
- .success
51
- ? matched.primitive.data
52
- : null;
53
- if (schema === null || matched.type === null) return null; // unreachable
54
- return {
55
- status: pre.status,
56
- description: pre.description ?? null,
57
- example: pre.example,
58
- examples: pre.examples,
59
- type: matched.type,
60
- ...schema,
61
- validate: JsonMetadataFactory.validate,
62
- } satisfies IReflectHttpOperationException;
63
- })
64
- .filter((e) => e !== null);
65
- if (errors.length) ctx.errors.push(...errors);
66
- return Object.fromEntries(exceptions.map((e) => [e.status, e]));
67
- };
68
-
69
- const analyzePreconfigured = (func: Function): TypedException.IProps<any>[] =>
70
- Reflect.getMetadata("nestia/TypedException", func) ?? [];
71
- }
1
+ import { TypedException } from "@nestia/core";
2
+ import { JsonMetadataFactory } from "typia/lib/factories/JsonMetadataFactory";
3
+
4
+ import { IReflectController } from "../structures/IReflectController";
5
+ import { IReflectHttpOperationException } from "../structures/IReflectHttpOperationException";
6
+ import { IReflectOperationError } from "../structures/IReflectOperationError";
7
+ import { IOperationMetadata } from "../transformers/IOperationMetadata";
8
+
9
+ export namespace ReflectHttpOperationExceptionAnalyzer {
10
+ export interface IContext {
11
+ controller: IReflectController;
12
+ function: Function;
13
+ functionName: string;
14
+ httpMethod: string;
15
+ metadata: IOperationMetadata;
16
+ errors: IReflectOperationError[];
17
+ }
18
+ export const analyze = (
19
+ ctx: IContext,
20
+ ): Record<string, IReflectHttpOperationException> => {
21
+ const preconfigured: TypedException.IProps<any>[] = analyzePreconfigured(
22
+ ctx.function,
23
+ )
24
+ .slice()
25
+ .reverse();
26
+ const errors: IReflectOperationError[] = [];
27
+ const exceptions: IReflectHttpOperationException[] = preconfigured
28
+ .map((pre, i) => {
29
+ const matched: IOperationMetadata.IException | null =
30
+ ctx.metadata.exceptions[i];
31
+ if (matched === undefined) {
32
+ errors.push({
33
+ file: ctx.controller.file,
34
+ class: ctx.controller.class.name,
35
+ function: ctx.functionName,
36
+ from: `exception (status: ${pre.status})`,
37
+ contents: ["Unable to find exception type."],
38
+ });
39
+ return null;
40
+ } else if (matched.type === null) {
41
+ errors.push({
42
+ file: ctx.controller.file,
43
+ class: ctx.controller.class.name,
44
+ function: ctx.functionName,
45
+ from: `exception (status: ${pre.status})`,
46
+ contents: ["Failed to get the type info."],
47
+ });
48
+ }
49
+ const schema: IOperationMetadata.ISchema | null = matched.primitive
50
+ .success
51
+ ? matched.primitive.data
52
+ : null;
53
+ if (schema === null || matched.type === null) return null; // unreachable
54
+ return {
55
+ status: pre.status,
56
+ description: pre.description ?? null,
57
+ example: pre.example,
58
+ examples: pre.examples,
59
+ type: matched.type,
60
+ ...schema,
61
+ validate: JsonMetadataFactory.validate,
62
+ } satisfies IReflectHttpOperationException;
63
+ })
64
+ .filter((e) => e !== null);
65
+ if (errors.length) ctx.errors.push(...errors);
66
+ return Object.fromEntries(exceptions.map((e) => [e.status, e]));
67
+ };
68
+
69
+ const analyzePreconfigured = (func: Function): TypedException.IProps<any>[] =>
70
+ Reflect.getMetadata("nestia/TypedException", func) ?? [];
71
+ }