@intuned/browser-dev 0.1.6-dev.1 → 0.1.8-dev.0

package/generated-docs/ai/functions/extractStructuredData.mdx

@@ -1,255 +0,0 @@
----
-title: extractStructuredData
-description: ""
----
-
-<Tabs>
-
-<Tab title="From Page or Locator">
-
-```typescript
-export declare function extractStructuredData(options: {
-  source: Page | Locator;
-  dataSchema: JsonSchema | z.ZodSchema;
-  prompt?: string;
-  strategy?: "IMAGE" | "MARKDOWN" | "HTML";
-  enableDomMatching?: boolean;
-  enableCache?: boolean;
-  maxRetries?: number;
-  model?: SUPPORTED_MODELS;
-  apiKey?: string;
-}): Promise<any>;
-```
-
-Extract structured data from web pages using AI-powered content analysis.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Page source
-import { extractStructuredData } from '@intuned/browser/ai';
-export default async function handler(params, page, context){
-await page.goto("https://books.toscrape.com/")
-const product = await extractStructuredData({
-  source: page,
-  strategy: "HTML",
-  model: "gpt-4o",
-  dataSchema: {
-    type: "object",
-    properties: {
-      name: { type: "string" },
-      price: { type: "string" },
-      description: { type: "string" },
-      inStock: { type: "boolean" }
-    },
-    required: ["name", "price"]
-  },
-  prompt: "Extract product details from this e page"
-});
-console.log(`Found book: ${product.name} - ${product.price}`);
-}
-```
-
-```typescript Locator source
-import { extractStructuredData } from '@intuned/browser/ai';
-export default async function handler(params, page, context){
-await page.goto("https://books.toscrape.com/")
-const articleContainer = page.locator("article").first()
-const article = await extractStructuredData({
-  source: articleContainer,
-  strategy: "MARKDOWN",
-  model: "claude-3-5-sonnet-20240620",
-  dataSchema: {
-  type: "object",
-  properties: {
-    title: { type: "string" },
-    author: { type: "string" },
-    publishDate: { type: "string" },
-    content: { type: "string" },
-  },
-  required: ["title"]
-},
-  maxRetries: 5
-});
-console.log(`Found book: ${article.title}`);
-}
-```
-
-</CodeGroup>
-
-## Arguments
-
-<ParamField path="options" type="Object" required
->
-Configuration object containing extraction parameters
-
-<Expandable title="options">
-<ParamField path="options.source" type="Page | Locator">
-Playwright Page object to extract data from the entire page or Locator object to extract data from a specific element
-</ParamField>
-
-<ParamField path="options.dataSchema" type="JsonSchema | z.ZodSchema">
-JsonSchema defining the structure of the data to extract. This can be a JsonSchema or ZodSchema
-</ParamField>
-
-<ParamField path="options.strategy" type="string">
-Type of extraction: "HTML", "IMAGE", or "MARKDOWN". Defaults to "HTML"
-</ParamField>
-
-<ParamField path="options.prompt" type="string">
-Optional prompt to guide the extraction process and provide more context
-</ParamField>
-
-<ParamField path="options.enableDomMatching" type="boolean">
-Whether to enable DOM element matching during extraction. Defaults to false. When set to true, all types in the schema must be strings to match with the DOM elements. The extracted results will be matched with the DOM elements and returned, then cached in a smart fashion so that the next time the same data is extracted, the result will be returned from the cache even if the DOM has minor changes.
-</ParamField>
-
-<ParamField path="options.enableCache" type="boolean">
-Whether to enable caching of the extracted data. Defaults to true
-</ParamField>
-
-<ParamField path="options.maxRetries" type="number">
-Maximum number of retry attempts on failures. Failures can be validation errors, API errors, output errors, etc. Defaults to 3
-</ParamField>
-
-<ParamField path="options.model" type="SUPPORTED_MODELS">
-AI model to use for extraction. See [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models. Defaults to "claude-3-5-haiku-latest"
-</ParamField>
-
-<ParamField path="options.apiKey" type="string">
-Optional API key for AI extraction (if provided, will not be billed to your account)
-</ParamField>
-
-</Expandable>
-
-</ParamField>
-
-## Returns: `any`
-
-Promise resolving to the extracted structured data matching the provided schema
-
-</Tab>
-
-<Tab title="From Content">
-
-```typescript
-export declare function extractStructuredData(options: {
-  content: ContentItem[] | ContentItem;
-  dataSchema: JsonSchema | z.ZodSchema;
-  prompt?: string;
-  maxRetries?: number;
-  enableCache?: boolean;
-  model: SUPPORTED_MODELS;
-  apiKey?: string;
-}): Promise<any>;
-```
-
-Extract structured data from content items (text, images) using AI-powered analysis.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Text Content
-import { extractStructuredData } from '@intuned/browser/ai';
-export default async function handler(params, page, context){
-const textContent: TextContentItem = {
-  type: "text",
-  data: "John Doe, age 30, works as a Software Engineer at Tech Corp"
-};
-
-const person = await extractStructuredData({
-  content: textContent,
-  model: "gpt-4o",
-  dataSchema: {
-  type: "object",
-  properties: {
-    name: { type: "string" },
-    age: { type: "number" },
-    occupation: { type: "string" },
-    company: { type: "string" }
-  },
-  required: ["name"]
-},
-  prompt: "Extract person information from the text"
-});
-
-console.log(`Found person: ${person.name}, ${person.age} years old`);
-}
-```
-
-```typescript Multiple Content Items
-import { extractStructuredData } from '@intuned/browser/ai';
-export default async function handler(params, page, context){
-const mixedContent = [
-  { type: "text", data: "Product: iPhone 15" },
-  { type: "image-url", image_type: "jpeg", data: "https://mintcdn.com/intuned-7/asXJUUPBWwDlStUB/logo/light.svg?fit=max&auto=format&n=asXJUUPBWwDlStUB&q=85&s=6525c0b299b3226464eba6afa9b7ebe6" }
-];
-
-
-const product = await extractStructuredData({
-  content: mixedContent,
-  model: "claude-3",
-  dataSchema: {
-  type: "object",
-  properties: {
-    name: { type: "string" },
-    price: { type: "string" },
-    features: { type: "array", items: { type: "string" } }
-  }
-},
-  maxRetries: 1,
-  enableCache: true
-});
-}
-```
-
-</CodeGroup>
-
-## Arguments
-
-<ParamField path="options" type="Object" required
->
-Configuration object containing extraction parameters
-
-<Expandable title="options">
-<ParamField path="options.content" type="Array<ContentItem> | ContentItem">
-Content to extract data from - can be a single content item or array of content items
-</ParamField>
-
-<ParamField path="options.dataSchema" type="JsonSchema | z.ZodSchema">
-JsonSchema defining the structure of the data to extract
-</ParamField>
-
-<ParamField path="options.prompt" type="string">
-Optional prompt to guide the extraction process and provide more context
-</ParamField>
-
-<ParamField path="options.enableCache" type="boolean">
-Whether to enable caching of the extracted data. Defaults to true
-</ParamField>
-
-<ParamField path="options.maxRetries" type="number">
-Maximum number of retry attempts on failures. Failures can be validation errors, API errors, output errors, etc. Defaults to 3
-</ParamField>
-
-<ParamField path="options.model" type="SUPPORTED_MODELS">
-AI model to use for extraction (e.g., "gpt-4", "claude-3"), see [SUPPORTED_MODELS](../type-aliases/SUPPORTED_MODELS) for all supported models
-</ParamField>
-
-<ParamField path="options.apiKey" type="string">
-Optional API key for AI extraction (if provided, will not be billed to your account)
-</ParamField>
-
-</Expandable>
-
-</ParamField>
-
-## Returns: `any`
-
-Promise resolving to the extracted structured data matching the provided schema
-
-</Tab>
-
-</Tabs>

package/generated-docs/ai/functions/isPageLoaded.mdx

@@ -1,89 +0,0 @@
----
-title: isPageLoaded
-description: ""
----
-
-```typescript
-export declare function isPageLoaded(input: {
-  page: Page;
-  timeoutInMs?: number;
-  model?: SUPPORTED_MODELS;
-  apiKey?: string;
-}): Promise<boolean>;
-```
-
-Uses AI vision to determine if a webpage has finished loading by analyzing a screenshot.
-Detects loading spinners, blank content, or incomplete page states.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Check Page Loading
-import { isPageLoaded } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-// Wait for page to finish loading
-await page.goto('https://example.com');
-
-const pageLoaded = await isPageLoaded({page});
-if (pageLoaded) {
-  // Continue with scraping or interactions
-} else {
-  // Wait longer or retry
-}
-}
-```
-
-```typescript Loading Loop
-import { isPageLoaded } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-// Keep checking until page loads
-await page.goto("https://example.com");
-let attempts = 0;
-while (attempts < 10) {
-  const pageLoaded = await isPageLoaded({
-    page,
-    model: "gpt-4o",
-    timeoutInMs: 5000
-  });
-  if (pageLoaded) break;
-
-  await page.waitForTimeout(2000);
-  attempts++;
-}
-}
-```
-}
-
-</CodeGroup>
-
-## Arguments
-
-<ParamField path="input" type="Object" required
->
-Input object containing the page to check
-
-<Expandable title="input">
-<ParamField path="input.page" type="Page">
-The Playwright page to check
-</ParamField>
-
-<ParamField path="input.timeoutInMs" type="number">
-Screenshot timeout in milliseconds. Defaults to 10000
-</ParamField>
-
-<ParamField path="input.model" type="SUPPORTED_MODELS">
-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"
-</ParamField>
-
-<ParamField path="input.apiKey" type="string">
-Optional API key for the AI service (if provided, will not be billed to your account)
-</ParamField>
-
-</Expandable>
-
-</ParamField>
-
-## Returns: `Promise<boolean>`
-
-Promise resolving to true if page is loaded, false if still loading

package/generated-docs/ai/interfaces/ArraySchema.mdx

@@ -1,36 +0,0 @@
----
-title: ArraySchema
-description: ""
----
-
-```typescript
-export interface ArraySchema extends BasicSchema {
-  type: "array";
-  items: JsonSchema | z.ZodSchema;
-  maxItems?: number;
-  minItems?: number;
-  uniqueItems?: boolean;
-}
-```
-
-Schema definition for array values with item validation and constraints.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Array Schema
-import { ArraySchema } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-const tagsSchema: ArraySchema = {
-  type: "array",
-  items: { type: "string" },
-  minItems: 1,
-  maxItems: 10,
-  uniqueItems: true,
-  description: "List of tags"
-};
-}
-```
-
-</CodeGroup>

package/generated-docs/ai/interfaces/BasicSchema.mdx

@@ -1,14 +0,0 @@
----
-title: BasicSchema
-description: ""
----
-
-```typescript
-export interface BasicSchema {
-  type: "string" | "number" | "integer" | "boolean" | "array" | "object";
-  description?: string;
-}
-```
-
-Base schema interface that all JSON schema types extend from.
-Provides common properties like type and description.

package/generated-docs/ai/interfaces/BooleanSchema.mdx

@@ -1,28 +0,0 @@
----
-title: BooleanSchema
-description: ""
----
-
-```typescript
-export interface BooleanSchema extends BasicSchema {
-  type: "boolean";
-}
-```
-
-Schema definition for boolean values.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Boolean Schema
-import { BooleanSchema } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-const isActiveSchema: BooleanSchema = {
-  type: "boolean",
-  description: "Whether the user account is active"
-};
-}
-```
-
-</CodeGroup>

package/generated-docs/ai/interfaces/ImageBufferContentItem.mdx

@@ -1,16 +0,0 @@
----
-title: ImageBufferContentItem
-description: ""
----
-
-```typescript
-export interface ImageBufferContentItem {
-  type: "image-buffer";
-  image_type: "png" | "jpeg" | "gif" | "webp";
-  data: Buffer;
-}
-```
-
-Represents image content provided as a Buffer for AI extraction.
-Used when passing image data directly to extractStructuredData without a page source.
-The image will be analyzed by AI vision models for data extraction.

package/generated-docs/ai/interfaces/ImageUrlContentItem.mdx

@@ -1,16 +0,0 @@
----
-title: ImageUrlContentItem
-description: ""
----
-
-```typescript
-export interface ImageUrlContentItem {
-  type: "image-url";
-  image_type: "png" | "jpeg" | "gif" | "webp";
-  data: string;
-}
-```
-
-Represents image content provided as a URL for AI extraction.
-Used when passing image URLs directly to extractStructuredData without a page source.
-The image will be fetched from the URL and analyzed by AI vision models for data extraction.

package/generated-docs/ai/interfaces/NumberSchema.mdx

@@ -1,35 +0,0 @@
----
-title: NumberSchema
-description: ""
----
-
-```typescript
-export interface NumberSchema extends BasicSchema {
-  type: "number" | "integer";
-  multipleOf?: number;
-  maximum?: number;
-  exclusiveMaximum?: number;
-  minimum?: number;
-  exclusiveMinimum?: number;
-}
-```
-
-Schema definition for numeric values (numbers and integers) with validation constraints.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Number Schema
-import { NumberSchema } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-const ageSchema: NumberSchema = {
-  type: "integer",
-  minimum: 0,
-  maximum: 150,
-  description: "Person's age in years"
-};
-}
-```
-
-</CodeGroup>

package/generated-docs/ai/interfaces/ObjectSchema.mdx

@@ -1,39 +0,0 @@
----
-title: ObjectSchema
-description: ""
----
-
-```typescript
-export interface ObjectSchema extends BasicSchema {
-  type: "object";
-  properties: Record<string,
-  JsonSchema | z.ZodSchema>;
-  required?: string[];
-  maxProperties?: number;
-  minProperties?: number;
-}
-```
-
-Schema definition for object values with property validation and constraints.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Object Schema
-import { ObjectSchema } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-const userSchema: ObjectSchema = {
-  type: "object",
-  properties: {
-    name: { type: "string" },
-    email: { type: "string", pattern: "^[^@]+@[^@]+\\.[^@]+$" },
-    age: { type: "integer", minimum: 0 }
-  },
-  required: ["name", "email"],
-  description: "User profile information"
-};
-}
-```
-
-</CodeGroup>

package/generated-docs/ai/interfaces/StringSchema.mdx

@@ -1,35 +0,0 @@
----
-title: StringSchema
-description: ""
----
-
-```typescript
-export interface StringSchema extends BasicSchema {
-  type: "string";
-  enum?: string[];
-  maxLength?: number;
-  minLength?: number;
-  pattern?: string;
-}
-```
-
-Schema definition for string values with validation constraints.
-
-## Examples
-
-<CodeGroup>
-
-```typescript String Schema
-import { StringSchema } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-const nameSchema: StringSchema = {
-  type: "string",
-  minLength: 2,
-  maxLength: 50,
-  pattern: "^[A-Za-z\\s]+$",
-  description: "Person's full name"
-};
-}
-```
-
-</CodeGroup>

package/generated-docs/ai/interfaces/TextContentItem.mdx

@@ -1,14 +0,0 @@
----
-title: TextContentItem
-description: ""
----
-
-```typescript
-export interface TextContentItem {
-  type: "text";
-  data: string;
-}
-```
-
-Represents text content for AI extraction.
-Used when passing text data directly to extractStructuredData without a page source.

package/generated-docs/ai/type-aliases/ContentItem.mdx

@@ -1,12 +0,0 @@
----
-title: ContentItem
-description: ""
----
-
-```typescript
-export type ContentItem = | TextContentItem
-  | ImageBufferContentItem
-  | ImageUrlContentItem;
-```
-
-Union type representing all content items for AI data extraction.

package/generated-docs/ai/type-aliases/JsonSchema.mdx

@@ -1,47 +0,0 @@
----
-title: JsonSchema
-description: ""
----
-
-```typescript
-export type JsonSchema = | StringSchema
-  | NumberSchema
-  | BooleanSchema
-  | ArraySchema
-  | ObjectSchema;
-```
-
-Union type representing all supported JSON schema types.
-Can be a StringSchema, NumberSchema, BooleanSchema, ArraySchema, or ObjectSchema.
-Each schema type provides validation constraints for its respective data type.
-
-## Examples
-
-<CodeGroup>
-
-```typescript Object Schema
-import { JsonSchema } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-const schema: JsonSchema = {
-  type: "object",
-  properties: {
-    name: { type: "string" },
-    age: { type: "number" }
-  },
-  required: ["name"]
-};
-}
-```
-
-```typescript Array Schema
-import { JsonSchema } from "@intuned/browser/ai";
-export default async function handler(params, page, context){
-const schema: JsonSchema = {
-  type: "array",
-  items: { type: "string" },
-  minItems: 1
-};
-}
-```
-
-</CodeGroup>