@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/api/handlers/ChatHandler.js

@@ -0,0 +1,230 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerChatRoutes = registerChatRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+const AuthContext_1 = require("../auth/AuthContext");
+/**
+ * Handler for chat completions API (OpenAI-compatible)
+ *
+ * POST /v1/chat/completions - Create a chat completion
+ * POST /v1/responses - Create a response (OpenAI Responses API)
+ * POST /v1/messages - Create a message (Anthropic/OpenAI Threads compatible)
+ * GET  /v1/models - List available models
+ *
+ * Supports both Solid Token (frontend) and API Key (third-party)
+ */
+function registerChatRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('ChatHandler');
+    const chatService = options.chatService;
+    // POST /api/chat/completions
+    server.post('/v1/chat/completions', 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',
+                    code: 'invalid_body',
+                },
+            });
+            return;
+        }
+        const payload = body;
+        // Validate required fields
+        if (!payload.model || typeof payload.model !== 'string') {
+            sendJson(response, 400, {
+                error: {
+                    message: 'model is required',
+                    type: 'invalid_request_error',
+                    code: 'missing_model',
+                },
+            });
+            return;
+        }
+        if (!Array.isArray(payload.messages) || payload.messages.length === 0) {
+            sendJson(response, 400, {
+                error: {
+                    message: 'messages array is required and must not be empty',
+                    type: 'invalid_request_error',
+                    code: 'missing_messages',
+                },
+            });
+            return;
+        }
+        // Get user identifier for rate limiting / logging
+        const userId = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous';
+        const displayName = (0, AuthContext_1.getDisplayName)(auth) || userId;
+        const accountId = (0, AuthContext_1.getAccountId)(auth);
+        // Check if service is available
+        if (!chatService) {
+            sendJson(response, 503, {
+                error: {
+                    message: 'Chat service is not configured',
+                    type: 'service_unavailable',
+                    code: 'service_not_configured',
+                },
+            });
+            return;
+        }
+        try {
+            const completionRequest = {
+                model: payload.model,
+                messages: payload.messages,
+                temperature: typeof payload.temperature === 'number' ? payload.temperature : undefined,
+                max_tokens: typeof payload.max_tokens === 'number' ? payload.max_tokens : undefined,
+                stream: payload.stream === true,
+            };
+            // Handle streaming
+            if (completionRequest.stream) {
+                const streamResult = await chatService.stream(completionRequest, auth);
+                // Vercel AI SDK v6 uses toTextStreamResponse (not toDataStreamResponse)
+                const webResponse = streamResult.toTextStreamResponse();
+                // Copy headers (Content-Type: text/plain; charset=utf-8, X-Vercel-AI-Data-Stream: v1)
+                webResponse.headers.forEach((value, key) => {
+                    response.setHeader(key, value);
+                });
+                response.statusCode = webResponse.status;
+                // Pipe Web Stream to Node Response
+                if (webResponse.body) {
+                    const reader = webResponse.body.getReader();
+                    const pump = async () => {
+                        try {
+                            while (true) {
+                                const { done, value } = await reader.read();
+                                if (done) {
+                                    break;
+                                }
+                                response.write(value);
+                            }
+                        }
+                        catch (e) {
+                            logger.error(`Stream write error: ${e}`);
+                        }
+                        finally {
+                            response.end();
+                        }
+                    };
+                    pump();
+                }
+                else {
+                    response.end();
+                }
+                return;
+            }
+            logger.info(`Chat completion request from ${displayName} (acc: ${accountId}), model: ${completionRequest.model}`);
+            const result = await chatService.complete(completionRequest, auth);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            if (error?.code === 'model_not_configured') {
+                sendJson(response, 400, {
+                    error: {
+                        message: error.message || 'Model is not configured',
+                        type: 'invalid_request_error',
+                        code: 'model_not_configured',
+                    },
+                });
+                return;
+            }
+            logger.error(`Chat completion error: ${error}`);
+            sendJson(response, 500, {
+                error: {
+                    message: error.message || 'Internal server error',
+                    stack: error.stack,
+                    type: 'internal_error',
+                    code: 'internal_error',
+                },
+            });
+        }
+    });
+    // POST /v1/responses - Create a response
+    server.post('/v1/responses', async (request, response, _params) => {
+        const auth = request.auth;
+        const body = await readJsonBody(request);
+        const userId = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous';
+        const displayName = (0, AuthContext_1.getDisplayName)(auth) || userId;
+        const accountId = (0, AuthContext_1.getAccountId)(auth);
+        if (!chatService || !chatService.responses) {
+            sendJson(response, 501, { error: 'Responses API not implemented or configured' });
+            return;
+        }
+        try {
+            logger.info(`Responses API request from ${displayName} (acc: ${accountId})`);
+            const result = await chatService.responses(body, auth);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Responses API error: ${error}`);
+            sendJson(response, 500, { error: error.message || 'Internal server error' });
+        }
+    });
+    // POST /v1/messages - Create a message
+    server.post('/v1/messages', async (request, response, _params) => {
+        const auth = request.auth;
+        const body = await readJsonBody(request);
+        const userId = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous';
+        const displayName = (0, AuthContext_1.getDisplayName)(auth) || userId;
+        const accountId = (0, AuthContext_1.getAccountId)(auth);
+        if (!chatService || !chatService.messages) {
+            sendJson(response, 501, { error: 'Messages API not implemented or configured' });
+            return;
+        }
+        try {
+            logger.info(`Messages API request from ${displayName} (acc: ${accountId})`);
+            const result = await chatService.messages(body, auth);
+            sendJson(response, 200, result);
+        }
+        catch (error) {
+            logger.error(`Messages API error: ${error}`);
+            sendJson(response, 500, { error: error.message || 'Internal server error' });
+        }
+    });
+    // GET /v1/models - List available models (OpenAI-compatible)
+    server.get('/v1/models', async (request, response, _params) => {
+        if (!chatService) {
+            sendJson(response, 503, { error: 'Chat service not configured' });
+            return;
+        }
+        try {
+            const auth = request.auth;
+            const models = await chatService.listModels(auth);
+            sendJson(response, 200, {
+                object: 'list',
+                data: models,
+            });
+        }
+        catch (error) {
+            logger.error(`Failed to list models: ${error}`);
+            sendJson(response, 500, { error: 'Failed to list models' });
+        }
+    });
+}
+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=ChatHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/ChatHandler.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 type { AuthContext } from '../auth/AuthContext';\nimport { getWebId, getAccountId, getDisplayName } from '../auth/AuthContext';\n\n/**\n * Chat completion request (OpenAI-compatible)\n */\nexport interface ChatCompletionRequest {\n  model: string;\n  messages: Array<{\n    role: 'system' | 'user' | 'assistant';\n    content: string;\n  }>;\n  temperature?: number;\n  max_tokens?: number;\n  stream?: boolean;\n}\n\n/**\n * Chat completion response (OpenAI-compatible)\n */\nexport interface ChatCompletionResponse {\n  id: string;\n  object: 'chat.completion';\n  created: number;\n  model: string;\n  choices: Array<{\n    index: number;\n    message: {\n      role: 'assistant';\n      content: string;\n    };\n    finish_reason: 'stop' | 'length' | 'content_filter';\n  }>;\n  usage: {\n    prompt_tokens: number;\n    completion_tokens: number;\n    total_tokens: number;\n  };\n}\n\nexport interface ChatHandlerOptions {\n  /**\n   * Backend chat service to delegate to (e.g., OpenAI, local model)\n   */\n  chatService?: {\n    complete(request: ChatCompletionRequest, auth: AuthContext): Promise<ChatCompletionResponse>;\n    stream(request: ChatCompletionRequest, auth: AuthContext): Promise<any>;\n    responses?(body: any, auth: AuthContext): Promise<any>;\n    messages?(body: any, auth: AuthContext): Promise<any>;\n    listModels(auth?: AuthContext): Promise<any[]>;\n  };\n}\n\n/**\n * Handler for chat completions API (OpenAI-compatible)\n * \n * POST /v1/chat/completions - Create a chat completion\n * POST /v1/responses - Create a response (OpenAI Responses API)\n * POST /v1/messages - Create a message (Anthropic/OpenAI Threads compatible)\n * GET  /v1/models - List available models\n * \n * Supports both Solid Token (frontend) and API Key (third-party)\n */\nexport function registerChatRoutes(server: ApiServer, options: ChatHandlerOptions): void {\n  const logger = getLoggerFor('ChatHandler');\n  const chatService = options.chatService;\n\n  // POST /api/chat/completions\n  server.post('/v1/chat/completions', 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, {\n        error: {\n          message: 'Request body must be a JSON object',\n          type: 'invalid_request_error',\n          code: 'invalid_body',\n        },\n      });\n      return;\n    }\n\n    const payload = body as Record<string, unknown>;\n\n    // Validate required fields\n    if (!payload.model || typeof payload.model !== 'string') {\n      sendJson(response, 400, {\n        error: {\n          message: 'model is required',\n          type: 'invalid_request_error',\n          code: 'missing_model',\n        },\n      });\n      return;\n    }\n\n    if (!Array.isArray(payload.messages) || payload.messages.length === 0) {\n      sendJson(response, 400, {\n        error: {\n          message: 'messages array is required and must not be empty',\n          type: 'invalid_request_error',\n          code: 'missing_messages',\n        },\n      });\n      return;\n    }\n\n    // Get user identifier for rate limiting / logging\n    const userId = getWebId(auth) ?? getAccountId(auth) ?? 'anonymous';\n    const displayName = getDisplayName(auth) || userId;\n    const accountId = getAccountId(auth);\n\n    // Check if service is available\n    if (!chatService) {\n      sendJson(response, 503, {\n        error: {\n          message: 'Chat service is not configured',\n          type: 'service_unavailable',\n          code: 'service_not_configured',\n        },\n      });\n      return;\n    }\n\n    try {\n      const completionRequest: ChatCompletionRequest = {\n        model: payload.model as string,\n        messages: payload.messages as ChatCompletionRequest['messages'],\n        temperature: typeof payload.temperature === 'number' ? payload.temperature : undefined,\n        max_tokens: typeof payload.max_tokens === 'number' ? payload.max_tokens : undefined,\n        stream: payload.stream === true,\n      };\n\n      // Handle streaming\n      if (completionRequest.stream) {\n        const streamResult = await chatService.stream(completionRequest, auth);\n        // Vercel AI SDK v6 uses toTextStreamResponse (not toDataStreamResponse)\n        const webResponse = streamResult.toTextStreamResponse();\n\n        // Copy headers (Content-Type: text/plain; charset=utf-8, X-Vercel-AI-Data-Stream: v1)\n        webResponse.headers.forEach((value: string, key: string) => {\n          response.setHeader(key, value);\n        });\n        response.statusCode = webResponse.status;\n\n        // Pipe Web Stream to Node Response\n        if (webResponse.body) {\n          const reader = webResponse.body.getReader();\n          const pump = async () => {\n            try {\n              while (true) {\n                const { done, value } = await reader.read();\n                if (done) {\n                  break;\n                }\n                response.write(value);\n              }\n            } catch (e) {\n              logger.error(`Stream write error: ${e}`);\n            } finally {\n              response.end();\n            }\n          };\n          pump();\n        } else {\n          response.end();\n        }\n        return;\n      }\n\n      logger.info(`Chat completion request from ${displayName} (acc: ${accountId}), model: ${completionRequest.model}`);\n\n      const result = await chatService.complete(completionRequest, auth);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      if (error?.code === 'model_not_configured') {\n        sendJson(response, 400, {\n          error: {\n            message: error.message || 'Model is not configured',\n            type: 'invalid_request_error',\n            code: 'model_not_configured',\n          },\n        });\n        return;\n      }\n      logger.error(`Chat completion error: ${error}`);\n      sendJson(response, 500, {\n        error: {\n          message: error.message || 'Internal server error',\n          stack: error.stack,\n          type: 'internal_error',\n          code: 'internal_error',\n        },\n      });\n    }\n  });\n\n  // POST /v1/responses - Create a response\n  server.post('/v1/responses', async (request, response, _params) => {\n    const auth = request.auth!;\n    const body = await readJsonBody(request);\n    const userId = getWebId(auth) ?? getAccountId(auth) ?? 'anonymous';\n    const displayName = getDisplayName(auth) || userId;\n    const accountId = getAccountId(auth);\n\n    if (!chatService || !chatService.responses) {\n      sendJson(response, 501, { error: 'Responses API not implemented or configured' });\n      return;\n    }\n\n    try {\n      logger.info(`Responses API request from ${displayName} (acc: ${accountId})`);\n      const result = await chatService.responses(body, auth);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`Responses API error: ${error}`);\n      sendJson(response, 500, { error: error.message || 'Internal server error' });\n    }\n  });\n\n  // POST /v1/messages - Create a message\n  server.post('/v1/messages', async (request, response, _params) => {\n    const auth = request.auth!;\n    const body = await readJsonBody(request);\n    const userId = getWebId(auth) ?? getAccountId(auth) ?? 'anonymous';\n    const displayName = getDisplayName(auth) || userId;\n    const accountId = getAccountId(auth);\n\n    if (!chatService || !chatService.messages) {\n      sendJson(response, 501, { error: 'Messages API not implemented or configured' });\n      return;\n    }\n\n    try {\n      logger.info(`Messages API request from ${displayName} (acc: ${accountId})`);\n      const result = await chatService.messages(body, auth);\n      sendJson(response, 200, result);\n    } catch (error: any) {\n      logger.error(`Messages API error: ${error}`);\n      sendJson(response, 500, { error: error.message || 'Internal server error' });\n    }\n  });\n\n  // GET /v1/models - List available models (OpenAI-compatible)\n  server.get('/v1/models', async (request, response, _params) => {\n    if (!chatService) {\n      sendJson(response, 503, { error: 'Chat service not configured' });\n      return;\n    }\n\n    try {\n      const auth = request.auth;\n      const models = await chatService.listModels(auth);\n      sendJson(response, 200, {\n        object: 'list',\n        data: models,\n      });\n    } catch (error) {\n      logger.error(`Failed to list models: ${error}`);\n      sendJson(response, 500, { error: 'Failed to list models' });\n    }\n  });\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/ChatKitHandler.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ChatKit Handler
+ *
+ * HTTP handler for the ChatKit protocol endpoint.
+ * Provides a single `/chatkit` POST endpoint that handles all ChatKit requests.
+ *
+ * Based on https://github.com/openai/chatkit-python
+ */
+import type { ApiServer } from '../ApiServer';
+import type { ChatKitService } from '../chatkit/service';
+import type { StoreContext } from '../chatkit/store';
+export interface ChatKitHandlerOptions {
+    chatKitService: ChatKitService<StoreContext>;
+}
+/**
+ * Register ChatKit routes on the API server
+ */
+export declare function registerChatKitRoutes(server: ApiServer, options: ChatKitHandlerOptions): void;

package/dist/api/handlers/ChatKitHandler.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * ChatKit Handler
+ *
+ * HTTP handler for the ChatKit protocol endpoint.
+ * Provides a single `/chatkit` POST endpoint that handles all ChatKit requests.
+ *
+ * Based on https://github.com/openai/chatkit-python
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerChatKitRoutes = registerChatKitRoutes;
+const global_logger_factory_1 = require("global-logger-factory");
+const AuthContext_1 = require("../auth/AuthContext");
+/**
+ * Register ChatKit routes on the API server
+ */
+function registerChatKitRoutes(server, options) {
+    const logger = (0, global_logger_factory_1.getLoggerFor)('ChatKitHandler');
+    const { chatKitService } = options;
+    /**
+     * POST /chatkit - Main ChatKit endpoint
+     *
+     * Handles all ChatKit protocol requests:
+     * - Streaming requests (threads.create, threads.add_user_message, etc.)
+     * - Non-streaming requests (threads.get_by_id, threads.list, etc.)
+     */
+    server.post('/chatkit', async (request, response, _params) => {
+        const auth = request.auth;
+        // Get userId from auth context (may be undefined for unauthenticated requests)
+        let userId = 'anonymous';
+        if (auth) {
+            userId = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous';
+        }
+        // Build context for store operations
+        const context = {
+            userId,
+            auth,
+        };
+        try {
+            // Read request body
+            const body = await readRequestBody(request);
+            if (!body) {
+                sendJsonError(response, 400, 'invalid_request', 'Request body is required');
+                return;
+            }
+            logger.debug(`ChatKit request from ${userId}: ${body.slice(0, 200)}...`);
+            // Process the request
+            const result = await chatKitService.process(body, context);
+            if (result.type === 'streaming') {
+                // Stream SSE response
+                await streamResponse(response, result);
+            }
+            else {
+                // Send JSON response
+                sendJsonResponse(response, result);
+            }
+        }
+        catch (error) {
+            logger.error(`ChatKit request failed: ${error}`);
+            if (!response.headersSent) {
+                sendJsonError(response, 500, 'internal_error', error.message || 'Internal server error');
+            }
+        }
+    });
+    /**
+     * GET /chatkit/health - Health check endpoint
+     */
+    server.get('/chatkit/health', async (_request, response, _params) => {
+        response.statusCode = 200;
+        response.setHeader('Content-Type', 'application/json');
+        response.end(JSON.stringify({ status: 'ok', service: 'chatkit' }));
+    }, { public: true });
+    logger.info('ChatKit routes registered: POST /chatkit, GET /chatkit/health');
+}
+/**
+ * Read the entire request body as a string
+ */
+async function readRequestBody(request) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        request.on('data', (chunk) => {
+            chunks.push(chunk);
+        });
+        request.on('end', () => {
+            const body = Buffer.concat(chunks).toString('utf-8');
+            resolve(body);
+        });
+        request.on('error', reject);
+    });
+}
+/**
+ * Stream SSE response
+ */
+async function streamResponse(response, result) {
+    // Set SSE headers
+    response.statusCode = 200;
+    response.setHeader('Content-Type', 'text/event-stream');
+    response.setHeader('Cache-Control', 'no-cache');
+    response.setHeader('Connection', 'keep-alive');
+    response.setHeader('X-Accel-Buffering', 'no'); // Disable nginx buffering
+    // Flush headers immediately
+    response.flushHeaders?.();
+    try {
+        for await (const chunk of result.stream()) {
+            if (response.writableEnded) {
+                break;
+            }
+            response.write(chunk);
+        }
+    }
+    catch (error) {
+        // Try to send error event if response is still writable
+        if (!response.writableEnded) {
+            const errorEvent = {
+                type: 'error',
+                error: {
+                    code: 'stream_error',
+                    message: error.message || 'Stream error occurred',
+                },
+            };
+            response.write(`data: ${JSON.stringify(errorEvent)}\n\n`);
+        }
+    }
+    finally {
+        if (!response.writableEnded) {
+            response.end();
+        }
+    }
+}
+/**
+ * Send JSON response
+ */
+function sendJsonResponse(response, result) {
+    response.statusCode = 200;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(result.json);
+}
+/**
+ * Send JSON error response
+ */
+function sendJsonError(response, status, code, message) {
+    response.statusCode = status;
+    response.setHeader('Content-Type', 'application/json');
+    response.end(JSON.stringify({
+        error: {
+            code,
+            message,
+        },
+    }));
+}
+//# sourceMappingURL=ChatKitHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatKitHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/ChatKitHandler.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAiBH,sDAkEC;AAhFD,iEAAqD;AAKrD,qDAA6D;AAM7D;;GAEG;AACH,SAAgB,qBAAqB,CAAC,MAAiB,EAAE,OAA8B;IACrF,MAAM,MAAM,GAAG,IAAA,oCAAY,EAAC,gBAAgB,CAAC,CAAC;IAC9C,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAEnC;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAE1B,+EAA+E;QAC/E,IAAI,MAAM,GAAG,WAAW,CAAC;QACzB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,IAAA,sBAAQ,EAAC,IAAI,CAAC,IAAI,IAAA,0BAAY,EAAC,IAAI,CAAC,IAAI,WAAW,CAAC;QAC/D,CAAC;QAED,qCAAqC;QACrC,MAAM,OAAO,GAAiB;YAC5B,MAAM;YACN,IAAI;SACL,CAAC;QAEF,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,CAAC;YAE5C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,iBAAiB,EAAE,0BAA0B,CAAC,CAAC;gBAC5E,OAAO;YACT,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,wBAAwB,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;YAEzE,sBAAsB;YACtB,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAE3D,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAChC,sBAAsB;gBACtB,MAAM,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,qBAAqB;gBACrB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;YAEjD,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC1B,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IAEH;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;QAClE,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;QAC1B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAErB,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;AAC/E,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,OAA6B;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACnC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,cAAc,CAAC,QAAwB,EAAE,MAAuB;IAC7E,kBAAkB;IAClB,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;IACxD,QAAQ,CAAC,SAAS,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IAC/C,QAAQ,CAAC,SAAS,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,0BAA0B;IAEzE,4BAA4B;IAC5B,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YAC1C,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,wDAAwD;QACxD,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG;gBACjB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACL,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,uBAAuB;iBAClD;aACF,CAAC;YACF,QAAQ,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,QAAwB,EAAE,MAA0B;IAC5E,QAAQ,CAAC,UAAU,GAAG,GAAG,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAwB,EAAE,MAAc,EAAE,IAAY,EAAE,OAAe;IAC5F,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;QAC1B,KAAK,EAAE;YACL,IAAI;YACJ,OAAO;SACR;KACF,CAAC,CAAC,CAAC;AACN,CAAC","sourcesContent":["/**\n * ChatKit Handler\n * \n * HTTP handler for the ChatKit protocol endpoint.\n * Provides a single `/chatkit` POST endpoint that handles all ChatKit requests.\n * \n * Based on https://github.com/openai/chatkit-python\n */\n\nimport type { ServerResponse } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type { ApiServer } from '../ApiServer';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\nimport type { ChatKitService, StreamingResult, NonStreamingResult } from '../chatkit/service';\nimport type { StoreContext } from '../chatkit/store';\nimport { getWebId, getAccountId } from '../auth/AuthContext';\n\nexport interface ChatKitHandlerOptions {\n  chatKitService: ChatKitService<StoreContext>;\n}\n\n/**\n * Register ChatKit routes on the API server\n */\nexport function registerChatKitRoutes(server: ApiServer, options: ChatKitHandlerOptions): void {\n  const logger = getLoggerFor('ChatKitHandler');\n  const { chatKitService } = options;\n\n  /**\n   * POST /chatkit - Main ChatKit endpoint\n   * \n   * Handles all ChatKit protocol requests:\n   * - Streaming requests (threads.create, threads.add_user_message, etc.)\n   * - Non-streaming requests (threads.get_by_id, threads.list, etc.)\n   */\n  server.post('/chatkit', async (request, response, _params) => {\n    const auth = request.auth;\n    \n    // Get userId from auth context (may be undefined for unauthenticated requests)\n    let userId = 'anonymous';\n    if (auth) {\n      userId = getWebId(auth) ?? getAccountId(auth) ?? 'anonymous';\n    }\n\n    // Build context for store operations\n    const context: StoreContext = {\n      userId,\n      auth,\n    };\n\n    try {\n      // Read request body\n      const body = await readRequestBody(request);\n      \n      if (!body) {\n        sendJsonError(response, 400, 'invalid_request', 'Request body is required');\n        return;\n      }\n\n      logger.debug(`ChatKit request from ${userId}: ${body.slice(0, 200)}...`);\n\n      // Process the request\n      const result = await chatKitService.process(body, context);\n\n      if (result.type === 'streaming') {\n        // Stream SSE response\n        await streamResponse(response, result);\n      } else {\n        // Send JSON response\n        sendJsonResponse(response, result);\n      }\n    } catch (error: any) {\n      logger.error(`ChatKit request failed: ${error}`);\n      \n      if (!response.headersSent) {\n        sendJsonError(response, 500, 'internal_error', error.message || 'Internal server error');\n      }\n    }\n  });\n\n  /**\n   * GET /chatkit/health - Health check endpoint\n   */\n  server.get('/chatkit/health', async (_request, response, _params) => {\n    response.statusCode = 200;\n    response.setHeader('Content-Type', 'application/json');\n    response.end(JSON.stringify({ status: 'ok', service: 'chatkit' }));\n  }, { public: true });\n\n  logger.info('ChatKit routes registered: POST /chatkit, GET /chatkit/health');\n}\n\n/**\n * Read the entire request body as a string\n */\nasync function readRequestBody(request: AuthenticatedRequest): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    \n    request.on('data', (chunk: Buffer) => {\n      chunks.push(chunk);\n    });\n    \n    request.on('end', () => {\n      const body = Buffer.concat(chunks).toString('utf-8');\n      resolve(body);\n    });\n    \n    request.on('error', reject);\n  });\n}\n\n/**\n * Stream SSE response\n */\nasync function streamResponse(response: ServerResponse, result: StreamingResult): Promise<void> {\n  // Set SSE headers\n  response.statusCode = 200;\n  response.setHeader('Content-Type', 'text/event-stream');\n  response.setHeader('Cache-Control', 'no-cache');\n  response.setHeader('Connection', 'keep-alive');\n  response.setHeader('X-Accel-Buffering', 'no'); // Disable nginx buffering\n  \n  // Flush headers immediately\n  response.flushHeaders?.();\n\n  try {\n    for await (const chunk of result.stream()) {\n      if (response.writableEnded) {\n        break;\n      }\n      response.write(chunk);\n    }\n  } catch (error: any) {\n    // Try to send error event if response is still writable\n    if (!response.writableEnded) {\n      const errorEvent = {\n        type: 'error',\n        error: {\n          code: 'stream_error',\n          message: error.message || 'Stream error occurred',\n        },\n      };\n      response.write(`data: ${JSON.stringify(errorEvent)}\\n\\n`);\n    }\n  } finally {\n    if (!response.writableEnded) {\n      response.end();\n    }\n  }\n}\n\n/**\n * Send JSON response\n */\nfunction sendJsonResponse(response: ServerResponse, result: NonStreamingResult): void {\n  response.statusCode = 200;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(result.json);\n}\n\n/**\n * Send JSON error response\n */\nfunction sendJsonError(response: ServerResponse, status: number, code: string, message: string): void {\n  response.statusCode = status;\n  response.setHeader('Content-Type', 'application/json');\n  response.end(JSON.stringify({\n    error: {\n      code,\n      message,\n    },\n  }));\n}\n"]}

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

@@ -0,0 +1,14 @@
+/**
+ * Dashboard 静态资源处理器
+ *
+ * Serve /dashboard/ 路径下的运维 UI 静态资源
+ */
+import type { ApiServer } from '../ApiServer';
+export interface DashboardHandlerOptions {
+    /** 静态资源目录路径 */
+    staticDir: string;
+}
+/**
+ * 注册 Dashboard 路由
+ */
+export declare function registerDashboardRoutes(server: ApiServer, options: DashboardHandlerOptions): void;

package/dist/api/handlers/DashboardHandler.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Dashboard 静态资源处理器
+ *
+ * Serve /dashboard/ 路径下的运维 UI 静态资源
+ */
+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 (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDashboardRoutes = registerDashboardRoutes;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const MIME_TYPES = {
+    '.html': 'text/html',
+    '.js': 'application/javascript',
+    '.css': 'text/css',
+    '.json': 'application/json',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.eot': 'application/vnd.ms-fontobject',
+};
+/**
+ * 注册 Dashboard 路由
+ */
+function registerDashboardRoutes(server, options) {
+    const { staticDir } = options;
+    // 检查目录是否存在
+    if (!fs.existsSync(staticDir)) {
+        console.warn(`[Dashboard] Static directory not found: ${staticDir}`);
+        console.warn('[Dashboard] Run "cd dashboard && yarn build" to build the dashboard UI');
+        return;
+    }
+    console.log(`[Dashboard] Serving from: ${staticDir}`);
+    // 处理 /dashboard 和 /dashboard/ 重定向
+    const redirectHandler = async (_req, res) => {
+        res.statusCode = 302;
+        res.setHeader('Location', '/dashboard/');
+        res.end();
+    };
+    // 静态资源处理器
+    const staticHandler = async (_req, res, params) => {
+        let filePath = params.path || 'index.html';
+        // 安全检查：防止路径遍历
+        if (filePath.includes('..')) {
+            res.statusCode = 403;
+            res.end('Forbidden');
+            return;
+        }
+        let fullPath = path.join(staticDir, filePath);
+        // 如果是目录，尝试 dashboard.html
+        if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {
+            fullPath = path.join(fullPath, 'index.html');
+        }
+        // 如果文件不存在，返回 dashboard.html (SPA fallback)
+        if (!fs.existsSync(fullPath)) {
+            fullPath = path.join(staticDir, 'index.html');
+        }
+        // 再次检查文件是否存在
+        if (!fs.existsSync(fullPath)) {
+            res.statusCode = 404;
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify({ error: 'Not Found' }));
+            return;
+        }
+        // 获取 MIME 类型
+        const ext = path.extname(fullPath).toLowerCase();
+        const mimeType = MIME_TYPES[ext] || 'application/octet-stream';
+        // 读取并返回文件
+        try {
+            const content = fs.readFileSync(fullPath);
+            res.statusCode = 200;
+            res.setHeader('Content-Type', mimeType);
+            res.setHeader('Cache-Control', ext === '.html' ? 'no-cache' : 'public, max-age=31536000');
+            res.end(content);
+        }
+        catch (error) {
+            console.error(`[Dashboard] Error reading file: ${fullPath}`, error);
+            res.statusCode = 500;
+            res.setHeader('Content-Type', 'application/json');
+            res.end(JSON.stringify({ error: 'Internal Server Error' }));
+        }
+    };
+    // 注册路由 - 都是 public 的，不需要认证
+    // 使用通配符 *path 匹配所有子路径（包括 assets/xxx.js）
+    server.get('/dashboard', redirectHandler, { public: true });
+    server.get('/dashboard/', staticHandler, { public: true });
+    server.get('/dashboard/*path', staticHandler, { public: true });
+}
+//# sourceMappingURL=DashboardHandler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardHandler.js","sourceRoot":"","sources":["../../../src/api/handlers/DashboardHandler.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Dashboard 静态资源处理器\n *\n * Serve /dashboard/ 路径下的运维 UI 静态资源\n */\n\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport type { ServerResponse } from 'node:http';\nimport type { ApiServer, RouteHandler } from '../ApiServer';\nimport type { AuthenticatedRequest } from '../middleware/AuthMiddleware';\n\nconst MIME_TYPES: Record<string, string> = {\n  '.html': 'text/html',\n  '.js': 'application/javascript',\n  '.css': 'text/css',\n  '.json': 'application/json',\n  '.png': 'image/png',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.ico': 'image/x-icon',\n  '.woff': 'font/woff',\n  '.woff2': 'font/woff2',\n  '.ttf': 'font/ttf',\n  '.eot': 'application/vnd.ms-fontobject',\n};\n\nexport interface DashboardHandlerOptions {\n  /** 静态资源目录路径 */\n  staticDir: string;\n}\n\n/**\n * 注册 Dashboard 路由\n */\nexport function registerDashboardRoutes(\n  server: ApiServer,\n  options: DashboardHandlerOptions,\n): void {\n  const { staticDir } = options;\n\n  // 检查目录是否存在\n  if (!fs.existsSync(staticDir)) {\n    console.warn(`[Dashboard] Static directory not found: ${staticDir}`);\n    console.warn('[Dashboard] Run \"cd dashboard && yarn build\" to build the dashboard UI');\n    return;\n  }\n\n  console.log(`[Dashboard] Serving from: ${staticDir}`);\n\n  // 处理 /dashboard 和 /dashboard/ 重定向\n  const redirectHandler: RouteHandler = async (\n    _req: AuthenticatedRequest,\n    res: ServerResponse,\n  ) => {\n    res.statusCode = 302;\n    res.setHeader('Location', '/dashboard/');\n    res.end();\n  };\n\n  // 静态资源处理器\n  const staticHandler: RouteHandler = async (\n    _req: AuthenticatedRequest,\n    res: ServerResponse,\n    params: Record<string, string>,\n  ) => {\n    let filePath = params.path || 'index.html';\n\n    // 安全检查：防止路径遍历\n    if (filePath.includes('..')) {\n      res.statusCode = 403;\n      res.end('Forbidden');\n      return;\n    }\n\n    let fullPath = path.join(staticDir, filePath);\n\n    // 如果是目录，尝试 dashboard.html\n    if (fs.existsSync(fullPath) && fs.statSync(fullPath).isDirectory()) {\n      fullPath = path.join(fullPath, 'index.html');\n    }\n\n    // 如果文件不存在，返回 dashboard.html (SPA fallback)\n    if (!fs.existsSync(fullPath)) {\n      fullPath = path.join(staticDir, 'index.html');\n    }\n\n    // 再次检查文件是否存在\n    if (!fs.existsSync(fullPath)) {\n      res.statusCode = 404;\n      res.setHeader('Content-Type', 'application/json');\n      res.end(JSON.stringify({ error: 'Not Found' }));\n      return;\n    }\n\n    // 获取 MIME 类型\n    const ext = path.extname(fullPath).toLowerCase();\n    const mimeType = MIME_TYPES[ext] || 'application/octet-stream';\n\n    // 读取并返回文件\n    try {\n      const content = fs.readFileSync(fullPath);\n      res.statusCode = 200;\n      res.setHeader('Content-Type', mimeType);\n      res.setHeader('Cache-Control', ext === '.html' ? 'no-cache' : 'public, max-age=31536000');\n      res.end(content);\n    } catch (error) {\n      console.error(`[Dashboard] Error reading file: ${fullPath}`, error);\n      res.statusCode = 500;\n      res.setHeader('Content-Type', 'application/json');\n      res.end(JSON.stringify({ error: 'Internal Server Error' }));\n    }\n  };\n\n  // 注册路由 - 都是 public 的，不需要认证\n  // 使用通配符 *path 匹配所有子路径（包括 assets/xxx.js）\n  server.get('/dashboard', redirectHandler, { public: true });\n  server.get('/dashboard/', staticHandler, { public: true });\n  server.get('/dashboard/*path', staticHandler, { public: true });\n}\n"]}

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

@@ -0,0 +1,19 @@
+/**
+ * DDNS API Handler
+ *
+ * 提供 DDNS 服务的 HTTP API
+ *
+ * POST /api/v1/ddns/{subdomain}     - 更新 DNS 记录
+ * GET  /api/v1/ddns/{subdomain}     - 查询 DNS 记录
+ * POST /api/v1/ddns/allocate        - 分配子域名
+ * DELETE /api/v1/ddns/{subdomain}   - 释放子域名
+ */
+import type { ApiServer } from '../ApiServer';
+import type { DdnsRepository } from '../../identity/drizzle/DdnsRepository';
+import type { DnsProvider } from '../../dns/DnsProvider';
+export interface DdnsHandlerOptions {
+    ddnsRepo: DdnsRepository;
+    dnsProvider?: DnsProvider;
+    defaultDomain: string;
+}
+export declare function registerDdnsRoutes(server: ApiServer, options: DdnsHandlerOptions): void;