Registry / devops / celepar-microservices-grpc

celepar-microservices-grpc

library1.4.3jsnpmunverified

A microservices library (v1.4.3) that integrates gRPC with Redis pub/sub for service discovery and load balancing. It allows services to register themselves via Redis sets and clients to discover available servers dynamically. Active development with infrequent releases. Key differentiator: lightweight, automatic failover, and no external service mesh required.

devops

npm install celepar-microservices-grpc

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · CELEPAR-MICROSERVI

celepar-microservices-grpc

devopsjavascriptv1.4.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.

Server

✓ import { Server } from 'celepar-microservices-grpc'

✗ const Server = require('celepar-microservices-grpc').Server

ESM named import. CommonJS usage: const { Server } = require('celepar-microservices-grpc').

Client

✓ import { Client } from 'celepar-microservices-grpc'

ESM named import. CommonJS usage: const { Client } = require('celepar-microservices-grpc').

default import

✓ import { Server } from 'celepar-microservices-grpc'

✗ import Celepar from 'celepar-microservices-grpc'

No default export; use named imports.

Shows basic server and client setup using gRPC and Redis for microservices communication.

import { Server, Client } from 'celepar-microservices-grpc' const server = new Server({ package: 'helloworld', service: 'Greeter', proto: './hello.proto', redis: { host: 'localhost', port: 6379, db: 10 } }) server.use({ SayHello: async (ctx) => ({ message: 'Hello ' + ctx.request.name }) }).start() const client = new Client({ services: [{ package: 'helloworld', service: 'Greeter' }], proto: './hello.proto', redis: { host: 'localhost', port: 6379, db: 10 } }).start() const res = await client.helloworld.Greeter.sayHello({ name: 'World' }) console.log(res)

Debug

Known issues

gotchaRedis connection required; library fails if Redis is unreachable

fix

Ensure Redis is running and connection settings (host, port, db) are correct.

affects: >=0.0.0

gotchaService methods must be asynchronous or return a Promise; synchronous handlers break client calls

fix

Define service methods as async or wrap in Promise.

affects: >=0.0.0

gotchaProto file path must be absolute or relative to process.cwd(); relative paths may fail

fix

Use __dirname + '/hello.proto' or path.resolve().

affects: >=0.0.0

deprecatedSpecifying service as object with `package` and `service` properties may be deprecated in future

fix

Use string identifiers as shown in documentation.

affects: >=1.0.0

gotchaClient call returns undefined if service name or method is misspelled

fix

Double-check service and method names against proto file.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Redis connection to localhost:6379 failed - connect ECONNREFUSED

Redis server not running or wrong host/port

fix

Start Redis or update connection config.

Error: Cannot find module './hello.proto'

Proto file path is incorrect or doesn't exist

fix

Provide absolute path using __dirname + '/path/to/file.proto'.

TypeError: Cannot read properties of undefined (reading 'Greeter')

Client's service registry missing the service or client not started

fix

Ensure client.start() is called and Redis has registered servers.

UnhandledPromiseRejectionWarning: Error: 12 UNIMPLEMENTED: Method not found

Server does not implement the called method

fix

Add missing method to server service object.

Upgrade

Version history

1.4.3latest on npm

Audit

Dependencies

grpcrequiredCore dependency for gRPC communication

redisrequiredRequired for service registry and discovery via Redis pub/sub

Agent activity

5 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/chameleonbr/celepar-microservices-grpc ↗

packagecelepar-microservices-grpc ↗

homepagehttps://github.com/chameleonbr/celepar-microservices-grpc#readme ↗