@crashlensorg/nestjs 0.1.0 → 0.3.0

package/dist/index.d.mts

@@ -1,16 +1,45 @@
-import { DynamicModule, ExceptionFilter, ArgumentsHost, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { ArgumentsHost, NestModule, MiddlewareConsumer, DynamicModule, ExceptionFilter, NestInterceptor, ExecutionContext, CallHandler, NestMiddleware } from '@nestjs/common';
 import { NodeInitOptions, CrashLens } from '@crashlensorg/node';
-export { Breadcrumb, CaptureParams, CrashLens, CrashLensUser, CrashOptions, DeviceInfo, NodeInitOptions, Severity, initNode } from '@crashlensorg/node';
+export { Breadcrumb, CaptureParams, CrashLens, CrashLensUser, CrashOptions, DeviceInfo, NodeInitOptions, Severity, initNode, runWithScope, withIsolationScope } from '@crashlensorg/node';
 import { BaseExceptionFilter } from '@nestjs/core';
 import { Observable } from 'rxjs';
 
+/** Usuário retornado por `resolveUser`. */
+interface ResolvedUser {
+    id: string | number;
+    email?: string;
+    username?: string;
+}
+interface HttpRequestContext {
+    method?: string;
+    /** Padrão da rota (ex.: "/users/:id"), ou o path sem query string como fallback. */
+    route?: string;
+    /** Path real da requisição, sem query string. */
+    path?: string;
+    requestId?: string;
+}
+/** Extrai método, padrão da rota e request id. Nunca lê body, cookies nem Authorization. */
+declare function getHttpRequestContext(req: any): HttpRequestContext;
+/** Resolução padrão do usuário: `req.user` com `id`, `userId` ou `sub`. */
+declare function defaultResolveUser(req: any): ResolvedUser | null;
+
 interface CrashLensConfig extends NodeInitOptions {
     /** URL base da API CrashLens. */
     baseUrl?: string;
-    /** Versão da release do app. */
+    /** Versão da release do app (padrão: env CRASHLENS_RELEASE, depois GIT_SHA). */
     release?: string;
-    /** Ambiente: "production", "staging", etc. */
+    /** Ambiente: "production", "staging", etc. (padrão: env CRASHLENS_ENVIRONMENT, depois NODE_ENV). */
     environment?: string;
+    /**
+     * Decide se uma exceção HTTP com esse status deve ser capturada (padrão: status >= 500).
+     * Erros que não são HttpException contam como 500.
+     */
+    captureStatus?: (status: number) => boolean;
+    /**
+     * Resolve o usuário do request para anexar aos eventos.
+     * Padrão: `req.user` com `id`/`userId`/`sub`.
+     */
+    resolveUser?: (req: any) => ResolvedUser | null | undefined;
     /** Tags globais. */
     tags?: Record<string, unknown>;
     /** Extra global. */
@@ -22,9 +51,17 @@ interface CrashLensConfig extends NodeInitOptions {
  */
 declare class CrashLensService {
     private readonly client?;
+    private readonly captureStatus;
+    private readonly resolveUser;
     constructor(options?: CrashLensConfig);
     get isInitialized(): boolean;
     captureException(error: unknown, params?: Parameters<CrashLens['captureException']>[1]): void;
+    /**
+     * Captura uma exceção HTTP aplicando o filtro de status (`captureStatus`) e anexando o
+     * contexto do request (método, rota, request id, usuário). Pode ser chamado do
+     * `catch()` de um filtro de exceções próprio, sem substituí-lo. Nunca lança.
+     */
+    captureHttpException(exception: unknown, host?: ArgumentsHost): void;
     captureMessage(message: string, params?: Parameters<CrashLens['captureMessage']>[1]): void;
     captureEvent(params: Parameters<CrashLens['captureEvent']>[0]): void;
     addBreadcrumb(breadcrumb: Parameters<CrashLens['addBreadcrumb']>[0]): void;
@@ -38,19 +75,26 @@ interface CrashLensModuleOptions extends CrashLensConfig {
     globalFilter?: boolean;
     /** Registra o interceptor global de requests (padrão: true). */
     globalInterceptor?: boolean;
+    /** Roda cada request HTTP em um escopo isolado (padrão: true). */
+    isolateRequestScope?: boolean;
 }
 /**
  * Módulo do CrashLens para NestJS.
  *
  * @Module({ imports: [CrashLensModule.forRoot({ apiKey: 'cl_live_xxx' }) ] })
  */
-declare class CrashLensModule {
+declare class CrashLensModule implements NestModule {
+    private static isolateRequestScope;
+    configure(consumer: MiddlewareConsumer): void;
     static forRoot(options: CrashLensModuleOptions): DynamicModule;
 }
 
 /**
- * Captura todas as exceções não tratadas e as envia ao CrashLens,
- * preservando o comportamento padrão do NestJS.
+ * Captura exceções e as envia ao CrashLens (respeitando `captureStatus`, padrão >= 500),
+ * preservando o comportamento padrão do NestJS. É o único ponto de captura do módulo.
+ *
+ * Se o app já tem um filtro global próprio, use `CrashLensService.captureHttpException`
+ * dentro dele (com `globalFilter: false`).
  */
 declare class CrashLensFilter extends BaseExceptionFilter implements ExceptionFilter {
     private readonly crashLens;
@@ -59,7 +103,11 @@ declare class CrashLensFilter extends BaseExceptionFilter implements ExceptionFi
 }
 
 /**
- * Interceptor que adiciona breadcrumbs de request e captura erros dos handlers.
+ * Interceptor que adiciona o breadcrumb HTTP de cada request.
+ *
+ * Ele NÃO captura erros: a captura é feita somente pelo `CrashLensFilter` (ou por
+ * `CrashLensService.captureHttpException` num filtro próprio). Usado sozinho, sem filtro,
+ * os erros não são enviados ao CrashLens.
  */
 declare class CrashLensInterceptor implements NestInterceptor {
     private readonly crashLens;
@@ -67,4 +115,13 @@ declare class CrashLensInterceptor implements NestInterceptor {
     intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
 }
 
-export { type CrashLensConfig, CrashLensFilter, CrashLensInterceptor, CrashLensModule, type CrashLensModuleOptions, CrashLensService };
+/**
+ * Executa cada request HTTP dentro de um escopo isolado do CrashLens, para que
+ * setUser/setTag/breadcrumbs de um request não vazem para outros concorrentes.
+ * Registrado automaticamente pelo CrashLensModule para todas as rotas.
+ */
+declare class CrashLensScopeMiddleware implements NestMiddleware {
+    use(_req: unknown, _res: unknown, next: (error?: unknown) => void): void;
+}
+
+export { type CrashLensConfig, CrashLensFilter, CrashLensInterceptor, CrashLensModule, type CrashLensModuleOptions, CrashLensScopeMiddleware, CrashLensService, type HttpRequestContext, type ResolvedUser, defaultResolveUser, getHttpRequestContext };

package/dist/index.d.ts

@@ -1,16 +1,45 @@
-import { DynamicModule, ExceptionFilter, ArgumentsHost, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { ArgumentsHost, NestModule, MiddlewareConsumer, DynamicModule, ExceptionFilter, NestInterceptor, ExecutionContext, CallHandler, NestMiddleware } from '@nestjs/common';
 import { NodeInitOptions, CrashLens } from '@crashlensorg/node';
-export { Breadcrumb, CaptureParams, CrashLens, CrashLensUser, CrashOptions, DeviceInfo, NodeInitOptions, Severity, initNode } from '@crashlensorg/node';
+export { Breadcrumb, CaptureParams, CrashLens, CrashLensUser, CrashOptions, DeviceInfo, NodeInitOptions, Severity, initNode, runWithScope, withIsolationScope } from '@crashlensorg/node';
 import { BaseExceptionFilter } from '@nestjs/core';
 import { Observable } from 'rxjs';
 
+/** Usuário retornado por `resolveUser`. */
+interface ResolvedUser {
+    id: string | number;
+    email?: string;
+    username?: string;
+}
+interface HttpRequestContext {
+    method?: string;
+    /** Padrão da rota (ex.: "/users/:id"), ou o path sem query string como fallback. */
+    route?: string;
+    /** Path real da requisição, sem query string. */
+    path?: string;
+    requestId?: string;
+}
+/** Extrai método, padrão da rota e request id. Nunca lê body, cookies nem Authorization. */
+declare function getHttpRequestContext(req: any): HttpRequestContext;
+/** Resolução padrão do usuário: `req.user` com `id`, `userId` ou `sub`. */
+declare function defaultResolveUser(req: any): ResolvedUser | null;
+
 interface CrashLensConfig extends NodeInitOptions {
     /** URL base da API CrashLens. */
     baseUrl?: string;
-    /** Versão da release do app. */
+    /** Versão da release do app (padrão: env CRASHLENS_RELEASE, depois GIT_SHA). */
     release?: string;
-    /** Ambiente: "production", "staging", etc. */
+    /** Ambiente: "production", "staging", etc. (padrão: env CRASHLENS_ENVIRONMENT, depois NODE_ENV). */
     environment?: string;
+    /**
+     * Decide se uma exceção HTTP com esse status deve ser capturada (padrão: status >= 500).
+     * Erros que não são HttpException contam como 500.
+     */
+    captureStatus?: (status: number) => boolean;
+    /**
+     * Resolve o usuário do request para anexar aos eventos.
+     * Padrão: `req.user` com `id`/`userId`/`sub`.
+     */
+    resolveUser?: (req: any) => ResolvedUser | null | undefined;
     /** Tags globais. */
     tags?: Record<string, unknown>;
     /** Extra global. */
@@ -22,9 +51,17 @@ interface CrashLensConfig extends NodeInitOptions {
  */
 declare class CrashLensService {
     private readonly client?;
+    private readonly captureStatus;
+    private readonly resolveUser;
     constructor(options?: CrashLensConfig);
     get isInitialized(): boolean;
     captureException(error: unknown, params?: Parameters<CrashLens['captureException']>[1]): void;
+    /**
+     * Captura uma exceção HTTP aplicando o filtro de status (`captureStatus`) e anexando o
+     * contexto do request (método, rota, request id, usuário). Pode ser chamado do
+     * `catch()` de um filtro de exceções próprio, sem substituí-lo. Nunca lança.
+     */
+    captureHttpException(exception: unknown, host?: ArgumentsHost): void;
     captureMessage(message: string, params?: Parameters<CrashLens['captureMessage']>[1]): void;
     captureEvent(params: Parameters<CrashLens['captureEvent']>[0]): void;
     addBreadcrumb(breadcrumb: Parameters<CrashLens['addBreadcrumb']>[0]): void;
@@ -38,19 +75,26 @@ interface CrashLensModuleOptions extends CrashLensConfig {
     globalFilter?: boolean;
     /** Registra o interceptor global de requests (padrão: true). */
     globalInterceptor?: boolean;
+    /** Roda cada request HTTP em um escopo isolado (padrão: true). */
+    isolateRequestScope?: boolean;
 }
 /**
  * Módulo do CrashLens para NestJS.
  *
  * @Module({ imports: [CrashLensModule.forRoot({ apiKey: 'cl_live_xxx' }) ] })
  */
-declare class CrashLensModule {
+declare class CrashLensModule implements NestModule {
+    private static isolateRequestScope;
+    configure(consumer: MiddlewareConsumer): void;
     static forRoot(options: CrashLensModuleOptions): DynamicModule;
 }
 
 /**
- * Captura todas as exceções não tratadas e as envia ao CrashLens,
- * preservando o comportamento padrão do NestJS.
+ * Captura exceções e as envia ao CrashLens (respeitando `captureStatus`, padrão >= 500),
+ * preservando o comportamento padrão do NestJS. É o único ponto de captura do módulo.
+ *
+ * Se o app já tem um filtro global próprio, use `CrashLensService.captureHttpException`
+ * dentro dele (com `globalFilter: false`).
  */
 declare class CrashLensFilter extends BaseExceptionFilter implements ExceptionFilter {
     private readonly crashLens;
@@ -59,7 +103,11 @@ declare class CrashLensFilter extends BaseExceptionFilter implements ExceptionFi
 }
 
 /**
- * Interceptor que adiciona breadcrumbs de request e captura erros dos handlers.
+ * Interceptor que adiciona o breadcrumb HTTP de cada request.
+ *
+ * Ele NÃO captura erros: a captura é feita somente pelo `CrashLensFilter` (ou por
+ * `CrashLensService.captureHttpException` num filtro próprio). Usado sozinho, sem filtro,
+ * os erros não são enviados ao CrashLens.
  */
 declare class CrashLensInterceptor implements NestInterceptor {
     private readonly crashLens;
@@ -67,4 +115,13 @@ declare class CrashLensInterceptor implements NestInterceptor {
     intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
 }
 
-export { type CrashLensConfig, CrashLensFilter, CrashLensInterceptor, CrashLensModule, type CrashLensModuleOptions, CrashLensService };
+/**
+ * Executa cada request HTTP dentro de um escopo isolado do CrashLens, para que
+ * setUser/setTag/breadcrumbs de um request não vazem para outros concorrentes.
+ * Registrado automaticamente pelo CrashLensModule para todas as rotas.
+ */
+declare class CrashLensScopeMiddleware implements NestMiddleware {
+    use(_req: unknown, _res: unknown, next: (error?: unknown) => void): void;
+}
+
+export { type CrashLensConfig, CrashLensFilter, CrashLensInterceptor, CrashLensModule, type CrashLensModuleOptions, CrashLensScopeMiddleware, CrashLensService, type HttpRequestContext, type ResolvedUser, defaultResolveUser, getHttpRequestContext };

package/dist/index.js

@@ -29,28 +29,84 @@ var __decorateParam = (index, decorator) => (target, key) => decorator(target, k
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  CrashLens: () => import_node3.CrashLens,
+  CrashLens: () => import_node5.CrashLens,
   CrashLensFilter: () => CrashLensFilter,
   CrashLensInterceptor: () => CrashLensInterceptor,
   CrashLensModule: () => CrashLensModule,
+  CrashLensScopeMiddleware: () => CrashLensScopeMiddleware,
   CrashLensService: () => CrashLensService,
-  initNode: () => import_node2.initNode
+  defaultResolveUser: () => defaultResolveUser,
+  getHttpRequestContext: () => getHttpRequestContext,
+  initNode: () => import_node4.initNode,
+  runWithScope: () => import_node3.runWithScope,
+  withIsolationScope: () => import_node3.withIsolationScope
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/crash-lens.module.ts
-var import_common4 = require("@nestjs/common");
+var import_common5 = require("@nestjs/common");
 var import_core2 = require("@nestjs/core");
 
 // src/crash-lens.service.ts
 var import_common = require("@nestjs/common");
 var import_node = require("@crashlensorg/node");
+
+// src/request-context.ts
+function stripQuery(url) {
+  if (typeof url !== "string") return void 0;
+  const i = url.search(/[?#]/);
+  return i === -1 ? url : url.slice(0, i);
+}
+function firstHeader(value) {
+  const v = Array.isArray(value) ? value[0] : value;
+  return typeof v === "string" && v ? v : void 0;
+}
+function getHttpRequestContext(req) {
+  if (!req) return {};
+  const path = stripQuery(req.originalUrl ?? req.url);
+  let route;
+  const expressRoute = req.route?.path;
+  if (typeof expressRoute === "string") {
+    route = `${req.baseUrl ?? ""}${expressRoute}`;
+  } else {
+    const fastifyRoute = req.routeOptions?.url ?? req.routerPath;
+    route = typeof fastifyRoute === "string" ? fastifyRoute : path;
+  }
+  return {
+    method: req.method,
+    route,
+    path,
+    requestId: firstHeader(req.headers?.["x-request-id"]) ?? (req.requestId ? String(req.requestId) : void 0)
+  };
+}
+function defaultResolveUser(req) {
+  const u = req?.user;
+  if (!u || typeof u !== "object") return null;
+  const id = u.id ?? u.userId ?? u.sub;
+  if (id === void 0 || id === null || id === "") return null;
+  return { id, email: u.email, username: u.username };
+}
+function toCrashLensUser(user) {
+  if (!user || user.id === void 0 || user.id === null) return void 0;
+  const out = { id: String(user.id) };
+  if (user.email) out.email = user.email;
+  if (user.username) out.username = user.username;
+  return out;
+}
+
+// src/crash-lens.service.ts
 var CrashLensService = class {
   constructor(options) {
+    this.captureStatus = (status) => status >= 500;
+    this.resolveUser = defaultResolveUser;
     if (!options) return;
+    if (options.captureStatus) this.captureStatus = options.captureStatus;
+    if (options.resolveUser) this.resolveUser = options.resolveUser;
     this.client = (0, import_node.initNode)({
       ...options,
-      enableGlobalHandlers: options.enableGlobalHandlers ?? false,
+      release: options.release ?? process.env.CRASHLENS_RELEASE ?? process.env.GIT_SHA,
+      environment: options.environment ?? process.env.CRASHLENS_ENVIRONMENT ?? process.env.NODE_ENV,
+      enableGlobalHandlers: options.enableGlobalHandlers ?? true,
       collectRuntimeInfo: options.collectRuntimeInfo ?? true,
       enableSessionTracking: options.enableSessionTracking ?? false
     });
@@ -71,6 +127,40 @@ var CrashLensService = class {
   captureException(error, params) {
     this.client?.captureException(error, params);
   }
+  /**
+   * Captura uma exceção HTTP aplicando o filtro de status (`captureStatus`) e anexando o
+   * contexto do request (método, rota, request id, usuário). Pode ser chamado do
+   * `catch()` de um filtro de exceções próprio, sem substituí-lo. Nunca lança.
+   */
+  captureHttpException(exception, host) {
+    try {
+      if (!this.client) return;
+      const status = exception instanceof import_common.HttpException ? exception.getStatus() : 500;
+      if (!this.captureStatus(status)) return;
+      const request = host && host.getType() === "http" ? host.switchToHttp().getRequest() : void 0;
+      const ctx = getHttpRequestContext(request);
+      const tags = { httpStatus: String(status) };
+      if (ctx.method) tags.httpMethod = ctx.method;
+      if (ctx.route) tags.route = ctx.route;
+      if (ctx.requestId) tags.requestId = ctx.requestId;
+      let user;
+      if (request) {
+        try {
+          user = toCrashLensUser(this.resolveUser(request));
+        } catch {
+        }
+      }
+      this.client.captureException(exception, {
+        context: "nestjs-exception-filter",
+        handled: exception instanceof import_common.HttpException,
+        url: ctx.path,
+        user,
+        tags,
+        extra: { request: { method: ctx.method, route: ctx.route, path: ctx.path, requestId: ctx.requestId } }
+      });
+    } catch {
+    }
+  }
   captureMessage(message, params) {
     this.client?.captureMessage(message, params);
   }
@@ -105,23 +195,7 @@ var CrashLensFilter = class extends import_core.BaseExceptionFilter {
     this.crashLens = crashLens;
   }
   catch(exception, host) {
-    const status = exception instanceof import_common2.HttpException ? exception.getStatus() : import_common2.HttpStatus.INTERNAL_SERVER_ERROR;
-    const request = host.switchToHttp().getRequest();
-    const message = exception instanceof Error ? exception.message : String(exception);
-    this.crashLens.captureException(exception, {
-      context: "nestjs-exception-filter",
-      handled: false,
-      tags: {
-        httpStatus: String(status),
-        httpMethod: request?.method
-      },
-      extra: {
-        url: request?.url,
-        method: request?.method,
-        statusCode: status,
-        error: message
-      }
-    });
+    this.crashLens.captureHttpException(exception, host);
     super.catch(exception, host);
   }
 };
@@ -131,45 +205,52 @@ CrashLensFilter = __decorateClass([
 
 // src/crash-lens.interceptor.ts
 var import_common3 = require("@nestjs/common");
-var import_rxjs = require("rxjs");
-var import_operators = require("rxjs/operators");
 var CrashLensInterceptor = class {
   constructor(crashLens) {
     this.crashLens = crashLens;
   }
   intercept(context, next) {
-    const request = context.switchToHttp().getRequest();
-    if (request) {
-      this.crashLens.addBreadcrumb({
-        message: `${request.method ?? "GET"} ${request.url ?? "/"}`,
-        type: "request",
-        category: "http",
-        data: { method: request.method, url: request.url }
-      });
+    if (context.getType() === "http") {
+      const request = context.switchToHttp().getRequest();
+      if (request) {
+        const url = String(request.originalUrl ?? request.url ?? "/");
+        const path = url.split("?")[0];
+        this.crashLens.addBreadcrumb({
+          message: `${request.method ?? "GET"} ${path}`,
+          type: "request",
+          category: "http",
+          data: { method: request.method, url: path }
+        });
+      }
     }
-    return next.handle().pipe(
-      (0, import_operators.tap)({
-        error: (error) => {
-          this.crashLens.captureException(error, {
-            handled: false,
-            context: "context.interceptor",
-            tags: { httpMethod: request?.method },
-            extra: { url: request?.url }
-          });
-        }
-      }),
-      (0, import_operators.catchError)((error) => (0, import_rxjs.throwError)(() => error))
-    );
+    return next.handle();
   }
 };
 CrashLensInterceptor = __decorateClass([
   (0, import_common3.Injectable)()
 ], CrashLensInterceptor);
 
+// src/crash-lens.middleware.ts
+var import_common4 = require("@nestjs/common");
+var import_node2 = require("@crashlensorg/node");
+var CrashLensScopeMiddleware = class {
+  use(_req, _res, next) {
+    (0, import_node2.runWithScope)(() => next());
+  }
+};
+CrashLensScopeMiddleware = __decorateClass([
+  (0, import_common4.Injectable)()
+], CrashLensScopeMiddleware);
+
 // src/crash-lens.module.ts
 var CRASH_LENS_OPTIONS = /* @__PURE__ */ Symbol("CRASH_LENS_OPTIONS");
 var CrashLensModule = class {
+  configure(consumer) {
+    if (!CrashLensModule.isolateRequestScope) return;
+    consumer.apply(CrashLensScopeMiddleware).forRoutes({ path: "*", method: import_common5.RequestMethod.ALL });
+  }
   static forRoot(options) {
+    CrashLensModule.isolateRequestScope = options.isolateRequestScope !== false;
     const providers = [
       { provide: CRASH_LENS_OPTIONS, useValue: options },
       CrashLensService
@@ -188,19 +269,26 @@ var CrashLensModule = class {
     };
   }
 };
+CrashLensModule.isolateRequestScope = true;
 CrashLensModule = __decorateClass([
-  (0, import_common4.Global)()
+  (0, import_common5.Global)()
 ], CrashLensModule);
 
 // src/index.ts
-var import_node2 = require("@crashlensorg/node");
 var import_node3 = require("@crashlensorg/node");
+var import_node4 = require("@crashlensorg/node");
+var import_node5 = require("@crashlensorg/node");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CrashLens,
   CrashLensFilter,
   CrashLensInterceptor,
   CrashLensModule,
+  CrashLensScopeMiddleware,
   CrashLensService,
-  initNode
+  defaultResolveUser,
+  getHttpRequestContext,
+  initNode,
+  runWithScope,
+  withIsolationScope
 });

package/dist/index.mjs

@@ -11,18 +11,69 @@ var __decorateClass = (decorators, target, key, kind) => {
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 
 // src/crash-lens.module.ts
-import { Global } from "@nestjs/common";
+import { Global, RequestMethod } from "@nestjs/common";
 import { APP_FILTER, APP_INTERCEPTOR } from "@nestjs/core";
 
 // src/crash-lens.service.ts
-import { Inject, Injectable, Optional } from "@nestjs/common";
+import { HttpException, Inject, Injectable, Optional } from "@nestjs/common";
 import { initNode } from "@crashlensorg/node";
+
+// src/request-context.ts
+function stripQuery(url) {
+  if (typeof url !== "string") return void 0;
+  const i = url.search(/[?#]/);
+  return i === -1 ? url : url.slice(0, i);
+}
+function firstHeader(value) {
+  const v = Array.isArray(value) ? value[0] : value;
+  return typeof v === "string" && v ? v : void 0;
+}
+function getHttpRequestContext(req) {
+  if (!req) return {};
+  const path = stripQuery(req.originalUrl ?? req.url);
+  let route;
+  const expressRoute = req.route?.path;
+  if (typeof expressRoute === "string") {
+    route = `${req.baseUrl ?? ""}${expressRoute}`;
+  } else {
+    const fastifyRoute = req.routeOptions?.url ?? req.routerPath;
+    route = typeof fastifyRoute === "string" ? fastifyRoute : path;
+  }
+  return {
+    method: req.method,
+    route,
+    path,
+    requestId: firstHeader(req.headers?.["x-request-id"]) ?? (req.requestId ? String(req.requestId) : void 0)
+  };
+}
+function defaultResolveUser(req) {
+  const u = req?.user;
+  if (!u || typeof u !== "object") return null;
+  const id = u.id ?? u.userId ?? u.sub;
+  if (id === void 0 || id === null || id === "") return null;
+  return { id, email: u.email, username: u.username };
+}
+function toCrashLensUser(user) {
+  if (!user || user.id === void 0 || user.id === null) return void 0;
+  const out = { id: String(user.id) };
+  if (user.email) out.email = user.email;
+  if (user.username) out.username = user.username;
+  return out;
+}
+
+// src/crash-lens.service.ts
 var CrashLensService = class {
   constructor(options) {
+    this.captureStatus = (status) => status >= 500;
+    this.resolveUser = defaultResolveUser;
     if (!options) return;
+    if (options.captureStatus) this.captureStatus = options.captureStatus;
+    if (options.resolveUser) this.resolveUser = options.resolveUser;
     this.client = initNode({
       ...options,
-      enableGlobalHandlers: options.enableGlobalHandlers ?? false,
+      release: options.release ?? process.env.CRASHLENS_RELEASE ?? process.env.GIT_SHA,
+      environment: options.environment ?? process.env.CRASHLENS_ENVIRONMENT ?? process.env.NODE_ENV,
+      enableGlobalHandlers: options.enableGlobalHandlers ?? true,
       collectRuntimeInfo: options.collectRuntimeInfo ?? true,
       enableSessionTracking: options.enableSessionTracking ?? false
     });
@@ -43,6 +94,40 @@ var CrashLensService = class {
   captureException(error, params) {
     this.client?.captureException(error, params);
   }
+  /**
+   * Captura uma exceção HTTP aplicando o filtro de status (`captureStatus`) e anexando o
+   * contexto do request (método, rota, request id, usuário). Pode ser chamado do
+   * `catch()` de um filtro de exceções próprio, sem substituí-lo. Nunca lança.
+   */
+  captureHttpException(exception, host) {
+    try {
+      if (!this.client) return;
+      const status = exception instanceof HttpException ? exception.getStatus() : 500;
+      if (!this.captureStatus(status)) return;
+      const request = host && host.getType() === "http" ? host.switchToHttp().getRequest() : void 0;
+      const ctx = getHttpRequestContext(request);
+      const tags = { httpStatus: String(status) };
+      if (ctx.method) tags.httpMethod = ctx.method;
+      if (ctx.route) tags.route = ctx.route;
+      if (ctx.requestId) tags.requestId = ctx.requestId;
+      let user;
+      if (request) {
+        try {
+          user = toCrashLensUser(this.resolveUser(request));
+        } catch {
+        }
+      }
+      this.client.captureException(exception, {
+        context: "nestjs-exception-filter",
+        handled: exception instanceof HttpException,
+        url: ctx.path,
+        user,
+        tags,
+        extra: { request: { method: ctx.method, route: ctx.route, path: ctx.path, requestId: ctx.requestId } }
+      });
+    } catch {
+    }
+  }
   captureMessage(message, params) {
     this.client?.captureMessage(message, params);
   }
@@ -69,7 +154,7 @@ CrashLensService = __decorateClass([
 ], CrashLensService);
 
 // src/crash-lens.filter.ts
-import { Catch, HttpException, HttpStatus } from "@nestjs/common";
+import { Catch } from "@nestjs/common";
 import { BaseExceptionFilter } from "@nestjs/core";
 var CrashLensFilter = class extends BaseExceptionFilter {
   constructor(crashLens) {
@@ -77,23 +162,7 @@ var CrashLensFilter = class extends BaseExceptionFilter {
     this.crashLens = crashLens;
   }
   catch(exception, host) {
-    const status = exception instanceof HttpException ? exception.getStatus() : HttpStatus.INTERNAL_SERVER_ERROR;
-    const request = host.switchToHttp().getRequest();
-    const message = exception instanceof Error ? exception.message : String(exception);
-    this.crashLens.captureException(exception, {
-      context: "nestjs-exception-filter",
-      handled: false,
-      tags: {
-        httpStatus: String(status),
-        httpMethod: request?.method
-      },
-      extra: {
-        url: request?.url,
-        method: request?.method,
-        statusCode: status,
-        error: message
-      }
-    });
+    this.crashLens.captureHttpException(exception, host);
     super.catch(exception, host);
   }
 };
@@ -103,45 +172,52 @@ CrashLensFilter = __decorateClass([
 
 // src/crash-lens.interceptor.ts
 import { Injectable as Injectable2 } from "@nestjs/common";
-import { throwError } from "rxjs";
-import { catchError, tap } from "rxjs/operators";
 var CrashLensInterceptor = class {
   constructor(crashLens) {
     this.crashLens = crashLens;
   }
   intercept(context, next) {
-    const request = context.switchToHttp().getRequest();
-    if (request) {
-      this.crashLens.addBreadcrumb({
-        message: `${request.method ?? "GET"} ${request.url ?? "/"}`,
-        type: "request",
-        category: "http",
-        data: { method: request.method, url: request.url }
-      });
+    if (context.getType() === "http") {
+      const request = context.switchToHttp().getRequest();
+      if (request) {
+        const url = String(request.originalUrl ?? request.url ?? "/");
+        const path = url.split("?")[0];
+        this.crashLens.addBreadcrumb({
+          message: `${request.method ?? "GET"} ${path}`,
+          type: "request",
+          category: "http",
+          data: { method: request.method, url: path }
+        });
+      }
     }
-    return next.handle().pipe(
-      tap({
-        error: (error) => {
-          this.crashLens.captureException(error, {
-            handled: false,
-            context: "context.interceptor",
-            tags: { httpMethod: request?.method },
-            extra: { url: request?.url }
-          });
-        }
-      }),
-      catchError((error) => throwError(() => error))
-    );
+    return next.handle();
   }
 };
 CrashLensInterceptor = __decorateClass([
   Injectable2()
 ], CrashLensInterceptor);
 
+// src/crash-lens.middleware.ts
+import { Injectable as Injectable3 } from "@nestjs/common";
+import { runWithScope } from "@crashlensorg/node";
+var CrashLensScopeMiddleware = class {
+  use(_req, _res, next) {
+    runWithScope(() => next());
+  }
+};
+CrashLensScopeMiddleware = __decorateClass([
+  Injectable3()
+], CrashLensScopeMiddleware);
+
 // src/crash-lens.module.ts
 var CRASH_LENS_OPTIONS = /* @__PURE__ */ Symbol("CRASH_LENS_OPTIONS");
 var CrashLensModule = class {
+  configure(consumer) {
+    if (!CrashLensModule.isolateRequestScope) return;
+    consumer.apply(CrashLensScopeMiddleware).forRoutes({ path: "*", method: RequestMethod.ALL });
+  }
   static forRoot(options) {
+    CrashLensModule.isolateRequestScope = options.isolateRequestScope !== false;
     const providers = [
       { provide: CRASH_LENS_OPTIONS, useValue: options },
       CrashLensService
@@ -160,11 +236,13 @@ var CrashLensModule = class {
     };
   }
 };
+CrashLensModule.isolateRequestScope = true;
 CrashLensModule = __decorateClass([
   Global()
 ], CrashLensModule);
 
 // src/index.ts
+import { runWithScope as runWithScope2, withIsolationScope } from "@crashlensorg/node";
 import { initNode as initNode2 } from "@crashlensorg/node";
 import { CrashLens as CrashLens2 } from "@crashlensorg/node";
 export {
@@ -172,6 +250,11 @@ export {
   CrashLensFilter,
   CrashLensInterceptor,
   CrashLensModule,
+  CrashLensScopeMiddleware,
   CrashLensService,
-  initNode2 as initNode
+  defaultResolveUser,
+  getHttpRequestContext,
+  initNode2 as initNode,
+  runWithScope2 as runWithScope,
+  withIsolationScope
 };

package/package.json

@@ -1,39 +1,39 @@
-{
-  "name": "@crashlensorg/nestjs",
-  "version": "0.1.0",
-  "description": "CrashLens integração com NestJS — módulo, filtro global de exceções e interceptor HTTP",
-  "license": "MIT",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    }
-  },
-  "files": ["dist"],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external @nestjs/common --external @nestjs/core --external @nestjs/platform-express --external @nestjs/websockets --external @nestjs/microservices --external rxjs --external reflect-metadata",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@crashlensorg/node": "0.1.0"
-  },
-  "peerDependencies": {
-    "@nestjs/common": "^9.0.0 || ^10.0.0 || ^11.0.0",
-    "reflect-metadata": "^0.2.0",
-    "rxjs": "^7.0.0"
-  },
-  "devDependencies": {
-    "@nestjs/common": "^10.4.0",
-    "@nestjs/core": "^10.4.0",
-    "reflect-metadata": "^0.2.2",
-    "rxjs": "^7.8.0"
-  },
-  "keywords": ["crashlens", "nestjs", "error-monitoring", "crash-reporting", "sentry-alternative"]
+{
+  "name": "@crashlensorg/nestjs",
+  "version": "0.3.0",
+  "description": "CrashLens integração com NestJS — módulo, filtro global de exceções e interceptor HTTP",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean --external @nestjs/common --external @nestjs/core --external @nestjs/platform-express --external @nestjs/websockets --external @nestjs/microservices --external rxjs --external reflect-metadata",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@crashlensorg/node": "0.3.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^9.0.0 || ^10.0.0 || ^11.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.0.0"
+  },
+  "devDependencies": {
+    "@nestjs/common": "^10.4.0",
+    "@nestjs/core": "^10.4.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.0"
+  },
+  "keywords": ["crashlens", "nestjs", "error-monitoring", "crash-reporting", "sentry-alternative"]
 }