crewly 1.2.3 → 1.2.4

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,14 @@
+/**
+ * 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';
+export { createCloudAuthRouter } from './cloud-auth.routes.js';
+export { createCloudTasksRouter } from './tasks/index.js';
+export { createCloudFilesRouter } from './files/index.js';
+export { createH5EntryRouter } from './h5/index.js';
+export { createMagicMomentRouter } from './magic-moment/index.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;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * 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';
+export { createCloudAuthRouter } from './cloud-auth.routes.js';
+export { createCloudTasksRouter } from './tasks/index.js';
+export { createCloudFilesRouter } from './files/index.js';
+export { createH5EntryRouter } from './h5/index.js';
+export { createMagicMomentRouter } from './magic-moment/index.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;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,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"}

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

@@ -0,0 +1,155 @@
+/**
+ * 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 { MagicMomentService } from '../../../services/payment/magic-moment.service.js';
+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 { validateMagicSubmitBody, validateFingerprint, } from '../../../services/payment/magic-moment.types.js';
+import { asyncHandler } from '../../../utils/async-handler.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Anonymous user ID prefix for magic moment tasks. */
+const ANON_USER_PREFIX = 'anon-';
+// ---------------------------------------------------------------------------
+// Handlers
+// ---------------------------------------------------------------------------
+/**
+ * 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 const handleMagicSubmit = asyncHandler(async (req, res) => {
+    const body = req.body;
+    const validationError = validateMagicSubmitBody(body);
+    if (validationError) {
+        res.status(400).json({ success: false, error: validationError });
+        return;
+    }
+    const magicService = MagicMomentService.getInstance();
+    // Check trial availability
+    const availability = await magicService.checkTrialAvailability(body.fingerprint);
+    if (!availability.available) {
+        res.status(429).json({
+            success: false,
+            error: 'Free trial limit reached. Please sign up to continue using the service.',
+            data: availability,
+        });
+        return;
+    }
+    // Create an anonymous user ID from the fingerprint
+    const anonUserId = `${ANON_USER_PREFIX}${body.fingerprint.slice(0, 16)}`;
+    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(anonUserId, 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(anonUserId, taskType, prompt, fileKeys);
+    // Consume the trial AFTER task creation succeeds
+    const updatedAvailability = await magicService.consumeTrial(body.fingerprint);
+    res.status(201).json({
+        success: true,
+        data: {
+            taskId: task.id,
+            message: '任务已提交，正在处理中',
+            trialsRemaining: updatedAvailability?.remaining ?? 0,
+        },
+    });
+});
+/**
+ * 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 const handleMagicStatus = asyncHandler(async (req, res) => {
+    const fingerprint = req.query.fingerprint;
+    const fpError = validateFingerprint(fingerprint);
+    if (fpError) {
+        res.status(400).json({ success: false, error: fpError });
+        return;
+    }
+    const magicService = MagicMomentService.getInstance();
+    const availability = await magicService.checkTrialAvailability(fingerprint);
+    res.json({ success: true, data: availability });
+});
+/**
+ * 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 const handleMagicTaskStatus = asyncHandler(async (req, res) => {
+    const { taskId } = req.params;
+    const fingerprint = req.query.fingerprint;
+    if (!taskId) {
+        res.status(400).json({ success: false, error: 'taskId is required' });
+        return;
+    }
+    const fpError = validateFingerprint(fingerprint);
+    if (fpError) {
+        res.status(400).json({ success: false, error: fpError });
+        return;
+    }
+    const anonUserId = `${ANON_USER_PREFIX}${fingerprint.slice(0, 16)}`;
+    const taskService = CloudTaskService.getInstance();
+    const task = await taskService.getTask(taskId, anonUserId);
+    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,
+        },
+    });
+});
+//# sourceMappingURL=magic-moment.controller.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Magic Moment REST Routes
+ *
+ * Router for anonymous free trial endpoints. No authentication required.
+ *
+ * Endpoints:
+ * - POST /submit       — Submit anonymous task (consumes trial)
+ * - GET  /status       — Check remaining trials
+ * - GET  /task/:taskId — Check task result
+ *
+ * @module controllers/cloud/magic-moment/magic-moment.routes
+ */
+import { Router } from 'express';
+/**
+ * Creates the magic moment router with all anonymous trial endpoints.
+ *
+ * All endpoints are public (no auth required):
+ * - POST /submit        — Submit anonymous task
+ * - GET  /status        — Check trial availability
+ * - GET  /task/:taskId  — Get task result
+ *
+ * @returns Express router configured with magic moment routes
+ */
+export declare function createMagicMomentRouter(): Router;
+//# sourceMappingURL=magic-moment.routes.d.ts.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Magic Moment REST Routes
+ *
+ * Router for anonymous free trial endpoints. No authentication required.
+ *
+ * Endpoints:
+ * - POST /submit       — Submit anonymous task (consumes trial)
+ * - GET  /status       — Check remaining trials
+ * - GET  /task/:taskId — Check task result
+ *
+ * @module controllers/cloud/magic-moment/magic-moment.routes
+ */
+import { Router } from 'express';
+import { handleMagicSubmit, handleMagicStatus, handleMagicTaskStatus, } from './magic-moment.controller.js';
+/**
+ * Creates the magic moment router with all anonymous trial endpoints.
+ *
+ * All endpoints are public (no auth required):
+ * - POST /submit        — Submit anonymous task
+ * - GET  /status        — Check trial availability
+ * - GET  /task/:taskId  — Get task result
+ *
+ * @returns Express router configured with magic moment routes
+ */
+export function createMagicMomentRouter() {
+    const router = Router();
+    router.post('/submit', handleMagicSubmit);
+    router.get('/status', handleMagicStatus);
+    router.get('/task/:taskId', handleMagicTaskStatus);
+    return router;
+}
+//# sourceMappingURL=magic-moment.routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"magic-moment.routes.js","sourceRoot":"","sources":["../../../../../../../backend/src/controllers/cloud/magic-moment/magic-moment.routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EACN,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB;IACtC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAC1C,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,qBAAqB,CAAC,CAAC;IAEnD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/backend/backend/src/controllers/cloud/relay.controller.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Relay REST Controller
+ *
+ * Handles HTTP requests for both the WebSocket Relay server management
+ * and the relay client lifecycle (connecting to a remote relay).
+ *
+ * Server-side endpoints:
+ * - POST /relay/register — register a local instance as a relay node
+ * - GET  /relay/status   — get relay server status and active sessions
+ *
+ * Client-side endpoints:
+ * - POST /relay/connect    — connect to a remote relay server
+ * - POST /relay/disconnect — disconnect from the relay server
+ * - GET  /relay/devices    — list paired/connected devices
+ * - POST /relay/send       — send a message to the paired peer
+ *
+ * @module controllers/cloud/relay.controller
+ */
+import type { Request, Response, NextFunction } from 'express';
+/**
+ * POST /relay/register
+ *
+ * Register a local Crewly instance as a relay node. Returns a session ID
+ * and the WebSocket URL to connect to for relay communication.
+ *
+ * @param req - Request with body: { role, pairingCode }
+ * @param res - Response returning RelayRegisterResponse
+ * @param next - Next function for error propagation
+ */
+export declare function registerRelayNode(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /relay/status
+ *
+ * Get the current relay server status, including whether it's running,
+ * the number of connected clients, and active session details.
+ *
+ * @param req - Express request (no params required)
+ * @param res - Response returning relay status object
+ * @param next - Next function for error propagation
+ */
+export declare function getRelayStatus(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /relay/connect
+ *
+ * Connect the local Crewly instance to a remote relay server as a client.
+ * Initiates WebSocket connection, registration, and waits for pairing.
+ *
+ * @param req - Request with body: { wsUrl, pairingCode, role, token, sharedSecret }
+ * @param res - Response with connection status
+ * @param next - Next function for error propagation
+ */
+export declare function connectToRelay(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /relay/disconnect
+ *
+ * Disconnect the local relay client from the remote relay server.
+ * Closes the WebSocket cleanly and stops heartbeats and reconnection.
+ *
+ * @param req - Express request (no body required)
+ * @param res - Response with disconnection confirmation
+ * @param next - Next function for error propagation
+ */
+export declare function disconnectFromRelay(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /relay/devices
+ *
+ * List connected devices visible through the relay. Returns both the local
+ * relay client state and the relay server sessions (if a local server is running).
+ *
+ * @param req - Express request (no params required)
+ * @param res - Response with device list
+ * @param next - Next function for error propagation
+ */
+export declare function getRelayDevices(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /relay/send
+ *
+ * Send an encrypted message to the paired peer via the relay.
+ * The message is encrypted locally using the shared secret before
+ * being forwarded through the relay server.
+ *
+ * @param req - Request with body: { message }
+ * @param res - Response with send confirmation
+ * @param next - Next function for error propagation
+ */
+export declare function sendRelayMessage(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /relay/auto-connect
+ *
+ * Magic Connection endpoint: uses the authenticated Supabase user_id as
+ * the pairingCode, auto-determines the role (orchestrator if no other
+ * device for this user, agent otherwise), and returns connection details.
+ *
+ * The frontend calls this single endpoint after login — zero manual config.
+ *
+ * @param req - Authenticated request (Supabase JWT)
+ * @param res - Response with { pairingCode, role, wsUrl, hostname }
+ * @param next - Next function for error propagation
+ */
+export declare function autoConnectRelay(req: Request, res: Response, next: NextFunction): Promise<void>;
+//# sourceMappingURL=relay.controller.d.ts.map

package/dist/backend/backend/src/controllers/cloud/relay.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/cloud/relay.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAkB/D;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDtG;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnG;AAeD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDnG;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBxG;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCrG;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDrG"}