@ozzylabs/feedradar 0.1.0 → 0.1.2

package/dist/core/feeds/html-js.js

@@ -0,0 +1,135 @@
+import { contentHash, parseHtmlDocument } from "./_html-common.js";
+/**
+ * `kind: html-js` adapter — Playwright-rendered HTML scraping (ADR-0010).
+ *
+ * Same selector contract as `kind: html` (delegates to `parseHtmlDocument`),
+ * but acquires the document by driving headless Chromium so SPA / CSR pages
+ * (Next.js, Notion embeds, Algolia DocSearch, etc.) that ship empty initial
+ * HTML can still be scraped.
+ *
+ * ## Hardening (ADR-0010 §D5 — hardcoded, NOT user-configurable)
+ *
+ * | Policy              | Value                | Rationale                                                |
+ * |---------------------|----------------------|----------------------------------------------------------|
+ * | `headless`          | `true`               | UI mode is CI-incompatible and an operator-UI risk.      |
+ * | `acceptDownloads`   | `false`              | Block drive-by downloads (page JS-triggered file saves). |
+ * | context reuse       | none — fresh each fetch | Prevent SW / IndexedDB / localStorage injection persistence and cross-source state mixing. |
+ * | default `timeout`   | 30000ms              | Cap OOM / infinite loops on pathological pages.          |
+ * | `page.close()`      | in `finally`         | Prevent page leak / memory accumulation.                 |
+ * | viewport            | Playwright default   | Avoid bloating DOM with oversized viewports.             |
+ *
+ * The above are intentionally NOT exposed through `SourceJsOptions`. Users
+ * may tune `waitFor` / `waitUntil` / `timeout` / `userAgent`, but the threat
+ * model assumes the policy floor above always holds.
+ *
+ * ## Optional peer dep
+ *
+ * Playwright is declared as an *optional* peer dependency (ADR-0010 §D3) so
+ * users who only run `kind: rss` / `kind: html` are not forced to install
+ * Chromium. The import is therefore `await import("playwright")` and resolves
+ * lazily on the first `html-js` fetch; missing-module errors are translated
+ * into a user-friendly install hint.
+ */
+/**
+ * Default per-step timeout in ms when `Source.js?.timeout` is omitted.
+ * Mirrors `SourceJsOptionsSchema`'s default so adapter-direct callers (not
+ * going through schema parse) still get the documented behavior.
+ */
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Default Playwright `page.goto()` waitUntil mode. `networkidle` is the
+ * safest default for SPA / CSR pages where item data arrives via XHR after
+ * the document has loaded.
+ */
+const DEFAULT_WAIT_UNTIL = "networkidle";
+/**
+ * Dynamically import Playwright. Translates the very common
+ * "package not installed" failure into the install hint from ADR-0010 §D3.
+ */
+async function loadPlaywright() {
+    try {
+        // Bare specifier: resolves via the consumer project's node_modules. The
+        // type assertion narrows the dynamic import to the subset we use.
+        const mod = (await import("playwright"));
+        return mod;
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        throw new Error(`html-js adapter: failed to load Playwright (${message}). ` +
+            "Install it with: `npm i playwright && npx playwright install chromium`");
+    }
+}
+export const htmlJsAdapter = {
+    kind: "html-js",
+    fetch: async (source, options = {}) => {
+        if (!source.selectors) {
+            throw new Error(`html-js adapter: source '${source.id}' has no selectors`);
+        }
+        const selectors = source.selectors;
+        const js = source.js;
+        const timeout = js?.timeout ?? DEFAULT_TIMEOUT_MS;
+        const waitUntil = js?.waitUntil ?? DEFAULT_WAIT_UNTIL;
+        // When `waitFor` is omitted we wait for the item selector itself — the
+        // common "wait until the item list rendered" intent without extra config.
+        const waitFor = js?.waitFor ?? selectors.item;
+        const playwright = options.playwright ?? (await loadPlaywright());
+        const previous = options.state;
+        const fetchedAt = new Date().toISOString();
+        // Hardening: headless is forced true. Even if a future Playwright default
+        // changes, the adapter pins it explicitly here.
+        const browser = await playwright.chromium.launch({ headless: true });
+        let html;
+        try {
+            // Hardening: fresh context per fetch (no SW / IndexedDB / localStorage
+            // persistence across fetches or sources). `acceptDownloads: false`
+            // blocks drive-by download routes (page JS triggering file saves).
+            const context = await browser.newContext({
+                acceptDownloads: false,
+                ...(js?.userAgent ? { userAgent: js.userAgent } : {}),
+            });
+            try {
+                const page = await context.newPage();
+                try {
+                    await page.goto(source.url, { waitUntil, timeout });
+                    await page.waitForSelector(waitFor, { timeout });
+                    html = await page.content();
+                }
+                finally {
+                    // `finally` guarantees page close even on goto / waitFor timeout —
+                    // prevents page leak / memory accumulation per ADR-0010 §D5.
+                    await page.close();
+                }
+            }
+            finally {
+                await context.close();
+            }
+        }
+        finally {
+            await browser.close();
+        }
+        // Dedup via content hash stored in the `lastEtag` slot (same convention
+        // as `kind: html` — see `_html-common.ts`). Server-side ETags are not
+        // observable from `page.content()`, so the content hash is the only
+        // dedup signal available here.
+        const bodyHash = contentHash(html);
+        if (previous?.lastEtag === bodyHash) {
+            return {
+                items: [],
+                notModified: true,
+                state: {
+                    lastFetchedAt: fetchedAt,
+                    lastEtag: bodyHash,
+                },
+            };
+        }
+        const items = parseHtmlDocument(html, source, fetchedAt);
+        return {
+            items,
+            state: {
+                lastFetchedAt: fetchedAt,
+                lastEtag: bodyHash,
+            },
+        };
+    },
+};
+//# sourceMappingURL=html-js.js.map

package/dist/core/feeds/html-js.js.map

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

package/dist/core/feeds/html.d.ts

@@ -1,10 +1,4 @@
-import type { Item, Source } from "../../schemas/index.js";
 import type { FeedAdapter } from "./types.js";
-/**
- * Parse an HTML document into validated `Item[]` using the source's
- * `selectors`. Exported so tests can drive the parser directly without
- * needing a fake HTTP layer.
- */
-export declare function parseHtmlDocument(html: string, source: Source, fetchedAt: string): Item[];
+export { parseHtmlDocument } from "./_html-common.js";
 export declare const htmlAdapter: FeedAdapter;
 //# sourceMappingURL=html.d.ts.map

package/dist/core/feeds/html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../src/core/feeds/html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAmB,MAAM,wBAAwB,CAAC;AAG5E,OAAO,KAAK,EAAE,WAAW,EAAiC,MAAM,YAAY,CAAC;AA6J7E;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,CAiBzF;AA+CD,eAAO,MAAM,WAAW,EAAE,WAuDzB,CAAC"}
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../src/core/feeds/html.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAiC,MAAM,YAAY,CAAC;AAK7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAyCtD,eAAO,MAAM,WAAW,EAAE,WAuDzB,CAAC"}

package/dist/core/feeds/html.js

@@ -1,184 +1,9 @@
-import { createHash } from "node:crypto";
-import { parse as parseHtml } from "node-html-parser";
-import { ItemSchema } from "../../schemas/index.js";
-import { deriveItemId, deriveStableKey } from "./derive-id.js";
+import { CONTENT_HASH_PREFIX, contentHash, parseHtmlDocument } from "./_html-common.js";
+// Re-export shared primitives so existing imports (and tests) that pulled
+// `parseHtmlDocument` from this module keep working after the
+// `_html-common.ts` split (ADR-0010 §D1, no behavior change).
+export { parseHtmlDocument } from "./_html-common.js";
 const USER_AGENT = "feedradar/0.0.0 (+https://github.com/ozzy-labs/feedradar)";
-/**
- * Prefix that flags an `lastEtag` slot as carrying a content hash rather than
- * an actual HTTP ETag. We reuse the `lastEtag` field so this Phase does not
- * have to migrate `SourceState` (see `docs/design/source-html.md`).
- */
-const CONTENT_HASH_PREFIX = "sha256:";
-/** Attributes the adapter checks before falling back to text content. */
-const DATETIME_ATTRS = ["datetime", "content", "value"];
-/**
- * Convert an `HTMLElement | null` to its trimmed text, or `undefined` when
- * the selector did not match. We always trim because raw scrapes routinely
- * carry surrounding whitespace from formatted markup.
- */
-function textOf(el) {
-    if (!el)
-        return undefined;
-    const text = el.text?.trim();
-    return text ? text : undefined;
-}
-/**
- * Apply a CSS selector relative to `root` and return the first match.
- * `node-html-parser` returns `null` instead of throwing for invalid input,
- * which matches what callers want here (a missing field, not a hard error).
- */
-function queryFirst(root, selector) {
-    return root.querySelector(selector);
-}
-/**
- * Resolve the `link` selector to an `href` (or text fallback).
- *
- * Anchor tags expose the URL via `href` so we prefer the attribute. When the
- * selector points at a non-anchor (e.g. a `<div data-link>` wrapper used by
- * some changelog layouts), we fall back to text content so the adapter can
- * still operate, deferring URL validation to `ItemSchema`.
- */
-function pickLink(el) {
-    if (!el)
-        return undefined;
-    const href = el.getAttribute("href");
-    if (href && href.trim())
-        return href.trim();
-    return textOf(el);
-}
-/**
- * Resolve `publishedAt` to a candidate string for `new Date()`.
- *
- * `<time datetime="2026-05-12">` and `<meta content="..."/>` markup hide the
- * canonical timestamp in attributes; the visible text is often a
- * localized "May 12, 2026" that is harder to parse reliably. We probe the
- * known attributes first, then fall back to element text.
- */
-function pickDatetime(el) {
-    if (!el)
-        return undefined;
-    for (const attr of DATETIME_ATTRS) {
-        const value = el.getAttribute(attr);
-        if (value && value.trim())
-            return value.trim();
-    }
-    return textOf(el);
-}
-/**
- * Try to parse a candidate timestamp into ISO 8601. Returns `undefined` for
- * unparseable inputs so the item can still be emitted (RSS adapter parity).
- */
-function toIsoDate(value) {
-    if (!value)
-        return undefined;
-    const date = new Date(value);
-    if (Number.isNaN(date.getTime()))
-        return undefined;
-    return date.toISOString();
-}
-/** Collect the trimmed text of every match for `selector`. */
-function collectTags(root, selector) {
-    if (!selector)
-        return undefined;
-    const tags = root
-        .querySelectorAll(selector)
-        .map((el) => el.text?.trim())
-        .filter((t) => !!t && t.length > 0);
-    return tags.length > 0 ? tags : undefined;
-}
-/**
- * Resolve a relative `link` against the source URL.
- *
- * Many sites publish `<a href="/changelog/foo">` rather than absolute URLs;
- * without resolution `ItemSchema`'s `z.string().url()` would drop them. We
- * intentionally swallow `URL` constructor errors so a malformed `link`
- * surfaces as a normal validation drop later instead of breaking the whole
- * fetch.
- */
-function resolveUrl(raw, base) {
-    try {
-        return new URL(raw, base).toString();
-    }
-    catch {
-        return raw;
-    }
-}
-/** Normalize one matched element into an Item, or `null` to drop it. */
-function parseItem(itemEl, selectors, source, fetchedAt) {
-    const title = textOf(queryFirst(itemEl, selectors.title));
-    const linkRaw = pickLink(queryFirst(itemEl, selectors.link));
-    if (!title || !linkRaw)
-        return null;
-    const url = resolveUrl(linkRaw, source.url);
-    const summary = selectors.summary ? textOf(queryFirst(itemEl, selectors.summary)) : undefined;
-    const body = selectors.body ? textOf(queryFirst(itemEl, selectors.body)) : undefined;
-    const publishedAt = selectors.publishedAt
-        ? toIsoDate(pickDatetime(queryFirst(itemEl, selectors.publishedAt)))
-        : undefined;
-    const tags = collectTags(itemEl, selectors.tags);
-    const stableKey = deriveStableKey({
-        url,
-        fallbackHashInputs: [title, publishedAt],
-    });
-    const id = deriveItemId(title, stableKey);
-    // Preserve a structured snapshot of the raw scrape rather than the
-    // `HTMLElement` instance itself — the watcher serializes `raw` to YAML and
-    // we want the on-disk payload to be diff-friendly.
-    const raw = { title, link: linkRaw };
-    if (summary !== undefined)
-        raw.summary = summary;
-    if (body !== undefined)
-        raw.body = body;
-    if (publishedAt !== undefined)
-        raw.publishedAt = publishedAt;
-    if (tags !== undefined)
-        raw.tags = tags;
-    return validateItem({
-        id,
-        sourceId: source.id,
-        title,
-        url,
-        summary,
-        publishedAt,
-        fetchedAt,
-        raw,
-    });
-}
-function validateItem(candidate) {
-    const result = ItemSchema.safeParse(candidate);
-    // Items that fail validation (e.g. unresolvable URL) are dropped silently —
-    // see rss.ts for the same fail-soft rationale.
-    return result.success ? result.data : null;
-}
-/**
- * Parse an HTML document into validated `Item[]` using the source's
- * `selectors`. Exported so tests can drive the parser directly without
- * needing a fake HTTP layer.
- */
-export function parseHtmlDocument(html, source, fetchedAt) {
-    if (!source.selectors) {
-        throw new Error(`html adapter: source '${source.id}' has no selectors`);
-    }
-    const selectors = source.selectors;
-    let root;
-    try {
-        root = parseHtml(html);
-    }
-    catch (e) {
-        throw new Error(`html adapter: failed to parse HTML: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    const itemEls = root.querySelectorAll(selectors.item);
-    return itemEls
-        .map((el) => parseItem(el, selectors, source, fetchedAt))
-        .filter((i) => i !== null);
-}
-/**
- * Compute the sha256 of the raw response body, prefixed so callers can tell
- * it apart from a real ETag inside `SourceState.lastEtag`.
- */
-function contentHash(body) {
-    return `${CONTENT_HASH_PREFIX}${createHash("sha256").update(body).digest("hex")}`;
-}
 /**
  * Issue an HTTP GET with conditional headers. The previous `lastEtag` slot
  * may contain either an actual ETag (mirror RSS behavior) or a `sha256:`

package/dist/core/feeds/html.js.map

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

package/dist/core/feeds/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAKrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAMhE;AAED,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAMrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU9C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAMhE;AAED,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/feeds/index.js

@@ -1,10 +1,12 @@
 import { githubReleasesAdapter } from "./github-releases.js";
 import { htmlAdapter } from "./html.js";
+import { htmlJsAdapter } from "./html-js.js";
 import { npmRegistryAdapter } from "./npm-registry.js";
 import { rssAdapter } from "./rss.js";
 const adapters = new Map([
     [rssAdapter.kind, rssAdapter],
     [htmlAdapter.kind, htmlAdapter],
+    [htmlJsAdapter.kind, htmlJsAdapter],
     [githubReleasesAdapter.kind, githubReleasesAdapter],
     [npmRegistryAdapter.kind, npmRegistryAdapter],
 ]);

package/dist/core/feeds/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAA8B;IACpD,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;IAC7B,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAC/B,CAAC,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACnD,CAAC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,CAAC;CAC9C,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/feeds/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAGtC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAA8B;IACpD,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC;IAC7B,CAAC,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC;IAC/B,CAAC,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC;IACnC,CAAC,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACnD,CAAC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,CAAC;CAC9C,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,IAAoB;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/playwright-check.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Detection / install helpers for the optional `playwright` peer dependency
+ * used by the `html-js` feed adapter (ADR-0010).
+ *
+ * The `html-js` adapter resolves Playwright at fetch time via
+ * `await import("playwright")`, so the package is intentionally optional in
+ * `package.json#peerDependenciesMeta`. Two CLI surfaces need to inspect that
+ * resolution outside of the adapter itself:
+ *
+ *   1. `radar doctor` — proactively reports whether Playwright + Chromium are
+ *      installed so users can fix the environment before scheduling a watch.
+ *   2. `radar watch run` — lazily probes Playwright on the first `html-js`
+ *      source so a missing install does not abort the whole run; the affected
+ *      source is skipped with an actionable error, other kinds continue.
+ *
+ * Both paths share the same probe / install helpers here to keep the install
+ * hint and `RADAR_AUTO_INSTALL_CHROMIUM` escape hatch in one place. The escape
+ * hatch exists for CI scenarios where a fresh runner has `playwright` itself
+ * (e.g. via `npm i`) but no browser binary on disk yet.
+ *
+ * Policy choices (intentional, not for adapter to second-guess):
+ *
+ *   - We do NOT auto-install the `playwright` npm package. Global npm installs
+ *     fail in non-obvious ways (permissions, version mismatches with the
+ *     workspace's lockfile), so the user must run `npm i -g playwright`
+ *     themselves and get a clear error from `npm` if it fails.
+ *   - We DO auto-install Chromium when `RADAR_AUTO_INSTALL_CHROMIUM=1` is set
+ *     and Playwright is present. `npx playwright install chromium` is the
+ *     official path, idempotent, and well-supported in CI runners.
+ */
+/**
+ * Minimal Playwright surface this module reasons about. We only need
+ * `chromium.executablePath()` (sync function returning a fs path) — the
+ * fetcher in `feeds/html-js.ts` keeps its own structural type for the launch
+ * subset it actually uses.
+ */
+export interface PlaywrightModuleLike {
+    chromium: {
+        executablePath: () => string;
+    };
+}
+/**
+ * Outcome of a Playwright probe. Discriminated union so callers branch
+ * cleanly on the failure mode without parsing error messages.
+ *
+ * - `ok`: module loaded AND `chromium.executablePath()` points at an
+ *   existing file on disk.
+ * - `module-missing`: `import("playwright")` threw (package not installed).
+ * - `chromium-missing`: module loaded but the executable path is absent.
+ *   The path is included so callers can show it to the user.
+ */
+export type PlaywrightProbeResult = {
+    status: "ok";
+    executablePath: string;
+} | {
+    status: "module-missing";
+    message: string;
+} | {
+    status: "chromium-missing";
+    executablePath: string;
+};
+/**
+ * Test seam: lets unit tests inject a fake importer / `pathExists` so we can
+ * exercise every branch (module missing, chromium missing, ok) without
+ * touching the real Playwright install.
+ *
+ * The real CLI never passes these; defaults are dynamic import + `fs.access`.
+ */
+export interface ProbeOptions {
+    /** Replace dynamic `import("playwright")` (tests only). */
+    importPlaywright?: () => Promise<unknown>;
+    /** Replace fs existence check (tests only). */
+    pathExists?: (p: string) => Promise<boolean>;
+}
+/**
+ * Probe whether Playwright + Chromium are usable from this process.
+ *
+ * Order matters: we MUST surface "module missing" before attempting any
+ * property access — `chromium.executablePath()` would throw with a less
+ * actionable message ("Cannot read properties of undefined").
+ */
+export declare function probePlaywright(options?: ProbeOptions): Promise<PlaywrightProbeResult>;
+/**
+ * User-facing install hint emitted when Playwright (the npm package) is
+ * missing. The text matches the wording in `feeds/html-js.ts#loadPlaywright`
+ * so users see consistent guidance across `doctor` and `watch run`.
+ *
+ * `RADAR_AUTO_INSTALL_CHROMIUM` is mentioned only in the Chromium-missing
+ * branch — auto-installing the npm package itself is intentionally out of
+ * scope (see module header).
+ */
+export declare const PLAYWRIGHT_MODULE_MISSING_HINT: string;
+/**
+ * User-facing install hint emitted when the npm package is present but the
+ * Chromium binary on disk is not. Mentions the auto-install escape hatch
+ * since this is the branch it actually applies to.
+ */
+export declare const CHROMIUM_MISSING_HINT: string;
+/**
+ * Test seam for the spawn used by `installChromium`. Production passes
+ * the real `child_process.spawn`; tests inject a fake that returns a
+ * predetermined exit code without actually launching a subprocess.
+ */
+export type InstallSpawnLike = (command: string, args: readonly string[], options: {
+    cwd?: string;
+    stdio?: "inherit" | "pipe" | "ignore";
+}) => {
+    on(event: "close", listener: (code: number | null) => void): void;
+    on(event: "error", listener: (err: Error) => void): void;
+};
+export interface InstallChromiumOptions {
+    /** Working directory for the spawned `npx`. Defaults to the caller's cwd. */
+    cwd?: string;
+    /** Test seam: swap out `child_process.spawn`. */
+    spawnImpl?: InstallSpawnLike;
+    /** Sink for progress messages (defaults to console.log). */
+    log?: (message: string) => void;
+}
+/**
+ * Spawn `npx playwright install chromium` and resolve when it exits.
+ *
+ * Used by the `RADAR_AUTO_INSTALL_CHROMIUM=1` escape hatch. We pipe output
+ * through `stdio: "inherit"` so the user (or CI logs) sees Playwright's
+ * progress in real time — `npx playwright install` already prints
+ * download URLs and percentages that are helpful debugging signal when the
+ * install fails. Resolves to the child's exit code so callers can decide
+ * whether to retry the original operation.
+ *
+ * Note we explicitly use `npx` (not direct binary lookup) because Playwright
+ * does not expose a JS API for browser install; the CLI is the supported
+ * entrypoint per Playwright docs.
+ */
+export declare function installChromium(options?: InstallChromiumOptions): Promise<number>;
+//# sourceMappingURL=playwright-check.d.ts.map

package/dist/core/playwright-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-check.d.ts","sourceRoot":"","sources":["../../src/core/playwright-check.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM,MAAM,CAAC;KAC9B,CAAC;CACH;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAWD;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgChG;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,8BAA8B,QAE0B,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAEmC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;CAAE,KAC7D;IACH,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAAC;IAClE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI,CAAC;CAC1D,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,4DAA4D;IAC5D,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAc3F"}

package/dist/core/playwright-check.js

@@ -0,0 +1,98 @@
+import { spawn } from "node:child_process";
+import { access } from "node:fs/promises";
+async function defaultPathExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Probe whether Playwright + Chromium are usable from this process.
+ *
+ * Order matters: we MUST surface "module missing" before attempting any
+ * property access — `chromium.executablePath()` would throw with a less
+ * actionable message ("Cannot read properties of undefined").
+ */
+export async function probePlaywright(options = {}) {
+    const importPlaywright = options.importPlaywright ?? (() => import("playwright"));
+    const pathExists = options.pathExists ?? defaultPathExists;
+    let mod;
+    try {
+        mod = (await importPlaywright());
+    }
+    catch (e) {
+        return {
+            status: "module-missing",
+            message: e instanceof Error ? e.message : String(e),
+        };
+    }
+    let execPath;
+    try {
+        execPath = mod.chromium.executablePath();
+    }
+    catch (e) {
+        // `executablePath()` raises when no browsers were ever installed via
+        // `npx playwright install`. Treat as the same user-actionable failure as a
+        // missing file on disk; surface an empty path so callers know the message
+        // came from this branch.
+        return {
+            status: "chromium-missing",
+            executablePath: e instanceof Error ? `(${e.message})` : "(unknown)",
+        };
+    }
+    if (!(await pathExists(execPath))) {
+        return { status: "chromium-missing", executablePath: execPath };
+    }
+    return { status: "ok", executablePath: execPath };
+}
+/**
+ * User-facing install hint emitted when Playwright (the npm package) is
+ * missing. The text matches the wording in `feeds/html-js.ts#loadPlaywright`
+ * so users see consistent guidance across `doctor` and `watch run`.
+ *
+ * `RADAR_AUTO_INSTALL_CHROMIUM` is mentioned only in the Chromium-missing
+ * branch — auto-installing the npm package itself is intentionally out of
+ * scope (see module header).
+ */
+export const PLAYWRIGHT_MODULE_MISSING_HINT = "Playwright is required for kind: html-js. Run: npm i -g playwright && npx playwright install chromium\n" +
+    "Or set RADAR_AUTO_INSTALL_CHROMIUM=1 to auto-install on next run.";
+/**
+ * User-facing install hint emitted when the npm package is present but the
+ * Chromium binary on disk is not. Mentions the auto-install escape hatch
+ * since this is the branch it actually applies to.
+ */
+export const CHROMIUM_MISSING_HINT = "Chromium binary not found. Run: npx playwright install chromium\n" +
+    "Or set RADAR_AUTO_INSTALL_CHROMIUM=1 to auto-install on next run.";
+/**
+ * Spawn `npx playwright install chromium` and resolve when it exits.
+ *
+ * Used by the `RADAR_AUTO_INSTALL_CHROMIUM=1` escape hatch. We pipe output
+ * through `stdio: "inherit"` so the user (or CI logs) sees Playwright's
+ * progress in real time — `npx playwright install` already prints
+ * download URLs and percentages that are helpful debugging signal when the
+ * install fails. Resolves to the child's exit code so callers can decide
+ * whether to retry the original operation.
+ *
+ * Note we explicitly use `npx` (not direct binary lookup) because Playwright
+ * does not expose a JS API for browser install; the CLI is the supported
+ * entrypoint per Playwright docs.
+ */
+export async function installChromium(options = {}) {
+    const spawnImpl = options.spawnImpl ?? spawn;
+    const log = options.log ?? ((m) => console.log(m));
+    log("Installing Chromium via `npx playwright install chromium`...");
+    return new Promise((resolve, reject) => {
+        const child = spawnImpl("npx", ["playwright", "install", "chromium"], {
+            cwd: options.cwd,
+            stdio: "inherit",
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+//# sourceMappingURL=playwright-check.js.map

package/dist/core/playwright-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-check.js","sourceRoot":"","sources":["../../src/core/playwright-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AA0E1C,KAAK,UAAU,iBAAiB,CAAC,CAAS;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAwB,EAAE;IAC9D,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,CAAC;IAE3D,IAAI,GAAyB,CAAC;IAC9B,IAAI,CAAC;QACH,GAAG,GAAG,CAAC,MAAM,gBAAgB,EAAE,CAAyB,CAAC;IAC3D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,gBAAgB;YACxB,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;SACpD,CAAC;IACJ,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;IAC3C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,qEAAqE;QACrE,2EAA2E;QAC3E,0EAA0E;QAC1E,yBAAyB;QACzB,OAAO;YACL,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,WAAW;SACpE,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACpD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,8BAA8B,GACzC,yGAAyG;IACzG,mEAAmE,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAChC,mEAAmE;IACnE,mEAAmE,CAAC;AAyBtE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAkC,EAAE;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAK,KAAqC,CAAC;IAC9E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,GAAG,CAAC,8DAA8D,CAAC,CAAC;IACpE,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE;YACpE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}