@detiq/crawler 0.1.7 → 0.1.9

package/src/test-executor.ts

@@ -17,6 +17,8 @@ export interface StepResult {
   healedVia?: 'mechanical' | 'ai';
   healReasoning?: string;
   healConfidence?: number;
+  elementBoundingRect?: { x: number; y: number; width: number; height: number } | null;
+  elementSelector?: string;
 }
 
 export interface ExecutionResult {
@@ -84,14 +86,14 @@ async function resolveLocator(
   if (!selector) return null;
 
   const primary = buildLocator(page, selector, selectorStrategy);
-  const attached = await primary.first().isVisible({ timeout: 1500 }).catch(() => false);
+  const attached = await primary.first().isVisible({ timeout: parseInt(process.env.TEST_WAIT_TIMEOUT_MS ?? '1500', 10) }).catch(() => false);
   if (attached) return { loc: primary, healed: false };
 
   // Tier 2 — mechanical: try other strategies before giving up
   for (const strategy of LOCATOR_STRATEGIES) {
     if (strategy === selectorStrategy) continue;
     const loc = buildLocator(page, selector, strategy);
-    const visible = await loc.first().isVisible({ timeout: 800 }).catch(() => false);
+    const visible = await loc.first().isVisible({ timeout: parseInt(process.env.TEST_SHORT_TIMEOUT_MS ?? '800', 10) }).catch(() => false);
     if (visible) return { loc, healed: true, healedVia: 'mechanical' };
   }
 
@@ -108,7 +110,7 @@ async function resolveLocator(
       });
       if (result.healed && result.updatedTest) {
         const healedLoc = page.getByText(result.updatedTest.elementMeaning, { exact: false });
-        const visible = await healedLoc.first().isVisible({ timeout: 1500 }).catch(() => false);
+        const visible = await healedLoc.first().isVisible({ timeout: parseInt(process.env.TEST_WAIT_TIMEOUT_MS ?? '1500', 10) }).catch(() => false);
         if (visible) {
           return {
             loc: healedLoc,
@@ -157,7 +159,7 @@ async function runPlan(
     };
 
     try {
-      const timeout = step.timeout ?? 8000;
+      const timeout = step.timeout ?? parseInt(process.env.TEST_STEP_TIMEOUT_MS ?? '8000', 10);
 
       switch (step.action) {
         case 'navigate':
@@ -169,6 +171,8 @@ async function runPlan(
         case 'click': {
           const r = await resolveLocator(page, step, options.healCtx);
           if (!r) throw new Error('Could not resolve locator');
+          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+          result.elementSelector = step.selector;
           await r.loc.first().click({ timeout });
           applyHealInfo(result, r);
           break;
@@ -177,6 +181,8 @@ async function runPlan(
         case 'fill': {
           const r = await resolveLocator(page, step, options.healCtx);
           if (!r) throw new Error('Could not resolve locator');
+          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+          result.elementSelector = step.selector;
           await r.loc.first().fill(step.value ?? '', { timeout });
           applyHealInfo(result, r);
           break;
@@ -185,6 +191,8 @@ async function runPlan(
         case 'select': {
           const r = await resolveLocator(page, step, options.healCtx);
           if (!r) throw new Error('Could not resolve locator');
+          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+          result.elementSelector = step.selector;
           await r.loc.first().selectOption(step.value ?? '', { timeout });
           applyHealInfo(result, r);
           break;
@@ -193,6 +201,8 @@ async function runPlan(
         case 'hover': {
           const r = await resolveLocator(page, step, options.healCtx);
           if (!r) throw new Error('Could not resolve locator');
+          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+          result.elementSelector = step.selector;
           await r.loc.first().hover({ timeout });
           applyHealInfo(result, r);
           break;
@@ -206,6 +216,8 @@ async function runPlan(
           const r = await resolveLocator(page, step, options.healCtx);
           if (!r) throw new Error('Could not resolve locator');
           await r.loc.first().waitFor({ state: 'visible', timeout });
+          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+          result.elementSelector = step.selector;
           applyHealInfo(result, r);
           break;
         }
@@ -217,6 +229,8 @@ async function runPlan(
           if (!text?.includes(step.value ?? '')) {
             throw new Error(`Expected text "${step.value}" not found. Got: "${text?.slice(0, 100)}"`);
           }
+          result.elementBoundingRect = await r.loc.first().boundingBox().catch(() => null);
+          result.elementSelector = step.selector;
           applyHealInfo(result, r);
           break;
         }
@@ -230,7 +244,7 @@ async function runPlan(
         }
 
         case 'wait':
-          await page.waitForTimeout(step.timeout ?? 2000);
+          await page.waitForTimeout(step.timeout ?? parseInt(process.env.TEST_STEP_DELAY_MS ?? '2000', 10));
           break;
 
         case 'screenshot': {
@@ -251,7 +265,7 @@ async function runPlan(
     }
 
     try {
-      await page.waitForLoadState('networkidle', { timeout: 1500 }).catch(() => {});
+      await page.waitForLoadState('networkidle', { timeout: parseInt(process.env.TEST_NETWORK_IDLE_TIMEOUT_MS ?? '1500', 10) }).catch(() => {});
       if (!result.screenshotPath) {
         const ssPath = `${options.screenshotDir}/${options.testRunId}-step-${step.stepNumber}.png`;
         await page.screenshot({ path: ssPath, fullPage: true });

package/types/crawler.d.ts

@@ -35,10 +35,24 @@ export declare function crawlProject(opts: {
     tenantId: string;
     projectId: string;
     appUrl: string;
+    /** The viewport used for this crawl pass */
+    viewport?: 'DESKTOP' | 'MOBILE_PORTRAIT' | 'TABLET';
     credentials?: Credentials;
     /** Playwright storageState JSON string — if present, session is restored and AI login is skipped. */
     storageState?: string;
     screenshotDir?: string;
+    /** Cloud storage config for immediate screenshot upload. If set, screenshots are uploaded to cloud immediately after capture and cloudUrl is persisted. */
+    storageConfig?: {
+        provider: string;
+        bucket: string;
+        region?: string;
+        accountId?: string;
+        endpointUrl?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        prefix?: string;
+        publicUrl?: string;
+    } | null;
     /** When true, run a fast URL-only discovery crawl — skips screenshots, DB saves, and AI element extraction. Returns discoveredUrls in the result object. */
     discoveryMode?: boolean;
     maxScreens?: number;

package/types/test-executor.d.ts

@@ -13,6 +13,13 @@ export interface StepResult {
     healedVia?: 'mechanical' | 'ai';
     healReasoning?: string;
     healConfidence?: number;
+    elementBoundingRect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null;
+    elementSelector?: string;
 }
 export interface ExecutionResult {
     stepResults: StepResult[];