@hubspot/cli 5.0.2-beta.1 → 5.0.2

package/bin/cli.js

@@ -5,7 +5,7 @@ const updateNotifier = require('update-notifier');
 const chalk = require('chalk');
 
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../lib/errorHandlers/standardErrors');
 const { setLogLevel, getCommandName } = require('../lib/commonOpts');
 const {
   trackHelpUsage,

package/commands/accounts/clean.js

@@ -21,7 +21,7 @@ const SpinniesManager = require('../../lib/SpinniesManager');
 const { deleteAccount } = require('@hubspot/cli-lib/lib/config');
 const {
   isSpecifiedHubSpotAuthError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
+} = require('../../lib/errorHandlers/apiErrors');
 
 const i18nKey = 'cli.commands.accounts.subcommands.clean';
 

package/commands/auth.js

@@ -16,7 +16,7 @@ const {
   getConfig,
   getConfigPath,
 } = require('@hubspot/cli-lib/lib/config');
-const { commaSeparatedValues } = require('@hubspot/cli-lib/lib/text');
+const { commaSeparatedValues } = require('@hubspot/local-dev-lib/text');
 const { promptUser } = require('../lib/prompts/promptUtils');
 const {
   personalAccessKeyPrompt,

package/commands/config/set/defaultMode.js

@@ -1,7 +1,7 @@
 const { logger } = require('@hubspot/cli-lib/logger');
 const { updateDefaultMode } = require('@hubspot/cli-lib/lib/config');
 const { Mode } = require('@hubspot/cli-lib');
-const { commaSeparatedValues } = require('@hubspot/cli-lib/lib/text');
+const { commaSeparatedValues } = require('@hubspot/local-dev-lib/text');
 const { trackCommandUsage } = require('../../../lib/usageTracking');
 const { promptUser } = require('../../../lib/prompts/promptUtils');
 const { i18n } = require('../../../lib/lang');

package/commands/create.js

@@ -24,7 +24,7 @@
 const fs = require('fs-extra');
 const {
   logFileSystemErrorInstance,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../lib/errorHandlers/fileSystemErrors');
 const { logger } = require('@hubspot/cli-lib/logger');
 const { setLogLevel, getAccountId } = require('../lib/commonOpts');
 const { logDebugInfo } = require('../lib/debugInfo');

package/commands/customObject/create.js

@@ -1,5 +1,5 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 const { getAbsoluteFilePath } = require('@hubspot/cli-lib/path');
 const {
   isFileValidJSON,

package/commands/customObject/schema/create.js

@@ -1,5 +1,7 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const {
+  logErrorInstance,
+} = require('../../../lib/errorHandlers/standardErrors');
 const { getAbsoluteFilePath } = require('@hubspot/cli-lib/path');
 const {
   isFileValidJSON,

package/commands/customObject/schema/delete.js

@@ -1,5 +1,7 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const {
+  logErrorInstance,
+} = require('../../../lib/errorHandlers/standardErrors');
 
 const { loadAndValidateOptions } = require('../../../lib/validation');
 const { trackCommandUsage } = require('../../../lib/usageTracking');

package/commands/customObject/schema/fetch-all.js

@@ -1,5 +1,7 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const {
+  logErrorInstance,
+} = require('../../../lib/errorHandlers/standardErrors');
 
 const { loadAndValidateOptions } = require('../../../lib/validation');
 const { trackCommandUsage } = require('../../../lib/usageTracking');

package/commands/customObject/schema/fetch.js

@@ -1,7 +1,9 @@
 const path = require('path');
 const { isConfigFlagEnabled } = require('@hubspot/cli-lib');
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const {
+  logErrorInstance,
+} = require('../../../lib/errorHandlers/standardErrors');
 const { ConfigFlags } = require('@hubspot/cli-lib/lib/constants');
 const { downloadSchema, getResolvedPath } = require('@hubspot/cli-lib/schema');
 const { fetchSchema } = require('@hubspot/cli-lib/api/fileTransport');

package/commands/customObject/schema/list.js

@@ -1,5 +1,7 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const {
+  logErrorInstance,
+} = require('../../../lib/errorHandlers/standardErrors');
 
 const { loadAndValidateOptions } = require('../../../lib/validation');
 const { trackCommandUsage } = require('../../../lib/usageTracking');

package/commands/customObject/schema/update.js

@@ -1,5 +1,7 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const {
+  logErrorInstance,
+} = require('../../../lib/errorHandlers/standardErrors');
 const { getAbsoluteFilePath } = require('@hubspot/cli-lib/path');
 const {
   isFileValidJSON,

package/commands/filemanager/upload.js

@@ -6,10 +6,10 @@ const { uploadFile } = require('@hubspot/cli-lib/api/fileManager');
 const { getCwd, convertToUnixPath } = require('@hubspot/cli-lib/path');
 const { logger } = require('@hubspot/cli-lib/logger');
 const {
-  logErrorInstance,
   ApiErrorContext,
   logApiUploadErrorInstance,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 const { validateSrcAndDestPaths } = require('@hubspot/cli-lib/modules');
 const { shouldIgnoreFile } = require('@hubspot/cli-lib/ignoreRules');
 

package/commands/functions/deploy.js

@@ -9,7 +9,7 @@ const { trackCommandUsage } = require('../../lib/usageTracking');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { POLLING_DELAY } = require('@hubspot/cli-lib/lib/constants');
 const { logger } = require('@hubspot/cli-lib/logger');
 const {

package/commands/functions/list.js

@@ -3,7 +3,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { getFunctionArrays } = require('../../lib/getFunctionArrays');
 const {
   getTableContents,

package/commands/hubdb/clear.js

@@ -1,5 +1,5 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 const { clearHubDbTableRows } = require('@hubspot/cli-lib/hubdb');
 const { publishTable } = require('@hubspot/cli-lib/api/hubdb');
 

package/commands/hubdb/create.js

@@ -1,7 +1,7 @@
 const path = require('path');
 
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 const { getCwd } = require('@hubspot/cli-lib/path');
 const { createHubDbTable } = require('@hubspot/cli-lib/hubdb');
 

package/commands/hubdb/delete.js

@@ -1,5 +1,5 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 const { deleteTable } = require('@hubspot/cli-lib/api/hubdb');
 const { loadAndValidateOptions } = require('../../lib/validation');
 const { trackCommandUsage } = require('../../lib/usageTracking');

package/commands/hubdb/fetch.js

@@ -1,5 +1,5 @@
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 const { downloadHubDbTable } = require('@hubspot/cli-lib/hubdb');
 
 const { loadAndValidateOptions } = require('../../lib/validation');

package/commands/init.js

@@ -9,7 +9,7 @@ const {
 const { addConfigOptions } = require('../lib/commonOpts');
 const { handleExit } = require('../lib/process');
 const { checkAndUpdateGitignore } = require('@hubspot/cli-lib/lib/git');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../lib/errorHandlers/standardErrors');
 const {
   DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME,
   PERSONAL_ACCESS_KEY_AUTH_METHOD,

package/commands/lint.js

@@ -1,7 +1,7 @@
 const { lint } = require('@hubspot/cli-lib/validate');
 const { printHublValidationResult } = require('../lib/hublValidate');
 const { logger } = require('@hubspot/cli-lib/logger');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../lib/errorHandlers/standardErrors');
 
 const {
   addConfigOptions,

package/commands/list.js

@@ -12,7 +12,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../lib/errorHandlers/apiErrors');
 const {
   getDirectoryContentsByPath,
 } = require('@hubspot/cli-lib/api/fileMapper');

package/commands/mv.js

@@ -3,7 +3,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../lib/errorHandlers/apiErrors');
 
 const {
   addConfigOptions,

package/commands/project/add.js

@@ -1,6 +1,6 @@
 const { logger } = require('@hubspot/cli-lib/logger');
 const { getAccountId } = require('@hubspot/cli-lib/lib/config');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 const { fetchReleaseData } = require('@hubspot/cli-lib/github');
 
 const { trackCommandUsage } = require('../../lib/usageTracking');

package/commands/project/create.js

@@ -67,6 +67,7 @@ exports.handler = async options => {
     'projectDevCommand',
     'projectHelpCommand',
     'feedbackCommand',
+    'sampleProjects',
   ]);
 };
 

package/commands/project/deploy.js

@@ -9,7 +9,7 @@ const { trackCommandUsage } = require('../../lib/usageTracking');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { logger } = require('@hubspot/cli-lib/logger');
 const { deployProject, fetchProject } = require('@hubspot/cli-lib/api/dfs');
 const { loadAndValidateOptions } = require('../../lib/validation');

package/commands/project/dev.js

@@ -50,18 +50,17 @@ const {
   PROJECT_DEPLOY_TEXT,
   ERROR_TYPES,
 } = require('@hubspot/cli-lib/lib/constants');
-const {
-  logErrorInstance,
-  logApiErrorInstance,
-  ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+
 const { buildSandbox } = require('../../lib/sandbox-create');
 const { syncSandbox } = require('../../lib/sandbox-sync');
 const { getHubSpotWebsiteOrigin } = require('@hubspot/cli-lib/lib/urls');
 const {
+  logApiErrorInstance,
+  ApiErrorContext,
   isMissingScopeError,
   isSpecifiedError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
+} = require('../../lib/errorHandlers/apiErrors');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 
 const i18nKey = 'cli.commands.project.subcommands.dev';
 

package/commands/project/download.js

@@ -10,7 +10,7 @@ const { getCwd } = require('@hubspot/cli-lib/path');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { logger } = require('@hubspot/cli-lib/logger');
 const { extractZipArchive } = require('@hubspot/cli-lib/archive');
 const {

package/commands/project/listBuilds.js

@@ -11,7 +11,7 @@ const { i18n } = require('../../lib/lang');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { logger } = require('@hubspot/cli-lib/logger');
 const {
   fetchProject,

package/commands/project/logs.js

@@ -25,7 +25,7 @@ const {
 // const {
 //   logApiErrorInstance,
 //   ApiErrorContext,
-// } = require('@hubspot/cli-lib/errorHandlers');
+// } = require('../../lib/errorHandlers/apiErrors');
 // const {
 //   getFunctionLogs,
 //   getLatestFunctionLog,

package/commands/project/upload.js

@@ -21,13 +21,11 @@ const {
 const { i18n } = require('../../lib/lang');
 const { getAccountConfig } = require('@hubspot/cli-lib');
 const { ERROR_TYPES } = require('@hubspot/cli-lib/lib/constants');
-const {
-  isSpecifiedError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+  isSpecifiedError,
+} = require('../../lib/errorHandlers/apiErrors');
 const { EXIT_CODES } = require('../../lib/enums/exitCodes');
 
 const i18nKey = 'cli.commands.project.subcommands.upload';

package/commands/project/watch.js

@@ -3,7 +3,7 @@ const { createWatcher } = require('../../lib/projectsWatch');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { logger } = require('@hubspot/cli-lib/logger');
 const { ERROR_TYPES } = require('@hubspot/cli-lib/lib/constants');
 const {

package/commands/remove.js

@@ -3,7 +3,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../lib/errorHandlers/apiErrors');
 
 const {
   addConfigOptions,

package/commands/sandbox/create.js

@@ -32,10 +32,8 @@ const {
 } = require('../../lib/prompts/sandboxesPrompt');
 const { promptUser } = require('../../lib/prompts/promptUtils');
 const { syncSandbox } = require('../../lib/sandbox-sync');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
-const {
-  isMissingScopeError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
+const { isMissingScopeError } = require('../../lib/errorHandlers/apiErrors');
 const { getHubSpotWebsiteOrigin } = require('@hubspot/cli-lib/lib/urls');
 
 const i18nKey = 'cli.commands.sandbox.subcommands.create';

package/commands/sandbox/delete.js

@@ -9,9 +9,13 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const { trackCommandUsage } = require('../../lib/usageTracking');
 const { loadAndValidateOptions } = require('../../lib/validation');
 const {
+  logErrorInstance,
   debugErrorAndContext,
-} = require('@hubspot/cli-lib/errorHandlers/standardErrors');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/standardErrors');
+const {
+  isSpecifiedError,
+  isSpecifiedHubSpotAuthError,
+} = require('../../lib/errorHandlers/apiErrors');
 const { deleteSandbox } = require('@hubspot/cli-lib/sandboxes');
 const { i18n } = require('../../lib/lang');
 const { getConfig, getEnv, getAccountConfig } = require('@hubspot/cli-lib');
@@ -26,10 +30,7 @@ const {
 const { EXIT_CODES } = require('../../lib/enums/exitCodes');
 const { promptUser } = require('../../lib/prompts/promptUtils');
 const { getHubSpotWebsiteOrigin } = require('@hubspot/cli-lib/lib/urls');
-const {
-  isSpecifiedError,
-  isSpecifiedHubSpotAuthError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
+
 const { getAccountName } = require('../../lib/sandboxes');
 const { getValidEnv } = require('@hubspot/cli-lib/lib/environment');
 

package/commands/sandbox/sync.js

@@ -24,12 +24,8 @@ const {
 } = require('../../lib/sandboxes');
 const { syncSandbox } = require('../../lib/sandbox-sync');
 const { getValidEnv } = require('@hubspot/cli-lib/lib/environment');
-const {
-  isSpecifiedError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
-const {
-  logErrorInstance,
-} = require('@hubspot/cli-lib/errorHandlers/standardErrors');
+const { isSpecifiedError } = require('../../lib/errorHandlers/apiErrors');
+const { logErrorInstance } = require('../../lib/errorHandlers/standardErrors');
 
 const i18nKey = 'cli.commands.sandbox.subcommands.sync';
 

package/commands/secrets/addSecret.js

@@ -2,7 +2,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logServerlessFunctionApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { addSecret } = require('@hubspot/cli-lib/api/secrets');
 
 const { loadAndValidateOptions } = require('../../lib/validation');

package/commands/secrets/deleteSecret.js

@@ -2,7 +2,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logServerlessFunctionApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { deleteSecret } = require('@hubspot/cli-lib/api/secrets');
 
 const { loadAndValidateOptions } = require('../../lib/validation');

package/commands/secrets/listSecrets.js

@@ -2,7 +2,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logServerlessFunctionApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { fetchSecrets } = require('@hubspot/cli-lib/api/secrets');
 
 const { loadAndValidateOptions } = require('../../lib/validation');

package/commands/secrets/updateSecret.js

@@ -2,7 +2,7 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   logServerlessFunctionApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { updateSecret } = require('@hubspot/cli-lib/api/secrets');
 
 const { loadAndValidateOptions } = require('../../lib/validation');

package/commands/upload.js

@@ -10,10 +10,10 @@ const {
 } = require('@hubspot/cli-lib/path');
 const { logger } = require('@hubspot/cli-lib/logger');
 const {
-  logErrorInstance,
   ApiErrorContext,
   logApiUploadErrorInstance,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../lib/errorHandlers/apiErrors');
+const { logErrorInstance } = require('../lib/errorHandlers/standardErrors');
 const { validateSrcAndDestPaths } = require('@hubspot/cli-lib/modules');
 const { shouldIgnoreFile } = require('@hubspot/cli-lib/ignoreRules');
 

package/lang/en.lyaml

@@ -994,6 +994,10 @@ en:
             sandboxSyncStandardCommand:
               command: "hs sandbox sync"
               message: "Run {{ command }} to to update all supported assets to your sandbox from production"
+            sampleProjects:
+              linkText: "HubSpot's sample projects"
+              url: "https://developers.hubspot.com/docs/platform/sample-projects?utm_source=cli&utm_content=project_create_whats_next"
+              message: "See {{ link }}"
       commonOpts:
         options:
           portal:
@@ -1259,6 +1263,37 @@ en:
               label: "Lead Flows"
             marketing-email:
               label: "Marketing emails"
+      errorHandlers:
+        standardErrors:
+          errorOccurred: "Error: {{ error }}"
+          errorContext: "Context: {{ context }}"
+          systemErrorOccurred: "A system error has occurred: {{ errorMessage }}"
+          genericErrorOccurred: "A {{ name }} has occurred."
+          unknownErrorOccurred: "An unknown error has occurred"
+        fileSystemErrors:
+          errorOccurred: "An error occurred while {{ fileAction }} {{ filepath }}."
+          errorExplanation: "This is the result of a system error: {{ errorMessage }}"
+        apiErrors:
+          messageDetail: "{{ request }} in account {{ accountId }}"
+          unableToUpload: 'Unable to upload "{{ payload }}.'
+          codes:
+            400: "The {{ messageDetail }} was bad."
+            401: "The {{ messageDetail }} was unauthorized."
+            403MissingScope: "Couldn't run the project command because there are scopes missing in your production account. To update scopes, deactivate your current personal access key for {{ accountId }}, and generate a new one. Then run `hs auth` to update the CLI with the new key."
+            403Gating: "The current target account {{ accountId }} does not have access to HubSpot projects. To opt in to the CRM Development Beta and use projects, visit https://app.hubspot.com/l/whats-new/betas?productUpdateId=13860216."
+            403: "The {{ messageDetail }} was forbidden."
+            404Request: 'The {{ action }} failed because "{{ request }}" was not found in account {{ accountId }}.'
+            404: "The {{ messageDetail }} was not found."
+            429: "The {{ messageDetail }} surpassed the rate limit. Retry in one minute."
+            503: "The {{ messageDetail }} could not be handled at this time. Please try again or visit https://help.hubspot.com/ to submit a ticket or contact HubSpot Support if the issue persists."
+            500generic: "The {{ messageDetail }} failed due to a server error. Please try again or visit https://help.hubspot.com/ to submit a ticket or contact HubSpot Support if the issue persists."
+            400generic: "The {{ messageDetail }} failed due to a client error."
+            generic: "The {{ messageDetail }} failed."
+          verifyAccessKeyAndUserAccess:
+            fetchScopeDataError: "Error verifying access of scopeGroup {{ scopeGroup }}: {{ error }}"
+            portalMissingScope: "Your account does not have access to this action. Talk to an account admin to request it."
+            userMissingScope: "You don't have access to this action. Ask an account admin to change your permissions in Users & Teams settings."
+            genericMissingScope: "Your access key does not allow this action. Please generate a new access key by running `hs auth personalaccesskey`."
 
 
 

package/lib/errorHandlers/apiErrors.js

@@ -0,0 +1,352 @@
+const { logger } = require('@hubspot/cli-lib/logger');
+const { getAccountConfig } = require('@hubspot/cli-lib/lib/config');
+const {
+  SCOPE_GROUPS,
+  PERSONAL_ACCESS_KEY_AUTH_METHOD,
+} = require('@hubspot/cli-lib/lib/constants');
+const {
+  fetchScopeData,
+} = require('@hubspot/cli-lib/api/localDevAuth/authenticated');
+const {
+  debugErrorAndContext,
+  logErrorInstance,
+  ErrorContext,
+} = require('./standardErrors');
+const { i18n } = require('../lang');
+
+const i18nKey = 'cli.lib.errorHandlers.apiErrors';
+
+const isApiStatusCodeError = err =>
+  err.name === 'StatusCodeError' ||
+  (err.statusCode >= 100 && err.statusCode < 600);
+
+const isApiUploadValidationError = err =>
+  !!(
+    err.statusCode === 400 &&
+    err.response &&
+    err.response.body &&
+    (err.response.body.message || err.response.body.errors)
+  );
+
+const isMissingScopeError = err =>
+  err.name === 'StatusCodeError' &&
+  err.statusCode === 403 &&
+  err.error &&
+  err.error.category === 'MISSING_SCOPES';
+
+const isGatingError = err =>
+  isSpecifiedError(err, { statusCode: 403, category: 'GATED' });
+
+const isSpecifiedError = (err, { statusCode, category, subCategory } = {}) => {
+  const statusCodeErr = !statusCode || err.statusCode === statusCode;
+  const categoryErr =
+    !category || (err.error && err.error.category === category);
+  const subCategoryErr =
+    !subCategory || (err.error && err.error.subCategory === subCategory);
+
+  return (
+    err.name === 'StatusCodeError' &&
+    statusCodeErr &&
+    categoryErr &&
+    subCategoryErr
+  );
+};
+
+const isSpecifiedHubSpotAuthError = (
+  err,
+  { statusCode, category, subCategory }
+) => {
+  const statusCodeErr = !statusCode || err.statusCode === statusCode;
+  const categoryErr = !category || err.category === category;
+  const subCategoryErr = !subCategory || err.subCategory === subCategory;
+  return (
+    err.name === 'HubSpotAuthError' &&
+    statusCodeErr &&
+    categoryErr &&
+    subCategoryErr
+  );
+};
+
+const parseValidationErrors = (responseBody = {}) => {
+  const errorMessages = [];
+
+  const { errors, message } = responseBody;
+
+  if (message) {
+    errorMessages.push(message);
+  }
+
+  if (errors) {
+    const specificErrors = errors.map(error => {
+      let errorMessage = error.message;
+      if (error.errorTokens && error.errorTokens.line) {
+        errorMessage = `line ${error.errorTokens.line}: ${errorMessage}`;
+      }
+      return errorMessage;
+    });
+    errorMessages.push(...specificErrors);
+  }
+
+  return errorMessages;
+};
+
+class ApiErrorContext extends ErrorContext {
+  constructor(props = {}) {
+    super(props);
+    /** @type {string} */
+    this.request = props.request || '';
+    /** @type {string} */
+    this.payload = props.payload || '';
+    /** @type {string} */
+    this.projectName = props.projectName || '';
+  }
+}
+
+/**
+ * @param {Error}           error
+ * @param {ApiErrorContext} context
+ */
+function logValidationErrors(error, context) {
+  const { response = {} } = error;
+  const validationErrors = parseValidationErrors(response.body);
+  if (validationErrors.length) {
+    validationErrors.forEach(err => {
+      logger.error(err);
+    });
+  }
+  debugErrorAndContext(error, context);
+}
+
+/**
+ * Message segments for API messages.
+ *
+ * @enum {string}
+ */
+const ApiMethodVerbs = {
+  DEFAULT: 'request',
+  DELETE: 'delete',
+  GET: 'request',
+  PATCH: 'update',
+  POST: 'post',
+  PUT: 'update',
+};
+
+/**
+ * Message segments for API messages.
+ *
+ * @enum {string}
+ */
+const ApiMethodPrepositions = {
+  DEFAULT: 'for',
+  DELETE: 'of',
+  GET: 'for',
+  PATCH: 'to',
+  POST: 'to',
+  PUT: 'to',
+};
+
+/**
+ * Logs messages for an error instance resulting from API interaction.
+ *
+ * @param {StatusCodeError} error
+ * @param {ApiErrorContext} context
+ */
+function logApiStatusCodeError(error, context) {
+  const { statusCode } = error;
+  const { method } = error.options || {};
+  const { projectName } = context;
+  const isPutOrPost = method === 'PUT' || method === 'POST';
+  const action = ApiMethodVerbs[method] || ApiMethodVerbs.DEFAULT;
+  const preposition =
+    ApiMethodPrepositions[method] || ApiMethodPrepositions.DEFAULT;
+  let messageDetail = '';
+  {
+    const request = context.request
+      ? `${action} ${preposition} "${context.request}"`
+      : action;
+    messageDetail = `${request} in account ${context.accountId}`;
+  }
+  const errorMessage = [];
+  if (isPutOrPost && context.payload) {
+    errorMessage.push(`Unable to upload "${context.payload}".`);
+  }
+  const isProjectMissingScopeError = isMissingScopeError(error) && projectName;
+  const isProjectGatingError = isGatingError(error) && projectName;
+  switch (statusCode) {
+    case 400:
+      errorMessage.push(i18n(`${i18nKey}.codes.400`, { messageDetail }));
+      break;
+    case 401:
+      errorMessage.push(i18n(`${i18nKey}.codes.401`, { messageDetail }));
+      break;
+    case 403:
+      if (isProjectMissingScopeError) {
+        errorMessage.push(
+          i18n(`${i18nKey}.codes.403MissingScope`, {
+            accountId: context.accountId || '',
+          })
+        );
+      } else if (isProjectGatingError) {
+        errorMessage.push(
+          i18n(`${i18nKey}.codes.403Gating`, {
+            accountId: context.accountId || '',
+          })
+        );
+      } else {
+        errorMessage.push(i18n(`${i18nKey}.codes.403`, { messageDetail }));
+      }
+      break;
+    case 404:
+      if (context.request) {
+        errorMessage.push(
+          i18n(`${i18nKey}.codes.404Request`, {
+            action: action || 'request',
+            request: context.request,
+            account: context.accountId || '',
+          })
+        );
+      } else {
+        errorMessage.push(i18n(`${i18nKey}.codes.404`, { messageDetail }));
+      }
+      break;
+    case 429:
+      errorMessage.push(i18n(`${i18nKey}.codes.429`, { messageDetail }));
+      break;
+    case 503:
+      errorMessage.push(i18n(`${i18nKey}.codes.503`, { messageDetail }));
+      break;
+    default:
+      if (statusCode >= 500 && statusCode < 600) {
+        errorMessage.push(
+          i18n(`${i18nKey}.codes.500Generic`, { messageDetail })
+        );
+      } else if (statusCode >= 400 && statusCode < 500) {
+        i18n(`${i18nKey}.codes.400Generic`, { messageDetail });
+      } else {
+        errorMessage.push(i18n(`${i18nKey}.codes.generic`, { messageDetail }));
+      }
+      break;
+  }
+  if (
+    error.error &&
+    error.error.message &&
+    !isProjectMissingScopeError &&
+    !isProjectGatingError
+  ) {
+    errorMessage.push(error.error.message);
+  }
+  if (error.error && error.error.errors) {
+    error.error.errors.forEach(err => {
+      errorMessage.push('\n- ' + err.message);
+    });
+  }
+  logger.error(errorMessage.join(' '));
+  debugErrorAndContext(error, context);
+}
+
+/**
+ * Logs a message for an error instance resulting from API interaction.
+ *
+ * @param {Error|SystemError|Object} error
+ * @param {ApiErrorContext}          context
+ */
+function logApiErrorInstance(error, context) {
+  // StatusCodeError
+  if (isApiStatusCodeError(error)) {
+    logApiStatusCodeError(error, context);
+    return;
+  }
+  logErrorInstance(error, context);
+}
+
+/**
+ * Logs a message for an error instance resulting from filemapper API upload.
+ *
+ * @param {Error|SystemError|Object} error
+ * @param {ApiErrorContext}          context
+ */
+function logApiUploadErrorInstance(error, context) {
+  if (isApiUploadValidationError(error)) {
+    logValidationErrors(error, context);
+    return;
+  }
+  logApiErrorInstance(error, context);
+}
+
+async function verifyAccessKeyAndUserAccess(accountId, scopeGroup) {
+  const accountConfig = getAccountConfig(accountId);
+  const { authType } = accountConfig;
+  if (authType !== PERSONAL_ACCESS_KEY_AUTH_METHOD.value) {
+    return;
+  }
+
+  let scopesData;
+  try {
+    scopesData = await fetchScopeData(accountId, scopeGroup);
+  } catch (e) {
+    logger.debug(
+      i18n(`${i18nKey}.verifyAccessKeyAndUserAccess.fetchScopeDataError`, {
+        scopeGroup,
+        error: e,
+      })
+    );
+    return;
+  }
+  const { portalScopesInGroup, userScopesInGroup } = scopesData;
+
+  if (!portalScopesInGroup.length) {
+    logger.error(
+      i18n(`${i18nKey}.verifyAccessKeyAndUserAccess.portalMissingScope`)
+    );
+    return;
+  }
+
+  if (!portalScopesInGroup.every(s => userScopesInGroup.includes(s))) {
+    logger.error(
+      i18n(`${i18nKey}.verifyAccessKeyAndUserAccess.userMissingScope`)
+    );
+    return;
+  } else {
+    logger.error(
+      i18n(`${i18nKey}.verifyAccessKeyAndUserAccess.genericMissingScope`)
+    );
+    return;
+  }
+}
+
+/**
+ * Logs a message for an error instance resulting from API interaction
+ * related to serverless function.
+ *
+ * @param {int} accountId
+ * @param {Error|SystemError|Object} error
+ * @param {ApiErrorContext}          context
+ */
+async function logServerlessFunctionApiErrorInstance(
+  accountId,
+  error,
+  context
+) {
+  if (isMissingScopeError(error)) {
+    await verifyAccessKeyAndUserAccess(accountId, SCOPE_GROUPS.functions);
+    return;
+  }
+
+  // StatusCodeError
+  if (isApiStatusCodeError(error)) {
+    logApiStatusCodeError(error, context);
+    return;
+  }
+  logErrorInstance(error, context);
+}
+
+module.exports = {
+  ApiErrorContext,
+  parseValidationErrors,
+  logApiErrorInstance,
+  logApiUploadErrorInstance,
+  logServerlessFunctionApiErrorInstance,
+  isMissingScopeError,
+  isSpecifiedError,
+  isSpecifiedHubSpotAuthError,
+};

package/lib/errorHandlers/fileSystemErrors.js

@@ -0,0 +1,55 @@
+const { logger } = require('@hubspot/cli-lib/logger');
+const {
+  ErrorContext,
+  isSystemError,
+  debugErrorAndContext,
+} = require('./standardErrors');
+const { i18n } = require('../lang');
+
+const i18nKey = 'cli.lib.errorHandlers.fileSystemErrors';
+
+class FileSystemErrorContext extends ErrorContext {
+  constructor(props = {}) {
+    super(props);
+    /** @type {string} */
+    this.filepath = props.filepath || '';
+    /** @type {boolean} */
+    this.read = !!props.read;
+    /** @type {boolean} */
+    this.write = !!props.write;
+  }
+}
+
+/**
+ * Logs a message for an error instance resulting from filesystem interaction.
+ *
+ * @param {Error|SystemError|Object} error
+ * @param {FileSystemErrorContext}   context
+ */
+function logFileSystemErrorInstance(error, context) {
+  let fileAction = '';
+  if (context.read) {
+    fileAction = 'reading from';
+  } else if (context.write) {
+    fileAction = 'writing to';
+  } else {
+    fileAction = 'accessing';
+  }
+  const filepath = context.filepath
+    ? `"${context.filepath}"`
+    : 'a file or folder';
+  const message = [i18n(`${i18nKey}.errorOccurred`, { fileAction, filepath })];
+  // Many `fs` errors will be `SystemError`s
+  if (isSystemError(error)) {
+    message.push(
+      i18n(`${i18nKey}.errorExplanation`, { errorMessage: error.message })
+    );
+  }
+  logger.error(message.join(' '));
+  debugErrorAndContext(error, context);
+}
+
+module.exports = {
+  FileSystemErrorContext,
+  logFileSystemErrorInstance,
+};

package/lib/errorHandlers/standardErrors.js

@@ -0,0 +1,95 @@
+const { HubSpotAuthError } = require('@hubspot/cli-lib/lib/models/Errors');
+const { logger } = require('@hubspot/cli-lib/logger');
+const { i18n } = require('../lang');
+
+const i18nKey = 'cli.lib.errorHandlers.standardErrors';
+
+const isSystemError = err =>
+  err.errno != null && err.code != null && err.syscall != null;
+const isFatalError = err => err instanceof HubSpotAuthError;
+
+// TODO: Make these TS interfaces
+class ErrorContext {
+  constructor(props = {}) {
+    /** @type {number} */
+    this.accountId = props.accountId;
+  }
+}
+
+/**
+ * Logs (debug) the error and context objects.
+ *
+ * @param {SystemError}  error
+ * @param {ErrorContext} context
+ */
+function debugErrorAndContext(error, context) {
+  if (error.name === 'StatusCodeError') {
+    const { statusCode, message, response } = error;
+    logger.debug(
+      i18n(`${i18nKey}.errorOccurred`, {
+        error: {
+          statusCode,
+          message,
+          url: response.request.href,
+          method: response.request.method,
+          response: response.body,
+          headers: response.headers,
+        },
+      })
+    );
+  } else {
+    logger.debug(i18n(`${i18nKey}.errorOccurred`, { error }));
+  }
+  logger.debug(i18n(`${i18nKey}.errorContext`, { context }));
+}
+
+/**
+ * Logs a SystemError
+ * @see {@link https://nodejs.org/api/errors.html#errors_class_systemerror}
+ *
+ * @param {SystemError}  error
+ * @param {ErrorContext} context
+ */
+function logSystemError(error, context) {
+  logger.error(
+    i18n(`${i18nKey}.systemErrorOccurred`, { error: error.message })
+  );
+  debugErrorAndContext(error, context);
+}
+
+/**
+ * Logs a message for an error instance of type not asserted.
+ *
+ * @param {Error|SystemError|Object} error
+ * @param {ErrorContext}             context
+ */
+function logErrorInstance(error, context) {
+  // SystemError
+  if (isSystemError(error)) {
+    logSystemError(error, context);
+    return;
+  }
+  if (error instanceof Error || error.message || error.reason) {
+    // Error or Error subclass
+    const name = error.name || 'Error';
+    const message = [i18n(`${i18nKey}.genericErrorOccurred`, { name })];
+    [(error.message, error.reason)].forEach(msg => {
+      if (msg) {
+        message.push(msg);
+      }
+    });
+    logger.error(message.join(' '));
+  } else {
+    // Unknown errors
+    logger.error(i18n(`${i18nKey}.unknownErrorOccurred`));
+  }
+  debugErrorAndContext(error, context);
+}
+
+module.exports = {
+  debugErrorAndContext,
+  ErrorContext,
+  isFatalError,
+  isSystemError,
+  logErrorInstance,
+};

package/lib/projects.js

@@ -29,10 +29,6 @@ const {
   fetchProject,
   uploadProject,
 } = require('@hubspot/cli-lib/api/dfs');
-const {
-  logApiErrorInstance,
-  ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
 const { shouldIgnoreFile } = require('@hubspot/cli-lib/ignoreRules');
 const { getCwd, getAbsoluteFilePath } = require('@hubspot/cli-lib/path');
 const { downloadGitHubRepoContents } = require('@hubspot/cli-lib/github');
@@ -42,9 +38,11 @@ const { uiLine, uiLink, uiAccountDescription } = require('../lib/ui');
 const { i18n } = require('./lang');
 const SpinniesManager = require('./SpinniesManager');
 const {
+  logApiErrorInstance,
+  ApiErrorContext,
   isSpecifiedError,
   isSpecifiedHubSpotAuthError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
+} = require('./errorHandlers/apiErrors');
 const { HUBSPOT_PROJECT_COMPONENTS_GITHUB_PATH } = require('./constants');
 
 const i18nKey = 'cli.lib.projects';

package/lib/projectsWatch.js

@@ -5,7 +5,7 @@ const { default: PQueue } = require('p-queue');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('./errorHandlers/apiErrors');
 const { i18n } = require('@hubspot/cli-lib/lib/lang');
 const { logger } = require('@hubspot/cli-lib/logger');
 const { isAllowedExtension } = require('@hubspot/cli-lib/path');

package/lib/prompts/downloadProjectPrompt.js

@@ -4,7 +4,7 @@ const { fetchProjects } = require('@hubspot/cli-lib/api/dfs');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { EXIT_CODES } = require('../enums/exitCodes');
 const { i18n } = require('../lang');
 

package/lib/prompts/projectsLogsPrompt.js

@@ -6,7 +6,7 @@ const { getProjectConfig, ensureProjectExists } = require('../projects');
 const {
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('../../lib/errorHandlers/apiErrors');
 const { logger } = require('@hubspot/cli-lib/logger');
 const { EXIT_CODES } = require('../enums/exitCodes');
 

package/lib/sandbox-create.js

@@ -12,11 +12,11 @@ const { logger } = require('@hubspot/cli-lib/logger');
 const {
   debugErrorAndContext,
   logErrorInstance,
-} = require('@hubspot/cli-lib/errorHandlers/standardErrors');
+} = require('./errorHandlers/standardErrors');
 const {
   isMissingScopeError,
   isSpecifiedError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
+} = require('./errorHandlers/apiErrors');
 const { getHubSpotWebsiteOrigin } = require('@hubspot/cli-lib/lib/urls');
 const { getEnv, getAccountId } = require('@hubspot/cli-lib');
 const { createSandbox } = require('@hubspot/cli-lib/sandboxes');

package/lib/sandbox-sync.js

@@ -11,17 +11,17 @@ const {
   syncTypes,
 } = require('./sandboxes');
 const { initiateSync } = require('@hubspot/cli-lib/sandboxes');
-const { logErrorInstance } = require('@hubspot/cli-lib/errorHandlers');
+const {
+  debugErrorAndContext,
+  logErrorInstance,
+} = require('./errorHandlers/standardErrors');
 const {
   isSpecifiedError,
   isMissingScopeError,
-} = require('@hubspot/cli-lib/errorHandlers/apiErrors');
+} = require('./errorHandlers/apiErrors');
 const { getSandboxTypeAsString } = require('./sandboxes');
 const { getAccountId } = require('@hubspot/cli-lib');
 const { uiAccountDescription } = require('./ui');
-const {
-  debugErrorAndContext,
-} = require('@hubspot/cli-lib/errorHandlers/standardErrors');
 
 const i18nKey = 'cli.lib.sandbox.sync';
 

package/lib/serverlessLogs.js

@@ -8,7 +8,7 @@ const {
   logServerlessFunctionApiErrorInstance,
   logApiErrorInstance,
   ApiErrorContext,
-} = require('@hubspot/cli-lib/errorHandlers');
+} = require('./errorHandlers/apiErrors');
 const { base64EncodeString } = require('@hubspot/cli-lib/lib/encoding');
 
 const { EXIT_CODES } = require('../lib/enums/exitCodes');

package/lib/ui.js

@@ -106,6 +106,7 @@ const uiFeatureHighlight = (commands, title) => {
       const commandKey = `${i18nKey}.commandKeys.${c}`;
       const message = i18n(`${commandKey}.message`, {
         command: uiCommandReference(i18n(`${commandKey}.command`)),
+        link: uiLink(i18n(`${commandKey}.linkText`), i18n(`${commandKey}.url`)),
       });
       if (i !== 0) {
         logger.log('');

package/lib/validation.js

@@ -13,7 +13,7 @@ const {
   OAUTH_AUTH_METHOD,
   PERSONAL_ACCESS_KEY_AUTH_METHOD,
 } = require('@hubspot/cli-lib/lib/constants');
-const { commaSeparatedValues } = require('@hubspot/cli-lib/lib/text');
+const { commaSeparatedValues } = require('@hubspot/local-dev-lib/text');
 const { getAbsoluteFilePath } = require('@hubspot/cli-lib/path');
 const { getOauthManager } = require('@hubspot/cli-lib/oauth');
 const {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubspot/cli",
-  "version": "5.0.2-beta.1",
+  "version": "5.0.2",
   "description": "CLI for working with HubSpot",
   "license": "Apache-2.0",
   "repository": {
@@ -9,7 +9,8 @@
   },
   "dependencies": {
     "@hubspot/cli-lib": "^5.0.1",
-    "@hubspot/serverless-dev-runtime": "4.2.1-beta.3",
+    "@hubspot/local-dev-lib": "^0.0.7",
+    "@hubspot/serverless-dev-runtime": "5.0.2",
     "@hubspot/ui-extensions-dev-server": "^0.8.0",
     "archiver": "^5.3.0",
     "chalk": "^4.1.2",
@@ -44,5 +45,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ffa9b2bd4597057e8b0c640c9ceb9c37a12df19c"
+  "gitHead": "44cbdf6dae130e268015d3e9afb612729b539915"
 }