@interfere/nest 0.0.1-canary.0

package/README.md

@@ -0,0 +1,30 @@
+# @interfere/nest
+
+> **Status: canary.** Pre-1.0 API, expect breaking changes. Pin to a specific `10.0.0-canary.N` in CI.
+
+NestJS SDK for [Interfere](https://interfere.com). Wraps [`@interfere/node`](../node) with a global exception filter and OTel auto-instrumentation for controllers, guards, pipes, interceptors, and middleware.
+
+## Install
+
+```sh
+bun add @interfere/nest
+```
+
+## Usage
+
+```ts
+// instrument.ts — imported first in main.ts, before any @nestjs/* import
+import { init } from "@interfere/nest";
+await init({ serviceName: "my-api" });
+```
+
+```ts
+// app.module.ts
+import { Module } from "@nestjs/common";
+import { InterfereModule } from "@interfere/nest";
+
+@Module({ imports: [InterfereModule.forRoot()] })
+export class AppModule {}
+```
+
+Set `INTERFERE_API_KEY` in the environment. Full docs at <https://interfere.com/docs>.

package/dist/_virtual/_@oxc-project_runtime@0.129.0/helpers/decorate.mjs

@@ -0,0 +1,9 @@
+//#region \0@oxc-project+runtime@0.129.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+//#endregion
+export { __decorate };

package/dist/_virtual/_@oxc-project_runtime@0.129.0/helpers/decorateMetadata.mjs

@@ -0,0 +1,6 @@
+//#region \0@oxc-project+runtime@0.129.0/helpers/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+//#endregion
+export { __decorateMetadata };

package/dist/_virtual/_@oxc-project_runtime@0.129.0/helpers/decorateParam.mjs

@@ -0,0 +1,8 @@
+//#region \0@oxc-project+runtime@0.129.0/helpers/decorateParam.js
+function __decorateParam(paramIndex, decorator) {
+	return function(target, key) {
+		decorator(target, key, paramIndex);
+	};
+}
+//#endregion
+export { __decorateParam };

package/dist/exception-filter.d.mts

@@ -0,0 +1,18 @@
+import { ArgumentsHost, ExceptionFilter } from "@nestjs/common";
+import { BaseExceptionFilter, HttpAdapterHost } from "@nestjs/core";
+
+//#region src/exception-filter.d.ts
+/**
+ * Forwards uncaught exceptions to Interfere, then delegates to Nest's
+ * default response shaping. Skips `HttpException` with status 4xx —
+ * client-fault errors are framework-handled and shouldn't bill against
+ * crash dashboards.
+ */
+declare class InterfereExceptionFilter extends BaseExceptionFilter implements ExceptionFilter {
+  constructor(adapterHost?: HttpAdapterHost);
+  catch(exception: unknown, host: ArgumentsHost): void;
+  private shouldReport;
+  private extractRequest;
+}
+//#endregion
+export { InterfereExceptionFilter };

package/dist/exception-filter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.d.mts","names":[],"sources":["../src/exception-filter.ts"],"mappings":";;;;;;AAkBA;;;;cACa,wBAAA,SACH,mBAAA,YACG,eAAA;cAG4B,WAAA,GAAc,eAAA;EAK5C,KAAA,CAAM,SAAA,WAAoB,IAAA,EAAM,aAAA;EAAA,QAOjC,YAAA;EAAA,QAOA,cAAA;AAAA"}

package/dist/exception-filter.mjs

@@ -0,0 +1,33 @@
+import { __decorateMetadata } from "./_virtual/_@oxc-project_runtime@0.129.0/helpers/decorateMetadata.mjs";
+import { __decorateParam } from "./_virtual/_@oxc-project_runtime@0.129.0/helpers/decorateParam.mjs";
+import { __decorate } from "./_virtual/_@oxc-project_runtime@0.129.0/helpers/decorate.mjs";
+import { captureError } from "@interfere/node";
+import { Catch, HttpException, Inject, Optional } from "@nestjs/common";
+import { BaseExceptionFilter, HttpAdapterHost } from "@nestjs/core";
+//#region src/exception-filter.ts
+var _ref;
+let InterfereExceptionFilter = class InterfereExceptionFilter extends BaseExceptionFilter {
+	constructor(adapterHost) {
+		super(adapterHost?.httpAdapter);
+	}
+	catch(exception, host) {
+		if (this.shouldReport(exception)) captureError(exception, this.extractRequest(host));
+		super.catch(exception, host);
+	}
+	shouldReport(exception) {
+		if (exception instanceof HttpException) return exception.getStatus() >= 500;
+		return true;
+	}
+	extractRequest(host) {
+		if (host.getType() !== "http") return;
+		return host.switchToHttp().getRequest();
+	}
+};
+InterfereExceptionFilter = __decorate([
+	Catch(),
+	__decorateParam(0, Optional()),
+	__decorateParam(0, Inject(HttpAdapterHost)),
+	__decorateMetadata("design:paramtypes", [typeof (_ref = typeof HttpAdapterHost !== "undefined" && HttpAdapterHost) === "function" ? _ref : Object])
+], InterfereExceptionFilter);
+//#endregion
+export { InterfereExceptionFilter };

package/dist/exception-filter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.mjs","names":[],"sources":["../src/exception-filter.ts"],"sourcesContent":["import { captureError } from \"@interfere/node\";\n\nimport {\n  type ArgumentsHost,\n  Catch,\n  type ExceptionFilter,\n  HttpException,\n  Inject,\n  Optional,\n} from \"@nestjs/common\";\nimport { BaseExceptionFilter, HttpAdapterHost } from \"@nestjs/core\";\n\n/**\n * Forwards uncaught exceptions to Interfere, then delegates to Nest's\n * default response shaping. Skips `HttpException` with status 4xx —\n * client-fault errors are framework-handled and shouldn't bill against\n * crash dashboards.\n */\n@Catch()\nexport class InterfereExceptionFilter\n  extends BaseExceptionFilter\n  implements ExceptionFilter\n{\n  constructor(\n    @Optional() @Inject(HttpAdapterHost) adapterHost?: HttpAdapterHost\n  ) {\n    super(adapterHost?.httpAdapter);\n  }\n\n  override catch(exception: unknown, host: ArgumentsHost): void {\n    if (this.shouldReport(exception)) {\n      captureError(exception, this.extractRequest(host));\n    }\n    super.catch(exception, host);\n  }\n\n  private shouldReport(exception: unknown): boolean {\n    if (exception instanceof HttpException) {\n      return exception.getStatus() >= 500;\n    }\n    return true;\n  }\n\n  private extractRequest(host: ArgumentsHost): unknown {\n    if (host.getType() !== \"http\") {\n      return;\n    }\n    return host.switchToHttp().getRequest();\n  }\n}\n"],"mappings":";;;;;;;;AAmBO,IAAA,2BAAA,MAAM,iCACH,oBAEV;CACE,YACE,aACA;EACA,MAAM,aAAa,YAAY;;CAGjC,MAAe,WAAoB,MAA2B;EAC5D,IAAI,KAAK,aAAa,UAAU,EAC9B,aAAa,WAAW,KAAK,eAAe,KAAK,CAAC;EAEpD,MAAM,MAAM,WAAW,KAAK;;CAG9B,aAAqB,WAA6B;EAChD,IAAI,qBAAqB,eACvB,OAAO,UAAU,WAAW,IAAI;EAElC,OAAO;;CAGT,eAAuB,MAA8B;EACnD,IAAI,KAAK,SAAS,KAAK,QACrB;EAEF,OAAO,KAAK,cAAc,CAAC,YAAY;;;;CA7B1C,OAAO;oBAMH,UAAU,CAAA;oBAAE,OAAO,gBAAgB,CAAA"}

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+import { InterfereExceptionFilter } from "./exception-filter.mjs";
+import { InitOptions, init } from "./init.mjs";
+import { InterfereModule } from "./module.mjs";
+import { CaptureErrorContext, captureError, captureMessage, close, flush, withSpan } from "@interfere/node";
+export { type CaptureErrorContext, type InitOptions, InterfereExceptionFilter, InterfereModule, captureError, captureMessage, close, flush, init, withSpan };

package/dist/index.mjs

@@ -0,0 +1,5 @@
+import { InterfereExceptionFilter } from "./exception-filter.mjs";
+import { init } from "./init.mjs";
+import { InterfereModule } from "./module.mjs";
+import { captureError, captureMessage, close, flush, withSpan } from "@interfere/node";
+export { InterfereExceptionFilter, InterfereModule, captureError, captureMessage, close, flush, init, withSpan };

package/dist/init.d.mts

@@ -0,0 +1,13 @@
+import { InitOptions, InitOptions as InitOptions$1 } from "@interfere/node";
+
+//#region src/init.d.ts
+/**
+ * Bootstraps `@interfere/node` and registers
+ * `@opentelemetry/instrumentation-nestjs-core` for auto-spans across
+ * controllers, guards, pipes, interceptors, and middleware. Must run
+ * before `@nestjs/core` is imported — see the README for the
+ * `instrument.ts` pattern.
+ */
+declare function init(options?: InitOptions$1): Promise<void>;
+//#endregion
+export { type InitOptions, init };

package/dist/init.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.mts","names":[],"sources":["../src/init.ts"],"mappings":";;;;;AAcA;;;;;iBAAsB,IAAA,CAAK,OAAA,GAAS,aAAA,GAAmB,OAAA"}

package/dist/init.mjs

@@ -0,0 +1,21 @@
+import { init as init$1 } from "@interfere/node";
+import { registerInstrumentations } from "@opentelemetry/instrumentation";
+import { NestInstrumentation } from "@opentelemetry/instrumentation-nestjs-core";
+//#region src/init.ts
+let instrumented = false;
+/**
+* Bootstraps `@interfere/node` and registers
+* `@opentelemetry/instrumentation-nestjs-core` for auto-spans across
+* controllers, guards, pipes, interceptors, and middleware. Must run
+* before `@nestjs/core` is imported — see the README for the
+* `instrument.ts` pattern.
+*/
+async function init(options = {}) {
+	if (!instrumented) {
+		registerInstrumentations({ instrumentations: [new NestInstrumentation()] });
+		instrumented = true;
+	}
+	await init$1(options);
+}
+//#endregion
+export { init };

package/dist/init.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.mjs","names":["nodeInit"],"sources":["../src/init.ts"],"sourcesContent":["import { type InitOptions, init as nodeInit } from \"@interfere/node\";\n\nimport { registerInstrumentations } from \"@opentelemetry/instrumentation\";\nimport { NestInstrumentation } from \"@opentelemetry/instrumentation-nestjs-core\";\n\nlet instrumented = false;\n\n/**\n * Bootstraps `@interfere/node` and registers\n * `@opentelemetry/instrumentation-nestjs-core` for auto-spans across\n * controllers, guards, pipes, interceptors, and middleware. Must run\n * before `@nestjs/core` is imported — see the README for the\n * `instrument.ts` pattern.\n */\nexport async function init(options: InitOptions = {}): Promise<void> {\n  if (!instrumented) {\n    registerInstrumentations({\n      instrumentations: [new NestInstrumentation()],\n    });\n    instrumented = true;\n  }\n  await nodeInit(options);\n}\n\nexport type { InitOptions } from \"@interfere/node\";\n"],"mappings":";;;;AAKA,IAAI,eAAe;;;;;;;;AASnB,eAAsB,KAAK,UAAuB,EAAE,EAAiB;CACnE,IAAI,CAAC,cAAc;EACjB,yBAAyB,EACvB,kBAAkB,CAAC,IAAI,qBAAqB,CAAC,EAC9C,CAAC;EACF,eAAe;;CAEjB,MAAMA,OAAS,QAAQ"}

package/dist/module.d.mts

@@ -0,0 +1,13 @@
+import { DynamicModule } from "@nestjs/common";
+
+//#region src/module.d.ts
+/**
+ * Registers `InterfereExceptionFilter` as a global filter via
+ * `APP_FILTER`. Import once at the app root: `imports:
+ * [InterfereModule.forRoot()]`.
+ */
+declare class InterfereModule {
+  static forRoot(): DynamicModule;
+}
+//#endregion
+export { InterfereModule };

package/dist/module.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.mts","names":[],"sources":["../src/module.ts"],"mappings":";;;;;AAUA;;;cACa,eAAA;EAAA,OACJ,OAAA,CAAA,GAAW,aAAA;AAAA"}

package/dist/module.mjs

@@ -0,0 +1,20 @@
+import { __decorate } from "./_virtual/_@oxc-project_runtime@0.129.0/helpers/decorate.mjs";
+import { InterfereExceptionFilter } from "./exception-filter.mjs";
+import { Module } from "@nestjs/common";
+import { APP_FILTER } from "@nestjs/core";
+//#region src/module.ts
+var _InterfereModule;
+let InterfereModule = _InterfereModule = class InterfereModule {
+	static forRoot() {
+		return {
+			module: _InterfereModule,
+			providers: [{
+				provide: APP_FILTER,
+				useClass: InterfereExceptionFilter
+			}]
+		};
+	}
+};
+InterfereModule = _InterfereModule = __decorate([Module({})], InterfereModule);
+//#endregion
+export { InterfereModule };

package/dist/module.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.mjs","names":[],"sources":["../src/module.ts"],"sourcesContent":["import { type DynamicModule, Module } from \"@nestjs/common\";\nimport { APP_FILTER } from \"@nestjs/core\";\n\nimport { InterfereExceptionFilter } from \"./exception-filter.js\";\n\n/**\n * Registers `InterfereExceptionFilter` as a global filter via\n * `APP_FILTER`. Import once at the app root: `imports:\n * [InterfereModule.forRoot()]`.\n */\n@Module({})\nexport class InterfereModule {\n  static forRoot(): DynamicModule {\n    return {\n      module: InterfereModule,\n      providers: [\n        {\n          provide: APP_FILTER,\n          useClass: InterfereExceptionFilter,\n        },\n      ],\n    };\n  }\n}\n"],"mappings":";;;;;;AAWO,IAAA,kBAAA,mBAAA,MAAM,gBAAgB;CAC3B,OAAO,UAAyB;EAC9B,OAAO;GACL,QAAA;GACA,WAAW,CACT;IACE,SAAS;IACT,UAAU;IACX,CACF;GACF;;;iDAXJ,OAAO,EAAE,CAAC,CAAA,EAAA,gBAAA"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@interfere/nest",
+  "version": "0.0.1-canary.0",
+  "license": "MIT",
+  "description": "NestJS SDK for Interfere. Auto-captures uncaught exceptions from controllers, providers, and middleware via a global ExceptionFilter, plus re-exports the @interfere/node OTel instrumentation.",
+  "keywords": [
+    "observability",
+    "typescript",
+    "nestjs",
+    "nest",
+    "error-tracking",
+    "opentelemetry"
+  ],
+  "homepage": "https://interfere.com",
+  "bugs": {
+    "url": "mailto:support@interfere.com"
+  },
+  "author": "Interfere <support@interfere.com> (https://interfere.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/interfere-inc/interfere.git",
+    "directory": "src/packages/public/nest"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "@source": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "tag": "canary"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit --incremental"
+  },
+  "dependencies": {
+    "@interfere/node": "^0.0.1-canary.0",
+    "@opentelemetry/instrumentation": "^0.217.0",
+    "@opentelemetry/instrumentation-nestjs-core": "^0.63.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^10 || ^11",
+    "@nestjs/core": "^10 || ^11"
+  },
+  "devDependencies": {
+    "@interfere/test-utils": "^9.0.0",
+    "@interfere/typescript-config": "^9.0.0",
+    "@nestjs/common": "^11",
+    "@nestjs/core": "^11",
+    "@types/node": "^24.12.0",
+    "@vitest/coverage-v8": "^4.1.6",
+    "reflect-metadata": "^0.2",
+    "tsdown": "^0.22.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  }
+}