@buoy-gg/impersonate 7.0.40 → 7.0.42

package/lib/commonjs/impersonate/utils/impersonateListener.js

@@ -1,335 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.getImpersonatedUserId = getImpersonatedUserId;
-exports.impersonateListener = impersonateListener;
-exports.isImpersonating = isImpersonating;
-exports.setImpersonateConfig = setImpersonateConfig;
-exports.startImpersonateListener = startImpersonateListener;
-exports.stopImpersonateListener = stopImpersonateListener;
-/**
- * Impersonate Listener - Header Injection via Fetch/XHR Monkey-Patching
- *
- * This module intercepts all network requests and injects the impersonation
- * header when impersonation is active. It follows the same singleton pattern
- * as @buoy-gg/network's networkListener.
- */
-
-// Extended XMLHttpRequest interface for tracking URL
-
-/**
- * Default URL patterns to ignore (won't inject header)
- * These are development-related URLs that shouldn't have impersonation
- */
-const DEFAULT_IGNORE_PATTERNS = [/\/symbolicate$/, /\/logs$/, /\/debugger-proxy/, /\/reload$/, /\/launch-js-devtools/, /localhost:8081/, /100\.64\.\d+\.\d+:8081/,
-// iOS simulator Metro
-/10\.0\.\d+\.\d+:8081/,
-// Android emulator Metro
-/\.hot-update\./, /__metro/];
-
-/**
- * Impersonation header injector for network requests
- *
- * This class monkey-patches fetch and XMLHttpRequest to inject the
- * impersonation header on all outgoing requests when impersonation is active.
- *
- * @example
- * ```typescript
- * // Get the singleton instance
- * const listener = impersonateListener();
- *
- * // Configure impersonation
- * listener.setConfig({
- *   headerKey: 'x-impersonate-user-id',
- *   userId: '12345',
- *   ignorePatterns: [/\/health/]
- * });
- *
- * // Start injecting headers
- * listener.startListening();
- *
- * // All fetch/XHR requests will now include the header
- *
- * // Stop injecting when done
- * listener.stopListening();
- * ```
- */
-/**
- * Cooperating-interceptor protocol with @buoy-gg/network: its interceptors
- * carry `__buoy*` marker properties, and it re-installs itself whenever the
- * marker disappears from the live global (that's how it survives being
- * clobbered by Expo/DevTools re-assigning fetch). We wrap its functions, so
- * the markers must ride along on our wrappers — otherwise the network tool
- * would conclude it lost interception and stack a fresh patch on every check.
- */
-function carryBuoyMarkers(wrapper, wrapped) {
-  for (const key of Object.keys(wrapped)) {
-    if (key.startsWith("__buoy")) {
-      wrapper[key] = wrapped[key];
-    }
-  }
-}
-class ImpersonateListener {
-  isListeningFlag = false;
-
-  // Store original methods - MUST be captured before other tools patch
-
-  /**
-   * The wrappers this instance installed, for identity checks — stopListening
-   * only restores globals that are still literally ours (see there).
-   */
-  patchedFetch = null;
-  patchedXHROpen = null;
-  patchedXHRSend = null;
-  constructor() {
-    // Initialize with current fetch - will be re-captured in startListening
-    this.originalFetch = globalThis.fetch.bind(globalThis);
-    this.originalXHROpen = XMLHttpRequest.prototype.open;
-    this.originalXHRSend = XMLHttpRequest.prototype.send;
-    this.config = {
-      headerKey: "x-impersonate-user-id",
-      userId: null,
-      ignorePatterns: [...DEFAULT_IGNORE_PATTERNS]
-    };
-  }
-
-  /**
-   * Update impersonation config without restarting listener
-   *
-   * This is the primary way to activate/deactivate impersonation.
-   * Set userId to null to stop injecting headers.
-   */
-  setConfig(partial) {
-    this.config = {
-      ...this.config,
-      ...partial
-    };
-
-    // Merge ignore patterns if provided
-    if (partial.ignorePatterns) {
-      this.config.ignorePatterns = [...DEFAULT_IGNORE_PATTERNS, ...partial.ignorePatterns];
-    }
-  }
-
-  /**
-   * Get current configuration
-   */
-  getConfig() {
-    return {
-      ...this.config
-    };
-  }
-
-  /**
-   * Check if URL should have header injected
-   *
-   * Returns false if:
-   * - No userId is set (not impersonating)
-   * - URL matches any ignore pattern
-   */
-  shouldInjectHeader(url) {
-    // Not impersonating
-    if (!this.config.userId) {
-      return false;
-    }
-
-    // Check ignore patterns
-    return !this.config.ignorePatterns.some(pattern => pattern.test(url));
-  }
-
-  /**
-   * Extract URL from various input types
-   */
-  extractUrl(input) {
-    if (typeof input === "string") {
-      return input;
-    }
-    if (input instanceof URL) {
-      return input.href;
-    }
-    // Request object
-    return input.url;
-  }
-
-  /**
-   * Start intercepting and injecting headers
-   *
-   * This patches globalThis.fetch and XMLHttpRequest.prototype methods
-   * to inject the impersonation header on all requests.
-   */
-  startListening() {
-    if (this.isListeningFlag) {
-      return;
-    }
-
-    // CRITICAL: Re-capture fetch/XHR NOW, not at construction time
-    // This ensures we patch OVER any existing interceptors (like @buoy-gg/network)
-    // so our modifications are visible to them
-    //
-    // Keep the UNBOUND functions too: @buoy-gg/network stamps `__buoy*` marker
-    // properties on its interceptors and re-installs when the marker vanishes
-    // from the live global — and `.bind()` drops own properties, so the
-    // markers must be read off the unbound originals and carried forward onto
-    // our wrappers (see below).
-    const wrappedFetch = globalThis.fetch;
-    const wrappedXHROpen = XMLHttpRequest.prototype.open;
-    const wrappedXHRSend = XMLHttpRequest.prototype.send;
-    this.originalFetch = wrappedFetch.bind(globalThis);
-    this.originalXHROpen = wrappedXHROpen;
-    this.originalXHRSend = wrappedXHRSend;
-    const self = this;
-
-    // =======================================================================
-    // PATCH FETCH
-    // =======================================================================
-    const patchedFetch = async function (input, init) {
-      const url = self.extractUrl(input);
-      if (self.shouldInjectHeader(url)) {
-        // Create new headers with impersonation header added
-        const existingHeaders = init?.headers;
-        const headers = new Headers(existingHeaders);
-        headers.set(self.config.headerKey, self.config.userId);
-
-        // Call original fetch with modified init
-        return self.originalFetch(input, {
-          ...init,
-          headers
-        });
-      }
-
-      // Not injecting - call original fetch as-is
-      return self.originalFetch(input, init);
-    };
-    carryBuoyMarkers(patchedFetch, wrappedFetch);
-    this.patchedFetch = patchedFetch;
-    globalThis.fetch = this.patchedFetch;
-
-    // =======================================================================
-    // PATCH XMLHttpRequest
-    // =======================================================================
-
-    // Patch open() to store the URL for later use in send()
-    const patchedOpen = function (method, url, async = true, username, password) {
-      const xhr = this;
-      xhr._impersonateUrl = typeof url === "string" ? url : url.href;
-      const urlStr = typeof url === "string" ? url : url.toString();
-      return self.originalXHROpen.call(this, method, urlStr, async, username, password);
-    };
-
-    // Patch send() to inject header before sending
-    const patchedSend = function (body) {
-      const xhr = this;
-      if (xhr._impersonateUrl && self.shouldInjectHeader(xhr._impersonateUrl)) {
-        // Inject the impersonation header
-        this.setRequestHeader(self.config.headerKey, self.config.userId);
-      }
-      return self.originalXHRSend.call(this, body);
-    };
-    carryBuoyMarkers(patchedOpen, wrappedXHROpen);
-    carryBuoyMarkers(patchedSend, wrappedXHRSend);
-    this.patchedXHROpen = patchedOpen;
-    this.patchedXHRSend = patchedSend;
-    XMLHttpRequest.prototype.open = this.patchedXHROpen;
-    XMLHttpRequest.prototype.send = this.patchedXHRSend;
-    this.isListeningFlag = true;
-  }
-
-  /**
-   * Stop intercepting - restore original methods
-   *
-   * Note: This restores fetch/XHR to their state when ImpersonateListener
-   * was constructed. If other interceptors were installed after, this may
-   * break their functionality.
-   */
-  stopListening() {
-    if (!this.isListeningFlag) {
-      return;
-    }
-
-    // Restore ONLY what is still literally ours: if another interceptor
-    // patched after us (the network tool re-asserting itself, a debugger),
-    // assigning our saved originals would silently wipe its patch. Leaving our
-    // wrapper in a foreign chain is safe — with no userId configured it is a
-    // pure pass-through.
-    if (this.patchedFetch && globalThis.fetch === this.patchedFetch) {
-      globalThis.fetch = this.originalFetch;
-    }
-    if (this.patchedXHROpen && XMLHttpRequest.prototype.open === this.patchedXHROpen) {
-      XMLHttpRequest.prototype.open = this.originalXHROpen;
-    }
-    if (this.patchedXHRSend && XMLHttpRequest.prototype.send === this.patchedXHRSend) {
-      XMLHttpRequest.prototype.send = this.originalXHRSend;
-    }
-    this.patchedFetch = null;
-    this.patchedXHROpen = null;
-    this.patchedXHRSend = null;
-    this.isListeningFlag = false;
-  }
-
-  /**
-   * Check if listener is currently active
-   */
-  get isListening() {
-    return this.isListeningFlag;
-  }
-
-  /**
-   * Check if impersonation is currently active (has userId set)
-   */
-  get isImpersonating() {
-    return this.config.userId !== null;
-  }
-}
-
-// =============================================================================
-// SINGLETON PATTERN
-// =============================================================================
-
-let _instance = null;
-
-/**
- * Get the singleton ImpersonateListener instance
- */
-function impersonateListener() {
-  if (!_instance) {
-    _instance = new ImpersonateListener();
-  }
-  return _instance;
-}
-
-/**
- * Convenience function to start the listener
- */
-function startImpersonateListener() {
-  impersonateListener().startListening();
-}
-
-/**
- * Convenience function to stop the listener
- */
-function stopImpersonateListener() {
-  impersonateListener().stopListening();
-}
-
-/**
- * Convenience function to update config
- */
-function setImpersonateConfig(config) {
-  impersonateListener().setConfig(config);
-}
-
-/**
- * Convenience function to check if impersonating
- */
-function isImpersonating() {
-  return _instance?.isImpersonating ?? false;
-}
-
-/**
- * Convenience function to get impersonated user ID
- */
-function getImpersonatedUserId() {
-  return _instance?.getConfig().userId ?? null;
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.getImpersonatedUserId=getImpersonatedUserId;exports.impersonateListener=impersonateListener;exports.isImpersonating=isImpersonating;exports.setImpersonateConfig=setImpersonateConfig;exports.startImpersonateListener=startImpersonateListener;exports.stopImpersonateListener=stopImpersonateListener;const DEFAULT_IGNORE_PATTERNS=[/\/symbolicate$/,/\/logs$/,/\/debugger-proxy/,/\/reload$/,/\/launch-js-devtools/,/localhost:8081/,/100\.64\.\d+\.\d+:8081/,/10\.0\.\d+\.\d+:8081/,/\.hot-update\./,/__metro/];function carryBuoyMarkers(r,e){for(const s of Object.keys(e)){if(s.startsWith("__buoy")){r[s]=e[s]}}}class ImpersonateListener{isListeningFlag=false;patchedFetch=null;patchedXHROpen=null;patchedXHRSend=null;constructor(){this.originalFetch=globalThis.fetch.bind(globalThis);this.originalXHROpen=XMLHttpRequest.prototype.open;this.originalXHRSend=XMLHttpRequest.prototype.send;this.config={headerKey:"x-impersonate-user-id",userId:null,ignorePatterns:[...DEFAULT_IGNORE_PATTERNS]}}setConfig(e){this.config={...this.config,...e};if(e.ignorePatterns){this.config.ignorePatterns=[...DEFAULT_IGNORE_PATTERNS,...e.ignorePatterns]}}getConfig(){return{...this.config}}shouldInjectHeader(e){if(!this.config.userId){return false}if(this.config.gate&&!this.config.gate()){return false}return!this.config.ignorePatterns.some(s=>s.test(e))}extractUrl(e){if(typeof e==="string"){return e}if(e instanceof URL){return e.href}return e.url}startListening(){if(this.isListeningFlag){return}const e=globalThis.fetch;const s=XMLHttpRequest.prototype.open;const c=XMLHttpRequest.prototype.send;this.originalFetch=e.bind(globalThis);this.originalXHROpen=s;this.originalXHRSend=c;const n=this;const p=async function(i,t){const a=n.extractUrl(i);if(n.shouldInjectHeader(a)){const h=t?.headers??(typeof i==="object"&&"headers"in i?i.headers:void 0);const o=new Headers(h);o.set(n.config.headerKey,n.config.userId);return n.originalFetch(i,{...t,headers:o})}return n.originalFetch(i,t)};carryBuoyMarkers(p,e);this.patchedFetch=p;globalThis.fetch=this.patchedFetch;const d=function(i,t,a=true,h,o){const u=this;u._impersonateUrl=typeof t==="string"?t:t.href;const H=typeof t==="string"?t:t.toString();return n.originalXHROpen.call(this,i,H,a,h,o)};const g=function(i){const t=this;if(t._impersonateUrl&&n.shouldInjectHeader(t._impersonateUrl)){this.setRequestHeader(n.config.headerKey,n.config.userId)}return n.originalXHRSend.call(this,i)};carryBuoyMarkers(d,s);carryBuoyMarkers(g,c);this.patchedXHROpen=d;this.patchedXHRSend=g;XMLHttpRequest.prototype.open=this.patchedXHROpen;XMLHttpRequest.prototype.send=this.patchedXHRSend;const f=globalThis;const l=f.__buoyHeaderInjectors??=[];if(!l.includes(this.reportHeader))l.push(this.reportHeader);this.isListeningFlag=true}reportHeader=e=>this.shouldInjectHeader(e)?{[this.config.headerKey]:this.config.userId}:null;stopListening(){if(!this.isListeningFlag){return}if(this.patchedFetch&&globalThis.fetch===this.patchedFetch){globalThis.fetch=this.originalFetch}if(this.patchedXHROpen&&XMLHttpRequest.prototype.open===this.patchedXHROpen){XMLHttpRequest.prototype.open=this.originalXHROpen}if(this.patchedXHRSend&&XMLHttpRequest.prototype.send===this.patchedXHRSend){XMLHttpRequest.prototype.send=this.originalXHRSend}this.patchedFetch=null;this.patchedXHROpen=null;this.patchedXHRSend=null;const e=globalThis.__buoyHeaderInjectors;const s=e?.indexOf(this.reportHeader)??-1;if(e&&s>=0)e.splice(s,1);this.isListeningFlag=false}get isListening(){return this.isListeningFlag}get isImpersonating(){return this.config.userId!==null&&(this.config.gate?.()??true)}}let _instance=null;function impersonateListener(){if(!_instance){_instance=new ImpersonateListener}return _instance}function startImpersonateListener(){impersonateListener().startListening()}function stopImpersonateListener(){impersonateListener().stopListening()}function setImpersonateConfig(r){impersonateListener().setConfig(r)}function isImpersonating(){return _instance?.isImpersonating??false}function getImpersonatedUserId(){return _instance?.getConfig().userId??null}