erosolar-cli 1.5.14 → 1.6.0

package/dist/browser/BrowserSessionManager.d.ts

@@ -0,0 +1,307 @@
+/**
+ * Browser Session Manager - Manages browser instances, sessions, cookies, and authentication
+ *
+ * Provides browser-use-like functionality for AI agents:
+ * - Persistent browser sessions with cookie management
+ * - Authentication state persistence
+ * - Multi-profile support
+ * - Session recovery and cleanup
+ *
+ * @license MIT
+ * @author Bo Shang
+ */
+import { Browser, BrowserContext, Page } from 'playwright';
+export interface SessionConfig {
+    /** Session identifier */
+    sessionId: string;
+    /** Browser type to use */
+    browserType?: 'chromium' | 'firefox' | 'webkit';
+    /** Run in headless mode */
+    headless?: boolean;
+    /** User agent string */
+    userAgent?: string;
+    /** Viewport size */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Load existing profile */
+    profilePath?: string;
+    /** Enable stealth mode (anti-detection) */
+    stealthMode?: boolean;
+    /** Proxy configuration */
+    proxy?: {
+        server: string;
+        username?: string;
+        password?: string;
+    };
+    /** Session timeout in milliseconds */
+    timeout?: number;
+}
+export interface AuthConfig {
+    /** Authentication type */
+    type: 'basic' | 'form' | 'oauth' | 'cookie' | 'token';
+    /** Credentials */
+    credentials?: {
+        username?: string;
+        password?: string;
+        token?: string;
+    };
+    /** Form selectors for form-based auth */
+    formSelectors?: {
+        usernameField: string;
+        passwordField: string;
+        submitButton: string;
+    };
+    /** Login URL */
+    loginUrl?: string;
+    /** URL to verify successful login */
+    successUrl?: string;
+    /** Selector that indicates successful login */
+    successSelector?: string;
+}
+export interface SessionState {
+    sessionId: string;
+    browserType: string;
+    isActive: boolean;
+    createdAt: number;
+    lastAccessedAt: number;
+    currentUrl?: string;
+    isAuthenticated: boolean;
+    authDomain?: string;
+    cookies: SerializedCookie[];
+    localStorage?: Record<string, string>;
+}
+interface SerializedCookie {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    expires?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'Strict' | 'Lax' | 'None';
+}
+interface ActiveSession {
+    config: SessionConfig;
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    state: SessionState;
+}
+/**
+ * Browser Session Manager
+ * Manages browser instances, sessions, and authentication state
+ */
+export declare class BrowserSessionManager {
+    private sessions;
+    private storageDir;
+    constructor(storageDir?: string);
+    private ensureStorageDir;
+    /**
+     * Create a new browser session
+     */
+    createSession(config: SessionConfig): Promise<string>;
+    /**
+     * Apply stealth scripts to avoid bot detection
+     */
+    private applyStealthScripts;
+    /**
+     * Get an active session
+     */
+    getSession(sessionId: string): ActiveSession | undefined;
+    /**
+     * Get the page for a session
+     */
+    getPage(sessionId: string): Page | undefined;
+    /**
+     * Navigate to a URL
+     */
+    navigateTo(sessionId: string, url: string, options?: {
+        waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+    }): Promise<{
+        success: boolean;
+        url: string;
+        title: string;
+        error?: string;
+    }>;
+    /**
+     * Perform authentication
+     */
+    authenticate(sessionId: string, authConfig: AuthConfig): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Perform form-based authentication
+     */
+    private performFormAuth;
+    /**
+     * Perform basic HTTP authentication
+     */
+    private performBasicAuth;
+    /**
+     * Perform cookie-based authentication
+     */
+    private performCookieAuth;
+    /**
+     * Perform token-based authentication
+     */
+    private performTokenAuth;
+    /**
+     * Save cookies for a session
+     */
+    saveCookies(session: ActiveSession): Promise<void>;
+    /**
+     * Save session state to disk
+     */
+    private saveSessionState;
+    /**
+     * Load session state from disk
+     */
+    private loadSessionState;
+    /**
+     * Take a screenshot
+     */
+    takeScreenshot(sessionId: string, options?: {
+        fullPage?: boolean;
+        path?: string;
+    }): Promise<{
+        success: boolean;
+        data?: string;
+        path?: string;
+        error?: string;
+    }>;
+    /**
+     * Click on an element
+     */
+    click(sessionId: string, selector: string, options?: {
+        timeout?: number;
+        force?: boolean;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Type text into an element
+     */
+    type(sessionId: string, selector: string, text: string, options?: {
+        delay?: number;
+        clear?: boolean;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Fill an input field (faster than type)
+     */
+    fill(sessionId: string, selector: string, value: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get text content of an element
+     */
+    getText(sessionId: string, selector: string): Promise<{
+        success: boolean;
+        text?: string;
+        error?: string;
+    }>;
+    /**
+     * Get page HTML content
+     */
+    getPageContent(sessionId: string): Promise<{
+        success: boolean;
+        html?: string;
+        error?: string;
+    }>;
+    /**
+     * Wait for a selector to appear
+     */
+    waitForSelector(sessionId: string, selector: string, options?: {
+        timeout?: number;
+        state?: 'attached' | 'visible' | 'hidden';
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Execute JavaScript in the page context
+     */
+    executeScript<T>(sessionId: string, script: string, args?: any[]): Promise<{
+        success: boolean;
+        result?: T;
+        error?: string;
+    }>;
+    /**
+     * Select an option from a dropdown
+     */
+    selectOption(sessionId: string, selector: string, value: string | string[]): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Check/uncheck a checkbox
+     */
+    setChecked(sessionId: string, selector: string, checked: boolean): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Upload a file
+     */
+    uploadFile(sessionId: string, selector: string, filePath: string | string[]): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get all cookies for the session
+     */
+    getCookies(sessionId: string, urls?: string[]): Promise<{
+        success: boolean;
+        cookies?: SerializedCookie[];
+        error?: string;
+    }>;
+    /**
+     * Add cookies to the session
+     */
+    addCookies(sessionId: string, cookies: SerializedCookie[]): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Clear cookies for the session
+     */
+    clearCookies(sessionId: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Close a session
+     */
+    closeSession(sessionId: string, saveCookies?: boolean): Promise<void>;
+    /**
+     * Close all sessions
+     */
+    closeAllSessions(): Promise<void>;
+    /**
+     * List all stored sessions
+     */
+    listStoredSessions(): string[];
+    /**
+     * Delete stored session data
+     */
+    deleteStoredSession(sessionId: string): boolean;
+    /**
+     * Get session info
+     */
+    getSessionInfo(sessionId: string): SessionState | null;
+    /**
+     * Check if session is authenticated
+     */
+    isAuthenticated(sessionId: string): boolean;
+}
+export declare function getDefaultBrowserSessionManager(): BrowserSessionManager;
+export declare function createBrowserSessionManager(storageDir?: string): BrowserSessionManager;
+export {};
+//# sourceMappingURL=BrowserSessionManager.d.ts.map

package/dist/browser/BrowserSessionManager.d.ts.map

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