posthog-node 5.27.1 → 5.28.0

package/dist/entrypoints/nestjs.d.ts

@@ -0,0 +1,2 @@
+export * from '../extensions/nestjs';
+//# sourceMappingURL=nestjs.d.ts.map

package/dist/entrypoints/nestjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.d.ts","sourceRoot":"","sources":["../../src/entrypoints/nestjs.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA"}

package/dist/entrypoints/nestjs.js

@@ -0,0 +1,60 @@
+"use strict";
+var __webpack_modules__ = {
+    "../extensions/nestjs": function(module) {
+        module.exports = require("../extensions/nestjs.js");
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+(()=>{
+    __webpack_require__.r(__webpack_exports__);
+    var _extensions_nestjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__("../extensions/nestjs");
+    var __WEBPACK_REEXPORT_OBJECT__ = {};
+    for(var __WEBPACK_IMPORT_KEY__ in _extensions_nestjs__WEBPACK_IMPORTED_MODULE_0__)if ("default" !== __WEBPACK_IMPORT_KEY__) __WEBPACK_REEXPORT_OBJECT__[__WEBPACK_IMPORT_KEY__] = (function(key) {
+        return _extensions_nestjs__WEBPACK_IMPORTED_MODULE_0__[key];
+    }).bind(0, __WEBPACK_IMPORT_KEY__);
+    __webpack_require__.d(__webpack_exports__, __WEBPACK_REEXPORT_OBJECT__);
+})();
+for(var __webpack_i__ in __webpack_exports__)exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/entrypoints/nestjs.mjs

@@ -0,0 +1 @@
+export * from "../extensions/nestjs.mjs";

package/dist/extensions/nestjs.d.ts

@@ -0,0 +1,32 @@
+import { Observable } from 'rxjs';
+import { PostHogBackendClient } from '../client';
+interface HttpArgumentsHost {
+    getRequest<T = any>(): T;
+    getResponse<T = any>(): T;
+}
+interface ExecutionContext {
+    switchToHttp(): HttpArgumentsHost;
+}
+interface CallHandler<T = any> {
+    handle(): Observable<T>;
+}
+interface NestInterceptor<T = any, R = any> {
+    intercept(context: ExecutionContext, next: CallHandler<T>): Observable<R>;
+}
+export interface ExceptionCaptureOptions {
+    /** Minimum HTTP status code to capture. Exceptions with a lower status (e.g. 4xx) are skipped. @default 500 */
+    minStatusToCapture?: number;
+}
+export interface PostHogInterceptorOptions {
+    /** Enable exception capture. Pass `true` for defaults or an object to configure. @default false */
+    captureExceptions?: boolean | ExceptionCaptureOptions;
+}
+export declare class PostHogInterceptor implements NestInterceptor {
+    private posthog;
+    private captureExceptions;
+    private minStatusToCapture;
+    constructor(posthog: PostHogBackendClient, options?: PostHogInterceptorOptions);
+    intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
+}
+export {};
+//# sourceMappingURL=nestjs.d.ts.map

package/dist/extensions/nestjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.d.ts","sourceRoot":"","sources":["../../src/extensions/nestjs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,MAAM,CAAA;AAI7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAGhD,UAAU,iBAAiB;IACzB,UAAU,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAA;IACxB,WAAW,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAA;CAC1B;AAED,UAAU,gBAAgB;IACxB,YAAY,IAAI,iBAAiB,CAAA;CAClC;AAED,UAAU,WAAW,CAAC,CAAC,GAAG,GAAG;IAC3B,MAAM,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;CACxB;AAED,UAAU,eAAe,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG;IACxC,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;CAC1E;AAED,MAAM,WAAW,uBAAuB;IACtC,+GAA+G;IAC/G,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,mGAAmG;IACnG,iBAAiB,CAAC,EAAE,OAAO,GAAG,uBAAuB,CAAA;CACtD;AAwBD,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,kBAAkB,CAAQ;gBAEtB,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAO9E,SAAS,CAAC,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,CAAC;CAiDzE"}

package/dist/extensions/nestjs.js

@@ -0,0 +1,105 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    PostHogInterceptor: ()=>PostHogInterceptor
+});
+const external_rxjs_namespaceObject = require("rxjs");
+const operators_namespaceObject = require("rxjs/operators");
+const index_js_namespaceObject = require("./error-tracking/index.js");
+var index_js_default = /*#__PURE__*/ __webpack_require__.n(index_js_namespaceObject);
+function getClientIp(headers, request) {
+    const forwarded = headers['x-forwarded-for'];
+    if (forwarded) {
+        const ip = String(forwarded).split(',')[0].trim();
+        if (ip) return ip;
+    }
+    return request?.socket?.remoteAddress;
+}
+function getExceptionStatus(exception) {
+    if (exception && 'object' == typeof exception && 'getStatus' in exception && 'function' == typeof exception.getStatus) {
+        const status = exception.getStatus();
+        return 'number' == typeof status ? status : void 0;
+    }
+}
+class PostHogInterceptor {
+    constructor(posthog, options){
+        this.posthog = posthog;
+        const capture = options?.captureExceptions;
+        this.captureExceptions = !!capture;
+        this.minStatusToCapture = ('object' == typeof capture ? capture.minStatusToCapture : void 0) ?? 500;
+    }
+    intercept(context, next) {
+        const httpHost = context.switchToHttp();
+        const request = httpHost.getRequest();
+        const response = httpHost.getResponse();
+        const headers = request?.headers ?? {};
+        const sessionId = headers['x-posthog-session-id'];
+        const windowId = headers['x-posthog-window-id'];
+        const distinctId = headers['x-posthog-distinct-id'];
+        const contextData = {
+            sessionId,
+            distinctId,
+            properties: {
+                $current_url: request?.url,
+                $request_method: request?.method,
+                $request_path: request?.path ?? request?.url,
+                $window_id: windowId,
+                $user_agent: headers['user-agent'],
+                $ip: getClientIp(headers, request)
+            }
+        };
+        this.posthog.enterContext(contextData);
+        let source = next.handle();
+        if (this.captureExceptions) source = source.pipe((0, operators_namespaceObject.catchError)((exception)=>{
+            if (index_js_default().isPreviouslyCapturedError(exception)) return (0, external_rxjs_namespaceObject.throwError)(()=>exception);
+            const status = getExceptionStatus(exception);
+            if (void 0 !== status && status < this.minStatusToCapture) return (0, external_rxjs_namespaceObject.throwError)(()=>exception);
+            const responseStatus = status ?? response?.statusCode;
+            const additionalProperties = void 0 !== responseStatus ? {
+                $response_status_code: responseStatus
+            } : void 0;
+            this.posthog.captureException(exception, distinctId, additionalProperties);
+            return (0, external_rxjs_namespaceObject.throwError)(()=>exception);
+        }));
+        return source;
+    }
+}
+exports.PostHogInterceptor = __webpack_exports__.PostHogInterceptor;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "PostHogInterceptor"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/extensions/nestjs.mjs

@@ -0,0 +1,61 @@
+import { throwError } from "rxjs";
+import { catchError } from "rxjs/operators";
+import error_tracking from "./error-tracking/index.mjs";
+function getClientIp(headers, request) {
+    const forwarded = headers['x-forwarded-for'];
+    if (forwarded) {
+        const ip = String(forwarded).split(',')[0].trim();
+        if (ip) return ip;
+    }
+    return request?.socket?.remoteAddress;
+}
+function getExceptionStatus(exception) {
+    if (exception && 'object' == typeof exception && 'getStatus' in exception && 'function' == typeof exception.getStatus) {
+        const status = exception.getStatus();
+        return 'number' == typeof status ? status : void 0;
+    }
+}
+class PostHogInterceptor {
+    constructor(posthog, options){
+        this.posthog = posthog;
+        const capture = options?.captureExceptions;
+        this.captureExceptions = !!capture;
+        this.minStatusToCapture = ('object' == typeof capture ? capture.minStatusToCapture : void 0) ?? 500;
+    }
+    intercept(context, next) {
+        const httpHost = context.switchToHttp();
+        const request = httpHost.getRequest();
+        const response = httpHost.getResponse();
+        const headers = request?.headers ?? {};
+        const sessionId = headers['x-posthog-session-id'];
+        const windowId = headers['x-posthog-window-id'];
+        const distinctId = headers['x-posthog-distinct-id'];
+        const contextData = {
+            sessionId,
+            distinctId,
+            properties: {
+                $current_url: request?.url,
+                $request_method: request?.method,
+                $request_path: request?.path ?? request?.url,
+                $window_id: windowId,
+                $user_agent: headers['user-agent'],
+                $ip: getClientIp(headers, request)
+            }
+        };
+        this.posthog.enterContext(contextData);
+        let source = next.handle();
+        if (this.captureExceptions) source = source.pipe(catchError((exception)=>{
+            if (error_tracking.isPreviouslyCapturedError(exception)) return throwError(()=>exception);
+            const status = getExceptionStatus(exception);
+            if (void 0 !== status && status < this.minStatusToCapture) return throwError(()=>exception);
+            const responseStatus = status ?? response?.statusCode;
+            const additionalProperties = void 0 !== responseStatus ? {
+                $response_status_code: responseStatus
+            } : void 0;
+            this.posthog.captureException(exception, distinctId, additionalProperties);
+            return throwError(()=>exception);
+        }));
+        return source;
+    }
+}
+export { PostHogInterceptor };

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "5.27.1";
+export declare const version = "5.28.0";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -26,7 +26,7 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     version: ()=>version
 });
-const version = '5.27.1';
+const version = '5.28.0';
 exports.version = __webpack_exports__.version;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "version"

package/dist/version.mjs

@@ -1,2 +1,2 @@
-const version = '5.27.1';
+const version = '5.28.0';
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posthog-node",
-  "version": "5.27.1",
+  "version": "5.28.0",
   "description": "PostHog Node.js integration",
   "repository": {
     "type": "git",
@@ -33,8 +33,17 @@
     "@types/jest": "^29.5.14",
     "@types/node": "^20.0.0",
     "jest": "29.7.0",
+    "rxjs": "^7.8.0",
     "@posthog-tooling/tsconfig-base": "1.1.1"
   },
+  "peerDependencies": {
+    "rxjs": "^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "rxjs": {
+      "optional": true
+    }
+  },
   "keywords": [
     "posthog",
     "stats",
@@ -73,6 +82,11 @@
       "require": "./dist/entrypoints/index.edge.js",
       "default": "./dist/entrypoints/index.edge.js"
     },
+    "./nestjs": {
+      "types": "./dist/entrypoints/nestjs.d.ts",
+      "import": "./dist/entrypoints/nestjs.mjs",
+      "require": "./dist/entrypoints/nestjs.js"
+    },
     "./experimental": {
       "types": "./dist/experimental.d.ts"
     }

package/src/entrypoints/nestjs.ts

@@ -0,0 +1 @@
+export * from '../extensions/nestjs'

package/src/extensions/nestjs.ts

@@ -0,0 +1,118 @@
+import { Observable, throwError } from 'rxjs'
+import { catchError } from 'rxjs/operators'
+
+import ErrorTracking from './error-tracking'
+import { PostHogBackendClient } from '../client'
+
+// Local interfaces to avoid runtime dependency on @nestjs/common
+interface HttpArgumentsHost {
+  getRequest<T = any>(): T
+  getResponse<T = any>(): T
+}
+
+interface ExecutionContext {
+  switchToHttp(): HttpArgumentsHost
+}
+
+interface CallHandler<T = any> {
+  handle(): Observable<T>
+}
+
+interface NestInterceptor<T = any, R = any> {
+  intercept(context: ExecutionContext, next: CallHandler<T>): Observable<R>
+}
+
+export interface ExceptionCaptureOptions {
+  /** Minimum HTTP status code to capture. Exceptions with a lower status (e.g. 4xx) are skipped. @default 500 */
+  minStatusToCapture?: number
+}
+
+export interface PostHogInterceptorOptions {
+  /** Enable exception capture. Pass `true` for defaults or an object to configure. @default false */
+  captureExceptions?: boolean | ExceptionCaptureOptions
+}
+
+function getClientIp(headers: Record<string, any>, request: any): string | undefined {
+  const forwarded = headers['x-forwarded-for']
+  if (forwarded) {
+    const ip = String(forwarded).split(',')[0].trim()
+    if (ip) return ip
+  }
+  return request?.socket?.remoteAddress
+}
+
+function getExceptionStatus(exception: unknown): number | undefined {
+  if (
+    exception &&
+    typeof exception === 'object' &&
+    'getStatus' in exception &&
+    typeof (exception as any).getStatus === 'function'
+  ) {
+    const status = (exception as any).getStatus()
+    return typeof status === 'number' ? status : undefined
+  }
+  return undefined
+}
+
+export class PostHogInterceptor implements NestInterceptor {
+  private posthog: PostHogBackendClient
+  private captureExceptions: boolean
+  private minStatusToCapture: number
+
+  constructor(posthog: PostHogBackendClient, options?: PostHogInterceptorOptions) {
+    this.posthog = posthog
+    const capture = options?.captureExceptions
+    this.captureExceptions = !!capture
+    this.minStatusToCapture = (typeof capture === 'object' ? capture.minStatusToCapture : undefined) ?? 500
+  }
+
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
+    const httpHost = context.switchToHttp()
+    const request = httpHost.getRequest()
+    const response = httpHost.getResponse()
+
+    const headers = request?.headers ?? {}
+    const sessionId: string | undefined = headers['x-posthog-session-id']
+    const windowId: string | undefined = headers['x-posthog-window-id']
+    const distinctId: string | undefined = headers['x-posthog-distinct-id']
+
+    const contextData = {
+      sessionId,
+      distinctId,
+      properties: {
+        $current_url: request?.url,
+        $request_method: request?.method,
+        $request_path: request?.path ?? request?.url,
+        $window_id: windowId,
+        $user_agent: headers['user-agent'],
+        $ip: getClientIp(headers, request),
+      },
+    }
+
+    // Use enterContext so the context propagates through RxJS Observable
+    // subscription and catchError handlers, not just the synchronous callback.
+    this.posthog.enterContext(contextData)
+
+    let source = next.handle()
+
+    if (this.captureExceptions) {
+      source = source.pipe(
+        catchError((exception: unknown) => {
+          if (ErrorTracking.isPreviouslyCapturedError(exception)) {
+            return throwError(() => exception)
+          }
+          const status = getExceptionStatus(exception)
+          if (status !== undefined && status < this.minStatusToCapture) {
+            return throwError(() => exception)
+          }
+          const responseStatus = status ?? response?.statusCode
+          const additionalProperties: Record<string, any> | undefined =
+            responseStatus !== undefined ? { $response_status_code: responseStatus } : undefined
+          this.posthog.captureException(exception, distinctId, additionalProperties)
+          return throwError(() => exception)
+        })
+      )
+    }
+    return source
+  }
+}

package/src/version.ts

@@ -1 +1 @@
-export const version = '5.27.1'
+export const version = '5.28.0'