@bctrl/sdk 1.0.1 → 1.0.2

package/dist/contracts/drivers/puppeteer.js

@@ -1,941 +0,0 @@
-/**
- * AUTO-GENERATED FILE - DO NOT EDIT
- *
- * Generated from: packages/automation-spec/src/drivers/puppeteer/options.ts
- * Run `pnpm generate:sdk-contracts` to regenerate.
- */
-/**
- * Puppeteer-specific option schemas
- *
- * These match the real Puppeteer API 1:1.
- * @see https://pptr.dev/api
- */
-import { z } from 'zod';
-// ============================================================================
-// Puppeteer Wait Until Values
-// ============================================================================
-export const PuppeteerWaitUntilSchema = z.enum([
-    'load',
-    'domcontentloaded',
-    'networkidle0',
-    'networkidle2',
-]);
-// waitUntil can be a single value or array of values
-export const PuppeteerWaitUntilOptionSchema = z.union([
-    PuppeteerWaitUntilSchema,
-    z.array(PuppeteerWaitUntilSchema),
-]);
-// ============================================================================
-// Navigation Options
-// ============================================================================
-export const PuppeteerGotoOptionsSchema = z.object({
-    waitUntil: PuppeteerWaitUntilOptionSchema.optional(),
-    timeout: z.number().nonnegative().optional(),
-    referer: z.string().optional(),
-    referrerPolicy: z.string().optional(),
-});
-export const PuppeteerWaitForNavigationOptionsSchema = z.object({
-    waitUntil: PuppeteerWaitUntilOptionSchema.optional(),
-    timeout: z.number().nonnegative().optional(),
-});
-// ReloadOptions extends WaitForOptions - https://pptr.dev/api/puppeteer.reloadoptions
-export const PuppeteerReloadOptionsSchema = PuppeteerWaitForNavigationOptionsSchema.extend({
-    ignoreCache: z.boolean().optional(),
-});
-// WaitForNetworkIdleOptions - https://pptr.dev/api/puppeteer.waitfornetworkidleoptions
-export const PuppeteerWaitForNetworkIdleOptionsSchema = z.object({
-    /** Maximum number of concurrent network connections to be considered inactive. Default: 0 */
-    concurrency: z.number().int().nonnegative().optional(),
-    /** Time in milliseconds the network should be idle. Default: 500 */
-    idleTime: z.number().nonnegative().optional(),
-    /** Maximum wait time in milliseconds. Pass 0 to disable timeout. Default: 30000 */
-    timeout: z.number().nonnegative().optional(),
-});
-// ============================================================================
-// HTTP Response (serialized for RPC)
-// ============================================================================
-// RemoteAddress - https://pptr.dev/api/puppeteer.remoteaddress
-export const PuppeteerRemoteAddressSchema = z.object({
-    ip: z.string().optional(),
-    port: z.number().optional(),
-});
-// SecurityDetails - https://pptr.dev/api/puppeteer.securitydetails
-export const PuppeteerSecurityDetailsSchema = z.object({
-    issuer: z.string(),
-    protocol: z.string(),
-    subjectName: z.string(),
-    validFrom: z.number(),
-    validTo: z.number(),
-    subjectAlternativeNames: z.array(z.string()),
-});
-// ResourceTiming - https://developer.chrome.com/docs/devtools/network/reference/#timing
-// Based on CDP Network.ResourceTiming
-export const PuppeteerResourceTimingSchema = z.object({
-    requestTime: z.number(),
-    proxyStart: z.number(),
-    proxyEnd: z.number(),
-    dnsStart: z.number(),
-    dnsEnd: z.number(),
-    connectStart: z.number(),
-    connectEnd: z.number(),
-    sslStart: z.number(),
-    sslEnd: z.number(),
-    workerStart: z.number(),
-    workerReady: z.number(),
-    workerFetchStart: z.number(),
-    workerRespondWithSettled: z.number(),
-    sendStart: z.number(),
-    sendEnd: z.number(),
-    pushStart: z.number(),
-    pushEnd: z.number(),
-    receiveHeadersStart: z.number(),
-    receiveHeadersEnd: z.number(),
-});
-// HTTPResponse (serialized for RPC) - https://pptr.dev/api/puppeteer.httpresponse
-// Extended with responseId for RPC tracking and all synchronous properties serialized
-export const PuppeteerHTTPResponseSchema = z.object({
-    responseId: z.string(),
-    url: z.string(),
-    status: z.number(),
-    statusText: z.string(),
-    headers: z.record(z.string(), z.string()),
-    ok: z.boolean(),
-    fromCache: z.boolean(),
-    fromServiceWorker: z.boolean(),
-    remoteAddress: PuppeteerRemoteAddressSchema.optional(),
-    securityDetails: PuppeteerSecurityDetailsSchema.optional(),
-    timing: PuppeteerResourceTimingSchema.optional(),
-    // References for related objects (fetched via RPC if needed)
-    requestId: z.string().optional(),
-    frameId: z.string().optional(),
-});
-// ============================================================================
-// Mouse Options
-// ============================================================================
-// MouseButton - https://pptr.dev/api/puppeteer.mousebutton
-export const PuppeteerMouseButtonSchema = z.enum(['left', 'right', 'middle', 'back', 'forward']);
-// Point - https://pptr.dev/api/puppeteer.point
-export const PuppeteerPointSchema = z.object({
-    x: z.number(),
-    y: z.number(),
-});
-// Offset - https://pptr.dev/api/puppeteer.offset
-export const PuppeteerOffsetSchema = z.object({
-    x: z.number(),
-    y: z.number(),
-});
-// MouseOptions - https://pptr.dev/api/puppeteer.mouseoptions
-export const PuppeteerMouseOptionsSchema = z.object({
-    button: PuppeteerMouseButtonSchema.optional(),
-    clickCount: z.number().int().positive().optional(), // deprecated
-});
-// MouseClickOptions extends MouseOptions - https://pptr.dev/api/puppeteer.mouseclickoptions
-export const PuppeteerMouseClickOptionsSchema = PuppeteerMouseOptionsSchema.extend({
-    count: z.number().int().positive().optional(),
-    delay: z.number().nonnegative().optional(),
-});
-// ClickOptions extends MouseClickOptions - https://pptr.dev/api/puppeteer.clickoptions
-export const PuppeteerClickOptionsSchema = PuppeteerMouseClickOptionsSchema.extend({
-    offset: PuppeteerOffsetSchema.optional(),
-    /** @experimental If true, highlights the click location for debugging. */
-    debugHighlight: z.boolean().optional(),
-});
-// MouseMoveOptions - https://pptr.dev/api/puppeteer.mousemoveoptions
-export const PuppeteerMouseMoveOptionsSchema = z.object({
-    steps: z.number().int().positive().optional(),
-});
-// MouseWheelOptions - https://pptr.dev/api/puppeteer.mousewheeloptions
-export const PuppeteerMouseWheelOptionsSchema = z.object({
-    deltaX: z.number().optional(),
-    deltaY: z.number().optional(),
-});
-// DragData - https://chromedevtools.github.io/devtools-protocol/tot/Input/#type-DragData
-// Used by drag, dragEnter, dragOver, drop methods
-export const PuppeteerDragDataItemSchema = z.object({
-    mimeType: z.string(),
-    data: z.string(),
-    title: z.string().optional(),
-    baseURL: z.string().optional(),
-});
-export const PuppeteerDragDataSchema = z.object({
-    items: z.array(PuppeteerDragDataItemSchema),
-    files: z.array(z.string()).optional(),
-    dragOperationsMask: z.number().int(),
-});
-// KeyboardTypeOptions - https://pptr.dev/api/puppeteer.keyboardtypeoptions
-export const PuppeteerKeyboardTypeOptionsSchema = z.object({
-    delay: z.number().nonnegative().optional(),
-});
-// KeyDownOptions - https://pptr.dev/api/puppeteer.keydownoptions
-export const PuppeteerKeyDownOptionsSchema = z.object({
-    text: z.string().optional(),
-    commands: z.array(z.string()).optional(),
-});
-// KeyPressOptions - https://pptr.dev/api/puppeteer.keypressoptions
-export const PuppeteerKeyPressOptionsSchema = z.object({
-    delay: z.number().nonnegative().optional(),
-    text: z.string().optional(),
-    commands: z.array(z.string()).optional(),
-});
-// ============================================================================
-// Wait Options
-// ============================================================================
-export const PuppeteerWaitForOptionsSchema = z.object({
-    timeout: z.number().positive().optional(),
-    visible: z.boolean().optional(),
-    hidden: z.boolean().optional(),
-});
-// ============================================================================
-// Screenshot Options
-// ============================================================================
-// ScreenshotClip extends BoundingBox - https://pptr.dev/api/puppeteer.screenshotclip
-export const PuppeteerScreenshotClipSchema = z.object({
-    x: z.number(),
-    y: z.number(),
-    width: z.number().positive(),
-    height: z.number().positive(),
-    scale: z.number().positive().optional(), // default: 1
-});
-// Keep alias for backwards compatibility
-/** @deprecated Use PuppeteerScreenshotClipSchema instead */
-export const PuppeteerClipRegionSchema = PuppeteerScreenshotClipSchema;
-// ImageFormat - https://pptr.dev/api/puppeteer.imageformat
-export const PuppeteerImageFormatSchema = z.enum(['png', 'jpeg', 'webp']);
-export const PuppeteerScreenshotOptionsSchema = z.object({
-    path: z.string().optional(),
-    type: PuppeteerImageFormatSchema.optional(),
-    quality: z.number().int().min(0).max(100).optional(),
-    fullPage: z.boolean().optional(),
-    clip: PuppeteerScreenshotClipSchema.optional(),
-    omitBackground: z.boolean().optional(),
-    encoding: z.enum(['base64', 'binary']).optional(),
-    captureBeyondViewport: z.boolean().optional(),
-    fromSurface: z.boolean().optional(), // default: true - capture from surface rather than view
-    optimizeForSpeed: z.boolean().optional(), // default: false
-});
-// ============================================================================
-// PDF Options
-// ============================================================================
-export const PuppeteerPDFMarginSchema = z.object({
-    top: z.union([z.string(), z.number()]).optional(),
-    right: z.union([z.string(), z.number()]).optional(),
-    bottom: z.union([z.string(), z.number()]).optional(),
-    left: z.union([z.string(), z.number()]).optional(),
-});
-// PaperFormat - https://pptr.dev/api/puppeteer.paperformat
-export const PuppeteerPaperFormatSchema = z.enum([
-    'letter',
-    'legal',
-    'tabloid',
-    'ledger',
-    'a0',
-    'a1',
-    'a2',
-    'a3',
-    'a4',
-    'a5',
-    'a6',
-]);
-export const PuppeteerPDFOptionsSchema = z.object({
-    path: z.string().optional(),
-    scale: z.number().positive().optional(),
-    displayHeaderFooter: z.boolean().optional(),
-    headerTemplate: z.string().optional(),
-    footerTemplate: z.string().optional(),
-    printBackground: z.boolean().optional(),
-    landscape: z.boolean().optional(),
-    pageRanges: z.string().optional(),
-    format: z.union([PuppeteerPaperFormatSchema, z.string()]).optional(),
-    width: z.union([z.string(), z.number()]).optional(),
-    height: z.union([z.string(), z.number()]).optional(),
-    margin: PuppeteerPDFMarginSchema.optional(),
-    preferCSSPageSize: z.boolean().optional(),
-    omitBackground: z.boolean().optional(),
-    timeout: z.number().nonnegative().optional(), // 0 disables timeout
-    /** @experimental Generate a document outline. */
-    outline: z.boolean().optional(),
-    /** @experimental Generate a tagged (accessible) PDF. Default: true */
-    tagged: z.boolean().optional(),
-    /** Wait for document.fonts.ready before generating PDF. Default: true */
-    waitForFonts: z.boolean().optional(),
-});
-// ============================================================================
-// Viewport Options
-// ============================================================================
-export const PuppeteerViewportSchema = z.object({
-    width: z.number().int().positive(),
-    height: z.number().int().positive(),
-    deviceScaleFactor: z.number().positive().optional(),
-    isMobile: z.boolean().optional(),
-    hasTouch: z.boolean().optional(),
-    isLandscape: z.boolean().optional(),
-});
-// ============================================================================
-// Cookie Options
-// ============================================================================
-// CookiePartitionKey - https://pptr.dev/api/puppeteer.cookiepartitionkey
-// Represents a cookie partition key in Chrome
-export const PuppeteerCookiePartitionKeySchema = z.object({
-    sourceOrigin: z.string(), // Required - site of top-level URL
-    hasCrossSiteAncestor: z.boolean().optional(), // Chrome only
-});
-// CookieSameSite - https://pptr.dev/api/puppeteer.cookiesamesite
-export const PuppeteerCookieSameSiteSchema = z.enum(['Strict', 'Lax', 'None']);
-// CookiePriority - https://pptr.dev/api/puppeteer.cookiepriority
-export const PuppeteerCookiePrioritySchema = z.enum(['Low', 'Medium', 'High']);
-// CookieSourceScheme - https://pptr.dev/api/puppeteer.cookiesourcescheme
-export const PuppeteerCookieSourceSchemeSchema = z.enum(['Unset', 'NonSecure', 'Secure']);
-// Cookie - returned by cookies() method
-export const PuppeteerCookieSchema = z.object({
-    name: z.string(),
-    value: z.string(),
-    domain: z.string().optional(),
-    path: z.string().optional(),
-    expires: z.number().optional(),
-    httpOnly: z.boolean().optional(),
-    secure: z.boolean().optional(),
-    sameSite: PuppeteerCookieSameSiteSchema.optional(),
-});
-// CookieData - for browser.setCookie() - https://pptr.dev/api/puppeteer.cookiedata
-export const PuppeteerCookieDataSchema = z.object({
-    name: z.string(),
-    value: z.string(),
-    domain: z.string(),
-    path: z.string().optional(),
-    expires: z.number().optional(),
-    httpOnly: z.boolean().optional(),
-    secure: z.boolean().optional(),
-    sameSite: PuppeteerCookieSameSiteSchema.optional(),
-    priority: PuppeteerCookiePrioritySchema.optional(),
-    sameParty: z.boolean().optional(),
-    sourceScheme: PuppeteerCookieSourceSchemeSchema.optional(),
-    partitionKey: z.union([PuppeteerCookiePartitionKeySchema, z.string()]).optional(),
-});
-// DeleteCookiesRequest - for deleteMatchingCookies() - https://pptr.dev/api/puppeteer.deletecookiesrequest
-export const PuppeteerDeleteCookiesRequestSchema = z.object({
-    name: z.string(),
-    domain: z.string().optional(),
-    path: z.string().optional(),
-    url: z.string().optional(),
-    partitionKey: z.union([PuppeteerCookiePartitionKeySchema, z.string()]).optional(),
-});
-// ============================================================================
-// Window Options
-// ============================================================================
-// WindowState - https://pptr.dev/api/puppeteer.windowstate
-export const PuppeteerWindowStateSchema = z.enum([
-    'normal',
-    'minimized',
-    'maximized',
-    'fullscreen',
-]);
-// WindowBounds - https://pptr.dev/api/puppeteer.windowbounds
-export const PuppeteerWindowBoundsSchema = z.object({
-    left: z.number().optional(),
-    top: z.number().optional(),
-    width: z.number().optional(),
-    height: z.number().optional(),
-    windowState: PuppeteerWindowStateSchema.optional(),
-});
-// ============================================================================
-// Target Options
-// ============================================================================
-// TargetType - https://pptr.dev/api/puppeteer.targettype
-export const PuppeteerTargetTypeSchema = z.enum([
-    'background_page',
-    'browser',
-    'other',
-    'page',
-    'service_worker',
-    'shared_worker',
-    'webview',
-]);
-// Target (serialized for RPC) - https://pptr.dev/api/puppeteer.target
-export const PuppeteerTargetSchema = z.object({
-    targetId: z.string(),
-    type: PuppeteerTargetTypeSchema,
-    url: z.string(),
-    title: z.string().optional(),
-    attached: z.boolean().optional(),
-    openerId: z.string().optional(),
-    browserContextId: z.string().optional(),
-});
-// WaitForTargetOptions - https://pptr.dev/api/puppeteer.waitfortargetoptions
-// Note: AbortSignal cannot be serialized over RPC, so it's omitted
-export const PuppeteerWaitForTargetOptionsSchema = z.object({
-    timeout: z.number().optional(), // default 30000ms, 0 to disable
-});
-// TargetFilter - for RPC-based waitForTarget (replaces predicate function)
-// Since functions can't be serialized, we use filter criteria instead
-export const PuppeteerTargetFilterSchema = z.object({
-    type: PuppeteerTargetTypeSchema.optional(),
-    url: z.string().optional(), // exact match or regex pattern
-    urlPattern: z.string().optional(), // regex pattern for URL matching
-});
-// ============================================================================
-// Browser Context Options
-// ============================================================================
-// DownloadPolicy - https://pptr.dev/api/puppeteer.downloadpolicy
-export const PuppeteerDownloadPolicySchema = z.enum(['deny', 'allow', 'allowAndName', 'default']);
-// DownloadBehavior - https://pptr.dev/api/puppeteer.downloadbehavior
-export const PuppeteerDownloadBehaviorSchema = z.object({
-    policy: PuppeteerDownloadPolicySchema,
-    downloadPath: z.string().optional(),
-});
-// BrowserContextOptions - https://pptr.dev/api/puppeteer.browsercontextoptions
-export const PuppeteerBrowserContextOptionsSchema = z.object({
-    /** Proxy server with optional port to use for all requests. */
-    proxyServer: z.string().optional(),
-    /** Bypass the proxy for the given list of hosts. */
-    proxyBypassList: z.array(z.string()).optional(),
-    /** Behavior definition for when downloading a file. */
-    downloadBehavior: PuppeteerDownloadBehaviorSchema.optional(),
-});
-// ============================================================================
-// Permission Options
-// ============================================================================
-// Permission - https://pptr.dev/api/puppeteer.permission
-export const PuppeteerPermissionSchema = z.enum([
-    'geolocation',
-    'midi',
-    'notifications',
-    'camera',
-    'microphone',
-    'background-sync',
-    'ambient-light-sensor',
-    'accelerometer',
-    'gyroscope',
-    'magnetometer',
-    'accessibility-events',
-    'clipboard-read',
-    'clipboard-write',
-    'clipboard-sanitized-write',
-    'payment-handler',
-    'persistent-storage',
-    'idle-detection',
-    'midi-sysex',
-]);
-// ============================================================================
-// Geolocation Options
-// ============================================================================
-export const PuppeteerGeolocationSchema = z.object({
-    latitude: z.number().min(-90).max(90),
-    longitude: z.number().min(-180).max(180),
-    accuracy: z.number().positive().optional(),
-});
-// ============================================================================
-// Bounding Box Result
-// ============================================================================
-export const PuppeteerBoundingBoxSchema = z.object({
-    x: z.number(),
-    y: z.number(),
-    width: z.number(),
-    height: z.number(),
-});
-// ============================================================================
-// Box Model
-// ============================================================================
-// BoxModel - https://pptr.dev/api/puppeteer.boxmodel
-export const PuppeteerBoxModelSchema = z.object({
-    content: z.array(PuppeteerPointSchema),
-    padding: z.array(PuppeteerPointSchema),
-    border: z.array(PuppeteerPointSchema),
-    margin: z.array(PuppeteerPointSchema),
-    width: z.number(),
-    height: z.number(),
-});
-// ============================================================================
-// Autofill Options
-// ============================================================================
-// CreditCard - https://pptr.dev/api/puppeteer.elementhandle.autofill
-export const PuppeteerCreditCardSchema = z.object({
-    number: z.string(),
-    name: z.string(),
-    expiryMonth: z.string(),
-    expiryYear: z.string(),
-    cvc: z.string(),
-});
-// AutofillData - https://pptr.dev/api/puppeteer.elementhandle.autofill
-export const PuppeteerAutofillDataSchema = z.object({
-    creditCard: PuppeteerCreditCardSchema,
-});
-// ============================================================================
-// Wait for Selector Options
-// ============================================================================
-// WaitForSelectorOptions - https://pptr.dev/api/puppeteer.waitforselectoroptions
-export const PuppeteerWaitForSelectorOptionsSchema = z.object({
-    visible: z.boolean().optional(),
-    hidden: z.boolean().optional(),
-    timeout: z.number().optional(),
-});
-// ============================================================================
-// Frame Add Script/Style Tag Options
-// ============================================================================
-// FrameAddScriptTagOptions - https://pptr.dev/api/puppeteer.frameaddscripttagoptions
-export const PuppeteerFrameAddScriptTagOptionsSchema = z.object({
-    url: z.string().optional(),
-    path: z.string().optional(),
-    content: z.string().optional(),
-    type: z.string().optional(),
-    id: z.string().optional(),
-});
-// FrameAddStyleTagOptions - https://pptr.dev/api/puppeteer.frameaddstyletagoptions
-export const PuppeteerFrameAddStyleTagOptionsSchema = z.object({
-    url: z.string().optional(),
-    path: z.string().optional(),
-    content: z.string().optional(),
-});
-// ============================================================================
-// Select Option
-// ============================================================================
-export const PuppeteerSelectOptionSchema = z.object({
-    value: z.string().optional(),
-    label: z.string().optional(),
-    index: z.number().int().optional(),
-});
-// ============================================================================
-// Serialized Element (for RPC)
-// ============================================================================
-export const PuppeteerSerializedElementSchema = z.object({
-    tagName: z.string(),
-    id: z.string().optional(),
-    className: z.string().optional(),
-    textContent: z.string().optional(),
-    innerText: z.string().optional(),
-    innerHTML: z.string().optional(),
-    attributes: z.record(z.string(), z.string()).optional(),
-});
-// ============================================================================
-// Device Emulation
-// ============================================================================
-// Device - https://pptr.dev/api/puppeteer.device
-export const PuppeteerDeviceSchema = z.object({
-    name: z.string(),
-    userAgent: z.string(),
-    viewport: PuppeteerViewportSchema,
-});
-// ============================================================================
-// Idle State Emulation
-// ============================================================================
-// IdleOverrides - for emulateIdleState
-export const PuppeteerIdleOverridesSchema = z.object({
-    isUserActive: z.boolean(),
-    isScreenUnlocked: z.boolean(),
-});
-// ============================================================================
-// Media Features
-// ============================================================================
-// MediaFeature - for emulateMediaFeatures
-export const PuppeteerMediaFeatureSchema = z.object({
-    name: z.string(),
-    value: z.string(),
-});
-// ============================================================================
-// Network Conditions
-// ============================================================================
-// NetworkConditions - for emulateNetworkConditions
-export const PuppeteerNetworkConditionsSchema = z.object({
-    download: z.number(), // Download speed (bytes/s), -1 to disable
-    upload: z.number(), // Upload speed (bytes/s), -1 to disable
-    latency: z.number(), // Latency (ms)
-});
-// ============================================================================
-// HTTP Request (serialized for RPC)
-// ============================================================================
-// ResourceType - https://pptr.dev/api/puppeteer.resourcetype
-export const PuppeteerResourceTypeSchema = z.enum([
-    'document',
-    'stylesheet',
-    'image',
-    'media',
-    'font',
-    'script',
-    'texttrack',
-    'xhr',
-    'fetch',
-    'prefetch',
-    'eventsource',
-    'websocket',
-    'manifest',
-    'signedexchange',
-    'ping',
-    'cspviolationreport',
-    'preflight',
-    'other',
-]);
-// ErrorCode - https://pptr.dev/api/puppeteer.errorcode
-// Network error codes for HTTPRequest.abort()
-export const PuppeteerErrorCodeSchema = z.enum([
-    'aborted',
-    'accessdenied',
-    'addressunreachable',
-    'blockedbyclient',
-    'blockedbyresponse',
-    'connectionaborted',
-    'connectionclosed',
-    'connectionfailed',
-    'connectionrefused',
-    'connectionreset',
-    'internetdisconnected',
-    'namenotresolved',
-    'timedout',
-    'failed',
-]);
-// InterceptResolutionAction - https://pptr.dev/api/puppeteer.interceptresolutionaction
-export const PuppeteerInterceptResolutionActionSchema = z.enum([
-    'abort',
-    'already-handled',
-    'continue',
-    'disabled',
-    'none',
-    'respond',
-]);
-// InterceptResolutionState - https://pptr.dev/api/puppeteer.interceptresolutionstate
-export const PuppeteerInterceptResolutionStateSchema = z.object({
-    action: PuppeteerInterceptResolutionActionSchema,
-    priority: z.number().optional(),
-});
-// ContinueRequestOverrides - https://pptr.dev/api/puppeteer.continuerequestoverrides
-export const PuppeteerContinueRequestOverridesSchema = z.object({
-    url: z.string().optional(),
-    method: z.string().optional(),
-    postData: z.string().optional(),
-    headers: z.record(z.string(), z.string()).optional(),
-});
-// ResponseForRequest - https://pptr.dev/api/puppeteer.responseforrequest
-export const PuppeteerResponseForRequestSchema = z.object({
-    status: z.number(),
-    headers: z.record(z.string(), z.unknown()).optional(),
-    contentType: z.string().optional(),
-    body: z.union([z.string(), z.instanceof(Uint8Array)]).optional(),
-});
-// Initiator - CDP Network.Initiator type
-// @see https://chromedevtools.github.io/devtools-protocol/tot/Network/#type-Initiator
-export const PuppeteerInitiatorTypeSchema = z.enum([
-    'parser',
-    'script',
-    'preload',
-    'SignedExchange',
-    'preflight',
-    'other',
-]);
-export const PuppeteerInitiatorSchema = z.object({
-    type: PuppeteerInitiatorTypeSchema,
-    url: z.string().optional(),
-    lineNumber: z.number().optional(),
-    columnNumber: z.number().optional(),
-    requestId: z.string().optional(),
-});
-// HTTPRequest (serialized) - https://pptr.dev/api/puppeteer.httprequest
-// Extended to include requestId for RPC tracking
-export const PuppeteerHTTPRequestSchema = z.object({
-    requestId: z.string(),
-    url: z.string(),
-    method: z.string(),
-    headers: z.record(z.string(), z.string()),
-    postData: z.string().optional(),
-    hasPostData: z.boolean().optional(),
-    resourceType: PuppeteerResourceTypeSchema,
-    isNavigationRequest: z.boolean(),
-    initiator: PuppeteerInitiatorSchema.optional(),
-    redirectChain: z.array(z.string()).optional(), // Array of requestIds
-    responseId: z.string().optional(), // Reference to associated response
-    frameId: z.string().optional(), // Reference to frame that initiated
-});
-// ============================================================================
-// Frame (serialized for RPC)
-// ============================================================================
-// Frame (serialized) - https://pptr.dev/api/puppeteer.frame
-export const PuppeteerFrameSchema = z.object({
-    frameId: z.string(),
-    url: z.string(),
-    name: z.string().optional(),
-    parentFrameId: z.string().optional(),
-    isDetached: z.boolean().optional(),
-    isOOPFrame: z.boolean().optional(),
-});
-// ============================================================================
-// WebWorker (serialized for RPC)
-// ============================================================================
-// WebWorker (serialized) - https://pptr.dev/api/puppeteer.webworker
-export const PuppeteerWebWorkerSchema = z.object({
-    workerId: z.string(),
-    url: z.string(),
-});
-// ============================================================================
-// RemoteObject (CDP Protocol types for JSHandle)
-// ============================================================================
-// RemoteObjectType - from CDP Protocol.Runtime.RemoteObject.type
-// @see https://chromedevtools.github.io/devtools-protocol/tot/Runtime/#type-RemoteObject
-export const PuppeteerRemoteObjectTypeSchema = z.enum([
-    'object',
-    'function',
-    'undefined',
-    'string',
-    'number',
-    'boolean',
-    'symbol',
-    'bigint',
-]);
-// RemoteObjectSubtype - from CDP Protocol.Runtime.RemoteObject.subtype
-export const PuppeteerRemoteObjectSubtypeSchema = z.enum([
-    'array',
-    'null',
-    'node',
-    'regexp',
-    'date',
-    'map',
-    'set',
-    'weakmap',
-    'weakset',
-    'iterator',
-    'generator',
-    'error',
-    'proxy',
-    'promise',
-    'typedarray',
-    'arraybuffer',
-    'dataview',
-    'webassemblymemory',
-    'wasmvalue',
-]);
-// RemoteObject - CDP Protocol.Runtime.RemoteObject (simplified for RPC)
-export const PuppeteerRemoteObjectSchema = z.object({
-    type: PuppeteerRemoteObjectTypeSchema,
-    subtype: PuppeteerRemoteObjectSubtypeSchema.optional(),
-    className: z.string().optional(),
-    value: z.unknown().optional(),
-    unserializableValue: z.string().optional(),
-    description: z.string().optional(),
-    objectId: z.string().optional(),
-});
-// ============================================================================
-// Vision Deficiency
-// ============================================================================
-export const PuppeteerVisionDeficiencySchema = z.enum([
-    'none',
-    'achromatopsia',
-    'blurredVision',
-    'deuteranopia',
-    'protanopia',
-    'tritanopia',
-]);
-// SerializedAXNode Zod schema
-export const PuppeteerSerializedAXNodeSchema = z.lazy(() => z.object({
-    // Required - the role of the node (e.g., 'button', 'heading', 'link')
-    role: z.string(),
-    // Common properties
-    name: z.string().optional(),
-    value: z.union([z.string(), z.number()]).optional(),
-    description: z.string().optional(),
-    keyshortcuts: z.string().optional(),
-    roledescription: z.string().optional(),
-    valuetext: z.string().optional(),
-    url: z.string().optional(),
-    // Boolean state properties
-    disabled: z.boolean().optional(),
-    expanded: z.boolean().optional(),
-    focused: z.boolean().optional(),
-    modal: z.boolean().optional(),
-    multiline: z.boolean().optional(),
-    multiselectable: z.boolean().optional(),
-    readonly: z.boolean().optional(),
-    required: z.boolean().optional(),
-    selected: z.boolean().optional(),
-    // Mixed state properties (can be boolean or 'mixed')
-    checked: z.union([z.boolean(), z.literal('mixed')]).optional(),
-    pressed: z.union([z.boolean(), z.literal('mixed')]).optional(),
-    // Numeric properties
-    level: z.number().optional(),
-    valuemin: z.number().optional(),
-    valuemax: z.number().optional(),
-    // Enum properties
-    autocomplete: z.enum(['none', 'inline', 'list', 'both']).optional(),
-    haspopup: z.enum(['false', 'menu', 'listbox', 'tree', 'grid', 'dialog']).optional(),
-    invalid: z.enum(['grammar', 'spelling', 'page', 'step', 'true', 'false']).optional(),
-    orientation: z.enum(['vertical', 'horizontal']).optional(),
-    // Recursive children
-    children: z.array(PuppeteerSerializedAXNodeSchema).optional(),
-}));
-// SnapshotOptions - https://pptr.dev/api/puppeteer.snapshotoptions
-// Options for Accessibility.snapshot()
-export const PuppeteerSnapshotOptionsSchema = z.object({
-    /**
-     * Prune uninteresting nodes from the tree.
-     * @default true
-     */
-    interestingOnly: z.boolean().optional(),
-    /**
-     * Root element handle to get the accessibility tree for.
-     * Note: For RPC, we use an element handle ID string instead of the actual ElementHandle.
-     * If not provided, defaults to the root node of the entire page.
-     */
-    root: z.string().optional(),
-});
-// ============================================================================
-// Tracing Options
-// ============================================================================
-// TracingOptions - https://pptr.dev/api/puppeteer.tracingoptions
-export const PuppeteerTracingOptionsSchema = z.object({
-    categories: z.array(z.string()).optional(),
-    path: z.string().optional(),
-    screenshots: z.boolean().optional(),
-});
-// ============================================================================
-// Dialog Options
-// ============================================================================
-// DialogType - https://pptr.dev/api/puppeteer.dialog
-export const PuppeteerDialogTypeSchema = z.enum(['alert', 'confirm', 'prompt', 'beforeunload']);
-// Dialog (serialized for RPC) - https://pptr.dev/api/puppeteer.dialog
-export const PuppeteerDialogSchema = z.object({
-    dialogId: z.string(),
-    type: PuppeteerDialogTypeSchema,
-    message: z.string(),
-    defaultValue: z.string(),
-});
-// ============================================================================
-// ConsoleMessage Options
-// ============================================================================
-// ConsoleMessageType - https://pptr.dev/api/puppeteer.consolemessagetype
-export const PuppeteerConsoleMessageTypeSchema = z.enum([
-    'log',
-    'debug',
-    'info',
-    'error',
-    'warn',
-    'dir',
-    'dirxml',
-    'table',
-    'trace',
-    'clear',
-    'startGroup',
-    'startGroupCollapsed',
-    'endGroup',
-    'assert',
-    'profile',
-    'profileEnd',
-    'count',
-    'timeEnd',
-    'verbose',
-]);
-// ConsoleMessageLocation - https://pptr.dev/api/puppeteer.consolemessagelocation
-export const PuppeteerConsoleMessageLocationSchema = z.object({
-    url: z.string().optional(),
-    lineNumber: z.number().optional(),
-    columnNumber: z.number().optional(),
-});
-// ConsoleMessage (serialized for RPC) - https://pptr.dev/api/puppeteer.consolemessage
-export const PuppeteerConsoleMessageSchema = z.object({
-    type: PuppeteerConsoleMessageTypeSchema,
-    text: z.string(),
-    location: PuppeteerConsoleMessageLocationSchema,
-    stackTrace: z.array(PuppeteerConsoleMessageLocationSchema),
-    args: z.array(z.unknown()), // Serialized JSON values (JSHandles can't be serialized)
-});
-// ============================================================================
-// TouchHandle (serialized for RPC)
-// ============================================================================
-// TouchHandle - https://pptr.dev/api/puppeteer.touchhandle
-// Serialized version for RPC - contains touch ID to track the touch on the server
-export const PuppeteerTouchHandleSchema = z.object({
-    touchId: z.string(),
-});
-// ============================================================================
-// Locator Options
-// ============================================================================
-// VisibilityOption - https://pptr.dev/api/puppeteer.visibilityoption
-export const PuppeteerVisibilityOptionSchema = z.enum(['visible', 'hidden']).nullable();
-// ActionOptions - base for all locator actions
-// Note: AbortSignal cannot be serialized over RPC, so it's omitted
-export const PuppeteerActionOptionsSchema = z.object({
-    timeout: z.number().nonnegative().optional(),
-});
-// LocatorScrollOptions extends ActionOptions
-export const PuppeteerLocatorScrollOptionsSchema = PuppeteerActionOptionsSchema.extend({
-    scrollLeft: z.number().optional(),
-    scrollTop: z.number().optional(),
-});
-// LocatorClickOptions extends ClickOptions (which extends MouseClickOptions)
-// https://pptr.dev/api/puppeteer.locatorclickoptions
-export const PuppeteerLocatorClickOptionsSchema = PuppeteerClickOptionsSchema.extend({
-    timeout: z.number().nonnegative().optional(),
-});
-// ============================================================================
-// Coverage Options
-// ============================================================================
-// CSSCoverageOptions - https://pptr.dev/api/puppeteer.csscoverageoptions
-export const PuppeteerCSSCoverageOptionsSchema = z.object({
-    resetOnNavigation: z.boolean().optional(),
-});
-// JSCoverageOptions - https://pptr.dev/api/puppeteer.jscoverageoptions
-export const PuppeteerJSCoverageOptionsSchema = z.object({
-    resetOnNavigation: z.boolean().optional(),
-    reportAnonymousScripts: z.boolean().optional(),
-    includeRawScriptCoverage: z.boolean().optional(),
-    useBlockCoverage: z.boolean().optional(),
-});
-// CoverageRange - part of CoverageEntry
-export const PuppeteerCoverageRangeSchema = z.object({
-    start: z.number(),
-    end: z.number(),
-});
-// CoverageEntry - https://pptr.dev/api/puppeteer.coverageentry
-export const PuppeteerCoverageEntrySchema = z.object({
-    url: z.string(),
-    text: z.string(),
-    ranges: z.array(PuppeteerCoverageRangeSchema),
-});
-// JSCoverageEntry extends CoverageEntry - https://pptr.dev/api/puppeteer.jscoverageentry
-// Note: rawScriptCoverage is from CDP Protocol.Profiler.ScriptCoverage, simplified for RPC
-export const PuppeteerJSCoverageEntrySchema = PuppeteerCoverageEntrySchema.extend({
-    rawScriptCoverage: z
-        .object({
-        scriptId: z.string(),
-        url: z.string(),
-        functions: z.array(z.object({
-            functionName: z.string(),
-            ranges: z.array(z.object({
-                startOffset: z.number(),
-                endOffset: z.number(),
-                count: z.number(),
-            })),
-            isBlockCoverage: z.boolean(),
-        })),
-    })
-        .optional(),
-});
-// PageEvent - https://pptr.dev/api/puppeteer.pageevent
-export const PuppeteerPageEventSchema = z.enum([
-    'close',
-    'console',
-    'dialog',
-    'domcontentloaded',
-    'error',
-    'frameattached',
-    'framedetached',
-    'framenavigated',
-    'load',
-    'metrics',
-    'pageerror',
-    'popup',
-    'request',
-    'requestfailed',
-    'requestfinished',
-    'requestservedfromcache',
-    'response',
-    'workercreated',
-    'workerdestroyed',
-]);
-// BrowserEvent - https://pptr.dev/api/puppeteer.browserevent
-export const PuppeteerBrowserEventSchema = z.enum([
-    'disconnected',
-    'targetchanged',
-    'targetcreated',
-    'targetdestroyed',
-]);
-// BrowserContextEvent - https://pptr.dev/api/puppeteer.browsercontextevent
-export const PuppeteerBrowserContextEventSchema = z.enum([
-    'targetchanged',
-    'targetcreated',
-    'targetdestroyed',
-]);