@hubspot/cli 8.18.0 → 8.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/commands/account/auth.js +2 -2
  2. package/commands/account/createOverride.js +2 -0
  3. package/commands/account/removeOverride.js +2 -0
  4. package/commands/app/secret/add.js +1 -1
  5. package/commands/app/secret/delete.js +1 -1
  6. package/commands/app/secret/list.js +1 -1
  7. package/commands/app/secret/update.js +1 -1
  8. package/commands/app/secret.js +1 -1
  9. package/commands/auth.js +3 -2
  10. package/commands/cms/function/create.js +5 -37
  11. package/commands/cms/function/deploy.js +8 -1
  12. package/commands/cms/function/list.js +4 -0
  13. package/commands/cms/function/logs.js +2 -0
  14. package/commands/cms/function/server.js +6 -0
  15. package/commands/cms/upload.js +6 -0
  16. package/commands/cms/watch.js +2 -0
  17. package/commands/cms/webpack/create.js +5 -32
  18. package/commands/customObject.js +2 -2
  19. package/commands/getStarted.js +4 -4
  20. package/commands/hubdb/list.js +2 -2
  21. package/commands/init.js +3 -2
  22. package/commands/mcp/setup.js +3 -2
  23. package/commands/project/dev/index.js +2 -2
  24. package/commands/project/logs.js +2 -2
  25. package/commands/project/upload.js +6 -2
  26. package/commands/project/watch.js +2 -2
  27. package/commands/sandbox/create.js +3 -3
  28. package/commands/sandbox/delete.js +1 -1
  29. package/commands/sandbox.js +1 -1
  30. package/lang/en.d.ts +26 -0
  31. package/lang/en.js +85 -43
  32. package/lib/accountAuth.js +12 -0
  33. package/lib/app/logSystemTypes.d.ts +4 -0
  34. package/lib/app/logSystemTypes.js +17 -0
  35. package/lib/app/logs.d.ts +2 -4
  36. package/lib/app/logs.js +2 -17
  37. package/lib/app/migrate.js +3 -3
  38. package/lib/constants.d.ts +2 -0
  39. package/lib/constants.js +4 -0
  40. package/lib/crossPlatformSpawn/escape.d.ts +2 -0
  41. package/lib/crossPlatformSpawn/escape.js +38 -0
  42. package/lib/crossPlatformSpawn/index.d.ts +7 -0
  43. package/lib/crossPlatformSpawn/index.js +43 -0
  44. package/lib/crossPlatformSpawn/resolveCommand.d.ts +1 -0
  45. package/lib/crossPlatformSpawn/resolveCommand.js +69 -0
  46. package/lib/errorHandlers/suppressError.js +3 -3
  47. package/lib/hints/hints.d.ts +9 -0
  48. package/lib/hints/hints.js +30 -0
  49. package/lib/hints/throttle.d.ts +4 -0
  50. package/lib/hints/throttle.js +9 -0
  51. package/lib/jsonOutput/projectUpload.d.ts +1 -0
  52. package/lib/jsonOutput/projectUpload.js +1 -0
  53. package/lib/mcp/promotion.js +15 -30
  54. package/lib/mcp/setup.d.ts +6 -1
  55. package/lib/mcp/setup.js +1 -1
  56. package/lib/middleware/deprecationWarningMiddleware.js +4 -9
  57. package/lib/projects/localDev/AppDevModeInterface.js +3 -3
  58. package/lib/projects/localDev/LocalDevLogger.js +5 -5
  59. package/lib/projects/localDev/helpers/project.js +3 -3
  60. package/lib/projects/pollProjectBuildAndDeploy.js +4 -4
  61. package/lib/projects/projectInfo.js +4 -4
  62. package/lib/projects/projectProfiles.js +3 -3
  63. package/lib/projects/ui.js +3 -3
  64. package/lib/projects/upload.d.ts +3 -1
  65. package/lib/projects/upload.js +23 -6
  66. package/lib/projects/watch.js +4 -2
  67. package/lib/projects/workspaces.js +4 -4
  68. package/lib/prompts/personalAccessKeyPrompt.js +2 -2
  69. package/lib/prompts/selectPublicAppForMigrationPrompt.js +3 -3
  70. package/lib/serverlessSunset.d.ts +6 -0
  71. package/lib/serverlessSunset.js +32 -0
  72. package/lib/ui/appLogs.js +4 -4
  73. package/lib/ui/formatting.d.ts +13 -0
  74. package/lib/ui/formatting.js +39 -0
  75. package/lib/ui/git.js +3 -3
  76. package/lib/ui/index.d.ts +9 -23
  77. package/lib/ui/index.js +36 -69
  78. package/lib/ui/logger.d.ts +1 -0
  79. package/lib/ui/logger.js +2 -1
  80. package/lib/ui/uiMessages.js +1 -1
  81. package/mcp-server/server.js +13 -5
  82. package/mcp-server/tools/cms/HsFunctionLogsTool.js +2 -2
  83. package/mcp-server/tools/cms/HsListFunctionsTool.js +1 -1
  84. package/mcp-server/tools/cms/HsListTool.js +4 -1
  85. package/mcp-server/tools/index.js +0 -2
  86. package/mcp-server/utils/command.js +16 -5
  87. package/package.json +9 -9
  88. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +0 -26
  89. package/mcp-server/tools/cms/HsCreateFunctionTool.js +0 -100
@@ -0,0 +1,38 @@
1
+ /*
2
+ * Adapted from cross-spawn 7.0.6 (lib/util/escape.js)
3
+ * https://github.com/moxystudio/node-cross-spawn
4
+ *
5
+ * The MIT License (MIT)
6
+ *
7
+ * Copyright (c) 2018 Made With MOXY Lda <hello@moxy.studio>
8
+ *
9
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
10
+ * of this software and associated documentation files (the "Software"), to deal
11
+ * in the Software without restriction, including without limitation the rights
12
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13
+ * copies of the Software, and to permit persons to whom the Software is
14
+ * furnished to do so, subject to the following conditions:
15
+ *
16
+ * The above copyright notice and this permission notice shall be included in
17
+ * all copies or substantial portions of the Software.
18
+ *
19
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
22
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25
+ * THE SOFTWARE.
26
+ */
27
+ const META_CHARS_PATTERN = /([()\][%!^"`<>&|;, *?])/g;
28
+ const BACKSLASHES_BEFORE_QUOTE_PATTERN = /(?=(\\+?)?)\1"/g;
29
+ const TRAILING_BACKSLASHES_PATTERN = /(?=(\\+?)?)\1$/;
30
+ export function escapeMetaCharacters(value) {
31
+ return value.replace(META_CHARS_PATTERN, '^$1');
32
+ }
33
+ export function escapeArgument(arg, doubleEscapeMetaChars) {
34
+ const quotesEscaped = arg.replace(BACKSLASHES_BEFORE_QUOTE_PATTERN, '$1$1\\"');
35
+ const trailingEscaped = quotesEscaped.replace(TRAILING_BACKSLASHES_PATTERN, '$1$1');
36
+ const escaped = escapeMetaCharacters(`"${trailingEscaped}"`);
37
+ return doubleEscapeMetaChars ? escapeMetaCharacters(escaped) : escaped;
38
+ }
@@ -0,0 +1,7 @@
1
+ import { type ChildProcessWithoutNullStreams } from 'node:child_process';
2
+ type CrossPlatformSpawnOptions = {
3
+ cwd: string;
4
+ env: NodeJS.ProcessEnv;
5
+ };
6
+ export declare function crossPlatformSpawn(command: string, args: string[], options: CrossPlatformSpawnOptions): ChildProcessWithoutNullStreams;
7
+ export {};
@@ -0,0 +1,43 @@
1
+ /*
2
+ * Adapted from cross-spawn 7.0.6 (index.js and lib/parse.js)
3
+ * https://github.com/moxystudio/node-cross-spawn
4
+ * The cross-spawn license is reproduced in escape.ts.
5
+ */
6
+ import path from 'path';
7
+ import { spawn } from 'node:child_process';
8
+ import { lib } from '../../lang/en.js';
9
+ import { escapeArgument, escapeMetaCharacters } from './escape.js';
10
+ import { resolveCommand } from './resolveCommand.js';
11
+ const DEFAULT_SHELL = 'cmd.exe';
12
+ const SKIP_CURRENT_DIRECTORY_ENV_VAR = 'NoDefaultCurrentDirectoryInExePath';
13
+ const CMD_SHIM_PATTERN = /node_modules[\\/].bin[\\/][^\\/]+\.cmd$/i;
14
+ const UNSAFE_ARG_PATTERN = /["%^&|<>\r\n]/;
15
+ const TRAILING_BACKSLASHES = '\\\\';
16
+ function isUnsafeArg(arg) {
17
+ return UNSAFE_ARG_PATTERN.test(arg) || arg.endsWith(TRAILING_BACKSLASHES);
18
+ }
19
+ function assertArgsAreSafe(args) {
20
+ const unsafeArg = args.find(isUnsafeArg);
21
+ if (unsafeArg !== undefined) {
22
+ throw new Error(lib.crossPlatformSpawn.unsafeArg(unsafeArg));
23
+ }
24
+ }
25
+ function buildShellLine(command, args, env) {
26
+ const file = resolveCommand(command, env);
27
+ const doubleEscapeMetaChars = file !== undefined && CMD_SHIM_PATTERN.test(file);
28
+ return [
29
+ escapeMetaCharacters(path.win32.normalize(command)),
30
+ ...args.map(arg => escapeArgument(arg, doubleEscapeMetaChars)),
31
+ ].join(' ');
32
+ }
33
+ export function crossPlatformSpawn(command, args, options) {
34
+ if (process.platform !== 'win32') {
35
+ return spawn(command, args, options);
36
+ }
37
+ assertArgsAreSafe(args);
38
+ return spawn(process.env.comspec || DEFAULT_SHELL, ['/d', '/s', '/c', `"${buildShellLine(command, args, options.env)}"`], {
39
+ ...options,
40
+ env: { ...options.env, [SKIP_CURRENT_DIRECTORY_ENV_VAR]: '1' },
41
+ windowsVerbatimArguments: true,
42
+ });
43
+ }
@@ -0,0 +1 @@
1
+ export declare function resolveCommand(command: string, env: NodeJS.ProcessEnv): string | undefined;
@@ -0,0 +1,69 @@
1
+ /*
2
+ * Adapted from cross-spawn 7.0.6 (lib/util/resolveCommand.js), whose
3
+ * license is reproduced in escape.ts, and from the packages below.
4
+ *
5
+ * which 2.0.2 (which.js) and isexe 2.0.0 (windows.js)
6
+ * https://github.com/isaacs/node-which
7
+ * https://github.com/isaacs/isexe
8
+ *
9
+ * The ISC License
10
+ *
11
+ * Copyright (c) Isaac Z. Schlueter and Contributors
12
+ *
13
+ * Permission to use, copy, modify, and/or distribute this software for any
14
+ * purpose with or without fee is hereby granted, provided that the above
15
+ * copyright notice and this permission notice appear in all copies.
16
+ *
17
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
18
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
19
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
20
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
21
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
22
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
23
+ * IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
24
+ *
25
+ * path-key 3.1.1 (index.js)
26
+ * https://github.com/sindresorhus/path-key
27
+ *
28
+ * MIT License
29
+ *
30
+ * Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
31
+ *
32
+ * Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
33
+ *
34
+ * The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
35
+ *
36
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
37
+ */
38
+ import fs from 'fs';
39
+ import path from 'path';
40
+ const PATH_DELIMITER = ';';
41
+ const DEFAULT_PATH_EXT = '.EXE;.CMD;.BAT;.COM';
42
+ const QUOTED_PATH_PATTERN = /^".*"$/;
43
+ function getPathKey(env) {
44
+ return (Object.keys(env)
45
+ .reverse()
46
+ .find(key => key.toUpperCase() === 'PATH') || 'Path');
47
+ }
48
+ function unquote(directory) {
49
+ return QUOTED_PATH_PATTERN.test(directory)
50
+ ? directory.slice(1, -1)
51
+ : directory;
52
+ }
53
+ function isFile(filePath) {
54
+ try {
55
+ return fs.statSync(filePath).isFile();
56
+ }
57
+ catch {
58
+ return false;
59
+ }
60
+ }
61
+ export function resolveCommand(command, env) {
62
+ const directories = (env[getPathKey(env)] || process.env.PATH || '')
63
+ .split(PATH_DELIMITER)
64
+ .map(unquote);
65
+ const extensions = (process.env.PATHEXT || DEFAULT_PATH_EXT).split(PATH_DELIMITER);
66
+ return directories
67
+ .flatMap(directory => extensions.map(extension => path.win32.join(directory, command + extension)))
68
+ .find(isFile);
69
+ }
@@ -2,7 +2,7 @@ import { isSpecifiedError, isMissingScopeError, } from '@hubspot/local-dev-lib/e
2
2
  import { uiLogger } from '../ui/logger.js';
3
3
  import { PLATFORM_VERSION_ERROR_TYPES } from '../constants.js';
4
4
  import { lib } from '../../lang/en.js';
5
- import { uiAccountDescription, uiLine, uiLink } from '../ui/index.js';
5
+ import { uiAccountDescription, logUiLine, uiLink } from '../ui/index.js';
6
6
  import { isPromptExitError } from '../errors/PromptExitError.js';
7
7
  function createPlatformVersionError(err, subCategory) {
8
8
  let translationKey = 'unspecifiedPlatformVersion';
@@ -17,7 +17,7 @@ function createPlatformVersionError(err, subCategory) {
17
17
  platformVersion = errorContext?.PLATFORM_VERSION ?? platformVersion;
18
18
  translationKey = 'nonExistentPlatformVersion';
19
19
  }
20
- uiLine();
20
+ logUiLine();
21
21
  uiLogger.error(lib.errorHandlers.suppressErrors.platformVersionErrors.header);
22
22
  const errorMessage = lib.errorHandlers.suppressErrors.platformVersionErrors[translationKey];
23
23
  uiLogger.log(typeof errorMessage === 'function'
@@ -25,7 +25,7 @@ function createPlatformVersionError(err, subCategory) {
25
25
  : errorMessage);
26
26
  uiLogger.log(lib.errorHandlers.suppressErrors.platformVersionErrors.updateProject);
27
27
  uiLogger.log(lib.errorHandlers.suppressErrors.platformVersionErrors.betaLink(uiLink(lib.errorHandlers.suppressErrors.platformVersionErrors.docsLink, 'https://developers.hubspot.com/docs/developer-tooling/platform/versioning')));
28
- uiLine();
28
+ logUiLine();
29
29
  }
30
30
  export function shouldSuppressError(err, context) {
31
31
  if (isPromptExitError(err)) {
@@ -0,0 +1,9 @@
1
+ import { type LastShownStateFlag } from './throttle.js';
2
+ export type Hint = {
3
+ lastShownFlag: LastShownStateFlag;
4
+ cooldownMs: number;
5
+ message: string;
6
+ isApplicable?: () => boolean;
7
+ };
8
+ export declare function shouldShowHint({ lastShownFlag, cooldownMs, isApplicable, }: Hint): boolean;
9
+ export declare function showHint(hint: Hint): boolean;
@@ -0,0 +1,30 @@
1
+ import { LOG_LEVEL, shouldLog } from '@hubspot/local-dev-lib/logger';
2
+ import { debugError } from '../errorHandlers/index.js';
3
+ import { uiLogger } from '../ui/logger.js';
4
+ import { hasShownWithin, recordShown, } from './throttle.js';
5
+ function isOutputSuppressed() {
6
+ return Boolean(process.env.CI || !process.stderr.isTTY || !shouldLog(LOG_LEVEL.LOG));
7
+ }
8
+ export function shouldShowHint({ lastShownFlag, cooldownMs, isApplicable, }) {
9
+ if (isOutputSuppressed()) {
10
+ return false;
11
+ }
12
+ if (hasShownWithin(lastShownFlag, cooldownMs)) {
13
+ return false;
14
+ }
15
+ return isApplicable ? isApplicable() : true;
16
+ }
17
+ export function showHint(hint) {
18
+ try {
19
+ if (!shouldShowHint(hint)) {
20
+ return false;
21
+ }
22
+ recordShown(hint.lastShownFlag);
23
+ uiLogger.hint(hint.message);
24
+ return true;
25
+ }
26
+ catch (e) {
27
+ debugError(e);
28
+ return false;
29
+ }
30
+ }
@@ -0,0 +1,4 @@
1
+ import { STATE_FLAGS } from '@hubspot/local-dev-lib/constants/config';
2
+ export type LastShownStateFlag = (typeof STATE_FLAGS)['MCP_PROMOTION_LAST_SHOWN_AT' | 'CLI_VERSION_DEPRECATION_WARNING_LAST_SHOWN_AT' | 'CLI_VERSION_END_OF_LIFE_WARNING_LAST_SHOWN_AT'];
3
+ export declare function hasShownWithin(flag: LastShownStateFlag, windowMs: number): boolean;
4
+ export declare function recordShown(flag: LastShownStateFlag): void;
@@ -0,0 +1,9 @@
1
+ import { getStateValue, setStateValue, } from '@hubspot/local-dev-lib/config/state';
2
+ export function hasShownWithin(flag, windowMs) {
3
+ const lastShown = getStateValue(flag);
4
+ const lastShownTime = typeof lastShown === 'string' ? Date.parse(lastShown) : NaN;
5
+ return !Number.isNaN(lastShownTime) && Date.now() - lastShownTime < windowMs;
6
+ }
7
+ export function recordShown(flag) {
8
+ setStateValue(flag, new Date().toISOString());
9
+ }
@@ -21,6 +21,7 @@ export declare const ProjectUploadSchema: z.ZodObject<{
21
21
  releaseTag: z.ZodOptional<z.ZodString>;
22
22
  succeeded: z.ZodBoolean;
23
23
  }, z.core.$strip>>;
24
+ skippedHsMetaFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
24
25
  }, z.core.$strip>;
25
26
  export type PreviewJsonOutput = z.infer<typeof PreviewSchema>;
26
27
  export type TargetAccountJsonOutput = z.infer<typeof TargetAccountSchema>;
@@ -13,6 +13,7 @@ export const ProjectUploadSchema = z.object({
13
13
  buildId: z.number().optional(),
14
14
  deployId: z.number().optional(),
15
15
  preview: PreviewSchema.optional(),
16
+ skippedHsMetaFiles: z.array(z.string()).optional(),
16
17
  });
17
18
  export function mapAccountToTargetAccount(accountId, account) {
18
19
  return {
@@ -1,11 +1,11 @@
1
1
  import fs from 'fs-extra';
2
2
  import os from 'os';
3
3
  import path from 'path';
4
- import { getStateValue, setStateValue, } from '@hubspot/local-dev-lib/config/state';
4
+ import { getStateValue } from '@hubspot/local-dev-lib/config/state';
5
5
  import { STATE_FLAGS } from '@hubspot/local-dev-lib/constants/config';
6
6
  import { commands } from '../../lang/en.js';
7
7
  import { debugError } from '../errorHandlers/index.js';
8
- import { uiLogger } from '../ui/logger.js';
8
+ import { shouldShowHint, showHint } from '../hints/hints.js';
9
9
  import { trackMcpPromotionShown } from '../usageTracking.js';
10
10
  import { MCP_CLIENTS, MCP_SERVER_NAME } from './clients.js';
11
11
  const ONE_WEEK_IN_MS = 7 * 24 * 60 * 60 * 1000;
@@ -56,51 +56,36 @@ export function detectConfiguredMcpClients() {
56
56
  return clients;
57
57
  }, []);
58
58
  }
59
- function isScriptSafeSuppressed() {
60
- return Boolean(process.env.CI || process.env.HUBSPOT_MCP_AI_AGENT || !process.stdout.isTTY);
61
- }
62
- function hasRecentPromotion(lastShownAt, now, cooldownMs) {
63
- if (!lastShownAt) {
59
+ function isMcpPromotionApplicable() {
60
+ if (process.env.HUBSPOT_MCP_AI_AGENT) {
64
61
  return false;
65
62
  }
66
- const lastShownTime = new Date(lastShownAt).getTime();
67
- if (Number.isNaN(lastShownTime)) {
63
+ const mcpTotalToolCalls = getStateValue(STATE_FLAGS.MCP_TOTAL_TOOL_CALLS);
64
+ if (typeof mcpTotalToolCalls === 'number' && mcpTotalToolCalls > 0) {
68
65
  return false;
69
66
  }
70
- return now.getTime() - lastShownTime < cooldownMs;
71
- }
72
- function getMcpPromotionLastShownAt() {
73
- return getStateValue(STATE_FLAGS.MCP_PROMOTION_LAST_SHOWN_AT);
67
+ return detectConfiguredMcpClients().length === 0;
74
68
  }
69
+ const MCP_PROMOTION_HINT = {
70
+ lastShownFlag: STATE_FLAGS.MCP_PROMOTION_LAST_SHOWN_AT,
71
+ cooldownMs: ONE_WEEK_IN_MS,
72
+ message: commands.mcp.promotion.activeNudge,
73
+ isApplicable: isMcpPromotionApplicable,
74
+ };
75
75
  export async function shouldShowMcpPromotion() {
76
- if (isScriptSafeSuppressed()) {
77
- return false;
78
- }
79
76
  try {
80
- const mcpTotalToolCalls = getStateValue(STATE_FLAGS.MCP_TOTAL_TOOL_CALLS);
81
- if (typeof mcpTotalToolCalls === 'number' && mcpTotalToolCalls > 0) {
82
- return false;
83
- }
84
- if (detectConfiguredMcpClients().length > 0) {
85
- return false;
86
- }
87
- return !hasRecentPromotion(getMcpPromotionLastShownAt(), new Date(), ONE_WEEK_IN_MS);
77
+ return shouldShowHint(MCP_PROMOTION_HINT);
88
78
  }
89
79
  catch (e) {
90
80
  debugError(e);
91
81
  return false;
92
82
  }
93
83
  }
94
- function setMcpPromotionShownAt() {
95
- setStateValue(STATE_FLAGS.MCP_PROMOTION_LAST_SHOWN_AT, new Date().toISOString());
96
- }
97
84
  export async function showMcpPromotionNudge(commandName) {
98
85
  try {
99
- if (!(await shouldShowMcpPromotion())) {
86
+ if (!showHint(MCP_PROMOTION_HINT)) {
100
87
  return;
101
88
  }
102
- setMcpPromotionShownAt();
103
- uiLogger.info(commands.mcp.promotion.activeNudge);
104
89
  await trackMcpPromotionShown(commandName || undefined);
105
90
  }
106
91
  catch (e) {
@@ -1,3 +1,4 @@
1
+ import { McpClientId } from './clients.js';
1
2
  export declare const supportedTools: {
2
3
  name: string;
3
4
  value: string;
@@ -13,7 +14,11 @@ interface ConfigureMcpServerOptions {
13
14
  cliVersion?: string;
14
15
  skills?: string[];
15
16
  }
16
- export declare function configureMcpServer(options: ConfigureMcpServerOptions): Promise<string[]>;
17
+ interface ConfigureMcpServerResult {
18
+ configuredTargets: McpClientId[];
19
+ selectedSkills: string[];
20
+ }
21
+ export declare function configureMcpServer(options: ConfigureMcpServerOptions): Promise<ConfigureMcpServerResult>;
17
22
  export declare function setupVsCode(mcpCommand?: McpCommand): Promise<boolean>;
18
23
  export declare function setupClaudeCode(mcpCommand?: McpCommand): Promise<boolean>;
19
24
  export declare function setupCursor(mcpCommand?: McpCommand): boolean;
package/lib/mcp/setup.js CHANGED
@@ -146,7 +146,7 @@ export async function configureMcpServer(options) {
146
146
  if (configuredTargets.length > 0) {
147
147
  uiLogger.info(commands.mcp.setup.success(configuredTargets));
148
148
  }
149
- return configuredTargets;
149
+ return { configuredTargets, selectedSkills };
150
150
  }
151
151
  catch (error) {
152
152
  SpinniesManager.fail('mcpSetup', {
@@ -1,10 +1,10 @@
1
1
  import semver from 'semver';
2
2
  import moment from 'moment';
3
- import { getStateValue, setStateValue, } from '@hubspot/local-dev-lib/config/state';
4
3
  import { STATE_FLAGS } from '@hubspot/local-dev-lib/constants/config';
5
4
  import { pkg } from '../jsonLoader.js';
6
5
  import { lib } from '../../lang/en.js';
7
6
  import { debugError } from '../errorHandlers/index.js';
7
+ import { hasShownWithin, recordShown } from '../hints/throttle.js';
8
8
  import { renderInline } from '../../ui/render.js';
9
9
  import { getWarningBox, getAlertBox, } from '../../ui/components/StatusMessageBoxes.js';
10
10
  import { CLI_DEPRECATED_MAJOR_VERSION, CLI_DEPRECATED_MAJOR_VERSION_DEPRECATION_DATE, CLI_DEPRECATED_MAJOR_VERSION_EOL_DATE, ONE_DAY_IN_MILLISECONDS, } from '../constants.js';
@@ -25,12 +25,6 @@ function getDeprecationStatusForCurrentMajorVersion() {
25
25
  }
26
26
  return null;
27
27
  }
28
- function hasShownWarningToday(status) {
29
- const lastShown = getStateValue(LAST_SHOWN_STATE_FLAGS[status]);
30
- const lastShownTime = typeof lastShown === 'string' ? Date.parse(lastShown) : NaN;
31
- return (!Number.isNaN(lastShownTime) &&
32
- Date.now() - lastShownTime < ONE_DAY_IN_MILLISECONDS);
33
- }
34
28
  async function logDeprecationStatusWarning(status) {
35
29
  const eolDate = moment(CLI_DEPRECATED_MAJOR_VERSION_EOL_DATE).format('MMMM D, YYYY');
36
30
  const getBox = status === 'endOfLife' ? getAlertBox : getWarningBox;
@@ -41,12 +35,13 @@ async function logDeprecationStatusWarning(status) {
41
35
  ? lib.middleware.deprecationWarning.endOfLifeMessage(pkg.version, eolDate)
42
36
  : lib.middleware.deprecationWarning.deprecatedMessage(pkg.version, eolDate);
43
37
  await renderInline(getBox({ title, message }));
44
- setStateValue(LAST_SHOWN_STATE_FLAGS[status], new Date().toISOString());
38
+ recordShown(LAST_SHOWN_STATE_FLAGS[status]);
45
39
  }
46
40
  export async function checkDeprecationWarning() {
47
41
  try {
48
42
  const status = getDeprecationStatusForCurrentMajorVersion();
49
- if (!status || hasShownWarningToday(status)) {
43
+ if (!status ||
44
+ hasShownWithin(LAST_SHOWN_STATE_FLAGS[status], ONE_DAY_IN_MILLISECONDS)) {
50
45
  return;
51
46
  }
52
47
  await logDeprecationStatusWarning(status);
@@ -3,7 +3,7 @@ import { fetchAppMetadataBySourceId, fetchPublicAppProductionInstallCounts, inst
3
3
  import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
4
4
  import { APP_AUTH_TYPES, APP_DISTRIBUTION_TYPES, APP_INSTALLATION_STATES, LOCAL_DEV_SERVER_MESSAGE_TYPES, } from '../../constants.js';
5
5
  import { EXIT_CODES } from '../../enums/exitCodes.js';
6
- import { uiLine } from '../../ui/index.js';
6
+ import { logUiLine } from '../../ui/index.js';
7
7
  import { logError } from '../../errorHandlers/index.js';
8
8
  import { isPromptExitError } from '../../errors/PromptExitError.js';
9
9
  import { installAppAutoPrompt, installAppBrowserPrompt, } from '../../prompts/installAppPrompt.js';
@@ -118,9 +118,9 @@ class AppDevModeInterface {
118
118
  text: lib.AppDevModeInterface.fetchAppData.activeInstallations(this.appNode?.config.name || '', this.marketplaceAppInstalls),
119
119
  failColor: 'yellow',
120
120
  });
121
- uiLine();
121
+ logUiLine();
122
122
  uiLogger.log(lib.LocalDevManager.activeInstallWarning.explanation);
123
- uiLine();
123
+ logUiLine();
124
124
  const proceed = await confirmPrompt(lib.LocalDevManager.activeInstallWarning.confirmationPrompt, { defaultAnswer: false });
125
125
  if (!proceed) {
126
126
  return this.localDevState.actions.exit(EXIT_CODES.SUCCESS);
@@ -2,7 +2,7 @@ import { hasLocalStateFlag } from '@hubspot/local-dev-lib/config';
2
2
  import { getConfigDefaultAccountIfExists, isConfigFlagEnabled, } from '@hubspot/local-dev-lib/config';
3
3
  import { CONFIG_FLAGS } from '@hubspot/local-dev-lib/constants/config';
4
4
  import { uiLogger } from '../../ui/logger.js';
5
- import { uiLine, uiAccountDescription, uiCommandReference, } from '../../ui/index.js';
5
+ import { logUiLine, uiAccountDescription, uiCommandReference, } from '../../ui/index.js';
6
6
  import { lib } from '../../../lang/en.js';
7
7
  import SpinniesManager from '../../ui/SpinniesManager.js';
8
8
  import { logError, getErrorMessage } from '../../errorHandlers/index.js';
@@ -105,7 +105,7 @@ class LocalDevLogger {
105
105
  }
106
106
  uiLogger.log('');
107
107
  uiLogger.log(lib.LocalDevManager.quitHelper);
108
- uiLine();
108
+ logUiLine();
109
109
  uiLogger.log('');
110
110
  }
111
111
  cleanupStart() {
@@ -155,12 +155,12 @@ class LocalDevLogger {
155
155
  uploadSuccess() {
156
156
  uiLogger.log('');
157
157
  uiLogger.log(lib.LocalDevProcess.uploadSuccess);
158
- uiLine();
158
+ logUiLine();
159
159
  uiLogger.log('');
160
160
  }
161
161
  uploadSuccessAutoDeployDisabled() {
162
162
  uiLogger.warn(lib.LocalDevProcess.uploadSuccessAutoDeployDisabled);
163
- uiLine();
163
+ logUiLine();
164
164
  uiLogger.log('');
165
165
  }
166
166
  deployError(error) {
@@ -174,7 +174,7 @@ class LocalDevLogger {
174
174
  deploySuccess() {
175
175
  uiLogger.log('');
176
176
  uiLogger.log(lib.LocalDevProcess.deploySuccess);
177
- uiLine();
177
+ logUiLine();
178
178
  uiLogger.log('');
179
179
  }
180
180
  monitorConsoleOutput() {
@@ -12,7 +12,7 @@ import { isSpecifiedError } from '@hubspot/local-dev-lib/errors/index';
12
12
  import { PROJECT_BUILD_TEXT, PROJECT_CONFIG_FILE, PROJECT_DEPLOY_TEXT, PROJECT_ERROR_TYPES, } from '../../../constants.js';
13
13
  import { lib } from '../../../../lang/en.js';
14
14
  import { uiLogger } from '../../../ui/logger.js';
15
- import { uiAccountDescription, uiLine } from '../../../ui/index.js';
15
+ import { uiAccountDescription, logUiLine } from '../../../ui/index.js';
16
16
  import { confirmPrompt } from '../../../prompts/promptUtils.js';
17
17
  import SpinniesManager from '../../../ui/SpinniesManager.js';
18
18
  import { EXIT_CODES } from '../../../enums/exitCodes.js';
@@ -32,9 +32,9 @@ export async function createNewProjectForLocalDev(projectConfig, targetAccountId
32
32
  .projectMustExistExplanation;
33
33
  const explanationString = explanationLangFunction(projectConfig.name, targetAccountId);
34
34
  uiLogger.log('');
35
- uiLine();
35
+ logUiLine();
36
36
  uiLogger.log(explanationString);
37
- uiLine();
37
+ logUiLine();
38
38
  shouldCreateProject = await confirmPrompt(lib.localDevHelpers.project.createNewProjectForLocalDev.createProject(projectConfig.name, uiAccountDescription(targetAccountId)));
39
39
  }
40
40
  if (shouldCreateProject) {
@@ -3,7 +3,7 @@ import { getBuildStatus, getBuildStructure, getDeployStatus, getDeployStructure,
3
3
  import { DEFAULT_POLLING_DELAY, PROJECT_BUILD_TEXT, PROJECT_DEPLOY_TEXT, PROJECT_TASK_TYPES, PROJECT_ERROR_TYPES, } from '../constants.js';
4
4
  import SpinniesManager from '../ui/SpinniesManager.js';
5
5
  import { logError, ApiErrorContext } from '../errorHandlers/index.js';
6
- import { uiLine, uiLink, uiAccountDescription } from '../ui/index.js';
6
+ import { logUiLine, uiLink, uiAccountDescription } from '../ui/index.js';
7
7
  import { getProjectBuildDetailUrl, getProjectDeployDetailUrl, getProjectActivityUrl, } from './urls.js';
8
8
  import { lib } from '../../lang/en.js';
9
9
  import { uiLogger } from '../ui/logger.js';
@@ -172,12 +172,12 @@ function makePollTaskStatusFunc({ statusFn, structureFn, statusText, statusStrin
172
172
  });
173
173
  if (!silenceLogs) {
174
174
  const failedSubtasks = subtasks.filter(subtask => subtask.status === 'FAILURE');
175
- uiLine();
175
+ logUiLine();
176
176
  uiLogger.log(`${statusStrings.SUBTASK_FAIL(failedSubtasks.length === 1
177
177
  ? getSubtaskName(failedSubtasks[0])
178
178
  : failedSubtasks.length + ' components', displayId)}\n`);
179
179
  uiLogger.log(lib.projectBuildAndDeploy.makePollTaskStatusFunc.errorSummary);
180
- uiLine();
180
+ logUiLine();
181
181
  const displayErrors = failedSubtasks.filter(subtask => subtask?.standardError?.subCategory !==
182
182
  PROJECT_ERROR_TYPES.SUBBUILD_FAILED &&
183
183
  subtask?.standardError?.subCategory !==
@@ -295,7 +295,7 @@ export async function pollProjectBuildAndDeploy(accountId, projectConfig, tempFi
295
295
  const { silenceLogs = false, skipDeploy = false } = options;
296
296
  let buildStatus = await pollBuildStatus(accountId, projectConfig.name, buildId, null, silenceLogs);
297
297
  if (!silenceLogs) {
298
- uiLine();
298
+ logUiLine();
299
299
  }
300
300
  const result = {
301
301
  succeeded: true,
@@ -4,7 +4,7 @@ import { APP_KEY, USER_FACING_TO_INTERNAL_TYPE, } from '@hubspot/project-parsing
4
4
  import { debugError } from '../errorHandlers/index.js';
5
5
  import { getProjectDetailUrl } from './urls.js';
6
6
  import { commands } from '../../lang/en.js';
7
- import { uiLine, uiLink } from '../ui/index.js';
7
+ import { logUiLine, uiLink } from '../ui/index.js';
8
8
  import { uiLogger } from '../ui/logger.js';
9
9
  export async function getProjectInfo(project, platformVersion, accountId) {
10
10
  const deployedBuild = project.deployedBuild;
@@ -46,7 +46,7 @@ export async function getProjectInfo(project, platformVersion, accountId) {
46
46
  }
47
47
  export function logProjectInfo(projectInfo) {
48
48
  uiLogger.log(chalk.bold(commands.project.info.project.title(projectInfo.projectName)));
49
- uiLine();
49
+ logUiLine();
50
50
  uiLogger.log(commands.project.info.project.platformVersion(projectInfo.platformVersion));
51
51
  uiLogger.log(commands.project.info.project.id(projectInfo.projectId));
52
52
  uiLogger.log(commands.project.info.project.deployedBuild(projectInfo.deployedBuildId));
@@ -58,7 +58,7 @@ export function logProjectInfo(projectInfo) {
58
58
  if (projectInfo.app) {
59
59
  uiLogger.log('');
60
60
  uiLogger.log(chalk.bold(commands.project.info.app.title));
61
- uiLine();
61
+ logUiLine();
62
62
  uiLogger.log(commands.project.info.app.name(projectInfo.app.name));
63
63
  uiLogger.log(commands.project.info.app.id(projectInfo.app.id));
64
64
  uiLogger.log(commands.project.info.app.uid(projectInfo.app.uid));
@@ -72,7 +72,7 @@ export function logProjectInfo(projectInfo) {
72
72
  if (projectInfo.components.length > 0) {
73
73
  uiLogger.log('');
74
74
  uiLogger.log(chalk.bold(commands.project.info.componentsHeader));
75
- uiLine();
75
+ logUiLine();
76
76
  const typeColWidth = Math.max(commands.project.info.labels.type.length, ...projectInfo.components.map(c => c.type.length));
77
77
  uiLogger.log(`${commands.project.info.labels.type.padEnd(typeColWidth)} ${commands.project.info.labels.uid}`);
78
78
  for (const component of projectInfo.components) {
@@ -1,14 +1,14 @@
1
1
  import path from 'path';
2
2
  import { loadHsProfileFile, getHsProfileFilename, validateProfileVariables, } from '@hubspot/project-parsing-lib/profiles';
3
3
  import { commands, lib } from '../../lang/en.js';
4
- import { indent, uiLine } from '../ui/index.js';
4
+ import { indent, logUiLine } from '../ui/index.js';
5
5
  import { uiLogger } from '../ui/logger.js';
6
6
  import { getConfigAccountById } from '@hubspot/local-dev-lib/config';
7
7
  import SpinniesManager from '../ui/SpinniesManager.js';
8
8
  import { handleTranslate } from './upload.js';
9
9
  import { getErrorMessage } from '../errorHandlers/index.js';
10
10
  export function logProfileHeader(profileName) {
11
- uiLine();
11
+ logUiLine();
12
12
  uiLogger.log(lib.projectProfiles.logs.usingProfile(getHsProfileFilename(profileName)));
13
13
  uiLogger.log('');
14
14
  }
@@ -21,7 +21,7 @@ export function logProfileFooter(profile, includeVariables = false) {
21
21
  uiLogger.log(` ${key}: ${value}`);
22
22
  });
23
23
  }
24
- uiLine();
24
+ logUiLine();
25
25
  uiLogger.log('');
26
26
  }
27
27
  export function loadProfile(projectConfig, projectDir, profileName) {
@@ -1,13 +1,13 @@
1
1
  import { uiLogger } from '../ui/logger.js';
2
2
  import { FEEDBACK_INTERVAL } from '../constants.js';
3
- import { uiLine } from '../ui/index.js';
3
+ import { logUiLine } from '../ui/index.js';
4
4
  import { lib } from '../../lang/en.js';
5
5
  import { confirmPrompt } from '../prompts/promptUtils.js';
6
6
  export function logFeedbackMessage(buildId) {
7
7
  if (buildId > 0 && buildId % FEEDBACK_INTERVAL === 0) {
8
- uiLine();
8
+ logUiLine();
9
9
  uiLogger.log(lib.projects.logFeedbackMessage.feedbackHeader);
10
- uiLine();
10
+ logUiLine();
11
11
  uiLogger.log(lib.projects.logFeedbackMessage.feedbackMessage);
12
12
  }
13
13
  }
@@ -8,6 +8,7 @@ type ProjectUploadResult<T> = {
8
8
  projectNotFound?: boolean;
9
9
  projectId?: number;
10
10
  userDeclined?: boolean;
11
+ skippedHsMetaFiles?: string[];
11
12
  };
12
13
  type HandleProjectUploadArg<T> = {
13
14
  accountId: number;
@@ -23,8 +24,9 @@ type HandleProjectUploadArg<T> = {
23
24
  skipAutoDeploy?: boolean;
24
25
  profile?: string;
25
26
  force?: boolean;
27
+ formatOutputAsJson?: boolean;
26
28
  };
27
- export declare function handleProjectUpload<T>({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage, forceCreate, isUploadCommand, sendIR, skipValidation, skipNpmAudit, skipAutoDeploy, force, }: HandleProjectUploadArg<T>): Promise<ProjectUploadResult<T>>;
29
+ export declare function handleProjectUpload<T>({ accountId, projectConfig, projectDir, callbackFunc, profile, uploadMessage, forceCreate, isUploadCommand, sendIR, skipValidation, skipNpmAudit, skipAutoDeploy, force, formatOutputAsJson, }: HandleProjectUploadArg<T>): Promise<ProjectUploadResult<T>>;
28
30
  export type SourceDirectoryWarning = {
29
31
  message: string;
30
32
  file: string;