@clawdtesting/puppeteer 1.0.3 → 1.0.5

package/dist/client.d.ts

@@ -15,7 +15,7 @@ export declare class ClawdTest {
     check(page: Page, testName: string, stepName: string): Promise<{
         sessionResult: import("./types").SessionResult;
         stepId: string;
-        status: "passed" | "failed" | "new";
+        status: "match" | "unresolved" | "new";
         diffScore: number;
         isNew: boolean;
         diffImageUrl: string | null;

package/dist/client.js

@@ -41,6 +41,8 @@ class ClawdTest {
             baselineBranch: sessionOptions.baselineBranch,
         });
         const { sessionId } = response.data;
+        // Auto-resize viewport to match session config
+        await page.setViewport(sessionOptions.viewport);
         return new session_1.ClawdTestSession(sessionId, page, this.apiClient, sessionOptions.viewport);
     }
     /**

package/dist/session.js

@@ -50,8 +50,15 @@ class ClawdTestSession {
             filename: `${options.stepName}.png`,
             contentType: 'image/png',
         });
-        if (options.metadata) {
-            formData.append('metadata', JSON.stringify(options.metadata));
+        const metadata = { ...options.metadata };
+        if (options.ignoreRegions && options.ignoreRegions.length > 0) {
+            metadata.ignoreRegions = options.ignoreRegions;
+        }
+        if (options.matchLevel) {
+            metadata.matchLevel = options.matchLevel;
+        }
+        if (Object.keys(metadata).length > 0) {
+            formData.append('metadata', JSON.stringify(metadata));
         }
         const response = await this.apiClient.post(`/sessions/${this.sessionId}/steps`, formData, {
             headers: formData.getHeaders(),

package/dist/types.d.ts

@@ -20,7 +20,7 @@ export interface SessionOptions {
 }
 export interface StepResult {
     stepId: string;
-    status: 'passed' | 'failed' | 'new';
+    status: 'match' | 'unresolved' | 'new';
     diffScore: number;
     isNew: boolean;
     diffImageUrl: string | null;
@@ -33,15 +33,18 @@ export interface SessionResult {
     failedSteps: number;
     newSteps: number;
 }
+export interface Region {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 export interface CheckOptions {
     stepName: string;
     fullPage?: boolean;
     selector?: string;
-    clip?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
+    clip?: Region;
+    ignoreRegions?: Region[];
+    matchLevel?: 'strict' | 'layout';
     metadata?: Record<string, any>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawdtesting/puppeteer",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Visual Testing SDK for Puppeteer",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/client.ts

@@ -46,6 +46,9 @@ export class ClawdTest {
 
     const { sessionId } = response.data;
 
+    // Auto-resize viewport to match session config
+    await page.setViewport(sessionOptions.viewport);
+
     return new ClawdTestSession(
       sessionId,
       page,

package/src/session.ts

@@ -65,8 +65,15 @@ export class ClawdTestSession {
       contentType: 'image/png',
     });
 
-    if (options.metadata) {
-      formData.append('metadata', JSON.stringify(options.metadata));
+    const metadata: Record<string, any> = { ...options.metadata };
+    if (options.ignoreRegions && options.ignoreRegions.length > 0) {
+      metadata.ignoreRegions = options.ignoreRegions;
+    }
+    if (options.matchLevel) {
+      metadata.matchLevel = options.matchLevel;
+    }
+    if (Object.keys(metadata).length > 0) {
+      formData.append('metadata', JSON.stringify(metadata));
     }
 
     const response = await this.apiClient.post(

package/src/types.ts

@@ -22,7 +22,7 @@ export interface SessionOptions {
 
 export interface StepResult {
   stepId: string;
-  status: 'passed' | 'failed' | 'new';
+  status: 'match' | 'unresolved' | 'new';
   diffScore: number;
   isNew: boolean;
   diffImageUrl: string | null;
@@ -37,15 +37,19 @@ export interface SessionResult {
   newSteps: number;
 }
 
+export interface Region {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+
 export interface CheckOptions {
   stepName: string;
   fullPage?: boolean;
   selector?: string;
-  clip?: {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-  };
+  clip?: Region;
+  ignoreRegions?: Region[];
+  matchLevel?: 'strict' | 'layout';
   metadata?: Record<string, any>;
 }