handoff-app 1.0.3 → 1.0.4

package/dist/platform/sync.js

@@ -1,349 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadSyncState = loadSyncState;
-exports.saveSyncState = saveSyncState;
-exports.pullProject = pullProject;
-exports.computePushDiff = computePushDiff;
-exports.pushProject = pushProject;
-exports.createPushProject = createPushProject;
-exports.walkDirectory = walkDirectory;
-const crypto_1 = __importDefault(require("crypto"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const logger_1 = require("../utils/logger");
-const client_1 = require("./client");
-// ── Constants ───────────────────────────────────────────────────────────
-const SYNC_STATE_DIR = '.handoff';
-const SYNC_STATE_FILE = 'sync-state.json';
-/** Paths excluded from sync (matching server-side exclusions) */
-const EXCLUDED_PATTERNS = [
-    '.env',
-    'node_modules',
-    'out',
-    '.handoff',
-    '.git',
-    '.DS_Store',
-];
-// ── Sync State ──────────────────────────────────────────────────────────
-/**
- * Load the sync state from the project directory.
- * Returns null if no sync state exists (first sync).
- */
-function loadSyncState(projectDir) {
-    const stateFile = path_1.default.join(projectDir, SYNC_STATE_DIR, SYNC_STATE_FILE);
-    try {
-        if (fs_extra_1.default.existsSync(stateFile)) {
-            return fs_extra_1.default.readJsonSync(stateFile);
-        }
-    }
-    catch (err) {
-        logger_1.Logger.warn('Could not read sync state file.');
-        logger_1.Logger.debug('Sync state read error', err);
-    }
-    return null;
-}
-/**
- * Save the sync state to the project directory.
- */
-function saveSyncState(projectDir, state) {
-    const stateDir = path_1.default.join(projectDir, SYNC_STATE_DIR);
-    const stateFile = path_1.default.join(stateDir, SYNC_STATE_FILE);
-    fs_extra_1.default.ensureDirSync(stateDir);
-    fs_extra_1.default.writeJsonSync(stateFile, state, { spaces: 2 });
-}
-// ── Pull ────────────────────────────────────────────────────────────────
-/**
- * Pull files from the remote project to the local directory.
- *
- * Compares the remote manifest against local files (using MD5 hashes)
- * and downloads any files that differ or are missing locally.
- *
- * @param onProgress Optional callback for reporting progress
- */
-function pullProject(baseUrl_1, token_1, projectId_1, projectDir_1) {
-    return __awaiter(this, arguments, void 0, function* (baseUrl, token, projectId, projectDir, options = {}) {
-        const { force = false, onProgress } = options;
-        onProgress === null || onProgress === void 0 ? void 0 : onProgress('Fetching remote manifest...');
-        const manifest = yield (0, client_1.getManifest)(baseUrl, token, projectId);
-        const remoteFiles = manifest.files;
-        const downloaded = [];
-        const deleted = [];
-        const unchanged = [];
-        // Download new or changed files
-        const remoteKeys = Object.keys(remoteFiles);
-        const total = remoteKeys.length;
-        for (let i = 0; i < total; i++) {
-            const relativePath = remoteKeys[i];
-            const remoteEntry = remoteFiles[relativePath];
-            const localPath = path_1.default.join(projectDir, relativePath);
-            onProgress === null || onProgress === void 0 ? void 0 : onProgress(`Checking (${i + 1}/${total}): ${relativePath}`);
-            let needsDownload = false;
-            if (!fs_extra_1.default.existsSync(localPath)) {
-                needsDownload = true;
-            }
-            else if (force) {
-                needsDownload = true;
-            }
-            else {
-                // Compare ETags (MD5 hash)
-                const localHash = computeEtag(localPath);
-                const remoteEtag = normalizeEtag(remoteEntry.etag);
-                if (localHash !== remoteEtag) {
-                    needsDownload = true;
-                }
-            }
-            if (needsDownload) {
-                onProgress === null || onProgress === void 0 ? void 0 : onProgress(`Downloading (${i + 1}/${total}): ${relativePath}`);
-                const content = yield (0, client_1.downloadFile)(baseUrl, token, projectId, relativePath);
-                fs_extra_1.default.ensureDirSync(path_1.default.dirname(localPath));
-                fs_extra_1.default.writeFileSync(localPath, content);
-                downloaded.push(relativePath);
-            }
-            else {
-                unchanged.push(relativePath);
-            }
-        }
-        // Detect local files that no longer exist remotely
-        const localFiles = walkDirectory(projectDir);
-        for (const localRelative of localFiles) {
-            if (!remoteFiles[localRelative]) {
-                if (force) {
-                    const localPath = path_1.default.join(projectDir, localRelative);
-                    fs_extra_1.default.removeSync(localPath);
-                    deleted.push(localRelative);
-                }
-                // If not force, we leave orphaned local files alone
-            }
-        }
-        // Save sync state
-        saveSyncState(projectDir, {
-            version: manifest.version,
-            manifest: remoteFiles,
-            lastSync: new Date().toISOString(),
-        });
-        return { downloaded, deleted, unchanged, version: manifest.version };
-    });
-}
-// ── Push ────────────────────────────────────────────────────────────────
-/**
- * Compute the diff between local files and the last-known manifest.
- */
-function computePushDiff(projectDir) {
-    var _a;
-    const syncState = loadSyncState(projectDir);
-    const lastManifest = (_a = syncState === null || syncState === void 0 ? void 0 : syncState.manifest) !== null && _a !== void 0 ? _a : {};
-    const localFiles = walkDirectory(projectDir);
-    const added = [];
-    const modified = [];
-    const deleted = [];
-    // Check local files against the manifest
-    for (const relativePath of localFiles) {
-        const localPath = path_1.default.join(projectDir, relativePath);
-        const localEtag = computeEtag(localPath);
-        const remoteEntry = lastManifest[relativePath];
-        if (!remoteEntry) {
-            added.push(relativePath);
-        }
-        else {
-            const remoteEtag = normalizeEtag(remoteEntry.etag);
-            if (localEtag !== remoteEtag) {
-                modified.push(relativePath);
-            }
-        }
-    }
-    // Check for files in the manifest that no longer exist locally
-    const localSet = new Set(localFiles);
-    for (const remotePath of Object.keys(lastManifest)) {
-        if (!localSet.has(remotePath)) {
-            deleted.push(remotePath);
-        }
-    }
-    return { added, modified, deleted };
-}
-/**
- * Push local changes to the remote project.
- *
- * @param onProgress Optional callback for reporting progress
- */
-function pushProject(baseUrl_1, token_1, projectId_1, projectDir_1) {
-    return __awaiter(this, arguments, void 0, function* (baseUrl, token, projectId, projectDir, options = {}) {
-        var _a, _b;
-        const { onProgress } = options;
-        const syncState = loadSyncState(projectDir);
-        const baseVersion = (_a = syncState === null || syncState === void 0 ? void 0 : syncState.version) !== null && _a !== void 0 ? _a : 0;
-        onProgress === null || onProgress === void 0 ? void 0 : onProgress('Computing changes...');
-        const diff = computePushDiff(projectDir);
-        const changedPaths = [...diff.added, ...diff.modified];
-        if (changedPaths.length === 0 && diff.deleted.length === 0) {
-            onProgress === null || onProgress === void 0 ? void 0 : onProgress('No changes to push.');
-            return {
-                success: true,
-                version: baseVersion,
-                uploaded: [],
-                deleted: [],
-                errors: [],
-                files: (_b = syncState === null || syncState === void 0 ? void 0 : syncState.manifest) !== null && _b !== void 0 ? _b : {},
-            };
-        }
-        // For any changed file inside a component directory, also include the
-        // component config file (e.g. button/button.js) so the server always
-        // has the config context even if only other files in the dir changed.
-        const configExtras = getComponentConfigsForChangedPaths(projectDir, changedPaths);
-        for (const extra of configExtras) {
-            if (!changedPaths.includes(extra)) {
-                changedPaths.push(extra);
-            }
-        }
-        onProgress === null || onProgress === void 0 ? void 0 : onProgress(`Preparing ${changedPaths.length} file(s) to upload, ${diff.deleted.length} to delete...`);
-        // Read file contents into buffers
-        const files = new Map();
-        for (const filePath of changedPaths) {
-            const localPath = path_1.default.join(projectDir, filePath);
-            files.set(filePath, fs_extra_1.default.readFileSync(localPath));
-        }
-        onProgress === null || onProgress === void 0 ? void 0 : onProgress('Pushing changes...');
-        const result = yield (0, client_1.pushChanges)(baseUrl, token, projectId, baseVersion, files, diff.deleted);
-        // Update sync state with new version and manifest
-        saveSyncState(projectDir, {
-            version: result.version,
-            manifest: result.files,
-            lastSync: new Date().toISOString(),
-        });
-        return result;
-    });
-}
-// ── Create Push (New Project) ───────────────────────────────────────────
-/**
- * Push an entire local project to the platform as a new project.
- * Collects all syncable local files and sends them via the create-push
- * endpoint, which creates the project and uploads files in one request.
- *
- * @param onProgress Optional callback for reporting progress
- */
-function createPushProject(baseUrl_1, token_1, orgId_1, projectDir_1) {
-    return __awaiter(this, arguments, void 0, function* (baseUrl, token, orgId, projectDir, options = {}) {
-        const { onProgress } = options;
-        onProgress === null || onProgress === void 0 ? void 0 : onProgress('Scanning local files...');
-        const localFiles = walkDirectory(projectDir);
-        onProgress === null || onProgress === void 0 ? void 0 : onProgress(`Preparing ${localFiles.length} file(s) for upload...`);
-        const files = new Map();
-        for (const relativePath of localFiles) {
-            const localPath = path_1.default.join(projectDir, relativePath);
-            files.set(relativePath, fs_extra_1.default.readFileSync(localPath));
-        }
-        onProgress === null || onProgress === void 0 ? void 0 : onProgress('Uploading project to platform...');
-        const result = yield (0, client_1.createPush)(baseUrl, token, orgId, files, {
-            name: options.name,
-            figmaProjectId: options.figmaProjectId,
-        });
-        // Save sync state so subsequent push/pull commands work correctly
-        saveSyncState(projectDir, {
-            version: result.syncVersion,
-            manifest: result.files,
-            lastSync: new Date().toISOString(),
-        });
-        return result;
-    });
-}
-// ── File Utilities ──────────────────────────────────────────────────────
-/**
- * Recursively walk a directory and return relative file paths,
- * excluding patterns that should not be synced.
- */
-function walkDirectory(baseDir) {
-    const results = [];
-    function walk(dir) {
-        if (!fs_extra_1.default.existsSync(dir))
-            return;
-        const entries = fs_extra_1.default.readdirSync(dir, { withFileTypes: true });
-        for (const entry of entries) {
-            const fullPath = path_1.default.join(dir, entry.name);
-            const relativePath = path_1.default.relative(baseDir, fullPath);
-            // Check exclusions against the first path segment and the entry name
-            if (isExcluded(relativePath))
-                continue;
-            if (entry.isDirectory()) {
-                walk(fullPath);
-            }
-            else if (entry.isFile()) {
-                // Use forward slashes for consistency with the server
-                results.push(relativePath.split(path_1.default.sep).join('/'));
-            }
-        }
-    }
-    walk(baseDir);
-    return results;
-}
-/**
- * Check if a relative path should be excluded from sync.
- */
-function isExcluded(relativePath) {
-    const segments = relativePath.split(path_1.default.sep);
-    for (const pattern of EXCLUDED_PATTERNS) {
-        // Match if any segment starts with or equals the pattern
-        if (segments.some((seg) => seg === pattern || seg.startsWith(pattern + '/'))) {
-            return true;
-        }
-        // Also match the exact relative path
-        if (relativePath === pattern)
-            return true;
-    }
-    return false;
-}
-/**
- * Compute the MD5 hash of a file (to compare against S3 ETags).
- */
-function computeEtag(filePath) {
-    const content = fs_extra_1.default.readFileSync(filePath);
-    return crypto_1.default.createHash('md5').update(content).digest('hex');
-}
-/**
- * Normalize an ETag string by removing surrounding quotes.
- */
-function normalizeEtag(etag) {
-    return etag.replace(/^"/, '').replace(/"$/, '');
-}
-/** Config file extensions to look for in component directories. */
-const COMPONENT_CONFIG_EXTENSIONS = ['.js', '.cjs', '.json'];
-/**
- * For a list of changed file paths, find any component config files that
- * live in the same directory so they are always uploaded alongside changes.
- *
- * A "component config" is a file whose basename (without extension) matches
- * the containing directory name, e.g. `components/button/button.js`.
- */
-function getComponentConfigsForChangedPaths(projectDir, changedPaths) {
-    const extras = new Set();
-    const checkedDirs = new Set();
-    for (const relativePath of changedPaths) {
-        // Get the directory portion using forward-slash splitting (paths are
-        // normalized to forward slashes by walkDirectory)
-        const dirPart = relativePath.includes('/') ? relativePath.substring(0, relativePath.lastIndexOf('/')) : '';
-        if (!dirPart || checkedDirs.has(dirPart))
-            continue;
-        checkedDirs.add(dirPart);
-        // The component config file is named after the directory
-        const dirName = dirPart.includes('/') ? dirPart.substring(dirPart.lastIndexOf('/') + 1) : dirPart;
-        for (const ext of COMPONENT_CONFIG_EXTENSIONS) {
-            const configRelative = `${dirPart}/${dirName}${ext}`;
-            const configAbsolute = path_1.default.join(projectDir, configRelative);
-            if (fs_extra_1.default.existsSync(configAbsolute)) {
-                extras.add(configRelative);
-                break; // only need the first matching config
-            }
-        }
-    }
-    return Array.from(extras);
-}