Package Exports

grpc-server-reflection
grpc-server-reflection/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (grpc-server-reflection) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

grpc-server-reflection

gRPC server reflection for Node.js

Usage

Generate descriptor set

Generate descriptor set with grpc_tools_node_protoc using descriptor_set_out and include_imports, e.g.:

grpc_tools_node_protoc
    --descriptor_set_out=path/to/descriptor_set.bin
    --include_imports
    ./api/**/*.proto

Add reflection

import { Server } from '@grpc/grpc-js';
import { addReflection } from 'grpc-server-reflection'

const server = new Server()
addReflection(server, 'path/to/descriptor_set.bin')

Notes

Reflection can be added before or after registering other services
All services from descriptor set are available
Server reflection service is not included (unless added manually in the descriptor set)
Running tests requires grpc_cli

Thanks

This project is heavily inspired and ports some parts of code from nice-grpc-server-reflection. I respectfully burrowed some of the code based on encouragement from the author, to available solid server reflection for Node.js for general purpose. I tried to implement it myself but failed due to some incompatibilities with binary format in protobuf-js with the C++ implementation. Using descriptor sets avoids as in the referenced project avoids the issues.

package	full support	`@grpc/grpc-js` support	`grpc` support	framework agnostic	service detection
`grpc-server-reflection`	✅️	✅️	✅️	✅️	✅️
`nice-grpc-server-reflection`	✅️	✅️	❌	❌	❌
`grpc-node-server-reflection`	❌	✅️	❌	❌	❌
`grpc-reflection-js`	❌	✅️	❌	❌	❌

License

MIT