@cyanheads/stackexchange-mcp-server 0.1.1

package/dist/services/stackexchange/html-normalizer.js

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Lightweight HTML→markdown normalizer for Stack Exchange post bodies.
+ * Handles SE's known tag set: p, pre/code, strong, em, a, ul, ol, li, h1-h6,
+ * blockquote, inline code. No external dependency required.
+ * @module services/stackexchange/html-normalizer
+ */
+/**
+ * Convert a Stack Exchange HTML post body to clean markdown.
+ * Operates on SE's predictable, limited HTML tag set.
+ */
+export function normalizeHtml(html) {
+    if (!html)
+        return '';
+    let md = html;
+    // NOTE: do NOT call decodeEntities() here. HTML entities must remain encoded
+    // until after all HTML tags are processed. Pre-decoding </> converts
+    // them to < / > which (a) breaks stripTags() on attribute values containing >
+    // (e.g. alt="x >= 128" gets split mid-tag) and (b) makes entity-encoded
+    // angle brackets in code blocks look like real HTML tags that then get stripped.
+    // Entities are decoded inside code block handlers explicitly, and by the final
+    // decodeEntities() call at the end of this function.
+    // Fenced code blocks: <pre><code>...</code></pre> → ```\n...\n```
+    // SE wraps code blocks in both tags; capture the language hint from class if present.
+    md = md.replace(/<pre[^>]*>\s*<code[^>]*class="[^"]*language-([^"\s]+)[^"]*"[^>]*>([\s\S]*?)<\/code>\s*<\/pre>/gi, (_, lang, code) => {
+        const cleaned = stripTags(code)
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'");
+        return `\`\`\`${lang}\n${cleaned.trim()}\n\`\`\``;
+    });
+    // Fenced code blocks without language class
+    md = md.replace(/<pre[^>]*>\s*<code[^>]*>([\s\S]*?)<\/code>\s*<\/pre>/gi, (_, code) => {
+        const cleaned = stripTags(code)
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'");
+        return `\`\`\`\n${cleaned.trim()}\n\`\`\``;
+    });
+    // Headings h1–h6
+    md = md.replace(/<h([1-6])[^>]*>([\s\S]*?)<\/h\1>/gi, (_, level, content) => {
+        const hashes = '#'.repeat(parseInt(level, 10));
+        return `\n${hashes} ${stripTags(content).trim()}\n`;
+    });
+    // Blockquotes
+    md = md.replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, (_, content) => {
+        const inner = normalizeHtml(content).trim();
+        return inner
+            .split('\n')
+            .map((line) => `> ${line}`)
+            .join('\n');
+    });
+    // Bold
+    md = md.replace(/<strong[^>]*>([\s\S]*?)<\/strong>/gi, (_, content) => `**${stripTags(content).trim()}**`);
+    md = md.replace(/<b[^>]*>([\s\S]*?)<\/b>/gi, (_, content) => `**${stripTags(content).trim()}**`);
+    // Italic
+    md = md.replace(/<em[^>]*>([\s\S]*?)<\/em>/gi, (_, content) => `_${stripTags(content).trim()}_`);
+    md = md.replace(/<i[^>]*>([\s\S]*?)<\/i>/gi, (_, content) => `_${stripTags(content).trim()}_`);
+    // Inline code (not already inside pre blocks)
+    md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, (_, content) => {
+        const raw = content
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#39;/g, "'");
+        return `\`${raw}\``;
+    });
+    // Links
+    md = md.replace(/<a[^>]+href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, (_, href, text) => {
+        const linkText = stripTags(text).trim() || href;
+        return `[${linkText}](${href})`;
+    });
+    md = md.replace(/<a[^>]+href='([^']*)'[^>]*>([\s\S]*?)<\/a>/gi, (_, href, text) => {
+        const linkText = stripTags(text).trim() || href;
+        return `[${linkText}](${href})`;
+    });
+    // Ordered lists
+    md = md.replace(/<ol[^>]*>([\s\S]*?)<\/ol>/gi, (_, content) => {
+        let counter = 0;
+        const items = content.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, (__, item) => {
+            counter++;
+            return `${counter}. ${normalizeHtml(item).trim()}\n`;
+        });
+        return `\n${items}\n`;
+    });
+    // Unordered lists
+    md = md.replace(/<ul[^>]*>([\s\S]*?)<\/ul>/gi, (_, content) => {
+        const items = content.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, (__, item) => `- ${normalizeHtml(item).trim()}\n`);
+        return `\n${items}\n`;
+    });
+    // Paragraphs → double newline
+    md = md.replace(/<p[^>]*>([\s\S]*?)<\/p>/gi, (_, content) => `\n${normalizeHtml(content).trim()}\n`);
+    // Line breaks
+    md = md.replace(/<br\s*\/?>/gi, '\n');
+    // Strip any remaining HTML tags (img, hr, sub, sup, table, etc.).
+    // Protect already-converted fenced code blocks first — their decoded content
+    // (e.g. `#include <algorithm>`) contains angle brackets that would otherwise
+    // be misidentified as HTML tags and stripped.
+    const codeBlocks = [];
+    const PLACEHOLDER_PREFIX = 'MDCODEBLOCK';
+    const PLACEHOLDER_SUFFIX = 'ENDMDCODEBLOCK';
+    md = md.replace(/```[\s\S]*?```/g, (block) => {
+        codeBlocks.push(block);
+        return `${PLACEHOLDER_PREFIX}${codeBlocks.length - 1}${PLACEHOLDER_SUFFIX}`;
+    });
+    md = stripTags(md);
+    md = md.replace(new RegExp(`${PLACEHOLDER_PREFIX}(\\d+)${PLACEHOLDER_SUFFIX}`, 'g'), (_, idx) => codeBlocks[parseInt(idx, 10)] ?? '');
+    // Decode entities in the non-code portions (remaining &amp;, &lt;, etc.)
+    md = decodeEntities(md);
+    // Normalize excessive blank lines (max 2 consecutive newlines)
+    md = md.replace(/\n{3,}/g, '\n\n');
+    return md.trim();
+}
+/** Strip all HTML tags from a string. */
+function stripTags(html) {
+    return html.replace(/<[^>]+>/g, '');
+}
+/**
+ * Decode basic HTML entities in a plain-text string (not HTML).
+ * Use this for SE API fields like site names and audiences that arrive
+ * HTML-encoded but contain no markup.
+ */
+export function decodeHtmlEntities(text) {
+    return decodeEntities(text);
+}
+/** Decode basic HTML entities. */
+function decodeEntities(text) {
+    return text
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/g, "'")
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&#(\d+);/g, (_, code) => String.fromCharCode(parseInt(code, 10)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => String.fromCharCode(parseInt(hex, 16)));
+}
+//# sourceMappingURL=html-normalizer.js.map

package/dist/services/stackexchange/html-normalizer.js.map

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

package/dist/services/stackexchange/stackexchange-service.d.ts

@@ -0,0 +1,143 @@
+/**
+ * @fileoverview Stack Exchange API v2.3 HTTP client with backoff tracking,
+ * quota logging, gzip decompression, and typed domain methods.
+ * @module services/stackexchange/stackexchange-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+export interface SearchQuestionsOptions {
+    acceptedOnly?: boolean;
+    /** API key from server config — injected by the service. */
+    apiKey?: string;
+    minScore?: number;
+    pageSize?: number;
+    query: string;
+    site: string;
+    sort?: 'relevance' | 'votes' | 'activity' | 'newest';
+    tags?: string[];
+}
+export interface GetThreadOptions {
+    apiKey?: string;
+    includeComments?: boolean;
+    maxAnswers?: number;
+    questionId: number;
+    site: string;
+}
+export interface GetUserOptions {
+    apiKey?: string;
+    site: string;
+    userId: number;
+}
+export interface GetTagFaqOptions {
+    apiKey?: string;
+    pageSize?: number;
+    site: string;
+    tag: string;
+}
+export interface GetSitesOptions {
+    apiKey?: string;
+}
+/** Normalized question for tool output. */
+export interface NormalizedQuestion {
+    answerCount: number;
+    excerpt?: string;
+    isAnswered: boolean;
+    link: string;
+    questionId: number;
+    score: number;
+    tags: string[];
+    title: string;
+}
+/** Normalized answer for thread output. */
+export interface NormalizedAnswer {
+    answerId: number;
+    authorLink?: string;
+    authorName?: string;
+    authorReputation?: number;
+    bodyMarkdown: string;
+    isAccepted: boolean;
+    score: number;
+}
+/** Normalized thread for tool output. */
+export interface NormalizedThread {
+    acceptedAnswerId?: number;
+    answers: NormalizedAnswer[];
+    authorLink?: string;
+    authorName?: string;
+    bodyMarkdown: string;
+    link: string;
+    questionId: number;
+    score: number;
+    tags: string[];
+    title: string;
+}
+/** Normalized user profile for tool output. */
+export interface NormalizedUser {
+    answerCount?: number;
+    badgeCounts?: {
+        gold?: number;
+        silver?: number;
+        bronze?: number;
+    };
+    displayName: string;
+    link: string;
+    location?: string;
+    questionCount?: number;
+    reputation: number;
+    topTags: {
+        tagName: string;
+        answerCount?: number;
+        answerScore?: number;
+    }[];
+    userId: number;
+    websiteUrl?: string;
+}
+/** Normalized site for tool output. */
+export interface NormalizedSite {
+    apiSiteParameter: string;
+    audience?: string;
+    name: string;
+    siteUrl: string;
+}
+export declare class StackExchangeService {
+    private readonly apiKey;
+    constructor(_config: AppConfig, _storage: StorageService, apiKey?: string);
+    /** Build a URL with common params (key, gzip). */
+    private buildUrl;
+    /** Fetch, decompress (auto), parse, handle errors. */
+    private fetchSe;
+    /** Search questions (no bodies). */
+    searchQuestions(opts: SearchQuestionsOptions, ctx: Context): Promise<{
+        questions: NormalizedQuestion[];
+        quotaRemaining: number;
+        quotaMax: number;
+    }>;
+    /** Fetch a complete Q&A thread with HTML→markdown normalization. */
+    getThread(opts: GetThreadOptions, ctx: Context): Promise<{
+        thread: NormalizedThread;
+        quotaRemaining: number;
+        quotaMax: number;
+    }>;
+    /** Fetch the tag FAQ (highest-voted answered questions for a tag). */
+    getTagFaq(opts: GetTagFaqOptions, ctx: Context): Promise<{
+        questions: NormalizedQuestion[];
+        quotaRemaining: number;
+        quotaMax: number;
+    }>;
+    /** Fetch a user profile + top tags. */
+    getUser(opts: GetUserOptions, ctx: Context): Promise<{
+        user: NormalizedUser;
+        quotaRemaining: number;
+        quotaMax: number;
+    }>;
+    /** Fetch all sites in the SE network (paginated, bounded set). */
+    getSites(ctx: Context): Promise<{
+        sites: NormalizedSite[];
+        quotaRemaining: number;
+        quotaMax: number;
+    }>;
+}
+export declare function initStackExchangeService(config: AppConfig, storage: StorageService, apiKey?: string): void;
+export declare function getStackExchangeService(): StackExchangeService;
+//# sourceMappingURL=stackexchange-service.d.ts.map

package/dist/services/stackexchange/stackexchange-service.d.ts.map

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

package/dist/services/stackexchange/stackexchange-service.js

@@ -0,0 +1,336 @@
+/**
+ * @fileoverview Stack Exchange API v2.3 HTTP client with backoff tracking,
+ * quota logging, gzip decompression, and typed domain methods.
+ * @module services/stackexchange/stackexchange-service
+ */
+import { invalidParams, notFound, rateLimited, serviceUnavailable, } from '@cyanheads/mcp-ts-core/errors';
+import { withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { decodeHtmlEntities, normalizeHtml } from './html-normalizer.js';
+const BASE_URL = 'https://api.stackexchange.com/2.3';
+/** Module-level backoff tracking — per-process, acceptable for server-side use. */
+let backoffUntil = 0;
+/** Honour the SE `backoff` field before the next request. */
+async function waitForBackoff() {
+    const now = Date.now();
+    if (now < backoffUntil) {
+        await new Promise((resolve) => setTimeout(resolve, backoffUntil - now));
+    }
+}
+/** Update the backoff window from a response envelope. */
+function updateBackoff(wrapper) {
+    if (wrapper.backoff && wrapper.backoff > 0) {
+        backoffUntil = Date.now() + wrapper.backoff * 1000;
+    }
+}
+export class StackExchangeService {
+    apiKey;
+    constructor(_config, _storage, apiKey) {
+        this.apiKey = apiKey;
+    }
+    /** Build a URL with common params (key, gzip). */
+    buildUrl(path, params) {
+        const url = new URL(`${BASE_URL}${path}`);
+        // SE API always returns gzip — accept it explicitly
+        // (fetch auto-decompresses with Accept-Encoding: gzip)
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== '' && v !== null) {
+                url.searchParams.set(k, String(v));
+            }
+        }
+        if (this.apiKey) {
+            url.searchParams.set('key', this.apiKey);
+        }
+        return url.toString();
+    }
+    /** Fetch, decompress (auto), parse, handle errors. */
+    async fetchSe(url, ctx) {
+        await waitForBackoff();
+        const response = await fetch(url, {
+            headers: {
+                'Accept-Encoding': 'gzip',
+                Accept: 'application/json',
+            },
+            signal: ctx.signal,
+        });
+        const text = await response.text();
+        // SE returns HTTP 400 with JSON error envelope for bad params
+        if (!response.ok) {
+            let errObj;
+            try {
+                errObj = JSON.parse(text);
+            }
+            catch {
+                // ignore parse failure
+            }
+            if (errObj?.error_name === 'bad_parameter') {
+                throw invalidParams(`Stack Exchange API error: ${errObj.error_message}`, {
+                    reason: 'invalid_site',
+                    error_name: errObj.error_name,
+                    error_id: errObj.error_id,
+                });
+            }
+            throw serviceUnavailable(`Stack Exchange API returned HTTP ${response.status}`, {
+                status: response.status,
+            });
+        }
+        let wrapper;
+        try {
+            wrapper = JSON.parse(text);
+        }
+        catch (err) {
+            throw serviceUnavailable('Failed to parse Stack Exchange response', {}, { cause: err });
+        }
+        updateBackoff(wrapper);
+        ctx.log.debug('SE quota', {
+            quota_remaining: wrapper.quota_remaining,
+            quota_max: wrapper.quota_max,
+        });
+        return wrapper;
+    }
+    /** Search questions (no bodies). */
+    searchQuestions(opts, ctx) {
+        return withRetry(async () => {
+            const params = {
+                site: opts.site,
+                q: opts.query,
+                sort: opts.sort ?? 'relevance',
+                pagesize: opts.pageSize ?? 10,
+                intitle: undefined,
+            };
+            if (opts.tags && opts.tags.length > 0) {
+                params.tagged = opts.tags.join(';');
+            }
+            if (opts.acceptedOnly) {
+                params.accepted = 'True';
+            }
+            if (opts.minScore !== undefined) {
+                params.min = opts.minScore;
+            }
+            const url = this.buildUrl('/search/advanced', params);
+            const wrapper = await this.fetchSe(url, ctx);
+            if (wrapper.quota_remaining === 0) {
+                throw rateLimited('Stack Exchange API quota exhausted.', {
+                    reason: 'quota_exceeded',
+                    quota_remaining: 0,
+                    quota_max: wrapper.quota_max,
+                });
+            }
+            const questions = wrapper.items.map((q) => ({
+                questionId: q.question_id,
+                title: q.title,
+                link: q.link,
+                score: q.score,
+                answerCount: q.answer_count,
+                isAnswered: q.is_answered,
+                tags: q.tags,
+                ...(q.excerpt ? { excerpt: q.excerpt } : {}),
+            }));
+            return { questions, quotaRemaining: wrapper.quota_remaining, quotaMax: wrapper.quota_max };
+        }, {
+            operation: 'searchQuestions',
+            context: ctx,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+    /** Fetch a complete Q&A thread with HTML→markdown normalization. */
+    getThread(opts, ctx) {
+        return withRetry(async () => {
+            const questionUrl = this.buildUrl(`/questions/${opts.questionId}`, {
+                site: opts.site,
+                filter: 'withbody',
+            });
+            const answersUrl = this.buildUrl(`/questions/${opts.questionId}/answers`, {
+                site: opts.site,
+                filter: 'withbody',
+                sort: 'votes',
+                pagesize: opts.maxAnswers ?? 10,
+            });
+            const [questionWrapper, answersWrapper] = await Promise.all([
+                this.fetchSe(questionUrl, ctx),
+                this.fetchSe(answersUrl, ctx),
+            ]);
+            if (questionWrapper.quota_remaining === 0) {
+                throw rateLimited('Stack Exchange API quota exhausted.', {
+                    reason: 'quota_exceeded',
+                    quota_remaining: 0,
+                    quota_max: questionWrapper.quota_max,
+                });
+            }
+            if (questionWrapper.items.length === 0) {
+                throw notFound(`Question ID ${opts.questionId} not found on site "${opts.site}".`, {
+                    reason: 'question_not_found',
+                    questionId: opts.questionId,
+                    site: opts.site,
+                });
+            }
+            const q = questionWrapper.items[0];
+            // Sort answers: accepted first, then by score descending
+            const answers = answersWrapper.items.slice().sort((a, b) => {
+                const aAccepted = a.answer_id === q.accepted_answer_id ? 1 : 0;
+                const bAccepted = b.answer_id === q.accepted_answer_id ? 1 : 0;
+                if (aAccepted !== bAccepted)
+                    return bAccepted - aAccepted;
+                return b.score - a.score;
+            });
+            const normalizedAnswers = answers.map((a) => ({
+                answerId: a.answer_id,
+                score: a.score,
+                isAccepted: a.is_accepted,
+                bodyMarkdown: normalizeHtml(a.body ?? ''),
+                ...(a.owner?.display_name ? { authorName: a.owner.display_name } : {}),
+                ...(a.owner?.link ? { authorLink: a.owner.link } : {}),
+                ...(a.owner?.reputation !== undefined ? { authorReputation: a.owner.reputation } : {}),
+            }));
+            const thread = {
+                questionId: q.question_id,
+                title: q.title,
+                link: q.link,
+                score: q.score,
+                tags: q.tags,
+                bodyMarkdown: normalizeHtml(q.body ?? ''),
+                ...(q.owner?.display_name ? { authorName: q.owner.display_name } : {}),
+                ...(q.owner?.link ? { authorLink: q.owner.link } : {}),
+                answers: normalizedAnswers,
+                ...(q.accepted_answer_id !== undefined ? { acceptedAnswerId: q.accepted_answer_id } : {}),
+            };
+            return {
+                thread,
+                quotaRemaining: questionWrapper.quota_remaining,
+                quotaMax: questionWrapper.quota_max,
+            };
+        }, {
+            operation: 'getThread',
+            context: ctx,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+    /** Fetch the tag FAQ (highest-voted answered questions for a tag). */
+    getTagFaq(opts, ctx) {
+        return withRetry(async () => {
+            const url = this.buildUrl(`/tags/${encodeURIComponent(opts.tag)}/faq`, {
+                site: opts.site,
+                pagesize: opts.pageSize ?? 10,
+            });
+            const wrapper = await this.fetchSe(url, ctx);
+            if (wrapper.quota_remaining === 0) {
+                throw rateLimited('Stack Exchange API quota exhausted.', {
+                    reason: 'quota_exceeded',
+                    quota_remaining: 0,
+                    quota_max: wrapper.quota_max,
+                });
+            }
+            const questions = wrapper.items.map((q) => ({
+                questionId: q.question_id,
+                title: q.title,
+                link: q.link,
+                score: q.score,
+                answerCount: q.answer_count,
+                isAnswered: q.is_answered,
+                tags: q.tags,
+            }));
+            return { questions, quotaRemaining: wrapper.quota_remaining, quotaMax: wrapper.quota_max };
+        }, {
+            operation: 'getTagFaq',
+            context: ctx,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+    /** Fetch a user profile + top tags. */
+    getUser(opts, ctx) {
+        return withRetry(async () => {
+            const profileUrl = this.buildUrl(`/users/${opts.userId}`, { site: opts.site });
+            const topTagsUrl = this.buildUrl(`/users/${opts.userId}/top-tags`, {
+                site: opts.site,
+                pagesize: 10,
+            });
+            const [profileWrapper, topTagsWrapper] = await Promise.all([
+                this.fetchSe(profileUrl, ctx),
+                this.fetchSe(topTagsUrl, ctx),
+            ]);
+            if (profileWrapper.quota_remaining === 0) {
+                throw rateLimited('Stack Exchange API quota exhausted.', {
+                    reason: 'quota_exceeded',
+                    quota_remaining: 0,
+                    quota_max: profileWrapper.quota_max,
+                });
+            }
+            if (profileWrapper.items.length === 0) {
+                throw notFound(`User ID ${opts.userId} not found on site "${opts.site}".`, {
+                    reason: 'user_not_found',
+                    userId: opts.userId,
+                    site: opts.site,
+                });
+            }
+            const u = profileWrapper.items[0];
+            const topTags = topTagsWrapper.items.map((t) => ({
+                tagName: t.tag_name,
+                ...(t.answer_count !== undefined ? { answerCount: t.answer_count } : {}),
+                ...(t.answer_score !== undefined ? { answerScore: t.answer_score } : {}),
+            }));
+            const user = {
+                userId: u.user_id,
+                displayName: u.display_name,
+                link: u.link,
+                reputation: u.reputation,
+                ...(u.badge_counts ? { badgeCounts: u.badge_counts } : {}),
+                ...(u.location ? { location: u.location } : {}),
+                ...(u.website_url ? { websiteUrl: u.website_url } : {}),
+                topTags,
+                ...(u.answer_count !== undefined ? { answerCount: u.answer_count } : {}),
+                ...(u.question_count !== undefined ? { questionCount: u.question_count } : {}),
+            };
+            return {
+                user,
+                quotaRemaining: profileWrapper.quota_remaining,
+                quotaMax: profileWrapper.quota_max,
+            };
+        }, {
+            operation: 'getUser',
+            context: ctx,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+    /** Fetch all sites in the SE network (paginated, bounded set). */
+    getSites(ctx) {
+        return withRetry(async () => {
+            const url = this.buildUrl('/sites', { pagesize: 100 });
+            const wrapper = await this.fetchSe(url, ctx);
+            // SE API returns site names and audiences HTML-encoded (e.g. "Unix &amp; Linux")
+            const normalizeSite = (s) => ({
+                name: decodeHtmlEntities(s.name),
+                apiSiteParameter: s.api_site_parameter,
+                siteUrl: s.site_url,
+                ...(s.audience ? { audience: decodeHtmlEntities(s.audience) } : {}),
+            });
+            const sites = wrapper.items.map(normalizeSite);
+            // If there are more pages, fetch them (SE has ~190 sites, fits in 2 pages at pagesize=100)
+            if (wrapper.has_more) {
+                const page2Url = this.buildUrl('/sites', { pagesize: 100, page: 2 });
+                const wrapper2 = await this.fetchSe(page2Url, ctx);
+                sites.push(...wrapper2.items.map(normalizeSite));
+            }
+            return { sites, quotaRemaining: wrapper.quota_remaining, quotaMax: wrapper.quota_max };
+        }, {
+            operation: 'getSites',
+            context: ctx,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+export function initStackExchangeService(config, storage, apiKey) {
+    _service = new StackExchangeService(config, storage, apiKey);
+}
+export function getStackExchangeService() {
+    if (!_service) {
+        throw new Error('StackExchangeService not initialized — call initStackExchangeService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=stackexchange-service.js.map

package/dist/services/stackexchange/stackexchange-service.js.map

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