@intuned/runtime-dev 1.2.0-dev-52 → 1.2.1-hooks.1

package/dist/common/asyncLocalStorage/index.d.ts

@@ -8,6 +8,7 @@ interface TimeoutInfo {
 }
 export interface InternalRunInfo extends RunInfo {
     extendedPayloads: Payload[];
+    cdpAddress?: string;
     timeoutInfo?: TimeoutInfo;
     getAuthSessionParameters?: () => Promise<any>;
 }

package/dist/common/constants.d.ts

@@ -1,2 +1,3 @@
+export declare const API_FOLDER_NAME = "api";
 export declare const AUTH_SESSIONS_FOLDER_NAME = "auth-sessions";
 export declare const AUTH_SESSIONS_INSTANCES_FOLDER_NAME = "auth-sessions-instances";

package/dist/common/constants.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.AUTH_SESSIONS_INSTANCES_FOLDER_NAME = exports.AUTH_SESSIONS_FOLDER_NAME = void 0;
+exports.AUTH_SESSIONS_INSTANCES_FOLDER_NAME = exports.AUTH_SESSIONS_FOLDER_NAME = exports.API_FOLDER_NAME = void 0;
+const API_FOLDER_NAME = exports.API_FOLDER_NAME = "api";
 const AUTH_SESSIONS_FOLDER_NAME = exports.AUTH_SESSIONS_FOLDER_NAME = "auth-sessions";
 const AUTH_SESSIONS_INSTANCES_FOLDER_NAME = exports.AUTH_SESSIONS_INSTANCES_FOLDER_NAME = "auth-sessions-instances";

package/dist/common/getPlaywrightConstructs.d.ts

@@ -1,6 +1,6 @@
 import * as playwright from "playwright";
-import type { RunApiSession } from "./runApi";
-interface Proxy {
+import type { ImportFunction, RunApiSession } from "./runApi";
+export interface Proxy {
     server: string;
     username: string;
     password: string;
@@ -10,12 +10,13 @@ interface GetPlaywrightConstructsOptions {
     headless?: boolean;
     storageState?: RunApiSession;
     downloadsPath: string;
+    importFunction?: ImportFunction;
 }
-export declare function getProductionPlaywrightConstructs({ proxy, headless, storageState, downloadsPath, }: GetPlaywrightConstructsOptions): Promise<{
+export declare function getProductionPlaywrightConstructs({ proxy, headless, storageState, downloadsPath, importFunction, }: GetPlaywrightConstructsOptions): Promise<{
     page: playwright.Page;
     context: playwright.BrowserContext;
 }>;
-export declare function getPlaywrightConstructsForMode(mode: "vanilla" | "playwright" | "playwright-standalone" | "playwright-headless", cdpAddress: string | undefined, authSession?: RunApiSession): Promise<{
+export declare function getPlaywrightConstructsForMode(mode: "vanilla" | "playwright" | "playwright-standalone" | "playwright-headless", cdpAddress: string | undefined, authSession?: RunApiSession, importFunction?: ImportFunction): Promise<{
     page: playwright.Page;
     context: playwright.BrowserContext;
 }>;

package/dist/common/getPlaywrightConstructs.js

@@ -33,42 +33,65 @@ async function createUserDirWithPreferences() {
   await (0, _fsExtra.writeFile)((0, _path.join)(defaultDir, "Preferences"), JSON.stringify(preferences));
   return userDir;
 }
+async function loadInitializeContextHook(importFunction) {
+  const result = await importFunction("hooks/initializeContext");
+  if (result.isErr()) {
+    if (result.error.type === "not_found") {
+      return null;
+    }
+    console.error("Error loading initializeBrowser hook");
+    throw result.error.error;
+  }
+  return result.value.default;
+}
 async function getProductionPlaywrightConstructs({
   proxy,
   headless = true,
   storageState,
-  downloadsPath
+  downloadsPath,
+  importFunction
 }) {
-  const extraArgs = ["--no-first-run", "--disable-sync", "--disable-translate", "--disable-features=TranslateUI", "--disable-features=NetworkService", "--lang=en"];
-  if (headless) {
-    extraArgs.push("--headless=new");
+  let context;
+  let page;
+  let hook = null;
+  if (importFunction) {
+    hook = await loadInitializeContextHook(importFunction);
   }
-  const executablePath = playwright.chromium.executablePath();
-  const chromium127Path = executablePath.replace("chromium-1117", "chromium-1124");
-  const isChrome127There = await (0, _fsExtra.exists)(chromium127Path);
-  const userAgent = `Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/${isChrome127There ? 127 : 125}.0.0.0 Safari/537.36`;
-  const userDataDir = await createUserDirWithPreferences();
-  const context = await playwright.chromium.launchPersistentContext(userDataDir, {
-    headless,
-    ignoreDefaultArgs: [...getChromiumLaunchArgsToIgnore(), "--headless"],
-    proxy,
-    executablePath: isChrome127There ? chromium127Path : executablePath,
-    args: extraArgs,
-    downloadsPath,
-    userAgent
-  });
-  context.once("close", async () => {
-    try {
-      await (0, _fsExtra.rm)(userDataDir, {
-        recursive: true,
-        force: true,
-        retryDelay: 1000,
-        maxRetries: 5
-      });
-    } catch (error) {
-      console.error("Failed to remove user data dir", error);
+  if (hook) {
+    ({
+      page,
+      context
+    } = await hook({
+      type: "launch",
+      proxy,
+      headless
+    }));
+  } else {
+    const extraArgs = ["--no-first-run", "--disable-sync", "--disable-translate", "--disable-features=TranslateUI", "--disable-features=NetworkService", "--lang=en"];
+    if (headless) {
+      extraArgs.push("--headless=new");
     }
-  });
+    const userDataDir = await createUserDirWithPreferences();
+    context = await playwright.chromium.launchPersistentContext(userDataDir, {
+      headless,
+      viewport: null,
+      proxy,
+      downloadsPath
+    });
+    context.once("close", async () => {
+      try {
+        await (0, _fsExtra.rm)(userDataDir, {
+          recursive: true,
+          force: true,
+          retryDelay: 1000,
+          maxRetries: 5
+        });
+      } catch (error) {
+        console.error("Failed to remove user data dir", error);
+      }
+    });
+    page = context.pages().at(0) ?? null;
+  }
   if (storageState) {
     await loadSessionToContext({
       context,
@@ -79,7 +102,6 @@ async function getProductionPlaywrightConstructs({
   await context.addInitScript({
     path: assetsFile
   });
-  let page = context.pages().at(0);
   if (page) {
     const scriptString = await (0, _fsExtra.readFile)(assetsFile, "utf8");
     await page.evaluate(scriptString);
@@ -91,15 +113,30 @@ async function getProductionPlaywrightConstructs({
     context
   };
 }
-const getChromiumLaunchArgsToIgnore = () => ["--disable-field-trial-config", "--disable-background-networking", "--enable-features=NetworkService,NetworkServiceInProcess", "--disable-background-timer-throttling", "--disable-backgrounding-occluded-windows", "--disable-back-forward-cache", "--disable-breakpad", "--disable-client-side-phishing-detection", "--disable-component-extensions-with-background-pages", "--disable-component-update", "--no-default-browser-check", "--disable-default-apps", "--disable-dev-shm-usage", "--disable-extensions", "--disable-features=ImprovedCookieControls,LazyFrameLoading,GlobalMediaControls,DestroyProfileOnBrowserClose,MediaRouter,DialMediaRouteProvider,AcceptCHFrame,AutoExpandDetailsElement,CertificateTransparencyComponentUpdater,AvoidUnnecessaryBeforeUnloadCheckSync,Translate,TranslateUI", "--allow-pre-commit-input", "--disable-hang-monitor", "--disable-ipc-flooding-protection", "--disable-prompt-on-repost", "--disable-renderer-backgrounding", "--force-color-profile=srgb", "--metrics-recording-only", "--no-first-run", "--enable-automation", "--password-store=basic", "--use-mock-keychain", "--no-service-autorun", "--export-tagged-pdf", "--enable-use-zoom-for-dsf=false"];
-async function getPlaywrightConstructsForMode(mode, cdpAddress, authSession) {
+async function getPlaywrightConstructsForMode(mode, cdpAddress, authSession, importFunction) {
+  let hook = null;
+  if (importFunction) {
+    hook = await loadInitializeContextHook(importFunction);
+  }
   if (mode == "playwright-standalone") {
     if (!cdpAddress) {
       throw new Error("cdpAddress is required");
     }
-    const {
-      context
-    } = await getRemotePlaywrightContext(cdpAddress);
+    let context;
+    let page = null;
+    if (hook) {
+      ({
+        context,
+        page
+      } = await hook({
+        type: "cdp",
+        cdpAddress
+      }));
+    } else {
+      ({
+        context
+      } = await getRemotePlaywrightContext(cdpAddress));
+    }
     if (!context) {
       throw new Error("no context found");
     }
@@ -107,14 +144,15 @@ async function getPlaywrightConstructsForMode(mode, cdpAddress, authSession) {
     await context.addInitScript({
       path: assetsFile
     });
-    const pages = await context.pages();
-    let page = null;
-    if (pages.length > 0) {
-      page = pages[0];
-      const scriptString = await fs.readFile(assetsFile, "utf8");
-      await page.evaluate(scriptString);
-    } else {
-      page = await context.newPage();
+    const pages = context.pages();
+    if (!page) {
+      if (pages.length > 0) {
+        page = pages[0];
+        const scriptString = await fs.readFile(assetsFile, "utf8");
+        await page.evaluate(scriptString);
+      } else {
+        page = await context.newPage();
+      }
     }
     if (authSession) {
       await loadSessionToContext({

package/dist/common/jwtTokenManager.js

@@ -36,8 +36,7 @@ class JwtTokenManager {
     return Math.max(timeToRefresh, timeWindow);
   }
   async scheduleTokenRefresh() {
-    var _process$env$RUN_ENVI;
-    if (((_process$env$RUN_ENVI = process.env.RUN_ENVIRONMENT) === null || _process$env$RUN_ENVI === void 0 ? void 0 : _process$env$RUN_ENVI.toLowerCase()) !== "authoring") return;
+    if (process.env.RUN_ENVIRONMENT?.toLowerCase() !== "authoring") return;
     const timeToRefresh = this.timeToRefresh;
     if (timeToRefresh === undefined) return;
     if (this.tokenRefreshTimeout) clearTimeout(this.tokenRefreshTimeout);
@@ -51,8 +50,7 @@ class JwtTokenManager {
     }, timeToRefresh);
   }
   async refreshToken() {
-    var _process$env$RUN_ENVI2;
-    if (((_process$env$RUN_ENVI2 = process.env.RUN_ENVIRONMENT) === null || _process$env$RUN_ENVI2 === void 0 ? void 0 : _process$env$RUN_ENVI2.toLowerCase()) !== "authoring") return;
+    if (process.env.RUN_ENVIRONMENT?.toLowerCase() !== "authoring") return;
     const res = await this.fetchWithToken(this.refreshTokenPath, {
       method: "GET"
     });
@@ -65,7 +63,7 @@ class JwtTokenManager {
     if (newToken) this._token = newToken;
   }
   fetchWithToken(...[input, init]) {
-    const headers = new Headers(init === null || init === void 0 ? void 0 : init.headers);
+    const headers = new Headers(init?.headers);
     headers.set("Authorization", `Bearer ${this.token}`);
     return (0, _crossFetch.default)(input, {
       ...init,

package/dist/common/runApi/errors.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.runAutomationErrorCodes = exports.maxLevelsExceededErrorCode = exports.invalidCheckErrorCode = exports.invalidApiErrorCode = exports.internalInvalidInputErrorCode = exports.automationError = exports.authRequiredErrorCode = exports.authCheckNotFoundErrorCode = exports.authCheckFailedErrorCode = exports.apiNotFoundErrorCode = exports.abortedErrorCode = exports.RunAutomationError = exports.MaxLevelsExceededError = exports.InvalidCheckError = exports.InvalidApiError = exports.InternalInvalidInputError = exports.AutomationError = exports.AuthRequiredError = exports.AuthCheckNotFoundError = exports.AuthCheckFailedError = exports.ApiNotFoundError = exports.AbortedError = void 0;
 var _runtime = require("../../runtime");
-var playwright = _interopRequireWildcard(require("playwright"));
+var playwright = _interopRequireWildcard(require("playwright-core"));
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 const apiNotFoundErrorCode = exports.apiNotFoundErrorCode = "APINotFoundError";
@@ -22,11 +22,10 @@ const runAutomationErrorCodes = exports.runAutomationErrorCodes = [apiNotFoundEr
 class RunAutomationError {
   wrapped = false;
   get json() {
-    var _this$cause;
     return {
       code: this.code,
       details: this.details,
-      cause: (_this$cause = this.cause) === null || _this$cause === void 0 ? void 0 : _this$cause.json
+      cause: this.cause?.json
     };
   }
 }
@@ -136,10 +135,10 @@ class AutomationError extends RunAutomationError {
       };
     }
     this.statusCode = 500;
-    this.message = `[${(error === null || error === void 0 ? void 0 : error.name) ?? error}] ${error === null || error === void 0 ? void 0 : error.message}`;
+    this.message = `[${error?.name ?? error}] ${error?.message}`;
     this.details = {
-      name: error === null || error === void 0 ? void 0 : error.name,
-      message: error === null || error === void 0 ? void 0 : error.message
+      name: error?.name,
+      message: error?.message
     };
   }
 }

package/dist/common/runApi/index.d.ts

@@ -8,6 +8,9 @@ export declare function runApiGenerator<ResultType = any, _YieldType = any, _Nex
     retrieveSession: true;
 }): AsyncGenerator<_YieldType, RunApiResult<ResultType, RunApiResultWithSessionOk>, _NextType>;
 export declare function runApiGenerator<ResultType = any, _YieldType = any, _NextType = any>(params: ExtendedRunApiParameters): AsyncGenerator<_YieldType, RunApiResult<ResultType>, _NextType>;
+export declare function runApi<ResultType = any>(params: ExtendedRunApiParameters & {
+    retrieveSession: true;
+}): Promise<RunApiResult<ResultType, RunApiResultWithSessionOk>>;
 export declare function runApi<ResultType = any>(params: ExtendedRunApiParameters): Promise<RunApiResult<ResultType>>;
 export declare function checkAuthSessionWithRetries(page: Page, context: BrowserContext, checkFn: (..._: any) => Promise<boolean>, retries?: number): Promise<Result<boolean, RunAutomationError>>;
 export type ImportFunction = ExtendedRunApiParameters["importFunction"];

package/dist/common/runApi/index.js

@@ -80,17 +80,15 @@ async function* runApiGenerator({
       return;
     }
     try {
-      var _context;
-      await ((_context = context) === null || _context === void 0 ? void 0 : _context.tracing.stop({
+      await context?.tracing.stop({
         path: tracing.filePath
-      }));
+      });
     } catch (error) {
-      console.log(errorMessage, error === null || error === void 0 ? void 0 : error.message);
+      console.log(errorMessage, error?.message);
       await (0, _fsExtra.remove)(tracing.filePath);
     }
   }
   async function* runAutomation() {
-    var _getExecutionContext;
     let page;
     const validatedModuleResult = await importUsingImportFunction(automationFunction.name, importFunction);
     if (validatedModuleResult.isErr()) {
@@ -98,7 +96,7 @@ async function* runApiGenerator({
     }
     const importedModule = validatedModuleResult.value;
     let checkFn;
-    if (auth !== null && auth !== void 0 && auth.runCheck) {
+    if (auth?.runCheck) {
       if (!auth.session) {
         return (0, _neverthrow.err)(new _errors.AuthRequiredError());
       }
@@ -130,7 +128,8 @@ async function* runApiGenerator({
         headless,
         proxy,
         downloadsPath,
-        storageState: auth === null || auth === void 0 ? void 0 : auth.session
+        storageState: auth?.session,
+        importFunction
       }));
     } else {
       const {
@@ -140,7 +139,7 @@ async function* runApiGenerator({
       ({
         page,
         context
-      } = await (0, _getPlaywrightConstructs.getPlaywrightConstructsForMode)(mode, cdpAddress, auth === null || auth === void 0 ? void 0 : auth.session));
+      } = await (0, _getPlaywrightConstructs.getPlaywrightConstructsForMode)(mode, cdpAddress, auth?.session, importFunction));
     }
     if (tracing.enabled) {
       await context.tracing.start({
@@ -152,20 +151,23 @@ async function* runApiGenerator({
     }
     (0, _cleanEnvironmentVariables.cleanEnvironmentVariables)();
     if (checkFn !== undefined) {
-      console.log("Running auth check");
-      const authCheckResult = await checkAuthSessionWithRetries(page, context, checkFn, 2);
-      if (authCheckResult.isErr()) {
-        const error = authCheckResult.error;
-        if (["APINotFoundError", "InvalidAPIError"].includes(error.code)) {
-          return (0, _neverthrow.err)(new _errors.InvalidCheckError(`Auth session check function failed`, error));
+      try {
+        console.log("Running auth check");
+        const authCheckResult = await checkAuthSessionWithRetries(page, context, checkFn, 2);
+        if (authCheckResult.isErr()) {
+          const error = authCheckResult.error;
+          if (["APINotFoundError", "InvalidAPIError"].includes(error.code)) {
+            return (0, _neverthrow.err)(new _errors.InvalidCheckError(`Auth session check function failed`, error));
+          }
+          return authCheckResult;
         }
-        return authCheckResult;
-      }
-      if (!authCheckResult.value) {
+        if (!authCheckResult.value) {
+          return (0, _neverthrow.err)(new _errors.AuthCheckFailedError());
+        }
+      } catch (error) {
         return (0, _neverthrow.err)(new _errors.AuthCheckFailedError());
       }
     }
-    console.log("Running automation");
     const automationFunctionParameters = [...(automationFunction.params !== undefined ? [automationFunction.params] : []), page, context];
     let result;
     if (importedModule.type === "async-generator") {
@@ -185,7 +187,7 @@ async function* runApiGenerator({
     }
     return (0, _neverthrow.ok)({
       result,
-      extendedPayloads: (_getExecutionContext = (0, _asyncLocalStorage.getExecutionContext)()) === null || _getExecutionContext === void 0 ? void 0 : _getExecutionContext.extendedPayloads,
+      extendedPayloads: (0, _asyncLocalStorage.getExecutionContext)()?.extendedPayloads,
       session: retrieveSession ? await (0, _contextStorageStateHelpers.getStorageState)(context) : undefined
     });
   }
@@ -206,11 +208,10 @@ async function* runApiGenerator({
   } catch (error) {
     return (0, _neverthrow.err)(new _errors.AutomationError(error));
   } finally {
-    var _context2;
     await saveTraceIfNeeded({
       errorMessage: "failed to save trace"
     });
-    await ((_context2 = context) === null || _context2 === void 0 ? void 0 : _context2.close());
+    await context?.close();
     if (downloadsPath !== undefined) {
       await fs.remove(downloadsPath);
     }

package/dist/common/runApi/types.d.ts

@@ -25,15 +25,146 @@ export interface RunAutomationResponse {
     status: number;
     body: RunAutomationResult;
 }
+export declare const runApiStorageStateSchema: z.ZodObject<{
+    cookies: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+        domain: z.ZodString;
+        path: z.ZodString;
+        expires: z.ZodNumber;
+        httpOnly: z.ZodBoolean;
+        secure: z.ZodBoolean;
+        sameSite: z.ZodEnum<["Strict", "Lax", "None"]>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        name: string;
+        path: string;
+        domain: string;
+        expires: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite: "Strict" | "Lax" | "None";
+    }, {
+        value: string;
+        name: string;
+        path: string;
+        domain: string;
+        expires: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite: "Strict" | "Lax" | "None";
+    }>, "many">;
+    origins: z.ZodArray<z.ZodObject<{
+        origin: z.ZodString;
+        localStorage: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+        }, {
+            value: string;
+            name: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        origin: string;
+        localStorage: {
+            value: string;
+            name: string;
+        }[];
+    }, {
+        origin: string;
+        localStorage: {
+            value: string;
+            name: string;
+        }[];
+    }>, "many">;
+    sessionStorage: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        origin: z.ZodString;
+        sessionStorage: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            value: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            name: string;
+        }, {
+            value: string;
+            name: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        sessionStorage: {
+            value: string;
+            name: string;
+        }[];
+        origin: string;
+    }, {
+        sessionStorage: {
+            value: string;
+            name: string;
+        }[];
+        origin: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    cookies: {
+        value: string;
+        name: string;
+        path: string;
+        domain: string;
+        expires: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite: "Strict" | "Lax" | "None";
+    }[];
+    origins: {
+        origin: string;
+        localStorage: {
+            value: string;
+            name: string;
+        }[];
+    }[];
+    sessionStorage?: {
+        sessionStorage: {
+            value: string;
+            name: string;
+        }[];
+        origin: string;
+    }[] | undefined;
+}, {
+    cookies: {
+        value: string;
+        name: string;
+        path: string;
+        domain: string;
+        expires: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite: "Strict" | "Lax" | "None";
+    }[];
+    origins: {
+        origin: string;
+        localStorage: {
+            value: string;
+            name: string;
+        }[];
+    }[];
+    sessionStorage?: {
+        sessionStorage: {
+            value: string;
+            name: string;
+        }[];
+        origin: string;
+    }[] | undefined;
+}>;
+export type RunApiStorageState = z.input<typeof runApiStorageStateSchema>;
 export declare const runApiSessionSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"file">;
     path: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    type: "file";
     path: string;
-}, {
     type: "file";
+}, {
     path: string;
+    type: "file";
 }>, z.ZodObject<{
     type: z.ZodLiteral<"state">;
     state: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -255,11 +386,11 @@ export declare const runApiParametersSchema: z.ZodObject<{
             type: z.ZodLiteral<"file">;
             path: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            type: "file";
             path: string;
-        }, {
             type: "file";
+        }, {
             path: string;
+            type: "file";
         }>, z.ZodObject<{
             type: z.ZodLiteral<"state">;
             state: z.ZodOptional<z.ZodNullable<z.ZodObject<{
@@ -452,8 +583,8 @@ export declare const runApiParametersSchema: z.ZodObject<{
         runCheck: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         session: {
-            type: "file";
             path: string;
+            type: "file";
         } | {
             type: "state";
             state?: {
@@ -486,8 +617,8 @@ export declare const runApiParametersSchema: z.ZodObject<{
         runCheck: boolean;
     }, {
         session: {
-            type: "file";
             path: string;
+            type: "file";
         } | {
             type: "state";
             state?: {
@@ -556,13 +687,13 @@ export declare const runApiParametersSchema: z.ZodObject<{
         cdpAddress: z.ZodString;
         mode: z.ZodUnion<[z.ZodLiteral<"vanilla">, z.ZodLiteral<"playwright">, z.ZodLiteral<"playwright-standalone">, z.ZodLiteral<"playwright-headless">]>;
     }, "strip", z.ZodTypeAny, {
+        cdpAddress: string;
         mode: "vanilla" | "playwright" | "playwright-standalone" | "playwright-headless";
         environment: "cdp";
-        cdpAddress: string;
     }, {
+        cdpAddress: string;
         mode: "vanilla" | "playwright" | "playwright-standalone" | "playwright-headless";
         environment: "cdp";
-        cdpAddress: string;
     }>]>>;
     retrieveSession: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
@@ -585,15 +716,15 @@ export declare const runApiParametersSchema: z.ZodObject<{
             password: string;
         } | undefined;
     } | {
+        cdpAddress: string;
         mode: "vanilla" | "playwright" | "playwright-standalone" | "playwright-headless";
         environment: "cdp";
-        cdpAddress: string;
     };
     retrieveSession: boolean;
     auth?: {
         session: {
-            type: "file";
             path: string;
+            type: "file";
         } | {
             type: "state";
             state?: {
@@ -638,8 +769,8 @@ export declare const runApiParametersSchema: z.ZodObject<{
     } | undefined;
     auth?: {
         session: {
-            type: "file";
             path: string;
+            type: "file";
         } | {
             type: "state";
             state?: {
@@ -680,9 +811,9 @@ export declare const runApiParametersSchema: z.ZodObject<{
             password: string;
         } | undefined;
     } | {
+        cdpAddress: string;
         mode: "vanilla" | "playwright" | "playwright-standalone" | "playwright-headless";
         environment: "cdp";
-        cdpAddress: string;
     } | undefined;
     retrieveSession?: boolean | undefined;
 }>;
@@ -703,6 +834,6 @@ export type RunApiResultOk<R = any> = {
     extendedPayloads?: Payload[];
 };
 export type RunApiResultWithSessionOk<R = any> = RunApiResultOk<R> & {
-    session: StorageState;
+    session: RunApiStorageState;
 };
 export type RunApiResult<R = any, FullResult extends RunApiResultOk<R> = RunApiResultOk<R>> = Result<FullResult, RunAutomationError>;