crewly 1.2.3 → 1.2.6

package/dist/backend/backend/src/services/cloud/cloud-client.service.js

@@ -0,0 +1,237 @@
+/**
+ * Cloud Client Service
+ *
+ * Singleton service responsible for all interactions with CrewlyAI Cloud.
+ * Handles authentication, premium template fetching, and subscription
+ * status synchronization.
+ *
+ * Premium templates are loaded into memory only — never written to disk
+ * to prevent IP leakage.
+ *
+ * @module services/cloud/cloud-client.service
+ */
+import { LoggerService } from '../core/logger.service.js';
+import { CLOUD_CONSTANTS, } from '../../constants.js';
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * CloudClientService singleton.
+ *
+ * Manages the lifecycle of the connection between a local Crewly instance
+ * and CrewlyAI Cloud. All cloud API calls are made via native fetch with
+ * bearer-token authentication.
+ */
+export class CloudClientService {
+    static instance = null;
+    logger;
+    /** Cloud API base URL (e.g. "https://cloud.crewly.dev") */
+    cloudUrl = null;
+    /** Bearer token obtained during connect() */
+    token = null;
+    /** Current connection status */
+    connectionStatus = CLOUD_CONSTANTS.CONNECTION_STATUS.DISCONNECTED;
+    /** Subscription tier reported by cloud */
+    tier = CLOUD_CONSTANTS.TIERS.FREE;
+    /** Timestamp of the most recent successful cloud API call */
+    lastSyncAt = null;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('CloudClientService');
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns CloudClientService instance
+     */
+    static getInstance() {
+        if (!CloudClientService.instance) {
+            CloudClientService.instance = new CloudClientService();
+        }
+        return CloudClientService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        CloudClientService.instance = null;
+    }
+    // -------------------------------------------------------------------------
+    // Public API
+    // -------------------------------------------------------------------------
+    /**
+     * Connect to CrewlyAI Cloud by verifying the provided token.
+     *
+     * Calls the cloud auth endpoint to validate credentials and retrieve
+     * the subscription tier. On success the service transitions to
+     * "connected" status.
+     *
+     * @param cloudUrl - Base URL of the CrewlyAI Cloud API
+     * @param token - Authentication token (API key or JWT)
+     * @returns Object with connection result
+     * @throws Error when the auth request fails or token is invalid
+     *
+     * @example
+     * ```ts
+     * const client = CloudClientService.getInstance();
+     * await client.connect('https://cloud.crewly.dev', 'sk-abc123');
+     * ```
+     */
+    async connect(cloudUrl, token) {
+        this.logger.info('Connecting to CrewlyAI Cloud', { cloudUrl });
+        const url = `${cloudUrl}${CLOUD_CONSTANTS.ENDPOINTS.AUTH_TOKEN}`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            signal: AbortSignal.timeout(CLOUD_CONSTANTS.TIMEOUTS.CONNECT),
+        });
+        if (!response.ok) {
+            this.connectionStatus = CLOUD_CONSTANTS.CONNECTION_STATUS.ERROR;
+            const errorText = await response.text().catch(() => 'Unknown error');
+            this.logger.error('Cloud connection failed', { status: response.status, errorText });
+            throw new Error(`Cloud authentication failed: ${response.status} ${errorText}`);
+        }
+        const data = (await response.json());
+        this.cloudUrl = cloudUrl;
+        this.token = token;
+        this.tier = data.tier || CLOUD_CONSTANTS.TIERS.FREE;
+        this.connectionStatus = CLOUD_CONSTANTS.CONNECTION_STATUS.CONNECTED;
+        this.lastSyncAt = new Date().toISOString();
+        this.logger.info('Connected to CrewlyAI Cloud', { tier: this.tier });
+        return { success: true, tier: this.tier };
+    }
+    /**
+     * Disconnect from CrewlyAI Cloud.
+     *
+     * Clears stored credentials and resets the connection state.
+     */
+    disconnect() {
+        this.logger.info('Disconnecting from CrewlyAI Cloud');
+        this.cloudUrl = null;
+        this.token = null;
+        this.connectionStatus = CLOUD_CONSTANTS.CONNECTION_STATUS.DISCONNECTED;
+        this.tier = CLOUD_CONSTANTS.TIERS.FREE;
+        this.lastSyncAt = null;
+    }
+    /**
+     * Fetch the list of premium templates available on CrewlyAI Cloud.
+     *
+     * Requires an active cloud connection.
+     *
+     * @returns Array of template summaries
+     * @throws Error when not connected or fetch fails
+     *
+     * @example
+     * ```ts
+     * const templates = await client.getTemplates();
+     * console.log(templates.map(t => t.name));
+     * ```
+     */
+    async getTemplates() {
+        this.ensureConnected();
+        const url = `${this.cloudUrl}${CLOUD_CONSTANTS.ENDPOINTS.TEMPLATES}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: this.authHeaders(),
+            signal: AbortSignal.timeout(CLOUD_CONSTANTS.TIMEOUTS.FETCH_TEMPLATES),
+        });
+        if (!response.ok) {
+            this.logger.error('Failed to fetch templates', { status: response.status });
+            throw new Error(`Failed to fetch templates: ${response.status}`);
+        }
+        const data = (await response.json());
+        this.lastSyncAt = new Date().toISOString();
+        return data.templates || [];
+    }
+    /**
+     * Fetch full detail for a single premium template.
+     *
+     * The returned data is held in memory only and must never be
+     * persisted to disk.
+     *
+     * @param id - Template identifier
+     * @returns Template detail object
+     * @throws Error when not connected, template not found, or fetch fails
+     *
+     * @example
+     * ```ts
+     * const detail = await client.getTemplateDetail('tpl-tiktok-ops');
+     * ```
+     */
+    async getTemplateDetail(id) {
+        this.ensureConnected();
+        const endpoint = CLOUD_CONSTANTS.ENDPOINTS.TEMPLATE_DETAIL.replace(':id', id);
+        const url = `${this.cloudUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method: 'GET',
+            headers: this.authHeaders(),
+            signal: AbortSignal.timeout(CLOUD_CONSTANTS.TIMEOUTS.FETCH_TEMPLATE_DETAIL),
+        });
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new Error(`Template not found: ${id}`);
+            }
+            this.logger.error('Failed to fetch template detail', { id, status: response.status });
+            throw new Error(`Failed to fetch template detail: ${response.status}`);
+        }
+        const data = (await response.json());
+        this.lastSyncAt = new Date().toISOString();
+        return data;
+    }
+    /**
+     * Get the current cloud connection status and subscription tier.
+     *
+     * @returns Current status snapshot
+     */
+    getStatus() {
+        return {
+            connectionStatus: this.connectionStatus,
+            cloudUrl: this.cloudUrl,
+            tier: this.tier,
+            lastSyncAt: this.lastSyncAt,
+        };
+    }
+    /**
+     * Check whether the client is currently connected to cloud.
+     *
+     * @returns true if connected
+     */
+    isConnected() {
+        return this.connectionStatus === CLOUD_CONSTANTS.CONNECTION_STATUS.CONNECTED;
+    }
+    /**
+     * Get the current subscription tier.
+     *
+     * @returns Current tier value
+     */
+    getTier() {
+        return this.tier;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Throw if the client is not in a connected state.
+     *
+     * @throws Error when not connected
+     */
+    ensureConnected() {
+        if (!this.isConnected() || !this.cloudUrl || !this.token) {
+            throw new Error('Not connected to CrewlyAI Cloud. Call connect() first.');
+        }
+    }
+    /**
+     * Build the standard authorization headers for cloud API requests.
+     *
+     * @returns Headers object with Authorization and Content-Type
+     */
+    authHeaders() {
+        return {
+            Authorization: `Bearer ${this.token}`,
+            'Content-Type': 'application/json',
+        };
+    }
+}
+//# sourceMappingURL=cloud-client.service.js.map

package/dist/backend/backend/src/services/cloud/cloud-client.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-client.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-client.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAwB,MAAM,2BAA2B,CAAC;AAChF,OAAO,EACL,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAkD5B,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IACrB,MAAM,CAAC,QAAQ,GAA8B,IAAI,CAAC;IACzC,MAAM,CAAkB;IAEzC,2DAA2D;IACnD,QAAQ,GAAkB,IAAI,CAAC;IACvC,6CAA6C;IACrC,KAAK,GAAkB,IAAI,CAAC;IACpC,gCAAgC;IACxB,gBAAgB,GAA0B,eAAe,CAAC,iBAAiB,CAAC,YAAY,CAAC;IACjG,0CAA0C;IAClC,IAAI,GAAc,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;IACrD,6DAA6D;IACrD,UAAU,GAAkB,IAAI,CAAC;IAEzC;QACE,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IACxF,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,CAAC;YACjC,kBAAkB,CAAC,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,kBAAkB,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,kBAAkB,CAAC,QAAQ,GAAG,IAAI,CAAC;IACrC,CAAC;IAED,4EAA4E;IAC5E,aAAa;IACb,4EAA4E;IAE5E;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,KAAa;QAC3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE/D,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAEjE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,KAAK,EAAE;aACjC;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC;SAC9D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC,iBAAiB,CAAC,KAAK,CAAC;YAChE,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsB,CAAC;QAE1D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAI,IAAI,CAAC,IAAkB,IAAI,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;QACnE,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC,iBAAiB,CAAC,SAAS,CAAC;QACpE,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE3C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,gBAAgB,GAAG,eAAe,CAAC,iBAAiB,CAAC,YAAY,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QAErE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE;YAC3B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,eAAe,CAAC;SACtE,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5E,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0C,CAAC;QAC9E,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,iBAAiB,CAAC,EAAU;QAChC,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;QAE1C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE;YAC3B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,qBAAqB,CAAC;SAC5E,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,uBAAuB,EAAE,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;QAC5D,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,SAAS;QACP,OAAO;YACL,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,gBAAgB,KAAK,eAAe,CAAC,iBAAiB,CAAC,SAAS,CAAC;IAC/E,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E;;;;OAIG;IACK,eAAe;QACrB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,WAAW;QACjB,OAAO;YACL,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;YACrC,cAAc,EAAE,kBAAkB;SACnC,CAAC;IACJ,CAAC"}

package/dist/backend/backend/src/services/cloud/cloud-features.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cloud Features Gate
+ *
+ * Determines whether cloud-specific features are enabled based on
+ * environment configuration. Used to conditionally load cloud routes,
+ * services, and UI components.
+ *
+ * @module services/cloud/cloud-features
+ */
+/**
+ * Check if cloud features are enabled.
+ *
+ * Cloud mode is enabled when CREWLY_CLOUD_URL or MONGODB_URI is set,
+ * indicating the instance is connected to the Cloud API.
+ *
+ * @returns true if cloud features should be active
+ */
+export declare function isCloudEnabled(): boolean;
+//# sourceMappingURL=cloud-features.d.ts.map

package/dist/backend/backend/src/services/cloud/cloud-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-features.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAMxC"}

package/dist/backend/backend/src/services/cloud/cloud-features.js

@@ -0,0 +1,23 @@
+/**
+ * Cloud Features Gate
+ *
+ * Determines whether cloud-specific features are enabled based on
+ * environment configuration. Used to conditionally load cloud routes,
+ * services, and UI components.
+ *
+ * @module services/cloud/cloud-features
+ */
+/**
+ * Check if cloud features are enabled.
+ *
+ * Cloud mode is enabled when CREWLY_CLOUD_URL or MONGODB_URI is set,
+ * indicating the instance is connected to the Cloud API.
+ *
+ * @returns true if cloud features should be active
+ */
+export function isCloudEnabled() {
+    return !!(process.env['CREWLY_CLOUD_URL'] ||
+        process.env['MONGODB_URI'] ||
+        process.env['CREWLY_CLOUD_MODE'] === 'true');
+}
+//# sourceMappingURL=cloud-features.js.map

package/dist/backend/backend/src/services/cloud/cloud-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-features.js","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-features.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,CAAC,CACP,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,MAAM,CAC5C,CAAC;AACJ,CAAC"}

package/dist/backend/backend/src/services/cloud/cloud-file.service.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Cloud File Service
+ *
+ * Handles file uploads for cloud AI employee tasks.
+ * MVP implementation: local file storage under ~/.crewly/cloud/uploads/.
+ * Future: migrate to DigitalOcean Spaces (S3-compatible).
+ *
+ * Files are organized by userId to enforce tenant isolation.
+ *
+ * @module services/cloud/cloud-file.service
+ */
+/** Cloud file service configuration. */
+export declare const CLOUD_FILE_CONSTANTS: {
+    /** Upload directory under ~/.crewly/ */
+    readonly UPLOAD_DIR: "cloud/uploads";
+    /** Maximum file size in bytes (20 MB) */
+    readonly MAX_FILE_SIZE: number;
+    /** Allowed MIME types for upload */
+    readonly ALLOWED_MIME_TYPES: readonly string[];
+    /** Allowed file extensions */
+    readonly ALLOWED_EXTENSIONS: readonly string[];
+};
+/** Result of a file upload operation. */
+export interface FileUploadResult {
+    /** Whether the upload succeeded */
+    success: boolean;
+    /** File key (path relative to upload root) — use this to reference the file */
+    fileKey?: string;
+    /** Original filename */
+    originalName?: string;
+    /** File size in bytes */
+    size?: number;
+    /** Error message on failure */
+    error?: string;
+}
+/** Metadata about an uploaded file. */
+export interface UploadedFileInfo {
+    /** File key (path relative to upload root) */
+    fileKey: string;
+    /** Absolute filesystem path */
+    absolutePath: string;
+    /** Original filename */
+    originalName: string;
+    /** File size in bytes */
+    size: number;
+    /** Upload timestamp */
+    uploadedAt: string;
+}
+/**
+ * Manages file uploads and retrieval for cloud tasks.
+ *
+ * Singleton — access via `CloudFileService.getInstance()`.
+ */
+export declare class CloudFileService {
+    private static instance;
+    private readonly logger;
+    private readonly uploadRoot;
+    private constructor();
+    /** Get singleton instance. */
+    static getInstance(): CloudFileService;
+    /** Reset singleton (for testing). */
+    static resetInstance(): void;
+    /**
+     * Save an uploaded file to the user's upload directory.
+     *
+     * @param userId - Authenticated user ID (tenant isolation)
+     * @param originalName - Original filename from the client
+     * @param buffer - File content as a Buffer
+     * @param mimeType - MIME type of the file
+     * @returns Upload result with file key
+     */
+    saveFile(userId: string, originalName: string, buffer: Buffer, mimeType: string): Promise<FileUploadResult>;
+    /**
+     * Read a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File buffer or null if not found
+     */
+    readFile(fileKey: string): Promise<Buffer | null>;
+    /**
+     * Get metadata about an uploaded file.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File info or null if not found
+     */
+    getFileInfo(fileKey: string): Promise<UploadedFileInfo | null>;
+    /**
+     * Delete a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns True if deleted, false if not found
+     */
+    deleteFile(fileKey: string): Promise<boolean>;
+    /** Get the absolute path for a file key. */
+    getAbsolutePath(fileKey: string): string;
+}
+//# sourceMappingURL=cloud-file.service.d.ts.map

package/dist/backend/backend/src/services/cloud/cloud-file.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-file.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/cloud-file.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,wCAAwC;AACxC,eAAO,MAAM,oBAAoB;IAChC,wCAAwC;;IAExC,yCAAyC;;IAEzC,oCAAoC;iCAU/B,SAAS,MAAM,EAAE;IACtB,8BAA8B;iCAIzB,SAAS,MAAM,EAAE;CACb,CAAC;AAMX,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAChC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAChC,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,uBAAuB;IACvB,UAAU,EAAE,MAAM,CAAC;CACnB;AAMD;;;;GAIG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO;IAKP,8BAA8B;IAC9B,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,qCAAqC;IACrC,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;;;OAQG;IACG,QAAQ,CACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACd,OAAO,CAAC,gBAAgB,CAAC;IAqD5B;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASvD;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgBpE;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWnD,4CAA4C;IAC5C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAGxC"}

package/dist/backend/backend/src/services/cloud/cloud-file.service.js

@@ -0,0 +1,184 @@
+/**
+ * Cloud File Service
+ *
+ * Handles file uploads for cloud AI employee tasks.
+ * MVP implementation: local file storage under ~/.crewly/cloud/uploads/.
+ * Future: migrate to DigitalOcean Spaces (S3-compatible).
+ *
+ * Files are organized by userId to enforce tenant isolation.
+ *
+ * @module services/cloud/cloud-file.service
+ */
+import { randomUUID } from 'node:crypto';
+import { readFile, writeFile, mkdir, stat, unlink } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+import { homedir } from 'node:os';
+import { LoggerService } from '../core/logger.service.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Cloud file service configuration. */
+export const CLOUD_FILE_CONSTANTS = {
+    /** Upload directory under ~/.crewly/ */
+    UPLOAD_DIR: 'cloud/uploads',
+    /** Maximum file size in bytes (20 MB) */
+    MAX_FILE_SIZE: 20 * 1024 * 1024,
+    /** Allowed MIME types for upload */
+    ALLOWED_MIME_TYPES: [
+        'image/png',
+        'image/jpeg',
+        'image/gif',
+        'image/webp',
+        'application/pdf',
+        'text/plain',
+        'text/csv',
+        'application/json',
+    ],
+    /** Allowed file extensions */
+    ALLOWED_EXTENSIONS: [
+        '.png', '.jpg', '.jpeg', '.gif', '.webp',
+        '.pdf', '.txt', '.csv', '.json',
+    ],
+};
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Manages file uploads and retrieval for cloud tasks.
+ *
+ * Singleton — access via `CloudFileService.getInstance()`.
+ */
+export class CloudFileService {
+    static instance = null;
+    logger;
+    uploadRoot;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('CloudFileService');
+        this.uploadRoot = join(homedir(), '.crewly', CLOUD_FILE_CONSTANTS.UPLOAD_DIR);
+    }
+    /** Get singleton instance. */
+    static getInstance() {
+        if (!CloudFileService.instance) {
+            CloudFileService.instance = new CloudFileService();
+        }
+        return CloudFileService.instance;
+    }
+    /** Reset singleton (for testing). */
+    static resetInstance() {
+        CloudFileService.instance = null;
+    }
+    /**
+     * Save an uploaded file to the user's upload directory.
+     *
+     * @param userId - Authenticated user ID (tenant isolation)
+     * @param originalName - Original filename from the client
+     * @param buffer - File content as a Buffer
+     * @param mimeType - MIME type of the file
+     * @returns Upload result with file key
+     */
+    async saveFile(userId, originalName, buffer, mimeType) {
+        // Validate file size
+        if (buffer.length > CLOUD_FILE_CONSTANTS.MAX_FILE_SIZE) {
+            return {
+                success: false,
+                error: `File too large: ${buffer.length} bytes. Maximum is ${CLOUD_FILE_CONSTANTS.MAX_FILE_SIZE} bytes (20 MB).`,
+            };
+        }
+        // Validate MIME type
+        if (!CLOUD_FILE_CONSTANTS.ALLOWED_MIME_TYPES.includes(mimeType)) {
+            return {
+                success: false,
+                error: `Unsupported file type: ${mimeType}. Allowed: ${CLOUD_FILE_CONSTANTS.ALLOWED_MIME_TYPES.join(', ')}`,
+            };
+        }
+        // Validate extension
+        const ext = extname(originalName).toLowerCase();
+        if (!CLOUD_FILE_CONSTANTS.ALLOWED_EXTENSIONS.includes(ext)) {
+            return {
+                success: false,
+                error: `Unsupported file extension: ${ext}. Allowed: ${CLOUD_FILE_CONSTANTS.ALLOWED_EXTENSIONS.join(', ')}`,
+            };
+        }
+        try {
+            // Create user-scoped upload directory
+            const userDir = join(this.uploadRoot, userId);
+            await mkdir(userDir, { recursive: true });
+            // Generate unique filename to prevent collisions
+            const uniqueName = `${randomUUID()}${ext}`;
+            const filePath = join(userDir, uniqueName);
+            const fileKey = `${userId}/${uniqueName}`;
+            await writeFile(filePath, buffer);
+            this.logger.info('File saved', { fileKey, originalName, size: buffer.length, mimeType });
+            return {
+                success: true,
+                fileKey,
+                originalName,
+                size: buffer.length,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger.error('Failed to save file', { error: msg, userId, originalName });
+            return { success: false, error: `Failed to save file: ${msg}` };
+        }
+    }
+    /**
+     * Read a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File buffer or null if not found
+     */
+    async readFile(fileKey) {
+        try {
+            const filePath = join(this.uploadRoot, fileKey);
+            return await readFile(filePath);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get metadata about an uploaded file.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns File info or null if not found
+     */
+    async getFileInfo(fileKey) {
+        try {
+            const filePath = join(this.uploadRoot, fileKey);
+            const stats = await stat(filePath);
+            return {
+                fileKey,
+                absolutePath: filePath,
+                originalName: fileKey.split('/').pop() ?? fileKey,
+                size: stats.size,
+                uploadedAt: stats.birthtime.toISOString(),
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Delete a file by its key.
+     *
+     * @param fileKey - File key (userId/filename)
+     * @returns True if deleted, false if not found
+     */
+    async deleteFile(fileKey) {
+        try {
+            const filePath = join(this.uploadRoot, fileKey);
+            await unlink(filePath);
+            this.logger.info('File deleted', { fileKey });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Get the absolute path for a file key. */
+    getAbsolutePath(fileKey) {
+        return join(this.uploadRoot, fileKey);
+    }
+}
+//# sourceMappingURL=cloud-file.service.js.map

package/dist/backend/backend/src/services/cloud/cloud-file.service.js.map

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