@epsilon-asi/actors 0.0.1

package/dist/interaction/HumanInteractor.d.ts

@@ -0,0 +1,29 @@
+import type { ClearFieldStrategy } from './FieldClearer.js';
+import type { HumanTypingOptions } from './HumanTyping.js';
+export interface HumanClickOptions {
+    waitForSelector?: boolean;
+    timeoutMs?: number;
+    cursorOptions?: Record<string, unknown>;
+}
+export interface HumanMoveOptions {
+    timeoutMs?: number;
+    cursorOptions?: Record<string, unknown>;
+}
+export interface HumanTypeOptions {
+    /** Legacy Puppeteer keyboard delay. Used as key-hold delay for human typing, or bulk delay when human typing is disabled. */
+    delayMs?: number;
+    clear?: boolean;
+    /** Defaults to selecting the field contents and pressing Backspace before typing. */
+    clearMethod?: ClearFieldStrategy;
+    clickBeforeTyping?: boolean;
+    timeoutMs?: number;
+    /** Human-like key-by-key typing configuration. Enabled by default at approximately 65 WPM. */
+    typing?: HumanTypingOptions;
+}
+export interface HumanInteractor {
+    click(selector: string, options?: HumanClickOptions): Promise<void>;
+    move(selector: string, options?: HumanMoveOptions): Promise<void>;
+    type(selector: string, value: string, options?: HumanTypeOptions): Promise<void>;
+    scrollIntoView(selector: string): Promise<void>;
+}
+//# sourceMappingURL=HumanInteractor.d.ts.map

package/dist/interaction/HumanInteractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HumanInteractor.d.ts","sourceRoot":"","sources":["../../src/interaction/HumanInteractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,gBAAgB;IAC/B,6HAA6H;IAC7H,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD"}

package/dist/interaction/HumanInteractor.js

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

package/dist/interaction/HumanInteractor.js.map

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

package/dist/interaction/HumanTyping.d.ts

@@ -0,0 +1,43 @@
+import type { KeyboardLike } from '../browser/PuppeteerLike.js';
+export type SleepFunction = (ms: number) => Promise<void>;
+export type RandomFunction = () => number;
+export interface HumanTypingOptions {
+    /** Defaults to true. When false, the whole value is sent through keyboard.type. */
+    enabled?: boolean;
+    /** Target words per minute. Defaults to 65. */
+    targetWordsPerMinute?: number;
+    /** Standard typing-speed word length. Defaults to 5 characters. */
+    averageWordLength?: number;
+    /** Symmetric per-keystroke jitter around the target interval. Defaults to ±18 ms. */
+    intervalJitterMs?: number;
+    /** Minimum inter-key interval after jitter is applied. Defaults to 20 ms. */
+    minimumIntervalMs?: number;
+    /** Optional keydown-to-keyup hold delay passed to Puppeteer's keyboard.type per character. */
+    keyHoldMs?: number;
+}
+export interface NormalizedHumanTypingOptions {
+    enabled: boolean;
+    targetWordsPerMinute: number;
+    averageWordLength: number;
+    intervalJitterMs: number;
+    minimumIntervalMs: number;
+    keyHoldMs: number;
+}
+export interface HumanTyperOptions {
+    sleep?: SleepFunction;
+    random?: RandomFunction;
+    defaults?: HumanTypingOptions;
+}
+export declare const DEFAULT_HUMAN_TYPING_OPTIONS: NormalizedHumanTypingOptions;
+export declare function characterIntervalMsForWordsPerMinute(targetWordsPerMinute: number, averageWordLength?: number): number;
+export declare function normalizeHumanTypingOptions(options?: HumanTypingOptions): NormalizedHumanTypingOptions;
+export declare function mergeHumanTypingOptions(defaults: HumanTypingOptions | undefined, overrides: HumanTypingOptions | undefined): HumanTypingOptions;
+export declare function jitteredIntervalMs(baseIntervalMs: number, jitterMs: number, minimumIntervalMs: number, random: RandomFunction): number;
+export declare class HumanTyper {
+    private readonly sleep;
+    private readonly random;
+    private readonly defaults;
+    constructor(options?: HumanTyperOptions);
+    type(keyboard: KeyboardLike, text: string, options?: HumanTypingOptions, legacyDelayMs?: number): Promise<void>;
+}
+//# sourceMappingURL=HumanTyping.d.ts.map

package/dist/interaction/HumanTyping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HumanTyping.d.ts","sourceRoot":"","sources":["../../src/interaction/HumanTyping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC;AAE1C,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+CAA+C;IAC/C,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,kBAAkB,CAAC;CAC/B;AAED,eAAO,MAAM,4BAA4B,EAAE,4BAO1C,CAAC;AAEF,wBAAgB,oCAAoC,CAClD,oBAAoB,EAAE,MAAM,EAC5B,iBAAiB,SAAiD,GACjE,MAAM,CAQR;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,kBAAuB,GAAG,4BAA4B,CA2B1G;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,SAAS,EAAE,kBAAkB,GAAG,SAAS,GACxC,kBAAkB,CAKpB;AAED,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,MAAM,EAAE,cAAc,GACrB,MAAM,CAIR;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;gBAE9C,OAAO,GAAE,iBAAsB;IAMrC,IAAI,CACR,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,EAChC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;CA4BjB"}

package/dist/interaction/HumanTyping.js

@@ -0,0 +1,85 @@
+import { delay as defaultDelay } from '../utils/delay.js';
+export const DEFAULT_HUMAN_TYPING_OPTIONS = {
+    enabled: true,
+    targetWordsPerMinute: 65,
+    averageWordLength: 5,
+    intervalJitterMs: 18,
+    minimumIntervalMs: 20,
+    keyHoldMs: 0
+};
+export function characterIntervalMsForWordsPerMinute(targetWordsPerMinute, averageWordLength = DEFAULT_HUMAN_TYPING_OPTIONS.averageWordLength) {
+    if (!Number.isFinite(targetWordsPerMinute) || targetWordsPerMinute <= 0) {
+        throw new RangeError('targetWordsPerMinute must be greater than 0.');
+    }
+    if (!Number.isFinite(averageWordLength) || averageWordLength <= 0) {
+        throw new RangeError('averageWordLength must be greater than 0.');
+    }
+    return 60_000 / (targetWordsPerMinute * averageWordLength);
+}
+export function normalizeHumanTypingOptions(options = {}) {
+    const normalized = {
+        enabled: options.enabled ?? DEFAULT_HUMAN_TYPING_OPTIONS.enabled,
+        targetWordsPerMinute: options.targetWordsPerMinute ?? DEFAULT_HUMAN_TYPING_OPTIONS.targetWordsPerMinute,
+        averageWordLength: options.averageWordLength ?? DEFAULT_HUMAN_TYPING_OPTIONS.averageWordLength,
+        intervalJitterMs: options.intervalJitterMs ?? DEFAULT_HUMAN_TYPING_OPTIONS.intervalJitterMs,
+        minimumIntervalMs: options.minimumIntervalMs ?? DEFAULT_HUMAN_TYPING_OPTIONS.minimumIntervalMs,
+        keyHoldMs: options.keyHoldMs ?? DEFAULT_HUMAN_TYPING_OPTIONS.keyHoldMs
+    };
+    if (!Number.isFinite(normalized.targetWordsPerMinute) || normalized.targetWordsPerMinute <= 0) {
+        throw new RangeError('targetWordsPerMinute must be greater than 0.');
+    }
+    if (!Number.isFinite(normalized.averageWordLength) || normalized.averageWordLength <= 0) {
+        throw new RangeError('averageWordLength must be greater than 0.');
+    }
+    if (!Number.isFinite(normalized.intervalJitterMs) || normalized.intervalJitterMs < 0) {
+        throw new RangeError('intervalJitterMs must be greater than or equal to 0.');
+    }
+    if (!Number.isFinite(normalized.minimumIntervalMs) || normalized.minimumIntervalMs < 0) {
+        throw new RangeError('minimumIntervalMs must be greater than or equal to 0.');
+    }
+    if (!Number.isFinite(normalized.keyHoldMs) || normalized.keyHoldMs < 0) {
+        throw new RangeError('keyHoldMs must be greater than or equal to 0.');
+    }
+    return normalized;
+}
+export function mergeHumanTypingOptions(defaults, overrides) {
+    return {
+        ...(defaults ?? {}),
+        ...(overrides ?? {})
+    };
+}
+export function jitteredIntervalMs(baseIntervalMs, jitterMs, minimumIntervalMs, random) {
+    const normalizedRandom = Math.min(1, Math.max(0, random()));
+    const jitter = (normalizedRandom * 2 - 1) * jitterMs;
+    return Math.max(minimumIntervalMs, Math.round(baseIntervalMs + jitter));
+}
+function keyboardTypeOptions(delayMs) {
+    return delayMs > 0 ? { delay: delayMs } : undefined;
+}
+export class HumanTyper {
+    sleep;
+    random;
+    defaults;
+    constructor(options = {}) {
+        this.sleep = options.sleep ?? defaultDelay;
+        this.random = options.random ?? Math.random;
+        this.defaults = options.defaults;
+    }
+    async type(keyboard, text, options = {}, legacyDelayMs) {
+        const normalized = normalizeHumanTypingOptions(mergeHumanTypingOptions(this.defaults, options));
+        const keyHoldMs = options.keyHoldMs ?? this.defaults?.keyHoldMs ?? legacyDelayMs ?? normalized.keyHoldMs;
+        if (!normalized.enabled) {
+            await keyboard.type(text, keyboardTypeOptions(keyHoldMs));
+            return;
+        }
+        const baseIntervalMs = characterIntervalMsForWordsPerMinute(normalized.targetWordsPerMinute, normalized.averageWordLength);
+        const characters = Array.from(text);
+        for (let index = 0; index < characters.length; index += 1) {
+            if (index > 0) {
+                await this.sleep(jitteredIntervalMs(baseIntervalMs, normalized.intervalJitterMs, normalized.minimumIntervalMs, this.random));
+            }
+            await keyboard.type(characters[index], keyboardTypeOptions(keyHoldMs));
+        }
+    }
+}
+//# sourceMappingURL=HumanTyping.js.map

package/dist/interaction/HumanTyping.js.map

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

package/dist/interaction/NativePuppeteerInteractor.d.ts

@@ -0,0 +1,20 @@
+import type { PageLike } from '../browser/PuppeteerLike.js';
+import type { HumanClickOptions, HumanInteractor, HumanMoveOptions, HumanTypeOptions } from './HumanInteractor.js';
+import { HumanTyper, type HumanTypingOptions, type RandomFunction, type SleepFunction } from './HumanTyping.js';
+export interface NativePuppeteerInteractorOptions {
+    typing?: HumanTypingOptions;
+    typer?: HumanTyper;
+    sleep?: SleepFunction;
+    random?: RandomFunction;
+}
+export declare class NativePuppeteerInteractor implements HumanInteractor {
+    private readonly page;
+    private readonly typer;
+    private readonly typingDefaults;
+    constructor(page: PageLike, options?: NativePuppeteerInteractorOptions);
+    click(selector: string, options?: HumanClickOptions): Promise<void>;
+    move(selector: string, options?: HumanMoveOptions): Promise<void>;
+    type(selector: string, value: string, options?: HumanTypeOptions): Promise<void>;
+    scrollIntoView(selector: string): Promise<void>;
+}
+//# sourceMappingURL=NativePuppeteerInteractor.d.ts.map

package/dist/interaction/NativePuppeteerInteractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativePuppeteerInteractor.d.ts","sourceRoot":"","sources":["../../src/interaction/NativePuppeteerInteractor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACnH,OAAO,EAAE,UAAU,EAA2B,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEzI,MAAM,WAAW,gCAAgC;IAC/C,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAMD,qBAAa,yBAA0B,YAAW,eAAe;IAInD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiC;gBAEnC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAE,gCAAqC;IASrF,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtD"}

package/dist/interaction/NativePuppeteerInteractor.js

@@ -0,0 +1,47 @@
+import { clearField } from './FieldClearer.js';
+import { HumanTyper, mergeHumanTypingOptions } from './HumanTyping.js';
+function selectorWaitOptions(timeoutMs) {
+    return timeoutMs === undefined ? undefined : { timeout: timeoutMs };
+}
+export class NativePuppeteerInteractor {
+    page;
+    typer;
+    typingDefaults;
+    constructor(page, options = {}) {
+        this.page = page;
+        this.typingDefaults = options.typing;
+        this.typer = options.typer ?? new HumanTyper({
+            ...(options.typing !== undefined ? { defaults: options.typing } : {}),
+            ...(options.sleep !== undefined ? { sleep: options.sleep } : {}),
+            ...(options.random !== undefined ? { random: options.random } : {})
+        });
+    }
+    async click(selector, options = {}) {
+        if (options.waitForSelector !== false) {
+            await this.page.waitForSelector(selector, selectorWaitOptions(options.timeoutMs));
+        }
+        await this.page.click(selector);
+    }
+    async move(selector, options = {}) {
+        await this.page.waitForSelector(selector, selectorWaitOptions(options.timeoutMs));
+    }
+    async type(selector, value, options = {}) {
+        await this.page.waitForSelector(selector, selectorWaitOptions(options.timeoutMs));
+        if (options.clickBeforeTyping ?? true) {
+            await this.page.click(selector);
+        }
+        else {
+            await this.page.focus(selector);
+        }
+        if (options.clear ?? true) {
+            await clearField(this.page, selector, options.clearMethod === undefined ? undefined : { strategy: options.clearMethod });
+        }
+        await this.typer.type(this.page.keyboard, value, mergeHumanTypingOptions(this.typingDefaults, options.typing), options.delayMs);
+    }
+    async scrollIntoView(selector) {
+        await this.page.$eval(selector, element => {
+            element.scrollIntoView({ block: 'center', inline: 'center', behavior: 'instant' });
+        });
+    }
+}
+//# sourceMappingURL=NativePuppeteerInteractor.js.map

package/dist/interaction/NativePuppeteerInteractor.js.map

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

package/dist/interaction/Navigation.d.ts

@@ -0,0 +1,17 @@
+import type { WaitForOptions } from 'puppeteer-core';
+import type { HumanInteractor } from './HumanInteractor.js';
+import type { PageAdapter } from './PageAdapter.js';
+export interface ClickNavigationOptions {
+    waitForNavigation?: boolean;
+    navigationOptions?: WaitForOptions;
+}
+export declare class Navigator {
+    private readonly page;
+    private readonly interactor;
+    private readonly baseUrl;
+    constructor(page: PageAdapter, interactor: HumanInteractor, baseUrl: string);
+    resolve(urlOrPath: string): string;
+    goto(urlOrPath: string, options?: WaitForOptions): Promise<void>;
+    click(selector: string, options?: ClickNavigationOptions): Promise<void>;
+}
+//# sourceMappingURL=Navigation.d.ts.map

package/dist/interaction/Navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Navigation.d.ts","sourceRoot":"","sources":["../../src/interaction/Navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iBAAiB,CAAC,EAAE,cAAc,CAAC;CACpC;AAED,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,eAAe,EAC3B,OAAO,EAAE,MAAM;IAGlC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI5B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,cAAkD,GAAG,OAAO,CAAC,IAAI,CAAC;IAInG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;CAWnF"}

package/dist/interaction/Navigation.js

@@ -0,0 +1,28 @@
+import { resolveUrl } from '../utils/url.js';
+export class Navigator {
+    page;
+    interactor;
+    baseUrl;
+    constructor(page, interactor, baseUrl) {
+        this.page = page;
+        this.interactor = interactor;
+        this.baseUrl = baseUrl;
+    }
+    resolve(urlOrPath) {
+        return resolveUrl(this.baseUrl, urlOrPath);
+    }
+    async goto(urlOrPath, options = { waitUntil: 'domcontentloaded' }) {
+        await this.page.goto(this.resolve(urlOrPath), options);
+    }
+    async click(selector, options = {}) {
+        if (options.waitForNavigation) {
+            await Promise.all([
+                this.page.waitForNavigation(options.navigationOptions ?? { waitUntil: 'domcontentloaded' }),
+                this.interactor.click(selector)
+            ]);
+            return;
+        }
+        await this.interactor.click(selector);
+    }
+}
+//# sourceMappingURL=Navigation.js.map

package/dist/interaction/Navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Navigation.js","sourceRoot":"","sources":["../../src/interaction/Navigation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAO7C,MAAM,OAAO,SAAS;IAED;IACA;IACA;IAHnB,YACmB,IAAiB,EACjB,UAA2B,EAC3B,OAAe;QAFf,SAAI,GAAJ,IAAI,CAAa;QACjB,eAAU,GAAV,UAAU,CAAiB;QAC3B,YAAO,GAAP,OAAO,CAAQ;IAC/B,CAAC;IAEJ,OAAO,CAAC,SAAiB;QACvB,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB,EAAE,UAA0B,EAAE,SAAS,EAAE,kBAAkB,EAAE;QACvF,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,QAAgB,EAAE,UAAkC,EAAE;QAChE,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC9B,MAAM,OAAO,CAAC,GAAG,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,iBAAiB,IAAI,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;gBAC3F,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;aAChC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/interaction/PageAdapter.d.ts

@@ -0,0 +1,32 @@
+import type { WaitForOptions, WaitForSelectorOptions } from 'puppeteer-core';
+import type { PageLike } from '../browser/PuppeteerLike.js';
+export interface PageAdapter {
+    goto(url: string, options?: WaitForOptions): Promise<void>;
+    waitFor(selector: string, options?: WaitForSelectorOptions): Promise<void>;
+    waitForNavigation(options?: WaitForOptions): Promise<void>;
+    exists(selector: string, options?: WaitForSelectorOptions): Promise<boolean>;
+    text(selector: string): Promise<string>;
+    textAll(selector: string): Promise<string[]>;
+    attr(selector: string, name: string): Promise<string | null>;
+    html(): Promise<string>;
+    url(): string;
+    title(): Promise<string>;
+    raw(): PageLike;
+}
+export declare class PuppeteerPageAdapter implements PageAdapter {
+    private readonly page;
+    constructor(page: PageLike);
+    goto(url: string, options?: WaitForOptions): Promise<void>;
+    waitFor(selector: string, options?: WaitForSelectorOptions): Promise<void>;
+    waitForNavigation(options?: WaitForOptions): Promise<void>;
+    exists(selector: string, options?: WaitForSelectorOptions): Promise<boolean>;
+    text(selector: string): Promise<string>;
+    textAll(selector: string): Promise<string[]>;
+    attr(selector: string, name: string): Promise<string | null>;
+    html(): Promise<string>;
+    url(): string;
+    title(): Promise<string>;
+    raw(): PageLike;
+}
+export declare function normalizeWhitespace(value: string): string;
+//# sourceMappingURL=PageAdapter.d.ts.map

package/dist/interaction/PageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PageAdapter.d.ts","sourceRoot":"","sources":["../../src/interaction/PageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,iBAAiB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,GAAG,IAAI,MAAM,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACzB,GAAG,IAAI,QAAQ,CAAC;CACjB;AAED,qBAAa,oBAAqB,YAAW,WAAW;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,QAAQ;IAErC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAkD,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,iBAAiB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2C,GAAG,OAAO,CAAC,OAAO,CAAC;IAShG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IASvC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAO5C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ5D,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAI7B,GAAG,IAAI,MAAM;IAIb,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,GAAG,IAAI,QAAQ;CAGhB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/interaction/PageAdapter.js

@@ -0,0 +1,62 @@
+import { SelectorError } from '../errors/SelectorError.js';
+export class PuppeteerPageAdapter {
+    page;
+    constructor(page) {
+        this.page = page;
+    }
+    async goto(url, options = { waitUntil: 'domcontentloaded' }) {
+        await this.page.goto(url, options);
+    }
+    async waitFor(selector, options) {
+        await this.page.waitForSelector(selector, options);
+    }
+    async waitForNavigation(options) {
+        await this.page.waitForNavigation(options);
+    }
+    async exists(selector, options = { timeout: 1_000 }) {
+        try {
+            await this.page.waitForSelector(selector, options);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async text(selector) {
+        try {
+            const value = await this.page.$eval(selector, element => element.textContent ?? '');
+            return normalizeWhitespace(value);
+        }
+        catch (error) {
+            throw new SelectorError(`Could not read text from selector: ${selector}`, selector, { cause: error });
+        }
+    }
+    async textAll(selector) {
+        const values = await this.page.$$eval(selector, elements => elements.map(element => element.textContent ?? ''));
+        return values.map(normalizeWhitespace).filter(value => value.length > 0);
+    }
+    async attr(selector, name) {
+        try {
+            return await this.page.$eval(selector, (element, attrName) => element.getAttribute(String(attrName)), name);
+        }
+        catch (error) {
+            throw new SelectorError(`Could not read attribute ${name} from selector: ${selector}`, selector, { cause: error });
+        }
+    }
+    async html() {
+        return this.page.content();
+    }
+    url() {
+        return this.page.url();
+    }
+    title() {
+        return this.page.title();
+    }
+    raw() {
+        return this.page;
+    }
+}
+export function normalizeWhitespace(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=PageAdapter.js.map

package/dist/interaction/PageAdapter.js.map

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

package/dist/interaction/Waits.d.ts

@@ -0,0 +1,3 @@
+import type { PageAdapter } from './PageAdapter.js';
+export declare function waitUntilVisible(page: PageAdapter, selector: string, timeoutMs?: number): Promise<void>;
+//# sourceMappingURL=Waits.d.ts.map

package/dist/interaction/Waits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Waits.d.ts","sourceRoot":"","sources":["../../src/interaction/Waits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAE7G"}

package/dist/interaction/Waits.js

@@ -0,0 +1,4 @@
+export async function waitUntilVisible(page, selector, timeoutMs = 15_000) {
+    await page.waitFor(selector, { timeout: timeoutMs, visible: true });
+}
+//# sourceMappingURL=Waits.js.map

package/dist/interaction/Waits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Waits.js","sourceRoot":"","sources":["../../src/interaction/Waits.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAiB,EAAE,QAAgB,EAAE,SAAS,GAAG,MAAM;IAC5F,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/interaction/index.d.ts

@@ -0,0 +1,10 @@
+export * from './HumanTyping.js';
+export * from './FieldClearer.js';
+export * from './Forms.js';
+export * from './GhostCursorAdapter.js';
+export * from './HumanInteractor.js';
+export * from './NativePuppeteerInteractor.js';
+export * from './Navigation.js';
+export * from './PageAdapter.js';
+export * from './Waits.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/interaction/index.js

@@ -0,0 +1,10 @@
+export * from './HumanTyping.js';
+export * from './FieldClearer.js';
+export * from './Forms.js';
+export * from './GhostCursorAdapter.js';
+export * from './HumanInteractor.js';
+export * from './NativePuppeteerInteractor.js';
+export * from './Navigation.js';
+export * from './PageAdapter.js';
+export * from './Waits.js';
+//# sourceMappingURL=index.js.map

package/dist/interaction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interaction/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC"}

package/dist/interaction/textToKeystrokeEvents.d.ts

@@ -0,0 +1,13 @@
+type KeystrokeReplayEvent = {
+    actionType: "keystroke";
+    method: "sendCharacter";
+    input: string;
+} | {
+    actionType: "keystroke";
+    method: "press";
+    key: "Enter" | "Tab" | "Backspace";
+    input: null;
+};
+export declare function textToKeystrokeEvents(input: string): KeystrokeReplayEvent[];
+export {};
+//# sourceMappingURL=textToKeystrokeEvents.d.ts.map

package/dist/interaction/textToKeystrokeEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textToKeystrokeEvents.d.ts","sourceRoot":"","sources":["../../src/interaction/textToKeystrokeEvents.ts"],"names":[],"mappings":"AAAA,KAAK,oBAAoB,GACnB;IACF,UAAU,EAAE,WAAW,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACjB,GACK;IACF,UAAU,EAAE,WAAW,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,GAAG,KAAK,GAAG,WAAW,CAAC;IACnC,KAAK,EAAE,IAAI,CAAC;CACf,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAc3E"}

package/dist/interaction/textToKeystrokeEvents.js

@@ -0,0 +1,15 @@
+export function textToKeystrokeEvents(input) {
+    const specialKeys = {
+        "\n": { actionType: "keystroke", method: "press", key: "Enter", input: null },
+        "\t": { actionType: "keystroke", method: "press", key: "Tab", input: null },
+        "\b": { actionType: "keystroke", method: "press", key: "Backspace", input: null },
+    };
+    return Array.from(input).map((char) => {
+        return specialKeys[char] ?? {
+            actionType: "keystroke",
+            method: "sendCharacter",
+            input: char,
+        };
+    });
+}
+//# sourceMappingURL=textToKeystrokeEvents.js.map

package/dist/interaction/textToKeystrokeEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textToKeystrokeEvents.js","sourceRoot":"","sources":["../../src/interaction/textToKeystrokeEvents.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,qBAAqB,CAAC,KAAa;IAC/C,MAAM,WAAW,GAAyC;QACtD,IAAI,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE;QAC7E,IAAI,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;QAC3E,IAAI,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE;KACpF,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI;YACxB,UAAU,EAAE,WAAW;YACvB,MAAM,EAAE,eAAe;YACvB,KAAK,EAAE,IAAI;SACd,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/logging/ConsoleLogger.d.ts

@@ -0,0 +1,12 @@
+import type { Logger, LogLevel } from './Logger.js';
+export declare class ConsoleLogger implements Logger {
+    private readonly minimumLevel;
+    constructor(minimumLevel?: LogLevel);
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+    private write;
+    private shouldWrite;
+}
+//# sourceMappingURL=ConsoleLogger.d.ts.map

package/dist/logging/ConsoleLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.d.ts","sourceRoot":"","sources":["../../src/logging/ConsoleLogger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEpD,qBAAa,aAAc,YAAW,MAAM;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,GAAE,QAAiB;IAE5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI5D,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,WAAW;CASpB"}

package/dist/logging/ConsoleLogger.js

@@ -0,0 +1,42 @@
+import { redact } from '../utils/redact.js';
+export class ConsoleLogger {
+    minimumLevel;
+    constructor(minimumLevel = 'info') {
+        this.minimumLevel = minimumLevel;
+    }
+    debug(message, meta) {
+        this.write('debug', message, meta);
+    }
+    info(message, meta) {
+        this.write('info', message, meta);
+    }
+    warn(message, meta) {
+        this.write('warn', message, meta);
+    }
+    error(message, meta) {
+        this.write('error', message, meta);
+    }
+    write(level, message, meta) {
+        if (!this.shouldWrite(level))
+            return;
+        const safeMeta = meta === undefined ? undefined : redact(meta);
+        const payload = safeMeta === undefined ? '' : ` ${JSON.stringify(safeMeta)}`;
+        const line = `[${new Date().toISOString()}] ${level.toUpperCase()} ${message}${payload}`;
+        if (level === 'error')
+            console.error(line);
+        else if (level === 'warn')
+            console.warn(line);
+        else
+            console.log(line);
+    }
+    shouldWrite(level) {
+        const weights = {
+            debug: 0,
+            info: 1,
+            warn: 2,
+            error: 3
+        };
+        return weights[level] >= weights[this.minimumLevel];
+    }
+}
+//# sourceMappingURL=ConsoleLogger.js.map

package/dist/logging/ConsoleLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsoleLogger.js","sourceRoot":"","sources":["../../src/logging/ConsoleLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAG5C,MAAM,OAAO,aAAa;IACK;IAA7B,YAA6B,eAAyB,MAAM;QAA/B,iBAAY,GAAZ,YAAY,CAAmB;IAAG,CAAC;IAEhE,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,KAAe,EAAE,OAAe,EAAE,IAA8B;QAC5E,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;YAAE,OAAO;QAErC,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,GAAG,OAAO,EAAE,CAAC;QAEzF,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;aACtC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACzC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAEO,WAAW,CAAC,KAAe;QACjC,MAAM,OAAO,GAA6B;YACxC,KAAK,EAAE,CAAC;YACR,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,CAAC;SACT,CAAC;QACF,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/logging/Logger.d.ts

@@ -0,0 +1,14 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogRecord {
+    level: LogLevel;
+    message: string;
+    meta?: Record<string, unknown>;
+    timestamp: string;
+}
+export interface Logger {
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logging/Logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9D"}

package/dist/logging/Logger.js

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

package/dist/logging/Logger.js.map

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