@hubspot/local-dev-lib 5.0.0-beta.0 → 5.0.0-beta.1

package/api/developerTestAccounts.d.ts

@@ -1,11 +1,9 @@
-import { DeveloperTestAccount, CreateDeveloperTestAccountResponse, FetchDeveloperTestAccountsResponse, DeveloperTestAccountConfig, CreateDeveloperTestAccountV3Response, InstallOauthAppIntoDeveloperTestAccountResponse, TestPortalStatusResponse, GenerateDeveloperTestAccountPersonalAccessKeyResponse } from '../types/developerTestAccounts.js';
-import { Environment } from '../types/Config.js';
+import { CreateDeveloperTestAccountResponse, FetchDeveloperTestAccountsResponse, DeveloperTestAccountConfig, CreateDeveloperTestAccountV3Response, InstallOauthAppIntoDeveloperTestAccountResponse, TestPortalStatusResponse, GenerateDeveloperTestAccountPersonalAccessKeyResponse } from '../types/developerTestAccounts.js';
 import { HubSpotPromise } from '../types/Http.js';
 export declare function fetchDeveloperTestAccounts(accountId: number): HubSpotPromise<FetchDeveloperTestAccountsResponse>;
 export declare function createDeveloperTestAccount(accountId: number, accountInfo: string): HubSpotPromise<CreateDeveloperTestAccountResponse>;
 export declare function createDeveloperTestAccount(accountId: number, accountInfo: DeveloperTestAccountConfig): HubSpotPromise<CreateDeveloperTestAccountV3Response>;
 export declare function deleteDeveloperTestAccount(accountId: number, testAccountId: number, useV3?: boolean): HubSpotPromise<void>;
-export declare function fetchDeveloperTestAccountData(accessToken: string, accountId: number, env?: Environment): HubSpotPromise<DeveloperTestAccount>;
 export declare function installOauthAppIntoDeveloperTestAccount(accountId: number, testAccountId: number, projectName: string, appUId: string): HubSpotPromise<InstallOauthAppIntoDeveloperTestAccountResponse>;
 export declare function fetchDeveloperTestAccountOauthAppInstallStatus(accountId: number, projectName: string, appUId: string): HubSpotPromise<TestPortalStatusResponse>;
 export declare function fetchDeveloperTestAccountGateSyncStatus(accountId: number, testAccountId: number): HubSpotPromise<TestPortalStatusResponse>;

package/api/developerTestAccounts.js

@@ -1,7 +1,4 @@
-import { httpClient } from '../http/client.js';
 import { http } from '../http/index.js';
-import { getAxiosConfig } from '../http/getAxiosConfig.js';
-import { ENVIRONMENTS } from '../constants/environments.js';
 import { SANDBOX_TIMEOUT } from '../constants/api.js';
 const TEST_ACCOUNTS_API_PATH = 'integrators/test-portals/v2';
 const TEST_ACCOUNTS_API_PATH_V3 = 'integrators/test-portals/v3';
@@ -34,21 +31,6 @@ export function deleteDeveloperTestAccount(accountId, testAccountId, useV3 = fal
         url: `${TEST_ACCOUNTS_API_PATH}/${testAccountId}`,
     });
 }
-export function fetchDeveloperTestAccountData(accessToken, accountId, env = ENVIRONMENTS.PROD) {
-    const axiosConfig = getAxiosConfig({
-        env,
-        url: `${TEST_ACCOUNTS_API_PATH}/self`,
-        params: { portalId: accountId },
-    });
-    const reqWithToken = {
-        ...axiosConfig,
-        headers: {
-            ...axiosConfig.headers,
-            Authorization: `Bearer ${accessToken}`,
-        },
-    };
-    return httpClient(reqWithToken);
-}
 export function installOauthAppIntoDeveloperTestAccount(accountId, testAccountId, projectName, appUId) {
     return http.post(accountId, {
         url: `${TEST_ACCOUNTS_API_PATH_V3}/install-apps`,

package/api/fileMapper.d.ts

@@ -1,7 +1,6 @@
 import { AxiosResponse } from 'axios';
 import { FileMapperNode, FileMapperOptions, FileTree } from '../types/Files.js';
 import { HubSpotPromise } from '../types/Http.js';
-export declare const FILE_MAPPER_API_PATH = "content/filemapper/v1";
 export declare function createFileMapperNodeFromStreamResponse(filePath: string, response: Partial<AxiosResponse>): FileMapperNode;
 export declare function upload(accountId: number, src: string, dest: string, options?: FileMapperOptions): HubSpotPromise<void>;
 export declare function fetchModule(accountId: number, moduleId: number, options?: FileMapperOptions): HubSpotPromise<FileTree>;

package/api/fileMapper.js

@@ -3,7 +3,7 @@ import path from 'path';
 import contentDisposition from 'content-disposition';
 import { http } from '../http/index.js';
 import { getCwd } from '../lib/path.js';
-export const FILE_MAPPER_API_PATH = 'content/filemapper/v1';
+import { FILE_MAPPER_API_PATH } from '../constants/endpoints.js';
 export function createFileMapperNodeFromStreamResponse(filePath, response) {
     if (filePath[0] !== '/') {
         filePath = `/${filePath}`;

package/api/fireAlarm.d.ts

@@ -1,4 +1,3 @@
 import { FireAlarm } from '../types/FireAlarm.js';
 import { HubSpotPromise } from '../types/Http.js';
-export declare const FIREALARM_API_AUTH_PATH = "firealarm/v4/alarm";
 export declare function fetchFireAlarms(accountId: number): HubSpotPromise<Array<FireAlarm>>;

package/api/fireAlarm.js

@@ -1,5 +1,5 @@
 import { http } from '../http/index.js';
-export const FIREALARM_API_AUTH_PATH = 'firealarm/v4/alarm';
+import { FIREALARM_API_AUTH_PATH } from '../constants/endpoints.js';
 export function fetchFireAlarms(accountId) {
     return http.get(accountId, {
         url: `${FIREALARM_API_AUTH_PATH}/hubspot-cli/${accountId}`,

package/api/localDevAuth.d.ts

@@ -1,9 +1,6 @@
-import { Environment } from '../types/Config.js';
-import { ScopeData, AccessTokenResponse, EnabledFeaturesResponse, ScopeAuthorizationResponse } from '../types/Accounts.js';
+import { ScopeData, EnabledFeaturesResponse, ScopeAuthorizationResponse } from '../types/Accounts.js';
 import { PublicAppInstallationData } from '../types/Apps.js';
 import { HubSpotPromise } from '../types/Http.js';
-export declare const LOCALDEVAUTH_ACCESS_TOKEN_PATH = "localdevauth/v1/auth/refresh";
-export declare function fetchAccessToken(personalAccessKey: string, env?: Environment, portalId?: number): HubSpotPromise<AccessTokenResponse>;
 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>;

package/api/localDevAuth.js

@@ -1,24 +1,5 @@
-import { getAxiosConfig } from '../http/getAxiosConfig.js';
 import { http } from '../http/index.js';
-import { ENVIRONMENTS } from '../constants/environments.js';
-import { httpClient } from '../http/client.js';
-const LOCALDEVAUTH_API_AUTH_PATH = 'localdevauth/v1/auth';
-export const LOCALDEVAUTH_ACCESS_TOKEN_PATH = `${LOCALDEVAUTH_API_AUTH_PATH}/refresh`;
-export function fetchAccessToken(personalAccessKey, env = ENVIRONMENTS.PROD, portalId) {
-    const axiosConfig = getAxiosConfig({
-        env,
-        localHostOverride: true,
-        url: LOCALDEVAUTH_ACCESS_TOKEN_PATH,
-        data: {
-            encodedOAuthRefreshToken: personalAccessKey,
-        },
-        params: portalId ? { portalId } : {},
-    });
-    return httpClient({
-        ...axiosConfig,
-        method: 'post',
-    });
-}
+import { LOCALDEVAUTH_API_AUTH_PATH } from '../constants/endpoints.js';
 export function fetchScopeData(accountId, scopeGroup) {
     return http.get(accountId, {
         url: `${LOCALDEVAUTH_API_AUTH_PATH}/check-scopes`,

package/api/sandboxHubs.d.ts

@@ -1,10 +1,7 @@
-import { AxiosPromise } from 'axios';
-import { Environment } from '../types/Config.js';
-import { SandboxPersonalAccessKey, SandboxHubData, SandboxResponse, SandboxUsageLimitsResponse, V2Sandbox } from '../types/Sandbox.js';
+import { SandboxPersonalAccessKey, SandboxResponse, SandboxUsageLimitsResponse, V2Sandbox } from '../types/Sandbox.js';
 import { HubSpotPromise } from '../types/Http.js';
 export declare function createSandbox(accountId: number, name: string, type: 1 | 2): HubSpotPromise<SandboxResponse>;
 export declare function deleteSandbox(parentAccountId: number, sandboxAccountId: number): HubSpotPromise<void>;
 export declare function getSandboxUsageLimits(parentAccountId: number): HubSpotPromise<SandboxUsageLimitsResponse>;
-export declare function fetchSandboxHubData(accessToken: string, accountId: number, env?: Environment): AxiosPromise<SandboxHubData>;
 export declare function createV2Sandbox(accountId: number, name: string, type: 'STANDARD' | 'DEVELOPER', syncObjectRecords: boolean): HubSpotPromise<V2Sandbox>;
 export declare function getSandboxPersonalAccessKey(accountId: number, sandboxId: number): HubSpotPromise<SandboxPersonalAccessKey>;

package/api/sandboxHubs.js

@@ -1,7 +1,4 @@
-import { httpClient } from '../http/client.js';
 import { http } from '../http/index.js';
-import { getAxiosConfig } from '../http/getAxiosConfig.js';
-import { ENVIRONMENTS } from '../constants/environments.js';
 import { SANDBOX_TIMEOUT } from '../constants/api.js';
 const SANDBOX_API_PATH = 'sandbox-hubs/v1';
 const SANDBOX_API_PATH_V2 = 'sandbox-hubs/v2';
@@ -22,21 +19,6 @@ export function getSandboxUsageLimits(parentAccountId) {
         url: `${SANDBOX_API_PATH}/parent/${parentAccountId}/usage`,
     });
 }
-export function fetchSandboxHubData(accessToken, accountId, env = ENVIRONMENTS.PROD) {
-    const axiosConfig = getAxiosConfig({
-        env,
-        url: `${SANDBOX_API_PATH}/self`,
-        params: { portalId: accountId },
-    });
-    const reqWithToken = {
-        ...axiosConfig,
-        headers: {
-            ...axiosConfig.headers,
-            Authorization: `Bearer ${accessToken}`,
-        },
-    };
-    return httpClient(reqWithToken);
-}
 export function createV2Sandbox(accountId, name, type, syncObjectRecords) {
     return http.post(accountId, {
         url: `${SANDBOX_API_PATH_V2}/sandboxes`,

package/config/defaultAccountOverride.d.ts

@@ -1,2 +1,3 @@
-export declare function getDefaultAccountOverrideAccountId(): number | null;
+import { HubSpotConfigAccount } from '../types/Accounts.js';
+export declare function getDefaultAccountOverrideAccountId(accounts: Array<HubSpotConfigAccount>): number | null;
 export declare function getDefaultAccountOverrideFilePath(): string | null;

package/config/defaultAccountOverride.js

@@ -4,9 +4,8 @@ import { getCwd } from '../lib/path.js';
 import { DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID, DEFAULT_ACCOUNT_OVERRIDE_ERROR_ACCOUNT_NOT_FOUND, DEFAULT_ACCOUNT_OVERRIDE_FILE_NAME, } from '../constants/config.js';
 import { i18n } from '../utils/lang.js';
 import { FileSystemError } from '../models/FileSystemError.js';
-import { getAllConfigAccounts } from './index.js';
 const i18nKey = 'config.defaultAccountOverride';
-export function getDefaultAccountOverrideAccountId() {
+export function getDefaultAccountOverrideAccountId(accounts) {
     const defaultAccountOverrideFilePath = getDefaultAccountOverrideFilePath();
     if (!defaultAccountOverrideFilePath) {
         return null;
@@ -30,7 +29,6 @@ export function getDefaultAccountOverrideAccountId() {
             cause: DEFAULT_ACCOUNT_OVERRIDE_ERROR_INVALID_ID,
         });
     }
-    const accounts = getAllConfigAccounts();
     const account = accounts?.find(account => account.accountId === accountId);
     if (!account) {
         throw new Error(i18n(`${i18nKey}.getDefaultAccountOverrideAccountId.errorHeader`, {

package/config/index.d.ts

@@ -1,7 +1,7 @@
 import { HubSpotConfigAccount } from '../types/Accounts.js';
 import { HubSpotConfig, ConfigFlag, HubSpotConfigValidationResult } from '../types/Config.js';
 import { CmsPublishMode } from '../types/Files.js';
-import { Environment } from '../types/Config.js';
+import { Environment } from '../types/Accounts.js';
 export declare function getGlobalConfigFilePath(): string;
 export declare function getLocalConfigFilePathIfExists(cwd?: string): string | null;
 export declare function localConfigFileExists(): boolean;

package/config/index.js

@@ -155,7 +155,7 @@ export function getConfigDefaultAccount() {
     const currentConfigPath = getConfigFilePath();
     const globalConfigPath = getGlobalConfigFilePath();
     if (currentConfigPath === globalConfigPath && globalConfigFileExists()) {
-        const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId();
+        const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId(accounts);
         defaultAccountToUse = defaultAccountOverrideAccountId || defaultAccount;
     }
     if (!defaultAccountToUse) {
@@ -176,7 +176,7 @@ export function getConfigDefaultAccountIfExists() {
     const currentConfigPath = getConfigFilePath();
     const globalConfigPath = getGlobalConfigFilePath();
     if (currentConfigPath === globalConfigPath && globalConfigFileExists()) {
-        const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId();
+        const defaultAccountOverrideAccountId = getDefaultAccountOverrideAccountId(accounts);
         defaultAccountToUse = defaultAccountOverrideAccountId || defaultAccount;
     }
     if (!defaultAccountToUse) {

package/constants/endpoints.d.ts

@@ -0,0 +1,6 @@
+export declare const LOCALDEVAUTH_API_AUTH_PATH = "localdevauth/v1/auth";
+export declare const LOCALDEVAUTH_ACCESS_TOKEN_PATH = "localdevauth/v1/auth/refresh";
+export declare const FIREALARM_API_AUTH_PATH = "firealarm/v4/alarm";
+export declare const FILE_MAPPER_API_PATH = "content/filemapper/v1";
+export declare const CMS_CLI_USAGE_PATH = "content/filemapper/v1/cms-cli-usage";
+export declare const VSCODE_USAGE_PATH = "content/filemapper/v1/vscode-extension-usage";

package/constants/endpoints.js

@@ -0,0 +1,6 @@
+export const LOCALDEVAUTH_API_AUTH_PATH = 'localdevauth/v1/auth';
+export const LOCALDEVAUTH_ACCESS_TOKEN_PATH = `${LOCALDEVAUTH_API_AUTH_PATH}/refresh`;
+export const FIREALARM_API_AUTH_PATH = 'firealarm/v4/alarm';
+export const FILE_MAPPER_API_PATH = 'content/filemapper/v1';
+export const CMS_CLI_USAGE_PATH = `${FILE_MAPPER_API_PATH}/cms-cli-usage`;
+export const VSCODE_USAGE_PATH = `${FILE_MAPPER_API_PATH}/vscode-extension-usage`;

package/enums/build.d.ts

@@ -19,6 +19,7 @@ export declare const DEPLOYABLE_STATES: {
 export declare const COMPONENT_TYPES: {
     readonly APP: "APP";
     readonly PRIVATE_APP: "PRIVATE_APP";
+    readonly PUBLIC_APP: "PUBLIC_APP";
     readonly THEME: "THEME";
     readonly REACT_THEME: "REACT_THEME";
 };

package/enums/build.js

@@ -19,6 +19,7 @@ export const DEPLOYABLE_STATES = {
 export const COMPONENT_TYPES = {
     APP: 'APP',
     PRIVATE_APP: 'PRIVATE_APP',
+    PUBLIC_APP: 'PUBLIC_APP',
     THEME: 'THEME',
     REACT_THEME: 'REACT_THEME',
 };

package/errors/index.d.ts

@@ -1,7 +1,7 @@
 import { HubSpotHttpError } from '../models/HubSpotHttpError.js';
-import { BaseError } from '../types/Error.js';
 import { FileSystemError } from '../models/FileSystemError.js';
 import { HubSpotConfigError } from '../models/HubSpotConfigError.js';
+export { isSystemError } from './isSystemError.js';
 export declare function isSpecifiedError(err: unknown, { statusCode, category, subCategory, errorType, code, }: {
     statusCode?: number;
     category?: string;
@@ -16,6 +16,5 @@ export declare function isAuthError(err: unknown): err is HubSpotHttpError;
 export declare function isValidationError(err: unknown): err is HubSpotHttpError;
 export declare function isHubSpotHttpError(error?: unknown): error is HubSpotHttpError;
 export declare function isGithubRateLimitError(err: unknown): err is HubSpotHttpError;
-export declare function isSystemError(err: unknown): err is BaseError;
 export declare function isFileSystemError(err: unknown): err is FileSystemError;
 export declare function isHubSpotConfigError(err: unknown): err is HubSpotConfigError;

package/errors/index.js

@@ -1,6 +1,7 @@
 import { HubSpotHttpErrorName, } from '../models/HubSpotHttpError.js';
 import { FilerSystemErrorName, } from '../models/FileSystemError.js';
 import { HubSpotConfigError } from '../models/HubSpotConfigError.js';
+export { isSystemError } from './isSystemError.js';
 export function isSpecifiedError(err, { statusCode, category, subCategory, errorType, code, }) {
     if (!isHubSpotHttpError(err)) {
         return false;
@@ -46,15 +47,6 @@ export function isGithubRateLimitError(err) {
         err.headers['x-ratelimit-remaining'] === '0' &&
         'x-github-request-id' in err.headers);
 }
-export function isSystemError(err) {
-    return (err instanceof Error &&
-        'errno' in err &&
-        err.errno != null &&
-        'code' in err &&
-        err.code != null &&
-        'syscall' in err &&
-        err.syscall != null);
-}
 export function isFileSystemError(err) {
     return err instanceof Error && err.name === FilerSystemErrorName;
 }

package/errors/isSystemError.d.ts

@@ -0,0 +1,2 @@
+import { BaseError } from '../types/Error.js';
+export declare function isSystemError(err: unknown): err is BaseError;

package/errors/isSystemError.js

@@ -0,0 +1,9 @@
+export function isSystemError(err) {
+    return (err instanceof Error &&
+        'errno' in err &&
+        err.errno != null &&
+        'code' in err &&
+        err.code != null &&
+        'syscall' in err &&
+        err.syscall != null);
+}

package/http/client.js

@@ -1,10 +1,8 @@
 import axios, { isAxiosError } from 'axios';
 import { HubSpotHttpError } from '../models/HubSpotHttpError.js';
 import { logger } from '../lib/logger.js';
-import { LOCALDEVAUTH_ACCESS_TOKEN_PATH } from '../api/localDevAuth.js';
-import { FIREALARM_API_AUTH_PATH } from '../api/fireAlarm.js';
 import * as util from 'util';
-import { CMS_CLI_USAGE_PATH, VSCODE_USAGE_PATH } from '../lib/trackUsage.js';
+import { LOCALDEVAUTH_ACCESS_TOKEN_PATH, FIREALARM_API_AUTH_PATH, CMS_CLI_USAGE_PATH, VSCODE_USAGE_PATH, } from '../constants/endpoints.js';
 // Create an isolated axios instance for this copy of local-dev-lib.
 // This prevents issues when multiple copies are loaded and share the global
 // axios, where each copy would register interceptors on the shared instance

package/lang/en.json

@@ -316,7 +316,7 @@
       },
       "buildConfigFromEnvironment": {
         "missingAccountId": "HUBSPOT_ACCOUNT_ID is required, but not currently set",
-        "invalidAuthType": "Auth type is invalid. Use HUBSPOT_CLIENT_ID, HUBSPOT_CLIENT_SECRET, and HUBSPOT_REFRESH_TOKEN to authenticate with Oauth2, PERSONAL_ACCESS_KEY to authenticate with Personal Access Key, or API_KEY to authenticate with API Key."
+        "invalidAuthType": "Auth type is invalid. Use HUBSPOT_CLIENT_ID, HUBSPOT_CLIENT_SECRET, and HUBSPOT_REFRESH_TOKEN to authenticate with Oauth2, HUBSPOT_PERSONAL_ACCESS_KEY to authenticate with Personal Access Key, or API_KEY to authenticate with API Key."
       }
     },
     "defaultAccountOverride": {

package/lib/archive.js

@@ -121,7 +121,6 @@ async function cleanupTempDir(tmpDir) {
         return;
     try {
         await fs.remove(tmpDir);
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
     }
     catch (e) {
         logger.debug(i18n(`${i18nKey}.cleanupTempDir.error`, { tmpDir }));

package/lib/crm.js

@@ -39,7 +39,6 @@ function fileExists(_path) {
         if (!isFile) {
             return false;
         }
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
     }
     catch (e) {
         return false;

package/lib/environment.d.ts

@@ -1,2 +1,2 @@
-import { Environment } from '../types/Config.js';
+import { Environment } from '../types/Accounts.js';
 export declare function getValidEnv(env?: string | null, maskedProductionValue?: Environment): Environment;

package/lib/fileMapper.js

@@ -61,7 +61,6 @@ function validateFileMapperNode(node) {
     let json;
     try {
         json = JSON.stringify(node, null, 2);
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
     }
     catch (err) {
         json = node;
@@ -156,7 +155,6 @@ async function writeFileMapperNode(accountId, filepath, node, cmsPublishMode, op
         try {
             await fetchAndWriteFileStream(accountId, node.path, localFilepath, cmsPublishMode, options);
             return true;
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
         }
         catch (err) {
             return false;

package/lib/personalAccessKey.d.ts

@@ -1,5 +1,4 @@
-import { PersonalAccessKeyConfigAccount, ScopeGroupAuthorization } from '../types/Accounts.js';
-import { Environment } from '../types/Config.js';
+import { PersonalAccessKeyConfigAccount, Environment } from '../types/Accounts.js';
 import { AccessToken } from '../types/Accounts.js';
 export declare function getAccessToken(personalAccessKey: string, env?: Environment, accountId?: number): Promise<AccessToken>;
 export declare function accessTokenForPersonalAccessKey(accountId: number, forceRefresh?: boolean): Promise<string | undefined>;
@@ -7,5 +6,4 @@ export declare function enabledFeaturesForPersonalAccessKey(accountId: number):
     [key: string]: number;
 } | undefined>;
 export declare function scopesOnAccessToken(accountId: number): Promise<Array<string>>;
-export declare function authorizedScopesForPortalAndUser(accountId: number): Promise<Array<ScopeGroupAuthorization>>;
 export declare function updateConfigWithAccessToken(token: AccessToken, personalAccessKey: string, env?: Environment, name?: string, makeDefault?: boolean): Promise<PersonalAccessKeyConfigAccount>;

package/lib/personalAccessKey.js

@@ -1,11 +1,9 @@
 import moment from 'moment';
 import { ENVIRONMENTS } from '../constants/environments.js';
 import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '../constants/auth.js';
-import { fetchAccessToken, fetchScopeAuthorizationData, } from '../api/localDevAuth.js';
-import { fetchSandboxHubData } from '../api/sandboxHubs.js';
+import { fetchAccessToken, fetchSandboxHubData, fetchDeveloperTestAccountData, } from '../utils/personalAccessKey.js';
 import { getConfigAccountById, getConfigAccountIfExists, updateConfigAccount, addConfigAccount, setConfigAccountAsDefault, } from '../config/index.js';
 import { HUBSPOT_ACCOUNT_TYPES } from '../constants/config.js';
-import { fetchDeveloperTestAccountData } from '../api/developerTestAccounts.js';
 import { logger } from './logger.js';
 import { i18n } from '../utils/lang.js';
 import { isHubSpotHttpError } from '../errors/index.js';
@@ -105,9 +103,6 @@ export async function enabledFeaturesForPersonalAccessKey(accountId) {
 export async function scopesOnAccessToken(accountId) {
     return (await getNewAccessTokenByAccountId(accountId)).scopeGroups;
 }
-export async function authorizedScopesForPortalAndUser(accountId) {
-    return (await fetchScopeAuthorizationData(accountId)).data.results;
-}
 export async function updateConfigWithAccessToken(token, personalAccessKey, env, name, makeDefault = false) {
     const { portalId, accessToken, expiresAt, accountType } = token;
     const account = getConfigAccountIfExists(portalId);

package/lib/trackUsage.d.ts

@@ -1,3 +1 @@
-export declare const CMS_CLI_USAGE_PATH = "content/filemapper/v1/cms-cli-usage";
-export declare const VSCODE_USAGE_PATH = "content/filemapper/v1/vscode-extension-usage";
 export declare function trackUsage(eventName: string, eventClass: string, meta?: {}, accountId?: number): Promise<void>;

package/lib/trackUsage.js

@@ -3,12 +3,10 @@ import { getAxiosConfig } from '../http/getAxiosConfig.js';
 import { logger } from './logger.js';
 import { http } from '../http/index.js';
 import { getConfigAccountById, getConfigAccountEnvironment, } from '../config/index.js';
-import { FILE_MAPPER_API_PATH } from '../api/fileMapper.js';
+import { FILE_MAPPER_API_PATH, CMS_CLI_USAGE_PATH, VSCODE_USAGE_PATH, } from '../constants/endpoints.js';
 import { i18n } from '../utils/lang.js';
 import { getValidEnv } from './environment.js';
 const i18nKey = 'lib.trackUsage';
-export const CMS_CLI_USAGE_PATH = `${FILE_MAPPER_API_PATH}/cms-cli-usage`;
-export const VSCODE_USAGE_PATH = `${FILE_MAPPER_API_PATH}/vscode-extension-usage`;
 export async function trackUsage(eventName, eventClass, meta = {}, accountId) {
     const usageEvent = {
         accountId,
@@ -41,7 +39,6 @@ export async function trackUsage(eventName, eventClass, meta = {}, accountId) {
                 resolveWithFullResponse: true,
             });
             return;
-            // eslint-disable-next-line @typescript-eslint/no-unused-vars
         }
         catch (e) {
             logger.debug(i18n(`${i18nKey}.retryingEventUnauthenticated`));

package/models/FileSystemError.js

@@ -1,5 +1,5 @@
 import { i18n } from '../utils/lang.js';
-import { isSystemError } from '../errors/index.js';
+import { isSystemError } from '../errors/isSystemError.js';
 const i18nKey = 'errors.fileSystemErrors';
 export const FilerSystemErrorName = 'FilerSystemError';
 export class FileSystemError extends Error {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@hubspot/local-dev-lib",
-    "version": "5.0.0-beta.0",
+    "version": "5.0.0-beta.1",
     "type": "module",
     "description": "Provides library functionality for HubSpot local development tooling, including the HubSpot CLI",
     "repository": {
@@ -13,6 +13,7 @@
     },
     "scripts": {
         "build": "tsx ./scripts/build.ts",
+        "circular-deps": "yarn madge --circular --extensions ts --exclude 'dist/.*' .",
         "lint": "eslint --max-warnings=0 . && prettier . --check",
         "local-dev": "yarn build && cd dist && yarn link && cd .. && tsc --watch --rootDir . --outdir dist",
         "prettier:write": "prettier . --write",
@@ -37,6 +38,7 @@
         "eslint": "^9.38.0",
         "eslint-plugin-import": "^2.31.0",
         "husky": "^8.0.0",
+        "madge": "^8.0.0",
         "open": "^8.4.2",
         "tsx": "^4.20.6",
         "typescript": "^5.9.3",
@@ -55,6 +57,7 @@
         "./config/state": "./config/state.js",
         "./config": "./config/index.js",
         "./constants/*": "./constants/*.js",
+        "./enums/*": "./enums/*.js",
         "./models/*": "./models/*.js",
         "./types/*": {
             "types": "./types/*.d.ts",

package/types/Accounts.d.ts

@@ -1,8 +1,9 @@
 import { HUBSPOT_ACCOUNT_TYPES } from '../constants/config.js';
+import { ENVIRONMENTS } from '../constants/environments.js';
 import { CmsPublishMode } from './Files.js';
-import { Environment } from './Config.js';
 import { ValueOf } from './Utils.js';
 import { PERSONAL_ACCESS_KEY_AUTH_METHOD, OAUTH_AUTH_METHOD, API_KEY_AUTH_METHOD } from '../constants/auth.js';
+export type Environment = ValueOf<typeof ENVIRONMENTS> | '';
 export type AuthType = 'personalaccesskey' | 'apikey' | 'oauth2';
 interface BaseHubSpotConfigAccount {
     name: string;

package/types/Build.d.ts

@@ -1,8 +1,7 @@
 import { ValueOf } from './Utils.js';
 import { BUILD_STATUS, SUBBUILD_TYPES, DEPLOYABLE_STATES } from '../enums/build.js';
 import { ActivitySource } from './Activity.js';
-import { DeployStatusTaskLocator } from './Deploy.js';
-import { ProjectStandardError } from './Project.js';
+import { DeployStatusTaskLocator, ProjectStandardError } from './ProjectComponents.js';
 export type SubbuildStatus = {
     buildName: string;
     buildType: ValueOf<typeof SUBBUILD_TYPES>;

package/types/Config.d.ts

@@ -1,6 +1,5 @@
 import { CONFIG_FLAGS, HUBSPOT_CONFIG_ERROR_TYPES, HUBSPOT_CONFIG_OPERATIONS } from '../constants/config.js';
-import { ENVIRONMENTS } from '../constants/environments.js';
-import { DeprecatedHubSpotConfigAccountFields, HubSpotConfigAccount } from './Accounts.js';
+import { DeprecatedHubSpotConfigAccountFields, Environment, HubSpotConfigAccount } from './Accounts.js';
 import { CmsPublishMode } from './Files.js';
 import { ValueOf } from './Utils.js';
 export interface HubSpotConfig {
@@ -22,7 +21,6 @@ export type DeprecatedHubSpotConfigFields = {
     defaultPortal?: string;
     defaultMode?: CmsPublishMode;
 };
-export type Environment = ValueOf<typeof ENVIRONMENTS> | '';
 export type GitInclusionResult = {
     inGit: boolean;
     configIgnored: boolean;

package/types/Deploy.d.ts

@@ -2,7 +2,7 @@ import { ValueOf } from './Utils.js';
 import { ACTIVITY_SOURCE } from '../enums/project.js';
 import { DEPLOY_ACTION, DEPLOY_STATUS } from '../enums/deploy.js';
 import { COMPONENT_TYPES, SUBCOMPONENT_TYPES } from '../enums/build.js';
-import { ProjectStandardError } from './Project.js';
+import { ProjectStandardError } from './ProjectComponents.js';
 export type DeployStatus = ValueOf<typeof DEPLOY_STATUS>;
 export type SubdeployStatus = {
     action: ValueOf<typeof DEPLOY_ACTION>;
@@ -29,12 +29,6 @@ export type Deploy = {
     userId: number;
     source: ValueOf<typeof ACTIVITY_SOURCE>;
 };
-export type DeployStatusTaskLocator = {
-    id: string;
-    links: Array<{
-        status: string;
-    }>;
-};
 export type SubdeployValidationIssue = {
     uid: string;
     componentTypeName: string;

package/types/Migration.d.ts

@@ -1,5 +1,5 @@
 import { ValueOf } from './Utils.js';
-import { ProjectStandardError } from './Project.js';
+import { ProjectStandardError } from './ProjectComponents.js';
 export declare const MIGRATION_STATUS: {
     readonly BUILDING: "BUILDING";
     readonly FAILURE: "FAILURE";

package/types/Project.d.ts

@@ -1,4 +1,4 @@
-import { Build } from './Build.js';
+import type { Build } from './Build.js';
 import { GithubSourceData } from './Github.js';
 import { ProjectLog } from './ProjectLog.js';
 export type Project = {
@@ -45,24 +45,6 @@ export type FetchPlatformVersionResponse = {
     defaultPlatformVersion: string;
     activePlatformVersions: Array<string>;
 };
-export type ProjectStandardError = {
-    status: string;
-    id?: string;
-    category: string;
-    subCategory?: string;
-    message?: string;
-    errors?: Array<{
-        message: string;
-        in?: string;
-        code?: string;
-        subcateogy?: string;
-        context: object;
-    }>;
-    context: object;
-    links: {
-        [key: string]: string;
-    };
-};
 export type WarnLogsResponse = {
     logs: Array<ProjectLog>;
 };

package/types/ProjectComponents.d.ts

@@ -0,0 +1,24 @@
+export type DeployStatusTaskLocator = {
+    id: string;
+    links: Array<{
+        status: string;
+    }>;
+};
+export type ProjectStandardError = {
+    status: string;
+    id?: string;
+    category: string;
+    subCategory?: string;
+    message?: string;
+    errors?: Array<{
+        message: string;
+        in?: string;
+        code?: string;
+        subcateogy?: string;
+        context: object;
+    }>;
+    context: object;
+    links: {
+        [key: string]: string;
+    };
+};

package/types/ProjectComponents.js

@@ -0,0 +1 @@
+export {};

package/utils/personalAccessKey.d.ts

@@ -0,0 +1,8 @@
+import { AxiosPromise } from 'axios';
+import { AccessTokenResponse, Environment } from '../types/Accounts.js';
+import { DeveloperTestAccount } from '../types/developerTestAccounts.js';
+import { SandboxHubData } from '../types/Sandbox.js';
+import { HubSpotPromise } from '../types/Http.js';
+export declare function fetchAccessToken(personalAccessKey: string, env?: Environment, portalId?: number): HubSpotPromise<AccessTokenResponse>;
+export declare function fetchSandboxHubData(accessToken: string, accountId: number, env?: Environment): AxiosPromise<SandboxHubData>;
+export declare function fetchDeveloperTestAccountData(accessToken: string, accountId: number, env?: Environment): HubSpotPromise<DeveloperTestAccount>;

package/utils/personalAccessKey.js

@@ -0,0 +1,51 @@
+import { httpClient } from '../http/client.js';
+import { getAxiosConfig } from '../http/getAxiosConfig.js';
+import { ENVIRONMENTS } from '../constants/environments.js';
+import { LOCALDEVAUTH_ACCESS_TOKEN_PATH } from '../constants/endpoints.js';
+const SANDBOX_API_PATH = 'sandbox-hubs/v1';
+const TEST_ACCOUNTS_API_PATH = 'integrators/test-portals/v2';
+export function fetchAccessToken(personalAccessKey, env = ENVIRONMENTS.PROD, portalId) {
+    const axiosConfig = getAxiosConfig({
+        env,
+        localHostOverride: true,
+        url: LOCALDEVAUTH_ACCESS_TOKEN_PATH,
+        data: {
+            encodedOAuthRefreshToken: personalAccessKey,
+        },
+        params: portalId ? { portalId } : {},
+    });
+    return httpClient({
+        ...axiosConfig,
+        method: 'post',
+    });
+}
+export function fetchSandboxHubData(accessToken, accountId, env = ENVIRONMENTS.PROD) {
+    const axiosConfig = getAxiosConfig({
+        env,
+        url: `${SANDBOX_API_PATH}/self`,
+        params: { portalId: accountId },
+    });
+    const reqWithToken = {
+        ...axiosConfig,
+        headers: {
+            ...axiosConfig.headers,
+            Authorization: `Bearer ${accessToken}`,
+        },
+    };
+    return httpClient(reqWithToken);
+}
+export function fetchDeveloperTestAccountData(accessToken, accountId, env = ENVIRONMENTS.PROD) {
+    const axiosConfig = getAxiosConfig({
+        env,
+        url: `${TEST_ACCOUNTS_API_PATH}/self`,
+        params: { portalId: accountId },
+    });
+    const reqWithToken = {
+        ...axiosConfig,
+        headers: {
+            ...axiosConfig.headers,
+            Authorization: `Bearer ${accessToken}`,
+        },
+    };
+    return httpClient(reqWithToken);
+}

package/errors/errors_DEPRECATED.d.ts

@@ -1,3 +0,0 @@
-import { BaseError, FileSystemErrorContext, ErrorContext } from '../types/Error.js';
-export declare function logErrorInstance(error: BaseError, context?: ErrorContext): void;
-export declare function logFileSystemErrorInstance(error: BaseError, context: FileSystemErrorContext): void;

package/errors/errors_DEPRECATED.js

@@ -1,55 +0,0 @@
-function isSystemError(err) {
-    return err.errno != null && err.code != null && err.syscall != null;
-}
-function debugErrorAndContext(error, context) {
-    console.debug('Error: %o', error);
-    console.debug('Context: %o', context);
-}
-export function logErrorInstance(error, context) {
-    // SystemError
-    if (isSystemError(error)) {
-        console.error(`A system error has occurred: ${error.message}`);
-        debugErrorAndContext(error, context);
-        return;
-    }
-    if (error instanceof Error ||
-        error.message ||
-        error.reason) {
-        // Error or Error subclass
-        const name = error.name || 'Error';
-        const message = [`A ${name} has occurred.`];
-        [error.message, error.reason].forEach(msg => {
-            if (msg) {
-                message.push(msg);
-            }
-        });
-        console.error(message.join(' '));
-    }
-    else {
-        // Unknown errors
-        console.error(`An unknown error has occurred.`);
-    }
-    debugErrorAndContext(error, context);
-}
-export function logFileSystemErrorInstance(error, context) {
-    let fileAction = '';
-    if (context.operation === 'read') {
-        fileAction = 'reading from';
-    }
-    else if (context.operation === 'write') {
-        fileAction = 'writing to';
-    }
-    else {
-        fileAction = 'accessing';
-    }
-    const filepath = context.filepath
-        ? `"${context.filepath}"`
-        : 'a file or folder';
-    const message = [`An error occurred while ${fileAction} ${filepath}.`];
-    // Many `fs` errors will be `SystemError`s
-    if (isSystemError(error)) {
-        message.push(`This is the result of a system error: ${error.message}`);
-    }
-    console.error(message.join(' '));
-    debugErrorAndContext(error, context);
-}