@hodfords/nestjs-grpc-helper 12.3.1 → 12.4.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.
- package/README.md +194 -1
- package/commands/generate-sdk.command.js +8 -2
- package/commands/generate-sdk.command.js.map +1 -1
- package/constants/sdk-toolchain.const.d.ts +25 -0
- package/constants/sdk-toolchain.const.js +38 -0
- package/constants/sdk-toolchain.const.js.map +1 -0
- package/decorators/grpc-param.decorator.js +5 -4
- package/decorators/grpc-param.decorator.js.map +1 -1
- package/decorators/property.decorator.js +6 -3
- package/decorators/property.decorator.js.map +1 -1
- package/helpers/generate.helper.d.ts +3 -2
- package/helpers/generate.helper.js +56 -3
- package/helpers/generate.helper.js.map +1 -1
- package/helpers/sdk-naming.helper.d.ts +7 -0
- package/helpers/sdk-naming.helper.js +197 -0
- package/helpers/sdk-naming.helper.js.map +1 -0
- package/helpers/sdk-output.helper.d.ts +6 -0
- package/helpers/sdk-output.helper.js +84 -0
- package/helpers/sdk-output.helper.js.map +1 -0
- package/helpers/shell.helper.d.ts +4 -0
- package/helpers/shell.helper.js +36 -0
- package/helpers/shell.helper.js.map +1 -1
- package/package.json +3 -1
- package/services/generate-proto.service.d.ts +1 -1
- package/services/generate-proto.service.js +7 -3
- package/services/generate-proto.service.js.map +1 -1
- package/services/go-sdk-generator.service.d.ts +26 -0
- package/services/go-sdk-generator.service.js +223 -0
- package/services/go-sdk-generator.service.js.map +1 -0
- package/services/protoc.service.d.ts +5 -0
- package/services/protoc.service.js +26 -0
- package/services/protoc.service.js.map +1 -0
- package/services/rust-sdk-generator.service.d.ts +24 -0
- package/services/rust-sdk-generator.service.js +197 -0
- package/services/rust-sdk-generator.service.js.map +1 -0
- package/services/sdk-descriptor.service.d.ts +13 -0
- package/services/sdk-descriptor.service.js +171 -0
- package/services/sdk-descriptor.service.js.map +1 -0
- package/templates/go/client.hbs +163 -0
- package/templates/go/enums.hbs +14 -0
- package/templates/go/errors.hbs +55 -0
- package/templates/go/go-mod.hbs +8 -0
- package/templates/rust/cargo-toml.hbs +13 -0
- package/templates/rust/client.hbs +90 -0
- package/templates/rust/enums.hbs +61 -0
- package/templates/rust/error.hbs +52 -0
- package/templates/rust/lib.hbs +17 -0
- package/types/sdk-build-config.type.d.ts +15 -0
- package/types/sdk-build-config.type.js +1 -1
- package/types/sdk-build-config.type.js.map +1 -1
- package/types/sdk-descriptor.type.d.ts +30 -0
- package/types/sdk-descriptor.type.js +2 -0
- package/types/sdk-descriptor.type.js.map +1 -0
|
@@ -0,0 +1,223 @@
|
|
|
1
|
+
import { Logger } from '@nestjs/common';
|
|
2
|
+
import fs from 'fs-extra';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { GO_SDK_TOOLCHAIN, PROTOC_TOOL } from '../constants/sdk-toolchain.const.js';
|
|
5
|
+
import { enumMemberName, toGoCamelCase, toGoPackageName } from '../helpers/sdk-naming.helper.js';
|
|
6
|
+
import { GO_OWNED_PATHS, stageOwnedPaths } from '../helpers/sdk-output.helper.js';
|
|
7
|
+
import { findBinary, isVersionAtLeast, runBinary } from '../helpers/shell.helper.js';
|
|
8
|
+
import { GenerateProtoService } from './generate-proto.service.js';
|
|
9
|
+
import { HbsGeneratorService } from './hbs-generator.service.js';
|
|
10
|
+
import { ProtocService } from './protoc.service.js';
|
|
11
|
+
import { SdkDescriptorService } from './sdk-descriptor.service.js';
|
|
12
|
+
const goNativeTypes = { string: 'string', bool: 'bool', float: 'float32' };
|
|
13
|
+
const goNativeZeroValues = { string: '""', bool: 'false', float: '0' };
|
|
14
|
+
export class GoSdkGeneratorService extends HbsGeneratorService {
|
|
15
|
+
config;
|
|
16
|
+
protocService;
|
|
17
|
+
static requiredTools = [PROTOC_TOOL, ...GO_SDK_TOOLCHAIN.tools];
|
|
18
|
+
logger = new Logger(GoSdkGeneratorService.name);
|
|
19
|
+
outputDir;
|
|
20
|
+
constructor(config, protocService = new ProtocService()) {
|
|
21
|
+
super();
|
|
22
|
+
this.config = config;
|
|
23
|
+
this.protocService = protocService;
|
|
24
|
+
this.outputDir = path.resolve(process.cwd(), this.config.go.output);
|
|
25
|
+
}
|
|
26
|
+
generate(descriptor) {
|
|
27
|
+
const { module } = this.config.go;
|
|
28
|
+
const packageName = toGoPackageName(module);
|
|
29
|
+
descriptor ??= new SdkDescriptorService().describe();
|
|
30
|
+
if (!descriptor.services.length) {
|
|
31
|
+
throw new Error('No gRPC microservice with a @GrpcAction method is registered; nothing to generate.');
|
|
32
|
+
}
|
|
33
|
+
this.protocService.assertTools(GoSdkGeneratorService.requiredTools);
|
|
34
|
+
const files = this.renderFiles(descriptor, packageName);
|
|
35
|
+
this.writeOwnedPaths(files);
|
|
36
|
+
this.format([...files.keys()].filter((file) => file.endsWith('.go')));
|
|
37
|
+
this.tidy();
|
|
38
|
+
if (this.config.go.build) {
|
|
39
|
+
this.build();
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
renderFiles(descriptor, packageName) {
|
|
43
|
+
const { module } = this.config.go;
|
|
44
|
+
return new Map([
|
|
45
|
+
[
|
|
46
|
+
'go.mod',
|
|
47
|
+
this.compileTemplate('go/go-mod.hbs', {
|
|
48
|
+
module,
|
|
49
|
+
goVersion: GO_SDK_TOOLCHAIN.goVersion,
|
|
50
|
+
grpcVersion: GO_SDK_TOOLCHAIN.modules.grpc,
|
|
51
|
+
protobufVersion: GO_SDK_TOOLCHAIN.modules.protobuf
|
|
52
|
+
})
|
|
53
|
+
],
|
|
54
|
+
[
|
|
55
|
+
'client.go',
|
|
56
|
+
this.compileTemplate('go/client.hbs', {
|
|
57
|
+
packageName,
|
|
58
|
+
module,
|
|
59
|
+
services: descriptor.services.map((service) => this.buildServiceView(service))
|
|
60
|
+
})
|
|
61
|
+
],
|
|
62
|
+
['errors.go', this.compileTemplate('go/errors.hbs', { packageName })],
|
|
63
|
+
[
|
|
64
|
+
'enums.go',
|
|
65
|
+
this.compileTemplate('go/enums.hbs', {
|
|
66
|
+
packageName,
|
|
67
|
+
enums: descriptor.enums.map((item) => this.buildEnumView(item))
|
|
68
|
+
})
|
|
69
|
+
]
|
|
70
|
+
]);
|
|
71
|
+
}
|
|
72
|
+
writeOwnedPaths(files) {
|
|
73
|
+
const { module } = this.config.go;
|
|
74
|
+
stageOwnedPaths(this.outputDir, GO_OWNED_PATHS, (stagingDir) => {
|
|
75
|
+
new GenerateProtoService(this.config.name, stagingDir).generate();
|
|
76
|
+
this.protocService.run([
|
|
77
|
+
'--proto_path=.',
|
|
78
|
+
'--go_out=.',
|
|
79
|
+
`--go_opt=Mmicroservice.proto=${module}/pb`,
|
|
80
|
+
`--go_opt=module=${module}`,
|
|
81
|
+
'--go-grpc_out=.',
|
|
82
|
+
`--go-grpc_opt=Mmicroservice.proto=${module}/pb`,
|
|
83
|
+
`--go-grpc_opt=module=${module}`,
|
|
84
|
+
'microservice.proto'
|
|
85
|
+
], stagingDir);
|
|
86
|
+
for (const [file, content] of files) {
|
|
87
|
+
fs.outputFileSync(path.join(stagingDir, file), content);
|
|
88
|
+
}
|
|
89
|
+
});
|
|
90
|
+
}
|
|
91
|
+
buildServiceView(service) {
|
|
92
|
+
const goName = toGoCamelCase(service.name);
|
|
93
|
+
const clientName = `${goName}Client`;
|
|
94
|
+
const description = service.description ? ` ${service.description}` : '';
|
|
95
|
+
return {
|
|
96
|
+
clientName,
|
|
97
|
+
docLines: `${clientName} calls the ${service.name} service.${description}`.split('\n'),
|
|
98
|
+
methods: service.methods.map((method) => this.buildMethodView(method))
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
buildMethodView(method) {
|
|
102
|
+
const goName = toGoCamelCase(method.name);
|
|
103
|
+
const isEmpty = method.responseKind === 'empty';
|
|
104
|
+
const returnType = this.returnType(method);
|
|
105
|
+
const docLines = `${goName} ${method.description || `calls the ${method.name} rpc.`}`.split('\n');
|
|
106
|
+
if (method.metadataKeys.length) {
|
|
107
|
+
docLines.push(`Metadata read by the server: ${method.metadataKeys.join(', ')}.`);
|
|
108
|
+
}
|
|
109
|
+
let signatureReturn = isEmpty ? 'error' : `(${returnType}, error)`;
|
|
110
|
+
if (method.isStream) {
|
|
111
|
+
signatureReturn = `(*Stream[${returnType}], error)`;
|
|
112
|
+
}
|
|
113
|
+
return {
|
|
114
|
+
goName,
|
|
115
|
+
docLines,
|
|
116
|
+
requestType: method.requestType ? `*pb.${toGoCamelCase(method.requestType)}` : undefined,
|
|
117
|
+
requestArg: method.requestType ? 'req' : '&emptypb.Empty{}',
|
|
118
|
+
isStream: method.isStream,
|
|
119
|
+
isEmpty,
|
|
120
|
+
returnType,
|
|
121
|
+
signatureReturn,
|
|
122
|
+
zeroValue: this.zeroValue(method),
|
|
123
|
+
unwrapExpr: this.unwrapExpression(method)
|
|
124
|
+
};
|
|
125
|
+
}
|
|
126
|
+
returnType(method) {
|
|
127
|
+
switch (method.responseKind) {
|
|
128
|
+
case 'empty':
|
|
129
|
+
return '*emptypb.Empty';
|
|
130
|
+
case 'list':
|
|
131
|
+
return `[]*pb.${toGoCamelCase(method.responseType)}`;
|
|
132
|
+
case 'native':
|
|
133
|
+
return goNativeTypes[method.responseType];
|
|
134
|
+
case 'nativeList':
|
|
135
|
+
return `[]${goNativeTypes[method.responseType]}`;
|
|
136
|
+
default:
|
|
137
|
+
return `*pb.${toGoCamelCase(method.responseType)}`;
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
zeroValue(method) {
|
|
141
|
+
return method.responseKind === 'native' ? goNativeZeroValues[method.responseType] : 'nil';
|
|
142
|
+
}
|
|
143
|
+
unwrapExpression(method) {
|
|
144
|
+
switch (method.responseKind) {
|
|
145
|
+
case 'list':
|
|
146
|
+
case 'nativeList':
|
|
147
|
+
return 'res.GetItems()';
|
|
148
|
+
case 'native':
|
|
149
|
+
case 'nullable':
|
|
150
|
+
return 'res.GetValue()';
|
|
151
|
+
default:
|
|
152
|
+
return 'res';
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
buildEnumView(item) {
|
|
156
|
+
const goName = toGoCamelCase(item.name);
|
|
157
|
+
return {
|
|
158
|
+
name: item.name,
|
|
159
|
+
goName,
|
|
160
|
+
goType: item.valueType === 'number' ? 'int32' : 'string',
|
|
161
|
+
entries: item.entries.map((entry) => ({
|
|
162
|
+
constName: `${goName}${enumMemberName(entry.key)}`,
|
|
163
|
+
literal: item.valueType === 'number' ? String(entry.value) : JSON.stringify(String(entry.value))
|
|
164
|
+
}))
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
format(goFiles) {
|
|
168
|
+
if (!findBinary('gofmt')) {
|
|
169
|
+
this.logger.warn('gofmt is not on PATH; the generated Go files are left unformatted.');
|
|
170
|
+
return;
|
|
171
|
+
}
|
|
172
|
+
try {
|
|
173
|
+
runBinary('gofmt', ['-w', ...goFiles], this.outputDir);
|
|
174
|
+
}
|
|
175
|
+
catch (error) {
|
|
176
|
+
const reason = error instanceof Error ? error.message : String(error);
|
|
177
|
+
this.logger.warn(`gofmt failed; the generated Go files are left unformatted: ${reason}`);
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
tidy() {
|
|
181
|
+
const required = Boolean(this.config.go.build);
|
|
182
|
+
const { goVersion } = GO_SDK_TOOLCHAIN;
|
|
183
|
+
const manualStep = `run "go mod tidy" with Go ${goVersion} or newer in ${this.outputDir} before building the module.`;
|
|
184
|
+
if (!findBinary('go')) {
|
|
185
|
+
if (required) {
|
|
186
|
+
throw new Error('"go.build" is true but go is not on PATH.');
|
|
187
|
+
}
|
|
188
|
+
this.logger.warn(`go is not on PATH; ${manualStep}`);
|
|
189
|
+
return;
|
|
190
|
+
}
|
|
191
|
+
const version = this.readGoVersion();
|
|
192
|
+
if (version && !isVersionAtLeast(version, goVersion)) {
|
|
193
|
+
if (required) {
|
|
194
|
+
throw new Error(`"go.build" needs Go ${goVersion} or newer, found ${version}.`);
|
|
195
|
+
}
|
|
196
|
+
this.logger.warn(`The generated go.mod needs Go ${goVersion} or newer, found Go ${version}; ${manualStep}`);
|
|
197
|
+
return;
|
|
198
|
+
}
|
|
199
|
+
try {
|
|
200
|
+
runBinary('go', ['mod', 'tidy'], this.outputDir);
|
|
201
|
+
}
|
|
202
|
+
catch (error) {
|
|
203
|
+
if (required) {
|
|
204
|
+
throw error;
|
|
205
|
+
}
|
|
206
|
+
const reason = error instanceof Error ? error.message : String(error);
|
|
207
|
+
this.logger.warn(`go mod tidy failed; ${manualStep} ${reason}`);
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
build() {
|
|
211
|
+
this.logger.log('Building the Go SDK');
|
|
212
|
+
runBinary('go', ['build', './...'], this.outputDir);
|
|
213
|
+
}
|
|
214
|
+
readGoVersion() {
|
|
215
|
+
try {
|
|
216
|
+
return /go(\d+\.\d+(?:\.\d+)?)/.exec(runBinary('go', ['version'], this.outputDir) ?? '')?.[1];
|
|
217
|
+
}
|
|
218
|
+
catch {
|
|
219
|
+
return undefined;
|
|
220
|
+
}
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
//# sourceMappingURL=go-sdk-generator.service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"go-sdk-generator.service.js","sourceRoot":"","sources":["../../../lib/services/go-sdk-generator.service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { findBinary, readBinaryVersion, runBinary } from '../helpers/shell.helper.js';
|
|
2
|
+
export class ProtocService {
|
|
3
|
+
assertTools(tools) {
|
|
4
|
+
const problems = [];
|
|
5
|
+
for (const tool of tools) {
|
|
6
|
+
if (!findBinary(tool.binary)) {
|
|
7
|
+
problems.push(`- ${tool.binary} is not on PATH. Install: ${tool.install}`);
|
|
8
|
+
continue;
|
|
9
|
+
}
|
|
10
|
+
if (!tool.version) {
|
|
11
|
+
continue;
|
|
12
|
+
}
|
|
13
|
+
const actual = readBinaryVersion(tool.binary);
|
|
14
|
+
if (actual && actual.split('.').slice(0, 2).join('.') !== tool.version) {
|
|
15
|
+
problems.push(`- ${tool.binary} ${actual} is not supported (need ${tool.version}.x). Install: ${tool.install}`);
|
|
16
|
+
}
|
|
17
|
+
}
|
|
18
|
+
if (problems.length) {
|
|
19
|
+
throw new Error(`Missing or unsupported SDK build tools:\n${problems.join('\n')}`);
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
run(args, cwd) {
|
|
23
|
+
runBinary('protoc', args, cwd);
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=protoc.service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"protoc.service.js","sourceRoot":"","sources":["../../../lib/services/protoc.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEtF,MAAM,OAAO,aAAa;IAKtB,WAAW,CAAC,KAA2B;QACnC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,6BAA6B,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC3E,SAAS;YACb,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAChB,SAAS;YACb,CAAC;YAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrE,QAAQ,CAAC,IAAI,CACT,KAAK,IAAI,CAAC,MAAM,IAAI,MAAM,2BAA2B,IAAI,CAAC,OAAO,iBAAiB,IAAI,CAAC,OAAO,EAAE,CACnG,CAAC;YACN,CAAC;QACL,CAAC;QAED,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;IACL,CAAC;IAED,GAAG,CAAC,IAAc,EAAE,GAAW;QAC3B,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;CACJ"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { SdkToolRequirement } from '../constants/sdk-toolchain.const.js';
|
|
2
|
+
import { SdkBuildConfigType } from '../types/sdk-build-config.type.js';
|
|
3
|
+
import { SdkDescriptor } from '../types/sdk-descriptor.type.js';
|
|
4
|
+
import { HbsGeneratorService } from './hbs-generator.service.js';
|
|
5
|
+
import { ProtocService } from './protoc.service.js';
|
|
6
|
+
export declare class RustSdkGeneratorService extends HbsGeneratorService {
|
|
7
|
+
private config;
|
|
8
|
+
private protocService;
|
|
9
|
+
static readonly requiredTools: SdkToolRequirement[];
|
|
10
|
+
private logger;
|
|
11
|
+
private outputDir;
|
|
12
|
+
constructor(config: SdkBuildConfigType, protocService?: ProtocService);
|
|
13
|
+
generate(descriptor?: SdkDescriptor): void;
|
|
14
|
+
private renderFiles;
|
|
15
|
+
private writeOwnedPaths;
|
|
16
|
+
private locateGeneratedFiles;
|
|
17
|
+
private buildServiceView;
|
|
18
|
+
private buildMethodView;
|
|
19
|
+
private returnType;
|
|
20
|
+
private unwrapExpression;
|
|
21
|
+
private buildEnumView;
|
|
22
|
+
private format;
|
|
23
|
+
private build;
|
|
24
|
+
}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
import { Logger } from '@nestjs/common';
|
|
2
|
+
import fs from 'fs-extra';
|
|
3
|
+
import path from 'node:path';
|
|
4
|
+
import { PROTOC_TOOL, RUST_SDK_TOOLCHAIN } from '../constants/sdk-toolchain.const.js';
|
|
5
|
+
import { enumMemberName, toRustIdentifier, toSnakeCase, toUpperCamelCase } from '../helpers/sdk-naming.helper.js';
|
|
6
|
+
import { RUST_OWNED_PATHS, stageOwnedPaths } from '../helpers/sdk-output.helper.js';
|
|
7
|
+
import { findBinary, isVersionAtLeast, readBinaryVersion, runBinary } from '../helpers/shell.helper.js';
|
|
8
|
+
import { GenerateProtoService } from './generate-proto.service.js';
|
|
9
|
+
import { HbsGeneratorService } from './hbs-generator.service.js';
|
|
10
|
+
import { ProtocService } from './protoc.service.js';
|
|
11
|
+
import { SdkDescriptorService } from './sdk-descriptor.service.js';
|
|
12
|
+
const rustNativeTypes = { string: 'String', bool: 'bool', float: 'f32' };
|
|
13
|
+
const generatedDir = 'src/generated';
|
|
14
|
+
const defaultCrateVersion = '0.1.0';
|
|
15
|
+
const reservedMethodNames = [
|
|
16
|
+
'connect',
|
|
17
|
+
'new',
|
|
18
|
+
'with_origin',
|
|
19
|
+
'with_interceptor',
|
|
20
|
+
'send_compressed',
|
|
21
|
+
'accept_compressed',
|
|
22
|
+
'max_decoding_message_size',
|
|
23
|
+
'max_encoding_message_size',
|
|
24
|
+
'clone'
|
|
25
|
+
];
|
|
26
|
+
function rustTypeName(name) {
|
|
27
|
+
return toRustIdentifier(toUpperCamelCase(name));
|
|
28
|
+
}
|
|
29
|
+
export class RustSdkGeneratorService extends HbsGeneratorService {
|
|
30
|
+
config;
|
|
31
|
+
protocService;
|
|
32
|
+
static requiredTools = [PROTOC_TOOL, ...RUST_SDK_TOOLCHAIN.tools];
|
|
33
|
+
logger = new Logger(RustSdkGeneratorService.name);
|
|
34
|
+
outputDir;
|
|
35
|
+
constructor(config, protocService = new ProtocService()) {
|
|
36
|
+
super();
|
|
37
|
+
this.config = config;
|
|
38
|
+
this.protocService = protocService;
|
|
39
|
+
this.outputDir = path.resolve(process.cwd(), this.config.rust.output);
|
|
40
|
+
}
|
|
41
|
+
generate(descriptor) {
|
|
42
|
+
descriptor ??= new SdkDescriptorService().describe();
|
|
43
|
+
if (!descriptor.services.length) {
|
|
44
|
+
throw new Error('No gRPC microservice with a @GrpcAction method is registered; nothing to generate.');
|
|
45
|
+
}
|
|
46
|
+
this.protocService.assertTools(RustSdkGeneratorService.requiredTools);
|
|
47
|
+
this.writeOwnedPaths(this.renderFiles(descriptor));
|
|
48
|
+
this.format();
|
|
49
|
+
if (this.config.rust.build) {
|
|
50
|
+
this.build();
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
renderFiles(descriptor) {
|
|
54
|
+
return new Map([
|
|
55
|
+
[
|
|
56
|
+
'Cargo.toml',
|
|
57
|
+
this.compileTemplate('rust/cargo-toml.hbs', {
|
|
58
|
+
crateName: this.config.rust.crateName,
|
|
59
|
+
version: this.config.rust.version ?? defaultCrateVersion,
|
|
60
|
+
rustVersion: RUST_SDK_TOOLCHAIN.minRustVersion,
|
|
61
|
+
crates: RUST_SDK_TOOLCHAIN.crates
|
|
62
|
+
})
|
|
63
|
+
],
|
|
64
|
+
[
|
|
65
|
+
'src/client.rs',
|
|
66
|
+
this.compileTemplate('rust/client.hbs', {
|
|
67
|
+
services: descriptor.services.map((service) => this.buildServiceView(service))
|
|
68
|
+
})
|
|
69
|
+
],
|
|
70
|
+
['src/error.rs', this.compileTemplate('rust/error.hbs', {})],
|
|
71
|
+
[
|
|
72
|
+
'src/enums.rs',
|
|
73
|
+
this.compileTemplate('rust/enums.hbs', {
|
|
74
|
+
enums: descriptor.enums.map((item) => this.buildEnumView(item))
|
|
75
|
+
})
|
|
76
|
+
]
|
|
77
|
+
]);
|
|
78
|
+
}
|
|
79
|
+
writeOwnedPaths(files) {
|
|
80
|
+
stageOwnedPaths(this.outputDir, RUST_OWNED_PATHS, (stagingDir) => {
|
|
81
|
+
new GenerateProtoService(this.config.name, stagingDir).generate();
|
|
82
|
+
fs.ensureDirSync(path.join(stagingDir, generatedDir));
|
|
83
|
+
this.protocService.run(['--proto_path=.', `--prost_out=${generatedDir}`, `--tonic_out=${generatedDir}`, 'microservice.proto'], stagingDir);
|
|
84
|
+
files.set('src/lib.rs', this.compileTemplate('rust/lib.hbs', this.locateGeneratedFiles(stagingDir)));
|
|
85
|
+
for (const [file, content] of files) {
|
|
86
|
+
fs.outputFileSync(path.join(stagingDir, file), content);
|
|
87
|
+
}
|
|
88
|
+
});
|
|
89
|
+
}
|
|
90
|
+
locateGeneratedFiles(rootDir) {
|
|
91
|
+
const generatedPath = path.join(rootDir, generatedDir);
|
|
92
|
+
const files = fs.readdirSync(generatedPath).filter((file) => file.endsWith('.rs'));
|
|
93
|
+
const tonicFiles = files.filter((file) => file.endsWith('.tonic.rs'));
|
|
94
|
+
const protoFiles = files.filter((file) => !file.endsWith('.tonic.rs'));
|
|
95
|
+
if (protoFiles.length !== 1 || tonicFiles.length !== 1) {
|
|
96
|
+
throw new Error(`Expected one prost file and one tonic file in ${generatedDir}, found: ${files.join(', ') || 'none'}.`);
|
|
97
|
+
}
|
|
98
|
+
const [protoFile] = protoFiles;
|
|
99
|
+
const [tonicFile] = tonicFiles;
|
|
100
|
+
const protoContent = fs.readFileSync(path.join(generatedPath, protoFile), 'utf8');
|
|
101
|
+
return { protoFile, tonicFile, includeTonicFile: !protoContent.includes(tonicFile) };
|
|
102
|
+
}
|
|
103
|
+
buildServiceView(service) {
|
|
104
|
+
const typeName = toUpperCamelCase(service.name);
|
|
105
|
+
const description = service.description ? ` ${service.description}` : '';
|
|
106
|
+
return {
|
|
107
|
+
clientName: `${typeName}Client`,
|
|
108
|
+
moduleName: `${toSnakeCase(service.name)}_client`,
|
|
109
|
+
docLines: `Client of the ${service.name} service.${description}`.split('\n'),
|
|
110
|
+
methods: service.methods.map((method) => this.buildMethodView(service, method))
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
buildMethodView(service, method) {
|
|
114
|
+
const snakeName = toSnakeCase(method.name);
|
|
115
|
+
if (reservedMethodNames.includes(snakeName)) {
|
|
116
|
+
throw new Error(`Rust SDK: rpc "${service.name}.${method.name}" maps to the reserved method name "${snakeName}". Rename the rpc.`);
|
|
117
|
+
}
|
|
118
|
+
const docLines = (method.description || `Calls the ${method.name} rpc.`).split('\n');
|
|
119
|
+
if (method.metadataKeys.length) {
|
|
120
|
+
docLines.push(`Metadata read by the server: ${method.metadataKeys.join(', ')}.`);
|
|
121
|
+
}
|
|
122
|
+
return {
|
|
123
|
+
fnName: toRustIdentifier(snakeName),
|
|
124
|
+
docLines,
|
|
125
|
+
requestType: method.requestType ? `pb::${rustTypeName(method.requestType)}` : undefined,
|
|
126
|
+
requestArg: method.requestType ? 'request' : '()',
|
|
127
|
+
isStream: method.isStream,
|
|
128
|
+
returnType: this.returnType(method),
|
|
129
|
+
unwrapExpr: this.unwrapExpression(method)
|
|
130
|
+
};
|
|
131
|
+
}
|
|
132
|
+
returnType(method) {
|
|
133
|
+
switch (method.responseKind) {
|
|
134
|
+
case 'empty':
|
|
135
|
+
return '()';
|
|
136
|
+
case 'list':
|
|
137
|
+
return `Vec<pb::${rustTypeName(method.responseType)}>`;
|
|
138
|
+
case 'native':
|
|
139
|
+
return rustNativeTypes[method.responseType];
|
|
140
|
+
case 'nativeList':
|
|
141
|
+
return `Vec<${rustNativeTypes[method.responseType]}>`;
|
|
142
|
+
case 'nullable':
|
|
143
|
+
return `Option<pb::${rustTypeName(method.responseType)}>`;
|
|
144
|
+
default:
|
|
145
|
+
return `pb::${rustTypeName(method.responseType)}`;
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
unwrapExpression(method) {
|
|
149
|
+
switch (method.responseKind) {
|
|
150
|
+
case 'list':
|
|
151
|
+
case 'nativeList':
|
|
152
|
+
return 'response.items';
|
|
153
|
+
case 'native':
|
|
154
|
+
case 'nullable':
|
|
155
|
+
return 'response.value';
|
|
156
|
+
default:
|
|
157
|
+
return 'response';
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
buildEnumView(item) {
|
|
161
|
+
const isNumber = item.valueType === 'number';
|
|
162
|
+
return {
|
|
163
|
+
rustName: rustTypeName(item.name),
|
|
164
|
+
isNumber,
|
|
165
|
+
entries: item.entries.map((entry) => ({
|
|
166
|
+
variant: toRustIdentifier(enumMemberName(entry.key)),
|
|
167
|
+
literal: isNumber ? String(entry.value) : JSON.stringify(String(entry.value))
|
|
168
|
+
}))
|
|
169
|
+
};
|
|
170
|
+
}
|
|
171
|
+
format() {
|
|
172
|
+
if (!findBinary('cargo')) {
|
|
173
|
+
this.logger.warn('cargo is not on PATH; the generated Rust files are left unformatted.');
|
|
174
|
+
return;
|
|
175
|
+
}
|
|
176
|
+
try {
|
|
177
|
+
runBinary('cargo', ['fmt'], this.outputDir);
|
|
178
|
+
}
|
|
179
|
+
catch (error) {
|
|
180
|
+
const reason = error instanceof Error ? error.message : String(error);
|
|
181
|
+
this.logger.warn(`cargo fmt failed; the generated Rust files are left unformatted: ${reason}`);
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
build() {
|
|
185
|
+
if (!findBinary('cargo')) {
|
|
186
|
+
throw new Error('"rust.build" is true but cargo is not on PATH.');
|
|
187
|
+
}
|
|
188
|
+
const { minRustVersion } = RUST_SDK_TOOLCHAIN;
|
|
189
|
+
const version = readBinaryVersion('cargo');
|
|
190
|
+
if (version && !isVersionAtLeast(version, minRustVersion)) {
|
|
191
|
+
throw new Error(`"rust.build" needs Rust ${minRustVersion} or newer, found ${version}. Run "rustup update stable".`);
|
|
192
|
+
}
|
|
193
|
+
this.logger.log('Building the Rust SDK');
|
|
194
|
+
runBinary('cargo', ['check'], this.outputDir);
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
//# sourceMappingURL=rust-sdk-generator.service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rust-sdk-generator.service.js","sourceRoot":"","sources":["../../../lib/services/rust-sdk-generator.service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { SdkDescriptor } from '../types/sdk-descriptor.type.js';
|
|
2
|
+
export declare class SdkDescriptorService {
|
|
3
|
+
private logger;
|
|
4
|
+
describe(): SdkDescriptor;
|
|
5
|
+
private describeService;
|
|
6
|
+
private describeMethod;
|
|
7
|
+
private describeResponse;
|
|
8
|
+
private describeEnums;
|
|
9
|
+
private findEnumSkipReason;
|
|
10
|
+
private findNameProblem;
|
|
11
|
+
private findDuplicate;
|
|
12
|
+
private describeEnumEntries;
|
|
13
|
+
}
|