@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/http/search/SearchHttpHandler.js

@@ -0,0 +1,312 @@
+"use strict";
+/**
+ * SearchHttpHandler - 语义搜索 HTTP 处理器
+ *
+ * 提供 /-/search 端点，支持基于向量的语义搜索。
+ *
+ * 端点：
+ * - GET  {path}/-/search?q=...     简单搜索
+ * - POST {path}/-/search           复杂搜索（支持 filter 等）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchHttpHandler = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const community_server_1 = require("@solid/community-server");
+const community_server_2 = require("@solid/community-server");
+const policy_engine_1 = require("@solidlab/policy-engine");
+const ALLOWED_METHODS = ['GET', 'POST', 'OPTIONS'];
+class SearchApiError extends Error {
+    constructor(code, statusCode, message) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.name = 'SearchApiError';
+    }
+    static invalidRequest(message) {
+        return new SearchApiError('INVALID_REQUEST', 400, message);
+    }
+    static noCredential() {
+        return new SearchApiError('NO_CREDENTIAL', 400, 'No AI credential found. Please configure AI credentials in your Pod settings.');
+    }
+    static embeddingError(message) {
+        return new SearchApiError('EMBEDDING_ERROR', 502, `Embedding generation failed: ${message}`);
+    }
+    static searchError(message) {
+        return new SearchApiError('SEARCH_ERROR', 500, `Search failed: ${message}`);
+    }
+}
+class SearchHttpHandler extends community_server_1.HttpHandler {
+    constructor(vectorStore, embeddingService, sparqlEngine, credentialsExtractor, permissionReader, authorizer, options = {}) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.vectorStore = vectorStore;
+        this.embeddingService = embeddingService;
+        this.sparqlEngine = sparqlEngine;
+        this.credentialsExtractor = credentialsExtractor;
+        this.permissionReader = permissionReader;
+        this.authorizer = authorizer;
+        this.sidecarPath = options.sidecarPath ?? '/-/search';
+        this.defaultModel = options.defaultModel ?? 'text-embedding-004';
+        this.defaultLimit = options.defaultLimit ?? 10;
+    }
+    async canHandle({ request }) {
+        const path = this.parseUrl(request).pathname;
+        if (!path.includes(this.sidecarPath)) {
+            throw new community_server_2.NotImplementedHttpError('Request is not targeting a search endpoint.');
+        }
+    }
+    async handle({ request, response }) {
+        const method = (request.method ?? 'GET').toUpperCase();
+        if (method === 'OPTIONS') {
+            this.writeOptions(response);
+            return;
+        }
+        if (!ALLOWED_METHODS.includes(method)) {
+            throw new community_server_2.MethodNotAllowedHttpError(ALLOWED_METHODS);
+        }
+        try {
+            const url = this.parseUrl(request);
+            const path = decodeURIComponent(url.pathname);
+            const sidecarIndex = path.indexOf(this.sidecarPath);
+            if (sidecarIndex === -1) {
+                throw new community_server_2.NotImplementedHttpError('Request is not targeting a search endpoint.');
+            }
+            // 提取 base path（sidecar 之前的路径）
+            let basePath = path.slice(0, sidecarIndex);
+            if (!basePath.endsWith('/')) {
+                basePath = `${basePath}/`;
+            }
+            const origin = `${url.protocol}//${url.host}`;
+            const baseUrl = `${origin}${basePath}`;
+            this.logger.debug(`Search request: ${method} ${path}, baseUrl=${baseUrl}`);
+            // 鉴权
+            await this.authorizeFor(baseUrl, request, [policy_engine_1.PERMISSIONS.Read]);
+            // 解析请求
+            const searchRequest = await this.parseSearchRequest(request, url);
+            // 执行搜索
+            const result = await this.executeSearch(searchRequest, baseUrl);
+            this.sendJsonResponse(response, result);
+        }
+        catch (error) {
+            this.handleError(response, error);
+        }
+    }
+    /**
+     * 解析搜索请求
+     */
+    async parseSearchRequest(request, url) {
+        const method = (request.method ?? 'GET').toUpperCase();
+        if (method === 'GET') {
+            // GET 请求从 query string 解析
+            const query = url.searchParams.get('q') || url.searchParams.get('query');
+            const limit = url.searchParams.get('limit');
+            const threshold = url.searchParams.get('threshold');
+            const model = url.searchParams.get('model');
+            if (!query) {
+                throw SearchApiError.invalidRequest('Missing query parameter "q"');
+            }
+            return {
+                query,
+                limit: limit ? parseInt(limit, 10) : undefined,
+                threshold: threshold ? parseFloat(threshold) : undefined,
+                model: model || undefined,
+            };
+        }
+        // POST 请求从 body 解析
+        const body = await this.readJsonBody(request);
+        if (!body.query && !body.vector) {
+            throw SearchApiError.invalidRequest('Either "query" or "vector" is required');
+        }
+        return body;
+    }
+    /**
+     * 执行搜索
+     */
+    async executeSearch(request, baseUrl) {
+        const startTime = Date.now();
+        const model = request.model || this.defaultModel;
+        let queryVector = request.vector;
+        // 如果提供了 query 文本，需要生成 embedding
+        if (request.query && !queryVector) {
+            // 获取 AI 凭据
+            const credential = await this.getAiCredential(baseUrl);
+            if (!credential) {
+                throw SearchApiError.noCredential();
+            }
+            try {
+                queryVector = await this.embeddingService.embed(request.query, credential, model);
+            }
+            catch (error) {
+                throw SearchApiError.embeddingError(error instanceof Error ? error.message : String(error));
+            }
+        }
+        if (!queryVector) {
+            throw SearchApiError.invalidRequest('Failed to generate query vector');
+        }
+        // 执行向量搜索
+        const searchOptions = {
+            limit: request.limit ?? this.defaultLimit,
+            threshold: request.threshold,
+        };
+        try {
+            const vectorResults = await this.vectorStore.search(model, queryVector, searchOptions);
+            // 转换结果
+            const results = vectorResults.map((r) => ({
+                subject: this.vectorIdToSubject(r.id, baseUrl),
+                score: r.score,
+                distance: r.distance,
+            }));
+            return {
+                results,
+                model,
+                took_ms: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            throw SearchApiError.searchError(error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * 获取 AI 凭据
+     */
+    async getAiCredential(podBaseUrl) {
+        try {
+            // 使用 undefineds.co/ns# 命名空间，与 drizzle-solid schema 一致
+            const query = `
+        PREFIX udfs: <https://undefineds.co/ns#>
+        SELECT ?apiKey ?baseUrl ?providerUri ?proxyUrl WHERE {
+          ?cred a udfs:Credential ;
+                udfs:service "ai" ;
+                udfs:status "active" ;
+                udfs:apiKey ?apiKey .
+          OPTIONAL { ?cred udfs:provider ?providerUri }
+          OPTIONAL {
+            ?cred udfs:provider ?providerUri .
+            ?providerUri udfs:baseUrl ?baseUrl .
+          }
+          OPTIONAL {
+            ?cred udfs:provider ?providerUri .
+            ?providerUri udfs:proxyUrl ?proxyUrl .
+          }
+        } LIMIT 1
+      `;
+            const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);
+            for await (const binding of bindingsStream) {
+                const apiKey = binding.get('apiKey');
+                const baseUrl = binding.get('baseUrl');
+                const providerUri = binding.get('providerUri');
+                const proxyUrl = binding.get('proxyUrl');
+                if (apiKey) {
+                    // 从 provider URI 提取 provider 名称（如 #google -> google）
+                    let providerName = 'google';
+                    if (providerUri?.value) {
+                        const match = providerUri.value.match(/#([^#]+)$/);
+                        if (match)
+                            providerName = match[1];
+                    }
+                    return {
+                        apiKey: apiKey.value,
+                        baseUrl: baseUrl?.value,
+                        provider: providerName,
+                        proxyUrl: proxyUrl?.value,
+                    };
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            this.logger.error(`Failed to query AI credential: ${error}`);
+            return null;
+        }
+    }
+    /**
+     * 将向量 ID 转换回 subject URI
+     * 注意：这是一个简化实现，实际需要维护 ID -> URI 的映射
+     */
+    vectorIdToSubject(id, baseUrl) {
+        // TODO: 实现 ID -> URI 映射查询
+        // 目前返回占位符
+        return `${baseUrl}#vector-${id}`;
+    }
+    // ============================================
+    // 辅助方法
+    // ============================================
+    handleError(response, error) {
+        if (error instanceof SearchApiError) {
+            this.logger.error(`Search API error [${error.code}]: ${error.message}`);
+            this.sendErrorResponse(response, error.statusCode, error.code, error.message);
+            return;
+        }
+        if (error instanceof community_server_2.HttpError) {
+            const errorMsg = error.message || error.name || `HTTP ${error.statusCode}`;
+            this.logger.error(`HTTP error ${error.statusCode}: ${errorMsg}`);
+            this.sendErrorResponse(response, error.statusCode, 'HTTP_ERROR', errorMsg);
+            return;
+        }
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        this.logger.error(`Unexpected error: ${errorMsg}`);
+        this.sendErrorResponse(response, 500, 'INTERNAL_ERROR', errorMsg || 'Internal server error');
+    }
+    async authorizeFor(baseUrl, request, permissions) {
+        const credentials = await this.credentialsExtractor.handleSafe(request);
+        const identifier = { path: baseUrl };
+        const requestedModes = new community_server_2.IdentifierSetMultiMap([[identifier, permissions]]);
+        const availablePermissions = await this.permissionReader.handleSafe({
+            credentials,
+            identifier,
+            requestedModes,
+        });
+        this.logger.debug(`authorizeFor: baseUrl=${baseUrl}, webId=${credentials.agent?.webId}`);
+        await this.authorizer.handleSafe({
+            credentials,
+            identifier,
+            requestedModes,
+            availablePermissions,
+        });
+    }
+    parseUrl(request) {
+        const protocol = request.headers['x-forwarded-proto'] || 'http';
+        const host = request.headers['x-forwarded-host'] || request.headers.host || 'localhost';
+        return new URL(request.url, `${protocol}://${host}`);
+    }
+    async readJsonBody(request) {
+        const chunks = [];
+        for await (const chunk of request) {
+            chunks.push(chunk);
+        }
+        const body = Buffer.concat(chunks).toString('utf8');
+        try {
+            return JSON.parse(body);
+        }
+        catch {
+            throw SearchApiError.invalidRequest('Invalid JSON body');
+        }
+    }
+    sendJsonResponse(response, data, status = 200) {
+        response.writeHead(status, {
+            'Content-Type': 'application/json',
+            'Cache-Control': 'no-cache',
+        });
+        response.end(JSON.stringify(data));
+    }
+    sendErrorResponse(response, status, code, message) {
+        response.writeHead(status, {
+            'Content-Type': 'application/json',
+            'Cache-Control': 'no-cache',
+        });
+        response.end(JSON.stringify({
+            error: true,
+            code,
+            message,
+        }));
+    }
+    writeOptions(response) {
+        response.writeHead(204, {
+            'Access-Control-Allow-Methods': ALLOWED_METHODS.join(', '),
+            'Access-Control-Allow-Headers': 'Content-Type, Authorization',
+        });
+        response.end();
+    }
+}
+exports.SearchHttpHandler = SearchHttpHandler;
+//# sourceMappingURL=SearchHttpHandler.js.map

package/dist/http/search/SearchHttpHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchHttpHandler.js","sourceRoot":"","sources":["../../../src/http/search/SearchHttpHandler.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,iEAAqD;AACrD,8DAAsD;AAEtD,8DAKiC;AACjC,2DAAsD;AAQtD,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;AAsDnD,MAAM,cAAe,SAAQ,KAAK;IAChC,YACkB,IAAqB,EACrB,UAAkB,EAClC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAiB;QACrB,eAAU,GAAV,UAAU,CAAQ;QAIlC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAAe;QACnC,OAAO,IAAI,cAAc,CAAC,iBAAiB,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,YAAY;QACjB,OAAO,IAAI,cAAc,CAAC,eAAe,EAAE,GAAG,EAAE,+EAA+E,CAAC,CAAC;IACnI,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,OAAe;QACnC,OAAO,IAAI,cAAc,CAAC,iBAAiB,EAAE,GAAG,EAAE,gCAAgC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,OAAe;QAChC,OAAO,IAAI,cAAc,CAAC,cAAc,EAAE,GAAG,EAAE,kBAAkB,OAAO,EAAE,CAAC,CAAC;IAC9E,CAAC;CACF;AAYD,MAAa,iBAAkB,SAAQ,8BAAW;IAahD,YACE,WAAwB,EACxB,gBAAkC,EAClC,YAA0B,EAC1B,oBAA0C,EAC1C,gBAAkC,EAClC,UAAsB,EACtB,UAAoC,EAAE;QAEtC,KAAK,EAAE,CAAC;QArBS,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAsB7C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;QACtD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,oBAAoB,CAAC;QACjE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;IACjD,CAAC;IAEe,KAAK,CAAC,SAAS,CAAC,EAAE,OAAO,EAAoB;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,0CAAuB,CAAC,6CAA6C,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAEe,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAoB;QAClE,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAEvD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,4CAAyB,CAAC,eAAe,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAE9C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACpD,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,0CAAuB,CAAC,6CAA6C,CAAC,CAAC;YACnF,CAAC;YAED,8BAA8B;YAC9B,IAAI,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAC3C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC5B,QAAQ,GAAG,GAAG,QAAQ,GAAG,CAAC;YAC5B,CAAC;YAED,MAAM,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAG,GAAG,MAAM,GAAG,QAAQ,EAAE,CAAC;YAEvC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mBAAmB,MAAM,IAAI,IAAI,aAAa,OAAO,EAAE,CAAC,CAAC;YAE3E,KAAK;YACL,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,2BAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAE9D,OAAO;YACP,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAElE,OAAO;YACP,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAEhE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAAC,OAAoB,EAAE,GAAQ;QAC7D,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAEvD,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,0BAA0B;YAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzE,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACpD,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAE5C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,cAAc,CAAC,cAAc,CAAC,6BAA6B,CAAC,CAAC;YACrE,CAAC;YAED,OAAO;gBACL,KAAK;gBACL,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC9C,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;gBACxD,KAAK,EAAE,KAAK,IAAI,SAAS;aAC1B,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAgB,OAAO,CAAC,CAAC;QAE7D,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,cAAc,CAAC,cAAc,CAAC,wCAAwC,CAAC,CAAC;QAChF,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,aAAa,CAAC,OAAsB,EAAE,OAAe;QACjE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC;QAEjD,IAAI,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;QAEjC,gCAAgC;QAChC,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAClC,WAAW;YACX,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,cAAc,CAAC,YAAY,EAAE,CAAC;YACtC,CAAC;YAED,IAAI,CAAC;gBACH,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YACpF,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,cAAc,CAAC,cAAc,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,cAAc,CAAC,cAAc,CAAC,iCAAiC,CAAC,CAAC;QACzE,CAAC;QAED,SAAS;QACT,MAAM,aAAa,GAAwB;YACzC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY;YACzC,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;YAEvF,OAAO;YACP,MAAM,OAAO,GAAmB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACxD,OAAO,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC;gBAC9C,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;aACrB,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACL,OAAO;gBACP,KAAK;gBACL,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,cAAc,CAAC,WAAW,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,UAAkB;QAC9C,IAAI,CAAC;YACH,sDAAsD;YACtD,MAAM,KAAK,GAAG;;;;;;;;;;;;;;;;;OAiBb,CAAC;YAEF,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;YAEhF,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;gBAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACrC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACvC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAEzC,IAAI,MAAM,EAAE,CAAC;oBACX,qDAAqD;oBACrD,IAAI,YAAY,GAAG,QAAQ,CAAC;oBAC5B,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;wBACvB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;wBACnD,IAAI,KAAK;4BAAE,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACrC,CAAC;oBAED,OAAO;wBACL,MAAM,EAAE,MAAM,CAAC,KAAK;wBACpB,OAAO,EAAE,OAAO,EAAE,KAAK;wBACvB,QAAQ,EAAE,YAAY;wBACtB,QAAQ,EAAE,QAAQ,EAAE,KAAK;qBAC1B,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,iBAAiB,CAAC,EAAU,EAAE,OAAe;QACnD,0BAA0B;QAC1B,UAAU;QACV,OAAO,GAAG,OAAO,WAAW,EAAE,EAAE,CAAC;IACnC,CAAC;IAED,+CAA+C;IAC/C,OAAO;IACP,+CAA+C;IAEvC,WAAW,CAAC,QAAsB,EAAE,KAAc;QACxD,IAAI,KAAK,YAAY,cAAc,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC9E,OAAO;QACT,CAAC;QAED,IAAI,KAAK,YAAY,4BAAS,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,QAAQ,KAAK,CAAC,UAAU,EAAE,CAAC;YAC3E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;YAC3E,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,QAAQ,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,QAAQ,IAAI,uBAAuB,CAAC,CAAC;IAC/F,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,OAAe,EACf,OAAoB,EACpB,WAA2D;QAE3D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxE,MAAM,UAAU,GAAuB,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACzD,MAAM,cAAc,GAAG,IAAI,wCAAqB,CAAC,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAQ,CAAC,CAAC;QAErF,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC;YAClE,WAAW;YACX,UAAU;YACV,cAAc;SACR,CAAC,CAAC;QAEV,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,OAAO,WAAW,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAEzF,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAC/B,WAAW;YACX,UAAU;YACV,cAAc;YACd,oBAAoB;SACd,CAAC,CAAC;IACZ,CAAC;IAEO,QAAQ,CAAC,OAAoB;QACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,MAAM,CAAC;QAChE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QACxF,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAI,EAAE,GAAG,QAAQ,MAAM,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,YAAY,CAAI,OAAoB;QAChD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,cAAc,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,QAAsB,EAAE,IAAa,EAAE,MAAM,GAAG,GAAG;QAC1E,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;YACzB,cAAc,EAAE,kBAAkB;YAClC,eAAe,EAAE,UAAU;SAC5B,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;IAEO,iBAAiB,CACvB,QAAsB,EACtB,MAAc,EACd,IAAY,EACZ,OAAe;QAEf,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;YACzB,cAAc,EAAE,kBAAkB;YAClC,eAAe,EAAE,UAAU;SAC5B,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,CACV,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,IAAI;YACX,IAAI;YACJ,OAAO;SACR,CAAC,CACH,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,QAAsB;QACzC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YACtB,8BAA8B,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1D,8BAA8B,EAAE,6BAA6B;SAC9D,CAAC,CAAC;QACH,QAAQ,CAAC,GAAG,EAAE,CAAC;IACjB,CAAC;CACF;AAzVD,8CAyVC","sourcesContent":["/**\n * SearchHttpHandler - 语义搜索 HTTP 处理器\n *\n * 提供 /-/search 端点，支持基于向量的语义搜索。\n *\n * 端点：\n * - GET  {path}/-/search?q=...     简单搜索\n * - POST {path}/-/search           复杂搜索（支持 filter 等）\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport { HttpHandler } from '@solid/community-server';\nimport type { HttpHandlerInput, HttpRequest, HttpResponse } from '@solid/community-server';\nimport {\n  NotImplementedHttpError,\n  MethodNotAllowedHttpError,\n  HttpError,\n  IdentifierSetMultiMap,\n} from '@solid/community-server';\nimport { PERMISSIONS } from '@solidlab/policy-engine';\nimport type { CredentialsExtractor, PermissionReader, Authorizer, ResourceIdentifier } from '@solid/community-server';\nimport type { VectorStore } from '../../storage/vector/VectorStore';\nimport type { EmbeddingService } from '../../ai/service/EmbeddingService';\nimport type { SparqlEngine } from '../../storage/sparql/SubgraphQueryEngine';\nimport type { AiCredential } from '../../ai/service/types';\nimport type { VectorSearchOptions } from '../../storage/vector/types';\n\nconst ALLOWED_METHODS = ['GET', 'POST', 'OPTIONS'];\n\n// ============================================\n// 请求/响应类型\n// ============================================\n\ninterface SearchRequest {\n  /** 查询文本 */\n  query?: string;\n  /** 预计算的查询向量 */\n  vector?: number[];\n  /** 返回结果数量，默认 10 */\n  limit?: number;\n  /** 相似度阈值 (0-1) */\n  threshold?: number;\n  /** 过滤条件 */\n  filter?: {\n    type?: string;\n    graphPrefix?: string;\n    subjectPrefix?: string;\n  };\n  /** embedding 模型 */\n  model?: string;\n}\n\ninterface SearchResult {\n  /** 资源 URI */\n  subject: string;\n  /** 相似度分数 (0-1) */\n  score: number;\n  /** 距离 */\n  distance?: number;\n  /** 文本片段 */\n  snippet?: string;\n}\n\ninterface SearchResponse {\n  results: SearchResult[];\n  model: string;\n  took_ms: number;\n}\n\n// ============================================\n// 错误处理\n// ============================================\n\ntype SearchErrorCode =\n  | 'INVALID_REQUEST'\n  | 'UNAUTHORIZED'\n  | 'FORBIDDEN'\n  | 'NO_CREDENTIAL'\n  | 'EMBEDDING_ERROR'\n  | 'SEARCH_ERROR';\n\nclass SearchApiError extends Error {\n  constructor(\n    public readonly code: SearchErrorCode,\n    public readonly statusCode: number,\n    message: string,\n  ) {\n    super(message);\n    this.name = 'SearchApiError';\n  }\n\n  static invalidRequest(message: string): SearchApiError {\n    return new SearchApiError('INVALID_REQUEST', 400, message);\n  }\n\n  static noCredential(): SearchApiError {\n    return new SearchApiError('NO_CREDENTIAL', 400, 'No AI credential found. Please configure AI credentials in your Pod settings.');\n  }\n\n  static embeddingError(message: string): SearchApiError {\n    return new SearchApiError('EMBEDDING_ERROR', 502, `Embedding generation failed: ${message}`);\n  }\n\n  static searchError(message: string): SearchApiError {\n    return new SearchApiError('SEARCH_ERROR', 500, `Search failed: ${message}`);\n  }\n}\n\n// ============================================\n// Handler\n// ============================================\n\nexport interface SearchHttpHandlerOptions {\n  sidecarPath?: string;\n  defaultModel?: string;\n  defaultLimit?: number;\n}\n\nexport class SearchHttpHandler extends HttpHandler {\n  protected readonly logger = getLoggerFor(this);\n\n  private readonly vectorStore: VectorStore;\n  private readonly embeddingService: EmbeddingService;\n  private readonly sparqlEngine: SparqlEngine;\n  private readonly credentialsExtractor: CredentialsExtractor;\n  private readonly permissionReader: PermissionReader;\n  private readonly authorizer: Authorizer;\n  private readonly sidecarPath: string;\n  private readonly defaultModel: string;\n  private readonly defaultLimit: number;\n\n  public constructor(\n    vectorStore: VectorStore,\n    embeddingService: EmbeddingService,\n    sparqlEngine: SparqlEngine,\n    credentialsExtractor: CredentialsExtractor,\n    permissionReader: PermissionReader,\n    authorizer: Authorizer,\n    options: SearchHttpHandlerOptions = {},\n  ) {\n    super();\n    this.vectorStore = vectorStore;\n    this.embeddingService = embeddingService;\n    this.sparqlEngine = sparqlEngine;\n    this.credentialsExtractor = credentialsExtractor;\n    this.permissionReader = permissionReader;\n    this.authorizer = authorizer;\n    this.sidecarPath = options.sidecarPath ?? '/-/search';\n    this.defaultModel = options.defaultModel ?? 'text-embedding-004';\n    this.defaultLimit = options.defaultLimit ?? 10;\n  }\n\n  public override async canHandle({ request }: HttpHandlerInput): Promise<void> {\n    const path = this.parseUrl(request).pathname;\n    if (!path.includes(this.sidecarPath)) {\n      throw new NotImplementedHttpError('Request is not targeting a search endpoint.');\n    }\n  }\n\n  public override async handle({ request, response }: HttpHandlerInput): Promise<void> {\n    const method = (request.method ?? 'GET').toUpperCase();\n\n    if (method === 'OPTIONS') {\n      this.writeOptions(response);\n      return;\n    }\n\n    if (!ALLOWED_METHODS.includes(method)) {\n      throw new MethodNotAllowedHttpError(ALLOWED_METHODS);\n    }\n\n    try {\n      const url = this.parseUrl(request);\n      const path = decodeURIComponent(url.pathname);\n\n      const sidecarIndex = path.indexOf(this.sidecarPath);\n      if (sidecarIndex === -1) {\n        throw new NotImplementedHttpError('Request is not targeting a search endpoint.');\n      }\n\n      // 提取 base path（sidecar 之前的路径）\n      let basePath = path.slice(0, sidecarIndex);\n      if (!basePath.endsWith('/')) {\n        basePath = `${basePath}/`;\n      }\n\n      const origin = `${url.protocol}//${url.host}`;\n      const baseUrl = `${origin}${basePath}`;\n\n      this.logger.debug(`Search request: ${method} ${path}, baseUrl=${baseUrl}`);\n\n      // 鉴权\n      await this.authorizeFor(baseUrl, request, [PERMISSIONS.Read]);\n\n      // 解析请求\n      const searchRequest = await this.parseSearchRequest(request, url);\n\n      // 执行搜索\n      const result = await this.executeSearch(searchRequest, baseUrl);\n\n      this.sendJsonResponse(response, result);\n    } catch (error: unknown) {\n      this.handleError(response, error);\n    }\n  }\n\n  /**\n   * 解析搜索请求\n   */\n  private async parseSearchRequest(request: HttpRequest, url: URL): Promise<SearchRequest> {\n    const method = (request.method ?? 'GET').toUpperCase();\n\n    if (method === 'GET') {\n      // GET 请求从 query string 解析\n      const query = url.searchParams.get('q') || url.searchParams.get('query');\n      const limit = url.searchParams.get('limit');\n      const threshold = url.searchParams.get('threshold');\n      const model = url.searchParams.get('model');\n\n      if (!query) {\n        throw SearchApiError.invalidRequest('Missing query parameter \"q\"');\n      }\n\n      return {\n        query,\n        limit: limit ? parseInt(limit, 10) : undefined,\n        threshold: threshold ? parseFloat(threshold) : undefined,\n        model: model || undefined,\n      };\n    }\n\n    // POST 请求从 body 解析\n    const body = await this.readJsonBody<SearchRequest>(request);\n\n    if (!body.query && !body.vector) {\n      throw SearchApiError.invalidRequest('Either \"query\" or \"vector\" is required');\n    }\n\n    return body;\n  }\n\n  /**\n   * 执行搜索\n   */\n  private async executeSearch(request: SearchRequest, baseUrl: string): Promise<SearchResponse> {\n    const startTime = Date.now();\n    const model = request.model || this.defaultModel;\n\n    let queryVector = request.vector;\n\n    // 如果提供了 query 文本，需要生成 embedding\n    if (request.query && !queryVector) {\n      // 获取 AI 凭据\n      const credential = await this.getAiCredential(baseUrl);\n      if (!credential) {\n        throw SearchApiError.noCredential();\n      }\n\n      try {\n        queryVector = await this.embeddingService.embed(request.query, credential, model);\n      } catch (error) {\n        throw SearchApiError.embeddingError(error instanceof Error ? error.message : String(error));\n      }\n    }\n\n    if (!queryVector) {\n      throw SearchApiError.invalidRequest('Failed to generate query vector');\n    }\n\n    // 执行向量搜索\n    const searchOptions: VectorSearchOptions = {\n      limit: request.limit ?? this.defaultLimit,\n      threshold: request.threshold,\n    };\n\n    try {\n      const vectorResults = await this.vectorStore.search(model, queryVector, searchOptions);\n\n      // 转换结果\n      const results: SearchResult[] = vectorResults.map((r) => ({\n        subject: this.vectorIdToSubject(r.id, baseUrl),\n        score: r.score,\n        distance: r.distance,\n      }));\n\n      return {\n        results,\n        model,\n        took_ms: Date.now() - startTime,\n      };\n    } catch (error) {\n      throw SearchApiError.searchError(error instanceof Error ? error.message : String(error));\n    }\n  }\n\n  /**\n   * 获取 AI 凭据\n   */\n  private async getAiCredential(podBaseUrl: string): Promise<AiCredential | null> {\n    try {\n      // 使用 undefineds.co/ns# 命名空间，与 drizzle-solid schema 一致\n      const query = `\n        PREFIX udfs: <https://undefineds.co/ns#>\n        SELECT ?apiKey ?baseUrl ?providerUri ?proxyUrl WHERE {\n          ?cred a udfs:Credential ;\n                udfs:service \"ai\" ;\n                udfs:status \"active\" ;\n                udfs:apiKey ?apiKey .\n          OPTIONAL { ?cred udfs:provider ?providerUri }\n          OPTIONAL {\n            ?cred udfs:provider ?providerUri .\n            ?providerUri udfs:baseUrl ?baseUrl .\n          }\n          OPTIONAL {\n            ?cred udfs:provider ?providerUri .\n            ?providerUri udfs:proxyUrl ?proxyUrl .\n          }\n        } LIMIT 1\n      `;\n\n      const bindingsStream = await this.sparqlEngine.queryBindings(query, podBaseUrl);\n\n      for await (const binding of bindingsStream) {\n        const apiKey = binding.get('apiKey');\n        const baseUrl = binding.get('baseUrl');\n        const providerUri = binding.get('providerUri');\n        const proxyUrl = binding.get('proxyUrl');\n\n        if (apiKey) {\n          // 从 provider URI 提取 provider 名称（如 #google -> google）\n          let providerName = 'google';\n          if (providerUri?.value) {\n            const match = providerUri.value.match(/#([^#]+)$/);\n            if (match) providerName = match[1];\n          }\n\n          return {\n            apiKey: apiKey.value,\n            baseUrl: baseUrl?.value,\n            provider: providerName,\n            proxyUrl: proxyUrl?.value,\n          };\n        }\n      }\n\n      return null;\n    } catch (error) {\n      this.logger.error(`Failed to query AI credential: ${error}`);\n      return null;\n    }\n  }\n\n  /**\n   * 将向量 ID 转换回 subject URI\n   * 注意：这是一个简化实现，实际需要维护 ID -> URI 的映射\n   */\n  private vectorIdToSubject(id: number, baseUrl: string): string {\n    // TODO: 实现 ID -> URI 映射查询\n    // 目前返回占位符\n    return `${baseUrl}#vector-${id}`;\n  }\n\n  // ============================================\n  // 辅助方法\n  // ============================================\n\n  private handleError(response: HttpResponse, error: unknown): void {\n    if (error instanceof SearchApiError) {\n      this.logger.error(`Search API error [${error.code}]: ${error.message}`);\n      this.sendErrorResponse(response, error.statusCode, error.code, error.message);\n      return;\n    }\n\n    if (error instanceof HttpError) {\n      const errorMsg = error.message || error.name || `HTTP ${error.statusCode}`;\n      this.logger.error(`HTTP error ${error.statusCode}: ${errorMsg}`);\n      this.sendErrorResponse(response, error.statusCode, 'HTTP_ERROR', errorMsg);\n      return;\n    }\n\n    const errorMsg = error instanceof Error ? error.message : String(error);\n    this.logger.error(`Unexpected error: ${errorMsg}`);\n    this.sendErrorResponse(response, 500, 'INTERNAL_ERROR', errorMsg || 'Internal server error');\n  }\n\n  private async authorizeFor(\n    baseUrl: string,\n    request: HttpRequest,\n    permissions: typeof PERMISSIONS[keyof typeof PERMISSIONS][],\n  ): Promise<void> {\n    const credentials = await this.credentialsExtractor.handleSafe(request);\n    const identifier: ResourceIdentifier = { path: baseUrl };\n    const requestedModes = new IdentifierSetMultiMap([[identifier, permissions]] as any);\n\n    const availablePermissions = await this.permissionReader.handleSafe({\n      credentials,\n      identifier,\n      requestedModes,\n    } as any);\n\n    this.logger.debug(`authorizeFor: baseUrl=${baseUrl}, webId=${credentials.agent?.webId}`);\n\n    await this.authorizer.handleSafe({\n      credentials,\n      identifier,\n      requestedModes,\n      availablePermissions,\n    } as any);\n  }\n\n  private parseUrl(request: HttpRequest): URL {\n    const protocol = request.headers['x-forwarded-proto'] || 'http';\n    const host = request.headers['x-forwarded-host'] || request.headers.host || 'localhost';\n    return new URL(request.url!, `${protocol}://${host}`);\n  }\n\n  private async readJsonBody<T>(request: HttpRequest): Promise<T> {\n    const chunks: Buffer[] = [];\n    for await (const chunk of request) {\n      chunks.push(chunk);\n    }\n    const body = Buffer.concat(chunks).toString('utf8');\n    try {\n      return JSON.parse(body) as T;\n    } catch {\n      throw SearchApiError.invalidRequest('Invalid JSON body');\n    }\n  }\n\n  private sendJsonResponse(response: HttpResponse, data: unknown, status = 200): void {\n    response.writeHead(status, {\n      'Content-Type': 'application/json',\n      'Cache-Control': 'no-cache',\n    });\n    response.end(JSON.stringify(data));\n  }\n\n  private sendErrorResponse(\n    response: HttpResponse,\n    status: number,\n    code: string,\n    message: string,\n  ): void {\n    response.writeHead(status, {\n      'Content-Type': 'application/json',\n      'Cache-Control': 'no-cache',\n    });\n    response.end(\n      JSON.stringify({\n        error: true,\n        code,\n        message,\n      }),\n    );\n  }\n\n  private writeOptions(response: HttpResponse): void {\n    response.writeHead(204, {\n      'Access-Control-Allow-Methods': ALLOWED_METHODS.join(', '),\n      'Access-Control-Allow-Headers': 'Content-Type, Authorization',\n    });\n    response.end();\n  }\n}\n"]}

package/dist/http/search/index.d.ts

@@ -0,0 +1 @@
+export * from './SearchHttpHandler';

package/dist/http/search/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./SearchHttpHandler"), exports);
+//# sourceMappingURL=index.js.map

package/dist/http/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/http/search/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC","sourcesContent":["export * from './SearchHttpHandler';\n"]}

package/dist/http/terminal/TerminalHttpHandler.d.ts

@@ -0,0 +1,45 @@
+import { IncomingMessage } from 'http';
+import { HttpHandler } from '@solid/community-server';
+import type { HttpHandlerInput, CredentialsExtractor } from '@solid/community-server';
+import { TerminalSessionManager } from '../../terminal/TerminalSessionManager';
+export interface TerminalHttpHandlerOptions {
+    /** Sidecar API path, default: '/-/terminal' */
+    sidecarPath?: string;
+    /** Credentials extractor for authentication */
+    credentialsExtractor: CredentialsExtractor;
+    /** Session manager options */
+    maxSessionsPerUser?: number;
+    maxTotalSessions?: number;
+    defaultTimeout?: number;
+    maxTimeout?: number;
+    defaultWorkdir?: string;
+}
+export declare class TerminalHttpHandler extends HttpHandler {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly sidecarPath;
+    private readonly sessionManager;
+    private readonly credentialsExtractor;
+    private wss?;
+    private readonly wsConnections;
+    constructor(options: TerminalHttpHandlerOptions);
+    canHandle({ request }: HttpHandlerInput): Promise<void>;
+    handle({ request, response }: HttpHandlerInput): Promise<void>;
+    /**
+     * Handle WebSocket upgrade requests
+     * This should be called from the server's 'upgrade' event
+     */
+    handleUpgrade(request: IncomingMessage, socket: any, head: Buffer): void;
+    private handleCreateSession;
+    private handleGetSession;
+    private handleDeleteSession;
+    private handleWebSocketConnection;
+    private handleClientMessage;
+    private handleCors;
+    private sendJson;
+    private sendError;
+    private readBody;
+    /**
+     * Get the session manager for external access
+     */
+    getSessionManager(): TerminalSessionManager;
+}