cbrowser 2.2.0

package/dist/personas.js

@@ -0,0 +1,296 @@
+"use strict";
+/**
+ * Built-in Personas for CBrowser
+ *
+ * Each persona represents a different user archetype with specific
+ * behaviors, timing, and interaction patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_PERSONAS = void 0;
+exports.getPersona = getPersona;
+exports.listPersonas = listPersonas;
+exports.BUILTIN_PERSONAS = {
+    "power-user": {
+        name: "power-user",
+        description: "Tech-savvy expert who expects efficiency and knows shortcuts",
+        demographics: {
+            age_range: "25-45",
+            tech_level: "expert",
+            device: "desktop",
+        },
+        behaviors: {
+            uses_keyboard_shortcuts: true,
+            reads_quickly: true,
+            skips_tutorials: true,
+            expects_instant_response: true,
+        },
+        humanBehavior: {
+            timing: {
+                reactionTime: { min: 100, max: 300 },
+                clickDelay: { min: 50, max: 150 },
+                typeSpeed: { min: 30, max: 80 },
+                readingSpeed: 400,
+                scrollPauseTime: { min: 100, max: 300 },
+            },
+            errors: {
+                misClickRate: 0.02,
+                doubleClickAccidental: 0.01,
+                typoRate: 0.02,
+                backtrackRate: 0.05,
+            },
+            mouse: {
+                curvature: 0.2,
+                jitter: 2,
+                overshoot: 0.05,
+                speed: "fast",
+            },
+            attention: {
+                pattern: "skim",
+                scrollBehavior: "jump",
+                focusAreas: ["cta", "prices"],
+                distractionRate: 0.1,
+            },
+        },
+        context: {
+            viewport: [1920, 1080],
+        },
+    },
+    "first-timer": {
+        name: "first-timer",
+        description: "New user exploring for the first time, needs guidance",
+        demographics: {
+            age_range: "18-65",
+            tech_level: "beginner",
+            device: "desktop",
+        },
+        behaviors: {
+            reads_everything: true,
+            hesitant_to_click: true,
+            follows_tutorials: true,
+            asks_for_help: true,
+        },
+        humanBehavior: {
+            timing: {
+                reactionTime: { min: 500, max: 1500 },
+                clickDelay: { min: 300, max: 800 },
+                typeSpeed: { min: 100, max: 200 },
+                readingSpeed: 150,
+                scrollPauseTime: { min: 500, max: 1500 },
+            },
+            errors: {
+                misClickRate: 0.1,
+                doubleClickAccidental: 0.05,
+                typoRate: 0.08,
+                backtrackRate: 0.2,
+            },
+            mouse: {
+                curvature: 0.6,
+                jitter: 8,
+                overshoot: 0.15,
+                speed: "slow",
+            },
+            attention: {
+                pattern: "thorough",
+                scrollBehavior: "chunked",
+                focusAreas: ["header", "text", "images"],
+                distractionRate: 0.3,
+            },
+        },
+        context: {
+            viewport: [1280, 800],
+        },
+    },
+    "mobile-user": {
+        name: "mobile-user",
+        description: "Smartphone user with touch interface and limited screen",
+        demographics: {
+            age_range: "18-45",
+            tech_level: "intermediate",
+            device: "mobile",
+        },
+        behaviors: {
+            uses_gestures: true,
+            easily_distracted: true,
+            short_sessions: true,
+            expects_mobile_friendly: true,
+        },
+        humanBehavior: {
+            timing: {
+                reactionTime: { min: 200, max: 600 },
+                clickDelay: { min: 150, max: 400 },
+                typeSpeed: { min: 80, max: 150 },
+                readingSpeed: 200,
+                scrollPauseTime: { min: 200, max: 500 },
+            },
+            errors: {
+                misClickRate: 0.15,
+                doubleClickAccidental: 0.08,
+                typoRate: 0.12,
+                backtrackRate: 0.15,
+            },
+            mouse: {
+                curvature: 0.3,
+                jitter: 15,
+                overshoot: 0.2,
+                speed: "normal",
+            },
+            attention: {
+                pattern: "f-pattern",
+                scrollBehavior: "continuous",
+                focusAreas: ["header", "cta", "images"],
+                distractionRate: 0.4,
+            },
+        },
+        context: {
+            viewport: [375, 812], // iPhone X dimensions
+        },
+    },
+    "screen-reader-user": {
+        name: "screen-reader-user",
+        description: "Blind user navigating with screen reader and keyboard",
+        demographics: {
+            age_range: "25-65",
+            tech_level: "intermediate",
+            device: "desktop",
+        },
+        behaviors: {
+            keyboard_only: true,
+            relies_on_aria: true,
+            needs_alt_text: true,
+            sequential_navigation: true,
+        },
+        humanBehavior: {
+            timing: {
+                reactionTime: { min: 300, max: 800 },
+                clickDelay: { min: 200, max: 500 },
+                typeSpeed: { min: 50, max: 120 },
+                readingSpeed: 250,
+                scrollPauseTime: { min: 300, max: 700 },
+            },
+            errors: {
+                misClickRate: 0.05,
+                doubleClickAccidental: 0.02,
+                typoRate: 0.04,
+                backtrackRate: 0.25,
+            },
+            mouse: {
+                curvature: 0,
+                jitter: 0,
+                overshoot: 0,
+                speed: "normal",
+            },
+            attention: {
+                pattern: "thorough",
+                scrollBehavior: "chunked",
+                focusAreas: ["header", "text"],
+                distractionRate: 0.15,
+            },
+        },
+        context: {
+            viewport: [1280, 800],
+        },
+    },
+    "elderly-user": {
+        name: "elderly-user",
+        description: "Older adult with potential vision and motor limitations",
+        demographics: {
+            age_range: "65+",
+            tech_level: "beginner",
+            device: "desktop",
+        },
+        behaviors: {
+            prefers_large_text: true,
+            careful_clicking: true,
+            avoids_complexity: true,
+            needs_clear_feedback: true,
+        },
+        humanBehavior: {
+            timing: {
+                reactionTime: { min: 800, max: 2000 },
+                clickDelay: { min: 500, max: 1200 },
+                typeSpeed: { min: 150, max: 300 },
+                readingSpeed: 100,
+                scrollPauseTime: { min: 800, max: 2000 },
+            },
+            errors: {
+                misClickRate: 0.2,
+                doubleClickAccidental: 0.15,
+                typoRate: 0.1,
+                backtrackRate: 0.3,
+            },
+            mouse: {
+                curvature: 0.7,
+                jitter: 12,
+                overshoot: 0.25,
+                speed: "slow",
+            },
+            attention: {
+                pattern: "thorough",
+                scrollBehavior: "chunked",
+                focusAreas: ["header", "text", "cta"],
+                distractionRate: 0.2,
+            },
+        },
+        context: {
+            viewport: [1280, 800],
+        },
+    },
+    "impatient-user": {
+        name: "impatient-user",
+        description: "Quick to abandon slow or confusing experiences",
+        demographics: {
+            age_range: "18-45",
+            tech_level: "intermediate",
+            device: "desktop",
+        },
+        behaviors: {
+            abandons_quickly: true,
+            skips_reading: true,
+            expects_speed: true,
+            low_tolerance_for_errors: true,
+        },
+        humanBehavior: {
+            timing: {
+                reactionTime: { min: 100, max: 400 },
+                clickDelay: { min: 80, max: 200 },
+                typeSpeed: { min: 40, max: 100 },
+                readingSpeed: 350,
+                scrollPauseTime: { min: 100, max: 300 },
+            },
+            errors: {
+                misClickRate: 0.08,
+                doubleClickAccidental: 0.05,
+                typoRate: 0.06,
+                backtrackRate: 0.1,
+            },
+            mouse: {
+                curvature: 0.3,
+                jitter: 5,
+                overshoot: 0.1,
+                speed: "fast",
+            },
+            attention: {
+                pattern: "skim",
+                scrollBehavior: "jump",
+                focusAreas: ["cta", "prices"],
+                distractionRate: 0.5,
+            },
+        },
+        context: {
+            viewport: [1280, 800],
+        },
+    },
+};
+/**
+ * Get a persona by name.
+ */
+function getPersona(name) {
+    return exports.BUILTIN_PERSONAS[name];
+}
+/**
+ * List all available persona names.
+ */
+function listPersonas() {
+    return Object.keys(exports.BUILTIN_PERSONAS);
+}
+//# sourceMappingURL=personas.js.map

package/dist/personas.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,195 @@
+/**
+ * CBrowser Type Definitions
+ */
+export interface TimingParams {
+    reactionTime: {
+        min: number;
+        max: number;
+    };
+    clickDelay: {
+        min: number;
+        max: number;
+    };
+    typeSpeed: {
+        min: number;
+        max: number;
+    };
+    readingSpeed: number;
+    scrollPauseTime: {
+        min: number;
+        max: number;
+    };
+}
+export interface ErrorParams {
+    misClickRate: number;
+    doubleClickAccidental: number;
+    typoRate: number;
+    backtrackRate: number;
+}
+export interface MouseParams {
+    curvature: number;
+    jitter: number;
+    overshoot: number;
+    speed: "slow" | "normal" | "fast";
+}
+export interface AttentionParams {
+    pattern: "f-pattern" | "z-pattern" | "skim" | "thorough";
+    scrollBehavior: "continuous" | "chunked" | "jump";
+    focusAreas: Array<"header" | "cta" | "images" | "prices" | "text">;
+    distractionRate: number;
+}
+export interface HumanBehaviorParams {
+    timing: TimingParams;
+    errors: ErrorParams;
+    mouse: MouseParams;
+    attention: AttentionParams;
+}
+export interface Persona {
+    name: string;
+    description: string;
+    demographics: {
+        age_range?: string;
+        tech_level?: "beginner" | "intermediate" | "expert";
+        device?: "desktop" | "mobile" | "tablet";
+    };
+    behaviors: Record<string, unknown>;
+    humanBehavior?: HumanBehaviorParams;
+    context?: {
+        viewport?: [number, number];
+    };
+}
+export interface SavedSession {
+    name: string;
+    created: string;
+    lastUsed: string;
+    domain: string;
+    url: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    cookies: Array<{
+        name: string;
+        value: string;
+        domain: string;
+        path: string;
+        expires: number;
+        httpOnly: boolean;
+        secure: boolean;
+        sameSite: "Strict" | "Lax" | "None";
+    }>;
+    localStorage: Record<string, string>;
+    sessionStorage: Record<string, string>;
+    testCredentials?: {
+        email: string;
+        password: string;
+        baseUrl: string;
+    };
+}
+export interface NavigationResult {
+    url: string;
+    title: string;
+    screenshot: string;
+    errors: string[];
+    warnings: string[];
+    loadTime: number;
+}
+export interface ClickResult {
+    success: boolean;
+    screenshot: string;
+    message: string;
+}
+export interface ExtractResult {
+    data: unknown;
+    screenshot: string;
+}
+export interface ConsoleEntry {
+    type: "log" | "info" | "warn" | "error" | "debug" | "trace";
+    text: string;
+    timestamp: string;
+    url?: string;
+    lineNumber?: number;
+}
+export interface JourneyStep {
+    action: string;
+    target?: string;
+    result: string;
+    screenshot?: string;
+    timestamp: string;
+}
+export interface JourneyResult {
+    persona: string;
+    goal: string;
+    steps: JourneyStep[];
+    success: boolean;
+    frictionPoints: string[];
+    totalTime: number;
+    consoleLogs: ConsoleEntry[];
+}
+export type ActionZone = "green" | "yellow" | "red" | "black";
+export interface AuditEntry {
+    timestamp: string;
+    action: string;
+    target?: string;
+    zone: ActionZone;
+    result: "success" | "failure" | "blocked";
+    screenshot?: string;
+    persona?: string;
+    duration?: number;
+}
+export interface StoredCredential {
+    site: string;
+    username: string;
+    password: string;
+    vaultPassphrase?: string;
+    pin?: string;
+    created: string;
+    lastUsed?: string;
+}
+export interface CleanupOptions {
+    dryRun?: boolean;
+    olderThan?: number;
+    keepScreenshots?: number;
+    keepJourneys?: number;
+    keepSessions?: number;
+    verbose?: boolean;
+}
+export interface CleanupResult {
+    deleted: number;
+    freedBytes: number;
+    details: {
+        screenshots: {
+            deleted: number;
+            freed: number;
+        };
+        journeys: {
+            deleted: number;
+            freed: number;
+        };
+        sessions: {
+            deleted: number;
+            freed: number;
+        };
+        audit: {
+            deleted: number;
+            freed: number;
+        };
+    };
+}
+export interface BrowserOptions {
+    headless?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeout?: number;
+    userAgent?: string;
+}
+export interface JourneyOptions {
+    persona: string;
+    startUrl: string;
+    goal: string;
+    maxSteps?: number;
+    timeout?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * CBrowser Type Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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