Registry / devops / grpc-simple-wrapper

grpc-simple-wrapper

JSON →
library0.0.3jsnpmunverified

A simple gRPC wrapper for Node.js that simplifies the setup of gRPC clients and servers. Version 0.0.3, early stage with infrequent releases. Provides a thin abstraction over the core gRPC library to reduce boilerplate for common patterns like SSL configuration, channel management, and stub creation. Lightweight with minimal dependencies, intended for projects that need quick gRPC integration without complex customizations. Not a replacement for full-featured frameworks like gRPC-Web or NestJS gRPC modules.

npm install grpc-simple-wrapper
INSTALL
IMPORT
SIG · GRPC-SIMPLE-WRAPPE
G
grpc-simple-wrapper
devopsjavascriptv0.0.3
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

GrpcWrapper
import { GrpcWrapper } from 'grpc-simple-wrapper'
const GrpcWrapper = require('grpc-simple-wrapper')
Package is ESM-only; using require will throw an error. Ensure "type": "module" in package.json.
createServer
import { createServer } from 'grpc-simple-wrapper'
import { createServer } from 'grpc-simple-wrapper'
Common mistake: trying to import GrpcWrapper.createServer as a static method; it's a named export.
createClient
import { createClient } from 'grpc-simple-wrapper'
const client = require('grpc-simple-wrapper').createClient
Named export, not default; require destructuring is necessary for CJS but package is ESM-only.

Shows how to initialize a gRPC server and client using grpc-simple-wrapper, including proto loading and insecure credentials.

import { createServer, createClient } from 'grpc-simple-wrapper'; import * as protoLoader from '@grpc/proto-loader'; import * as grpc from '@grpc/grpc-js'; // Load proto file const packageDefinition = protoLoader.loadSync('helloworld.proto', { keepCase: true, longs: String, enums: String, defaults: true, oneofs: true }); const helloProto = grpc.loadPackageDefinition(packageDefinition).helloworld; // Create server const server = createServer({ proto: helloProto.Greeter.service, implementations: { sayHello: (call, callback) => { callback(null, { message: 'Hello ' + call.request.name }); } } }); server.bindAsync('0.0.0.0:50051', grpc.ServerCredentials.createInsecure(), () => { server.start(); console.log('Server running on port 50051'); }); // Create client const client = createClient({ proto: helloProto.Greeter, address: 'localhost:50051', credentials: grpc.credentials.createInsecure() }); client.sayHello({ name: 'World' }, (error, response) => { if (error) console.error(error); else console.log('Greeting:', response.message); });
Debug
Known issues
breakingPackage version 0.x may have breaking changes between minor versions.
fix
Pin to a specific version ("grpc-simple-wrapper": "0.0.3") and check changelog before upgrading.
affects: >=0.0.0 <1.0.0
gotchaThe wrapper does not support advanced gRPC features like streaming, interceptors, or custom channel args.
fix
If you need streaming or advanced features, use @grpc/grpc-js directly.
affects: >=0.0.0
deprecatedPackage uses 'keepCase: true' in protoLoader options by default, which may be deprecated in future proto-loader versions.
fix
Set keepCase: false and adjust field names to camelCase if needed.
affects: >=0.0.0
Errors
Common errors & fixes
Error: Cannot find module 'grpc-simple-wrapper'
Package not installed or import path incorrect
fix
Run 'npm install grpc-simple-wrapper' and ensure import path is correct (no typos).
TypeError: createServer is not a function
Import destructuring mismatch or using CJS require
fix
Use ESM import: 'import { createServer } from 'grpc-simple-wrapper''
Error: @grpc/proto-loader is required to load proto files
Missing peer dependency @grpc/proto-loader
fix
Install it: 'npm install @grpc/proto-loader'
Upgrade
Version history
0.0.3latest on npm
Audit
Dependencies
@grpc/grpc-jsrequiredCore gRPC runtime for Node.js
@grpc/proto-loaderrequiredLoads .proto files to generate service descriptors
Agent activity
6 hits · last 30 days
node
6
Resources
grpc-simple-wrapper — npm install grpc-simple-wrapper · libregistry