@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.
Files changed (53) hide show
  1. package/README.md +194 -1
  2. package/commands/generate-sdk.command.js +8 -2
  3. package/commands/generate-sdk.command.js.map +1 -1
  4. package/constants/sdk-toolchain.const.d.ts +25 -0
  5. package/constants/sdk-toolchain.const.js +38 -0
  6. package/constants/sdk-toolchain.const.js.map +1 -0
  7. package/decorators/grpc-param.decorator.js +5 -4
  8. package/decorators/grpc-param.decorator.js.map +1 -1
  9. package/decorators/property.decorator.js +6 -3
  10. package/decorators/property.decorator.js.map +1 -1
  11. package/helpers/generate.helper.d.ts +3 -2
  12. package/helpers/generate.helper.js +56 -3
  13. package/helpers/generate.helper.js.map +1 -1
  14. package/helpers/sdk-naming.helper.d.ts +7 -0
  15. package/helpers/sdk-naming.helper.js +197 -0
  16. package/helpers/sdk-naming.helper.js.map +1 -0
  17. package/helpers/sdk-output.helper.d.ts +6 -0
  18. package/helpers/sdk-output.helper.js +84 -0
  19. package/helpers/sdk-output.helper.js.map +1 -0
  20. package/helpers/shell.helper.d.ts +4 -0
  21. package/helpers/shell.helper.js +36 -0
  22. package/helpers/shell.helper.js.map +1 -1
  23. package/package.json +3 -1
  24. package/services/generate-proto.service.d.ts +1 -1
  25. package/services/generate-proto.service.js +7 -3
  26. package/services/generate-proto.service.js.map +1 -1
  27. package/services/go-sdk-generator.service.d.ts +26 -0
  28. package/services/go-sdk-generator.service.js +223 -0
  29. package/services/go-sdk-generator.service.js.map +1 -0
  30. package/services/protoc.service.d.ts +5 -0
  31. package/services/protoc.service.js +26 -0
  32. package/services/protoc.service.js.map +1 -0
  33. package/services/rust-sdk-generator.service.d.ts +24 -0
  34. package/services/rust-sdk-generator.service.js +197 -0
  35. package/services/rust-sdk-generator.service.js.map +1 -0
  36. package/services/sdk-descriptor.service.d.ts +13 -0
  37. package/services/sdk-descriptor.service.js +171 -0
  38. package/services/sdk-descriptor.service.js.map +1 -0
  39. package/templates/go/client.hbs +163 -0
  40. package/templates/go/enums.hbs +14 -0
  41. package/templates/go/errors.hbs +55 -0
  42. package/templates/go/go-mod.hbs +8 -0
  43. package/templates/rust/cargo-toml.hbs +13 -0
  44. package/templates/rust/client.hbs +90 -0
  45. package/templates/rust/enums.hbs +61 -0
  46. package/templates/rust/error.hbs +52 -0
  47. package/templates/rust/lib.hbs +17 -0
  48. package/types/sdk-build-config.type.d.ts +15 -0
  49. package/types/sdk-build-config.type.js +1 -1
  50. package/types/sdk-build-config.type.js.map +1 -1
  51. package/types/sdk-descriptor.type.d.ts +30 -0
  52. package/types/sdk-descriptor.type.js +2 -0
  53. 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,5 @@
1
+ import { SdkToolRequirement } from '../constants/sdk-toolchain.const.js';
2
+ export declare class ProtocService {
3
+ assertTools(tools: SdkToolRequirement[]): void;
4
+ run(args: string[], cwd: string): void;
5
+ }
@@ -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
+ }