@hubspot/cli 7.7.0-experimental.3 → 7.7.0

package/lib/app/migrate_legacy.js

@@ -1,40 +1,34 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.migrateApp2023_2 = migrateApp2023_2;
-const appsDev_1 = require("@hubspot/local-dev-lib/api/appsDev");
-const logger_1 = require("@hubspot/local-dev-lib/logger");
-const projects_1 = require("@hubspot/local-dev-lib/api/projects");
-const path_1 = __importDefault(require("path"));
-const path_2 = require("@hubspot/local-dev-lib/path");
-const urls_1 = require("@hubspot/local-dev-lib/urls");
-const archive_1 = require("@hubspot/local-dev-lib/archive");
-const promptUtils_1 = require("../prompts/promptUtils");
-const errorHandlers_1 = require("../errorHandlers");
-const exitCodes_1 = require("../enums/exitCodes");
-const ui_1 = require("../ui");
-const lang_1 = require("../lang");
-const accountTypes_1 = require("../accountTypes");
-const selectPublicAppForMigrationPrompt_1 = require("../prompts/selectPublicAppForMigrationPrompt");
-const createProjectPrompt_1 = require("../prompts/createProjectPrompt");
-const ensureProjectExists_1 = require("../projects/ensureProjectExists");
-const usageTracking_1 = require("../usageTracking");
-const SpinniesManager_1 = __importDefault(require("../ui/SpinniesManager"));
-const process_1 = require("../process");
-const polling_1 = require("../polling");
-const migrate_1 = require("./migrate");
-async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
-    const accountName = (0, ui_1.uiAccountDescription)(derivedAccountId);
-    const defaultAccountIsUnified = await (0, accountTypes_1.isUnifiedAccount)(accountConfig);
-    if (!(0, accountTypes_1.isAppDeveloperAccount)(accountConfig) && !defaultAccountIsUnified) {
-        (0, migrate_1.logInvalidAccountError)();
-        return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+import { fetchPublicAppMetadata } from '@hubspot/local-dev-lib/api/appsDev';
+import { logger } from '@hubspot/local-dev-lib/logger';
+import { checkMigrationStatus, downloadProject, migrateApp as migrateNonProjectApp_v2023_2, } from '@hubspot/local-dev-lib/api/projects';
+import path from 'path';
+import { getCwd, sanitizeFileName } from '@hubspot/local-dev-lib/path';
+import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
+import { extractZipArchive } from '@hubspot/local-dev-lib/archive';
+import { promptUser } from '../prompts/promptUtils.js';
+import { ApiErrorContext, logError } from '../errorHandlers/index.js';
+import { EXIT_CODES } from '../enums/exitCodes.js';
+import { uiAccountDescription, uiLine, uiLink } from '../ui/index.js';
+import { i18n } from '../lang.js';
+import { isAppDeveloperAccount, isUnifiedAccount } from '../accountTypes.js';
+import { selectPublicAppForMigrationPrompt } from '../prompts/selectPublicAppForMigrationPrompt.js';
+import { projectNameAndDestPrompt } from '../prompts/projectNameAndDestPrompt.js';
+import { ensureProjectExists } from '../projects/ensureProjectExists.js';
+import { trackCommandMetadataUsage } from '../usageTracking.js';
+import SpinniesManager from '../ui/SpinniesManager.js';
+import { handleKeypress } from '../process.js';
+import { poll } from '../polling.js';
+import { logInvalidAccountError } from './migrate.js';
+export async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
+    const accountName = uiAccountDescription(derivedAccountId);
+    const defaultAccountIsUnified = await isUnifiedAccount(accountConfig);
+    if (!isAppDeveloperAccount(accountConfig) && !defaultAccountIsUnified) {
+        logInvalidAccountError();
+        return process.exit(EXIT_CODES.SUCCESS);
     }
     let appId = options.appId;
     if (!appId) {
-        const { appId: selectAppId } = await (0, selectPublicAppForMigrationPrompt_1.selectPublicAppForMigrationPrompt)({
+        const { appId: selectAppId } = await selectPublicAppForMigrationPrompt({
             accountId: derivedAccountId,
             accountName,
             isMigratingApp: true,
@@ -42,89 +36,88 @@ async function migrateApp2023_2(derivedAccountId, options, accountConfig) {
         appId = selectAppId;
     }
     try {
-        const { data: selectedApp } = await (0, appsDev_1.fetchPublicAppMetadata)(appId, derivedAccountId);
+        const { data: selectedApp } = await fetchPublicAppMetadata(appId, derivedAccountId);
         // preventProjectMigrations returns true if we have not added app to allowlist config.
         // listingInfo will only exist for marketplace apps
         const preventProjectMigrations = selectedApp.preventProjectMigrations;
         const listingInfo = selectedApp.listingInfo;
         if (preventProjectMigrations && listingInfo) {
-            logger_1.logger.error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.invalidApp`, {
+            logger.error(i18n(`commands.project.subcommands.migrateApp.errors.invalidApp`, {
                 appId,
             }));
-            return process.exit(exitCodes_1.EXIT_CODES.ERROR);
+            return process.exit(EXIT_CODES.ERROR);
         }
     }
     catch (error) {
-        (0, errorHandlers_1.logError)(error, new errorHandlers_1.ApiErrorContext({ accountId: derivedAccountId }));
-        return process.exit(exitCodes_1.EXIT_CODES.ERROR);
+        logError(error, new ApiErrorContext({ accountId: derivedAccountId }));
+        return process.exit(EXIT_CODES.ERROR);
     }
-    const createProjectPromptResponse = await (0, createProjectPrompt_1.createProjectPrompt)(options);
-    const { name: projectName, dest: projectDest } = createProjectPromptResponse;
-    const { projectExists } = await (0, ensureProjectExists_1.ensureProjectExists)(derivedAccountId, projectName, {
+    const { name: projectName, dest: projectDest } = await projectNameAndDestPrompt(options);
+    const { projectExists } = await ensureProjectExists(derivedAccountId, projectName, {
         allowCreate: false,
         noLogs: true,
     });
     if (projectExists) {
-        throw new Error((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.errors.projectAlreadyExists`, {
+        throw new Error(i18n(`commands.project.subcommands.migrateApp.errors.projectAlreadyExists`, {
             projectName,
         }));
     }
-    await (0, usageTracking_1.trackCommandMetadataUsage)('migrate-app', { step: 'STARTED' }, derivedAccountId);
-    logger_1.logger.log('');
-    (0, ui_1.uiLine)();
-    logger_1.logger.warn(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.title`)}\n`);
-    logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.projectConversion`));
-    logger_1.logger.log(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.appConfig`)}\n`);
-    logger_1.logger.log(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.buildAndDeploy`)}\n`);
-    logger_1.logger.log(`${(0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.existingApps`)}\n`);
-    logger_1.logger.log((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.warning.copyApp`));
-    (0, ui_1.uiLine)();
-    const { shouldCreateApp } = await (0, promptUtils_1.promptUser)({
+    await trackCommandMetadataUsage('migrate-app', { step: 'STARTED' }, derivedAccountId);
+    logger.log('');
+    uiLine();
+    logger.warn(`${i18n(`commands.project.subcommands.migrateApp.warning.title`)}\n`);
+    logger.log(i18n(`commands.project.subcommands.migrateApp.warning.projectConversion`));
+    logger.log(`${i18n(`commands.project.subcommands.migrateApp.warning.appConfig`)}\n`);
+    logger.log(`${i18n(`commands.project.subcommands.migrateApp.warning.buildAndDeploy`)}\n`);
+    logger.log(`${i18n(`commands.project.subcommands.migrateApp.warning.existingApps`)}\n`);
+    logger.log(i18n(`commands.project.subcommands.migrateApp.warning.copyApp`));
+    uiLine();
+    const { shouldCreateApp } = await promptUser({
         name: 'shouldCreateApp',
         type: 'confirm',
-        message: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.createAppPrompt`),
+        message: i18n(`commands.project.subcommands.migrateApp.createAppPrompt`),
     });
     process.stdin.resume();
     if (!shouldCreateApp) {
-        return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+        return process.exit(EXIT_CODES.SUCCESS);
     }
     try {
-        SpinniesManager_1.default.init();
-        SpinniesManager_1.default.add('migrateApp', {
-            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.inProgress`),
+        SpinniesManager.init();
+        SpinniesManager.add('migrateApp', {
+            text: i18n(`commands.project.subcommands.migrateApp.migrationStatus.inProgress`),
         });
-        (0, process_1.handleKeypress)(async (key) => {
+        handleKeypress(async (key) => {
             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`));
-                return process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+                SpinniesManager.remove('migrateApp');
+                logger.log(i18n(`commands.project.subcommands.migrateApp.migrationInterrupted`));
+                return process.exit(EXIT_CODES.SUCCESS);
             }
         });
-        const { data: migrateResponse } = await (0, projects_1.migrateApp)(derivedAccountId, appId, projectName);
+        const { data: migrateResponse } = await migrateNonProjectApp_v2023_2(derivedAccountId, appId, projectName);
         const { id } = migrateResponse;
-        const pollResponse = await (0, polling_1.poll)(() => (0, projects_1.checkMigrationStatus)(derivedAccountId, id));
+        const pollResponse = await poll(() => checkMigrationStatus(derivedAccountId, id));
         const { status, project } = pollResponse;
         if (status === 'SUCCESS') {
-            const absoluteDestPath = path_1.default.resolve((0, path_2.getCwd)(), projectDest);
+            const absoluteDestPath = path.resolve(getCwd(), projectDest);
             const { env } = accountConfig;
-            const baseUrl = (0, urls_1.getHubSpotWebsiteOrigin)(env);
-            const { data: zippedProject } = await (0, projects_1.downloadProject)(derivedAccountId, projectName, 1);
-            await (0, archive_1.extractZipArchive)(zippedProject, (0, path_2.sanitizeFileName)(projectName), path_1.default.resolve(absoluteDestPath), { includesRootDir: true, hideLogs: true });
-            SpinniesManager_1.default.succeed('migrateApp', {
-                text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.done`),
+            const baseUrl = getHubSpotWebsiteOrigin(env);
+            const { data: zippedProject } = await downloadProject(derivedAccountId, projectName, 1);
+            await extractZipArchive(zippedProject, sanitizeFileName(projectName), path.resolve(absoluteDestPath), { includesRootDir: true, hideLogs: true });
+            SpinniesManager.succeed('migrateApp', {
+                text: i18n(`commands.project.subcommands.migrateApp.migrationStatus.done`),
                 succeedColor: 'white',
             });
-            logger_1.logger.log('');
-            (0, ui_1.uiLine)();
-            logger_1.logger.success((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.success`));
-            logger_1.logger.log('');
-            logger_1.logger.log((0, ui_1.uiLink)((0, lang_1.i18n)(`commands.project.subcommands.migrateApp.projectDetailsLink`), `${baseUrl}/developer-projects/${derivedAccountId}/project/${encodeURIComponent(project.name)}`));
-            process.exit(exitCodes_1.EXIT_CODES.SUCCESS);
+            logger.log('');
+            uiLine();
+            logger.success(i18n(`commands.project.subcommands.migrateApp.migrationStatus.success`));
+            logger.log('');
+            logger.log(uiLink(i18n(`commands.project.subcommands.migrateApp.projectDetailsLink`), `${baseUrl}/developer-projects/${derivedAccountId}/project/${encodeURIComponent(project.name)}`));
+            process.exit(EXIT_CODES.SUCCESS);
         }
     }
     catch (error) {
-        SpinniesManager_1.default.fail('migrateApp', {
-            text: (0, lang_1.i18n)(`commands.project.subcommands.migrateApp.migrationStatus.failure`),
+        SpinniesManager.fail('migrateApp', {
+            text: i18n(`commands.project.subcommands.migrateApp.migrationStatus.failure`),
             failColor: 'white',
         });
         throw error;

package/lib/app/urls.d.ts

@@ -2,7 +2,7 @@ import { Environment } from '@hubspot/local-dev-lib/types/Config';
 type PrivateAppInstallUrlArgs = {
     targetAccountId: number;
     env: Environment;
-    appId: string;
+    appId: number;
 };
 type PublicAppInstallUrlArgs = {
     targetAccountId: number;

package/lib/app/urls.js

@@ -1,16 +1,12 @@
-"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);
+import { getHubSpotWebsiteOrigin } from '@hubspot/local-dev-lib/urls';
+export function getOauthAppInstallUrl({ targetAccountId, env, clientId, scopes, redirectUrls, }) {
+    const websiteOrigin = 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);
+export function getStaticAuthAppInstallUrl({ targetAccountId, env, appId, }) {
+    const websiteOrigin = getHubSpotWebsiteOrigin(env);
     return `${websiteOrigin}/static-token/${targetAccountId}/authorize?appId=${appId}`;
 }

package/lib/buildAccount.d.ts

@@ -1,11 +1,20 @@
+import { DeveloperTestAccountConfig } from '@hubspot/local-dev-lib/types/developerTestAccounts';
 import { Environment } from '@hubspot/local-dev-lib/types/Config';
 import { CLIAccount } from '@hubspot/local-dev-lib/types/Accounts';
-import { SandboxResponse } from '@hubspot/local-dev-lib/types/Sandbox';
-import { SandboxAccountType } from '../types/Sandboxes';
+import { SandboxResponse, V2Sandbox } from '@hubspot/local-dev-lib/types/Sandbox';
+import { SandboxAccountType } from '../types/Sandboxes.js';
 export declare function saveAccountToConfig(accountId: number | undefined, accountName: string, env: Environment, personalAccessKey?: string, force?: boolean): Promise<string>;
-export declare function buildDeveloperTestAccount(testAccountName: string, parentAccountConfig: CLIAccount, env: Environment, portalLimit: number): Promise<number>;
+export declare function createDeveloperTestAccountV3(parentAccountId: number, testAccountConfig: DeveloperTestAccountConfig): Promise<{
+    accountName: string;
+    accountId?: number;
+    personalAccessKey?: string;
+}>;
+export declare function buildDeveloperTestAccount(testAccountName: string, parentAccountConfig: CLIAccount, env: Environment, portalLimit: number, useV3?: boolean): Promise<number>;
 type SandboxAccount = SandboxResponse & {
     name: string;
 };
 export declare function buildSandbox(sandboxName: string, parentAccountConfig: CLIAccount, sandboxType: SandboxAccountType, env: Environment, force?: boolean): Promise<SandboxAccount>;
+export declare function buildV2Sandbox(sandboxName: string, parentAccountConfig: CLIAccount, sandboxType: SandboxAccountType, syncObjectRecords: boolean, env: Environment, force?: boolean): Promise<{
+    sandbox: V2Sandbox;
+}>;
 export {};

package/lib/buildAccount.js

@@ -1,47 +1,42 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.saveAccountToConfig = saveAccountToConfig;
-exports.buildDeveloperTestAccount = buildDeveloperTestAccount;
-exports.buildSandbox = buildSandbox;
-const personalAccessKey_1 = require("@hubspot/local-dev-lib/personalAccessKey");
-const config_1 = require("@hubspot/local-dev-lib/config");
-const getAccountIdentifier_1 = require("@hubspot/local-dev-lib/config/getAccountIdentifier");
-const logger_1 = require("@hubspot/local-dev-lib/logger");
-const developerTestAccounts_1 = require("@hubspot/local-dev-lib/api/developerTestAccounts");
-const config_2 = require("@hubspot/local-dev-lib/constants/config");
-const sandboxHubs_1 = require("@hubspot/local-dev-lib/api/sandboxHubs");
-const personalAccessKeyPrompt_1 = require("./prompts/personalAccessKeyPrompt");
-const lang_1 = require("./lang");
-const accountNamePrompt_1 = require("./prompts/accountNamePrompt");
-const SpinniesManager_1 = __importDefault(require("./ui/SpinniesManager"));
-const index_1 = require("./errorHandlers/index");
-const sandboxes_1 = require("./sandboxes");
-const developerTestAccounts_2 = require("./developerTestAccounts");
-async function saveAccountToConfig(accountId, accountName, env, personalAccessKey, force = false) {
+import { getAccessToken, updateConfigWithAccessToken, } from '@hubspot/local-dev-lib/personalAccessKey';
+import { accountNameExistsInConfig, updateAccountConfig, writeConfig, getAccountId, } from '@hubspot/local-dev-lib/config';
+import { getAccountIdentifier } from '@hubspot/local-dev-lib/config/getAccountIdentifier';
+import { logger } from '@hubspot/local-dev-lib/logger';
+import { createDeveloperTestAccount, fetchDeveloperTestAccountGateSyncStatus, generateDeveloperTestAccountPersonalAccessKey, } from '@hubspot/local-dev-lib/api/developerTestAccounts';
+import { HUBSPOT_ACCOUNT_TYPES } from '@hubspot/local-dev-lib/constants/config';
+import { createSandbox, createV2Sandbox, getSandboxPersonalAccessKey, } from '@hubspot/local-dev-lib/api/sandboxHubs';
+import { personalAccessKeyPrompt } from './prompts/personalAccessKeyPrompt.js';
+import { createDeveloperTestAccountConfigPrompt } from './prompts/createDeveloperTestAccountConfigPrompt.js';
+import { i18n } from './lang.js';
+import { cliAccountNamePrompt } from './prompts/accountNamePrompt.js';
+import SpinniesManager from './ui/SpinniesManager.js';
+import { debugError, logError } from './errorHandlers/index.js';
+import { SANDBOX_API_TYPE_MAP, SANDBOX_TYPE_MAP_V2, handleSandboxCreateError, } from './sandboxes.js';
+import { handleDeveloperTestAccountCreateError } from './developerTestAccounts.js';
+import { lib } from '../lang/en.js';
+import { poll } from './polling.js';
+export async function saveAccountToConfig(accountId, accountName, env, personalAccessKey, force = false) {
     if (!personalAccessKey) {
-        const configData = await (0, personalAccessKeyPrompt_1.personalAccessKeyPrompt)({
+        const configData = await personalAccessKeyPrompt({
             env,
             account: accountId,
         });
         personalAccessKey = configData.personalAccessKey;
     }
-    const token = await (0, personalAccessKey_1.getAccessToken)(personalAccessKey, env);
-    const updatedConfig = await (0, personalAccessKey_1.updateConfigWithAccessToken)(token, personalAccessKey, env);
+    const token = await getAccessToken(personalAccessKey, env);
+    const updatedConfig = await updateConfigWithAccessToken(token, personalAccessKey, env);
     let validName = updatedConfig?.name || '';
     if (!updatedConfig?.name) {
         const nameForConfig = accountName.toLowerCase().split(' ').join('-');
         validName = nameForConfig;
-        const invalidAccountName = (0, config_1.accountNameExistsInConfig)(nameForConfig);
+        const invalidAccountName = accountNameExistsInConfig(nameForConfig);
         if (invalidAccountName) {
             if (!force) {
-                logger_1.logger.log('');
-                logger_1.logger.warn((0, lang_1.i18n)(`lib.prompts.accountNamePrompt.errors.accountNameExists`, {
+                logger.log('');
+                logger.warn(i18n(`lib.prompts.accountNamePrompt.errors.accountNameExists`, {
                     name: nameForConfig,
                 }));
-                const { name: promptName } = await (0, accountNamePrompt_1.cliAccountNamePrompt)(nameForConfig + `_${accountId}`);
+                const { name: promptName } = await cliAccountNamePrompt(nameForConfig + `_${accountId}`);
                 validName = promptName;
             }
             else {
@@ -50,111 +45,212 @@ async function saveAccountToConfig(accountId, accountName, env, personalAccessKe
             }
         }
     }
-    (0, config_1.updateAccountConfig)({
+    updateAccountConfig({
         ...updatedConfig,
         env: updatedConfig?.env,
         tokenInfo: updatedConfig?.auth?.tokenInfo,
         name: validName,
     });
-    (0, config_1.writeConfig)();
-    logger_1.logger.log('');
+    writeConfig();
+    logger.log('');
     return validName;
 }
-async function buildDeveloperTestAccount(testAccountName, parentAccountConfig, env, portalLimit) {
-    const id = (0, getAccountIdentifier_1.getAccountIdentifier)(parentAccountConfig);
-    const parentAccountId = (0, config_1.getAccountId)(id);
+export async function createDeveloperTestAccountV3(parentAccountId, testAccountConfig) {
+    const result = {
+        accountName: testAccountConfig.accountName,
+    };
+    const { data } = await createDeveloperTestAccount(parentAccountId, testAccountConfig);
+    result.accountId = data.id;
+    try {
+        await poll(() => fetchDeveloperTestAccountGateSyncStatus(parentAccountId, result.accountId), {
+            successStates: ['SUCCESS'],
+            errorStates: [],
+        });
+    }
+    catch (err) {
+        debugError(err);
+        throw new Error(lib.buildAccount.createDeveloperTestAccountV3.syncFailure);
+    }
+    // HACK: The status endpoint sometimes returns an early success status.
+    // Sleep for an extra 5 seconds to make sure the sync is actually complete.
+    await new Promise(resolve => setTimeout(resolve, 5000));
+    try {
+        // Attempt to generate a new personal access key for the test account now that gate sync is complete.
+        const { data } = await generateDeveloperTestAccountPersonalAccessKey(parentAccountId, result.accountId);
+        result.personalAccessKey = data.personalAccessKey;
+    }
+    catch (err) {
+        debugError(err);
+        throw new Error(lib.buildAccount.createDeveloperTestAccountV3.pakFailure);
+    }
+    return result;
+}
+export async function buildDeveloperTestAccount(testAccountName, parentAccountConfig, env, portalLimit, useV3 = false) {
+    const id = getAccountIdentifier(parentAccountConfig);
+    const parentAccountId = getAccountId(id);
+    let testAccountConfig = {
+        accountName: testAccountName,
+    };
     if (!parentAccountId) {
-        throw new Error((0, lang_1.i18n)(`lib.developerTestAccount.create.loading.fail`));
+        throw new Error(i18n(`lib.developerTestAccount.create.loading.fail`));
+    }
+    if (useV3) {
+        testAccountConfig = await createDeveloperTestAccountConfigPrompt({
+            name: testAccountConfig.accountName,
+            description: 'Test Account created by the HubSpot CLI',
+        }, false);
     }
-    SpinniesManager_1.default.init({
+    SpinniesManager.init({
         succeedColor: 'white',
     });
-    logger_1.logger.log('');
-    SpinniesManager_1.default.add('buildDeveloperTestAccount', {
-        text: (0, lang_1.i18n)(`lib.developerTestAccount.create.loading.add`, {
+    logger.log('');
+    SpinniesManager.add('buildDeveloperTestAccount', {
+        text: i18n(`lib.developerTestAccount.create.loading.add`, {
             accountName: testAccountName,
         }),
     });
     let developerTestAccountId;
     let developerTestAccountPersonalAccessKey;
     try {
-        const { data } = await (0, developerTestAccounts_1.createDeveloperTestAccount)(parentAccountId, testAccountName);
-        developerTestAccountId = data.id;
-        developerTestAccountPersonalAccessKey = data.personalAccessKey;
-        SpinniesManager_1.default.succeed('buildDeveloperTestAccount', {
-            text: (0, lang_1.i18n)(`lib.developerTestAccount.create.loading.succeed`, {
+        if (useV3) {
+            const result = await createDeveloperTestAccountV3(parentAccountId, testAccountConfig);
+            developerTestAccountId = result.accountId;
+            developerTestAccountPersonalAccessKey = result.personalAccessKey;
+        }
+        else {
+            const { data } = await createDeveloperTestAccount(parentAccountId, testAccountName);
+            developerTestAccountId = data.id;
+            developerTestAccountPersonalAccessKey = data.personalAccessKey;
+        }
+        SpinniesManager.succeed('buildDeveloperTestAccount', {
+            text: i18n(`lib.developerTestAccount.create.loading.succeed`, {
                 accountName: testAccountName,
                 accountId: developerTestAccountId,
             }),
         });
     }
     catch (e) {
-        (0, index_1.debugError)(e);
-        SpinniesManager_1.default.fail('buildDeveloperTestAccount', {
-            text: (0, lang_1.i18n)(`lib.developerTestAccount.create.loading.fail`, {
+        debugError(e);
+        SpinniesManager.fail('buildDeveloperTestAccount', {
+            text: i18n(`lib.developerTestAccount.create.loading.fail`, {
                 accountName: testAccountName,
             }),
         });
-        (0, developerTestAccounts_2.handleDeveloperTestAccountCreateError)(e, parentAccountId, env, portalLimit);
+        handleDeveloperTestAccountCreateError(e, parentAccountId, env, portalLimit);
     }
     try {
         await saveAccountToConfig(developerTestAccountId, testAccountName, env, developerTestAccountPersonalAccessKey);
     }
     catch (err) {
-        (0, index_1.logError)(err);
+        logError(err);
         throw err;
     }
     return developerTestAccountId;
 }
-async function buildSandbox(sandboxName, parentAccountConfig, sandboxType, env, force = false) {
+export async function buildSandbox(sandboxName, parentAccountConfig, sandboxType, env, force = false) {
     let i18nKey;
-    if (sandboxType === config_2.HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX) {
+    if (sandboxType === HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX) {
         i18nKey = 'lib.sandbox.create.loading.standard';
     }
     else {
         i18nKey = 'lib.sandbox.create.loading.developer';
     }
-    const id = (0, getAccountIdentifier_1.getAccountIdentifier)(parentAccountConfig);
-    const parentAccountId = (0, config_1.getAccountId)(id);
+    const id = getAccountIdentifier(parentAccountConfig);
+    const parentAccountId = getAccountId(id);
     if (!parentAccountId) {
-        throw new Error((0, lang_1.i18n)(`${i18nKey}.fail`));
+        throw new Error(i18n(`${i18nKey}.fail`));
     }
-    SpinniesManager_1.default.init({
+    SpinniesManager.init({
         succeedColor: 'white',
     });
-    logger_1.logger.log('');
-    SpinniesManager_1.default.add('buildSandbox', {
-        text: (0, lang_1.i18n)(`${i18nKey}.add`, {
+    logger.log('');
+    SpinniesManager.add('buildSandbox', {
+        text: i18n(`${i18nKey}.add`, {
             accountName: sandboxName,
         }),
     });
     let sandbox;
     try {
-        const sandboxApiType = sandboxes_1.SANDBOX_API_TYPE_MAP[sandboxType];
-        const { data } = await (0, sandboxHubs_1.createSandbox)(parentAccountId, sandboxName, sandboxApiType);
+        const sandboxApiType = SANDBOX_API_TYPE_MAP[sandboxType];
+        const { data } = await createSandbox(parentAccountId, sandboxName, sandboxApiType);
         sandbox = { name: sandboxName, ...data };
-        SpinniesManager_1.default.succeed('buildSandbox', {
-            text: (0, lang_1.i18n)(`${i18nKey}.succeed`, {
+        SpinniesManager.succeed('buildSandbox', {
+            text: i18n(`${i18nKey}.succeed`, {
                 accountName: sandboxName,
                 accountId: sandbox.sandbox.sandboxHubId,
             }),
         });
     }
     catch (e) {
-        (0, index_1.debugError)(e);
-        SpinniesManager_1.default.fail('buildSandbox', {
-            text: (0, lang_1.i18n)(`${i18nKey}.fail`, {
+        debugError(e);
+        SpinniesManager.fail('buildSandbox', {
+            text: i18n(`${i18nKey}.fail`, {
                 accountName: sandboxName,
             }),
         });
-        (0, sandboxes_1.handleSandboxCreateError)(e, env, sandboxName, parentAccountId);
+        handleSandboxCreateError(e, env, sandboxName, parentAccountId);
     }
     try {
         await saveAccountToConfig(sandbox.sandbox.sandboxHubId, sandboxName, env, sandbox.personalAccessKey, force);
     }
     catch (err) {
-        (0, index_1.logError)(err);
+        logError(err);
         throw err;
     }
     return sandbox;
 }
+export async function buildV2Sandbox(sandboxName, parentAccountConfig, sandboxType, syncObjectRecords, env, force = false) {
+    let i18nKey;
+    if (sandboxType === HUBSPOT_ACCOUNT_TYPES.STANDARD_SANDBOX) {
+        i18nKey = 'lib.sandbox.create.loading.standard';
+    }
+    else {
+        i18nKey = 'lib.sandbox.create.loading.developer';
+    }
+    const id = getAccountIdentifier(parentAccountConfig);
+    const parentAccountId = getAccountId(id);
+    if (!parentAccountId) {
+        throw new Error(i18n(`${i18nKey}.fail`));
+    }
+    SpinniesManager.init({
+        succeedColor: 'white',
+    });
+    logger.log('');
+    SpinniesManager.add('buildV2Sandbox', {
+        text: i18n(`${i18nKey}.add`, {
+            accountName: sandboxName,
+        }),
+    });
+    let sandbox;
+    let pak;
+    try {
+        const sandboxTypeV2 = SANDBOX_TYPE_MAP_V2[sandboxType];
+        const { data } = await createV2Sandbox(parentAccountId, sandboxName, sandboxTypeV2, syncObjectRecords);
+        sandbox = { ...data };
+        const { data: { personalAccessKey }, } = await getSandboxPersonalAccessKey(parentAccountId, sandbox.sandboxHubId);
+        pak = personalAccessKey.encodedOAuthRefreshToken;
+        SpinniesManager.succeed('buildV2Sandbox', {
+            text: i18n(`${i18nKey}.succeed`, {
+                accountName: sandboxName,
+                accountId: sandbox.sandboxHubId,
+            }),
+        });
+    }
+    catch (e) {
+        debugError(e);
+        SpinniesManager.fail('buildV2Sandbox', {
+            text: i18n(`${i18nKey}.fail`, {
+                accountName: sandboxName,
+            }),
+        });
+        handleSandboxCreateError(e, env, sandboxName, parentAccountId);
+    }
+    try {
+        await saveAccountToConfig(sandbox.sandboxHubId, sandboxName, env, pak, force);
+    }
+    catch (err) {
+        logError(err);
+        throw err;
+    }
+    return { sandbox };
+}

package/lib/commonOpts.d.ts

@@ -1,6 +1,6 @@
 import { Argv, Arguments } from 'yargs';
 import { CmsPublishMode } from '@hubspot/local-dev-lib/types/Files';
-import { ConfigArgs } from '../types/Yargs';
+import { ConfigArgs } from '../types/Yargs.js';
 export declare function addGlobalOptions(yargs: Argv): Argv<{}>;
 export declare function addAccountOptions(yargs: Argv): Argv;
 export declare function addConfigOptions(yargs: Argv): Argv<ConfigArgs>;
@@ -11,14 +11,14 @@ export declare function addCmsPublishModeOptions(yargs: Argv, { read, write }: {
 }): Argv;
 export declare function addTestingOptions(yargs: Argv): Argv;
 export declare function addUseEnvironmentOptions(yargs: Argv): Argv;
+export declare function addJSONOutputOptions(yargs: Argv): Argv;
 export declare function addCustomHelpOutput(yargs: Argv, command: string | string[], describe?: string): Promise<void>;
 export declare function setLogLevel(options: Arguments<{
     debug?: boolean;
     networkDebug?: boolean;
+    json?: 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;