ysk-server-core 1.0.0

package/dist/host-browse/service.d.ts

@@ -0,0 +1,122 @@
+/**
+ * HostBrowseService — proxy (HTTP rewrite) + browser (Chromium) engines.
+ */
+import { BrowserEngine } from './browser-engine.js';
+import { HostBrowseSessionStore, type HostBrowseSession } from './session-store.js';
+import type { HostBrowseCapabilities, HostBrowseContentResult, HostBrowseEngine, HostBrowseFetchResult, HostBrowseMode, HostBrowseNavigateAction, HostBrowsePanelConfig, HostBrowsePolicy, HostBrowseSessionMeta } from './types.js';
+import { type BrowseUserLibrary } from './bookmarks.js';
+import type { HostExecutor } from '../host/executor.js';
+export type HostBrowseAuditFn = (event: {
+    action: string;
+    userId: string;
+    ok: boolean;
+    detail: Record<string, unknown>;
+}) => void;
+export declare class HostBrowseService {
+    readonly store: HostBrowseSessionStore;
+    readonly browser: BrowserEngine;
+    private readonly basePolicy;
+    private readonly getPanelConfig?;
+    private readonly getHost?;
+    private readonly getDataDir?;
+    private readonly getLibrary?;
+    private readonly setLibrary?;
+    constructor(policy?: HostBrowsePolicy, audit?: HostBrowseAuditFn, getPanelConfig?: () => HostBrowsePanelConfig | undefined, deps?: {
+        getHost?: () => HostExecutor;
+        getDataDir?: () => string;
+        getLibrary?: (userId: string) => BrowseUserLibrary;
+        setLibrary?: (userId: string, lib: BrowseUserLibrary) => void;
+    });
+    private audit?;
+    private libOf;
+    private saveLib;
+    getLibraryFor(userId: string): BrowseUserLibrary;
+    listDownloads(userId: string, sessionId: string): import("./downloads.js").BrowseDownloadPublic[];
+    listTabs(userId: string, sessionId: string): Promise<{
+        pageId: string;
+        url: string;
+        title: string;
+        active: boolean;
+    }[]>;
+    openTab(userId: string, sessionId: string, url?: string): Promise<{
+        pageId: string;
+        tabs: {
+            pageId: string;
+            url: string;
+            title: string;
+            active: boolean;
+        }[];
+    }>;
+    switchTab(userId: string, sessionId: string, pageId: string): Promise<{
+        pageId: string;
+        tabs: {
+            pageId: string;
+            url: string;
+            title: string;
+            active: boolean;
+        }[];
+        currentUrl: string | null;
+        title: string;
+    }>;
+    closeTab(userId: string, sessionId: string, pageId: string): Promise<{
+        activePageId: string | null;
+        tabs: {
+            pageId: string;
+            url: string;
+            title: string;
+            active: boolean;
+        }[];
+        currentUrl: string | null;
+    }>;
+    getDownloadFile(userId: string, sessionId: string, downloadId: string): import("./downloads.js").BrowseDownload;
+    setHomeUrl(userId: string, homeUrl: string): BrowseUserLibrary;
+    toggleBookmark(userId: string, input: {
+        url: string;
+        title?: string;
+    }): BrowseUserLibrary;
+    deleteBookmark(userId: string, id: string): BrowseUserLibrary;
+    heartbeat(userId: string, sessionId: string): void;
+    /** Kill browser + ephemeral user if heartbeat stale (call from timer). */
+    reapStaleSessions(maxIdleMs?: number): Promise<number>;
+    /** Persist multi-tab URL snapshot for resume-on-return. */
+    snapshotSession(userId: string, sessionId: string): void;
+    clearLastSnapshot(userId: string): BrowseUserLibrary;
+    teardownBrowserSession(userId: string, sessionId: string): Promise<void>;
+    /** Live policy: panel settings overlay env/base. */
+    effectivePolicy(): HostBrowsePolicy;
+    /** After panel settings change — drop Chrome process so path/sandbox re-apply. */
+    applyConfigChanged(): Promise<void>;
+    capabilities(): HostBrowseCapabilities;
+    resolveEngine(requested?: string | null): HostBrowseEngine;
+    createSession(userId: string, mode: HostBrowseMode, engine?: string | null): HostBrowseSessionMeta;
+    getSession(userId: string, sessionId: string): HostBrowseSessionMeta;
+    deleteSession(userId: string, sessionId: string): Promise<void>;
+    clearCookies(userId: string, sessionId: string): Promise<HostBrowseSessionMeta>;
+    abort(userId: string, sessionId: string): void;
+    contentPath(session: HostBrowseSession, absoluteUrl: string): string;
+    formPath(session: HostBrowseSession, absoluteUrl: string): string;
+    navigate(userId: string, sessionId: string, input: {
+        url?: string;
+        action?: HostBrowseNavigateAction;
+    }): Promise<HostBrowseFetchResult>;
+    /**
+     * Ensure Chromium session is open (ephemeral user + downloads dir when available).
+     * Shared by navigateBrowser and live ticket / WS paths.
+     */
+    ensureBrowserSession(userId: string, sessionId: string): Promise<void>;
+    private navigateBrowser;
+    private navigateProxy;
+    submit(userId: string, sessionId: string, input: {
+        url: string;
+        method?: string;
+        contentType?: string;
+        body?: string;
+    }): Promise<HostBrowseFetchResult>;
+    /** Form POST from iframe (contentToken auth). */
+    submitByToken(sessionId: string, contentToken: string, rawUrl: string, body: string, contentType: string): Promise<HostBrowseFetchResult>;
+    getContentByToken(sessionId: string, contentToken: string, rawUrl: string): Promise<HostBrowseContentResult>;
+    getContent(userId: string, sessionId: string, contentToken: string, rawUrl: string): Promise<HostBrowseContentResult>;
+    private requireSession;
+    private fetchThroughSession;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/host-browse/service.d.ts.map

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