@interfere/nest 0.0.1-canary.2 → 0.0.1-canary.4

package/README.md

@@ -13,9 +13,9 @@ bun add @interfere/nest
 ## Usage
 
 ```ts
-// instrument.ts — imported first in main.ts, before any @nestjs/* import
+// instrument.ts — must run before @nestjs/core is imported
 import { init } from "@interfere/nest";
-init({ serviceName: "my-api" });
+init({ serviceName: "my-api", debug: true });
 ```
 
 ```ts
@@ -40,4 +40,24 @@ import { InterfereModule } from "@interfere/nest";
 export class AppModule {}
 ```
 
-Set `INTERFERE_PUBLIC_KEY` to your surface's `interfere_pk_*` public key. Full docs at <https://interfere.com/docs>.
+## Build & Deploy
+
+Add a `postbuild` script so source maps are uploaded and the release is registered with the collector:
+
+```json
+{
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "interfere sourcemaps upload ./dist"
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Where | Purpose |
+|---|---|---|
+| `INTERFERE_PUBLIC_KEY` | Runtime | Routes spans to your surface (`interfere_pk_*`) |
+| `INTERFERE_API_KEY` | CI / Build | Uploads source maps and registers releases (`interfere_ak_*`) |
+
+Full docs at <https://interfere.com/docs>.

package/dist/init.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_package=require("./package.cjs");let _interfere_node=require("@interfere/node"),_opentelemetry_instrumentation=require("@opentelemetry/instrumentation"),_opentelemetry_instrumentation_nestjs_core=require("@opentelemetry/instrumentation-nestjs-core"),instrumented=!1;function init(options={}){instrumented||=((0,_opentelemetry_instrumentation.registerInstrumentations)({instrumentations:[new _opentelemetry_instrumentation_nestjs_core.NestInstrumentation]}),!0),(0,_interfere_node.init)(options),options.debug&&console.log(`[interfere] ${require_package.name}@${require_package.version} initialized`)}exports.init=init;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_nest_instrumentation=require("./nest-instrumentation.cjs");let _interfere_node=require("@interfere/node"),node_module=require("node:module"),_opentelemetry_instrumentation=require("@opentelemetry/instrumentation"),_opentelemetry_instrumentation_nestjs_core=require("@opentelemetry/instrumentation-nestjs-core");const INIT_KEY=`__interfereNestInitialized__`,g=globalThis;function init(options={}){g[INIT_KEY]||(typeof node_module.register==`function`&&(0,node_module.register)(`import-in-the-middle/hook.mjs`,require("url").pathToFileURL(__filename).href),(0,_interfere_node.init)(options),(0,_opentelemetry_instrumentation.registerInstrumentations)({instrumentations:[new _opentelemetry_instrumentation_nestjs_core.NestInstrumentation,new require_nest_instrumentation.InterfereNestInstrumentation]}),g[INIT_KEY]=!0)}exports.init=init;

package/dist/init.d.cts

@@ -1,22 +1,21 @@
-import { InitOptions as InitOptions$1 } from "@interfere/node";
+import { InitOptions, InitOptions as InitOptions$1 } from "@interfere/node";
 
 //#region src/init.d.ts
-interface InitOptions extends InitOptions$1 {
-  /**
-   * Log a one-line confirmation to `stdout` on successful init.
-   * Useful during integration to verify the SDK is wired up.
-   * Default `false`.
-   */
-  readonly debug?: boolean;
-}
 /**
- * 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.
+ * Bootstraps `@interfere/node` and registers auto-instrumentation for
+ * NestJS controllers, guards, pipes, interceptors, and middleware.
+ *
+ * Uses two complementary instrumentation strategies:
+ * - `@opentelemetry/instrumentation-nestjs-core` for NestFactory and
+ *   router-level spans (when RITM hooks engage)
+ * - `InterfereNestInstrumentation` which patches `@Injectable` to wrap
+ *   middleware, guards, pipes, and interceptors at the decorator level
+ *   (always works, no RITM dependency for nested paths)
+ *
+ * Registers ESM loader hooks via `module.register()` so that
+ * `@nestjs/common` imports are intercepted for auto-instrumentation.
  */
-declare function init(options?: InitOptions): void;
+declare function init(options?: InitOptions$1): void;
 //#endregion
-export { InitOptions, init };
+export { type InitOptions, init };
 //# sourceMappingURL=init.d.cts.map

package/dist/init.d.mts

@@ -1,22 +1,21 @@
-import { InitOptions as InitOptions$1 } from "@interfere/node";
+import { InitOptions, InitOptions as InitOptions$1 } from "@interfere/node";
 
 //#region src/init.d.ts
-interface InitOptions extends InitOptions$1 {
-  /**
-   * Log a one-line confirmation to `stdout` on successful init.
-   * Useful during integration to verify the SDK is wired up.
-   * Default `false`.
-   */
-  readonly debug?: boolean;
-}
 /**
- * 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.
+ * Bootstraps `@interfere/node` and registers auto-instrumentation for
+ * NestJS controllers, guards, pipes, interceptors, and middleware.
+ *
+ * Uses two complementary instrumentation strategies:
+ * - `@opentelemetry/instrumentation-nestjs-core` for NestFactory and
+ *   router-level spans (when RITM hooks engage)
+ * - `InterfereNestInstrumentation` which patches `@Injectable` to wrap
+ *   middleware, guards, pipes, and interceptors at the decorator level
+ *   (always works, no RITM dependency for nested paths)
+ *
+ * Registers ESM loader hooks via `module.register()` so that
+ * `@nestjs/common` imports are intercepted for auto-instrumentation.
  */
-declare function init(options?: InitOptions): void;
+declare function init(options?: InitOptions$1): void;
 //#endregion
-export { InitOptions, init };
+export { type InitOptions, init };
 //# sourceMappingURL=init.d.mts.map

package/dist/init.mjs

@@ -1,2 +1,2 @@
-import{name,version}from"./package.mjs";import{init as init$1}from"@interfere/node";import{registerInstrumentations}from"@opentelemetry/instrumentation";import{NestInstrumentation}from"@opentelemetry/instrumentation-nestjs-core";let instrumented=!1;function init(options={}){instrumented||=(registerInstrumentations({instrumentations:[new NestInstrumentation]}),!0),init$1(options),options.debug&&console.log(`[interfere] ${name}@${version} initialized`)}export{init};
+import{InterfereNestInstrumentation}from"./nest-instrumentation.mjs";import{register}from"node:module";import{init as init$1}from"@interfere/node";import{registerInstrumentations}from"@opentelemetry/instrumentation";import{NestInstrumentation}from"@opentelemetry/instrumentation-nestjs-core";const INIT_KEY=`__interfereNestInitialized__`,g=globalThis;function init(options={}){g[INIT_KEY]||(typeof register==`function`&&register(`import-in-the-middle/hook.mjs`,import.meta.url),init$1(options),registerInstrumentations({instrumentations:[new NestInstrumentation,new InterfereNestInstrumentation]}),g[INIT_KEY]=!0)}export{init};
 //# sourceMappingURL=init.mjs.map

package/dist/nest-instrumentation.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_package=require("./package.cjs");let _opentelemetry_instrumentation=require("@opentelemetry/instrumentation"),_opentelemetry_api=require("@opentelemetry/api");const SUPPORTED_VERSIONS=[`>=8.0.0 <12`],COMPONENT=`@nestjs/common`;var InterfereNestInstrumentation=class extends _opentelemetry_instrumentation.InstrumentationBase{constructor(config={}){super(require_package.name,require_package.version,config)}init(){let moduleDef=new _opentelemetry_instrumentation.InstrumentationNodeModuleDefinition(COMPONENT,SUPPORTED_VERSIONS);return moduleDef.files.push(this.getInjectableInstrumentation(SUPPORTED_VERSIONS)),moduleDef}getInjectableInstrumentation(versions){return new _opentelemetry_instrumentation.InstrumentationNodeModuleFile(`@nestjs/common/decorators/core/injectable.decorator.js`,versions,moduleExports=>((0,_opentelemetry_instrumentation.isWrapped)(moduleExports.Injectable)&&this._unwrap(moduleExports,`Injectable`),this._wrap(moduleExports,`Injectable`,original=>this.wrapInjectable(original)),moduleExports),moduleExports=>{this._unwrap(moduleExports,`Injectable`)})}wrapInjectable(original){let tracer=this.tracer;return function(options){return target=>target.__INTERFERE_PATCHED__?original(options)(target):(target.__INTERFERE_PATCHED__=!0,typeof target.prototype.use==`function`&&patchMethod(tracer,target,`use`,`middleware.nestjs`),typeof target.prototype.canActivate==`function`&&patchMethod(tracer,target,`canActivate`,`guard.nestjs`),typeof target.prototype.transform==`function`&&patchMethod(tracer,target,`transform`,`pipe.nestjs`),typeof target.prototype.intercept==`function`&&patchMethod(tracer,target,`intercept`,`interceptor.nestjs`),original(options)(target))}}};function patchMethod(tracer,target,method,op){let original=target.prototype[method];target.prototype[method]=function(...args){let span=tracer.startSpan(`${target.name}.${method}`,{kind:_opentelemetry_api.SpanKind.INTERNAL,attributes:{component:COMPONENT,"nestjs.type":op,"nestjs.callback":method,"nestjs.controller":target.name}}),ctx=_opentelemetry_api.trace.setSpan(_opentelemetry_api.context.active(),span);return _opentelemetry_api.context.with(ctx,()=>{try{let result=original.apply(this,args);return result&&typeof result.then==`function`?result.then(v=>(span.end(),v),err=>{throw span.recordException(err),span.setStatus({code:_opentelemetry_api.SpanStatusCode.ERROR}),span.end(),err}):(span.end(),result)}catch(err){throw span.recordException(err),span.setStatus({code:_opentelemetry_api.SpanStatusCode.ERROR}),span.end(),err}})}}exports.InterfereNestInstrumentation=InterfereNestInstrumentation;

package/dist/nest-instrumentation.d.cts

@@ -0,0 +1,12 @@
+import { InstrumentationBase, InstrumentationConfig, InstrumentationNodeModuleDefinition } from "@opentelemetry/instrumentation";
+
+//#region src/nest-instrumentation.d.ts
+declare class InterfereNestInstrumentation extends InstrumentationBase {
+  constructor(config?: InstrumentationConfig);
+  init(): InstrumentationNodeModuleDefinition;
+  private getInjectableInstrumentation;
+  private wrapInjectable;
+}
+//#endregion
+export { InterfereNestInstrumentation };
+//# sourceMappingURL=nest-instrumentation.d.cts.map

package/dist/nest-instrumentation.d.mts

@@ -0,0 +1,12 @@
+import { InstrumentationBase, InstrumentationConfig, InstrumentationNodeModuleDefinition } from "@opentelemetry/instrumentation";
+
+//#region src/nest-instrumentation.d.ts
+declare class InterfereNestInstrumentation extends InstrumentationBase {
+  constructor(config?: InstrumentationConfig);
+  init(): InstrumentationNodeModuleDefinition;
+  private getInjectableInstrumentation;
+  private wrapInjectable;
+}
+//#endregion
+export { InterfereNestInstrumentation };
+//# sourceMappingURL=nest-instrumentation.d.mts.map

package/dist/nest-instrumentation.mjs

@@ -0,0 +1,2 @@
+import{name,version}from"./package.mjs";import{InstrumentationBase,InstrumentationNodeModuleDefinition,InstrumentationNodeModuleFile,isWrapped}from"@opentelemetry/instrumentation";import{SpanKind,SpanStatusCode,context,trace}from"@opentelemetry/api";const SUPPORTED_VERSIONS=[`>=8.0.0 <12`],COMPONENT=`@nestjs/common`;var InterfereNestInstrumentation=class extends InstrumentationBase{constructor(config={}){super(name,version,config)}init(){let moduleDef=new InstrumentationNodeModuleDefinition(COMPONENT,SUPPORTED_VERSIONS);return moduleDef.files.push(this.getInjectableInstrumentation(SUPPORTED_VERSIONS)),moduleDef}getInjectableInstrumentation(versions){return new InstrumentationNodeModuleFile(`@nestjs/common/decorators/core/injectable.decorator.js`,versions,moduleExports=>(isWrapped(moduleExports.Injectable)&&this._unwrap(moduleExports,`Injectable`),this._wrap(moduleExports,`Injectable`,original=>this.wrapInjectable(original)),moduleExports),moduleExports=>{this._unwrap(moduleExports,`Injectable`)})}wrapInjectable(original){let tracer=this.tracer;return function(options){return target=>target.__INTERFERE_PATCHED__?original(options)(target):(target.__INTERFERE_PATCHED__=!0,typeof target.prototype.use==`function`&&patchMethod(tracer,target,`use`,`middleware.nestjs`),typeof target.prototype.canActivate==`function`&&patchMethod(tracer,target,`canActivate`,`guard.nestjs`),typeof target.prototype.transform==`function`&&patchMethod(tracer,target,`transform`,`pipe.nestjs`),typeof target.prototype.intercept==`function`&&patchMethod(tracer,target,`intercept`,`interceptor.nestjs`),original(options)(target))}}};function patchMethod(tracer,target,method,op){let original=target.prototype[method];target.prototype[method]=function(...args){let span=tracer.startSpan(`${target.name}.${method}`,{kind:SpanKind.INTERNAL,attributes:{component:COMPONENT,"nestjs.type":op,"nestjs.callback":method,"nestjs.controller":target.name}}),ctx=trace.setSpan(context.active(),span);return context.with(ctx,()=>{try{let result=original.apply(this,args);return result&&typeof result.then==`function`?result.then(v=>(span.end(),v),err=>{throw span.recordException(err),span.setStatus({code:SpanStatusCode.ERROR}),span.end(),err}):(span.end(),result)}catch(err){throw span.recordException(err),span.setStatus({code:SpanStatusCode.ERROR}),span.end(),err}})}}export{InterfereNestInstrumentation};
+//# sourceMappingURL=nest-instrumentation.mjs.map

package/dist/package.cjs

@@ -1 +1 @@
-var name=`@interfere/nest`,version=`0.0.1-canary.2`;Object.defineProperty(exports,"name",{enumerable:!0,get:function(){return name}}),Object.defineProperty(exports,"version",{enumerable:!0,get:function(){return version}});
+var name=`@interfere/nest`,version=`0.0.1-canary.4`;Object.defineProperty(exports,"name",{enumerable:!0,get:function(){return name}}),Object.defineProperty(exports,"version",{enumerable:!0,get:function(){return version}});

package/dist/package.mjs

@@ -1,2 +1,2 @@
-var name=`@interfere/nest`,version=`0.0.1-canary.2`;export{name,version};
+var name=`@interfere/nest`,version=`0.0.1-canary.4`;export{name,version};
 //# sourceMappingURL=package.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@interfere/nest",
-  "version": "0.0.1-canary.2",
+  "version": "0.0.1-canary.4",
   "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": [
@@ -55,7 +55,8 @@
     "typecheck": "tsc --noEmit --incremental"
   },
   "dependencies": {
-    "@interfere/node": "^0.0.1-canary.2",
+    "@interfere/node": "^0.0.1-canary.4",
+    "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/instrumentation": "^0.218.0",
     "@opentelemetry/instrumentation-nestjs-core": "^0.64.0"
   },