@crashlensorg/nestjs 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,70 @@
+import { DynamicModule, ExceptionFilter, ArgumentsHost, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { NodeInitOptions, CrashLens } from '@crashlensorg/node';
+export { Breadcrumb, CaptureParams, CrashLens, CrashLensUser, CrashOptions, DeviceInfo, NodeInitOptions, Severity, initNode } from '@crashlensorg/node';
+import { BaseExceptionFilter } from '@nestjs/core';
+import { Observable } from 'rxjs';
+
+interface CrashLensConfig extends NodeInitOptions {
+    /** URL base da API CrashLens. */
+    baseUrl?: string;
+    /** Versão da release do app. */
+    release?: string;
+    /** Ambiente: "production", "staging", etc. */
+    environment?: string;
+    /** Tags globais. */
+    tags?: Record<string, unknown>;
+    /** Extra global. */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Serviço que mantém o cliente CrashLens e expõe a API de captura.
+ * Pode ser injetado em qualquer controller/service.
+ */
+declare class CrashLensService {
+    private readonly client?;
+    constructor(options?: CrashLensConfig);
+    get isInitialized(): boolean;
+    captureException(error: unknown, params?: Parameters<CrashLens['captureException']>[1]): void;
+    captureMessage(message: string, params?: Parameters<CrashLens['captureMessage']>[1]): void;
+    captureEvent(params: Parameters<CrashLens['captureEvent']>[0]): void;
+    addBreadcrumb(breadcrumb: Parameters<CrashLens['addBreadcrumb']>[0]): void;
+    setUser(user: Parameters<CrashLens['setUser']>[0]): void;
+    setTag(key: string, value: unknown): void;
+    get clientInstance(): CrashLens | undefined;
+}
+
+interface CrashLensModuleOptions extends CrashLensConfig {
+    /** Registra o filtro global de exceções (padrão: true). */
+    globalFilter?: boolean;
+    /** Registra o interceptor global de requests (padrão: true). */
+    globalInterceptor?: boolean;
+}
+/**
+ * Módulo do CrashLens para NestJS.
+ *
+ * @Module({ imports: [CrashLensModule.forRoot({ apiKey: 'cl_live_xxx' }) ] })
+ */
+declare class CrashLensModule {
+    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.
+ */
+declare class CrashLensFilter extends BaseExceptionFilter implements ExceptionFilter {
+    private readonly crashLens;
+    constructor(crashLens: CrashLensService);
+    catch(exception: unknown, host: ArgumentsHost): void;
+}
+
+/**
+ * Interceptor que adiciona breadcrumbs de request e captura erros dos handlers.
+ */
+declare class CrashLensInterceptor implements NestInterceptor {
+    private readonly crashLens;
+    constructor(crashLens: CrashLensService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+
+export { type CrashLensConfig, CrashLensFilter, CrashLensInterceptor, CrashLensModule, type CrashLensModuleOptions, CrashLensService };

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import { DynamicModule, ExceptionFilter, ArgumentsHost, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { NodeInitOptions, CrashLens } from '@crashlensorg/node';
+export { Breadcrumb, CaptureParams, CrashLens, CrashLensUser, CrashOptions, DeviceInfo, NodeInitOptions, Severity, initNode } from '@crashlensorg/node';
+import { BaseExceptionFilter } from '@nestjs/core';
+import { Observable } from 'rxjs';
+
+interface CrashLensConfig extends NodeInitOptions {
+    /** URL base da API CrashLens. */
+    baseUrl?: string;
+    /** Versão da release do app. */
+    release?: string;
+    /** Ambiente: "production", "staging", etc. */
+    environment?: string;
+    /** Tags globais. */
+    tags?: Record<string, unknown>;
+    /** Extra global. */
+    extra?: Record<string, unknown>;
+}
+/**
+ * Serviço que mantém o cliente CrashLens e expõe a API de captura.
+ * Pode ser injetado em qualquer controller/service.
+ */
+declare class CrashLensService {
+    private readonly client?;
+    constructor(options?: CrashLensConfig);
+    get isInitialized(): boolean;
+    captureException(error: unknown, params?: Parameters<CrashLens['captureException']>[1]): void;
+    captureMessage(message: string, params?: Parameters<CrashLens['captureMessage']>[1]): void;
+    captureEvent(params: Parameters<CrashLens['captureEvent']>[0]): void;
+    addBreadcrumb(breadcrumb: Parameters<CrashLens['addBreadcrumb']>[0]): void;
+    setUser(user: Parameters<CrashLens['setUser']>[0]): void;
+    setTag(key: string, value: unknown): void;
+    get clientInstance(): CrashLens | undefined;
+}
+
+interface CrashLensModuleOptions extends CrashLensConfig {
+    /** Registra o filtro global de exceções (padrão: true). */
+    globalFilter?: boolean;
+    /** Registra o interceptor global de requests (padrão: true). */
+    globalInterceptor?: boolean;
+}
+/**
+ * Módulo do CrashLens para NestJS.
+ *
+ * @Module({ imports: [CrashLensModule.forRoot({ apiKey: 'cl_live_xxx' }) ] })
+ */
+declare class CrashLensModule {
+    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.
+ */
+declare class CrashLensFilter extends BaseExceptionFilter implements ExceptionFilter {
+    private readonly crashLens;
+    constructor(crashLens: CrashLensService);
+    catch(exception: unknown, host: ArgumentsHost): void;
+}
+
+/**
+ * Interceptor que adiciona breadcrumbs de request e captura erros dos handlers.
+ */
+declare class CrashLensInterceptor implements NestInterceptor {
+    private readonly crashLens;
+    constructor(crashLens: CrashLensService);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<unknown>;
+}
+
+export { type CrashLensConfig, CrashLensFilter, CrashLensInterceptor, CrashLensModule, type CrashLensModuleOptions, CrashLensService };

package/dist/index.js

@@ -0,0 +1,206 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CrashLens: () => import_node3.CrashLens,
+  CrashLensFilter: () => CrashLensFilter,
+  CrashLensInterceptor: () => CrashLensInterceptor,
+  CrashLensModule: () => CrashLensModule,
+  CrashLensService: () => CrashLensService,
+  initNode: () => import_node2.initNode
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/crash-lens.module.ts
+var import_common4 = 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");
+var CrashLensService = class {
+  constructor(options) {
+    if (!options) return;
+    this.client = (0, import_node.initNode)({
+      ...options,
+      enableGlobalHandlers: options.enableGlobalHandlers ?? false,
+      collectRuntimeInfo: options.collectRuntimeInfo ?? true,
+      enableSessionTracking: options.enableSessionTracking ?? false
+    });
+    if (options.tags) {
+      for (const [k, v] of Object.entries(options.tags)) {
+        this.client.setTag(k, v);
+      }
+    }
+    if (options.extra) {
+      for (const [k, v] of Object.entries(options.extra)) {
+        this.client.setExtra(k, v);
+      }
+    }
+  }
+  get isInitialized() {
+    return this.client?.isInitialized ?? false;
+  }
+  captureException(error, params) {
+    this.client?.captureException(error, params);
+  }
+  captureMessage(message, params) {
+    this.client?.captureMessage(message, params);
+  }
+  captureEvent(params) {
+    this.client?.captureEvent(params);
+  }
+  addBreadcrumb(breadcrumb) {
+    this.client?.addBreadcrumb(breadcrumb);
+  }
+  setUser(user) {
+    this.client?.setUser(user);
+  }
+  setTag(key, value) {
+    this.client?.setTag(key, value);
+  }
+  get clientInstance() {
+    return this.client;
+  }
+};
+CrashLensService = __decorateClass([
+  (0, import_common.Injectable)(),
+  __decorateParam(0, (0, import_common.Optional)()),
+  __decorateParam(0, (0, import_common.Inject)(CRASH_LENS_OPTIONS))
+], CrashLensService);
+
+// src/crash-lens.filter.ts
+var import_common2 = require("@nestjs/common");
+var import_core = require("@nestjs/core");
+var CrashLensFilter = class extends import_core.BaseExceptionFilter {
+  constructor(crashLens) {
+    super();
+    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
+      }
+    });
+    super.catch(exception, host);
+  }
+};
+CrashLensFilter = __decorateClass([
+  (0, import_common2.Catch)()
+], CrashLensFilter);
+
+// 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 }
+      });
+    }
+    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))
+    );
+  }
+};
+CrashLensInterceptor = __decorateClass([
+  (0, import_common3.Injectable)()
+], CrashLensInterceptor);
+
+// src/crash-lens.module.ts
+var CRASH_LENS_OPTIONS = /* @__PURE__ */ Symbol("CRASH_LENS_OPTIONS");
+var CrashLensModule = class {
+  static forRoot(options) {
+    const providers = [
+      { provide: CRASH_LENS_OPTIONS, useValue: options },
+      CrashLensService
+    ];
+    if (options.globalFilter !== false) {
+      providers.push({ provide: import_core2.APP_FILTER, useClass: CrashLensFilter });
+    }
+    if (options.globalInterceptor !== false) {
+      providers.push({ provide: import_core2.APP_INTERCEPTOR, useClass: CrashLensInterceptor });
+    }
+    return {
+      module: CrashLensModule,
+      global: true,
+      providers,
+      exports: [CrashLensService]
+    };
+  }
+};
+CrashLensModule = __decorateClass([
+  (0, import_common4.Global)()
+], CrashLensModule);
+
+// src/index.ts
+var import_node2 = require("@crashlensorg/node");
+var import_node3 = require("@crashlensorg/node");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CrashLens,
+  CrashLensFilter,
+  CrashLensInterceptor,
+  CrashLensModule,
+  CrashLensService,
+  initNode
+});

package/dist/index.mjs

@@ -0,0 +1,177 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// src/crash-lens.module.ts
+import { Global } from "@nestjs/common";
+import { APP_FILTER, APP_INTERCEPTOR } from "@nestjs/core";
+
+// src/crash-lens.service.ts
+import { Inject, Injectable, Optional } from "@nestjs/common";
+import { initNode } from "@crashlensorg/node";
+var CrashLensService = class {
+  constructor(options) {
+    if (!options) return;
+    this.client = initNode({
+      ...options,
+      enableGlobalHandlers: options.enableGlobalHandlers ?? false,
+      collectRuntimeInfo: options.collectRuntimeInfo ?? true,
+      enableSessionTracking: options.enableSessionTracking ?? false
+    });
+    if (options.tags) {
+      for (const [k, v] of Object.entries(options.tags)) {
+        this.client.setTag(k, v);
+      }
+    }
+    if (options.extra) {
+      for (const [k, v] of Object.entries(options.extra)) {
+        this.client.setExtra(k, v);
+      }
+    }
+  }
+  get isInitialized() {
+    return this.client?.isInitialized ?? false;
+  }
+  captureException(error, params) {
+    this.client?.captureException(error, params);
+  }
+  captureMessage(message, params) {
+    this.client?.captureMessage(message, params);
+  }
+  captureEvent(params) {
+    this.client?.captureEvent(params);
+  }
+  addBreadcrumb(breadcrumb) {
+    this.client?.addBreadcrumb(breadcrumb);
+  }
+  setUser(user) {
+    this.client?.setUser(user);
+  }
+  setTag(key, value) {
+    this.client?.setTag(key, value);
+  }
+  get clientInstance() {
+    return this.client;
+  }
+};
+CrashLensService = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Optional()),
+  __decorateParam(0, Inject(CRASH_LENS_OPTIONS))
+], CrashLensService);
+
+// src/crash-lens.filter.ts
+import { Catch, HttpException, HttpStatus } from "@nestjs/common";
+import { BaseExceptionFilter } from "@nestjs/core";
+var CrashLensFilter = class extends BaseExceptionFilter {
+  constructor(crashLens) {
+    super();
+    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
+      }
+    });
+    super.catch(exception, host);
+  }
+};
+CrashLensFilter = __decorateClass([
+  Catch()
+], CrashLensFilter);
+
+// 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 }
+      });
+    }
+    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))
+    );
+  }
+};
+CrashLensInterceptor = __decorateClass([
+  Injectable2()
+], CrashLensInterceptor);
+
+// src/crash-lens.module.ts
+var CRASH_LENS_OPTIONS = /* @__PURE__ */ Symbol("CRASH_LENS_OPTIONS");
+var CrashLensModule = class {
+  static forRoot(options) {
+    const providers = [
+      { provide: CRASH_LENS_OPTIONS, useValue: options },
+      CrashLensService
+    ];
+    if (options.globalFilter !== false) {
+      providers.push({ provide: APP_FILTER, useClass: CrashLensFilter });
+    }
+    if (options.globalInterceptor !== false) {
+      providers.push({ provide: APP_INTERCEPTOR, useClass: CrashLensInterceptor });
+    }
+    return {
+      module: CrashLensModule,
+      global: true,
+      providers,
+      exports: [CrashLensService]
+    };
+  }
+};
+CrashLensModule = __decorateClass([
+  Global()
+], CrashLensModule);
+
+// src/index.ts
+import { initNode as initNode2 } from "@crashlensorg/node";
+import { CrashLens as CrashLens2 } from "@crashlensorg/node";
+export {
+  CrashLens2 as CrashLens,
+  CrashLensFilter,
+  CrashLensInterceptor,
+  CrashLensModule,
+  CrashLensService,
+  initNode2 as initNode
+};

package/package.json

@@ -0,0 +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"]
+}