crewly 1.2.3 → 1.2.6

package/dist/backend/backend/src/controllers/cloud/files/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Cloud files controller barrel export.
+ *
+ * @module controllers/cloud/files
+ */
+export { createCloudFilesRouter } from './cloud-file.routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/controllers/cloud/files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/files/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/backend/backend/src/controllers/cloud/files/index.js

@@ -0,0 +1,7 @@
+/**
+ * Cloud files controller barrel export.
+ *
+ * @module controllers/cloud/files
+ */
+export { createCloudFilesRouter } from './cloud-file.routes.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/controllers/cloud/files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/files/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.controller.d.ts

@@ -0,0 +1,47 @@
+/**
+ * H5 Quick Entry Controller
+ *
+ * Handles task submission from the minimal H5 page for SteamFun.
+ * No authentication required — the SteamFun user ID is hardcoded.
+ *
+ * Endpoints:
+ * - POST /api/h5/submit  — Submit a task (text + optional file)
+ * - GET  /api/h5/task/:taskId — Check task status / result
+ *
+ * @module controllers/cloud/h5/h5-entry.controller
+ */
+import type { Request, Response } from 'express';
+/**
+ * POST /api/h5/submit
+ *
+ * Submit a task from the H5 quick entry page.
+ * No auth required — uses hardcoded SteamFun user ID.
+ *
+ * Accepts JSON body with optional base64 file data.
+ * Creates a file upload (if provided) and a cloud task.
+ *
+ * @param req - Request with body: H5SubmitBody
+ * @param res - Response with H5SubmitResponse or H5ErrorResponse
+ */
+export declare const handleH5Submit: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+/**
+ * GET /api/h5/task/:taskId
+ *
+ * Check the status of a task submitted from the H5 page.
+ * No auth required — uses hardcoded SteamFun user ID for ownership check.
+ *
+ * @param req - Request with params: { taskId }
+ * @param res - Response with H5TaskStatusResponse
+ */
+export declare const handleH5TaskStatus: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+/**
+ * GET /api/h5/tasks
+ *
+ * List recent tasks for the SteamFun account.
+ * No auth required — uses hardcoded SteamFun user ID.
+ *
+ * @param req - Request with optional query: { limit }
+ * @param res - Response with task list
+ */
+export declare const handleH5ListTasks: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+//# sourceMappingURL=h5-entry.controller.d.ts.map

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h5-entry.controller.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/h5-entry.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAYjD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,sFAyDzB,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,sFA4B7B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,sFAY5B,CAAC"}

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.controller.js

@@ -0,0 +1,131 @@
+/**
+ * H5 Quick Entry Controller
+ *
+ * Handles task submission from the minimal H5 page for SteamFun.
+ * No authentication required — the SteamFun user ID is hardcoded.
+ *
+ * Endpoints:
+ * - POST /api/h5/submit  — Submit a task (text + optional file)
+ * - GET  /api/h5/task/:taskId — Check task status / result
+ *
+ * @module controllers/cloud/h5/h5-entry.controller
+ */
+import { CloudTaskService } from '../../../services/cloud/cloud-task.service.js';
+import { CloudFileService } from '../../../services/cloud/cloud-file.service.js';
+import { CLOUD_TASK_TYPES } from '../tasks/cloud-task.types.js';
+import { H5_ENTRY_CONSTANTS, validateH5SubmitBody } from './h5-entry.types.js';
+import { asyncHandler } from '../../../utils/async-handler.js';
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+/**
+ * POST /api/h5/submit
+ *
+ * Submit a task from the H5 quick entry page.
+ * No auth required — uses hardcoded SteamFun user ID.
+ *
+ * Accepts JSON body with optional base64 file data.
+ * Creates a file upload (if provided) and a cloud task.
+ *
+ * @param req - Request with body: H5SubmitBody
+ * @param res - Response with H5SubmitResponse or H5ErrorResponse
+ */
+export const handleH5Submit = asyncHandler(async (req, res) => {
+    const body = req.body;
+    // Validate request
+    const validationError = validateH5SubmitBody(body);
+    if (validationError) {
+        res.status(400).json({ success: false, error: validationError });
+        return;
+    }
+    const userId = H5_ENTRY_CONSTANTS.STEAMFUN_USER_ID;
+    const fileKeys = [];
+    // Handle file upload if provided
+    if (body.fileData && body.fileName && body.fileMimeType) {
+        let buffer;
+        try {
+            buffer = Buffer.from(body.fileData, 'base64');
+        }
+        catch {
+            res.status(400).json({ success: false, error: 'Invalid base64 file data' });
+            return;
+        }
+        const fileService = CloudFileService.getInstance();
+        const uploadResult = await fileService.saveFile(userId, body.fileName.trim(), buffer, body.fileMimeType);
+        if (!uploadResult.success) {
+            res.status(400).json({ success: false, error: uploadResult.error ?? 'File upload failed' });
+            return;
+        }
+        fileKeys.push(uploadResult.fileKey);
+    }
+    // Determine task type
+    const hasImage = body.fileMimeType?.startsWith('image/');
+    const taskType = hasImage ? CLOUD_TASK_TYPES.IMAGE_ANALYSIS : CLOUD_TASK_TYPES.TEXT;
+    // Build prompt
+    const prompt = body.prompt?.trim() || '请分析上传的文件内容并生成摘要';
+    // Create cloud task
+    const taskService = CloudTaskService.getInstance();
+    const task = await taskService.createTask(userId, taskType, prompt, fileKeys);
+    res.status(201).json({
+        success: true,
+        data: {
+            taskId: task.id,
+            message: '任务已提交，正在处理中',
+        },
+    });
+});
+/**
+ * GET /api/h5/task/:taskId
+ *
+ * Check the status of a task submitted from the H5 page.
+ * No auth required — uses hardcoded SteamFun user ID for ownership check.
+ *
+ * @param req - Request with params: { taskId }
+ * @param res - Response with H5TaskStatusResponse
+ */
+export const handleH5TaskStatus = asyncHandler(async (req, res) => {
+    const { taskId } = req.params;
+    if (!taskId) {
+        res.status(400).json({ success: false, error: 'taskId is required' });
+        return;
+    }
+    const userId = H5_ENTRY_CONSTANTS.STEAMFUN_USER_ID;
+    const taskService = CloudTaskService.getInstance();
+    const task = await taskService.getTask(taskId, userId);
+    if (!task) {
+        res.status(404).json({ success: false, error: 'Task not found' });
+        return;
+    }
+    res.json({
+        success: true,
+        data: {
+            taskId: task.id,
+            status: task.status,
+            result: task.result,
+            error: task.error,
+            createdAt: task.createdAt,
+            updatedAt: task.updatedAt,
+        },
+    });
+});
+/**
+ * GET /api/h5/tasks
+ *
+ * List recent tasks for the SteamFun account.
+ * No auth required — uses hardcoded SteamFun user ID.
+ *
+ * @param req - Request with optional query: { limit }
+ * @param res - Response with task list
+ */
+export const handleH5ListTasks = asyncHandler(async (req, res) => {
+    const limit = req.query.limit ? parseInt(req.query.limit, 10) : 10;
+    const parsedLimit = isNaN(limit) || limit < 1 ? 10 : Math.min(limit, 50);
+    const userId = H5_ENTRY_CONSTANTS.STEAMFUN_USER_ID;
+    const taskService = CloudTaskService.getInstance();
+    const result = await taskService.listTasks(userId, { limit: parsedLimit });
+    res.json({
+        success: true,
+        data: result,
+    });
+});
+//# sourceMappingURL=h5-entry.controller.js.map

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h5-entry.controller.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/h5-entry.controller.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.routes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * H5 Quick Entry Routes
+ *
+ * Router for the minimal H5 page endpoints.
+ * No authentication required — SteamFun account is hardcoded.
+ *
+ * @module controllers/cloud/h5/h5-entry.routes
+ */
+import { Router } from 'express';
+/**
+ * Creates the H5 quick entry router.
+ *
+ * All endpoints are unauthenticated (SteamFun hardcoded account).
+ *
+ * Endpoints:
+ * - POST /submit         — Submit a task (text + optional file)
+ * - GET  /task/:taskId   — Check task status / result
+ * - GET  /tasks          — List recent tasks
+ *
+ * @returns Express Router configured with H5 entry endpoints
+ */
+export declare function createH5EntryRouter(): Router;
+//# sourceMappingURL=h5-entry.routes.d.ts.map

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h5-entry.routes.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/h5-entry.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAOjC;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAQ5C"}

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.routes.js

@@ -0,0 +1,30 @@
+/**
+ * H5 Quick Entry Routes
+ *
+ * Router for the minimal H5 page endpoints.
+ * No authentication required — SteamFun account is hardcoded.
+ *
+ * @module controllers/cloud/h5/h5-entry.routes
+ */
+import { Router } from 'express';
+import { handleH5Submit, handleH5TaskStatus, handleH5ListTasks, } from './h5-entry.controller.js';
+/**
+ * Creates the H5 quick entry router.
+ *
+ * All endpoints are unauthenticated (SteamFun hardcoded account).
+ *
+ * Endpoints:
+ * - POST /submit         — Submit a task (text + optional file)
+ * - GET  /task/:taskId   — Check task status / result
+ * - GET  /tasks          — List recent tasks
+ *
+ * @returns Express Router configured with H5 entry endpoints
+ */
+export function createH5EntryRouter() {
+    const router = Router();
+    router.post('/submit', handleH5Submit);
+    router.get('/task/:taskId', handleH5TaskStatus);
+    router.get('/tasks', handleH5ListTasks);
+    return router;
+}
+//# sourceMappingURL=h5-entry.routes.js.map

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h5-entry.routes.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/h5-entry.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACN,cAAc,EACd,kBAAkB,EAClB,iBAAiB,GACjB,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB;IAClC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAChD,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAExC,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * H5 Quick Entry Type Definitions
+ *
+ * Types for the minimal H5 page that allows SteamFun to submit tasks
+ * without authentication. The SteamFun account is hardcoded.
+ *
+ * @module controllers/cloud/h5/h5-entry.types
+ */
+/** Hardcoded SteamFun founding member configuration. */
+export declare const H5_ENTRY_CONSTANTS: {
+    /** Fixed user ID for all H5 submissions (SteamFun account) */
+    readonly STEAMFUN_USER_ID: "steamfun-founding-member";
+    /** Display name for notifications */
+    readonly STEAMFUN_DISPLAY_NAME: "SteamFun";
+    /** Maximum file size for H5 uploads (10 MB) */
+    readonly MAX_FILE_SIZE_BYTES: number;
+    /** Maximum base64 payload size (14 MB covers ~10 MB decoded) */
+    readonly MAX_BASE64_LENGTH: number;
+    /** Maximum prompt length (characters) */
+    readonly MAX_PROMPT_LENGTH: 5000;
+    /** Allowed MIME types for H5 uploads */
+    readonly ALLOWED_MIME_TYPES: readonly string[];
+};
+/** POST /api/h5/submit — task submission body. */
+export interface H5SubmitBody {
+    /** User's text prompt / instruction */
+    prompt?: string;
+    /** Base64-encoded file data (optional) */
+    fileData?: string;
+    /** Original filename (required if fileData is provided) */
+    fileName?: string;
+    /** MIME type of the file (required if fileData is provided) */
+    fileMimeType?: string;
+    /** Notification email address (optional) */
+    notifyEmail?: string;
+}
+/** Successful H5 submit response. */
+export interface H5SubmitResponse {
+    success: true;
+    data: {
+        /** Created task ID */
+        taskId: string;
+        /** Message for the user */
+        message: string;
+    };
+}
+/** Failed H5 submit response. */
+export interface H5ErrorResponse {
+    success: false;
+    error: string;
+}
+/** H5 task status response. */
+export interface H5TaskStatusResponse {
+    success: boolean;
+    data?: {
+        taskId: string;
+        status: string;
+        result: string | null;
+        error: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+    error?: string;
+}
+/**
+ * Checks whether a MIME type is allowed for H5 uploads.
+ *
+ * @param mimeType - MIME type to check
+ * @returns True if the MIME type is allowed
+ */
+export declare function isAllowedH5MimeType(mimeType: string): boolean;
+/**
+ * Validates an H5 submit request body.
+ *
+ * At least one of prompt or fileData must be present.
+ *
+ * @param body - Request body to validate
+ * @returns Error message string or null if valid
+ */
+export declare function validateH5SubmitBody(body: H5SubmitBody): string | null;
+//# sourceMappingURL=h5-entry.types.d.ts.map

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"h5-entry.types.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/h5-entry.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,wDAAwD;AACxD,eAAO,MAAM,kBAAkB;IAC9B,8DAA8D;;IAE9D,qCAAqC;;IAErC,+CAA+C;;IAE/C,gEAAgE;;IAEhE,yCAAyC;;IAEzC,wCAAwC;iCASnC,SAAS,MAAM,EAAE;CACb,CAAC;AAMX,kDAAkD;AAClD,MAAM,WAAW,YAAY;IAC5B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE;QACL,sBAAsB;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,2BAA2B;QAC3B,OAAO,EAAE,MAAM,CAAC;KAChB,CAAC;CACF;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,+BAA+B;AAC/B,MAAM,WAAW,oBAAoB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAMD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAqCtE"}

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.types.js

@@ -0,0 +1,85 @@
+/**
+ * H5 Quick Entry Type Definitions
+ *
+ * Types for the minimal H5 page that allows SteamFun to submit tasks
+ * without authentication. The SteamFun account is hardcoded.
+ *
+ * @module controllers/cloud/h5/h5-entry.types
+ */
+// ---------------------------------------------------------------------------
+// Hardcoded SteamFun Configuration
+// ---------------------------------------------------------------------------
+/** Hardcoded SteamFun founding member configuration. */
+export const H5_ENTRY_CONSTANTS = {
+    /** Fixed user ID for all H5 submissions (SteamFun account) */
+    STEAMFUN_USER_ID: 'steamfun-founding-member',
+    /** Display name for notifications */
+    STEAMFUN_DISPLAY_NAME: 'SteamFun',
+    /** Maximum file size for H5 uploads (10 MB) */
+    MAX_FILE_SIZE_BYTES: 10 * 1024 * 1024,
+    /** Maximum base64 payload size (14 MB covers ~10 MB decoded) */
+    MAX_BASE64_LENGTH: 14 * 1024 * 1024,
+    /** Maximum prompt length (characters) */
+    MAX_PROMPT_LENGTH: 5000,
+    /** Allowed MIME types for H5 uploads */
+    ALLOWED_MIME_TYPES: [
+        'image/png',
+        'image/jpeg',
+        'image/gif',
+        'image/webp',
+        'application/pdf',
+        'text/plain',
+        'text/csv',
+    ],
+};
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+/**
+ * Checks whether a MIME type is allowed for H5 uploads.
+ *
+ * @param mimeType - MIME type to check
+ * @returns True if the MIME type is allowed
+ */
+export function isAllowedH5MimeType(mimeType) {
+    return H5_ENTRY_CONSTANTS.ALLOWED_MIME_TYPES.includes(mimeType);
+}
+/**
+ * Validates an H5 submit request body.
+ *
+ * At least one of prompt or fileData must be present.
+ *
+ * @param body - Request body to validate
+ * @returns Error message string or null if valid
+ */
+export function validateH5SubmitBody(body) {
+    const hasPrompt = body.prompt && typeof body.prompt === 'string' && body.prompt.trim().length > 0;
+    const hasFile = body.fileData && typeof body.fileData === 'string' && body.fileData.length > 0;
+    if (!hasPrompt && !hasFile) {
+        return 'At least one of prompt or file is required';
+    }
+    if (hasPrompt && body.prompt.length > H5_ENTRY_CONSTANTS.MAX_PROMPT_LENGTH) {
+        return `Prompt too long: maximum ${H5_ENTRY_CONSTANTS.MAX_PROMPT_LENGTH} characters`;
+    }
+    if (hasFile) {
+        if (!body.fileName || typeof body.fileName !== 'string' || body.fileName.trim().length === 0) {
+            return 'fileName is required when uploading a file';
+        }
+        if (!body.fileMimeType || typeof body.fileMimeType !== 'string') {
+            return 'fileMimeType is required when uploading a file';
+        }
+        if (!isAllowedH5MimeType(body.fileMimeType)) {
+            return `Unsupported file type: ${body.fileMimeType}`;
+        }
+        if (body.fileData.length > H5_ENTRY_CONSTANTS.MAX_BASE64_LENGTH) {
+            return 'File too large: maximum 10 MB';
+        }
+    }
+    if (body.notifyEmail !== undefined) {
+        if (typeof body.notifyEmail !== 'string' || !body.notifyEmail.includes('@')) {
+            return 'notifyEmail must be a valid email address';
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=h5-entry.types.js.map

package/dist/backend/backend/src/controllers/cloud/h5/h5-entry.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"h5-entry.types.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/h5-entry.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,wDAAwD;AACxD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IACjC,8DAA8D;IAC9D,gBAAgB,EAAE,0BAA0B;IAC5C,qCAAqC;IACrC,qBAAqB,EAAE,UAAU;IACjC,+CAA+C;IAC/C,mBAAmB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;IACrC,gEAAgE;IAChE,iBAAiB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;IACnC,yCAAyC;IACzC,iBAAiB,EAAE,IAAI;IACvB,wCAAwC;IACxC,kBAAkB,EAAE;QACnB,WAAW;QACX,YAAY;QACZ,WAAW;QACX,YAAY;QACZ,iBAAiB;QACjB,YAAY;QACZ,UAAU;KACW;CACb,CAAC;AAuDX,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IACnD,OAAO,kBAAkB,CAAC,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACjE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAkB;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAClG,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAE/F,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,OAAO,4CAA4C,CAAC;IACrD,CAAC;IAED,IAAI,SAAS,IAAI,IAAI,CAAC,MAAO,CAAC,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,CAAC;QAC7E,OAAO,4BAA4B,kBAAkB,CAAC,iBAAiB,aAAa,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9F,OAAO,4CAA4C,CAAC;QACrD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,gDAAgD,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YAC7C,OAAO,0BAA0B,IAAI,CAAC,YAAY,EAAE,CAAC;QACtD,CAAC;QAED,IAAI,IAAI,CAAC,QAAS,CAAC,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,EAAE,CAAC;YAClE,OAAO,+BAA+B,CAAC;QACxC,CAAC;IACF,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACpC,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7E,OAAO,2CAA2C,CAAC;QACpD,CAAC;IACF,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC"}

package/dist/backend/backend/src/controllers/cloud/h5/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * H5 quick entry barrel export.
+ *
+ * @module controllers/cloud/h5
+ */
+export { createH5EntryRouter } from './h5-entry.routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/controllers/cloud/h5/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/backend/backend/src/controllers/cloud/h5/index.js

@@ -0,0 +1,7 @@
+/**
+ * H5 quick entry barrel export.
+ *
+ * @module controllers/cloud/h5
+ */
+export { createH5EntryRouter } from './h5-entry.routes.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/controllers/cloud/h5/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/h5/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/backend/backend/src/controllers/cloud/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cloud controller barrel export.
+ *
+ * @module controllers/cloud
+ */
+export { createCloudRouter } from './cloud.routes.js';
+export { createRelayRouter } from './relay.routes.js';
+export { createAuthRouter } from './auth/auth.routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/controllers/cloud/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/cloud/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/backend/backend/src/controllers/cloud/index.js

@@ -0,0 +1,9 @@
+/**
+ * Cloud controller barrel export.
+ *
+ * @module controllers/cloud
+ */
+export { createCloudRouter } from './cloud.routes.js';
+export { createRelayRouter } from './relay.routes.js';
+export { createAuthRouter } from './auth/auth.routes.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/controllers/cloud/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../backend/src/controllers/cloud/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/backend/backend/src/controllers/cloud/magic-moment/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Magic Moment controller barrel export.
+ *
+ * @module controllers/cloud/magic-moment
+ */
+export { createMagicMomentRouter } from './magic-moment.routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/backend/src/controllers/cloud/magic-moment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/magic-moment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/backend/backend/src/controllers/cloud/magic-moment/index.js

@@ -0,0 +1,7 @@
+/**
+ * Magic Moment controller barrel export.
+ *
+ * @module controllers/cloud/magic-moment
+ */
+export { createMagicMomentRouter } from './magic-moment.routes.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/backend/src/controllers/cloud/magic-moment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/magic-moment/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.controller.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Magic Moment REST Controller
+ *
+ * Handles anonymous free trial task submissions. No authentication
+ * required — trials are tracked by a client-provided device fingerprint.
+ *
+ * Endpoints:
+ * - POST /api/magic/submit   — Submit an anonymous task (consumes 1 trial)
+ * - GET  /api/magic/status    — Check remaining trials for a fingerprint
+ * - GET  /api/magic/task/:id  — Check task status / result (no auth)
+ *
+ * @module controllers/cloud/magic-moment/magic-moment.controller
+ */
+import type { Request, Response } from 'express';
+/**
+ * POST /api/magic/submit
+ *
+ * Submit a task anonymously, consuming one free trial.
+ * Requires a device fingerprint in the request body.
+ *
+ * @param req - Request with body: MagicSubmitBody
+ * @param res - Response with MagicSubmitResponse or error
+ */
+export declare const handleMagicSubmit: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+/**
+ * GET /api/magic/status
+ *
+ * Check remaining free trials for a device fingerprint.
+ * Fingerprint is passed as a query parameter.
+ *
+ * @param req - Request with query: { fingerprint }
+ * @param res - Response with MagicStatusResponse
+ */
+export declare const handleMagicStatus: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+/**
+ * GET /api/magic/task/:taskId
+ *
+ * Check the status of a task submitted via magic moment.
+ * No authentication required — uses anonymous user ID derivation.
+ *
+ * @param req - Request with params: { taskId } and query: { fingerprint }
+ * @param res - Response with task status
+ */
+export declare const handleMagicTaskStatus: (req: Request, res: Response, next: import("express").NextFunction) => Promise<void>;
+//# sourceMappingURL=magic-moment.controller.d.ts.map

package/dist/backend/backend/src/controllers/cloud/magic-moment/magic-moment.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-moment.controller.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/magic-moment/magic-moment.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAuBjD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,sFA0E5B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,sFAa5B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,sFAmChC,CAAC"}