camofox-browser 1.0.0

package/dist/src/services/session.js

@@ -0,0 +1,204 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_TABS_PER_SESSION = exports.MAX_SESSIONS = exports.SESSION_TIMEOUT_MS = void 0;
+exports.normalizeUserId = normalizeUserId;
+exports.getSessionMapKey = getSessionMapKey;
+exports.getSessionsForUser = getSessionsForUser;
+exports.getAllSessions = getAllSessions;
+exports.countTotalTabsForSessions = countTotalTabsForSessions;
+exports.getTabGroup = getTabGroup;
+exports.unindexSessionTabs = unindexSessionTabs;
+exports.findTabById = findTabById;
+exports.getSession = getSession;
+exports.indexTab = indexTab;
+exports.unindexTab = unindexTab;
+exports.clearAllState = clearAllState;
+exports.closeSessionsForUser = closeSessionsForUser;
+exports.closeAllSessions = closeAllSessions;
+exports.startCleanupInterval = startCleanupInterval;
+exports.stopCleanupInterval = stopCleanupInterval;
+const presets_1 = require("../utils/presets");
+const logging_1 = require("../middleware/logging");
+const browser_1 = require("./browser");
+const tab_1 = require("./tab");
+const config_1 = require("../utils/config");
+const CONFIG = (0, config_1.loadConfig)();
+// userId -> { context, tabGroups: Map<sessionKey, Map<tabId, TabState>>, lastAccess }
+// Note: sessionKey was previously called listItemId - both are accepted for backward compatibility
+const sessions = new Map();
+// tabId -> sessions map key
+// Sessions may be keyed by composite `${userId}:${contextHash}`, while tab endpoints only get tabId.
+const tabSessionIndex = new Map();
+exports.SESSION_TIMEOUT_MS = Math.max(60000, Number.parseInt(process.env.CAMOFOX_SESSION_TIMEOUT || '', 10) || 1800000);
+exports.MAX_SESSIONS = Math.max(1, Number.parseInt(process.env.CAMOFOX_MAX_SESSIONS || '', 10) || 50);
+exports.MAX_TABS_PER_SESSION = Math.max(1, Number.parseInt(process.env.CAMOFOX_MAX_TABS || '', 10) || 10);
+function normalizeUserId(userId) {
+    return String(userId);
+}
+function getSessionMapKey(userId, contextOverrides) {
+    return normalizeUserId(userId) + (0, presets_1.contextHash)(contextOverrides ?? null);
+}
+function getSessionsForUser(userId) {
+    if (userId === undefined || userId === null)
+        return [];
+    const prefix = normalizeUserId(userId);
+    const out = [];
+    for (const [key, session] of sessions) {
+        if (key === prefix || key.startsWith(prefix + ':'))
+            out.push([key, session]);
+    }
+    return out;
+}
+function getAllSessions() {
+    return sessions;
+}
+function countTotalTabsForSessions(sessionsForUser) {
+    let totalTabs = 0;
+    const iter = sessionsForUser ?? Array.from(sessions.entries());
+    for (const [, session] of iter) {
+        for (const group of session.tabGroups.values())
+            totalTabs += group.size;
+    }
+    return totalTabs;
+}
+function getTabGroup(session, sessionKey) {
+    let group = session.tabGroups.get(sessionKey);
+    if (!group) {
+        group = new Map();
+        session.tabGroups.set(sessionKey, group);
+    }
+    return group;
+}
+function findTab(session, tabId) {
+    for (const [listItemId, group] of session.tabGroups) {
+        if (group.has(tabId)) {
+            const tabState = group.get(tabId);
+            if (!tabState)
+                continue;
+            return { tabState, listItemId, group };
+        }
+    }
+    return null;
+}
+function unindexSessionTabs(session) {
+    if (!session)
+        return;
+    for (const [, group] of session.tabGroups) {
+        for (const tabId of group.keys()) {
+            tabSessionIndex.delete(tabId);
+            (0, tab_1.clearTabLock)(tabId);
+        }
+    }
+}
+function findTabById(tabId, userId) {
+    if (userId === undefined || userId === null)
+        return null;
+    const prefix = normalizeUserId(userId);
+    const indexedKey = tabSessionIndex.get(tabId);
+    if (indexedKey) {
+        if (!(indexedKey === prefix || indexedKey.startsWith(prefix + ':'))) {
+            return null;
+        }
+        const session = sessions.get(indexedKey);
+        if (session) {
+            const found = findTab(session, tabId);
+            if (found)
+                return { sessionKey: indexedKey, session, ...found };
+        }
+        tabSessionIndex.delete(tabId);
+    }
+    for (const [sessionKey, session] of sessions) {
+        if (!(sessionKey === prefix || sessionKey.startsWith(prefix + ':')))
+            continue;
+        const found = findTab(session, tabId);
+        if (found) {
+            tabSessionIndex.set(tabId, sessionKey);
+            return { sessionKey, session, ...found };
+        }
+    }
+    return null;
+}
+async function getSession(userId, contextOverrides) {
+    const key = getSessionMapKey(userId, contextOverrides);
+    let session = sessions.get(key);
+    if (!session) {
+        if (sessions.size >= exports.MAX_SESSIONS) {
+            throw new Error('Maximum concurrent sessions reached');
+        }
+        const b = await (0, browser_1.ensureBrowser)();
+        const resolved = contextOverrides || {};
+        const contextOptions = {
+            viewport: resolved.viewport || { width: 1280, height: 720 },
+            permissions: ['geolocation'],
+        };
+        const hasOverrides = !!(contextOverrides &&
+            (contextOverrides.locale !== undefined || contextOverrides.timezoneId !== undefined || contextOverrides.geolocation !== undefined));
+        // With proxy+geoip, camoufox auto-configures locale/timezone/geo from proxy IP.
+        // If caller explicitly supplies overrides, apply them even when proxy is active.
+        if (!CONFIG.proxy.host || hasOverrides) {
+            contextOptions.locale = resolved.locale || 'en-US';
+            contextOptions.timezoneId = resolved.timezoneId || 'America/Los_Angeles';
+            contextOptions.geolocation = resolved.geolocation || { latitude: 37.7749, longitude: -122.4194 };
+        }
+        const context = await b.newContext(contextOptions);
+        session = { context, tabGroups: new Map(), lastAccess: Date.now() };
+        sessions.set(key, session);
+        (0, logging_1.log)('info', 'session created', { userId: key });
+    }
+    session.lastAccess = Date.now();
+    return session;
+}
+function indexTab(tabId, sessionKey) {
+    tabSessionIndex.set(tabId, sessionKey);
+}
+function unindexTab(tabId) {
+    tabSessionIndex.delete(tabId);
+    (0, tab_1.clearTabLock)(tabId);
+}
+function clearAllState() {
+    sessions.clear();
+    tabSessionIndex.clear();
+    (0, tab_1.clearAllTabLocks)();
+}
+async function closeSessionsForUser(userId) {
+    const prefix = userId;
+    for (const [key, session] of sessions) {
+        if (key === prefix || key.startsWith(prefix + ':')) {
+            await session.context.close().catch(() => { });
+            unindexSessionTabs(session);
+            sessions.delete(key);
+            (0, logging_1.log)('info', 'session closed', { userId: key });
+        }
+    }
+}
+async function closeAllSessions() {
+    for (const [userId, session] of sessions) {
+        await session.context.close().catch(() => { });
+        unindexSessionTabs(session);
+        sessions.delete(userId);
+    }
+}
+let cleanupInterval = null;
+function startCleanupInterval() {
+    if (cleanupInterval)
+        return cleanupInterval;
+    cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [sessionKey, session] of sessions) {
+            if (now - session.lastAccess > exports.SESSION_TIMEOUT_MS) {
+                session.context.close().catch(() => { });
+                unindexSessionTabs(session);
+                sessions.delete(sessionKey);
+                (0, logging_1.log)('info', 'session expired', { userId: sessionKey });
+            }
+        }
+    }, 60_000);
+    return cleanupInterval;
+}
+function stopCleanupInterval() {
+    if (cleanupInterval) {
+        clearInterval(cleanupInterval);
+        cleanupInterval = null;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/src/services/session.js.map

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

package/dist/src/services/tab.d.ts

@@ -0,0 +1,85 @@
+import type { Locator, Page } from 'playwright-core';
+import type { RefInfo, TabState, WaitForPageReadyOptions } from '../types';
+export declare function withTabLock<T>(tabId: string, operation: () => Promise<T>): Promise<T>;
+export declare function clearTabLock(tabId: string): void;
+export declare function clearAllTabLocks(): void;
+export declare function validateUrl(url: string): string | null;
+export declare function annotateAriaYamlWithRefs(ariaYaml: string | null, refs: Map<string, RefInfo>): string;
+export declare function waitForPageReady(page: Page, options?: WaitForPageReadyOptions): Promise<boolean>;
+export declare function dismissConsentDialogs(page: Page): Promise<void>;
+export declare function buildRefs(page: Page): Promise<Map<string, RefInfo>>;
+export declare function getAriaSnapshot(page: Page): Promise<string | null>;
+export declare function refToLocator(page: Page, ref: string, refs: Map<string, RefInfo>): Locator | null;
+export declare function createTabState(page: Page): TabState;
+export declare function navigateTab(tabId: string, tabState: TabState, params: {
+    url?: string;
+    macro?: string;
+    query?: string;
+}): Promise<{
+    ok: true;
+    url: string;
+}>;
+export declare function snapshotTab(tabState: TabState): Promise<{
+    url: string;
+    snapshot: string;
+    refsCount: number;
+}>;
+export declare function clickTab(tabId: string, tabState: TabState, params: {
+    ref?: string;
+    selector?: string;
+}): Promise<{
+    ok: true;
+    url: string;
+}>;
+export declare function typeTab(tabId: string, tabState: TabState, params: {
+    ref?: string;
+    selector?: string;
+    text: string;
+}): Promise<{
+    ok: true;
+}>;
+export declare function pressTab(tabId: string, tabState: TabState, key: string): Promise<{
+    ok: true;
+}>;
+export declare function scrollTab(tabState: TabState, params: {
+    direction?: 'up' | 'down';
+    amount?: number;
+}): Promise<{
+    ok: true;
+}>;
+export declare function backTab(tabId: string, tabState: TabState): Promise<{
+    ok: true;
+    url: string;
+}>;
+export declare function forwardTab(tabId: string, tabState: TabState): Promise<{
+    ok: true;
+    url: string;
+}>;
+export declare function refreshTab(tabId: string, tabState: TabState): Promise<{
+    ok: true;
+    url: string;
+}>;
+export declare function getLinks(tabState: TabState, params: {
+    limit: number;
+    offset: number;
+}): Promise<{
+    links: Array<{
+        url: string;
+        text: string;
+    }>;
+    pagination: {
+        total: number;
+        offset: number;
+        limit: number;
+        hasMore: boolean;
+    };
+}>;
+export declare function screenshotTab(tabState: TabState, fullPage: boolean): Promise<Buffer>;
+export declare function waitTab(tabState: TabState, params: {
+    timeout: number;
+    waitForNetwork: boolean;
+}): Promise<{
+    ok: true;
+    ready: boolean;
+}>;
+//# sourceMappingURL=tab.d.ts.map

package/dist/src/services/tab.d.ts.map

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