handoff-app 1.0.3 → 1.0.4

package/dist/commands/platform/push.js

@@ -1,428 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
-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 });
-const p = __importStar(require("@clack/prompts"));
-const chalk_1 = __importDefault(require("chalk"));
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
-const __1 = __importDefault(require("../../"));
-const client_1 = require("../../platform/client");
-const credentials_1 = require("../../platform/credentials");
-const sync_1 = require("../../platform/sync");
-const DEFAULT_PLATFORM_URL = 'http://localhost:3000';
-const CONFIG_FILES = ['handoff.config.json', 'handoff.config.js', 'handoff.config.cjs'];
-const command = {
-    command: 'platform:push',
-    describe: 'Push local changes to the Handoff platform',
-    builder: (yargs) => {
-        return yargs
-            .option('url', {
-            type: 'string',
-            description: 'Platform URL (overrides config)',
-        })
-            .option('force', {
-            alias: 'f',
-            type: 'boolean',
-            description: 'Push without confirmation prompt',
-            default: false,
-        })
-            .option('debug', {
-            alias: 'd',
-            type: 'boolean',
-            description: 'Enable debug mode',
-        });
-    },
-    handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
-        const handoff = new __1.default(args.debug, args.force);
-        const config = handoff.config;
-        const baseUrl = (args.url || (config === null || config === void 0 ? void 0 : config.platformUrl) || process.env.HANDOFF_PLATFORM_URL || DEFAULT_PLATFORM_URL).replace(/\/+$/, '');
-        const projectId = config === null || config === void 0 ? void 0 : config.platformProjectId;
-        p.intro(chalk_1.default.bold('Handoff Platform Push'));
-        // Check login first — needed for both flows
-        const token = (0, credentials_1.getToken)(baseUrl);
-        if (!token) {
-            p.cancel(`Not logged in to ${baseUrl}. Run ${chalk_1.default.cyan('handoff-app platform:login')} first.`);
-            process.exit(1);
-        }
-        // ── No project linked → offer to create a new one ──────────────────
-        if (!projectId) {
-            yield handleCreatePush(handoff, baseUrl, token, args.force);
-            return;
-        }
-        // ── Normal push to existing project ────────────────────────────────
-        yield handleExistingPush(handoff, baseUrl, token, projectId, args.force);
-    }),
-};
-// ─────────────────────────────────────────────────────────────────────────
-// Create-push flow: push a legacy project as a new platform project
-// ─────────────────────────────────────────────────────────────────────────
-function handleCreatePush(handoff, baseUrl, token, force) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a, _b;
-        p.note([
-            'This project is not linked to a platform project.',
-            '',
-            'You can create a new project on the platform and push',
-            'your local files up in a single step.',
-        ].join('\n'), 'New Project');
-        const wantCreate = yield p.confirm({
-            message: 'Would you like to create a new project on the platform?',
-        });
-        if (p.isCancel(wantCreate) || !wantCreate) {
-            p.cancel(`Run ${chalk_1.default.cyan('handoff-app platform:init')} to link to an existing project instead.`);
-            process.exit(0);
-        }
-        const spinner = p.spinner();
-        // Fetch the project list to get available organizations
-        spinner.start('Loading organizations...');
-        let projects;
-        try {
-            projects = yield (0, client_1.listProjects)(baseUrl, token);
-        }
-        catch (err) {
-            spinner.stop('Failed to load organizations.');
-            p.cancel(err.message || 'Could not fetch project list');
-            process.exit(1);
-        }
-        spinner.stop('Organizations loaded.');
-        // Extract unique organizations the user has access to
-        const orgMap = new Map();
-        for (const proj of projects) {
-            if (!orgMap.has(proj.orgId)) {
-                orgMap.set(proj.orgId, { id: proj.orgId, name: proj.orgName, slug: proj.orgSlug });
-            }
-        }
-        // If no orgs available at all, the user might still have org access even with 0 projects.
-        // The listProjects endpoint returns projects — if there are none, we still have the token.
-        // We'll ask the user to type an org ID, or if we found orgs, let them pick.
-        let orgId;
-        if (orgMap.size > 0) {
-            const orgs = Array.from(orgMap.values());
-            if (orgs.length === 1) {
-                orgId = orgs[0].id;
-                p.log.info(`Organization: ${chalk_1.default.bold(orgs[0].name)}`);
-            }
-            else {
-                const selectedOrg = yield p.select({
-                    message: 'Which organization should own this project?',
-                    options: orgs.map((org) => ({
-                        value: org.id,
-                        label: org.name,
-                        hint: org.slug,
-                    })),
-                });
-                if (p.isCancel(selectedOrg)) {
-                    p.cancel('Push cancelled.');
-                    process.exit(0);
-                }
-                orgId = selectedOrg;
-            }
-        }
-        else {
-            // No projects found → we can't infer orgs. Ask the user.
-            const orgInput = yield p.text({
-                message: 'Enter the organization ID to create the project in:',
-                placeholder: 'uuid',
-                validate: (val) => {
-                    if (!val || val.trim().length === 0)
-                        return 'Organization ID is required';
-                    return undefined;
-                },
-            });
-            if (p.isCancel(orgInput)) {
-                p.cancel('Push cancelled.');
-                process.exit(0);
-            }
-            orgId = orgInput.trim();
-        }
-        // Collect project name
-        const defaultName = ((_b = (_a = handoff.config) === null || _a === void 0 ? void 0 : _a.app) === null || _b === void 0 ? void 0 : _b.title) || path_1.default.basename(handoff.workingPath);
-        const projectName = yield p.text({
-            message: 'Project name:',
-            placeholder: defaultName,
-            defaultValue: defaultName,
-            validate: (val) => {
-                if (!val || val.trim().length === 0)
-                    return 'Project name is required';
-                return undefined;
-            },
-        });
-        if (p.isCancel(projectName)) {
-            p.cancel('Push cancelled.');
-            process.exit(0);
-        }
-        // Optionally collect Figma project ID
-        const wantFigma = yield p.confirm({
-            message: 'Do you want to connect a Figma file? (can be added later)',
-            initialValue: false,
-        });
-        let figmaProjectId;
-        if (!p.isCancel(wantFigma) && wantFigma) {
-            const figmaInput = yield p.text({
-                message: 'Figma file ID:',
-                placeholder: 'e.g. abc123XYZ',
-                validate: (val) => {
-                    if (!val || val.trim().length === 0)
-                        return 'Figma file ID is required';
-                    return undefined;
-                },
-            });
-            if (p.isCancel(figmaInput)) {
-                p.cancel('Push cancelled.');
-                process.exit(0);
-            }
-            figmaProjectId = figmaInput.trim();
-        }
-        // Confirm before proceeding
-        if (!force) {
-            const confirmed = yield p.confirm({
-                message: `Create project "${projectName}" and push all local files?`,
-            });
-            if (p.isCancel(confirmed) || !confirmed) {
-                p.cancel('Push cancelled.');
-                process.exit(0);
-            }
-        }
-        // Execute create-push
-        try {
-            spinner.start('Creating project and uploading files...');
-            const result = yield (0, sync_1.createPushProject)(baseUrl, token, orgId, handoff.workingPath, {
-                name: projectName.trim(),
-                figmaProjectId,
-                onProgress: (msg) => spinner.message(msg),
-            });
-            spinner.stop('Project created and files uploaded!');
-            // Update the local config with the new project ID and platform URL
-            yield updateLocalConfig(handoff.workingPath, result.project.id, baseUrl);
-            // Separate excluded-path warnings from real errors
-            const excludedErrors = result.errors.filter((e) => /excluded\s*path/i.test(e));
-            const realErrors = result.errors.filter((e) => !/excluded\s*path/i.test(e));
-            const summary = [
-                `Project: ${chalk_1.default.bold(result.project.name)}`,
-                `Project ID: ${chalk_1.default.dim(result.project.id)}`,
-                `Files uploaded: ${chalk_1.default.green(String(result.uploaded))}`,
-                `Sync version: ${chalk_1.default.cyan(String(result.syncVersion))}`,
-            ];
-            if (excludedErrors.length > 0) {
-                summary.push(chalk_1.default.yellow(`${excludedErrors.length} path(s) not synced (excluded by server)`));
-            }
-            if (realErrors.length > 0) {
-                summary.push(`Errors: ${chalk_1.default.red(String(realErrors.length))}`);
-                for (const err of realErrors) {
-                    summary.push(chalk_1.default.red(`  ! ${err}`));
-                }
-            }
-            p.note(summary.join('\n'), 'Create-Push Summary');
-            p.outro(`Your local config has been updated. Use ${chalk_1.default.cyan('platform:push')} for future syncs.`);
-        }
-        catch (err) {
-            spinner.stop('Create-push failed.');
-            p.cancel(err.message || 'Failed to create project');
-            process.exit(1);
-        }
-    });
-}
-// ─────────────────────────────────────────────────────────────────────────
-// Normal push flow: push changes to an existing linked project
-// ─────────────────────────────────────────────────────────────────────────
-function handleExistingPush(handoff, baseUrl, token, projectId, force) {
-    return __awaiter(this, void 0, void 0, function* () {
-        // Preview what will be pushed
-        const diff = (0, sync_1.computePushDiff)(handoff.workingPath);
-        if (diff.added.length === 0 && diff.modified.length === 0 && diff.deleted.length === 0) {
-            p.note('No changes detected.', 'Push');
-            p.outro('Everything is up to date.');
-            return;
-        }
-        // Show the changes summary
-        const changeLines = [];
-        if (diff.added.length > 0) {
-            changeLines.push(chalk_1.default.green(`  + ${diff.added.length} new file(s)`));
-            for (const f of diff.added.slice(0, 10)) {
-                changeLines.push(chalk_1.default.dim(`    + ${f}`));
-            }
-            if (diff.added.length > 10) {
-                changeLines.push(chalk_1.default.dim(`    ... and ${diff.added.length - 10} more`));
-            }
-        }
-        if (diff.modified.length > 0) {
-            changeLines.push(chalk_1.default.yellow(`  ~ ${diff.modified.length} modified file(s)`));
-            for (const f of diff.modified.slice(0, 10)) {
-                changeLines.push(chalk_1.default.dim(`    ~ ${f}`));
-            }
-            if (diff.modified.length > 10) {
-                changeLines.push(chalk_1.default.dim(`    ... and ${diff.modified.length - 10} more`));
-            }
-        }
-        if (diff.deleted.length > 0) {
-            changeLines.push(chalk_1.default.red(`  - ${diff.deleted.length} deleted file(s)`));
-            for (const f of diff.deleted.slice(0, 10)) {
-                changeLines.push(chalk_1.default.dim(`    - ${f}`));
-            }
-            if (diff.deleted.length > 10) {
-                changeLines.push(chalk_1.default.dim(`    ... and ${diff.deleted.length - 10} more`));
-            }
-        }
-        p.note(changeLines.join('\n'), 'Changes to push');
-        // Confirm unless --force
-        if (!force) {
-            const confirmed = yield p.confirm({
-                message: 'Push these changes?',
-            });
-            if (p.isCancel(confirmed) || !confirmed) {
-                p.cancel('Push cancelled.');
-                process.exit(0);
-            }
-        }
-        const spinner = p.spinner();
-        try {
-            spinner.start('Pushing changes...');
-            const result = yield (0, sync_1.pushProject)(baseUrl, token, projectId, handoff.workingPath, {
-                force,
-                onProgress: (msg) => spinner.message(msg),
-            });
-            spinner.stop('Push complete.');
-            // Separate excluded-path warnings from real errors
-            const excludedErrors = result.errors.filter((e) => /excluded\s*path/i.test(e));
-            const realErrors = result.errors.filter((e) => !/excluded\s*path/i.test(e));
-            const summary = [
-                `Uploaded: ${chalk_1.default.green(String(result.uploaded.length))} file(s)`,
-                `Deleted: ${chalk_1.default.red(String(result.deleted.length))} file(s)`,
-                `Sync version: ${chalk_1.default.cyan(String(result.version))}`,
-            ];
-            if (excludedErrors.length > 0) {
-                summary.push(chalk_1.default.yellow(`${excludedErrors.length} path(s) not synced (excluded by server)`));
-            }
-            if (realErrors.length > 0) {
-                summary.push(`Errors: ${chalk_1.default.red(String(realErrors.length))}`);
-                for (const err of realErrors) {
-                    summary.push(chalk_1.default.red(`  ! ${err}`));
-                }
-            }
-            p.note(summary.join('\n'), 'Push Summary');
-            p.outro('Remote project updated.');
-        }
-        catch (err) {
-            spinner.stop('Push failed.');
-            if (err instanceof client_1.PlatformApiError && err.statusCode === 409) {
-                p.cancel([
-                    'Version conflict! The remote project has changed since your last pull.',
-                    `Run ${chalk_1.default.cyan('handoff-app platform:pull')} first, then try pushing again.`,
-                ].join('\n'));
-            }
-            else {
-                p.cancel(err.message || 'Push failed');
-            }
-            process.exit(1);
-        }
-    });
-}
-// ─────────────────────────────────────────────────────────────────────────
-// Config helpers
-// ─────────────────────────────────────────────────────────────────────────
-/**
- * Update the local handoff config file with platformProjectId and platformUrl
- * after a successful create-push. Reuses the same injection logic as platform:init.
- */
-function updateLocalConfig(workingDir, projectId, platformUrl) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const existingConfigFile = CONFIG_FILES.find((file) => fs_extra_1.default.existsSync(path_1.default.resolve(workingDir, file)));
-        if (existingConfigFile) {
-            const configPath = path_1.default.resolve(workingDir, existingConfigFile);
-            const ext = path_1.default.extname(configPath);
-            if (ext === '.json') {
-                const config = fs_extra_1.default.readJsonSync(configPath);
-                config.platformProjectId = projectId;
-                config.platformUrl = platformUrl;
-                fs_extra_1.default.writeJsonSync(configPath, config, { spaces: 2 });
-            }
-            else {
-                let content = fs_extra_1.default.readFileSync(configPath, 'utf8');
-                content = upsertConfigField(content, 'platformProjectId', JSON.stringify(projectId));
-                content = upsertConfigField(content, 'platformUrl', JSON.stringify(platformUrl));
-                fs_extra_1.default.writeFileSync(configPath, content, 'utf8');
-            }
-        }
-        else {
-            // Create a minimal config
-            const configPath = path_1.default.resolve(workingDir, 'handoff.config.js');
-            fs_extra_1.default.writeFileSync(configPath, `module.exports = {\n  platformProjectId: ${JSON.stringify(projectId)},\n  platformUrl: ${JSON.stringify(platformUrl)},\n};\n`);
-        }
-    });
-}
-/**
- * Insert or replace a top-level field in a JS config export.
- */
-function upsertConfigField(source, fieldName, value) {
-    const existingPattern = new RegExp(`(${fieldName}\\s*:\\s*)([^,}\\n]+)(,?)`);
-    if (existingPattern.test(source)) {
-        return source.replace(existingPattern, `$1${value}$3`);
-    }
-    const closingBrace = /(\n)(};?\s*$)/;
-    if (closingBrace.test(source)) {
-        source = ensureTrailingComma(source);
-        return source.replace(closingBrace, `$1  ${fieldName}: ${value},\n$2`);
-    }
-    return source + `\n// Added by platform:push — could not auto-inject:\n// ${fieldName}: ${value}\n`;
-}
-/**
- * Ensure the last property line before the closing brace has a trailing comma.
- */
-function ensureTrailingComma(source) {
-    const lines = source.split('\n');
-    let closingIdx = -1;
-    for (let i = lines.length - 1; i >= 0; i--) {
-        if (/^};?\s*$/.test(lines[i])) {
-            closingIdx = i;
-            break;
-        }
-    }
-    if (closingIdx <= 0)
-        return source;
-    let lastPropIdx = closingIdx - 1;
-    while (lastPropIdx >= 0 && (/^\s*$/.test(lines[lastPropIdx]) || /^\s*\/\//.test(lines[lastPropIdx]))) {
-        lastPropIdx--;
-    }
-    if (lastPropIdx < 0)
-        return source;
-    const stripped = lines[lastPropIdx].replace(/\s*\/\/.*$/, '').trimEnd();
-    if (stripped.length > 0 && !stripped.endsWith(',') && !stripped.endsWith('{')) {
-        lines[lastPropIdx] = lines[lastPropIdx].replace(/(\S)(\s*(?:\/\/.*)?)$/, '$1,$2');
-    }
-    return lines.join('\n');
-}
-exports.default = command;

package/dist/platform/client.d.ts

@@ -1,122 +0,0 @@
-export interface DeviceCodeResponse {
-    deviceCode: string;
-    userCode: string;
-    verificationUrl: string;
-    expiresIn: number;
-    interval: number;
-}
-export interface TokenPollPending {
-    status: 'pending';
-}
-export interface TokenPollApproved {
-    status: 'approved';
-    token: string;
-    user: {
-        id: string;
-        name: string | null;
-        email: string;
-        image: string | null;
-    };
-}
-export type TokenPollResponse = TokenPollPending | TokenPollApproved;
-export interface CliProject {
-    id: string;
-    name: string;
-    slug: string;
-    orgId: string;
-    orgName: string;
-    orgSlug: string;
-    role: string;
-    syncVersion: number;
-}
-export interface ManifestFile {
-    etag: string;
-    size: number;
-    lastModified: string;
-}
-export interface SyncManifest {
-    projectId: string;
-    version: number;
-    prefix: string;
-    files: Record<string, ManifestFile>;
-}
-export interface PushResult {
-    success: boolean;
-    version: number;
-    uploaded: string[];
-    deleted: string[];
-    errors: string[];
-    files: Record<string, ManifestFile>;
-}
-export interface ConflictResponse {
-    error: 'conflict';
-    message: string;
-    currentVersion: number;
-    files: Record<string, ManifestFile>;
-}
-export interface CreatePushResult {
-    project: {
-        id: string;
-        name: string;
-        slug: string;
-        orgId: string;
-        [key: string]: unknown;
-    };
-    syncVersion: number;
-    uploaded: number;
-    errors: string[];
-    files: Record<string, ManifestFile>;
-}
-declare class PlatformApiError extends Error {
-    statusCode: number;
-    constructor(statusCode: number, message: string);
-}
-/**
- * Initiate the device-code auth flow.
- */
-export declare function createDeviceCode(baseUrl: string): Promise<DeviceCodeResponse>;
-/**
- * Poll for an approved token. Resolves when approved or rejects on
- * expiry / error.
- */
-export declare function pollForToken(baseUrl: string, deviceCode: string, interval: number, expiresIn: number): Promise<TokenPollApproved>;
-/**
- * Revoke (logout) the current CLI token.
- */
-export declare function revokeToken(baseUrl: string, token: string): Promise<void>;
-/**
- * List all projects accessible to the authenticated user.
- */
-export declare function listProjects(baseUrl: string, token: string): Promise<CliProject[]>;
-/**
- * Get the file manifest for a project.
- */
-export declare function getManifest(baseUrl: string, token: string, projectId: string): Promise<SyncManifest>;
-/**
- * Download a single file from the project by relative path.
- * Returns the file content as a Buffer.
- */
-export declare function downloadFile(baseUrl: string, token: string, projectId: string, filePath: string): Promise<Buffer>;
-/**
- * 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
- */
-export declare function pushChanges(baseUrl: string, token: string, projectId: string, baseVersion: number, files: Map<string, Buffer>, deleted: string[]): Promise<PushResult>;
-/**
- * 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
- */
-export declare function createPush(baseUrl: string, token: string, orgId: string, files: Map<string, Buffer>, options?: {
-    name?: string;
-    figmaProjectId?: string;
-}): Promise<CreatePushResult>;
-export { PlatformApiError };