@plusplusoneplusplus/coc 1.0.0

package/dist/server/wiki/admin-handlers.js

@@ -0,0 +1,345 @@
+"use strict";
+/**
+ * Wiki Admin Handlers
+ *
+ * REST API handlers for wiki admin endpoints (seeds, config).
+ * Adapted from deep-wiki's admin-handlers for multi-wiki CoC server.
+ * Each endpoint is a flat Route — no sub-router pattern.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleGetSeeds = handleGetSeeds;
+exports.handlePutSeeds = handlePutSeeds;
+exports.handleGetConfig = handleGetConfig;
+exports.handlePutConfig = handlePutConfig;
+exports.handleGenerateSeeds = handleGenerateSeeds;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const router_1 = require("../shared/router");
+const ask_handler_1 = require("./ask-handler");
+// ============================================================================
+// Seeds Handlers
+// ============================================================================
+const SEEDS_FILE = 'seeds.yaml';
+/**
+ * Resolve the path where seeds.yaml should be stored.
+ * Prefers repoPath (alongside deep-wiki.config.yaml) when available,
+ * otherwise falls back to wikiDir.
+ */
+function resolveSeedsPath(wikiDir, repoPath) {
+    return repoPath ? path.join(repoPath, SEEDS_FILE) : path.join(wikiDir, SEEDS_FILE);
+}
+/**
+ * GET /api/wikis/:wikiId/admin/seeds — Read seeds.yaml from the wiki directory.
+ */
+async function handleGetSeeds(res, wikiId, wikiManager) {
+    const wiki = wikiManager.get(wikiId);
+    if (!wiki) {
+        (0, router_1.sendJson)(res, { error: `Wiki not found: ${wikiId}` }, 404);
+        return;
+    }
+    try {
+        const seedsPath = resolveSeedsPath(wiki.registration.wikiDir, wiki.registration.repoPath);
+        if (!fs.existsSync(seedsPath)) {
+            (0, router_1.sendJson)(res, { exists: false, content: null, path: seedsPath });
+            return;
+        }
+        const content = fs.readFileSync(seedsPath, 'utf-8');
+        let parsed;
+        try {
+            const yaml = await Promise.resolve().then(() => __importStar(require('js-yaml')));
+            parsed = yaml.load(content);
+        }
+        catch {
+            (0, router_1.sendJson)(res, { exists: true, content: null, raw: content, path: seedsPath, error: 'Invalid YAML' });
+            return;
+        }
+        (0, router_1.sendJson)(res, { exists: true, content: parsed, path: seedsPath });
+    }
+    catch (error) {
+        (0, router_1.send500)(res, `Failed to read seeds: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * PUT /api/wikis/:wikiId/admin/seeds — Write seeds.yaml to the wiki directory.
+ */
+async function handlePutSeeds(req, res, wikiId, wikiManager) {
+    const wiki = wikiManager.get(wikiId);
+    if (!wiki) {
+        (0, router_1.sendJson)(res, { error: `Wiki not found: ${wikiId}` }, 404);
+        return;
+    }
+    try {
+        const body = await (0, ask_handler_1.readBody)(req);
+        let payload;
+        try {
+            payload = JSON.parse(body);
+        }
+        catch {
+            (0, router_1.send400)(res, 'Request body must be valid JSON');
+            return;
+        }
+        if (payload.content === undefined || payload.content === null) {
+            (0, router_1.send400)(res, 'Missing "content" field in request body');
+            return;
+        }
+        const seeds = payload.content;
+        if (typeof seeds === 'object' && !Array.isArray(seeds)) {
+            const obj = seeds;
+            if (obj.themes !== undefined && !Array.isArray(obj.themes)) {
+                (0, router_1.send400)(res, 'Seeds "themes" field must be an array');
+                return;
+            }
+        }
+        const seedsPath = resolveSeedsPath(wiki.registration.wikiDir, wiki.registration.repoPath);
+        const yaml = await Promise.resolve().then(() => __importStar(require('js-yaml')));
+        const content = typeof seeds === 'string' ? seeds : yaml.dump(seeds);
+        fs.writeFileSync(seedsPath, content, 'utf-8');
+        (0, router_1.sendJson)(res, { success: true, path: seedsPath });
+    }
+    catch (error) {
+        (0, router_1.send500)(res, `Failed to save seeds: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+// ============================================================================
+// Config Handlers
+// ============================================================================
+const CONFIG_CANDIDATES = ['deep-wiki.config.yaml', 'deep-wiki.config.yml'];
+/**
+ * Discover config file in a directory (check for yaml/yml variants).
+ */
+function discoverConfigFile(dir) {
+    for (const candidate of CONFIG_CANDIDATES) {
+        const configPath = path.join(dir, candidate);
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+    }
+    return null;
+}
+/**
+ * GET /api/wikis/:wikiId/admin/config — Read deep-wiki.config.yaml from the repo root.
+ */
+function handleGetConfig(res, wikiId, wikiManager) {
+    const wiki = wikiManager.get(wikiId);
+    if (!wiki) {
+        (0, router_1.sendJson)(res, { error: `Wiki not found: ${wikiId}` }, 404);
+        return;
+    }
+    try {
+        if (!wiki.registration.repoPath) {
+            (0, router_1.sendJson)(res, { exists: false, content: null, path: null, error: 'No repository path configured' });
+            return;
+        }
+        const configPath = discoverConfigFile(wiki.registration.repoPath);
+        if (!configPath) {
+            (0, router_1.sendJson)(res, {
+                exists: false,
+                content: null,
+                path: path.join(wiki.registration.repoPath, CONFIG_CANDIDATES[0]),
+                defaultName: CONFIG_CANDIDATES[0],
+            });
+            return;
+        }
+        const content = fs.readFileSync(configPath, 'utf-8');
+        (0, router_1.sendJson)(res, { exists: true, content, path: configPath });
+    }
+    catch (error) {
+        (0, router_1.send500)(res, `Failed to read config: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * PUT /api/wikis/:wikiId/admin/config — Write deep-wiki.config.yaml to the repo root.
+ */
+async function handlePutConfig(req, res, wikiId, wikiManager) {
+    const wiki = wikiManager.get(wikiId);
+    if (!wiki) {
+        (0, router_1.sendJson)(res, { error: `Wiki not found: ${wikiId}` }, 404);
+        return;
+    }
+    try {
+        if (!wiki.registration.repoPath) {
+            (0, router_1.send400)(res, 'No repository path configured. Cannot save config.');
+            return;
+        }
+        const body = await (0, ask_handler_1.readBody)(req);
+        let payload;
+        try {
+            payload = JSON.parse(body);
+        }
+        catch {
+            (0, router_1.send400)(res, 'Request body must be valid JSON');
+            return;
+        }
+        if (payload.content === undefined || payload.content === null) {
+            (0, router_1.send400)(res, 'Missing "content" field in request body');
+            return;
+        }
+        if (typeof payload.content !== 'string') {
+            (0, router_1.send400)(res, '"content" must be a YAML string');
+            return;
+        }
+        const yamlContent = payload.content;
+        // Validate YAML (basic structure check)
+        try {
+            const yaml = await Promise.resolve().then(() => __importStar(require('js-yaml')));
+            const parsed = yaml.load(yamlContent);
+            if (parsed !== null && parsed !== undefined && typeof parsed !== 'object') {
+                (0, router_1.send400)(res, 'Config must parse to an object');
+                return;
+            }
+        }
+        catch (error) {
+            (0, router_1.send400)(res, `Invalid config YAML: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        const existingPath = discoverConfigFile(wiki.registration.repoPath);
+        const configPath = existingPath || path.join(wiki.registration.repoPath, CONFIG_CANDIDATES[0]);
+        fs.writeFileSync(configPath, yamlContent, 'utf-8');
+        (0, router_1.sendJson)(res, { success: true, path: configPath });
+    }
+    catch (error) {
+        (0, router_1.send500)(res, `Failed to save config: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+// ============================================================================
+// Seeds Generate Handler
+// ============================================================================
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function importDeepWiki(subpath) {
+    const modulePath = `@plusplusoneplusplus/deep-wiki/dist/${subpath}`;
+    return Promise.resolve(`${modulePath}`).then(s => __importStar(require(s)));
+}
+/**
+ * POST /api/wikis/:wikiId/admin/seeds/generate — Generate theme seeds via AI (SSE).
+ */
+async function handleGenerateSeeds(req, res, wikiId, wikiManager) {
+    const wiki = wikiManager.get(wikiId);
+    if (!wiki) {
+        (0, router_1.sendJson)(res, { error: `Wiki not found: ${wikiId}` }, 404);
+        return;
+    }
+    const repoPath = wiki.registration.repoPath;
+    if (!repoPath) {
+        (0, router_1.sendJson)(res, { error: 'No repository path configured' }, 400);
+        return;
+    }
+    // Parse optional JSON body
+    let maxThemes;
+    let model;
+    let timeout;
+    try {
+        const body = await (0, ask_handler_1.readBody)(req);
+        if (body.trim()) {
+            const parsed = JSON.parse(body);
+            maxThemes = parsed.maxThemes;
+            model = parsed.model;
+            timeout = parsed.timeout;
+        }
+    }
+    catch {
+        // Use defaults on parse error
+    }
+    // SSE setup
+    res.writeHead(200, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache',
+        'Connection': 'keep-alive',
+        'X-Accel-Buffering': 'no',
+    });
+    // Track client disconnect to avoid writing to a destroyed stream
+    let clientDisconnected = false;
+    req.on('close', () => { clientDisconnected = true; });
+    const safeSend = (data) => {
+        if (clientDisconnected)
+            return false;
+        return (0, ask_handler_1.sendSSE)(res, data);
+    };
+    const safeEnd = () => {
+        if (!res.destroyed && !res.writableEnded) {
+            res.end();
+        }
+    };
+    try {
+        safeSend({ type: 'status', message: 'Checking AI availability...' });
+        const { checkAIAvailability } = await importDeepWiki('ai-invoker');
+        const availability = await checkAIAvailability();
+        if (!availability.available) {
+            const reason = availability.reason || 'Copilot SDK not available';
+            safeSend({ type: 'error', message: reason });
+            safeSend({ type: 'done', success: false, error: reason });
+            safeEnd();
+            return;
+        }
+        if (clientDisconnected) {
+            safeEnd();
+            return;
+        }
+        safeSend({ type: 'status', message: 'Generating theme seeds...' });
+        const { runSeedsSession } = await importDeepWiki('seeds/seeds-session');
+        const seeds = await runSeedsSession(repoPath, {
+            maxThemes: maxThemes ?? 50,
+            model,
+            timeout,
+        });
+        if (clientDisconnected) {
+            safeEnd();
+            return;
+        }
+        // Auto-save seeds.yaml — prefer repoPath (alongside deep-wiki.config.yaml), fall back to wikiDir
+        try {
+            const seedsPath = resolveSeedsPath(wiki.registration.wikiDir, wiki.registration.repoPath);
+            fs.mkdirSync(path.dirname(seedsPath), { recursive: true });
+            const yaml = await Promise.resolve().then(() => __importStar(require('js-yaml')));
+            fs.writeFileSync(seedsPath, yaml.dump({ themes: seeds }), 'utf-8');
+            safeSend({ type: 'log', message: `Seeds saved to ${seedsPath}` });
+        }
+        catch (saveErr) {
+            const saveMsg = saveErr instanceof Error ? saveErr.message : String(saveErr);
+            safeSend({ type: 'log', message: `Warning: failed to auto-save seeds — ${saveMsg}` });
+        }
+        safeSend({ type: 'log', message: `Generated ${seeds.length} theme seeds` });
+        safeSend({ type: 'done', success: true, seeds });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        safeSend({ type: 'error', message });
+        safeSend({ type: 'done', success: false, error: message });
+    }
+    safeEnd();
+}
+//# sourceMappingURL=admin-handlers.js.map

package/dist/server/wiki/admin-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-handlers.js","sourceRoot":"","sources":["../../../src/server/wiki/admin-handlers.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BH,wCAgCC;AAKD,wCA6CC;AAwBD,0CAiCC;AAKD,0CA4DC;AAeD,kDAwGC;AA3VD,uCAAyB;AACzB,2CAA6B;AAC7B,6CAA8D;AAC9D,+CAAkD;AAGlD,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,OAAe,EAAE,QAAiB;IACxD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACvF,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAChC,GAAwB,EACxB,MAAc,EACd,WAAwB;IAExB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC1F,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YACjE,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,wDAAa,SAAS,GAAC,CAAC;YACrC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACL,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;YACrG,OAAO;QACX,CAAC;QAED,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAA,gBAAO,EAAC,GAAG,EAAE,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;AACL,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAChC,GAAyB,EACzB,GAAwB,EACxB,MAAc,EACd,WAAwB;IAExB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAA,sBAAQ,EAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAA6B,CAAC;QAClC,IAAI,CAAC;YACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACL,IAAA,gBAAO,EAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;YAChD,OAAO;QACX,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5D,IAAA,gBAAO,EAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;YACxD,OAAO;QACX,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;QAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,IAAA,gBAAO,EAAC,GAAG,EAAE,uCAAuC,CAAC,CAAC;gBACtD,OAAO;YACX,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC1F,MAAM,IAAI,GAAG,wDAAa,SAAS,GAAC,CAAC;QACrC,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE9C,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAA,gBAAO,EAAC,GAAG,EAAE,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpG,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,iBAAiB,GAAG,CAAC,uBAAuB,EAAE,sBAAsB,CAAC,CAAC;AAE5E;;GAEG;AACH,SAAS,kBAAkB,CAAC,GAAW;IACnC,KAAK,MAAM,SAAS,IAAI,iBAAiB,EAAE,CAAC;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,UAAU,CAAC;QACtB,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAC3B,GAAwB,EACxB,MAAc,EACd,WAAwB;IAExB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,+BAA+B,EAAE,CAAC,CAAC;YACpG,OAAO;QACX,CAAC;QAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,IAAA,iBAAQ,EAAC,GAAG,EAAE;gBACV,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;gBACjE,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;aACpC,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAA,gBAAO,EAAC,GAAG,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;AACL,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,eAAe,CACjC,GAAyB,EACzB,GAAwB,EACxB,MAAc,EACd,WAAwB;IAExB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,IAAI,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAC9B,IAAA,gBAAO,EAAC,GAAG,EAAE,oDAAoD,CAAC,CAAC;YACnE,OAAO;QACX,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,IAAA,sBAAQ,EAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAA6B,CAAC;QAClC,IAAI,CAAC;YACD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACL,IAAA,gBAAO,EAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;YAChD,OAAO;QACX,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5D,IAAA,gBAAO,EAAC,GAAG,EAAE,yCAAyC,CAAC,CAAC;YACxD,OAAO;QACX,CAAC;QAED,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtC,IAAA,gBAAO,EAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;YAChD,OAAO;QACX,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;QAEpC,wCAAwC;QACxC,IAAI,CAAC;YACD,MAAM,IAAI,GAAG,wDAAa,SAAS,GAAC,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACtC,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxE,IAAA,gBAAO,EAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;gBAC/C,OAAO;YACX,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAA,gBAAO,EAAC,GAAG,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/F,OAAO;QACX,CAAC;QAED,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpE,MAAM,UAAU,GAAG,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/F,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAEnD,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,IAAA,gBAAO,EAAC,GAAG,EAAE,0BAA0B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrG,CAAC;AACL,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,8DAA8D;AAC9D,KAAK,UAAU,cAAc,CAAC,OAAe;IACzC,MAAM,UAAU,GAAG,uCAAuC,OAAO,EAAE,CAAC;IACpE,0BAAc,UAAU,wCAAE;AAC9B,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,mBAAmB,CACrC,GAAyB,EACzB,GAAwB,EACxB,MAAc,EACd,WAAwB;IAExB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mBAAmB,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,OAAO;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC;IAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,IAAA,iBAAQ,EAAC,GAAG,EAAE,EAAE,KAAK,EAAE,+BAA+B,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/D,OAAO;IACX,CAAC;IAED,2BAA2B;IAC3B,IAAI,SAA6B,CAAC;IAClC,IAAI,KAAyB,CAAC;IAC9B,IAAI,OAA2B,CAAC;IAChC,IAAI,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAA,sBAAQ,EAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACd,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAChC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;YAC7B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACrB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACL,8BAA8B;IAClC,CAAC;IAED,YAAY;IACZ,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;QACf,cAAc,EAAE,mBAAmB;QACnC,eAAe,EAAE,UAAU;QAC3B,YAAY,EAAE,YAAY;QAC1B,mBAAmB,EAAE,IAAI;KAC5B,CAAC,CAAC;IAEH,iEAAiE;IACjE,IAAI,kBAAkB,GAAG,KAAK,CAAC;IAC/B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,kBAAkB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtD,MAAM,QAAQ,GAAG,CAAC,IAA6B,EAAW,EAAE;QACxD,IAAI,kBAAkB;YAAE,OAAO,KAAK,CAAC;QACrC,OAAO,IAAA,qBAAO,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,EAAE;QACjB,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC;YACvC,GAAG,CAAC,GAAG,EAAE,CAAC;QACd,CAAC;IACL,CAAC,CAAC;IAEF,IAAI,CAAC;QACD,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC,CAAC;QAErE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,MAAM,mBAAmB,EAAE,CAAC;QACjD,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,IAAI,2BAA2B,CAAC;YAClE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7C,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1D,OAAO,EAAE,CAAC;YACV,OAAO;QACX,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAE9C,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC,CAAC;QAEnE,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,cAAc,CAAC,qBAAqB,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE;YAC1C,SAAS,EAAE,SAAS,IAAI,EAAE;YAC1B,KAAK;YACL,OAAO;SACV,CAAC,CAAC;QAEH,IAAI,kBAAkB,EAAE,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAE9C,iGAAiG;QACjG,IAAI,CAAC;YACD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC1F,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,wDAAa,SAAS,GAAC,CAAC;YACrC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YACnE,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,SAAS,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,OAAgB,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7E,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,wCAAwC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC1F,CAAC;QAED,QAAQ,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,KAAK,CAAC,MAAM,cAAc,EAAE,CAAC,CAAC;QAC5E,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACrC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC"}

package/dist/server/wiki/api-handlers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * API Handlers
+ *
+ * Handles all /api/* routes for the deep-wiki server.
+ * Provides REST endpoints for component graph, components, and special pages.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import * as http from 'http';
+import type { WikiData } from './wiki-data';
+import type { ContextBuilder } from './context-builder';
+import type { AskAIFunction } from './types';
+import type { ConversationSessionManager } from './conversation-session-manager';
+import type { WebSocketServer } from './websocket';
+export interface ApiHandlerContext {
+    wikiData: WikiData;
+    aiEnabled: boolean;
+    repoPath?: string;
+    /** Context builder for AI Q&A (only when AI is enabled) */
+    contextBuilder?: ContextBuilder;
+    /** AI SDK send function (only when AI is enabled) */
+    aiSendMessage?: AskAIFunction;
+    /** AI model override */
+    aiModel?: string;
+    /** Working directory for AI sessions */
+    aiWorkingDirectory?: string;
+    /** Session manager for multi-turn conversations */
+    sessionManager?: ConversationSessionManager;
+    /** WebSocket server (for broadcasting events) */
+    wsServer?: WebSocketServer;
+}
+/**
+ * Route an API request to the appropriate handler.
+ */
+export declare function handleApiRequest(req: http.IncomingMessage, res: http.ServerResponse, pathname: string, method: string, context: ApiHandlerContext): void;
+//# sourceMappingURL=api-handlers.d.ts.map

package/dist/server/wiki/api-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-handlers.d.ts","sourceRoot":"","sources":["../../../src/server/wiki/api-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAK7C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAOnD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,qDAAqD;IACrD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,cAAc,CAAC,EAAE,0BAA0B,CAAC;IAC5C,iDAAiD;IACjD,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC9B;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC5B,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GAC3B,IAAI,CAoJN"}

package/dist/server/wiki/api-handlers.js

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * API Handlers
+ *
+ * Handles all /api/* routes for the deep-wiki server.
+ * Provides REST endpoints for component graph, components, and special pages.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleApiRequest = handleApiRequest;
+const router_1 = require("./router");
+const ask_handler_1 = require("./ask-handler");
+const explore_handler_1 = require("./explore-handler");
+const standalone_admin_handlers_1 = require("./standalone-admin-handlers");
+// ============================================================================
+// Main API Router
+// ============================================================================
+/**
+ * Route an API request to the appropriate handler.
+ */
+function handleApiRequest(req, res, pathname, method, context) {
+    const { wikiData } = context;
+    // GET /api/graph
+    if (method === 'GET' && pathname === '/api/graph') {
+        handleGetGraph(res, wikiData);
+        return;
+    }
+    // GET /api/themes (must come before /api/themes/:id to avoid catch-all)
+    if (method === 'GET' && pathname === '/api/themes') {
+        handleGetThemes(res, wikiData);
+        return;
+    }
+    // GET /api/themes/:themeId/:slug
+    const themeArticleMatch = pathname.match(/^\/api\/themes\/([^/]+)\/([^/]+)$/);
+    if (method === 'GET' && themeArticleMatch) {
+        const themeId = decodeURIComponent(themeArticleMatch[1]);
+        const slug = decodeURIComponent(themeArticleMatch[2]);
+        handleGetThemeArticle(res, wikiData, themeId, slug);
+        return;
+    }
+    // GET /api/themes/:themeId
+    const themeMatch = pathname.match(/^\/api\/themes\/([^/]+)$/);
+    if (method === 'GET' && themeMatch) {
+        const themeId = decodeURIComponent(themeMatch[1]);
+        handleGetThemeById(res, wikiData, themeId);
+        return;
+    }
+    // GET /api/components
+    if (method === 'GET' && pathname === '/api/components') {
+        handleGetComponents(res, wikiData);
+        return;
+    }
+    // GET /api/components/:id
+    const componentMatch = pathname.match(/^\/api\/components\/(.+)$/);
+    if (method === 'GET' && componentMatch) {
+        const componentId = decodeURIComponent(componentMatch[1]);
+        handleGetComponentById(res, wikiData, componentId);
+        return;
+    }
+    // GET /api/pages/:key
+    const pageMatch = pathname.match(/^\/api\/pages\/(.+)$/);
+    if (method === 'GET' && pageMatch) {
+        const key = decodeURIComponent(pageMatch[1]);
+        handleGetPage(res, wikiData, key);
+        return;
+    }
+    // POST /api/ask — AI Q&A (gated by --ai flag)
+    if (method === 'POST' && pathname === '/api/ask') {
+        if (!context.aiEnabled) {
+            (0, router_1.send400)(res, 'AI features are not enabled. Start the server with --ai flag.');
+            return;
+        }
+        if (!context.contextBuilder || !context.aiSendMessage) {
+            (0, router_1.send400)(res, 'AI service is not configured.');
+            return;
+        }
+        // Inline ask: parse body, create context, delegate to handleAskCore
+        (async () => {
+            const askBody = await (0, router_1.readBody)(req);
+            let askReq;
+            try {
+                askReq = JSON.parse(askBody);
+            }
+            catch {
+                (0, router_1.send400)(res, 'Invalid JSON body');
+                return;
+            }
+            if (!askReq.question || typeof askReq.question !== 'string') {
+                (0, router_1.send400)(res, 'Missing or invalid "question" field');
+                return;
+            }
+            const askContext = {
+                contextBuilder: context.contextBuilder,
+                sendMessage: context.aiSendMessage,
+                model: context.aiModel,
+                workingDirectory: context.aiWorkingDirectory,
+                sessionManager: context.sessionManager,
+            };
+            await (0, ask_handler_1.handleAskCore)(res, askReq, askContext);
+        })().catch(() => {
+            if (!res.headersSent) {
+                (0, router_1.sendJson)(res, { error: 'Internal server error' }, 500);
+            }
+        });
+        return;
+    }
+    // DELETE /api/ask/session/:id — Destroy a conversation session
+    const sessionDeleteMatch = pathname.match(/^\/api\/ask\/session\/(.+)$/);
+    if (method === 'DELETE' && sessionDeleteMatch) {
+        if (!context.sessionManager) {
+            (0, router_1.send400)(res, 'Session management is not enabled.');
+            return;
+        }
+        const sessionId = decodeURIComponent(sessionDeleteMatch[1]);
+        const destroyed = context.sessionManager.destroy(sessionId);
+        (0, router_1.sendJson)(res, { destroyed, sessionId });
+        return;
+    }
+    // POST /api/explore/:id — Deep dive (gated by --ai flag)
+    const exploreMatch = pathname.match(/^\/api\/explore\/(.+)$/);
+    if (method === 'POST' && exploreMatch) {
+        if (!context.aiEnabled) {
+            (0, router_1.send400)(res, 'AI features are not enabled. Start the server with --ai flag.');
+            return;
+        }
+        if (!context.aiSendMessage) {
+            (0, router_1.send400)(res, 'AI service is not configured.');
+            return;
+        }
+        const exploreComponentId = decodeURIComponent(exploreMatch[1]);
+        const exploreContext = {
+            wikiData: context.wikiData,
+            sendMessage: context.aiSendMessage,
+            model: context.aiModel,
+            workingDirectory: context.aiWorkingDirectory,
+        };
+        (0, explore_handler_1.handleExploreCore)(req, res, exploreComponentId, exploreContext).catch(() => {
+            if (!res.headersSent) {
+                (0, router_1.sendJson)(res, { error: 'Internal server error' }, 500);
+            }
+        });
+        return;
+    }
+    // Admin routes: /api/admin/*
+    if (pathname.startsWith('/api/admin/')) {
+        const handled = (0, standalone_admin_handlers_1.handleAdminRequest)(req, res, pathname, method, {
+            wikiDir: wikiData.dir,
+            repoPath: context.repoPath,
+            wikiData: context.wikiData,
+            wsServer: context.wsServer,
+        });
+        if (handled) {
+            return;
+        }
+    }
+    // 404 for unknown API routes
+    (0, router_1.send404)(res, `Unknown API endpoint: ${method} ${pathname}`);
+}
+// ============================================================================
+// Handler Implementations
+// ============================================================================
+/**
+ * GET /api/graph — Returns the full component graph JSON.
+ */
+function handleGetGraph(res, wikiData) {
+    try {
+        (0, router_1.sendJson)(res, wikiData.graph);
+    }
+    catch (error) {
+        (0, router_1.sendJson)(res, { error: (0, router_1.getErrorMessage)(error) }, 500);
+    }
+}
+/**
+ * GET /api/components — Returns a list of component summaries.
+ */
+function handleGetComponents(res, wikiData) {
+    try {
+        const summaries = wikiData.getComponentSummaries();
+        (0, router_1.sendJson)(res, summaries);
+    }
+    catch (error) {
+        (0, router_1.sendJson)(res, { error: (0, router_1.getErrorMessage)(error) }, 500);
+    }
+}
+/**
+ * GET /api/components/:id — Returns detail for a single component.
+ */
+function handleGetComponentById(res, wikiData, componentId) {
+    try {
+        const detail = wikiData.getComponentDetail(componentId);
+        if (!detail) {
+            (0, router_1.send404)(res, `Component not found: ${componentId}`);
+            return;
+        }
+        (0, router_1.sendJson)(res, detail);
+    }
+    catch (error) {
+        (0, router_1.sendJson)(res, { error: (0, router_1.getErrorMessage)(error) }, 500);
+    }
+}
+/**
+ * GET /api/pages/:key — Returns a special page.
+ */
+function handleGetPage(res, wikiData, key) {
+    try {
+        const page = wikiData.getSpecialPage(key);
+        if (!page) {
+            (0, router_1.send404)(res, `Page not found: ${key}`);
+            return;
+        }
+        (0, router_1.sendJson)(res, page);
+    }
+    catch (error) {
+        (0, router_1.sendJson)(res, { error: (0, router_1.getErrorMessage)(error) }, 500);
+    }
+}
+/**
+ * GET /api/themes — Returns list of all theme areas.
+ */
+function handleGetThemes(res, wikiData) {
+    try {
+        const themes = wikiData.getThemeList();
+        (0, router_1.sendJson)(res, themes);
+    }
+    catch (error) {
+        (0, router_1.sendJson)(res, { error: (0, router_1.getErrorMessage)(error) }, 500);
+    }
+}
+/**
+ * GET /api/themes/:themeId — Returns theme area with all articles.
+ */
+function handleGetThemeById(res, wikiData, themeId) {
+    try {
+        const themes = wikiData.getThemeList();
+        const meta = themes.find(t => t.id === themeId);
+        if (!meta) {
+            (0, router_1.send404)(res, `Theme not found: ${themeId}`);
+            return;
+        }
+        const articles = wikiData.getThemeArticles(themeId);
+        (0, router_1.sendJson)(res, { ...meta, articles: articles.map(a => ({ slug: a.slug, title: a.title, content: a.content })) });
+    }
+    catch (error) {
+        (0, router_1.sendJson)(res, { error: (0, router_1.getErrorMessage)(error) }, 500);
+    }
+}
+/**
+ * GET /api/themes/:themeId/:slug — Returns a single theme article.
+ */
+function handleGetThemeArticle(res, wikiData, themeId, slug) {
+    try {
+        const detail = wikiData.getThemeArticle(themeId, slug);
+        if (!detail) {
+            (0, router_1.send404)(res, `Theme article not found: ${themeId}/${slug}`);
+            return;
+        }
+        (0, router_1.sendJson)(res, { themeId, slug, content: detail.content, meta: detail.meta });
+    }
+    catch (error) {
+        (0, router_1.sendJson)(res, { error: (0, router_1.getErrorMessage)(error) }, 500);
+    }
+}
+//# sourceMappingURL=api-handlers.js.map