@intuned/browser-dev 0.1.4-dev.0 → 0.1.5-dev.0

package/README.md

@@ -50,7 +50,6 @@ The Intuned Browser SDK provides a comprehensive set of tools for browser automa
 
 - **Schema Validation** - Validate data structures with `validateDataUsingSchema()`
 - **Empty Value Filtering** - Filter empty values with `filterEmptyValues()`
-- **Custom Type Registry** - Define custom validators with `CustomTypeRegistry`
 
 ### ⚡ Optimized Extractors
 

package/dist/ai/export.d.ts

@@ -535,7 +535,7 @@ export type SUPPORTED_MODELS =
  * @param {Object} input - Input object containing the page to check
  * @param {Page} input.page - The Playwright page to check
  * @param {number} [input.timeoutInMs=10000] - Screenshot timeout in milliseconds. Defaults to 10000
- * @param {SUPPORTED_MODELS} [input.model="gpt-4o-2024-08-06"] - AI model to use for the check. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-4o-2024-08-06"
+ * @param {SUPPORTED_MODELS} [input.model="gpt-5-mini-2025-08-07"] - AI model to use for the check. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-5-mini-2025-08-07"
  * @param {string} [input.apiKey] - Optional API key for the AI service (if provided, will not be billed to your account)
  * @returns {Promise<boolean>} Promise resolving to true if page is loaded, false if still loading
  * @example

package/dist/ai/index.d.ts

@@ -535,7 +535,7 @@ export type SUPPORTED_MODELS =
  * @param {Object} input - Input object containing the page to check
  * @param {Page} input.page - The Playwright page to check
  * @param {number} [input.timeoutInMs=10000] - Screenshot timeout in milliseconds. Defaults to 10000
- * @param {SUPPORTED_MODELS} [input.model="gpt-4o-2024-08-06"] - AI model to use for the check. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-4o-2024-08-06"
+ * @param {SUPPORTED_MODELS} [input.model="gpt-5-mini-2025-08-07"] - AI model to use for the check. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-5-mini-2025-08-07"
  * @param {string} [input.apiKey] - Optional API key for the AI service (if provided, will not be billed to your account)
  * @returns {Promise<boolean>} Promise resolving to true if page is loaded, false if still loading
  * @example

package/dist/ai/isPageLoaded.js

@@ -20,7 +20,7 @@ const isPageLoaded = async options => {
   });
   const gateway = _utils.GatewayFactory.createAIGateway({
     apiKey: options === null || options === void 0 ? void 0 : options.apiKey,
-    model: (options === null || options === void 0 ? void 0 : options.model) ?? "gpt-4o-2024-08-06"
+    model: (options === null || options === void 0 ? void 0 : options.model) ?? "gpt-5-mini-2025-08-07"
   });
   const gatewayModel = await gateway.getModel();
   const base64Image = Buffer.from(screenshotBytes).toString("base64");
@@ -30,11 +30,22 @@ const isPageLoaded = async options => {
       role: "system",
       content: `You are a helpful assistant that determines if a webpage finished loading. If the page finished loading, start your answer with 'True'. If the page is loading, start your answer with 'False'. If you are not sure, start your answer with 'Dont know'. In a new line, add a reason to your response.
 
-Some good cues for determining if a page is loading:
+## Some good cues for determining if a page is loading (return 'False'):
 - Loading spinner
 - Page is blank
 - Some content looks like it's missing
-- Not on splash screen`
+- Not on splash screen
+
+## Special cases for LOADED pages (return 'True')
+- CAPTCHA challenges are considered loaded, because it is indeed loaded and waiting for the user to solve the captcha.
+- Bot detection screens (e.g., "Checking your browser", Cloudflare verification) are considered loaded, because it is indeed loaded and waiting for the user to solve the captcha.
+- Static error pages (404 Not Found, 403 Forbidden, 500 Internal Server Error, etc.)
+- Login/authentication screens
+- Complete forms ready for user input
+- Fully rendered articles, product pages, or dashboards
+- Cookie consent banners or popups over complete content
+- Payment or checkout pages with all fields visible
+`
     }, {
       role: "user",
       content: [{

package/dist/ai/tests/testIsPageLoaded.spec.js

@@ -175,7 +175,7 @@ const ERROR_PAGE = `
 </body>
 </html>
 `;
-(0, _extendedTest.describe)("isPageLoaded Tests", () => {
+_extendedTest.describe.skip("isPageLoaded Tests", () => {
   let browser;
   let page;
   (0, _extendedTest.beforeAll)(async () => {
@@ -263,11 +263,11 @@ const ERROR_PAGE = `
     });
   });
   (0, _extendedTest.describe)("Different model types", () => {
-    (0, _extendedTest.test)("should work with claude-3-5-sonnet-20240620", async () => {
+    (0, _extendedTest.test)("should work with claude-3-7-sonnet-latest", async () => {
       await page.setContent(FULLY_LOADED_PAGE);
       const result = await (0, _isPageLoaded.isPageLoaded)({
         page,
-        model: "claude-3-5-sonnet-20240620",
+        model: "claude-3-7-sonnet-latest",
         apiKey: process.env.ANTHROPIC_API_KEY,
         timeoutInMs: 10000
       });

package/dist/helpers/downloadFile.js

@@ -62,6 +62,7 @@ const downloadFile = async input => {
     downloadPromise = pageToDownloadFrom.waitForEvent("download", {
       timeout: (timeoutInMs ?? 5000) + 1000
     });
+    await page.evaluate("(() => {window.waitForPrintDialog = new Promise(f => window.print = f);})()");
     if (isUrlTrigger(trigger)) {
       absoluteUrl = await getAbsoluteUrl(page, trigger);
       if (!isValidURL(absoluteUrl)) {
@@ -92,8 +93,44 @@ const downloadFile = async input => {
       }
     } else if (isCallableTrigger(trigger)) {
       action = await trigger(page);
+      try {
+        await pageToDownloadFrom.waitForFunction("window.waitForPrintDialog", undefined, {
+          timeout: 1000
+        });
+        const pdf = await pageToDownloadFrom.pdf({
+          format: "A4"
+        });
+        const pdfBase64 = pdf.toString("base64");
+        await pageToDownloadFrom.evaluate(base64 => {
+          const dataUrl = `data:application/pdf;base64,${base64}`;
+          const link = document.createElement("a");
+          link.href = dataUrl;
+          link.download = "print.pdf";
+          document.body.appendChild(link);
+          link.click();
+          document.body.removeChild(link);
+        }, pdfBase64);
+      } catch (error) {}
     } else if (isLocatorTrigger(trigger)) {
       action = await trigger.click();
+      try {
+        await pageToDownloadFrom.waitForFunction("window.waitForPrintDialog", undefined, {
+          timeout: 1000
+        });
+        const pdf = await pageToDownloadFrom.pdf({
+          format: "A4"
+        });
+        const pdfBase64 = pdf.toString("base64");
+        await pageToDownloadFrom.evaluate(base64 => {
+          const dataUrl = `data:application/pdf;base64,${base64}`;
+          const link = document.createElement("a");
+          link.href = dataUrl;
+          link.download = "print.pdf";
+          document.body.appendChild(link);
+          link.click();
+          document.body.removeChild(link);
+        }, pdfBase64);
+      } catch (error) {}
     }
     const download = await downloadPromise;
     if ((0, _utils.isGenerateCodeMode)()) {

package/dist/helpers/export.d.ts

@@ -204,7 +204,7 @@ export declare function filterEmptyValues<T>(input: { data: T }): T;
  * @param {string} [input.waitForLoadState="load"] - When to consider navigation succeeded. Options: "load", "domcontentloaded", "networkidle", "commit". Defaults to "load"
  * @param {boolean} [input.throwOnTimeout=true] - Whether to throw an error if navigation times out. When false, the function returns without throwing, allowing continued execution. Defaults to true.
  * @param {boolean} [input.waitForLoadingStateUsingAi=false] - When true, uses AI vision to verify the page is fully loaded by checking for loading spinners, blank content, or incomplete states. Retries up to 4 times with 5-second delays. Defaults to false
- * @param {SUPPORTED_MODELS} [input.model="gpt-4o-2024-08-06"] - AI model to use for loading verification. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-4o-2024-08-06"
+ * @param {SUPPORTED_MODELS} [input.model="gpt-5-mini-2025-08-07"] - AI model to use for loading verification. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-5-mini-2025-08-07"
  * @param {string} [input.apiKey] - Optional API key for the AI service (if provided, will not be billed to your account)
  * @returns {Promise<void>} Promise that resolves when navigation completes successfully. If the operation fails and `throwOnTimeout` is false, resolves without error
  *
@@ -540,7 +540,7 @@ export declare function uploadFileToS3(input: {
  * @param {Object} input - The input object containing data and schema
  * @param {Record<string, any> | Record<string, any>[]} input.data - The data to validate. Can be a single data object or an array of data objects
  * @param {Record<string, any>} input.schema - JSON schema object defining validation rules
- * @returns {Promise<void>} Promise that resolves if validation passes, throws ValidationError if it fails
+ * @returns {void} Returns nothing if validation passes, throws ValidationError if it fails
  *
  * @example
  * ```typescript Basic User Data Validation
@@ -562,7 +562,7 @@ export declare function uploadFileToS3(input: {
  *   }
  * };
  *
- * await validateDataUsingSchema({ data: userData, schema: userSchema });
+ * validateDataUsingSchema({ data: userData, schema: userSchema });
  * // Validation passes, no error thrown
  * }
  * ```
@@ -585,7 +585,7 @@ export declare function uploadFileToS3(input: {
  *   }
  * };
  *
- * await validateDataUsingSchema({ data: userData, schema: userSchema });
+ * validateDataUsingSchema({ data: userData, schema: userSchema });
  * // Validation fails, throws ValidationError
  * }
  * ```
@@ -593,7 +593,7 @@ export declare function uploadFileToS3(input: {
 export declare function validateDataUsingSchema(input: {
   data: Record<string, any>[] | Record<string, any>;
   schema: Record<string, any>;
-}): Promise<void>;
+}): void;
 
 /**
  * Executes a callback function and waits for network requests to settle before returning.
@@ -839,6 +839,9 @@ export interface Attachment {
   /** The name/key of the file in the S3 bucket */
   fileName: string;
 
+  /** The S3 object key/path */
+  key: string;
+
   /** The S3 bucket name where the file is stored */
   bucket: string;
 
@@ -846,13 +849,13 @@ export interface Attachment {
   region: string;
 
   /** Optional custom S3 endpoint URL. Defaults to undefined for standard AWS S3 */
-  endpoint?: string;
+  endpoint?: string | null;
 
   /** A human-readable filename suggestion for downloads or display */
   suggestedFileName: string;
 
   /** The file type of the file */
-  fileType?: AttachmentType;
+  fileType?: AttachmentType | null;
 
   /**
    * Returns a JSON-serializable record representation of the file.

package/dist/helpers/gotoUrl.js

@@ -20,7 +20,7 @@ const goToUrl = async input => {
     throwOnTimeout = true,
     waitForLoadingStateUsingAi = false,
     retries = 3,
-    model = "gpt-4o-2024-08-06",
+    model = "gpt-5-mini-2025-08-07",
     apiKey,
     waitForLoadState = "load"
   } = input || {};

package/dist/helpers/index.d.ts

@@ -204,7 +204,7 @@ export declare function filterEmptyValues<T>(input: { data: T }): T;
  * @param {string} [input.waitForLoadState="load"] - When to consider navigation succeeded. Options: "load", "domcontentloaded", "networkidle", "commit". Defaults to "load"
  * @param {boolean} [input.throwOnTimeout=true] - Whether to throw an error if navigation times out. When false, the function returns without throwing, allowing continued execution. Defaults to true.
  * @param {boolean} [input.waitForLoadingStateUsingAi=false] - When true, uses AI vision to verify the page is fully loaded by checking for loading spinners, blank content, or incomplete states. Retries up to 4 times with 5-second delays. Defaults to false
- * @param {SUPPORTED_MODELS} [input.model="gpt-4o-2024-08-06"] - AI model to use for loading verification. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-4o-2024-08-06"
+ * @param {SUPPORTED_MODELS} [input.model="gpt-5-mini-2025-08-07"] - AI model to use for loading verification. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "gpt-5-mini-2025-08-07"
  * @param {string} [input.apiKey] - Optional API key for the AI service (if provided, will not be billed to your account)
  * @returns {Promise<void>} Promise that resolves when navigation completes successfully. If the operation fails and `throwOnTimeout` is false, resolves without error
  *
@@ -540,7 +540,7 @@ export declare function uploadFileToS3(input: {
  * @param {Object} input - The input object containing data and schema
  * @param {Record<string, any> | Record<string, any>[]} input.data - The data to validate. Can be a single data object or an array of data objects
  * @param {Record<string, any>} input.schema - JSON schema object defining validation rules
- * @returns {Promise<void>} Promise that resolves if validation passes, throws ValidationError if it fails
+ * @returns {void} Returns nothing if validation passes, throws ValidationError if it fails
  *
  * @example
  * ```typescript Basic User Data Validation
@@ -562,7 +562,7 @@ export declare function uploadFileToS3(input: {
  *   }
  * };
  *
- * await validateDataUsingSchema({ data: userData, schema: userSchema });
+ * validateDataUsingSchema({ data: userData, schema: userSchema });
  * // Validation passes, no error thrown
  * }
  * ```
@@ -585,7 +585,7 @@ export declare function uploadFileToS3(input: {
  *   }
  * };
  *
- * await validateDataUsingSchema({ data: userData, schema: userSchema });
+ * validateDataUsingSchema({ data: userData, schema: userSchema });
  * // Validation fails, throws ValidationError
  * }
  * ```
@@ -593,7 +593,7 @@ export declare function uploadFileToS3(input: {
 export declare function validateDataUsingSchema(input: {
   data: Record<string, any>[] | Record<string, any>;
   schema: Record<string, any>;
-}): Promise<void>;
+}): void;
 
 /**
  * Executes a callback function and waits for network requests to settle before returning.
@@ -839,6 +839,9 @@ export interface Attachment {
   /** The name/key of the file in the S3 bucket */
   fileName: string;
 
+  /** The S3 object key/path */
+  key: string;
+
   /** The S3 bucket name where the file is stored */
   bucket: string;
 
@@ -846,13 +849,13 @@ export interface Attachment {
   region: string;
 
   /** Optional custom S3 endpoint URL. Defaults to undefined for standard AWS S3 */
-  endpoint?: string;
+  endpoint?: string | null;
 
   /** A human-readable filename suggestion for downloads or display */
   suggestedFileName: string;
 
   /** The file type of the file */
-  fileType?: AttachmentType;
+  fileType?: AttachmentType | null;
 
   /**
    * Returns a JSON-serializable record representation of the file.

package/dist/helpers/index.js

@@ -3,24 +3,6 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "AttachmentValidator", {
-  enumerable: true,
-  get: function () {
-    return _types.AttachmentValidator;
-  }
-});
-Object.defineProperty(exports, "CustomTypeRegistry", {
-  enumerable: true,
-  get: function () {
-    return _types.CustomTypeRegistry;
-  }
-});
-Object.defineProperty(exports, "CustomTypeValidator", {
-  enumerable: true,
-  get: function () {
-    return _types.CustomTypeValidator;
-  }
-});
 Object.defineProperty(exports, "clickUntilExhausted", {
   enumerable: true,
   get: function () {
@@ -109,7 +91,6 @@ var _gotoUrl = require("./gotoUrl");
 var _uploadFileToS = require("./uploadFileToS3");
 var _withNetworkSettledWait = require("./withNetworkSettledWait");
 var _validateDataUsingSchema = require("./validateDataUsingSchema");
-var _types = require("./types");
 var _downloadFile = require("./downloadFile");
 var _filterEmptyValues = require("./filterEmptyValues");
 var _processDate = require("./processDate");

package/dist/helpers/tests/testDownloadFile.spec.js

@@ -37,6 +37,16 @@ const content = `
         <a href="https://intuned-docs-public-images.s3.us-west-2.amazonaws.com/large_pdf.pdf">Download Text File</a>
     </div>
 
+    <div>
+        <h3>Print Dialog Download</h3>
+        <button id="print-button">Print Document</button>
+        <script>
+            document.getElementById('print-button').addEventListener('click', function() {
+                window.print();
+            });
+        </script>
+    </div>
+
 </body>
 </html>
 `;
@@ -56,14 +66,14 @@ async function createUserDirWithPreferences() {
   await (0, _promises.writeFile)(preferencesPath, JSON.stringify(preferences));
   return (0, _path.resolve)(userDir);
 }
-_extendedTest.describe.skip("TestNotInGeneration", () => {
+(0, _extendedTest.describe)("TestNotInGeneration", () => {
   let context;
   let page;
   (0, _extendedTest.beforeAll)(async () => {
     const dir = await createUserDirWithPreferences();
     process.env.MODE = "";
     context = await _playwrightCore.chromium.launchPersistentContext(dir, {
-      headless: true,
+      headless: false,
       args: ["--no-first-run", "--disable-sync", "--disable-translate", "--disable-features=TranslateUI", "--disable-features=NetworkService", "--lang=en", "--disable-blink-features=AutomationControlled"],
       acceptDownloads: true
     });
@@ -97,7 +107,7 @@ _extendedTest.describe.skip("TestNotInGeneration", () => {
     (0, _extendedTest.expect)(path).toBeDefined();
     (0, _extendedTest.expect)(String(path)).toContain("/var/folders/");
   });
-  _extendedTest.test.skip("should upload image to s3", async () => {
+  (0, _extendedTest.test)("should upload image to s3", async () => {
     await page.setContent(content);
     const downloadedImage = await (0, _.downloadFile)({
       page,
@@ -120,7 +130,7 @@ _extendedTest.describe.skip("TestNotInGeneration", () => {
     (0, _extendedTest.expect)(uploadedFile.suggestedFileName).toBeDefined();
     (0, _extendedTest.expect)(uploadedFile.bucket).toBe(process.env.INTUNED_S3_BUCKET);
   });
-  _extendedTest.test.skip("should upload file to s3", async () => {
+  (0, _extendedTest.test)("should upload file to s3", async () => {
     await page.setContent(content);
     const download = await (0, _.downloadFile)({
       page,
@@ -133,6 +143,18 @@ _extendedTest.describe.skip("TestNotInGeneration", () => {
     (0, _extendedTest.expect)(uploadedFile.suggestedFileName).toBeDefined();
     (0, _extendedTest.expect)(uploadedFile.bucket).toBe(process.env.INTUNED_S3_BUCKET);
   });
+  (0, _extendedTest.test)("should download from print dialog", async () => {
+    await page.setContent(content);
+    const printButton = page.locator("#print-button");
+    const download = await (0, _.downloadFile)({
+      page,
+      trigger: printButton
+    });
+    (0, _extendedTest.expect)(download).toBeDefined();
+    const downloadPath = await download.path();
+    (0, _extendedTest.expect)(downloadPath).toBeDefined();
+    (0, _extendedTest.expect)(download.suggestedFilename()).toContain(".pdf");
+  });
 });
 (0, _extendedTest.describe)("TestInGeneration", () => {
   let context;
@@ -141,7 +163,7 @@ _extendedTest.describe.skip("TestNotInGeneration", () => {
     process.env.MODE = "generate_code";
     const dir = await createUserDirWithPreferences();
     context = await _playwrightCore.chromium.launchPersistentContext(dir, {
-      headless: true,
+      headless: false,
       userAgent: "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36",
       args: ["--no-first-run", "--disable-sync", "--disable-translate", "--disable-features=TranslateUI", "--disable-features=NetworkService", "--lang=en", "--disable-blink-features=AutomationControlled"],
       acceptDownloads: true
@@ -188,7 +210,7 @@ _extendedTest.describe.skip("TestNotInGeneration", () => {
     });
     (0, _extendedTest.expect)(downloadedImage.path).toBeDefined();
   });
-  _extendedTest.test.skip("should upload file to s3", async () => {
+  (0, _extendedTest.test)("should upload file to s3", async () => {
     await page.setContent(content);
     const download = await (0, _.downloadFile)({
       page,
@@ -203,4 +225,17 @@ _extendedTest.describe.skip("TestNotInGeneration", () => {
     (0, _extendedTest.expect)(uploadedFile.bucket).toBe("testing_bucket");
     (0, _extendedTest.expect)(uploadedFile.region).toBe("testing_region");
   });
+  (0, _extendedTest.test)("should download from print dialog", async () => {
+    await page.setContent(content);
+    const printButton = page.locator("#print-button");
+    const download = await (0, _.downloadFile)({
+      page,
+      trigger: printButton
+    });
+    (0, _extendedTest.expect)(download).toBeDefined();
+    const cancelled = await download.failure();
+    if (cancelled) {
+      (0, _extendedTest.expect)(cancelled).toContain("canceled");
+    }
+  });
 });