grpc-descriptor-reflection 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MasonryStack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,174 @@
+# grpc-descriptor-reflection
+
+A gRPC server reflection service for [`@grpc/grpc-js`](https://www.npmjs.com/package/@grpc/grpc-js) that serves **raw `FileDescriptorProto` bytes** from a pre-built descriptor set, preserving all extensions and custom options byte-for-byte.
+
+## Why?
+
+Existing reflection libraries for Node.js gRPC lose extension fields during serialization:
+
+- **`@grpc/reflection`** decodes descriptors through protobufjs and re-encodes them. protobufjs silently drops all extension fields (`google.api.http`, `openapiv2_operation`, custom options, etc.) because they are not declared fields on the standard option message types.
+
+- **`grpc-server-reflection`** uses `google-protobuf` which performs a similar decode/re-encode round-trip, with no guarantee of byte-for-byte fidelity.
+
+This means any downstream consumer relying on reflection (API gateways, documentation generators, gRPC-to-HTTP transcoders) will see methods without HTTP bindings, missing OpenAPI annotations, or stripped custom options.
+
+**`grpc-descriptor-reflection`** solves this by:
+
+1. Parsing the `FileDescriptorSet` wire format directly to extract each `FileDescriptorProto` as a raw byte slice
+2. Using `@bufbuild/protobuf` only for indexing (building symbol and dependency lookups)
+3. Serving the original raw bytes to reflection clients without any re-encoding
+
+The result is **byte-for-byte identical** output to what `buf build` or `protoc` produced.
+
+## Installation
+
+```bash
+npm install grpc-descriptor-reflection
+```
+
+Peer dependencies (you likely already have these):
+
+```bash
+npm install @grpc/grpc-js @grpc/proto-loader
+```
+
+## Generating a Descriptor Set
+
+You need a binary `FileDescriptorSet` file. Generate one with either `buf` or `protoc`:
+
+### With buf (recommended)
+
+```bash
+buf build -o descriptor.bin --as-file-descriptor-set
+```
+
+### With protoc
+
+```bash
+protoc \
+  --descriptor_set_out=descriptor.bin \
+  --include_imports \
+  -I ./proto \
+  ./proto/**/*.proto
+```
+
+> **Important:** Use `--include_imports` (protoc) or the default behavior of `buf build` to include all transitive dependencies. The reflection service needs the full dependency graph to serve complete responses.
+
+## Usage
+
+### With vanilla `@grpc/grpc-js`
+
+```ts
+import * as grpc from "@grpc/grpc-js";
+import { DescriptorReflectionService } from "grpc-descriptor-reflection";
+
+const server = new grpc.Server();
+
+// Add your application services...
+// server.addService(MyService, myImplementation);
+
+// Add reflection (registers both v1 and v1alpha endpoints)
+const reflection = new DescriptorReflectionService("path/to/descriptor.bin");
+reflection.addToServer(server);
+
+server.bindAsync("0.0.0.0:50051", grpc.ServerCredentials.createInsecure(), () => {
+  console.log("Server listening on port 50051");
+});
+```
+
+### With NestJS gRPC microservice
+
+```ts
+import { DescriptorReflectionService } from "grpc-descriptor-reflection";
+
+const reflection = new DescriptorReflectionService(
+  join(__dirname, "..", "descriptor.bin"),
+);
+
+@Module({
+  imports: [
+    ClientsModule.register([
+      {
+        name: "ORDERS_PACKAGE",
+        transport: Transport.GRPC,
+        options: {
+          package: "orders.v1",
+          protoPath: join(__dirname, "../proto/orders/v1/orders.proto"),
+          url: "0.0.0.0:50051",
+          onLoadPackageDefinition: (_pkg, server) => {
+            reflection.addToServer(server);
+          },
+        },
+      },
+    ]),
+  ],
+})
+export class AppModule {}
+```
+
+### Filtering advertised services
+
+By default, all services found in the descriptor set are advertised via `ListServices`. You can restrict which services are listed:
+
+```ts
+const reflection = new DescriptorReflectionService("descriptor.bin", {
+  services: ["mypackage.MyService", "mypackage.AdminService"],
+});
+```
+
+> Note: The filter only affects `ListServices` responses. All symbols remain resolvable via `FileContainingSymbol` regardless of the filter.
+
+## API
+
+### `new DescriptorReflectionService(descriptorSetPath, options?)`
+
+Creates a new reflection service instance.
+
+**Parameters:**
+
+- `descriptorSetPath` (`string`) - Path to a binary-encoded `FileDescriptorSet` file.
+- `options` (`DescriptorReflectionServiceOptions`) - Optional configuration.
+  - `services` (`string[]`) - Restrict which services are advertised via `ListServices`. If omitted, all services in the descriptor set are advertised.
+
+### `reflection.addToServer(server)`
+
+Registers both `grpc.reflection.v1.ServerReflection` and `grpc.reflection.v1alpha.ServerReflection` services on the given server.
+
+**Parameters:**
+
+- `server` - A `grpc.Server` instance or any object with an `addService(service, implementation)` method.
+
+## Supported Reflection Operations
+
+| Operation | Description |
+|---|---|
+| `ListServices` | Lists all (or filtered) services |
+| `FileContainingSymbol` | Returns file descriptors for a fully-qualified symbol |
+| `FileByFilename` | Returns a file descriptor by its proto filename |
+| `FileContainingExtension` | Returns the file containing an extension field |
+| `AllExtensionNumbersOfType` | Returns all extension field numbers for a type |
+
+All responses include transitive dependencies.
+
+## Comparison with `@grpc/reflection`
+
+| Feature | `@grpc/reflection` | `grpc-descriptor-reflection` |
+|---|---|---|
+| Preserves `google.api.http` | No | Yes |
+| Preserves `openapiv2_operation` | No | Yes |
+| Preserves custom options | No | Yes |
+| Byte-for-byte fidelity | No | Yes |
+| Input | Proto file paths | Pre-built descriptor set |
+| Encoding library | protobufjs (lossy) | Raw wire format (lossless) |
+
+## How It Works
+
+1. The constructor reads the binary `FileDescriptorSet` and parses the protobuf wire format directly to extract each `FileDescriptorProto` as a raw `Uint8Array` slice.
+2. It then decodes the set with `@bufbuild/protobuf` (which does preserve extensions) solely to build indexes: symbol-to-file mappings, dependency graphs, and extension registries.
+3. When a reflection client requests a file, the service serves the **original raw bytes** extracted in step 1, along with all transitive dependencies.
+
+Since the raw bytes are never decoded and re-encoded, every extension field, custom option, and annotation is preserved exactly as the proto compiler produced it.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Options for creating a {@link DescriptorReflectionService}.
+ */
+export interface DescriptorReflectionServiceOptions {
+    /**
+     * Restrict which services are advertised via `ListServices`.
+     * If omitted, all services found in the descriptor set are advertised.
+     */
+    services?: string[];
+}
+/**
+ * A gRPC server reflection service that serves raw `FileDescriptorProto` bytes
+ * from a pre-built descriptor set (e.g. produced by `buf build -o descriptor.bin`).
+ *
+ * Unlike `@grpc/reflection`, which decodes and re-encodes descriptors through
+ * protobufjs (silently stripping all extensions like `google.api.http`,
+ * `openapiv2_operation`, etc.), this implementation preserves the original binary
+ * encoding byte-for-byte. All custom options and extensions are retained.
+ *
+ * Registers both `grpc.reflection.v1` and `grpc.reflection.v1alpha` endpoints.
+ *
+ * @example
+ * ```ts
+ * import { DescriptorReflectionService } from "grpc-descriptor-reflection";
+ *
+ * const reflection = new DescriptorReflectionService("path/to/descriptor.bin");
+ *
+ * // With NestJS gRPC microservice:
+ * onLoadPackageDefinition: (_pkg, server) => {
+ *   reflection.addToServer(server);
+ * }
+ *
+ * // With vanilla @grpc/grpc-js:
+ * reflection.addToServer(server);
+ * ```
+ */
+export declare class DescriptorReflectionService {
+    /** Files indexed by filename. */
+    private files;
+    /** Fully-qualified symbol name -> filename. */
+    private symbols;
+    /** Service FQN -> filename. */
+    private services;
+    /** File dependency graph: filename -> list of dependency filenames. */
+    private dependencies;
+    /** Extension index: extendee type -> Map<field number, filename>. */
+    private extensions;
+    /** Optional filter for advertised services. */
+    private serviceFilter?;
+    /**
+     * @param descriptorSetPath - Path to a binary-encoded `FileDescriptorSet`
+     *   file (e.g. produced by `buf build -o descriptor.bin --as-file-descriptor-set`
+     *   or `protoc --descriptor_set_out`).
+     * @param options - Optional configuration.
+     */
+    constructor(descriptorSetPath: string, options?: DescriptorReflectionServiceOptions);
+    private indexMessage;
+    /** Collect raw bytes for a file and all its transitive dependencies. */
+    private collectFileWithDeps;
+    private handleRequest;
+    /**
+     * Register both `grpc.reflection.v1` and `grpc.reflection.v1alpha` reflection
+     * services on the given gRPC server.
+     *
+     * @param server - A `grpc.Server` instance or any object with an `addService` method
+     *   (e.g. the server object from NestJS `onLoadPackageDefinition`).
+     */
+    addToServer(server: {
+        addService: (service: any, implementation: any) => any;
+    }): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,2BAA2B;IACtC,iCAAiC;IACjC,OAAO,CAAC,KAAK,CAAgC;IAC7C,+CAA+C;IAC/C,OAAO,CAAC,OAAO,CAA6B;IAC5C,+BAA+B;IAC/B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,uEAAuE;IACvE,OAAO,CAAC,YAAY,CAA+B;IACnD,qEAAqE;IACrE,OAAO,CAAC,UAAU,CAA0C;IAC5D,+CAA+C;IAC/C,OAAO,CAAC,aAAa,CAAC,CAAc;IAEpC;;;;;OAKG;gBAED,iBAAiB,EAAE,MAAM,EACzB,OAAO,CAAC,EAAE,kCAAkC;IA6E9C,OAAO,CAAC,YAAY;IAmDpB,wEAAwE;IACxE,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,aAAa;IAwFrB;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,KAAK,GAAG,CAAC;KACxD,GAAG,IAAI;CA4CT"}

package/dist/index.js

@@ -0,0 +1,404 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DescriptorReflectionService = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const grpc = __importStar(require("@grpc/grpc-js"));
+const protoLoader = __importStar(require("@grpc/proto-loader"));
+const protobuf_1 = require("@bufbuild/protobuf");
+const wkt_1 = require("@bufbuild/protobuf/wkt");
+/**
+ * Resolve the package root directory, supporting both CJS and ESM.
+ * In CJS (compiled output), __dirname points to dist/, so we go up one level.
+ * In ESM (e.g. running source directly with --experimental-strip-types),
+ * __dirname is not available so we use import.meta.
+ */
+function resolvePackageDir() {
+    if (typeof __dirname !== "undefined") {
+        // CJS: __dirname is dist/ → package root is ..
+        return (0, node_path_1.join)(__dirname, "..");
+    }
+    // ESM: import.meta.filename points to src/index.ts → package root is ..
+    // @ts-ignore -- import.meta.filename available in Node 21+
+    return (0, node_path_1.join)((0, node_path_1.dirname)(import.meta.filename), "..");
+}
+const PROTO_LOADER_OPTS = {
+    longs: String,
+    enums: String,
+    bytes: Array,
+    defaults: true,
+    oneofs: true,
+};
+/**
+ * A gRPC server reflection service that serves raw `FileDescriptorProto` bytes
+ * from a pre-built descriptor set (e.g. produced by `buf build -o descriptor.bin`).
+ *
+ * Unlike `@grpc/reflection`, which decodes and re-encodes descriptors through
+ * protobufjs (silently stripping all extensions like `google.api.http`,
+ * `openapiv2_operation`, etc.), this implementation preserves the original binary
+ * encoding byte-for-byte. All custom options and extensions are retained.
+ *
+ * Registers both `grpc.reflection.v1` and `grpc.reflection.v1alpha` endpoints.
+ *
+ * @example
+ * ```ts
+ * import { DescriptorReflectionService } from "grpc-descriptor-reflection";
+ *
+ * const reflection = new DescriptorReflectionService("path/to/descriptor.bin");
+ *
+ * // With NestJS gRPC microservice:
+ * onLoadPackageDefinition: (_pkg, server) => {
+ *   reflection.addToServer(server);
+ * }
+ *
+ * // With vanilla @grpc/grpc-js:
+ * reflection.addToServer(server);
+ * ```
+ */
+class DescriptorReflectionService {
+    /**
+     * @param descriptorSetPath - Path to a binary-encoded `FileDescriptorSet`
+     *   file (e.g. produced by `buf build -o descriptor.bin --as-file-descriptor-set`
+     *   or `protoc --descriptor_set_out`).
+     * @param options - Optional configuration.
+     */
+    constructor(descriptorSetPath, options) {
+        /** Files indexed by filename. */
+        this.files = new Map();
+        /** Fully-qualified symbol name -> filename. */
+        this.symbols = new Map();
+        /** Service FQN -> filename. */
+        this.services = new Map();
+        /** File dependency graph: filename -> list of dependency filenames. */
+        this.dependencies = new Map();
+        /** Extension index: extendee type -> Map<field number, filename>. */
+        this.extensions = new Map();
+        if (options?.services) {
+            this.serviceFilter = new Set(options.services);
+        }
+        const bin = (0, node_fs_1.readFileSync)(descriptorSetPath);
+        const descriptorSet = (0, protobuf_1.fromBinary)(wkt_1.FileDescriptorSetSchema, bin);
+        // Extract raw bytes for each FileDescriptorProto by parsing the wire
+        // format of the FileDescriptorSet directly. This preserves the exact bytes
+        // produced by buf/protoc without any decode/re-encode cycle.
+        const rawEntries = extractRawFileDescriptorProtos(bin);
+        for (let i = 0; i < descriptorSet.file.length; i++) {
+            const fd = descriptorSet.file[i];
+            const name = fd.name;
+            if (!name)
+                continue;
+            // Use raw bytes extracted from the original binary if available,
+            // otherwise fall back to re-encoding via @bufbuild/protobuf (which
+            // does preserve extensions, unlike protobufjs).
+            const rawBytes = rawEntries[i] ?? (0, protobuf_1.toBinary)(wkt_1.FileDescriptorProtoSchema, fd);
+            this.files.set(name, { descriptor: fd, rawBytes });
+            this.dependencies.set(name, [...fd.dependency]);
+            const pkg = fd.package;
+            const prefix = pkg ? `${pkg}.` : "";
+            for (const msg of fd.messageType) {
+                this.indexMessage(prefix, msg, name);
+            }
+            for (const en of fd.enumType) {
+                if (en.name) {
+                    this.symbols.set(`${prefix}${en.name}`, name);
+                    for (const val of en.value) {
+                        if (val.name) {
+                            this.symbols.set(`${prefix}${en.name}.${val.name}`, name);
+                        }
+                    }
+                }
+            }
+            for (const svc of fd.service) {
+                if (svc.name) {
+                    const svcFqn = `${prefix}${svc.name}`;
+                    this.symbols.set(svcFqn, name);
+                    this.services.set(svcFqn, name);
+                    for (const method of svc.method) {
+                        if (method.name) {
+                            this.symbols.set(`${svcFqn}.${method.name}`, name);
+                        }
+                    }
+                }
+            }
+            for (const ext of fd.extension) {
+                if (ext.extendee && ext.number) {
+                    const extendee = ext.extendee.startsWith(".")
+                        ? ext.extendee.slice(1)
+                        : ext.extendee;
+                    let extMap = this.extensions.get(extendee);
+                    if (!extMap) {
+                        extMap = new Map();
+                        this.extensions.set(extendee, extMap);
+                    }
+                    extMap.set(ext.number, name);
+                    if (ext.name) {
+                        this.symbols.set(`${prefix}${ext.name}`, name);
+                    }
+                }
+            }
+        }
+    }
+    indexMessage(prefix, msg, filename) {
+        if (!msg.name)
+            return;
+        const fqn = `${prefix}${msg.name}`;
+        this.symbols.set(fqn, filename);
+        for (const field of msg.field) {
+            if (field.name) {
+                this.symbols.set(`${fqn}.${field.name}`, filename);
+            }
+        }
+        for (const oneof of msg.oneofDecl) {
+            if (oneof.name) {
+                this.symbols.set(`${fqn}.${oneof.name}`, filename);
+            }
+        }
+        for (const nested of msg.nestedType) {
+            this.indexMessage(`${fqn}.`, nested, filename);
+        }
+        for (const en of msg.enumType) {
+            if (en.name) {
+                this.symbols.set(`${fqn}.${en.name}`, filename);
+                for (const val of en.value) {
+                    if (val.name) {
+                        this.symbols.set(`${fqn}.${en.name}.${val.name}`, filename);
+                    }
+                }
+            }
+        }
+        for (const ext of msg.extension) {
+            if (ext.extendee && ext.number) {
+                const extendee = ext.extendee.startsWith(".")
+                    ? ext.extendee.slice(1)
+                    : ext.extendee;
+                let extMap = this.extensions.get(extendee);
+                if (!extMap) {
+                    extMap = new Map();
+                    this.extensions.set(extendee, extMap);
+                }
+                extMap.set(ext.number, filename);
+            }
+        }
+    }
+    /** Collect raw bytes for a file and all its transitive dependencies. */
+    collectFileWithDeps(filename) {
+        const visited = new Set();
+        const result = [];
+        const visit = (name) => {
+            if (visited.has(name))
+                return;
+            visited.add(name);
+            const entry = this.files.get(name);
+            if (!entry)
+                return;
+            result.push(entry.rawBytes);
+            for (const dep of this.dependencies.get(name) ?? []) {
+                visit(dep);
+            }
+        };
+        visit(filename);
+        return result;
+    }
+    handleRequest(message) {
+        const response = {
+            validHost: message.host,
+            originalRequest: message,
+        };
+        try {
+            switch (message.messageRequest) {
+                case "fileByFilename": {
+                    const filename = message.fileByFilename || "";
+                    if (!this.files.has(filename)) {
+                        throw {
+                            code: 5 /* NOT_FOUND */,
+                            msg: `File not found: ${filename}`,
+                        };
+                    }
+                    response.fileDescriptorResponse = {
+                        fileDescriptorProto: this.collectFileWithDeps(filename),
+                    };
+                    break;
+                }
+                case "fileContainingSymbol": {
+                    const symbol = message.fileContainingSymbol || "";
+                    const filename = this.symbols.get(symbol);
+                    if (!filename) {
+                        throw {
+                            code: 5 /* NOT_FOUND */,
+                            msg: `Symbol not found: ${symbol}`,
+                        };
+                    }
+                    response.fileDescriptorResponse = {
+                        fileDescriptorProto: this.collectFileWithDeps(filename),
+                    };
+                    break;
+                }
+                case "fileContainingExtension": {
+                    const containingType = message.fileContainingExtension?.containingType || "";
+                    const extensionNumber = message.fileContainingExtension?.extensionNumber ?? -1;
+                    const extMap = this.extensions.get(containingType);
+                    const filename = extMap?.get(extensionNumber);
+                    if (!filename) {
+                        throw {
+                            code: 5 /* NOT_FOUND */,
+                            msg: `Extension not found: ${containingType}(${extensionNumber})`,
+                        };
+                    }
+                    response.fileDescriptorResponse = {
+                        fileDescriptorProto: this.collectFileWithDeps(filename),
+                    };
+                    break;
+                }
+                case "allExtensionNumbersOfType": {
+                    const typeName = message.allExtensionNumbersOfType || "";
+                    const extMap = this.extensions.get(typeName);
+                    response.allExtensionNumbersResponse = {
+                        baseTypeName: typeName,
+                        extensionNumber: extMap ? [...extMap.keys()] : [],
+                    };
+                    break;
+                }
+                case "listServices": {
+                    const serviceNames = this.serviceFilter
+                        ? [...this.serviceFilter]
+                        : [...this.services.keys()];
+                    response.listServicesResponse = {
+                        service: serviceNames.map((name) => ({ name })),
+                    };
+                    break;
+                }
+                default: {
+                    throw {
+                        code: 12 /* UNIMPLEMENTED */,
+                        msg: `Unimplemented: ${message.messageRequest}`,
+                    };
+                }
+            }
+        }
+        catch (e) {
+            response.errorResponse = {
+                errorCode: e.code ?? 2 /* UNKNOWN */,
+                errorMessage: e.msg ?? "Unknown error",
+            };
+        }
+        return response;
+    }
+    /**
+     * Register both `grpc.reflection.v1` and `grpc.reflection.v1alpha` reflection
+     * services on the given gRPC server.
+     *
+     * @param server - A `grpc.Server` instance or any object with an `addService` method
+     *   (e.g. the server object from NestJS `onLoadPackageDefinition`).
+     */
+    addToServer(server) {
+        const handler = {
+            ServerReflectionInfo: (stream) => {
+                stream.on("end", () => stream.end());
+                stream.on("data", (message) => {
+                    try {
+                        stream.write(this.handleRequest(message));
+                    }
+                    catch (e) {
+                        console.error("[grpc-descriptor-reflection] Error:", e);
+                        stream.end();
+                    }
+                });
+            },
+        };
+        // Resolve the proto directory relative to this source file.
+        // In CJS (compiled), __dirname is available. In ESM (strip-types),
+        // we fall back to resolving from the package root via require.resolve.
+        const protoDir = (0, node_path_1.join)(resolvePackageDir(), "proto");
+        // Register v1
+        const v1ProtoPath = (0, node_path_1.join)(protoDir, "grpc/reflection/v1/reflection.proto");
+        const v1PkgDef = protoLoader.loadSync(v1ProtoPath, PROTO_LOADER_OPTS);
+        const v1Pkg = grpc.loadPackageDefinition(v1PkgDef);
+        server.addService(v1Pkg.grpc.reflection.v1.ServerReflection.service, handler);
+        // Register v1alpha
+        const v1AlphaProtoPath = (0, node_path_1.join)(protoDir, "grpc/reflection/v1alpha/reflection.proto");
+        const v1AlphaPkgDef = protoLoader.loadSync(v1AlphaProtoPath, PROTO_LOADER_OPTS);
+        const v1AlphaPkg = grpc.loadPackageDefinition(v1AlphaPkgDef);
+        server.addService(v1AlphaPkg.grpc.reflection.v1alpha.ServerReflection.service, handler);
+    }
+}
+exports.DescriptorReflectionService = DescriptorReflectionService;
+/**
+ * Extracts raw `FileDescriptorProto` byte arrays from a serialized
+ * `FileDescriptorSet` by parsing the protobuf wire format directly.
+ *
+ * This preserves the exact bytes produced by `buf build` or `protoc` without
+ * any decode/re-encode cycle, guaranteeing all extensions and custom options
+ * are retained byte-for-byte.
+ */
+function extractRawFileDescriptorProtos(bin) {
+    const result = [];
+    let offset = 0;
+    while (offset < bin.length) {
+        // Read tag varint
+        let tag = 0;
+        let shift = 0;
+        while (offset < bin.length) {
+            const byte = bin[offset++];
+            tag |= (byte & 0x7f) << shift;
+            if ((byte & 0x80) === 0)
+                break;
+            shift += 7;
+        }
+        const fieldNumber = tag >>> 3;
+        const wireType = tag & 0x7;
+        if (wireType !== 2) {
+            throw new Error(`Unexpected wire type ${wireType} for field ${fieldNumber} in FileDescriptorSet`);
+        }
+        // Read varint length
+        let length = 0;
+        shift = 0;
+        while (offset < bin.length) {
+            const byte = bin[offset++];
+            length |= (byte & 0x7f) << shift;
+            if ((byte & 0x80) === 0)
+                break;
+            shift += 7;
+        }
+        if (fieldNumber === 1) {
+            // Field 1 = repeated FileDescriptorProto
+            result.push(new Uint8Array(bin.buffer, bin.byteOffset + offset, length));
+        }
+        // Skip any other fields
+        offset += length;
+    }
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "grpc-descriptor-reflection",
+  "version": "1.0.0",
+  "description": "gRPC reflection service for @grpc/grpc-js that serves raw FileDescriptorProto bytes from a pre-built descriptor set, preserving all extensions and custom options (google.api.http, openapiv2, etc.)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "proto"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-strip-types --no-warnings --test test/reflection.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "grpc",
+    "reflection",
+    "protobuf",
+    "descriptor",
+    "grpc-js",
+    "google.api.http",
+    "extensions",
+    "openapi",
+    "buf"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MasonryStack/grpc-descriptor-reflection.git"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@grpc/grpc-js": "^1.0.0",
+    "@grpc/proto-loader": "^0.7.0 || ^0.8.0"
+  },
+  "devDependencies": {
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/proto/grpc/reflection/v1/reflection.proto

@@ -0,0 +1,146 @@
+// Copyright 2016 The gRPC Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Service exported by server reflection.  A more complete description of how
+// server reflection works can be found at
+// https://github.com/grpc/grpc/blob/master/doc/server-reflection.md
+//
+// The canonical version of this proto can be found at
+// https://github.com/grpc/grpc-proto/blob/master/grpc/reflection/v1/reflection.proto
+
+syntax = "proto3";
+
+package grpc.reflection.v1;
+
+option go_package = "google.golang.org/grpc/reflection/grpc_reflection_v1";
+option java_multiple_files = true;
+option java_package = "io.grpc.reflection.v1";
+option java_outer_classname = "ServerReflectionProto";
+
+service ServerReflection {
+  // The reflection service is structured as a bidirectional stream, ensuring
+  // all related requests go to a single server.
+  rpc ServerReflectionInfo(stream ServerReflectionRequest)
+      returns (stream ServerReflectionResponse);
+}
+
+// The message sent by the client when calling ServerReflectionInfo method.
+message ServerReflectionRequest {
+  string host = 1;
+  // To use reflection service, the client should set one of the following
+  // fields in message_request. The server distinguishes requests by their
+  // defined field and then handles them using corresponding methods.
+  oneof message_request {
+    // Find a proto file by the file name.
+    string file_by_filename = 3;
+
+    // Find the proto file that declares the given fully-qualified symbol name.
+    // This field should be a fully-qualified symbol name
+    // (e.g. <package>.<service>[.<method>] or <package>.<type>).
+    string file_containing_symbol = 4;
+
+    // Find the proto file which defines an extension extending the given
+    // message type with the given field number.
+    ExtensionRequest file_containing_extension = 5;
+
+    // Finds the tag numbers used by all known extensions of the given message
+    // type, and appends them to ExtensionNumberResponse in an undefined order.
+    // Its corresponding method is best-effort: it's not guaranteed that the
+    // reflection service will implement this method, and it's not guaranteed
+    // that this method will provide all extensions. Returns
+    // StatusCode::UNIMPLEMENTED if it's not implemented.
+    // This field should be a fully-qualified type name. The format is
+    // <package>.<type>
+    string all_extension_numbers_of_type = 6;
+
+    // List the full names of registered services. The content will not be
+    // checked.
+    string list_services = 7;
+  }
+}
+
+// The type name and extension number sent by the client when requesting
+// file_containing_extension.
+message ExtensionRequest {
+  // Fully-qualified type name. The format should be <package>.<type>
+  string containing_type = 1;
+  int32 extension_number = 2;
+}
+
+// The message sent by the server to answer ServerReflectionInfo method.
+message ServerReflectionResponse {
+  string valid_host = 1;
+  ServerReflectionRequest original_request = 2;
+  // The server sets one of the following fields according to the message_request
+  // in the request.
+  oneof message_response {
+    // This message is used to answer file_by_filename, file_containing_symbol,
+    // file_containing_extension requests with transitive dependencies.
+    // As the repeated label is not allowed in oneof fields, we use a
+    // FileDescriptorResponse message to encapsulate the repeated fields.
+    // The reflection service is allowed to avoid sending FileDescriptorProtos
+    // that were previously sent in response to earlier requests in the stream.
+    FileDescriptorResponse file_descriptor_response = 4;
+
+    // This message is used to answer all_extension_numbers_of_type requests.
+    ExtensionNumberResponse all_extension_numbers_response = 5;
+
+    // This message is used to answer list_services requests.
+    ListServiceResponse list_services_response = 6;
+
+    // This message is used when an error occurs.
+    ErrorResponse error_response = 7;
+  }
+}
+
+// Serialized FileDescriptorProto messages sent by the server answering
+// a file_by_filename, file_containing_symbol, or file_containing_extension
+// request.
+message FileDescriptorResponse {
+  // Serialized FileDescriptorProto messages. We avoid taking a dependency on
+  // descriptor.proto, which uses proto2 only features, by making them opaque
+  // bytes instead.
+  repeated bytes file_descriptor_proto = 1;
+}
+
+// A list of extension numbers sent by the server answering
+// all_extension_numbers_of_type request.
+message ExtensionNumberResponse {
+  // Full name of the base type, including the package name. The format
+  // is <package>.<type>
+  string base_type_name = 1;
+  repeated int32 extension_number = 2;
+}
+
+// A list of ServiceResponse sent by the server answering list_services request.
+message ListServiceResponse {
+  // The information of each service may be expanded in the future, so we use
+  // ServiceResponse message to encapsulate it.
+  repeated ServiceResponse service = 1;
+}
+
+// The information of a single service used by ListServiceResponse to answer
+// list_services request.
+message ServiceResponse {
+  // Full name of a registered service, including its package name. The format
+  // is <package>.<service>
+  string name = 1;
+}
+
+// The error code and error message sent by the server when an error occurs.
+message ErrorResponse {
+  // This field uses the error codes defined in grpc::StatusCode.
+  int32 error_code = 1;
+  string error_message = 2;
+}

package/proto/grpc/reflection/v1alpha/reflection.proto

@@ -0,0 +1,136 @@
+// Copyright 2016 gRPC authors.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// Service exported by server reflection
+
+syntax = "proto3";
+
+package grpc.reflection.v1alpha;
+
+service ServerReflection {
+  // The reflection service is structured as a bidirectional stream, ensuring
+  // all related requests go to a single server.
+  rpc ServerReflectionInfo(stream ServerReflectionRequest)
+      returns (stream ServerReflectionResponse);
+}
+
+// The message sent by the client when calling ServerReflectionInfo method.
+message ServerReflectionRequest {
+  string host = 1;
+  // To use reflection service, the client should set one of the following
+  // fields in message_request. The server distinguishes requests by their
+  // defined field and then handles them using corresponding methods.
+  oneof message_request {
+    // Find a proto file by the file name.
+    string file_by_filename = 3;
+
+    // Find the proto file that declares the given fully-qualified symbol name.
+    // This field should be a fully-qualified symbol name
+    // (e.g. <package>.<service>[.<method>] or <package>.<type>).
+    string file_containing_symbol = 4;
+
+    // Find the proto file which defines an extension extending the given
+    // message type with the given field number.
+    ExtensionRequest file_containing_extension = 5;
+
+    // Finds the tag numbers used by all known extensions of the given message
+    // type, and appends them to ExtensionNumberResponse in an undefined order.
+    // Its corresponding method is best-effort: it's not guaranteed that the
+    // reflection service will implement this method, and it's not guaranteed
+    // that this method will provide all extensions. Returns
+    // StatusCode::UNIMPLEMENTED if it's not implemented.
+    // This field should be a fully-qualified type name. The format is
+    // <package>.<type>
+    string all_extension_numbers_of_type = 6;
+
+    // List the full names of registered services. The content will not be
+    // checked.
+    string list_services = 7;
+  }
+}
+
+// The type name and extension number sent by the client when requesting
+// file_containing_extension.
+message ExtensionRequest {
+  // Fully-qualified type name. The format should be <package>.<type>
+  string containing_type = 1;
+  int32 extension_number = 2;
+}
+
+// The message sent by the server to answer ServerReflectionInfo method.
+message ServerReflectionResponse {
+  string valid_host = 1;
+  ServerReflectionRequest original_request = 2;
+  // The server set one of the following fields accroding to the message_request
+  // in the request.
+  oneof message_response {
+    // This message is used to answer file_by_filename, file_containing_symbol,
+    // file_containing_extension requests with transitive dependencies. As
+    // the repeated label is not allowed in oneof fields, we use a
+    // FileDescriptorResponse message to encapsulate the repeated fields.
+    // The reflection service is allowed to avoid sending FileDescriptorProtos
+    // that were previously sent in response to earlier requests in the stream.
+    FileDescriptorResponse file_descriptor_response = 4;
+
+    // This message is used to answer all_extension_numbers_of_type requst.
+    ExtensionNumberResponse all_extension_numbers_response = 5;
+
+    // This message is used to answer list_services request.
+    ListServiceResponse list_services_response = 6;
+
+    // This message is used when an error occurs.
+    ErrorResponse error_response = 7;
+  }
+}
+
+// Serialized FileDescriptorProto messages sent by the server answering
+// a file_by_filename, file_containing_symbol, or file_containing_extension
+// request.
+message FileDescriptorResponse {
+  // Serialized FileDescriptorProto messages. We avoid taking a dependency on
+  // descriptor.proto, which uses proto2 only features, by making them opaque
+  // bytes instead.
+  repeated bytes file_descriptor_proto = 1;
+}
+
+// A list of extension numbers sent by the server answering
+// all_extension_numbers_of_type request.
+message ExtensionNumberResponse {
+  // Full name of the base type, including the package name. The format
+  // is <package>.<type>
+  string base_type_name = 1;
+  repeated int32 extension_number = 2;
+}
+
+// A list of ServiceResponse sent by the server answering list_services request.
+message ListServiceResponse {
+  // The information of each service may be expanded in the future, so we use
+  // ServiceResponse message to encapsulate it.
+  repeated ServiceResponse service = 1;
+}
+
+// The information of a single service used by ListServiceResponse to answer
+// list_services request.
+message ServiceResponse {
+  // Full name of a registered service, including its package name. The format
+  // is <package>.<service>
+  string name = 1;
+}
+
+// The error code and error message sent by the server when an error occurs.
+message ErrorResponse {
+  // This field uses the error codes defined in grpc::StatusCode.
+  int32 error_code = 1;
+  string error_message = 2;
+}