@tsgonest/runtime 0.0.1

package/dist/config.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Configuration for tsgonest.
+ */
+export interface TsgonestConfig {
+    /** Controller file discovery patterns. */
+    controllers?: {
+        /** Glob patterns for controller files to include. */
+        include?: string[];
+        /** Glob patterns for files to exclude. */
+        exclude?: string[];
+    };
+    /** Code transformation settings. */
+    transforms?: {
+        /** Generate validation companion files. */
+        validation?: boolean;
+        /** Generate serialization companion files. */
+        serialization?: boolean;
+    };
+    /** OpenAPI document generation settings. */
+    openapi?: {
+        /** Output path for the generated OpenAPI document. */
+        output?: string;
+        /** API title for the OpenAPI info section. */
+        title?: string;
+        /** API version for the OpenAPI info section. */
+        version?: string;
+        /** API description for the OpenAPI info section. */
+        description?: string;
+    };
+}
+/**
+ * Type-safe config helper for tsgonest.config.ts.
+ * Provides autocomplete and validation for the config object.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@tsgonest/runtime";
+ *
+ * export default defineConfig({
+ *   controllers: {
+ *     include: ["src/**\/*.controller.ts"],
+ *   },
+ *   transforms: {
+ *     validation: true,
+ *     serialization: true,
+ *   },
+ *   openapi: {
+ *     output: "dist/openapi.json",
+ *   },
+ * });
+ * ```
+ */
+export declare function defineConfig(config: TsgonestConfig): TsgonestConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,WAAW,CAAC,EAAE;QACZ,qDAAqD;QACrD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,0CAA0C;QAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IAEF,oCAAoC;IACpC,UAAU,CAAC,EAAE;QACX,2CAA2C;QAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,8CAA8C;QAC9C,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;IAEF,4CAA4C;IAC5C,OAAO,CAAC,EAAE;QACR,sDAAsD;QACtD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,8CAA8C;QAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gDAAgD;QAChD,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,oDAAoD;QACpD,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAEnE"}

package/dist/config.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = defineConfig;
+/**
+ * Type-safe config helper for tsgonest.config.ts.
+ * Provides autocomplete and validation for the config object.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "@tsgonest/runtime";
+ *
+ * export default defineConfig({
+ *   controllers: {
+ *     include: ["src/**\/*.controller.ts"],
+ *   },
+ *   transforms: {
+ *     validation: true,
+ *     serialization: true,
+ *   },
+ *   openapi: {
+ *     output: "dist/openapi.json",
+ *   },
+ * });
+ * ```
+ */
+function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAuDA,oCAEC;AAxBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,SAAgB,YAAY,CAAC,MAAsB;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/discovery.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Route mapping entry — maps a controller method to its return type.
+ * Key format in the manifest: "ControllerName.methodName"
+ */
+export interface RouteMapping {
+    /** The DTO type name (e.g., "UserResponse"). */
+    returnType: string;
+    /** Whether the method returns an array of the return type. */
+    isArray?: boolean;
+}
+/**
+ * The manifest file generated by tsgonest during compilation.
+ * Maps DTO type names to their companion file paths and function names.
+ */
+export interface TsgonestManifest {
+    validators: Record<string, ManifestEntry>;
+    serializers: Record<string, ManifestEntry>;
+    routes?: Record<string, RouteMapping>;
+}
+/**
+ * A single entry in the manifest, pointing to a companion file and exported function.
+ */
+export interface ManifestEntry {
+    /** Relative path to the companion JS file. */
+    file: string;
+    /** Name of the exported function in the companion file. */
+    fn: string;
+}
+/**
+ * Discovers and loads companion file functions from the tsgonest manifest.
+ */
+export declare class CompanionDiscovery {
+    private manifest;
+    private manifestDir;
+    private cache;
+    /**
+     * Load the manifest from a directory.
+     * Searches for __tsgonest_manifest.json in the given directory.
+     */
+    loadManifest(distDir: string): boolean;
+    /**
+     * Load the manifest from a JSON string.
+     * Used for testing or when the manifest is embedded.
+     */
+    loadManifestFromJSON(json: string, baseDir: string): boolean;
+    /**
+     * Get a validator function for a DTO type name.
+     * Returns the assert function that throws on invalid input.
+     */
+    getValidator(typeName: string): ((input: unknown) => unknown) | null;
+    /**
+     * Get a serializer function for a DTO type name.
+     * Returns a function that converts the input to a JSON string.
+     */
+    getSerializer(typeName: string): ((input: unknown) => string) | null;
+    /**
+     * Check if a validator exists for a type.
+     */
+    hasValidator(typeName: string): boolean;
+    /**
+     * Check if a serializer exists for a type.
+     */
+    hasSerializer(typeName: string): boolean;
+    /**
+     * Get all registered validator type names.
+     */
+    getValidatorTypes(): string[];
+    /**
+     * Get all registered serializer type names.
+     */
+    getSerializerTypes(): string[];
+    /**
+     * Look up the return type for a controller method from the route map.
+     * @param controllerName The controller class name (e.g., "UserController").
+     * @param methodName The method name (e.g., "findAll").
+     * @returns The route mapping or null if not found.
+     */
+    getRouteMapping(controllerName: string, methodName: string): RouteMapping | null;
+    /**
+     * Get a serializer function for a controller method, using the route map.
+     * This is the primary lookup path for the fast interceptor — no Reflect metadata needed.
+     * @returns An object with the serializer function and whether it's an array, or null.
+     */
+    getSerializerForRoute(controllerName: string, methodName: string): {
+        serializer: (input: unknown) => string;
+        isArray: boolean;
+    } | null;
+}
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;CACZ;AAUD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,KAAK,CAGX;IAEF;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAgBtC;;;OAGG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAU5D;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,GAAG,IAAI;IAyBpE;;;OAGG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,GAAG,IAAI;IAyBpE;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIxC;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACH,kBAAkB,IAAI,MAAM,EAAE;IAI9B;;;;;OAKG;IACH,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAMhF;;;;OAIG;IACH,qBAAqB,CACnB,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB;QAAE,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CASvE"}

package/dist/discovery.js

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompanionDiscovery = void 0;
+const path_1 = require("path");
+const fs_1 = require("fs");
+/**
+ * Discovers and loads companion file functions from the tsgonest manifest.
+ */
+class CompanionDiscovery {
+    manifest = null;
+    manifestDir = '';
+    cache = {
+        validators: new Map(),
+        serializers: new Map(),
+    };
+    /**
+     * Load the manifest from a directory.
+     * Searches for __tsgonest_manifest.json in the given directory.
+     */
+    loadManifest(distDir) {
+        const manifestPath = (0, path_1.join)(distDir, '__tsgonest_manifest.json');
+        if (!(0, fs_1.existsSync)(manifestPath)) {
+            return false;
+        }
+        try {
+            const content = (0, fs_1.readFileSync)(manifestPath, 'utf-8');
+            this.manifest = JSON.parse(content);
+            this.manifestDir = (0, path_1.dirname)(manifestPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load the manifest from a JSON string.
+     * Used for testing or when the manifest is embedded.
+     */
+    loadManifestFromJSON(json, baseDir) {
+        try {
+            this.manifest = JSON.parse(json);
+            this.manifestDir = baseDir;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get a validator function for a DTO type name.
+     * Returns the assert function that throws on invalid input.
+     */
+    getValidator(typeName) {
+        // Check cache
+        const cached = this.cache.validators.get(typeName);
+        if (cached)
+            return cached;
+        if (!this.manifest)
+            return null;
+        const entry = this.manifest.validators[typeName];
+        if (!entry)
+            return null;
+        try {
+            const filePath = (0, path_1.join)(this.manifestDir, entry.file);
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const mod = require(filePath);
+            const fn = mod[entry.fn];
+            if (typeof fn === 'function') {
+                this.cache.validators.set(typeName, fn);
+                return fn;
+            }
+        }
+        catch {
+            // Failed to load companion file
+        }
+        return null;
+    }
+    /**
+     * Get a serializer function for a DTO type name.
+     * Returns a function that converts the input to a JSON string.
+     */
+    getSerializer(typeName) {
+        // Check cache
+        const cached = this.cache.serializers.get(typeName);
+        if (cached)
+            return cached;
+        if (!this.manifest)
+            return null;
+        const entry = this.manifest.serializers[typeName];
+        if (!entry)
+            return null;
+        try {
+            const filePath = (0, path_1.join)(this.manifestDir, entry.file);
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const mod = require(filePath);
+            const fn = mod[entry.fn];
+            if (typeof fn === 'function') {
+                this.cache.serializers.set(typeName, fn);
+                return fn;
+            }
+        }
+        catch {
+            // Failed to load companion file
+        }
+        return null;
+    }
+    /**
+     * Check if a validator exists for a type.
+     */
+    hasValidator(typeName) {
+        return this.manifest?.validators[typeName] != null;
+    }
+    /**
+     * Check if a serializer exists for a type.
+     */
+    hasSerializer(typeName) {
+        return this.manifest?.serializers[typeName] != null;
+    }
+    /**
+     * Get all registered validator type names.
+     */
+    getValidatorTypes() {
+        return this.manifest ? Object.keys(this.manifest.validators) : [];
+    }
+    /**
+     * Get all registered serializer type names.
+     */
+    getSerializerTypes() {
+        return this.manifest ? Object.keys(this.manifest.serializers) : [];
+    }
+    /**
+     * Look up the return type for a controller method from the route map.
+     * @param controllerName The controller class name (e.g., "UserController").
+     * @param methodName The method name (e.g., "findAll").
+     * @returns The route mapping or null if not found.
+     */
+    getRouteMapping(controllerName, methodName) {
+        if (!this.manifest?.routes)
+            return null;
+        const key = `${controllerName}.${methodName}`;
+        return this.manifest.routes[key] ?? null;
+    }
+    /**
+     * Get a serializer function for a controller method, using the route map.
+     * This is the primary lookup path for the fast interceptor — no Reflect metadata needed.
+     * @returns An object with the serializer function and whether it's an array, or null.
+     */
+    getSerializerForRoute(controllerName, methodName) {
+        const mapping = this.getRouteMapping(controllerName, methodName);
+        if (!mapping)
+            return null;
+        const serializer = this.getSerializer(mapping.returnType);
+        if (!serializer)
+            return null;
+        return { serializer, isArray: mapping.isArray ?? false };
+    }
+}
+exports.CompanionDiscovery = CompanionDiscovery;
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Validation error details for a single field.
+ */
+export interface ValidationErrorDetail {
+    /** The path to the invalid field (e.g., "input.name"). */
+    path: string;
+    /** The expected type or constraint. */
+    expected: string;
+    /** The received type or value description. */
+    received: string;
+}
+/**
+ * Error thrown when validation fails.
+ * Contains structured error details for each invalid field.
+ */
+export declare class TsgonestValidationError extends Error {
+    readonly errors: ValidationErrorDetail[];
+    constructor(errors: ValidationErrorDetail[]);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,MAAM,EAAE,qBAAqB,EAAE,CAAC;gBAEpC,MAAM,EAAE,qBAAqB,EAAE;CAO5C"}

package/dist/errors.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsgonestValidationError = void 0;
+/**
+ * Error thrown when validation fails.
+ * Contains structured error details for each invalid field.
+ */
+class TsgonestValidationError extends Error {
+    errors;
+    constructor(errors) {
+        const message = `Validation failed: ${errors.length} error(s)\n` +
+            errors.map(e => `  - ${e.path}: expected ${e.expected}, received ${e.received}`).join('\n');
+        super(message);
+        this.name = 'TsgonestValidationError';
+        this.errors = errors;
+    }
+}
+exports.TsgonestValidationError = TsgonestValidationError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAYA;;;GAGG;AACH,MAAa,uBAAwB,SAAQ,KAAK;IAChC,MAAM,CAA0B;IAEhD,YAAY,MAA+B;QACzC,MAAM,OAAO,GAAG,sBAAsB,MAAM,CAAC,MAAM,aAAa;YAC9D,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,QAAQ,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9F,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAVD,0DAUC"}

package/dist/fast-interceptor.d.ts

@@ -0,0 +1,82 @@
+import type { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import type { Observable } from 'rxjs';
+import { CompanionDiscovery } from './discovery';
+/**
+ * Options for configuring the TsgonestFastInterceptor.
+ */
+export interface FastInterceptorOptions {
+    /**
+     * Path to the dist directory containing the tsgonest manifest.
+     * Defaults to the current working directory's dist/ folder.
+     */
+    distDir?: string;
+    /**
+     * Pre-loaded CompanionDiscovery instance.
+     * If provided, distDir is ignored.
+     */
+    discovery?: CompanionDiscovery;
+    /**
+     * Type name overrides for specific routes.
+     * Map of "ControllerName.methodName" to type name.
+     * Takes priority over the route map in the manifest.
+     */
+    typeOverrides?: Record<string, string>;
+    /**
+     * Whether to set the raw response directly (bypassing NestJS JSON serialization).
+     * When true, the interceptor writes the pre-serialized JSON string directly to
+     * the response with Content-Type: application/json, skipping JSON.stringify entirely.
+     *
+     * When false (default), the interceptor returns the pre-serialized string and
+     * relies on NestJS/Express to write it (which may still call JSON.stringify on
+     * the string — wrapping it in quotes). Use `true` for maximum performance.
+     *
+     * Defaults to true.
+     */
+    rawResponse?: boolean;
+}
+/**
+ * A high-performance NestJS interceptor that replaces JSON.stringify with
+ * tsgonest-generated schema-aware serializers on responses.
+ *
+ * Unlike `TsgonestSerializationInterceptor`, this interceptor uses the
+ * **route map** in the manifest to look up which serializer to use for each
+ * controller method — no Reflect.getMetadata or emitDecoratorMetadata needed.
+ *
+ * The route map is populated at build time by tsgonest's static analysis of
+ * NestJS controllers, making this zero-config and guaranteed to work.
+ *
+ * Performance: 2-5x faster JSON serialization compared to JSON.stringify,
+ * because the generated serializers use string concatenation with known
+ * property names and types, avoiding the overhead of generic object traversal.
+ *
+ * Usage:
+ * ```ts
+ * import { TsgonestFastInterceptor } from '@tsgonest/runtime';
+ *
+ * // In main.ts (after app creation):
+ * app.useGlobalInterceptors(new TsgonestFastInterceptor());
+ *
+ * // With options:
+ * app.useGlobalInterceptors(new TsgonestFastInterceptor({
+ *   distDir: 'dist',
+ *   rawResponse: true, // bypass JSON.stringify entirely
+ * }));
+ * ```
+ */
+export declare class TsgonestFastInterceptor implements NestInterceptor {
+    private discovery;
+    private typeOverrides;
+    private rawResponse;
+    private initialized;
+    private distDir;
+    constructor(options?: FastInterceptorOptions);
+    /**
+     * Ensure the manifest is loaded (lazy init on first request).
+     */
+    private ensureInitialized;
+    /**
+     * Intercept the response and apply fast serialization if a route mapping exists.
+     */
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+//# sourceMappingURL=fast-interceptor.d.ts.map

package/dist/fast-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fast-interceptor.d.ts","sourceRoot":"","sources":["../src/fast-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,WAAW,CAAU;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,GAAE,sBAA2B;IAahD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;CAyF7E"}

package/dist/fast-interceptor.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsgonestFastInterceptor = void 0;
+const discovery_1 = require("./discovery");
+/**
+ * A high-performance NestJS interceptor that replaces JSON.stringify with
+ * tsgonest-generated schema-aware serializers on responses.
+ *
+ * Unlike `TsgonestSerializationInterceptor`, this interceptor uses the
+ * **route map** in the manifest to look up which serializer to use for each
+ * controller method — no Reflect.getMetadata or emitDecoratorMetadata needed.
+ *
+ * The route map is populated at build time by tsgonest's static analysis of
+ * NestJS controllers, making this zero-config and guaranteed to work.
+ *
+ * Performance: 2-5x faster JSON serialization compared to JSON.stringify,
+ * because the generated serializers use string concatenation with known
+ * property names and types, avoiding the overhead of generic object traversal.
+ *
+ * Usage:
+ * ```ts
+ * import { TsgonestFastInterceptor } from '@tsgonest/runtime';
+ *
+ * // In main.ts (after app creation):
+ * app.useGlobalInterceptors(new TsgonestFastInterceptor());
+ *
+ * // With options:
+ * app.useGlobalInterceptors(new TsgonestFastInterceptor({
+ *   distDir: 'dist',
+ *   rawResponse: true, // bypass JSON.stringify entirely
+ * }));
+ * ```
+ */
+class TsgonestFastInterceptor {
+    discovery;
+    typeOverrides;
+    rawResponse;
+    initialized = false;
+    distDir;
+    constructor(options = {}) {
+        this.typeOverrides = options.typeOverrides ?? {};
+        this.rawResponse = options.rawResponse ?? true;
+        if (options.discovery) {
+            this.discovery = options.discovery;
+            this.initialized = true;
+        }
+        else {
+            this.discovery = new discovery_1.CompanionDiscovery();
+            this.distDir = options.distDir;
+        }
+    }
+    /**
+     * Ensure the manifest is loaded (lazy init on first request).
+     */
+    ensureInitialized() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        const distDir = this.distDir || 'dist';
+        this.discovery.loadManifest(distDir);
+    }
+    /**
+     * Intercept the response and apply fast serialization if a route mapping exists.
+     */
+    intercept(context, next) {
+        this.ensureInitialized();
+        const handler = context.getHandler();
+        const controller = context.getClass();
+        const controllerName = controller.name;
+        const methodName = handler.name;
+        // 1. Check explicit type overrides first
+        const overrideKey = `${controllerName}.${methodName}`;
+        const overrideType = this.typeOverrides[overrideKey];
+        // 2. Look up via route map (the primary path — zero-config)
+        let serializerFn = null;
+        let isArray = false;
+        if (overrideType) {
+            serializerFn = this.discovery.getSerializer(overrideType);
+        }
+        else {
+            const routeInfo = this.discovery.getSerializerForRoute(controllerName, methodName);
+            if (routeInfo) {
+                serializerFn = routeInfo.serializer;
+                isArray = routeInfo.isArray;
+            }
+        }
+        if (!serializerFn) {
+            // No serializer available — pass through to default JSON.stringify
+            return next.handle();
+        }
+        // Capture for closure
+        const serializer = serializerFn;
+        const useRawResponse = this.rawResponse;
+        const isArrayResponse = isArray;
+        // Lazy-import rxjs to avoid requiring it at module load time
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { map } = require('rxjs');
+            return next.handle().pipe(map((data) => {
+                if (data === null || data === undefined) {
+                    return data;
+                }
+                let jsonString;
+                if (isArrayResponse || Array.isArray(data)) {
+                    // Serialize array: serialize each element, join with commas
+                    const items = Array.isArray(data) ? data : [data];
+                    const parts = items.map(item => serializer(item));
+                    jsonString = '[' + parts.join(',') + ']';
+                }
+                else {
+                    jsonString = serializer(data);
+                }
+                if (useRawResponse) {
+                    // Write directly to the response, bypassing NestJS JSON serialization
+                    const httpCtx = context.switchToHttp();
+                    const response = httpCtx.getResponse();
+                    // Works with both Express and Fastify
+                    if (typeof response.type === 'function') {
+                        // Fastify
+                        response.type('application/json');
+                        response.send(jsonString);
+                    }
+                    else if (typeof response.setHeader === 'function') {
+                        // Express
+                        response.setHeader('Content-Type', 'application/json');
+                        response.end(jsonString);
+                    }
+                    // Return undefined to signal NestJS not to send anything else.
+                    // The response is already sent.
+                    return undefined;
+                }
+                // Non-raw mode: return the pre-serialized JSON.
+                // Note: NestJS will call JSON.stringify on this string,
+                // wrapping it in quotes. This mode is less optimal but safer.
+                return jsonString;
+            }));
+        }
+        catch {
+            // rxjs not available — pass through
+            return next.handle();
+        }
+    }
+}
+exports.TsgonestFastInterceptor = TsgonestFastInterceptor;
+//# sourceMappingURL=fast-interceptor.js.map

package/dist/fast-interceptor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { TsgonestValidationPipe } from './validation-pipe';
+export type { ValidationPipeOptions } from './validation-pipe';
+export { TsgonestSerializationInterceptor } from './serialization';
+export type { SerializationInterceptorOptions } from './serialization';
+export { TsgonestFastInterceptor } from './fast-interceptor';
+export type { FastInterceptorOptions } from './fast-interceptor';
+export { TsgonestValidationError } from './errors';
+export type { ValidationErrorDetail } from './errors';
+export { CompanionDiscovery } from './discovery';
+export type { TsgonestManifest, ManifestEntry, RouteMapping } from './discovery';
+export { defineConfig } from './config';
+export type { TsgonestConfig } from './config';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAGvE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACnD,YAAY,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGjF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = exports.CompanionDiscovery = exports.TsgonestValidationError = exports.TsgonestFastInterceptor = exports.TsgonestSerializationInterceptor = exports.TsgonestValidationPipe = void 0;
+// Validation
+var validation_pipe_1 = require("./validation-pipe");
+Object.defineProperty(exports, "TsgonestValidationPipe", { enumerable: true, get: function () { return validation_pipe_1.TsgonestValidationPipe; } });
+// Serialization (legacy — uses Reflect.getMetadata)
+var serialization_1 = require("./serialization");
+Object.defineProperty(exports, "TsgonestSerializationInterceptor", { enumerable: true, get: function () { return serialization_1.TsgonestSerializationInterceptor; } });
+// Fast Serialization (recommended — uses route map, no Reflect needed)
+var fast_interceptor_1 = require("./fast-interceptor");
+Object.defineProperty(exports, "TsgonestFastInterceptor", { enumerable: true, get: function () { return fast_interceptor_1.TsgonestFastInterceptor; } });
+// Errors
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "TsgonestValidationError", { enumerable: true, get: function () { return errors_1.TsgonestValidationError; } });
+// Discovery
+var discovery_1 = require("./discovery");
+Object.defineProperty(exports, "CompanionDiscovery", { enumerable: true, get: function () { return discovery_1.CompanionDiscovery; } });
+// Config
+var config_1 = require("./config");
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return config_1.defineConfig; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,aAAa;AACb,qDAA2D;AAAlD,yHAAA,sBAAsB,OAAA;AAG/B,oDAAoD;AACpD,iDAAmE;AAA1D,iIAAA,gCAAgC,OAAA;AAGzC,uEAAuE;AACvE,uDAA6D;AAApD,2HAAA,uBAAuB,OAAA;AAGhC,SAAS;AACT,mCAAmD;AAA1C,iHAAA,uBAAuB,OAAA;AAGhC,YAAY;AACZ,yCAAiD;AAAxC,+GAAA,kBAAkB,OAAA;AAG3B,SAAS;AACT,mCAAwC;AAA/B,sGAAA,YAAY,OAAA"}

package/dist/serialization.d.ts

@@ -0,0 +1,65 @@
+import type { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import type { Observable } from 'rxjs';
+import { CompanionDiscovery } from './discovery';
+/**
+ * Options for configuring the TsgonestSerializationInterceptor.
+ */
+export interface SerializationInterceptorOptions {
+    /**
+     * Path to the dist directory containing the tsgonest manifest.
+     * Defaults to the current working directory's dist/ folder.
+     */
+    distDir?: string;
+    /**
+     * Pre-loaded CompanionDiscovery instance.
+     * If provided, distDir is ignored.
+     */
+    discovery?: CompanionDiscovery;
+    /**
+     * Type name overrides for specific routes.
+     * Map of "ControllerName.methodName" → type name.
+     */
+    typeOverrides?: Record<string, string>;
+}
+/**
+ * A NestJS interceptor that uses tsgonest-generated companion serialization
+ * functions for fast JSON output.
+ *
+ * When a serializer companion exists for a controller method's return type,
+ * this interceptor replaces the default JSON.stringify with the generated
+ * fast serializer (string concatenation approach).
+ *
+ * Usage:
+ * ```ts
+ * import { TsgonestSerializationInterceptor } from '@tsgonest/runtime';
+ *
+ * // In main.ts:
+ * app.useGlobalInterceptors(new TsgonestSerializationInterceptor({ distDir: 'dist' }));
+ * ```
+ */
+export declare class TsgonestSerializationInterceptor implements NestInterceptor {
+    private discovery;
+    private typeOverrides;
+    private initialized;
+    private distDir;
+    constructor(options?: SerializationInterceptorOptions);
+    /**
+     * Ensure the manifest is loaded.
+     */
+    private ensureInitialized;
+    /**
+     * Intercept the response and apply fast serialization if available.
+     */
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+    /**
+     * Resolve the return type name for a controller method.
+     *
+     * Strategy:
+     * 1. Check typeOverrides for "ControllerName.methodName"
+     * 2. Check Reflect metadata (if available) for return type
+     * 3. Check the manifest for all registered serializer types
+     *    and match by method name convention (e.g., "findAll" → look for array type)
+     */
+    private resolveTypeName;
+}
+//# sourceMappingURL=serialization.d.ts.map

package/dist/serialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialization.d.ts","sourceRoot":"","sources":["../src/serialization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gCAAiC,YAAW,eAAe;IACtE,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,GAAE,+BAAoC;IAYzD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;IA4C5E;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe;CAkCxB"}

package/dist/serialization.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsgonestSerializationInterceptor = void 0;
+const discovery_1 = require("./discovery");
+/**
+ * A NestJS interceptor that uses tsgonest-generated companion serialization
+ * functions for fast JSON output.
+ *
+ * When a serializer companion exists for a controller method's return type,
+ * this interceptor replaces the default JSON.stringify with the generated
+ * fast serializer (string concatenation approach).
+ *
+ * Usage:
+ * ```ts
+ * import { TsgonestSerializationInterceptor } from '@tsgonest/runtime';
+ *
+ * // In main.ts:
+ * app.useGlobalInterceptors(new TsgonestSerializationInterceptor({ distDir: 'dist' }));
+ * ```
+ */
+class TsgonestSerializationInterceptor {
+    discovery;
+    typeOverrides;
+    initialized = false;
+    distDir;
+    constructor(options = {}) {
+        this.typeOverrides = options.typeOverrides ?? {};
+        if (options.discovery) {
+            this.discovery = options.discovery;
+            this.initialized = true;
+        }
+        else {
+            this.discovery = new discovery_1.CompanionDiscovery();
+            this.distDir = options.distDir;
+        }
+    }
+    /**
+     * Ensure the manifest is loaded.
+     */
+    ensureInitialized() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        const distDir = this.distDir || 'dist';
+        this.discovery.loadManifest(distDir);
+    }
+    /**
+     * Intercept the response and apply fast serialization if available.
+     */
+    intercept(context, next) {
+        this.ensureInitialized();
+        const handler = context.getHandler();
+        const controller = context.getClass();
+        // Determine the return type name
+        const typeName = this.resolveTypeName(controller, handler);
+        if (!typeName) {
+            return next.handle();
+        }
+        // Look up the serializer for this type
+        const serializer = this.discovery.getSerializer(typeName);
+        if (!serializer) {
+            return next.handle();
+        }
+        // Lazy-import rxjs map to avoid requiring rxjs at import time
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { map } = require('rxjs');
+            return next.handle().pipe(map((data) => {
+                if (data === null || data === undefined) {
+                    return data;
+                }
+                // If the data is an array, serialize each element
+                if (Array.isArray(data)) {
+                    const parts = data.map(item => serializer(item));
+                    return '[' + parts.join(',') + ']';
+                }
+                return serializer(data);
+            }));
+        }
+        catch {
+            // rxjs not available — pass through
+            return next.handle();
+        }
+    }
+    /**
+     * Resolve the return type name for a controller method.
+     *
+     * Strategy:
+     * 1. Check typeOverrides for "ControllerName.methodName"
+     * 2. Check Reflect metadata (if available) for return type
+     * 3. Check the manifest for all registered serializer types
+     *    and match by method name convention (e.g., "findAll" → look for array type)
+     */
+    resolveTypeName(controller, handler) {
+        const controllerName = controller.name;
+        const methodName = handler.name;
+        // 1. Check explicit overrides
+        const overrideKey = `${controllerName}.${methodName}`;
+        if (this.typeOverrides[overrideKey]) {
+            return this.typeOverrides[overrideKey];
+        }
+        // 2. Check Reflect metadata for return type (if emitDecoratorMetadata is enabled)
+        if (typeof Reflect !== 'undefined' && Reflect.getMetadata) {
+            const returnType = Reflect.getMetadata('design:returntype', controller.prototype, methodName);
+            if (returnType && returnType.name && returnType.name !== 'Promise' && returnType.name !== 'Object') {
+                const typeName = returnType.name;
+                if (this.discovery.hasSerializer(typeName)) {
+                    return typeName;
+                }
+            }
+        }
+        // 3. Check custom metadata set by tsgonest (via __tsgonest_return_type__)
+        if (typeof Reflect !== 'undefined' && Reflect.getMetadata) {
+            const tsgonestReturnType = Reflect.getMetadata('__tsgonest_return_type__', controller.prototype, methodName);
+            if (tsgonestReturnType && this.discovery.hasSerializer(tsgonestReturnType)) {
+                return tsgonestReturnType;
+            }
+        }
+        return null;
+    }
+}
+exports.TsgonestSerializationInterceptor = TsgonestSerializationInterceptor;
+//# sourceMappingURL=serialization.js.map

package/dist/serialization.js.map

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

package/dist/validation-pipe.d.ts

@@ -0,0 +1,79 @@
+import type { PipeTransform, ArgumentMetadata } from '@nestjs/common';
+import { CompanionDiscovery } from './discovery';
+/**
+ * Options for configuring the TsgonestValidationPipe.
+ */
+export interface ValidationPipeOptions {
+    /**
+     * Path to the dist directory containing the tsgonest manifest.
+     * Defaults to the current working directory's dist/ folder.
+     */
+    distDir?: string;
+    /**
+     * Pre-loaded CompanionDiscovery instance.
+     * If provided, distDir is ignored.
+     */
+    discovery?: CompanionDiscovery;
+    /**
+     * Whether to throw an error if validation fails.
+     * Defaults to true. When false, returns null for invalid input.
+     */
+    throwOnError?: boolean;
+    /**
+     * HTTP status code to use when throwing validation errors.
+     * Defaults to 400 (Bad Request).
+     */
+    errorHttpStatusCode?: number;
+}
+/**
+ * A NestJS pipe that validates incoming request data using
+ * tsgonest-generated companion validation functions.
+ *
+ * Usage:
+ * ```ts
+ * import { TsgonestValidationPipe } from '@tsgonest/runtime';
+ *
+ * // In main.ts:
+ * app.useGlobalPipes(new TsgonestValidationPipe({ distDir: 'dist' }));
+ *
+ * // Or with a pre-loaded discovery:
+ * const discovery = new CompanionDiscovery();
+ * discovery.loadManifest('dist');
+ * app.useGlobalPipes(new TsgonestValidationPipe({ discovery }));
+ * ```
+ */
+export declare class TsgonestValidationPipe implements PipeTransform {
+    private discovery;
+    private throwOnError;
+    private errorHttpStatusCode;
+    private initialized;
+    private distDir;
+    constructor(options?: ValidationPipeOptions);
+    /**
+     * Ensure the manifest is loaded.
+     */
+    private ensureInitialized;
+    /**
+     * Transform (validate) the incoming value.
+     * If a companion validator exists for the metatype, it is called.
+     * Otherwise, the value is returned unchanged.
+     */
+    transform(value: unknown, metadata: ArgumentMetadata): unknown;
+    /**
+     * Extract the type name from a NestJS metatype.
+     * Filters out built-in types (String, Number, Boolean, etc.).
+     */
+    private getTypeName;
+    /**
+     * Parse error messages from generated assert functions.
+     * The generated code throws errors like:
+     *   "Validation failed: input.name expected string, received number"
+     */
+    private parseAssertError;
+    /**
+     * Create an HTTP exception for validation errors.
+     * Uses a dynamic import approach to avoid hard NestJS dependency at import time.
+     */
+    private createHttpException;
+}
+//# sourceMappingURL=validation-pipe.d.ts.map

package/dist/validation-pipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-pipe.d.ts","sourceRoot":"","sources":["../src/validation-pipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAQ,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAE/B;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAqB;gBAExB,OAAO,GAAE,qBAA0B;IAa/C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO;IA8C9D;;;OAGG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAuB5B"}

package/dist/validation-pipe.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TsgonestValidationPipe = void 0;
+const discovery_1 = require("./discovery");
+const errors_1 = require("./errors");
+/**
+ * A NestJS pipe that validates incoming request data using
+ * tsgonest-generated companion validation functions.
+ *
+ * Usage:
+ * ```ts
+ * import { TsgonestValidationPipe } from '@tsgonest/runtime';
+ *
+ * // In main.ts:
+ * app.useGlobalPipes(new TsgonestValidationPipe({ distDir: 'dist' }));
+ *
+ * // Or with a pre-loaded discovery:
+ * const discovery = new CompanionDiscovery();
+ * discovery.loadManifest('dist');
+ * app.useGlobalPipes(new TsgonestValidationPipe({ discovery }));
+ * ```
+ */
+class TsgonestValidationPipe {
+    discovery;
+    throwOnError;
+    errorHttpStatusCode;
+    initialized = false;
+    distDir;
+    constructor(options = {}) {
+        this.throwOnError = options.throwOnError ?? true;
+        this.errorHttpStatusCode = options.errorHttpStatusCode ?? 400;
+        if (options.discovery) {
+            this.discovery = options.discovery;
+            this.initialized = true;
+        }
+        else {
+            this.discovery = new discovery_1.CompanionDiscovery();
+            this.distDir = options.distDir;
+        }
+    }
+    /**
+     * Ensure the manifest is loaded.
+     */
+    ensureInitialized() {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        const distDir = this.distDir || 'dist';
+        this.discovery.loadManifest(distDir);
+    }
+    /**
+     * Transform (validate) the incoming value.
+     * If a companion validator exists for the metatype, it is called.
+     * Otherwise, the value is returned unchanged.
+     */
+    transform(value, metadata) {
+        this.ensureInitialized();
+        // Only validate body, query, and param types
+        if (!metadata.metatype) {
+            return value;
+        }
+        const typeName = this.getTypeName(metadata.metatype);
+        if (!typeName) {
+            return value;
+        }
+        // Look up the validator (assert function) for this type
+        const validator = this.discovery.getValidator(typeName);
+        if (!validator) {
+            // No companion found — pass through
+            return value;
+        }
+        try {
+            return validator(value);
+        }
+        catch (err) {
+            if (!this.throwOnError) {
+                return null;
+            }
+            // Re-throw TsgonestValidationError as a structured HTTP error
+            if (err instanceof errors_1.TsgonestValidationError) {
+                throw this.createHttpException(err.errors);
+            }
+            // For errors from the generated assert functions that throw plain Error
+            if (err instanceof Error && err.message) {
+                // The generated assert functions throw errors with structured messages
+                // Parse them if possible, otherwise wrap
+                const details = this.parseAssertError(err.message);
+                if (details.length > 0) {
+                    throw this.createHttpException(details);
+                }
+            }
+            throw err;
+        }
+    }
+    /**
+     * Extract the type name from a NestJS metatype.
+     * Filters out built-in types (String, Number, Boolean, etc.).
+     */
+    getTypeName(metatype) {
+        const builtInTypes = [String, Number, Boolean, Array, Object];
+        if (builtInTypes.includes(metatype)) {
+            return null;
+        }
+        return metatype.name || null;
+    }
+    /**
+     * Parse error messages from generated assert functions.
+     * The generated code throws errors like:
+     *   "Validation failed: input.name expected string, received number"
+     */
+    parseAssertError(message) {
+        const details = [];
+        const lines = message.split('\n');
+        for (const line of lines) {
+            // Match patterns like "  - input.name: expected string, received number"
+            const match = line.match(/^\s*-?\s*(.+?):\s*expected\s+(.+?),\s*received\s+(.+)$/);
+            if (match) {
+                details.push({
+                    path: match[1].trim(),
+                    expected: match[2].trim(),
+                    received: match[3].trim(),
+                });
+            }
+        }
+        return details;
+    }
+    /**
+     * Create an HTTP exception for validation errors.
+     * Uses a dynamic import approach to avoid hard NestJS dependency at import time.
+     */
+    createHttpException(errors) {
+        // Try to create a NestJS HttpException
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const { HttpException } = require('@nestjs/common');
+            return new HttpException({
+                statusCode: this.errorHttpStatusCode,
+                message: 'Validation failed',
+                errors: errors.map(e => ({
+                    property: e.path,
+                    constraints: { tsgonest: `expected ${e.expected}, received ${e.received}` },
+                })),
+            }, this.errorHttpStatusCode);
+        }
+        catch {
+            // Fallback if @nestjs/common not available
+            const err = new errors_1.TsgonestValidationError(errors);
+            err.status = this.errorHttpStatusCode;
+            return err;
+        }
+    }
+}
+exports.TsgonestValidationPipe = TsgonestValidationPipe;
+//# sourceMappingURL=validation-pipe.js.map

package/dist/validation-pipe.js.map

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@tsgonest/runtime",
+  "version": "0.0.1",
+  "description": "Runtime utilities for tsgonest — validation pipe, serialization interceptor, and companion file discovery",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@nestjs/common": ">=9.0.0",
+    "@nestjs/core": ">=9.0.0",
+    "rxjs": ">=7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@nestjs/common": {
+      "optional": true
+    },
+    "@nestjs/core": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "nestjs",
+    "typescript",
+    "validation",
+    "serialization",
+    "openapi",
+    "tsgonest"
+  ],
+  "devDependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@types/node": "^25.3.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tsgonest/tsgonest"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest --run"
+  }
+}