@taodigital/crawler 0.0.0-stage → 1.2.1

package/dist/advanced-ui-probes.js

@@ -0,0 +1,310 @@
+async function detectDragAndDrop(page) {
+  const detected = await page.evaluate(() => {
+    if (document.querySelector("[data-dnd-kit-draggable]")) {
+      return {
+        library: "dnd-kit",
+        draggableCount: document.querySelectorAll("[data-dnd-kit-draggable]").length,
+        dropZoneCount: document.querySelectorAll("[data-dnd-kit-droppable]").length
+      };
+    }
+    if (document.querySelector("[data-rbd-draggable-id]")) {
+      return {
+        library: "react-beautiful-dnd",
+        draggableCount: document.querySelectorAll("[data-rbd-draggable-id]").length,
+        dropZoneCount: document.querySelectorAll("[data-rbd-droppable-id]").length
+      };
+    }
+    if (document.querySelector(".sortable-ghost") || document.querySelector("[data-sortable]")) {
+      return {
+        library: "sortablejs",
+        draggableCount: document.querySelectorAll("[data-sortable], .sortable-item").length,
+        dropZoneCount: document.querySelectorAll("[data-sortable-list], .sortable-list").length
+      };
+    }
+    const html5Draggables = document.querySelectorAll('[draggable="true"]');
+    if (html5Draggables.length > 0) {
+      return {
+        library: "html5",
+        draggableCount: html5Draggables.length,
+        dropZoneCount: document.querySelectorAll("[data-drop-target], [ondrop], .drop-zone").length
+      };
+    }
+    return { library: "none", draggableCount: 0, dropZoneCount: 0 };
+  });
+  if (detected.library === "none") {
+    return { ...detected, testAttempted: false, testCompleted: false };
+  }
+  let testAttempted = false;
+  let testCompleted = false;
+  try {
+    if (detected.library === "html5" && detected.draggableCount >= 2) {
+      const sources = await page.$$('[draggable="true"]');
+      if (sources.length >= 2) {
+        testAttempted = true;
+        await page.dragAndDrop('[draggable="true"]:nth-child(1)', '[draggable="true"]:nth-child(2)');
+        testCompleted = true;
+      }
+    } else if (detected.draggableCount >= 2) {
+      const draggableSel = detected.library === "dnd-kit" ? "[data-dnd-kit-draggable]" : detected.library === "react-beautiful-dnd" ? "[data-rbd-draggable-id]" : "[data-sortable], .sortable-item";
+      const elements = await page.$$(draggableSel);
+      if (elements.length >= 2) {
+        testAttempted = true;
+        const src = elements[0];
+        const dst = elements[1];
+        const srcBox = await src.boundingBox();
+        const dstBox = await dst.boundingBox();
+        if (srcBox && dstBox) {
+          const srcX = srcBox.x + srcBox.width / 2;
+          const srcY = srcBox.y + srcBox.height / 2;
+          const dstX = dstBox.x + dstBox.width / 2;
+          const dstY = dstBox.y + dstBox.height / 2;
+          await page.mouse.move(srcX, srcY);
+          await page.mouse.down();
+          const steps = 10;
+          for (let i = 1; i <= steps; i++) {
+            await page.mouse.move(
+              srcX + (dstX - srcX) * i / steps,
+              srcY + (dstY - srcY) * i / steps
+            );
+          }
+          await page.mouse.up();
+          testCompleted = true;
+        }
+      }
+    }
+  } catch {
+  }
+  return { ...detected, testAttempted, testCompleted };
+}
+async function captureDatePickers(page) {
+  const results = [];
+  const nativeInputs = await page.$$('input[type="date"], input[type="datetime-local"]');
+  for (const input of nativeInputs.slice(0, 5)) {
+    try {
+      const attrs = await input.evaluate((el) => ({
+        type: el.type,
+        min: el.min || void 0,
+        max: el.max || void 0,
+        id: el.id || "",
+        name: el.name || ""
+      }));
+      let fieldLabel = attrs.id || attrs.name || "unknown";
+      if (attrs.id) {
+        const lblText = await page.evaluate((id) => {
+          const lbl = document.querySelector(`label[for="${id}"]`);
+          return lbl ? (lbl.textContent ?? "").trim() : null;
+        }, attrs.id);
+        if (lblText) fieldLabel = lblText;
+      }
+      let sampleSelectedValue;
+      try {
+        await input.fill("2026-09-15");
+        sampleSelectedValue = await input.inputValue();
+        if (!sampleSelectedValue) sampleSelectedValue = void 0;
+      } catch {
+      }
+      results.push({
+        fieldLabel,
+        pickerType: attrs.type === "datetime-local" ? "native-datetime" : "native-date",
+        minDate: attrs.min,
+        maxDate: attrs.max,
+        disabledDatesFound: false,
+        // native inputs have no visual disabled cells
+        sampleSelectedValue
+      });
+    } catch {
+    }
+  }
+  const customInputs = await page.$$('input:not([type="date"]):not([type="datetime-local"]):not([type="hidden"])');
+  for (const input of customInputs.slice(0, 5)) {
+    if (results.length >= 5) break;
+    try {
+      await input.click();
+      const calendarAppeared = await page.waitForSelector('[role="grid"]', { timeout: 2e3 }).then(() => true).catch(() => false);
+      if (!calendarAppeared) {
+        await page.keyboard.press("Escape");
+        continue;
+      }
+      const monthHeader = await page.evaluate(() => {
+        const header = document.querySelector('[role="grid"] caption, [role="columnheader"], .calendar-header, .rdp-caption');
+        return header ? (header.textContent ?? "").trim().slice(0, 60) : "";
+      });
+      const disabledCount = await page.evaluate(
+        () => document.querySelectorAll('[role="gridcell"][aria-disabled="true"], [role="gridcell"].disabled').length
+      );
+      const inputId = await input.evaluate((el) => el.id || el.name || "");
+      let fieldLabel = inputId || "datepicker";
+      if (inputId) {
+        const lblText = await page.evaluate((id) => {
+          const lbl = document.querySelector(`label[for="${id}"]`);
+          return lbl ? (lbl.textContent ?? "").trim() : null;
+        }, inputId);
+        if (lblText) fieldLabel = lblText;
+      }
+      let sampleSelectedValue;
+      try {
+        const firstEnabled = await page.$('[role="gridcell"]:not([aria-disabled="true"]):not(.disabled)');
+        if (firstEnabled) {
+          await firstEnabled.click();
+          sampleSelectedValue = await input.inputValue().catch(() => void 0);
+        }
+      } catch {
+      }
+      await page.keyboard.press("Escape");
+      results.push({
+        fieldLabel,
+        pickerType: "calendar-popup",
+        disabledDatesFound: disabledCount > 0,
+        sampleSelectedValue: sampleSelectedValue || void 0
+      });
+    } catch {
+      try {
+        await page.keyboard.press("Escape");
+      } catch {
+      }
+    }
+  }
+  return results;
+}
+async function captureSliders(page) {
+  const results = [];
+  const handles = await page.$$('input[type="range"], [role="slider"]');
+  for (const handle of handles.slice(0, 5)) {
+    try {
+      const attrs = await handle.evaluate((el) => {
+        const min = parseFloat(el.min ?? el.getAttribute("aria-valuemin") ?? "0");
+        const max = parseFloat(el.max ?? el.getAttribute("aria-valuemax") ?? "100");
+        const step = parseFloat(el.step ?? el.getAttribute("aria-valuestep") ?? "1") || 1;
+        const value = parseFloat(el.value ?? el.getAttribute("aria-valuenow") ?? String(min));
+        const id = el.id || el.name || "";
+        return { min, max, step, value, id };
+      });
+      let label = attrs.id || "slider";
+      if (attrs.id) {
+        const lblText = await page.evaluate((id) => {
+          const lbl = document.querySelector(`label[for="${id}"]`);
+          return lbl ? (lbl.textContent ?? "").trim() : null;
+        }, attrs.id);
+        if (lblText) label = lblText;
+      }
+      const isNative = await handle.evaluate((el) => el.tagName.toLowerCase() === "input");
+      if (isNative) {
+        try {
+          await handle.fill(String(attrs.min));
+          await handle.fill(String(attrs.max));
+          await handle.fill(String(attrs.value));
+        } catch {
+        }
+      }
+      results.push({
+        label,
+        min: attrs.min,
+        max: attrs.max,
+        step: attrs.step,
+        currentValue: attrs.value
+      });
+    } catch {
+    }
+  }
+  return results;
+}
+async function captureTypeaheads(page) {
+  const results = [];
+  const candidates = await page.$$(
+    '[role="combobox"][aria-autocomplete], [aria-autocomplete="list"], input.autocomplete, input[aria-autocomplete]'
+  );
+  for (const input of candidates.slice(0, 3)) {
+    try {
+      const inputId = await input.evaluate((el) => el.id || el.name || el.placeholder || "");
+      let label = inputId || "typeahead";
+      if (inputId) {
+        const lblText = await page.evaluate((id) => {
+          const lbl = document.querySelector(`label[for="${id}"]`);
+          return lbl ? (lbl.textContent ?? "").trim() : null;
+        }, inputId);
+        if (lblText) label = lblText;
+      }
+      await input.click();
+      await input.fill("");
+      await input.type("a", { delay: 100 });
+      await page.waitForTimeout(500);
+      let listboxVisible = await page.evaluate(() => {
+        const lb = document.querySelector('[role="listbox"]');
+        if (!lb) return false;
+        const style = window.getComputedStyle(lb);
+        return style.display !== "none" && style.visibility !== "hidden";
+      });
+      let minCharsToTrigger = listboxVisible ? 1 : 2;
+      if (!listboxVisible) {
+        await input.type("b", { delay: 100 });
+        await page.waitForTimeout(500);
+        listboxVisible = await page.evaluate(() => {
+          const lb = document.querySelector('[role="listbox"]');
+          if (!lb) return false;
+          const style = window.getComputedStyle(lb);
+          return style.display !== "none" && style.visibility !== "hidden";
+        });
+        if (listboxVisible) minCharsToTrigger = 2;
+      }
+      const sampleSuggestions = [];
+      if (listboxVisible) {
+        const suggestions = await page.evaluate(
+          () => Array.from(document.querySelectorAll('[role="option"]')).slice(0, 8).map((o) => (o.textContent ?? "").trim()).filter(Boolean)
+        );
+        sampleSuggestions.push(...suggestions);
+      }
+      await input.fill("ZZXQQ_NORESULT_9999");
+      await page.waitForTimeout(500);
+      const noResultsText = await page.evaluate(() => {
+        const selectors = [
+          '[role="listbox"] [role="option"]',
+          '[role="status"]',
+          ".no-results",
+          ".empty-message",
+          '[data-testid*="no-result"]'
+        ];
+        for (const sel of selectors) {
+          const el = document.querySelector(sel);
+          if (el) {
+            const txt = (el.textContent ?? "").trim();
+            if (txt) return txt.slice(0, 120);
+          }
+        }
+        return null;
+      });
+      await input.fill("");
+      results.push({
+        label,
+        minCharsToTrigger,
+        sampleSuggestions,
+        noResultsText
+      });
+    } catch {
+      try {
+        await input.fill("");
+      } catch {
+      }
+    }
+  }
+  return results;
+}
+async function probeAdvancedUI(page) {
+  const defaultDragDrop = {
+    library: "none",
+    draggableCount: 0,
+    dropZoneCount: 0,
+    testAttempted: false,
+    testCompleted: false
+  };
+  const [dragDrop, datePickers, sliders, typeaheads] = await Promise.all([
+    detectDragAndDrop(page).catch(() => defaultDragDrop),
+    captureDatePickers(page).catch(() => []),
+    captureSliders(page).catch(() => []),
+    captureTypeaheads(page).catch(() => [])
+  ]);
+  return { dragDrop, datePickers, sliders, typeaheads };
+}
+export {
+  probeAdvancedUI
+};
+//# sourceMappingURL=advanced-ui-probes.js.map

package/dist/advanced-ui-probes.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/advanced-ui-probes.ts"],
+  "sourcesContent": ["/**\n * Advanced UI probes \u2014 detect and exercise drag-drop, date pickers, sliders,\n * and typeahead/autocomplete widgets on a crawled page.\n *\n * Results feed ZeTa's test generator so it can emit interaction-level test\n * cases for these widget families instead of falling back to generic clicks.\n *\n * Each probe is independently try/caught so a broken widget does not abort\n * the others. All browser-side code runs inside page.evaluate / page.$$eval\n * to avoid serialisation issues with DOM handles.\n */\n\nimport type { Page } from 'playwright';\n\n// ---------------------------------------------------------------------------\n// Public interfaces\n// ---------------------------------------------------------------------------\n\nexport interface DragDropCapture {\n  library: 'html5' | 'dnd-kit' | 'react-beautiful-dnd' | 'sortablejs' | 'pointer-event' | 'none';\n  draggableCount: number;\n  dropZoneCount: number;\n  testAttempted: boolean;\n  testCompleted: boolean;\n}\n\nexport interface DatePickerCapture {\n  fieldLabel: string;\n  pickerType: 'calendar-popup' | 'native-date' | 'native-datetime' | 'none';\n  minDate?: string;\n  maxDate?: string;\n  disabledDatesFound: boolean;\n  sampleSelectedValue?: string;\n}\n\nexport interface SliderCapture {\n  label: string;\n  min: number;\n  max: number;\n  step: number;\n  currentValue: number;\n}\n\nexport interface TypeaheadCapture {\n  label: string;\n  minCharsToTrigger: number;\n  sampleSuggestions: string[];\n  noResultsText: string | null;\n}\n\nexport interface AdvancedProbeResult {\n  dragDrop: DragDropCapture;\n  datePickers: DatePickerCapture[];\n  sliders: SliderCapture[];\n  typeaheads: TypeaheadCapture[];\n}\n\n// ---------------------------------------------------------------------------\n// Internal: drag-and-drop detection\n// ---------------------------------------------------------------------------\n\nasync function detectDragAndDrop(page: Page): Promise<DragDropCapture> {\n  // Detect library and count elements in the browser context\n  const detected = await page.evaluate((): {\n    library: DragDropCapture['library'];\n    draggableCount: number;\n    dropZoneCount: number;\n  } => {\n    // dnd-kit\n    if (document.querySelector('[data-dnd-kit-draggable]')) {\n      return {\n        library: 'dnd-kit',\n        draggableCount: document.querySelectorAll('[data-dnd-kit-draggable]').length,\n        dropZoneCount: document.querySelectorAll('[data-dnd-kit-droppable]').length,\n      };\n    }\n    // react-beautiful-dnd\n    if (document.querySelector('[data-rbd-draggable-id]')) {\n      return {\n        library: 'react-beautiful-dnd',\n        draggableCount: document.querySelectorAll('[data-rbd-draggable-id]').length,\n        dropZoneCount: document.querySelectorAll('[data-rbd-droppable-id]').length,\n      };\n    }\n    // SortableJS\n    if (document.querySelector('.sortable-ghost') || document.querySelector('[data-sortable]')) {\n      return {\n        library: 'sortablejs',\n        draggableCount: document.querySelectorAll('[data-sortable], .sortable-item').length,\n        dropZoneCount: document.querySelectorAll('[data-sortable-list], .sortable-list').length,\n      };\n    }\n    // Native HTML5 draggable\n    const html5Draggables = document.querySelectorAll('[draggable=\"true\"]');\n    if (html5Draggables.length > 0) {\n      return {\n        library: 'html5',\n        draggableCount: html5Draggables.length,\n        dropZoneCount: document.querySelectorAll('[data-drop-target], [ondrop], .drop-zone').length,\n      };\n    }\n    return { library: 'none', draggableCount: 0, dropZoneCount: 0 };\n  });\n\n  if (detected.library === 'none') {\n    return { ...detected, testAttempted: false, testCompleted: false };\n  }\n\n  let testAttempted = false;\n  let testCompleted = false;\n\n  try {\n    if (detected.library === 'html5' && detected.draggableCount >= 2) {\n      // Attempt a real dragAndDrop between the first two draggable elements\n      const sources = await page.$$('[draggable=\"true\"]');\n      if (sources.length >= 2) {\n        testAttempted = true;\n        await page.dragAndDrop('[draggable=\"true\"]:nth-child(1)', '[draggable=\"true\"]:nth-child(2)');\n        testCompleted = true;\n      }\n    } else if (detected.draggableCount >= 2) {\n      // Pointer-event simulation for library-managed drag\n      const draggableSel =\n        detected.library === 'dnd-kit' ? '[data-dnd-kit-draggable]' :\n        detected.library === 'react-beautiful-dnd' ? '[data-rbd-draggable-id]' :\n        '[data-sortable], .sortable-item';\n\n      const elements = await page.$$(draggableSel);\n      if (elements.length >= 2) {\n        testAttempted = true;\n        const src = elements[0];\n        const dst = elements[1];\n        const srcBox = await src.boundingBox();\n        const dstBox = await dst.boundingBox();\n\n        if (srcBox && dstBox) {\n          const srcX = srcBox.x + srcBox.width / 2;\n          const srcY = srcBox.y + srcBox.height / 2;\n          const dstX = dstBox.x + dstBox.width / 2;\n          const dstY = dstBox.y + dstBox.height / 2;\n\n          await page.mouse.move(srcX, srcY);\n          await page.mouse.down();\n          // Move in small steps to allow drag handlers to fire\n          const steps = 10;\n          for (let i = 1; i <= steps; i++) {\n            await page.mouse.move(\n              srcX + ((dstX - srcX) * i) / steps,\n              srcY + ((dstY - srcY) * i) / steps,\n            );\n          }\n          await page.mouse.up();\n          testCompleted = true;\n        }\n      }\n    }\n  } catch {\n    // testCompleted remains false \u2014 that is the signal to the caller\n  }\n\n  return { ...detected, testAttempted, testCompleted };\n}\n\n// ---------------------------------------------------------------------------\n// Internal: date pickers\n// ---------------------------------------------------------------------------\n\nasync function captureDatePickers(page: Page): Promise<DatePickerCapture[]> {\n  const results: DatePickerCapture[] = [];\n\n  // Native date / datetime-local inputs\n  const nativeInputs = await page.$$('input[type=\"date\"], input[type=\"datetime-local\"]');\n  for (const input of nativeInputs.slice(0, 5)) {\n    try {\n      const attrs = await input.evaluate((el: any) => ({\n        type: el.type as string,\n        min: el.min || undefined,\n        max: el.max || undefined,\n        id: el.id || '',\n        name: el.name || '',\n      }));\n\n      // Resolve label text\n      let fieldLabel = attrs.id || attrs.name || 'unknown';\n      if (attrs.id) {\n        const lblText = await page.evaluate((id: string) => {\n          const lbl = document.querySelector(`label[for=\"${id}\"]`);\n          return lbl ? (lbl.textContent ?? '').trim() : null;\n        }, attrs.id);\n        if (lblText) fieldLabel = lblText;\n      }\n\n      // Try filling a known date and reading it back\n      let sampleSelectedValue: string | undefined;\n      try {\n        await input.fill('2026-09-15');\n        sampleSelectedValue = await input.inputValue();\n        if (!sampleSelectedValue) sampleSelectedValue = undefined;\n      } catch {\n        // ignore fill errors\n      }\n\n      results.push({\n        fieldLabel,\n        pickerType: attrs.type === 'datetime-local' ? 'native-datetime' : 'native-date',\n        minDate: attrs.min,\n        maxDate: attrs.max,\n        disabledDatesFound: false, // native inputs have no visual disabled cells\n        sampleSelectedValue,\n      });\n    } catch {\n      // skip this element\n    }\n  }\n\n  // Calendar-popup pickers (custom widgets triggered by click)\n  // Only look for inputs not already classified as native date inputs\n  const customInputs = await page.$$('input:not([type=\"date\"]):not([type=\"datetime-local\"]):not([type=\"hidden\"])');\n  for (const input of customInputs.slice(0, 5)) {\n    if (results.length >= 5) break;\n\n    try {\n      await input.click();\n      // Wait up to 2 s for a calendar grid to appear\n      const calendarAppeared = await page.waitForSelector('[role=\"grid\"]', { timeout: 2000 })\n        .then(() => true)\n        .catch(() => false);\n\n      if (!calendarAppeared) {\n        await page.keyboard.press('Escape');\n        continue;\n      }\n\n      // Capture month/year header\n      const monthHeader = await page.evaluate(() => {\n        const header = document.querySelector('[role=\"grid\"] caption, [role=\"columnheader\"], .calendar-header, .rdp-caption');\n        return header ? (header.textContent ?? '').trim().slice(0, 60) : '';\n      });\n\n      // Count disabled cells\n      const disabledCount = await page.evaluate(() =>\n        document.querySelectorAll('[role=\"gridcell\"][aria-disabled=\"true\"], [role=\"gridcell\"].disabled').length\n      );\n\n      // Resolve label for this input\n      const inputId = await input.evaluate((el: any) => el.id || el.name || '');\n      let fieldLabel = inputId || 'datepicker';\n      if (inputId) {\n        const lblText = await page.evaluate((id: string) => {\n          const lbl = document.querySelector(`label[for=\"${id}\"]`);\n          return lbl ? (lbl.textContent ?? '').trim() : null;\n        }, inputId);\n        if (lblText) fieldLabel = lblText;\n      }\n\n      // Click the first enabled cell and read value\n      let sampleSelectedValue: string | undefined;\n      try {\n        const firstEnabled = await page.$('[role=\"gridcell\"]:not([aria-disabled=\"true\"]):not(.disabled)');\n        if (firstEnabled) {\n          await firstEnabled.click();\n          sampleSelectedValue = await input.inputValue().catch(() => undefined);\n        }\n      } catch {\n        // ignore\n      }\n\n      await page.keyboard.press('Escape');\n\n      results.push({\n        fieldLabel,\n        pickerType: 'calendar-popup',\n        disabledDatesFound: disabledCount > 0,\n        sampleSelectedValue: sampleSelectedValue || undefined,\n      });\n    } catch {\n      try { await page.keyboard.press('Escape'); } catch { /* ignore */ }\n    }\n  }\n\n  return results;\n}\n\n// ---------------------------------------------------------------------------\n// Internal: sliders\n// ---------------------------------------------------------------------------\n\nasync function captureSliders(page: Page): Promise<SliderCapture[]> {\n  const results: SliderCapture[] = [];\n\n  // Collect both native range inputs and ARIA sliders\n  const handles = await page.$$('input[type=\"range\"], [role=\"slider\"]');\n\n  for (const handle of handles.slice(0, 5)) {\n    try {\n      const attrs = await handle.evaluate((el: any) => {\n        const min = parseFloat(el.min ?? el.getAttribute('aria-valuemin') ?? '0');\n        const max = parseFloat(el.max ?? el.getAttribute('aria-valuemax') ?? '100');\n        const step = parseFloat(el.step ?? el.getAttribute('aria-valuestep') ?? '1') || 1;\n        const value = parseFloat(el.value ?? el.getAttribute('aria-valuenow') ?? String(min));\n        const id = el.id || el.name || '';\n        return { min, max, step, value, id };\n      });\n\n      // Resolve label\n      let label = attrs.id || 'slider';\n      if (attrs.id) {\n        const lblText = await page.evaluate((id: string) => {\n          const lbl = document.querySelector(`label[for=\"${id}\"]`);\n          return lbl ? (lbl.textContent ?? '').trim() : null;\n        }, attrs.id);\n        if (lblText) label = lblText;\n      }\n\n      // Exercise fill to min then max then restore (native range only)\n      const isNative = await handle.evaluate((el: any) => el.tagName.toLowerCase() === 'input');\n      if (isNative) {\n        try {\n          await handle.fill(String(attrs.min));\n          await handle.fill(String(attrs.max));\n          await handle.fill(String(attrs.value));\n        } catch {\n          // ignore \u2014 read-only or detached\n        }\n      }\n\n      results.push({\n        label,\n        min: attrs.min,\n        max: attrs.max,\n        step: attrs.step,\n        currentValue: attrs.value,\n      });\n    } catch {\n      // skip this element\n    }\n  }\n\n  return results;\n}\n\n// ---------------------------------------------------------------------------\n// Internal: typeahead / autocomplete\n// ---------------------------------------------------------------------------\n\nasync function captureTypeaheads(page: Page): Promise<TypeaheadCapture[]> {\n  const results: TypeaheadCapture[] = [];\n\n  // Candidate selectors for typeahead inputs\n  const candidates = await page.$$(\n    '[role=\"combobox\"][aria-autocomplete], [aria-autocomplete=\"list\"], input.autocomplete, input[aria-autocomplete]'\n  );\n\n  for (const input of candidates.slice(0, 3)) {\n    try {\n      const inputId = await input.evaluate((el: any) => el.id || el.name || el.placeholder || '');\n\n      // Resolve label\n      let label = inputId || 'typeahead';\n      if (inputId) {\n        const lblText = await page.evaluate((id: string) => {\n          const lbl = document.querySelector(`label[for=\"${id}\"]`);\n          return lbl ? (lbl.textContent ?? '').trim() : null;\n        }, inputId);\n        if (lblText) label = lblText;\n      }\n\n      await input.click();\n      await input.fill('');\n\n      // Type 'a' and check whether a listbox appears\n      await input.type('a', { delay: 100 });\n      await page.waitForTimeout(500);\n\n      let listboxVisible = await page.evaluate(() => {\n        const lb = document.querySelector('[role=\"listbox\"]');\n        if (!lb) return false;\n        const style = window.getComputedStyle(lb);\n        return style.display !== 'none' && style.visibility !== 'hidden';\n      });\n\n      let minCharsToTrigger = listboxVisible ? 1 : 2;\n\n      if (!listboxVisible) {\n        // Try a second character\n        await input.type('b', { delay: 100 });\n        await page.waitForTimeout(500);\n        listboxVisible = await page.evaluate(() => {\n          const lb = document.querySelector('[role=\"listbox\"]');\n          if (!lb) return false;\n          const style = window.getComputedStyle(lb);\n          return style.display !== 'none' && style.visibility !== 'hidden';\n        });\n        if (listboxVisible) minCharsToTrigger = 2;\n      }\n\n      // Collect suggestion text from visible options\n      const sampleSuggestions: string[] = [];\n      if (listboxVisible) {\n        const suggestions = await page.evaluate(() =>\n          Array.from(document.querySelectorAll('[role=\"option\"]'))\n            .slice(0, 8)\n            .map(o => (o.textContent ?? '').trim())\n            .filter(Boolean)\n        );\n        sampleSuggestions.push(...suggestions);\n      }\n\n      // Type a nonsense string to capture the \"no results\" message\n      await input.fill('ZZXQQ_NORESULT_9999');\n      await page.waitForTimeout(500);\n\n      const noResultsText = await page.evaluate(() => {\n        // Common no-results patterns\n        const selectors = [\n          '[role=\"listbox\"] [role=\"option\"]',\n          '[role=\"status\"]',\n          '.no-results',\n          '.empty-message',\n          '[data-testid*=\"no-result\"]',\n        ];\n        for (const sel of selectors) {\n          const el = document.querySelector(sel);\n          if (el) {\n            const txt = (el.textContent ?? '').trim();\n            if (txt) return txt.slice(0, 120);\n          }\n        }\n        return null;\n      });\n\n      // Clear the input to leave the page in a clean state\n      await input.fill('');\n\n      results.push({\n        label,\n        minCharsToTrigger,\n        sampleSuggestions,\n        noResultsText,\n      });\n    } catch {\n      try { await input.fill(''); } catch { /* ignore */ }\n    }\n  }\n\n  return results;\n}\n\n// ---------------------------------------------------------------------------\n// Public orchestrator\n// ---------------------------------------------------------------------------\n\nexport async function probeAdvancedUI(page: Page): Promise<AdvancedProbeResult> {\n  const defaultDragDrop: DragDropCapture = {\n    library: 'none',\n    draggableCount: 0,\n    dropZoneCount: 0,\n    testAttempted: false,\n    testCompleted: false,\n  };\n\n  const [dragDrop, datePickers, sliders, typeaheads] = await Promise.all([\n    detectDragAndDrop(page).catch((): DragDropCapture => defaultDragDrop),\n    captureDatePickers(page).catch((): DatePickerCapture[] => []),\n    captureSliders(page).catch((): SliderCapture[] => []),\n    captureTypeaheads(page).catch((): TypeaheadCapture[] => []),\n  ]);\n\n  return { dragDrop, datePickers, sliders, typeaheads };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/ai-login.d.ts

@@ -0,0 +1,32 @@
+import type { Stagehand } from '@browserbasehq/stagehand';
+import type { Credentials } from './auth.js';
+/**
+ * Recorded login step from the Chrome extension's step recorder.
+ * {username} and {password} in `value` are substituted at replay time.
+ */
+export interface LoginStep {
+    action: 'fill' | 'click' | 'wait';
+    selector: string;
+    value?: string;
+    ms?: number;
+}
+/**
+ * AI-guided login using Stagehand act/extract.
+ *
+ * @param loginInstructions - Optional natural language description of the login flow.
+ *   When provided, an initial stagehand.act() is called with these instructions to
+ *   navigate the UI (e.g. "click Sign In in the nav, fill email, click Continue").
+ *   The standard 3-step credential fill follows immediately after.
+ * @param opts - Optional tenant/project/job IDs for writing AUTH_STEP CrawlEvidence.
+ */
+export declare function loginWithStagehand(stagehand: Stagehand, creds: Credentials, startUrl: string, captchaOpts?: {
+    apiKey?: string;
+    provider?: '2captcha' | 'capsolver';
+}, emailOtpOpts?: {
+    apiKey?: string;
+    inboxId?: string;
+}, loginInstructions?: string, opts?: {
+    tenantId?: string;
+    projectId?: string;
+    jobId?: string;
+}): Promise<boolean>;

package/dist/ai-login.js

@@ -0,0 +1,250 @@
+import { z } from "zod";
+import { AppBrain } from "@taodigital/app-brain";
+import { solveCaptcha } from "./captcha-solver.js";
+import { waitForEmailContent } from "./email-otp.js";
+import { logger } from "./logger.js";
+import { simulateMouseMovement } from "./stealth/human-behavior.js";
+const CLICK_INTENT = /\b(click|tap|press|submit|select|choose|toggle)\b/i;
+function isNoObjectGeneratedError(err) {
+  const name = String(err?.name ?? "");
+  const msg = String(err?.message ?? "");
+  return name.includes("NoObjectGenerated") || msg.includes("NoObjectGenerated") || msg.includes("No object generated");
+}
+async function actWithMouseSim(stagehand, instruction) {
+  if (CLICK_INTENT.test(instruction)) {
+    try {
+      const pg = await stagehand.resolvePage();
+      const viewport = pg.viewportSize() ?? { width: 1280, height: 720 };
+      const targetX = viewport.width * 0.3 + Math.random() * viewport.width * 0.4;
+      const targetY = viewport.height * 0.2 + Math.random() * viewport.height * 0.5;
+      await simulateMouseMovement(pg, targetX, targetY);
+    } catch {
+    }
+  }
+  return stagehand.act(instruction);
+}
+const TwoFASchema = z.object({
+  has2FA: z.boolean(),
+  fieldLabel: z.string().optional()
+});
+const CAPTCHA_SELECTORS = [
+  'iframe[src*="recaptcha"]',
+  'iframe[src*="hcaptcha"]',
+  'iframe[src*="challenges.cloudflare.com"]',
+  ".cf-turnstile",
+  "[data-sitekey]",
+  "#captcha",
+  ".captcha",
+  '[id*="captcha"]',
+  '[class*="captcha"]'
+];
+async function loginWithStagehand(stagehand, creds, startUrl, captchaOpts, emailOtpOpts, loginInstructions, opts) {
+  async function logStep(step, fn) {
+    const t0 = Date.now();
+    try {
+      const r = await fn();
+      const result = { success: true, detail: r?.description ?? r?.message ?? step };
+      if (opts?.tenantId && opts?.projectId) {
+        AppBrain.saveCrawlEvidence(opts.tenantId, opts.projectId, {
+          jobId: opts?.jobId,
+          type: "AUTH_STEP",
+          payload: { step, ...result, ms: Date.now() - t0 }
+        }).catch(() => {
+        });
+      }
+      return result;
+    } catch (e) {
+      const result = { success: false, detail: e.message ?? "failed" };
+      if (opts?.tenantId && opts?.projectId) {
+        AppBrain.saveCrawlEvidence(opts.tenantId, opts.projectId, {
+          jobId: opts?.jobId,
+          type: "AUTH_STEP",
+          payload: { step, ...result, ms: Date.now() - t0 }
+        }).catch(() => {
+        });
+      }
+      throw e;
+    }
+  }
+  try {
+    const pg = await stagehand.resolvePage();
+    for (const sel of CAPTCHA_SELECTORS) {
+      const count = await pg.locator(sel).count().catch(() => 0);
+      if (count > 0) {
+        logger.warn({ selector: sel }, "[crawler] CAPTCHA detected on login page");
+        if (captchaOpts?.apiKey) {
+          logger.info({ provider: captchaOpts.provider ?? "2captcha" }, "[crawler] Attempting auto-solve");
+          try {
+            const result = await solveCaptcha(pg, startUrl, captchaOpts.apiKey, captchaOpts.provider ?? "2captcha");
+            if (result) {
+              logger.info({ provider: result.provider }, "[crawler] CAPTCHA solved \u2014 proceeding with login");
+              break;
+            }
+          } catch (solveErr) {
+            logger.warn({ err: solveErr }, "[crawler] CAPTCHA solve failed \u2014 falling back to manual error");
+            throw new Error(`CAPTCHA_DETECTED: Auto-solve failed (${String(solveErr)}). Use session capture instead.`);
+          }
+        } else {
+          throw new Error(
+            'CAPTCHA_DETECTED: Login page has a CAPTCHA. Use "Session Capture \u2192 Launch Browser" to log in manually, then capture the session. Alternatively, disable CAPTCHA for the ZeTa crawler IP.'
+          );
+        }
+        break;
+      }
+    }
+    const MAX_LOGIN_INSTRUCTIONS = 2e3;
+    if (loginInstructions && loginInstructions.length > MAX_LOGIN_INSTRUCTIONS) {
+      throw new Error(`loginInstructions exceeds ${MAX_LOGIN_INSTRUCTIONS} character limit`);
+    }
+    if (loginInstructions) {
+      await logStep("custom_recipe", async () => {
+        try {
+          return await actWithMouseSim(stagehand, loginInstructions);
+        } catch (err) {
+          if (!isNoObjectGeneratedError(err)) throw err;
+          logger.warn("[crawler] custom_recipe act() failed \u2014 Stagehand V3 elementId schema error, skipping to standard fill");
+          return { description: "custom_recipe skipped (schema error)" };
+        }
+      });
+      await pg.waitForLoadState("networkidle").catch(() => pg.waitForTimeout(1500));
+    }
+    await logStep("fill_username", async () => {
+      try {
+        return await actWithMouseSim(stagehand, `Type "${creds.username}" into the username or email input field`);
+      } catch (err) {
+        if (!isNoObjectGeneratedError(err)) throw err;
+        logger.warn("[crawler] fill_username act() failed \u2014 falling back to DOM");
+        const sel = 'input[type="email"], input[autocomplete="email"], input[autocomplete="username"], input[name*="email" i], input[name*="user" i], input[placeholder*="email" i], input[placeholder*="user" i], input[id*="email" i], input[id*="user" i]';
+        await pg.locator(sel).first().fill(creds.username);
+        return { description: "fill_username via DOM fallback" };
+      }
+    });
+    await logStep("fill_password", async () => {
+      const observations = await stagehand.observe("Find the password input field");
+      const selector = observations[0]?.selector || 'input[type="password"]';
+      try {
+        await pg.locator(selector).fill(creds.password);
+      } catch {
+        await pg.evaluate((pwd) => {
+          const input = document.querySelector('input[type="password"]');
+          if (!input) throw new Error("No password field found on page");
+          const setter = Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, "value")?.set;
+          setter?.call(input, pwd);
+          input.dispatchEvent(new Event("input", { bubbles: true }));
+          input.dispatchEvent(new Event("change", { bubbles: true }));
+        }, creds.password);
+      }
+    });
+    await logStep("click_submit", async () => {
+      try {
+        return await actWithMouseSim(stagehand, "Click the sign in, log in, login, or continue button to submit credentials");
+      } catch (err) {
+        if (!isNoObjectGeneratedError(err)) throw err;
+        logger.warn("[crawler] click_submit act() failed \u2014 falling back to DOM");
+        const sel = 'button[type="submit"], input[type="submit"], button:has-text("Sign in"), button:has-text("Log in"), button:has-text("Login"), button:has-text("Continue"), button:has-text("Next"), button:has-text("Sign In"), [role="button"]:has-text("Sign in"), [role="button"]:has-text("Login")';
+        await pg.locator(sel).first().click();
+        await pg.waitForTimeout(500);
+        return { description: "click_submit via DOM fallback" };
+      }
+    });
+    await pg.waitForLoadState("networkidle").catch(() => pg.waitForTimeout(2e3));
+    const twoFA = await stagehand.extract(
+      "Is there a two-factor authentication, OTP, or verification code input visible right now?",
+      TwoFASchema
+    );
+    if (twoFA.has2FA) {
+      if (opts?.tenantId && opts?.projectId) {
+        AppBrain.saveCrawlEvidence(opts.tenantId, opts.projectId, {
+          jobId: opts?.jobId,
+          type: "AUTH_STEP",
+          payload: { step: "2fa_detect", success: true, detail: twoFA.fieldLabel ?? "2FA detected", ms: 0 }
+        }).catch(() => {
+        });
+      }
+      let code = creds.oneTimeCode ?? await creds.getOneTimeCode?.();
+      if (!code && emailOtpOpts?.apiKey && emailOtpOpts?.inboxId) {
+        const since = (/* @__PURE__ */ new Date()).toISOString();
+        logger.info("[crawler] 2FA detected \u2014 waiting for email OTP or magic link via MailSlurp");
+        const emailContent = await waitForEmailContent(
+          { provider: "mailslurp", apiKey: emailOtpOpts.apiKey, inboxId: emailOtpOpts.inboxId },
+          since
+        );
+        if (emailContent?.magicLink) {
+          logger.info({ url: emailContent.magicLink }, "[crawler] Magic link received \u2014 navigating");
+          await pg.goto(emailContent.magicLink, { waitUntil: "domcontentloaded" });
+          await pg.waitForLoadState("networkidle").catch(() => {
+          });
+          return true;
+        }
+        code = emailContent?.otp ?? void 0;
+        if (code) {
+          logger.info("[crawler] Email OTP received");
+        } else {
+          logger.warn("[crawler] Email OTP timed out after 60s");
+        }
+      }
+      if (!code) {
+        console.warn("[crawler] 2FA detected but no oneTimeCode provided");
+        return false;
+      }
+      await logStep("2fa_inject", async () => {
+        try {
+          return await actWithMouseSim(stagehand, `Enter "${code}" into the ${twoFA.fieldLabel ?? "verification code"} field`);
+        } catch (err) {
+          if (!isNoObjectGeneratedError(err)) throw err;
+          logger.warn("[crawler] 2fa_inject act() failed \u2014 falling back to DOM");
+          const sel = 'input[autocomplete="one-time-code"], input[name*="otp" i], input[name*="code" i], input[name*="token" i], input[inputmode="numeric"], input[type="number"]';
+          await pg.locator(sel).first().fill(code);
+          return { description: "2fa_inject via DOM fallback" };
+        }
+      });
+      await logStep("2fa_submit", async () => {
+        try {
+          return await actWithMouseSim(stagehand, "Click verify or confirm to submit the verification code");
+        } catch (err) {
+          if (!isNoObjectGeneratedError(err)) throw err;
+          logger.warn("[crawler] 2fa_submit act() failed \u2014 falling back to DOM");
+          const sel = 'button[type="submit"], button:has-text("Verify"), button:has-text("Confirm"), button:has-text("Submit"), button:has-text("Continue")';
+          await pg.locator(sel).first().click();
+          return { description: "2fa_submit via DOM fallback" };
+        }
+      });
+      await pg.waitForLoadState("networkidle").catch(() => pg.waitForTimeout(2e3));
+    }
+    const currentUrl = pg.url();
+    const loginPathPattern = /\/(login|signin|sign-in|auth|authenticate|log-in|account\/login)(\?|$|\/)/i;
+    try {
+      const { pathname } = new URL(currentUrl);
+      const wasRedirected = currentUrl !== startUrl;
+      const stillOnLoginPath = loginPathPattern.test(pathname);
+      if (wasRedirected && !stillOnLoginPath) {
+        logger.info({ url: currentUrl }, "Login confirmed via URL change");
+        return true;
+      }
+    } catch {
+    }
+    const passwordCount = await pg.locator('input[type="password"]').count().catch(() => 1);
+    const bodyText = await pg.evaluate(() => document.body?.innerText?.trim()?.length ?? 0).catch(() => 0);
+    if (passwordCount === 0 && bodyText > 30) {
+      logger.info("Login confirmed: password field no longer visible");
+      return true;
+    }
+    logger.warn({ url: currentUrl }, "Login appears failed");
+    try {
+      const screenshotPath = `/tmp/zeta-auth-failure-${Date.now()}.jpg`;
+      await pg.screenshot({ path: screenshotPath, type: "jpeg", quality: 70, fullPage: false });
+      logger.warn({ screenshotPath }, "[crawler] Auth failure screenshot saved");
+    } catch {
+    }
+    return false;
+  } catch (err) {
+    const msg = String(err.message ?? err);
+    if (msg.includes("CAPTCHA_DETECTED")) throw err;
+    logger.error({ err }, "Login error");
+    return false;
+  }
+}
+export {
+  loginWithStagehand
+};
+//# sourceMappingURL=ai-login.js.map