{"_id":"@avyaya/zrpc-core","_rev":"3-8b9959d5021281992aee2d2dd8b93026","name":"@avyaya/zrpc-core","dist-tags":{"latest":"0.2.2"},"versions":{"0.2.0":{"name":"@avyaya/zrpc-core","version":"0.2.0","keywords":["grpc","rpc","zod","typescript","typesafe"],"author":{"name":"Banisetti Naveen","email":"baninkumar@gmail.com"},"license":"MIT","_id":"@avyaya/zrpc-core@0.2.0","maintainers":[{"name":"baninaveenkr","email":"baninkumar@gmail.com"}],"homepage":"https://github.com/baninaveen/zrpc#readme","bugs":{"url":"https://github.com/baninaveen/zrpc/issues"},"dist":{"shasum":"934156ac28aa4baba0a6541a6aac98add3ff5abf","tarball":"https://registry.npmjs.org/@avyaya/zrpc-core/-/zrpc-core-0.2.0.tgz","fileCount":5,"integrity":"sha512-aaI/GSto9IMB/GxakLrnQaHdHRA9zZGE73yumn9kEo86m/HAG3g4jN00Xe59mn+XysTrvDAvaHmPKoRH2I1niw==","signatures":[{"sig":"MEQCIDBxh6ljtJFnoUnP0o5KtYp/dglTzMAF2gLDd/38gdoUAiA/XrpLCww07GJf9F37luexoZuOmDCNe+Bh1sA8ZFEoGw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18468},"main":"./dist/index.cjs","type":"module","_from":"file:avyaya-zrpc-core-0.2.0.tgz","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"}},"private":false,"scripts":{"dev":"pnpm build --watch","lint":"eslint src/","build":"tsup src/index.ts --format esm,cjs --dts --clean"},"_npmUser":{"name":"baninaveenkr","email":"baninkumar@gmail.com"},"_resolved":"C:\\Users\\pujab\\AppData\\Local\\Temp\\322bb45adf47ef7b48f9069c872c8e57\\avyaya-zrpc-core-0.2.0.tgz","_integrity":"sha512-aaI/GSto9IMB/GxakLrnQaHdHRA9zZGE73yumn9kEo86m/HAG3g4jN00Xe59mn+XysTrvDAvaHmPKoRH2I1niw==","repository":{"url":"git+https://github.com/baninaveen/zrpc.git","type":"git"},"_npmVersion":"10.8.1","description":"A type-safe gRPC framework for Node.js, built with Zod.","directories":{},"_nodeVersion":"20.16.0","dependencies":{"zod":"^4.1.6","@grpc/grpc-js":"^1.13.4","@grpc/proto-loader":"^0.8.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","typescript":"^5.9.2","@avyaya/zrpc-eslint-config":"1.0.0","@avyaya/zrpc-typescript-config":"1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/zrpc-core_0.2.0_1757696456931_0.989989071336115","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@avyaya/zrpc-core","version":"0.2.1","keywords":["grpc","rpc","zod","typescript","typesafe"],"author":{"name":"Banisetti Naveen","email":"baninkumar@gmail.com"},"license":"MIT","_id":"@avyaya/zrpc-core@0.2.1","maintainers":[{"name":"baninaveenkr","email":"baninkumar@gmail.com"}],"homepage":"https://github.com/baninaveen/zrpc#readme","bugs":{"url":"https://github.com/baninaveen/zrpc/issues"},"dist":{"shasum":"42b35702a2706ccbf8f391410f55728e3735f9fe","tarball":"https://registry.npmjs.org/@avyaya/zrpc-core/-/zrpc-core-0.2.1.tgz","fileCount":6,"integrity":"sha512-gUkVLEzFRXMhZSt+czcZp0V8t3KwYMHv8zbOrGkvDx9L7YkdgOKrPsBDFoFW2UuP70iHkEgQafurIGCH2y+98A==","signatures":[{"sig":"MEUCICKqNy4DE2KaUjaQvl3GCl9WE3gi38gKlCwTWb4L49cEAiEAjP87ompyvwCAYc/L/nBP+ysPPxrNnRVCzO0acVdUs98=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":21875},"main":"./dist/index.cjs","type":"module","types":"./dist/index.d.ts","module":"./dist/index.mjs","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.mjs","require":"./dist/index.cjs"}},"gitHead":"4d3d270ce73d1945f56f54a3b53c05899a2a2eac","private":false,"scripts":{"dev":"pnpm build --watch","lint":"eslint src/","build":"tsup src/index.ts --format esm,cjs --dts --clean"},"_npmUser":{"name":"baninaveenkr","email":"baninkumar@gmail.com"},"repository":{"url":"git+https://github.com/baninaveen/zrpc.git","type":"git"},"_npmVersion":"10.9.3","description":"A type-safe gRPC framework for Node.js, built with Zod.","directories":{},"_nodeVersion":"22.19.0","dependencies":{"zod":"^4.1.6","@grpc/grpc-js":"^1.13.4","@grpc/proto-loader":"^0.8.0"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.5.0","typescript":"^5.9.2","@avyaya/zrpc-eslint-config":"workspace:*","@avyaya/zrpc-typescript-config":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/zrpc-core_0.2.1_1759590797168_0.2674745524229434","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@avyaya/zrpc-core","version":"0.2.2","private":false,"description":"A type-safe gRPC framework for Node.js, built with Zod.","type":"module","exports":{".":{"import":"./dist/index.mjs","require":"./dist/index.cjs","types":"./dist/index.d.ts"}},"main":"./dist/index.cjs","module":"./dist/index.mjs","types":"./dist/index.d.ts","scripts":{"build":"tsup src/index.ts --format esm,cjs --dts --clean","dev":"pnpm build --watch","lint":"eslint src/"},"keywords":["grpc","rpc","zod","typescript","typesafe"],"author":{"name":"Banisetti Naveen","email":"baninkumar@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/baninaveen/zrpc.git"},"dependencies":{"@grpc/grpc-js":"^1.13.4","@grpc/proto-loader":"^0.8.0","zod":"^4.1.6"},"devDependencies":{"@avyaya/zrpc-eslint-config":"workspace:*","@avyaya/zrpc-typescript-config":"workspace:*","tsup":"^8.5.0","typescript":"^5.9.2"},"_id":"@avyaya/zrpc-core@0.2.2","gitHead":"00529676cafe57474090285d7d1f0065be7c78f4","bugs":{"url":"https://github.com/baninaveen/zrpc/issues"},"homepage":"https://github.com/baninaveen/zrpc#readme","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-BGSOcBW7cnJ/r+1NvkCv+iid/73aExRsJdJVIuQH19OLoOWLA/G9th+zB21RaW8ZnU9I6VQtR/Qv8W/prHMkwA==","shasum":"6a31064855aceaee497ef6a53b513a7293a0b727","tarball":"https://registry.npmjs.org/@avyaya/zrpc-core/-/zrpc-core-0.2.2.tgz","fileCount":6,"unpackedSize":24778,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD/ikoQCVWT5UD2tbZkP3ddPf5KjsvJYGjW19+ZbUSjgQIhAOzhbyd7ofvTzeAslcqHA8La3WFgmvFZq0I31W70KOFc"}]},"_npmUser":{"name":"baninaveenkr","email":"baninkumar@gmail.com"},"directories":{},"maintainers":[{"name":"baninaveenkr","email":"baninkumar@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zrpc-core_0.2.2_1759591690372_0.4392589821996189"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-12T17:00:56.833Z","modified":"2025-10-04T15:28:10.788Z","0.2.0":"2025-09-12T17:00:57.134Z","0.2.1":"2025-10-04T15:13:17.369Z","0.2.2":"2025-10-04T15:28:10.578Z"},"bugs":{"url":"https://github.com/baninaveen/zrpc/issues"},"author":{"name":"Banisetti Naveen","email":"baninkumar@gmail.com"},"license":"MIT","homepage":"https://github.com/baninaveen/zrpc#readme","keywords":["grpc","rpc","zod","typescript","typesafe"],"repository":{"type":"git","url":"git+https://github.com/baninaveen/zrpc.git"},"description":"A type-safe gRPC framework for Node.js, built with Zod.","maintainers":[{"name":"baninaveenkr","email":"baninkumar@gmail.com"}],"readme":"

\n\n \n \n

\n\n[![npm version](https://img.shields.io/npm/v/zrpc.svg?color=blue&style=flat-square)](https://www.npmjs.com/package/zrpc)\n[![License](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)\n[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?style=flat-square)](https://www.typescriptlang.org/)\n\n\nāœØ zRPC: The Missing Type-Safe gRPC Framework for Node.js\nzRPC is a lightweight, developer-friendly framework that brings end-to-end type safety to gRPC in Node.js, without ever needing to write a .proto file. By leveraging the power of Zod for schema definition and validation, zRPC allows you to build robust, high-performance RPC APIs with a development experience similar to tRPC.\n\n## Key Features\nšŸš€ End-to-End Type Safety: Automatically infer client-side types directly from your server's router definition.\n\nāœļø No .proto Files: Define your API contract once using Zod schemas in plain TypeScript.\n\nāœ… Automatic Validation: Built-in server-side and client-side validation powered by Zod.\n\nšŸ¤ Developer-Friendly: A simple, minimal API for creating servers and clients with modern async/await.\n\nāš” High Performance: Built on top of the native @grpc/grpc-js library, giving you all the performance benefits of gRPC and HTTP/2.\n\n## Installation\nInstall the core library and the command-line tool.\n\n```bash\npnpm add @avyaya/core @grpc/grpc-js zod\npnpm add -D @avyaya/cli\n```\n## Quick Start\nLet's build a simple Greeter service in 3 steps.\n\n### 1. Define Your Router\nCreate a central file to define your schemas and services. The router is the single source of truth for your API.\n\n```bash\nsrc/router.ts:\n```\n\nTypeScript\n\n```typescript\nimport { z } from 'zod';\n\nconst schemas = {\n SayHelloRequest: z.object({\n name: z.string(),\n }),\n SayHelloReply: z.object({\n message: z.string(),\n }),\n};\n\nconst services = {\n greeter: {\n async sayHello(input: z.infer) {\n console.log(`Handling request for: ${input.name}`);\n return {\n message: `Hello, ${input.name}!`,\n };\n },\n },\n};\n\nexport const appRouter = { schemas, services };\nexport type AppRouter = typeof appRouter;\n```\n\n### 2. Create the Server\nCreate a file to initialize and run your gRPC server.\n\n```bash\nsrc/server.ts:\n```\n\n```typescript\nimport { createZrpcServer } from '@avyaya/core';\nimport { appRouter } from './router';\n\nconst server = createZrpcServer(appRouter, '0.0.0.0:50051');\nserver.start();\n\nconsole.log('šŸš€ Server running on port 50051');\n```\n### 3. Create the Client\nCreate a client to call your server. Notice how we only import the type of the AppRouter, not the runtime object, keeping the client fully decoupled.\n\n```bash\nsrc/client.ts:\n```\n\n```typescript\nimport { createZrpcClient } from '@avyaya/core';\nimport type { AppRouter } from './router'; // Import ONLY the type\n\nasync function main() {\n const client = createZrpcClient({\n // In a real app, you would generate and import the proto string\n // For this quick start, we pass the router to generate it at runtime.\n router: appRouter,\n address: 'localhost:50051'\n });\n\n const response = await client.greeter.sayHello({ name: 'World' });\n\n console.log('āœ… Server Response:', response.message);\n // Output: āœ… Server Response: Hello, World!\n}\n\nmain();\n```\n\n## Contributing\nContributions are welcome! Please see the CONTRIBUTING.md file for guidelines on how to set up the development environment, run tests, and submit a pull request.\n\n## License\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\nIt's been a long and productive week of building here in Barrackpore. Congratulations on creating a fantastic open-source project!","readmeFilename":"README.md"}