@hubspot/cli 7.3.0 → 7.4.0-experimental.0

package/bin/cli.js

@@ -43,6 +43,7 @@ const cmsCommand = require('../commands/cms');
 const feedbackCommand = require('../commands/feedback');
 const doctorCommand = require('../commands/doctor');
 const completionCommand = require('../commands/completion');
+const appCommand = require('../commands/app');
 const notifier = updateNotifier({
     pkg: { ...pkg, name: '@hubspot/cli' },
     distTag: 'latest',
@@ -294,6 +295,7 @@ const argv = yargs
     .command(feedbackCommand)
     .command(doctorCommand)
     .command(completionCommand)
+    .command(appCommand)
     .help()
     .alias('h', 'help')
     .recommendCommands()

package/commands/app/migrate.d.ts

@@ -0,0 +1,7 @@
+import { ArgumentsCamelCase, Argv, CommandModule } from 'yargs';
+import { MigrateAppOptions } from '../../types/Yargs';
+export declare const validMigrationTargets: string[];
+export declare function handler(options: ArgumentsCamelCase<MigrateAppOptions>): Promise<never>;
+export declare function builder(yargs: Argv): Argv<MigrateAppOptions>;
+declare const migrateCommand: CommandModule<unknown, MigrateAppOptions>;
+export default migrateCommand;

package/commands/app/migrate.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validMigrationTargets = void 0;
+exports.handler = handler;
+exports.builder = builder;
+const commonOpts_1 = require("../../lib/commonOpts");
+const usageTracking_1 = require("../../lib/usageTracking");
+const lang_1 = require("../../lib/lang");
+const errorHandlers_1 = require("../../lib/errorHandlers");
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const config_1 = require("@hubspot/local-dev-lib/config");
+const migrate_1 = require("../../lib/app/migrate");
+const projects_1 = require("@hubspot/local-dev-lib/constants/projects");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const ui_1 = require("../../lib/ui");
+const { v2023_2, v2025_2, unstable } = projects_1.PLATFORM_VERSIONS;
+exports.validMigrationTargets = [v2023_2, v2025_2, unstable];
+const command = 'migrate';
+const describe = undefined; // uiBetaTag(i18n(`commands.project.subcommands.migrateApp.header.text.describe`), false);
+async function handler(options) {
+    const { derivedAccountId, platformVersion } = options;
+    await (0, usageTracking_1.trackCommandUsage)('migrate-app', {}, derivedAccountId);
+    const accountConfig = (0, config_1.getAccountConfig)(derivedAccountId);
+    if (!accountConfig) {
+        logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.noAccountConfig`));
+        return process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    logger_1.logger.log('');
+    logger_1.logger.log((0, ui_1.uiBetaTag)((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.header.text`), false));
+    logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.header.link`), 'https://developers.hubspot.com/docs/platform/migrate-a-public-app-to-projects'));
+    logger_1.logger.log('');
+    try {
+        if (platformVersion === v2025_2 || platformVersion === unstable) {
+            await (0, migrate_1.migrateApp2025_2)(derivedAccountId, options);
+        }
+        else {
+            await (0, migrate_1.migrateApp2023_2)(derivedAccountId, options, accountConfig);
+        }
+    }
+    catch (error) {
+        if (error &&
+            typeof error === 'object' &&
+            'errors' in error &&
+            Array.isArray(error.errors)) {
+            error.errors.forEach(err => (0, errorHandlers_1.logError)(err));
+        }
+        else {
+            (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
+        }
+        await (0, usageTracking_1.trackCommandMetadataUsage)('migrate-app', { successful: false }, derivedAccountId);
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+    }
+    await (0, usageTracking_1.trackCommandMetadataUsage)('migrate-app', { successful: true }, derivedAccountId);
+    return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+}
+function builder(yargs) {
+    (0, commonOpts_1.addConfigOptions)(yargs);
+    (0, commonOpts_1.addAccountOptions)(yargs);
+    (0, commonOpts_1.addUseEnvironmentOptions)(yargs);
+    yargs.options({
+        name: {
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.name.describe`),
+            type: 'string',
+        },
+        dest: {
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.dest.describe`),
+            type: 'string',
+        },
+        'app-id': {
+            describe: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.options.appId.describe`),
+            type: 'number',
+        },
+        'platform-version': {
+            type: 'string',
+            choices: exports.validMigrationTargets,
+            hidden: true,
+            default: '2023.2',
+        },
+    });
+    yargs.example([
+        [
+            `$0 app migrate`,
+            (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.examples.default`),
+        ],
+    ]);
+    return yargs;
+}
+const migrateCommand = {
+    command,
+    describe,
+    handler,
+    builder,
+};
+exports.default = migrateCommand;

package/commands/app.d.ts

@@ -0,0 +1,6 @@
+import { Argv, CommandModule } from 'yargs';
+export declare const command: string[];
+export declare const describe: undefined;
+export declare function builder(yargs: Argv): Argv<{}>;
+declare const appCommand: CommandModule;
+export default appCommand;

package/commands/app.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describe = exports.command = void 0;
+exports.builder = builder;
+const migrate_1 = __importDefault(require("./app/migrate"));
+const commonOpts_1 = require("../lib/commonOpts");
+exports.command = ['app', 'apps'];
+// Keep the command hidden for now
+exports.describe = undefined;
+function builder(yargs) {
+    (0, commonOpts_1.addGlobalOptions)(yargs);
+    return yargs.command(migrate_1.default).demandCommand(1, '');
+}
+const appCommand = {
+    command: exports.command,
+    describe: exports.describe,
+    builder,
+    handler: () => { },
+};
+exports.default = appCommand;

package/commands/project/cloneApp.d.ts

@@ -1 +1,9 @@
-export {};
+import { ArgumentsCamelCase, Argv, CommandModule } from 'yargs';
+import { CloneAppArgs } from '../../types/Yargs';
+export declare const command = "clone-app";
+export declare const describe: string | undefined;
+export declare const deprecated = true;
+export declare const handler: (options: ArgumentsCamelCase<CloneAppArgs>) => Promise<never>;
+export declare const builder: (yargs: Argv) => Argv<CloneAppArgs>;
+declare const cloneAppCommand: CommandModule<unknown, CloneAppArgs>;
+export default cloneAppCommand;

package/commands/project/cloneApp.js

@@ -1,43 +1,46 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-// @ts-nocheck
-const path = require('path');
-const fs = require('fs');
-const { addAccountOptions, addConfigOptions, addUseEnvironmentOptions, } = require('../../lib/commonOpts');
-const { trackCommandUsage, trackCommandMetadataUsage, } = require('../../lib/usageTracking');
-const { i18n } = require('../../lib/lang');
-const { selectPublicAppPrompt, } = require('../../lib/prompts/selectPublicAppPrompt');
-const { createProjectPrompt, } = require('../../lib/prompts/createProjectPrompt');
-const { poll } = require('../../lib/polling');
-const { uiBetaTag, uiLine, uiCommandReference, uiAccountDescription, } = require('../../lib/ui');
-const SpinniesManager = require('../../lib/ui/SpinniesManager');
-const { logError, ApiErrorContext } = require('../../lib/errorHandlers/index');
-const { EXIT_CODES } = require('../../lib/enums/exitCodes');
-const { isAppDeveloperAccount } = require('../../lib/accountTypes');
-const { writeProjectConfig } = require('../../lib/projects');
-const { PROJECT_CONFIG_FILE } = require('../../lib/constants');
-const { cloneApp, checkCloneStatus, downloadClonedProject, } = require('@hubspot/local-dev-lib/api/projects');
-const { getCwd, sanitizeFileName } = require('@hubspot/local-dev-lib/path');
-const { logger } = require('@hubspot/local-dev-lib/logger');
-const { getAccountConfig } = require('@hubspot/local-dev-lib/config');
-const { extractZipArchive } = require('@hubspot/local-dev-lib/archive');
+exports.builder = exports.handler = exports.deprecated = exports.describe = exports.command = void 0;
+const ui_1 = require("../../lib/ui");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+const commonOpts_1 = require("../../lib/commonOpts");
+const usageTracking_1 = require("../../lib/usageTracking");
+const lang_1 = require("../../lib/lang");
+const selectPublicAppPrompt_1 = require("../../lib/prompts/selectPublicAppPrompt");
+const createProjectPrompt_1 = require("../../lib/prompts/createProjectPrompt");
+const polling_1 = require("../../lib/polling");
+const ui_2 = require("../../lib/ui");
+const errorHandlers_1 = require("../../lib/errorHandlers");
+const exitCodes_1 = require("../../lib/enums/exitCodes");
+const accountTypes_1 = require("../../lib/accountTypes");
+const projects_1 = require("../../lib/projects");
+const constants_1 = require("../../lib/constants");
+const projects_2 = require("@hubspot/local-dev-lib/api/projects");
+const path_2 = require("@hubspot/local-dev-lib/path");
+const logger_1 = require("@hubspot/local-dev-lib/logger");
+const archive_1 = require("@hubspot/local-dev-lib/archive");
+const config_1 = require("@hubspot/local-dev-lib/config");
+const SpinniesManager_1 = __importDefault(require("../../lib/ui/SpinniesManager"));
+const migrate_1 = require("../../lib/app/migrate");
 const i18nKey = 'commands.project.subcommands.cloneApp';
 exports.command = 'clone-app';
-exports.describe = uiBetaTag(i18n(`${i18nKey}.describe`), false);
-exports.handler = async (options) => {
+exports.describe = (0, ui_1.uiDeprecatedTag)((0, lang_1.i18n)(`${i18nKey}.describe`), false);
+exports.deprecated = true;
+const handler = async (options) => {
     const { derivedAccountId } = options;
-    const accountConfig = getAccountConfig(derivedAccountId);
-    const accountName = uiAccountDescription(derivedAccountId);
-    trackCommandUsage('clone-app', {}, derivedAccountId);
-    if (!isAppDeveloperAccount(accountConfig)) {
-        uiLine();
-        logger.error(i18n(`${i18nKey}.errors.invalidAccountTypeTitle`));
-        logger.log(i18n(`${i18nKey}.errors.invalidAccountTypeDescription`, {
-            useCommand: uiCommandReference('hs accounts use'),
-            authCommand: uiCommandReference('hs auth'),
-        }));
-        uiLine();
-        process.exit(EXIT_CODES.SUCCESS);
+    await (0, usageTracking_1.trackCommandUsage)('clone-app', {}, derivedAccountId);
+    const accountConfig = (0, config_1.getAccountConfig)(derivedAccountId);
+    const accountName = (0, ui_2.uiAccountDescription)(derivedAccountId);
+    if (!accountConfig) {
+        throw new Error((0, lang_1.i18n)(`commands.projects.subcommands.cloneApp.errors.noAccountConfig`));
+    }
+    if (!(0, accountTypes_1.isAppDeveloperAccount)(accountConfig)) {
+        (0, migrate_1.logInvalidAccountError)(i18nKey);
+        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
     }
     let appId;
     let projectName;
@@ -45,96 +48,108 @@ exports.handler = async (options) => {
     try {
         appId = options.appId;
         if (!appId) {
-            const appIdResponse = await selectPublicAppPrompt({
+            const appIdResponse = await (0, selectPublicAppPrompt_1.selectPublicAppPrompt)({
                 accountId: derivedAccountId,
                 accountName,
-                options,
                 isMigratingApp: false,
             });
             appId = appIdResponse.appId;
         }
-        const createProjectPromptResponse = await createProjectPrompt(options);
+        const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(options);
         projectName = createProjectPromptResponse.name;
         projectDest = createProjectPromptResponse.dest;
     }
     catch (error) {
-        logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
-        process.exit(EXIT_CODES.ERROR);
+        (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
+        process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
-    await trackCommandMetadataUsage('clone-app', { status: 'STARTED' }, derivedAccountId);
+    await (0, usageTracking_1.trackCommandMetadataUsage)('clone-app', { step: 'STARTED' }, derivedAccountId);
     try {
-        SpinniesManager.init();
-        SpinniesManager.add('cloneApp', {
-            text: i18n(`${i18nKey}.cloneStatus.inProgress`),
+        SpinniesManager_1.default.init();
+        SpinniesManager_1.default.add('cloneApp', {
+            text: (0, lang_1.i18n)(`${i18nKey}.cloneStatus.inProgress`),
         });
-        const { data: { exportId }, } = await cloneApp(derivedAccountId, appId);
-        const { status } = await poll(() => checkCloneStatus(derivedAccountId, exportId));
+        const { data: { exportId }, } = await (0, projects_2.cloneApp)(derivedAccountId, appId);
+        const { status } = await (0, polling_1.poll)(() => (0, projects_2.checkCloneStatus)(derivedAccountId, exportId));
         if (status === 'SUCCESS') {
             // Ensure correct project folder structure exists
-            const baseDestPath = path.resolve(getCwd(), projectDest);
-            const absoluteDestPath = path.resolve(baseDestPath, 'src', 'app');
-            fs.mkdirSync(absoluteDestPath, { recursive: true });
+            const baseDestPath = path_1.default.resolve((0, path_2.getCwd)(), projectDest);
+            const absoluteDestPath = path_1.default.resolve(baseDestPath, 'src', 'app');
+            fs_1.default.mkdirSync(absoluteDestPath, { recursive: true });
             // Extract zipped app files and place them in correct directory
-            const { data: zippedApp } = await downloadClonedProject(derivedAccountId, exportId);
-            await extractZipArchive(zippedApp, sanitizeFileName(projectName), absoluteDestPath, {
+            const { data: zippedApp } = await (0, projects_2.downloadClonedProject)(derivedAccountId, exportId);
+            await (0, archive_1.extractZipArchive)(zippedApp, (0, path_2.sanitizeFileName)(projectName), absoluteDestPath, {
                 includesRootDir: true,
                 hideLogs: true,
             });
             // Create hsproject.json file
-            const configPath = path.join(baseDestPath, PROJECT_CONFIG_FILE);
+            const configPath = path_1.default.join(baseDestPath, constants_1.PROJECT_CONFIG_FILE);
             const configContent = {
                 name: projectName,
                 srcDir: 'src',
                 platformVersion: '2023.2',
             };
-            const success = writeProjectConfig(configPath, configContent);
-            SpinniesManager.succeed('cloneApp', {
-                text: i18n(`${i18nKey}.cloneStatus.done`),
+            const success = (0, projects_1.writeProjectConfig)(configPath, configContent);
+            SpinniesManager_1.default.succeed('cloneApp', {
+                text: (0, lang_1.i18n)(`${i18nKey}.cloneStatus.done`),
                 succeedColor: 'white',
             });
             if (!success) {
-                logger.error(i18n(`${i18nKey}.errors.couldNotWriteConfigPath`), configPath);
+                logger_1.logger.error((0, lang_1.i18n)(`${i18nKey}.errors.couldNotWriteConfigPath`), configPath);
             }
-            logger.log('');
-            uiLine();
-            logger.success(i18n(`${i18nKey}.cloneStatus.success`, { dest }));
-            logger.log('');
-            process.exit(EXIT_CODES.SUCCESS);
+            logger_1.logger.log('');
+            (0, ui_2.uiLine)();
+            logger_1.logger.success((0, lang_1.i18n)(`${i18nKey}.cloneStatus.success`, { dest: projectDest }));
+            logger_1.logger.log('');
+            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
         }
     }
     catch (error) {
-        await trackCommandMetadataUsage('clone-app', { status: 'FAILURE' }, derivedAccountId);
-        SpinniesManager.fail('cloneApp', {
-            text: i18n(`${i18nKey}.cloneStatus.failure`),
+        await (0, usageTracking_1.trackCommandMetadataUsage)('clone-app', { successful: false }, derivedAccountId);
+        SpinniesManager_1.default.fail('cloneApp', {
+            text: (0, lang_1.i18n)(`${i18nKey}.cloneStatus.failure`),
             failColor: 'white',
         });
         // Migrations endpoints return a response object with an errors property. The errors property contains an array of errors.
-        if (error.errors && Array.isArray(error.errors)) {
-            error.errors.forEach(e => logError(e, new ApiErrorContext({ accountId: derivedAccountId })));
+        if (error &&
+            typeof error === 'object' &&
+            'errors' in error &&
+            Array.isArray(error.errors)) {
+            error.errors.forEach(e => (0, errorHandlers_1.logError)(e, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId })));
         }
         else {
-            logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
+            (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
         }
     }
-    await trackCommandMetadataUsage('clone-app', { status: 'SUCCESS' }, derivedAccountId);
-    process.exit(EXIT_CODES.SUCCESS);
+    await (0, usageTracking_1.trackCommandMetadataUsage)('clone-app', { successful: true }, derivedAccountId);
+    process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
 };
-exports.builder = yargs => {
+exports.handler = handler;
+const builder = (yargs) => {
     yargs.options({
         dest: {
-            describe: i18n(`${i18nKey}.options.dest.describe`),
+            describe: (0, lang_1.i18n)(`${i18nKey}.options.dest.describe`),
             type: 'string',
         },
         'app-id': {
-            describe: i18n(`${i18nKey}.options.appId.describe`),
+            describe: (0, lang_1.i18n)(`${i18nKey}.options.appId.describe`),
             type: 'number',
         },
     });
     yargs.example([
-        ['$0 project clone-app', i18n(`${i18nKey}.examples.default`)],
+        ['$0 project clone-app', (0, lang_1.i18n)(`${i18nKey}.examples.default`)],
     ]);
-    addConfigOptions(yargs);
-    addAccountOptions(yargs);
-    addUseEnvironmentOptions(yargs);
+    (0, commonOpts_1.addConfigOptions)(yargs);
+    (0, commonOpts_1.addAccountOptions)(yargs);
+    (0, commonOpts_1.addUseEnvironmentOptions)(yargs);
     return yargs;
 };
+exports.builder = builder;
+const cloneAppCommand = {
+    command: exports.command,
+    describe: exports.describe,
+    handler: exports.handler,
+    builder: exports.builder,
+    deprecated: exports.deprecated,
+};
+exports.default = cloneAppCommand;

package/commands/project/create.js

@@ -87,7 +87,6 @@ exports.handler = async (options) => {
         'projectCommandTip',
         'projectUploadCommand',
         'projectDevCommand',
-        'projectInstallDepsCommand',
         'projectHelpCommand',
         'feedbackCommand',
         'sampleProjects',

package/commands/project/migrateApp.d.ts

@@ -1 +1,9 @@
-export {};
+import { ArgumentsCamelCase, Argv, CommandModule } from 'yargs';
+import { MigrateAppOptions } from '../../types/Yargs';
+export declare const command = "migrate-app";
+export declare const describe: string | undefined;
+export declare const deprecated = true;
+export declare function handler(yargs: ArgumentsCamelCase<MigrateAppOptions>): Promise<void>;
+export declare function builder(yargs: Argv): Argv<MigrateAppOptions>;
+declare const migrateAppCommand: CommandModule<unknown, MigrateAppOptions>;
+export default migrateAppCommand;