wgc 0.79.5 → 0.80.0

package/dist/src/commands/router/plugin/commands/init.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { BaseCommandOptions } from '../../../../core/types/types.js';
+declare const _default: (opts: BaseCommandOptions) => Command;
+export default _default;

package/dist/src/commands/router/plugin/commands/init.js

@@ -0,0 +1,98 @@
+import { access, mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+import { Command, program } from 'commander';
+import { resolve } from 'pathe';
+import pc from 'picocolors';
+import pupa from 'pupa';
+import Spinner from 'ora';
+import { compileGraphQLToMapping, compileGraphQLToProto } from '@wundergraph/protographic';
+import { camelCase, upperFirst } from 'lodash-es';
+import { goMod, mainGo, mainGoTest, readme, schema } from '../templates/go-plugin.js';
+import { renderResultTree } from '../helper.js';
+export default (opts) => {
+    const command = new Command('init');
+    command.description('Scaffold a new gRPC router plugin');
+    command.argument('name', 'Name of the plugin');
+    command.option('-d, --directory <directory>', 'Directory to create the plugin in', '.');
+    command.option('-l, --language <language>', 'Programming language to use for the plugin', 'go');
+    command.action(async (name, options) => {
+        const startTime = performance.now();
+        const pluginDir = resolve(process.cwd(), options.directory, name);
+        name = upperFirst(camelCase(name));
+        const serviceName = name + 'Service';
+        // Check if a directory exists
+        try {
+            await access(pluginDir);
+            program.error(pc.red(`Plugin ${name} already exists in ${pluginDir}`));
+        }
+        catch {
+            // Directory doesn't exist, we can proceed
+        }
+        const spinner = Spinner({ text: 'Creating plugin...' });
+        // Create a temporary directory
+        const tempDir = resolve(tmpdir(), `cosmo-plugin-${randomUUID()}`);
+        spinner.start();
+        try {
+            spinner.text = 'Creating directories...';
+            await mkdir(tempDir, { recursive: true });
+            const srcDir = resolve(tempDir, 'src');
+            await mkdir(srcDir, { recursive: true });
+            const generatedDir = resolve(tempDir, 'generated');
+            await mkdir(generatedDir, { recursive: true });
+            spinner.text = 'Checkout templates...';
+            if (options.language.toLowerCase() !== 'go') {
+                spinner.fail(pc.yellow(`Language '${options.language}' is not supported yet. Using 'go' instead.`));
+                options.language = 'go';
+            }
+            await writeFile(resolve(tempDir, 'README.md'), pupa(readme, { name }));
+            await writeFile(resolve(srcDir, 'schema.graphql'), pupa(schema, { name }));
+            spinner.text = 'Generating mapping and proto files...';
+            const mapping = compileGraphQLToMapping(schema, serviceName);
+            await writeFile(resolve(generatedDir, 'mapping.json'), JSON.stringify(mapping, null, 2));
+            const goModulePath = 'github.com/wundergraph/cosmo/plugin';
+            const proto = compileGraphQLToProto(schema, {
+                serviceName,
+                packageName: 'service',
+                goPackage: goModulePath,
+            });
+            await writeFile(resolve(generatedDir, 'service.proto'), proto.proto);
+            await writeFile(resolve(generatedDir, 'service.proto.lock.json'), JSON.stringify(proto.lockData, null, 2));
+            await writeFile(resolve(srcDir, 'main.go'), pupa(mainGo, { serviceName }));
+            await writeFile(resolve(srcDir, 'main_test.go'), pupa(mainGoTest, { serviceName }));
+            // go mod init
+            await writeFile(resolve(tempDir, 'go.mod'), pupa(goMod, { modulePath: goModulePath }));
+            await mkdir(resolve(process.cwd(), options.directory), { recursive: true });
+            await rename(tempDir, pluginDir);
+            const endTime = performance.now();
+            const elapsedTimeMs = endTime - startTime;
+            const formattedTime = elapsedTimeMs > 1000 ? `${(elapsedTimeMs / 1000).toFixed(2)}s` : `${Math.round(elapsedTimeMs)}ms`;
+            renderResultTree(spinner, 'Plugin scaffolded!', true, name, {
+                language: options.language,
+                time: formattedTime,
+                location: pluginDir,
+            });
+            console.log('');
+            console.log(`  Checkout the ${pc.bold(pc.italic('README.md'))} file for instructions on how to build and run your plugin.`);
+            console.log(`  Go to https://cosmo-docs.wundergraph.com/router/plugins to learn more about it.`);
+            console.log('');
+        }
+        catch (error) {
+            // Clean up the temp directory in case of error
+            try {
+                await rm(tempDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            renderResultTree(spinner, 'Plugin scaffolding', false, name, {
+                error: error.message,
+            });
+        }
+        finally {
+            spinner.stop();
+        }
+    });
+    return command;
+};
+//# sourceMappingURL=init.js.map

package/dist/src/commands/router/plugin/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../../../src/commands/router/plugin/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/router/plugin/commands/test.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { BaseCommandOptions } from '../../../../core/types/types.js';
+declare const _default: (opts: BaseCommandOptions) => Command;
+export default _default;

package/dist/src/commands/router/plugin/commands/test.js

@@ -0,0 +1,62 @@
+import path from 'node:path';
+import os from 'node:os';
+import { Command } from 'commander';
+import { resolve } from 'pathe';
+import Spinner from 'ora';
+import { checkAndInstallTools, runGoTests } from '../toolchain.js';
+import { renderResultTree } from '../helper.js';
+export default (opts) => {
+    const command = new Command('test');
+    command.description('Run tests for a gRPC router plugin');
+    command.argument('[directory]', 'Directory of the plugin', '.');
+    command.option('--skip-tools-installation', 'Skip tool installation', false);
+    command.option('--force-tools-installation', 'Force tools installation regardless of version check or confirmation', false);
+    command.action(async (directory, options) => {
+        const startTime = performance.now();
+        const pluginDir = resolve(directory);
+        const spinner = Spinner({ text: 'Running tests...' });
+        const pluginName = path.basename(pluginDir);
+        try {
+            spinner.start();
+            // Check and install tools if needed
+            if (!options.skipToolsInstallation) {
+                await checkAndInstallTools(options.forceToolsInstallation);
+            }
+            const srcDir = resolve(pluginDir, 'src');
+            spinner.text = 'Running tests...';
+            try {
+                const { failed } = await runGoTests(srcDir, spinner, false);
+                // Calculate elapsed time
+                const endTime = performance.now();
+                const elapsedTimeMs = endTime - startTime;
+                const formattedTime = elapsedTimeMs > 1000 ? `${(elapsedTimeMs / 1000).toFixed(2)}s` : `${Math.round(elapsedTimeMs)}ms`;
+                // Common details for both success and failure
+                const details = {
+                    source: srcDir,
+                    env: `${os.platform()} ${os.arch()}`,
+                    time: formattedTime,
+                };
+                const title = failed ? 'Tests failed!' : 'Tests completed successfully!';
+                renderResultTree(spinner, title, !failed, pluginName, details);
+            }
+            catch (error) {
+                renderResultTree(spinner, 'Tests failed!', false, pluginName, {
+                    source: srcDir,
+                    env: `${os.platform()} ${os.arch()}`,
+                    error: error.message,
+                });
+            }
+        }
+        catch (error) {
+            renderResultTree(spinner, 'Failed to run tests!', false, pluginName, {
+                env: `${os.platform()} ${os.arch()}`,
+                error: error.message,
+            });
+        }
+        finally {
+            spinner.stop();
+        }
+    });
+    return command;
+};
+//# sourceMappingURL=test.js.map

package/dist/src/commands/router/plugin/commands/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../../../../../src/commands/router/plugin/commands/test.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/router/plugin/helper.d.ts

@@ -0,0 +1,10 @@
+import Spinner from 'ora';
+/**
+ * Renders a tree-formatted result display
+ * @param spinner The spinner instance
+ * @param title The title to display
+ * @param success Whether the operation was successful
+ * @param name The name of the item (e.g. plugin name)
+ * @param details Key-value pairs of details to display
+ */
+export declare function renderResultTree(spinner: ReturnType<typeof Spinner>, title: string, success: boolean, name: string, details: Record<string, string>): void;

package/dist/src/commands/router/plugin/helper.js

@@ -0,0 +1,47 @@
+import pc from 'picocolors';
+/**
+ * Renders a tree-formatted result display
+ * @param spinner The spinner instance
+ * @param title The title to display
+ * @param success Whether the operation was successful
+ * @param name The name of the item (e.g. plugin name)
+ * @param details Key-value pairs of details to display
+ */
+export function renderResultTree(spinner, title, success, name, details) {
+    const state = success ? pc.green('success') : pc.red('failed');
+    const symbol = success ? pc.green('[●]') : pc.red('[●]');
+    spinner.stopAndPersist({
+        symbol,
+        text: pc.bold(title),
+    });
+    // Build the tree with consistent formatting
+    let output = ` ${pc.dim('│')}`;
+    // Add the name and state first (these are always present)
+    output += `\n ${pc.dim('├────────── name')}: ${name}`;
+    output += `\n ${pc.dim('├───────── state')}: ${state}`;
+    // Dynamically generate key formatters based on actual keys
+    const keys = Object.keys(details);
+    const keyFormatters = {};
+    // Generate dynamic formatters for each key
+    for (const key of [...keys, 'name', 'state']) {
+        // Calculate the number of dashes needed to align all values
+        const dashCount = 14 - key.length;
+        keyFormatters[key] = '─'.repeat(dashCount) + ' ' + key;
+    }
+    // Apply fixed formatters for the standard keys
+    keyFormatters.name = '────────── name';
+    keyFormatters.state = '───────── state';
+    // Add all the other details except the last one
+    for (const key of keys.slice(0, -1)) {
+        const formattedKey = keyFormatters[key];
+        output += `\n ${pc.dim('├' + formattedKey)}: ${details[key]}`;
+    }
+    // Add the last detail with the corner character
+    if (keys.length > 0) {
+        const lastKey = keys.at(-1);
+        const formattedKey = keyFormatters[lastKey];
+        output += `\n ${pc.dim('└' + formattedKey)}: ${details[lastKey]}`;
+    }
+    console.log(output);
+}
+//# sourceMappingURL=helper.js.map

package/dist/src/commands/router/plugin/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/commands/router/plugin/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAmC,EACnC,KAAa,EACb,OAAgB,EAChB,IAAY,EACZ,OAA+B;IAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAEzD,OAAO,CAAC,cAAc,CAAC;QACrB,MAAM;QACN,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;KACrB,CAAC,CAAC;IAEH,4CAA4C;IAC5C,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;IAE/B,0DAA0D;IAC1D,MAAM,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC;IACtD,MAAM,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,kBAAkB,CAAC,KAAK,KAAK,EAAE,CAAC;IAEvD,2DAA2D;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,aAAa,GAA2B,EAAE,CAAC;IAEjD,2CAA2C;IAC3C,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QAC7C,4DAA4D;QAC5D,MAAM,SAAS,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;QAClC,aAAa,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC;IACzD,CAAC;IAED,+CAA+C;IAC/C,aAAa,CAAC,IAAI,GAAG,iBAAiB,CAAC;IACvC,aAAa,CAAC,KAAK,GAAG,iBAAiB,CAAC;IAExC,gDAAgD;IAChD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,YAAY,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,gDAAgD;IAChD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,YAAY,GAAG,aAAa,CAAC,OAAiB,CAAC,CAAC;QACtD,MAAM,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,YAAY,CAAC,KAAK,OAAO,CAAC,OAAiB,CAAC,EAAE,CAAC;IAC9E,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC"}

package/dist/src/commands/router/plugin/index.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { BaseCommandOptions } from '../../../core/types/types.js';
+declare const _default: (opts: BaseCommandOptions) => Command;
+export default _default;

package/dist/src/commands/router/plugin/index.js

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import InitPluginCommand from './commands/init.js';
+import BuildPluginCommand from './commands/build.js';
+import TestPluginCommand from './commands/test.js';
+export default (opts) => {
+    const command = new Command('plugin');
+    command.description('Provides commands for creating and maintaining router plugins');
+    command.addCommand(InitPluginCommand(opts));
+    command.addCommand(BuildPluginCommand(opts));
+    command.addCommand(TestPluginCommand(opts));
+    return command;
+};
+//# sourceMappingURL=index.js.map

package/dist/src/commands/router/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/router/plugin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,iBAAiB,MAAM,oBAAoB,CAAC;AACnD,OAAO,kBAAkB,MAAM,qBAAqB,CAAC;AACrD,OAAO,iBAAiB,MAAM,oBAAoB,CAAC;AAEnD,eAAe,CAAC,IAAwB,EAAE,EAAE;IAC1C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,CAAC,WAAW,CAAC,+DAA+D,CAAC,CAAC;IACrF,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5C,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/src/commands/router/plugin/templates/go-plugin.d.ts

@@ -0,0 +1,5 @@
+export declare const goMod = "\nmodule {modulePath}\n\ngo 1.24.1\n\nrequire (\n  github.com/stretchr/testify v1.10.0\n  github.com/wundergraph/cosmo/router-plugin v0.0.0-20250519132817-0768029ce9e5\n  google.golang.org/grpc v1.68.1\n  google.golang.org/protobuf v1.36.5\n)\n";
+export declare const mainGo = "package main\n\nimport (\n  \"context\"\n  \"log\"\n  \"strconv\"\n\n  service \"github.com/wundergraph/cosmo/plugin/generated\"\n\n  routerplugin \"github.com/wundergraph/cosmo/router-plugin\"\n  \"google.golang.org/grpc\"\n)\n\nfunc main() {\n  pl, err := routerplugin.NewRouterPlugin(func(s *grpc.Server) {\n    s.RegisterService(&service.{serviceName}_ServiceDesc, &{serviceName}{\n      nextID: 1,\n    })\n  })\n\n  if err != nil {\n    log.Fatalf(\"failed to create router plugin: %v\", err)\n  }\n\n  pl.Serve()\n}\n\ntype {serviceName} struct {\n  service.Unimplemented{serviceName}Server\n  nextID int\n}\n\nfunc (s *{serviceName}) QueryHello(ctx context.Context, req *service.QueryHelloRequest) (*service.QueryHelloResponse, error) {\n  response := &service.QueryHelloResponse{\n    Hello: &service.World{\n      Id:   strconv.Itoa(s.nextID),\n      Name: req.Name,\n    },\n  }\n  s.nextID++\n  return response, nil\n}\n";
+export declare const mainGoTest = "package main\n\nimport (\n  \"context\"\n  \"net\"\n  \"testing\"\n\n  \"github.com/stretchr/testify/assert\"\n  \"github.com/stretchr/testify/require\"\n  service \"github.com/wundergraph/cosmo/plugin/generated\"\n  \"google.golang.org/grpc\"\n  \"google.golang.org/grpc/credentials/insecure\"\n  \"google.golang.org/grpc/test/bufconn\"\n)\n\nconst bufSize = 1024 * 1024\n\n// testService is a wrapper that holds the gRPC test components\ntype testService struct {\n  grpcConn  *grpc.ClientConn\n  client service.{serviceName}Client\n  cleanup   func()\n}\n\n// setupTestService creates a local gRPC server for testing\nfunc setupTestService(t *testing.T) *testService {\n  // Create a buffer for gRPC connections\n  lis := bufconn.Listen(bufSize)\n\n  // Create a new gRPC server\n  grpcServer := grpc.NewServer()\n\n  // Register our service\n  service.Register{serviceName}Server(grpcServer, &{serviceName}{\n    nextID: 1,\n  })\n\n  // Start the server\n  go func() {\n    if err := grpcServer.Serve(lis); err != nil {\n      t.Fatalf(\"failed to serve: %v\", err)\n    }\n  }()\n\n  // Create a client connection\n  dialer := func(context.Context, string) (net.Conn, error) {\n    return lis.Dial()\n  }\n  conn, err := grpc.Dial(\n    \"passthrough:///bufnet\",\n    grpc.WithContextDialer(dialer),\n    grpc.WithTransportCredentials(insecure.NewCredentials()),\n  )\n  require.NoError(t, err)\n\n  // Create the service client\n  client := service.New{serviceName}Client(conn)\n\n  // Return cleanup function\n  cleanup := func() {\n    conn.Close()\n    grpcServer.Stop()\n  }\n\n  return &testService{\n    grpcConn:  conn,\n    client: client,\n    cleanup:   cleanup,\n  }\n}\n\nfunc TestQueryHello(t *testing.T) {\n  // Set up basic service\n  svc := setupTestService(t)\n  defer svc.cleanup()\n\n  tests := []struct {\n    name     string\n    userName string\n    wantId   string\n    wantName string\n    wantErr  bool\n  }{\n    {\n      name:     \"valid hello\",\n      userName: \"Alice\",\n      wantId:   \"1\",\n      wantName: \"Alice\",\n      wantErr:  false,\n    },\n    {\n      name:     \"empty name\",\n      userName: \"\",\n      wantId:   \"2\",\n      wantName: \"\", // Empty name should be preserved\n      wantErr:  false,\n    },\n    {\n      name:     \"special characters\",\n      userName: \"John & Jane\",\n      wantId:   \"3\",\n      wantName: \"John & Jane\",\n      wantErr:  false,\n    },\n  }\n\n  for _, tt := range tests {\n    t.Run(tt.name, func(t *testing.T) {\n      req := &service.QueryHelloRequest{\n        Name: tt.userName,\n      }\n\n      resp, err := svc.client.QueryHello(context.Background(), req)\n      if tt.wantErr {\n        assert.Error(t, err)\n        return\n      }\n\n      assert.NoError(t, err)\n      assert.NotNil(t, resp.Hello)\n      assert.Equal(t, tt.wantId, resp.Hello.Id)\n      assert.Equal(t, tt.wantName, resp.Hello.Name)\n    })\n  }\n}\n\nfunc TestSequentialIDs(t *testing.T) {\n  // Set up basic service\n  svc := setupTestService(t)\n  defer svc.cleanup()\n\n  // The first request should get ID \"1\"\n  firstReq := &service.QueryHelloRequest{Name: \"First\"}\n  firstResp, err := svc.client.QueryHello(context.Background(), firstReq)\n  require.NoError(t, err)\n  assert.Equal(t, \"1\", firstResp.Hello.Id)\n\n  // The second request should get ID \"2\"\n  secondReq := &service.QueryHelloRequest{Name: \"Second\"}\n  secondResp, err := svc.client.QueryHello(context.Background(), secondReq)\n  require.NoError(t, err)\n  assert.Equal(t, \"2\", secondResp.Hello.Id)\n\n  // The third request should get ID \"3\"\n  thirdReq := &service.QueryHelloRequest{Name: \"Third\"}\n  thirdResp, err := svc.client.QueryHello(context.Background(), thirdReq)\n  require.NoError(t, err)\n  assert.Equal(t, \"3\", thirdResp.Hello.Id)\n}\n";
+export declare const readme = "# {name} Plugin - Cosmo gRPC Subgraph Example\n\nThis repository contains a simple Cosmo gRPC subgraph plugin that showcases how to design APIs with GraphQL but implement them using gRPC methods instead of traditional resolvers.\n\n## What is this demo about?\n\nThis demo illustrates a key pattern in Cosmo subgraph development:\n- **Design with GraphQL**: Define your API using GraphQL schema\n- **Implement with gRPC**: Instead of writing GraphQL resolvers, implement gRPC service methods\n- **Bridge the gap**: The Cosmo router connects GraphQL operations to your gRPC implementations\n- **Test-Driven Development**: Test your gRPC service implementation with gRPC client and server without external dependencies\n\nThe plugin demonstrates:\n- How GraphQL types and operations map to gRPC service methods\n- Simple \"Hello World\" implementation\n- Proper structure for a Cosmo gRPC subgraph plugin\n- How to test your gRPC service implementation with gRPC client and server without external dependencies\n\n## Plugin Structure\n\n- `src/` - Contains the plugin source code\n  - `main.go` - The gRPC service implementation with methods that replace GraphQL resolvers\n  - `main_test.go` - The gRPC service implementation with methods that replace GraphQL resolvers\n  - `schema.graphql` - The GraphQL schema defining the API contract\n- `generated/` - Contains generated code from the plugin schema\n- `bin/` - Contains compiled binaries of the plugin\n\n## GraphQL to gRPC Mapping\n\nThe plugin shows how GraphQL operations map to gRPC methods:\n\n| GraphQL Operation | gRPC Method |\n|-------------------|-------------|\n| `query { hello }` | `QueryHello()` |\n\n## GraphQL Schema\n\n```graphql\ntype World {\n  id: ID!\n  name: String!\n}\n\ntype Query {\n  hello(name: String!): World!\n}\n```\n\n## Getting Started\n\n1. **Build the plugin**\n\n   ```\n   wgc router plugin build <plugin-directory>\n   ```\n\n2. **Compose your supergraph with your gRPC subgraph**\n\n   config.yaml\n   ```yaml\n   subgraphs:\n     - name: <plugin-name>\n       plugin:\n         version: 0.0.1\n         directory: <plugin-directory>/<plugin-name>\n   ```\n\n3. **Build the federated graph**\n\n    ```bash\n    wgc router compose config.yaml\n    ```\n\n4. **Test the plugin**\n\n   ```bash\n   wgc router plugin test <plugin-directory>/<plugin-name>\n   ```\n   or\n   ```bash\n   go test src -v\n   ```\n   if you have the Go toolchain already installed.\n\n5. **Start the router**\n\n   ```yaml\n   execution_config:\n    file:\n        path: ./config.yaml\n   plugins:\n    - <plugin-directory>\n   ```\n\n6. **Query the hello endpoint**\n\n   Once running, you can perform GraphQL operations like:\n   \n   ```graphql\n   # Hello query\n   query {\n     hello(name: \"World\") {\n       id\n       name\n     }\n   }\n   ```\n\n## Further Steps\n\n- Change the plugin code in `src/main.go` and rebuild the plugin\n- Change the GraphQL schema in `src/schema.graphql` and rebuild the plugin\n\n## Learn More\n\nFor more information about Cosmo and building subgraph plugins, visit the [Cosmo documentation](https://cosmo-docs.wundergraph.com).";
+export declare const schema = "type World {\n  \"\"\"\n  The ID of the world\n  \"\"\"\n  id: ID!\n  \"\"\"\n  The name of the world\n  \"\"\"\n  name: String!\n}\n\ntype Query {\n  \"\"\"\n  The hello query\n  \"\"\"\n  hello(name: String!): World!\n}\n";

package/dist/src/commands/router/plugin/templates/go-plugin.js

@@ -0,0 +1,342 @@
+// We store the templates in code to avoid dealing with file system issues when
+// building for bun and transpiling TypeScript.
+export const goMod = `
+module {modulePath}
+
+go 1.24.1
+
+require (
+  github.com/stretchr/testify v1.10.0
+  github.com/wundergraph/cosmo/router-plugin v0.0.0-20250519132817-0768029ce9e5
+  google.golang.org/grpc v1.68.1
+  google.golang.org/protobuf v1.36.5
+)
+`;
+export const mainGo = `package main
+
+import (
+  "context"
+  "log"
+  "strconv"
+
+  service "github.com/wundergraph/cosmo/plugin/generated"
+
+  routerplugin "github.com/wundergraph/cosmo/router-plugin"
+  "google.golang.org/grpc"
+)
+
+func main() {
+  pl, err := routerplugin.NewRouterPlugin(func(s *grpc.Server) {
+    s.RegisterService(&service.{serviceName}_ServiceDesc, &{serviceName}{
+      nextID: 1,
+    })
+  })
+
+  if err != nil {
+    log.Fatalf("failed to create router plugin: %v", err)
+  }
+
+  pl.Serve()
+}
+
+type {serviceName} struct {
+  service.Unimplemented{serviceName}Server
+  nextID int
+}
+
+func (s *{serviceName}) QueryHello(ctx context.Context, req *service.QueryHelloRequest) (*service.QueryHelloResponse, error) {
+  response := &service.QueryHelloResponse{
+    Hello: &service.World{
+      Id:   strconv.Itoa(s.nextID),
+      Name: req.Name,
+    },
+  }
+  s.nextID++
+  return response, nil
+}
+`;
+export const mainGoTest = `package main
+
+import (
+  "context"
+  "net"
+  "testing"
+
+  "github.com/stretchr/testify/assert"
+  "github.com/stretchr/testify/require"
+  service "github.com/wundergraph/cosmo/plugin/generated"
+  "google.golang.org/grpc"
+  "google.golang.org/grpc/credentials/insecure"
+  "google.golang.org/grpc/test/bufconn"
+)
+
+const bufSize = 1024 * 1024
+
+// testService is a wrapper that holds the gRPC test components
+type testService struct {
+  grpcConn  *grpc.ClientConn
+  client service.{serviceName}Client
+  cleanup   func()
+}
+
+// setupTestService creates a local gRPC server for testing
+func setupTestService(t *testing.T) *testService {
+  // Create a buffer for gRPC connections
+  lis := bufconn.Listen(bufSize)
+
+  // Create a new gRPC server
+  grpcServer := grpc.NewServer()
+
+  // Register our service
+  service.Register{serviceName}Server(grpcServer, &{serviceName}{
+    nextID: 1,
+  })
+
+  // Start the server
+  go func() {
+    if err := grpcServer.Serve(lis); err != nil {
+      t.Fatalf("failed to serve: %v", err)
+    }
+  }()
+
+  // Create a client connection
+  dialer := func(context.Context, string) (net.Conn, error) {
+    return lis.Dial()
+  }
+  conn, err := grpc.Dial(
+    "passthrough:///bufnet",
+    grpc.WithContextDialer(dialer),
+    grpc.WithTransportCredentials(insecure.NewCredentials()),
+  )
+  require.NoError(t, err)
+
+  // Create the service client
+  client := service.New{serviceName}Client(conn)
+
+  // Return cleanup function
+  cleanup := func() {
+    conn.Close()
+    grpcServer.Stop()
+  }
+
+  return &testService{
+    grpcConn:  conn,
+    client: client,
+    cleanup:   cleanup,
+  }
+}
+
+func TestQueryHello(t *testing.T) {
+  // Set up basic service
+  svc := setupTestService(t)
+  defer svc.cleanup()
+
+  tests := []struct {
+    name     string
+    userName string
+    wantId   string
+    wantName string
+    wantErr  bool
+  }{
+    {
+      name:     "valid hello",
+      userName: "Alice",
+      wantId:   "1",
+      wantName: "Alice",
+      wantErr:  false,
+    },
+    {
+      name:     "empty name",
+      userName: "",
+      wantId:   "2",
+      wantName: "", // Empty name should be preserved
+      wantErr:  false,
+    },
+    {
+      name:     "special characters",
+      userName: "John & Jane",
+      wantId:   "3",
+      wantName: "John & Jane",
+      wantErr:  false,
+    },
+  }
+
+  for _, tt := range tests {
+    t.Run(tt.name, func(t *testing.T) {
+      req := &service.QueryHelloRequest{
+        Name: tt.userName,
+      }
+
+      resp, err := svc.client.QueryHello(context.Background(), req)
+      if tt.wantErr {
+        assert.Error(t, err)
+        return
+      }
+
+      assert.NoError(t, err)
+      assert.NotNil(t, resp.Hello)
+      assert.Equal(t, tt.wantId, resp.Hello.Id)
+      assert.Equal(t, tt.wantName, resp.Hello.Name)
+    })
+  }
+}
+
+func TestSequentialIDs(t *testing.T) {
+  // Set up basic service
+  svc := setupTestService(t)
+  defer svc.cleanup()
+
+  // The first request should get ID "1"
+  firstReq := &service.QueryHelloRequest{Name: "First"}
+  firstResp, err := svc.client.QueryHello(context.Background(), firstReq)
+  require.NoError(t, err)
+  assert.Equal(t, "1", firstResp.Hello.Id)
+
+  // The second request should get ID "2"
+  secondReq := &service.QueryHelloRequest{Name: "Second"}
+  secondResp, err := svc.client.QueryHello(context.Background(), secondReq)
+  require.NoError(t, err)
+  assert.Equal(t, "2", secondResp.Hello.Id)
+
+  // The third request should get ID "3"
+  thirdReq := &service.QueryHelloRequest{Name: "Third"}
+  thirdResp, err := svc.client.QueryHello(context.Background(), thirdReq)
+  require.NoError(t, err)
+  assert.Equal(t, "3", thirdResp.Hello.Id)
+}
+`;
+export const readme = `# {name} Plugin - Cosmo gRPC Subgraph Example
+
+This repository contains a simple Cosmo gRPC subgraph plugin that showcases how to design APIs with GraphQL but implement them using gRPC methods instead of traditional resolvers.
+
+## What is this demo about?
+
+This demo illustrates a key pattern in Cosmo subgraph development:
+- **Design with GraphQL**: Define your API using GraphQL schema
+- **Implement with gRPC**: Instead of writing GraphQL resolvers, implement gRPC service methods
+- **Bridge the gap**: The Cosmo router connects GraphQL operations to your gRPC implementations
+- **Test-Driven Development**: Test your gRPC service implementation with gRPC client and server without external dependencies
+
+The plugin demonstrates:
+- How GraphQL types and operations map to gRPC service methods
+- Simple "Hello World" implementation
+- Proper structure for a Cosmo gRPC subgraph plugin
+- How to test your gRPC service implementation with gRPC client and server without external dependencies
+
+## Plugin Structure
+
+- \`src/\` - Contains the plugin source code
+  - \`main.go\` - The gRPC service implementation with methods that replace GraphQL resolvers
+  - \`main_test.go\` - The gRPC service implementation with methods that replace GraphQL resolvers
+  - \`schema.graphql\` - The GraphQL schema defining the API contract
+- \`generated/\` - Contains generated code from the plugin schema
+- \`bin/\` - Contains compiled binaries of the plugin
+
+## GraphQL to gRPC Mapping
+
+The plugin shows how GraphQL operations map to gRPC methods:
+
+| GraphQL Operation | gRPC Method |
+|-------------------|-------------|
+| \`query { hello }\` | \`QueryHello()\` |
+
+## GraphQL Schema
+
+\`\`\`graphql
+type World {
+  id: ID!
+  name: String!
+}
+
+type Query {
+  hello(name: String!): World!
+}
+\`\`\`
+
+## Getting Started
+
+1. **Build the plugin**
+
+   \`\`\`
+   wgc router plugin build <plugin-directory>
+   \`\`\`
+
+2. **Compose your supergraph with your gRPC subgraph**
+
+   config.yaml
+   \`\`\`yaml
+   subgraphs:
+     - name: <plugin-name>
+       plugin:
+         version: 0.0.1
+         directory: <plugin-directory>/<plugin-name>
+   \`\`\`
+
+3. **Build the federated graph**
+
+    \`\`\`bash
+    wgc router compose config.yaml
+    \`\`\`
+
+4. **Test the plugin**
+
+   \`\`\`bash
+   wgc router plugin test <plugin-directory>/<plugin-name>
+   \`\`\`
+   or
+   \`\`\`bash
+   go test src -v
+   \`\`\`
+   if you have the Go toolchain already installed.
+
+5. **Start the router**
+
+   \`\`\`yaml
+   execution_config:
+    file:
+        path: ./config.yaml
+   plugins:
+    - <plugin-directory>
+   \`\`\`
+
+6. **Query the hello endpoint**
+
+   Once running, you can perform GraphQL operations like:
+   
+   \`\`\`graphql
+   # Hello query
+   query {
+     hello(name: "World") {
+       id
+       name
+     }
+   }
+   \`\`\`
+
+## Further Steps
+
+- Change the plugin code in \`src/main.go\` and rebuild the plugin
+- Change the GraphQL schema in \`src/schema.graphql\` and rebuild the plugin
+
+## Learn More
+
+For more information about Cosmo and building subgraph plugins, visit the [Cosmo documentation](https://cosmo-docs.wundergraph.com).`;
+export const schema = `type World {
+  """
+  The ID of the world
+  """
+  id: ID!
+  """
+  The name of the world
+  """
+  name: String!
+}
+
+type Query {
+  """
+  The hello query
+  """
+  hello(name: String!): World!
+}
+`;
+//# sourceMappingURL=go-plugin.js.map

package/dist/src/commands/router/plugin/templates/go-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-plugin.js","sourceRoot":"","sources":["../../../../../../src/commands/router/plugin/templates/go-plugin.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+CAA+C;AAE/C,MAAM,CAAC,MAAM,KAAK,GAAG;;;;;;;;;;;CAWpB,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0CrB,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqJzB,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qIAmH+G,CAAC;AAEtI,MAAM,CAAC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;CAiBrB,CAAC"}