@loom-framework/core 0.1.0-alpha.15 → 0.1.0-alpha.150

package/dist/backend/routes/chat.js

@@ -0,0 +1,257 @@
+/**
+ * Chat SSE Route - HTTP Server-Sent Events streaming for AI chat
+ *
+ * Replaces WebSocket with HTTP SSE for AI conversation streaming.
+ * Ant Design X (useXChat + XRequest) natively consumes this format.
+ *
+ * POST /api/v1/chat
+ *   Body: { content, session_id, button_id?, context?, files? }
+ *   Response: SSE stream with data lines containing JSON chunks
+ */
+import { generateId } from '../../utils/id.js';
+import { mergeContentBlock } from '../ai/content-blocks.js';
+import { resolveButtonPrompt } from '../ai/button-resolver.js';
+import { saveUploadedFile } from './upload.js';
+import { startHeartbeat, startIdleTimeout, refreshIdleTimeout, cleanupSSE, sendSSE, endSSE } from './chat-sse.js';
+import { registerSessionRoutes } from './session-routes.js';
+// ── Shared Schemas ──
+const chatBodySchema = {
+    type: 'object',
+    properties: {
+        content: { type: 'string' },
+        session_id: { type: 'string' },
+        button_id: { type: 'string' },
+        context: { type: 'object', additionalProperties: true },
+        model: { type: 'string' },
+        files: {
+            type: 'array',
+            items: {
+                type: 'object',
+                required: ['uid', 'name', 'size', 'type', 'content'],
+                properties: {
+                    uid: { type: 'string' },
+                    name: { type: 'string' },
+                    size: { type: 'number' },
+                    type: { type: 'string' },
+                    content: { type: 'string' },
+                },
+            },
+        },
+    },
+};
+// ── Route Registration ──
+/**
+ * Register chat SSE route and session REST routes
+ */
+export function registerChatRoutes(fastify, options) {
+    const { engine, sessionManager, config, logger, projectRoot } = options;
+    // Register session CRUD routes (extracted to session-routes.ts)
+    registerSessionRoutes(fastify, { sessionManager });
+    // POST /api/v1/chat — SSE streaming AI response
+    fastify.post('/api/v1/chat', {
+        schema: { body: chatBodySchema },
+    }, async (request, reply) => {
+        const body = request.body;
+        const { content, session_id, button_id, context, files, model } = body;
+        if (!content && !button_id) {
+            return reply.status(400).send({ error: 'content or button_id is required' });
+        }
+        // Auto-generate session_id if not provided
+        const resolvedSessionId = session_id || `session_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+        const isNewSession = !session_id;
+        // Set SSE headers
+        reply.raw.writeHead(200, {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache',
+            Connection: 'keep-alive',
+            'X-Accel-Buffering': 'no', // Disable nginx buffering
+        });
+        // Start heartbeat and idle timeout
+        const sseState = {
+            heartbeat: startHeartbeat(reply),
+            timeout: startIdleTimeout(reply, () => { sseState.clientConnected = false; }),
+            clientConnected: true,
+        };
+        const messageId = generateMessageId();
+        const startTime = Date.now();
+        // Track active process for abort on disconnect
+        let activeProcessKey;
+        // Handle client disconnect - abort the engine process
+        reply.raw.on('close', () => {
+            if (activeProcessKey && engine && 'killSession' in engine) {
+                engine.killSession(activeProcessKey);
+            }
+            cleanupSSE(sseState);
+        });
+        // Handle file uploads
+        const uploadedFiles = [];
+        if (files && files.length > 0 && projectRoot) {
+            for (const file of files) {
+                if (file.content) {
+                    try {
+                        const result = await saveUploadedFile(projectRoot, resolvedSessionId, file.name, file.content);
+                        uploadedFiles.push({ name: file.name, path: result.path });
+                    }
+                    catch (err) {
+                        fastify.log.warn('Failed to save uploaded file %s: %s', file.name, err);
+                    }
+                }
+            }
+        }
+        // Resolve prompt: AI button or direct content
+        let prompt;
+        if (button_id) {
+            const resolved = resolveButtonPrompt(button_id, context, config);
+            if (!resolved) {
+                await sendSSE(reply, { type: 'error', error: `AI button "${button_id}" not found`, message_id: messageId, session_id: resolvedSessionId });
+                endSSE(reply);
+                cleanupSSE(sseState);
+                return;
+            }
+            if (resolved.error) {
+                await sendSSE(reply, { type: 'error', error: resolved.error, message_id: messageId, session_id: resolvedSessionId });
+                endSSE(reply);
+                cleanupSSE(sseState);
+                return;
+            }
+            prompt = resolved.prompt;
+        }
+        else {
+            prompt = content;
+        }
+        // Get or create session
+        const session = await sessionManager.getOrCreate(resolvedSessionId);
+        activeProcessKey = resolvedSessionId;
+        // Add user message to session
+        const userMsg = {
+            id: messageId,
+            role: 'user',
+            content: prompt,
+            timestamp: new Date().toISOString(),
+            files: files?.map((f) => ({ uid: f.uid, name: f.name, size: f.size, type: f.type, url: `/api/v1/uploads/${resolvedSessionId}/${f.name}` })),
+        };
+        await sessionManager.addMessages(resolvedSessionId, [userMsg]);
+        // Call AI engine and stream chunks
+        let aiContent = '';
+        let aiContentBlocks = [];
+        let claudeSessionId;
+        let usage;
+        try {
+            for await (const chunk of engine.call(prompt, {
+                sessionId: resolvedSessionId,
+                resumeSessionId: session.claudeSessionId,
+                files: uploadedFiles.length > 0 ? uploadedFiles : undefined,
+                model,
+                userToken: request.user?.token,
+            })) {
+                // Check if client is still connected
+                if (!sseState.clientConnected)
+                    break;
+                // Merge chunk into content blocks using shared merge logic
+                aiContentBlocks = mergeContentBlock(aiContentBlocks, chunk);
+                if (chunk.type === 'content' && chunk.content) {
+                    aiContent += chunk.content;
+                    const sent = await sendSSE(reply, { type: 'content', content: chunk.content, message_id: messageId, session_id: resolvedSessionId });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+                else if (chunk.type === 'thinking' && chunk.content) {
+                    const sent = await sendSSE(reply, { type: 'thinking', thinking: chunk.content, message_id: messageId, session_id: resolvedSessionId });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+                else if (chunk.type === 'session_info') {
+                    claudeSessionId = chunk.sessionId;
+                    if (chunk.usage)
+                        usage = chunk.usage;
+                }
+                else if (chunk.type === 'error' && chunk.error) {
+                    await sendSSE(reply, { type: 'error', error: chunk.error, message_id: messageId, session_id: resolvedSessionId });
+                }
+                else if (chunk.type === 'tool_call') {
+                    const sent = await sendSSE(reply, {
+                        type: 'tool_call',
+                        toolUseId: chunk.toolUseId,
+                        toolName: chunk.toolName,
+                        toolInput: chunk.toolInput,
+                    });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+                else if (chunk.type === 'tool_result') {
+                    const sent = await sendSSE(reply, {
+                        type: 'tool_result',
+                        toolUseId: chunk.toolUseId || '',
+                        toolResult: chunk.toolResult,
+                    });
+                    if (!sent)
+                        break;
+                    refreshIdleTimeout(sseState, reply, () => { sseState.clientConnected = false; });
+                }
+            }
+        }
+        catch (error) {
+            fastify.log.error('AI engine exception: %s', error);
+            recordLog(logger, resolvedSessionId, messageId, prompt, '', startTime, [], [], error instanceof Error ? error.message : String(error), fastify);
+            await sendSSE(reply, { type: 'error', error: `Processing error: ${error}`, message_id: messageId, session_id: resolvedSessionId });
+            endSSE(reply);
+            cleanupSSE(sseState);
+            return;
+        }
+        // Send completion
+        if (sseState.clientConnected) {
+            const completePayload = {
+                type: 'done',
+                content: aiContent || '(empty response)',
+                message_id: messageId,
+                assistant_message_id: `resp_${messageId}`,
+                session_id: resolvedSessionId,
+                is_new_session: isNewSession || undefined,
+            };
+            if (claudeSessionId)
+                completePayload.claude_session_id = claudeSessionId;
+            if (usage)
+                completePayload.usage = usage;
+            await sendSSE(reply, completePayload);
+            // Persist assistant message (with contentBlocks)
+            const assistantMsg = {
+                id: `resp_${messageId}`,
+                role: 'assistant',
+                content: aiContent || '(empty response)',
+                timestamp: new Date().toISOString(),
+                ...(aiContentBlocks.length > 0 ? { contentBlocks: aiContentBlocks } : {}),
+            };
+            await sessionManager.addMessages(resolvedSessionId, [assistantMsg], claudeSessionId, usage);
+            recordLog(logger, resolvedSessionId, messageId, prompt, aiContent || '(empty response)', startTime, [], [], undefined, fastify, usage);
+        }
+        endSSE(reply);
+        cleanupSSE(sseState);
+    });
+}
+// ── Helpers ──
+function generateMessageId() {
+    return generateId('msg');
+}
+function recordLog(logger, sessionId, messageId, prompt, response, startTime, mcpCalls, cliCalls, error, fastify, usage) {
+    if (!logger)
+        return;
+    const logEntry = {
+        sessionId,
+        messageId,
+        timestamp: new Date().toISOString(),
+        prompt,
+        response,
+        duration: Date.now() - startTime,
+        usage: usage ? { inputTokens: usage.inputTokens, outputTokens: usage.outputTokens } : undefined,
+        mcpCalls,
+        cliCalls,
+        error,
+    };
+    logger.log(logEntry).catch((err) => {
+        fastify.log.warn('Failed to write interaction log: %s', err);
+    });
+}
+//# sourceMappingURL=chat.js.map

package/dist/backend/routes/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/backend/routes/chat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAElH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAe5D,uBAAuB;AAEvB,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,IAAI,EAAE;QACvD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;gBACpD,UAAU,EAAE;oBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACvB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC5B;aACF;SACF;KACF;CACO,CAAC;AAEX,2BAA2B;AAE3B;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAwB,EACxB,OAAyB;IAEzB,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAExE,gEAAgE;IAChE,qBAAqB,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC;IAEnD,gDAAgD;IAChD,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE;QAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;KACjC,EAAE,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAuB,CAAC;QAC7C,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvE,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,2CAA2C;QAC3C,MAAM,iBAAiB,GAAG,UAAU,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC/G,MAAM,YAAY,GAAG,CAAC,UAAU,CAAC;QAEjC,kBAAkB;QAClB,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,EAAE;YACvB,cAAc,EAAE,mBAAmB;YACnC,eAAe,EAAE,UAAU;YAC3B,UAAU,EAAE,YAAY;YACxB,mBAAmB,EAAE,IAAI,EAAE,0BAA0B;SACtD,CAAC,CAAC;QAEH,mCAAmC;QACnC,MAAM,QAAQ,GAAuB;YACnC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC;YAChC,OAAO,EAAE,gBAAgB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC7E,eAAe,EAAE,IAAI;SACtB,CAAC;QAEF,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,+CAA+C;QAC/C,IAAI,gBAAoC,CAAC;QAEzC,sDAAsD;QACtD,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACzB,IAAI,gBAAgB,IAAI,MAAM,IAAI,aAAa,IAAI,MAAM,EAAE,CAAC;gBACzD,MAAiD,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;YACnF,CAAC;YACD,UAAU,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,sBAAsB;QACtB,MAAM,aAAa,GAA0C,EAAE,CAAC;QAChE,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,EAAE,CAAC;YAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,IAAI,CAAC;wBACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;wBAC/F,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC7D,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;oBAC1E,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,IAAI,MAAc,CAAC;QACnB,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,EAAE,OAA6C,EAAE,MAAM,CAAC,CAAC;YACvG,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,SAAS,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBAC3I,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBACrH,MAAM,CAAC,KAAK,CAAC,CAAC;gBACd,UAAU,CAAC,QAAQ,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,OAAQ,CAAC;QACpB,CAAC;QAED,wBAAwB;QACxB,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;QACpE,gBAAgB,GAAG,iBAAiB,CAAC;QAErC,8BAA8B;QAC9B,MAAM,OAAO,GAAmB;YAC9B,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,MAAM;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,iBAAiB,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;SAC5I,CAAC;QACF,MAAM,cAAc,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAE/D,mCAAmC;QACnC,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,eAAe,GAAmB,EAAE,CAAC;QACzC,IAAI,eAAmC,CAAC;QACxC,IAAI,KAA0B,CAAC;QAE/B,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE;gBAC5C,SAAS,EAAE,iBAAiB;gBAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;gBACxC,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS;gBAC3D,KAAK;gBACL,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK;aAC/B,CAAC,EAAE,CAAC;gBACH,qCAAqC;gBACrC,IAAI,CAAC,QAAQ,CAAC,eAAe;oBAAE,MAAM;gBAErC,2DAA2D;gBAC3D,eAAe,GAAG,iBAAiB,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;gBAE5D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBAC9C,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC;oBAC3B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;oBACrI,IAAI,CAAC,IAAI;wBAAE,MAAM;oBACjB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnF,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;oBACtD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;oBACvI,IAAI,CAAC,IAAI;wBAAE,MAAM;oBACjB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnF,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACzC,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC;oBAClC,IAAI,KAAK,CAAC,KAAK;wBAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;gBACvC,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;oBACjD,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;gBACpH,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACtC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE;wBAChC,IAAI,EAAE,WAAW;wBACjB,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;qBAC3B,CAAC,CAAC;oBACH,IAAI,CAAC,IAAI;wBAAE,MAAM;oBACjB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnF,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACxC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE;wBAChC,IAAI,EAAE,aAAa;wBACnB,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;wBAChC,UAAU,EAAE,KAAK,CAAC,UAAU;qBAC7B,CAAC,CAAC;oBACH,IAAI,CAAC,IAAI;wBAAE,MAAM;oBACjB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnF,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YACpD,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;YAChJ,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC,CAAC;YACnI,MAAM,CAAC,KAAK,CAAC,CAAC;YACd,UAAU,CAAC,QAAQ,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,IAAI,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC7B,MAAM,eAAe,GAAoB;gBACvC,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,SAAS,IAAI,kBAAkB;gBACxC,UAAU,EAAE,SAAS;gBACrB,oBAAoB,EAAE,QAAQ,SAAS,EAAE;gBACzC,UAAU,EAAE,iBAAiB;gBAC7B,cAAc,EAAE,YAAY,IAAI,SAAS;aAC1C,CAAC;YACF,IAAI,eAAe;gBAAE,eAAe,CAAC,iBAAiB,GAAG,eAAe,CAAC;YACzE,IAAI,KAAK;gBAAE,eAAe,CAAC,KAAK,GAAG,KAAK,CAAC;YACzC,MAAM,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YAEtC,iDAAiD;YACjD,MAAM,YAAY,GAAmB;gBACnC,EAAE,EAAE,QAAQ,SAAS,EAAE;gBACvB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,SAAS,IAAI,kBAAkB;gBACxC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1E,CAAC;YAEF,MAAM,cAAc,CAAC,WAAW,CAAC,iBAAiB,EAAE,CAAC,YAAY,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;YAC5F,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,kBAAkB,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACzI,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,CAAC;QACd,UAAU,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gBAAgB;AAEhB,SAAS,iBAAiB;IACxB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,SAAS,CAChB,MAAuC,EACvC,SAAiB,EACjB,SAAiB,EACjB,MAAc,EACd,QAAgB,EAChB,SAAiB,EACjB,QAAkB,EAClB,QAAkB,EAClB,KAAyB,EACzB,OAAwB,EACxB,KAAe;IAEf,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,QAAQ,GAAG;QACf,SAAS;QACT,SAAS;QACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM;QACN,QAAQ;QACR,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QAChC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS;QAC/F,QAAQ;QACR,QAAQ;QACR,KAAK;KACN,CAAC;IACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,qCAAqC,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/routes/data.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Data REST Routes - DataAdapter-driven CRUD with Fastify schema validation
+ *
+ * GET    /api/v1/data/:model          - List/query records
+ * GET    /api/v1/data/:model/schema   - Get model schema + aiButtons
+ * GET    /api/v1/data/:model/:id      - Get single record
+ * POST   /api/v1/data/:model          - Create record
+ * PUT    /api/v1/data/:model/:id      - Update record
+ * DELETE /api/v1/data/:model/:id      - Delete record
+ */
+import type { FastifyInstance } from 'fastify';
+import type { DataAdapter } from '../../types/adapter.js';
+import type { LoomConfig } from '../../types/config.js';
+export declare function registerDataRoutes(fastify: FastifyInstance, adapter: DataAdapter, config?: LoomConfig): void;
+//# sourceMappingURL=data.d.ts.map

package/dist/backend/routes/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/backend/routes/data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAiCxD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAyU5G"}

package/dist/backend/routes/data.js

@@ -0,0 +1,365 @@
+/**
+ * Data REST Routes - DataAdapter-driven CRUD with Fastify schema validation
+ *
+ * GET    /api/v1/data/:model          - List/query records
+ * GET    /api/v1/data/:model/schema   - Get model schema + aiButtons
+ * GET    /api/v1/data/:model/:id      - Get single record
+ * POST   /api/v1/data/:model          - Create record
+ * PUT    /api/v1/data/:model/:id      - Update record
+ * DELETE /api/v1/data/:model/:id      - Delete record
+ */
+import { resolveLocale, resolveEnumLabels } from '../../types/locale.js';
+// ── Shared Schemas ──
+const modelParamsSchema = {
+    type: 'object',
+    required: ['model'],
+    properties: {
+        model: { type: 'string', minLength: 1 },
+    },
+};
+const modelIdParamsSchema = {
+    type: 'object',
+    required: ['model', 'id'],
+    properties: {
+        model: { type: 'string', minLength: 1 },
+        id: { type: 'string', minLength: 1 },
+    },
+};
+const readQuerySchema = {
+    type: 'object',
+    properties: {
+        filter: { type: 'string' },
+        sort: { type: 'string' },
+        sortOrder: { type: 'string', enum: ['asc', 'desc'] },
+        limit: { type: 'integer', minimum: 1 },
+        offset: { type: 'integer', minimum: 0 },
+    },
+};
+export function registerDataRoutes(fastify, adapter, config) {
+    // Get model schema + aiButtons
+    fastify.get('/api/v1/data/:model/schema', {
+        schema: { params: modelParamsSchema },
+    }, async (req, reply) => {
+        const { model } = req.params;
+        const query = req.query;
+        const locale = query.locale || config?.ui?.locale || 'zh-CN';
+        try {
+            const modelSchema = await adapter.getSchema(model);
+            if (!modelSchema) {
+                reply.code(404).send({ error: 'Model not found' });
+                return;
+            }
+            // Resolve LocaleString fields for the requested locale
+            const resolved = {
+                ...modelSchema,
+                description: resolveLocale(modelSchema.description, locale),
+                fields: modelSchema.fields.map(f => ({
+                    ...f,
+                    description: resolveLocale(f.description, locale),
+                    enumLabels: resolveEnumLabels(f.enumLabels, locale),
+                })),
+            };
+            // Filter aiButtons by model placement and resolve labels
+            const allButtons = config?.aiButtons ?? [];
+            const aiButtons = allButtons.filter(btn => {
+                if (!btn.placement)
+                    return true; // No placement → global
+                return btn.placement.split(',').map(s => s.trim()).includes(model);
+            }).map(btn => ({
+                ...btn,
+                label: resolveLocale(btn.label, locale),
+            }));
+            reply.send({ data: resolved, aiButtons });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Schema fetch failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+    // List or query records
+    fastify.get('/api/v1/data/:model', {
+        schema: { params: modelParamsSchema, querystring: readQuerySchema },
+    }, async (req, reply) => {
+        const { model } = req.params;
+        const query = req.query;
+        const options = {};
+        if (query.filter) {
+            try {
+                options.filter = JSON.parse(query.filter);
+            }
+            catch {
+                reply.code(400).send({ error: 'Invalid filter JSON' });
+                return;
+            }
+        }
+        if (query.limit)
+            options.limit = parseInt(query.limit, 10);
+        if (query.offset)
+            options.offset = parseInt(query.offset, 10);
+        if (query.sort) {
+            options.sort = { field: query.sort, order: query.sortOrder === 'desc' ? 'desc' : 'asc' };
+        }
+        try {
+            const result = await adapter.read(model, options);
+            const total = await adapter.count(model, { filter: options.filter });
+            reply.send({ data: result, total });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Read failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+    // Get single record
+    fastify.get('/api/v1/data/:model/:id', {
+        schema: { params: modelIdParamsSchema },
+    }, async (req, reply) => {
+        const { model, id } = req.params;
+        try {
+            const result = await adapter.read(model, { id });
+            if (result === null || result === undefined) {
+                reply.code(404).send({ error: 'Record not found' });
+                return;
+            }
+            reply.send({ data: result });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Read failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+    // Create record
+    fastify.post('/api/v1/data/:model', {
+        schema: { params: modelParamsSchema, body: { type: 'object' } },
+    }, async (req, reply) => {
+        const { model } = req.params;
+        const body = req.body;
+        // Inject createdBy from authenticated user (route-level, not DataAdapter)
+        if (req.user) {
+            body.createdBy = req.user.userId;
+        }
+        try {
+            const result = await adapter.write(model, body);
+            reply.code(201).send({ data: result });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Write failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+    // Update record
+    fastify.put('/api/v1/data/:model/:id', {
+        schema: { params: modelIdParamsSchema, body: { type: 'object' } },
+    }, async (req, reply) => {
+        const { model, id } = req.params;
+        const body = req.body;
+        // Inject updatedBy from authenticated user (route-level, not DataAdapter)
+        if (req.user) {
+            body.updatedBy = req.user.userId;
+        }
+        try {
+            const result = await adapter.update(model, id, body);
+            reply.send({ data: result });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Update failed';
+            const code = message.includes('not found') ? 404 : 400;
+            reply.code(code).send({ error: message });
+        }
+    });
+    // Delete record
+    fastify.delete('/api/v1/data/:model/:id', {
+        schema: { params: modelIdParamsSchema },
+    }, async (req, reply) => {
+        const { model, id } = req.params;
+        try {
+            await adapter.delete(model, id);
+            reply.code(204).send();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Delete failed';
+            const code = message.includes('not found') ? 404 : 400;
+            reply.code(code).send({ error: message });
+        }
+    });
+    // ── Batch operations ──
+    // Batch delete records
+    fastify.post('/api/v1/data/:model/batch-delete', {
+        schema: { params: modelParamsSchema, body: { type: 'object', required: ['ids'], properties: { ids: { type: 'array', items: { type: 'string' } } } } },
+    }, async (req, reply) => {
+        const { model } = req.params;
+        const { ids } = req.body;
+        try {
+            const errors = [];
+            for (const id of ids) {
+                try {
+                    await adapter.delete(model, id);
+                }
+                catch (err) {
+                    errors.push(`${id}: ${err instanceof Error ? err.message : 'Failed'}`);
+                }
+            }
+            reply.send({ data: { deleted: ids.length - errors.length, errors } });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Batch delete failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+    // ── CSV Export ──
+    fastify.get('/api/v1/data/:model/export', {
+        schema: { params: modelParamsSchema },
+    }, async (req, reply) => {
+        const { model } = req.params;
+        try {
+            const result = await adapter.read(model, {});
+            const records = Array.isArray(result) ? result : [result];
+            if (records.length === 0) {
+                reply.code(404).send({ error: 'No data to export' });
+                return;
+            }
+            // Get schema for field ordering
+            const modelSchema = await adapter.getSchema(model);
+            const fields = modelSchema?.fields?.map(f => f.name) ?? Object.keys(records[0]);
+            // Build CSV
+            const escapeCsv = (val) => {
+                const str = val === null || val === undefined ? '' : String(val);
+                if (str.includes(',') || str.includes('"') || str.includes('\n')) {
+                    return `"${str.replace(/"/g, '""')}"`;
+                }
+                return str;
+            };
+            const header = fields.map(escapeCsv).join(',');
+            const rows = records.map((record) => {
+                const r = record;
+                return fields.map(f => {
+                    const val = r[f];
+                    if (Array.isArray(val))
+                        return escapeCsv(val.join(';'));
+                    if (typeof val === 'object' && val !== null)
+                        return escapeCsv(JSON.stringify(val));
+                    return escapeCsv(val);
+                }).join(',');
+            });
+            const csv = [header, ...rows].join('\n');
+            reply.header('Content-Type', 'text/csv; charset=utf-8');
+            reply.header('Content-Disposition', `attachment; filename=${model}_export.csv`);
+            reply.send(csv);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Export failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+    // ── CSV Import ──
+    fastify.post('/api/v1/data/:model/import', {
+        schema: { params: modelParamsSchema },
+    }, async (req, reply) => {
+        const { model } = req.params;
+        const body = req.body;
+        if (!body.data) {
+            reply.code(400).send({ error: 'Missing CSV data' });
+            return;
+        }
+        try {
+            const lines = body.data.split('\n').filter(l => l.trim());
+            if (lines.length < 2) {
+                reply.code(400).send({ error: 'CSV must have at least a header and one data row' });
+                return;
+            }
+            // Parse header
+            const parseLine = (line) => {
+                const result = [];
+                let current = '';
+                let inQuotes = false;
+                for (let i = 0; i < line.length; i++) {
+                    const ch = line[i];
+                    if (inQuotes) {
+                        if (ch === '"' && line[i + 1] === '"') {
+                            current += '"';
+                            i++;
+                        }
+                        else if (ch === '"') {
+                            inQuotes = false;
+                        }
+                        else {
+                            current += ch;
+                        }
+                    }
+                    else {
+                        if (ch === '"') {
+                            inQuotes = true;
+                        }
+                        else if (ch === ',') {
+                            result.push(current.trim());
+                            current = '';
+                        }
+                        else {
+                            current += ch;
+                        }
+                    }
+                }
+                result.push(current.trim());
+                return result;
+            };
+            const headers = parseLine(lines[0]);
+            const errors = [];
+            let imported = 0;
+            for (let i = 1; i < lines.length; i++) {
+                try {
+                    const values = parseLine(lines[i]);
+                    const record = {};
+                    headers.forEach((h, idx) => {
+                        if (h !== 'id' && h) {
+                            let val = values[idx] ?? '';
+                            // Try to parse JSON values (arrays, objects)
+                            if (typeof val === 'string' && (val.startsWith('[') || val.startsWith('{'))) {
+                                try {
+                                    val = JSON.parse(val);
+                                }
+                                catch { /* keep as string */ }
+                            }
+                            record[h] = val;
+                        }
+                    });
+                    await adapter.write(model, record);
+                    imported++;
+                }
+                catch (err) {
+                    errors.push(`Row ${i + 1}: ${err instanceof Error ? err.message : 'Failed'}`);
+                }
+            }
+            reply.send({ data: { imported, errors } });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Import failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+    // ── Relations ──
+    fastify.get('/api/v1/data/:model/:id/relations', {
+        schema: { params: modelIdParamsSchema },
+    }, async (req, reply) => {
+        const { model, id } = req.params;
+        try {
+            const relations = config?.relations?.filter(r => r.from === model) ?? [];
+            const results = {};
+            for (const rel of relations) {
+                const allRecords = await adapter.read(rel.to, {});
+                const records = Array.isArray(allRecords) ? allRecords : [allRecords];
+                results[rel.name] = records.filter((record) => {
+                    const r = record;
+                    const fkValue = r[rel.foreignKey];
+                    if (Array.isArray(fkValue))
+                        return fkValue.includes(id);
+                    return String(fkValue) === String(id);
+                });
+            }
+            reply.send({ data: results, relations });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : 'Relations fetch failed';
+            reply.code(400).send({ error: message });
+        }
+    });
+}
+//# sourceMappingURL=data.js.map