@hubspot/local-dev-lib 0.4.1-experimental.0 → 0.4.3-experimental.0

package/api/appsDev.d.ts

@@ -5,3 +5,4 @@ export declare function fetchPublicAppDeveloperTestAccountInstallData(appId: num
 export declare function fetchPublicAppProductionInstallCounts(appId: number, accountId: number): HubSpotPromise<PublicAppInstallCounts>;
 export declare function fetchPublicAppMetadata(appId: number, accountId: number): HubSpotPromise<PublicApp>;
 export declare function installStaticAuthAppOnTestAccount(appId: number, accountId: number, scopeGroupIds: number[]): HubSpotPromise<void>;
+export declare function fetchAppMetadataByUid(appUid: string, accountId: number): HubSpotPromise<PublicApp>;

package/api/appsDev.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installStaticAuthAppOnTestAccount = exports.fetchPublicAppMetadata = exports.fetchPublicAppProductionInstallCounts = exports.fetchPublicAppDeveloperTestAccountInstallData = exports.fetchPublicAppsForPortal = void 0;
+exports.fetchAppMetadataByUid = exports.installStaticAuthAppOnTestAccount = exports.fetchPublicAppMetadata = exports.fetchPublicAppProductionInstallCounts = exports.fetchPublicAppDeveloperTestAccountInstallData = exports.fetchPublicAppsForPortal = void 0;
 const http_1 = require("../http");
 const APPS_DEV_API_PATH = 'apps-dev/external/public/v3';
 const APPS_HUBLETS_API_PATH = 'apps-hublets/external/static-token/v3';
@@ -39,3 +39,12 @@ function installStaticAuthAppOnTestAccount(appId, accountId, scopeGroupIds) {
     });
 }
 exports.installStaticAuthAppOnTestAccount = installStaticAuthAppOnTestAccount;
+function fetchAppMetadataByUid(appUid, accountId) {
+    return http_1.http.get(accountId, {
+        url: `${APPS_DEV_API_PATH}/full/portal/sourceId`,
+        params: {
+            sourceId: appUid,
+        },
+    });
+}
+exports.fetchAppMetadataByUid = fetchAppMetadataByUid;

package/api/crm.d.ts

@@ -0,0 +1,3 @@
+import { HubSpotPromise } from '../types/Http';
+import { ImportRequest, ImportResponse } from '../types/Crm';
+export declare function createImport(accountId: number, importRequest: ImportRequest, dataFileNames: string[]): HubSpotPromise<ImportResponse>;

package/api/crm.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createImport = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const form_data_1 = __importDefault(require("form-data"));
+const http_1 = require("../http");
+const path_2 = require("../lib/path");
+const HUBSPOT_CRM_IMPORT_PATH = '/crm/v3/imports';
+function createImport(accountId, importRequest, dataFileNames) {
+    const jsonImportRequest = JSON.stringify(importRequest);
+    const formData = new form_data_1.default();
+    formData.append('importRequest', jsonImportRequest);
+    dataFileNames.forEach(file => {
+        const stream = fs_extra_1.default.createReadStream(path_1.default.resolve((0, path_2.getCwd)(), file));
+        formData.append('files', stream, file);
+    });
+    return http_1.http.post(accountId, {
+        url: `${HUBSPOT_CRM_IMPORT_PATH}`,
+        data: formData,
+        headers: {
+            ...formData.getHeaders(),
+        },
+    });
+}
+exports.createImport = createImport;

package/api/github.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchRepoContents = exports.fetchRepoFileByDownloadUrl = exports.fetchRepoFile = exports.fetchRepoAsZip = exports.fetchRepoReleaseData = void 0;
 const axios_1 = __importDefault(require("axios"));
 const getAxiosConfig_1 = require("../http/getAxiosConfig");
+const errors_1 = require("../errors");
 const GITHUB_REPOS_API = 'https://api.github.com/repos';
 const GITHUB_RAW_CONTENT_API_PATH = 'https://raw.githubusercontent.com';
 function getAdditionalHeaders() {
@@ -18,16 +19,33 @@ function getAdditionalHeaders() {
     }
     return headers;
 }
+function githubRequestWithFallback(url, responseType) {
+    const headersWithAuth = {
+        ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(),
+        ...getAdditionalHeaders(),
+    };
+    if (headersWithAuth.authorization) {
+        return axios_1.default
+            .get(url, { headers: headersWithAuth, responseType })
+            .catch(error => {
+            // 404 with an auth token might mean an SSO issue so retry without the authorization header
+            if ((0, errors_1.isSpecifiedError)(error, { statusCode: 404 })) {
+                return axios_1.default.get(url, {
+                    headers: { ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)() },
+                    responseType,
+                });
+            }
+            throw error;
+        });
+    }
+    // No auth token, proceed normally
+    return axios_1.default.get(url, { headers: headersWithAuth, responseType });
+}
 // Returns information about the repo's releases. Defaults to "latest" if no tag is provided
 // https://docs.github.com/en/rest/releases/releases?apiVersion=2022-11-28#get-a-release-by-tag-name
 function fetchRepoReleaseData(repoPath, tag = '') {
     const URL = `${GITHUB_REPOS_API}/${repoPath}/releases`;
-    return axios_1.default.get(`${URL}/${tag ? `tags/${tag}` : 'latest'}`, {
-        headers: {
-            ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(),
-            ...getAdditionalHeaders(),
-        },
-    });
+    return githubRequestWithFallback(`${URL}/${tag ? `tags/${tag}` : 'latest'}`);
 }
 exports.fetchRepoReleaseData = fetchRepoReleaseData;
 // Returns the entire repo content as a zip, using the zipball_url from fetchRepoReleaseData()
@@ -41,31 +59,19 @@ function fetchRepoAsZip(zipUrl) {
 exports.fetchRepoAsZip = fetchRepoAsZip;
 // Returns the raw file contents via the raw.githubusercontent endpoint
 function fetchRepoFile(repoPath, filePath, ref) {
-    return axios_1.default.get(`${GITHUB_RAW_CONTENT_API_PATH}/${repoPath}/${ref}/${filePath}`, {
-        headers: {
-            ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(),
-            ...getAdditionalHeaders(),
-        },
-    });
+    const url = `${GITHUB_RAW_CONTENT_API_PATH}/${repoPath}/${ref}/${filePath}`;
+    return githubRequestWithFallback(url);
 }
 exports.fetchRepoFile = fetchRepoFile;
 // Returns the raw file contents via the raw.githubusercontent endpoint
 function fetchRepoFileByDownloadUrl(downloadUrl) {
-    return axios_1.default.get(downloadUrl, {
-        headers: { ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(), ...getAdditionalHeaders() },
-        responseType: 'arraybuffer',
-    });
+    return githubRequestWithFallback(downloadUrl, 'arraybuffer');
 }
 exports.fetchRepoFileByDownloadUrl = fetchRepoFileByDownloadUrl;
 // Returns the contents of a file or directory in a repository by path
 // https://docs.github.com/en/rest/repos/contents?apiVersion=2022-11-28#get-repository-content
 function fetchRepoContents(repoPath, path, ref) {
     const refQuery = ref ? `?ref=${ref}` : '';
-    return axios_1.default.get(`${GITHUB_REPOS_API}/${repoPath}/contents/${path}${refQuery}`, {
-        headers: {
-            ...(0, getAxiosConfig_1.getDefaultUserAgentHeader)(),
-            ...getAdditionalHeaders(),
-        },
-    });
+    return githubRequestWithFallback(`${GITHUB_REPOS_API}/${repoPath}/contents/${path}${refQuery}`);
 }
 exports.fetchRepoContents = fetchRepoContents;

package/api/localDevAuth.d.ts

@@ -7,4 +7,4 @@ export declare function fetchAccessToken(personalAccessKey: string, env?: Enviro
 export declare function fetchScopeData(accountId: number, scopeGroup: string): HubSpotPromise<ScopeData>;
 export declare function fetchScopeAuthorizationData(accountId: number): HubSpotPromise<ScopeAuthorizationResponse>;
 export declare function fetchAppInstallationData(portalId: number, projectId: number, appUid: string, requiredScopeGroups: Array<string>, optionalScopeGroups?: Array<string>): HubSpotPromise<PublicAppInstallationData>;
-export declare function fetchEnabledFeatures(accountId: number): Promise<import("axios").AxiosResponse<EnabledFeaturesResponse, any>>;
+export declare function fetchEnabledFeatures(accountId: number): Promise<import("axios").AxiosResponse<EnabledFeaturesResponse, any, {}>>;

package/config/CLIConfiguration.js

@@ -46,7 +46,7 @@ class _CLIConfiguration {
             const configFromEnv = (0, environment_1.loadConfigFromEnvironment)();
             if (configFromEnv) {
                 logger_1.logger.debug((0, lang_1.i18n)(`${i18nKey}.load.configFromEnv`, {
-                    accountId: configFromEnv.accounts[0].accountId,
+                    accountId: `${configFromEnv.accounts?.[0].accountId}`,
                 }));
                 this.useEnvConfig = true;
                 this.config = this.handleLegacyCmsPublishMode(configFromEnv);
@@ -168,11 +168,11 @@ class _CLIConfiguration {
         }
         let account = null;
         if (name) {
-            account = this.config.accounts.find(a => a.name === name) || null;
+            account = this.config.accounts?.find(a => a.name === name) || null;
         }
         if (accountId && !account) {
             account =
-                this.config.accounts.find(a => accountId === a.accountId) || null;
+                this.config.accounts?.find(a => accountId === a.accountId) || null;
         }
         return account;
     }
@@ -230,7 +230,7 @@ class _CLIConfiguration {
         return account.name || account.accountId;
     }
     getAccountIndex(accountId) {
-        return this.config
+        return this.config && Array.isArray(this.config.accounts)
             ? this.config.accounts.findIndex(account => account.accountId === accountId)
             : -1;
     }
@@ -243,10 +243,10 @@ class _CLIConfiguration {
     isAccountInConfig(nameOrId) {
         if (typeof nameOrId === 'string') {
             return (!!this.config &&
-                this.config.accounts &&
+                !!this.config.accounts &&
                 !!this.getAccountId(nameOrId.toLowerCase()));
         }
-        return (!!this.config && this.config.accounts && !!this.getAccountId(nameOrId));
+        return (!!this.config && !!this.config.accounts && !!this.getAccountId(nameOrId));
     }
     getAndLoadConfigIfNeeded(options) {
         if (!this.config) {
@@ -341,7 +341,7 @@ class _CLIConfiguration {
         safelyApplyUpdates('accountType', this.getAccountType(updatedAccountType, sandboxAccountType));
         safelyApplyUpdates('parentAccountId', parentAccountId);
         const completedAccountConfig = nextAccountConfig;
-        if (!Object.hasOwn(this.config, 'accounts')) {
+        if (!Array.isArray(this.config.accounts)) {
             this.config.accounts = [];
         }
         if (currentAccountConfig) {
@@ -429,7 +429,10 @@ class _CLIConfiguration {
         if (accountConfig) {
             logger_1.logger.debug((0, lang_1.i18n)(`${i18nKey}.removeAccountFromConfig.deleting`, { accountId }));
             const index = this.getAccountIndex(accountId);
-            this.config.accounts.splice(index, 1);
+            if (index === -1) {
+                return removedAccountIsDefault;
+            }
+            this.config.accounts?.splice(index, 1);
             if (this.getDefaultAccount() === accountConfig.name) {
                 removedAccountIsDefault = true;
             }

package/config/configUtils.js

@@ -24,7 +24,7 @@ function getOrderedConfig(unorderedConfig) {
         httpTimeout,
         allowUsageTracking,
         ...rest,
-        accounts: accounts.map(getOrderedAccount),
+        accounts: accounts?.map(getOrderedAccount) || [],
     };
 }
 exports.getOrderedConfig = getOrderedConfig;
@@ -80,7 +80,7 @@ function generateConfig(type, options) {
             return null;
     }
     if (configAccount) {
-        config.accounts.push(configAccount);
+        config.accounts?.push(configAccount);
     }
     return config;
 }

package/config/config_DEPRECATED.js

@@ -14,7 +14,6 @@ const auth_1 = require("../constants/auth");
 const files_1 = require("../constants/files");
 const environment_1 = require("../lib/environment");
 const logger_1 = require("../lib/logger");
-const git_1 = require("../utils/git");
 const errors_DEPRECATED_1 = require("../errors/errors_DEPRECATED");
 const ALL_CMS_PUBLISH_MODES = Object.values(files_1.CMS_PUBLISH_MODE);
 let _config;
@@ -191,12 +190,11 @@ function readConfigFile() {
         return { source, error };
     }
     try {
-        (0, git_1.isConfigPathInGitRepo)(_configPath);
         source = fs_extra_1.default.readFileSync(_configPath);
     }
     catch (err) {
         error = err;
-        logger_1.logger.error('Config file could not be read "%s"', _configPath);
+        logger_1.logger.error(`Config file could not be read: ${_configPath}`);
         (0, errors_DEPRECATED_1.logFileSystemErrorInstance)(error, {
             filepath: _configPath,
             operation: 'read',
@@ -215,7 +213,7 @@ function parseConfig(configSource) {
     }
     catch (err) {
         error = err;
-        logger_1.logger.error('Config file could not be parsed "%s"', _configPath);
+        logger_1.logger.error(`Config file could not be parsed: ${_configPath}`);
         (0, errors_DEPRECATED_1.logErrorInstance)(err);
     }
     return { parsed, error };

package/config/migrate.js

@@ -105,6 +105,8 @@ function mergeConfigProperties(globalConfig, deprecatedConfig, force) {
         config_1.ENV,
         config_1.HTTP_USE_LOCALHOST,
         config_1.ALLOW_USAGE_TRACKING,
+        config_1.AUTO_OPEN_BROWSER,
+        config_1.ALLOW_AUTO_UPDATES,
     ];
     const conflicts = [];
     propertiesToCheck.forEach(prop => {

package/config/state.d.ts

@@ -0,0 +1,3 @@
+import { HubSpotState } from '../types/Config';
+export declare function getStateValue<K extends keyof HubSpotState>(key: K): HubSpotState[K];
+export declare function setStateValue<K extends keyof HubSpotState>(key: K, value: HubSpotState[K]): void;

package/config/state.js

@@ -0,0 +1,104 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setStateValue = exports.getStateValue = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const lang_1 = require("../utils/lang");
+const config_1 = require("../constants/config");
+const logger_1 = require("../lib/logger");
+const i18nKey = 'config.state';
+const DEFAULT_STATE = {
+    mcpTotalToolCalls: 0,
+};
+function ensureCLIDirectory() {
+    try {
+        const dir = path.dirname(config_1.STATE_FILE_PATH);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+    }
+    catch (error) {
+        throw new Error((0, lang_1.i18n)(`${i18nKey}.ensureCLIDirectory.errors.cannotCreateDirectory`, {
+            error: error instanceof Error ? error.message : String(error),
+        }));
+    }
+}
+function sanitizeAndMerge(parsed) {
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return structuredClone(DEFAULT_STATE);
+    }
+    const state = parsed;
+    const result = structuredClone(DEFAULT_STATE);
+    for (const key in DEFAULT_STATE) {
+        const typedKey = key;
+        if (key in state &&
+            typeof state[typedKey] === typeof DEFAULT_STATE[typedKey]) {
+            result[typedKey] = state[typedKey];
+        }
+        // keys not in parsed file remain as DEFAULT values
+    }
+    return result;
+}
+function getCurrentState() {
+    try {
+        if (!fs.existsSync(config_1.STATE_FILE_PATH)) {
+            return structuredClone(DEFAULT_STATE);
+        }
+        const data = fs.readFileSync(config_1.STATE_FILE_PATH, 'utf-8');
+        if (!data?.trim()) {
+            logger_1.logger.debug((0, lang_1.i18n)(`${i18nKey}.getCurrentState.debug.emptyStateFile`));
+            return structuredClone(DEFAULT_STATE);
+        }
+        const parsed = JSON.parse(data);
+        return sanitizeAndMerge(parsed);
+    }
+    catch (error) {
+        logger_1.logger.debug((0, lang_1.i18n)(`${i18nKey}.getCurrentState.errors.errorReading`, {
+            error: error instanceof Error ? error.message : String(error),
+        }));
+        return structuredClone(DEFAULT_STATE);
+    }
+}
+function getStateValue(key) {
+    ensureCLIDirectory();
+    const state = getCurrentState();
+    return state[key];
+}
+exports.getStateValue = getStateValue;
+function setStateValue(key, value) {
+    ensureCLIDirectory();
+    const currentState = getCurrentState();
+    const newState = { ...currentState, [key]: value };
+    try {
+        fs.writeFileSync(config_1.STATE_FILE_PATH, JSON.stringify(newState, null, 2), 'utf-8');
+    }
+    catch (error) {
+        throw new Error((0, lang_1.i18n)(`${i18nKey}.setStateValue.errors.failedToWrite`, {
+            error: error instanceof Error ? error.message : String(error),
+        }));
+    }
+}
+exports.setStateValue = setStateValue;

package/constants/config.d.ts

@@ -2,7 +2,9 @@ export declare const DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = "hubspot.config.yml
 export declare const ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME = "archived.hubspot.config.yml";
 export declare const HUBSPOT_CONFIGURATION_FOLDER = ".hscli";
 export declare const HUBSPOT_CONFIGURATION_FILE = "config.yml";
+export declare const HUBSPOT_STATE_FILE = "state.json";
 export declare const GLOBAL_CONFIG_PATH: string;
+export declare const STATE_FILE_PATH: string;
 export declare const DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME = ".hsaccount";
 export declare const DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID = "DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID";
 export declare const DEFAULT_ACCOUNT_OVERRIDE_ERROR_ACCOUNT_NOT_FOUND = "DEFAULT_ACCOUNT_OVERRIDE_ERROR_ACCOUNT_NOT_FOUND";
@@ -11,6 +13,8 @@ export declare const HTTP_TIMEOUT = "httpTimeout";
 export declare const ENV = "env";
 export declare const HTTP_USE_LOCALHOST = "httpUseLocalhost";
 export declare const ALLOW_USAGE_TRACKING = "allowUsageTracking";
+export declare const AUTO_OPEN_BROWSER = "autoOpenBrowser";
+export declare const ALLOW_AUTO_UPDATES = "allowAutoUpdates";
 export declare const DEFAULT_ACCOUNT = "defaultAccount";
 export declare const DEFAULT_PORTAL = "defaultPortal";
 export declare const MIN_HTTP_TIMEOUT = 3000;

package/constants/config.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HUBSPOT_ACCOUNT_TYPE_STRINGS = exports.HUBSPOT_ACCOUNT_TYPES = exports.MIN_HTTP_TIMEOUT = exports.DEFAULT_PORTAL = exports.DEFAULT_ACCOUNT = exports.ALLOW_USAGE_TRACKING = exports.HTTP_USE_LOCALHOST = exports.ENV = exports.HTTP_TIMEOUT = exports.DEFAULT_CMS_PUBLISH_MODE = exports.DEFAULT_ACCOUNT_OVERRIDE_ERROR_ACCOUNT_NOT_FOUND = exports.DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID = exports.DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME = exports.GLOBAL_CONFIG_PATH = exports.HUBSPOT_CONFIGURATION_FILE = exports.HUBSPOT_CONFIGURATION_FOLDER = exports.ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME = exports.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = void 0;
+exports.HUBSPOT_ACCOUNT_TYPE_STRINGS = exports.HUBSPOT_ACCOUNT_TYPES = exports.MIN_HTTP_TIMEOUT = exports.DEFAULT_PORTAL = exports.DEFAULT_ACCOUNT = exports.ALLOW_AUTO_UPDATES = exports.AUTO_OPEN_BROWSER = exports.ALLOW_USAGE_TRACKING = exports.HTTP_USE_LOCALHOST = exports.ENV = exports.HTTP_TIMEOUT = exports.DEFAULT_CMS_PUBLISH_MODE = exports.DEFAULT_ACCOUNT_OVERRIDE_ERROR_ACCOUNT_NOT_FOUND = exports.DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID = exports.DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME = exports.STATE_FILE_PATH = exports.GLOBAL_CONFIG_PATH = exports.HUBSPOT_STATE_FILE = exports.HUBSPOT_CONFIGURATION_FILE = exports.HUBSPOT_CONFIGURATION_FOLDER = exports.ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME = exports.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = void 0;
 const lang_1 = require("../utils/lang");
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
@@ -11,7 +11,9 @@ exports.DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME = 'hubspot.config.yml';
 exports.ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME = 'archived.hubspot.config.yml';
 exports.HUBSPOT_CONFIGURATION_FOLDER = '.hscli';
 exports.HUBSPOT_CONFIGURATION_FILE = 'config.yml';
+exports.HUBSPOT_STATE_FILE = 'state.json';
 exports.GLOBAL_CONFIG_PATH = path_1.default.join(os_1.default.homedir(), exports.HUBSPOT_CONFIGURATION_FOLDER, exports.HUBSPOT_CONFIGURATION_FILE);
+exports.STATE_FILE_PATH = path_1.default.join(os_1.default.homedir(), exports.HUBSPOT_CONFIGURATION_FOLDER, exports.HUBSPOT_STATE_FILE);
 exports.DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME = '.hsaccount';
 exports.DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID = 'DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID';
 exports.DEFAULT_ACCOUNT_OVERRIDE_ERROR_ACCOUNT_NOT_FOUND = 'DEFAULT_ACCOUNT_OVERRIDE_ERROR_ACCOUNT_NOT_FOUND';
@@ -20,6 +22,8 @@ exports.HTTP_TIMEOUT = 'httpTimeout';
 exports.ENV = 'env';
 exports.HTTP_USE_LOCALHOST = 'httpUseLocalhost';
 exports.ALLOW_USAGE_TRACKING = 'allowUsageTracking';
+exports.AUTO_OPEN_BROWSER = 'autoOpenBrowser';
+exports.ALLOW_AUTO_UPDATES = 'allowAutoUpdates';
 exports.DEFAULT_ACCOUNT = 'defaultAccount';
 exports.DEFAULT_PORTAL = 'defaultPortal';
 exports.MIN_HTTP_TIMEOUT = 3000;

package/lang/en.json

@@ -78,6 +78,15 @@
         "invalidPersonalAccessKey": "Error while retrieving new access token: {{ errorMessage }}"
       }
     },
+    "crm": {
+      "importData": {
+        "errors": {
+          "fileNotFound": "The file {{ fileName }} does not exist",
+          "notJson": "You must provide a JSON file for the import data request schema.",
+          "noFiles": "You must provide at least one data file for the import data request schema."
+        }
+      }
+    },
     "cms": {
       "modules": {
         "createModule": {
@@ -243,13 +252,13 @@
         "empty": "The config file was empty. Initializing an empty config."
       },
       "validate": {
-        "noConfig": "Valiation failed: No config was found.",
-        "noConfigAccounts": "Valiation failed: config.accounts[] is not defined.",
-        "emptyAccountConfig": "Valiation failed: config.accounts[] has an empty entry.",
-        "noAccountId": "Valiation failed: config.accounts[] has an entry missing accountId.",
-        "duplicateAccountIds": "Valiation failed: config.accounts[] has multiple entries with {{ accountId }}.",
-        "duplicateAccountNames": "Valiation failed: config.accounts[] has multiple entries with {{ accountName }}.",
-        "nameContainsSpaces": "Valiation failed: config.name {{ accountName }} cannot contain spaces."
+        "noConfig": "Validation failed: No config was found.",
+        "noConfigAccounts": "Validation failed: config.accounts[] is not defined.",
+        "emptyAccountConfig": "Validation failed: config.accounts[] has an empty entry.",
+        "noAccountId": "Validation failed: config.accounts[] has an entry missing accountId.",
+        "duplicateAccountIds": "Validation failed: config.accounts[] has multiple entries with {{ accountId }}.",
+        "duplicateAccountNames": "Validation failed: config.accounts[] has multiple entries with {{ accountName }}.",
+        "nameContainsSpaces": "Validation failed: config.name {{ accountName }} cannot contain spaces."
       },
       "updateAccount": {
         "noConfigToUpdate": "No config to update.",
@@ -311,6 +320,26 @@
     "configUtils": {
       "unknownType": "Unknown auth type {{ type }}"
     },
+    "state": {
+      "ensureCLIDirectory": {
+        "errors": {
+          "cannotCreateDirectory": "Cannot create CLI state directory: {{ error }}"
+        }
+      },
+      "getCurrentState": {
+        "debug": {
+          "emptyStateFile": "State file is empty, using default state"
+        },
+        "errors": {
+          "errorReading": "Error reading CLI state, using defaults: {{ error }}"
+        }
+      },
+      "setStateValue": {
+        "errors": {
+          "failedToWrite": "Failed to write CLI state: {{ error }}"
+        }
+      }
+    },
     "environment": {
       "loadConfig": {
         "missingAccountId": "Unable to load config from environment variables: Missing accountId",

package/lib/cms/uploadFolder.js

@@ -38,6 +38,16 @@ function getFileType(filePath) {
             return files_1.FILE_TYPES.other;
     }
 }
+function isMetaJsonFile(filePath) {
+    return path_1.default.basename(filePath).toLowerCase() === 'meta.json';
+}
+function resolveUploadPath(file, fieldsJsPaths, tmpDirRegex, regex, dest) {
+    const fieldsJsFileInfo = fieldsJsPaths.find(f => f.outputPath === file);
+    const relativePath = file.replace(fieldsJsFileInfo ? tmpDirRegex : regex, '');
+    const destPath = (0, path_2.convertToUnixPath)(path_1.default.join(dest, relativePath));
+    const originalFilePath = fieldsJsFileInfo ? fieldsJsFileInfo.filePath : file;
+    return { fieldsJsFileInfo, relativePath, destPath, originalFilePath };
+}
 async function getFilesByType(filePaths, projectDir, rootWriteDir, commandOptions) {
     const { convertFields, fieldOptions } = commandOptions;
     const projectDirRegex = new RegExp(`^${(0, escapeRegExp_1.escapeRegExp)(projectDir)}`);
@@ -106,6 +116,12 @@ const defaultUploadFinalErrorCallback = (accountId, file, destPath, error) => {
         payload: file,
     });
 };
+async function uploadMetaJsonFiles(moduleFiles, uploadFile) {
+    const moduleMetaJsonFiles = moduleFiles.filter(isMetaJsonFile);
+    if (moduleMetaJsonFiles.length > 0) {
+        await queue.addAll(moduleMetaJsonFiles.map(uploadFile));
+    }
+}
 async function uploadFolder(accountId, src, dest, fileMapperOptions, commandOptions = {}, filePaths = [], cmsPublishMode = null) {
     const { saveOutput, convertFields, onAttemptCallback, onSuccessCallback, onFirstErrorCallback, onRetryCallback, onFinalErrorCallback, } = commandOptions;
     const _onAttemptCallback = onAttemptCallback || defaultUploadAttemptCallback;
@@ -120,23 +136,15 @@ async function uploadFolder(accountId, src, dest, fileMapperOptions, commandOpti
     const apiOptions = (0, fileMapper_1.getFileMapperQueryValues)(cmsPublishMode, fileMapperOptions);
     const failures = [];
     let fieldsJsPaths = [];
-    let tmpDirRegex;
+    const tmpDirRegex = new RegExp(`^${(0, escapeRegExp_1.escapeRegExp)(tmpDir || '')}`);
     const [filesByType, fieldsJsObjects] = await getFilesByType(filePaths, src, tmpDir, commandOptions);
-    const fileList = Object.values(filesByType);
     if (fieldsJsObjects.length) {
         fieldsJsPaths = fieldsJsObjects.map(fieldsJs => {
             return { outputPath: fieldsJs.outputPath, filePath: fieldsJs.filePath };
         });
-        tmpDirRegex = new RegExp(`^${(0, escapeRegExp_1.escapeRegExp)(tmpDir || '')}`);
     }
     function uploadFile(file) {
-        const fieldsJsFileInfo = fieldsJsPaths.find(f => f.outputPath === file);
-        const originalFilePath = fieldsJsFileInfo
-            ? fieldsJsFileInfo.filePath
-            : file;
-        // files in fieldsJsPaths always belong to the tmp directory.
-        const relativePath = file.replace(fieldsJsFileInfo ? tmpDirRegex : regex, '');
-        const destPath = (0, path_2.convertToUnixPath)(path_1.default.join(dest, relativePath));
+        const { originalFilePath, destPath } = resolveUploadPath(file, fieldsJsPaths, tmpDirRegex, regex, dest);
         return async () => {
             _onAttemptCallback(originalFilePath, destPath);
             try {
@@ -155,9 +163,23 @@ async function uploadFolder(accountId, src, dest, fileMapperOptions, commandOpti
             }
         };
     }
-    for (let i = 0; i < fileList.length; i++) {
-        const filesToUpload = fileList[i];
-        await queue.addAll(filesToUpload.map(uploadFile));
+    // Upload all meta.json files first
+    await uploadMetaJsonFiles(filesByType[files_1.FILE_TYPES.module] || [], uploadFile);
+    // Collect all remaining files for upload
+    const deferredFiles = [];
+    Object.entries(filesByType).forEach(([fileType, files]) => {
+        if (fileType === files_1.FILE_TYPES.module) {
+            // Add non-meta.json module files
+            deferredFiles.push(...files.filter(f => !isMetaJsonFile(f)));
+        }
+        else {
+            // Add all non-module files
+            deferredFiles.push(...files);
+        }
+    });
+    // Upload all remaining files concurrently
+    if (deferredFiles.length > 0) {
+        await queue.addAll(deferredFiles.map(uploadFile));
     }
     const results = await queue
         .addAll(failures.map(({ file, destPath }) => {

package/lib/crm.d.ts

@@ -0,0 +1,6 @@
+import { ImportRequest } from '../types/Crm';
+export declare function getImportDataRequest(fileName: string): {
+    importRequest: ImportRequest;
+    dataFileNames: string[];
+};
+export declare function validateImportRequestFile(fileName: string): void;

package/lib/crm.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateImportRequestFile = exports.getImportDataRequest = void 0;
+const path_1 = __importDefault(require("path"));
+const path_2 = require("./path");
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const lang_1 = require("../utils/lang");
+function getImportDataRequest(fileName) {
+    validateImportRequestFile(fileName);
+    const importRequest = fs_extra_1.default.readJsonSync(path_1.default.resolve((0, path_2.getCwd)(), fileName));
+    const dataFileNames = importRequest.files.map(file => file.fileName);
+    // allow relative paths in the provided import request
+    importRequest.files = importRequest.files.map(file => ({
+        ...file,
+        fileName: path_1.default.basename(file.fileName),
+    }));
+    if (dataFileNames.length === 0) {
+        throw new Error((0, lang_1.i18n)('lib.crm.importData.errors.noFiles'));
+    }
+    dataFileNames.forEach(fileName => {
+        if (!fileExists(fileName)) {
+            throw new Error((0, lang_1.i18n)('lib.crm.importData.errors.fileNotFound', { fileName }));
+        }
+    });
+    return { importRequest, dataFileNames };
+}
+exports.getImportDataRequest = getImportDataRequest;
+function validateImportRequestFile(fileName) {
+    if (!fileExists(fileName)) {
+        throw new Error((0, lang_1.i18n)('lib.crm.importData.errors.fileNotFound', { fileName }));
+    }
+    if (path_1.default.extname(fileName) !== '.json') {
+        throw new Error((0, lang_1.i18n)('lib.crm.importData.errors.notJson'));
+    }
+}
+exports.validateImportRequestFile = validateImportRequestFile;
+function fileExists(_path) {
+    try {
+        const absoluteSrcPath = path_1.default.resolve((0, path_2.getCwd)(), _path);
+        if (!absoluteSrcPath)
+            return false;
+        const stats = fs_extra_1.default.statSync(absoluteSrcPath);
+        const isFile = stats.isFile();
+        if (!isFile) {
+            return false;
+        }
+    }
+    catch (e) {
+        return false;
+    }
+    return true;
+}

package/lib/gitignore.js

@@ -18,7 +18,7 @@ function checkAndAddConfigToGitignore(configPath) {
             return;
         let gitignoreFilePath = gitignoreFiles && gitignoreFiles.length ? gitignoreFiles[0] : null;
         if (!gitignoreFilePath) {
-            gitignoreFilePath = path_1.default.resolve(configPath, GITIGNORE_FILE);
+            gitignoreFilePath = path_1.default.join(path_1.default.dirname(configPath), GITIGNORE_FILE);
             (0, fs_extra_1.writeFileSync)(gitignoreFilePath, '');
         }
         const gitignoreContents = (0, fs_extra_1.readFileSync)(gitignoreFilePath).toString();

package/lib/hubdb.d.ts

@@ -8,7 +8,7 @@ export declare function createHubDbTable(accountId: number, src: string): Promis
     tableId: string;
     rowCount: number;
 }>;
-export declare function updateHubDbTable(accountId: number, tableId: string, src: string): Promise<AxiosResponse<Table, any>>;
+export declare function updateHubDbTable(accountId: number, tableId: string, src: string): Promise<AxiosResponse<Table, any, {}>>;
 export declare function downloadHubDbTable(accountId: number, tableId: string, dest: string): Promise<{
     filePath: string;
 }>;

package/lib/isDeepEqual.d.ts

@@ -0,0 +1 @@
+export declare function isDeepEqual(object1: unknown, object2: unknown, ignoreKeys?: string[]): boolean;

package/lib/isDeepEqual.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDeepEqual = void 0;
+function isDeepEqual(object1, object2, ignoreKeys) {
+    if (object1 === object2) {
+        return true;
+    }
+    if (object1 === null ||
+        object2 === null ||
+        typeof object1 !== 'object' ||
+        typeof object2 !== 'object') {
+        return object1 === object2;
+    }
+    if (typeof object1 !== typeof object2) {
+        return false;
+    }
+    const isArray1 = Array.isArray(object1);
+    const isArray2 = Array.isArray(object2);
+    if (isArray1 !== isArray2) {
+        return false;
+    }
+    const objKeys1 = Object.keys(object1).filter(key => !ignoreKeys?.includes(key));
+    const objKeys2 = Object.keys(object2).filter(key => !ignoreKeys?.includes(key));
+    if (objKeys1.length !== objKeys2.length)
+        return false;
+    for (const key of objKeys1) {
+        const value1 = object1[key];
+        const value2 = object2[key];
+        if (!isDeepEqual(value1, value2, ignoreKeys)) {
+            return false;
+        }
+    }
+    return true;
+}
+exports.isDeepEqual = isDeepEqual;

package/lib/portManager.d.ts

@@ -7,5 +7,6 @@ export declare function stopPortManagerServer(): Promise<void>;
 export declare function requestPorts(portData: Array<RequestPortsData>): Promise<{
     [instanceId: string]: number;
 }>;
+export declare function getServerPortByInstanceId(serverInstanceId: string): Promise<number>;
 export declare function deleteServerInstance(serverInstanceId: string): Promise<void>;
 export declare function portManagerHasActiveServers(): Promise<boolean>;

package/lib/portManager.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.portManagerHasActiveServers = exports.deleteServerInstance = exports.requestPorts = exports.stopPortManagerServer = exports.startPortManagerServer = exports.isPortManagerServerRunning = exports.isPortManagerPortAvailable = exports.BASE_URL = void 0;
+exports.portManagerHasActiveServers = exports.deleteServerInstance = exports.getServerPortByInstanceId = exports.requestPorts = exports.stopPortManagerServer = exports.startPortManagerServer = exports.isPortManagerServerRunning = exports.isPortManagerPortAvailable = exports.BASE_URL = void 0;
 const axios_1 = __importDefault(require("axios"));
 const PortManagerServer_1 = require("../utils/PortManagerServer");
 const ports_1 = require("../constants/ports");
@@ -46,6 +46,11 @@ async function requestPorts(portData) {
     return data.ports;
 }
 exports.requestPorts = requestPorts;
+async function getServerPortByInstanceId(serverInstanceId) {
+    const { data } = await axios_1.default.get(`${exports.BASE_URL}/servers/${serverInstanceId}`);
+    return data.port;
+}
+exports.getServerPortByInstanceId = getServerPortByInstanceId;
 async function deleteServerInstance(serverInstanceId) {
     await axios_1.default.delete(`${exports.BASE_URL}/servers/${serverInstanceId}`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/local-dev-lib",
-    "version": "0.4.1-experimental.0",
+    "version": "0.4.3-experimental.0",
     "description": "Provides library functionality for HubSpot local development tooling, including the HubSpot CLI",
     "repository": {
         "type": "git",
@@ -20,6 +20,7 @@
     },
     "license": "Apache-2.0",
     "devDependencies": {
+        "@hubspot/npm-scripts": "0.0.4",
         "@inquirer/prompts": "^7.0.1",
         "@types/content-disposition": "^0.5.5",
         "@types/cors": "^2.8.15",
@@ -51,6 +52,7 @@
         "./http/*": "./http/*.js",
         "./config/getAccountIdentifier": "./config/getAccountIdentifier.js",
         "./config/migrate": "./config/migrate.js",
+        "./config/state": "./config/state.js",
         "./config": "./config/index.js",
         "./constants/*": "./constants/*.js",
         "./models/*": "./models/*.js",
@@ -61,7 +63,7 @@
     },
     "dependencies": {
         "address": "2.0.2",
-        "axios": "1.8.4",
+        "axios": "1.12.0",
         "chalk": "2.4.2",
         "chokidar": "3.6.0",
         "content-disposition": "0.5.4",
@@ -70,6 +72,7 @@
         "express": "4.21.2",
         "extract-zip": "2.0.1",
         "findup-sync": "5.0.0",
+        "form-data": "^4.0.4",
         "fs-extra": "11.2.0",
         "ignore": "5.3.1",
         "js-yaml": "4.1.0",

package/types/Build.d.ts

@@ -31,6 +31,7 @@ export type Build = {
     subbuildStatuses: Array<SubbuildStatus>;
     uploadMessage: string;
     autoDeployId: number;
+    platformVersion: string;
 };
 export type FetchProjectBuildsResponse = {
     results: Array<Build>;

package/types/Config.d.ts

@@ -3,7 +3,7 @@ import { CLIAccount_NEW, CLIAccount_DEPRECATED } from './Accounts';
 import { CmsPublishMode } from './Files';
 import { ValueOf } from './Utils';
 export interface CLIConfig_NEW {
-    accounts: Array<CLIAccount_NEW>;
+    accounts?: Array<CLIAccount_NEW>;
     allowUsageTracking?: boolean;
     allowAutoUpdates?: boolean;
     defaultAccount?: string | number;
@@ -44,3 +44,6 @@ export type GitInclusionResult = {
     configIgnored: boolean;
     gitignoreFiles: Array<string>;
 };
+export type HubSpotState = {
+    mcpTotalToolCalls: number;
+};

package/types/Crm.d.ts

@@ -0,0 +1,26 @@
+export interface ImportRequest {
+    name: string;
+    importOperations: {
+        [objectTypeId: string]: 'CREATE' | 'UPDATE' | 'UPSERT';
+    };
+    dateFormat?: string;
+    marketableContactImport?: boolean;
+    createContactListFromImport?: boolean;
+    files: Array<{
+        fileName: string;
+        fileFormat: 'CSV' | 'XLSX' | 'XLS';
+        fileImportPage: {
+            hasHeader: boolean;
+            columnMappings: Array<{
+                columnObjectTypeId: string;
+                columnName: string;
+                propertyName: string;
+                columnType?: string;
+            }>;
+        };
+    }>;
+}
+export interface ImportResponse {
+    id: string;
+    state: 'STARTED' | 'PROCESSING' | 'DONE' | 'FAILED' | 'CANCELED' | 'DEFERRED';
+}

package/types/Crm.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/types/Deploy.d.ts

@@ -42,7 +42,7 @@ export type ProjectDeployResponseQueued = {
         status: string;
     };
 };
-type SubdeployValidationIssue = {
+export type SubdeployValidationIssue = {
     uid: string;
     componentTypeName: string;
     errorMessages: string[];
@@ -56,4 +56,3 @@ export type ProjectDeployResponseBlocked = {
     issues: SubdeployValidationIssue[];
 };
 export type ProjectDeployResponse = ProjectDeployResponseQueued | ProjectDeployResponseBlocked;
-export {};

package/utils/accounts.js

@@ -5,10 +5,10 @@ function getAccounts(config) {
     if (!config) {
         return [];
     }
-    else if (Object.hasOwn(config, 'portals')) {
+    else if ('portals' in config && Array.isArray(config.portals)) {
         return config.portals;
     }
-    else if (Object.hasOwn(config, 'accounts')) {
+    else if ('accounts' in config && Array.isArray(config.accounts)) {
         return config.accounts;
     }
     return [];