handoff-app 1.0.3 → 1.0.4

package/dist/platform/client.js

@@ -1,228 +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());
-    });
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PlatformApiError = void 0;
-exports.createDeviceCode = createDeviceCode;
-exports.pollForToken = pollForToken;
-exports.revokeToken = revokeToken;
-exports.listProjects = listProjects;
-exports.getManifest = getManifest;
-exports.downloadFile = downloadFile;
-exports.pushChanges = pushChanges;
-exports.createPush = createPush;
-const logger_1 = require("../utils/logger");
-// ── Helpers ─────────────────────────────────────────────────────────────
-class PlatformApiError extends Error {
-    constructor(statusCode, message) {
-        super(message);
-        this.statusCode = statusCode;
-        this.name = 'PlatformApiError';
-    }
-}
-exports.PlatformApiError = PlatformApiError;
-function authHeaders(token) {
-    return {
-        Authorization: `Bearer ${token}`,
-    };
-}
-function handleResponse(res, context) {
-    return __awaiter(this, void 0, void 0, function* () {
-        if (!res.ok) {
-            let message = `${context}: HTTP ${res.status}`;
-            try {
-                const body = yield res.json();
-                if (body.error)
-                    message = `${context}: ${body.error}`;
-                if (body.message)
-                    message = `${context}: ${body.message}`;
-            }
-            catch (_a) {
-                // ignore parse errors
-            }
-            throw new PlatformApiError(res.status, message);
-        }
-        return res.json();
-    });
-}
-// ── API Functions ───────────────────────────────────────────────────────
-/**
- * Initiate the device-code auth flow.
- */
-function createDeviceCode(baseUrl) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const res = yield fetch(`${baseUrl}/api/cli/auth/device`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-        });
-        return handleResponse(res, 'Device code creation');
-    });
-}
-/**
- * Poll for an approved token. Resolves when approved or rejects on
- * expiry / error.
- */
-function pollForToken(baseUrl, deviceCode, interval, expiresIn) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const deadline = Date.now() + expiresIn * 1000;
-        while (Date.now() < deadline) {
-            yield sleep(interval * 1000);
-            const res = yield fetch(`${baseUrl}/api/cli/auth/token`, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ deviceCode }),
-            });
-            if (res.status === 410) {
-                throw new PlatformApiError(410, 'Device code expired. Please try logging in again.');
-            }
-            if (res.status === 404) {
-                throw new PlatformApiError(404, 'Invalid device code.');
-            }
-            const body = (yield res.json());
-            if (body.status === 'approved') {
-                return body;
-            }
-            logger_1.Logger.debug('Token poll: still pending...');
-        }
-        throw new PlatformApiError(408, 'Authentication timed out. Please try again.');
-    });
-}
-/**
- * Revoke (logout) the current CLI token.
- */
-function revokeToken(baseUrl, token) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const res = yield fetch(`${baseUrl}/api/cli/auth/token`, {
-            method: 'DELETE',
-            headers: authHeaders(token),
-        });
-        if (!res.ok && res.status !== 401) {
-            yield handleResponse(res, 'Token revocation');
-        }
-    });
-}
-/**
- * List all projects accessible to the authenticated user.
- */
-function listProjects(baseUrl, token) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const res = yield fetch(`${baseUrl}/api/cli/projects`, {
-            headers: authHeaders(token),
-        });
-        return handleResponse(res, 'List projects');
-    });
-}
-/**
- * Get the file manifest for a project.
- */
-function getManifest(baseUrl, token, projectId) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const res = yield fetch(`${baseUrl}/api/cli/projects/${projectId}/sync/manifest`, {
-            headers: authHeaders(token),
-        });
-        return handleResponse(res, 'Get manifest');
-    });
-}
-/**
- * Download a single file from the project by relative path.
- * Returns the file content as a Buffer.
- */
-function downloadFile(baseUrl, token, projectId, filePath) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const url = `${baseUrl}/api/cli/projects/${projectId}/sync/file?path=${encodeURIComponent(filePath)}`;
-        const res = yield fetch(url, {
-            headers: authHeaders(token),
-        });
-        if (!res.ok) {
-            let message = `Download file "${filePath}": HTTP ${res.status}`;
-            try {
-                const body = yield res.json();
-                if (body.error)
-                    message = `Download file "${filePath}": ${body.error}`;
-            }
-            catch (_a) {
-                // response might not be JSON
-            }
-            throw new PlatformApiError(res.status, message);
-        }
-        const arrayBuffer = yield res.arrayBuffer();
-        return Buffer.from(arrayBuffer);
-    });
-}
-/**
- * Push file changes to the project. Uses multipart/form-data.
- *
- * @param files Map of relative path -> file Buffer
- * @param deleted Array of relative paths to delete
- * @returns PushResult on success
- * @throws PlatformApiError with status 409 on version conflict
- */
-function pushChanges(baseUrl, token, projectId, baseVersion, files, deleted) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // Use the built-in FormData (Node 18+) — the `form-data` npm package
-        // is stream-based and incompatible with native fetch.
-        const form = new FormData();
-        form.append('baseVersion', String(baseVersion));
-        if (deleted.length > 0) {
-            form.append('deleted', JSON.stringify(deleted));
-        }
-        for (const [filePath, content] of files) {
-            const blob = new Blob([new Uint8Array(content)]);
-            form.append(filePath, blob, filePath);
-        }
-        const res = yield fetch(`${baseUrl}/api/cli/projects/${projectId}/sync/push`, {
-            method: 'POST',
-            headers: Object.assign({}, authHeaders(token)),
-            body: form,
-        });
-        if (res.status === 409) {
-            const body = (yield res.json());
-            const err = new PlatformApiError(409, body.message || 'Version conflict — pull first');
-            err.conflictData = body;
-            throw err;
-        }
-        return handleResponse(res, 'Push changes');
-    });
-}
-/**
- * Create a new project and push all files in a single request.
- * Used for onboarding existing handoff-app projects to the platform.
- *
- * @param orgId Organization to create the project in
- * @param name Optional project name (falls back to app.title in config)
- * @param figmaProjectId Optional Figma file ID
- * @param files Map of relative path -> file Buffer
- */
-function createPush(baseUrl_1, token_1, orgId_1, files_1) {
-    return __awaiter(this, arguments, void 0, function* (baseUrl, token, orgId, files, options = {}) {
-        const form = new FormData();
-        form.append('orgId', orgId);
-        if (options.name) {
-            form.append('name', options.name);
-        }
-        if (options.figmaProjectId) {
-            form.append('figmaProjectId', options.figmaProjectId);
-        }
-        for (const [filePath, content] of files) {
-            const blob = new Blob([new Uint8Array(content)]);
-            form.append(filePath, blob, filePath);
-        }
-        const res = yield fetch(`${baseUrl}/api/cli/projects/create-push`, {
-            method: 'POST',
-            headers: Object.assign({}, authHeaders(token)),
-            body: form,
-        });
-        return handleResponse(res, 'Create and push project');
-    });
-}
-// ── Utilities ───────────────────────────────────────────────────────────
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}

package/dist/platform/credentials.d.ts

@@ -1,40 +0,0 @@
-export interface CredentialEntry {
-    token: string;
-    user: {
-        name: string | null;
-        email: string;
-    };
-    createdAt: string;
-}
-/** Keyed by platform base URL */
-export type CredentialsStore = Record<string, CredentialEntry>;
-/**
- * Load the full credentials store from disk.
- * Returns an empty object if the file doesn't exist yet.
- */
-export declare function loadCredentials(): CredentialsStore;
-/**
- * Save the full credentials store to disk.
- * Creates the ~/.handoff directory if it doesn't exist.
- */
-export declare function saveCredentials(creds: CredentialsStore): void;
-/**
- * Retrieve the token for a specific platform URL.
- * Returns null if not logged in to that URL.
- */
-export declare function getToken(baseUrl: string): string | null;
-/**
- * Retrieve the full credential entry for a specific platform URL.
- */
-export declare function getCredential(baseUrl: string): CredentialEntry | null;
-/**
- * Store a token and user info for a platform URL.
- */
-export declare function setToken(baseUrl: string, token: string, user: {
-    name: string | null;
-    email: string;
-}): void;
-/**
- * Remove the credential for a platform URL.
- */
-export declare function removeToken(baseUrl: string): void;

package/dist/platform/credentials.js

@@ -1,91 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadCredentials = loadCredentials;
-exports.saveCredentials = saveCredentials;
-exports.getToken = getToken;
-exports.getCredential = getCredential;
-exports.setToken = setToken;
-exports.removeToken = removeToken;
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
-const logger_1 = require("../utils/logger");
-// ── Paths ───────────────────────────────────────────────────────────────
-const HANDOFF_DIR = path_1.default.join(os_1.default.homedir(), '.handoff');
-const CREDENTIALS_FILE = path_1.default.join(HANDOFF_DIR, 'credentials.json');
-// ── Core Functions ──────────────────────────────────────────────────────
-/**
- * Load the full credentials store from disk.
- * Returns an empty object if the file doesn't exist yet.
- */
-function loadCredentials() {
-    try {
-        if (fs_extra_1.default.existsSync(CREDENTIALS_FILE)) {
-            return fs_extra_1.default.readJsonSync(CREDENTIALS_FILE);
-        }
-    }
-    catch (err) {
-        logger_1.Logger.warn('Could not read credentials file, starting fresh.');
-        logger_1.Logger.debug('Credentials read error', err);
-    }
-    return {};
-}
-/**
- * Save the full credentials store to disk.
- * Creates the ~/.handoff directory if it doesn't exist.
- */
-function saveCredentials(creds) {
-    fs_extra_1.default.ensureDirSync(HANDOFF_DIR);
-    fs_extra_1.default.writeJsonSync(CREDENTIALS_FILE, creds, { spaces: 2, mode: 0o600 });
-}
-/**
- * Retrieve the token for a specific platform URL.
- * Returns null if not logged in to that URL.
- */
-function getToken(baseUrl) {
-    var _a, _b;
-    const creds = loadCredentials();
-    const normalized = normalizeUrl(baseUrl);
-    return (_b = (_a = creds[normalized]) === null || _a === void 0 ? void 0 : _a.token) !== null && _b !== void 0 ? _b : null;
-}
-/**
- * Retrieve the full credential entry for a specific platform URL.
- */
-function getCredential(baseUrl) {
-    var _a;
-    const creds = loadCredentials();
-    const normalized = normalizeUrl(baseUrl);
-    return (_a = creds[normalized]) !== null && _a !== void 0 ? _a : null;
-}
-/**
- * Store a token and user info for a platform URL.
- */
-function setToken(baseUrl, token, user) {
-    const creds = loadCredentials();
-    const normalized = normalizeUrl(baseUrl);
-    creds[normalized] = {
-        token,
-        user,
-        createdAt: new Date().toISOString(),
-    };
-    saveCredentials(creds);
-}
-/**
- * Remove the credential for a platform URL.
- */
-function removeToken(baseUrl) {
-    const creds = loadCredentials();
-    const normalized = normalizeUrl(baseUrl);
-    delete creds[normalized];
-    saveCredentials(creds);
-}
-// ── Helpers ─────────────────────────────────────────────────────────────
-/**
- * Normalize a URL by removing trailing slashes for consistent key lookup.
- */
-function normalizeUrl(url) {
-    return url.replace(/\/+$/, '');
-}

package/dist/platform/sync.d.ts

@@ -1,68 +0,0 @@
-import { CreatePushResult, ManifestFile, PushResult } from './client';
-export interface SyncState {
-    version: number;
-    manifest: Record<string, ManifestFile>;
-    lastSync: string;
-}
-export interface PullResult {
-    downloaded: string[];
-    deleted: string[];
-    unchanged: string[];
-    version: number;
-}
-export interface PushDiff {
-    added: string[];
-    modified: string[];
-    deleted: string[];
-}
-/**
- * Load the sync state from the project directory.
- * Returns null if no sync state exists (first sync).
- */
-export declare function loadSyncState(projectDir: string): SyncState | null;
-/**
- * Save the sync state to the project directory.
- */
-export declare function saveSyncState(projectDir: string, state: SyncState): void;
-/**
- * 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
- */
-export declare function pullProject(baseUrl: string, token: string, projectId: string, projectDir: string, options?: {
-    force?: boolean;
-    onProgress?: (message: string) => void;
-}): Promise<PullResult>;
-/**
- * Compute the diff between local files and the last-known manifest.
- */
-export declare function computePushDiff(projectDir: string): PushDiff;
-/**
- * Push local changes to the remote project.
- *
- * @param onProgress Optional callback for reporting progress
- */
-export declare function pushProject(baseUrl: string, token: string, projectId: string, projectDir: string, options?: {
-    force?: boolean;
-    onProgress?: (message: string) => void;
-}): Promise<PushResult>;
-/**
- * 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
- */
-export declare function createPushProject(baseUrl: string, token: string, orgId: string, projectDir: string, options?: {
-    name?: string;
-    figmaProjectId?: string;
-    onProgress?: (message: string) => void;
-}): Promise<CreatePushResult>;
-/**
- * Recursively walk a directory and return relative file paths,
- * excluding patterns that should not be synced.
- */
-export declare function walkDirectory(baseDir: string): string[];