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

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/frame_utils/constants.js

@@ -0,0 +1,8 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.IFRAME_TAGS = exports.ALL_IFRAMES_CSS_SELECTOR = void 0;
+const IFRAME_TAGS = exports.IFRAME_TAGS = ["iframe", "frame"];
+const ALL_IFRAMES_CSS_SELECTOR = exports.ALL_IFRAMES_CSS_SELECTOR = IFRAME_TAGS.join(", ");

package/dist/helpers/frame_utils/findAllIframes.js

@@ -0,0 +1,79 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.findAllIframes = findAllIframes;
+exports.findAllIframesList = findAllIframesList;
+var _Logger = require("../../common/Logger");
+var _constants = require("./constants");
+async function findAllIframes(root, iframeTimeoutMs = 10000) {
+  const processed = new Set();
+  return await processFrameRecursive(root, processed, iframeTimeoutMs);
+}
+async function findAllIframesList(root, iframeTimeoutMs = 10000) {
+  const iframeNodes = await findAllIframes(root, iframeTimeoutMs);
+  return flattenIframeTree(iframeNodes);
+}
+async function processFrameRecursive(root, processedRoots, iframeTimeoutMs) {
+  if (processedRoots.has(root)) {
+    return [];
+  }
+  processedRoots.add(root);
+  const iframeNodes = [];
+  try {
+    const iframeLocator = root.locator(_constants.ALL_IFRAMES_CSS_SELECTOR);
+    let iframeCount;
+    try {
+      iframeCount = await Promise.race([iframeLocator.count(), new Promise((_, reject) => setTimeout(() => reject(new Error("Timeout")), iframeTimeoutMs))]);
+    } catch (error) {
+      _Logger.logger.error("Timeout counting iframes in context, skipping");
+      return [];
+    }
+    for (let i = 0; i < iframeCount; i++) {
+      try {
+        const processSingleIframe = async index => {
+          const iframeElementLocator = iframeLocator.nth(index);
+          const iframeElement = await iframeElementLocator.elementHandle();
+          if (!iframeElement) {
+            _Logger.logger.error(`Could not get element handle for iframe: ${iframeElement}`);
+            return null;
+          }
+          const contentFrame = await iframeElement.contentFrame();
+          if (!contentFrame) {
+            _Logger.logger.error(`Could not access content_frame for iframe: ${iframeElement}`);
+            return null;
+          }
+          const nestedIframes = await processFrameRecursive(contentFrame, processedRoots, iframeTimeoutMs);
+          return {
+            frame: contentFrame,
+            nestedIframes: nestedIframes
+          };
+        };
+        const iframeNode = await Promise.race([processSingleIframe(i), new Promise((_, reject) => setTimeout(() => reject(new Error("Timeout")), iframeTimeoutMs))]);
+        if (iframeNode !== null) {
+          iframeNodes.push(iframeNode);
+        }
+      } catch (error) {
+        _Logger.logger.error(`Timeout processing iframe ${i} in context, skipping`);
+        continue;
+      }
+    }
+  } catch (error) {
+    _Logger.logger.error(`Error processing frames in context: ${error}`);
+  }
+  return iframeNodes;
+}
+function flattenIframeTree(iframeNodes) {
+  const flattened = [];
+  function flattenRecursive(nodes) {
+    for (const node of nodes) {
+      flattened.push(node);
+      if (node.nestedIframes && node.nestedIframes.length > 0) {
+        flattenRecursive(node.nestedIframes);
+      }
+    }
+  }
+  flattenRecursive(iframeNodes);
+  return flattened;
+}

package/dist/helpers/frame_utils/getContainerFrame.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getContainerFrame = getContainerFrame;
+async function getContainerFrame(element) {
+  let handle;
+  if ("elementHandle" in element) {
+    handle = await element.elementHandle();
+  } else {
+    handle = element;
+  }
+  if (!handle) {
+    throw new Error("Could not get element handle");
+  }
+  const frame = await handle.ownerFrame();
+  if (!frame) {
+    throw new Error("Could not get owner frame for element");
+  }
+  return frame;
+}

package/dist/helpers/frame_utils/index.js

@@ -0,0 +1,44 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "ALL_IFRAMES_CSS_SELECTOR", {
+  enumerable: true,
+  get: function () {
+    return _constants.ALL_IFRAMES_CSS_SELECTOR;
+  }
+});
+Object.defineProperty(exports, "IFRAME_TAGS", {
+  enumerable: true,
+  get: function () {
+    return _constants.IFRAME_TAGS;
+  }
+});
+Object.defineProperty(exports, "IframeNode", {
+  enumerable: true,
+  get: function () {
+    return _findAllIframes.IframeNode;
+  }
+});
+Object.defineProperty(exports, "findAllIframes", {
+  enumerable: true,
+  get: function () {
+    return _findAllIframes.findAllIframes;
+  }
+});
+Object.defineProperty(exports, "findAllIframesList", {
+  enumerable: true,
+  get: function () {
+    return _findAllIframes.findAllIframesList;
+  }
+});
+Object.defineProperty(exports, "getContainerFrame", {
+  enumerable: true,
+  get: function () {
+    return _getContainerFrame.getContainerFrame;
+  }
+});
+var _findAllIframes = require("./findAllIframes");
+var _getContainerFrame = require("./getContainerFrame");
+var _constants = require("./constants");

package/dist/helpers/frame_utils/tests/testFindAllIframes.spec.js

@@ -0,0 +1,170 @@
+"use strict";
+
+var _extendedTest = require("../../../common/extendedTest");
+var _playwrightCore = require("playwright-core");
+var _findAllIframes = require("../findAllIframes");
+(0, _extendedTest.describe)("Test findAllIframes", () => {
+  let browser;
+  let page;
+  (0, _extendedTest.beforeAll)(async () => {
+    browser = await _playwrightCore.chromium.launch({
+      headless: true
+    });
+  });
+  (0, _extendedTest.afterAll)(async () => {
+    await browser.close();
+  });
+  (0, _extendedTest.beforeEach)(async () => {
+    page = await browser.newPage();
+  });
+  (0, _extendedTest.afterEach)(async () => {
+    await page.close();
+  });
+  (0, _extendedTest.test)("should find all iframes - basic", async () => {
+    await page.goto(`data:text/html,
+      <html>
+        <body>
+          <h1>Main Content</h1>
+          <iframe id="iframe-1"
+                  src="data:text/html,<html><body><h2>Iframe 1</h2></body></html>"
+                  width="300"
+                  height="200">
+          </iframe>
+          <iframe id="iframe-2"
+                  src="data:text/html,<html><body><h2>Iframe 2</h2></body></html>"
+                  width="300"
+                  height="200">
+          </iframe>
+        </body>
+      </html>`, {
+      waitUntil: "domcontentloaded"
+    });
+    const iframeNodes = await (0, _findAllIframes.findAllIframes)(page);
+    (0, _extendedTest.expect)(iframeNodes.length).toBe(2);
+    (0, _extendedTest.expect)(iframeNodes[0].frame).toBeDefined();
+    (0, _extendedTest.expect)(iframeNodes[1].frame).toBeDefined();
+    (0, _extendedTest.expect)(iframeNodes[0].nestedIframes.length).toBe(0);
+    (0, _extendedTest.expect)(iframeNodes[1].nestedIframes.length).toBe(0);
+  });
+  (0, _extendedTest.test)("should find nested iframes", async () => {
+    await page.goto(`data:text/html,
+      <html>
+        <body>
+          <h1>Main Content</h1>
+          <iframe id="outer-iframe"
+                  src="data:text/html,<html><body><h2>Outer</h2><iframe src='data:text/html,<html><body><h3>Inner</h3></body></html>'></iframe></body></html>"
+                  width="400"
+                  height="300">
+          </iframe>
+        </body>
+      </html>`, {
+      waitUntil: "domcontentloaded"
+    });
+    const iframeNodes = await (0, _findAllIframes.findAllIframes)(page);
+    (0, _extendedTest.expect)(iframeNodes.length).toBe(1);
+    (0, _extendedTest.expect)(iframeNodes[0].nestedIframes.length).toBe(1);
+    (0, _extendedTest.expect)(iframeNodes[0].nestedIframes[0].nestedIframes.length).toBe(0);
+  });
+  (0, _extendedTest.test)("should handle page with no iframes", async () => {
+    await page.goto(`data:text/html,
+      <html>
+        <body>
+          <h1>Main Content</h1>
+          <p>No iframes here</p>
+        </body>
+      </html>`, {
+      waitUntil: "domcontentloaded"
+    });
+    const iframeNodes = await (0, _findAllIframes.findAllIframes)(page);
+    (0, _extendedTest.expect)(iframeNodes.length).toBe(0);
+  });
+  (0, _extendedTest.test)("should handle problematic iframe sources", async () => {
+    await page.goto(`data:text/html,
+      <html>
+        <body>
+          <h1>Main Content</h1>
+          <iframe id="javascript-iframe"
+                  src="javascript:"
+                  width="300"
+                  height="200">
+          </iframe>
+          <iframe id="blob-iframe"
+                  src="blob:null/invalid"
+                  width="300"
+                  height="200">
+          </iframe>
+          <iframe id="about-blank-iframe"
+                  src="about:blank"
+                  width="300"
+                  height="200">
+          </iframe>
+        </body>
+      </html>`, {
+      waitUntil: "domcontentloaded",
+      timeout: 5000
+    });
+    const startTime = Date.now();
+    const iframeNodes = await (0, _findAllIframes.findAllIframes)(page, 2000);
+    const elapsedTime = Date.now() - startTime;
+    (0, _extendedTest.expect)(elapsedTime).toBeLessThan(10000);
+    (0, _extendedTest.expect)(iframeNodes.length).toBeLessThan(3);
+  });
+  (0, _extendedTest.test)("should find iframes with srcdoc attribute", async () => {
+    await page.goto(`data:text/html,
+      <html>
+        <body>
+          <h1>Main Content</h1>
+          <iframe id="srcdoc-iframe"
+                  srcdoc="<html><body><h2>Srcdoc Content</h2></body></html>"
+                  width="300"
+                  height="200">
+          </iframe>
+        </body>
+      </html>`, {
+      waitUntil: "domcontentloaded"
+    });
+    const iframeNodes = await (0, _findAllIframes.findAllIframes)(page);
+    (0, _extendedTest.expect)(iframeNodes.length).toBe(1);
+  });
+  (0, _extendedTest.test)("should handle legacy frame elements", async () => {
+    await page.goto(`data:text/html,
+      <html>
+        <head><title>Legacy Frameset</title></head>
+        <frameset cols="50%,50%">
+          <frame id="frame-1"
+                 src="data:text/html,<html><body><h2>Frame 1</h2></body></html>">
+          </frame>
+          <frame id="frame-2"
+                 src="data:text/html,<html><body><h2>Frame 2</h2></body></html>">
+          </frame>
+        </frameset>
+      </html>`, {
+      waitUntil: "domcontentloaded"
+    });
+    const iframeNodes = await (0, _findAllIframes.findAllIframes)(page);
+    (0, _extendedTest.expect)(iframeNodes.length).toBeGreaterThanOrEqual(0);
+    for (const node of iframeNodes) {
+      (0, _extendedTest.expect)(node.frame).toBeDefined();
+    }
+  });
+  (0, _extendedTest.test)("findAllIframesList should return flat list", async () => {
+    await page.goto(`data:text/html,
+      <html>
+        <body>
+          <h1>Main Content</h1>
+          <iframe id="outer-iframe"
+                  src="data:text/html,<html><body><h2>Outer</h2><iframe id='inner-iframe' src='data:text/html,<html><body><h3>Inner</h3></body></html>'></iframe></body></html>"
+                  width="400"
+                  height="300">
+          </iframe>
+        </body>
+      </html>`, {
+      waitUntil: "domcontentloaded"
+    });
+    const iframeList = await (0, _findAllIframes.findAllIframesList)(page);
+    (0, _extendedTest.expect)(iframeList.length).toBe(2);
+    for (const node of iframeList) {
+      (0, _extendedTest.expect)(node.frame).toBeDefined();
+    }
+  });
+});

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");