@epsilon-asi/actors 0.0.1

package/dist/cli/run.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+import { ActorRegistry } from '../core/ActorRegistry.js';
+import { ActorRunner } from '../core/ActorRunner.js';
+import { exampleActor } from '../sites/example/example.actor.js';
+async function main() {
+    const [actorId, taskName, inputJson] = process.argv.slice(2);
+    if (actorId === undefined || taskName === undefined) {
+        console.error('Usage: paf <actorId> <taskName> [jsonInput]');
+        process.exitCode = 1;
+        return;
+    }
+    const config = readRuntimeConfigFromEnv();
+    const registry = new ActorRegistry().register(exampleActor);
+    const runner = new ActorRunner({ config, registry });
+    const input = inputJson === undefined ? undefined : JSON.parse(inputJson);
+    const result = await runner.runRegistered(actorId, taskName, input);
+    console.log(JSON.stringify(result, null, 2));
+}
+function readRuntimeConfigFromEnv() {
+    const userDataDir = process.env.CHROME_USER_DATA_DIR;
+    const profileDirectory = process.env.CHROME_PROFILE_DIRECTORY;
+    const browserURL = process.env.CHROME_REMOTE_DEBUGGING_URL;
+    const browserWSEndpoint = process.env.CHROME_WS_ENDPOINT ?? process.env.CHROME_BROWSER_WS_ENDPOINT ?? process.env.CHROME_REMOTE_DEBUGGING_WS_ENDPOINT;
+    const connectToDefaultEndpoint = process.env.CHROME_CONNECT === '1' || process.env.CHROME_CONNECT === 'true';
+    const remoteDebuggingHost = process.env.CHROME_REMOTE_DEBUGGING_HOST;
+    const remoteDebuggingPort = parseOptionalInteger(process.env.CHROME_REMOTE_DEBUGGING_PORT);
+    const reuseExistingPage = parseOptionalBoolean(process.env.CHROME_REUSE_EXISTING_PAGE);
+    if (userDataDir !== undefined && userDataDir.length > 0) {
+        const browser = {
+            mode: 'existing-profile',
+            userDataDir,
+            channel: 'chrome',
+            headless: false
+        };
+        if (profileDirectory !== undefined && profileDirectory.length > 0)
+            browser.profileDirectory = profileDirectory;
+        const runningInstance = buildRunningInstanceConfig({
+            enabled: parseOptionalBoolean(process.env.CHROME_CONNECT_TO_RUNNING_PROFILE),
+            browserURL,
+            browserWSEndpoint,
+            remoteDebuggingHost,
+            remoteDebuggingPort,
+            reuseExistingPage
+        });
+        if (runningInstance !== undefined)
+            browser.runningInstance = runningInstance;
+        return { browser };
+    }
+    if (connectToDefaultEndpoint || (browserURL !== undefined && browserURL.length > 0) || (browserWSEndpoint !== undefined && browserWSEndpoint.length > 0)) {
+        const browser = { mode: 'remote-debugging' };
+        if (browserURL !== undefined && browserURL.length > 0)
+            browser.browserURL = browserURL;
+        if (browserWSEndpoint !== undefined && browserWSEndpoint.length > 0)
+            browser.browserWSEndpoint = browserWSEndpoint;
+        if (remoteDebuggingHost !== undefined && remoteDebuggingHost.length > 0)
+            browser.remoteDebuggingHost = remoteDebuggingHost;
+        if (remoteDebuggingPort !== undefined)
+            browser.remoteDebuggingPort = remoteDebuggingPort;
+        if (reuseExistingPage !== undefined)
+            browser.reuseExistingPage = reuseExistingPage;
+        return { browser };
+    }
+    throw new Error('Set CHROME_USER_DATA_DIR to launch/connect to a Chrome profile, or set CHROME_REMOTE_DEBUGGING_URL/CHROME_CONNECT to connect to an already-running Chrome.');
+}
+function parseOptionalInteger(value) {
+    if (value === undefined || value.length === 0)
+        return undefined;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed)) {
+        throw new Error(`Expected an integer for CHROME_REMOTE_DEBUGGING_PORT, got: ${value}`);
+    }
+    return parsed;
+}
+function buildRunningInstanceConfig(input) {
+    const config = {};
+    if (input.enabled !== undefined)
+        config.enabled = input.enabled;
+    if (input.browserURL !== undefined && input.browserURL.length > 0)
+        config.browserURL = input.browserURL;
+    if (input.browserWSEndpoint !== undefined && input.browserWSEndpoint.length > 0)
+        config.browserWSEndpoint = input.browserWSEndpoint;
+    if (input.remoteDebuggingHost !== undefined && input.remoteDebuggingHost.length > 0)
+        config.remoteDebuggingHost = input.remoteDebuggingHost;
+    if (input.remoteDebuggingPort !== undefined)
+        config.remoteDebuggingPort = input.remoteDebuggingPort;
+    if (input.reuseExistingPage !== undefined)
+        config.reuseExistingPage = input.reuseExistingPage;
+    return Object.keys(config).length === 0 ? undefined : config;
+}
+function parseOptionalBoolean(value) {
+    if (value === undefined || value.length === 0)
+        return undefined;
+    if (value === '1' || value.toLowerCase() === 'true')
+        return true;
+    if (value === '0' || value.toLowerCase() === 'false')
+        return false;
+    throw new Error(`Expected a boolean-like value for environment variable, got: ${value}`);
+}
+main().catch(error => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"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"}

package/dist/core/Actor.d.ts

@@ -0,0 +1,54 @@
+import type { WaitForOptions } from 'puppeteer-core';
+import type { LoginFlowDefinition } from '../auth/LoginFlow.types.js';
+import type { ClearFieldStrategy } from '../interaction/FieldClearer.js';
+import type { HumanTypingOptions } from '../interaction/HumanTyping.js';
+import type { ActorContext } from './ActorContext.js';
+export type ActorTask<TInput = any, TOutput = unknown> = (context: ActorContext, input: TInput) => Promise<TOutput> | TOutput;
+export type ActorTaskMap = Record<string, ActorTask<any, any>>;
+export interface ActorHooks {
+    beforeRun?: (context: ActorContext, taskName: string, input: unknown) => Promise<void> | void;
+    afterRun?: (context: ActorContext, taskName: string, output: unknown) => Promise<void> | void;
+    onError?: (context: ActorContext, taskName: string, error: unknown) => Promise<void> | void;
+}
+export interface Actor<TTasks extends ActorTaskMap = ActorTaskMap> {
+    id: string;
+    baseUrl: string;
+    auth?: LoginFlowDefinition;
+    tasks: TTasks;
+    hooks?: ActorHooks;
+}
+export type FormTaskValue = string | number | boolean;
+export type FormTaskValueResolver<TInput> = (input: TInput, context: ActorContext) => Promise<FormTaskValue | null | undefined> | FormTaskValue | null | undefined;
+export interface FormTaskFieldDefinition<TInput extends Record<string, unknown>> {
+    selector: string;
+    inputKey?: keyof TInput & string;
+    value?: FormTaskValue | FormTaskValueResolver<TInput>;
+    required?: boolean;
+    timeoutMs?: number;
+    clickBeforeTyping?: boolean;
+    clearFieldBeforeTyping?: boolean;
+    clearMethod?: ClearFieldStrategy;
+    typing?: HumanTypingOptions;
+}
+export interface FormTaskSubmitDefinition {
+    selector: string;
+    timeoutMs?: number;
+    waitForNavigation?: boolean;
+    navigationOptions?: WaitForOptions;
+}
+export interface FormTaskHooks<TInput extends Record<string, unknown>> {
+    beforeFill?: (context: ActorContext, input: TInput) => Promise<void> | void;
+    afterField?: (context: ActorContext, field: FormTaskFieldDefinition<TInput>, input: TInput, value: string) => Promise<void> | void;
+    beforeSubmit?: (context: ActorContext, input: TInput) => Promise<void> | void;
+    afterSubmit?: (context: ActorContext, input: TInput) => Promise<void> | void;
+}
+export interface FormTaskDefinition<TInput extends Record<string, unknown>, TOutput = void> {
+    url?: string;
+    fields: FormTaskFieldDefinition<TInput>[];
+    submit: FormTaskSubmitDefinition;
+    hooks?: FormTaskHooks<TInput>;
+    onComplete?: (context: ActorContext, input: TInput) => Promise<TOutput> | TOutput;
+}
+export declare function defineFormTask<TInput extends Record<string, unknown>, TOutput = void>(definition: FormTaskDefinition<TInput, TOutput>): ActorTask<TInput, TOutput>;
+export declare function defineFormFillerTask<TInput extends Record<string, unknown>, TOutput = void>(definition: FormTaskDefinition<TInput, TOutput>): ActorTask<TInput, TOutput>;
+//# sourceMappingURL=Actor.d.ts.map

package/dist/core/Actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Actor.d.ts","sourceRoot":"","sources":["../../src/core/Actor.ts"],"names":[],"mappings":"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"}

package/dist/core/Actor.js

@@ -0,0 +1,68 @@
+import { ConfigError as RuntimeConfigError } from '../errors/ConfigError.js';
+export function defineFormTask(definition) {
+    return async (context, input) => {
+        if (definition.url !== undefined) {
+            await context.nav.goto(definition.url);
+        }
+        await definition.hooks?.beforeFill?.(context, input);
+        for (const field of definition.fields) {
+            const resolved = await resolveFormTaskValue(field, input, context);
+            if (resolved === null || resolved === undefined) {
+                if (field.required ?? true) {
+                    throw new RuntimeConfigError(`Form task field ${field.selector} is missing a value.`);
+                }
+                continue;
+            }
+            const fillOptions = {
+                required: field.required ?? true
+            };
+            if (field.timeoutMs !== undefined)
+                fillOptions.timeoutMs = field.timeoutMs;
+            if (field.clickBeforeTyping !== undefined)
+                fillOptions.clickBeforeTyping = field.clickBeforeTyping;
+            if (field.clearFieldBeforeTyping !== undefined)
+                fillOptions.clear = field.clearFieldBeforeTyping;
+            if (field.clearMethod !== undefined)
+                fillOptions.clearMethod = field.clearMethod;
+            if (field.typing !== undefined)
+                fillOptions.typing = field.typing;
+            const textValue = String(resolved);
+            await context.forms.fillText(field.selector, textValue, fillOptions);
+            await definition.hooks?.afterField?.(context, field, input, textValue);
+        }
+        await definition.hooks?.beforeSubmit?.(context, input);
+        const clickOptions = definition.submit.timeoutMs === undefined
+            ? undefined
+            : { timeoutMs: definition.submit.timeoutMs };
+        if (definition.submit.waitForNavigation) {
+            await Promise.all([
+                context.page.waitForNavigation(definition.submit.navigationOptions ?? { waitUntil: 'domcontentloaded' }),
+                context.cursor.click(definition.submit.selector, clickOptions)
+            ]);
+        }
+        else {
+            await context.cursor.click(definition.submit.selector, clickOptions);
+        }
+        await definition.hooks?.afterSubmit?.(context, input);
+        if (definition.onComplete !== undefined) {
+            return definition.onComplete(context, input);
+        }
+        return undefined;
+    };
+}
+export function defineFormFillerTask(definition) {
+    return defineFormTask(definition);
+}
+async function resolveFormTaskValue(field, input, context) {
+    if (field.value !== undefined) {
+        if (typeof field.value === 'function') {
+            return field.value(input, context);
+        }
+        return field.value;
+    }
+    if (field.inputKey === undefined) {
+        throw new RuntimeConfigError(`Form task field ${field.selector} requires either an inputKey or a value resolver.`);
+    }
+    return input[field.inputKey];
+}
+//# sourceMappingURL=Actor.js.map

package/dist/core/Actor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Actor.js","sourceRoot":"","sources":["../../src/core/Actor.ts"],"names":[],"mappings":"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"}

package/dist/core/ActorContext.d.ts

@@ -0,0 +1,32 @@
+import type { BrowserSession } from '../browser/BrowserSession.js';
+import type { RuntimeConfig } from '../browser/RuntimeConfig.js';
+import type { LoginFlowDefinition } from '../auth/LoginFlow.types.js';
+import type { Extractor } from '../extraction/Extractor.js';
+import type { Pagination } from '../extraction/Pagination.js';
+import type { FormFiller } from '../interaction/Forms.js';
+import type { HumanInteractor } from '../interaction/HumanInteractor.js';
+import type { Navigator } from '../interaction/Navigation.js';
+import type { PageAdapter } from '../interaction/PageAdapter.js';
+import type { Logger } from '../logging/Logger.js';
+export interface ActorMetadata {
+    id: string;
+    baseUrl: string;
+}
+export interface AuthController {
+    isLoggedIn(definition?: LoginFlowDefinition): Promise<boolean>;
+    ensureAuthenticated(definition?: LoginFlowDefinition): Promise<void>;
+}
+export interface ActorContext {
+    actor: ActorMetadata;
+    config: RuntimeConfig;
+    session: BrowserSession;
+    page: PageAdapter;
+    cursor: HumanInteractor;
+    forms: FormFiller;
+    nav: Navigator;
+    extract: Extractor;
+    pagination: Pagination;
+    auth: AuthController;
+    logger: Logger;
+}
+//# sourceMappingURL=ActorContext.d.ts.map

package/dist/core/ActorContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorContext.d.ts","sourceRoot":"","sources":["../../src/core/ActorContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,mBAAmB,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,SAAS,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/core/ActorContext.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ActorContext.js.map

package/dist/core/ActorContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorContext.js","sourceRoot":"","sources":["../../src/core/ActorContext.ts"],"names":[],"mappings":""}

package/dist/core/ActorRegistry.d.ts

@@ -0,0 +1,8 @@
+import type { Actor, ActorTaskMap } from './Actor.js';
+export declare class ActorRegistry {
+    private readonly actors;
+    register<TTasks extends ActorTaskMap>(actor: Actor<TTasks>): this;
+    get(actorId: string): Actor;
+    list(): Actor[];
+}
+//# sourceMappingURL=ActorRegistry.d.ts.map

package/dist/core/ActorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ActorRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IAEnD,QAAQ,CAAC,MAAM,SAAS,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI;IAQjE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAQ3B,IAAI,IAAI,KAAK,EAAE;CAGhB"}

package/dist/core/ActorRegistry.js

@@ -0,0 +1,22 @@
+import { ConfigError } from '../errors/ConfigError.js';
+export class ActorRegistry {
+    actors = new Map();
+    register(actor) {
+        if (this.actors.has(actor.id)) {
+            throw new ConfigError(`Actor already registered: ${actor.id}`);
+        }
+        this.actors.set(actor.id, actor);
+        return this;
+    }
+    get(actorId) {
+        const actor = this.actors.get(actorId);
+        if (actor === undefined) {
+            throw new ConfigError(`No actor registered with id: ${actorId}`);
+        }
+        return actor;
+    }
+    list() {
+        return [...this.actors.values()];
+    }
+}
+//# sourceMappingURL=ActorRegistry.js.map

package/dist/core/ActorRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorRegistry.js","sourceRoot":"","sources":["../../src/core/ActorRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,OAAO,aAAa;IACP,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEnD,QAAQ,CAA8B,KAAoB;QACxD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,WAAW,CAAC,6BAA6B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAc,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,OAAe;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,WAAW,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/core/ActorRunner.d.ts

@@ -0,0 +1,57 @@
+import { type CredentialsProvider } from '../auth/CredentialsProvider.js';
+import { AuthStateDetector } from '../auth/AuthStateDetector.js';
+import { LoginFlow } from '../auth/LoginFlow.js';
+import { BrowserFactory } from '../browser/BrowserFactory.js';
+import type { BrowserSession } from '../browser/BrowserSession.js';
+import type { PageLike } from '../browser/PuppeteerLike.js';
+import type { RuntimeConfig } from '../browser/RuntimeConfig.js';
+import type { HumanInteractor } from '../interaction/HumanInteractor.js';
+import { type PageAdapter } from '../interaction/PageAdapter.js';
+import type { Logger } from '../logging/Logger.js';
+import type { Actor, ActorTaskMap } from './Actor.js';
+import type { ActorContext } from './ActorContext.js';
+import type { ActorRegistry } from './ActorRegistry.js';
+export interface ActorRunnerOptions {
+    config: RuntimeConfig;
+    browserFactory?: BrowserFactory;
+    credentialsProvider?: CredentialsProvider;
+    logger?: Logger;
+    interactorFactory?: (page: PageLike) => HumanInteractor;
+    pageAdapterFactory?: (page: PageLike) => PageAdapter;
+    loginFlow?: LoginFlow;
+    authStateDetector?: AuthStateDetector;
+    registry?: ActorRegistry;
+}
+type TaskName<TTasks extends ActorTaskMap> = keyof TTasks & string;
+type TaskInput<TTask> = TTask extends (...args: infer TArgs) => unknown ? TArgs extends [unknown, infer TInput, ...unknown[]] ? TInput : undefined : never;
+type TaskOutput<TTask> = TTask extends (...args: unknown[]) => infer TResult ? Awaited<TResult> : never;
+type SequenceOutputs<TTasks extends ActorTaskMap, TTaskNames extends readonly TaskName<TTasks>[]> = {
+    [TIndex in keyof TTaskNames]: TTaskNames[TIndex] extends TaskName<TTasks> ? TaskOutput<TTasks[TTaskNames[TIndex]]> : never;
+};
+export declare class ActorRunner {
+    private readonly browserFactory;
+    private readonly credentialsProvider;
+    private readonly logger;
+    private readonly interactorFactory;
+    private readonly pageAdapterFactory;
+    private readonly loginFlow;
+    private readonly authStateDetector;
+    protected readonly registry: ActorRegistry | undefined;
+    protected readonly options: ActorRunnerOptions;
+    constructor(options: ActorRunnerOptions);
+    run<TTasks extends ActorTaskMap, TTaskKey extends TaskName<TTasks>>(actor: Actor<TTasks>, taskName: TTaskKey, input?: TaskInput<TTasks[TTaskKey]>): Promise<TaskOutput<TTasks[TTaskKey]>>;
+    runRegistered<TOutput = unknown, TInput = unknown>(actorId: string, taskName: string, input?: TInput): Promise<TOutput>;
+    protected createSession(): Promise<BrowserSession>;
+    protected closeSession(session: BrowserSession): Promise<void>;
+    protected executeTask<TTasks extends ActorTaskMap, TTaskKey extends TaskName<TTasks>>(actor: Actor<TTasks>, context: ActorContext, taskName: TTaskKey, input: TaskInput<TTasks[TTaskKey]> | undefined, ensureAuthentication: boolean): Promise<TaskOutput<TTasks[TTaskKey]>>;
+    protected getRegisteredActor(actorId: string): Actor;
+    protected createContext(actor: Actor, session: BrowserSession): ActorContext;
+    protected getTask<TTasks extends ActorTaskMap, TTaskKey extends TaskName<TTasks>>(actor: Actor<TTasks>, taskName: TTaskKey): TTasks[TTaskKey];
+    protected wrapError(error: unknown, actorId: string, taskName: string, url?: string): Error;
+}
+export declare class ActorSequenceRunner extends ActorRunner {
+    runSequence<TTasks extends ActorTaskMap, TTaskNames extends readonly TaskName<TTasks>[]>(actor: Actor<TTasks>, taskNames: [...TTaskNames], input?: TaskInput<TTasks[TTaskNames[number]]>): Promise<SequenceOutputs<TTasks, TTaskNames>>;
+    runRegisteredSequence<TOutput = unknown, TInput = unknown>(actorId: string, taskNames: string[], input?: TInput): Promise<TOutput[]>;
+}
+export {};
+//# sourceMappingURL=ActorRunner.d.ts.map

package/dist/core/ActorRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorRunner.d.ts","sourceRoot":"","sources":["../../src/core/ActorRunner.ts"],"names":[],"mappings":"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"}

package/dist/core/ActorRunner.js

@@ -0,0 +1,157 @@
+import { EnvCredentialsProvider } from '../auth/CredentialsProvider.js';
+import { AuthStateDetector } from '../auth/AuthStateDetector.js';
+import { LoginFlow } from '../auth/LoginFlow.js';
+import { BrowserFactory } from '../browser/BrowserFactory.js';
+import { AutomationError } from '../errors/AutomationError.js';
+import { ConfigError } from '../errors/ConfigError.js';
+import { Extractor } from '../extraction/Extractor.js';
+import { Pagination } from '../extraction/Pagination.js';
+import { FormFiller } from '../interaction/Forms.js';
+import { GhostCursorAdapter } from '../interaction/GhostCursorAdapter.js';
+import { Navigator } from '../interaction/Navigation.js';
+import { PuppeteerPageAdapter } from '../interaction/PageAdapter.js';
+import { ConsoleLogger } from '../logging/ConsoleLogger.js';
+export class ActorRunner {
+    browserFactory;
+    credentialsProvider;
+    logger;
+    interactorFactory;
+    pageAdapterFactory;
+    loginFlow;
+    authStateDetector;
+    registry;
+    options;
+    constructor(options) {
+        this.options = options;
+        this.browserFactory = options.browserFactory ?? new BrowserFactory();
+        this.credentialsProvider = options.credentialsProvider ?? new EnvCredentialsProvider();
+        this.logger = options.logger ?? new ConsoleLogger('info');
+        this.interactorFactory = options.interactorFactory ?? (page => new GhostCursorAdapter(page, options.config.interaction?.typing === undefined ? {} : { typing: options.config.interaction.typing }));
+        this.pageAdapterFactory = options.pageAdapterFactory ?? (page => new PuppeteerPageAdapter(page));
+        this.authStateDetector = options.authStateDetector ?? new AuthStateDetector();
+        this.loginFlow = options.loginFlow ?? new LoginFlow(this.credentialsProvider, this.authStateDetector);
+        this.registry = options.registry;
+    }
+    async run(actor, taskName, input) {
+        const session = await this.createSession();
+        const context = this.createContext(actor, session);
+        try {
+            return await this.executeTask(actor, context, taskName, input, true);
+        }
+        finally {
+            await this.closeSession(session);
+        }
+    }
+    async runRegistered(actorId, taskName, input) {
+        const actor = this.getRegisteredActor(actorId);
+        return this.run(actor, taskName, input);
+    }
+    async createSession() {
+        return this.browserFactory.launch(this.options.config);
+    }
+    async closeSession(session) {
+        if (session.shouldCloseOnFinish()) {
+            await session.close();
+        }
+    }
+    async executeTask(actor, context, taskName, input, ensureAuthentication) {
+        const task = this.getTask(actor, taskName);
+        try {
+            await actor.hooks?.beforeRun?.(context, taskName, input);
+            if (ensureAuthentication && actor.auth !== undefined) {
+                await context.auth.ensureAuthenticated(actor.auth);
+            }
+            const output = await task(context, input);
+            await actor.hooks?.afterRun?.(context, taskName, output);
+            return output;
+        }
+        catch (error) {
+            await actor.hooks?.onError?.(context, taskName, error);
+            throw this.wrapError(error, actor.id, taskName, context.page.url());
+        }
+    }
+    getRegisteredActor(actorId) {
+        if (this.registry === undefined) {
+            throw new ConfigError('runRegistered requires an ActorRegistry.');
+        }
+        return this.registry.get(actorId);
+    }
+    createContext(actor, session) {
+        const page = this.pageAdapterFactory(session.page);
+        const cursor = this.interactorFactory(session.page);
+        const forms = new FormFiller(page, cursor);
+        const nav = new Navigator(page, cursor, actor.baseUrl);
+        const extract = new Extractor(page);
+        const pagination = new Pagination(page, cursor);
+        let context;
+        const auth = {
+            isLoggedIn: async (definition) => {
+                const targetDefinition = definition ?? actor.auth;
+                if (targetDefinition === undefined) {
+                    return false;
+                }
+                return this.authStateDetector.isLoggedIn(context, targetDefinition);
+            },
+            ensureAuthenticated: async (definition) => {
+                const targetDefinition = definition ?? actor.auth;
+                if (targetDefinition === undefined) {
+                    return;
+                }
+                await this.loginFlow.ensureAuthenticated(context, targetDefinition);
+            }
+        };
+        context = {
+            actor: { id: actor.id, baseUrl: actor.baseUrl },
+            config: this.options.config,
+            session,
+            page,
+            cursor,
+            forms,
+            nav,
+            extract,
+            pagination,
+            auth,
+            logger: this.logger
+        };
+        return context;
+    }
+    getTask(actor, taskName) {
+        const task = actor.tasks[taskName];
+        if (task === undefined) {
+            throw new ConfigError(`Actor ${actor.id} does not define task: ${taskName}`);
+        }
+        return task;
+    }
+    wrapError(error, actorId, taskName, url) {
+        if (error instanceof AutomationError) {
+            return error;
+        }
+        const meta = url === undefined ? { actorId, taskName, cause: error } : { actorId, taskName, url, cause: error };
+        return new AutomationError(`Actor ${actorId} task ${taskName} failed.`, meta);
+    }
+}
+export class ActorSequenceRunner extends ActorRunner {
+    async runSequence(actor, taskNames, input) {
+        if (taskNames.length === 0) {
+            throw new ConfigError('runSequence requires at least one task.');
+        }
+        const session = await this.createSession();
+        const context = this.createContext(actor, session);
+        const outputs = [];
+        try {
+            for (const [index, taskName] of taskNames.entries()) {
+                const output = await this.executeTask(actor, context, taskName, input, index === 0);
+                outputs.push(output);
+            }
+            return outputs;
+        }
+        finally {
+            await this.closeSession(session);
+        }
+    }
+    async runRegisteredSequence(actorId, taskNames, input) {
+        const actor = this.getRegisteredActor(actorId);
+        return this.runSequence(actor, taskNames, input);
+    }
+}
+//# sourceMappingURL=ActorRunner.js.map

package/dist/core/ActorRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActorRunner.js","sourceRoot":"","sources":["../../src/core/ActorRunner.ts"],"names":[],"mappings":"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"}

package/dist/core/defineActor.d.ts

@@ -0,0 +1,3 @@
+import type { Actor, ActorTaskMap } from './Actor.js';
+export declare function defineActor<TTasks extends ActorTaskMap>(actor: Actor<TTasks>): Actor<TTasks>;
+//# sourceMappingURL=defineActor.d.ts.map

package/dist/core/defineActor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineActor.d.ts","sourceRoot":"","sources":["../../src/core/defineActor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEtD,wBAAgB,WAAW,CAAC,MAAM,SAAS,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAE5F"}

package/dist/core/defineActor.js

@@ -0,0 +1,4 @@
+export function defineActor(actor) {
+    return actor;
+}
+//# sourceMappingURL=defineActor.js.map

package/dist/core/defineActor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineActor.js","sourceRoot":"","sources":["../../src/core/defineActor.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAA8B,KAAoB;IAC3E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+export * from './Actor.js';
+export * from './ActorContext.js';
+export * from './ActorRegistry.js';
+export * from './ActorRunner.js';
+export * from './defineActor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+export * from './Actor.js';
+export * from './ActorContext.js';
+export * from './ActorRegistry.js';
+export * from './ActorRunner.js';
+export * from './defineActor.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/errors/AuthError.d.ts

@@ -0,0 +1,5 @@
+import { AutomationError, type AutomationErrorMeta } from './AutomationError.js';
+export declare class AuthError extends AutomationError {
+    constructor(message: string, meta?: AutomationErrorMeta);
+}
+//# sourceMappingURL=AuthError.d.ts.map

package/dist/errors/AuthError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthError.d.ts","sourceRoot":"","sources":["../../src/errors/AuthError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEjF,qBAAa,SAAU,SAAQ,eAAe;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,mBAAwB;CAG5D"}