@funduck/connectrpc-fastify-nestjs 1.0.4 → 1.0.6

package/README.md

@@ -9,7 +9,7 @@ This package allows to add [Connectrpc](https://github.com/connectrpc/connect-es
 
 If you are comfortable with HTTP/1 only and want a compact, ready-to-use setup, this repository is for you.
 
-It simplifies the binding of controllers, middlewares, and guards.
+It simplifies the binding of controllers and middlewares.
 
 It uses my another package [Connectrpc Fastify Wrapper](https://github.com/funduck/connectrpc-fastify).
 
@@ -21,14 +21,14 @@ This library allows you to:
 * Perform RPC with streaming responses
 * Perform RPC with streaming requests
 * Use middlewares
-* Use global guards
+* Use interceptors
 
 *Bidirectional streaming RPC is currently out of scope because it requires HTTP/2, which is unstable on public networks. In practice, HTTP/1 provides more consistent performance.*
 
 
 ## How To Use
 
-You can check out the `test` directory for a complete example of server and client integration using NestJS and Fastify. Start reading from `test/app.module.ts`.
+You can check out the `test/demo` directory for a complete example of server and client integration using NestJS and Fastify. Start reading from `test/demo/app.module.ts`.
 
 Except the bootstrap instructions are pretty much the same as in [Connectrpc Fastify Wrapper](https://github.com/funduck/connectrpc-fastify#how-to-use).
 
@@ -75,26 +75,30 @@ export class TestMiddleware1 implements Middleware {
 
 ```
 
-### Guards
-Guard must implement `Guard` interface and register itself using `ConnectRPC.registerGuard`:
+### Interceptors
+Interceptor must implement `Interceptor` interface and register itself using `ConnectRPC.registerInterceptor`:
 ```TS
 @Injectable()
-export class TestGuard1 implements Guard {
+export class TestInterceptor1 implements Interceptor {
   @Inject(Logger)
   private logger: Logger;
 
   constructor() {
-    ConnectRPC.registerGuard(this);
+    ConnectRPC.registerInterceptor(this);
   }
 
-  canActivate(context: ExecutionContext): boolean {
-    return true;
+  use(next: AnyFn): AnyFn {
+    return async (req) => {
+      this.logger.log(`TestInterceptor1 invoked`);
+      return await next(req);
+    };
   }
 }
+
 ```
 
 ### Module Setup
-Configure your NestJS module to use `ConnectRPCModule.forRoot` and register middlewares/guards as providers if necessary:
+Configure your NestJS module to use `ConnectRPCModule.forRoot` and register middlewares and interceptors as providers if necessary:
 
 ```typescript
 @Module({
@@ -107,14 +111,16 @@ Configure your NestJS module to use `ConnectRPCModule.forRoot` and register midd
         middlewareConfig(TestMiddleware2, ElizaService),
         middlewareConfig(TestMiddleware3, ElizaService, ['say']),
       ],
+      interceptors: [
+        interceptorConfig(TestInterceptor1),
+        interceptorConfig(TestInterceptor2, ElizaService),
+        interceptorConfig(TestInterceptor3, ElizaService, ['say']),
+      ],
     }),
   ],
   providers: [
     Logger,
 
-    // Guard is provided the NestJS way
-    { provide: APP_GUARD, useClass: TestGuard1 },
-
     // Controllers are provided here instead of `controllers` array
     ElizaController, 
 
@@ -124,6 +130,11 @@ Configure your NestJS module to use `ConnectRPCModule.forRoot` and register midd
 
     // Middlewares that are applied via `consumer.apply()` should NOT be provided here
     // Do not instantiate TestMiddleware3 twice!
+
+    // Interceptors specific for ConnectRPC are provided here
+    TestInterceptor1,
+    TestInterceptor2,
+    TestInterceptor3,
   ],
 })
 export class AppModule implements NestModule {

package/dist/connectrpc.module.js

@@ -76,6 +76,7 @@ let ConnectRPCModule = ConnectRPCModule_1 = class ConnectRPCModule {
         if (!server) {
             throw new Error('Fastify server instance not found');
         }
+        connectrpc_fastify_1.ConnectRPC.initInterceptors(this.options.interceptors || []);
         await connectrpc_fastify_1.ConnectRPC.registerFastifyPlugin(server);
     }
     /** This is called by NestJS after the module has been initialized */
@@ -86,8 +87,6 @@ let ConnectRPCModule = ConnectRPCModule_1 = class ConnectRPCModule {
         const server = this.getServer();
         // Initialize middlewares first
         await connectrpc_fastify_1.ConnectRPC.initMiddlewares(server, this.options.middlewares || []);
-        // Initialize guards after middlewares
-        await connectrpc_fastify_1.ConnectRPC.initGuards(server);
     }
 };
 exports.ConnectRPCModule = ConnectRPCModule;

package/dist/connectrpc.module.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,3 @@
+export declare function printMsg(): void;
 export { ConnectRPCModule } from './connectrpc.module';
 export type { ConnectRPCModuleOptions } from './interfaces';

package/dist/index.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConnectRPCModule = void 0;
-// Export nestjs module
+exports.printMsg = printMsg;
+function printMsg() {
+    console.error('connectrpc-fastify-nestjs is in development mode! not ready for production yet!');
+}
 var connectrpc_module_1 = require("./connectrpc.module");
 Object.defineProperty(exports, "ConnectRPCModule", { enumerable: true, get: function () { return connectrpc_module_1.ConnectRPCModule; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uBAAuB;AACvB,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAIC;AAJD,SAAgB,QAAQ;IACtB,OAAO,CAAC,KAAK,CACX,iFAAiF,CAClF,CAAC;AACJ,CAAC;AAED,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA"}

package/dist/interfaces.d.ts

@@ -1,4 +1,5 @@
 import { Logger, MiddlewareConfigUnion } from '@funduck/connectrpc-fastify';
+import { InterceptorConfigUnion } from '@funduck/connectrpc-fastify/dist/interfaces';
 /**
  * Options for configuring ConnectRPC module
  */
@@ -8,4 +9,8 @@ export interface ConnectRPCModuleOptions {
      * Middleware configurations to apply to ConnectRPC routes
      */
     middlewares?: MiddlewareConfigUnion[];
+    /**
+     * Interceptor configurations to apply to ConnectRPC routes
+     */
+    interceptors?: InterceptorConfigUnion[];
 }

package/package.json

@@ -1,23 +1,26 @@
 {
   "name": "@funduck/connectrpc-fastify-nestjs",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "author": "Oleg Milekhin <qlfunduck@gmail.com>",
-  "description": "Wrapper for official @connectrpc/connect and fastify integrated into Nestjs. Simplifies configuration, type safe binding to controller, simplifies use of middlewares and guards.",
+  "description": "Wrapper for official @connectrpc/connect and fastify integrated into Nestjs. Simplifies configuration, type safe binding to controller, simplifies use of middlewares.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "npx rimraf dist; tsc -p tsconfig.build.json",
-    "compile-proto": "cd test && npx buf dep update; npx buf lint; npx buf generate",
-    "test": "npm run compile-proto && cd test && DEBUG=true npx tsx e2e-demo.ts",
-    "publish:check": "npm test && npm run build && npm publish --tag latest --access public --dry-run",
-    "publish:latest": "npm publish --tag latest --access public"
+    "compile-proto": "cd test/demo && npx buf dep update; npx buf lint; npx buf generate",
+    "test:demo": "npm run compile-proto && cd test/demo && DEBUG=true npx tsx e2e-demo.ts",
+    "test": "npm run compile-proto && jest --verbose",
+    "test:coverage": "npm run compile-proto && jest --coverage --runInBand",
+    "publish:check": "npm test && npm run test:demo && npm run build && npm publish --tag latest --access public --dry-run",
+    "publish:latest": "npm test && npm run test:demo && npm run build && npm publish --tag latest --access public"
   },
   "license": "MIT",
   "peerDependencies": {
-    "@funduck/connectrpc-fastify": "^1.0.11",
+    "@funduck/connectrpc-fastify": "^1.0.17",
     "@nestjs/common": "^11.1.12",
     "@nestjs/core": "^11.1.12",
-    "@nestjs/platform-fastify": "^11.1.12"
+    "@nestjs/platform-fastify": "^11.1.12",
+    "fastify": "^5.6.2"
   },
   "devDependencies": {
     "@bufbuild/buf": "^1.64.0",
@@ -25,8 +28,16 @@
     "@bufbuild/protoc-gen-es": "^2.10.2",
     "@connectrpc/connect": "^2.1.1",
     "@connectrpc/connect-node": "^2.1.1",
+    "@funduck/connectrpc-fastify": "^1.0.17",
+    "@nestjs/common": "^11.1.12",
+    "@nestjs/core": "^11.1.12",
+    "@nestjs/platform-fastify": "^11.1.12",
+    "@types/jest": "^30.0.0",
     "@types/node": "^25.0.9",
+    "fastify": "^5.6.2",
+    "jest": "^30.2.0",
     "prettier-plugin-organize-imports": "^4.3.0",
+    "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3"
   }