@funduck/connectrpc-fastify-nestjs 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oleg Milekhin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,151 @@
+# Connectrpc Fastify Wrapper For Nestjs
+
+## Description
+
+This package allows to add [Connectrpc](https://github.com/connectrpc/connect-es) into [Nestjs](https://github.com/nestjs/nest) project using the [Fastify](https://github.com/fastify/fastify) server.
+
+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 uses my another package [Connectrpc Fastify Wrapper](https://github.com/funduck/connectrpc-fastify).
+
+## Features
+
+This library allows you to:
+* Use only HTTP/1 transport
+* Perform RPC with simple request and response messages
+* Perform RPC with streaming responses
+* Perform RPC with streaming requests
+* Use middlewares
+* Use global guards
+
+*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`.
+
+Except the bootstrap instructions are pretty much the same as in [Connectrpc Fastify Wrapper](https://github.com/funduck/connectrpc-fastify#how-to-use).
+
+### Controllers
+Controller must implement the service interface (not all methods) and register itself using `ConnectRPC.registerController`:
+```TS
+@Injectable()
+export class ElizaController implements Service<typeof ElizaService> {
+  @Inject(Logger)
+  private logger: Logger;
+
+  constructor() {
+    ConnectRPC.registerController(this, ElizaService);
+  }
+
+  async say(
+    request: SayRequest,
+  ) {
+    return {
+      sentence: `You said: ${request.sentence}`,
+    };
+  }
+
+  // ... Other methods are optional
+}
+```
+
+### Middlewares
+Middleware must implement `Middleware` interface and register itself using `ConnectRPC.registerMiddleware`:
+```TS
+@Injectable()
+export class TestMiddleware1 implements Middleware {
+  @Inject(Logger)
+  private logger: Logger;
+
+  constructor() {
+    ConnectRPC.registerMiddleware(this);
+  }
+
+  use(req: FastifyRequest['raw'], res: FastifyReply['raw'], next: () => void) {
+    next();
+  }
+}
+
+```
+
+### Guards
+Guard must implement `Guard` interface and register itself using `ConnectRPC.registerGuard`:
+```TS
+@Injectable()
+export class TestGuard1 implements Guard {
+  @Inject(Logger)
+  private logger: Logger;
+
+  constructor() {
+    ConnectRPC.registerGuard(this);
+  }
+
+  canActivate(context: ExecutionContext): boolean {
+    return true;
+  }
+}
+```
+
+### Module Setup
+Configure your NestJS module to use `ConnectRPCModule.forRoot` and register middlewares/guards as providers if necessary:
+
+```typescript
+@Module({
+  imports: [
+    // Configure ConnectRPCModule
+    ConnectRPCModule.forRoot({
+      logger: new Logger('ConnectRPC', { timestamp: true }),
+      middlewares: [
+        middlewareConfig(TestMiddleware1),
+        middlewareConfig(TestMiddleware2, ElizaService),
+        middlewareConfig(TestMiddleware3, ElizaService, ['say']),
+      ],
+    }),
+  ],
+  providers: [
+    Logger,
+
+    // Guard is provided the NestJS way
+    { provide: APP_GUARD, useClass: TestGuard1 },
+
+    // Controllers are provided here instead of `controllers` array
+    ElizaController, 
+
+    // Middlewares specific for ConnectRPC are provided here
+    TestMiddleware1, 
+    TestMiddleware2,
+
+    // Middlewares that are applied via `consumer.apply()` should NOT be provided here
+    // Do not instantiate TestMiddleware3 twice!
+  ],
+})
+export class AppModule implements NestModule {
+  configure(consumer: MiddlewareConsumer) {
+    consumer.apply(TestMiddleware3).forRoutes('*'); // TestMiddleware3 is instantiated here!
+  }
+}
+```
+
+### Server Bootstrap
+Just add the call to `ConnectRPCModule` after creating the app:
+
+```typescript
+export async function bootstrap() {
+  const app = await NestFactory.create<NestFastifyApplication>(
+    AppModule,
+    new FastifyAdapter(),
+  );
+
+  // After the app is created, register the ConnectRPCModule
+  await app.get(ConnectRPCModule).registerPlugin();
+
+  await app.listen(3000);
+}
+```
+
+## Feedback
+Please use [Discussions](https://github.com/funduck/connectrpc-fastify-nestjs/discussions) or email me.

package/dist/src/connectrpc.d.ts

@@ -0,0 +1,22 @@
+import { GenService, GenServiceMethods } from '@bufbuild/protobuf/codegenv2';
+import { FastifyInstance } from 'fastify';
+import { Guard, Logger, Middleware, MiddlewareConfigUnion, Service } from './interfaces';
+declare class ConnectRPCClass {
+    setLogger(customLogger: Logger): void;
+    registerMiddleware(self: Middleware, options?: {
+        allowMultipleInstances?: boolean;
+    }): void;
+    registerController<T extends GenServiceMethods>(self: Service<GenService<T>>, service: GenService<T>, options?: {
+        allowMultipleInstances?: boolean;
+    }): void;
+    registerGuard(self: Guard, options?: {
+        allowMultipleInstances?: boolean;
+    }): void;
+    registerFastifyPlugin(server: FastifyInstance): Promise<void>;
+    private _middlewaresInitialized;
+    initMiddlewares(server: FastifyInstance, middlewareConfigs: MiddlewareConfigUnion[]): Promise<void>;
+    private _guardsInitialized;
+    initGuards(server: FastifyInstance): Promise<void>;
+}
+export declare const ConnectRPC: ConnectRPCClass;
+export {};

package/dist/src/connectrpc.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectRPC = void 0;
+const fastify_plugin_1 = require("./fastify-plugin");
+const guards_1 = require("./guards");
+const helpers_1 = require("./helpers");
+const middlewares_1 = require("./middlewares");
+const stores_1 = require("./stores");
+class ConnectRPCClass {
+    setLogger(customLogger) {
+        (0, helpers_1.setLogger)(customLogger);
+    }
+    registerMiddleware(self, options) {
+        stores_1.MiddlewareStore.registerInstance(self, options);
+    }
+    registerController(self, service, options) {
+        stores_1.ControllersStore.registerInstance(self, service, options);
+    }
+    registerGuard(self, options) {
+        stores_1.GuardsStore.registerInstance(self, options);
+    }
+    registerFastifyPlugin(server) {
+        return (0, fastify_plugin_1.registerFastifyPlugin)(server);
+    }
+    _middlewaresInitialized = false;
+    initMiddlewares(server, middlewareConfigs) {
+        if (this._middlewaresInitialized) {
+            throw new Error('Middlewares have already been initialized!');
+        }
+        if (this._guardsInitialized) {
+            throw new Error('Middlewares must be initialized before guards!');
+        }
+        this._middlewaresInitialized = true;
+        return (0, middlewares_1.initMiddlewares)(server, middlewareConfigs);
+    }
+    _guardsInitialized = false;
+    initGuards(server) {
+        if (this._guardsInitialized) {
+            throw new Error('Guards have already been initialized!');
+        }
+        this._guardsInitialized = true;
+        return (0, guards_1.initGuards)(server);
+    }
+}
+exports.ConnectRPC = new ConnectRPCClass();
+//# sourceMappingURL=connectrpc.js.map

package/dist/src/connectrpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectrpc.js","sourceRoot":"","sources":["../../src/connectrpc.ts"],"names":[],"mappings":";;;AAEA,qDAAyD;AACzD,qCAAsC;AACtC,uCAAsC;AAQtC,+CAAgD;AAChD,qCAA0E;AAE1E,MAAM,eAAe;IACnB,SAAS,CAAC,YAAoB;QAC5B,IAAA,mBAAS,EAAC,YAAY,CAAC,CAAC;IAC1B,CAAC;IAED,kBAAkB,CAChB,IAAgB,EAChB,OAEC;QAED,wBAAe,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAMD,kBAAkB,CAChB,IAA4B,EAC5B,OAAsB,EACtB,OAEC;QAED,yBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,aAAa,CACX,IAAW,EACX,OAEC;QAED,oBAAW,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAED,qBAAqB,CAAC,MAAuB;QAC3C,OAAO,IAAA,sCAAqB,EAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAEO,uBAAuB,GAAG,KAAK,CAAC;IAExC,eAAe,CACb,MAAuB,EACvB,iBAA0C;QAE1C,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;QACpC,OAAO,IAAA,6BAAe,EAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACpD,CAAC;IAEO,kBAAkB,GAAG,KAAK,CAAC;IAEnC,UAAU,CAAC,MAAuB;QAChC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/B,OAAO,IAAA,mBAAU,EAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF;AAKY,QAAA,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC"}

package/dist/src/execution-context.d.ts

@@ -0,0 +1,22 @@
+import { FastifyReply, FastifyRequest } from 'fastify';
+import { ExecutionContext, Type } from './interfaces';
+export declare class ManualExecutionContext implements ExecutionContext {
+    readonly request: FastifyRequest['raw'];
+    readonly response: FastifyReply['raw'];
+    readonly next: <T = any>() => T;
+    readonly args: any[];
+    readonly constructorRef: Type<any> | null;
+    readonly handler: Function | null;
+    constructor(request: FastifyRequest['raw'], response: FastifyReply['raw'], next: <T = any>() => T, args: any[], constructorRef?: Type<any> | null, handler?: Function | null);
+    getClass<T = any>(): Type<T>;
+    getHandler(): Function;
+    getArgs<T extends Array<any> = any[]>(): T;
+    getArgByIndex<T = any>(index: number): T;
+    switchToHttp(): this & {
+        getRequest: () => import("node:http").IncomingMessage;
+        getResponse: () => import("node:http").ServerResponse<import("node:http").IncomingMessage>;
+        getNext: () => <T = any>() => T;
+    };
+    switchToRpc(): void;
+    switchToWs(): void;
+}

package/dist/src/execution-context.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManualExecutionContext = void 0;
+class ManualExecutionContext {
+    request;
+    response;
+    next;
+    args;
+    constructorRef;
+    handler;
+    constructor(request, response, next, args, constructorRef = null, handler = null) {
+        this.request = request;
+        this.response = response;
+        this.next = next;
+        this.args = args;
+        this.constructorRef = constructorRef;
+        this.handler = handler;
+    }
+    getClass() {
+        return this.constructorRef;
+    }
+    getHandler() {
+        return this.handler;
+    }
+    getArgs() {
+        return this.args;
+    }
+    getArgByIndex(index) {
+        return this.args[index];
+    }
+    switchToHttp() {
+        return Object.assign(this, {
+            getRequest: () => this.request,
+            getResponse: () => this.response,
+            getNext: () => this.next,
+        });
+    }
+    switchToRpc() {
+        throw new Error('Context switching to RPC is not supported.');
+    }
+    switchToWs() {
+        throw new Error('Context switching to WebSockets is not supported.');
+    }
+}
+exports.ManualExecutionContext = ManualExecutionContext;
+//# sourceMappingURL=execution-context.js.map

package/dist/src/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/execution-context.ts"],"names":[],"mappings":";;;AAGA,MAAa,sBAAsB;IAEtB;IACA;IACA;IACA;IACA;IACA;IANX,YACW,OAA8B,EAC9B,QAA6B,EAC7B,IAAsB,EACtB,IAAW,EACX,iBAAmC,IAAI,EACvC,UAA2B,IAAI;QAL/B,YAAO,GAAP,OAAO,CAAuB;QAC9B,aAAQ,GAAR,QAAQ,CAAqB;QAC7B,SAAI,GAAJ,IAAI,CAAkB;QACtB,SAAI,GAAJ,IAAI,CAAO;QACX,mBAAc,GAAd,cAAc,CAAyB;QACvC,YAAO,GAAP,OAAO,CAAwB;IACvC,CAAC;IAEJ,QAAQ;QACN,OAAO,IAAI,CAAC,cAAe,CAAC;IAC9B,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAQ,CAAC;IACvB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAS,CAAC;IACxB,CAAC;IAED,aAAa,CAAU,KAAa;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAM,CAAC;IAC/B,CAAC;IAED,YAAY;QACV,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACzB,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO;YAC9B,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ;YAChC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI;SACzB,CAAC,CAAC;IACL,CAAC;IAED,WAAW;QACT,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IAED,UAAU;QACR,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;CACF;AAzCD,wDAyCC"}

package/dist/src/fastify-plugin.d.ts

@@ -0,0 +1,5 @@
+import { Compression } from '@connectrpc/connect/protocol';
+import { FastifyInstance } from 'fastify';
+export declare function registerFastifyPlugin(server: FastifyInstance, options?: {
+    acceptCompression?: Compression[];
+}): Promise<void>;

package/dist/src/fastify-plugin.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFastifyPlugin = registerFastifyPlugin;
+const connect_fastify_1 = require("@connectrpc/connect-fastify");
+const guards_1 = require("./guards");
+const helpers_1 = require("./helpers");
+const stores_1 = require("./stores");
+async function registerFastifyPlugin(server, options = {}) {
+    const implementations = new Map();
+    for (const { instance, service } of stores_1.ControllersStore.values()) {
+        const guards = (0, guards_1.getGuards)(instance);
+        if (guards.length > 0) {
+            helpers_1.logger.log(`Found ${guards.length} guards on controller ${instance.constructor.name}`);
+        }
+        const methodMappings = (0, helpers_1.discoverMethodMappings)(instance.__proto__, service);
+        const implementation = {};
+        for (const methodDesc of service.methods) {
+            const { name } = methodDesc;
+            const methodName = name[0].toLowerCase() + name.slice(1);
+            const controllerMethodName = methodMappings[name];
+            if (controllerMethodName) {
+                const controllerMethod = instance[controllerMethodName];
+                if (controllerMethod) {
+                    const bindedMethod = controllerMethod.bind(instance);
+                    implementation[methodName] = (...args) => {
+                        return bindedMethod(...args);
+                    };
+                    stores_1.RouteMetadataStore.registerRoute(service.typeName, name, instance.constructor, controllerMethod, controllerMethodName, instance);
+                    helpers_1.logger.log(`Binding ${instance.constructor.name}.${controllerMethodName} to ${service.typeName}.${name}`);
+                }
+                else {
+                    helpers_1.logger.warn(`Method ${controllerMethodName} not found in ${instance.constructor.name}`);
+                }
+            }
+        }
+        implementations.set(service, implementation);
+    }
+    const routes = (router) => {
+        for (const [service, implementation] of implementations.entries()) {
+            router.service(service, implementation);
+            helpers_1.logger.log(`Registered {/${service.typeName}} route`);
+        }
+    };
+    if (routes.length === 0) {
+        helpers_1.logger.warn('No controllers found to register');
+        return;
+    }
+    await server.register(connect_fastify_1.fastifyConnectPlugin, {
+        grpc: false,
+        grpcWeb: false,
+        connect: true,
+        acceptCompression: options.acceptCompression ?? [],
+        routes: routes,
+    });
+    helpers_1.logger.log('Ready');
+}
+//# sourceMappingURL=fastify-plugin.js.map

package/dist/src/fastify-plugin.js.map

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

package/dist/src/guards.d.ts

@@ -0,0 +1,8 @@
+import { FastifyInstance } from 'fastify';
+import { ExecutionContext, Guard } from './interfaces';
+export declare class ManualGuardExecutor {
+    executeGuard(guard: Guard, context: ExecutionContext): Promise<boolean>;
+    executeGuards(guards: Guard[], context: ExecutionContext): Promise<boolean>;
+}
+export declare function getGuards(controller: any): Guard[];
+export declare function initGuards(server: FastifyInstance): Promise<void>;

package/dist/src/guards.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ManualGuardExecutor = void 0;
+exports.getGuards = getGuards;
+exports.initGuards = initGuards;
+const execution_context_1 = require("./execution-context");
+const helpers_1 = require("./helpers");
+const stores_1 = require("./stores");
+class ManualGuardExecutor {
+    async executeGuard(guard, context) {
+        const result = guard.canActivate(context);
+        if (typeof result === 'boolean') {
+            return result;
+        }
+        return await result;
+    }
+    async executeGuards(guards, context) {
+        for (const guard of guards) {
+            const canActivate = await this.executeGuard(guard, context);
+            if (!canActivate) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+exports.ManualGuardExecutor = ManualGuardExecutor;
+function getGuards(controller) {
+    return stores_1.GuardsStore.getAllGuards();
+}
+async function initGuards(server) {
+    const guardExecutor = new ManualGuardExecutor();
+    server.addHook('preHandler', async (request, reply) => {
+        const url = request.url;
+        const match = url.match(/^\/([^/]+)\/([^/]+)$/);
+        if (!match) {
+            return;
+        }
+        const routeMetadata = stores_1.RouteMetadataStore.getRouteMetadata(url);
+        if (!routeMetadata) {
+            helpers_1.logger.warn(`No route metadata found for ${url}`);
+            return;
+        }
+        const { controllerClass, controllerMethod, controllerMethodName, instance, } = routeMetadata;
+        const guards = getGuards(instance);
+        if (guards.length === 0) {
+            return;
+        }
+        const executionContext = new execution_context_1.ManualExecutionContext(request.raw, reply.raw, (() => undefined), [], controllerClass, controllerMethod);
+        try {
+            const canActivate = await guardExecutor.executeGuards(guards, executionContext);
+            if (!canActivate) {
+                reply.code(403).send({
+                    code: 'permission_denied',
+                    message: 'Forbidden',
+                });
+                throw new Error('Guard rejected the request');
+            }
+        }
+        catch (error) {
+            if (!reply.sent) {
+                reply.code(403).send({
+                    code: 'permission_denied',
+                    message: error instanceof Error ? error.message : 'Forbidden',
+                });
+            }
+            throw error;
+        }
+    });
+    helpers_1.logger.log('Guards middleware initialized');
+}
+//# sourceMappingURL=guards.js.map

package/dist/src/guards.js.map

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

package/dist/src/helpers.d.ts

@@ -0,0 +1,7 @@
+import { GenService } from '@bufbuild/protobuf/codegenv2';
+import { FastifyReply, FastifyRequest } from 'fastify';
+import { Logger } from './interfaces';
+export declare function discoverMethodMappings(prototype: any, service: GenService<any>): Record<string, string>;
+export declare function convertMiddlewareToHook(middlewareInstance: any): (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+export declare let logger: Logger;
+export declare function setLogger(customLogger: Logger): void;

package/dist/src/helpers.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.discoverMethodMappings = discoverMethodMappings;
+exports.convertMiddlewareToHook = convertMiddlewareToHook;
+exports.setLogger = setLogger;
+function discoverMethodMappings(prototype, service) {
+    const methodMappings = {};
+    const serviceMethods = Array.isArray(service.methods) ? service.methods : [];
+    const controllerMethods = Object.getOwnPropertyNames(prototype).filter((name) => name !== 'constructor' && typeof prototype[name] === 'function');
+    for (const methodDesc of serviceMethods) {
+        const serviceMethodName = methodDesc.name;
+        const localName = methodDesc.localName;
+        let controllerMethodName = controllerMethods.find((name) => name === localName);
+        if (!controllerMethodName) {
+            controllerMethodName = controllerMethods.find((name) => name.toLowerCase() === serviceMethodName.toLowerCase());
+        }
+        if (controllerMethodName) {
+            methodMappings[serviceMethodName] = controllerMethodName;
+        }
+    }
+    return methodMappings;
+}
+function convertMiddlewareToHook(middlewareInstance) {
+    return async (request, reply) => {
+        return new Promise((resolve, reject) => {
+            try {
+                middlewareInstance.use(request.raw, reply.raw, (err) => {
+                    if (err) {
+                        reject(err);
+                    }
+                    else {
+                        resolve();
+                    }
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    };
+}
+exports.logger = {
+    log: (...args) => {
+        console.info(...args);
+    },
+    error: (...args) => {
+        console.error(...args);
+    },
+    warn: (...args) => {
+        console.warn(...args);
+    },
+    debug: (...args) => {
+        console.debug(...args);
+    },
+    verbose: (...args) => {
+        console.log(...args);
+    },
+};
+function setLogger(customLogger) {
+    exports.logger = customLogger;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/src/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/helpers.ts"],"names":[],"mappings":";;;AAOA,wDAsCC;AAKD,0DAmBC;AAoBD,8BAEC;AApFD,SAAgB,sBAAsB,CACpC,SAAS,EACT,OAAwB;IAExB,MAAM,cAAc,GAA2B,EAAE,CAAC;IAGlD,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAG7E,MAAM,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,MAAM,CACpE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,UAAU,CAC1E,CAAC;IAGF,KAAK,MAAM,UAAU,IAAI,cAAc,EAAE,CAAC;QACxC,MAAM,iBAAiB,GAAG,UAAU,CAAC,IAAI,CAAC;QAC1C,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QAIvC,IAAI,oBAAoB,GAAG,iBAAiB,CAAC,IAAI,CAC/C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAC7B,CAAC;QAEF,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,oBAAoB,GAAG,iBAAiB,CAAC,IAAI,CAC3C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,iBAAiB,CAAC,WAAW,EAAE,CACjE,CAAC;QACJ,CAAC;QAED,IAAI,oBAAoB,EAAE,CAAC;YAEzB,cAAc,CAAC,iBAAiB,CAAC,GAAG,oBAAoB,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAKD,SAAgB,uBAAuB,CACrC,kBAAuB;IAEvB,OAAO,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;QAC5D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC;gBAEH,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,GAAS,EAAE,EAAE;oBAC3D,IAAI,GAAG,EAAE,CAAC;wBACR,MAAM,CAAC,GAAG,CAAC,CAAC;oBACd,CAAC;yBAAM,CAAC;wBACN,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAEU,QAAA,MAAM,GAAW;IAC1B,GAAG,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE;QACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE;QACvB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,IAAW,EAAE,EAAE;QAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;CACF,CAAC;AAEF,SAAgB,SAAS,CAAC,YAAoB;IAC5C,cAAM,GAAG,YAAY,CAAC;AACxB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export declare function printMsg(): void;
+export { ConnectRPC } from './connectrpc';
+export { middlewareConfig } from './interfaces';
+export type { ExecutionContext, Guard, Logger, Middleware, MiddlewareConfig, MiddlewareConfigUnion, Service, } from './interfaces';
+export { initGuards } from './guards';
+export type { OmitConnectrpcFields } from './types';

package/dist/src/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initGuards = exports.middlewareConfig = exports.ConnectRPC = void 0;
+exports.printMsg = printMsg;
+function printMsg() {
+    console.log('Thanks for using connectrpc-fastify!');
+}
+var connectrpc_1 = require("./connectrpc");
+Object.defineProperty(exports, "ConnectRPC", { enumerable: true, get: function () { return connectrpc_1.ConnectRPC; } });
+var interfaces_1 = require("./interfaces");
+Object.defineProperty(exports, "middlewareConfig", { enumerable: true, get: function () { return interfaces_1.middlewareConfig; } });
+var guards_1 = require("./guards");
+Object.defineProperty(exports, "initGuards", { enumerable: true, get: function () { return guards_1.initGuards; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAEC;AAFD,SAAgB,QAAQ;IACtB,OAAO,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AACtD,CAAC;AAED,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,2CAAgD;AAAvC,8GAAA,gBAAgB,OAAA;AAYzB,mCAAsC;AAA7B,oGAAA,UAAU,OAAA"}

package/dist/src/interfaces.d.ts

@@ -0,0 +1,66 @@
+import type { GenMessage, GenService } from '@bufbuild/protobuf/codegenv2';
+import { FastifyReply, FastifyRequest } from 'fastify';
+import { OmitConnectrpcFields } from './types';
+export interface Logger {
+    log: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+    debug: (...args: any[]) => void;
+    verbose: (...args: any[]) => void;
+}
+export interface Middleware {
+    use(req: FastifyRequest['raw'], res: FastifyReply['raw'], next: (err?: any) => void): void;
+}
+export interface Type<T = any> extends Function {
+    new (...args: any[]): T;
+}
+type ExtractInput<T> = T extends {
+    input: GenMessage<infer M>;
+} ? M : never;
+type ExtractOutput<T> = T extends {
+    output: GenMessage<infer M>;
+} ? M : never;
+type ServiceMethod<T> = T extends {
+    methodKind: 'unary';
+} ? (request: ExtractInput<T>) => Promise<OmitConnectrpcFields<ExtractOutput<T>>> : T extends {
+    methodKind: 'server_streaming';
+} ? (request: ExtractInput<T>) => AsyncIterable<OmitConnectrpcFields<ExtractOutput<T>>> : T extends {
+    methodKind: 'client_streaming';
+} ? (request: AsyncIterable<ExtractInput<T>>) => Promise<OmitConnectrpcFields<ExtractOutput<T>>> : T extends {
+    methodKind: 'bidi_streaming';
+} ? (request: AsyncIterable<ExtractInput<T>>) => AsyncIterable<OmitConnectrpcFields<ExtractOutput<T>>> : never;
+export type Service<T> = T extends GenService<infer Methods> ? {
+    [K in keyof Methods]?: ServiceMethod<Methods[K]>;
+} : never;
+export type ServiceMethodNames<T> = T extends GenService<infer Methods> ? {
+    [K in keyof Methods]: K;
+}[keyof Methods] : never;
+export type MiddlewareConfigGlobal = {
+    use: Type<Middleware>;
+    on?: never;
+    methods?: never;
+};
+export type MiddlewareConfig<T extends GenService<any>> = {
+    use: Type<Middleware>;
+    on: T;
+    methods?: Array<ServiceMethodNames<T>>;
+};
+export type MiddlewareConfigUnion = MiddlewareConfigGlobal | MiddlewareConfig<any>;
+export declare function middlewareConfig<T extends GenService<any>>(use: Type<Middleware>, on?: T, methods?: Array<ServiceMethodNames<T>>): MiddlewareConfigUnion;
+export interface ExecutionContext {
+    getClass<T = any>(): Type<T>;
+    getHandler(): Function;
+    getArgs<T extends Array<any> = any[]>(): T;
+    getArgByIndex<T = any>(index: number): T;
+    switchToHttp(): {
+        getRequest(): FastifyRequest['raw'];
+        getResponse(): FastifyReply['raw'];
+        getNext<T = any>(): () => T;
+    };
+    switchToRpc(): any;
+    switchToWs(): any;
+}
+export interface Guard {
+    canActivate(context: ExecutionContext): boolean | Promise<boolean>;
+}
+export {};