@taurgis/bonsai 1.0.6 → 3.0.0

package/dist/lib/research/docs/remote-search.js

@@ -1,101 +0,0 @@
-// Algolia identifiers extracted from untrusted page HTML are interpolated into the request URL, so
-// they MUST be format-validated to prevent SSRF (an unvalidated appId like "evil.com/x" would point
-// the request at an attacker host). App IDs are uppercase alphanumeric; public search keys are hex;
-// the index name must contain no slash (it is path-encoded but we still reject separators).
-const ALGOLIA_APP_ID_RE = /^[A-Z0-9]{6,24}$/;
-const ALGOLIA_API_KEY_RE = /^[a-f0-9]{16,64}$/;
-const ALGOLIA_INDEX_RE = /^[A-Za-z0-9._~-]{1,128}$/;
-// Pulls a DocSearch config out of embedded site data. Returns null unless all three fields are
-// present AND well-formed — a partial or malformed signal is not enough to query.
-export function extractAlgoliaConfig(html) {
-    const text = html.replace(/\\"/g, '"');
-    const appId = text.match(/"appId"\s*:\s*"([^"]+)"/)?.[1];
-    const apiKey = text.match(/"apiKey"\s*:\s*"([^"]+)"/)?.[1];
-    const indexName = text.match(/"indexName"\s*:\s*"([^"]+)"/)?.[1];
-    if (!appId || !apiKey || !indexName)
-        return null;
-    if (!ALGOLIA_APP_ID_RE.test(appId) ||
-        !ALGOLIA_API_KEY_RE.test(apiKey) ||
-        !ALGOLIA_INDEX_RE.test(indexName)) {
-        return null;
-    }
-    return { appId, apiKey, indexName };
-}
-export function algoliaQueryUrl(config) {
-    return `https://${config.appId}-dsn.algolia.net/1/indexes/${encodeURIComponent(config.indexName)}/query`;
-}
-// DocSearch records nest the page hierarchy under `hierarchy` and the page URL under `url`.
-function algoliaTitle(hit) {
-    const h = hit?.hierarchy ?? {};
-    // Prefer the deepest (most specific) hierarchy level present.
-    for (const level of ['lvl6', 'lvl5', 'lvl4', 'lvl3', 'lvl2', 'lvl1', 'lvl0']) {
-        if (h[level])
-            return String(h[level]);
-    }
-    return hit?.url ?? 'Untitled';
-}
-export function parseAlgoliaResponse(body, indexUrl) {
-    const data = JSON.parse(body);
-    if (!Array.isArray(data.hits))
-        throw new Error('Algolia response missing "hits"');
-    return data.hits
-        .filter((hit) => typeof hit?.url === 'string')
-        .map((hit, i) => ({
-        title: algoliaTitle(hit),
-        url: hit.url,
-        snippet: hit?.content ?? undefined,
-        provider: 'algolia-docsearch',
-        score: data.hits.length - i, // preserve Algolia's relevance order
-        indexUrl,
-    }));
-}
-function vitepressUrl(base, id) {
-    try {
-        return new URL(id, base).toString();
-    }
-    catch {
-        return null;
-    }
-}
-// Ranks one VitePress doc by query term hits: a title match weighs 10×, body occurrences 1× each
-// (capped at 5). Kept separate so the search loop stays a flat filter → score → format.
-function scoreVitePressDoc(doc, terms) {
-    const haystack = `${doc.title ?? ''} ${(doc.titles ?? []).join(' ')} ${doc.text ?? ''}`.toLowerCase();
-    let score = 0;
-    for (const term of terms) {
-        if ((doc.title ?? '').toLowerCase().includes(term))
-            score += 10;
-        score += Math.min(haystack.split(term).length - 1, 5);
-    }
-    return score;
-}
-/**
- * Parses a VitePress local search index (MiniSearch documents) and ranks docs by query term hits.
- * `base` is the docs site origin/base used to resolve the relative `id` routes.
- */
-export function searchVitePressLocalIndex(body, indexUrl, base, query) {
-    const docs = JSON.parse(body);
-    if (!Array.isArray(docs))
-        throw new Error('VitePress local index is not an array');
-    const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
-    const results = [];
-    for (const doc of docs) {
-        if (!doc.id)
-            continue;
-        const score = scoreVitePressDoc(doc, terms);
-        if (score <= 0)
-            continue;
-        const url = vitepressUrl(base, doc.id);
-        if (!url)
-            continue;
-        results.push({
-            title: doc.title ?? doc.id,
-            url,
-            snippet: (doc.text ?? '').slice(0, 150),
-            provider: 'vitepress-local',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}

package/dist/lib/research/docs/search-index.d.ts

@@ -1,13 +0,0 @@
-import type { SearchProvider } from './capabilities.js';
-export interface DocsSearchResult {
-    title: string;
-    url: string;
-    anchor?: string;
-    snippet?: string;
-    provider: SearchProvider;
-    score: number;
-    indexUrl: string;
-}
-export declare function searchMkDocsIndex(body: string, indexUrl: string, query: string): DocsSearchResult[];
-export declare function searchJekyllIndex(body: string, indexUrl: string, query: string): DocsSearchResult[];
-export declare function searchSphinxIndex(js: string, indexUrl: string, query: string): DocsSearchResult[];

package/dist/lib/research/docs/search-index.js

@@ -1,176 +0,0 @@
-function queryTerms(query) {
-    return query.toLowerCase().split(/\s+/).filter(Boolean);
-}
-// Score = title term hits (heavy) + body term hits (light). Zero means no match (dropped).
-function scoreText(title, body, terms) {
-    const t = title.toLowerCase();
-    const b = body.toLowerCase();
-    let score = 0;
-    for (const term of terms) {
-        if (t.includes(term))
-            score += 10;
-        const bodyHits = b.split(term).length - 1;
-        score += Math.min(bodyHits, 5);
-    }
-    return score;
-}
-function snippetFrom(text, terms) {
-    const lower = text.toLowerCase();
-    let idx = 0;
-    for (const term of terms) {
-        const found = lower.indexOf(term);
-        if (found !== -1) {
-            idx = found;
-            break;
-        }
-    }
-    const start = Math.max(0, idx - 40);
-    return text
-        .slice(start, start + 150)
-        .replace(/\s+/g, ' ')
-        .trim();
-}
-function splitAnchor(location) {
-    const hashIdx = location.indexOf('#');
-    if (hashIdx === -1)
-        return { path: location };
-    return { path: location.slice(0, hashIdx), anchor: location.slice(hashIdx + 1) || undefined };
-}
-function resolve(base, relative) {
-    try {
-        return new URL(relative, base).toString();
-    }
-    catch {
-        return null;
-    }
-}
-// MkDocs / Material for MkDocs: { docs: [ { location: "page/#anchor", title, text } ] }.
-// Locations are relative to the site root (the index sits at <root>/search/search_index.json).
-export function searchMkDocsIndex(body, indexUrl, query) {
-    const data = JSON.parse(body);
-    if (!Array.isArray(data.docs))
-        throw new Error('MkDocs index missing "docs" array');
-    const root = resolve(indexUrl, '../') ?? indexUrl;
-    const terms = queryTerms(query);
-    const results = [];
-    for (const doc of data.docs) {
-        if (!doc.location && doc.location !== '')
-            continue;
-        const { path, anchor } = splitAnchor(doc.location ?? '');
-        const url = resolve(root, path);
-        if (!url)
-            continue;
-        const score = scoreText(doc.title ?? '', doc.text ?? '', terms);
-        if (score <= 0)
-            continue;
-        results.push({
-            title: doc.title ?? path,
-            url,
-            anchor,
-            snippet: snippetFrom(doc.text ?? '', terms),
-            provider: 'mkdocs-local',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}
-// Just the Docs: { "0": { title, content, url|relUrl }, "1": {...} } keyed by stringified ints.
-export function searchJekyllIndex(body, indexUrl, query) {
-    const data = JSON.parse(body);
-    if (typeof data !== 'object' || data === null)
-        throw new Error('Jekyll index is not an object');
-    const terms = queryTerms(query);
-    const results = [];
-    for (const entry of Object.values(data)) {
-        const rel = entry.url ?? entry.relUrl;
-        if (!rel)
-            continue;
-        const { path, anchor } = splitAnchor(rel);
-        const url = resolve(indexUrl, path);
-        if (!url)
-            continue;
-        const score = scoreText(entry.title ?? '', entry.content ?? '', terms);
-        if (score <= 0)
-            continue;
-        results.push({
-            title: entry.title ?? path,
-            url,
-            anchor,
-            snippet: snippetFrom(entry.content ?? '', terms),
-            provider: 'jekyll-json',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}
-// Extracts the object literal from `Search.setIndex({...})` as inert data and JSON.parses it —
-// never eval. Anchors on the `setIndex(` call so leading comments/whitespace can't shift the slice;
-// falls back to first-`{`/last-`}` for index variants that assign the object differently.
-function parseSphinxObject(js) {
-    const call = js.indexOf('setIndex(');
-    const start = call !== -1 ? js.indexOf('{', call) : js.indexOf('{');
-    const end = js.lastIndexOf('}');
-    if (start === -1 || end <= start)
-        throw new Error('Sphinx index has no object literal');
-    return JSON.parse(js.slice(start, end + 1));
-}
-function collectDocIndices(map, terms) {
-    const hits = new Map();
-    if (!map)
-        return hits;
-    for (const [word, posting] of Object.entries(map)) {
-        const lower = word.toLowerCase();
-        if (!terms.some((t) => lower.includes(t)))
-            continue;
-        const docs = Array.isArray(posting) ? posting : [posting];
-        for (const d of docs)
-            hits.set(d, (hits.get(d) ?? 0) + 1);
-    }
-    return hits;
-}
-// Scores each Sphinx doc index by term hits: title-term hits and exact title matches weigh 10×,
-// body-term hits 1×. Kept separate so the search function stays a flat parse → score → format.
-function scoreSphinxDocs(index, terms, titles) {
-    const scores = new Map();
-    for (const [doc, count] of collectDocIndices(index.titleterms, terms)) {
-        scores.set(doc, (scores.get(doc) ?? 0) + count * 10);
-    }
-    for (const [doc, count] of collectDocIndices(index.terms, terms)) {
-        scores.set(doc, (scores.get(doc) ?? 0) + count);
-    }
-    for (let i = 0; i < titles.length; i++) {
-        if (terms.some((t) => (titles[i] ?? '').toLowerCase().includes(t))) {
-            scores.set(i, (scores.get(i) ?? 0) + 10);
-        }
-    }
-    return scores;
-}
-// Sphinx searchindex.js. Page URLs are docname + ".html" relative to the index's directory.
-export function searchSphinxIndex(js, indexUrl, query) {
-    const index = parseSphinxObject(js);
-    const docnames = index.docnames ?? [];
-    const titles = index.titles ?? [];
-    if (docnames.length === 0)
-        throw new Error('Sphinx index has no docnames');
-    const terms = queryTerms(query);
-    const scores = scoreSphinxDocs(index, terms, titles);
-    const results = [];
-    for (const [doc, score] of scores) {
-        const name = docnames[doc];
-        if (!name || score <= 0)
-            continue;
-        const url = resolve(indexUrl, `${name}.html`);
-        if (!url)
-            continue;
-        results.push({
-            title: titles[doc] ?? name,
-            url,
-            provider: 'sphinx-searchindex',
-            score,
-            indexUrl,
-        });
-    }
-    return results.sort((a, b) => b.score - a.score);
-}

package/dist/sites/algolia.d.ts

@@ -1,9 +0,0 @@
-import type { SiteModule } from './types.js';
-export declare function createAlgoliaSite(id: string, name: string, domains: string[], appId: string, apiKey: string, indexName: string): SiteModule;
-export declare const react: SiteModule;
-export declare const vue: SiteModule;
-export declare const tailwind: SiteModule;
-export declare const jest: SiteModule;
-export declare const cypress: SiteModule;
-export declare const vitest: SiteModule;
-export declare const vitepress: SiteModule;

package/dist/sites/algolia.js

@@ -1,26 +0,0 @@
-import { algoliaQueryUrl, parseAlgoliaResponse } from '../lib/research/docs/remote-search.js';
-import { postJson } from '../lib/research/fetcher.js';
-export function createAlgoliaSite(id, name, domains, appId, apiKey, indexName) {
-    return {
-        id,
-        name,
-        domains,
-        search: async (query) => {
-            const url = algoliaQueryUrl({ appId, apiKey, indexName });
-            const bodyParams = { params: `query=${encodeURIComponent(query)}&hitsPerPage=20` };
-            const res = await postJson(url, bodyParams, {
-                'Content-Type': 'application/json',
-                'X-Algolia-API-Key': apiKey,
-                'X-Algolia-Application-Id': appId,
-            });
-            return parseAlgoliaResponse(res, url);
-        },
-    };
-}
-export const react = createAlgoliaSite('react', 'React', ['react.dev', 'legacy.reactjs.org'], '1FCF9AYYAT', '1b7ad4e1c89e645e351e59d40544eda1', 'beta-react');
-export const vue = createAlgoliaSite('vue', 'Vue.js', ['vuejs.org'], 'ML0LEBN7FQ', '10e7a8b13e6aec4007343338ab134e05', 'vuejs');
-export const tailwind = createAlgoliaSite('tailwind', 'Tailwind CSS', ['tailwindcss.com'], 'KNPXZI5B0M', '5fc87cef58bb80203d2207578309fab6', 'tailwindcss');
-export const jest = createAlgoliaSite('jest', 'Jest', ['jestjs.io'], 'HP439UUSOL', 'e5e670fd16f8f17caada79d6b0931682', 'jest-v2');
-export const cypress = createAlgoliaSite('cypress', 'Cypress', ['docs.cypress.io', 'cypress.io'], 'R9KDA5FMJB', 'b4af59e23bc2fa05281af7dcf13fcae5', 'cypress_docs');
-export const vitest = createAlgoliaSite('vitest', 'Vitest', ['vitest.dev'], 'ZTF29HGJ69', '9c3ced6fed60d2670bb36ab7e8bed8bc', 'vitest');
-export const vitepress = createAlgoliaSite('vitepress', 'VitePress', ['vitepress.dev'], '8J64VVRP8K', '52f578a92b88ad6abde815aae2b0ad7c', 'vitepress');

package/dist/sites/auto.d.ts

@@ -1,8 +0,0 @@
-import type { SiteModule } from './types.js';
-export declare function createAutoSite(id: string, name: string, domains: string[], docsUrl: string): SiteModule;
-export declare const angular: SiteModule;
-export declare const redux: SiteModule;
-export declare const vite: SiteModule;
-export declare const fastify: SiteModule;
-export declare const rollup: SiteModule;
-export declare const vueuse: SiteModule;

package/dist/sites/auto.js

@@ -1,30 +0,0 @@
-import { runRemoteDocsSearch } from '../lib/research/docs/remote-search-runner.js';
-import { fetchStaticHtml, fetchText, postJson } from '../lib/research/fetcher.js';
-export function createAutoSite(id, name, domains, docsUrl) {
-    return {
-        id,
-        name,
-        domains,
-        search: async (query) => {
-            const deps = {
-                fetchStatic: async (url) => {
-                    const res = await fetchStaticHtml(url);
-                    return { content: res.content, finalUrl: res.finalUrl };
-                },
-                fetchText: async (url) => {
-                    const res = await fetchText(url);
-                    return { content: res.content, status: res.status };
-                },
-                postJson: (url, body, headers) => postJson(url, body, headers),
-            };
-            const { results } = await runRemoteDocsSearch(docsUrl, query, deps);
-            return results;
-        },
-    };
-}
-export const angular = createAutoSite('angular', 'Angular', ['angular.dev'], 'https://angular.dev');
-export const redux = createAutoSite('redux', 'Redux', ['redux.js.org'], 'https://redux.js.org');
-export const vite = createAutoSite('vite', 'Vite', ['vitejs.dev', 'vite.dev'], 'https://vite.dev');
-export const fastify = createAutoSite('fastify', 'Fastify', ['fastify.dev', 'fastify.io'], 'https://fastify.dev');
-export const rollup = createAutoSite('rollup', 'Rollup', ['rollupjs.org'], 'https://rollupjs.org');
-export const vueuse = createAutoSite('vueuse', 'VueUse', ['vueuse.org'], 'https://vueuse.org');

package/dist/sites/nextjs/index.d.ts

@@ -1,2 +0,0 @@
-import type { SiteModule } from '../types.js';
-export declare const nextjs: SiteModule;

package/dist/sites/nextjs/index.js

@@ -1,52 +0,0 @@
-import { postJson } from '../../lib/research/fetcher.js';
-export const nextjs = {
-    id: 'nextjs',
-    name: 'Next.js',
-    domains: ['nextjs.org'],
-    search: async (query) => {
-        const url = 'https://nextjs.org/api/search';
-        const bodyStr = await postJson(url, { query, version: 'stable', routerType: 'app' }, {});
-        let data;
-        try {
-            // The Next.js API returns a JSON array sometimes or a JSON object with 'hits'
-            const parsed = JSON.parse(bodyStr);
-            if (Array.isArray(parsed)) {
-                data = parsed;
-            }
-            else if (parsed && Array.isArray(parsed.hits)) {
-                data = parsed.hits;
-            }
-            else {
-                throw new Error('Unexpected response format from Next.js search');
-            }
-        }
-        catch (err) {
-            throw new Error(`Failed to parse Next.js search response: ${err.message}`);
-        }
-        const queryLower = query.toLowerCase();
-        return data.map((item) => {
-            const content = item.content || '';
-            let snippet = content;
-            const idx = content.toLowerCase().indexOf(queryLower);
-            if (idx !== -1) {
-                const start = Math.max(0, idx - 40);
-                const end = Math.min(content.length, idx + 110);
-                snippet = content.slice(start, end);
-                if (start > 0)
-                    snippet = '...' + snippet;
-                if (end < content.length)
-                    snippet = snippet + '...';
-            }
-            else {
-                snippet = content.slice(0, 150);
-            }
-            // Clean up whitespace and newlines so it looks like a snippet and not a raw script
-            snippet = snippet.replace(/\s+/g, ' ').trim();
-            return {
-                url: `https://nextjs.org${item.path}${item.anchor ? `#${item.anchor}` : ''}`,
-                title: item.title ? `${item.pageTitle} - ${item.title}` : item.pageTitle || 'Untitled',
-                snippet,
-            };
-        });
-    },
-};

package/dist/sites/react/index.d.ts

@@ -1,2 +0,0 @@
-import type { SiteModule } from '../types.js';
-export declare const react: SiteModule;

package/dist/sites/react/index.js

@@ -1,17 +0,0 @@
-import { algoliaQueryUrl, parseAlgoliaResponse } from '../../lib/research/docs/remote-search.js';
-import { postJson } from '../../lib/research/fetcher.js';
-export const react = {
-    id: 'react',
-    name: 'React',
-    domains: ['react.dev', 'legacy.reactjs.org'],
-    search: async (query) => {
-        const config = {
-            appId: '1FCF9AYYAT',
-            apiKey: '1b7ad4e1c89e645e351e59d40544eda1',
-            indexName: 'beta-react'
-        };
-        const url = algoliaQueryUrl(config);
-        const body = await postJson(url, { params: `query=${encodeURIComponent(query)}` }, { 'X-Algolia-API-Key': config.apiKey, 'X-Algolia-Application-Id': config.appId });
-        return parseAlgoliaResponse(body, url);
-    }
-};

package/dist/sites/salesforce/browser-search.d.ts

@@ -1,7 +0,0 @@
-import type { SiteSearchResult } from '../types.js';
-/**
- * Searches Salesforce Help via Coveo. Reuses a cached token for a direct API call when
- * possible; otherwise drives a headless browser, reads the page's own Coveo search response,
- * and caches the Coveo token (intercepted from the page's Aura call) for the next run.
- */
-export declare function searchSalesforce(query: string, limit?: number): Promise<SiteSearchResult[]>;

package/dist/sites/salesforce/browser-search.js

@@ -1,82 +0,0 @@
-import { openCdpPage, waitForLoad, ResponseCapture } from '../../lib/research/browser.js';
-import { checkDnsSafety } from '../../lib/research/fetcher.js';
-import { buildSearchPageUrl, extractCoveoResults, searchCoveoDirect, COVEO_SEARCH_PATH, AURA_PATH, } from './coveo.js';
-import { loadToken, storeToken, isTokenValid, parseAuraToken } from './token.js';
-const DEFAULT_LIMIT = 10;
-const PAGE_LOAD_TIMEOUT_MS = 15_000;
-const COVEO_WAIT_MS = 30_000;
-const TOKEN_WAIT_MS = 5_000;
-const DEBUG = Boolean(process.env.RESEARCH_DEBUG);
-function dbg(message) {
-    if (DEBUG)
-        console.error(`[salesforce-search] ${message}`);
-}
-// Salesforce gates content behind a OneTrust cookie banner; dismissing it lets the page run.
-const ACCEPT_CONSENT_EXPRESSION = "(() => { const b = document.querySelector('#onetrust-accept-btn-handler'); if (b) b.click(); })()";
-/**
- * Searches Salesforce Help via Coveo. Reuses a cached token for a direct API call when
- * possible; otherwise drives a headless browser, reads the page's own Coveo search response,
- * and caches the Coveo token (intercepted from the page's Aura call) for the next run.
- */
-export async function searchSalesforce(query, limit = DEFAULT_LIMIT) {
-    const cached = loadToken();
-    if (cached && isTokenValid(cached.expiresAtMs)) {
-        dbg('using cached token (direct Coveo call)');
-        const results = extractCoveoResults(await searchCoveoDirect(cached, query, limit), limit);
-        if (results.length)
-            return results;
-        dbg('cached token returned no results; falling back to browser');
-    }
-    return searchViaBrowser(query, limit);
-}
-async function searchViaBrowser(query, limit) {
-    await checkDnsSafety('help.salesforce.com');
-    const page = await openCdpPage();
-    try {
-        // No asset blocking: the search SPA must fully boot to run its query and mint its token.
-        const capture = new ResponseCapture(page, [
-            { key: 'coveo', test: ({ url }) => url.includes(COVEO_SEARCH_PATH) },
-            // help.salesforce.com runs on LWR (no global $A to mint a token ourselves), so we
-            // intercept the page's own Aura token response — the one whose body parses to a token.
-            {
-                key: 'token',
-                test: ({ url }) => url.includes(AURA_PATH),
-                accept: (body) => parseAuraToken(body) !== null,
-            },
-        ]);
-        await page.client.send('Page.navigate', { url: buildSearchPageUrl(query) }, page.sessionId);
-        await waitForLoad(page.client, page.sessionId, PAGE_LOAD_TIMEOUT_MS).catch(() => { });
-        await page.client
-            .send('Runtime.evaluate', { expression: ACCEPT_CONSENT_EXPRESSION }, page.sessionId)
-            .catch(() => { });
-        const coveoBody = await capture.waitFor('coveo', COVEO_WAIT_MS);
-        await cacheToken(capture);
-        if (!coveoBody) {
-            dbg('no Coveo search response captured');
-            return [];
-        }
-        return extractCoveoResults(parseJson(coveoBody), limit);
-    }
-    finally {
-        await page.close();
-    }
-}
-async function cacheToken(capture) {
-    const tokenBody = await capture.waitFor('token', TOKEN_WAIT_MS);
-    const token = tokenBody ? parseAuraToken(tokenBody) : null;
-    if (token) {
-        storeToken(token);
-        dbg('cached Coveo token for next run');
-    }
-    else {
-        dbg('no Aura token response intercepted; next run will use the browser again');
-    }
-}
-function parseJson(text) {
-    try {
-        return JSON.parse(text);
-    }
-    catch {
-        return null;
-    }
-}

package/dist/sites/salesforce/coveo.d.ts

@@ -1,23 +0,0 @@
-import type { SiteSearchResult } from '../types.js';
-import { type TokenInfo } from './token.js';
-export declare const ALLOWED_DOC_HOSTS: Set<string>;
-export declare const SEARCH_PAGE_URL = "https://help.salesforce.com/s/search-result";
-export declare const COVEO_SEARCH_PATH = "/services/apexrest/coveo/analytics/rest/search/v2";
-export declare const DEFAULT_LANGUAGE = "en_US";
-export declare const AURA_PATH = "/s/sfsites/aura";
-export declare function isAllowedDocHost(hostname: string): boolean;
-/** The search page reads its query from the URL hash, so this URL is browser-only (never normalized). */
-export declare function buildSearchPageUrl(query: string, language?: string): string;
-/**
- * Coveo indexes Help articles under an internal `/help_doccontent` URL; rewrite it to the
- * canonical `/s/articleView` page a human (or our fetcher) can actually open.
- */
-export declare function normalizeHelpDocContentUrl(rawUrl: string): string;
-/** Maps a raw Coveo response into deduped, host-validated search results. */
-export declare function extractCoveoResults(data: unknown, limit: number): SiteSearchResult[];
-/**
- * Direct Coveo Search API call using a cached token — the no-browser fast path.
- * Tries a bearer header first, then falls back to a query-string token on auth rejection.
- * Returns the parsed response body (with a `results` array) or null on failure.
- */
-export declare function searchCoveoDirect(tokenInfo: TokenInfo, query: string, limit: number, language?: string, timeoutMs?: number): Promise<unknown | null>;