@taodigital/crawler 0.0.0-stage → 1.2.1

package/dist/crud-interaction.d.ts

@@ -0,0 +1,31 @@
+import type { Page } from 'playwright';
+export type EditFlowType = 'inline' | 'modal' | 'navigation' | 'unknown';
+export interface CrudFlowCapture {
+    entityName: string;
+    createTrigger?: string;
+    editFlowType: EditFlowType;
+    editFields: Array<{
+        name: string;
+        type: string;
+        prefilledValue?: string;
+    }>;
+    deleteConfirmation?: {
+        message: string;
+        confirmLabel: string;
+        cancelLabel: string;
+    };
+    createSuccessToast?: string;
+    editSuccessToast?: string;
+    rowCount: number;
+    hasDeleteButton: boolean;
+    hasEditButton: boolean;
+}
+export interface CrudProbeResult {
+    flows: CrudFlowCapture[];
+    toastsObserved: Array<{
+        action: string;
+        text: string;
+        role: string;
+    }>;
+}
+export declare function probeCrudFlows(page: Page, entityName?: string): Promise<CrudProbeResult>;

package/dist/crud-interaction.js

@@ -0,0 +1,264 @@
+function injectToastObserver(page) {
+  page.evaluate(() => {
+    if (window.__toastObserver) return;
+    window.__capturedToasts = [];
+    const TOAST_CLASSES = ["toast", "snackbar", "notification"];
+    function matchesToast(el) {
+      const role = el.getAttribute("role") ?? "";
+      if (role === "alert" || role === "status") return true;
+      const cls = (el.getAttribute("class") ?? "").toLowerCase();
+      return TOAST_CLASSES.some((t) => cls.includes(t));
+    }
+    function captureNode(node) {
+      if (!(node instanceof Element)) return;
+      if (matchesToast(node)) {
+        const text = (node.innerText ?? "").replace(/\s+/g, " ").trim();
+        const role = node.getAttribute("role") ?? "alert";
+        if (text) window.__capturedToasts.push({ text, role });
+      }
+      node.querySelectorAll('[role="alert"],[role="status"],[class*="toast"],[class*="Toast"],[class*="snackbar"],[class*="notification"]').forEach((child) => {
+        const text = (child.innerText ?? "").replace(/\s+/g, " ").trim();
+        const role = child.getAttribute("role") ?? "alert";
+        if (text) window.__capturedToasts.push({ text, role });
+      });
+    }
+    const observer = new MutationObserver((mutations) => {
+      for (const m of mutations) {
+        m.addedNodes.forEach(captureNode);
+      }
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    window.__toastObserver = observer;
+  }).catch(() => void 0);
+}
+async function collectCapturedToasts(page) {
+  try {
+    return await page.evaluate(() => {
+      const toasts = window.__capturedToasts ?? [];
+      window.__capturedToasts = [];
+      return toasts;
+    });
+  } catch {
+    return [];
+  }
+}
+async function findCrudButtons(page) {
+  const editLocator = page.locator(
+    'button[aria-label*="edit" i], button[aria-label*="Edit"], button:has-text("Edit")'
+  );
+  const deleteLocator = page.locator(
+    'button[aria-label*="delete" i], button[aria-label*="Delete"], button:has-text("Delete")'
+  );
+  const createLocator = page.locator(
+    'button:has-text("New"), button:has-text("Create"), button:has-text("Add")'
+  );
+  const [editCount, deleteCount, createCount] = await Promise.all([
+    editLocator.count().catch(() => 0),
+    deleteLocator.count().catch(() => 0),
+    createLocator.count().catch(() => 0)
+  ]);
+  const editBtns = [];
+  for (let i = 0; i < Math.min(editCount, 3); i++) {
+    editBtns.push(editLocator.nth(i));
+  }
+  const deleteBtns = [];
+  for (let i = 0; i < Math.min(deleteCount, 3); i++) {
+    deleteBtns.push(deleteLocator.nth(i));
+  }
+  const createBtn = createCount > 0 ? createLocator.first() : null;
+  return { editBtns, deleteBtns, createBtn };
+}
+async function detectEditFlowType(page, editButton) {
+  try {
+    const urlBefore = page.url();
+    await editButton.click({ timeout: 2e3 });
+    await page.waitForTimeout(600);
+    const urlAfter = page.url();
+    if (urlAfter !== urlBefore) {
+      await page.goBack().catch(() => void 0);
+      await page.waitForTimeout(300);
+      return "navigation";
+    }
+    const dialogVisible = await page.locator('[role="dialog"]').first().isVisible().catch(() => false);
+    if (dialogVisible) {
+      await page.keyboard.press("Escape");
+      await page.waitForTimeout(300);
+      return "modal";
+    }
+    const inlineInputCount = await page.locator("input:visible, textarea:visible").count().catch(() => 0);
+    if (inlineInputCount > 0) {
+      await page.keyboard.press("Escape");
+      await page.waitForTimeout(300);
+      return "inline";
+    }
+    await page.keyboard.press("Escape");
+    await page.waitForTimeout(300);
+    return "unknown";
+  } catch {
+    try {
+      await page.keyboard.press("Escape");
+    } catch {
+    }
+    return "unknown";
+  }
+}
+async function captureEditModal(page) {
+  try {
+    const dialog = page.locator('[role="dialog"]').first();
+    const fields = dialog.locator("input, textarea, select");
+    const count = Math.min(await fields.count().catch(() => 0), 20);
+    const results = [];
+    for (let i = 0; i < count; i++) {
+      try {
+        const field = fields.nth(i);
+        const tagName = await field.evaluate((el) => el.tagName.toLowerCase()).catch(() => "input");
+        const inputType = await field.getAttribute("type").catch(() => null) ?? tagName;
+        const name = await field.getAttribute("name").catch(() => null) ?? await field.getAttribute("id").catch(() => null) ?? await field.getAttribute("aria-label").catch(() => null) ?? `field_${i}`;
+        const prefilledValue = await field.inputValue().catch(() => void 0);
+        results.push({
+          name,
+          type: inputType,
+          prefilledValue: prefilledValue || void 0
+        });
+      } catch {
+      }
+    }
+    return results;
+  } catch {
+    return [];
+  }
+}
+async function captureDeleteConfirmation(page, deleteBtn) {
+  try {
+    await deleteBtn.click({ timeout: 2e3 });
+    const confirmDialog = page.locator('[role="alertdialog"], [role="dialog"]').first();
+    try {
+      await confirmDialog.waitFor({ state: "visible", timeout: 2e3 });
+    } catch {
+      await page.keyboard.press("Escape");
+      return null;
+    }
+    const dialogText = await confirmDialog.evaluate(
+      (el) => el.innerText?.replace(/\s+/g, " ").trim()
+    ).catch(() => "");
+    const isDeleteDialog = /delete|remove|are you sure|confirm/i.test(dialogText);
+    if (!isDeleteDialog) {
+      await page.keyboard.press("Escape");
+      return null;
+    }
+    const buttons = confirmDialog.locator("button");
+    const btnCount = await buttons.count().catch(() => 0);
+    const btnLabels = [];
+    for (let i = 0; i < btnCount; i++) {
+      try {
+        const label = await buttons.nth(i).innerText();
+        btnLabels.push(label.trim());
+      } catch {
+      }
+    }
+    const confirmLabel = btnLabels.find((l) => /delete|remove|yes|confirm/i.test(l)) ?? btnLabels[0] ?? "Confirm";
+    const cancelLabel = btnLabels.find((l) => /cancel|no|keep|dismiss/i.test(l)) ?? btnLabels[btnLabels.length - 1] ?? "Cancel";
+    await page.keyboard.press("Escape");
+    await page.waitForTimeout(300);
+    return {
+      message: dialogText,
+      confirmLabel,
+      cancelLabel
+    };
+  } catch {
+    try {
+      await page.keyboard.press("Escape");
+    } catch {
+    }
+    return null;
+  }
+}
+async function detectRowCount(page) {
+  try {
+    const tableRows = await page.locator("table tbody tr").count().catch(() => 0);
+    if (tableRows > 0) return tableRows;
+    const listItems = await page.locator('[role="row"]').count().catch(() => 0);
+    if (listItems > 0) return listItems;
+    const dataItems = await page.locator('[data-testid*="row"], [class*="row" i], [class*="item" i]').count().catch(() => 0);
+    return dataItems;
+  } catch {
+    return 0;
+  }
+}
+async function getCreateTriggerLabel(createBtn) {
+  if (!createBtn) return void 0;
+  try {
+    const label = await createBtn.innerText();
+    return label.trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function probeCrudFlows(page, entityName = "Entity") {
+  const toastsObserved = [];
+  injectToastObserver(page);
+  const { editBtns, deleteBtns, createBtn } = await findCrudButtons(page);
+  const rowCount = await detectRowCount(page);
+  const createTrigger = await getCreateTriggerLabel(createBtn);
+  let editFlowType = "unknown";
+  let editFields = [];
+  if (editBtns.length > 0) {
+    try {
+      editFlowType = await detectEditFlowType(page, editBtns[0]);
+      if (editFlowType === "modal") {
+        try {
+          await editBtns[0].click({ timeout: 2e3 });
+          await page.waitForTimeout(400);
+          const dialogVisible = await page.locator('[role="dialog"]').first().isVisible().catch(() => false);
+          if (dialogVisible) {
+            editFields = await captureEditModal(page);
+            const editToasts = await collectCapturedToasts(page);
+            for (const t of editToasts) {
+              toastsObserved.push({ action: "edit_open", ...t });
+            }
+          }
+          await page.keyboard.press("Escape");
+          await page.waitForTimeout(300);
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  let deleteConfirmation;
+  if (deleteBtns.length > 0) {
+    try {
+      const result = await captureDeleteConfirmation(page, deleteBtns[0]);
+      if (result) {
+        deleteConfirmation = result;
+        const deleteToasts = await collectCapturedToasts(page);
+        for (const t of deleteToasts) {
+          toastsObserved.push({ action: "delete_cancel", ...t });
+        }
+      }
+    } catch {
+    }
+  }
+  const remainingToasts = await collectCapturedToasts(page);
+  for (const t of remainingToasts) {
+    toastsObserved.push({ action: "ambient", ...t });
+  }
+  const flow = {
+    entityName,
+    createTrigger,
+    editFlowType,
+    editFields,
+    deleteConfirmation,
+    rowCount,
+    hasDeleteButton: deleteBtns.length > 0,
+    hasEditButton: editBtns.length > 0
+  };
+  return {
+    flows: [flow],
+    toastsObserved
+  };
+}
+export {
+  probeCrudFlows
+};
+//# sourceMappingURL=crud-interaction.js.map

package/dist/crud-interaction.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/crud-interaction.ts"],
+  "sourcesContent": ["import type { Page, Locator } from 'playwright';\n\n// \u2500\u2500 Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type EditFlowType = 'inline' | 'modal' | 'navigation' | 'unknown';\n\nexport interface CrudFlowCapture {\n  entityName: string;\n  createTrigger?: string;\n  editFlowType: EditFlowType;\n  editFields: Array<{ name: string; type: string; prefilledValue?: string }>;\n  deleteConfirmation?: { message: string; confirmLabel: string; cancelLabel: string };\n  createSuccessToast?: string;\n  editSuccessToast?: string;\n  rowCount: number;\n  hasDeleteButton: boolean;\n  hasEditButton: boolean;\n}\n\nexport interface CrudProbeResult {\n  flows: CrudFlowCapture[];\n  toastsObserved: Array<{ action: string; text: string; role: string }>;\n}\n\n// \u2500\u2500 Internal: Toast observer \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nfunction injectToastObserver(page: Page): void {\n  page.evaluate(() => {\n    if ((window as any).__toastObserver) return;\n\n    (window as any).__capturedToasts = [] as Array<{ text: string; role: string }>;\n\n    const TOAST_CLASSES = ['toast', 'snackbar', 'notification'];\n\n    function matchesToast(el: Element): boolean {\n      const role = el.getAttribute('role') ?? '';\n      if (role === 'alert' || role === 'status') return true;\n      const cls = (el.getAttribute('class') ?? '').toLowerCase();\n      return TOAST_CLASSES.some((t) => cls.includes(t));\n    }\n\n    function captureNode(node: Node): void {\n      if (!(node instanceof Element)) return;\n      if (matchesToast(node)) {\n        const text = ((node as HTMLElement).innerText ?? '').replace(/\\s+/g, ' ').trim();\n        const role = node.getAttribute('role') ?? 'alert';\n        if (text) (window as any).__capturedToasts.push({ text, role });\n      }\n      node.querySelectorAll('[role=\"alert\"],[role=\"status\"],[class*=\"toast\"],[class*=\"Toast\"],[class*=\"snackbar\"],[class*=\"notification\"]').forEach((child) => {\n        const text = ((child as HTMLElement).innerText ?? '').replace(/\\s+/g, ' ').trim();\n        const role = child.getAttribute('role') ?? 'alert';\n        if (text) (window as any).__capturedToasts.push({ text, role });\n      });\n    }\n\n    const observer = new MutationObserver((mutations) => {\n      for (const m of mutations) {\n        m.addedNodes.forEach(captureNode);\n      }\n    });\n\n    observer.observe(document.body, { childList: true, subtree: true });\n    (window as any).__toastObserver = observer;\n  }).catch(() => undefined);\n}\n\nasync function collectCapturedToasts(page: Page): Promise<Array<{ text: string; role: string }>> {\n  try {\n    return await page.evaluate(() => {\n      const toasts: Array<{ text: string; role: string }> = (window as any).__capturedToasts ?? [];\n      (window as any).__capturedToasts = [];\n      return toasts;\n    });\n  } catch {\n    return [];\n  }\n}\n\n// \u2500\u2500 Internal: Button discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\ninterface CrudButtons {\n  editBtns: Locator[];\n  deleteBtns: Locator[];\n  createBtn: Locator | null;\n}\n\nasync function findCrudButtons(page: Page): Promise<CrudButtons> {\n  const editLocator = page.locator(\n    'button[aria-label*=\"edit\" i], button[aria-label*=\"Edit\"], button:has-text(\"Edit\")'\n  );\n  const deleteLocator = page.locator(\n    'button[aria-label*=\"delete\" i], button[aria-label*=\"Delete\"], button:has-text(\"Delete\")'\n  );\n  const createLocator = page.locator(\n    'button:has-text(\"New\"), button:has-text(\"Create\"), button:has-text(\"Add\")'\n  );\n\n  const [editCount, deleteCount, createCount] = await Promise.all([\n    editLocator.count().catch(() => 0),\n    deleteLocator.count().catch(() => 0),\n    createLocator.count().catch(() => 0),\n  ]);\n\n  const editBtns: Locator[] = [];\n  for (let i = 0; i < Math.min(editCount, 3); i++) {\n    editBtns.push(editLocator.nth(i));\n  }\n\n  const deleteBtns: Locator[] = [];\n  for (let i = 0; i < Math.min(deleteCount, 3); i++) {\n    deleteBtns.push(deleteLocator.nth(i));\n  }\n\n  const createBtn = createCount > 0 ? createLocator.first() : null;\n\n  return { editBtns, deleteBtns, createBtn };\n}\n\n// \u2500\u2500 Internal: Edit flow detection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nasync function detectEditFlowType(page: Page, editButton: Locator): Promise<EditFlowType> {\n  try {\n    const urlBefore = page.url();\n    await editButton.click({ timeout: 2000 });\n    await page.waitForTimeout(600);\n\n    const urlAfter = page.url();\n    if (urlAfter !== urlBefore) {\n      await page.goBack().catch(() => undefined);\n      await page.waitForTimeout(300);\n      return 'navigation';\n    }\n\n    const dialogVisible = await page.locator('[role=\"dialog\"]').first().isVisible().catch(() => false);\n    if (dialogVisible) {\n      await page.keyboard.press('Escape');\n      await page.waitForTimeout(300);\n      return 'modal';\n    }\n\n    const inlineInputCount = await page.locator('input:visible, textarea:visible').count().catch(() => 0);\n    if (inlineInputCount > 0) {\n      await page.keyboard.press('Escape');\n      await page.waitForTimeout(300);\n      return 'inline';\n    }\n\n    await page.keyboard.press('Escape');\n    await page.waitForTimeout(300);\n    return 'unknown';\n  } catch {\n    try {\n      await page.keyboard.press('Escape');\n    } catch { /* ignore */ }\n    return 'unknown';\n  }\n}\n\n// \u2500\u2500 Internal: Modal field capture \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nasync function captureEditModal(\n  page: Page\n): Promise<Array<{ name: string; type: string; prefilledValue?: string }>> {\n  try {\n    const dialog = page.locator('[role=\"dialog\"]').first();\n    const fields = dialog.locator('input, textarea, select');\n    const count = Math.min(await fields.count().catch(() => 0), 20);\n\n    const results: Array<{ name: string; type: string; prefilledValue?: string }> = [];\n\n    for (let i = 0; i < count; i++) {\n      try {\n        const field = fields.nth(i);\n        const tagName = await field.evaluate((el) => el.tagName.toLowerCase()).catch(() => 'input');\n        const inputType = await field.getAttribute('type').catch(() => null) ?? tagName;\n        const name =\n          (await field.getAttribute('name').catch(() => null)) ??\n          (await field.getAttribute('id').catch(() => null)) ??\n          (await field.getAttribute('aria-label').catch(() => null)) ??\n          `field_${i}`;\n        const prefilledValue = await field.inputValue().catch(() => undefined);\n\n        results.push({\n          name,\n          type: inputType,\n          prefilledValue: prefilledValue || undefined,\n        });\n      } catch { /* skip individual field errors */ }\n    }\n\n    return results;\n  } catch {\n    return [];\n  }\n}\n\n// \u2500\u2500 Internal: Delete confirmation capture \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nasync function captureDeleteConfirmation(\n  page: Page,\n  deleteBtn: Locator\n): Promise<{ message: string; confirmLabel: string; cancelLabel: string } | null> {\n  try {\n    await deleteBtn.click({ timeout: 2000 });\n\n    const confirmDialog = page.locator('[role=\"alertdialog\"], [role=\"dialog\"]').first();\n    try {\n      await confirmDialog.waitFor({ state: 'visible', timeout: 2000 });\n    } catch {\n      await page.keyboard.press('Escape');\n      return null;\n    }\n\n    const dialogText = await confirmDialog.evaluate((el) =>\n      (el as HTMLElement).innerText?.replace(/\\s+/g, ' ').trim()\n    ).catch(() => '');\n\n    const isDeleteDialog =\n      /delete|remove|are you sure|confirm/i.test(dialogText);\n\n    if (!isDeleteDialog) {\n      await page.keyboard.press('Escape');\n      return null;\n    }\n\n    // Capture button labels inside the dialog\n    const buttons = confirmDialog.locator('button');\n    const btnCount = await buttons.count().catch(() => 0);\n    const btnLabels: string[] = [];\n    for (let i = 0; i < btnCount; i++) {\n      try {\n        const label = await buttons.nth(i).innerText();\n        btnLabels.push(label.trim());\n      } catch { /* skip */ }\n    }\n\n    // Heuristic: confirm = first destructive-looking label, cancel = cancel/no label\n    const confirmLabel =\n      btnLabels.find((l) => /delete|remove|yes|confirm/i.test(l)) ??\n      btnLabels[0] ??\n      'Confirm';\n    const cancelLabel =\n      btnLabels.find((l) => /cancel|no|keep|dismiss/i.test(l)) ??\n      btnLabels[btnLabels.length - 1] ??\n      'Cancel';\n\n    // CRITICAL: Always cancel \u2014 never actually delete data\n    await page.keyboard.press('Escape');\n    await page.waitForTimeout(300);\n\n    return {\n      message: dialogText,\n      confirmLabel,\n      cancelLabel,\n    };\n  } catch {\n    try {\n      await page.keyboard.press('Escape');\n    } catch { /* ignore */ }\n    return null;\n  }\n}\n\n// \u2500\u2500 Internal: Row count \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nasync function detectRowCount(page: Page): Promise<number> {\n  try {\n    // Try common table row patterns\n    const tableRows = await page.locator('table tbody tr').count().catch(() => 0);\n    if (tableRows > 0) return tableRows;\n\n    const listItems = await page.locator('[role=\"row\"]').count().catch(() => 0);\n    if (listItems > 0) return listItems;\n\n    const dataItems = await page\n      .locator('[data-testid*=\"row\"], [class*=\"row\" i], [class*=\"item\" i]')\n      .count()\n      .catch(() => 0);\n    return dataItems;\n  } catch {\n    return 0;\n  }\n}\n\n// \u2500\u2500 Internal: Create trigger label \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nasync function getCreateTriggerLabel(createBtn: Locator | null): Promise<string | undefined> {\n  if (!createBtn) return undefined;\n  try {\n    const label = await createBtn.innerText();\n    return label.trim() || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n// \u2500\u2500 Public: probeCrudFlows \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport async function probeCrudFlows(\n  page: Page,\n  entityName = 'Entity'\n): Promise<CrudProbeResult> {\n  const toastsObserved: Array<{ action: string; text: string; role: string }> = [];\n\n  // Step 1: Inject toast observer\n  injectToastObserver(page);\n\n  // Step 2: Find CRUD buttons\n  const { editBtns, deleteBtns, createBtn } = await findCrudButtons(page);\n\n  // Step 3: Row count\n  const rowCount = await detectRowCount(page);\n\n  // Step 4: Create trigger label\n  const createTrigger = await getCreateTriggerLabel(createBtn);\n\n  // Step 5: Probe edit flow (use first edit button)\n  let editFlowType: EditFlowType = 'unknown';\n  let editFields: Array<{ name: string; type: string; prefilledValue?: string }> = [];\n\n  if (editBtns.length > 0) {\n    try {\n      editFlowType = await detectEditFlowType(page, editBtns[0]);\n\n      if (editFlowType === 'modal') {\n        // Re-open to capture fields\n        try {\n          await editBtns[0].click({ timeout: 2000 });\n          await page.waitForTimeout(400);\n          const dialogVisible = await page\n            .locator('[role=\"dialog\"]')\n            .first()\n            .isVisible()\n            .catch(() => false);\n          if (dialogVisible) {\n            editFields = await captureEditModal(page);\n            const editToasts = await collectCapturedToasts(page);\n            for (const t of editToasts) {\n              toastsObserved.push({ action: 'edit_open', ...t });\n            }\n          }\n          await page.keyboard.press('Escape');\n          await page.waitForTimeout(300);\n        } catch { /* non-fatal */ }\n      }\n    } catch { /* non-fatal */ }\n  }\n\n  // Step 6: Probe delete confirmation (NEVER actually delete)\n  let deleteConfirmation: CrudFlowCapture['deleteConfirmation'];\n\n  if (deleteBtns.length > 0) {\n    try {\n      const result = await captureDeleteConfirmation(page, deleteBtns[0]);\n      if (result) {\n        deleteConfirmation = result;\n        const deleteToasts = await collectCapturedToasts(page);\n        for (const t of deleteToasts) {\n          toastsObserved.push({ action: 'delete_cancel', ...t });\n        }\n      }\n    } catch { /* non-fatal */ }\n  }\n\n  // Step 7: Collect any remaining toasts\n  const remainingToasts = await collectCapturedToasts(page);\n  for (const t of remainingToasts) {\n    toastsObserved.push({ action: 'ambient', ...t });\n  }\n\n  const flow: CrudFlowCapture = {\n    entityName,\n    createTrigger,\n    editFlowType,\n    editFields,\n    deleteConfirmation,\n    rowCount,\n    hasDeleteButton: deleteBtns.length > 0,\n    hasEditButton: editBtns.length > 0,\n  };\n\n  return {\n    flows: [flow],\n    toastsObserved,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/custom-js-injector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Custom JS injector — run user-provided JavaScript in the context of each crawled page.
+ *
+ * Use cases:
+ * - Extract custom data points not captured by standard extractors
+ * - Set localStorage/sessionStorage values before crawl
+ * - Override fetch() to intercept API calls
+ * - Simulate user events (keydown, focus, etc.)
+ * - Bypass specific anti-bot checks
+ *
+ * Security: scripts run in the page context (sandboxed by Chromium's renderer).
+ * They cannot access the Node.js process or file system.
+ * ZeTa validates scripts are strings before injection.
+ */
+import type { Page } from 'playwright';
+export interface JsInjectionOpts {
+    /** Script to run on every page BEFORE navigation (via page.addInitScript) */
+    initScript?: string;
+    /** Script to run on every page AFTER navigation completes (via page.evaluate) */
+    postLoadScript?: string;
+    /** Key-value pairs to set in localStorage before page load */
+    localStorage?: Record<string, string>;
+    /** Key-value pairs to set in sessionStorage before page load */
+    sessionStorage?: Record<string, string>;
+    /** Cookie key-value pairs to add before page load */
+    cookies?: Array<{
+        name: string;
+        value: string;
+        domain?: string;
+        path?: string;
+    }>;
+}
+export interface JsInjectionResult {
+    initScriptApplied: boolean;
+    postLoadResult: unknown;
+    storageSet: boolean;
+    cookiesSet: number;
+    error?: string;
+}
+export declare function injectCustomJs(page: Page, opts: JsInjectionOpts): Promise<JsInjectionResult>;
+/** Safe string validator — ensures script is a string, not an object/function reference */
+export declare function validateScript(script: unknown): string;

package/dist/custom-js-injector.js

@@ -0,0 +1,50 @@
+async function injectCustomJs(page, opts) {
+  const result = {
+    initScriptApplied: false,
+    postLoadResult: null,
+    storageSet: false,
+    cookiesSet: 0
+  };
+  if (opts.cookies?.length) {
+    try {
+      await page.context().addCookies(
+        opts.cookies.map((c) => ({ name: c.name, value: c.value, domain: c.domain ?? "", path: c.path ?? "/", url: page.url() || void 0 }))
+      );
+      result.cookiesSet = opts.cookies.length;
+    } catch (e) {
+      result.error = `Cookie injection failed: ${e.message}`;
+    }
+  }
+  if (opts.initScript || opts.localStorage || opts.sessionStorage) {
+    const storageSetup = [
+      opts.localStorage ? `Object.entries(${JSON.stringify(opts.localStorage)}).forEach(([k,v])=>localStorage.setItem(k,v));` : "",
+      opts.sessionStorage ? `Object.entries(${JSON.stringify(opts.sessionStorage)}).forEach(([k,v])=>sessionStorage.setItem(k,v));` : ""
+    ].filter(Boolean).join("\n");
+    const combinedInit = [storageSetup, opts.initScript ?? ""].filter(Boolean).join("\n");
+    try {
+      await page.addInitScript(combinedInit);
+      result.initScriptApplied = true;
+      result.storageSet = !!(opts.localStorage || opts.sessionStorage);
+    } catch (e) {
+      result.error = `Init script failed: ${e.message}`;
+    }
+  }
+  if (opts.postLoadScript) {
+    try {
+      result.postLoadResult = await page.evaluate(opts.postLoadScript);
+    } catch (e) {
+      result.error = `Post-load script failed: ${e.message}`;
+    }
+  }
+  return result;
+}
+function validateScript(script) {
+  if (typeof script !== "string") throw new Error("Script must be a string");
+  if (script.length > 5e4) throw new Error("Script too large (>50KB)");
+  return script;
+}
+export {
+  injectCustomJs,
+  validateScript
+};
+//# sourceMappingURL=custom-js-injector.js.map

package/dist/custom-js-injector.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/custom-js-injector.ts"],
+  "sourcesContent": ["/**\n * Custom JS injector \u2014 run user-provided JavaScript in the context of each crawled page.\n *\n * Use cases:\n * - Extract custom data points not captured by standard extractors\n * - Set localStorage/sessionStorage values before crawl\n * - Override fetch() to intercept API calls\n * - Simulate user events (keydown, focus, etc.)\n * - Bypass specific anti-bot checks\n *\n * Security: scripts run in the page context (sandboxed by Chromium's renderer).\n * They cannot access the Node.js process or file system.\n * ZeTa validates scripts are strings before injection.\n */\n\nimport type { Page } from 'playwright';\n\nexport interface JsInjectionOpts {\n  /** Script to run on every page BEFORE navigation (via page.addInitScript) */\n  initScript?: string;\n  /** Script to run on every page AFTER navigation completes (via page.evaluate) */\n  postLoadScript?: string;\n  /** Key-value pairs to set in localStorage before page load */\n  localStorage?: Record<string, string>;\n  /** Key-value pairs to set in sessionStorage before page load */\n  sessionStorage?: Record<string, string>;\n  /** Cookie key-value pairs to add before page load */\n  cookies?: Array<{ name: string; value: string; domain?: string; path?: string }>;\n}\n\nexport interface JsInjectionResult {\n  initScriptApplied: boolean;\n  postLoadResult: unknown;\n  storageSet: boolean;\n  cookiesSet: number;\n  error?: string;\n}\n\nexport async function injectCustomJs(page: Page, opts: JsInjectionOpts): Promise<JsInjectionResult> {\n  const result: JsInjectionResult = {\n    initScriptApplied: false,\n    postLoadResult: null,\n    storageSet: false,\n    cookiesSet: 0,\n  };\n\n  // Set cookies via Playwright context\n  if (opts.cookies?.length) {\n    try {\n      await page.context().addCookies(\n        opts.cookies.map(c => ({ name: c.name, value: c.value, domain: c.domain ?? '', path: c.path ?? '/', url: page.url() || undefined }))\n      );\n      result.cookiesSet = opts.cookies.length;\n    } catch (e: any) {\n      result.error = `Cookie injection failed: ${e.message}`;\n    }\n  }\n\n  // Init script (runs before page load on every navigation)\n  if (opts.initScript || opts.localStorage || opts.sessionStorage) {\n    const storageSetup = [\n      opts.localStorage ? `Object.entries(${JSON.stringify(opts.localStorage)}).forEach(([k,v])=>localStorage.setItem(k,v));` : '',\n      opts.sessionStorage ? `Object.entries(${JSON.stringify(opts.sessionStorage)}).forEach(([k,v])=>sessionStorage.setItem(k,v));` : '',\n    ].filter(Boolean).join('\\n');\n\n    const combinedInit = [storageSetup, opts.initScript ?? ''].filter(Boolean).join('\\n');\n    try {\n      await page.addInitScript(combinedInit);\n      result.initScriptApplied = true;\n      result.storageSet = !!(opts.localStorage || opts.sessionStorage);\n    } catch (e: any) {\n      result.error = `Init script failed: ${e.message}`;\n    }\n  }\n\n  // Post-load script (runs after navigation)\n  if (opts.postLoadScript) {\n    try {\n      result.postLoadResult = await page.evaluate(opts.postLoadScript);\n    } catch (e: any) {\n      result.error = `Post-load script failed: ${e.message}`;\n    }\n  }\n\n  return result;\n}\n\n/** Safe string validator \u2014 ensures script is a string, not an object/function reference */\nexport function validateScript(script: unknown): string {\n  if (typeof script !== 'string') throw new Error('Script must be a string');\n  if (script.length > 50_000) throw new Error('Script too large (>50KB)');\n  return script;\n}\n"],
+  "mappings": "AAsCA,eAAsB,eAAe,MAAY,MAAmD;AAClG,QAAM,SAA4B;AAAA,IAChC,mBAAmB;AAAA,IACnB,gBAAgB;AAAA,IAChB,YAAY;AAAA,IACZ,YAAY;AAAA,EACd;AAGA,MAAI,KAAK,SAAS,QAAQ;AACxB,QAAI;AACF,YAAM,KAAK,QAAQ,EAAE;AAAA,QACnB,KAAK,QAAQ,IAAI,QAAM,EAAE,MAAM,EAAE,MAAM,OAAO,EAAE,OAAO,QAAQ,EAAE,UAAU,IAAI,MAAM,EAAE,QAAQ,KAAK,KAAK,KAAK,IAAI,KAAK,OAAU,EAAE;AAAA,MACrI;AACA,aAAO,aAAa,KAAK,QAAQ;AAAA,IACnC,SAAS,GAAQ;AACf,aAAO,QAAQ,4BAA4B,EAAE,OAAO;AAAA,IACtD;AAAA,EACF;AAGA,MAAI,KAAK,cAAc,KAAK,gBAAgB,KAAK,gBAAgB;AAC/D,UAAM,eAAe;AAAA,MACnB,KAAK,eAAe,kBAAkB,KAAK,UAAU,KAAK,YAAY,CAAC,mDAAmD;AAAA,MAC1H,KAAK,iBAAiB,kBAAkB,KAAK,UAAU,KAAK,cAAc,CAAC,qDAAqD;AAAA,IAClI,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI;AAE3B,UAAM,eAAe,CAAC,cAAc,KAAK,cAAc,EAAE,EAAE,OAAO,OAAO,EAAE,KAAK,IAAI;AACpF,QAAI;AACF,YAAM,KAAK,cAAc,YAAY;AACrC,aAAO,oBAAoB;AAC3B,aAAO,aAAa,CAAC,EAAE,KAAK,gBAAgB,KAAK;AAAA,IACnD,SAAS,GAAQ;AACf,aAAO,QAAQ,uBAAuB,EAAE,OAAO;AAAA,IACjD;AAAA,EACF;AAGA,MAAI,KAAK,gBAAgB;AACvB,QAAI;AACF,aAAO,iBAAiB,MAAM,KAAK,SAAS,KAAK,cAAc;AAAA,IACjE,SAAS,GAAQ;AACf,aAAO,QAAQ,4BAA4B,EAAE,OAAO;AAAA,IACtD;AAAA,EACF;AAEA,SAAO;AACT;AAGO,SAAS,eAAe,QAAyB;AACtD,MAAI,OAAO,WAAW,SAAU,OAAM,IAAI,MAAM,yBAAyB;AACzE,MAAI,OAAO,SAAS,IAAQ,OAAM,IAAI,MAAM,0BAA0B;AACtE,SAAO;AACT;",
+  "names": []
+}

package/dist/dark-mode-capture.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Dark mode capture — screenshot pages in both light and dark color schemes.
+ *
+ * Uses Playwright's page.emulateMedia({ colorScheme: 'dark' }) to force dark mode,
+ * then captures a screenshot. Compares with light mode to determine if dark mode
+ * is supported (significant visual difference).
+ *
+ * Also detects prefers-color-scheme media query support in CSS.
+ */
+import type { Page } from 'playwright';
+export interface DarkModeCapture {
+    url: string;
+    lightScreenshot?: Buffer;
+    darkScreenshot?: Buffer;
+    hasDarkMode: boolean;
+    hasCssDarkMode: boolean;
+    backgroundColorLight?: string;
+    backgroundColorDark?: string;
+    capturedAt: string;
+}
+export declare function captureDarkMode(page: Page, url: string, opts?: {
+    takeScreenshots?: boolean;
+}): Promise<DarkModeCapture>;

package/dist/dark-mode-capture.js

@@ -0,0 +1,75 @@
+async function getBackgroundColor(page) {
+  try {
+    return await page.evaluate(() => {
+      const body = document.body;
+      return window.getComputedStyle(body).backgroundColor;
+    });
+  } catch {
+    return "unknown";
+  }
+}
+function colorsAreDifferent(a, b) {
+  if (a === b) return false;
+  if (a === "unknown" || b === "unknown") return false;
+  const parse = (c) => {
+    const m = c.match(/\d+/g);
+    return m ? m.map(Number) : [0, 0, 0];
+  };
+  const [ar, ag, ab] = parse(a);
+  const [br, bg, bb] = parse(b);
+  const lumA = 0.299 * ar + 0.587 * ag + 0.114 * ab;
+  const lumB = 0.299 * br + 0.587 * bg + 0.114 * bb;
+  return Math.abs(lumA - lumB) > 30;
+}
+async function hasCssDarkModeSupport(page) {
+  try {
+    return await page.evaluate(() => {
+      const sheets = Array.from(document.styleSheets);
+      for (const sheet of sheets) {
+        try {
+          const rules = Array.from(sheet.cssRules ?? []);
+          for (const rule of rules) {
+            if (rule instanceof CSSMediaRule && rule.conditionText?.includes("prefers-color-scheme")) {
+              return true;
+            }
+          }
+        } catch {
+        }
+      }
+      return false;
+    });
+  } catch {
+    return false;
+  }
+}
+async function captureDarkMode(page, url, opts = {}) {
+  const capturedAt = (/* @__PURE__ */ new Date()).toISOString();
+  const { takeScreenshots = false } = opts;
+  await page.emulateMedia({ colorScheme: "light" }).catch(() => {
+  });
+  const backgroundColorLight = await getBackgroundColor(page);
+  const hasCssDark = await hasCssDarkModeSupport(page);
+  const lightScreenshot = takeScreenshots ? await page.screenshot({ type: "jpeg", quality: 60 }).catch(() => void 0) : void 0;
+  await page.emulateMedia({ colorScheme: "dark" }).catch(() => {
+  });
+  await page.waitForTimeout(300);
+  const backgroundColorDark = await getBackgroundColor(page);
+  const darkScreenshot = takeScreenshots ? await page.screenshot({ type: "jpeg", quality: 60 }).catch(() => void 0) : void 0;
+  await page.emulateMedia({ colorScheme: "light" }).catch(() => {
+  });
+  const hasDarkMode = colorsAreDifferent(backgroundColorLight, backgroundColorDark) || hasCssDark;
+  return {
+    url,
+    lightScreenshot,
+    darkScreenshot,
+    hasDarkMode,
+    hasCssDarkMode: hasCssDark,
+    backgroundColorLight,
+    backgroundColorDark,
+    capturedAt
+  };
+}
+export {
+  captureDarkMode
+};
+//# sourceMappingURL=dark-mode-capture.js.map

package/dist/dark-mode-capture.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/dark-mode-capture.ts"],
+  "sourcesContent": ["/**\n * Dark mode capture \u2014 screenshot pages in both light and dark color schemes.\n *\n * Uses Playwright's page.emulateMedia({ colorScheme: 'dark' }) to force dark mode,\n * then captures a screenshot. Compares with light mode to determine if dark mode\n * is supported (significant visual difference).\n *\n * Also detects prefers-color-scheme media query support in CSS.\n */\n\nimport type { Page } from 'playwright';\n\nexport interface DarkModeCapture {\n  url: string;\n  lightScreenshot?: Buffer;\n  darkScreenshot?: Buffer;\n  hasDarkMode: boolean;\n  hasCssDarkMode: boolean; // @media (prefers-color-scheme: dark) detected in stylesheets\n  backgroundColorLight?: string;\n  backgroundColorDark?: string;\n  capturedAt: string;\n}\n\nasync function getBackgroundColor(page: Page): Promise<string> {\n  try {\n    return await page.evaluate(() => {\n      const body = document.body;\n      return window.getComputedStyle(body).backgroundColor;\n    });\n  } catch {\n    return 'unknown';\n  }\n}\n\nfunction colorsAreDifferent(a: string, b: string): boolean {\n  if (a === b) return false;\n  if (a === 'unknown' || b === 'unknown') return false;\n  // Parse rgb(r, g, b) and compare luminance\n  const parse = (c: string) => {\n    const m = c.match(/\\d+/g);\n    return m ? m.map(Number) : [0, 0, 0];\n  };\n  const [ar, ag, ab] = parse(a);\n  const [br, bg, bb] = parse(b);\n  const lumA = 0.299 * ar + 0.587 * ag + 0.114 * ab;\n  const lumB = 0.299 * br + 0.587 * bg + 0.114 * bb;\n  return Math.abs(lumA - lumB) > 30; // significant luminance difference\n}\n\nasync function hasCssDarkModeSupport(page: Page): Promise<boolean> {\n  try {\n    return await page.evaluate(() => {\n      const sheets = Array.from(document.styleSheets);\n      for (const sheet of sheets) {\n        try {\n          const rules = Array.from(sheet.cssRules ?? []);\n          for (const rule of rules) {\n            if (rule instanceof CSSMediaRule && rule.conditionText?.includes('prefers-color-scheme')) {\n              return true;\n            }\n          }\n        } catch { /* cross-origin stylesheet \u2014 skip */ }\n      }\n      return false;\n    });\n  } catch {\n    return false;\n  }\n}\n\nexport async function captureDarkMode(\n  page: Page,\n  url: string,\n  opts: { takeScreenshots?: boolean } = {},\n): Promise<DarkModeCapture> {\n  const capturedAt = new Date().toISOString();\n  const { takeScreenshots = false } = opts;\n\n  // Light mode\n  await page.emulateMedia({ colorScheme: 'light' }).catch(() => {});\n  const backgroundColorLight = await getBackgroundColor(page);\n  const hasCssDark = await hasCssDarkModeSupport(page);\n  const lightScreenshot = takeScreenshots\n    ? await page.screenshot({ type: 'jpeg', quality: 60 }).catch(() => undefined)\n    : undefined;\n\n  // Dark mode\n  await page.emulateMedia({ colorScheme: 'dark' }).catch(() => {});\n  await page.waitForTimeout(300); // allow CSS transitions\n  const backgroundColorDark = await getBackgroundColor(page);\n  const darkScreenshot = takeScreenshots\n    ? await page.screenshot({ type: 'jpeg', quality: 60 }).catch(() => undefined)\n    : undefined;\n\n  // Restore light mode\n  await page.emulateMedia({ colorScheme: 'light' }).catch(() => {});\n\n  const hasDarkMode = colorsAreDifferent(backgroundColorLight, backgroundColorDark) || hasCssDark;\n\n  return {\n    url,\n    lightScreenshot,\n    darkScreenshot,\n    hasDarkMode,\n    hasCssDarkMode: hasCssDark,\n    backgroundColorLight,\n    backgroundColorDark,\n    capturedAt,\n  };\n}\n"],
+  "mappings": "AAuBA,eAAe,mBAAmB,MAA6B;AAC7D,MAAI;AACF,WAAO,MAAM,KAAK,SAAS,MAAM;AAC/B,YAAM,OAAO,SAAS;AACtB,aAAO,OAAO,iBAAiB,IAAI,EAAE;AAAA,IACvC,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,mBAAmB,GAAW,GAAoB;AACzD,MAAI,MAAM,EAAG,QAAO;AACpB,MAAI,MAAM,aAAa,MAAM,UAAW,QAAO;AAE/C,QAAM,QAAQ,CAAC,MAAc;AAC3B,UAAM,IAAI,EAAE,MAAM,MAAM;AACxB,WAAO,IAAI,EAAE,IAAI,MAAM,IAAI,CAAC,GAAG,GAAG,CAAC;AAAA,EACrC;AACA,QAAM,CAAC,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC;AAC5B,QAAM,CAAC,IAAI,IAAI,EAAE,IAAI,MAAM,CAAC;AAC5B,QAAM,OAAO,QAAQ,KAAK,QAAQ,KAAK,QAAQ;AAC/C,QAAM,OAAO,QAAQ,KAAK,QAAQ,KAAK,QAAQ;AAC/C,SAAO,KAAK,IAAI,OAAO,IAAI,IAAI;AACjC;AAEA,eAAe,sBAAsB,MAA8B;AACjE,MAAI;AACF,WAAO,MAAM,KAAK,SAAS,MAAM;AAC/B,YAAM,SAAS,MAAM,KAAK,SAAS,WAAW;AAC9C,iBAAW,SAAS,QAAQ;AAC1B,YAAI;AACF,gBAAM,QAAQ,MAAM,KAAK,MAAM,YAAY,CAAC,CAAC;AAC7C,qBAAW,QAAQ,OAAO;AACxB,gBAAI,gBAAgB,gBAAgB,KAAK,eAAe,SAAS,sBAAsB,GAAG;AACxF,qBAAO;AAAA,YACT;AAAA,UACF;AAAA,QACF,QAAQ;AAAA,QAAuC;AAAA,MACjD;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAsB,gBACpB,MACA,KACA,OAAsC,CAAC,GACb;AAC1B,QAAM,cAAa,oBAAI,KAAK,GAAE,YAAY;AAC1C,QAAM,EAAE,kBAAkB,MAAM,IAAI;AAGpC,QAAM,KAAK,aAAa,EAAE,aAAa,QAAQ,CAAC,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AAChE,QAAM,uBAAuB,MAAM,mBAAmB,IAAI;AAC1D,QAAM,aAAa,MAAM,sBAAsB,IAAI;AACnD,QAAM,kBAAkB,kBACpB,MAAM,KAAK,WAAW,EAAE,MAAM,QAAQ,SAAS,GAAG,CAAC,EAAE,MAAM,MAAM,MAAS,IAC1E;AAGJ,QAAM,KAAK,aAAa,EAAE,aAAa,OAAO,CAAC,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AAC/D,QAAM,KAAK,eAAe,GAAG;AAC7B,QAAM,sBAAsB,MAAM,mBAAmB,IAAI;AACzD,QAAM,iBAAiB,kBACnB,MAAM,KAAK,WAAW,EAAE,MAAM,QAAQ,SAAS,GAAG,CAAC,EAAE,MAAM,MAAM,MAAS,IAC1E;AAGJ,QAAM,KAAK,aAAa,EAAE,aAAa,QAAQ,CAAC,EAAE,MAAM,MAAM;AAAA,EAAC,CAAC;AAEhE,QAAM,cAAc,mBAAmB,sBAAsB,mBAAmB,KAAK;AAErF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/dead-link-detector.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Dead link detector — tracks broken links discovered during crawl.
+ *
+ * A "dead link" is a URL that:
+ * - Returns 404, 410, or other 4xx/5xx responses
+ * - Times out after maxRetries
+ * - Redirects to an error page (detected by title heuristic)
+ *
+ * Results: list of broken links with source page, status code, and anchor text.
+ * Used for: SEO audit export, test report enrichment.
+ */
+export interface DeadLink {
+    url: string;
+    statusCode: number;
+    sourceUrl?: string;
+    anchorText?: string;
+    checkedAt: string;
+    reason: 'http-error' | 'timeout' | 'dns-error';
+}
+export declare class DeadLinkTracker {
+    private deadLinks;
+    private checked;
+    record(url: string, statusCode: number, source?: {
+        sourceUrl?: string;
+        anchorText?: string;
+    }): void;
+    recordTimeout(url: string, sourceUrl?: string): void;
+    getDeadLinks(): DeadLink[];
+    isKnownBroken(url: string): boolean;
+    stats(): {
+        total: number;
+        by404: number;
+        by5xx: number;
+        byTimeout: number;
+    };
+    toCsv(): string;
+}

package/dist/dead-link-detector.js

@@ -0,0 +1,50 @@
+class DeadLinkTracker {
+  deadLinks = [];
+  checked = /* @__PURE__ */ new Map();
+  // url → statusCode
+  record(url, statusCode, source) {
+    if (this.checked.has(url)) return;
+    this.checked.set(url, statusCode);
+    if (statusCode >= 400) {
+      this.deadLinks.push({
+        url,
+        statusCode,
+        sourceUrl: source?.sourceUrl,
+        anchorText: source?.anchorText,
+        checkedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        reason: statusCode === 0 ? "timeout" : "http-error"
+      });
+    }
+  }
+  recordTimeout(url, sourceUrl) {
+    if (this.checked.has(url)) return;
+    this.checked.set(url, 0);
+    this.deadLinks.push({ url, statusCode: 0, sourceUrl, checkedAt: (/* @__PURE__ */ new Date()).toISOString(), reason: "timeout" });
+  }
+  getDeadLinks() {
+    return [...this.deadLinks];
+  }
+  isKnownBroken(url) {
+    const code = this.checked.get(url);
+    return code !== void 0 && code >= 400;
+  }
+  stats() {
+    return {
+      total: this.deadLinks.length,
+      by404: this.deadLinks.filter((l) => l.statusCode === 404).length,
+      by5xx: this.deadLinks.filter((l) => l.statusCode >= 500).length,
+      byTimeout: this.deadLinks.filter((l) => l.reason === "timeout").length
+    };
+  }
+  toCsv() {
+    const rows = [["URL", "Status", "Source URL", "Anchor Text", "Checked At"]];
+    for (const l of this.deadLinks) {
+      rows.push([l.url, String(l.statusCode), l.sourceUrl ?? "", l.anchorText ?? "", l.checkedAt]);
+    }
+    return rows.map((r) => r.map((c) => `"${c.replace(/"/g, '""')}"`).join(",")).join("\n");
+  }
+}
+export {
+  DeadLinkTracker
+};
+//# sourceMappingURL=dead-link-detector.js.map