@nestia/sdk 7.0.3 → 7.1.1-dev.20250714

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 (115) 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 +4 -4
  15. package/lib/executable/sdk.js +12 -12
  16. package/lib/generates/internal/SdkHttpFunctionProgrammer.js +1 -1
  17. package/lib/generates/internal/SdkHttpFunctionProgrammer.js.map +1 -1
  18. package/lib/generates/internal/SdkHttpSimulationProgrammer.js +7 -10
  19. package/lib/generates/internal/SdkHttpSimulationProgrammer.js.map +1 -1
  20. package/package.json +6 -11
  21. package/src/INestiaConfig.ts +269 -269
  22. package/src/NestiaSdkApplication.ts +307 -307
  23. package/src/NestiaSwaggerComposer.ts +138 -138
  24. package/src/analyses/AccessorAnalyzer.ts +67 -67
  25. package/src/analyses/ConfigAnalyzer.ts +155 -155
  26. package/src/analyses/ExceptionAnalyzer.ts +154 -154
  27. package/src/analyses/GenericAnalyzer.ts +49 -49
  28. package/src/analyses/ImportAnalyzer.ts +171 -171
  29. package/src/analyses/PathAnalyzer.ts +69 -69
  30. package/src/analyses/ReflectControllerAnalyzer.ts +105 -105
  31. package/src/analyses/ReflectHttpOperationAnalyzer.ts +183 -183
  32. package/src/analyses/ReflectHttpOperationExceptionAnalyzer.ts +71 -71
  33. package/src/analyses/ReflectHttpOperationParameterAnalyzer.ts +348 -348
  34. package/src/analyses/ReflectHttpOperationResponseAnalyzer.ts +127 -127
  35. package/src/analyses/ReflectMetadataAnalyzer.ts +44 -44
  36. package/src/analyses/ReflectWebSocketOperationAnalyzer.ts +172 -172
  37. package/src/analyses/SecurityAnalyzer.ts +25 -25
  38. package/src/analyses/TypedHttpRouteAnalyzer.ts +204 -204
  39. package/src/analyses/TypedWebSocketRouteAnalyzer.ts +33 -33
  40. package/src/decorators/OperationMetadata.ts +15 -15
  41. package/src/executable/internal/CommandParser.ts +15 -15
  42. package/src/executable/internal/NestiaConfigLoader.ts +78 -78
  43. package/src/executable/internal/NestiaSdkCommand.ts +103 -103
  44. package/src/executable/sdk.ts +75 -75
  45. package/src/generates/CloneGenerator.ts +66 -66
  46. package/src/generates/E2eGenerator.ts +32 -32
  47. package/src/generates/SdkGenerator.ts +160 -160
  48. package/src/generates/SwaggerGenerator.ts +284 -284
  49. package/src/generates/internal/E2eFileProgrammer.ts +205 -205
  50. package/src/generates/internal/FilePrinter.ts +53 -53
  51. package/src/generates/internal/ImportDictionary.ts +163 -163
  52. package/src/generates/internal/SdkAliasCollection.ts +255 -255
  53. package/src/generates/internal/SdkDistributionComposer.ts +103 -103
  54. package/src/generates/internal/SdkFileProgrammer.ts +116 -116
  55. package/src/generates/internal/SdkHttpCloneProgrammer.ts +124 -124
  56. package/src/generates/internal/SdkHttpCloneReferencer.ts +75 -75
  57. package/src/generates/internal/SdkHttpFunctionProgrammer.ts +279 -276
  58. package/src/generates/internal/SdkHttpNamespaceProgrammer.ts +500 -500
  59. package/src/generates/internal/SdkHttpParameterProgrammer.ts +178 -178
  60. package/src/generates/internal/SdkHttpRouteProgrammer.ts +107 -107
  61. package/src/generates/internal/SdkHttpSimulationProgrammer.ts +309 -340
  62. package/src/generates/internal/SdkImportWizard.ts +55 -55
  63. package/src/generates/internal/SdkRouteDirectory.ts +18 -18
  64. package/src/generates/internal/SdkTypeProgrammer.ts +384 -384
  65. package/src/generates/internal/SdkTypeTagProgrammer.ts +102 -102
  66. package/src/generates/internal/SdkWebSocketNamespaceProgrammer.ts +366 -366
  67. package/src/generates/internal/SdkWebSocketParameterProgrammer.ts +87 -87
  68. package/src/generates/internal/SdkWebSocketRouteProgrammer.ts +279 -279
  69. package/src/generates/internal/SwaggerDescriptionComposer.ts +64 -64
  70. package/src/generates/internal/SwaggerOperationComposer.ts +119 -119
  71. package/src/generates/internal/SwaggerOperationParameterComposer.ts +177 -177
  72. package/src/generates/internal/SwaggerOperationResponseComposer.ts +110 -110
  73. package/src/index.ts +4 -4
  74. package/src/module.ts +3 -3
  75. package/src/structures/INestiaProject.ts +13 -13
  76. package/src/structures/INestiaSdkInput.ts +20 -20
  77. package/src/structures/IReflectApplication.ts +8 -8
  78. package/src/structures/IReflectController.ts +15 -15
  79. package/src/structures/IReflectHttpOperation.ts +26 -26
  80. package/src/structures/IReflectHttpOperationException.ts +19 -19
  81. package/src/structures/IReflectHttpOperationParameter.ts +81 -81
  82. package/src/structures/IReflectHttpOperationSuccess.ts +22 -22
  83. package/src/structures/IReflectOperationError.ts +26 -26
  84. package/src/structures/IReflectType.ts +4 -4
  85. package/src/structures/IReflectTypeImport.ts +4 -4
  86. package/src/structures/IReflectWebSocketOperation.ts +17 -17
  87. package/src/structures/IReflectWebSocketOperationParameter.ts +38 -38
  88. package/src/structures/ITypedApplication.ts +11 -11
  89. package/src/structures/ITypedHttpRoute.ts +41 -41
  90. package/src/structures/ITypedHttpRouteException.ts +15 -15
  91. package/src/structures/ITypedHttpRouteParameter.ts +41 -41
  92. package/src/structures/ITypedHttpRouteSuccess.ts +22 -22
  93. package/src/structures/ITypedWebSocketRoute.ts +24 -24
  94. package/src/structures/ITypedWebSocketRouteParameter.ts +3 -3
  95. package/src/structures/MethodType.ts +5 -5
  96. package/src/structures/ParamCategory.ts +1 -1
  97. package/src/structures/TypeEntry.ts +22 -22
  98. package/src/transform.ts +9 -9
  99. package/src/transformers/IOperationMetadata.ts +44 -44
  100. package/src/transformers/ISdkOperationTransformerContext.ts +8 -8
  101. package/src/transformers/SdkOperationProgrammer.ts +209 -209
  102. package/src/transformers/SdkOperationTransformer.ts +253 -253
  103. package/src/transformers/TextPlainValidator.ts +17 -17
  104. package/src/typings/get-function-location.d.ts +7 -7
  105. package/src/utils/ArrayUtil.ts +26 -26
  106. package/src/utils/FileRetriever.ts +22 -22
  107. package/src/utils/MapUtil.ts +14 -14
  108. package/src/utils/MetadataUtil.ts +26 -26
  109. package/src/utils/PathUtil.ts +10 -10
  110. package/src/utils/SourceFinder.ts +66 -66
  111. package/src/utils/StringUtil.ts +17 -17
  112. package/src/utils/StripEnums.ts +5 -5
  113. package/src/utils/VersioningStrategy.ts +28 -28
  114. package/src/validators/HttpHeadersValidator.ts +34 -34
  115. 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
+ };