@doppelgangerdev/doppelganger 0.5.6 → 0.5.7

package/agent.js

@@ -110,11 +110,17 @@ async function overshootScroll(page, targetY) {
     }
 }
 
-const punctuationPause = /[.,!?;:]/;
-
-const randomBetween = (min, max) => min + Math.random() * (max - min);
-
-async function humanType(page, selector, text, options = {}) {
+const punctuationPause = /[.,!?;:]/;
+
+const randomBetween = (min, max) => min + Math.random() * (max - min);
+const parseBooleanFlag = (value) => {
+    if (typeof value === 'boolean') return value;
+    if (value === undefined || value === null) return false;
+    const normalized = String(value).toLowerCase();
+    return normalized === 'true' || normalized === '1';
+};
+
+async function humanType(page, selector, text, options = {}) {
     const { allowTypos = false, naturalTyping = false, fatigue = false } = options;
     if (selector) await page.focus(selector);
     const chars = text.split('');
@@ -166,12 +172,16 @@ async function handleAgent(req, res) {
     let { url, actions, wait: globalWait, rotateUserAgents, rotateProxies, humanTyping, stealth = {} } = data;
     const runId = data.runId ? String(data.runId) : null;
     const captureRunId = runId || `run_${Date.now()}_unknown`;
-    const includeShadowDomRaw = data.includeShadowDom ?? req.query.includeShadowDom;
-    const includeShadowDom = includeShadowDomRaw === undefined
-        ? true
-        : !(String(includeShadowDomRaw).toLowerCase() === 'false' || includeShadowDomRaw === false);
-    const {
-        allowTypos = false,
+    const includeShadowDomRaw = data.includeShadowDom ?? req.query.includeShadowDom;
+    const includeShadowDom = includeShadowDomRaw === undefined
+        ? true
+        : !(String(includeShadowDomRaw).toLowerCase() === 'false' || includeShadowDomRaw === false);
+    const disableRecordingRaw = data.disableRecording ?? req.query.disableRecording;
+    const disableRecording = parseBooleanFlag(disableRecordingRaw);
+    const statelessExecutionRaw = data.statelessExecution ?? req.query.statelessExecution;
+    const statelessExecution = parseBooleanFlag(statelessExecutionRaw);
+    const {
+        allowTypos = false,
         idleMovements = false,
         overscroll = false,
         deadClicks = false,
@@ -434,21 +444,24 @@ async function handleAgent(req, res) {
             ? { width: 1280 + Math.floor(Math.random() * 640), height: 720 + Math.floor(Math.random() * 360) }
             : { width: 1366, height: 768 };
 
-        const contextOptions = {
-            userAgent: selectedUA,
-            viewport,
-            deviceScaleFactor: 1,
-            locale: 'en-US',
-            timezoneId: 'America/New_York',
-            colorScheme: 'dark',
-            permissions: ['geolocation'],
-            recordVideo: { dir: recordingsDir, size: viewport }
-        };
-
-        if (fs.existsSync(STORAGE_STATE_FILE)) {
-            contextOptions.storageState = STORAGE_STATE_FILE;
-        }
-
+        const contextOptions = {
+            userAgent: selectedUA,
+            viewport,
+            deviceScaleFactor: 1,
+            locale: 'en-US',
+            timezoneId: 'America/New_York',
+            colorScheme: 'dark',
+            permissions: ['geolocation'],
+        };
+
+        const shouldUseStorageState = !statelessExecution && fs.existsSync(STORAGE_STATE_FILE);
+        if (shouldUseStorageState) {
+            contextOptions.storageState = STORAGE_STATE_FILE;
+        }
+
+        if (!disableRecording) {
+            contextOptions.recordVideo = { dir: recordingsDir, size: viewport };
+        }
         context = await browser.newContext(contextOptions);
 
         await context.addInitScript(() => {
@@ -1434,7 +1447,9 @@ async function handleAgent(req, res) {
         };
 
         const video = page.video();
-        try { await context.storageState({ path: STORAGE_STATE_FILE }); } catch {}
+        if (!statelessExecution) {
+            try { await context.storageState({ path: STORAGE_STATE_FILE }); } catch {}
+        }
         try { await context.close(); } catch {}
         if (video) {
             try {