@nestia/sdk 7.0.0-dev.20250607 → 7.0.0

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 (111) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +92 -92
  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 +4 -4
  15. package/lib/executable/sdk.js +12 -12
  16. package/package.json +5 -5
  17. package/src/INestiaConfig.ts +269 -269
  18. package/src/NestiaSdkApplication.ts +307 -307
  19. package/src/NestiaSwaggerComposer.ts +138 -138
  20. package/src/analyses/AccessorAnalyzer.ts +67 -67
  21. package/src/analyses/ConfigAnalyzer.ts +155 -155
  22. package/src/analyses/ExceptionAnalyzer.ts +154 -154
  23. package/src/analyses/GenericAnalyzer.ts +49 -49
  24. package/src/analyses/ImportAnalyzer.ts +171 -171
  25. package/src/analyses/PathAnalyzer.ts +69 -69
  26. package/src/analyses/ReflectControllerAnalyzer.ts +105 -105
  27. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  28. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +71 -71
  29. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +348 -348
  30. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +127 -127
  31. package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
  32. package/src/analyses/ReflectWebSocketOperationAnalyzer.ts +172 -172
  33. package/src/analyses/SecurityAnalyzer.ts +25 -25
  34. package/src/analyses/TypedHttpRouteAnalyzer.ts +204 -204
  35. package/src/analyses/TypedWebSocketRouteAnalyzer.ts +33 -33
  36. package/src/decorators/OperationMetadata.ts +15 -15
  37. package/src/executable/internal/CommandParser.ts +15 -15
  38. package/src/executable/internal/NestiaConfigLoader.ts +78 -78
  39. package/src/executable/internal/NestiaSdkCommand.ts +103 -103
  40. package/src/executable/sdk.ts +75 -75
  41. package/src/generates/CloneGenerator.ts +66 -66
  42. package/src/generates/E2eGenerator.ts +32 -32
  43. package/src/generates/SdkGenerator.ts +160 -160
  44. package/src/generates/SwaggerGenerator.ts +284 -284
  45. package/src/generates/internal/E2eFileProgrammer.ts +205 -205
  46. package/src/generates/internal/FilePrinter.ts +53 -53
  47. package/src/generates/internal/ImportDictionary.ts +163 -163
  48. package/src/generates/internal/SdkAliasCollection.ts +255 -255
  49. package/src/generates/internal/SdkDistributionComposer.ts +103 -103
  50. package/src/generates/internal/SdkFileProgrammer.ts +116 -116
  51. package/src/generates/internal/SdkHttpCloneProgrammer.ts +124 -124
  52. package/src/generates/internal/SdkHttpCloneReferencer.ts +75 -75
  53. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +276 -276
  54. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +500 -500
  55. package/src/generates/internal/SdkHttpParameterProgrammer.ts +178 -178
  56. package/src/generates/internal/SdkHttpRouteProgrammer.ts +107 -107
  57. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +340 -340
  58. package/src/generates/internal/SdkImportWizard.ts +55 -55
  59. package/src/generates/internal/SdkRouteDirectory.ts +18 -18
  60. package/src/generates/internal/SdkTypeProgrammer.ts +384 -384
  61. package/src/generates/internal/SdkTypeTagProgrammer.ts +102 -102
  62. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +366 -366
  63. package/src/generates/internal/SdkWebSocketParameterProgrammer.ts +87 -87
  64. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +279 -279
  65. package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
  66. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  67. package/src/generates/internal/SwaggerOperationParameterComposer.ts +177 -177
  68. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  69. package/src/index.ts +4 -4
  70. package/src/module.ts +3 -3
  71. package/src/structures/INestiaProject.ts +13 -13
  72. package/src/structures/INestiaSdkInput.ts +20 -20
  73. package/src/structures/IReflectApplication.ts +8 -8
  74. package/src/structures/IReflectController.ts +15 -15
  75. package/src/structures/IReflectHttpOperation.ts +26 -26
  76. package/src/structures/IReflectHttpOperationException.ts +19 -19
  77. package/src/structures/IReflectHttpOperationParameter.ts +81 -81
  78. package/src/structures/IReflectHttpOperationSuccess.ts +22 -22
  79. package/src/structures/IReflectOperationError.ts +26 -26
  80. package/src/structures/IReflectType.ts +4 -4
  81. package/src/structures/IReflectTypeImport.ts +4 -4
  82. package/src/structures/IReflectWebSocketOperation.ts +17 -17
  83. package/src/structures/IReflectWebSocketOperationParameter.ts +38 -38
  84. package/src/structures/ITypedApplication.ts +11 -11
  85. package/src/structures/ITypedHttpRoute.ts +41 -41
  86. package/src/structures/ITypedHttpRouteException.ts +15 -15
  87. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  88. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  89. package/src/structures/ITypedWebSocketRoute.ts +24 -24
  90. package/src/structures/ITypedWebSocketRouteParameter.ts +3 -3
  91. package/src/structures/MethodType.ts +5 -5
  92. package/src/structures/ParamCategory.ts +1 -1
  93. package/src/structures/TypeEntry.ts +22 -22
  94. package/src/transform.ts +9 -9
  95. package/src/transformers/IOperationMetadata.ts +44 -44
  96. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  97. package/src/transformers/SdkOperationProgrammer.ts +209 -209
  98. package/src/transformers/SdkOperationTransformer.ts +253 -253
  99. package/src/transformers/TextPlainValidator.ts +17 -17
  100. package/src/typings/get-function-location.d.ts +7 -7
  101. package/src/utils/ArrayUtil.ts +26 -26
  102. package/src/utils/FileRetriever.ts +22 -22
  103. package/src/utils/MapUtil.ts +14 -14
  104. package/src/utils/MetadataUtil.ts +26 -26
  105. package/src/utils/PathUtil.ts +10 -10
  106. package/src/utils/SourceFinder.ts +66 -66
  107. package/src/utils/StringUtil.ts +17 -17
  108. package/src/utils/StripEnums.ts +5 -5
  109. package/src/utils/VersioningStrategy.ts +28 -28
  110. package/src/validators/HttpHeadersValidator.ts +34 -34
  111. package/src/validators/HttpQueryValidator.ts +34 -34
@@ -1,163 +1,163 @@
1
- import path from "path";
2
- import { HashMap, HashSet, Pair } from "tstl";
3
- import ts from "typescript";
4
-
5
- import { FilePrinter } from "./FilePrinter";
6
-
7
- export class ImportDictionary {
8
- private readonly components_: HashMap<Pair<string, boolean>, IComposition> =
9
- new HashMap();
10
-
11
- public constructor(public readonly file: string) {}
12
-
13
- public empty(): boolean {
14
- return this.components_.empty();
15
- }
16
-
17
- public external(props: ImportDictionary.IExternalProps): string {
18
- const key: string = `node_modules/${props.library}`;
19
- const composition: IComposition = this.components_.take(
20
- new Pair(key, props.type),
21
- () => ({
22
- location: key,
23
- elements: new HashSet(),
24
- default: false,
25
- type: props.type,
26
- }),
27
- );
28
- if (props.instance === null) composition.default = true;
29
- else composition.elements.insert(props.instance);
30
- return props.instance ?? props.library;
31
- }
32
-
33
- public internal(props: ImportDictionary.IInternalProps): string {
34
- const file: string = normalize(
35
- (() => {
36
- if (props.file.substring(props.file.length - 5) === ".d.ts")
37
- return props.file.substring(0, props.file.length - 5);
38
- else if (props.file.substring(props.file.length - 3) === ".ts")
39
- return props.file.substring(0, props.file.length - 3);
40
- return props.file;
41
- })(),
42
- );
43
- const composition: IComposition = this.components_.take(
44
- new Pair(file, props.type),
45
- () => ({
46
- location: file,
47
- elements: new HashSet(),
48
- default: false,
49
- type: props.type,
50
- }),
51
- );
52
- if (props.instance === null) {
53
- composition.default = true;
54
- if (props.name) composition.name = props.name;
55
- } else composition.elements.insert(props.instance);
56
- return props.instance ?? file;
57
- }
58
-
59
- public toStatements(outDir: string): ts.Statement[] {
60
- outDir = path.resolve(outDir);
61
- const external: ts.ImportDeclaration[] = [];
62
- const internal: ts.ImportDeclaration[] = [];
63
-
64
- const locator = (str: string) => {
65
- const location: string = path
66
- .relative(outDir, str)
67
- .split(path.sep)
68
- .join("/");
69
- const index: number = location.lastIndexOf(NODE_MODULES);
70
- return index === -1
71
- ? location.startsWith("..")
72
- ? location
73
- : `./${location}`
74
- : location.substring(index + NODE_MODULES.length);
75
- };
76
- const enroll =
77
- (filter: (str: string) => boolean) =>
78
- (container: ts.ImportDeclaration[]) => {
79
- const compositions: IComposition[] = this.components_
80
- .toJSON()
81
- .filter((c) => filter(c.second.location))
82
- .map((e) => ({
83
- ...e.second,
84
- location: locator(e.second.location),
85
- }))
86
- .sort((a, b) => a.location.localeCompare(b.location));
87
- for (const c of compositions) {
88
- const brackets: string[] = [];
89
- if (c.default) brackets.push(c.name ?? c.location);
90
- if (c.elements.empty() === false)
91
- brackets.push(
92
- `{ ${c.elements
93
- .toJSON()
94
- .sort((a, b) => a.localeCompare(b))
95
- .join(", ")} }`,
96
- );
97
- container.push(
98
- ts.factory.createImportDeclaration(
99
- undefined,
100
- ts.factory.createImportClause(
101
- c.type,
102
- c.default
103
- ? ts.factory.createIdentifier(c.name ?? c.location)
104
- : undefined,
105
- c.elements.empty() === false
106
- ? ts.factory.createNamedImports(
107
- [...c.elements].map((elem) =>
108
- ts.factory.createImportSpecifier(
109
- false,
110
- undefined,
111
- ts.factory.createIdentifier(elem),
112
- ),
113
- ),
114
- )
115
- : undefined,
116
- ),
117
- ts.factory.createStringLiteral(c.location),
118
- ),
119
- );
120
- }
121
- };
122
-
123
- enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
124
- enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
125
- return [
126
- ...external,
127
- ...(external.length && internal.length ? [FilePrinter.enter()] : []),
128
- ...internal,
129
- ];
130
- }
131
- }
132
- export namespace ImportDictionary {
133
- export interface IExternalProps {
134
- type: boolean;
135
- library: string;
136
- instance: string | null;
137
- }
138
- export interface IInternalProps {
139
- type: boolean;
140
- file: string;
141
- instance: string | null;
142
- name?: string | null;
143
- }
144
- }
145
-
146
- interface IComposition {
147
- location: string;
148
- type: boolean;
149
- default: boolean;
150
- name?: string;
151
- elements: HashSet<string>;
152
- }
153
-
154
- const NODE_MODULES = "node_modules/";
155
-
156
- const normalize = (file: string): string => {
157
- file = path.resolve(file);
158
- if (file.includes(`node_modules${path.sep}`))
159
- file =
160
- "node_modules/" +
161
- file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
162
- return file;
163
- };
1
+ import path from "path";
2
+ import { HashMap, HashSet, Pair } from "tstl";
3
+ import ts from "typescript";
4
+
5
+ import { FilePrinter } from "./FilePrinter";
6
+
7
+ export class ImportDictionary {
8
+ private readonly components_: HashMap<Pair<string, boolean>, IComposition> =
9
+ new HashMap();
10
+
11
+ public constructor(public readonly file: string) {}
12
+
13
+ public empty(): boolean {
14
+ return this.components_.empty();
15
+ }
16
+
17
+ public external(props: ImportDictionary.IExternalProps): string {
18
+ const key: string = `node_modules/${props.library}`;
19
+ const composition: IComposition = this.components_.take(
20
+ new Pair(key, props.type),
21
+ () => ({
22
+ location: key,
23
+ elements: new HashSet(),
24
+ default: false,
25
+ type: props.type,
26
+ }),
27
+ );
28
+ if (props.instance === null) composition.default = true;
29
+ else composition.elements.insert(props.instance);
30
+ return props.instance ?? props.library;
31
+ }
32
+
33
+ public internal(props: ImportDictionary.IInternalProps): string {
34
+ const file: string = normalize(
35
+ (() => {
36
+ if (props.file.substring(props.file.length - 5) === ".d.ts")
37
+ return props.file.substring(0, props.file.length - 5);
38
+ else if (props.file.substring(props.file.length - 3) === ".ts")
39
+ return props.file.substring(0, props.file.length - 3);
40
+ return props.file;
41
+ })(),
42
+ );
43
+ const composition: IComposition = this.components_.take(
44
+ new Pair(file, props.type),
45
+ () => ({
46
+ location: file,
47
+ elements: new HashSet(),
48
+ default: false,
49
+ type: props.type,
50
+ }),
51
+ );
52
+ if (props.instance === null) {
53
+ composition.default = true;
54
+ if (props.name) composition.name = props.name;
55
+ } else composition.elements.insert(props.instance);
56
+ return props.instance ?? file;
57
+ }
58
+
59
+ public toStatements(outDir: string): ts.Statement[] {
60
+ outDir = path.resolve(outDir);
61
+ const external: ts.ImportDeclaration[] = [];
62
+ const internal: ts.ImportDeclaration[] = [];
63
+
64
+ const locator = (str: string) => {
65
+ const location: string = path
66
+ .relative(outDir, str)
67
+ .split(path.sep)
68
+ .join("/");
69
+ const index: number = location.lastIndexOf(NODE_MODULES);
70
+ return index === -1
71
+ ? location.startsWith("..")
72
+ ? location
73
+ : `./${location}`
74
+ : location.substring(index + NODE_MODULES.length);
75
+ };
76
+ const enroll =
77
+ (filter: (str: string) => boolean) =>
78
+ (container: ts.ImportDeclaration[]) => {
79
+ const compositions: IComposition[] = this.components_
80
+ .toJSON()
81
+ .filter((c) => filter(c.second.location))
82
+ .map((e) => ({
83
+ ...e.second,
84
+ location: locator(e.second.location),
85
+ }))
86
+ .sort((a, b) => a.location.localeCompare(b.location));
87
+ for (const c of compositions) {
88
+ const brackets: string[] = [];
89
+ if (c.default) brackets.push(c.name ?? c.location);
90
+ if (c.elements.empty() === false)
91
+ brackets.push(
92
+ `{ ${c.elements
93
+ .toJSON()
94
+ .sort((a, b) => a.localeCompare(b))
95
+ .join(", ")} }`,
96
+ );
97
+ container.push(
98
+ ts.factory.createImportDeclaration(
99
+ undefined,
100
+ ts.factory.createImportClause(
101
+ c.type,
102
+ c.default
103
+ ? ts.factory.createIdentifier(c.name ?? c.location)
104
+ : undefined,
105
+ c.elements.empty() === false
106
+ ? ts.factory.createNamedImports(
107
+ [...c.elements].map((elem) =>
108
+ ts.factory.createImportSpecifier(
109
+ false,
110
+ undefined,
111
+ ts.factory.createIdentifier(elem),
112
+ ),
113
+ ),
114
+ )
115
+ : undefined,
116
+ ),
117
+ ts.factory.createStringLiteral(c.location),
118
+ ),
119
+ );
120
+ }
121
+ };
122
+
123
+ enroll((str) => str.indexOf(NODE_MODULES) !== -1)(external);
124
+ enroll((str) => str.indexOf(NODE_MODULES) === -1)(internal);
125
+ return [
126
+ ...external,
127
+ ...(external.length && internal.length ? [FilePrinter.enter()] : []),
128
+ ...internal,
129
+ ];
130
+ }
131
+ }
132
+ export namespace ImportDictionary {
133
+ export interface IExternalProps {
134
+ type: boolean;
135
+ library: string;
136
+ instance: string | null;
137
+ }
138
+ export interface IInternalProps {
139
+ type: boolean;
140
+ file: string;
141
+ instance: string | null;
142
+ name?: string | null;
143
+ }
144
+ }
145
+
146
+ interface IComposition {
147
+ location: string;
148
+ type: boolean;
149
+ default: boolean;
150
+ name?: string;
151
+ elements: HashSet<string>;
152
+ }
153
+
154
+ const NODE_MODULES = "node_modules/";
155
+
156
+ const normalize = (file: string): string => {
157
+ file = path.resolve(file);
158
+ if (file.includes(`node_modules${path.sep}`))
159
+ file =
160
+ "node_modules/" +
161
+ file.split(`node_modules${path.sep}`).at(-1)!.split(path.sep).join("/");
162
+ return file;
163
+ };