@nestia/sdk 11.0.0-dev.20260316 → 11.0.1

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 (65) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +93 -93
  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/executable/internal/NestiaConfigLoader.js +5 -5
  15. package/lib/executable/internal/NestiaConfigLoader.js.map +1 -1
  16. package/package.json +8 -8
  17. package/src/INestiaConfig.ts +267 -267
  18. package/src/NestiaSdkApplication.ts +307 -307
  19. package/src/NestiaSwaggerComposer.ts +143 -143
  20. package/src/analyses/AccessorAnalyzer.ts +67 -67
  21. package/src/analyses/DtoAnalyzer.ts +260 -260
  22. package/src/analyses/ImportAnalyzer.ts +126 -126
  23. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  24. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +72 -72
  25. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +350 -350
  26. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +126 -126
  27. package/src/analyses/TypedHttpRouteAnalyzer.ts +208 -208
  28. package/src/executable/internal/NestiaConfigLoader.ts +85 -85
  29. package/src/executable/internal/NestiaSdkCommand.ts +107 -107
  30. package/src/generates/SwaggerGenerator.ts +291 -291
  31. package/src/generates/internal/E2eFileProgrammer.ts +196 -196
  32. package/src/generates/internal/FilePrinter.ts +64 -64
  33. package/src/generates/internal/ImportDictionary.ts +192 -192
  34. package/src/generates/internal/SdkAliasCollection.ts +260 -260
  35. package/src/generates/internal/SdkFileProgrammer.ts +110 -110
  36. package/src/generates/internal/SdkHttpCloneProgrammer.ts +126 -126
  37. package/src/generates/internal/SdkHttpCloneReferencer.ts +77 -77
  38. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +278 -278
  39. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +502 -502
  40. package/src/generates/internal/SdkHttpRouteProgrammer.ts +109 -109
  41. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +312 -312
  42. package/src/generates/internal/SdkImportWizard.ts +62 -62
  43. package/src/generates/internal/SdkTypeProgrammer.ts +388 -388
  44. package/src/generates/internal/SdkTypeTagProgrammer.ts +114 -114
  45. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +379 -379
  46. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +302 -302
  47. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  48. package/src/generates/internal/SwaggerOperationParameterComposer.ts +161 -161
  49. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  50. package/src/module.ts +4 -4
  51. package/src/structures/IReflectHttpOperationException.ts +18 -18
  52. package/src/structures/IReflectHttpOperationParameter.ts +79 -79
  53. package/src/structures/IReflectHttpOperationSuccess.ts +21 -21
  54. package/src/structures/ITypedApplication.ts +11 -11
  55. package/src/structures/ITypedHttpRouteException.ts +15 -15
  56. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  57. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  58. package/src/transformers/IOperationMetadata.ts +46 -46
  59. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  60. package/src/transformers/SdkOperationProgrammer.ts +240 -240
  61. package/src/transformers/SdkOperationTransformer.ts +248 -248
  62. package/src/transformers/TextPlainValidator.ts +17 -17
  63. package/src/utils/MetadataUtil.ts +26 -26
  64. package/src/validators/HttpHeadersValidator.ts +40 -40
  65. package/src/validators/HttpQueryValidator.ts +40 -40
@@ -1,72 +1,72 @@
1
- import { TypedException } from "@nestia/core";
2
- import { JsonMetadataFactory } from "@typia/core";
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
- if (ctx.functionName === "getOauthProfile") console.log(ctx.metadata);
33
- errors.push({
34
- file: ctx.controller.file,
35
- class: ctx.controller.class.name,
36
- function: ctx.functionName,
37
- from: `exception (status: ${pre.status})`,
38
- contents: ["Unable to find exception type."],
39
- });
40
- return null;
41
- } else if (matched.type === null) {
42
- errors.push({
43
- file: ctx.controller.file,
44
- class: ctx.controller.class.name,
45
- function: ctx.functionName,
46
- from: `exception (status: ${pre.status})`,
47
- contents: ["Failed to get the type info."],
48
- });
49
- }
50
- const schema: IOperationMetadata.ISchema | null = matched.primitive
51
- .success
52
- ? matched.primitive.data
53
- : null;
54
- if (schema === null || matched.type === null) return null; // unreachable
55
- return {
56
- status: pre.status,
57
- description: pre.description ?? null,
58
- example: pre.example,
59
- examples: pre.examples,
60
- type: matched.type,
61
- ...schema,
62
- validate: JsonMetadataFactory.validate,
63
- } satisfies IReflectHttpOperationException;
64
- })
65
- .filter((e) => e !== null);
66
- if (errors.length) ctx.errors.push(...errors);
67
- return Object.fromEntries(exceptions.map((e) => [e.status, e]));
68
- };
69
-
70
- const analyzePreconfigured = (func: Function): TypedException.IProps<any>[] =>
71
- Reflect.getMetadata("nestia/TypedException", func) ?? [];
72
- }
1
+ import { TypedException } from "@nestia/core";
2
+ import { JsonMetadataFactory } from "@typia/core";
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
+ if (ctx.functionName === "getOauthProfile") console.log(ctx.metadata);
33
+ errors.push({
34
+ file: ctx.controller.file,
35
+ class: ctx.controller.class.name,
36
+ function: ctx.functionName,
37
+ from: `exception (status: ${pre.status})`,
38
+ contents: ["Unable to find exception type."],
39
+ });
40
+ return null;
41
+ } else if (matched.type === null) {
42
+ errors.push({
43
+ file: ctx.controller.file,
44
+ class: ctx.controller.class.name,
45
+ function: ctx.functionName,
46
+ from: `exception (status: ${pre.status})`,
47
+ contents: ["Failed to get the type info."],
48
+ });
49
+ }
50
+ const schema: IOperationMetadata.ISchema | null = matched.primitive
51
+ .success
52
+ ? matched.primitive.data
53
+ : null;
54
+ if (schema === null || matched.type === null) return null; // unreachable
55
+ return {
56
+ status: pre.status,
57
+ description: pre.description ?? null,
58
+ example: pre.example,
59
+ examples: pre.examples,
60
+ type: matched.type,
61
+ ...schema,
62
+ validate: JsonMetadataFactory.validate,
63
+ } satisfies IReflectHttpOperationException;
64
+ })
65
+ .filter((e) => e !== null);
66
+ if (errors.length) ctx.errors.push(...errors);
67
+ return Object.fromEntries(exceptions.map((e) => [e.status, e]));
68
+ };
69
+
70
+ const analyzePreconfigured = (func: Function): TypedException.IProps<any>[] =>
71
+ Reflect.getMetadata("nestia/TypedException", func) ?? [];
72
+ }