@epsilon-asi/actors 0.0.1

package/README.md

@@ -0,0 +1,435 @@
+# Puppeteer Actor Framework
+
+A TypeScript framework for building website-specific Puppeteer scrapers and actors with reusable login, navigation, extraction, pagination, and human-like interaction abstractions.
+
+The browser runtime supports three practical flows:
+
+1. Launch installed Chrome with an existing persistent profile.
+2. Attach to an already-running Chrome through a local DevTools / remote-debugging endpoint.
+3. Try flow 1 first, and if Chrome reports that the profile is already running, automatically fall back to flow 2.
+
+That third flow is the default for `existing-profile` mode. It lets the caller pass a normal Chrome profile config while still supporting multiple concurrent actors against a single debug-enabled Chrome host.
+
+## What it gives you
+
+- Existing Chrome profile launch via `userDataDir` and optional `--profile-directory`.
+- Automatic profile-lock fallback through Puppeteer `connect()`.
+- Explicit remote-debugging mode using `browserURL` or `browserWSEndpoint`.
+- `browser.defaultBrowserContext()` usage instead of isolated contexts.
+- Fresh tab per connected actor by default, so simultaneous automations do not fight over the same tab.
+- Connected sessions call `browser.disconnect()` instead of closing the shared browser.
+- Reusable `LoginFlow` for simple and multi-step username/password login when the existing profile is not already authenticated.
+- `ghost-cursor` adapter behind a `HumanInteractor` interface.
+- Human-like key-by-key typing at approximately 65 WPM by default, with small randomized inter-key jitter.
+- Login-flow `clearFieldBeforeTyping` support that selects and deletes existing username/password field contents before typing.
+- Ordered multi-step login flows for username-first/password-second forms like Apple ID, Upwork, and similar staged UIs.
+- Strict TypeScript configuration and Vitest unit tests with fake browser/page/cursor fixtures.
+
+## Install
+
+```bash
+npm install
+```
+
+## Verify
+
+```bash
+npm run check
+```
+
+This runs:
+
+```bash
+npm run typecheck
+npm test
+```
+
+## Existing profile mode with automatic running-Chrome fallback
+
+Use the parent Chrome user data directory as `userDataDir`, and use `profileDirectory` for the nested profile folder.
+
+```ts
+import { ActorRunner, exampleActor } from 'puppeteer-actor-framework';
+
+const runner = new ActorRunner({
+  config: {
+    browser: {
+      mode: 'existing-profile',
+      userDataDir: '/Users/alex/ChromeAutomation/UserData',
+      profileDirectory: 'Default',
+      channel: 'chrome',
+      headless: false,
+      runningInstance: {
+        enabled: true,
+        remoteDebuggingHost: '127.0.0.1',
+        remoteDebuggingPort: 9222,
+        reuseExistingPage: false,
+        disconnectOnFinish: true
+      }
+    }
+  }
+});
+
+const rows = await runner.run(exampleActor, 'scrapeDashboard', { limit: 20 });
+console.log(rows);
+```
+
+Behavior:
+
+```txt
+Chrome profile not already running:
+  puppeteer.launch({ userDataDir, args: ['--profile-directory=Default'] })
+
+Chrome profile already running:
+  puppeteer.connect({ browserURL: 'http://127.0.0.1:9222' })
+```
+
+`runningInstance.enabled` defaults to `true`, so this fallback happens automatically when a profile-lock launch error is detected. To disable it:
+
+```ts
+browser: {
+  mode: 'existing-profile',
+  userDataDir: '/Users/alex/ChromeAutomation/UserData',
+  profileDirectory: 'Default',
+  runningInstance: { enabled: false }
+}
+```
+
+Correct profile path usage:
+
+```txt
+userDataDir:       /Users/alex/ChromeAutomation/UserData
+profileDirectory: Default
+```
+
+Incorrect:
+
+```txt
+userDataDir: /Users/alex/ChromeAutomation/UserData/Default
+```
+
+## Explicit remote-debugging mode
+
+Use this when you know Chrome is already running and you only want to attach.
+
+```ts
+const runner = new ActorRunner({
+  config: {
+    browser: {
+      mode: 'remote-debugging',
+      browserURL: 'http://127.0.0.1:9222',
+      reuseExistingPage: false
+    }
+  }
+});
+```
+
+In connect mode, `reuseExistingPage` defaults to `false`, so each actor run opens a fresh tab in the connected Chrome instance.
+
+## Enabling Chrome's debug endpoint
+
+Start Chrome with a local remote-debugging endpoint and a persistent automation profile. Keep the endpoint bound to `127.0.0.1` unless you have a secured tunneling setup.
+
+### macOS
+
+```bash
+mkdir -p "$HOME/.chrome-automation/user-data"
+
+/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
+  --remote-debugging-address=127.0.0.1 \
+  --remote-debugging-port=9222 \
+  --user-data-dir="$HOME/.chrome-automation/user-data" \
+  --profile-directory="Default" \
+  --no-first-run \
+  --no-default-browser-check
+```
+
+### Linux
+
+```bash
+mkdir -p "$HOME/.chrome-automation/user-data"
+
+google-chrome \
+  --remote-debugging-address=127.0.0.1 \
+  --remote-debugging-port=9222 \
+  --user-data-dir="$HOME/.chrome-automation/user-data" \
+  --profile-directory="Default" \
+  --no-first-run \
+  --no-default-browser-check
+```
+
+### Windows PowerShell
+
+```powershell
+New-Item -ItemType Directory -Force "$env:USERPROFILE\.chrome-automation\user-data"
+
+& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
+  --remote-debugging-address=127.0.0.1 `
+  --remote-debugging-port=9222 `
+  --user-data-dir="$env:USERPROFILE\.chrome-automation\user-data" `
+  --profile-directory="Default" `
+  --no-first-run `
+  --no-default-browser-check
+```
+
+Verify the endpoint:
+
+```bash
+curl http://127.0.0.1:9222/json/version
+```
+
+You should see JSON containing a `webSocketDebuggerUrl`.
+
+## CLI examples
+
+Build first:
+
+```bash
+npm run build
+```
+
+Pass a profile and let the framework launch or connect automatically:
+
+```bash
+CHROME_USER_DATA_DIR="$HOME/.chrome-automation/user-data" \
+CHROME_PROFILE_DIRECTORY="Default" \
+CHROME_REMOTE_DEBUGGING_PORT="9222" \
+node dist/cli/run.js example scrapeDashboard '{"limit": 10}'
+```
+
+Attach directly to an already-running Chrome:
+
+```bash
+CHROME_REMOTE_DEBUGGING_URL="http://127.0.0.1:9222" \
+node dist/cli/run.js example scrapeDashboard '{"limit": 10}'
+```
+
+Run multiple actors simultaneously against the same Chrome host:
+
+```bash
+CHROME_USER_DATA_DIR="$HOME/.chrome-automation/user-data" \
+CHROME_PROFILE_DIRECTORY="Default" \
+node dist/cli/run.js example scrapeDashboard '{"limit": 10}' &
+
+CHROME_USER_DATA_DIR="$HOME/.chrome-automation/user-data" \
+CHROME_PROFILE_DIRECTORY="Default" \
+node dist/cli/run.js example scrapeDashboard '{"limit": 20}' &
+
+wait
+```
+
+Each connected actor opens its own page and disconnects its Puppeteer client on completion without closing Chrome.
+
+
+## Human-like typing
+
+Text entry is key-by-key by default. The framework targets approximately 65 WPM using the standard typing-speed convention of five characters per word, so the default average inter-key interval is about 185 ms. A small symmetric jitter is applied per keystroke so typing is not perfectly mechanical.
+
+You can tune typing globally through `RuntimeConfig.interaction.typing`:
+
+```ts
+const runner = new ActorRunner({
+  config: {
+    browser: {
+      mode: 'existing-profile',
+      userDataDir: '/Users/alex/ChromeAutomation/UserData',
+      profileDirectory: 'Default'
+    },
+    interaction: {
+      typing: {
+        targetWordsPerMinute: 65,
+        intervalJitterMs: 18,
+        minimumIntervalMs: 20
+      }
+    }
+  }
+});
+```
+
+You can also tune a specific form field or actor task:
+
+```ts
+await context.forms.fillText('#search', 'quarterly report', {
+  typing: {
+    targetWordsPerMinute: 65,
+    intervalJitterMs: 12
+  }
+});
+```
+
+To disable human typing for a field and send the whole value through Puppeteer's bulk keyboard input:
+
+```ts
+await context.forms.fillText('#fast-field', 'value', {
+  typing: { enabled: false }
+});
+```
+
+## Login field clearing
+
+The standardized login flow now clears username and password fields by selecting the existing contents, pressing `Backspace`, and then typing the new value. This is enabled by default.
+
+```ts
+auth: defineLoginFlow({
+  loginUrl: 'https://example.com/login',
+  credentials: { id: 'my-site' },
+  selectors: {
+    username: '#email',
+    password: '#password',
+    submit: 'button[type="submit"]',
+    loggedInSignal: '[data-testid="account-menu"]'
+  },
+  behavior: {
+    clearFieldBeforeTyping: true,
+    typing: {
+      targetWordsPerMinute: 65,
+      intervalJitterMs: 18
+    }
+  }
+})
+```
+
+Set `clearFieldBeforeTyping: false` only for unusual sites where clearing fields breaks the login widget.
+
+## Multi-step login forms
+
+Some sites do not show the password field until after the username step. For those cases, keep `selectors.loggedInSignal` and define an ordered `steps` array. The simple `selectors.username/password/submit` fields become optional because the steps provide each field and button.
+
+```ts
+auth: defineLoginFlow({
+  loginUrl: 'https://example.com/login',
+  credentials: {
+    id: 'staged-site',
+    usernameEnv: 'STAGED_SITE_USERNAME',
+    passwordEnv: 'STAGED_SITE_PASSWORD'
+  },
+  selectors: {
+    loggedInSignal: '[data-testid="account-menu"]',
+    errorMessage: '[data-testid="login-error"]'
+  },
+  behavior: {
+    clearFieldBeforeTyping: true,
+    errorTimeoutMs: 750,
+    typing: {
+      targetWordsPerMinute: 65,
+      intervalJitterMs: 18
+    }
+  },
+  steps: [
+    {
+      type: 'fill',
+      name: 'username',
+      selector: '#username',
+      credential: 'username'
+    },
+    {
+      type: 'click',
+      name: 'continue to password',
+      selector: 'button[type="submit"]',
+      waitForSelector: '#password',
+      waitForSelectorTimeoutMs: 10_000
+    },
+    {
+      type: 'fill',
+      name: 'password',
+      selector: '#password',
+      credential: 'password'
+    },
+    {
+      type: 'click',
+      name: 'submit password',
+      selector: 'button[type="submit"]',
+      submit: true,
+      waitForNavigation: true,
+      navigationOptions: { waitUntil: 'domcontentloaded' }
+    }
+  ]
+})
+```
+
+The `click` step can wait for the next stage with `waitForSelector`. If `selectors.errorMessage` is configured, the framework checks for that error after click/wait steps, so an invalid username can fail cleanly before the password field ever appears.
+
+Each fill step can override the global login behavior:
+
+```ts
+steps: [
+  {
+    type: 'fill',
+    selector: '#username',
+    credential: 'username',
+    clearFieldBeforeTyping: true
+  },
+  {
+    type: 'fill',
+    selector: '#password',
+    credential: 'password',
+    clearFieldBeforeTyping: false,
+    typing: { targetWordsPerMinute: 72, intervalJitterMs: 10 }
+  }
+]
+```
+
+The `submit: true` flag marks the final button step, so existing `beforeSubmit` and `afterSubmit` hooks still run around that click. For unusual login screens, a step can also provide `before` and `after` hooks, or you can insert a custom hook step:
+
+```ts
+steps: [
+  { type: 'fill', selector: '#email', credential: 'username' },
+  { type: 'click', selector: '#continue', waitForSelector: '#password' },
+  {
+    type: 'hook',
+    name: 'accept optional prompt',
+    run: async context => {
+      if (await context.page.exists('#remember-device', { timeout: 500 })) {
+        await context.cursor.click('#remember-device');
+      }
+    }
+  },
+  { type: 'fill', selector: '#password', credential: 'password' },
+  { type: 'click', selector: '#sign-in', submit: true }
+]
+```
+
+## Creating a site actor
+
+```ts
+import { defineActor, defineLoginFlow } from 'puppeteer-actor-framework';
+
+export const mySiteActor = defineActor({
+  id: 'my-site',
+  baseUrl: 'https://example.com',
+  auth: defineLoginFlow({
+    loginUrl: 'https://example.com/login',
+    credentials: {
+      id: 'my-site',
+      usernameEnv: 'MY_SITE_USERNAME',
+      passwordEnv: 'MY_SITE_PASSWORD'
+    },
+    selectors: {
+      username: '#email',
+      password: '#password',
+      submit: 'button[type="submit"]',
+      loggedInSignal: '[data-testid="account-menu"]'
+    }
+  }),
+  tasks: {
+    scrapeDashboard: async context => {
+      await context.nav.goto('/dashboard');
+      return context.extract.textList('[data-testid="dashboard-row"]');
+    }
+  }
+});
+```
+
+## Important operational notes
+
+Chrome can lock a profile while it is already open. This framework responds by connecting to the local debug endpoint when `runningInstance.enabled` is true.
+
+Recent Chrome versions require a non-standard `--user-data-dir` when using remote debugging. The recommended setup is a dedicated persistent automation profile, such as:
+
+```txt
+~/.chrome-automation/user-data
+```
+
+Log into the required sites once in that Chrome window, then reuse the profile for automation.
+
+Do not expose the remote debugging port publicly. Bind it to `127.0.0.1` unless you have a separately secured tunnel. Use this for legitimate automation and scraping you are authorized to perform; this project does not include CAPTCHA bypassing, stealth evasion, credential harvesting, or anti-bot circumvention logic.

package/ai-gen.config.ts

@@ -0,0 +1,67 @@
+export const config = {
+    "repoRoot": ".",
+    "generationsDir": ".ai/generators",
+    "workflowsDir": ".ai/workflows",
+    "model": "gpt-5.3-codex",
+    "maxToolRounds": 100,
+    "maxContextFileSizeBytes": 60000,
+    "defaultMaxOutputFiles": 10,
+    "ignore": [
+        ".git",
+        "node_modules",
+        "dist",
+        "build",
+        ".next",
+        ".turbo",
+        ".cache",
+        "coverage",
+        ".idea",
+        ".vscode",
+        ".langgraph_api",
+        ".langgraph_checkpoint",
+        ".easigen",
+        "dist",
+
+        "package-lock.json",
+    ],
+    "offLimits": [
+        ".env",
+        ".env.*",
+        "*.pem",
+        "*.key",
+        "*.crt",
+        "*.p12",
+        "*.pfx",
+        ".easigen",
+        "dist",
+        ".git",
+
+        "node_modules",
+        "dist",
+        "build",
+        ".next",
+        ".turbo",
+        ".cache",
+        "coverage",
+        ".idea",
+        ".vscode",
+        ".langgraph_api",
+        ".langgraph_checkpoint",
+        ".easigen",
+        "dist",
+
+        "package-lock.json",
+    ],
+    "defaultContext": [],
+    "defaultKeywordContexts": [],
+    "openai": {
+        "timeoutMs": 120000,
+        "reconnectPollTimeoutMs": 30000,
+        "reconnectPollIntervalMs": 2000
+    },
+    "logging": {
+        "level": "info",
+        "pretty": true
+    }
+};
+export default config;

package/dist/auth/AuthStateDetector.d.ts

@@ -0,0 +1,6 @@
+import type { ActorContext } from '../core/ActorContext.js';
+import type { LoginFlowDefinition } from './LoginFlow.types.js';
+export declare class AuthStateDetector {
+    isLoggedIn(context: ActorContext, definition: LoginFlowDefinition): Promise<boolean>;
+}
+//# sourceMappingURL=AuthStateDetector.d.ts.map

package/dist/auth/AuthStateDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthStateDetector.d.ts","sourceRoot":"","sources":["../../src/auth/AuthStateDetector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEhE,qBAAa,iBAAiB;IACtB,UAAU,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;CAa3F"}

package/dist/auth/AuthStateDetector.js

@@ -0,0 +1,14 @@
+export class AuthStateDetector {
+    async isLoggedIn(context, definition) {
+        if (definition.behavior?.authCheckUrl !== undefined) {
+            await context.nav.goto(definition.behavior.authCheckUrl);
+        }
+        if (definition.hooks?.verifyLoggedIn !== undefined) {
+            return Boolean(await definition.hooks.verifyLoggedIn(context));
+        }
+        return context.page.exists(definition.selectors.loggedInSignal, {
+            timeout: definition.behavior?.loggedInTimeoutMs ?? 2_000
+        });
+    }
+}
+//# sourceMappingURL=AuthStateDetector.js.map

package/dist/auth/AuthStateDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthStateDetector.js","sourceRoot":"","sources":["../../src/auth/AuthStateDetector.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,UAAU,CAAC,OAAqB,EAAE,UAA+B;QACrE,IAAI,UAAU,CAAC,QAAQ,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;YACpD,MAAM,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,UAAU,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,EAAE,CAAC;YACnD,OAAO,OAAO,CAAC,MAAM,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,cAAc,EAAE;YAC9D,OAAO,EAAE,UAAU,CAAC,QAAQ,EAAE,iBAAiB,IAAI,KAAK;SACzD,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/auth/CredentialsProvider.d.ts

@@ -0,0 +1,22 @@
+export interface Credentials {
+    username: string;
+    password: string;
+    accountId?: string;
+}
+export interface CredentialRef {
+    id: string;
+    usernameEnv?: string;
+    passwordEnv?: string;
+}
+export interface CredentialsProvider {
+    getCredentials(ref: CredentialRef): Promise<Credentials>;
+}
+export declare class EnvCredentialsProvider implements CredentialsProvider {
+    getCredentials(ref: CredentialRef): Promise<Credentials>;
+}
+export declare class StaticCredentialsProvider implements CredentialsProvider {
+    private readonly credentials;
+    constructor(credentials: Record<string, Credentials>);
+    getCredentials(ref: CredentialRef): Promise<Credentials>;
+}
+//# sourceMappingURL=CredentialsProvider.d.ts.map

package/dist/auth/CredentialsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialsProvider.d.ts","sourceRoot":"","sources":["../../src/auth/CredentialsProvider.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1D;AAED,qBAAa,sBAAuB,YAAW,mBAAmB;IAC1D,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;CAgB/D;AAED,qBAAa,yBAA0B,YAAW,mBAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAE/D,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;CAO/D"}

package/dist/auth/CredentialsProvider.js

@@ -0,0 +1,30 @@
+import { AuthError } from '../errors/AuthError.js';
+export class EnvCredentialsProvider {
+    async getCredentials(ref) {
+        const usernameKey = ref.usernameEnv ?? `${ref.id.toUpperCase()}_USERNAME`;
+        const passwordKey = ref.passwordEnv ?? `${ref.id.toUpperCase()}_PASSWORD`;
+        const username = process.env[usernameKey];
+        const password = process.env[passwordKey];
+        if (username === undefined || username.length === 0) {
+            throw new AuthError(`Missing username environment variable: ${usernameKey}`);
+        }
+        if (password === undefined || password.length === 0) {
+            throw new AuthError(`Missing password environment variable: ${passwordKey}`);
+        }
+        return { username, password, accountId: ref.id };
+    }
+}
+export class StaticCredentialsProvider {
+    credentials;
+    constructor(credentials) {
+        this.credentials = credentials;
+    }
+    async getCredentials(ref) {
+        const credential = this.credentials[ref.id];
+        if (credential === undefined) {
+            throw new AuthError(`No static credentials registered for credential id: ${ref.id}`);
+        }
+        return credential;
+    }
+}
+//# sourceMappingURL=CredentialsProvider.js.map

package/dist/auth/CredentialsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CredentialsProvider.js","sourceRoot":"","sources":["../../src/auth/CredentialsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAkBnD,MAAM,OAAO,sBAAsB;IACjC,KAAK,CAAC,cAAc,CAAC,GAAkB;QACrC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;QAC1E,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;QAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAE1C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,0CAA0C,WAAW,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,0CAA0C,WAAW,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC;IACnD,CAAC;CACF;AAED,MAAM,OAAO,yBAAyB;IACP;IAA7B,YAA6B,WAAwC;QAAxC,gBAAW,GAAX,WAAW,CAA6B;IAAG,CAAC;IAEzE,KAAK,CAAC,cAAc,CAAC,GAAkB;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,SAAS,CAAC,uDAAuD,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;CACF"}

package/dist/auth/LoginFlow.d.ts

@@ -0,0 +1,27 @@
+import type { ActorContext } from '../core/ActorContext.js';
+import type { CredentialsProvider } from './CredentialsProvider.js';
+import { AuthStateDetector } from './AuthStateDetector.js';
+import { type LoginFlowDefinition } from './LoginFlow.types.js';
+export declare class LoginFlow {
+    private readonly credentialsProvider;
+    private readonly detector;
+    constructor(credentialsProvider: CredentialsProvider, detector?: AuthStateDetector);
+    ensureAuthenticated(context: ActorContext, definition: LoginFlowDefinition): Promise<void>;
+    login(context: ActorContext, definition: LoginFlowDefinition): Promise<void>;
+    private resolveSteps;
+    private executeSteps;
+    private executeFillStep;
+    private executeClickStep;
+    private executeWaitForSelectorStep;
+    private waitForNextStageSelector;
+    private waitForRequiredSelector;
+    private buildFillOptions;
+    private mergeStepTyping;
+    private resolveFillValue;
+    private isCredentialFillStep;
+    private clickOptions;
+    private shouldCheckForStepError;
+    private throwIfConfiguredErrorIsVisible;
+    private stepLabel;
+}
+//# sourceMappingURL=LoginFlow.d.ts.map

package/dist/auth/LoginFlow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoginFlow.d.ts","sourceRoot":"","sources":["../../src/auth/LoginFlow.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,KAAK,EAAe,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAKL,KAAK,mBAAmB,EAGzB,MAAM,sBAAsB,CAAC;AAE9B,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,mBAAmB,EAAE,mBAAmB,EACxC,QAAQ,oBAA0B;IAG/C,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1F,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0ClF,OAAO,CAAC,YAAY;YAyCN,YAAY;YAiCZ,eAAe;YAkBf,gBAAgB;YAoChB,0BAA0B;YAa1B,wBAAwB;YAexB,uBAAuB;IAkBrC,OAAO,CAAC,gBAAgB;IAsBxB,OAAO,CAAC,eAAe;YAQT,gBAAgB;IAgB9B,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,uBAAuB;YAIjB,+BAA+B;IAkB7C,OAAO,CAAC,SAAS;CAGlB"}