@decaf-ts/for-nest 0.11.2-refactor.5 → 0.11.2-refactor.6

package/lib/esm/factory/exceptions/DecafErrorFilter.js

@@ -4,13 +4,38 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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;
 };
-import { Catch, NotAcceptableException, NotFoundException, } from "@nestjs/common";
-import { BaseError, InternalError } from "@decaf-ts/db-decorators";
-import { LoggedEnvironment } from "@decaf-ts/logging";
-import { UnsupportedError } from "@decaf-ts/core";
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { BadRequestException, Catch, ConflictException, ForbiddenException, HttpException, Injectable, NotAcceptableException, NotFoundException, Optional, UnauthorizedException, UnprocessableEntityException, } from "@nestjs/common";
+import { ContextIdFactory, ModuleRef } from "@nestjs/core";
+import { BadRequestError, BaseError, ConflictError, InternalError, ValidationError, } from "@decaf-ts/db-decorators";
+import { LoggedEnvironment, Logging } from "@decaf-ts/logging";
+import { AuthorizationError, ForbiddenError, UnsupportedError } from "@decaf-ts/core";
 import { ToManyRequestsError } from "./../errors/throttling.js";
+import { DecafRequestContext } from "./../../request/DecafRequestContext.js";
+/**
+ * @description Maps well-known NestJS `HttpException` subclasses (as guards, pipes, or
+ * other framework-level code would throw them) onto the equivalent decaf-ts `BaseError`.
+ * @summary Only `BaseError` instances carry the `.code` the response body relies on, so
+ * without this map every non-decaf exception — including perfectly legitimate ones like a
+ * guard's `ForbiddenException` — would be flattened into a generic 500 `InternalError`.
+ */
+const HTTP_EXCEPTION_TO_DECAF_ERROR = new Map([
+    [UnauthorizedException, (msg) => new AuthorizationError(msg)],
+    [ForbiddenException, (msg) => new ForbiddenError(msg)],
+    [BadRequestException, (msg) => new BadRequestError(msg)],
+    [ConflictException, (msg) => new ConflictError(msg)],
+    [UnprocessableEntityException, (msg) => new ValidationError(msg)],
+]);
 let DecafExceptionFilter = class DecafExceptionFilter {
-    catch(exception, host) {
+    constructor(moduleRef) {
+        this.moduleRef = moduleRef;
+    }
+    async catch(exception, host) {
         const ctx = host.switchToHttp();
         const response = ctx.getResponse();
         const request = ctx.getRequest();
@@ -22,13 +47,23 @@ let DecafExceptionFilter = class DecafExceptionFilter {
             statusCode = exception.getStatus();
         }
         else if (!(exception instanceof BaseError)) {
-            if (exception.status === 429) {
+            const toDecafError = this.decafErrorFor(exception);
+            if (toDecafError) {
+                exception = toDecafError(exception.message);
+            }
+            else if (exception.status === 429) {
                 exception = new ToManyRequestsError(exception.message);
             }
+            else if (exception instanceof HttpException) {
+                // A recognized but unmapped HttpException (e.g. thrown by a guard or
+                // pipe) — preserve its real status instead of flattening it to 500.
+                statusCode = exception.getStatus();
+            }
             else {
                 exception = new InternalError(exception.message);
             }
         }
+        await this.logError(request, exception);
         response.status(exception.code || statusCode).json({
             status: exception.code || statusCode,
             error: isProduction ? exception.name : exception.message,
@@ -37,9 +72,72 @@ let DecafExceptionFilter = class DecafExceptionFilter {
             method: request.method,
         });
     }
+    /**
+     * @description Finds the decaf-ts `BaseError` constructor mapped to this exception's type, if any.
+     * @summary Walks `HTTP_EXCEPTION_TO_DECAF_ERROR` with `instanceof` (rather than a straight
+     * `Map.get`) so subclasses of a mapped exception are matched too.
+     */
+    decafErrorFor(exception) {
+        for (const [type, factory] of HTTP_EXCEPTION_TO_DECAF_ERROR) {
+            if (exception instanceof type)
+                return factory;
+        }
+        return undefined;
+    }
+    /**
+     * @description Logs the exception without ever letting logging failures block the response.
+     * @summary A guard (or middleware/CORS check) can throw before any decaf-aware provider ran,
+     * so the request-bound Context may not exist yet — or the resolved logger's `.error()` itself
+     * could throw (broken transport, formatter bug, etc.). Either way the client-facing error
+     * response below must still go out, so every failure mode here is swallowed, falling back to
+     * the plain `Logging.get()` logger and, as a last resort, doing nothing at all.
+     */
+    async logError(request, exception) {
+        const message = `Unhandled error on ${request?.method} ${request?.url}`;
+        try {
+            const log = await this.resolveLogger(request);
+            log.error(message, exception);
+        }
+        catch {
+            try {
+                Logging.get().error(message, exception);
+            }
+            catch {
+                // logging is unavailable — the response is still sent below
+            }
+        }
+    }
+    /**
+     * @description Resolves the logger bound to the originating request's decaf-ts Context.
+     * @summary Global filters are singletons, so the request-scoped {@link DecafRequestContext}
+     * (and the client/user-bound logger it carries) can't be constructor-injected. Instead, this
+     * looks up the same request's context id and re-resolves the already-accumulated instance
+     * through `ModuleRef`. Falls back to the generic `Logging.get()` logger when the filter wasn't
+     * constructed with a `ModuleRef` (e.g. manually `new`'d) or no request-scoped context exists
+     * for this request (e.g. the error happened before any decaf-aware provider ran, as is the
+     * case when a guard rejects the request before interceptors get to bind the client-scoped
+     * logger onto the Context).
+     */
+    async resolveLogger(request) {
+        if (this.moduleRef) {
+            try {
+                const contextId = ContextIdFactory.getByRequest(request);
+                const requestContext = await this.moduleRef.resolve(DecafRequestContext, contextId, { strict: false });
+                if (requestContext?.logger)
+                    return requestContext.logger;
+            }
+            catch {
+                // no request-scoped context bound for this request — fall back below
+            }
+        }
+        return Logging.get();
+    }
 };
 DecafExceptionFilter = __decorate([
-    Catch()
+    Catch(),
+    Injectable(),
+    __param(0, Optional()),
+    __metadata("design:paramtypes", [ModuleRef])
 ], DecafExceptionFilter);
 export { DecafExceptionFilter };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRGVjYWZFcnJvckZpbHRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9mYWN0b3J5L2V4Y2VwdGlvbnMvRGVjYWZFcnJvckZpbHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSxPQUFPLEVBRUwsS0FBSyxFQUVMLHNCQUFzQixFQUN0QixpQkFBaUIsR0FDbEIsTUFBTSxnQkFBZ0IsQ0FBQztBQUN4QixPQUFPLEVBQUUsU0FBUyxFQUFFLGFBQWEsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQ25FLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ3RELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQ2xELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxrQ0FBNkI7QUFHcEQsSUFBTSxvQkFBb0IsR0FBMUIsTUFBTSxvQkFBb0I7SUFDL0IsS0FBSyxDQUFDLFNBQWdCLEVBQUUsSUFBbUI7UUFDekMsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLFlBQVksRUFBRSxDQUFDO1FBQ2hDLE1BQU0sUUFBUSxHQUFHLEdBQUcsQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUNuQyxNQUFNLE9BQU8sR0FBRyxHQUFHLENBQUMsVUFBVSxFQUFFLENBQUM7UUFFakMsTUFBTSxZQUFZLEdBQUcsaUJBQWlCLENBQUMsR0FBRyxLQUFLLFlBQVksQ0FBQztRQUM1RCxJQUFJLFVBQVUsQ0FBQztRQUVmLElBQ0UsU0FBUyxZQUFZLGlCQUFpQjtZQUN0QyxTQUFTLFlBQVksZ0JBQWdCLEVBQ3JDLENBQUM7WUFDRCxTQUFTLEdBQUcsSUFBSSxzQkFBc0IsQ0FBQyxTQUFTLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDMUQsVUFBVSxHQUFJLFNBQW9DLENBQUMsU0FBUyxFQUFFLENBQUM7UUFDakUsQ0FBQzthQUFNLElBQUksQ0FBQyxDQUFDLFNBQVMsWUFBWSxTQUFTLENBQUMsRUFBRSxDQUFDO1lBQzdDLElBQUksU0FBaUIsQ0FBQyxNQUFNLEtBQUssR0FBRyxFQUFDLENBQUM7Z0JBQ3BDLFNBQVMsR0FBRyxJQUFJLG1CQUFtQixDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUN6RCxDQUFDO2lCQUFJLENBQUM7Z0JBQ0osU0FBUyxHQUFHLElBQUksYUFBYSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUNuRCxDQUFDO1FBQ0gsQ0FBQztRQUVELFFBQVEsQ0FBQyxNQUFNLENBQUUsU0FBdUIsQ0FBQyxJQUFJLElBQUksVUFBVSxDQUFDLENBQUMsSUFBSSxDQUFDO1lBQ2hFLE1BQU0sRUFBRyxTQUF1QixDQUFDLElBQUksSUFBSSxVQUFVO1lBQ25ELEtBQUssRUFBRSxZQUFZLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxPQUFPO1lBQ3hELFNBQVMsRUFBRSxJQUFJLElBQUksRUFBRSxDQUFDLFdBQVcsRUFBRTtZQUNuQyxJQUFJLEVBQUUsT0FBTyxDQUFDLEdBQUc7WUFDakIsTUFBTSxFQUFFLE9BQU8sQ0FBQyxNQUFNO1NBQ3ZCLENBQUMsQ0FBQztJQUNMLENBQUM7Q0FDRixDQUFBO0FBL0JZLG9CQUFvQjtJQURoQyxLQUFLLEVBQUU7R0FDSyxvQkFBb0IsQ0ErQmhDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHtcbiAgQXJndW1lbnRzSG9zdCxcbiAgQ2F0Y2gsXG4gIEV4Y2VwdGlvbkZpbHRlcixcbiAgTm90QWNjZXB0YWJsZUV4Y2VwdGlvbixcbiAgTm90Rm91bmRFeGNlcHRpb24sXG59IGZyb20gXCJAbmVzdGpzL2NvbW1vblwiO1xuaW1wb3J0IHsgQmFzZUVycm9yLCBJbnRlcm5hbEVycm9yIH0gZnJvbSBcIkBkZWNhZi10cy9kYi1kZWNvcmF0b3JzXCI7XG5pbXBvcnQgeyBMb2dnZWRFbnZpcm9ubWVudCB9IGZyb20gXCJAZGVjYWYtdHMvbG9nZ2luZ1wiO1xuaW1wb3J0IHsgVW5zdXBwb3J0ZWRFcnJvciB9IGZyb20gXCJAZGVjYWYtdHMvY29yZVwiO1xuaW1wb3J0IHsgVG9NYW55UmVxdWVzdHNFcnJvciB9IGZyb20gXCIuLi9lcnJvcnMvdGhyb3R0bGluZ1wiO1xuXG5AQ2F0Y2goKVxuZXhwb3J0IGNsYXNzIERlY2FmRXhjZXB0aW9uRmlsdGVyIGltcGxlbWVudHMgRXhjZXB0aW9uRmlsdGVyIHtcbiAgY2F0Y2goZXhjZXB0aW9uOiBFcnJvciwgaG9zdDogQXJndW1lbnRzSG9zdCkge1xuICAgIGNvbnN0IGN0eCA9IGhvc3Quc3dpdGNoVG9IdHRwKCk7XG4gICAgY29uc3QgcmVzcG9uc2UgPSBjdHguZ2V0UmVzcG9uc2UoKTtcbiAgICBjb25zdCByZXF1ZXN0ID0gY3R4LmdldFJlcXVlc3QoKTtcblxuICAgIGNvbnN0IGlzUHJvZHVjdGlvbiA9IExvZ2dlZEVudmlyb25tZW50LmVudiA9PT0gXCJwcm9kdWN0aW9uXCI7XG4gICAgbGV0IHN0YXR1c0NvZGU7XG5cbiAgICBpZiAoXG4gICAgICBleGNlcHRpb24gaW5zdGFuY2VvZiBOb3RGb3VuZEV4Y2VwdGlvbiB8fFxuICAgICAgZXhjZXB0aW9uIGluc3RhbmNlb2YgVW5zdXBwb3J0ZWRFcnJvclxuICAgICkge1xuICAgICAgZXhjZXB0aW9uID0gbmV3IE5vdEFjY2VwdGFibGVFeGNlcHRpb24oZXhjZXB0aW9uLm1lc3NhZ2UpO1xuICAgICAgc3RhdHVzQ29kZSA9IChleGNlcHRpb24gYXMgTm90QWNjZXB0YWJsZUV4Y2VwdGlvbikuZ2V0U3RhdHVzKCk7XG4gICAgfSBlbHNlIGlmICghKGV4Y2VwdGlvbiBpbnN0YW5jZW9mIEJhc2VFcnJvcikpIHtcbiAgICAgIGlmKChleGNlcHRpb24gYXMgYW55KS5zdGF0dXMgPT09IDQyOSl7XG4gICAgICAgIGV4Y2VwdGlvbiA9IG5ldyBUb01hbnlSZXF1ZXN0c0Vycm9yKGV4Y2VwdGlvbi5tZXNzYWdlKTtcbiAgICAgIH1lbHNle1xuICAgICAgICBleGNlcHRpb24gPSBuZXcgSW50ZXJuYWxFcnJvcihleGNlcHRpb24ubWVzc2FnZSk7XG4gICAgICB9XG4gICAgfVxuXG4gICAgcmVzcG9uc2Uuc3RhdHVzKChleGNlcHRpb24gYXMgQmFzZUVycm9yKS5jb2RlIHx8IHN0YXR1c0NvZGUpLmpzb24oe1xuICAgICAgc3RhdHVzOiAoZXhjZXB0aW9uIGFzIEJhc2VFcnJvcikuY29kZSB8fCBzdGF0dXNDb2RlLFxuICAgICAgZXJyb3I6IGlzUHJvZHVjdGlvbiA/IGV4Y2VwdGlvbi5uYW1lIDogZXhjZXB0aW9uLm1lc3NhZ2UsXG4gICAgICB0aW1lc3RhbXA6IG5ldyBEYXRlKCkudG9JU09TdHJpbmcoKSxcbiAgICAgIHBhdGg6IHJlcXVlc3QudXJsLFxuICAgICAgbWV0aG9kOiByZXF1ZXN0Lm1ldGhvZCxcbiAgICB9KTtcbiAgfVxufVxuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiRGVjYWZFcnJvckZpbHRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9mYWN0b3J5L2V4Y2VwdGlvbnMvRGVjYWZFcnJvckZpbHRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7QUFBQSxPQUFPLEVBRUwsbUJBQW1CLEVBQ25CLEtBQUssRUFDTCxpQkFBaUIsRUFFakIsa0JBQWtCLEVBQ2xCLGFBQWEsRUFDYixVQUFVLEVBQ1Ysc0JBQXNCLEVBQ3RCLGlCQUFpQixFQUNqQixRQUFRLEVBQ1IscUJBQXFCLEVBQ3JCLDRCQUE0QixHQUM3QixNQUFNLGdCQUFnQixDQUFDO0FBQ3hCLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxTQUFTLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFDM0QsT0FBTyxFQUNMLGVBQWUsRUFDZixTQUFTLEVBQ1QsYUFBYSxFQUNiLGFBQWEsRUFDYixlQUFlLEdBQ2hCLE1BQU0seUJBQXlCLENBQUM7QUFDakMsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE9BQU8sRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQy9ELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxjQUFjLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUN0RixPQUFPLEVBQUUsbUJBQW1CLEVBQUUsa0NBQTZCO0FBQzNELE9BQU8sRUFBRSxtQkFBbUIsRUFBRSwrQ0FBMEM7QUFHeEU7Ozs7OztHQU1HO0FBQ0gsTUFBTSw2QkFBNkIsR0FBRyxJQUFJLEdBQUcsQ0FHM0M7SUFDQSxDQUFDLHFCQUFxQixFQUFFLENBQUMsR0FBRyxFQUFFLEVBQUUsQ0FBQyxJQUFJLGtCQUFrQixDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzdELENBQUMsa0JBQWtCLEVBQUUsQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUFDLElBQUksY0FBYyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQ3RELENBQUMsbUJBQW1CLEVBQUUsQ0FBQyxHQUFHLEVB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RixDQUFBO0FBL0dZLG9CQUFvQjtJQUZoQyxLQUFLLEVBQUU7SUFDUCxVQUFVLEVBQUU7SUFFRSxXQUFBLFFBQVEsRUFBRSxDQUFBO3FDQUFnQyxTQUFTO0dBRHJELG9CQUFvQixDQStHaEMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQge1xuICBBcmd1bWVudHNIb3N0LFxuICBCYWRSZXF1ZXN0RXhjZXB0aW9uLFxuICBDYXRjaCxcbiAgQ29uZmxpY3RFeGNlcHRpb24sXG4gIEV4Y2VwdGlvbkZpbHRlcixcbiAgRm9yYmlkZGVuRXhjZXB0aW9uLFxuICBIdHRwRXhjZXB0aW9uLFxuICBJbmplY3RhYmxlLFxuICBOb3RBY2NlcHRhYmxlRXhjZXB0aW9uLFxuICBOb3RGb3VuZEV4Y2VwdGlvbixcbiAgT3B0aW9uYWwsXG4gIFVuYXV0aG9yaXplZEV4Y2VwdGlvbixcbiAgVW5wcm9jZXNzYWJsZUVudGl0eUV4Y2VwdGlvbixcbn0gZnJvbSBcIkBuZXN0anMvY29tbW9uXCI7XG5pbXBvcnQgeyBDb250ZXh0SWRGYWN0b3J5LCBNb2R1bGVSZWYgfSBmcm9tIFwiQG5lc3Rqcy9jb3JlXCI7XG5pbXBvcnQge1xuICBCYWRSZXF1ZXN0RXJyb3IsXG4gIEJhc2VFcnJvcixcbiAgQ29uZmxpY3RFcnJvcixcbiAgSW50ZXJuYWxFcnJvcixcbiAgVmFsaWRhdGlvbkVycm9yLFxufSBmcm9tIFwiQGRlY2FmLXRzL2RiLWRlY29yYXRvcnNcIjtcbmltcG9ydCB7IExvZ2dlZEVudmlyb25tZW50LCBMb2dnaW5nIH0gZnJvbSBcIkBkZWNhZi10cy9sb2dnaW5nXCI7XG5pbXBvcnQgeyBBdXRob3JpemF0aW9uRXJyb3IsIEZvcmJpZGRlbkVycm9yLCBVbnN1cHBvcnRlZEVycm9yIH0gZnJvbSBcIkBkZWNhZi10cy9jb3JlXCI7XG5pbXBvcnQgeyBUb01hbnlSZXF1ZXN0c0Vycm9yIH0gZnJvbSBcIi4uL2Vycm9ycy90aHJvdHRsaW5nXCI7XG5pbXBvcnQgeyBEZWNhZlJlcXVlc3RDb250ZXh0IH0gZnJvbSBcIi4uLy4uL3JlcXVlc3QvRGVjYWZSZXF1ZXN0Q29udGV4dFwiO1xuaW1wb3J0IHR5cGUgeyBSZXF1ZXN0TG9nZ2VyIH0gZnJvbSBcIkBkZWNhZi10cy9mb3ItaHR0cC9zZXJ2ZXJcIjtcblxuLyoqXG4gKiBAZGVzY3JpcHRpb24gTWFwcyB3ZWxsLWtub3duIE5lc3RKUyBgSHR0cEV4Y2VwdGlvbmAgc3ViY2xhc3NlcyAoYXMgZ3VhcmRzLCBwaXBlcywgb3JcbiAqIG90aGVyIGZyYW1ld29yay1sZXZlbCBjb2RlIHdvdWxkIHRocm93IHRoZW0pIG9udG8gdGhlIGVxdWl2YWxlbnQgZGVjYWYtdHMgYEJhc2VFcnJvcmAuXG4gKiBAc3VtbWFyeSBPbmx5IGBCYXNlRXJyb3JgIGluc3RhbmNlcyBjYXJyeSB0aGUgYC5jb2RlYCB0aGUgcmVzcG9uc2UgYm9keSByZWxpZXMgb24sIHNvXG4gKiB3aXRob3V0IHRoaXMgbWFwIGV2ZXJ5IG5vbi1kZWNhZiBleGNlcHRpb24g4oCUIGluY2x1ZGluZyBwZXJmZWN0bHkgbGVnaXRpbWF0ZSBvbmVzIGxpa2UgYVxuICogZ3VhcmQncyBgRm9yYmlkZGVuRXhjZXB0aW9uYCDigJQgd291bGQgYmUgZmxhdHRlbmVkIGludG8gYSBnZW5lcmljIDUwMCBgSW50ZXJuYWxFcnJvcmAuXG4gKi9cbmNvbnN0IEhUVFBfRVhDRVBUSU9OX1RPX0RFQ0FGX0VSUk9SID0gbmV3IE1hcDxcbiAgbmV3ICguLi5hcmdzOiBhbnlbXSkgPT4gSHR0cEV4Y2VwdGlvbixcbiAgKG1zZzogc3RyaW5nKSA9PiBCYXNlRXJyb3Jcbj4oW1xuICBbVW5hdXRob3JpemVkRXhjZXB0aW9uLCAobXNnKSA9PiBuZXcgQXV0aG9yaXphdGlvbkVycm9yKG1zZyldLFxuICBbRm9yYmlkZGVuRXhjZXB0aW9uLCAobXNnKSA9PiBuZXcgRm9yYmlkZGVuRXJyb3IobXNnKV0sXG4gIFtCYWRSZXF1ZXN0RXhjZXB0aW9uLCAobXNnKSA9PiBuZXcgQmFkUmVxdWVzdEVycm9yKG1zZyldLFxuICBbQ29uZmxpY3RFeGNlcHRpb24sIChtc2cpID0+IG5ldyBDb25mbGljdEVycm9yKG1zZyldLFxuICBbVW5wcm9jZXNzYWJsZUVudGl0eUV4Y2VwdGlvbiwgKG1zZykgPT4gbmV3IFZhbGlkYXRpb25FcnJvcihtc2cpXSxcbl0pO1xuXG5AQ2F0Y2goKVxuQEluamVjdGFibGUoKVxuZXhwb3J0IGNsYXNzIERlY2FmRXhjZXB0aW9uRmlsdGVyIGltcGxlbWVudHMgRXhjZXB0aW9uRmlsdGVyIHtcbiAgY29uc3RydWN0b3IoQE9wdGlvbmFsKCkgcHJvdGVjdGVkIHJlYWRvbmx5IG1vZHVsZVJlZj86IE1vZHVsZVJlZikge31cblxuICBhc3luYyBjYXRjaChleGNlcHRpb246IEVycm9yLCBob3N0OiBBcmd1bWVudHNIb3N0KSB7XG4gICAgY29uc3QgY3R4ID0gaG9zdC5zd2l0Y2hUb0h0dHAoKTtcbiAgICBjb25zdCByZXNwb25zZSA9IGN0eC5nZXRSZXNwb25zZSgpO1xuICAgIGNvbnN0IHJlcXVlc3QgPSBjdHguZ2V0UmVxdWVzdCgpO1xuXG4gICAgY29uc3QgaXNQcm9kdWN0aW9uID0gTG9nZ2VkRW52aXJvbm1lbnQuZW52ID09PSBcInByb2R1Y3Rpb25cIjtcbiAgICBsZXQgc3RhdHVzQ29kZTtcblxuICAgIGlmIChcbiAgICAgIGV4Y2VwdGlvbiBpbnN0YW5jZW9mIE5vdEZvdW5kRXhjZXB0aW9uIHx8XG4gICAgICBleGNlcHRpb24gaW5zdGFuY2VvZiBVbnN1cHBvcnRlZEVycm9yXG4gICAgKSB7XG4gICAgICBleGNlcHRpb24gPSBuZXcgTm90QWNjZXB0YWJsZUV4Y2VwdGlvbihleGNlcHRpb24ubWVzc2FnZSk7XG4gICAgICBzdGF0dXNDb2RlID0gKGV4Y2VwdGlvbiBhcyBOb3RBY2NlcHRhYmxlRXhjZXB0aW9uKS5nZXRTdGF0dXMoKTtcbiAgICB9IGVsc2UgaWYgKCEoZXhjZXB0aW9uIGluc3RhbmNlb2YgQmFzZUVycm9yKSkge1xuICAgICAgY29uc3QgdG9EZWNhZkVycm9yID0gdGhpcy5kZWNhZkVycm9yRm9yKGV4Y2VwdGlvbik7XG4gICAgICBpZiAodG9EZWNhZkVycm9yKSB7XG4gICAgICAgIGV4Y2VwdGlvbiA9IHRvRGVjYWZFcnJvcihleGNlcHRpb24ubWVzc2FnZSk7XG4gICAgICB9IGVsc2UgaWYgKChleGNlcHRpb24gYXMgYW55KS5zdGF0dXMgPT09IDQyOSkge1xuICAgICAgICBleGNlcHRpb24gPSBuZXcgVG9NYW55UmVxdWVzdHNFcnJvcihleGNlcHRpb24ubWVzc2FnZSk7XG4gICAgICB9IGVsc2UgaWYgKGV4Y2VwdGlvbiBpbnN0YW5jZW9mIEh0dHBFeGNlcHRpb24pIHtcbiAgICAgICAgLy8gQSByZWNvZ25pemVkIGJ1dCB1bm1hcHBlZCBIdHRwRXhjZXB0aW9uIChlLmcuIHRocm93biBieSBhIGd1YXJkIG9yXG4gICAgICAgIC8vIHBpcGUpIOKAlCBwcmVzZXJ2ZSBpdHMgcmVhbCBzdGF0dXMgaW5zdGVhZCBvZiBmbGF0dGVuaW5nIGl0IHRvIDUwMC5cbiAgICAgICAgc3RhdHVzQ29kZSA9IGV4Y2VwdGlvbi5nZXRTdGF0dXMoKTtcbiAgICAgIH0gZWxzZSB7XG4gICAgICAgIGV4Y2VwdGlvbiA9IG5ldyBJbnRlcm5hbEVycm9yKGV4Y2VwdGlvbi5tZXNzYWdlKTtcbiAgICAgIH1cbiAgICB9XG5cbiAgICBhd2FpdCB0aGlzLmxvZ0Vycm9yKHJlcXVlc3QsIGV4Y2VwdGlvbik7XG5cbiAgICByZXNwb25zZS5zdGF0dXMoKGV4Y2VwdGlvbiBhcyBCYXNlRXJyb3IpLmNvZGUgfHwgc3RhdHVzQ29kZSkuanNvbih7XG4gICAgICBzdGF0dXM6IChleGNlcHRpb24gYXMgQmFzZUVycm9yKS5jb2RlIHx8IHN0YXR1c0NvZGUsXG4gICAgICBlcnJvcjogaXNQcm9kdWN0aW9uID8gZXhjZXB0aW9uLm5hbWUgOiBleGNlcHRpb24ubWVzc2FnZSxcbiAgICAgIHRpbWVzdGFtcDogbmV3IERhdGUoKS50b0lTT1N0cmluZygpLFxuICAgICAgcGF0aDogcmVxdWVzdC51cmwsXG4gICAgICBtZXRob2Q6IHJlcXVlc3QubWV0aG9kLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBGaW5kcyB0aGUgZGVjYWYtdHMgYEJhc2VFcnJvcmAgY29uc3RydWN0b3IgbWFwcGVkIHRvIHRoaXMgZXhjZXB0aW9uJ3MgdHlwZSwgaWYgYW55LlxuICAgKiBAc3VtbWFyeSBXYWxrcyBgSFRUUF9FWENFUFRJT05fVE9fREVDQUZfRVJST1JgIHdpdGggYGluc3RhbmNlb2ZgIChyYXRoZXIgdGhhbiBhIHN0cmFpZ2h0XG4gICAqIGBNYXAuZ2V0YCkgc28gc3ViY2xhc3NlcyBvZiBhIG1hcHBlZCBleGNlcHRpb24gYXJlIG1hdGNoZWQgdG9vLlxuICAgKi9cbiAgcHJvdGVjdGVkIGRlY2FmRXJyb3JGb3IoXG4gICAgZXhjZXB0aW9uOiBFcnJvclxuICApOiAoKG1zZzogc3RyaW5nKSA9PiBCYXNlRXJyb3IpIHwgdW5kZWZpbmVkIHtcbiAgICBmb3IgKGNvbnN0IFt0eXBlLCBmYWN0b3J5XSBvZiBIVFRQX0VYQ0VQVElPTl9UT19ERUNBRl9FUlJPUikge1xuICAgICAgaWYgKGV4Y2VwdGlvbiBpbnN0YW5jZW9mIHR5cGUpIHJldHVybiBmYWN0b3J5O1xuICAgIH1cbiAgICByZXR1cm4gdW5kZWZpbmVkO1xuICB9XG5cbiAgLyoqXG4gICAqIEBkZXNjcmlwdGlvbiBMb2dzIHRoZSBleGNlcHRpb24gd2l0aG91dCBldmVyIGxldHRpbmcgbG9nZ2luZyBmYWlsdXJlcyBibG9jayB0aGUgcmVzcG9uc2UuXG4gICAqIEBzdW1tYXJ5IEEgZ3VhcmQgKG9yIG1pZGRsZXdhcmUvQ09SUyBjaGVjaykgY2FuIHRocm93IGJlZm9yZSBhbnkgZGVjYWYtYXdhcmUgcHJvdmlkZXIgcmFuLFxuICAgKiBzbyB0aGUgcmVxdWVzdC1ib3VuZCBDb250ZXh0IG1heSBub3QgZXhpc3QgeWV0IOKAlCBvciB0aGUgcmVzb2x2ZWQgbG9nZ2VyJ3MgYC5lcnJvcigpYCBpdHNlbGZcbiAgICogY291bGQgdGhyb3cgKGJyb2tlbiB0cmFuc3BvcnQsIGZvcm1hdHRlciBidWcsIGV0Yy4pLiBFaXRoZXIgd2F5IHRoZSBjbGllbnQtZmFjaW5nIGVycm9yXG4gICAqIHJlc3BvbnNlIGJlbG93IG11c3Qgc3RpbGwgZ28gb3V0LCBzbyBldmVyeSBmYWlsdXJlIG1vZGUgaGVyZSBpcyBzd2FsbG93ZWQsIGZhbGxpbmcgYmFjayB0b1xuICAgKiB0aGUgcGxhaW4gYExvZ2dpbmcuZ2V0KClgIGxvZ2dlciBhbmQsIGFzIGEgbGFzdCByZXNvcnQsIGRvaW5nIG5vdGhpbmcgYXQgYWxsLlxuICAgKi9cbiAgcHJvdGVjdGVkIGFzeW5jIGxvZ0Vycm9yKFxuICAgIHJlcXVlc3Q6IFJlY29yZDxzdHJpbmcsIGFueT4sXG4gICAgZXhjZXB0aW9uOiBFcnJvclxuICApOiBQcm9taXNlPHZvaWQ+IHtcbiAgICBjb25zdCBtZXNzYWdlID0gYFVuaGFuZGxlZCBlcnJvciBvbiAke3JlcXVlc3Q/Lm1ldGhvZH0gJHtyZXF1ZXN0Py51cmx9YDtcbiAgICB0cnkge1xuICAgICAgY29uc3QgbG9nID0gYXdhaXQgdGhpcy5yZXNvbHZlTG9nZ2VyKHJlcXVlc3QpO1xuICAgICAgbG9nLmVycm9yKG1lc3NhZ2UsIGV4Y2VwdGlvbik7XG4gICAgfSBjYXRjaCB7XG4gICAgICB0cnkge1xuICAgICAgICBMb2dnaW5nLmdldCgpLmVycm9yKG1lc3NhZ2UsIGV4Y2VwdGlvbik7XG4gICAgICB9IGNhdGNoIHtcbiAgICAgICAgLy8gbG9nZ2luZyBpcyB1bmF2YWlsYWJsZSDigJQgdGhlIHJlc3BvbnNlIGlzIHN0aWxsIHNlbnQgYmVsb3dcbiAgICAgIH1cbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogQGRlc2NyaXB0aW9uIFJlc29sdmVzIHRoZSBsb2dnZXIgYm91bmQgdG8gdGhlIG9yaWdpbmF0aW5nIHJlcXVlc3QncyBkZWNhZi10cyBDb250ZXh0LlxuICAgKiBAc3VtbWFyeSBHbG9iYWwgZmlsdGVycyBhcmUgc2luZ2xldG9ucywgc28gdGhlIHJlcXVlc3Qtc2NvcGVkIHtAbGluayBEZWNhZlJlcXVlc3RDb250ZXh0fVxuICAgKiAoYW5kIHRoZSBjbGllbnQvdXNlci1ib3VuZCBsb2dnZXIgaXQgY2FycmllcykgY2FuJ3QgYmUgY29uc3RydWN0b3ItaW5qZWN0ZWQuIEluc3RlYWQsIHRoaXNcbiAgICogbG9va3MgdXAgdGhlIHNhbWUgcmVxdWVzdCdzIGNvbnRleHQgaWQgYW5kIHJlLXJlc29sdmVzIHRoZSBhbHJlYWR5LWFjY3VtdWxhdGVkIGluc3RhbmNlXG4gICAqIHRocm91Z2ggYE1vZHVsZVJlZmAuIEZhbGxzIGJhY2sgdG8gdGhlIGdlbmVyaWMgYExvZ2dpbmcuZ2V0KClgIGxvZ2dlciB3aGVuIHRoZSBmaWx0ZXIgd2Fzbid0XG4gICAqIGNvbnN0cnVjdGVkIHdpdGggYSBgTW9kdWxlUmVmYCAoZS5nLiBtYW51YWxseSBgbmV3YCdkKSBvciBubyByZXF1ZXN0LXNjb3BlZCBjb250ZXh0IGV4aXN0c1xuICAgKiBmb3IgdGhpcyByZXF1ZXN0IChlLmcuIHRoZSBlcnJvciBoYXBwZW5lZCBiZWZvcmUgYW55IGRlY2FmLWF3YXJlIHByb3ZpZGVyIHJhbiwgYXMgaXMgdGhlXG4gICAqIGNhc2Ugd2hlbiBhIGd1YXJkIHJlamVjdHMgdGhlIHJlcXVlc3QgYmVmb3JlIGludGVyY2VwdG9ycyBnZXQgdG8gYmluZCB0aGUgY2xpZW50LXNjb3BlZFxuICAgKiBsb2dnZXIgb250byB0aGUgQ29udGV4dCkuXG4gICAqL1xuICBwcm90ZWN0ZWQgYXN5bmMgcmVzb2x2ZUxvZ2dlcihcbiAgICByZXF1ZXN0OiBSZWNvcmQ8c3RyaW5nLCBhbnk+XG4gICk6IFByb21pc2U8UmVxdWVzdExvZ2dlcj4ge1xuICAgIGlmICh0aGlzLm1vZHVsZVJlZikge1xuICAgICAgdHJ5IHtcbiAgICAgICAgY29uc3QgY29udGV4dElkID0gQ29udGV4dElkRmFjdG9yeS5nZXRCeVJlcXVlc3QocmVxdWVzdCk7XG4gICAgICAgIGNvbnN0IHJlcXVlc3RDb250ZXh0ID0gYXdhaXQgdGhpcy5tb2R1bGVSZWYucmVzb2x2ZShcbiAgICAgICAgICBEZWNhZlJlcXVlc3RDb250ZXh0LFxuICAgICAgICAgIGNvbnRleHRJZCxcbiAgICAgICAgICB7IHN0cmljdDogZmFsc2UgfVxuICAgICAgICApO1xuICAgICAgICBpZiAocmVxdWVzdENvbnRleHQ/LmxvZ2dlcikgcmV0dXJuIHJlcXVlc3RDb250ZXh0LmxvZ2dlcjtcbiAgICAgIH0gY2F0Y2gge1xuICAgICAgICAvLyBubyByZXF1ZXN0LXNjb3BlZCBjb250ZXh0IGJvdW5kIGZvciB0aGlzIHJlcXVlc3Qg4oCUIGZhbGwgYmFjayBiZWxvd1xuICAgICAgfVxuICAgIH1cbiAgICByZXR1cm4gTG9nZ2luZy5nZXQoKSBhcyB1bmtub3duIGFzIFJlcXVlc3RMb2dnZXI7XG4gIH1cbn1cbiJdfQ==

package/lib/esm/factory/exceptions/decorators.js

@@ -1,10 +1,13 @@
 import { UseFilters, UseInterceptors } from "@nestjs/common";
 import { DecafExceptionFilter } from "./DecafErrorFilter.js";
 import { DecafResponseInterceptor } from "./../../request/index.js";
+// No ModuleRef available at decoration time, so this instance falls back to
+// Logging.get() rather than the request-bound context logger; prefer
+// NestBootstraper.useGlobalFilters() for context-aware error logging.
 export function UseDecafFilter() {
     return UseFilters(new DecafExceptionFilter());
 }
 export function UseDecafHeaders() {
     return UseInterceptors(DecafResponseInterceptor);
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVjb3JhdG9ycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9mYWN0b3J5L2V4Y2VwdGlvbnMvZGVjb3JhdG9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLGVBQWUsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzdELE9BQU8sRUFBRSxvQkFBb0IsRUFBRSw4QkFBMkI7QUFDMUQsT0FBTyxFQUFFLHdCQUF3QixFQUFFLGlDQUE0QjtBQUUvRCxNQUFNLFVBQVUsY0FBYztJQUM1QixPQUFPLFVBQVUsQ0FBQyxJQUFJLG9CQUFvQixFQUFFLENBQUMsQ0FBQztBQUNoRCxDQUFDO0FBRUQsTUFBTSxVQUFVLGVBQWU7SUFDN0IsT0FBTyxlQUFlLENBQUMsd0JBQXdCLENBQUMsQ0FBQztBQUNuRCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgVXNlRmlsdGVycywgVXNlSW50ZXJjZXB0b3JzIH0gZnJvbSBcIkBuZXN0anMvY29tbW9uXCI7XG5pbXBvcnQgeyBEZWNhZkV4Y2VwdGlvbkZpbHRlciB9IGZyb20gXCIuL0RlY2FmRXJyb3JGaWx0ZXJcIjtcbmltcG9ydCB7IERlY2FmUmVzcG9uc2VJbnRlcmNlcHRvciB9IGZyb20gXCIuLi8uLi9yZXF1ZXN0L2luZGV4XCI7XG5cbmV4cG9ydCBmdW5jdGlvbiBVc2VEZWNhZkZpbHRlcigpIHtcbiAgcmV0dXJuIFVzZUZpbHRlcnMobmV3IERlY2FmRXhjZXB0aW9uRmlsdGVyKCkpO1xufVxuXG5leHBvcnQgZnVuY3Rpb24gVXNlRGVjYWZIZWFkZXJzKCkge1xuICByZXR1cm4gVXNlSW50ZXJjZXB0b3JzKERlY2FmUmVzcG9uc2VJbnRlcmNlcHRvcik7XG59XG4iXX0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVjb3JhdG9ycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3NyYy9mYWN0b3J5L2V4Y2VwdGlvbnMvZGVjb3JhdG9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLGVBQWUsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzdELE9BQU8sRUFBRSxvQkFBb0IsRUFBRSw4QkFBMkI7QUFDMUQsT0FBTyxFQUFFLHdCQUF3QixFQUFFLGlDQUE0QjtBQUUvRCw0RUFBNEU7QUFDNUUscUVBQXFFO0FBQ3JFLHNFQUFzRTtBQUN0RSxNQUFNLFVBQVUsY0FBYztJQUM1QixPQUFPLFVBQVUsQ0FBQyxJQUFJLG9CQUFvQixFQUFFLENBQUMsQ0FBQztBQUNoRCxDQUFDO0FBRUQsTUFBTSxVQUFVLGVBQWU7SUFDN0IsT0FBTyxlQUFlLENBQUMsd0JBQXdCLENBQUMsQ0FBQztBQUNuRCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgVXNlRmlsdGVycywgVXNlSW50ZXJjZXB0b3JzIH0gZnJvbSBcIkBuZXN0anMvY29tbW9uXCI7XG5pbXBvcnQgeyBEZWNhZkV4Y2VwdGlvbkZpbHRlciB9IGZyb20gXCIuL0RlY2FmRXJyb3JGaWx0ZXJcIjtcbmltcG9ydCB7IERlY2FmUmVzcG9uc2VJbnRlcmNlcHRvciB9IGZyb20gXCIuLi8uLi9yZXF1ZXN0L2luZGV4XCI7XG5cbi8vIE5vIE1vZHVsZVJlZiBhdmFpbGFibGUgYXQgZGVjb3JhdGlvbiB0aW1lLCBzbyB0aGlzIGluc3RhbmNlIGZhbGxzIGJhY2sgdG9cbi8vIExvZ2dpbmcuZ2V0KCkgcmF0aGVyIHRoYW4gdGhlIHJlcXVlc3QtYm91bmQgY29udGV4dCBsb2dnZXI7IHByZWZlclxuLy8gTmVzdEJvb3RzdHJhcGVyLnVzZUdsb2JhbEZpbHRlcnMoKSBmb3IgY29udGV4dC1hd2FyZSBlcnJvciBsb2dnaW5nLlxuZXhwb3J0IGZ1bmN0aW9uIFVzZURlY2FmRmlsdGVyKCkge1xuICByZXR1cm4gVXNlRmlsdGVycyhuZXcgRGVjYWZFeGNlcHRpb25GaWx0ZXIoKSk7XG59XG5cbmV4cG9ydCBmdW5jdGlvbiBVc2VEZWNhZkhlYWRlcnMoKSB7XG4gIHJldHVybiBVc2VJbnRlcmNlcHRvcnMoRGVjYWZSZXNwb25zZUludGVyY2VwdG9yKTtcbn1cbiJdfQ==

package/lib/esm/index.js

@@ -43,21 +43,21 @@ export * from "./events-module/index.js";
  * @constant
  * @type {string}
  */
-export const VERSION = "0.11.2-refactor.4";
+export const VERSION = "0.11.2-refactor.5";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export const COMMIT = "1b4f98c";
+export const COMMIT = "3009b85";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export const FULL_VERSION = "0.11.2-refactor.4-1b4f98c";
+export const FULL_VERSION = "0.11.2-refactor.5-3009b85";
 export const PACKAGE_NAME = "@decaf-ts/for-nest";
 Metadata.allowReregistration(true);
 Metadata.registerLibrary(PACKAGE_NAME, VERSION);

package/lib/types/factory/NestBootstraper.d.cts

@@ -190,6 +190,11 @@ export declare class NestBootstraper {
      * set of standard exception filters for common error types like
      * `HttpException`, `ValidationException`, `ConflictException`, and others.
      *
+     * The default `DecafExceptionFilter` is constructed with the application's
+     * `ModuleRef` so it can resolve the request-scoped `DecafRequestContext` (and
+     * its client-bound logger) for the request that threw, instead of logging
+     * through the generic global logger.
+     *
      * @param {...ExceptionFilter[]} filters - Optional filters to apply globally.
      */
     static useGlobalFilters(...filters: any[]): typeof NestBootstraper;

package/lib/types/factory/NestBootstraper.d.mts

@@ -190,6 +190,11 @@ export declare class NestBootstraper {
      * set of standard exception filters for common error types like
      * `HttpException`, `ValidationException`, `ConflictException`, and others.
      *
+     * The default `DecafExceptionFilter` is constructed with the application's
+     * `ModuleRef` so it can resolve the request-scoped `DecafRequestContext` (and
+     * its client-bound logger) for the request that threw, instead of logging
+     * through the generic global logger.
+     *
      * @param {...ExceptionFilter[]} filters - Optional filters to apply globally.
      */
     static useGlobalFilters(...filters: any[]): typeof NestBootstraper;

package/lib/types/factory/exceptions/DecafErrorFilter.d.cts

@@ -1,4 +1,36 @@
 import { ArgumentsHost, ExceptionFilter } from "@nestjs/common";
+import { ModuleRef } from "@nestjs/core";
+import { BaseError } from "@decaf-ts/db-decorators";
+import type { RequestLogger } from "@decaf-ts/for-http/server";
 export declare class DecafExceptionFilter implements ExceptionFilter {
-    catch(exception: Error, host: ArgumentsHost): void;
+    protected readonly moduleRef?: ModuleRef | undefined;
+    constructor(moduleRef?: ModuleRef | undefined);
+    catch(exception: Error, host: ArgumentsHost): Promise<void>;
+    /**
+     * @description Finds the decaf-ts `BaseError` constructor mapped to this exception's type, if any.
+     * @summary Walks `HTTP_EXCEPTION_TO_DECAF_ERROR` with `instanceof` (rather than a straight
+     * `Map.get`) so subclasses of a mapped exception are matched too.
+     */
+    protected decafErrorFor(exception: Error): ((msg: string) => BaseError) | undefined;
+    /**
+     * @description Logs the exception without ever letting logging failures block the response.
+     * @summary A guard (or middleware/CORS check) can throw before any decaf-aware provider ran,
+     * so the request-bound Context may not exist yet — or the resolved logger's `.error()` itself
+     * could throw (broken transport, formatter bug, etc.). Either way the client-facing error
+     * response below must still go out, so every failure mode here is swallowed, falling back to
+     * the plain `Logging.get()` logger and, as a last resort, doing nothing at all.
+     */
+    protected logError(request: Record<string, any>, exception: Error): Promise<void>;
+    /**
+     * @description Resolves the logger bound to the originating request's decaf-ts Context.
+     * @summary Global filters are singletons, so the request-scoped {@link DecafRequestContext}
+     * (and the client/user-bound logger it carries) can't be constructor-injected. Instead, this
+     * looks up the same request's context id and re-resolves the already-accumulated instance
+     * through `ModuleRef`. Falls back to the generic `Logging.get()` logger when the filter wasn't
+     * constructed with a `ModuleRef` (e.g. manually `new`'d) or no request-scoped context exists
+     * for this request (e.g. the error happened before any decaf-aware provider ran, as is the
+     * case when a guard rejects the request before interceptors get to bind the client-scoped
+     * logger onto the Context).
+     */
+    protected resolveLogger(request: Record<string, any>): Promise<RequestLogger>;
 }

package/lib/types/factory/exceptions/DecafErrorFilter.d.mts

@@ -1,4 +1,36 @@
 import { ArgumentsHost, ExceptionFilter } from "@nestjs/common";
+import { ModuleRef } from "@nestjs/core";
+import { BaseError } from "@decaf-ts/db-decorators";
+import type { RequestLogger } from "@decaf-ts/for-http/server";
 export declare class DecafExceptionFilter implements ExceptionFilter {
-    catch(exception: Error, host: ArgumentsHost): void;
+    protected readonly moduleRef?: ModuleRef | undefined;
+    constructor(moduleRef?: ModuleRef | undefined);
+    catch(exception: Error, host: ArgumentsHost): Promise<void>;
+    /**
+     * @description Finds the decaf-ts `BaseError` constructor mapped to this exception's type, if any.
+     * @summary Walks `HTTP_EXCEPTION_TO_DECAF_ERROR` with `instanceof` (rather than a straight
+     * `Map.get`) so subclasses of a mapped exception are matched too.
+     */
+    protected decafErrorFor(exception: Error): ((msg: string) => BaseError) | undefined;
+    /**
+     * @description Logs the exception without ever letting logging failures block the response.
+     * @summary A guard (or middleware/CORS check) can throw before any decaf-aware provider ran,
+     * so the request-bound Context may not exist yet — or the resolved logger's `.error()` itself
+     * could throw (broken transport, formatter bug, etc.). Either way the client-facing error
+     * response below must still go out, so every failure mode here is swallowed, falling back to
+     * the plain `Logging.get()` logger and, as a last resort, doing nothing at all.
+     */
+    protected logError(request: Record<string, any>, exception: Error): Promise<void>;
+    /**
+     * @description Resolves the logger bound to the originating request's decaf-ts Context.
+     * @summary Global filters are singletons, so the request-scoped {@link DecafRequestContext}
+     * (and the client/user-bound logger it carries) can't be constructor-injected. Instead, this
+     * looks up the same request's context id and re-resolves the already-accumulated instance
+     * through `ModuleRef`. Falls back to the generic `Logging.get()` logger when the filter wasn't
+     * constructed with a `ModuleRef` (e.g. manually `new`'d) or no request-scoped context exists
+     * for this request (e.g. the error happened before any decaf-aware provider ran, as is the
+     * case when a guard rejects the request before interceptors get to bind the client-scoped
+     * logger onto the Context).
+     */
+    protected resolveLogger(request: Record<string, any>): Promise<RequestLogger>;
 }

package/lib/types/index.d.cts

@@ -41,19 +41,19 @@ export * from "./events-module/index.d.cts";
  * @constant
  * @type {string}
  */
-export declare const VERSION = "0.11.2-refactor.4";
+export declare const VERSION = "0.11.2-refactor.5";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "1b4f98c";
+export declare const COMMIT = "3009b85";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.11.2-refactor.4-1b4f98c";
+export declare const FULL_VERSION = "0.11.2-refactor.5-3009b85";
 export declare const PACKAGE_NAME = "@decaf-ts/for-nest";

package/lib/types/index.d.mts

@@ -41,19 +41,19 @@ export * from "./events-module/index.d.mts";
  * @constant
  * @type {string}
  */
-export declare const VERSION = "0.11.2-refactor.4";
+export declare const VERSION = "0.11.2-refactor.5";
 /**
  * @description Represents the current commit hash of the module build.
  * @summary Stores the current git commit hash for the package. The build replaces
  * the placeholder with the actual commit hash at publish time.
  * @const COMMIT
  */
-export declare const COMMIT = "1b4f98c";
+export declare const COMMIT = "3009b85";
 /**
  * @description Represents the full version string of the module.
  * @summary Stores the semver version and commit hash for the package.
  * The build replaces the placeholder with the actual `<version>-<commit>` value at publish time.
  * @const FULL_VERSION
  */
-export declare const FULL_VERSION = "0.11.2-refactor.4-1b4f98c";
+export declare const FULL_VERSION = "0.11.2-refactor.5-3009b85";
 export declare const PACKAGE_NAME = "@decaf-ts/for-nest";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/for-nest",
-  "version": "0.11.2-refactor.5",
+  "version": "0.11.2-refactor.6",
   "description": "NestJS decaf integration",
   "type": "module",
   "exports": {