harnery 0.31.5 → 0.32.0

package/dist/lib/browser/session-control.d.ts

@@ -0,0 +1,112 @@
+import type { BrowserSessionInspection, BrowserSessionLocator, BrowserSessionScreenshot, BrowserSessionStatus, BrowserSessionTab } from "./client.js";
+export declare const BROWSER_SESSION_PROTOCOL_VERSION: 1;
+export declare const BROWSER_SESSION_MAX_FRAME_BYTES: number;
+export declare const BROWSER_SESSION_MAX_FILL_BYTES: number;
+export declare const BROWSER_SESSION_MAX_INSPECTION_TEXT_BYTES: number;
+export interface BrowserSessionDescriptor {
+    version: typeof BROWSER_SESSION_PROTOCOL_VERSION;
+    pid: number;
+    created_at: string;
+    transport: {
+        kind: "unix";
+        address: string;
+    } | {
+        kind: "pipe";
+        address: string;
+    };
+    token: string;
+}
+export type BrowserSessionRequest = BaseRequest<"status", Record<string, never>> | BaseRequest<"inspect", {
+    locator?: BrowserSessionLocator;
+}> | BaseRequest<"screenshot", {
+    out: string;
+}> | BaseRequest<"tabs", Record<string, never>> | BaseRequest<"select_tab", {
+    index: number;
+}> | BaseRequest<"open_tab", {
+    url: string;
+}> | BaseRequest<"close_tab", {
+    index: number;
+}> | BaseRequest<"goto", {
+    url: string;
+}> | BaseRequest<"reload", Record<string, never>> | BaseRequest<"click", {
+    locator: BrowserSessionLocator;
+}> | BaseRequest<"fill", {
+    locator: BrowserSessionLocator;
+    value: string;
+}> | BaseRequest<"press", {
+    key: string;
+}> | BaseRequest<"wait", {
+    locator: BrowserSessionLocator;
+}> | BaseRequest<"close", Record<string, never>>;
+interface BaseRequest<Action extends string, Args> {
+    version: typeof BROWSER_SESSION_PROTOCOL_VERSION;
+    id: string;
+    token: string;
+    action: Action;
+    args: Args;
+}
+export type BrowserSessionResult = BrowserSessionStatus | BrowserSessionInspection | BrowserSessionScreenshot | BrowserSessionTab[] | BrowserSessionTab | {
+    closing: true;
+} | {
+    revision: number;
+};
+export type BrowserSessionResponse = {
+    version: typeof BROWSER_SESSION_PROTOCOL_VERSION;
+    id: string;
+    ok: true;
+    result: BrowserSessionResult;
+} | {
+    version: typeof BROWSER_SESSION_PROTOCOL_VERSION;
+    id: string;
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export interface BrowserSessionTarget {
+    sessionStatus(): Promise<BrowserSessionStatus>;
+    sessionInspect(locator?: BrowserSessionLocator): Promise<BrowserSessionInspection>;
+    sessionScreenshot(out: string): Promise<BrowserSessionScreenshot>;
+    sessionTabs(): Promise<BrowserSessionTab[]>;
+    sessionSelectTab(index: number): Promise<BrowserSessionTab>;
+    sessionOpenTab(url: string): Promise<BrowserSessionTab>;
+    sessionCloseTab(index: number): Promise<BrowserSessionTab>;
+    sessionGoto(url: string): Promise<BrowserSessionTab>;
+    sessionReload(): Promise<BrowserSessionTab>;
+    sessionClick(locator: BrowserSessionLocator): Promise<{
+        revision: number;
+    }>;
+    sessionFill(locator: BrowserSessionLocator, value: string): Promise<{
+        revision: number;
+    }>;
+    sessionPress(key: string): Promise<{
+        revision: number;
+    }>;
+    sessionWait(locator: BrowserSessionLocator): Promise<{
+        revision: number;
+    }>;
+}
+export declare class BrowserSessionError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export interface BrowserSessionServer {
+    descriptorPath: string;
+    closeRequested: Promise<void>;
+    stopAccepting(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+interface StartOptions {
+    platform?: NodeJS.Platform;
+    actionTimeoutMs?: number;
+    shortActionTimeoutMs?: number;
+}
+export declare function browserSessionTransport(controlFile: string, platform?: NodeJS.Platform): BrowserSessionDescriptor["transport"];
+export declare function startBrowserSessionServer(controlFileInput: string, target: BrowserSessionTarget, options?: StartOptions): Promise<BrowserSessionServer>;
+export declare function readBrowserSessionDescriptor(controlFileInput: string, platform?: NodeJS.Platform): BrowserSessionDescriptor;
+export declare function sendBrowserSessionRequest(controlFile: string, action: BrowserSessionRequest["action"], args: Record<string, unknown>): Promise<BrowserSessionResult>;
+export declare function sendRequestToDescriptor(descriptor: BrowserSessionDescriptor, request: BrowserSessionRequest): Promise<BrowserSessionResponse>;
+export declare function parseBrowserSessionRequest(value: unknown): BrowserSessionRequest;
+export {};
+//# sourceMappingURL=session-control.d.ts.map

package/dist/lib/browser/session-control.d.ts.map

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