polite-crawler 0.1.1 → 0.1.2

package/build/browser-CKRNbIDT.mjs

@@ -0,0 +1,62 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
+import { n as RenderRefused, t as NO_PLAYWRIGHT } from "./render-C1CUraWF.mjs";
+import { basename, dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+//#region src/browser.ts
+var browser_exports = /* @__PURE__ */ __exportAll({
+	NO_BROWSER: () => NO_BROWSER,
+	browserMissing: () => browserMissing,
+	checkedRenderer: () => checkedRenderer
+});
+/** The text of the note when `playwright-core` is installed, but its browser is not. */
+const NO_BROWSER = "rendering needs a browser: npx playwright-core install chromium-headless-shell";
+/**
+* This function tells if the default renderer can start a browser. It gives no value when it can,
+* and the reason when it cannot. The command line and the MCP server use it one time at start.
+* Then a missing browser costs no wait and no error capture for each page that needs JavaScript.
+*
+* The check does not start the browser. It finds the full Chromium build or the headless shell of
+* the same revision on the disk. When the check cannot find the answer, it gives no value, and the
+* renderer then tries.
+*/
+const browserMissing = async (load = () => import("playwright-core")) => {
+	let chromium;
+	try {
+		({chromium} = await load());
+	} catch {
+		return NO_PLAYWRIGHT;
+	}
+	try {
+		const executable = chromium.executablePath();
+		if (existsSync(executable)) return void 0;
+		let folder = dirname(executable);
+		while (dirname(folder) !== folder && !/^chromium-\d+$/.test(basename(folder))) folder = dirname(folder);
+		const revision = /^chromium-(\d+)$/.exec(basename(folder))?.[1];
+		if (revision === void 0) return void 0;
+		return existsSync(join(dirname(folder), `chromium_headless_shell-${revision}`)) ? void 0 : NO_BROWSER;
+	} catch {
+		return;
+	}
+};
+/**
+* This function gives a renderer that checks one time, before its first page, that the browser is
+* on the disk (`browserMissing`). With no browser, each page gets a `RenderRefused` with the reason
+* `browser` at once, and the renderer opens nothing. `createRuntime` puts its default renderer in
+* it, so a library with no browser costs no wait and no error capture.
+*/
+const checkedRenderer = (renderer, check = () => browserMissing()) => {
+	let missing;
+	return {
+		async render(url, options) {
+			missing ??= check().catch(() => void 0);
+			const reason = await missing;
+			if (reason !== void 0) throw new RenderRefused("browser", reason);
+			return renderer.render(url, options);
+		},
+		close: () => renderer.close()
+	};
+};
+//#endregion
+export { browser_exports as n, checkedRenderer as r, browserMissing as t };
+
+//# sourceMappingURL=browser-CKRNbIDT.mjs.map

package/build/browser-CKRNbIDT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-CKRNbIDT.mjs","names":[],"sources":["../src/browser.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\nimport type { Renderer } from \"./render.ts\";\nimport { NO_PLAYWRIGHT, RenderRefused } from \"./render.ts\";\n\n/** The text of the note when `playwright-core` is installed, but its browser is not. */\nexport const NO_BROWSER =\n  \"rendering needs a browser: npx playwright-core install chromium-headless-shell\";\n\n/** This is the part of `playwright-core` that the check uses. */\ninterface Chromium {\n  executablePath(): string;\n}\n\n/**\n * This function tells if the default renderer can start a browser. It gives no value when it can,\n * and the reason when it cannot. The command line and the MCP server use it one time at start.\n * Then a missing browser costs no wait and no error capture for each page that needs JavaScript.\n *\n * The check does not start the browser. It finds the full Chromium build or the headless shell of\n * the same revision on the disk. When the check cannot find the answer, it gives no value, and the\n * renderer then tries.\n */\nexport const browserMissing = async (\n  load: () => Promise<{ readonly chromium: Chromium }> = () => import(\"playwright-core\"),\n): Promise<string | undefined> => {\n  let chromium: Chromium;\n  try {\n    ({ chromium } = await load());\n  } catch {\n    return NO_PLAYWRIGHT;\n  }\n  try {\n    const executable = chromium.executablePath();\n    if (existsSync(executable)) return undefined;\n    // the headless shell is in a folder next to the folder of the full build, with the same revision\n    let folder = dirname(executable);\n    while (dirname(folder) !== folder && !/^chromium-\\d+$/.test(basename(folder)))\n      folder = dirname(folder);\n    const revision = /^chromium-(\\d+)$/.exec(basename(folder))?.[1];\n    if (revision === undefined) return undefined;\n    return existsSync(join(dirname(folder), `chromium_headless_shell-${revision}`))\n      ? undefined\n      : NO_BROWSER;\n  } catch {\n    return undefined;\n  }\n};\n\n/**\n * This function gives a renderer that checks one time, before its first page, that the browser is\n * on the disk (`browserMissing`). With no browser, each page gets a `RenderRefused` with the reason\n * `browser` at once, and the renderer opens nothing. `createRuntime` puts its default renderer in\n * it, so a library with no browser costs no wait and no error capture.\n */\nexport const checkedRenderer = (\n  renderer: Renderer,\n  check: () => Promise<string | undefined> = () => browserMissing(),\n): Renderer => {\n  let missing: Promise<string | undefined> | undefined;\n  return {\n    async render(url, options) {\n      missing ??= check().catch(() => undefined);\n      const reason = await missing;\n      if (reason !== undefined) throw new RenderRefused(\"browser\", reason);\n      return renderer.render(url, options);\n    },\n    close: () => renderer.close(),\n  };\n};\n"],"mappings":";;;;;;;;;;;AAMA,MAAa,aACX;;;;;;;;;;AAgBF,MAAa,iBAAiB,OAC5B,aAA6D,OAAO,uBACpC;CAChC,IAAI;CACJ,IAAI;EACF,CAAC,CAAE,YAAa,MAAM,KAAK;CAC7B,QAAQ;EACN,OAAO;CACT;CACA,IAAI;EACF,MAAM,aAAa,SAAS,eAAe;EAC3C,IAAI,WAAW,UAAU,GAAG,OAAO,KAAA;EAEnC,IAAI,SAAS,QAAQ,UAAU;EAC/B,OAAO,QAAQ,MAAM,MAAM,UAAU,CAAC,iBAAiB,KAAK,SAAS,MAAM,CAAC,GAC1E,SAAS,QAAQ,MAAM;EACzB,MAAM,WAAW,mBAAmB,KAAK,SAAS,MAAM,CAAC,CAAC,GAAG;EAC7D,IAAI,aAAa,KAAA,GAAW,OAAO,KAAA;EACnC,OAAO,WAAW,KAAK,QAAQ,MAAM,GAAG,2BAA2B,UAAU,CAAC,IAC1E,KAAA,IACA;CACN,QAAQ;EACN;CACF;AACF;;;;;;;AAQA,MAAa,mBACX,UACA,cAAiD,eAAe,MACnD;CACb,IAAI;CACJ,OAAO;EACL,MAAM,OAAO,KAAK,SAAS;GACzB,YAAY,MAAM,CAAC,CAAC,YAAY,KAAA,CAAS;GACzC,MAAM,SAAS,MAAM;GACrB,IAAI,WAAW,KAAA,GAAW,MAAM,IAAI,cAAc,WAAW,MAAM;GACnE,OAAO,SAAS,OAAO,KAAK,OAAO;EACrC;EACA,aAAa,SAAS,MAAM;CAC9B;AACF"}