@epsilon-asi/actors 0.0.1 → 0.0.3

package/src/sites/myvistage-com/myvistage-com.actor.ts

@@ -1,50 +0,0 @@
-import { defineLoginFlow } from '../../auth/LoginFlow.types.js';
-import { defineFormFillerTask } from '../../core/Actor.js';
-import { defineActor } from '../../core/defineActor.js';
-import { myvistageComSelectors } from './myvistage-com.selectors.js';
-import type {
-  PingInput,
-  PingOutput,
-  PostCommentInput,
-  PostCommentOutput
-} from './myvistage-com.types.js';
-
-export const myvistageComActor = defineActor({
-  id: 'myvistage-com',
-  baseUrl: 'https://myvistage.com',
-  auth: defineLoginFlow({
-    loginUrl: 'https://myvistage.com',
-    selectors: myvistageComSelectors.login,
-    credentials: { id: 'myvistage-com' },
-    behavior: {
-      authCheckUrl: '/',
-      submitCausesNavigation: true,
-      loggedInTimeoutMs: 5_000,
-      errorTimeoutMs: 1_500,
-      typing: {
-        targetWordsPerMinute: 65,
-        intervalJitterMs: 18
-      }
-    }
-  }),
-  tasks: {
-    ping: async (_context, input: PingInput = {}): Promise<PingOutput> => ({
-      ok: true,
-      echo: input.message ?? null
-    }),
-    postComment: defineFormFillerTask<PostCommentInput, PostCommentOutput>({
-      url: '/?status/151341-151341-1779377493/',
-      fields: [
-        { selector: myvistageComSelectors.postComment.comment, inputKey: 'comment' },
-        { selector: myvistageComSelectors.postComment.subject, inputKey: 'subject', required: false }
-      ],
-      submit: {
-        selector: myvistageComSelectors.postComment.submit
-      },
-      onComplete: (_context, input) => ({
-        submittedComment: input.comment,
-        submittedSubject: input.subject ?? null
-      })
-    })
-  }
-});

package/src/sites/myvistage-com/myvistage-com.selectors.ts

@@ -1,14 +0,0 @@
-export const myvistageComSelectors = {
-  login: {
-    username: '[name="username"]',
-    password: '[name="password"]',
-    submit: '#form-login button[type="submit"]',
-    loggedInSignal: 'a[href*="logout"], a[href*="signout"]',
-    errorMessage: '#mv3login [role="alert"], #mv3login .error, #mv3login .woocommerce-error'
-  },
-  postComment: {
-    comment: 'textarea[name="comment"]',
-    subject: 'input[name="subject"]',
-    submit: 'div:nth-of-type(2) > div:nth-of-type(2) > div:nth-of-type(1) > button:nth-of-type(2)'
-  }
-} as const;

package/src/sites/myvistage-com/myvistage-com.types.ts

@@ -1,18 +0,0 @@
-export interface PingInput {
-  message?: string;
-}
-
-export interface PingOutput {
-  ok: true;
-  echo: string | null;
-}
-
-export interface PostCommentInput extends Record<string, string | undefined> {
-  comment: string;
-  subject?: string;
-}
-
-export interface PostCommentOutput {
-  submittedComment: string;
-  submittedSubject: string | null;
-}

package/src/sites/myvistage-com/post-comment-action.json

@@ -1,81 +0,0 @@
-[
-  {
-    "actionType": "click",
-    "frameUrl": "https://myvistage.com/?status/151341-151341-1779377493/",
-    "id": "evt_1779456308524_qrd1e362",
-    "input": null,
-    "metadata": {
-      "ariaLabel": null,
-      "button": 0,
-      "buttons": 0,
-      "clientX": 529,
-      "clientY": 1042,
-      "id": null,
-      "inputType": null,
-      "label": "Write a comment...",
-      "name": "comment",
-      "pageX": 529,
-      "pageY": 1042,
-      "role": null,
-      "sensitive": false,
-      "tagName": "textarea"
-    },
-    "selector": "[placeholder=\"Write a comment...\"]",
-    "sessionId": "session_1779456305296_opr4xo87",
-    "tagName": "textarea",
-    "text": null,
-    "timestamp": "2026-05-22T13:25:08.522Z",
-    "url": "https://myvistage.com/?status/151341-151341-1779377493/"
-  },
-  {
-    "actionType": "input",
-    "frameUrl": "https://myvistage.com/?status/151341-151341-1779377493/",
-    "id": "evt_1779456314495_qrzdnyxn",
-    "input": null,
-    "metadata": {
-      "ariaLabel": null,
-      "id": null,
-      "inputType": null,
-      "label": "Write a comment...",
-      "name": "comment",
-      "role": null,
-      "sensitive": false,
-      "tagName": "textarea",
-      "valueLength": null
-    },
-    "selector": "[placeholder=\"Write a comment...\"]",
-    "sessionId": "session_1779456305296_opr4xo87",
-    "tagName": "textarea",
-    "text": null,
-    "timestamp": "2026-05-22T13:25:14.139Z",
-    "url": "https://myvistage.com/?status/151341-151341-1779377493/"
-  },
-  {
-    "actionType": "click",
-    "frameUrl": "https://myvistage.com/?status/151341-151341-1779377493/",
-    "id": "evt_1779456319321_fujuvmqc",
-    "input": null,
-    "metadata": {
-      "ariaLabel": null,
-      "button": 0,
-      "buttons": 0,
-      "clientX": 1167,
-      "clientY": 1042,
-      "id": null,
-      "inputType": null,
-      "label": "Post",
-      "name": null,
-      "pageX": 1167,
-      "pageY": 1042,
-      "role": null,
-      "sensitive": false,
-      "tagName": "button"
-    },
-    "selector": "div:nth-of-type(2) > div:nth-of-type(2) > div:nth-of-type(1) > button:nth-of-type(2)",
-    "sessionId": "session_1779456305296_opr4xo87",
-    "tagName": "button",
-    "text": "Post",
-    "timestamp": "2026-05-22T13:25:19.320Z",
-    "url": "https://myvistage.com/?status/151341-151341-1779377493/"
-  }
-]

package/src/sites/upwork-com/index.ts

@@ -1,6 +0,0 @@
-export * from './upwork-com.actor.js';
-export * from './upwork-com.selectors.js';
-export * from './upwork-com.types.js';
-export {parseRate} from "./upwork-com.util.js";
-
-export {buildSearchParams} from "./upwork-com.util.js";

package/src/sites/upwork-com/upwork-com.actor.ts

@@ -1,97 +0,0 @@
-import {defineLoginFlow} from '../../auth/LoginFlow.types.js';
-import {defineActor} from '../../core/defineActor.js';
-import {upworkComSelectors} from './upwork-com.selectors.js';
-import type {
-  UpworkApplyToJobInput,
-  UpworkApplyToJobResult,
-  UpworkJobSearchFields,
-  UpworkJobSearchResult
-} from './upwork-com.types.js';
-import {buildSearchParams, parseRate} from "./upwork-com.util.js";
-
-export const upworkComActor = defineActor({
-  id: 'upwork-com',
-  baseUrl: 'https://upwork.com',
-  auth: defineLoginFlow({
-    loginUrl: 'https://www.upwork.com/ab/account-security/login',
-    selectors: {
-      loggedInSignal: upworkComSelectors.login.loggedInSignal,
-      errorMessage: upworkComSelectors.login.errorMessage
-    },
-    credentials: { id: 'upwork' },
-    behavior: {
-      authCheckUrl: '/',
-      loggedInTimeoutMs: 5_000,
-      errorTimeoutMs: 1_500,
-      typing: {
-        targetWordsPerMinute: 65,
-        intervalJitterMs: 18
-      }
-    },
-    steps: [
-      {
-        type: 'fill',
-        name: 'username',
-        selector: upworkComSelectors.login.username,
-        credential: 'username'
-      },
-      {
-        type: 'click',
-        name: 'continue to password',
-        selector: upworkComSelectors.login.continueToPassword,
-        waitForSelector: upworkComSelectors.login.password,
-        waitForSelectorTimeoutMs: 5_000
-      },
-      {
-        type: 'fill',
-        name: 'password',
-        selector: upworkComSelectors.login.password,
-        credential: 'password'
-      },
-      {
-        type: 'click',
-        name: 'submit password',
-        selector: upworkComSelectors.login.submit,
-        submit: true,
-        waitForNavigation: true,
-        checkForError: false
-      }
-    ]
-  }),
-  tasks: {
-    searchJobs: async (context, input: UpworkJobSearchFields = {}): Promise<any> => {
-      const path = '/nx/s/universal-search/jobs?client_hires=1-9,10-&payment_verified=1&q=%27rancher%27%20or%20%27terraform%27%20or%20%27gitops%27%20or%20%27azure%27%20or%20%27microsoft%20azure%27%20or%20%27cloud%20architect%27%20or%20%27ai%20architect%27%20or%20%27forward%20deployed%20engineer%27%20or%20%27aws%27%20or%20%27aks%27%20or%20%27eks%27%20or%20%27gke%27%20or%20%27cloud%20engineer%27%20or%20devops%20or%20kuberentes%20or%20%27platform%20engineer%27%20or%20%27infrastructure%20engineer%27%20or%20"google%20cloud%20platform"%20or%20"GCP"%20or%20"langsmith"%20or%20"langgraph"%20or%20"gemini%20enterprise"&sort=recency&user_location_match=1';
-
-      await context.nav.goto(path, {});
-
-      console.log(context.page.raw());
-
-      // Get by classname class="jobs-main-panel - get all children of article type
-      // loop through each. Check
-        //
-      //
-    },
-    applyToJob: async (_context, input: UpworkApplyToJobInput): Promise<UpworkApplyToJobResult> => {
-      const coverLetter = input.coverLetter.trim();
-      if (coverLetter.length === 0) {
-        throw new Error('coverLetter must be a non-empty string.');
-      }
-
-      const rate = parseRate(input.rate);
-      if (!Number.isFinite(rate) || rate <= 0) {
-        throw new Error('rate must be a positive number.');
-      }
-
-      return {
-        coverLetter,
-        rate
-      };
-    }
-  }
-});
-
-
-const likeScript = `reactions.action_reactions(this, 1632181); `
-const commentScript = `activity.comment_save(1630927, this);`
-
-

package/src/sites/upwork-com/upwork-com.runner.ts

@@ -1,17 +0,0 @@
-import {ActorRunner} from "../../core/index.js";
-import {upworkComActor} from "./upwork-com.actor.js";
-
-const runner = new ActorRunner({
-    config: {
-        browser: {
-            mode: 'remote-debugging',
-        }
-    }
-});
-
-
-const run = async () => {
-    await runner.run(upworkComActor, 'searchJobs', {} as any)
-}
-
-run().catch(e=>console.error(e)).then(r=>console.log(r))

package/src/sites/upwork-com/upwork-com.selectors.ts

@@ -1,10 +0,0 @@
-export const upworkComSelectors = {
-  login: {
-    username: '#login_username',
-    password: '#login_password',
-    continueToPassword: '#login_password_continue',
-    submit: '#login_control_continue',
-    loggedInSignal: '[data-test="nav-user-dropdown"]',
-    errorMessage: '#login_error'
-  }
-} as const;

package/src/sites/upwork-com/upwork-com.types.ts

@@ -1,102 +0,0 @@
-export enum JobSearchSort {
-  BestMatch = 'best_match',
-}
-
-export enum DomesticFilter {
-  USOnly = 'us_only',
-}
-
-export enum ContractorTier {
-  EntryLevel = '1',
-  Intermediate = '2',
-  Expert = '3',
-}
-
-export enum JobType {
-  Hourly = 'hourly',
-  FixedPrice = 'fixed_price',
-}
-
-export enum FixedPriceRange {
-  LessThan100 = 'lt_100',
-  From100To500 = '100_to_500',
-  From500To1000 = '500_to_1000',
-  From1000To5000 = '1000_to_5000',
-  GreaterThan5000 = 'gte_5000',
-}
-
-export enum ProposalRange {
-  FewerThan5 = '0-4',
-  From5To10 = '5-9',
-  From10To15 = '10-14',
-  From15To20 = '15-19',
-  From20To50 = '20-49',
-}
-
-export enum ClientInfoFilter {
-  PreviousClients = 'previous_clients',
-  PaymentVerified = 'payment_verified',
-}
-
-export enum ClientHiresRange {
-  NoHires = '0',
-  From1To9 = '1-9',
-  TenPlus = '10-',
-}
-
-export enum ProjectLength {
-  LessThanOneMonth = 'week',
-  OneToThreeMonths = 'month',
-  ThreeToSixMonths = 'semester',
-  MoreThanSixMonths = 'ongoing',
-}
-
-export enum HoursPerWeek {
-  LessThan30 = 'as_needed',
-  MoreThan30 = 'full_time',
-}
-
-export enum JobDuration {
-  ContractToHire = 'contract_to_hire',
-}
-
-export type MoneyRange = {
-  min?: number;
-  max?: number;
-  currency?: 'USD';
-};
-
-export type UpworkJobSearchFields = {
-  sort?: JobSearchSort;
-  domestic?: DomesticFilter;
-  categories?: string[];
-  contractorTier?: ContractorTier[];
-  jobType?: JobType[];
-  hourlyRate?: MoneyRange;
-  fixedPriceRanges?: FixedPriceRange[];
-  fixedPriceCustom?: MoneyRange;
-  proposals?: ProposalRange[];
-  clientInfo?: ClientInfoFilter[];
-  clientHires?: ClientHiresRange[];
-  clientLocations?: string[];
-  clientTimezones?: string[];
-  projectLength?: ProjectLength[];
-  hoursPerWeek?: HoursPerWeek[];
-  jobDuration?: JobDuration[];
-};
-
-export interface UpworkJobSearchResult {
-  searchUrl: string;
-  query: string;
-  filters: UpworkJobSearchFields;
-}
-
-export interface UpworkApplyToJobInput {
-  coverLetter: string;
-  rate: number | string;
-}
-
-export interface UpworkApplyToJobResult {
-  coverLetter: string;
-  rate: number;
-}

package/src/sites/upwork-com/upwork-com.util.ts

@@ -1,41 +0,0 @@
-import type {UpworkApplyToJobInput, UpworkJobSearchFields} from "./upwork-com.types.js";
-
-export function buildSearchParams(input: UpworkJobSearchFields): URLSearchParams {
-    const params = new URLSearchParams();
-
-    if (input.sort !== undefined) params.set('sort', input.sort);
-    if (input.domestic !== undefined) params.set('domestic', input.domestic);
-    appendList(params, 'categories', input.categories);
-    appendList(params, 'contractor_tier', input.contractorTier);
-    appendList(params, 'job_type', input.jobType);
-
-    if (input.hourlyRate?.min !== undefined) params.set('hourly_rate_min', String(input.hourlyRate.min));
-    if (input.hourlyRate?.max !== undefined) params.set('hourly_rate_max', String(input.hourlyRate.max));
-    if (input.hourlyRate?.currency !== undefined) params.set('hourly_rate_currency', input.hourlyRate.currency);
-
-    appendList(params, 'fixed_price_ranges', input.fixedPriceRanges);
-    if (input.fixedPriceCustom?.min !== undefined) params.set('fixed_price_min', String(input.fixedPriceCustom.min));
-    if (input.fixedPriceCustom?.max !== undefined) params.set('fixed_price_max', String(input.fixedPriceCustom.max));
-    if (input.fixedPriceCustom?.currency !== undefined) params.set('fixed_price_currency', input.fixedPriceCustom.currency);
-
-    appendList(params, 'proposals', input.proposals);
-    appendList(params, 'client_info', input.clientInfo);
-    appendList(params, 'client_hires', input.clientHires);
-    appendList(params, 'client_locations', input.clientLocations);
-    appendList(params, 'client_timezones', input.clientTimezones);
-    appendList(params, 'project_length', input.projectLength);
-    appendList(params, 'hours_per_week', input.hoursPerWeek);
-    appendList(params, 'job_duration', input.jobDuration);
-
-    return params;
-}
-
-function appendList(params: URLSearchParams, key: string, values: readonly string[] | undefined): void {
-    if (values === undefined || values.length === 0) return;
-    params.set(key, values.join(','));
-}
-
-export function parseRate(rate: UpworkApplyToJobInput['rate']): number {
-    if (typeof rate === 'number') return rate;
-    return Number(rate.trim());
-}

package/src/utils/delay.ts

@@ -1,4 +0,0 @@
-export function delay(ms: number): Promise<void> {
-  if (ms <= 0) return Promise.resolve();
-  return new Promise(resolve => setTimeout(resolve, ms));
-}

package/src/utils/index.ts

@@ -1,5 +0,0 @@
-export * from './delay.js';
-export * from './invariant.js';
-export * from './redact.js';
-export * from './retry.js';
-export * from './url.js';

package/src/utils/invariant.ts

@@ -1,7 +0,0 @@
-import { ConfigError } from '../errors/ConfigError.js';
-
-export function invariant(condition: unknown, message: string): asserts condition {
-  if (!condition) {
-    throw new ConfigError(message);
-  }
-}

package/src/utils/redact.ts

@@ -1,53 +0,0 @@
-const DEFAULT_REDACTION_KEYS = [
-  'password',
-  'passwd',
-  'secret',
-  'token',
-  'apiKey',
-  'api_key',
-  'authorization',
-  'auth',
-  'cookie',
-  'session',
-  'credential',
-  'refreshToken',
-  'accessToken'
-];
-
-export interface RedactOptions {
-  replacement?: string;
-  sensitiveKeys?: string[];
-}
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-
-function keyIsSensitive(key: string, sensitiveKeys: string[]): boolean {
-  const normalized = key.toLowerCase();
-  return sensitiveKeys.some(sensitiveKey => normalized.includes(sensitiveKey.toLowerCase()));
-}
-
-export function redact<T>(value: T, options: RedactOptions = {}): T {
-  const replacement = options.replacement ?? '[REDACTED]';
-  const sensitiveKeys = options.sensitiveKeys ?? DEFAULT_REDACTION_KEYS;
-
-  const visit = (input: unknown): unknown => {
-    if (Array.isArray(input)) {
-      return input.map(item => visit(item));
-    }
-
-    if (!isPlainObject(input)) {
-      return input;
-    }
-
-    return Object.fromEntries(
-      Object.entries(input).map(([key, nestedValue]) => [
-        key,
-        keyIsSensitive(key, sensitiveKeys) ? replacement : visit(nestedValue)
-      ])
-    );
-  };
-
-  return visit(value) as T;
-}

package/src/utils/retry.ts

@@ -1,31 +0,0 @@
-import { delay } from './delay.js';
-
-export interface RetryPolicy {
-  attempts: number;
-  baseDelayMs: number;
-  maxDelayMs?: number;
-  jitter?: boolean;
-}
-
-export async function retry<T>(fn: () => Promise<T>, policy: RetryPolicy): Promise<T> {
-  if (!Number.isInteger(policy.attempts) || policy.attempts < 1) {
-    throw new Error('Retry attempts must be a positive integer.');
-  }
-
-  let lastError: unknown;
-  for (let attempt = 1; attempt <= policy.attempts; attempt += 1) {
-    try {
-      return await fn();
-    } catch (error) {
-      lastError = error;
-      if (attempt === policy.attempts) break;
-
-      const exponentialDelay = policy.baseDelayMs * 2 ** (attempt - 1);
-      const cappedDelay = Math.min(exponentialDelay, policy.maxDelayMs ?? exponentialDelay);
-      const jitter = policy.jitter ? Math.floor(Math.random() * Math.max(1, cappedDelay / 3)) : 0;
-      await delay(cappedDelay + jitter);
-    }
-  }
-
-  throw lastError;
-}

package/src/utils/url.ts

@@ -1,7 +0,0 @@
-export function resolveUrl(baseUrl: string, urlOrPath: string): string {
-  try {
-    return new URL(urlOrPath).toString();
-  } catch {
-    return new URL(urlOrPath, baseUrl).toString();
-  }
-}

package/tests/fixtures/FakeCredentialsProvider.ts

@@ -1,12 +0,0 @@
-import type { CredentialRef, Credentials, CredentialsProvider } from '../../src/auth/CredentialsProvider.js';
-
-export class FakeCredentialsProvider implements CredentialsProvider {
-  readonly requested: CredentialRef[] = [];
-
-  constructor(private readonly credentials: Credentials = { username: 'user@example.com', password: 'secret' }) {}
-
-  async getCredentials(ref: CredentialRef): Promise<Credentials> {
-    this.requested.push(ref);
-    return this.credentials;
-  }
-}

package/tests/fixtures/FakeCursor.ts

@@ -1,48 +0,0 @@
-import type { HumanClickOptions, HumanInteractor, HumanMoveOptions, HumanTypeOptions } from '../../src/interaction/HumanInteractor.js';
-
-export class FakeHumanInteractor implements HumanInteractor {
-  clicks: Array<{ selector: string; options?: HumanClickOptions }> = [];
-  moves: Array<{ selector: string; options?: HumanMoveOptions }> = [];
-  typed: Array<{ selector: string; value: string; options?: HumanTypeOptions }> = [];
-  scrolled: string[] = [];
-
-  async click(selector: string, options?: HumanClickOptions): Promise<void> {
-    const record: { selector: string; options?: HumanClickOptions } = { selector };
-    if (options !== undefined) record.options = options;
-    this.clicks.push(record);
-  }
-
-  async move(selector: string, options?: HumanMoveOptions): Promise<void> {
-    const record: { selector: string; options?: HumanMoveOptions } = { selector };
-    if (options !== undefined) record.options = options;
-    this.moves.push(record);
-  }
-
-  async type(selector: string, value: string, options?: HumanTypeOptions): Promise<void> {
-    const record: { selector: string; value: string; options?: HumanTypeOptions } = { selector, value };
-    if (options !== undefined) record.options = options;
-    this.typed.push(record);
-  }
-
-  async scrollIntoView(selector: string): Promise<void> {
-    this.scrolled.push(selector);
-  }
-}
-
-export class FakeGhostCursor {
-  clicks: Array<{ selector?: string; options?: Record<string, unknown> }> = [];
-  moves: Array<{ selector: string; options?: Record<string, unknown> }> = [];
-
-  async click(selector?: string, options?: Record<string, unknown>): Promise<void> {
-    const record: { selector?: string; options?: Record<string, unknown> } = {};
-    if (selector !== undefined) record.selector = selector;
-    if (options !== undefined) record.options = options;
-    this.clicks.push(record);
-  }
-
-  async move(selector: string, options?: Record<string, unknown>): Promise<void> {
-    const record: { selector: string; options?: Record<string, unknown> } = { selector };
-    if (options !== undefined) record.options = options;
-    this.moves.push(record);
-  }
-}