@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/api/handlers/VectorStoreHandler.js

@@ -0,0 +1,348 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerVectorStoreRoutes = registerVectorStoreRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+const AuthContext_1 = require("../auth/AuthContext");
+const VectorStoreWebhookHandler_1 = require("./VectorStoreWebhookHandler");
+/**
+ * Handler for Vector Store API endpoints (OpenAI Compatible)
+ *
+ * Vector Stores:
+ * - POST   /v1/vector_stores                - Create vector store
+ * - GET    /v1/vector_stores                - List vector stores
+ * - GET    /v1/vector_stores/:id            - Retrieve vector store
+ * - POST   /v1/vector_stores/:id            - Modify vector store
+ * - DELETE /v1/vector_stores/:id            - Delete vector store
+ * - POST   /v1/vector_stores/:id/search     - Search vector store
+ *
+ * Note: File operations (add/remove) are handled via LDP + webhook.
+ * When files are added/removed from the container, webhook triggers indexing.
+ */
+function registerVectorStoreRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('VectorStoreHandler');
+    const service = options.vectorStoreService;
+    // POST /v1/vector_stores - Create vector store
+    server.post('/v1/vector_stores', async (request, response, _params) => {
+        const auth = request.auth;
+        const body = await readJsonBody(request);
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });
+            return;
+        }
+        const payload = body;
+        if (!payload.url || typeof payload.url !== 'string') {
+            sendJson(response, 400, { error: { message: 'url is required', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const createRequest = {
+                name: payload.name,
+                url: payload.url,
+                chunking_strategy: payload.chunking_strategy,
+                metadata: payload.metadata,
+            };
+            const userId = (0, AuthContext_1.getDisplayName)(auth) || (0, AuthContext_1.getWebId)(auth) || (0, AuthContext_1.getAccountId)(auth) || 'anonymous';
+            logger.info(`Creating vector store for ${userId}, container: ${createRequest.url}`);
+            // 传入 accessToken 以便注册 webhook 订阅
+            const accessToken = getAccessToken(request);
+            const result = await service.createVectorStore(createRequest, auth, accessToken);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Create vector store error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // GET /v1/vector_stores - List vector stores
+    server.get('/v1/vector_stores', async (request, response, _params) => {
+        const auth = request.auth;
+        const url = new URL(request.url, `http://${request.headers.host}`);
+        try {
+            const options = {
+                limit: url.searchParams.has('limit') ? parseInt(url.searchParams.get('limit'), 10) : undefined,
+                order: url.searchParams.get('order'),
+                after: url.searchParams.get('after') || undefined,
+                before: url.searchParams.get('before') || undefined,
+            };
+            const result = await service.listVectorStores(auth, options);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`List vector stores error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // GET /v1/vector_stores/:id - Retrieve vector store
+    server.get('/v1/vector_stores/:id', async (request, response, params) => {
+        const auth = request.auth;
+        const id = params.id;
+        if (!id) {
+            sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const result = await service.getVectorStore(id, auth);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            if (error.message?.includes('not found')) {
+                sendJson(response, 404, { error: { message: `Vector store ${id} not found`, type: 'not_found_error' } });
+            }
+            else {
+                logger.error(`Get vector store error: ${error}`);
+                sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+            }
+        }
+    });
+    // POST /v1/vector_stores/:id - Modify vector store
+    server.post('/v1/vector_stores/:id', async (request, response, params) => {
+        const auth = request.auth;
+        const id = params.id;
+        const body = await readJsonBody(request);
+        if (!id) {
+            sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const modifyRequest = {
+                name: body?.name,
+                chunking_strategy: body?.chunking_strategy,
+                metadata: body?.metadata,
+            };
+            const result = await service.modifyVectorStore(id, modifyRequest, auth);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Modify vector store error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // DELETE /v1/vector_stores/:id - Delete vector store
+    server.delete('/v1/vector_stores/:id', async (request, response, params) => {
+        const auth = request.auth;
+        const id = params.id;
+        if (!id) {
+            sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const result = await service.deleteVectorStore(id, auth);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Delete vector store error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // POST /v1/vector_stores/:id/search - Search vector store
+    server.post('/v1/vector_stores/:id/search', async (request, response, params) => {
+        const auth = request.auth;
+        const id = params.id;
+        const body = await readJsonBody(request);
+        if (!id) {
+            sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });
+            return;
+        }
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });
+            return;
+        }
+        const payload = body;
+        if (!payload.query) {
+            sendJson(response, 400, { error: { message: 'query is required', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const searchRequest = {
+                query: payload.query,
+                max_num_results: payload.max_num_results,
+                filters: payload.filters,
+                ranking_options: payload.ranking_options,
+                rewrite_query: payload.rewrite_query,
+            };
+            const accessToken = getAccessToken(request);
+            if (!accessToken) {
+                sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });
+                return;
+            }
+            const userId = (0, AuthContext_1.getDisplayName)(auth) || (0, AuthContext_1.getWebId)(auth) || 'anonymous';
+            const queryText = Array.isArray(searchRequest.query) ? searchRequest.query.join(' ') : searchRequest.query;
+            logger.info(`Vector store search from ${userId}, query: ${queryText.slice(0, 50)}...`);
+            const result = await service.search(id, searchRequest, auth, accessToken);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Search vector store error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // ============================================
+    // AI Configuration endpoints
+    // ============================================
+    // GET /v1/ai/config - Get AI configuration (embedding model, migration status)
+    server.get('/v1/ai/config', async (request, response, _params) => {
+        const auth = request.auth;
+        try {
+            const config = await service.getAIConfig(auth);
+            if (!config) {
+                sendJson(response, 404, { error: { message: 'No AI configuration found', type: 'not_found_error' } });
+                return;
+            }
+            sendJson(response, 200, {
+                object: 'ai.config',
+                embedding_model: config.embeddingModel,
+                migration_status: config.migrationStatus,
+                previous_model: config.previousModel || null,
+                migration_progress: config.migrationProgress || 0,
+            });
+        }
+        catch (error) {
+            logger.error(`Get AI config error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // POST /v1/ai/config - Set embedding model (triggers migration if changed)
+    server.post('/v1/ai/config', async (request, response, _params) => {
+        const auth = request.auth;
+        const body = await readJsonBody(request);
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });
+            return;
+        }
+        const payload = body;
+        if (!payload.embedding_model || typeof payload.embedding_model !== 'string') {
+            sendJson(response, 400, { error: { message: 'embedding_model is required', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const accessToken = getAccessToken(request);
+            if (!accessToken) {
+                sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });
+                return;
+            }
+            const userId = (0, AuthContext_1.getDisplayName)(auth) || (0, AuthContext_1.getWebId)(auth) || 'anonymous';
+            logger.info(`Setting embedding model for ${userId}: ${payload.embedding_model}`);
+            const result = await service.setEmbeddingModel(payload.embedding_model, auth, accessToken);
+            sendJson(response, 200, {
+                object: 'ai.config.update',
+                success: result.success,
+                migration_triggered: result.migrationTriggered,
+                message: result.message,
+            });
+        }
+        catch (error) {
+            logger.error(`Set embedding model error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // ============================================
+    // Webhook endpoint for Solid Notifications
+    // ============================================
+    const webhookHandler = new VectorStoreWebhookHandler_1.VectorStoreWebhookHandler({ vectorStoreService: service });
+    // POST /v1/vector_stores/webhook - Receive Solid Notification
+    // This endpoint is called by Solid Server when files change in a subscribed container
+    server.post('/v1/vector_stores/webhook', async (request, response, _params) => {
+        const auth = request.auth;
+        const body = await readJsonBody(request);
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });
+            return;
+        }
+        const notification = body;
+        // Validate notification structure
+        if (!notification.type || !notification.object?.id) {
+            sendJson(response, 400, { error: { message: 'Invalid notification format', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const accessToken = getAccessToken(request);
+            if (!accessToken) {
+                sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });
+                return;
+            }
+            const userId = (0, AuthContext_1.getDisplayName)(auth) || (0, AuthContext_1.getWebId)(auth) || 'anonymous';
+            logger.info(`Webhook notification from ${userId}: ${notification.type} on ${notification.object.id}`);
+            await webhookHandler.handleNotification(notification, auth, accessToken);
+            sendJson(response, 200, { success: true });
+        }
+        catch (error) {
+            logger.error(`Webhook error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+    // POST /v1/vector_stores/:id/index - Manually index a file (for testing/admin)
+    server.post('/v1/vector_stores/:id/index', async (request, response, params) => {
+        const auth = request.auth;
+        const id = params.id;
+        const body = await readJsonBody(request);
+        if (!id) {
+            sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });
+            return;
+        }
+        if (!body || typeof body !== 'object') {
+            sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });
+            return;
+        }
+        const payload = body;
+        if (!payload.url || typeof payload.url !== 'string') {
+            sendJson(response, 400, { error: { message: 'url is required', type: 'invalid_request_error' } });
+            return;
+        }
+        try {
+            const accessToken = getAccessToken(request);
+            if (!accessToken) {
+                sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });
+                return;
+            }
+            const result = await service.indexFile(payload.url, auth, accessToken);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Index file error: ${error}`);
+            sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });
+        }
+    });
+}
+// ============================================
+// Helpers
+// ============================================
+function getAccessToken(request) {
+    const authHeader = request.headers.authorization;
+    if (!authHeader)
+        return undefined;
+    if (authHeader.startsWith('Bearer ')) {
+        return authHeader.slice(7);
+    }
+    if (authHeader.startsWith('DPoP ')) {
+        return authHeader.slice(5);
+    }
+    return authHeader;
+}
+async function readJsonBody(request) {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        request.setEncoding('utf8');
+        request.on('data', (chunk) => {
+            data += chunk;
+        });
+        request.on('end', () => {
+            if (!data) {
+                resolve(undefined);
+                return;
+            }
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                resolve(undefined);
+            }
+        });
+        request.on('error', reject);
+    });
+}
+function sendJson(response, status, data) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(JSON.stringify(data));
+}
+//# sourceMappingURL=VectorStoreHandler.js.map

package/dist/api/handlers/VectorStoreHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStoreHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/VectorStoreHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ServerResponse } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { ApiServer } from '../ApiServer';\nimport { getWebId, getAccountId, getDisplayName } from '../auth/AuthContext';\nimport type {\n  VectorStoreService,\n  CreateVectorStoreRequest,\n  ModifyVectorStoreRequest,\n  SearchRequest,\n} from '../service/VectorStoreService';\nimport { VectorStoreWebhookHandler, type SolidNotification } from './VectorStoreWebhookHandler';\n\nexport interface VectorStoreHandlerOptions {\n  vectorStoreService: VectorStoreService;\n}\n\n/**\n * Handler for Vector Store API endpoints (OpenAI Compatible)\n *\n * Vector Stores:\n * - POST   /v1/vector_stores                - Create vector store\n * - GET    /v1/vector_stores                - List vector stores\n * - GET    /v1/vector_stores/:id            - Retrieve vector store\n * - POST   /v1/vector_stores/:id            - Modify vector store\n * - DELETE /v1/vector_stores/:id            - Delete vector store\n * - POST   /v1/vector_stores/:id/search     - Search vector store\n *\n * Note: File operations (add/remove) are handled via LDP + webhook.\n * When files are added/removed from the container, webhook triggers indexing.\n */\nexport function registerVectorStoreRoutes(server: ApiServer, options: VectorStoreHandlerOptions): void {\n  const logger = getLoggerFor('VectorStoreHandler');\n  const service = options.vectorStoreService;\n\n  // POST /v1/vector_stores - Create vector store\n  server.post('/v1/vector_stores', async (request, response, _params) => {\n    const auth = request.auth!;\n    const body = await readJsonBody(request);\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n\n    if (!payload.url || typeof payload.url !== 'string') {\n      sendJson(response, 400, { error: { message: 'url is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const createRequest: CreateVectorStoreRequest = {\n        name: payload.name as string | undefined,\n        url: payload.url as string,\n        chunking_strategy: payload.chunking_strategy as 'auto' | 'static' | undefined,\n        metadata: payload.metadata as Record<string, string> | undefined,\n      };\n\n      const userId = getDisplayName(auth) || getWebId(auth) || getAccountId(auth) || 'anonymous';\n      logger.info(`Creating vector store for ${userId}, container: ${createRequest.url}`);\n\n      // 传入 accessToken 以便注册 webhook 订阅\n      const accessToken = getAccessToken(request);\n      const result = await service.createVectorStore(createRequest, auth, accessToken);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`Create vector store error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // GET /v1/vector_stores - List vector stores\n  server.get('/v1/vector_stores', async (request, response, _params) => {\n    const auth = request.auth!;\n    const url = new URL(request.url!, `http://${request.headers.host}`);\n\n    try {\n      const options = {\n        limit: url.searchParams.has('limit') ? parseInt(url.searchParams.get('limit')!, 10) : undefined,\n        order: url.searchParams.get('order') as 'asc' | 'desc' | undefined,\n        after: url.searchParams.get('after') || undefined,\n        before: url.searchParams.get('before') || undefined,\n      };\n\n      const result = await service.listVectorStores(auth, options);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`List vector stores error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // GET /v1/vector_stores/:id - Retrieve vector store\n  server.get('/v1/vector_stores/:id', async (request, response, params) => {\n    const auth = request.auth!;\n    const id = params.id;\n\n    if (!id) {\n      sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const result = await service.getVectorStore(id, auth);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      if (error.message?.includes('not found')) {\n        sendJson(response, 404, { error: { message: `Vector store ${id} not found`, type: 'not_found_error' } });\n      } else {\n        logger.error(`Get vector store error: ${error}`);\n        sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n      }\n    }\n  });\n\n  // POST /v1/vector_stores/:id - Modify vector store\n  server.post('/v1/vector_stores/:id', async (request, response, params) => {\n    const auth = request.auth!;\n    const id = params.id;\n    const body = await readJsonBody(request);\n\n    if (!id) {\n      sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const modifyRequest: ModifyVectorStoreRequest = {\n        name: (body as any)?.name,\n        chunking_strategy: (body as any)?.chunking_strategy,\n        metadata: (body as any)?.metadata,\n      };\n\n      const result = await service.modifyVectorStore(id, modifyRequest, auth);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`Modify vector store error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // DELETE /v1/vector_stores/:id - Delete vector store\n  server.delete('/v1/vector_stores/:id', async (request, response, params) => {\n    const auth = request.auth!;\n    const id = params.id;\n\n    if (!id) {\n      sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const result = await service.deleteVectorStore(id, auth);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`Delete vector store error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // POST /v1/vector_stores/:id/search - Search vector store\n  server.post('/v1/vector_stores/:id/search', async (request, response, params) => {\n    const auth = request.auth!;\n    const id = params.id;\n    const body = await readJsonBody(request);\n\n    if (!id) {\n      sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n\n    if (!payload.query) {\n      sendJson(response, 400, { error: { message: 'query is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const searchRequest: SearchRequest = {\n        query: payload.query as string | string[],\n        max_num_results: payload.max_num_results as number | undefined,\n        filters: payload.filters as Record<string, any> | undefined,\n        ranking_options: payload.ranking_options as any,\n        rewrite_query: payload.rewrite_query as boolean | undefined,\n      };\n\n      const accessToken = getAccessToken(request);\n      if (!accessToken) {\n        sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });\n        return;\n      }\n\n      const userId = getDisplayName(auth) || getWebId(auth) || 'anonymous';\n      const queryText = Array.isArray(searchRequest.query) ? searchRequest.query.join(' ') : searchRequest.query;\n      logger.info(`Vector store search from ${userId}, query: ${queryText.slice(0, 50)}...`);\n\n      const result = await service.search(id, searchRequest, auth, accessToken);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`Search vector store error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // ============================================\n  // AI Configuration endpoints\n  // ============================================\n\n  // GET /v1/ai/config - Get AI configuration (embedding model, migration status)\n  server.get('/v1/ai/config', async (request, response, _params) => {\n    const auth = request.auth!;\n\n    try {\n      const config = await service.getAIConfig(auth);\n      if (!config) {\n        sendJson(response, 404, { error: { message: 'No AI configuration found', type: 'not_found_error' } });\n        return;\n      }\n      sendJson(response, 200, {\n        object: 'ai.config',\n        embedding_model: config.embeddingModel,\n        migration_status: config.migrationStatus,\n        previous_model: config.previousModel || null,\n        migration_progress: config.migrationProgress || 0,\n      });\n    } catch (error: any) {\n      logger.error(`Get AI config error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // POST /v1/ai/config - Set embedding model (triggers migration if changed)\n  server.post('/v1/ai/config', async (request, response, _params) => {\n    const auth = request.auth!;\n    const body = await readJsonBody(request);\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n\n    if (!payload.embedding_model || typeof payload.embedding_model !== 'string') {\n      sendJson(response, 400, { error: { message: 'embedding_model is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const accessToken = getAccessToken(request);\n      if (!accessToken) {\n        sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });\n        return;\n      }\n\n      const userId = getDisplayName(auth) || getWebId(auth) || 'anonymous';\n      logger.info(`Setting embedding model for ${userId}: ${payload.embedding_model}`);\n\n      const result = await service.setEmbeddingModel(payload.embedding_model as string, auth, accessToken);\n      sendJson(response, 200, {\n        object: 'ai.config.update',\n        success: result.success,\n        migration_triggered: result.migrationTriggered,\n        message: result.message,\n      });\n    } catch (error: any) {\n      logger.error(`Set embedding model error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // ============================================\n  // Webhook endpoint for Solid Notifications\n  // ============================================\n\n  const webhookHandler = new VectorStoreWebhookHandler({ vectorStoreService: service });\n\n  // POST /v1/vector_stores/webhook - Receive Solid Notification\n  // This endpoint is called by Solid Server when files change in a subscribed container\n  server.post('/v1/vector_stores/webhook', async (request, response, _params) => {\n    const auth = request.auth!;\n    const body = await readJsonBody(request);\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });\n      return;\n    }\n\n    const notification = body as SolidNotification;\n\n    // Validate notification structure\n    if (!notification.type || !notification.object?.id) {\n      sendJson(response, 400, { error: { message: 'Invalid notification format', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const accessToken = getAccessToken(request);\n      if (!accessToken) {\n        sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });\n        return;\n      }\n\n      const userId = getDisplayName(auth) || getWebId(auth) || 'anonymous';\n      logger.info(`Webhook notification from ${userId}: ${notification.type} on ${notification.object.id}`);\n\n      await webhookHandler.handleNotification(notification, auth, accessToken);\n      sendJson(response, 200, { success: true });\n    } catch (error: any) {\n      logger.error(`Webhook error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n\n  // POST /v1/vector_stores/:id/index - Manually index a file (for testing/admin)\n  server.post('/v1/vector_stores/:id/index', async (request, response, params) => {\n    const auth = request.auth!;\n    const id = params.id;\n    const body = await readJsonBody(request);\n\n    if (!id) {\n      sendJson(response, 400, { error: { message: 'vector_store_id is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    if (!body || typeof body !== 'object') {\n      sendJson(response, 400, { error: { message: 'Request body must be a JSON object', type: 'invalid_request_error' } });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n\n    if (!payload.url || typeof payload.url !== 'string') {\n      sendJson(response, 400, { error: { message: 'url is required', type: 'invalid_request_error' } });\n      return;\n    }\n\n    try {\n      const accessToken = getAccessToken(request);\n      if (!accessToken) {\n        sendJson(response, 401, { error: { message: 'No access token provided', type: 'authentication_error' } });\n        return;\n      }\n\n      const result = await service.indexFile(payload.url as string, auth, accessToken);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`Index file error: ${error}`);\n      sendJson(response, 500, { error: { message: error.message || 'Internal server error', type: 'server_error' } });\n    }\n  });\n}\n\n// ============================================\n// Helpers\n// ============================================\n\nfunction getAccessToken(request: AuthenticatedRequest): string | undefined {\n  const authHeader = request.headers.authorization;\n  if (!authHeader) return undefined;\n\n  if (authHeader.startsWith('Bearer ')) {\n    return authHeader.slice(7);\n  }\n  if (authHeader.startsWith('DPoP ')) {\n    return authHeader.slice(5);\n  }\n  return authHeader;\n}\n\nasync function readJsonBody(request: AuthenticatedRequest): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    let data = '';\n    request.setEncoding('utf8');\n    request.on('data', (chunk: string) => {\n      data += chunk;\n    });\n    request.on('end', () => {\n      if (!data) {\n        resolve(undefined);\n        return;\n      }\n      try {\n        resolve(JSON.parse(data));\n      } catch {\n        resolve(undefined);\n      }\n    });\n    request.on('error', reject);\n  });\n}\n\nfunction sendJson(response: ServerResponse, status: number, data: unknown): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify(data));\n}\n"]}

package/dist/api/handlers/VectorStoreWebhookHandler.d.ts

@@ -0,0 +1,74 @@
+/**
+ * VectorStoreWebhookHandler - 处理 Solid Notification 触发的索引操作
+ *
+ * 当 VectorStore 关联的 Container 中文件发生变化时，自动触发索引更新：
+ * - 文件创建 (as:Create) -> 索引文件
+ * - 文件删除 (as:Delete) -> 删除索引
+ * - 文件更新 (as:Update) -> 重新索引
+ *
+ * 使用方式：
+ * 1. 用户创建 VectorStore 时，系统自动为 Container 创建 WebSocket 订阅
+ * 2. 当文件变化时，Solid Server 发送通知
+ * 3. 本 Handler 处理通知并触发相应的索引操作
+ */
+import type { VectorStoreService } from '../service/VectorStoreService';
+import type { AuthContext } from '../auth/AuthContext';
+/**
+ * Solid Notification 消息格式 (Activity Streams 2.0)
+ */
+export interface SolidNotification {
+    '@context': string | string[];
+    type: 'Create' | 'Update' | 'Delete' | 'Add' | 'Remove';
+    actor?: {
+        type: string;
+        id: string;
+    };
+    object: {
+        type?: string | string[];
+        id: string;
+    };
+    target?: {
+        type: string;
+        id: string;
+    };
+    published: string;
+}
+export interface VectorStoreWebhookHandlerOptions {
+    vectorStoreService: VectorStoreService;
+}
+/**
+ * VectorStoreWebhookHandler - 处理文件变更通知
+ */
+export declare class VectorStoreWebhookHandler {
+    private readonly logger;
+    private readonly vectorStoreService;
+    constructor(options: VectorStoreWebhookHandlerOptions);
+    /**
+     * 处理 Solid Notification
+     *
+     * @param notification Solid Notification 消息
+     * @param auth 认证上下文
+     * @param accessToken 访问令牌
+     */
+    handleNotification(notification: SolidNotification, auth: AuthContext, accessToken: string): Promise<void>;
+    /**
+     * 处理文件创建或更新
+     * 注意：文件只索引一份，VectorStore 只是用来定位分块策略
+     */
+    private handleFileCreatedOrUpdated;
+    /**
+     * 处理文件删除
+     * 注意：文件只索引一份，删除时直接按 fileUrl 删除
+     */
+    private handleFileDeleted;
+    /**
+     * 从文件 URL 提取容器 URL
+     */
+    private extractContainerUrl;
+}
+/**
+ * 创建 WebSocket 订阅配置
+ *
+ * 用于订阅 Container 的文件变更通知
+ */
+export declare function createSubscriptionRequest(containerUrl: string): object;

package/dist/api/handlers/VectorStoreWebhookHandler.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * VectorStoreWebhookHandler - 处理 Solid Notification 触发的索引操作
+ *
+ * 当 VectorStore 关联的 Container 中文件发生变化时，自动触发索引更新：
+ * - 文件创建 (as:Create) -> 索引文件
+ * - 文件删除 (as:Delete) -> 删除索引
+ * - 文件更新 (as:Update) -> 重新索引
+ *
+ * 使用方式：
+ * 1. 用户创建 VectorStore 时，系统自动为 Container 创建 WebSocket 订阅
+ * 2. 当文件变化时，Solid Server 发送通知
+ * 3. 本 Handler 处理通知并触发相应的索引操作
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorStoreWebhookHandler = void 0;
+exports.createSubscriptionRequest = createSubscriptionRequest;
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * VectorStoreWebhookHandler - 处理文件变更通知
+ */
+class VectorStoreWebhookHandler {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.vectorStoreService = options.vectorStoreService;
+    }
+    /**
+     * 处理 Solid Notification
+     *
+     * @param notification Solid Notification 消息
+     * @param auth 认证上下文
+     * @param accessToken 访问令牌
+     */
+    async handleNotification(notification, auth, accessToken) {
+        const fileUrl = notification.object.id;
+        const containerUrl = notification.target?.id || this.extractContainerUrl(fileUrl);
+        this.logger.info(`Received ${notification.type} notification for ${fileUrl} in ${containerUrl}`);
+        // 跳过容器本身的变更
+        if (fileUrl.endsWith('/')) {
+            this.logger.debug(`Skipping container ${fileUrl}`);
+            return;
+        }
+        // 查找所有匹配的 VectorStore（包括父级容器）
+        // 例如：A/B/c.txt 应该被索引到 A/ 和 A/B/ 两个 VectorStore
+        const vectorStores = await this.vectorStoreService.findVectorStoresByFileUrl(fileUrl, auth);
+        if (vectorStores.length === 0) {
+            this.logger.debug(`No VectorStore configured for file ${fileUrl}, skipping`);
+            return;
+        }
+        this.logger.info(`Found ${vectorStores.length} VectorStore(s) for file ${fileUrl}`);
+        // 根据通知类型，对每个匹配的 VectorStore 执行相应操作
+        for (const vectorStore of vectorStores) {
+            switch (notification.type) {
+                case 'Create':
+                case 'Add':
+                case 'Update':
+                    await this.handleFileCreatedOrUpdated(vectorStore.id, fileUrl, auth, accessToken);
+                    break;
+                case 'Delete':
+                case 'Remove':
+                    await this.handleFileDeleted(vectorStore.id, fileUrl, auth, accessToken);
+                    break;
+                default:
+                    this.logger.debug(`Ignoring notification type: ${notification.type}`);
+            }
+        }
+    }
+    /**
+     * 处理文件创建或更新
+     * 注意：文件只索引一份，VectorStore 只是用来定位分块策略
+     */
+    async handleFileCreatedOrUpdated(_vectorStoreId, fileUrl, auth, accessToken) {
+        try {
+            this.logger.info(`Indexing file ${fileUrl}`);
+            const result = await this.vectorStoreService.indexFile(fileUrl, auth, accessToken);
+            this.logger.info(`Indexed file ${fileUrl}: status=${result.status}, vectorId=${result.vectorId}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to index file ${fileUrl}: ${error}`);
+            // 不抛出错误，避免影响其他通知处理
+        }
+    }
+    /**
+     * 处理文件删除
+     * 注意：文件只索引一份，删除时直接按 fileUrl 删除
+     */
+    async handleFileDeleted(_vectorStoreId, fileUrl, auth, accessToken) {
+        try {
+            this.logger.info(`Removing index for file ${fileUrl}`);
+            const result = await this.vectorStoreService.removeFileIndex(fileUrl, auth, accessToken);
+            this.logger.info(`Removed index for file ${fileUrl}: deleted=${result.deleted}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to remove index for file ${fileUrl}: ${error}`);
+        }
+    }
+    /**
+     * 从文件 URL 提取容器 URL
+     */
+    extractContainerUrl(fileUrl) {
+        const lastSlash = fileUrl.lastIndexOf('/');
+        if (lastSlash > 0) {
+            return fileUrl.slice(0, lastSlash + 1);
+        }
+        return fileUrl;
+    }
+}
+exports.VectorStoreWebhookHandler = VectorStoreWebhookHandler;
+/**
+ * 创建 WebSocket 订阅配置
+ *
+ * 用于订阅 Container 的文件变更通知
+ */
+function createSubscriptionRequest(containerUrl) {
+    return {
+        '@context': ['https://www.w3.org/ns/solid/notification/v1'],
+        type: 'http://www.w3.org/ns/solid/notifications#WebSocketChannel2023',
+        topic: containerUrl,
+    };
+}
+//# sourceMappingURL=VectorStoreWebhookHandler.js.map

package/dist/api/handlers/VectorStoreWebhookHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStoreWebhookHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/VectorStoreWebhookHandler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAqJH,8DAMC;AAzJD,iEAAqD;AA0BrD;;GAEG;AACH,MAAa,yBAAyB;IAIpC,YAAmB,OAAyC;QAH3C,WAAM,GAAG,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;QAI3C,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACI,KAAK,CAAC,kBAAkB,CAC7B,YAA+B,EAC/B,IAAiB,EACjB,WAAmB;QAEnB,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,EAAE,EAAE,IAAI,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAElF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,YAAY,CAAC,IAAI,qBAAqB,OAAO,OAAO,YAAY,EAAE,CAAC,CAAC;QAEjG,YAAY;QACZ,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QAED,8BAA8B;QAC9B,+CAA+C;QAC/C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAE5F,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,OAAO,YAAY,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,MAAM,4BAA4B,OAAO,EAAE,CAAC,CAAC;QAEpF,mCAAmC;QACnC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,QAAQ,YAAY,CAAC,IAAI,EAAE,CAAC;gBAC1B,KAAK,QAAQ,CAAC;gBACd,KAAK,KAAK,CAAC;gBACX,KAAK,QAAQ;oBACX,MAAM,IAAI,CAAC,0BAA0B,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;oBAClF,MAAM;gBAER,KAAK,QAAQ,CAAC;gBACd,KAAK,QAAQ;oBACX,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;oBACzE,MAAM;gBAER;oBACE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,0BAA0B,CACtC,cAAsB,EACtB,OAAe,EACf,IAAiB,EACjB,WAAmB;QAEnB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,YAAY,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpG,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;YAC/D,mBAAmB;QACrB,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,iBAAiB,CAC7B,cAAsB,EACtB,OAAe,EACf,IAAiB,EACjB,WAAmB;QAEnB,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACzF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,aAAa,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,OAAe;QACzC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA/GD,8DA+GC;AAED;;;;GAIG;AACH,SAAgB,yBAAyB,CAAC,YAAoB;IAC5D,OAAO;QACL,UAAU,EAAE,CAAC,6CAA6C,CAAC;QAC3D,IAAI,EAAE,+DAA+D;QACrE,KAAK,EAAE,YAAY;KACpB,CAAC;AACJ,CAAC","sourcesContent":["/**\n * VectorStoreWebhookHandler - 处理 Solid Notification 触发的索引操作\n *\n * 当 VectorStore 关联的 Container 中文件发生变化时，自动触发索引更新：\n * - 文件创建 (as:Create) -> 索引文件\n * - 文件删除 (as:Delete) -> 删除索引\n * - 文件更新 (as:Update) -> 重新索引\n *\n * 使用方式：\n * 1. 用户创建 VectorStore 时，系统自动为 Container 创建 WebSocket 订阅\n * 2. 当文件变化时，Solid Server 发送通知\n * 3. 本 Handler 处理通知并触发相应的索引操作\n */\n\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { VectorStoreService } from '../service/VectorStoreService';\nimport type { AuthContext } from '../auth/AuthContext';\n\n/**\n * Solid Notification 消息格式 (Activity Streams 2.0)\n */\nexport interface SolidNotification {\n  '@context': string | string[];\n  type: 'Create' | 'Update' | 'Delete' | 'Add' | 'Remove';\n  actor?: { type: string; id: string };\n  object: {\n    type?: string | string[];\n    id: string; // 资源 URL\n  };\n  target?: {\n    type: string;\n    id: string; // Container URL\n  };\n  published: string;\n}\n\nexport interface VectorStoreWebhookHandlerOptions {\n  vectorStoreService: VectorStoreService;\n}\n\n/**\n * VectorStoreWebhookHandler - 处理文件变更通知\n */\nexport class VectorStoreWebhookHandler {\n  private readonly logger = getLoggerFor(this);\n  private readonly vectorStoreService: VectorStoreService;\n\n  public constructor(options: VectorStoreWebhookHandlerOptions) {\n    this.vectorStoreService = options.vectorStoreService;\n  }\n\n  /**\n   * 处理 Solid Notification\n   *\n   * @param notification Solid Notification 消息\n   * @param auth 认证上下文\n   * @param accessToken 访问令牌\n   */\n  public async handleNotification(\n    notification: SolidNotification,\n    auth: AuthContext,\n    accessToken: string,\n  ): Promise<void> {\n    const fileUrl = notification.object.id;\n    const containerUrl = notification.target?.id || this.extractContainerUrl(fileUrl);\n\n    this.logger.info(`Received ${notification.type} notification for ${fileUrl} in ${containerUrl}`);\n\n    // 跳过容器本身的变更\n    if (fileUrl.endsWith('/')) {\n      this.logger.debug(`Skipping container ${fileUrl}`);\n      return;\n    }\n\n    // 查找所有匹配的 VectorStore（包括父级容器）\n    // 例如：A/B/c.txt 应该被索引到 A/ 和 A/B/ 两个 VectorStore\n    const vectorStores = await this.vectorStoreService.findVectorStoresByFileUrl(fileUrl, auth);\n    \n    if (vectorStores.length === 0) {\n      this.logger.debug(`No VectorStore configured for file ${fileUrl}, skipping`);\n      return;\n    }\n\n    this.logger.info(`Found ${vectorStores.length} VectorStore(s) for file ${fileUrl}`);\n\n    // 根据通知类型，对每个匹配的 VectorStore 执行相应操作\n    for (const vectorStore of vectorStores) {\n      switch (notification.type) {\n        case 'Create':\n        case 'Add':\n        case 'Update':\n          await this.handleFileCreatedOrUpdated(vectorStore.id, fileUrl, auth, accessToken);\n          break;\n\n        case 'Delete':\n        case 'Remove':\n          await this.handleFileDeleted(vectorStore.id, fileUrl, auth, accessToken);\n          break;\n\n        default:\n          this.logger.debug(`Ignoring notification type: ${notification.type}`);\n      }\n    }\n  }\n\n  /**\n   * 处理文件创建或更新\n   * 注意：文件只索引一份，VectorStore 只是用来定位分块策略\n   */\n  private async handleFileCreatedOrUpdated(\n    _vectorStoreId: string,\n    fileUrl: string,\n    auth: AuthContext,\n    accessToken: string,\n  ): Promise<void> {\n    try {\n      this.logger.info(`Indexing file ${fileUrl}`);\n      const result = await this.vectorStoreService.indexFile(fileUrl, auth, accessToken);\n      this.logger.info(`Indexed file ${fileUrl}: status=${result.status}, vectorId=${result.vectorId}`);\n    } catch (error) {\n      this.logger.error(`Failed to index file ${fileUrl}: ${error}`);\n      // 不抛出错误，避免影响其他通知处理\n    }\n  }\n\n  /**\n   * 处理文件删除\n   * 注意：文件只索引一份，删除时直接按 fileUrl 删除\n   */\n  private async handleFileDeleted(\n    _vectorStoreId: string,\n    fileUrl: string,\n    auth: AuthContext,\n    accessToken: string,\n  ): Promise<void> {\n    try {\n      this.logger.info(`Removing index for file ${fileUrl}`);\n      const result = await this.vectorStoreService.removeFileIndex(fileUrl, auth, accessToken);\n      this.logger.info(`Removed index for file ${fileUrl}: deleted=${result.deleted}`);\n    } catch (error) {\n      this.logger.error(`Failed to remove index for file ${fileUrl}: ${error}`);\n    }\n  }\n\n  /**\n   * 从文件 URL 提取容器 URL\n   */\n  private extractContainerUrl(fileUrl: string): string {\n    const lastSlash = fileUrl.lastIndexOf('/');\n    if (lastSlash > 0) {\n      return fileUrl.slice(0, lastSlash + 1);\n    }\n    return fileUrl;\n  }\n}\n\n/**\n * 创建 WebSocket 订阅配置\n *\n * 用于订阅 Container 的文件变更通知\n */\nexport function createSubscriptionRequest(containerUrl: string): object {\n  return {\n    '@context': ['https://www.w3.org/ns/solid/notification/v1'],\n    type: 'http://www.w3.org/ns/solid/notifications#WebSocketChannel2023',\n    topic: containerUrl,\n  };\n}\n"]}

package/dist/api/handlers/WebIdProfileHandler.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WebID Profile API Handler
+ *
+ * 提供 WebID Profile 托管服务的 HTTP API
+ *
+ * GET  /{username}/profile/card     - 获取 WebID Profile (Turtle 格式)
+ * POST /api/v1/identity/{username}/storage - 更新 storage 指针 (需认证)
+ */
+import type { ApiServer } from '../ApiServer';
+import type { WebIdProfileRepository } from '../../identity/drizzle/WebIdProfileRepository';
+export interface WebIdProfileHandlerOptions {
+    profileRepo: WebIdProfileRepository;
+}
+export declare function registerWebIdProfileRoutes(server: ApiServer, options: WebIdProfileHandlerOptions): void;