@nest-native/trpc 0.5.0

package/README.md

@@ -0,0 +1,200 @@
+<p align="center">Decorator-first tRPC integration for NestJS with full Nest enhancer lifecycle support.</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@nest-native/trpc"><img src="https://img.shields.io/npm/v/@nest-native/trpc.svg" alt="NPM Version" /></a>
+  <a href="https://www.npmjs.com/package/@nest-native/trpc"><img src="https://img.shields.io/npm/dm/@nest-native/trpc.svg" alt="NPM Downloads" /></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="Package License" /></a>
+  <img src="https://img.shields.io/badge/coverage-100%25-brightgreen.svg" alt="Test Coverage" />
+  <a href="https://nest-native.github.io/trpc/"><img src="https://img.shields.io/badge/docs-%40nest--native%2Ftrpc-e0234e.svg" alt="Documentation" /></a>
+</p>
+
+> [!IMPORTANT]
+> **Renamed package.** This project was previously published as `nest-trpc-native`.
+> It is now **`@nest-native/trpc`** (repo: [`nest-native/trpc`](https://github.com/nest-native/trpc)).
+>
+> ```bash
+> npm uninstall nest-trpc-native
+> npm install @nest-native/trpc
+> ```
+>
+> Update imports from `nest-trpc-native` to `@nest-native/trpc`. The old package is frozen at `0.4.3` and is no longer maintained.
+
+## What This Is
+
+`@nest-native/trpc` is a community NestJS integration for building tRPC APIs with Nest-style modules, decorators, DI, enhancers, and request scope.
+
+It makes tRPC feel native in Nest applications:
+
+- Module setup via `TrpcModule.forRoot()` / `TrpcModule.forRootAsync()`
+- Decorator-based routers with `@Router()`, `@Query()`, `@Mutation()`, `@Subscription()`
+- Explicit parameter extraction via `@Input()` and `@TrpcContext()`
+- Nest enhancer support for guards, interceptors, pipes, filters, and request scope
+- Adapter-agnostic behavior across Express and Fastify
+- Zod or `class-validator` validation, without forcing either style on every project
+- Generated `AppRouter` types for fully typed tRPC clients
+
+## Documentation
+
+The documentation site is the canonical source of truth for guides and support policy:
+
+- [Introduction](https://nest-native.github.io/trpc/docs/introduction)
+- [Quick Start](https://nest-native.github.io/trpc/docs/quick-start)
+- [Samples](https://nest-native.github.io/trpc/docs/samples)
+- [Support Policy](https://nest-native.github.io/trpc/docs/support-policy)
+
+See the showcase sample for a full end-to-end application:
+
+- https://github.com/nest-native/trpc/tree/main/sample/00-showcase
+
+## Compatibility
+
+| Runtime | Supported line |
+| --- | --- |
+| Node.js | `>=20` |
+| NestJS | `11.x` |
+| tRPC | `11.x` |
+| Zod | `4.x`, optional peer |
+| Adapters | Express, Fastify |
+
+## Installation
+
+```bash
+npm i @nest-native/trpc @trpc/server
+```
+
+Peer dependencies:
+
+```bash
+npm i @nestjs/common @nestjs/core reflect-metadata rxjs
+```
+
+Optional (recommended for schema inference and validation, Zod v4):
+
+```bash
+npm i zod@^4
+```
+
+## Zero Runtime Dependency Design
+
+`@nest-native/trpc` intentionally keeps its runtime dependency block empty (`"dependencies": {}`).
+
+Why this is intentional:
+
+- This package is an integration layer (NestJS <-> tRPC), not a standalone runtime.
+- NestJS and tRPC should come from the host application to avoid version duplication and container mismatches.
+- Core features here rely on peer/runtime primitives already present in Nest apps:
+  - metadata reflection (`reflect-metadata`)
+  - Nest DI/discovery (`@nestjs/common`, `@nestjs/core`)
+  - tRPC adapters (`@trpc/server`)
+  - Node built-ins for file generation (`fs`, `path`)
+
+## Why Zod Is Optional (and When You Need It)
+
+Short answer: **Zod is not mandatory** for the package to work.
+
+- If you prefer classic Nest validation (`class-validator` + `ValidationPipe`), you can use this package without Zod-specific decorators/schemas.
+- If you use tRPC-style schema definitions (`@Query({ input: z.object(...) })`, `@Mutation({ output: ... })`) and `autoSchemaFile` generation for those schemas, then Zod v4 is required by your app code.
+
+Should we remove Zod support entirely?
+
+- We should **not** remove it: Zod support is a core part of the tRPC-first DX and one of the main interoperability goals.
+- Keeping `zod@^4` as an **optional peer dependency** is the best balance:
+  - no forced runtime dependency
+  - clear compatibility contract when users choose Zod
+  - full support for mixed validation strategies in the same project
+
+## Quick Start
+
+### Non-Zod (class-validator + ValidationPipe)
+
+```ts
+import { Module, UsePipes, ValidationPipe } from '@nestjs/common';
+import { IsString, MinLength } from 'class-validator';
+import { Input, Mutation, Query, Router, TrpcModule } from '@nest-native/trpc';
+
+class CreateUserDto {
+  @IsString()
+  @MinLength(1)
+  name!: string;
+}
+
+@Router('users')
+class UsersRouter {
+  @Query()
+  list() {
+    return [{ id: '1', name: 'Ada' }];
+  }
+
+  @Mutation()
+  @UsePipes(new ValidationPipe({ whitelist: true }))
+  create(@Input() input: CreateUserDto) {
+    return { id: '2', ...input };
+  }
+}
+
+@Module({
+  imports: [
+    TrpcModule.forRoot({
+      path: '/trpc',
+      autoSchemaFile: 'src/@generated/server.ts',
+    }),
+  ],
+  providers: [UsersRouter],
+})
+export class AppModule {}
+```
+
+### Zod
+
+```ts
+import { Module } from '@nestjs/common';
+import {
+  Input,
+  Mutation,
+  Query,
+  Router,
+  TrpcContext,
+  TrpcModule,
+} from '@nest-native/trpc';
+import { z } from 'zod';
+
+const CreateUserSchema = z.object({ name: z.string().min(1) });
+
+@Router('users')
+class UsersRouter {
+  @Query({ output: z.array(z.object({ id: z.string(), name: z.string() })) })
+  list(@TrpcContext('requestId') requestId: string) {
+    return [{ id: requestId, name: 'Ada' }];
+  }
+
+  @Mutation({ input: CreateUserSchema })
+  create(@Input() input: { name: string }) {
+    return { id: '1', ...input };
+  }
+}
+
+@Module({
+  imports: [
+    TrpcModule.forRoot({
+      path: '/trpc',
+      autoSchemaFile: 'src/@generated/server.ts',
+    }),
+  ],
+  providers: [UsersRouter],
+})
+export class AppModule {}
+```
+
+## Sample
+
+The full production-style sample lives in `sample/00-showcase` and demonstrates:
+
+- Modular router composition with constructor DI
+- Mixed validation (`zod` + `class-validator`)
+- Guards, pipes, interceptors, and filters on procedures
+- Typed client generation and compile-time checks
+- Express and Fastify runtime entrypoints
+
+## License
+
+This project is MIT licensed.

package/dist/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const TRPC_MODULE_OPTIONS = "TRPC_MODULE_OPTIONS";
+export declare const TRPC_ROUTER_METADATA = "trpc:router";
+export declare const TRPC_PROCEDURE_METADATA = "trpc:procedure";
+export declare const TRPC_PROCEDURE_TYPE_METADATA = "trpc:procedure_type";
+export declare const TRPC_INPUT_METADATA = "trpc:input";
+export declare const TRPC_OUTPUT_METADATA = "trpc:output";
+export declare const TRPC_PARAM_ARGS_METADATA = "__trpcParamArgs__";

package/dist/constants.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRPC_PARAM_ARGS_METADATA = exports.TRPC_OUTPUT_METADATA = exports.TRPC_INPUT_METADATA = exports.TRPC_PROCEDURE_TYPE_METADATA = exports.TRPC_PROCEDURE_METADATA = exports.TRPC_ROUTER_METADATA = exports.TRPC_MODULE_OPTIONS = void 0;
+exports.TRPC_MODULE_OPTIONS = 'TRPC_MODULE_OPTIONS';
+exports.TRPC_ROUTER_METADATA = 'trpc:router';
+exports.TRPC_PROCEDURE_METADATA = 'trpc:procedure';
+exports.TRPC_PROCEDURE_TYPE_METADATA = 'trpc:procedure_type';
+exports.TRPC_INPUT_METADATA = 'trpc:input';
+exports.TRPC_OUTPUT_METADATA = 'trpc:output';
+exports.TRPC_PARAM_ARGS_METADATA = '__trpcParamArgs__';
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,qBAAqB,CAAC;AAC5C,QAAA,oBAAoB,GAAG,aAAa,CAAC;AACrC,QAAA,uBAAuB,GAAG,gBAAgB,CAAC;AAC3C,QAAA,4BAA4B,GAAG,qBAAqB,CAAC;AACrD,QAAA,mBAAmB,GAAG,YAAY,CAAC;AACnC,QAAA,oBAAoB,GAAG,aAAa,CAAC;AACrC,QAAA,wBAAwB,GAAG,mBAAmB,CAAC"}

package/dist/context/trpc-context-creator.d.ts

@@ -0,0 +1,93 @@
+import { ContextType, PipeTransform } from '@nestjs/common';
+import { Controller } from '@nestjs/common/interfaces';
+import { ExecutionContextHost } from '@nestjs/core/helpers/execution-context-host';
+interface TrpcHandlerOptions {
+    callback: (...args: any[]) => any;
+    methodName: string;
+    moduleKey: string;
+    paramTypes?: unknown[];
+    inquirerId?: string;
+    resolveContextId?: () => {
+        id: number;
+    };
+    resolveInstance: (contextId: {
+        id: number;
+    }) => Promise<Controller>;
+}
+type TrpcCallback = (...args: any[]) => any;
+type TrpcContextId = {
+    id: number;
+};
+interface TrpcGuardsContextCreatorLike {
+    create(instance: Controller, callback: TrpcCallback, moduleKey: string, contextId: TrpcContextId, inquirerId?: string): unknown[];
+}
+interface TrpcGuardsConsumerLike {
+    tryActivate(guards: unknown[], args: unknown[], instance: Controller, callback: TrpcCallback, type: ContextType): Promise<boolean>;
+}
+interface TrpcInterceptorsContextCreatorLike {
+    create(instance: Controller, callback: TrpcCallback, moduleKey: string, contextId: TrpcContextId, inquirerId?: string): unknown[];
+}
+interface TrpcInterceptorsConsumerLike {
+    intercept(interceptors: unknown[], args: unknown[], instance: Controller, callback: TrpcCallback, next: () => Promise<unknown>, type: ContextType): Promise<unknown>;
+}
+interface TrpcPipesContextCreatorLike {
+    create(instance: Controller, callback: TrpcCallback, moduleKey: string, contextId: TrpcContextId, inquirerId?: string): PipeTransform[];
+}
+interface TrpcPipesConsumerLike {
+    apply(value: unknown, metadata: {
+        type: unknown;
+        metatype?: unknown;
+        data?: string;
+    }, pipes: PipeTransform[]): Promise<unknown>;
+}
+interface TrpcExceptionHandlerLike {
+    next(error: Error, executionContext: ExecutionContextHost): Promise<unknown>;
+}
+interface TrpcExceptionFiltersContextLike {
+    create(instance: Controller, callback: TrpcCallback, moduleKey: string, contextId: TrpcContextId, inquirerId?: string): TrpcExceptionHandlerLike;
+}
+export interface TrpcEnhancerRuntime {
+    guardsContextCreator: TrpcGuardsContextCreatorLike;
+    guardsConsumer: TrpcGuardsConsumerLike;
+    interceptorsContextCreator: TrpcInterceptorsContextCreatorLike;
+    interceptorsConsumer: TrpcInterceptorsConsumerLike;
+    pipesContextCreator: TrpcPipesContextCreatorLike;
+    pipesConsumer: TrpcPipesConsumerLike;
+    exceptionFiltersContext: TrpcExceptionFiltersContextLike;
+}
+/**
+ * Creates execution-context-aware wrappers for tRPC procedure handlers.
+ *
+ * Integrates NestJS guards, interceptors, pipes, and exception filters
+ * into the tRPC request lifecycle, mirroring Nest external context handling.
+ *
+ * @internal
+ */
+export declare class TrpcContextCreator {
+    private readonly runtime;
+    constructor(runtime: TrpcEnhancerRuntime);
+    constructor(guardsContextCreator: TrpcGuardsContextCreatorLike, guardsConsumer: TrpcGuardsConsumerLike, interceptorsContextCreator: TrpcInterceptorsContextCreatorLike, interceptorsConsumer: TrpcInterceptorsConsumerLike, pipesContextCreator: TrpcPipesContextCreatorLike, pipesConsumer: TrpcPipesConsumerLike, exceptionFiltersContext: TrpcExceptionFiltersContextLike);
+    private isEnhancerRuntime;
+    /**
+     * Backward-compatible overload for existing unit tests and internal callers.
+     */
+    create(instance: Controller, callback: (...args: any[]) => any, moduleKey: string, contextId?: {
+        id: number;
+    }, inquirerId?: string): (input: unknown, ctx: unknown) => Promise<unknown>;
+    /**
+     * Preferred overload used by TrpcRouter for request-scoped resolution.
+     */
+    create(options: TrpcHandlerOptions): (input: unknown, ctx: unknown) => Promise<unknown>;
+    private createHandler;
+    private handleException;
+    private applyPipes;
+    private getPipeTargets;
+    private resolveHandlerArgs;
+    private extractParamValue;
+    private pickField;
+    private transformToResult;
+    private toTrpcError;
+    private extractHttpExceptionMessage;
+    private mapHttpStatusToTrpcCode;
+}
+export {};

package/dist/context/trpc-context-creator.js

@@ -0,0 +1,260 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrpcContextCreator = void 0;
+const common_1 = require("@nestjs/common");
+const route_paramtypes_enum_1 = require("@nestjs/common/enums/route-paramtypes.enum");
+const execution_context_host_1 = require("@nestjs/core/helpers/execution-context-host");
+const constants_1 = require("@nestjs/core/injector/constants");
+const server_1 = require("@trpc/server");
+const rxjs_1 = require("rxjs");
+const constants_2 = require("../constants");
+const enums_1 = require("../enums");
+const TRPC_CONTEXT_TYPE = 'rpc';
+/**
+ * Creates execution-context-aware wrappers for tRPC procedure handlers.
+ *
+ * Integrates NestJS guards, interceptors, pipes, and exception filters
+ * into the tRPC request lifecycle, mirroring Nest external context handling.
+ *
+ * @internal
+ */
+let TrpcContextCreator = class TrpcContextCreator {
+    constructor(runtimeOrGuardsContextCreator, guardsConsumer, interceptorsContextCreator, interceptorsConsumer, pipesContextCreator, pipesConsumer, exceptionFiltersContext) {
+        if (this.isEnhancerRuntime(runtimeOrGuardsContextCreator)) {
+            this.runtime = runtimeOrGuardsContextCreator;
+            return;
+        }
+        if (!guardsConsumer ||
+            !interceptorsContextCreator ||
+            !interceptorsConsumer ||
+            !pipesContextCreator ||
+            !pipesConsumer ||
+            !exceptionFiltersContext) {
+            throw new Error('Invalid TrpcContextCreator configuration');
+        }
+        this.runtime = {
+            guardsContextCreator: runtimeOrGuardsContextCreator,
+            guardsConsumer,
+            interceptorsContextCreator,
+            interceptorsConsumer,
+            pipesContextCreator,
+            pipesConsumer,
+            exceptionFiltersContext,
+        };
+    }
+    isEnhancerRuntime(value) {
+        return (typeof value === 'object' &&
+            value !== null &&
+            'guardsContextCreator' in value &&
+            'guardsConsumer' in value &&
+            'interceptorsContextCreator' in value &&
+            'interceptorsConsumer' in value &&
+            'pipesContextCreator' in value &&
+            'pipesConsumer' in value &&
+            'exceptionFiltersContext' in value);
+    }
+    create(instanceOrOptions, callback, moduleKey, contextId = constants_1.STATIC_CONTEXT, inquirerId) {
+        if (typeof callback === 'function' && moduleKey !== undefined) {
+            const instance = instanceOrOptions;
+            return this.createHandler({
+                callback,
+                methodName: callback.name,
+                moduleKey,
+                inquirerId,
+                resolveContextId: () => contextId,
+                resolveInstance: async () => instance,
+            });
+        }
+        return this.createHandler(instanceOrOptions);
+    }
+    createHandler(options) {
+        const paramMetadata = Reflect.getMetadata(constants_2.TRPC_PARAM_ARGS_METADATA, options.callback) ?? [];
+        const paramTypes = options.paramTypes ?? [];
+        return async (input, trpcCtx) => {
+            const currentContextId = options.resolveContextId?.() ?? constants_1.STATIC_CONTEXT;
+            const instance = await options.resolveInstance(currentContextId);
+            const callbackCandidate = instance[options.methodName] ??
+                options.callback;
+            if (typeof callbackCandidate !== 'function') {
+                throw new server_1.TRPCError({
+                    code: 'INTERNAL_SERVER_ERROR',
+                    message: `Unable to resolve tRPC handler "${options.methodName}"`,
+                });
+            }
+            const callback = callbackCandidate;
+            const guards = this.runtime.guardsContextCreator.create(instance, callback, options.moduleKey, currentContextId, options.inquirerId);
+            const interceptors = this.runtime.interceptorsContextCreator.create(instance, callback, options.moduleKey, currentContextId, options.inquirerId);
+            const pipes = this.runtime.pipesContextCreator.create(instance, callback, options.moduleKey, currentContextId, options.inquirerId);
+            const exceptionHandler = this.runtime.exceptionFiltersContext.create(instance, callback, options.moduleKey, currentContextId, options.inquirerId);
+            const contextArgs = [input, trpcCtx];
+            const executionContext = new execution_context_host_1.ExecutionContextHost(contextArgs, instance.constructor, callback);
+            executionContext.setType(TRPC_CONTEXT_TYPE);
+            try {
+                if (guards.length) {
+                    const canActivate = await this.runtime.guardsConsumer.tryActivate(guards, contextArgs, instance, callback, TRPC_CONTEXT_TYPE);
+                    if (!canActivate) {
+                        throw new common_1.ForbiddenException('Forbidden');
+                    }
+                }
+                const handler = async () => {
+                    const handlerArgs = this.resolveHandlerArgs(input, trpcCtx, paramMetadata);
+                    if (pipes.length) {
+                        await this.applyPipes(handlerArgs, pipes, paramMetadata, paramTypes);
+                    }
+                    return callback.call(instance, ...handlerArgs);
+                };
+                const result = interceptors.length > 0
+                    ? await this.runtime.interceptorsConsumer.intercept(interceptors, contextArgs, instance, callback, handler, TRPC_CONTEXT_TYPE)
+                    : await handler();
+                // `return await` is required (not just `return`): when an interceptor
+                // returns a deferred Observable, `transformToResult` yields a Promise
+                // that may reject after subscription. Without `await`, the rejection
+                // escapes this try/catch and HttpExceptions are mis-mapped to
+                // INTERNAL_SERVER_ERROR by the @trpc/server boundary.
+                return await this.transformToResult(result);
+            }
+            catch (error) {
+                return this.handleException(error, exceptionHandler, executionContext);
+            }
+        };
+    }
+    async handleException(error, exceptionHandler, executionContext) {
+        try {
+            return await exceptionHandler.next(error, executionContext);
+        }
+        catch (filteredError) {
+            throw this.toTrpcError(filteredError);
+        }
+    }
+    async applyPipes(args, pipes, metadata, paramTypes) {
+        const targets = this.getPipeTargets(metadata);
+        for (const target of targets) {
+            args[target.index] = await this.runtime.pipesConsumer.apply(args[target.index], {
+                type: route_paramtypes_enum_1.RouteParamtypes.BODY,
+                metatype: paramTypes[target.index],
+                data: target.data,
+            }, pipes);
+        }
+    }
+    getPipeTargets(metadata) {
+        if (!metadata.length) {
+            return [{ index: 0 }];
+        }
+        return metadata
+            .filter(param => param.type === enums_1.TrpcParamtype.INPUT)
+            .map(param => ({ index: param.index, data: param.data }));
+    }
+    resolveHandlerArgs(input, trpcCtx, metadata) {
+        if (!metadata.length) {
+            return [input, trpcCtx];
+        }
+        const size = Math.max(...metadata.map(param => param.index)) + 1;
+        const args = new Array(size).fill(undefined);
+        for (const param of metadata) {
+            args[param.index] = this.extractParamValue(param, input, trpcCtx);
+        }
+        return args;
+    }
+    extractParamValue(param, input, trpcCtx) {
+        if (param.type === enums_1.TrpcParamtype.INPUT) {
+            return this.pickField(input, param.data);
+        }
+        return this.pickField(trpcCtx, param.data);
+    }
+    pickField(value, field) {
+        if (!field) {
+            return value;
+        }
+        if (!value || typeof value !== 'object') {
+            return undefined;
+        }
+        return value[field];
+    }
+    async transformToResult(resultOrDeferred) {
+        if ((0, rxjs_1.isObservable)(resultOrDeferred)) {
+            return (0, rxjs_1.lastValueFrom)(resultOrDeferred);
+        }
+        return resultOrDeferred;
+    }
+    toTrpcError(error) {
+        if (error instanceof server_1.TRPCError) {
+            return error;
+        }
+        if (error instanceof common_1.HttpException) {
+            return new server_1.TRPCError({
+                code: this.mapHttpStatusToTrpcCode(error.getStatus()),
+                message: this.extractHttpExceptionMessage(error),
+                cause: error,
+            });
+        }
+        if (error instanceof Error) {
+            return new server_1.TRPCError({
+                code: 'INTERNAL_SERVER_ERROR',
+                message: error.message,
+                cause: error,
+            });
+        }
+        return new server_1.TRPCError({
+            code: 'INTERNAL_SERVER_ERROR',
+            message: 'Internal server error',
+            cause: error,
+        });
+    }
+    extractHttpExceptionMessage(exception) {
+        const response = exception.getResponse();
+        if (typeof response === 'string') {
+            return response;
+        }
+        if (response &&
+            typeof response === 'object' &&
+            'message' in response &&
+            response.message) {
+            if (Array.isArray(response.message)) {
+                return response.message.join(', ');
+            }
+            if (typeof response.message === 'string') {
+                return response.message;
+            }
+        }
+        return exception.message;
+    }
+    mapHttpStatusToTrpcCode(status) {
+        const codeByStatus = {
+            400: 'BAD_REQUEST',
+            401: 'UNAUTHORIZED',
+            402: 'PAYMENT_REQUIRED',
+            403: 'FORBIDDEN',
+            404: 'NOT_FOUND',
+            405: 'METHOD_NOT_SUPPORTED',
+            408: 'TIMEOUT',
+            409: 'CONFLICT',
+            412: 'PRECONDITION_FAILED',
+            413: 'PAYLOAD_TOO_LARGE',
+            415: 'UNSUPPORTED_MEDIA_TYPE',
+            422: 'UNPROCESSABLE_CONTENT',
+            428: 'PRECONDITION_REQUIRED',
+            429: 'TOO_MANY_REQUESTS',
+            499: 'CLIENT_CLOSED_REQUEST',
+            501: 'NOT_IMPLEMENTED',
+            502: 'BAD_GATEWAY',
+            503: 'SERVICE_UNAVAILABLE',
+            504: 'GATEWAY_TIMEOUT',
+        };
+        return codeByStatus[status] ?? 'INTERNAL_SERVER_ERROR';
+    }
+};
+exports.TrpcContextCreator = TrpcContextCreator;
+exports.TrpcContextCreator = TrpcContextCreator = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [Object, Object, Object, Object, Object, Object, Object])
+], TrpcContextCreator);
+//# sourceMappingURL=trpc-context-creator.js.map

package/dist/context/trpc-context-creator.js.map

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

package/dist/context/trpc-enhancer-runtime.factory.d.ts

@@ -0,0 +1,10 @@
+import { ApplicationConfig } from '@nestjs/core';
+import { ModulesContainer } from '@nestjs/core/injector/modules-container';
+import { TrpcEnhancerRuntime } from './trpc-context-creator';
+/**
+ * Isolates Nest internal enhancer creator wiring to a single boundary.
+ *
+ * This keeps TrpcContextCreator focused on orchestration logic and makes
+ * future Nest major upgrades cheaper to validate and patch.
+ */
+export declare function createTrpcEnhancerRuntime(modulesContainer: ModulesContainer, applicationConfig: ApplicationConfig): TrpcEnhancerRuntime;

package/dist/context/trpc-enhancer-runtime.factory.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTrpcEnhancerRuntime = createTrpcEnhancerRuntime;
+const external_exception_filter_context_1 = require("@nestjs/core/exceptions/external-exception-filter-context");
+const guards_consumer_1 = require("@nestjs/core/guards/guards-consumer");
+const guards_context_creator_1 = require("@nestjs/core/guards/guards-context-creator");
+const interceptors_consumer_1 = require("@nestjs/core/interceptors/interceptors-consumer");
+const interceptors_context_creator_1 = require("@nestjs/core/interceptors/interceptors-context-creator");
+const pipes_consumer_1 = require("@nestjs/core/pipes/pipes-consumer");
+const pipes_context_creator_1 = require("@nestjs/core/pipes/pipes-context-creator");
+/**
+ * Isolates Nest internal enhancer creator wiring to a single boundary.
+ *
+ * This keeps TrpcContextCreator focused on orchestration logic and makes
+ * future Nest major upgrades cheaper to validate and patch.
+ */
+function createTrpcEnhancerRuntime(modulesContainer, applicationConfig) {
+    const containerRef = {
+        getModules: () => modulesContainer,
+    };
+    return {
+        guardsContextCreator: new guards_context_creator_1.GuardsContextCreator(containerRef, applicationConfig),
+        guardsConsumer: new guards_consumer_1.GuardsConsumer(),
+        interceptorsContextCreator: new interceptors_context_creator_1.InterceptorsContextCreator(containerRef, applicationConfig),
+        interceptorsConsumer: new interceptors_consumer_1.InterceptorsConsumer(),
+        pipesContextCreator: new pipes_context_creator_1.PipesContextCreator(containerRef, applicationConfig),
+        pipesConsumer: new pipes_consumer_1.PipesConsumer(),
+        exceptionFiltersContext: new external_exception_filter_context_1.ExternalExceptionFilterContext(containerRef, applicationConfig),
+    };
+}
+//# sourceMappingURL=trpc-enhancer-runtime.factory.js.map

package/dist/context/trpc-enhancer-runtime.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpc-enhancer-runtime.factory.js","sourceRoot":"","sources":["../../context/trpc-enhancer-runtime.factory.ts"],"names":[],"mappings":";;AAqBA,8DA6BC;AAjDD,iHAA2G;AAC3G,yEAAqE;AACrE,uFAAkF;AAClF,2FAAuF;AACvF,yGAAoG;AAEpG,sEAAkE;AAClE,oFAA+E;AAO/E;;;;;GAKG;AACH,SAAgB,yBAAyB,CACvC,gBAAkC,EAClC,iBAAoC;IAEpC,MAAM,YAAY,GAAqB;QACrC,UAAU,EAAE,GAAG,EAAE,CAAC,gBAAgB;KACnC,CAAC;IAEF,OAAO;QACL,oBAAoB,EAAE,IAAI,6CAAoB,CAC5C,YAAmB,EACnB,iBAAiB,CAClB;QACD,cAAc,EAAE,IAAI,gCAAc,EAAE;QACpC,0BAA0B,EAAE,IAAI,yDAA0B,CACxD,YAAmB,EACnB,iBAAiB,CAClB;QACD,oBAAoB,EAAE,IAAI,4CAAoB,EAAE;QAChD,mBAAmB,EAAE,IAAI,2CAAmB,CAC1C,YAAmB,EACnB,iBAAiB,CAClB;QACD,aAAa,EAAE,IAAI,8BAAa,EAAE;QAClC,uBAAuB,EAAE,IAAI,kEAA8B,CACzD,YAAmB,EACnB,iBAAiB,CAClB;KACF,CAAC;AACJ,CAAC"}

package/dist/decorators/ctx.decorator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extracts request context data from a tRPC procedure call.
+ *
+ * - `@TrpcContext()` injects the full tRPC context object.
+ * - `@TrpcContext('field')` injects a field from the context object.
+ *
+ * @publicApi
+ */
+export declare function TrpcContext(data?: string): ParameterDecorator;