@chrischall/mcp-utils 0.10.5 → 0.12.0

package/dist/scrape/index.js

@@ -0,0 +1,463 @@
+/**
+ * `scrape` — zero-dependency string/JSON extraction primitives for
+ * server-rendered pages.
+ *
+ * Consolidates the SSR JSON-store extraction stack the fleet re-implemented at
+ * least five times: musescore's `store.ts` (entity recovery + string-aware
+ * bracket matching), tock's `redux-state.ts` (top-level slice extraction +
+ * JS-literal repair) and `parse.ts` (cycle-guarded deep walkers), zillow's
+ * `page-props.ts` (`findArrayByShape`), etix's `parse.ts` (JSON-LD / OpenGraph
+ * / dataLayer readers), plus the entity-decode/strip-tags helpers duplicated in
+ * alltrails / musescore / signupgenius and the anti-XSSI guard strippers in
+ * workday / canvas / redfin.
+ *
+ * Everything here is pure string/JSON work — NO `node-html-parser`. DOM-level
+ * scraping (tables, link lists) lives in `@chrischall/mcp-utils/html`, which
+ * carries that optional peer dep; this module is safe for the core barrel.
+ */
+// ---------------------------------------------------------------------------
+// Entity decoding / tag stripping
+// ---------------------------------------------------------------------------
+/** The named entities the fleet's scraped content actually contains. */
+const NAMED_ENTITIES = {
+    nbsp: ' ',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+};
+/**
+ * Decode HTML character references: decimal (`&#65;`) and hex (`&#x41;`)
+ * numerics plus the common named entities. `&amp;` is decoded **last** so a
+ * double-escaped entity survives exactly one level (`&amp;lt;` → `&lt;`, not
+ * `<`) — the ordering both alltrails' `stripHtml` and musescore's `decodeText`
+ * depend on when recovering attribute-escaped JSON. Unknown entities pass
+ * through untouched.
+ */
+export function decodeHtmlEntities(text) {
+    return text
+        .replace(/&#(\d+);/g, (whole, d) => codePointOr(Number(d), whole))
+        .replace(/&#x([0-9a-fA-F]+);/g, (whole, h) => codePointOr(parseInt(h, 16), whole))
+        .replace(/&(nbsp|lt|gt|quot|apos);/gi, (whole, name) => {
+        return NAMED_ENTITIES[name.toLowerCase()] ?? whole;
+    })
+        .replace(/&amp;/gi, '&');
+}
+/**
+ * `String.fromCodePoint` for a scraped numeric entity, but SAFE: an out-of-range
+ * code point (negative or > 0x10FFFF, e.g. `&#999999999999;`) throws
+ * `RangeError`, which on hostile input would crash the extractor — the guard
+ * returns the raw entity text unchanged instead, preserving the module's
+ * never-throw contract. (Lone surrogates, 0xD800–0xDFFF, do NOT throw and pass
+ * the guard; `String.fromCodePoint` yields a lone-surrogate string for them,
+ * which is harmless here. The `try/catch` is belt-and-suspenders.)
+ */
+function codePointOr(code, raw) {
+    if (!Number.isInteger(code) || code < 0 || code > 0x10ffff)
+        return raw;
+    try {
+        return String.fromCodePoint(code);
+    }
+    catch {
+        return raw;
+    }
+}
+/**
+ * Strip an HTML **fragment** to readable text: tags → spaces, entities decoded
+ * (via {@link decodeHtmlEntities}), whitespace collapsed and trimmed.
+ *
+ * For a full document where inline `<script>`/`<style>` *content* must not leak
+ * into the output, use `extractPlainTextFromHtml` from
+ * `@chrischall/mcp-utils/html` — this fragment-level helper does not remove
+ * element content, only markup.
+ */
+export function stripHtml(html) {
+    if (!html)
+        return '';
+    return decodeHtmlEntities(html.replace(/<[^>]+>/g, ' '))
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+// ---------------------------------------------------------------------------
+// Balanced-structure matching / marker extraction / JS-literal repair
+// ---------------------------------------------------------------------------
+const IDENT_CHAR = /[A-Za-z0-9_$]/;
+/**
+ * Replace bare JS `undefined` literals with `null` so a scraped JS object
+ * literal becomes parseable JSON. String-aware: occurrences inside single- or
+ * double-quoted strings are left alone, as are identifiers that merely contain
+ * the word. Consolidates tock's `sanitizeJsLiterals`.
+ */
+export function sanitizeJsLiterals(text) {
+    let out = '';
+    let inString = null;
+    let escape = false;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (inString) {
+            out += ch;
+            if (escape)
+                escape = false;
+            else if (ch === '\\')
+                escape = true;
+            else if (ch === inString)
+                inString = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            inString = ch;
+            out += ch;
+            continue;
+        }
+        if (ch === 'u' &&
+            text.startsWith('undefined', i) &&
+            (i === 0 || !IDENT_CHAR.test(text[i - 1])) &&
+            (i + 9 >= text.length || !IDENT_CHAR.test(text[i + 9]))) {
+            out += 'null';
+            i += 8;
+            continue;
+        }
+        out += ch;
+    }
+    return out;
+}
+/**
+ * Given `text[start]` on a `{` or `[`, walk the balanced structure — tracking
+ * double- AND single-quoted strings and backslash escapes so brackets inside
+ * string literals don't terminate it early — and return the **exclusive** end
+ * index. Returns `-1` when `start` isn't on an opener or the structure never
+ * closes. Consolidates musescore's `matchBracket` and the brace-walk inside
+ * tock's `extractReduxSlice` (regex can't do this: the stores nest and escape).
+ */
+export function matchBalanced(text, start) {
+    const opener = text[start];
+    if (opener !== '{' && opener !== '[')
+        return -1;
+    const stack = [];
+    let inString = null;
+    let escape = false;
+    for (let i = start; i < text.length; i++) {
+        const ch = text[i];
+        if (inString) {
+            if (escape)
+                escape = false;
+            else if (ch === '\\')
+                escape = true;
+            else if (ch === inString)
+                inString = null;
+            continue;
+        }
+        if (ch === '"' || ch === "'") {
+            inString = ch;
+        }
+        else if (ch === '{' || ch === '[') {
+            stack.push(ch);
+        }
+        else if (ch === '}' || ch === ']') {
+            const open = stack.pop();
+            if ((ch === '}' && open !== '{') || (ch === ']' && open !== '['))
+                return -1;
+            if (stack.length === 0)
+                return i + 1;
+        }
+    }
+    return -1;
+}
+/**
+ * Find the first of `markers` in `text`, skip to the next `{` or `[`, walk the
+ * balanced structure ({@link matchBalanced}), and `JSON.parse` it. Returns
+ * `null` on any failure — marker absent, no opener, unbalanced, or invalid
+ * JSON — so callers can branch without a try/catch.
+ *
+ * The array-capable, multi-marker, JS-literal-tolerant generalization of the
+ * `/html` subpath's `extractJsonFromHtml` (which is object-only and marker-form
+ * fixed). Use this for `window.$REDUX_STATE` slices (tock), `__NEXT_DATA__`
+ * analogues, and attribute-escaped stores (run the text through
+ * {@link decodeHtmlEntities} first when the blob is entity-escaped).
+ */
+export function extractJsonAfterMarker(text, markers, opts = {}) {
+    const list = Array.isArray(markers) ? markers : [markers];
+    let idx = -1;
+    let markerLen = 0;
+    for (const m of list) {
+        const i = text.indexOf(m);
+        if (i >= 0) {
+            idx = i;
+            markerLen = m.length;
+            break;
+        }
+    }
+    if (idx < 0)
+        return null;
+    let start = idx + markerLen;
+    while (start < text.length && text[start] !== '{' && text[start] !== '[')
+        start++;
+    if (start >= text.length)
+        return null;
+    const end = matchBalanced(text, start);
+    if (end < 0)
+        return null;
+    let raw = text.slice(start, end);
+    if (opts.sanitize)
+        raw = sanitizeJsLiterals(raw);
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// JSON-LD / OpenGraph readers
+// ---------------------------------------------------------------------------
+const LD_JSON_ATTR_RE = /type\s*=\s*["']application\/ld\+json["']/i;
+/**
+ * Find the next opening tag `<name` in `html` at or after `from`, respecting a
+ * tag-name boundary (so `<scriptish` doesn't match `<script`) and returning the
+ * index of the `<`, or `-1`. `lowerHtml` is the pre-lowercased haystack; `name`
+ * must be lowercase. Uses `indexOf` (linear) — the string primitives don't
+ * backtrack, unlike a `/<name\b[^>]*>/g` regex which is O(n²) across many
+ * openers when the closing `>` is withheld.
+ */
+function nextTagOpen(lowerHtml, name, from) {
+    const needle = `<${name}`;
+    for (let i = lowerHtml.indexOf(needle, from); i >= 0; i = lowerHtml.indexOf(needle, i + 1)) {
+        const after = lowerHtml[i + needle.length];
+        // A real tag boundary: end, `>`, whitespace, or self-close/slash.
+        if (after === undefined || after === '>' || after === '/' || after === ' ' || after === '\t' || after === '\n' || after === '\r' || after === '\f') {
+            return i;
+        }
+    }
+    return -1;
+}
+/**
+ * Parse every `<script type="application/ld+json">` block in the page,
+ * skipping malformed ones. Returns the parsed values in document order.
+ * Consolidates etix's / tripadvisor's ld+json block iteration.
+ *
+ * Linear-time by construction: `indexOf`-driven tag scanning (find `<script`,
+ * find its `>`, find `</script>`), never a `[^>]*>` regex — the previous
+ * single mega-regex was O(n³) and its `[^>]*>`-per-opener replacement is still
+ * O(n²); string `indexOf` doesn't backtrack, so an unterminated
+ * `<script type="application/ld+json"` flood can't pin the event loop.
+ */
+export function extractJsonLdBlocks(html) {
+    const out = [];
+    const lower = html.toLowerCase();
+    let i = 0;
+    for (;;) {
+        const open = nextTagOpen(lower, 'script', i);
+        if (open < 0)
+            break;
+        const tagEnd = html.indexOf('>', open);
+        if (tagEnd < 0)
+            break; // unterminated opening tag — nothing more to extract
+        const attrs = html.slice(open + '<script'.length, tagEnd);
+        const bodyStart = tagEnd + 1;
+        const bodyEnd = lower.indexOf('</script>', bodyStart);
+        if (bodyEnd < 0)
+            break; // no closing tag
+        i = bodyEnd + '</script>'.length;
+        if (!LD_JSON_ATTR_RE.test(attrs))
+            continue;
+        try {
+            out.push(JSON.parse(html.slice(bodyStart, bodyEnd).trim()));
+        }
+        catch {
+            // Malformed block — skip, per every donor.
+        }
+    }
+    return out;
+}
+/** True when a JSON-LD node's `@type` (string or array) includes `type`. */
+function typeMatches(node, type) {
+    if (node === null || typeof node !== 'object')
+        return false;
+    const t = node['@type'];
+    return t === type || (Array.isArray(t) && t.includes(type));
+}
+/**
+ * Find the first schema.org entity of `@type === type` across the page's
+ * JSON-LD blocks — checking each block itself, its array items, its `@graph`
+ * items, and each candidate's `mainEntity` (the etix pattern: the Event often
+ * hides inside a `WebPage.mainEntity`). Returns the matching node, or `null`.
+ */
+export function findJsonLdEntity(html, type) {
+    for (const block of extractJsonLdBlocks(html)) {
+        const roots = Array.isArray(block) ? block : [block];
+        for (const root of roots) {
+            if (root === null || typeof root !== 'object')
+                continue;
+            const graph = root['@graph'];
+            const candidates = [root, ...(Array.isArray(graph) ? graph : [])];
+            for (const candidate of candidates) {
+                if (typeMatches(candidate, type))
+                    return candidate;
+                const main = candidate?.['mainEntity'];
+                if (typeMatches(main, type))
+                    return main;
+            }
+        }
+    }
+    return null;
+}
+// These run only on a SINGLE bounded `<meta …>` tag's attribute text, so they
+// carry no ReDoS risk (input is one tag, not the whole document).
+const META_CONTENT_RE = /\bcontent\s*=\s*["']([^"']*)["']/i;
+const META_PROP_RE = /\b(?:property|name)\s*=\s*["']([^"']*)["']/i;
+/**
+ * Read a `<meta property="og:…" content="…">` value, tolerant of either
+ * attribute order (both occur in the wild — etix's `ogContent`) and of
+ * `name=`-keyed OpenGraph. The content is entity-decoded. Returns `undefined`
+ * when the property is absent.
+ *
+ * Linear-time by construction: `indexOf`-driven `<meta …>` scanning, reading
+ * the `property`/`content` attributes WITHIN each single (bounded) tag — never
+ * a `<meta\s[^>]*PROP[^>]*content…` regex, which backtracked quadratically on a
+ * flood of unterminated `<meta property=…` (a ReDoS on hostile scraped HTML).
+ */
+export function ogContent(html, property) {
+    const want = property.toLowerCase();
+    const lower = html.toLowerCase();
+    let i = 0;
+    for (;;) {
+        const open = nextTagOpen(lower, 'meta', i);
+        if (open < 0)
+            return undefined;
+        const tagEnd = html.indexOf('>', open);
+        if (tagEnd < 0)
+            return undefined; // unterminated tag — nothing more to read
+        const attrs = html.slice(open + '<meta'.length, tagEnd);
+        i = tagEnd + 1;
+        const prop = META_PROP_RE.exec(attrs);
+        if (!prop || prop[1]?.toLowerCase() !== want)
+            continue;
+        const content = META_CONTENT_RE.exec(attrs);
+        if (content?.[1] !== undefined)
+            return decodeHtmlEntities(content[1]);
+    }
+}
+// ---------------------------------------------------------------------------
+// Shape-directed JSON walking
+// ---------------------------------------------------------------------------
+/**
+ * Locate an array inside a drifting JSON container (a `pageProps` /
+ * `__NEXT_DATA__` blob): try `directKeys` first, then scan the container's
+ * top-level array values and return the first whose FIRST element passes
+ * `looksRight`. An empty array at a direct key is trusted (there is no first
+ * element to test). Returns `[]` on a miss — never `undefined` — so projections
+ * degrade to "no rows" instead of crashing when the upstream renames a key.
+ * Consolidates zillow's `page-props.ts#findArrayByShape`.
+ */
+export function findArrayByShape(container, directKeys, looksRight) {
+    for (const key of directKeys) {
+        const v = container[key];
+        if (Array.isArray(v) && (v.length === 0 || looksRight(v[0])))
+            return v;
+    }
+    for (const v of Object.values(container)) {
+        if (Array.isArray(v) && v.length > 0 && looksRight(v[0]))
+            return v;
+    }
+    return [];
+}
+/**
+ * Depth-first, cycle-guarded walk collecting every array whose FIRST element
+ * passes `pred`. Recurses into matched arrays too (nested hits are collected).
+ * Consolidates tock's `collectArrays` — the "walk for the shape, don't
+ * hard-code the path" discipline for SSR stores.
+ */
+export function deepCollectArrays(root, pred) {
+    const found = [];
+    const seen = new WeakSet();
+    const walk = (node) => {
+        if (node === null || typeof node !== 'object')
+            return;
+        if (seen.has(node))
+            return;
+        seen.add(node);
+        if (Array.isArray(node)) {
+            if (node.length > 0 && pred(node[0]))
+                found.push(node);
+            for (const item of node)
+                walk(item);
+            return;
+        }
+        for (const v of Object.values(node))
+            walk(v);
+    };
+    walk(root);
+    return found;
+}
+/**
+ * Depth-first, cycle-guarded search for the first non-array object passing
+ * `pred`. Returns `null` when nothing matches. Consolidates tock's
+ * `findObject`.
+ */
+export function deepFindObject(root, pred) {
+    const seen = new WeakSet();
+    const walk = (node) => {
+        if (node === null || typeof node !== 'object')
+            return null;
+        if (seen.has(node))
+            return null;
+        seen.add(node);
+        if (Array.isArray(node)) {
+            for (const item of node) {
+                const hit = walk(item);
+                if (hit)
+                    return hit;
+            }
+            return null;
+        }
+        const obj = node;
+        if (pred(obj))
+            return obj;
+        for (const v of Object.values(obj)) {
+            const hit = walk(v);
+            if (hit)
+                return hit;
+        }
+        return null;
+    };
+    return walk(root);
+}
+// ---------------------------------------------------------------------------
+// Interstitial / guard detection
+// ---------------------------------------------------------------------------
+/**
+ * Detect a Cloudflare challenge interstitial by its DEFINITIVE markers only:
+ * the `_cf_chl_opt` bootstrap object or a `<title>Just a moment` page title.
+ * Deliberately does NOT match `cdn-cgi/challenge-platform` or
+ * `challenges.cloudflare.com` references — Cloudflare inlines those on CLEARED
+ * pages too, and matching them false-positives on legit pages (the musescore
+ * "search works but detail pages fail" bug). Consolidates the byte-identical
+ * predicates in musescore and tock.
+ */
+export function isCloudflareChallenge(html) {
+    return /_cf_chl_opt/.test(html) || /<title[^>]*>\s*Just a moment/i.test(html);
+}
+// Known anti-XSSI guard prefixes, each anchored to the string start:
+// Google-style `)]}'`, Facebook-style `for(;;);`, the classic `while(1);`,
+// and redfin's stingray `{}&&`.
+const GUARD_RES = [/^\)\]\}'/, /^while\s*\(\s*1\s*\)\s*;?/, /^for\s*\(\s*;;\s*\)\s*;?/, /^\{\}&&/];
+/**
+ * Strip anti-XSSI / anti-JSON-hijacking guard prefixes from a response body so
+ * it parses as JSON: `)]}'`, `while(1);`, `for(;;);`, and `{}&&` (redfin's
+ * stingray envelope), plus surrounding whitespace, applied repeatedly until no
+ * guard remains. Unguarded input passes through unchanged. Consolidates
+ * workday's `stripJsonGuard`, canvas-parent's `while(1);` strip, and redfin's
+ * `stripStingrayPrefix`.
+ */
+export function stripJsonGuard(text) {
+    let out = text.trimStart();
+    for (;;) {
+        const before = out;
+        for (const re of GUARD_RES) {
+            out = out.replace(re, '').trimStart();
+        }
+        if (out === before)
+            return out;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/scrape/index.js.map

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

package/dist/session/index.d.ts

@@ -307,6 +307,28 @@ export interface CookieSessionManagerOptions<S, R = Response> {
      * (always retry) — the safe default for sites with no config/transient split.
      */
     isPermanentError?: (err: unknown) => boolean;
+    /**
+     * Proactive session TTL, in milliseconds. A session older than this (by
+     * login/seed time) is treated as stale: the next {@link ensure} invalidates
+     * and re-logs-in (single-flight — a stale burst coalesces onto ONE login).
+     * Omit for reactive-only expiry via {@link isExpired}. Mirrors
+     * infinitecampus's 5-hour `SESSION_TTL_MS` (which hand-rolled an
+     * `ensureFresh` wrapper for exactly this) and {@link TokenManager}'s
+     * proactive-refresh discipline.
+     */
+    maxAgeMs?: number;
+    /** Injectable clock for {@link maxAgeMs} staleness (defaults to `Date.now`) — for tests. */
+    now?: () => number;
+    /**
+     * Called when {@link CookieSessionManager.withSession}'s expiry-replay
+     * re-login FAILS — by default that failure is swallowed and the original
+     * expired-looking response is returned, which hides an actionable login
+     * error (e.g. "fetchproxy bridge down — open a signed-in tab") behind a
+     * generic 401. Use this hook to record the error (infinitecampus's
+     * `lastLoginError` bookkeeping) or `throw err` inside it to surface the
+     * login failure to the caller instead of the stale response.
+     */
+    onReplayLoginError?: (err: unknown) => void;
 }
 /**
  * Cookie-session analog of {@link TokenManager}: owns a site's cookie-session
@@ -352,12 +374,19 @@ export declare class CookieSessionManager<S = CookieSession, R = Response> {
     private inFlight;
     /** A cached *permanent* config error: once set, every `ensure` rethrows it. */
     private permanentError;
+    /** When the current session was minted (login) or installed (seed) — for maxAgeMs. */
+    private sessionAt;
     private readonly loginFn;
     private readonly isExpiredFn;
     private readonly isPermanentErrorFn;
+    private readonly maxAgeMs;
+    private readonly now;
+    private readonly onReplayLoginErrorFn;
     constructor(opts: CookieSessionManagerOptions<S, R>);
     /** The current session, or `undefined` before the first successful login. */
     get current(): S | undefined;
+    /** True when {@link CookieSessionManagerOptions.maxAgeMs} says the session is too old. */
+    private isStale;
     /**
      * Return the current session, or single-flight a login if there is none.
      *
@@ -366,8 +395,22 @@ export declare class CookieSessionManager<S = CookieSession, R = Response> {
      * the next call retries. A login error classified permanent by
      * {@link CookieSessionManagerOptions.isPermanentError} is cached and rethrown
      * on every later call; a transient error is not cached (next call retries).
+     * With {@link CookieSessionManagerOptions.maxAgeMs} set, a session past its
+     * TTL is invalidated first, so the call falls through to a (single-flight)
+     * re-login.
      */
     ensure(): Promise<S>;
+    /**
+     * Install an externally-minted session (e.g. infinitecampus's CUPS linked-
+     * district discovery, which mints sessions outside {@link
+     * CookieSessionManagerOptions.login}). The seed becomes the current session
+     * with a fresh {@link CookieSessionManagerOptions.maxAgeMs} clock, and any
+     * in-flight login is DETACHED: its waiters still receive its result, but a
+     * late resolution will not overwrite the seed. A cached permanent config
+     * error is left intact — the login path is still misconfigured, and the next
+     * post-seed re-login should keep saying so.
+     */
+    seed(session: S): void;
     /**
      * One login attempt. Self-clears `inFlight` on settle so a rejected login
      * never sticks, and stamps the resulting session only while it's still the

package/dist/session/index.d.ts.map

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