@get-technology-inc/jamf-docs-mcp-server 5.6.0 → 5.8.0

package/dist/core/services/intercom-service.js

@@ -0,0 +1,312 @@
+/**
+ * Reading an Intercom Help Center.
+ *
+ * support.jamf.com is a Next.js app whose every page embeds its own data as
+ * JSON in `<script id="__NEXT_DATA__">`. That is the source of truth: the
+ * rendered DOM is a view of it, and parsing the JSON avoids guessing at
+ * class names that change with any theme update.
+ *
+ * The content model is a block list, not HTML, so it is rendered to Markdown
+ * here rather than going through `content-parser`.
+ */
+import * as cheerio from 'cheerio';
+import { httpGetText } from '../http-client.js';
+import { cacheKey } from './cache-key.js';
+import { PAGINATION_CONFIG, TOKEN_CONFIG } from '../constants.js';
+import { calculatePagination, truncateListByTokens, buildPaginationNote, } from './tokenizer.js';
+// ─── __NEXT_DATA__ ──────────────────────────────────────────────
+/**
+ * Pull the embedded page data out of an Intercom Help Center page.
+ *
+ * The opening tag carries a `nonce` attribute, so a regex anchored on
+ * `<script id="__NEXT_DATA__" type="application/json">` misses every page.
+ * Matching up to the first `>` is what makes it robust to attribute drift.
+ */
+export function parseNextData(html) {
+    const match = /<script id="__NEXT_DATA__"[^>]*>([\s\S]*?)<\/script>/.exec(html);
+    if (match?.[1] === undefined) {
+        return null;
+    }
+    try {
+        return JSON.parse(match[1]);
+    }
+    catch {
+        return null;
+    }
+}
+/** `props.pageProps`, or null when the page is not shaped like one. */
+function pageProps(html) {
+    const data = parseNextData(html);
+    const props = data?.props?.pageProps;
+    return typeof props === 'object' && props !== null
+        ? props
+        : null;
+}
+/**
+ * A JSON value read back as a string, or the fallback.
+ *
+ * `String(value)` on an `unknown` renders an object as "[object Object]" and
+ * puts it straight into a title. These payloads come off the wire, so the
+ * narrowing has to happen at the boundary rather than being asserted.
+ */
+function asString(value, fallback = '') {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (typeof value === 'number') {
+        return String(value);
+    }
+    return fallback;
+}
+/** Inline HTML inside a block's `text`, flattened to Markdown-safe text. */
+function inlineText(html) {
+    const $ = cheerio.load(`<div>${html}</div>`);
+    $('a[href]').each((_, el) => {
+        const href = $(el).attr('href') ?? '';
+        const label = $(el).text();
+        if (href !== '' && label !== '') {
+            $(el).replaceWith(`[${label}](${href})`);
+        }
+    });
+    $('code').each((_, el) => { $(el).replaceWith(`\`${$(el).text()}\``); });
+    $('strong, b').each((_, el) => { $(el).replaceWith(`**${$(el).text()}**`); });
+    $('em, i').each((_, el) => { $(el).replaceWith(`*${$(el).text()}*`); });
+    return $('div').text().replace(/\s+/g, ' ').trim();
+}
+/**
+ * Render a nested list.
+ *
+ * A list item carries its text as a `content` block array — usually a single
+ * `paragraph` — not as `text`. The block's own `text` is a pre-rendered
+ * string of the whole list ("1. …\n2. …"), which is why reading `item.text`
+ * produces empty bullets rather than an obvious error: every item has the
+ * field, and it is undefined on all of them.
+ *
+ * Nested lists arrive as further list blocks inside that same `content`, so
+ * they are rendered by recursing through {@link renderBlocks} with the depth
+ * carried in the indent.
+ */
+function renderList(items, ordered, depth) {
+    const indent = '  '.repeat(depth);
+    return items
+        .map((item, index) => {
+        const bullet = ordered ? `${String(index + 1)}.` : '-';
+        const body = item.content !== undefined && item.content.length > 0
+            ? renderBlocks(item.content, depth + 1).trim()
+            : inlineText(item.text ?? '');
+        if (body === '') {
+            return '';
+        }
+        const [first = '', ...rest] = body.split('\n');
+        const continuation = rest.map(line => `${indent}  ${line}`).join('\n');
+        return `${indent}${bullet} ${first}\n${continuation === '' ? '' : `${continuation}\n`}`;
+    })
+        .join('');
+}
+/**
+ * The blocks that map to one Markdown construct each.
+ *
+ * Split from {@link renderBlock} so the two nesting types — `callout` and
+ * `collapsibleSection`, which recurse — stay legible next to each other
+ * rather than at the bottom of one long switch. Returns null for anything it
+ * does not handle.
+ */
+function renderSimpleBlock(block, depth) {
+    switch (block.type) {
+        case 'heading':
+            return `## ${inlineText(block.text ?? '')}\n\n`;
+        case 'subheading':
+            return `### ${inlineText(block.text ?? '')}\n\n`;
+        case 'paragraph': {
+            const text = inlineText(block.text ?? '');
+            return text === '' ? '' : `${text}\n\n`;
+        }
+        case 'orderedNestedList':
+            return `${renderList(block.items ?? [], true, depth)}\n`;
+        case 'unorderedNestedList':
+            return `${renderList(block.items ?? [], false, depth)}\n`;
+        case 'code':
+            return `\`\`\`\n${block.text ?? ''}\n\`\`\`\n\n`;
+        case 'horizontalRule':
+            return '---\n\n';
+        case 'image':
+            return block.url !== undefined ? `![](${block.url})\n\n` : '';
+        case undefined:
+        default:
+            return null;
+    }
+}
+/**
+ * Render one Intercom block.
+ *
+ * Ten types occur across the live corpus, not the four the integration notes
+ * listed. `callout` and `collapsibleSection` nest their body under `content`
+ * rather than `text`, and `subheading`, `unorderedNestedList`,
+ * `collapsibleSection`, `image`, `code` and `horizontalRule` would all be
+ * dropped by a renderer that only knew the four — silently, since a missing
+ * block leaves no trace in the output.
+ */
+export function renderBlock(block, depth = 0) {
+    const simple = renderSimpleBlock(block, depth);
+    if (simple !== null) {
+        return simple;
+    }
+    switch (block.type) {
+        case 'callout':
+            // Rendered as a blockquote: a callout is emphasis, and losing it would
+            // turn "do not do this" into an ordinary sentence.
+            return `${renderBlocks(block.content ?? [])
+                .trimEnd()
+                .split('\n')
+                .map(line => `> ${line}`)
+                .join('\n')}\n\n`;
+        case 'collapsibleSection':
+            return `**${inlineText(block.summary ?? '')}**\n\n${renderBlocks(block.content ?? [])}`;
+        case undefined:
+        default:
+            // Unknown type: keep whatever text it has rather than dropping the
+            // block. Intercom adds types over time and silence is the worse
+            // failure — a reader cannot tell a missing paragraph from one that was
+            // never written.
+            return block.text !== undefined ? `${inlineText(block.text)}\n\n` : '';
+    }
+}
+export function renderBlocks(blocks, depth = 0) {
+    return blocks.map(block => renderBlock(block, depth)).join('');
+}
+/**
+ * Parse one Help Center article page.
+ *
+ * `articleContent.markdown` exists on every article and is `null` on every
+ * one measured — the body is in `blocks`. Reading the field that is named
+ * for what you want is the trap here.
+ */
+export function parseIntercomArticle(html) {
+    const props = pageProps(html);
+    const article = props?.articleContent;
+    if (article === undefined) {
+        return null;
+    }
+    const blocks = (article.blocks ?? []);
+    // `breadcrumbs` is a sibling of `articleContent` under pageProps, not a key
+    // of it.
+    const crumbs = (props?.breadcrumbs ?? []);
+    return {
+        title: asString(article.title, 'Untitled'),
+        content: renderBlocks(blocks).trim(),
+        ...(typeof article.description === 'string' && article.description !== ''
+            ? { description: article.description } : {}),
+        ...(typeof article.lastUpdatedDate === 'string'
+            ? { lastUpdated: article.lastUpdatedDate.slice(0, 10) } : {}),
+        breadcrumb: crumbs
+            .map(crumb => crumb.label ?? crumb.name ?? '')
+            .filter(label => label !== ''),
+    };
+}
+function slugFromUrl(url) {
+    const last = url.replace(/\/$/, '').split('/').pop() ?? '';
+    // `/collections/12369024-jamf-pro` → `jamf-pro`. The numeric id is
+    // Intercom's and changes if a collection is recreated; the slug is what a
+    // reader recognises, so it is what publication ids are built from.
+    return last.replace(/^\d+-/, '');
+}
+/** The Help Center's top-level collections for one locale. */
+export async function listIntercomCollections(ctx, source, locale) {
+    const key = cacheKey('intercom-collections', { source: source.id, locale });
+    const cached = await ctx.cache.get(key);
+    if (cached !== null) {
+        return cached;
+    }
+    const html = await httpGetText(`${source.baseUrl}/${locale}/`);
+    const props = pageProps(html);
+    const home = props?.home;
+    const collections = (home?.collections ?? []).map((collection) => {
+        const url = asString(collection.url);
+        return {
+            id: asString(collection.id),
+            slug: typeof collection.slug === 'string' && collection.slug !== ''
+                ? collection.slug
+                : slugFromUrl(url),
+            name: asString(collection.name),
+            description: asString(collection.description),
+            url,
+            articleCount: typeof collection.articleCount === 'number' ? collection.articleCount : 0,
+        };
+    });
+    await ctx.cache.set(key, collections, ctx.config.cacheTtl.products);
+    return collections;
+}
+/**
+ * The article tree of one collection.
+ *
+ * A collection page's `__NEXT_DATA__` carries the whole subtree —
+ * subcollections and every article summary — so one request answers what
+ * crawling 356 article pages would.
+ */
+export async function fetchIntercomCollectionToc(ctx, source, collection) {
+    const key = cacheKey('intercom-collection-toc', { source: source.id, collection: collection.id });
+    const cached = await ctx.cache.get(key);
+    if (cached !== null) {
+        return cached;
+    }
+    const html = await httpGetText(collection.url);
+    const props = pageProps(html);
+    const raw = props?.collection;
+    const toEntries = (summaries) => (summaries ?? []).map(summary => ({
+        title: asString(summary.title, 'Untitled'),
+        url: asString(summary.url),
+    }));
+    const entries = [
+        // Articles that sit directly in the collection come first: they are the
+        // ones with no subcollection to file them under, and dropping them is
+        // the easy mistake — Jamf Pro has 11 of them beside 24 subcollections.
+        ...toEntries(raw?.articleSummaries),
+        ...(raw?.subcollections ?? []).map((sub) => {
+            const children = toEntries(sub.articleSummaries);
+            const entry = {
+                title: asString(sub.name, 'Untitled'),
+                url: asString(sub.url),
+            };
+            if (children.length > 0) {
+                entry.children = children;
+            }
+            return entry;
+        }),
+    ];
+    await ctx.cache.set(key, entries, ctx.config.cacheTtl.products);
+    return entries;
+}
+/**
+ * A `FetchTocResult` for one Intercom collection.
+ *
+ * Pagination and truncation match the other TOC paths, so a caller cannot
+ * tell from the response shape which kind of source answered.
+ */
+export async function fetchIntercomToc(ctx, source, collection, options = {}) {
+    const page = options.page ?? PAGINATION_CONFIG.DEFAULT_PAGE;
+    const maxTokens = options.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+    const allToc = await fetchIntercomCollectionToc(ctx, source, collection);
+    const count = (entries) => entries.reduce((total, entry) => total + 1 + (entry.children !== undefined ? count(entry.children) : 0), 0);
+    const serialise = (entry, depth = 0) => {
+        const indent = '  '.repeat(depth);
+        const children = entry.children?.map(child => serialise(child, depth + 1)).join('') ?? '';
+        return `${indent}- ${entry.title}\n${children}`;
+    };
+    const calc = calculatePagination(allToc.length, page, PAGINATION_CONFIG.DEFAULT_PAGE_SIZE);
+    const { items, tokenCount, truncated } = truncateListByTokens(allToc.slice(calc.startIndex, calc.endIndex), maxTokens, serialise);
+    const paginationNote = buildPaginationNote(calc);
+    return {
+        toc: items,
+        pagination: {
+            page: calc.page,
+            pageSize: calc.pageSize,
+            totalPages: calc.totalPages,
+            totalItems: count(allToc),
+            hasNext: calc.hasNext,
+            hasPrev: calc.hasPrev,
+        },
+        tokenInfo: { tokenCount, truncated, maxTokens },
+        ...(paginationNote !== undefined ? { paginationNote } : {}),
+    };
+}
+//# sourceMappingURL=intercom-service.js.map

package/dist/core/services/intercom-service.js.map

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

package/dist/core/services/sitemap-service.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Table of contents for a static documentation source, built from its sitemap.
+ *
+ * A Fluid Topics publication ships a real TOC endpoint. A static site does
+ * not — but concepts.jamf.com publishes a sitemap whose paths already encode
+ * the hierarchy (`{locale}/guides/{category}/{article}`), so the tree can be
+ * derived from 990 URLs in one request instead of crawling 99 pages per
+ * locale and parsing each one's navigation.
+ */
+import type { StaticDocSource, StaticSection } from '../constants/sources.js';
+import type { ServerContext } from '../types/context.js';
+import type { FetchTocOptions, FetchTocResult, TocEntry } from '../types.js';
+/** One `<url>` of a sitemap, reduced to what a TOC needs. */
+export interface SitemapEntry {
+    /** Canonical absolute URL. */
+    url: string;
+    /** Path segments after the origin, e.g. `['en', 'guides', 'ai-governance']`. */
+    segments: string[];
+    /** `<lastmod>`, when present. */
+    lastModified?: string;
+}
+/**
+ * Extract every `<loc>` from a sitemap, with its `<lastmod>` when it has one.
+ *
+ * Deliberately a scan for `<url>` blocks rather than an XML parse: the
+ * document is a flat list, cheerio would have to be told to treat it as XML,
+ * and a sitemap that fails to parse should still yield the entries it does
+ * have.
+ */
+export declare function parseSitemap(xml: string): SitemapEntry[];
+/** Fetch and cache a source's sitemap. */
+export declare function loadSitemap(ctx: ServerContext, source: StaticDocSource): Promise<SitemapEntry[]>;
+/**
+ * Turn a slug into a heading: `ai-governance` → `AI Governance`.
+ *
+ * Checked against the fourteen real titles concepts.jamf.com's own guides
+ * index renders, which is the only place the site publishes them without a
+ * per-page request: eight of nine match exactly. The ninth is
+ * `infrastructure-as-code`, which the site titles "Infrastructure As Code"
+ * and this produces as "Infrastructure as Code" — standard title case
+ * lowercases "as", and matching one page's capitalisation is not worth a
+ * special case.
+ */
+export declare function titleFromSlug(slug: string): string;
+/**
+ * Build a TOC for one section of a static source, in one locale.
+ *
+ * @param locale the source's own locale code, e.g. `en` — not `en-US`
+ */
+export declare function buildStaticToc(ctx: ServerContext, source: StaticDocSource, section: StaticSection, locale: string): Promise<TocEntry[]>;
+/**
+ * A `FetchTocResult` for a static source's section.
+ *
+ * Pagination and token truncation are the same operations the Fluid Topics
+ * path performs, applied to entries that came from a sitemap instead of a
+ * map: a caller paging through a Concepts TOC must not get a different shape
+ * from one paging through Jamf Pro's.
+ */
+export declare function fetchStaticToc(ctx: ServerContext, source: StaticDocSource, section: StaticSection, sourceLocale: string, options?: FetchTocOptions): Promise<FetchTocResult>;
+//# sourceMappingURL=sitemap-service.d.ts.map

package/dist/core/services/sitemap-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/sitemap-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAQ7E,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,gFAAgF;IAChF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAmBxD;AAED,0CAA0C;AAC1C,wBAAsB,WAAW,CAC/B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CASzB;AA4BD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUlD;AAsBD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,QAAQ,EAAE,CAAC,CAwBrB;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,aAAa,EACtB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAgCzB"}

package/dist/core/services/sitemap-service.js

@@ -0,0 +1,201 @@
+/**
+ * Table of contents for a static documentation source, built from its sitemap.
+ *
+ * A Fluid Topics publication ships a real TOC endpoint. A static site does
+ * not — but concepts.jamf.com publishes a sitemap whose paths already encode
+ * the hierarchy (`{locale}/guides/{category}/{article}`), so the tree can be
+ * derived from 990 URLs in one request instead of crawling 99 pages per
+ * locale and parsing each one's navigation.
+ */
+import { httpGetText } from '../http-client.js';
+import { cacheKey } from './cache-key.js';
+import { canonicalStaticUrl } from './static-article-service.js';
+import { PAGINATION_CONFIG, TOKEN_CONFIG } from '../constants.js';
+import { calculatePagination, truncateListByTokens, buildPaginationNote, } from './tokenizer.js';
+/**
+ * Extract every `<loc>` from a sitemap, with its `<lastmod>` when it has one.
+ *
+ * Deliberately a scan for `<url>` blocks rather than an XML parse: the
+ * document is a flat list, cheerio would have to be told to treat it as XML,
+ * and a sitemap that fails to parse should still yield the entries it does
+ * have.
+ */
+export function parseSitemap(xml) {
+    const out = [];
+    for (const block of xml.match(/<url\b[\s\S]*?<\/url>/g) ?? []) {
+        const loc = /<loc>\s*([^<\s]+)\s*<\/loc>/.exec(block)?.[1];
+        if (loc === undefined) {
+            continue;
+        }
+        const lastmod = /<lastmod>\s*([^<\s]+)\s*<\/lastmod>/.exec(block)?.[1];
+        let segments;
+        try {
+            segments = new URL(loc).pathname.split('/').filter(Boolean);
+        }
+        catch {
+            continue;
+        }
+        out.push({
+            url: canonicalStaticUrl(loc),
+            segments,
+            ...(lastmod !== undefined ? { lastModified: lastmod } : {}),
+        });
+    }
+    return out;
+}
+/** Fetch and cache a source's sitemap. */
+export async function loadSitemap(ctx, source) {
+    const key = cacheKey('static-sitemap', { source: source.id });
+    const cached = await ctx.cache.get(key);
+    if (cached !== null) {
+        return cached;
+    }
+    const xml = await httpGetText(`${source.baseUrl}/sitemap.xml`);
+    const entries = parseSitemap(xml);
+    await ctx.cache.set(key, entries, ctx.config.cacheTtl.products);
+    return entries;
+}
+/**
+ * Terms whose casing a naive capitalise gets wrong.
+ *
+ * The sitemap gives slugs, not titles, and fetching 99 pages per locale to
+ * read each `og:title` is not worth one heading apiece. Word-by-word
+ * capitalisation produces "Ai Governance", "Byod" and "Ios", which read as
+ * mistakes; this table is what the site's own index page shows those as.
+ * Keyed lowercase.
+ */
+const TITLE_CASE_TERMS = {
+    ai: 'AI', api: 'API', byod: 'BYOD', ddm: 'DDM', it: 'IT', mdm: 'MDM',
+    pki: 'PKI', ldap: 'LDAP', scep: 'SCEP', ztna: 'ZTNA', sso: 'SSO',
+    vpn: 'VPN', mfa: 'MFA', dns: 'DNS', ip: 'IP', tls: 'TLS', url: 'URL',
+    json: 'JSON', xml: 'XML', sdk: 'SDK', cli: 'CLI', ui: 'UI', ux: 'UX',
+    id: 'ID', edr: 'EDR', xdr: 'XDR', siem: 'SIEM', saas: 'SaaS',
+    macos: 'macOS', ios: 'iOS', ipados: 'iPadOS', tvos: 'tvOS',
+    watchos: 'watchOS', visionos: 'visionOS', jamf: 'Jamf', apple: 'Apple',
+    aws: 'AWS', okta: 'Okta', entra: 'Entra', jss: 'JSS',
+};
+/** Words that stay lowercase unless they open the title. */
+const TITLE_MINOR_WORDS = new Set([
+    'a', 'an', 'and', 'as', 'at', 'but', 'by', 'for', 'in', 'of', 'on', 'or',
+    'the', 'to', 'via', 'with',
+]);
+/**
+ * Turn a slug into a heading: `ai-governance` → `AI Governance`.
+ *
+ * Checked against the fourteen real titles concepts.jamf.com's own guides
+ * index renders, which is the only place the site publishes them without a
+ * per-page request: eight of nine match exactly. The ninth is
+ * `infrastructure-as-code`, which the site titles "Infrastructure As Code"
+ * and this produces as "Infrastructure as Code" — standard title case
+ * lowercases "as", and matching one page's capitalisation is not worth a
+ * special case.
+ */
+export function titleFromSlug(slug) {
+    const words = slug.split('-').filter(Boolean);
+    return words
+        .map((word, index) => {
+        const known = TITLE_CASE_TERMS[word.toLowerCase()];
+        if (known !== undefined) {
+            return known;
+        }
+        if (index > 0 && TITLE_MINOR_WORDS.has(word.toLowerCase())) {
+            return word.toLowerCase();
+        }
+        return word.charAt(0).toUpperCase() + word.slice(1);
+    })
+        .join(' ');
+}
+function toTocEntries(nodes, titles) {
+    return [...nodes]
+        .sort((a, b) => a.slug.localeCompare(b.slug))
+        .map(node => {
+        const children = toTocEntries(node.children.values(), titles);
+        const entry = {
+            title: titles.get(node.url ?? '') ?? titleFromSlug(node.slug),
+            url: node.url ?? '',
+        };
+        if (children.length > 0) {
+            entry.children = children;
+        }
+        return entry;
+    });
+}
+/**
+ * Build a TOC for one section of a static source, in one locale.
+ *
+ * @param locale the source's own locale code, e.g. `en` — not `en-US`
+ */
+export async function buildStaticToc(ctx, source, section, locale) {
+    const entries = await loadSitemap(ctx, source);
+    const root = new Map();
+    for (const entry of entries) {
+        const [entryLocale, entrySection, ...rest] = entry.segments;
+        if (entryLocale !== locale || entrySection !== section.path) {
+            continue;
+        }
+        // The section's own index page is the container, not a child of itself.
+        if (rest.length === 0) {
+            continue;
+        }
+        let level = root;
+        let node;
+        for (const slug of rest) {
+            node = level.get(slug);
+            if (node === undefined) {
+                node = { slug, children: new Map() };
+                level.set(slug, node);
+            }
+            level = node.children;
+        }
+        if (node !== undefined) {
+            node.url = entry.url;
+        }
+    }
+    return toTocEntries(root.values(), new Map());
+}
+/**
+ * A `FetchTocResult` for a static source's section.
+ *
+ * Pagination and token truncation are the same operations the Fluid Topics
+ * path performs, applied to entries that came from a sitemap instead of a
+ * map: a caller paging through a Concepts TOC must not get a different shape
+ * from one paging through Jamf Pro's.
+ */
+export async function fetchStaticToc(ctx, source, section, sourceLocale, options = {}) {
+    const page = options.page ?? PAGINATION_CONFIG.DEFAULT_PAGE;
+    const maxTokens = options.maxTokens ?? TOKEN_CONFIG.DEFAULT_MAX_TOKENS;
+    const allToc = await buildStaticToc(ctx, source, section, sourceLocale);
+    const totalItems = countTocEntries(allToc);
+    const paginationCalc = calculatePagination(allToc.length, page, PAGINATION_CONFIG.DEFAULT_PAGE_SIZE);
+    const paginated = allToc.slice(paginationCalc.startIndex, paginationCalc.endIndex);
+    const { items, tokenCount, truncated } = truncateListByTokens(paginated, maxTokens, tocEntryToString);
+    const paginationNote = buildPaginationNote(paginationCalc);
+    return {
+        toc: items,
+        pagination: {
+            page: paginationCalc.page,
+            pageSize: paginationCalc.pageSize,
+            totalPages: paginationCalc.totalPages,
+            totalItems,
+            hasNext: paginationCalc.hasNext,
+            hasPrev: paginationCalc.hasPrev,
+        },
+        tokenInfo: { tokenCount, truncated, maxTokens },
+        // The locale that answered is the one asked for: unlike Fluid Topics,
+        // where a family may exist in en-US only, a static section either
+        // publishes the locale or `resolveTocSource` refused before reaching here.
+        resolvedLocale: sourceLocale,
+        ...(paginationNote !== undefined ? { paginationNote } : {}),
+    };
+}
+/** Total entries including nested children. Mirrors toc-service's own count. */
+function countTocEntries(entries) {
+    return entries.reduce((count, entry) => count + 1 + (entry.children !== undefined ? countTocEntries(entry.children) : 0), 0);
+}
+/** Serialise one entry for token estimation. Mirrors toc-service's. */
+function tocEntryToString(entry, depth = 0) {
+    const indent = '  '.repeat(depth);
+    const childrenStr = entry.children?.map(c => tocEntryToString(c, depth + 1)).join('') ?? '';
+    return `${indent}- ${entry.title}\n${childrenStr}`;
+}
+//# sourceMappingURL=sitemap-service.js.map

package/dist/core/services/sitemap-service.js.map

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

package/dist/core/services/static-article-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-article-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/static-article-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAU3E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASrE;AAYD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA2D7B"}
+{"version":3,"file":"static-article-service.d.ts","sourceRoot":"","sources":["../../../src/core/services/static-article-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAa3E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAWzD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASrE;AAYD;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA2D7B"}