npm - @epsilon-asi/actors - Versions diffs - 0.0.1 → 0.0.3 - Mend

@epsilon-asi/actors 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (112) hide show

package/package.json +12 -3
package/.ai/generators/_template.ts +0 -37
package/.ai/generators/abstract.ts +0 -24
package/.ai/generators/actor-task-form-filler.ts +0 -140
package/.ai/generators/actor-task.ts +0 -122
package/.ai/generators/auth-core.ts +0 -126
package/.ai/generators/browser-runtime.ts +0 -114
package/.ai/generators/cli-command.ts +0 -96
package/.ai/generators/core-framework.ts +0 -80
package/.ai/generators/docs.ts +0 -92
package/.ai/generators/error-logging.ts +0 -102
package/.ai/generators/extraction-helper.ts +0 -96
package/.ai/generators/interaction-behavior.ts +0 -129
package/.ai/generators/site-actor.ts +0 -125
package/.ai/generators/site-login-flow.ts +0 -117
package/.ai/generators/unit-test.ts +0 -109
package/.ai/workflows/_template.ts +0 -20
package/.ai/workflows/starter.ts +0 -20
package/ai-gen.config.ts +0 -67
package/src/auth/AuthStateDetector.ts +0 -18
package/src/auth/CredentialsProvider.ts +0 -48
package/src/auth/LoginFlow.ts +0 -332
package/src/auth/LoginFlow.types.ts +0 -141
package/src/auth/SessionStore.ts +0 -21
package/src/auth/index.ts +0 -5
package/src/browser/BrowserFactory.ts +0 -253
package/src/browser/BrowserSession.ts +0 -50
package/src/browser/PuppeteerLike.ts +0 -65
package/src/browser/RuntimeConfig.ts +0 -152
package/src/browser/index.ts +0 -5
package/src/browser/profileValidation.ts +0 -73
package/src/cli/run.ts +0 -112
package/src/core/Actor.ts +0 -167
package/src/core/ActorContext.ts +0 -34
package/src/core/ActorRegistry.ts +0 -26
package/src/core/ActorRunner.ts +0 -240
package/src/core/defineActor.ts +0 -5
package/src/core/index.ts +0 -5
package/src/errors/AuthError.ts +0 -7
package/src/errors/AutomationError.ts +0 -26
package/src/errors/ConfigError.ts +0 -7
package/src/errors/ExtractionError.ts +0 -7
package/src/errors/NavigationError.ts +0 -7
package/src/errors/SelectorError.ts +0 -10
package/src/errors/index.ts +0 -6
package/src/extraction/Extractor.ts +0 -65
package/src/extraction/Pagination.ts +0 -47
package/src/extraction/index.ts +0 -2
package/src/index.ts +0 -9
package/src/interaction/FieldClearer.ts +0 -73
package/src/interaction/Forms.ts +0 -27
package/src/interaction/GhostCursorAdapter.ts +0 -79
package/src/interaction/HumanInteractor.ts +0 -32
package/src/interaction/HumanTyping.ts +0 -157
package/src/interaction/NativePuppeteerInteractor.ts +0 -68
package/src/interaction/Navigation.ts +0 -37
package/src/interaction/PageAdapter.ts +0 -86
package/src/interaction/Waits.ts +0 -5
package/src/interaction/index.ts +0 -9
package/src/logging/ConsoleLogger.ts +0 -44
package/src/logging/Logger.ts +0 -15
package/src/logging/MemoryLogger.ts +0 -34
package/src/logging/NullLogger.ts +0 -8
package/src/logging/index.ts +0 -4
package/src/sites/example/example.actor.ts +0 -53
package/src/sites/example/example.selectors.ts +0 -17
package/src/sites/example/example.types.ts +0 -18
package/src/sites/example/index.ts +0 -3
package/src/sites/index.ts +0 -3
package/src/sites/myvistage-com/index.ts +0 -3
package/src/sites/myvistage-com/login-action-list.json +0 -349
package/src/sites/myvistage-com/myvistage-com.actor.ts +0 -50
package/src/sites/myvistage-com/myvistage-com.selectors.ts +0 -14
package/src/sites/myvistage-com/myvistage-com.types.ts +0 -18
package/src/sites/myvistage-com/post-comment-action.json +0 -81
package/src/sites/upwork-com/index.ts +0 -6
package/src/sites/upwork-com/upwork-com.actor.ts +0 -97
package/src/sites/upwork-com/upwork-com.runner.ts +0 -17
package/src/sites/upwork-com/upwork-com.selectors.ts +0 -10
package/src/sites/upwork-com/upwork-com.types.ts +0 -102
package/src/sites/upwork-com/upwork-com.util.ts +0 -41
package/src/utils/delay.ts +0 -4
package/src/utils/index.ts +0 -5
package/src/utils/invariant.ts +0 -7
package/src/utils/redact.ts +0 -53
package/src/utils/retry.ts +0 -31
package/src/utils/url.ts +0 -7
package/tests/fixtures/FakeCredentialsProvider.ts +0 -12
package/tests/fixtures/FakeCursor.ts +0 -48
package/tests/fixtures/FakePage.ts +0 -266
package/tests/fixtures/makeContext.ts +0 -76
package/tests/unit/auth/AuthStateDetector.test.ts +0 -80
package/tests/unit/auth/LoginFlow.test.ts +0 -296
package/tests/unit/browser/BrowserFactory.test.ts +0 -370
package/tests/unit/core/ActorRunner.test.ts +0 -370
package/tests/unit/core/defineActor.test.ts +0 -112
package/tests/unit/extraction/Extractor.test.ts +0 -48
package/tests/unit/extraction/Pagination.test.ts +0 -54
package/tests/unit/interaction/FieldClearer.test.ts +0 -29
package/tests/unit/interaction/Forms.test.ts +0 -35
package/tests/unit/interaction/GhostCursorAdapter.test.ts +0 -68
package/tests/unit/interaction/HumanTyping.test.ts +0 -54
package/tests/unit/interaction/NativePuppeteerInteractor.test.ts +0 -22
package/tests/unit/interaction/PageAdapter.test.ts +0 -25
package/tests/unit/logging/redact.test.ts +0 -36
package/tests/unit/sites/myvistage-com.actor.test.ts +0 -19
package/tests/unit/sites/myvistage-com.login.test.ts +0 -22
package/tests/unit/sites/myvistage-com.postComment.test.ts +0 -70
package/tests/unit/sites/upwork-com.login.test.ts +0 -52
package/tsconfig.build.json +0 -9
package/tsconfig.json +0 -22
package/vitest.config.ts +0 -12

package/tests/fixtures/FakePage.ts DELETED Viewed

@@ -1,266 +0,0 @@
-import type { HTTPResponse, WaitForOptions, WaitForSelectorOptions } from 'puppeteer-core';
-import type { BrowserContextLike, BrowserLike, KeyboardLike, PageLike } from '../../src/browser/PuppeteerLike.js';
-interface FakeElementState {
-  textContent?: string;
-  attributes?: Record<string, string>;
-  value?: string;
-  isContentEditable?: boolean;
-  selected?: boolean;
-  focused?: boolean;
-  events?: string[];
-  selectionStart?: number;
-  selectionEnd?: number;
-  scrolled?: boolean;
-}
-class FakeElement {
-  private readonly attributes: Record<string, string>;
-  constructor(private readonly state: FakeElementState = {}) {
-    this.attributes = state.attributes ?? {};
-    this.state.events ??= [];
-  }
-  get textContent(): string {
-    return this.state.textContent ?? '';
-  }
-  set textContent(value: string) {
-    this.state.textContent = value;
-  }
-  get value(): string {
-    return this.state.value ?? '';
-  }
-  set value(value: string) {
-    this.state.value = value;
-  }
-  get isContentEditable(): boolean {
-    return this.state.isContentEditable ?? false;
-  }
-  get events(): string[] {
-    return this.state.events ?? [];
-  }
-  getAttribute(name: string): string | null {
-    return this.attributes[name] ?? null;
-  }
-  dispatchEvent(event: Event): boolean {
-    this.state.events ??= [];
-    this.state.events.push(event.type);
-    return true;
-  }
-  focus(): void {
-    this.state.focused = true;
-  }
-  select(): void {
-    this.state.selected = true;
-    this.state.selectionStart = 0;
-    this.state.selectionEnd = this.value.length;
-  }
-  setSelectionRange(start: number, end: number): void {
-    this.state.selected = true;
-    this.state.selectionStart = start;
-    this.state.selectionEnd = end;
-  }
-  scrollIntoView(): void {
-    this.state.scrolled = true;
-  }
-  querySelectorAll(selector: string): FakeElement[] {
-    if (selector === 'thead th') {
-      return this.attributes.__headers?.split('|').map(textContent => new FakeElement({ textContent })) ?? [];
-    }
-    if (selector === 'tbody tr') {
-      const rowTexts = this.attributes.__rows?.split('\n').filter(Boolean) ?? [];
-      return rowTexts.map(rowText => new FakeTableRow(rowText));
-    }
-    return [];
-  }
-}
-class FakeTableRow extends FakeElement {
-  constructor(private readonly rowText: string) {
-    super();
-  }
-  override querySelectorAll(selector: string): FakeElement[] {
-    if (selector !== 'td') return [];
-    return this.rowText.split('|').map(textContent => new FakeElement({ textContent }));
-  }
-}
-export class FakeKeyboard implements KeyboardLike {
-  typed: Array<{ text: string; options?: { delay?: number } }> = [];
-  pressed: Array<{ key: string; options?: { delay?: number } }> = [];
-  async type(text: string, options?: { delay?: number }): Promise<void> {
-    const record: { text: string; options?: { delay?: number } } = { text };
-    if (options !== undefined) record.options = options;
-    this.typed.push(record);
-  }
-  async press(key: string, options?: { delay?: number }): Promise<void> {
-    const record: { key: string; options?: { delay?: number } } = { key };
-    if (options !== undefined) record.options = options;
-    this.pressed.push(record);
-  }
-}
-export class FakePage implements PageLike {
-  keyboard = new FakeKeyboard();
-  readonly selectors = new Map<string, FakeElementState>();
-  readonly selectorLists = new Map<string, FakeElementState[]>();
-  readonly gotos: Array<{ url: string; options?: WaitForOptions }> = [];
-  readonly waitedSelectors: Array<{ selector: string; options?: WaitForSelectorOptions }> = [];
-  readonly waitedNavigations: WaitForOptions[] = [];
-  readonly clicked: string[] = [];
-  readonly focused: string[] = [];
-  defaultTimeout?: number;
-  defaultNavigationTimeout?: number;
-  currentUrl = 'about:blank';
-  pageTitle = 'Fake Page';
-  pageContent = '<html></html>';
-  screenshots: Record<string, unknown>[] = [];
-  setSelector(selector: string, state: FakeElementState = {}): this {
-    this.selectors.set(selector, state);
-    return this;
-  }
-  setTextList(selector: string, texts: string[]): this {
-    this.selectorLists.set(selector, texts.map(textContent => ({ textContent })));
-    return this;
-  }
-  removeSelector(selector: string): this {
-    this.selectors.delete(selector);
-    return this;
-  }
-  async goto(url: string, options?: WaitForOptions): Promise<HTTPResponse | null> {
-    this.currentUrl = url;
-    const record: { url: string; options?: WaitForOptions } = { url };
-    if (options !== undefined) record.options = options;
-    this.gotos.push(record);
-    return null;
-  }
-  async waitForSelector(selector: string, options?: WaitForSelectorOptions): Promise<unknown> {
-    const record: { selector: string; options?: WaitForSelectorOptions } = { selector };
-    if (options !== undefined) record.options = options;
-    this.waitedSelectors.push(record);
-    if (!this.selectors.has(selector) && !this.selectorLists.has(selector)) {
-      throw new Error(`Missing selector: ${selector}`);
-    }
-    return {};
-  }
-  async waitForNavigation(options?: WaitForOptions): Promise<HTTPResponse | null> {
-    this.waitedNavigations.push(options ?? {});
-    return null;
-  }
-  async click(selector: string): Promise<void> {
-    await this.waitForSelector(selector);
-    this.clicked.push(selector);
-  }
-  async focus(selector: string): Promise<void> {
-    await this.waitForSelector(selector);
-    this.focused.push(selector);
-  }
-  async $eval<T>(selector: string, pageFunction: (element: Element, ...args: unknown[]) => T, ...args: unknown[]): Promise<T> {
-    const state = this.selectors.get(selector);
-    if (state === undefined) throw new Error(`Missing selector: ${selector}`);
-    return pageFunction(new FakeElement(state) as unknown as Element, ...args);
-  }
-  async $$eval<T>(selector: string, pageFunction: (elements: Element[], ...args: unknown[]) => T, ...args: unknown[]): Promise<T> {
-    const states = this.selectorLists.get(selector) ?? (this.selectors.has(selector) ? [this.selectors.get(selector)!] : []);
-    const elements = states.map(state => new FakeElement(state) as unknown as Element);
-    return pageFunction(elements, ...args);
-  }
-  async evaluate<T>(pageFunction: (...args: unknown[]) => T, ...args: unknown[]): Promise<T> {
-    return pageFunction(...args);
-  }
-  url(): string {
-    return this.currentUrl;
-  }
-  async title(): Promise<string> {
-    return this.pageTitle;
-  }
-  async content(): Promise<string> {
-    return this.pageContent;
-  }
-  async screenshot(options?: Record<string, unknown>): Promise<Uint8Array | string> {
-    this.screenshots.push(options ?? {});
-    return new Uint8Array();
-  }
-  setDefaultTimeout(timeout: number): void {
-    this.defaultTimeout = timeout;
-  }
-  setDefaultNavigationTimeout(timeout: number): void {
-    this.defaultNavigationTimeout = timeout;
-  }
-}
-export class FakeBrowserContext implements BrowserContextLike {}
-export class FakeBrowser implements BrowserLike {
-  readonly context = new FakeBrowserContext();
-  readonly closeCalls: number[] = [];
-  readonly disconnectCalls: number[] = [];
-  defaultBrowserContextCalls = 0;
-  newPageCalls = 0;
-  createBrowserContextCalls = 0;
-  constructor(private readonly pageList: FakePage[] = [new FakePage()]) {}
-  defaultBrowserContext(): BrowserContextLike {
-    this.defaultBrowserContextCalls += 1;
-    return this.context;
-  }
-  async pages(): Promise<PageLike[]> {
-    return this.pageList;
-  }
-  async newPage(): Promise<PageLike> {
-    this.newPageCalls += 1;
-    const page = new FakePage();
-    this.pageList.push(page);
-    return page;
-  }
-  // Deliberately not part of BrowserLike. Tests assert BrowserFactory never calls it.
-  async createBrowserContext(): Promise<BrowserContextLike> {
-    this.createBrowserContextCalls += 1;
-    return new FakeBrowserContext();
-  }
-  async close(): Promise<void> {
-    this.closeCalls.push(Date.now());
-  }
-  async disconnect(): Promise<void> {
-    this.disconnectCalls.push(Date.now());
-  }
-}

package/tests/fixtures/makeContext.ts DELETED Viewed

@@ -1,76 +0,0 @@
-import fs from 'node:fs';
-import os from 'node:os';
-import path from 'node:path';
-import { BrowserSession } from '../../src/browser/BrowserSession.js';
-import type { RuntimeConfig } from '../../src/browser/RuntimeConfig.js';
-import type { ActorContext, AuthController } from '../../src/core/ActorContext.js';
-import { Extractor } from '../../src/extraction/Extractor.js';
-import { Pagination } from '../../src/extraction/Pagination.js';
-import { FormFiller } from '../../src/interaction/Forms.js';
-import type { HumanInteractor } from '../../src/interaction/HumanInteractor.js';
-import { Navigator } from '../../src/interaction/Navigation.js';
-import { PuppeteerPageAdapter } from '../../src/interaction/PageAdapter.js';
-import { MemoryLogger } from '../../src/logging/MemoryLogger.js';
-import { FakeHumanInteractor } from './FakeCursor.js';
-import { FakeBrowser, FakePage } from './FakePage.js';
-export interface TestContextParts {
-  context: ActorContext;
-  fakePage: FakePage;
-  fakeInteractor: FakeHumanInteractor;
-  logger: MemoryLogger;
-  config: RuntimeConfig;
-}
-export function makeContext(overrides: Partial<{
-  page: FakePage;
-  interactor: HumanInteractor;
-  actorId: string;
-  baseUrl: string;
-  auth: AuthController;
-}> = {}): TestContextParts {
-  const fakePage = overrides.page ?? new FakePage();
-  const fakeInteractor = overrides.interactor instanceof FakeHumanInteractor
-    ? overrides.interactor
-    : new FakeHumanInteractor();
-  const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'paf-test-context-'));
-  fs.mkdirSync(path.join(userDataDir, 'Default'));
-  const config: RuntimeConfig = {
-    browser: {
-      mode: 'existing-profile',
-      userDataDir,
-      profileDirectory: 'Default',
-      headless: false
-    }
-  };
-  const fakeBrowser = new FakeBrowser([fakePage]);
-  const session = new BrowserSession(fakeBrowser, fakeBrowser.context, fakePage, config.browser, 'launched');
-  const page = new PuppeteerPageAdapter(fakePage);
-  const cursor = overrides.interactor ?? fakeInteractor;
-  const forms = new FormFiller(page, cursor);
-  const nav = new Navigator(page, cursor, overrides.baseUrl ?? 'https://example.com');
-  const extract = new Extractor(page);
-  const pagination = new Pagination(page, cursor);
-  const logger = new MemoryLogger();
-  const auth: AuthController = overrides.auth ?? {
-    isLoggedIn: async () => false,
-    ensureAuthenticated: async () => undefined
-  };
-  const context: ActorContext = {
-    actor: { id: overrides.actorId ?? 'example', baseUrl: overrides.baseUrl ?? 'https://example.com' },
-    config,
-    session,
-    page,
-    cursor,
-    forms,
-    nav,
-    extract,
-    pagination,
-    auth,
-    logger
-  };
-  return { context, fakePage, fakeInteractor, logger, config };
-}

package/tests/unit/auth/AuthStateDetector.test.ts DELETED Viewed

@@ -1,80 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { AuthStateDetector } from '../../../src/auth/AuthStateDetector.js';
-import { defineLoginFlow } from '../../../src/auth/LoginFlow.types.js';
-import { makeContext } from '../../fixtures/makeContext.js';
-describe('AuthStateDetector', () => {
-  it('returns true when the logged-in signal exists', async () => {
-    const { context, fakePage } = makeContext();
-    fakePage.setSelector('[data-testid="account"]');
-    const detector = new AuthStateDetector();
-    const result = await detector.isLoggedIn(context, defineLoginFlow({
-      loginUrl: '/login',
-      selectors: {
-        username: '#email',
-        password: '#password',
-        submit: '#submit',
-        loggedInSignal: '[data-testid="account"]'
-      }
-    }));
-    expect(result).toBe(true);
-  });
-  it('returns false when the logged-in signal is absent', async () => {
-    const { context } = makeContext();
-    const detector = new AuthStateDetector();
-    await expect(detector.isLoggedIn(context, defineLoginFlow({
-      loginUrl: '/login',
-      selectors: {
-        username: '#email',
-        password: '#password',
-        submit: '#submit',
-        loggedInSignal: '#missing'
-      }
-    }))).resolves.toBe(false);
-  });
-  it('visits authCheckUrl before checking auth state', async () => {
-    const { context, fakePage } = makeContext();
-    fakePage.setSelector('#account');
-    const detector = new AuthStateDetector();
-    await detector.isLoggedIn(context, defineLoginFlow({
-      loginUrl: '/login',
-      selectors: {
-        username: '#email',
-        password: '#password',
-        submit: '#submit',
-        loggedInSignal: '#account'
-      },
-      behavior: {
-        authCheckUrl: '/dashboard'
-      }
-    }));
-    expect(fakePage.gotos[0]?.url).toBe('https://example.com/dashboard');
-  });
-  it('uses custom verifyLoggedIn hook when provided', async () => {
-    const { context } = makeContext();
-    const detector = new AuthStateDetector();
-    const result = await detector.isLoggedIn(context, defineLoginFlow({
-      loginUrl: '/login',
-      selectors: {
-        username: '#email',
-        password: '#password',
-        submit: '#submit',
-        loggedInSignal: '#account'
-      },
-      hooks: {
-        verifyLoggedIn: async () => true
-      }
-    }));
-    expect(result).toBe(true);
-  });
-});