@hubspot/cli 7.5.11-experimental.0 → 7.6.0-beta.1

package/lang/en.lyaml

@@ -20,18 +20,6 @@ en:
     account:
       describe: "Commands for managing configured accounts."
       subcommands:
-        auth:
-          describe: "Configure authentication for your HubSpot account."
-          options:
-            account:
-              describe: "HubSpot account to authenticate"
-          errors:
-            failedToUpdateConfig: "Failed to update the configuration file. Please try again."
-            migrationNotConfirmed: "Did not migrate. Use the {{ authCommand }} command to update the deprecated config at {{ deprecatedConfigPath }}."
-            mergeNotConfirmed: "Did not merge. When you are ready to merge the deprecated config file with the global config file, run the {{ authCommand }} or {{ migrateCommand }} command."
-          success:
-            configFileCreated: "Created config file \"{{ configPath }}\""
-            configFileUpdated: "Connected account \"{{ account }}\" and set it as the default account"
         createOverride:
           describe: "Create a new default account override file ({{ hsAccountFileName }}) in the current working directory."
           success: "Default account override file created at {{ overrideFilePath }}"
@@ -39,6 +27,7 @@ en:
           prompts:
             replaceOverrideFile: "Replace existing account override file?"
           errors:
+            globalConfigNotFound: "This command is only compatible with our new global config. Run {{ authCommand }} to get started."
             accountNotFound: "The specified account could not be found in the config file {{ configPath }}"
           options:
             account:
@@ -54,6 +43,8 @@ en:
             deleteOverrideFile: "Delete account override file?"
           success: "Removed the default account override file."
           noOverrideFile: "No default account override file found in the current working directory. No action required."
+          errors:
+            globalConfigNotFound: "This command is only compatible with our new global config. Run {{ authCommand }} to get started."
           options:
             force:
               describe: "Skip confirmation prompt when removing the override file"
@@ -152,7 +143,7 @@ en:
       verboseDescribe: "Configure authentication for a HubSpot account. This will update the {{ configName }} file that stores your account information.\n\nThe recommended authentication method is {{#bold}}{{ authMethod }}{{/bold}}, which uses an access token tied to a specific user account."
       errors:
         unsupportedAuthType: "Unsupported auth type: {{ type }}. The only supported authentication protocols are {{ supportedProtocols }}."
-        globalConfigFileExists: "A global config file exists at {{ configPath }}. To authorize an account, please use {{ authCommand }}."
+        globalConfigFileExists: "You are using our new global configuration for account management, which is not compatible with this command. Please use {{ accountAuthCommand }} instead."
       options:
         authType:
           describe: "Authentication method"
@@ -163,16 +154,6 @@ en:
     config:
       describe: "Commands for managing the CLI config file."
       subcommands:
-        migrate:
-          describe: "Migrate from the deprecated {{ deprecatedConfigPath }} file to the new global config file at {{ globalConfigPath }}."
-          migrationAlreadyCompleted: "No {{ deprecatedConfigPath }} deprecated configuration file found. No migration necessary."
-          errors:
-            configNotFound: "A configuration file at {{ configPath }} could not be found. Please try again with a valid file path."
-          options:
-            force: "When merging a deprecated configuration file with an existing global configuration file, overwrite any conflicting values in the global config with the deprecated config values."
-          examples:
-            default: "Migrate from the deprecated {{ deprecatedConfigPath }} file to the new global config file at {{ globalConfigPath }}"
-            configFlag: "Migrate a specific config file (specified with the config flag) to the new global config file at {{ globalConfigPath }}"
         set:
           describe: "Set various configuration options within the hubspot.config.yml file."
           promptMessage: "Select a config option to update"
@@ -527,7 +508,7 @@ en:
         updateConfig: "To update an existing config file, use the \"hs auth\" command."
       errors:
         configFileExists: "The config file {{ configPath }} already exists."
-        globalConfigFileExists: "A global config file already exists at {{ configPath }}. To specify a new local config file, delete the existing one and try again."
+        globalConfigFileExists: "You are using our new global configuration for account management, which is not compatible with this command. Please use {{ accountAuthCommand }} instead."
     lint:
       issuesFound: "{{ count }} issues found."
       groupName: "Linting {{ path }}"
@@ -588,15 +569,21 @@ en:
             betaMessage: "HubSpot projects local development"
             placeholderAccountSelection: "Using default account as target account (for now)"
             learnMoreLocalDevServer: "Learn more about the projects local dev server"
+            accountTypeInformation: "Testing in a developer test account is strongly recommended, but you can use a sandbox account if your plan allows you to create one."
+            learnMoreMessage: "Visit our {{ learnMoreLink }} to learn more."
+            learnMoreLink: "docs on Developer Test and Sandbox accounts "
           errors:
             noProjectConfig: "No project detected. Please run this command again from a project directory."
             noAccount: "An error occurred while reading account {{ accountId }} from your config. Run {{ authCommand }} to re-auth this account."
             noAccountsInConfig: "No accounts found in your config. Run {{ authCommand }} to configure a HubSpot account with the CLI."
             invalidProjectComponents: "Projects cannot contain both private and public apps. Move your apps to separate projects before attempting local development."
             noRunnableComponents: "No supported components were found in this project. Run {{ command }} to see a list of available components and add one to your project."
-            invalidUnifiedAppsAccount: "Local development of Unified Apps is currently only supported in standard and developer accounts. Target a standard or developer account with {{ authCommand }} and try again."
+            accountNotCombined: "Local development of Unified Apps is currently only compatible with accounts that are opted into the unified apps beta. Make sure that this account is opted in or switch accounts using {{ accountUseCommand }}."
           examples:
             default: "Start local dev for the current project"
+          options:
+            profile:
+              describe: "The profile to target during local dev"
         create:
           describe: "Create a new project."
           errors:
@@ -707,6 +694,7 @@ en:
             buildIdDoesNotExist: "Build {{ buildId }} does not exist for project {{ projectName }}. {{ linkToProject }}"
             buildAlreadyDeployed: "Build {{ buildId }} is already deployed. {{ linkToProject}}"
             viewProjectsBuilds: 'View project builds in HubSpot'
+            deployContainsRemovals: "- This deploy would remove the {{#bold}}{{ componentName }}{{/bold}} component. To proceed, run the deploy command with the {{ forceFlag }} flag"
           examples:
             default: "Deploy the latest build of the current project"
             withOptions: "Deploy build 5 of the project my-project"
@@ -715,6 +703,10 @@ en:
               describe: "Project build ID to be deployed"
             project:
               describe: "Project name"
+            profile:
+              describe: "The profile to target with this deploy"
+            force:
+              describe: "Skip warnings and force deploy. Use this carefully as it will bypass warnings for destructive actions."
         listBuilds:
           describe: "List the project's builds."
           continueOrExitPrompt: "Press <enter> to load more, or ctrl+c to exit"
@@ -782,6 +774,8 @@ en:
               describe: "Automatically create project if it does not exist"
             message:
               describe: "Add a message when you upload your project and create a build"
+            profile:
+              describe: "The profile to target with this upload"
         watch:
           describe: "Watch your local project for changes and automatically upload changed files to a new build in HubSpot."
           examples:
@@ -841,18 +835,10 @@ en:
             default: "Opens the projects page for the specified account"
           success: "Successfully opened \"{{ projectName }}\""
         feedback:
-          describe: "Leave feedback on HubSpot projects or file a bug report."
-          feedbackType:
-            prompt: "What type of feedback would you like to leave?"
-            bug: "[--bug] Report a bug"
-            general: "[--general] Tell us about your experience with HubSpot's developer tools"
-          openPrompt: "Create a Github issue in your browser?"
+          describe: "Leave feedback or file a bug report."
+          openPrompt: "Open the feedback form in your browser?"
           success: "We opened {{ url }} in your browser."
-          options:
-            bug:
-              describe: "Open Github issues in your browser to report a bug."
-            general:
-              describe: "Open Github issues in your browser to give feedback."
+          error: "Navigate to {{ url }} to leave feedback."
         installDeps:
           help:
             describe: "Install the dependencies for your project, or add a dependency to a subcomponent of a project."
@@ -867,14 +853,6 @@ en:
           noProjectConfig: "No project detected. Run this command from a project directory."
           noPackageJsonInProject: "No dependencies to install. The project {{ projectName }} folder might be missing component or subcomponent files. {{ link }}"
           packageManagerNotInstalled: "This command depends on {{ packageManager }}, install {{#bold}}{{ link }}{{/bold}}"
-    remove:
-      describe: "Delete a file or folder from HubSpot."
-      deleted: "Deleted \"{{ path }}\" from account {{ accountId }}"
-      errors:
-        deleteFailed: "Deleting \"{{ path }}\" from account {{ accountId }} failed"
-      positionals:
-        path:
-          describe: "Remote hubspot path"
     sandbox:
       describe: "Commands for managing sandboxes."
       subcommands:
@@ -972,144 +950,6 @@ en:
           success:
             update: "The secret \"{{ secretName }}\" was updated in the HubSpot account: {{ accountIdentifier }}"
             updateExplanation: "Existing serverless functions will start using this new value within 10 seconds."
-    theme:
-      describe: "Commands for managing themes."
-      subcommands:
-        generateSelectors:
-          describe: "Automatically generates an editor-preview.json file for the given theme. The selectors this command generates are not perfect, so please edit editor-preview.json after running."
-          errors:
-            invalidPath: "Could not find directory \"{{ themePath }}\""
-            fieldsNotFound: "Unable to find theme's fields.json."
-            noSelectorsFound: "No selectors found."
-          success: "Selectors generated for {{ themePath }}, please double check the selectors generated at {{ selectorsPath }} before uploading the theme."
-          positionals:
-            path:
-              describe: "The path of the theme you'd like to generate an editor-preview.json for."
-        marketplaceValidate:
-          describe: "Validate a theme for the marketplace."
-          errors:
-            invalidPath: "The path \"{{ path }}\" is not a path to a folder in the Design Manager"
-          logs:
-            validatingTheme: "Validating theme \"{{ path }}\" \n"
-          results:
-            required: "Required validation results:"
-            recommended: "Recommended validation results:"
-            warnings:
-              file: "File: {{ file }}"
-              lineNumber: "Line number: {{ line }}"
-            noErrors: "No errors"
-          positionals:
-            path:
-              describe: "Path to the theme within the Design Manager."
-        preview:
-          describe: "Upload and watch a theme directory on your computer for changes and start a local development server to preview theme changes on a site."
-          errors:
-            invalidPath: "The path \"{{ path }}\" is not a path to a directory"
-            noThemeComponents: "Your project has no theme components available to preview."
-          positionals:
-            src:
-              describe: "Path to the local directory your theme is in, relative to your current working directory"
-            dest:
-              describe: "Path in HubSpot Design Tools. Can be a net new path. If you wish to preview a site page using your theme changes it must match the path of the theme used by the site."
-          options:
-            notify:
-              describe: "Log to specified file when a watch task is triggered and after workers have gone idle. Ex. --notify path/to/file"
-            noSsl:
-              describe: "Disable HTTPS"
-            port:
-              describe: "The port on which to start the local server"
-          initialUploadProgressBar:
-            start: "Starting..."
-            uploading: "Uploading..."
-            finish: "Complete!"
-          logs:
-            processExited: "Stopping dev server..."
-    module:
-      describe: "Commands for working with modules, including marketplace validation with the marketplace-validate subcommand."
-      subcommands:
-        marketplaceValidate:
-          describe: "Validate a module for the marketplace. Make sure to include the suffix .module in the path to the module within the Design Manager."
-          errors:
-            invalidPath: "The path \"{{ path }}\" is not a path to a module within the Design Manager."
-          logs:
-            validatingModule: "Validating module \"{{ path }}\" \n"
-          options:
-            json:
-              describe: "Output raw json data"
-          results:
-            required: "Required validation results:"
-            recommended: "Recommended validation results:"
-            warnings:
-              file: "File: {{ file }}"
-              lineNumber: "Line number: {{ line }}"
-            noErrors: "No errors"
-          positionals:
-            src:
-              describe: "Path to the module within the Design Manager."
-    upload:
-      describe: "Upload a folder or file from your computer to the HubSpot CMS."
-      errors:
-        destinationRequired: "A destination path needs to be passed"
-        fileIgnored: "The file \"{{ path }}\" is being ignored via an .hsignore rule"
-        invalidPath: "The path \"{{ path }}\" is not a path to a file or folder"
-        uploadFailed: "Uploading file \"{{ src }}\" to \"{{ dest }}\" failed"
-        someFilesFailed: "One or more files failed to upload to \"{{ dest }}\" in the Design Manager"
-        deleteFailed: "Deleting \"{{ path }}\" from account {{ accountId }} failed"
-      options:
-        options:
-          describe: "Options to pass to javascript fields files"
-        saveOutput:
-          describe: "If true, saves all output from javascript fields files as 'fields.output.json'."
-        convertFields:
-          describe: "If true, converts any javascript fields files contained in module folder or project root."
-        clean:
-          describe: "Will delete the destination directory and its contents before uploading. This will also clear the global content associated with any global partial templates and modules."
-        force:
-          describe: "Skips confirmation prompts when doing a clean upload."
-      previewUrl: "To preview this theme, visit: {{ previewUrl }}"
-      positionals:
-        src:
-          describe: "Path to the local file, relative to your current working directory."
-        dest:
-          describe: "Path in HubSpot Design Tools, can be a net new path."
-      success:
-        fileUploaded: "Uploaded file from \"{{ src }}\" to \"{{ dest }}\" in the Design Manager of account {{ accountId }}"
-        uploadComplete: "Uploading files to \"{{ dest }}\" in the Design Manager is complete"
-      uploading: "Uploading files from \"{{ src }}\" to \"{{ dest }}\" in the Design Manager of account {{ accountId }}"
-      notUploaded: "There was an error processing \"{{ src }}\". The file has not been uploaded."
-      cleaning: "Removing \"{{ filePath }}\" from account {{ accountId }} and uploading local..."
-      confirmCleanUpload: "You are about to delete the directory \"{{ filePath }}\" and its contents on HubSpot account {{ accountId }} before uploading. This will also clear the global content associated with any global partial templates and modules. Are you sure you want to do this?"
-    watch:
-      describe: "Watch a directory on your computer for changes and upload the changed files to the HubSpot CMS."
-      errors:
-        folderFailed: "Initial uploading of folder \"{{ src }}\" to \"{{ dest }}\" in account {{ accountId }} had failures"
-        fileFailed: "Upload of file \"{{ file }}\" to \"{{ dest }}\" in account {{ accountId }} failed"
-        destinationRequired: "A destination directory needs to be passed"
-        invalidPath: "The \"{{ path }}\" is not a path to a directory"
-      options:
-        disableInitial:
-          describe: "Disable the initial upload when watching a directory (default)"
-        initialUpload:
-          describe: "Upload directory before watching for updates"
-        notify:
-          describe: "Log to specified file when a watch task is triggered and after workers have gone idle. Ex. --notify path/to/file"
-        remove:
-          describe: "Will cause watch to delete files in your HubSpot account that are not found locally."
-        convertFields:
-          describe: "If true, converts any javascript fields files contained in module folder or project root."
-        saveOutput:
-          describe: "If true, saves all output from javascript fields files as 'fields.output.json'."
-        options:
-          describe: "Options to pass to javascript fields files"
-      positionals:
-        src:
-          describe: "Path to the local directory your files are in, relative to your current working directory"
-        dest:
-          describe: "Path in HubSpot Design Tools. Can be a net new path"
-      warnings:
-        disableInitial: "Passing the \"--disable-initial\" option is no longer necessary. Running \"hs watch\" no longer uploads the watched directory by default."
-        initialUpload: "To upload the directory run \"hs upload\" beforehand or add the \"--initial-upload\" option when running \"hs watch\"."
-        notUploaded: "The \"hs watch\" command no longer uploads the watched directory when started. The directory \"{{ path }}\" was not uploaded."
     convertFields:
       describe: "Converts a specific JavaScript fields file of a module or theme to JSON."
       positionals:
@@ -1196,7 +1036,7 @@ en:
         errors:
           noProjectsInConfig: "Unable to find any projects in the target repository's config.json file. Please ensure that there is a \"projects\" array in the config file."
           missingConfigFileTemplateSource: "Failed to fetch the config.json file from the target repository. Please ensure that there is a valid config.json file at the root of the repository and try again."
-          missingPropertiesInConfig: "Found misconfigured projects in the target repository's config.json file. Please ensure that each project in the target repository's config.json file contains the following properties: [\"name\", \"label\", \"path\", \"insertPath\"]."
+          missingPropertiesInConfig: "Found misconfigured projects in the target repository's config.json file. Please ensure that each project in the target repository's config.json file contains the following properties: [\"name\", \"label\", \"path\"]."
       validateProjectConfig:
         configNotFound: "Unable to locate a project configuration file. Try running again from a project directory, or run {{ createCommand }} to create a new project."
         configMissingFields: "The project configuration file is missing required fields."
@@ -1212,19 +1052,6 @@ en:
       logFeedbackMessage:
         feedbackHeader: "We'd love to hear your feedback!"
         feedbackMessage: "How are you liking the new projects and developer tools? \n > Run `{{#yellow}}hs feedback{{/yellow}}` to let us know what you think!\n"
-    projectBuildAndDeploy:
-      makePollTaskStatusFunc:
-        componentCountSingular: "Found 1 component in this project"
-        componentCount: "Found {{ numComponents }} components in this project"
-        successStatusText: "DONE"
-        failedStatusText: "FAILED"
-        errorFetchingTaskStatus: "An error occurred while fetching the status of the current {{ taskType }}. For more information, view this project in HubSpot by running {{ openCommand }}."
-      pollBuildAutodeployStatusError: "Error fetching autodeploy status for build #{{ buildId }}"
-      pollProjectBuildAndDeploy:
-        buildSucceededAutomaticallyDeploying: "Build #{{ buildId }} succeeded. {{#bold}}Automatically deploying{{/bold}} to {{ accountIdentifier }}\n"
-        cleanedUpTempFile: "Cleaned up temporary file {{ path }}"
-        viewDeploys: "View all deploys for this project in HubSpot"
-        unableToFindAutodeployStatus: "Unable to find the auto deploy for build #{{ buildId }}. This deploy may have been skipped. {{ viewDeploysLink }}."
     projectUpload:
       uploadProjectFiles:
         add: "Uploading {{#bold}}{{ projectName }}{{/bold}} project files to {{ accountIdentifier }}"
@@ -1270,6 +1097,9 @@ en:
           feedbackCommand:
             command: "hs feedback"
             message: "Run {{ command }} to report a bug or leave feedback"
+          getStartedCommand:
+            command: "hs get-started"
+            message: "Run {{ command }} to get started with HubSpot development"
           helpCommand:
             command: "hs help"
             message: "Run {{ command }} to see a list of available commands"
@@ -1287,7 +1117,7 @@ en:
             message: "Run {{ command }} to upload your project to your HubSpot account"
           projectDevCommand:
             command: "hs project dev"
-            message: "Run {{ command }} to set up your test environment and start local development"
+            message: "Run {{ command }} from within your project directory to set up your test environment and start local development"
           projectInstallDepsCommand:
             command: "hs project install-deps"
             message: "Run {{ command }} to install dependencies for your project components"
@@ -1328,13 +1158,6 @@ en:
           describe: "Use environment variable config"
         debug:
           describe: "Set log level to debug"
-    configMigrate:
-      migrateConfigPrompt: "Migrate config?\n From deprecated config file: {{ deprecatedConfigPath }}\n To new global config file: {{ globalConfigPath }}\n (This action will delete the deprecated config file).\n"
-      mergeConfigConflictPrompt: "Change the {{ property }} property in the global config from {{ newValue }} to {{ oldValue }}?"
-      mergeConfigsPrompt: "Two config files detected. Merge them?\n Deprecated config file: {{ deprecatedConfigPath }}\n Global config: {{ globalConfigPath }}\n (This action will delete the deprecated config file).\n"
-      migrationSuccess: "The deprecated config file has been migrated to the new global config file at {{ globalConfigPath }}."
-      mergeSuccess: "The deprecated config file has been merged with the global config file at {{ globalConfigPath }}."
-      skippedExistingAccounts: "\nThe following accounts were not merged, because they already exist in the global config: {{ skippedAccountIds }}.\n"
     prompts:
       projectDevTargetAccountPrompt:
         createNewSandboxOption: "<Test on a new development sandbox>"
@@ -1423,7 +1246,7 @@ en:
           invalidCharacters: "The selected destination contains invalid characters. Please provide a new path and try again."
           invalidTemplate: "[--template] Could not find template \"{{ template }}\". Please choose an available template:"
           projectTemplateRequired: "Project template is required when projectTemplates is provided"
-      selectPublicAppPrompt:
+      selectPublicAppForMigrationPrompt:
         selectAppIdMigrate: "[--appId] Choose an app under {{ accountName }} to migrate:"
         selectAppIdClone: "[--appId] Choose an app under {{ accountName }} to clone:"
         errors:
@@ -1446,8 +1269,8 @@ en:
           nameRequired: "A component name is required"
           invalidType: "[--type] Could not find type \"{{ type }}\". Please choose an available type:"
       secretPrompt:
-        enterValue: "Enter a value for your secret: "
-        enterName: "Enter a name for your secret: "
+        enterValue: "Enter a value for the secret: "
+        enterName: "Enter the name of the secret to add: "
         selectSecretUpdate: "Select the secret you want to update"
         selectSecretDelete: "Select the secret you want to delete"
         errors:
@@ -1478,12 +1301,6 @@ en:
         errors:
           srcRequired: "You must specify a source directory."
           destRequired: "You must specify a destination directory."
-      installPublicAppPrompt:
-        explanation: "Local development requires this app to be installed in the target test account"
-        reinstallExplanation: "This app's required scopes have been updated since it was last installed on the target test account. To avoid issues with local development, we recommend reinstalling the app with the updated scopes."
-        prompt: "Open HubSpot to install this app?"
-        reinstallPrompt: "Open HubSpot to reinstall this app?"
-        decline: "To continue local development of this app, install it in your target test account and re-run {{#bold}}`hs project dev`{{/bold}}"
       selectHubDBTablePrompt:
         selectTable: "Select a HubDB table:"
         enterDest: "Enter the destination path:"

package/lib/accountTypes.js

@@ -39,6 +39,5 @@ async function isUnifiedAccount(account) {
     if (!accountId) {
         return false;
     }
-    const isUngatedForUnifiedApps = await (0, hasFeature_1.hasFeature)(accountId, constants_1.FEATURES.UNIFIED_APPS);
-    return isStandardAccount(account) && isUngatedForUnifiedApps;
+    return (0, hasFeature_1.hasFeature)(accountId, constants_1.FEATURES.UNIFIED_APPS);
 }

package/lib/app/migrate.d.ts

@@ -1,11 +1,34 @@
 import { ArgumentsCamelCase } from 'yargs';
 import { LoadedProjectConfig } from '../projects/config';
+import { MigrationApp, MigrationFailed, MigrationStatus } from '../../api/migrate';
 import { AccountArgs, CommonArgs, ConfigArgs, EnvironmentArgs } from '../../types/Yargs';
 export type MigrateAppArgs = CommonArgs & AccountArgs & EnvironmentArgs & ConfigArgs & {
     name?: string;
     dest?: string;
     appId?: number;
     platformVersion: string;
+    unstable: boolean;
 };
+export declare function getUnmigratableReason(reasonCode: string, projectName: string | undefined, accountId: number): string;
+export declare function generateFilterAppsByProjectNameFunction(projectConfig?: LoadedProjectConfig): (app: MigrationApp) => boolean;
+export declare function buildErrorMessageFromMigrationStatus(error: MigrationFailed): string;
+export declare function fetchMigrationApps(appId: MigrateAppArgs['appId'], derivedAccountId: number, platformVersion: string, projectConfig?: LoadedProjectConfig): Promise<MigrationApp[]>;
+export declare function promptForAppToMigrate(allApps: MigrationApp[], derivedAccountId: number): Promise<number>;
+export declare function selectAppToMigrate(allApps: MigrationApp[], derivedAccountId: number, appId?: number): Promise<{
+    proceed: boolean;
+    appIdToMigrate?: number;
+}>;
+export declare function handleMigrationSetup(derivedAccountId: number, options: ArgumentsCamelCase<MigrateAppArgs>, projectConfig?: LoadedProjectConfig): Promise<{
+    appIdToMigrate?: number | undefined;
+    projectName?: string;
+    projectDest?: string;
+}>;
+export declare function beginMigration(derivedAccountId: number, appId: number, platformVersion: string): Promise<{
+    migrationId: number;
+    uidMap: Record<string, string>;
+} | undefined>;
+export declare function pollMigrationStatus(derivedAccountId: number, migrationId: number, successStates?: string[]): Promise<MigrationStatus>;
+export declare function finalizeMigration(derivedAccountId: number, migrationId: number, uidMap: Record<string, string>, projectName: string): Promise<number>;
+export declare function downloadProjectFiles(derivedAccountId: number, projectName: string, buildId: number, projectDest: string, projectConfig?: LoadedProjectConfig): Promise<void>;
 export declare function migrateApp2025_2(derivedAccountId: number, options: ArgumentsCamelCase<MigrateAppArgs>, projectConfig?: LoadedProjectConfig): Promise<void>;
 export declare function logInvalidAccountError(): void;

package/lib/app/migrate.js

@@ -3,6 +3,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUnmigratableReason = getUnmigratableReason;
+exports.generateFilterAppsByProjectNameFunction = generateFilterAppsByProjectNameFunction;
+exports.buildErrorMessageFromMigrationStatus = buildErrorMessageFromMigrationStatus;
+exports.fetchMigrationApps = fetchMigrationApps;
+exports.promptForAppToMigrate = promptForAppToMigrate;
+exports.selectAppToMigrate = selectAppToMigrate;
+exports.handleMigrationSetup = handleMigrationSetup;
+exports.beginMigration = beginMigration;
+exports.pollMigrationStatus = pollMigrationStatus;
+exports.finalizeMigration = finalizeMigration;
+exports.downloadProjectFiles = downloadProjectFiles;
 exports.migrateApp2025_2 = migrateApp2025_2;
 exports.logInvalidAccountError = logInvalidAccountError;
 const path_1 = __importDefault(require("path"));
@@ -43,7 +54,7 @@ function getUnmigratableReason(reasonCode, projectName, accountId) {
             return en_1.lib.migrate.errors.unmigratableReasons.generic(reasonCode);
     }
 }
-function filterAppsByProjectName(projectConfig) {
+function generateFilterAppsByProjectNameFunction(projectConfig) {
     return (app) => {
         if (projectConfig) {
             return app.projectName === projectConfig?.projectConfig?.name;
@@ -65,8 +76,8 @@ function buildErrorMessageFromMigrationStatus(error) {
 }
 async function fetchMigrationApps(appId, derivedAccountId, platformVersion, projectConfig) {
     const { data: { migratableApps, unmigratableApps }, } = await (0, migrate_1.listAppsForMigration)(derivedAccountId, platformVersion);
-    const filteredMigratableApps = migratableApps.filter(filterAppsByProjectName(projectConfig));
-    const filteredUnmigratableApps = unmigratableApps.filter(filterAppsByProjectName(projectConfig));
+    const filteredMigratableApps = migratableApps.filter(generateFilterAppsByProjectNameFunction(projectConfig));
+    const filteredUnmigratableApps = unmigratableApps.filter(generateFilterAppsByProjectNameFunction(projectConfig));
     const allApps = [...filteredMigratableApps, ...filteredUnmigratableApps];
     if (allApps.length > 1 && projectConfig) {
         throw new Error(en_1.lib.migrate.errors.project.multipleApps);
@@ -225,9 +236,21 @@ async function beginMigration(derivedAccountId, appId, platformVersion) {
     if (Object.values(componentsRequiringUids).length !== 0) {
         for (const [componentId, component] of Object.entries(componentsRequiringUids)) {
             const { componentHint, componentType } = component;
-            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)(en_1.lib.migrate.prompt.uidForComponent(componentHint
-                ? `${(0, transform_1.mapToUserFacingType)(componentType)} '${componentHint}'`
-                : (0, transform_1.mapToUserFacingType)(componentType)), {
+            // Extract the internal ID from the base64-encoded ComponentExternalId
+            let internalId;
+            try {
+                const decoded = Buffer.from(componentId, 'base64').toString('utf8');
+                const parts = decoded.split('$$');
+                internalId = parts[1] || componentId;
+            }
+            catch {
+                // If decoding fails, use the componentId as the internalId
+                internalId = componentId;
+            }
+            const promptText = componentHint
+                ? `${(0, transform_1.mapToUserFacingType)(componentType)} '${componentHint}' (ID: ${internalId})`
+                : `${(0, transform_1.mapToUserFacingType)(componentType)} (ID: ${internalId})`;
+            uidMap[componentId] = await (0, promptUtils_1.inputPrompt)(en_1.lib.migrate.prompt.uidForComponent(promptText), {
                 validate: (uid) => {
                     const result = (0, project_parsing_lib_1.validateUid)(uid);
                     return result === undefined ? true : result;

package/lib/app/migrate_legacy.js

@@ -17,7 +17,7 @@ const exitCodes_1 = require("../enums/exitCodes");
 const ui_1 = require("../ui");
 const lang_1 = require("../lang");
 const accountTypes_1 = require("../accountTypes");
-const selectPublicAppPrompt_1 = require("../prompts/selectPublicAppPrompt");
+const selectPublicAppForMigrationPrompt_1 = require("../prompts/selectPublicAppForMigrationPrompt");
 const createProjectPrompt_1 = require("../prompts/createProjectPrompt");
 const ensureProjectExists_1 = require("../projects/ensureProjectExists");
 const usageTracking_1 = require("../usageTracking");
@@ -30,11 +30,11 @@ async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
     const defaultAccountIsUnified = await (0, accountTypes_1.isUnifiedAccount)(accountConfig);
     if (!(0, accountTypes_1.isAppDeveloperAccount)(accountConfig) && !defaultAccountIsUnified) {
         (0, migrate_1.logInvalidAccountError)();
-        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
     }
     let appId = options.appId;
     if (!appId) {
-        const { appId: selectAppId } = await (0, selectPublicAppPrompt_1.selectPublicAppPrompt)({
+        const { appId: selectAppId } = await (0, selectPublicAppForMigrationPrompt_1.selectPublicAppForMigrationPrompt)({
             accountId: derivedAccountId,
             accountName,
             isMigratingApp: true,
@@ -51,12 +51,12 @@ async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
             logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.invalidApp`, {
                 appId,
             }));
-            process.exit(exitCodes_1.EXIT_CODES.ERROR);
+            return process.exit(exitCodes_1.EXIT_CODES.ERROR);
         }
     }
     catch (error) {
         (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
-        process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        return process.exit(exitCodes_1.EXIT_CODES.ERROR);
     }
     const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(options);
     const { name: projectName, dest: projectDest } = createProjectPromptResponse;
@@ -86,7 +86,7 @@ async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
     });
     process.stdin.resume();
     if (!shouldCreateApp) {
-        process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
     }
     try {
         SpinniesManager_1.default.init();
@@ -97,7 +97,7 @@ async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
             if ((key.ctrl && key.name === 'c') || key.name === 'q') {
                 SpinniesManager_1.default.remove('migrateApp');
                 logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationInterrupted`));
-                process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+                return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
             }
         });
         const { data: migrateResponse } = await (0, projects_1.migrateApp)(derivedAccountId, appId, projectName);

package/lib/app/urls.d.ts

@@ -0,0 +1,16 @@
+import { Environment } from '@hubspot/local-dev-lib/types/Config';
+type PrivateAppInstallUrlArgs = {
+    targetAccountId: number;
+    env: Environment;
+    appId: string;
+};
+type PublicAppInstallUrlArgs = {
+    targetAccountId: number;
+    env: Environment;
+    clientId: string;
+    scopes: string[];
+    redirectUrls: string[];
+};
+export declare function getOauthAppInstallUrl({ targetAccountId, env, clientId, scopes, redirectUrls, }: PublicAppInstallUrlArgs): string;
+export declare function getStaticAuthAppInstallUrl({ targetAccountId, env, appId, }: PrivateAppInstallUrlArgs): string;
+export {};

package/lib/app/urls.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOauthAppInstallUrl = getOauthAppInstallUrl;
+exports.getStaticAuthAppInstallUrl = getStaticAuthAppInstallUrl;
+const urls_1 = require("@hubspot/local-dev-lib/urls");
+function getOauthAppInstallUrl({ targetAccountId, env, clientId, scopes, redirectUrls, }) {
+    const websiteOrigin = (0, urls_1.getHubSpotWebsiteOrigin)(env);
+    return (`${websiteOrigin}/oauth/${targetAccountId}/authorize` +
+        `?client_id=${encodeURIComponent(clientId)}` +
+        `&scope=${encodeURIComponent(scopes.join(' '))}` +
+        `&redirect_uri=${encodeURIComponent(redirectUrls[0])}`);
+}
+function getStaticAuthAppInstallUrl({ targetAccountId, env, appId, }) {
+    const websiteOrigin = (0, urls_1.getHubSpotWebsiteOrigin)(env);
+    return `${websiteOrigin}/static-token/${targetAccountId}/authorize?appId=${appId}`;
+}

package/lib/commonOpts.d.ts

@@ -16,9 +16,7 @@ export declare function setLogLevel(options: Arguments<{
     debug?: boolean;
     networkDebug?: boolean;
 }>): void;
-export declare function getCommandName(argv: Arguments<{
-    _?: string[];
-}>): string;
+export declare function getCommandName(argv: Arguments): string;
 export declare function getCmsPublishMode(options: Arguments<{
     cmsPublishMode?: CmsPublishMode;
     derivedAccountId?: number;

package/lib/commonOpts.js

@@ -138,7 +138,7 @@ function setLogLevel(options) {
     }
 }
 function getCommandName(argv) {
-    return (argv && argv._ && argv._[0]) || '';
+    return String(argv && argv._ && argv._[0]) || '';
 }
 function getCmsPublishMode(options) {
     // 1. --cmsPublishMode

package/lib/configMigrate.d.ts

@@ -1,2 +1,2 @@
-export declare function handleMigration(accountId: number | undefined, configPath?: string): Promise<boolean>;
-export declare function handleMerge(accountId: number | undefined, configPath?: string, force?: boolean): Promise<boolean>;
+export declare function handleMigration(deprecatedConfigPath?: string, hideWarning?: boolean): Promise<boolean>;
+export declare function handleMerge(deprecatedConfigPath?: string, force?: boolean, hideWarning?: boolean): Promise<boolean>;