1import type { BrowserSession } from "../browser/session";
2import type { CdpClient } from "../browser/cdp-client";
3import type { NetworkJournal } from "../browser/network-journal";
4import type { ExtractedDocument } from "../extract/document";
5import type { MediaDownloadRequest, MediaDownloadResult, MediaAsset } from "../media/types";
6import type { Logger } from "../utils/logger";
7 
8export interface AdapterInput {
9  url: URL;
10}
11 
12export type LoginState = "logged_in" | "logged_out" | "unknown";
13export type InteractionKind = "login" | "cloudflare" | "recaptcha" | "hcaptcha" | "captcha" | "challenge";
14 
15export interface AdapterLoginInfo {
16  provider: string;
17  state: LoginState;
18  required?: boolean;
19  username?: string;
20  reason?: string;
21}
22 
23export interface WaitForInteractionRequest {
24  type: "wait_for_interaction";
25  kind: InteractionKind;
26  provider: string;
27  prompt: string;
28  reason?: string;
29  timeoutMs?: number;
30  pollIntervalMs?: number;
31  requiresVisibleBrowser?: boolean;
32}
33 
34export type AdapterProcessResult =
35  | {
36      status: "ok";
37      document: ExtractedDocument;
38      media?: MediaAsset[];
39      login?: AdapterLoginInfo;
40    }
41  | {
42      status: "needs_interaction";
43      interaction: WaitForInteractionRequest;
44      login?: AdapterLoginInfo;
45    }
46  | {
47      status: "no_document";
48      login?: AdapterLoginInfo;
49    };
50 
51export interface AdapterContext {
52  input: AdapterInput;
53  browser: BrowserSession;
54  network: NetworkJournal;
55  cdp: CdpClient;
56  log: Logger;
57  outputFormat: "markdown" | "json";
58  timeoutMs: number;
59  interactive: boolean;
60  downloadMedia: boolean;
61}
62 
63export interface Adapter {
64  name: string;
65  match(input: AdapterInput): boolean;
66  checkLogin?(context: AdapterContext): Promise<AdapterLoginInfo>;
67  exportCookies?(context: AdapterContext, profileDir?: string): Promise<boolean>;
68  restoreCookies?(context: AdapterContext, profileDir?: string): Promise<boolean>;
69  downloadMedia?(request: MediaDownloadRequest): Promise<MediaDownloadResult>;
70  process(context: AdapterContext): Promise<AdapterProcessResult>;
71}
72 
73export type { MediaAsset };
74