handoff-app 1.0.3-canary.6 → 1.0.3

package/Changelog.md

@@ -6,7 +6,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## \[1.0.3] - 2026-02-08
+## \[1.0.3] - 2026-02-17
 
 Bugfixes, UX improvements to the component page, improvements to react docgen,
 a new quickstart command, and security fixes.
@@ -26,6 +26,12 @@ a new quickstart command, and security fixes.
 * The API response documentation is now a tree view, rather a formated JSON
   object. This makes it much easier to see and reason about the JSON response.
 
+## Bug Fixes
+
+* The API preview would through a 500 error under some conditions
+* Using TSX components would cause an error in the code preview if the tsx component
+  used some kinds of valid react formatting.
+
 ## Type Gen
 
 * When using TSX instead of handlebars, the properties can be automatically
@@ -46,10 +52,10 @@ a new quickstart command, and security fixes.
   Since Handoff does not use server side rendered components, handoff sites are not
   vulnerable to this risks.
 
-## Feature
+## QoL Improvements
 
-* Components now set a last mod time at build time so you can tell when a component
-  has changed.
+* Fixes a bug in webpack that made the include path lookups fail.  @handoff and @/util now
+  works properly.
 
 ## \[1.0.2] - 2026-01-12
 
@@ -61,6 +67,10 @@ Bugfixes focused on developer quality of life.
   resulting in a 404 error. This patch resolves a race condition in the HMR, by
   preventing double write of the next config.
 * Patch an issue where the example component doesn't load in a clean project
+* If you create pages without a declared weight, handoff would throw an error
+* There was an old structure in the way we used handlebars that surfaces a warning
+  on build.  We've updated that method.
+* We removed an old page template that was no longer needed.
 
 ## \[1.0.1] - 2025-12-28
 

package/dist/commands/platform/init.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from 'yargs';
+export interface PlatformInitArgs {
+    url?: string;
+}
+declare const command: CommandModule<{}, PlatformInitArgs>;
+export default command;

package/dist/commands/platform/init.js

@@ -0,0 +1,231 @@
+"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 client_1 = require("../../platform/client");
+const credentials_1 = require("../../platform/credentials");
+const DEFAULT_PLATFORM_URL = 'http://localhost:3000';
+const CONFIG_FILES = ['handoff.config.json', 'handoff.config.js', 'handoff.config.cjs'];
+const command = {
+    command: 'platform:init',
+    describe: 'Link this directory to a Handoff platform project',
+    builder: (yargs) => {
+        return yargs.option('url', {
+            type: 'string',
+            description: 'Platform URL',
+            default: process.env.HANDOFF_PLATFORM_URL || DEFAULT_PLATFORM_URL,
+        });
+    },
+    handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
+        const baseUrl = (args.url || DEFAULT_PLATFORM_URL).replace(/\/+$/, '');
+        const workingDir = process.cwd();
+        p.intro(chalk_1.default.bold('Handoff Platform Init'));
+        // 1. Check login
+        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);
+        }
+        const spinner = p.spinner();
+        try {
+            // 2. Fetch project list
+            spinner.start('Fetching projects...');
+            const projects = yield (0, client_1.listProjects)(baseUrl, token);
+            spinner.stop('Projects loaded.');
+            if (projects.length === 0) {
+                p.cancel('No projects found. Create a project in the Handoff platform first.');
+                process.exit(1);
+            }
+            // 3. Interactive project selection
+            const projectId = yield p.select({
+                message: 'Select a project to link:',
+                options: projects.map((proj) => ({
+                    value: proj.id,
+                    label: `${proj.name} (${proj.orgName})`,
+                    hint: `${proj.slug} — ${proj.role}`,
+                })),
+            });
+            if (p.isCancel(projectId)) {
+                p.cancel('Init cancelled.');
+                process.exit(0);
+            }
+            const selectedProject = projects.find((proj) => proj.id === projectId);
+            // 4. Check if a local config exists
+            const existingConfigFile = CONFIG_FILES.find((file) => fs_extra_1.default.existsSync(path_1.default.resolve(workingDir, file)));
+            if (!existingConfigFile) {
+                // No local config — pull it from the remote project
+                spinner.start('No local config found. Fetching config from platform...');
+                try {
+                    const manifest = yield (0, client_1.getManifest)(baseUrl, token, selectedProject.id);
+                    // Look for handoff.config.js in the manifest
+                    const remoteConfigKey = Object.keys(manifest.files).find((key) => key === 'handoff.config.js' || key === 'handoff.config.json' || key === 'handoff.config.cjs');
+                    if (remoteConfigKey) {
+                        const content = yield (0, client_1.downloadFile)(baseUrl, token, selectedProject.id, remoteConfigKey);
+                        const localConfigPath = path_1.default.resolve(workingDir, remoteConfigKey);
+                        fs_extra_1.default.writeFileSync(localConfigPath, content);
+                        spinner.stop(`Downloaded ${remoteConfigKey} from platform.`);
+                        // Now inject the platform fields into it
+                        yield injectPlatformFields(localConfigPath, selectedProject.id, baseUrl);
+                    }
+                    else {
+                        spinner.stop('No remote config found either. Creating a new config.');
+                        // Create a minimal config with just the platform fields
+                        const configPath = path_1.default.resolve(workingDir, 'handoff.config.js');
+                        const configContent = generateMinimalConfig(selectedProject.id, baseUrl);
+                        fs_extra_1.default.writeFileSync(configPath, configContent);
+                    }
+                }
+                catch (err) {
+                    spinner.stop('Could not fetch remote config.');
+                    // Fall back to creating a minimal config
+                    const configPath = path_1.default.resolve(workingDir, 'handoff.config.js');
+                    const configContent = generateMinimalConfig(selectedProject.id, baseUrl);
+                    fs_extra_1.default.writeFileSync(configPath, configContent);
+                }
+            }
+            else {
+                // Local config exists — add/update platform fields
+                const configPath = path_1.default.resolve(workingDir, existingConfigFile);
+                yield injectPlatformFields(configPath, selectedProject.id, baseUrl);
+            }
+            p.note([
+                `Project: ${chalk_1.default.bold(selectedProject.name)}`,
+                `Organization: ${chalk_1.default.dim(selectedProject.orgName)}`,
+                `Project ID: ${chalk_1.default.dim(selectedProject.id)}`,
+                `Platform: ${chalk_1.default.dim(baseUrl)}`,
+            ].join('\n'), 'Linked successfully');
+            p.outro(`Run ${chalk_1.default.cyan('handoff-app platform:pull')} to sync files from the platform.`);
+        }
+        catch (err) {
+            spinner.stop('Init failed.');
+            p.cancel(err.message || 'Init failed');
+            process.exit(1);
+        }
+    }),
+};
+/**
+ * Inject platformProjectId and platformUrl into an existing config file.
+ *
+ * For JSON files, parse and re-serialize.
+ * For JS/CJS files, use a regex approach to add/update the fields.
+ */
+function injectPlatformFields(configPath, projectId, platformUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        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 {
+            // JS or CJS file — read as text, inject/replace fields
+            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');
+        }
+    });
+}
+/**
+ * Insert or replace a top-level field in a JS config export.
+ * Looks for `fieldName: ...` and replaces the value, or appends
+ * the field before the closing `};` of module.exports.
+ */
+function upsertConfigField(source, fieldName, value) {
+    // Pattern to match an existing field assignment (with optional trailing comma)
+    const existingPattern = new RegExp(`(${fieldName}\\s*:\\s*)([^,}\\n]+)(,?)`);
+    if (existingPattern.test(source)) {
+        return source.replace(existingPattern, `$1${value}$3`);
+    }
+    // Insert before the last `};` (end of module.exports)
+    // Handle both `module.exports = {` and `export default {` styles
+    // Also ensure the previous line ends with a comma so the JS stays valid
+    const closingBrace = /(\n)(};?\s*$)/;
+    if (closingBrace.test(source)) {
+        // Ensure the last property line before the closing brace has a trailing comma
+        source = ensureTrailingComma(source);
+        return source.replace(closingBrace, `$1  ${fieldName}: ${value},\n$2`);
+    }
+    // Fallback: just append as a comment warning
+    return source + `\n// Added by platform:init — could not auto-inject:\n// ${fieldName}: ${value}\n`;
+}
+/**
+ * Ensure the last property line before the closing `};` has a trailing comma.
+ * This prevents invalid JS when appending new properties to an object literal.
+ */
+function ensureTrailingComma(source) {
+    const lines = source.split('\n');
+    // Find the closing `};` or `}` at the start of a line (module.exports / export default)
+    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;
+    // Walk backwards past blank lines and comment-only lines to find the last property line
+    let lastPropIdx = closingIdx - 1;
+    while (lastPropIdx >= 0 && (/^\s*$/.test(lines[lastPropIdx]) || /^\s*\/\//.test(lines[lastPropIdx]))) {
+        lastPropIdx--;
+    }
+    if (lastPropIdx < 0)
+        return source;
+    // Strip inline comments for the check, but preserve them in the output
+    const stripped = lines[lastPropIdx].replace(/\s*\/\/.*$/, '').trimEnd();
+    if (stripped.length > 0 && !stripped.endsWith(',') && !stripped.endsWith('{')) {
+        // Insert a comma after the last significant character, preserving any inline comment
+        lines[lastPropIdx] = lines[lastPropIdx].replace(/(\S)(\s*(?:\/\/.*)?)$/, '$1,$2');
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate a minimal handoff.config.js with platform fields.
+ */
+function generateMinimalConfig(projectId, platformUrl) {
+    return `module.exports = {
+  platformProjectId: ${JSON.stringify(projectId)},
+  platformUrl: ${JSON.stringify(platformUrl)},
+};
+`;
+}
+exports.default = command;

package/dist/commands/platform/login.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from 'yargs';
+export interface PlatformLoginArgs {
+    url?: string;
+}
+declare const command: CommandModule<{}, PlatformLoginArgs>;
+export default command;

package/dist/commands/platform/login.js

@@ -0,0 +1,108 @@
+"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 child_process_1 = require("child_process");
+const client_1 = require("../../platform/client");
+const credentials_1 = require("../../platform/credentials");
+const DEFAULT_PLATFORM_URL = 'http://localhost:3000';
+const command = {
+    command: 'platform:login',
+    describe: 'Log in to the Handoff platform',
+    builder: (yargs) => {
+        return yargs.option('url', {
+            type: 'string',
+            description: 'Platform URL',
+            default: process.env.HANDOFF_PLATFORM_URL || DEFAULT_PLATFORM_URL,
+        });
+    },
+    handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
+        const baseUrl = (args.url || DEFAULT_PLATFORM_URL).replace(/\/+$/, '');
+        p.intro(chalk_1.default.bold('Handoff Platform Login'));
+        const spinner = p.spinner();
+        try {
+            spinner.start('Initiating authentication...');
+            const deviceCode = yield (0, client_1.createDeviceCode)(baseUrl);
+            spinner.stop('Authentication initiated.');
+            // Display the user code prominently
+            p.note([
+                `Your one-time code: ${chalk_1.default.bold.cyan(deviceCode.userCode)}`,
+                '',
+                `Open this URL to sign in:`,
+                chalk_1.default.underline(`${deviceCode.verificationUrl}`),
+            ].join('\n'), 'Authentication');
+            // Try to open the browser automatically
+            openBrowser(deviceCode.verificationUrl);
+            spinner.start('Waiting for approval (this will open in your browser)...');
+            const result = yield (0, client_1.pollForToken)(baseUrl, deviceCode.deviceCode, deviceCode.interval, deviceCode.expiresIn);
+            spinner.stop('Authentication approved!');
+            // Store the token
+            (0, credentials_1.setToken)(baseUrl, result.token, {
+                name: result.user.name,
+                email: result.user.email,
+            });
+            p.note([
+                `Logged in as ${chalk_1.default.bold(result.user.name || result.user.email)}`,
+                `Platform: ${chalk_1.default.dim(baseUrl)}`,
+            ].join('\n'), 'Success');
+            p.outro('You can now use platform:init to link a project.');
+        }
+        catch (err) {
+            spinner.stop('Authentication failed.');
+            p.cancel(err.message || 'Login failed');
+            process.exit(1);
+        }
+    }),
+};
+/**
+ * Attempt to open a URL in the default browser.
+ * Fails silently — the user can always copy/paste the URL.
+ */
+function openBrowser(url) {
+    const command = process.platform === 'darwin'
+        ? `open "${url}"`
+        : process.platform === 'win32'
+            ? `start "" "${url}"`
+            : `xdg-open "${url}"`;
+    (0, child_process_1.exec)(command, (err) => {
+        if (err) {
+            // Silently ignore — user will use the printed URL
+        }
+    });
+}
+exports.default = command;

package/dist/commands/platform/logout.d.ts

@@ -0,0 +1,6 @@
+import { CommandModule } from 'yargs';
+export interface PlatformLogoutArgs {
+    url?: string;
+}
+declare const command: CommandModule<{}, PlatformLogoutArgs>;
+export default command;

package/dist/commands/platform/logout.js

@@ -0,0 +1,88 @@
+"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 client_1 = require("../../platform/client");
+const credentials_1 = require("../../platform/credentials");
+const DEFAULT_PLATFORM_URL = 'http://localhost:3000';
+const command = {
+    command: 'platform:logout',
+    describe: 'Log out from the Handoff platform',
+    builder: (yargs) => {
+        return yargs.option('url', {
+            type: 'string',
+            description: 'Platform URL',
+            default: process.env.HANDOFF_PLATFORM_URL || DEFAULT_PLATFORM_URL,
+        });
+    },
+    handler: (args) => __awaiter(void 0, void 0, void 0, function* () {
+        const baseUrl = (args.url || DEFAULT_PLATFORM_URL).replace(/\/+$/, '');
+        p.intro(chalk_1.default.bold('Handoff Platform Logout'));
+        const token = (0, credentials_1.getToken)(baseUrl);
+        if (!token) {
+            p.note(`Not currently logged in to ${chalk_1.default.dim(baseUrl)}.`, 'Info');
+            p.outro('Nothing to do.');
+            return;
+        }
+        const spinner = p.spinner();
+        try {
+            // Revoke the token on the server (best-effort)
+            spinner.start('Revoking token...');
+            try {
+                yield (0, client_1.revokeToken)(baseUrl, token);
+            }
+            catch (_a) {
+                // If the server is unreachable or the token is already invalid,
+                // still proceed to remove the local credential.
+            }
+            spinner.stop('Token revoked.');
+            // Remove from local credentials store
+            (0, credentials_1.removeToken)(baseUrl);
+            p.note(`Logged out from ${chalk_1.default.dim(baseUrl)}.`, 'Success');
+            p.outro('Local credentials removed.');
+        }
+        catch (err) {
+            spinner.stop('Logout encountered an issue.');
+            // Still remove the local token even if revocation fails
+            (0, credentials_1.removeToken)(baseUrl);
+            p.note(`Local credentials removed, but server revocation may have failed.`, 'Warning');
+            p.outro('You are logged out locally.');
+        }
+    }),
+};
+exports.default = command;

package/dist/commands/platform/pull.d.ts

@@ -0,0 +1,8 @@
+import { CommandModule } from 'yargs';
+export interface PlatformPullArgs {
+    url?: string;
+    force?: boolean;
+    debug?: boolean;
+}
+declare const command: CommandModule<{}, PlatformPullArgs>;
+export default command;

package/dist/commands/platform/pull.js

@@ -0,0 +1,112 @@
+"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 __1 = __importDefault(require("../../"));
+const credentials_1 = require("../../platform/credentials");
+const sync_1 = require("../../platform/sync");
+const DEFAULT_PLATFORM_URL = 'http://localhost:3000';
+const command = {
+    command: 'platform:pull',
+    describe: 'Pull project files from the Handoff platform',
+    builder: (yargs) => {
+        return yargs
+            .option('url', {
+            type: 'string',
+            description: 'Platform URL (overrides config)',
+        })
+            .option('force', {
+            alias: 'f',
+            type: 'boolean',
+            description: 'Overwrite all local files and delete orphaned files',
+            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 Pull'));
+        if (!projectId) {
+            p.cancel(`No project linked. Run ${chalk_1.default.cyan('handoff-app platform:init')} first.`);
+            process.exit(1);
+        }
+        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);
+        }
+        const spinner = p.spinner();
+        try {
+            spinner.start('Pulling from platform...');
+            const result = yield (0, sync_1.pullProject)(baseUrl, token, projectId, handoff.workingPath, {
+                force: args.force,
+                onProgress: (msg) => spinner.message(msg),
+            });
+            spinner.stop('Pull complete.');
+            const summary = [
+                `Downloaded: ${chalk_1.default.green(String(result.downloaded.length))} file(s)`,
+                `Unchanged: ${chalk_1.default.dim(String(result.unchanged.length))} file(s)`,
+            ];
+            if (result.deleted.length > 0) {
+                summary.push(`Deleted: ${chalk_1.default.red(String(result.deleted.length))} file(s)`);
+            }
+            summary.push(`Sync version: ${chalk_1.default.cyan(String(result.version))}`);
+            p.note(summary.join('\n'), 'Pull Summary');
+            if (result.downloaded.length > 0) {
+                p.log.info(chalk_1.default.dim('Downloaded files:'));
+                for (const file of result.downloaded) {
+                    p.log.info(chalk_1.default.dim(`  + ${file}`));
+                }
+            }
+            p.outro('Local project is up to date.');
+        }
+        catch (err) {
+            spinner.stop('Pull failed.');
+            p.cancel(err.message || 'Pull failed');
+            process.exit(1);
+        }
+    }),
+};
+exports.default = command;

package/dist/commands/platform/push.d.ts

@@ -0,0 +1,8 @@
+import { CommandModule } from 'yargs';
+export interface PlatformPushArgs {
+    url?: string;
+    force?: boolean;
+    debug?: boolean;
+}
+declare const command: CommandModule<{}, PlatformPushArgs>;
+export default command;