test-proxy-recorder 0.2.0 → 0.3.1

package/dist/index.cjs

@@ -19,8 +19,6 @@ var crypto__default = /*#__PURE__*/_interopDefault(crypto);
 var path__default = /*#__PURE__*/_interopDefault(path);
 var filenamify2__default = /*#__PURE__*/_interopDefault(filenamify2);
 
-// src/ProxyServer.ts
-
 // src/constants.ts
 var DEFAULT_TIMEOUT_MS = 120 * 1e3;
 var HTTP_STATUS_BAD_GATEWAY = 502;
@@ -28,6 +26,7 @@ var HTTP_STATUS_OK = 200;
 var HTTP_STATUS_BAD_REQUEST = 400;
 var HTTP_STATUS_NOT_FOUND = 404;
 var CONTROL_ENDPOINT = "/__control";
+var RECORDING_ID_HEADER = "x-test-rcrd-id";
 
 // src/types.ts
 var Modes = {
@@ -61,13 +60,23 @@ async function loadRecordingSession(filePath) {
   return JSON.parse(fileContent);
 }
 function processRecordings(recordings) {
-  const keySequenceMap = /* @__PURE__ */ new Map();
-  return recordings.map((recording) => {
+  const recordingsByKey = /* @__PURE__ */ new Map();
+  for (const recording of recordings) {
     const key = recording.key;
-    const currentSeq = keySequenceMap.get(key) || 0;
-    keySequenceMap.set(key, currentSeq + 1);
-    return { ...recording, sequence: currentSeq };
-  });
+    if (!recordingsByKey.has(key)) {
+      recordingsByKey.set(key, []);
+    }
+    recordingsByKey.get(key).push(recording);
+  }
+  const processedRecordings = [];
+  for (const [_key, keyRecordings] of recordingsByKey) {
+    keyRecordings.sort((a, b) => a.recordingId - b.recordingId);
+    keyRecordings.forEach((recording, index) => {
+      processedRecordings.push({ ...recording, sequence: index });
+    });
+  }
+  processedRecordings.sort((a, b) => a.recordingId - b.recordingId);
+  return processedRecordings;
 }
 async function saveRecordingSession(recordingsDir, session) {
   const filePath = getRecordingPath(recordingsDir, session.id);
@@ -130,19 +139,25 @@ var ProxyServer = class {
   recordingsDir;
   recordingIdCounter;
   // Unique ID for each recording entry
+  sequenceCounterByKey;
+  // Sequence counter per key (endpoint)
   replaySessions;
   // Track multiple concurrent replay sessions by recording ID
+  recordingPromises;
+  // Stack of promises that resolve to completed recordings
   constructor(targets, recordingsDir) {
     this.targets = targets;
     this.currentTargetIndex = 0;
     this.mode = Modes.transparent;
     this.recordingId = null;
     this.recordingIdCounter = 0;
+    this.sequenceCounterByKey = /* @__PURE__ */ new Map();
     this.replayId = null;
     this.modeTimeout = null;
     this.currentSession = null;
     this.recordingsDir = recordingsDir;
     this.replaySessions = /* @__PURE__ */ new Map();
+    this.recordingPromises = [];
     this.proxy = httpProxy__default.default.createProxyServer({
       secure: false,
       changeOrigin: true,
@@ -168,7 +183,7 @@ var ProxyServer = class {
   }
   setupProxyEventHandlers() {
     this.proxy.on("error", this.handleProxyError.bind(this));
-    this.proxy.on("proxyRes", this.handleProxyResponse.bind(this));
+    this.proxy.on("proxyRes", this.addCorsHeaders.bind(this));
   }
   handleProxyError(err, req, res) {
     console.error("Proxy error:", err);
@@ -184,12 +199,6 @@ var ProxyServer = class {
     }
     res.end(JSON.stringify({ error: "Proxy error", message: err.message }));
   }
-  handleProxyResponse(proxyRes, req) {
-    this.addCorsHeaders(proxyRes, req);
-    if (this.mode === Modes.record && this.recordingId) {
-      this.recordResponse(req, proxyRes);
-    }
-  }
   /**
    * Get CORS headers for a given request
    * @param req The incoming HTTP request
@@ -200,7 +209,7 @@ var ProxyServer = class {
     return {
       "access-control-allow-origin": origin || "*",
       "access-control-allow-credentials": "true",
-      "access-control-allow-headers": req.headers["access-control-request-headers"] || "Origin, X-Requested-With, Content-Type, Accept, Authorization",
+      "access-control-allow-headers": req.headers["access-control-request-headers"] || `Origin, X-Requested-With, Content-Type, Accept, Authorization, ${RECORDING_ID_HEADER}`,
       "access-control-allow-methods": "GET, POST, PUT, DELETE, PATCH, OPTIONS",
       "access-control-expose-headers": "*"
     };
@@ -214,9 +223,22 @@ var ProxyServer = class {
     this.currentTargetIndex = (this.currentTargetIndex + 1) % this.targets.length;
     return target;
   }
+  /**
+   * Extract recording ID from custom HTTP header
+   * Used for concurrent replay session routing, especially with Next.js
+   * @param req The incoming HTTP request
+   * @returns The recording ID from header, or null if not found
+   */
+  getRecordingIdFromHeader(req) {
+    const headerValue = req.headers[RECORDING_ID_HEADER];
+    if (!headerValue) {
+      return null;
+    }
+    return Array.isArray(headerValue) ? headerValue[0] : headerValue;
+  }
   /**
    * Extract recording ID from request cookie
-   * Used for concurrent replay session routing
+   * Used for concurrent replay session routing (fallback method)
    * @param req The incoming HTTP request
    * @returns The recording ID from cookie, or null if not found
    */
@@ -228,6 +250,14 @@ var ProxyServer = class {
     const match = cookies.match(/proxy-recording-id=([^;]+)/);
     return match ? decodeURIComponent(match[1]) : null;
   }
+  /**
+   * Extract recording ID from request using custom header (preferred) or cookie (fallback)
+   * @param req The incoming HTTP request
+   * @returns The recording ID, or null if not found
+   */
+  getRecordingIdFromRequest(req) {
+    return this.getRecordingIdFromHeader(req) || this.getRecordingIdFromCookie(req);
+  }
   /**
    * Get or create a replay session state for a given recording ID
    * @param recordingId The recording ID to get/create session for
@@ -262,18 +292,20 @@ var ProxyServer = class {
     }
     return { mode, id, timeout };
   }
+  async parseControlRequest(req) {
+    if (req.method === "GET") {
+      return this.parseGetParams(req);
+    }
+    if (req.method === "POST") {
+      const body = await readRequestBody(req);
+      console.log(`MODE CHANGE (${req.method})`, body);
+      return JSON.parse(body);
+    }
+    throw new Error("Unsupported control method");
+  }
   async handleControlRequest(req, res) {
     try {
-      let data;
-      if (req.method === "GET") {
-        data = this.parseGetParams(req);
-      } else if (req.method === "POST") {
-        const body = await readRequestBody(req);
-        console.log(`MODE CHANGE (${req.method})`, body);
-        data = JSON.parse(body);
-      } else {
-        return;
-      }
+      const data = await this.parseControlRequest(req);
       const { mode, id, timeout: requestTimeout } = data;
       const timeout = requestTimeout ?? DEFAULT_TIMEOUT_MS;
       this.clearModeTimeout();
@@ -306,7 +338,7 @@ var ProxyServer = class {
   async switchMode(mode, id) {
     console.log(`Switching to ${mode.toUpperCase()} mode`);
     if (this.currentSession && this.mode === Modes.record) {
-      await this.saveCurrentSession(true);
+      await this.saveCurrentSession();
       console.log("Session saved, continuing with mode switch");
     }
     switch (mode) {
@@ -346,6 +378,8 @@ var ProxyServer = class {
     this.recordingId = id;
     this.replayId = null;
     this.currentSession = { id, recordings: [], websocketRecordings: [] };
+    this.recordingIdCounter = 0;
+    this.sequenceCounterByKey.clear();
     console.log(`Switched to record mode with ID: ${id}`);
   }
   async switchToReplayMode(id) {
@@ -365,169 +399,91 @@ var ProxyServer = class {
   setupModeTimeout(timeout) {
     this.modeTimeout = setTimeout(async () => {
       console.log("Timeout reached, switching back to transparent mode");
-      await this.saveCurrentSession(true);
+      await this.saveCurrentSession();
       this.switchToTransparentMode();
       this.modeTimeout = null;
     }, timeout);
   }
-  async saveCurrentSession(filterIncomplete = false) {
-    if (!this.currentSession) {
+  async flushPendingRecordings() {
+    if (this.recordingPromises.length === 0) {
       return;
     }
-    if (filterIncomplete) {
-      const incompleteCount = this.currentSession.recordings.filter(
-        (r) => !r.response
-      ).length;
-      if (incompleteCount > 0) {
-        this.currentSession.recordings = this.currentSession.recordings.filter(
-          (r) => r.response
-        );
+    const results = await Promise.allSettled(this.recordingPromises);
+    if (this.currentSession) {
+      for (const result of results) {
+        if (result.status === "fulfilled" && result.value) {
+          this.currentSession.recordings.push(result.value);
+        }
       }
+      console.log(
+        `Flushed ${results.length} recordings to session (total: ${this.currentSession.recordings.length})`
+      );
     }
-    console.log(
-      `Saving session with ${this.currentSession.recordings.length} HTTP and ${this.currentSession.websocketRecordings.length} WebSocket recordings`
-    );
-    await saveRecordingSession(this.recordingsDir, this.currentSession);
+    this.recordingPromises = [];
   }
-  saveRequestRecordSync(req, body) {
+  async saveCurrentSession() {
     if (!this.currentSession) {
       return;
     }
-    const key = getReqID(req);
-    const recordingId = this.recordingIdCounter++;
-    req.__recordingId = recordingId;
-    const record = {
-      request: {
-        method: req.method,
-        url: req.url,
-        headers: req.headers,
-        body: body || null
-      },
-      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      key,
-      recordingId
-    };
-    this.currentSession.recordings.push(record);
+    await this.flushPendingRecordings();
     console.log(
-      // eslint-disable-next-line sonarjs/no-nested-template-literals
-      `saveRequestRecordSync: Saved ${req.method} ${req.url} (key: ${key}, recordingId: ${recordingId}, body: ${body ? `${body.length} chars` : "null"}, total: ${this.currentSession.recordings.length}, sessionId: ${this.currentSession.id})`
+      `Saving session with ${this.currentSession.recordings.length} HTTP and ${this.currentSession.websocketRecordings.length} WebSocket recordings`
     );
+    await saveRecordingSession(this.recordingsDir, this.currentSession);
   }
-  updateRequestBodySync(req, body) {
-    if (!this.currentSession) {
-      return;
-    }
-    const recordingId = req.__recordingId;
-    if (recordingId === void 0) {
-      console.error(
-        `updateRequestBodySync: No recording ID found on request ${req.method} ${req.url}`
-      );
-      return;
-    }
-    const record = this.currentSession.recordings.find(
-      (r) => r.recordingId === recordingId
-    );
-    if (!record) {
-      console.error(
-        `updateRequestBodySync: Could not find recording with ID ${recordingId} for ${req.method} ${req.url}`
-      );
-      return;
+  getRecordingIdOrError(req, res) {
+    const recordingId = this.getRecordingIdFromRequest(req) || this.replayId;
+    if (!recordingId) {
+      const corsHeaders = this.getCorsHeaders(req);
+      res.writeHead(HTTP_STATUS_BAD_REQUEST, {
+        "Content-Type": "application/json",
+        ...corsHeaders
+      });
+      res.end(JSON.stringify({ error: "No replay session active" }));
+      return null;
     }
-    record.request.body = body || null;
-    console.log(
-      `updateRequestBodySync: Updated body for ${req.method} ${req.url} (${body.length} chars, recordingId: ${recordingId})`
-    );
+    return recordingId;
   }
-  async recordResponse(req, proxyRes) {
-    if (!this.currentSession) {
-      return;
-    }
-    const recordingId = req.__recordingId;
-    if (recordingId === void 0) {
-      console.error(
-        `recordResponse: No recording ID found on request ${req.method} ${req.url}`
-      );
-      return;
+  async ensureSessionLoaded(recordingId, filePath) {
+    const sessionState = this.getOrCreateReplaySession(recordingId);
+    if (!sessionState.loadedSession) {
+      sessionState.loadedSession = await loadRecordingSession(filePath);
+      console.log(`[REPLAY] Loaded recording session: ${recordingId}`);
     }
-    const record = this.currentSession.recordings.find(
-      (r) => r.recordingId === recordingId
-    );
-    if (!record) {
-      console.error(
-        `recordResponse: Could not find recording with ID ${recordingId} for ${req.method} ${req.url}`
-      );
-      return;
-    }
-    const chunks = [];
-    proxyRes.on("data", (chunk) => {
-      chunks.push(chunk);
-    });
-    proxyRes.on("end", async () => {
-      const body = Buffer.concat(chunks).toString("utf8");
-      record.response = {
-        statusCode: proxyRes.statusCode,
-        headers: proxyRes.headers,
-        body: body || null
-      };
-      console.log(
-        `Recorded: ${req.method} ${req.url} (recordingId: ${recordingId})`
-      );
-    });
+    return sessionState;
   }
-  async recordResponseData(req, proxyRes, body) {
-    if (!this.currentSession) {
-      return false;
+  getServedTracker(sessionState, key) {
+    if (!sessionState.servedRecordingIdsByKey.has(key)) {
+      sessionState.servedRecordingIdsByKey.set(key, /* @__PURE__ */ new Set());
     }
-    const recordingId = req.__recordingId;
-    if (recordingId === void 0) {
-      console.error(
-        `recordResponseData: No recording ID found on request ${req.method} ${req.url}`
-      );
-      return false;
+    return sessionState.servedRecordingIdsByKey.get(key);
+  }
+  selectReplayRecord(recordsWithKey, servedForThisKey, key, recordingId) {
+    for (const rec of recordsWithKey) {
+      if (!servedForThisKey.has(rec.recordingId)) {
+        return rec;
+      }
     }
-    const record = this.currentSession.recordings.find(
-      (r) => r.recordingId === recordingId
-    );
-    if (!record) {
-      console.error(
-        `recordResponseData: Could not find recording with ID ${recordingId} for ${req.method} ${req.url}`
+    if (recordsWithKey.length > 0) {
+      console.log(
+        `[REPLAY WARNING] All ${recordsWithKey.length} recordings already served for ${key} (session: ${recordingId}), reusing last one`
       );
-      return false;
+      return recordsWithKey[recordsWithKey.length - 1];
     }
-    record.response = {
-      statusCode: proxyRes.statusCode,
-      headers: proxyRes.headers,
-      body: body || null
-    };
-    console.log(
-      `recordResponseData: Recorded response for ${req.method} ${req.url} (recordingId: ${recordingId})`
-    );
-    return true;
+    return null;
   }
   async handleReplayRequest(req, res) {
-    const recordingId = this.getRecordingIdFromCookie(req) || this.replayId;
-    if (!recordingId) {
-      const corsHeaders = this.getCorsHeaders(req);
-      res.writeHead(HTTP_STATUS_BAD_REQUEST, {
-        "Content-Type": "application/json",
-        ...corsHeaders
-      });
-      res.end(JSON.stringify({ error: "No replay session active" }));
-      return;
-    }
+    const recordingId = this.getRecordingIdOrError(req, res);
+    if (!recordingId) return;
     const key = getReqID(req);
     const filePath = getRecordingPath(this.recordingsDir, recordingId);
     try {
-      const sessionState = this.getOrCreateReplaySession(recordingId);
-      if (!sessionState.loadedSession) {
-        sessionState.loadedSession = await loadRecordingSession(filePath);
-        console.log(`[REPLAY] Loaded recording session: ${recordingId}`);
-      }
+      const sessionState = await this.ensureSessionLoaded(
+        recordingId,
+        filePath
+      );
       const session = sessionState.loadedSession;
-      if (!sessionState.servedRecordingIdsByKey.has(key)) {
-        sessionState.servedRecordingIdsByKey.set(key, /* @__PURE__ */ new Set());
-      }
-      const servedForThisKey = sessionState.servedRecordingIdsByKey.get(key);
+      const servedForThisKey = this.getServedTracker(sessionState, key);
       const host = req.headers.host || "unknown";
       const recordsWithKey = session.recordings.filter((r) => r.key === key && r.response).toSorted((a, b) => {
         const aSeq = a.sequence !== void 0 ? a.sequence : a.recordingId;
@@ -556,30 +512,23 @@ var ProxyServer = class {
       }
       const requestCount = servedForThisKey.size + 1;
       console.log(
-        `[replay request #${requestCount}] ${req.method} ${req.url} (session: ${recordingId}, total: ${recordsWithKey.length}, served: ${servedForThisKey.size})`
+        `[replay request #${requestCount}] ${req.method} ${req.url} (key: ${key}, session: ${recordingId}, total: ${recordsWithKey.length}, served: ${servedForThisKey.size})`
       );
-      let record;
-      for (const rec of recordsWithKey) {
-        if (!servedForThisKey.has(rec.recordingId)) {
-          record = rec;
-          break;
-        }
-      }
-      if (!record) {
-        console.log(
-          `[REPLAY WARNING] All ${recordsWithKey.length} recordings already served for ${key} (session: ${recordingId}), reusing last one`
+      const record = this.selectReplayRecord(
+        recordsWithKey,
+        servedForThisKey,
+        key,
+        recordingId
+      );
+      if (!record || !record.response) {
+        throw new Error(
+          `No response recorded for this request: ${req.method} ${host}${req.url}`
         );
-        record = recordsWithKey[recordsWithKey.length - 1];
       }
       servedForThisKey.add(record.recordingId);
       console.log(
         `[replay serving] recordingId: ${record.recordingId}, session: ${recordingId}, body_len: ${record.response?.body?.length || 0}`
       );
-      if (!record.response) {
-        throw new Error(
-          `No response recorded for this request: ${req.method} ${host}${req.url}`
-        );
-      }
       const { statusCode, headers, body } = record.response;
       const responseHeaders = {
         ...headers,
@@ -634,82 +583,124 @@ var ProxyServer = class {
     const target = this.getTarget();
     console.log(`[${this.mode}] ${req.method} ${req.url} -> ${target}`);
     if (this.mode === Modes.record) {
-      this.saveRequestRecordSync(req, null);
-      await this.bufferAndProxyRequest(req, res, target);
+      await this.recordAndProxyRequest(req, res, target);
     } else {
       this.proxy.web(req, res, { target });
     }
   }
-  // TODO: check if can handle streaming requests
-  async bufferAndProxyRequest(req, res, target) {
-    const chunks = [];
-    req.on("data", (chunk) => {
-      chunks.push(chunk);
-    });
-    try {
-      await new Promise((resolve, reject) => {
-        req.on("end", () => resolve());
-        req.on("error", (err) => reject(err));
-        setTimeout(
-          () => reject(new Error("Request buffering timeout")),
-          3e4
-        );
-      });
-    } catch (error) {
-      console.error("Error buffering request:", error);
-    }
-    const body = Buffer.concat(chunks).toString("utf8");
-    this.updateRequestBodySync(req, body);
-    const targetUrl = new URL(target);
-    const isHttps = targetUrl.protocol === "https:";
-    const requestModule = isHttps ? https__default.default : http__default.default;
-    const defaultPort = isHttps ? 443 : 80;
-    const proxyReq = requestModule.request(
-      {
-        hostname: targetUrl.hostname,
-        port: targetUrl.port || defaultPort,
-        path: req.url,
-        method: req.method,
-        headers: req.headers
-      },
-      (proxyRes) => {
-        this.addCorsHeaders(proxyRes, req);
-        const responseChunks = [];
-        proxyRes.on("data", (chunk) => {
-          responseChunks.push(chunk);
-        });
-        proxyRes.on("end", async () => {
-          const responseBody = Buffer.concat(responseChunks);
-          const recorded = await this.recordResponseData(
-            req,
-            proxyRes,
-            responseBody.toString("utf8")
-          );
-          const responseHeaders = {
-            ...proxyRes.headers,
-            ...this.getCorsHeaders(req)
-          };
-          res.writeHead(proxyRes.statusCode || 200, responseHeaders);
-          res.end(responseBody);
-          if (recorded) {
-            console.log(`Recorded: ${req.method} ${req.url}`);
+  // Note: streaming requests are buffered before proxying; streaming passthrough is not yet implemented
+  async recordAndProxyRequest(req, res, target) {
+    if (!this.currentSession) {
+      return;
+    }
+    const key = getReqID(req);
+    const recordingId = this.recordingIdCounter++;
+    const sequence = this.sequenceCounterByKey.get(key) || 0;
+    this.sequenceCounterByKey.set(key, sequence + 1);
+    const recordingPromise = new Promise((resolve) => {
+      (async () => {
+        try {
+          const chunks = [];
+          req.on("data", (chunk) => {
+            chunks.push(chunk);
+          });
+          try {
+            await new Promise((resolveBuffer, rejectBuffer) => {
+              req.on("end", () => resolveBuffer());
+              req.on("error", (err) => rejectBuffer(err));
+              setTimeout(
+                () => rejectBuffer(new Error("Request buffering timeout")),
+                3e4
+              );
+            });
+          } catch (error) {
+            console.error("Error buffering request:", error);
           }
-        });
-        proxyRes.on("error", (err) => {
-          console.error("Proxy response error:", err);
-          if (!res.headersSent) {
+          const requestBody = Buffer.concat(chunks).toString("utf8");
+          const targetUrl = new URL(target);
+          const isHttps = targetUrl.protocol === "https:";
+          const requestModule = isHttps ? https__default.default : http__default.default;
+          const defaultPort = isHttps ? 443 : 80;
+          const proxyReq = requestModule.request(
+            {
+              hostname: targetUrl.hostname,
+              port: targetUrl.port || defaultPort,
+              path: req.url,
+              method: req.method,
+              headers: req.headers
+            },
+            (proxyRes) => {
+              this.addCorsHeaders(proxyRes, req);
+              const responseChunks = [];
+              proxyRes.on("data", (chunk) => {
+                responseChunks.push(chunk);
+              });
+              proxyRes.on("end", async () => {
+                try {
+                  const responseBody = Buffer.concat(responseChunks);
+                  const responseBodyStr = responseBody.toString("utf8");
+                  const recording = {
+                    request: {
+                      method: req.method,
+                      url: req.url,
+                      headers: req.headers,
+                      body: requestBody || null
+                    },
+                    response: {
+                      statusCode: proxyRes.statusCode,
+                      headers: proxyRes.headers,
+                      body: responseBodyStr || null
+                    },
+                    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                    key,
+                    recordingId,
+                    sequence
+                  };
+                  const responseHeaders = {
+                    ...proxyRes.headers,
+                    ...this.getCorsHeaders(req)
+                  };
+                  res.writeHead(proxyRes.statusCode || 200, responseHeaders);
+                  res.end(responseBody);
+                  console.log(
+                    `Recorded: ${req.method} ${req.url} (recordingId: ${recordingId}, sequence: ${sequence})`
+                  );
+                  resolve(recording);
+                } catch (error) {
+                  console.error("Error completing recording:", error);
+                  resolve(null);
+                }
+              });
+              proxyRes.on("error", (err) => {
+                console.error("Proxy response error:", err);
+                if (!res.headersSent) {
+                  this.handleProxyError(err, req, res);
+                }
+                resolve(null);
+              });
+            }
+          );
+          proxyReq.on("error", (err) => {
             this.handleProxyError(err, req, res);
+            resolve(null);
+          });
+          if (chunks.length > 0) {
+            proxyReq.write(Buffer.concat(chunks));
           }
-        });
-      }
-    );
-    proxyReq.on("error", (err) => {
-      this.handleProxyError(err, req, res);
+          proxyReq.end();
+        } catch (error) {
+          console.error("Error in recordAndProxyRequest:", error);
+          try {
+            this.handleProxyError(error, req, res);
+          } catch (error_) {
+            console.error("Failed to handle proxy error:", error_);
+          }
+          resolve(null);
+        }
+      })();
     });
-    if (chunks.length > 0) {
-      proxyReq.write(Buffer.concat(chunks));
-    }
-    proxyReq.end();
+    this.recordingPromises.push(recordingPromise);
+    await recordingPromise;
   }
   handleUpgrade(req, socket, head) {
     if (this.mode === Modes.replay) {
@@ -954,23 +945,29 @@ async function stopProxy(testInfo) {
 }
 var playwrightProxy = {
   /**
-   * Setup before test - sets the proxy mode
+   * Setup before test - sets the proxy mode and configures page with custom header
+   * Automatically sets up page.on('close') handler for cleanup
+   * @param page - Playwright page object
    * @param testInfo - Playwright test info object
    * @param mode - The proxy mode to use for this test
    * @param timeout - Optional timeout in milliseconds
    */
-  async before(testInfo, mode, timeout) {
+  async before(page, testInfo, mode, timeout) {
     const sessionId = generateSessionId(testInfo);
+    await page.setExtraHTTPHeaders({
+      [RECORDING_ID_HEADER]: sessionId
+    });
     await setProxyMode(mode, sessionId, timeout);
-  },
-  /**
-   * Cleanup after test - resets replay session by re-entering replay mode
-   * switchToReplayMode automatically clears sequence counters
-   * @param testInfo - Playwright test info object
-   */
-  async after(testInfo) {
-    const sessionId = generateSessionId(testInfo);
-    await setProxyMode(Modes.replay, sessionId);
+    page.on("close", async () => {
+      try {
+        await setProxyMode(Modes.replay, sessionId);
+        console.log(
+          `[Cleanup] Switched to replay mode for session: ${sessionId}`
+        );
+      } catch (error) {
+        console.error("[Cleanup] Error during page close cleanup:", error);
+      }
+    });
   },
   /**
    * Global teardown - switches proxy to transparent mode
@@ -981,9 +978,45 @@ var playwrightProxy = {
   }
 };
 
+// src/nextjs/middleware.ts
+function isRecorderEnabled() {
+  const isProduction = process.env.NODE_ENV === "production";
+  const isExplicitlyEnabled = process.env.TEST_PROXY_RECORDER_ENABLED === "true" || Number.parseInt(process.env.TEST_PROXY_RECORDER_ENABLED || "") === 1;
+  return !isProduction || isExplicitlyEnabled;
+}
+function setNextProxyHeaders(request, response) {
+  if (!isRecorderEnabled()) {
+    return;
+  }
+  const recordingId = request.headers.get(RECORDING_ID_HEADER);
+  if (recordingId) {
+    response.headers.set(RECORDING_ID_HEADER, recordingId);
+  }
+}
+function getRecordingId(requestHeaders) {
+  if (requestHeaders instanceof Headers) {
+    return requestHeaders.get(RECORDING_ID_HEADER);
+  }
+  return requestHeaders.headers.get(RECORDING_ID_HEADER);
+}
+function createHeadersWithRecordingId(requestHeaders, additionalHeaders = {}) {
+  if (!isRecorderEnabled()) {
+    return additionalHeaders;
+  }
+  const recordingId = getRecordingId(requestHeaders);
+  return {
+    ...additionalHeaders,
+    ...recordingId && { [RECORDING_ID_HEADER]: recordingId }
+  };
+}
+
 exports.ProxyServer = ProxyServer;
+exports.RECORDING_ID_HEADER = RECORDING_ID_HEADER;
+exports.createHeadersWithRecordingId = createHeadersWithRecordingId;
 exports.generateSessionId = generateSessionId;
+exports.getRecordingId = getRecordingId;
 exports.playwrightProxy = playwrightProxy;
+exports.setNextProxyHeaders = setNextProxyHeaders;
 exports.setProxyMode = setProxyMode;
 exports.startRecording = startRecording;
 exports.startReplay = startReplay;