@viyzhu/boss-cli-fork 0.6.8

package/README.md

@@ -0,0 +1,223 @@
+# boss-cli — Boss直聘自动化 CLI | 批量发消息 · 自动打招呼 · AI Agent 招聘工具
+
+[![npm version](https://img.shields.io/npm/v/@joohw/boss-cli)](https://www.npmjs.com/package/@joohw/boss-cli)
+[![npm downloads](https://img.shields.io/npm/dm/@joohw/boss-cli)](https://www.npmjs.com/package/@joohw/boss-cli)
+[![license](https://img.shields.io/github/license/joohw/boss-cli)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/joohw/boss-cli)](https://github.com/joohw/boss-cli)
+
+官网主页：[boss-cli.com](https://boss-cli.com)
+
+**boss-cli**（`@joohw/boss-cli`）是开源的 **Boss直聘自动化命令行工具**。基于 Puppeteer / CDP 协议驱动本机 Chrome，无需 Selenium，把 Boss直聘 B 端的核心 HR 操作搬进终端：**候选人列表**、**批量发消息**、**自动打招呼**、**在线简历预览**、**深度搜索**、**职位管理**。
+
+适合 HR 日常提效，也适合 Claude / GPT / Gemini 等 **AI Agent** 通过子进程调用，搭建全自动化招聘流水线。
+
+```bash
+npm install -g @joohw/boss-cli@latest
+boss login
+boss help
+```
+
+> 纯 CLI，不内置对话式 Agent。每条命令输出结构化纯文本，Agent 可直接解析并编排多步流程。
+
+---
+
+## 为什么选择 boss-cli？
+
+| 场景 | 命令 |
+| --- | --- |
+| Boss直聘批量发消息 | `boss send --text "..."` 配合脚本循环 |
+| Boss直聘自动打招呼 | `boss greet <姓名> [--job <岗位>]` |
+| Boss直聘候选人筛选 | `boss list` / `boss list --unread` |
+| Boss直聘脚本自动化 | 本机 Chrome + CDP，Cookie 本地存储 |
+| AI 招聘 Agent | 子进程调用，输出 Agent 友好 |
+| 数据隐私 | 不经过第三方服务器，数据在 `~/.boss-cli/` |
+
+---
+
+## 安装
+
+**要求**：Node.js ≥ 20，本机已安装 Chrome / Chromium。
+
+```bash
+npm install -g @joohw/boss-cli@latest
+boss help
+```
+
+### 安装本 fork（含尚未进入上游的修复）
+
+本仓库是 [`joohw/boss-cli`](https://github.com/joohw/boss-cli) 的 fork，包含风控页反弹熔断等
+上游尚未发布的修复，以 `@viyzhu/boss-cli-fork` 单独发布：
+
+```bash
+npm install -g @viyzhu/boss-cli-fork@latest
+boss version
+```
+
+两个包提供同名的 `boss` 命令，**不要同时装**；换装前先 `npm uninstall -g @joohw/boss-cli`。
+也可以直接装仓库 tarball（等价于 main 最新提交）：
+
+```bash
+npm install -g https://github.com/Viy1204/boss-cli/archive/refs/heads/main.tar.gz
+```
+
+> 别用 `npm i -g github:Viy1204/boss-cli`：npm 会把全局包链到 npm cache 里的临时 clone，
+> 缓存清理后 `boss` 直接 `Cannot find module`。
+
+如果你觉得 boss-cli 好用，欢迎给本仓库一个 Star；使用中遇到问题请提交 Issue，新功能或改进也欢迎提交 PR。
+
+> **macOS / Linux 权限问题**：系统 Node 默认全局前缀在 `/usr/local`，当前账户无写权限。建议先把全局前缀挪到用户目录（一次性配置）：
+>
+> ```bash
+> mkdir -p ~/.npm-global
+> npm config set prefix ~/.npm-global
+> echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc   # bash 用 ~/.bash_profile
+> source ~/.zshrc
+> ```
+>
+> 使用 `fnm` / `nvm` / `volta` 的用户可跳过此步。Windows 用户无需此步。
+
+---
+
+## 命令一览
+
+| 命令 | 说明 |
+| --- | --- |
+| `boss login` | 打开 Boss直聘登录页（扫码/验证后手动完成） |
+| `boss update` | 通过 npm 安装最新版 boss-cli |
+| `boss list [--unread]` | 读取聊天列表；`--unread` 仅未读 |
+| `boss chat <姓名> [--strict]` | 打开指定候选人会话 |
+| `boss chat [姓名] --index <序号> [--unread] [--strict]` | 按 `boss list` 输出序号打开会话；同名候选人建议用序号 |
+| `boss send [--text <内容>]` | 向当前会话发送消息 |
+| `boss action <操作>` | 索要简历 / 不合适 / 备注 / 交换微信等 |
+| `boss recommend [岗位关键字]` | 读取推荐候选人列表 |
+| `boss search [关键词]` | 常规搜索牛人列表 |
+| `boss greet <姓名> [--job <岗位>]` | 在当前推荐/深度搜索页对候选人打招呼（不会自动跳转） |
+| `boss preview <姓名>` | 在线简历预览（每日次数有限） |
+| `boss deep-search [岗位关键字] [--core <要求>] [--bonus <加分项>] [--clear-core] [--clear-bonus] [--match]` | 深度搜索表单状态；`--core` / `--bonus` 可重复，并按传入列表同步分组；`--clear-*` 清空分组；默认不输出候选列表，`--match` 输出最新 20 条 |
+| `boss positions` | 读取职位列表 |
+| `boss jd <名称>` | 抓取职位 JD 缓存到本地 |
+
+完整用法：`boss help`
+
+---
+
+## 快速上手
+
+```bash
+# 1. 登录
+boss login
+
+# 2. 查看未读候选人
+boss list --unread
+
+# 3. 打开会话并发送消息
+boss chat 张三
+boss send --text "您好，请问方便发一下简历吗？"
+
+# 同名或姓名定位失败时，按 list 序号打开；--unread 对应 list --unread 的序号
+boss chat --index 2 --unread
+boss chat 张三 --index 2 --unread --strict
+
+# 4. 先进入推荐页，再在当前页打招呼
+boss recommend 前端工程师
+boss greet 张三 --job 前端工程师
+
+# 5. 常规搜索牛人
+boss search "langgraph"
+
+# 6. 深度搜索：按传入列表同步分组条件，但不消耗匹配次数
+boss deep-search --core "AI产品经理" --core "做过 RAG 或 Agent 产品落地" --bonus "有 ToB 平台经验"
+
+# 只有明确添加 --match 才会点击「立即匹配」，会消耗今日匹配次数，并只输出最新 20 条
+boss deep-search --match
+```
+
+---
+
+## 与 AI Agent 集成
+
+boss-cli 每条命令输出纯文本，适合 LLM 通过子进程编排：
+
+```
+1. boss list --unread     → 获取未读候选人
+2. boss chat <姓名>       → 打开会话
+   同名时用 boss chat [姓名] --index <序号> [--unread]
+3. boss action resume     → 索要简历
+4. boss send -t "..."     → 发送消息
+5. boss recommend         → 读取推荐列表
+6. boss search <关键词>   → 读取常规搜索列表
+7. boss greet <姓名>      → 批量打招呼
+```
+
+详见 [AGENTS.md](./AGENTS.md)。
+
+---
+
+## 常见问题
+
+**boss-cli 是什么？**
+开源 Boss直聘自动化 CLI，用终端命令代替手动操作 Boss直聘网页，支持 AI Agent 编排。
+
+**和 Selenium / Playwright 有什么区别？**
+boss-cli 基于 CDP 连接本机 Chrome，复用已有登录态，针对 Boss直聘 B 端页面做了专用封装，开箱即用。
+
+**需要额外下载浏览器吗？**
+不需要。使用本机已安装的 Chrome / Chromium，通过 CDP 协议连接。
+
+**数据会上传到服务器吗？**
+不会。Cookie 和缓存仅存储在本地 `~/.boss-cli/`，CLI 不经过任何第三方服务器。
+
+**如何无头模式运行？**
+设置环境变量 `BOSS_BROWSER_HEADLESS=true`（默认 headful，便于扫码登录）。
+
+**如何自定义操作蒙层品牌？**
+设置环境变量 `BOSS_CLI_AGENT_BRAND=你的品牌名`。
+
+---
+
+## 数据目录
+
+| 路径 | 内容 |
+| --- | --- |
+| `~/.boss-cli/.cache/` | Cookie、浏览器用户数据 |
+| `~/.boss-cli/jd/` | `boss jd` 缓存的岗位描述 |
+
+---
+
+## 开发
+
+```bash
+npm run build   # 编译到 dist/
+npm run dev     # build + 交互模式
+```
+
+---
+
+## 发布
+
+仓库通过 GitHub Actions 自动发布，工作流文件是 `.github/workflows/tag-publish.yml`。
+
+发布新版本时，本地只需要更新 `package.json` 版本号、提交代码、创建并推送 `v*` tag：
+
+```bash
+git tag -a v0.6.0 -m "v0.6.0"
+git push origin main
+git push origin v0.6.0
+```
+
+tag 推送后，workflow 会自动安装依赖、构建、检查 npm 版本、发布 `@joohw/boss-cli`、更新 `latest` dist-tag，并创建或更新 GitHub Release。npm 发布依赖仓库 Secret `NPM_TOKEN`，本地不需要手动执行 `npm publish`。
+
+---
+
+## 许可
+
+[GPL-3.0](./LICENSE)
+
+---
+
+## 相关链接
+
+- 官网：[boss-cli.com](https://boss-cli.com)
+- npm：[@joohw/boss-cli](https://www.npmjs.com/package/@joohw/boss-cli)
+- GitHub：[joohw/boss-cli](https://github.com/joohw/boss-cli)
+- 问题反馈：[Issues](https://github.com/joohw/boss-cli/issues)

package/dist/browser/browser_session.d.ts

@@ -0,0 +1,27 @@
+import type { Browser, Page } from 'puppeteer-core';
+/**
+ * 在 {@link ensureBrowserSession} 之后返回当前已连接的 Browser；
+ * 用于工具内单次获取句柄，避免与异步 ensure 不同步的 `getBrowser()` 竞态。
+ */
+export declare function ensureAndGetBrowser(): Promise<Browser | null>;
+export declare function ensureBrowserSession(): Promise<void>;
+export declare function getBrowserRef(): Browser | null;
+export declare function getPageRef(): Page | null;
+/**
+ * 将当前会话的主操作页设为 `page`（须属于已连接的 `browserRef`）。
+ * 供“导航/打开页面”类流程在新建或选中标签后同步，便于其它工具通过 `getPageRef` 复用。
+ */
+export declare function setSessionPage(page: Page): void;
+/** 进程退出时断开 CDP，避免残留子进程 */
+export declare function disconnectBrowserSession(): Promise<void>;
+/**
+ * 仅断开与浏览器的 CDP 连接，但不主动关闭浏览器进程。
+ * 用于 `boss login` 这类“需要用户继续在浏览器里操作”的场景：
+ * CLI 可以立刻退出，而浏览器窗口仍保留给用户完成登录。
+ *
+ * 必须在 disconnect 后对 Chrome 子进程 `unref`，否则 Node 会因子进程仍存活而无法退出。
+ *
+ * 注意：**绝不调用 `browser.close()`**——历史上在 disconnect 抛错时误走 close 会导致退出 CLI 时浏览器被关掉。
+ */
+export declare function detachBrowserSession(): Promise<void>;
+//# sourceMappingURL=browser_session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser_session.d.ts","sourceRoot":"","sources":["../../src/browser/browser_session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAwHpD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAGnE;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAwC1D;AAED,wBAAgB,aAAa,IAAI,OAAO,GAAG,IAAI,CAE9C;AAED,wBAAgB,UAAU,IAAI,IAAI,GAAG,IAAI,CAIxC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAS/C;AAED,0BAA0B;AAC1B,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY9D;AAWD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB1D"}

package/dist/browser/browser_session.js

@@ -0,0 +1,246 @@
+import { clearSpawnedChromeProcessRef, connectBrowser } from './cdp_browser.js';
+import { installBossBrowserPageGuards, installBossPageGuards } from '../common/boss_page_guards.js';
+let browserRef = null;
+let pageRef = null;
+let connectPromise = null;
+function attachDisconnectedHandler(b) {
+    b.once('disconnected', () => {
+        if (browserRef === b) {
+            browserRef = null;
+            pageRef = null;
+            console.error('[boss-cli] 与浏览器断开连接（窗口关闭或进程退出）；下次使用工具时会自动重连。');
+        }
+    });
+}
+/**
+ * 选一个「主」标签：避免始终把 `pages()[0]` 当主页——用户常在第二个及以后的 Boss 标签上操作，
+ * 而第一个是 `about:blank` 或残留空页时，错误地读到 blank 会让登录/页面检查类操作误判。
+ */
+async function pickOrCreatePage(b) {
+    const pages = (await b.pages()).filter((p) => !p.isClosed());
+    if (pages.length === 0) {
+        return b.newPage();
+    }
+    const urls = await Promise.all(pages.map((p) => {
+        try {
+            return p.url();
+        }
+        catch {
+            return '';
+        }
+    }));
+    const zhipin = pages.find((p, i) => {
+        const u = urls[i] ?? '';
+        return u.length > 0 && u !== 'about:blank' && u.includes('zhipin.com');
+    });
+    if (zhipin) {
+        return zhipin;
+    }
+    const nonBlank = pages.find((p, i) => {
+        const u = urls[i] ?? '';
+        return u.length > 0 && u !== 'about:blank';
+    });
+    if (nonBlank) {
+        return nonBlank;
+    }
+    return pages[0];
+}
+async function closeRedundantBlankPages(b, keep) {
+    const pages = (await b.pages()).filter((p) => !p.isClosed());
+    if (pages.length <= 1)
+        return;
+    const urls = await Promise.all(pages.map((p) => {
+        try {
+            return p.url();
+        }
+        catch {
+            return '';
+        }
+    }));
+    const blankPages = pages.filter((_, i) => {
+        const u = urls[i] ?? '';
+        return u === '' || u === 'about:blank';
+    });
+    if (blankPages.length === 0)
+        return;
+    const hasNonBlank = pages.some((_, i) => {
+        const u = urls[i] ?? '';
+        return u !== '' && u !== 'about:blank';
+    });
+    for (const p of blankPages) {
+        if (p === keep)
+            continue;
+        if (!hasNonBlank && p === blankPages[0])
+            continue;
+        try {
+            await p.close({ runBeforeUnload: false });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+function isSessionHealthy() {
+    return !!(browserRef?.connected && pageRef && !pageRef.isClosed());
+}
+async function establishSession() {
+    const prev = browserRef;
+    if (prev) {
+        try {
+            prev.removeAllListeners('disconnected');
+            await prev.close();
+        }
+        catch {
+            /* 已断开时忽略 */
+        }
+        browserRef = null;
+        pageRef = null;
+    }
+    const b = await connectBrowser();
+    browserRef = b;
+    attachDisconnectedHandler(b);
+    await installBossBrowserPageGuards(b);
+    pageRef = await pickOrCreatePage(b);
+    await installBossPageGuards(pageRef);
+    await closeRedundantBlankPages(b, pageRef);
+}
+/**
+ * 在 {@link ensureBrowserSession} 之后返回当前已连接的 Browser；
+ * 用于工具内单次获取句柄，避免与异步 ensure 不同步的 `getBrowser()` 竞态。
+ */
+export async function ensureAndGetBrowser() {
+    await ensureBrowserSession();
+    return getBrowserRef();
+}
+export async function ensureBrowserSession() {
+    if (browserRef?.connected) {
+        await installBossBrowserPageGuards(browserRef);
+        if (pageRef && !pageRef.isClosed()) {
+            try {
+                const u = pageRef.url();
+                if (u === 'about:blank' || u === '') {
+                    const preferred = await pickOrCreatePage(browserRef);
+                    if (preferred !== pageRef && !(preferred.url() === 'about:blank')) {
+                        pageRef = preferred;
+                    }
+                }
+                await closeRedundantBlankPages(browserRef, pageRef);
+            }
+            catch {
+                /* ignore */
+            }
+            await installBossPageGuards(pageRef);
+            return;
+        }
+        pageRef = await pickOrCreatePage(browserRef);
+        await installBossPageGuards(pageRef);
+        await closeRedundantBlankPages(browserRef, pageRef);
+        return;
+    }
+    if (connectPromise) {
+        await connectPromise;
+        return;
+    }
+    connectPromise = (async () => {
+        if (isSessionHealthy())
+            return;
+        await establishSession();
+    })();
+    try {
+        await connectPromise;
+    }
+    finally {
+        connectPromise = null;
+    }
+}
+export function getBrowserRef() {
+    return browserRef?.connected ? browserRef : null;
+}
+export function getPageRef() {
+    if (!pageRef || pageRef.isClosed())
+        return null;
+    if (!browserRef?.connected)
+        return null;
+    return pageRef;
+}
+/**
+ * 将当前会话的主操作页设为 `page`（须属于已连接的 `browserRef`）。
+ * 供“导航/打开页面”类流程在新建或选中标签后同步，便于其它工具通过 `getPageRef` 复用。
+ */
+export function setSessionPage(page) {
+    if (!browserRef?.connected)
+        return;
+    try {
+        if (page.browser() !== browserRef)
+            return;
+    }
+    catch {
+        return;
+    }
+    if (page.isClosed())
+        return;
+    pageRef = page;
+}
+/** 进程退出时断开 CDP，避免残留子进程 */
+export async function disconnectBrowserSession() {
+    const b = browserRef;
+    if (!b)
+        return;
+    try {
+        b.removeAllListeners('disconnected');
+        await b.close();
+    }
+    catch {
+        /* ignore */
+    }
+    browserRef = null;
+    pageRef = null;
+    clearSpawnedChromeProcessRef();
+}
+function unrefBrowserChildProcess(proc) {
+    if (!proc)
+        return;
+    try {
+        proc.unref();
+    }
+    catch {
+        /* ignore */
+    }
+}
+/**
+ * 仅断开与浏览器的 CDP 连接，但不主动关闭浏览器进程。
+ * 用于 `boss login` 这类“需要用户继续在浏览器里操作”的场景：
+ * CLI 可以立刻退出，而浏览器窗口仍保留给用户完成登录。
+ *
+ * 必须在 disconnect 后对 Chrome 子进程 `unref`，否则 Node 会因子进程仍存活而无法退出。
+ *
+ * 注意：**绝不调用 `browser.close()`**——历史上在 disconnect 抛错时误走 close 会导致退出 CLI 时浏览器被关掉。
+ */
+export async function detachBrowserSession() {
+    const b = browserRef;
+    if (!b)
+        return;
+    let proc;
+    try {
+        proc = typeof b.process === 'function' ? b.process() : undefined;
+    }
+    catch {
+        proc = undefined;
+    }
+    try {
+        b.removeAllListeners('disconnected');
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const anyB = b;
+        if (typeof anyB.disconnect === 'function') {
+            await Promise.resolve(anyB.disconnect());
+        }
+    }
+    catch {
+        /* 仍不 close；仅断开失败时依赖下方 unref 与进程退出行为 */
+    }
+    unrefBrowserChildProcess(proc ?? null);
+    clearSpawnedChromeProcessRef();
+    browserRef = null;
+    pageRef = null;
+}
+//# sourceMappingURL=browser_session.js.map

package/dist/browser/browser_session.js.map

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

package/dist/browser/cdp_browser.d.ts

@@ -0,0 +1,50 @@
+import { type Browser, type CDPSession, type Page } from 'puppeteer-core';
+/**
+ * 固定的远程调试端口：boss-cli 使用独立的 user-data-dir，因此可以稳定占用一个端口，
+ * 让多个命令直接通过 `http://127.0.0.1:<port>/json/version` 复用同一只浏览器。
+ * 可用 `BOSS_BROWSER_REMOTE_DEBUGGING_PORT` 覆盖。
+ */
+export declare const REMOTE_DEBUGGING_PORT: number;
+export declare function clearSpawnedChromeProcessRef(): void;
+/** 最近一次启动是否为无头（仅本进程内、与当前会话一致时有效）。 */
+export declare function wasLastChromeLaunchHeadless(): boolean;
+/** 减轻「正受到自动测试软件的控制」提示与常见自动化特征（非万能，站点仍可能用其它方式检测）。手动开 Chrome 并接 CDP 时可复用。 */
+export declare const LAUNCH_ARGS_LESS_AUTOMATION: readonly ["--disable-infobars"];
+/** 仅用于本地调试：尽量放宽同源/CORS 限制，便于跨域 iframe/canvas 处理。 */
+export declare const LAUNCH_ARGS_ALLOW_ALL_CORS: readonly ["--disable-web-security", "--allow-running-insecure-content"];
+export type ConnectBrowserOptions = {
+    /** 用于启动本机 Chrome/Edge */
+    executablePath?: string;
+    /** 启动浏览器时复用的用户数据目录（登录态/缓存等） */
+    userDataDir?: string;
+    /** 启动浏览器时指定 profile（如 `Default` / `Profile 1`） */
+    profileDirectory?: string;
+    /** 默认 `false`（有界面）。也可用环境变量 `BOSS_BROWSER_HEADLESS=true` 开无头。 */
+    headless?: boolean;
+    /** 仅本地调试用：放宽同源/CORS 策略（高风险，默认关闭）。 */
+    allowAllCors?: boolean;
+};
+/**
+ * 启动本机浏览器（puppeteer-core 底层为 Chrome DevTools Protocol）。
+ *
+ * 环境变量（可选）：
+ * - `CHROME_PATH` / `PUPPETEER_EXECUTABLE_PATH` — 启动本机浏览器可执行文件路径（高于自动探测）
+ * - `BOSS_BROWSER_USER_DATA_DIR` — 启动浏览器时复用的用户数据目录；未设置时默认 `~/.boss-cli/.cache/browser-data`
+ * - `BOSS_BROWSER_PROFILE_DIRECTORY` — 启动浏览器时指定 profile（如 `Default`）
+ * - `BOSS_BROWSER_REMOTE_DEBUGGING_PORT` — 远程调试端口（默认 53470）；同一 user-data-dir 跨命令复用该端口
+ * - `BOSS_BROWSER_ALLOW_ALL_CORS` — 设为 `true` 时附加放宽同源/CORS 的启动参数（仅调试）
+ * - `BOSS_BROWSER_DISABLE_GPU` — 设为 `true` 时附加 `--disable-gpu`
+ *
+ * 若以上均未设置，会按系统尝试常见 Chrome / Edge / Chromium 安装路径。
+ * - `BOSS_BROWSER_HEADLESS` — 设为 `true` 时启用无头；默认**有界面**。
+ * - `BOSS_BROWSER_VIEWPORT_WIDTH` / `BOSS_BROWSER_VIEWPORT_HEIGHT` — 启动时显式指定视口；未设置时不覆盖浏览器窗口尺寸
+ */
+/** 启动浏览器时的默认视口（与环境变量一致）；截图恢复时 `viewport()` 为 null 也可用其兜底。 */
+export declare function defaultViewportFromEnv(): {
+    width: number;
+    height: number;
+};
+export declare function connectBrowser(options?: ConnectBrowserOptions): Promise<Browser>;
+/** 对某一页创建原生 CDP Session（需要低层域如 `Network.*`、`Fetch.*` 时使用）。 */
+export declare function createPageCDPSession(page: Page): Promise<CDPSession>;
+//# sourceMappingURL=cdp_browser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cdp_browser.d.ts","sourceRoot":"","sources":["../../src/browser/cdp_browser.ts"],"names":[],"mappings":"AAIA,OAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAQrF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAOhC,CAAC;AAML,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAED,qCAAqC;AACrC,wBAAgB,2BAA2B,IAAI,OAAO,CAErD;AAwJD,2EAA2E;AAC3E,eAAO,MAAM,2BAA2B,iCAE9B,CAAC;AAEX,oDAAoD;AACpD,eAAO,MAAM,0BAA0B,yEAG7B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG;IAClC,yBAAyB;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,6DAA6D;AAC7D,wBAAgB,sBAAsB,IAAI;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAO1E;AAYD,wBAAsB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,OAAO,CAAC,CA2H1F;AAED,8DAA8D;AAC9D,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAE1E"}