@hubspot/cli 7.7.34-experimental.0 → 7.8.0-beta.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 (293) hide show
  1. package/bin/cli.js +31 -25
  2. package/commands/__tests__/auth.test.js +5 -0
  3. package/commands/__tests__/doctor.test.js +16 -16
  4. package/commands/__tests__/getStarted.test.js +2 -2
  5. package/commands/__tests__/mcp.test.js +1 -1
  6. package/commands/__tests__/project.test.js +0 -3
  7. package/commands/account/clean.js +18 -27
  8. package/commands/account/createOverride.js +13 -31
  9. package/commands/account/info.js +20 -31
  10. package/commands/account/list.js +16 -22
  11. package/commands/account/remove.js +12 -20
  12. package/commands/account/removeOverride.js +11 -21
  13. package/commands/account/rename.js +6 -9
  14. package/commands/account/use.js +12 -26
  15. package/commands/account.js +2 -2
  16. package/commands/app/__tests__/migrate.test.js +5 -6
  17. package/commands/app/migrate.js +13 -19
  18. package/commands/app/secret/add.js +2 -1
  19. package/commands/app/secret/delete.js +2 -1
  20. package/commands/app/secret/list.js +2 -1
  21. package/commands/app/secret/update.js +2 -1
  22. package/commands/app/secret.js +2 -1
  23. package/commands/app.js +3 -8
  24. package/commands/auth.d.ts +1 -0
  25. package/commands/auth.js +16 -7
  26. package/commands/cms/convertFields.js +7 -9
  27. package/commands/cms/getReactModule.js +9 -14
  28. package/commands/cms/lighthouseScore.js +33 -36
  29. package/commands/cms.js +2 -2
  30. package/commands/completion.js +3 -3
  31. package/commands/config/set.d.ts +1 -1
  32. package/commands/config/set.js +64 -37
  33. package/commands/config.js +2 -2
  34. package/commands/create.js +2 -2
  35. package/commands/customObject/create.js +10 -12
  36. package/commands/customObject/schema/create.js +9 -11
  37. package/commands/customObject/schema/delete.js +16 -16
  38. package/commands/customObject/schema/fetch-all.js +12 -11
  39. package/commands/customObject/schema/fetch.js +15 -15
  40. package/commands/customObject/schema/list.js +4 -4
  41. package/commands/customObject/schema/update.js +13 -13
  42. package/commands/customObject/schema.js +2 -2
  43. package/commands/customObject.js +6 -7
  44. package/commands/doctor.js +8 -11
  45. package/commands/feedback.js +7 -12
  46. package/commands/fetch.js +8 -8
  47. package/commands/filemanager/fetch.js +7 -7
  48. package/commands/filemanager/upload.js +15 -34
  49. package/commands/filemanager.js +2 -2
  50. package/commands/function/deploy.js +11 -29
  51. package/commands/function/list.js +8 -8
  52. package/commands/function/server.js +9 -11
  53. package/commands/function.d.ts +1 -1
  54. package/commands/function.js +2 -2
  55. package/commands/getStarted.d.ts +0 -2
  56. package/commands/getStarted.js +4 -4
  57. package/commands/hubdb/clear.js +7 -15
  58. package/commands/hubdb/create.js +9 -15
  59. package/commands/hubdb/delete.js +8 -15
  60. package/commands/hubdb/fetch.js +6 -9
  61. package/commands/hubdb.d.ts +1 -1
  62. package/commands/hubdb.js +2 -2
  63. package/commands/init.js +2 -3
  64. package/commands/lint.js +16 -16
  65. package/commands/list.js +8 -14
  66. package/commands/logs.js +14 -20
  67. package/commands/mcp/__tests__/setup.test.js +2 -2
  68. package/commands/mcp/setup.js +11 -2
  69. package/commands/mcp.js +3 -3
  70. package/commands/mv.js +6 -17
  71. package/commands/open.js +5 -5
  72. package/commands/project/__tests__/add.test.js +4 -2
  73. package/commands/project/__tests__/create.test.js +6 -6
  74. package/commands/project/__tests__/deploy.test.js +3 -7
  75. package/commands/project/__tests__/devUnifiedFlow.test.js +2 -4
  76. package/commands/project/__tests__/installDeps.test.js +8 -8
  77. package/commands/project/__tests__/logs.test.js +1 -4
  78. package/commands/project/__tests__/migrate.test.js +6 -7
  79. package/commands/project/__tests__/migrateApp.test.js +3 -7
  80. package/commands/project/__tests__/profile.test.js +1 -1
  81. package/commands/project/__tests__/validate.test.js +98 -0
  82. package/commands/project/add.js +4 -8
  83. package/commands/project/cloneApp.js +14 -19
  84. package/commands/project/create.js +3 -10
  85. package/commands/project/deploy.js +5 -5
  86. package/commands/project/dev/deprecatedFlow.js +7 -16
  87. package/commands/project/dev/index.js +16 -13
  88. package/commands/project/dev/unifiedFlow.js +8 -4
  89. package/commands/project/download.js +10 -14
  90. package/commands/project/installDeps.js +8 -9
  91. package/commands/project/listBuilds.js +12 -21
  92. package/commands/project/logs.js +21 -24
  93. package/commands/project/migrate.js +41 -13
  94. package/commands/project/migrateApp.js +10 -17
  95. package/commands/project/open.js +6 -14
  96. package/commands/project/profile/add.js +3 -3
  97. package/commands/project/profile/delete.js +1 -2
  98. package/commands/project/profile.js +2 -3
  99. package/commands/project/upload.d.ts +2 -2
  100. package/commands/project/upload.js +17 -26
  101. package/commands/project/validate.js +7 -7
  102. package/commands/project/watch.js +13 -22
  103. package/commands/project.js +2 -3
  104. package/commands/sandbox/__tests__/create.test.js +5 -5
  105. package/commands/sandbox/create.js +22 -32
  106. package/commands/sandbox/delete.js +35 -63
  107. package/commands/sandbox.js +2 -2
  108. package/commands/secret/addSecret.js +7 -17
  109. package/commands/secret/deleteSecret.js +10 -20
  110. package/commands/secret/listSecret.js +8 -10
  111. package/commands/secret/updateSecret.js +9 -17
  112. package/commands/secret.js +2 -2
  113. package/commands/testAccount/__tests__/delete.test.js +2 -4
  114. package/commands/testAccount/create.js +0 -3
  115. package/commands/testAccount/delete.d.ts +4 -3
  116. package/commands/testAccount/delete.js +155 -14
  117. package/commands/testAccount/importData.d.ts +1 -1
  118. package/commands/testAccount/importData.js +1 -1
  119. package/commands/testAccount.js +1 -1
  120. package/lang/en.d.ts +317 -120
  121. package/lang/en.js +312 -118
  122. package/lang/en.lyaml +2 -2
  123. package/lib/__tests__/buildAccount.test.js +2 -1
  124. package/lib/__tests__/commonOpts.test.js +1 -1
  125. package/lib/__tests__/dependencyManagement.test.js +1 -1
  126. package/lib/__tests__/developerTestAccounts.test.js +3 -3
  127. package/lib/__tests__/npm.test.js +1 -1
  128. package/lib/__tests__/oauth.test.js +4 -4
  129. package/lib/__tests__/process.test.js +10 -5
  130. package/lib/__tests__/sandboxSync.test.js +8 -8
  131. package/lib/__tests__/sandboxes.test.js +8 -8
  132. package/lib/__tests__/serverlessLogs.test.js +1 -1
  133. package/lib/__tests__/usageTracking.test.js +5 -5
  134. package/lib/__tests__/validation.test.js +2 -1
  135. package/lib/__tests__/yargsUtils.test.js +83 -9
  136. package/lib/app/__tests__/migrate.test.js +19 -56
  137. package/lib/app/__tests__/migrate_legacy.test.js +1 -1
  138. package/lib/app/migrate.d.ts +2 -8
  139. package/lib/app/migrate.js +5 -80
  140. package/lib/app/migrate_legacy.js +20 -24
  141. package/lib/buildAccount.js +25 -57
  142. package/lib/commonOpts.d.ts +1 -1
  143. package/lib/commonOpts.js +25 -22
  144. package/lib/configOptions.js +7 -0
  145. package/lib/constants.d.ts +13 -0
  146. package/lib/constants.js +17 -0
  147. package/lib/dependencyManagement.js +9 -27
  148. package/lib/developerTestAccounts.js +9 -23
  149. package/lib/doctor/Diagnosis.js +11 -23
  150. package/lib/doctor/DiagnosticInfoBuilder.js +12 -11
  151. package/lib/doctor/Doctor.js +42 -90
  152. package/lib/doctor/__tests__/Doctor.test.js +4 -4
  153. package/lib/errorHandlers/index.js +12 -20
  154. package/lib/errorHandlers/suppressError.js +10 -17
  155. package/lib/lang.js +6 -5
  156. package/lib/links.d.ts +1 -0
  157. package/lib/links.js +14 -7
  158. package/lib/mcp/setup.js +1 -1
  159. package/lib/middleware/__test__/commandTargetingUtils.test.js +99 -0
  160. package/lib/middleware/__test__/configMiddleware.test.js +11 -11
  161. package/lib/middleware/__test__/yargsChecksMiddleware.test.js +6 -8
  162. package/lib/middleware/commandTargetingUtils.d.ts +8 -0
  163. package/lib/middleware/commandTargetingUtils.js +78 -0
  164. package/lib/middleware/configMiddleware.d.ts +1 -1
  165. package/lib/middleware/configMiddleware.js +21 -81
  166. package/lib/middleware/fireAlarmMiddleware.js +15 -5
  167. package/lib/middleware/gitMiddleware.js +5 -1
  168. package/lib/middleware/notificationsMiddleware.js +5 -11
  169. package/lib/middleware/yargsChecksMiddleware.js +6 -9
  170. package/lib/npm.js +2 -2
  171. package/lib/oauth.js +5 -5
  172. package/lib/process.js +5 -4
  173. package/lib/projectProfiles.d.ts +1 -1
  174. package/lib/projectProfiles.js +2 -10
  175. package/lib/projects/__tests__/AppDevModeInterface.test.js +2 -0
  176. package/lib/projects/__tests__/LocalDevProcess.test.js +227 -16
  177. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +86 -60
  178. package/lib/projects/__tests__/deploy.test.js +71 -6
  179. package/lib/projects/__tests__/localDevProjectHelpers.test.js +6 -2
  180. package/lib/projects/__tests__/platformVersion.test.js +8 -8
  181. package/lib/projects/__tests__/projects.test.js +12 -12
  182. package/lib/projects/__tests__/structure.test.js +3 -3
  183. package/lib/projects/__tests__/upload.test.d.ts +1 -0
  184. package/lib/projects/__tests__/upload.test.js +82 -0
  185. package/lib/projects/add/__tests__/legacyAddComponent.test.js +6 -6
  186. package/lib/projects/add/__tests__/v3AddComponent.test.js +4 -4
  187. package/lib/projects/create/__tests__/legacy.test.js +5 -5
  188. package/lib/projects/create/__tests__/v3.test.js +80 -5
  189. package/lib/projects/create/index.js +2 -2
  190. package/lib/projects/create/legacy.js +2 -2
  191. package/lib/projects/create/v3.js +10 -8
  192. package/lib/projects/localDev/AppDevModeInterface.d.ts +2 -0
  193. package/lib/projects/localDev/AppDevModeInterface.js +21 -12
  194. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  195. package/lib/projects/localDev/LocalDevLogger.js +27 -6
  196. package/lib/projects/localDev/LocalDevManager.js +4 -5
  197. package/lib/projects/localDev/LocalDevProcess.d.ts +7 -5
  198. package/lib/projects/localDev/LocalDevProcess.js +90 -19
  199. package/lib/projects/localDev/LocalDevState.d.ts +9 -8
  200. package/lib/projects/localDev/LocalDevState.js +18 -17
  201. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +2 -1
  202. package/lib/projects/localDev/LocalDevWebsocketServer.js +62 -33
  203. package/lib/projects/localDev/helpers/project.d.ts +1 -0
  204. package/lib/projects/localDev/helpers/project.js +42 -1
  205. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +4 -0
  206. package/lib/projects/localDev/localDevWebsocketServerUtils.js +10 -0
  207. package/lib/projects/platformVersion.d.ts +1 -1
  208. package/lib/projects/platformVersion.js +1 -1
  209. package/lib/projects/pollProjectBuildAndDeploy.js +4 -4
  210. package/lib/projects/structure.d.ts +2 -2
  211. package/lib/projects/structure.js +6 -6
  212. package/lib/projects/upload.d.ts +2 -3
  213. package/lib/projects/upload.js +17 -9
  214. package/lib/prompts/accountNamePrompt.js +14 -19
  215. package/lib/prompts/accountsPrompt.js +2 -2
  216. package/lib/prompts/cmsFieldPrompt.js +2 -2
  217. package/lib/prompts/createApiSamplePrompt.js +5 -5
  218. package/lib/prompts/createDeveloperTestAccountConfigPrompt.js +10 -1
  219. package/lib/prompts/createFunctionPrompt.js +14 -14
  220. package/lib/prompts/createModulePrompt.js +9 -9
  221. package/lib/prompts/createTemplatePrompt.js +2 -2
  222. package/lib/prompts/downloadProjectPrompt.js +5 -8
  223. package/lib/prompts/personalAccessKeyPrompt.js +3 -3
  224. package/lib/prompts/previewPrompt.js +6 -6
  225. package/lib/prompts/projectAddPrompt.js +8 -1
  226. package/lib/prompts/projectDevTargetAccountPrompt.js +20 -32
  227. package/lib/prompts/projectNamePrompt.js +4 -8
  228. package/lib/prompts/projectsLogsPrompt.js +2 -4
  229. package/lib/prompts/promptUtils.js +30 -9
  230. package/lib/prompts/sandboxesPrompt.js +7 -7
  231. package/lib/prompts/secretPrompt.js +3 -3
  232. package/lib/prompts/selectAppPrompt.js +3 -3
  233. package/lib/prompts/selectHubDBTablePrompt.js +9 -13
  234. package/lib/prompts/selectProjectTemplatePrompt.js +2 -0
  235. package/lib/prompts/selectPublicAppForMigrationPrompt.js +15 -19
  236. package/lib/prompts/setAsDefaultAccountPrompt.js +4 -8
  237. package/lib/prompts/uploadPrompt.js +5 -5
  238. package/lib/sandboxSync.js +24 -41
  239. package/lib/sandboxes.js +19 -47
  240. package/lib/schema.js +3 -3
  241. package/lib/serverlessLogs.js +11 -13
  242. package/lib/theme/__tests__/migrate.test.d.ts +1 -0
  243. package/lib/theme/__tests__/migrate.test.js +233 -0
  244. package/lib/theme/migrate.d.ts +13 -0
  245. package/lib/theme/migrate.js +90 -0
  246. package/lib/ui/SpinniesManager.d.ts +2 -0
  247. package/lib/ui/SpinniesManager.js +7 -0
  248. package/lib/ui/boxen.js +1 -2
  249. package/lib/ui/git.js +13 -10
  250. package/lib/ui/index.js +38 -37
  251. package/lib/ui/serverlessFunctionLogs.js +9 -7
  252. package/lib/ui/uiMessages.d.ts +68 -0
  253. package/lib/ui/uiMessages.js +71 -0
  254. package/lib/usageTracking.js +8 -8
  255. package/lib/validation.js +20 -23
  256. package/lib/yargsUtils.d.ts +1 -1
  257. package/lib/yargsUtils.js +12 -5
  258. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +2 -2
  259. package/mcp-server/tools/index.js +4 -0
  260. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +2 -2
  261. package/mcp-server/tools/project/CreateProjectTool.d.ts +2 -2
  262. package/mcp-server/tools/project/DocsSearchTool.d.ts +4 -1
  263. package/mcp-server/tools/project/DocsSearchTool.js +5 -5
  264. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +23 -0
  265. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +68 -0
  266. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +11 -0
  267. package/mcp-server/tools/project/GetApplicationInfoTool.js +49 -0
  268. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +4 -1
  269. package/mcp-server/tools/project/GetConfigValuesTool.js +12 -6
  270. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +2 -2
  271. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +12 -10
  272. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +1 -0
  273. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +169 -0
  274. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +1 -0
  275. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +115 -0
  276. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +8 -7
  277. package/mcp-server/utils/__tests__/cliConfig.test.d.ts +1 -0
  278. package/mcp-server/utils/__tests__/cliConfig.test.js +110 -0
  279. package/mcp-server/utils/cliConfig.d.ts +1 -0
  280. package/mcp-server/utils/cliConfig.js +12 -0
  281. package/mcp-server/utils/toolUsageTracking.js +2 -2
  282. package/package.json +4 -4
  283. package/types/LocalDev.d.ts +19 -3
  284. package/types/Yargs.d.ts +1 -1
  285. package/ui/index.js +1 -1
  286. package/commands/app/__tests__/install.test.js +0 -47
  287. package/commands/app/install.d.ts +0 -8
  288. package/commands/app/install.js +0 -122
  289. package/lib/middleware/__test__/utils.test.js +0 -51
  290. package/lib/middleware/utils.d.ts +0 -8
  291. package/lib/middleware/utils.js +0 -14
  292. /package/commands/{app/__tests__/install.test.d.ts → project/__tests__/validate.test.d.ts} +0 -0
  293. /package/lib/middleware/__test__/{utils.test.d.ts → commandTargetingUtils.test.d.ts} +0 -0
@@ -0,0 +1,49 @@
1
+ import { Tool } from '../../types.js';
2
+ import { z } from 'zod';
3
+ import { trackToolUsage } from '../../utils/toolUsageTracking.js';
4
+ import { http } from '@hubspot/local-dev-lib/http';
5
+ import { formatTextContents } from '../../utils/content.js';
6
+ import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
7
+ import { getAccountId } from '@hubspot/local-dev-lib/config';
8
+ const inputSchema = {};
9
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
10
+ const inputSchemaZodObject = z.object({ ...inputSchema });
11
+ const toolName = 'get-applications-info';
12
+ export class GetApplicationInfoTool extends Tool {
13
+ constructor(mcpServer) {
14
+ super(mcpServer);
15
+ }
16
+ async handler({}) {
17
+ await trackToolUsage(toolName);
18
+ try {
19
+ // Get account ID from CLI config
20
+ const accountId = getAccountId();
21
+ if (!accountId) {
22
+ const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
23
+ return formatTextContents(authErrorMessage);
24
+ }
25
+ const response = await http.get(accountId, {
26
+ url: `app/feature/utilization/public/v3/insights/apps`,
27
+ });
28
+ // Format the response for display
29
+ const { data } = response;
30
+ const formattedResult = JSON.stringify(data, null, 2);
31
+ return formatTextContents(formattedResult);
32
+ }
33
+ catch (error) {
34
+ if (isHubSpotHttpError(error)) {
35
+ // Handle HubSpot-specific HTTP errors
36
+ return formatTextContents(error.toString());
37
+ }
38
+ const errorMessage = `${error instanceof Error ? error.message : String(error)}`;
39
+ return formatTextContents(errorMessage);
40
+ }
41
+ }
42
+ register() {
43
+ return this.mcpServer.registerTool(toolName, {
44
+ title: 'Get Applications Information',
45
+ description: 'Retrieves a list of all HubSpot applications available in the current account. Returns an array of applications, where each application contains an appId (numeric identifier) and appName (string). This information is useful for identifying available applications before using other tools that require specific application IDs, such as getting API usage patterns. No input parameters are required - this tool fetches all applications from the HubSpot Insights API.',
46
+ inputSchema,
47
+ }, this.handler);
48
+ }
49
+ }
@@ -2,19 +2,22 @@ import { TextContentResponse, Tool } from '../../types.js';
2
2
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
3
3
  import { z } from 'zod';
4
4
  declare const inputSchemaZodObject: z.ZodObject<{
5
+ absoluteCurrentWorkingDirectory: z.ZodString;
5
6
  platformVersion: z.ZodString;
6
7
  featureType: z.ZodString;
7
8
  }, "strip", z.ZodTypeAny, {
8
9
  platformVersion: string;
10
+ absoluteCurrentWorkingDirectory: string;
9
11
  featureType: string;
10
12
  }, {
11
13
  platformVersion: string;
14
+ absoluteCurrentWorkingDirectory: string;
12
15
  featureType: string;
13
16
  }>;
14
17
  type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
15
18
  export declare class GetConfigValuesTool extends Tool<InputSchemaType> {
16
19
  constructor(mcpServer: McpServer);
17
- handler({ platformVersion, featureType, }: InputSchemaType): Promise<TextContentResponse>;
20
+ handler({ absoluteCurrentWorkingDirectory, platformVersion, featureType, }: InputSchemaType): Promise<TextContentResponse>;
18
21
  register(): RegisteredTool;
19
22
  }
20
23
  export {};
@@ -1,10 +1,12 @@
1
1
  import { Tool } from '../../types.js';
2
2
  import { z } from 'zod';
3
3
  import { formatTextContents } from '../../utils/content.js';
4
+ import { absoluteCurrentWorkingDirectory } from './constants.js';
4
5
  import { getIntermediateRepresentationSchema, mapToInternalType, } from '@hubspot/project-parsing-lib';
5
- import { getAccountId, getConfigPath, loadConfig, } from '@hubspot/local-dev-lib/config';
6
- import { useV3Api } from '../../../lib/projects/platformVersion.js';
6
+ import { isV2Project } from '../../../lib/projects/platformVersion.js';
7
+ import { getAccountIdFromCliConfig } from '../../utils/cliConfig.js';
7
8
  const inputSchema = {
9
+ absoluteCurrentWorkingDirectory,
8
10
  platformVersion: z
9
11
  .string()
10
12
  .describe('The platform version for the project. Located in the hsproject.json file.'),
@@ -21,16 +23,20 @@ export class GetConfigValuesTool extends Tool {
21
23
  constructor(mcpServer) {
22
24
  super(mcpServer);
23
25
  }
24
- async handler({ platformVersion, featureType, }) {
26
+ async handler({ absoluteCurrentWorkingDirectory, platformVersion, featureType, }) {
25
27
  try {
26
- if (!useV3Api(platformVersion)) {
28
+ if (!isV2Project(platformVersion)) {
27
29
  return formatTextContents(`Can only be used on projects with a minimum platformVersion of 2025.2`);
28
30
  }
29
- loadConfig(getConfigPath());
31
+ const accountId = getAccountIdFromCliConfig(absoluteCurrentWorkingDirectory);
32
+ if (!accountId) {
33
+ const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
34
+ return formatTextContents(authErrorMessage);
35
+ }
30
36
  const schema = await getIntermediateRepresentationSchema({
31
37
  platformVersion,
32
38
  projectSourceDir: '',
33
- accountId: getAccountId(),
39
+ accountId,
34
40
  });
35
41
  const internalComponentType = mapToInternalType(featureType);
36
42
  if (schema[internalComponentType]) {
@@ -4,9 +4,9 @@ import { z } from 'zod';
4
4
  declare const inputSchemaZodObject: z.ZodObject<{
5
5
  command: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"hs init">, z.ZodLiteral<"hs auth">, z.ZodLiteral<"hs project create">, z.ZodLiteral<"hs project upload">]>>;
6
6
  }, "strip", z.ZodTypeAny, {
7
- command?: "hs auth" | "hs project upload" | "hs project create" | "hs init" | undefined;
7
+ command?: "hs auth" | "hs project create" | "hs project upload" | "hs init" | undefined;
8
8
  }, {
9
- command?: "hs auth" | "hs project upload" | "hs project create" | "hs init" | undefined;
9
+ command?: "hs auth" | "hs project create" | "hs project upload" | "hs init" | undefined;
10
10
  }>;
11
11
  type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
12
12
  export declare class GuidedWalkthroughTool extends Tool<InputSchemaType> {
@@ -1,14 +1,14 @@
1
1
  import { DocsSearchTool } from '../DocsSearchTool.js';
2
2
  import { http } from '@hubspot/local-dev-lib/http';
3
- import { getAccountId } from '@hubspot/local-dev-lib/config';
4
3
  import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
4
+ import { getAccountIdFromCliConfig } from '../../../utils/cliConfig.js';
5
5
  vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
6
6
  vi.mock('@hubspot/local-dev-lib/http');
7
- vi.mock('@hubspot/local-dev-lib/config');
8
7
  vi.mock('@hubspot/local-dev-lib/errors/index');
9
8
  vi.mock('../../../utils/toolUsageTracking');
9
+ vi.mock('../../../utils/cliConfig.js');
10
10
  const mockHttp = http;
11
- const mockGetAccountId = getAccountId;
11
+ const mockGetAccountIdFromCliConfig = getAccountIdFromCliConfig;
12
12
  const mockIsHubSpotHttpError = vi.mocked(isHubSpotHttpError);
13
13
  describe('mcp-server/tools/project/DocsSearchTool', () => {
14
14
  let mockMcpServer;
@@ -38,9 +38,10 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
38
38
  describe('handler', () => {
39
39
  const mockInput = {
40
40
  docsSearchQuery: 'test query',
41
+ absoluteCurrentWorkingDirectory: '/foo',
41
42
  };
42
43
  it('should return auth error message when no account ID is found', async () => {
43
- mockGetAccountId.mockReturnValue(null);
44
+ mockGetAccountIdFromCliConfig.mockReturnValue(null);
44
45
  const result = await tool.handler(mockInput);
45
46
  expect(result).toEqual({
46
47
  content: [
@@ -52,7 +53,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
52
53
  });
53
54
  });
54
55
  it('should return successful results when docs are found', async () => {
55
- mockGetAccountId.mockReturnValue(12345);
56
+ mockGetAccountIdFromCliConfig.mockReturnValue(12345);
56
57
  const mockResponse = {
57
58
  results: [
58
59
  {
@@ -76,6 +77,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
76
77
  data: mockResponse,
77
78
  });
78
79
  const result = await tool.handler(mockInput);
80
+ expect(mockGetAccountIdFromCliConfig).toHaveBeenCalledWith('/foo');
79
81
  expect(mockHttp.post).toHaveBeenCalledWith(12345, {
80
82
  url: 'dev/docs/llms/v1/docs-search',
81
83
  data: {
@@ -103,7 +105,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
103
105
  expect(resultText).toContain('Test content 2');
104
106
  });
105
107
  it('should return no results message when no documentation is found', async () => {
106
- mockGetAccountId.mockReturnValue(12345);
108
+ mockGetAccountIdFromCliConfig.mockReturnValue(12345);
107
109
  const mockResponse = {
108
110
  results: [],
109
111
  };
@@ -122,7 +124,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
122
124
  });
123
125
  });
124
126
  it('should return no results message when results is null', async () => {
125
- mockGetAccountId.mockReturnValue(12345);
127
+ mockGetAccountIdFromCliConfig.mockReturnValue(12345);
126
128
  const mockResponse = {
127
129
  results: null,
128
130
  };
@@ -141,7 +143,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
141
143
  });
142
144
  });
143
145
  it('should handle HubSpot HTTP errors', async () => {
144
- mockGetAccountId.mockReturnValue(12345);
146
+ mockGetAccountIdFromCliConfig.mockReturnValue(12345);
145
147
  const mockError = {
146
148
  toString: () => 'HubSpot API Error: 404 Not Found',
147
149
  };
@@ -158,7 +160,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
158
160
  });
159
161
  });
160
162
  it('should handle generic errors', async () => {
161
- mockGetAccountId.mockReturnValue(12345);
163
+ mockGetAccountIdFromCliConfig.mockReturnValue(12345);
162
164
  const mockError = new Error('Network error');
163
165
  mockHttp.post.mockRejectedValue(mockError);
164
166
  mockIsHubSpotHttpError.mockReturnValue(false);
@@ -173,7 +175,7 @@ describe('mcp-server/tools/project/DocsSearchTool', () => {
173
175
  });
174
176
  });
175
177
  it('should handle non-Error rejections', async () => {
176
- mockGetAccountId.mockReturnValue(12345);
178
+ mockGetAccountIdFromCliConfig.mockReturnValue(12345);
177
179
  mockHttp.post.mockRejectedValue('String error');
178
180
  mockIsHubSpotHttpError.mockReturnValue(false);
179
181
  const result = await tool.handler(mockInput);
@@ -0,0 +1,169 @@
1
+ import { GetApiUsagePatternsByAppIdTool } from '../GetApiUsagePatternsByAppIdTool.js';
2
+ import { z } from 'zod';
3
+ import { getAccountId } from '@hubspot/local-dev-lib/config';
4
+ import { http } from '@hubspot/local-dev-lib/http';
5
+ import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
6
+ vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
7
+ vi.mock('../../../utils/toolUsageTracking');
8
+ vi.mock('@hubspot/local-dev-lib/http');
9
+ vi.mock('@hubspot/local-dev-lib/errors/index');
10
+ vi.mock('@hubspot/local-dev-lib/config');
11
+ const mockGetAccountId = getAccountId;
12
+ const mockHttp = http;
13
+ const mockIsHubSpotHttpError = isHubSpotHttpError;
14
+ describe('mcp-server/tools/project/GetApiUsagePatternsByAppIdTool', () => {
15
+ let mockMcpServer;
16
+ let tool;
17
+ let mockRegisteredTool;
18
+ beforeEach(() => {
19
+ vi.clearAllMocks();
20
+ // @ts-expect-error Not mocking the whole thing
21
+ mockMcpServer = {
22
+ registerTool: vi.fn(),
23
+ };
24
+ mockRegisteredTool = {};
25
+ mockMcpServer.registerTool.mockReturnValue(mockRegisteredTool);
26
+ tool = new GetApiUsagePatternsByAppIdTool(mockMcpServer);
27
+ });
28
+ describe('register', () => {
29
+ it('should register tool with correct parameters', () => {
30
+ const result = tool.register();
31
+ expect(mockMcpServer.registerTool).toHaveBeenCalledWith('get-api-usage-patterns-by-app-id', {
32
+ title: 'Get API Usage Patterns by App ID',
33
+ description: 'Retrieves detailed API usage pattern analytics for a specific HubSpot application. Requires an appId (string) to identify the target application. Optionally accepts startDate and endDate parameters in YYYY-MM-DD format to filter results within a specific time range. Returns patternSummaries object containing usage statistics including portalPercentage (percentage of portals using this pattern) and numOfPortals (total count of portals) for different usage patterns. This data helps analyze how the application is being used across different HubSpot portals and can inform optimization decisions.',
34
+ inputSchema: expect.objectContaining({
35
+ appId: expect.objectContaining({
36
+ describe: expect.any(Function),
37
+ }),
38
+ startDate: expect.objectContaining({
39
+ optional: expect.any(Function),
40
+ }),
41
+ endDate: expect.objectContaining({
42
+ optional: expect.any(Function),
43
+ }),
44
+ }),
45
+ }, tool.handler);
46
+ expect(result).toBe(mockRegisteredTool);
47
+ });
48
+ });
49
+ describe('input validation', () => {
50
+ const inputSchema = z.object({
51
+ appId: z
52
+ .string()
53
+ .describe('The application ID to get API usage patterns for.'),
54
+ startDate: z
55
+ .string()
56
+ .regex(/^\d{4}-\d{2}-\d{2}$/, 'Start date must be in YYYY-MM-DD format')
57
+ .optional()
58
+ .describe('Start date for the usage patterns query in ISO 8601 format (e.g., 2025-01-01).'),
59
+ endDate: z
60
+ .string()
61
+ .regex(/^\d{4}-\d{2}-\d{2}$/, 'End date must be in YYYY-MM-DD format')
62
+ .optional()
63
+ .describe('End date for the usage patterns query in ISO 8601 format (e.g., 2025-12-31).'),
64
+ });
65
+ it('should validate date format correctly', () => {
66
+ const validInput = {
67
+ appId: '12345',
68
+ startDate: '2025-01-01',
69
+ endDate: '2025-12-31',
70
+ };
71
+ const invalidInput = {
72
+ appId: '12345',
73
+ startDate: '2025-1-1',
74
+ endDate: '2025-12-31T00:00:00Z',
75
+ };
76
+ expect(() => inputSchema.parse(validInput)).not.toThrow();
77
+ expect(() => inputSchema.parse(invalidInput)).toThrow();
78
+ });
79
+ });
80
+ describe('handler', () => {
81
+ const input = {
82
+ appId: '12345',
83
+ startDate: '2025-01-01',
84
+ endDate: '2025-12-31',
85
+ };
86
+ beforeEach(() => {
87
+ mockGetAccountId.mockReturnValue(123456789);
88
+ mockIsHubSpotHttpError.mockReturnValue(false);
89
+ });
90
+ it('should return API usage patterns successfully', async () => {
91
+ const mockResponse = {
92
+ data: {
93
+ patternSummaries: {
94
+ additionalProp1: {
95
+ portalPercentage: 25.5,
96
+ numOfPortals: 150,
97
+ },
98
+ additionalProp2: {
99
+ portalPercentage: 18.2,
100
+ numOfPortals: 89,
101
+ },
102
+ additionalProp3: {
103
+ portalPercentage: 32.1,
104
+ numOfPortals: 201,
105
+ },
106
+ },
107
+ },
108
+ status: 200,
109
+ statusText: 'OK',
110
+ headers: {},
111
+ config: { headers: {} },
112
+ };
113
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
114
+ mockHttp.get.mockResolvedValue(mockResponse);
115
+ const result = await tool.handler(input);
116
+ expect(mockGetAccountId).toHaveBeenCalledWith();
117
+ expect(mockHttp.get).toHaveBeenCalledWith(123456789, {
118
+ url: 'app/feature/utilization/public/v3/insights/app/12345/usage-patterns',
119
+ params: {
120
+ startDate: '2025-01-01',
121
+ endDate: '2025-12-31',
122
+ },
123
+ });
124
+ expect(result).toEqual({
125
+ content: [
126
+ {
127
+ type: 'text',
128
+ text: JSON.stringify(mockResponse.data, null, 2),
129
+ },
130
+ ],
131
+ });
132
+ });
133
+ it('should return error when account ID cannot be determined', async () => {
134
+ mockGetAccountId.mockReturnValue(null);
135
+ const result = await tool.handler(input);
136
+ expect(result).toEqual({
137
+ content: [
138
+ {
139
+ type: 'text',
140
+ text: 'No account ID found. Please run `hs account auth` to configure an account, or set a default account with `hs account use <account>`',
141
+ },
142
+ ],
143
+ });
144
+ expect(mockHttp.get).not.toHaveBeenCalled();
145
+ });
146
+ it('should handle empty usage patterns response', async () => {
147
+ const mockResponse = {
148
+ data: {
149
+ patternSummaries: {},
150
+ },
151
+ status: 200,
152
+ statusText: 'OK',
153
+ headers: {},
154
+ config: { headers: {} },
155
+ };
156
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
157
+ mockHttp.get.mockResolvedValue(mockResponse);
158
+ const result = await tool.handler(input);
159
+ expect(result).toEqual({
160
+ content: [
161
+ {
162
+ type: 'text',
163
+ text: JSON.stringify(mockResponse.data, null, 2),
164
+ },
165
+ ],
166
+ });
167
+ });
168
+ });
169
+ });
@@ -0,0 +1,115 @@
1
+ import { GetApplicationInfoTool } from '../GetApplicationInfoTool.js';
2
+ import { getAccountId } from '@hubspot/local-dev-lib/config';
3
+ import { http } from '@hubspot/local-dev-lib/http';
4
+ import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
5
+ vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
6
+ vi.mock('../../utils/toolUsageTracking');
7
+ vi.mock('@hubspot/local-dev-lib/http');
8
+ vi.mock('@hubspot/local-dev-lib/errors/index');
9
+ vi.mock('@hubspot/local-dev-lib/config');
10
+ const mockGetAccountId = getAccountId;
11
+ const mockHttp = http;
12
+ const mockIsHubSpotHttpError = isHubSpotHttpError;
13
+ describe('mcp-server/tools/project/GetApplicationInfoTool', () => {
14
+ let mockMcpServer;
15
+ let tool;
16
+ let mockRegisteredTool;
17
+ beforeEach(() => {
18
+ vi.clearAllMocks();
19
+ // @ts-expect-error Not mocking the whole thing
20
+ mockMcpServer = {
21
+ registerTool: vi.fn(),
22
+ };
23
+ mockRegisteredTool = {};
24
+ mockMcpServer.registerTool.mockReturnValue(mockRegisteredTool);
25
+ tool = new GetApplicationInfoTool(mockMcpServer);
26
+ });
27
+ describe('register', () => {
28
+ it('should register tool with correct parameters', () => {
29
+ const result = tool.register();
30
+ expect(mockMcpServer.registerTool).toHaveBeenCalledWith('get-applications-info', {
31
+ title: 'Get Applications Information',
32
+ description: 'Retrieves a list of all HubSpot applications available in the current account. Returns an array of applications, where each application contains an appId (numeric identifier) and appName (string). This information is useful for identifying available applications before using other tools that require specific application IDs, such as getting API usage patterns. No input parameters are required - this tool fetches all applications from the HubSpot Insights API.',
33
+ inputSchema: {},
34
+ }, tool.handler);
35
+ expect(result).toBe(mockRegisteredTool);
36
+ });
37
+ });
38
+ describe('handler', () => {
39
+ const input = {};
40
+ beforeEach(() => {
41
+ mockGetAccountId.mockReturnValue(123456789);
42
+ mockIsHubSpotHttpError.mockReturnValue(false);
43
+ });
44
+ it('should return application information successfully', async () => {
45
+ const mockResponse = {
46
+ data: {
47
+ applications: [
48
+ {
49
+ appId: 12345,
50
+ appName: 'Test App 1',
51
+ },
52
+ {
53
+ appId: 67890,
54
+ appName: 'Test App 2',
55
+ },
56
+ ],
57
+ },
58
+ status: 200,
59
+ statusText: 'OK',
60
+ headers: {},
61
+ config: { headers: {} },
62
+ };
63
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
64
+ mockHttp.get.mockResolvedValue(mockResponse);
65
+ const result = await tool.handler(input);
66
+ expect(mockGetAccountId).toHaveBeenCalledWith();
67
+ expect(mockHttp.get).toHaveBeenCalledWith(123456789, {
68
+ url: 'app/feature/utilization/public/v3/insights/apps',
69
+ });
70
+ expect(result).toEqual({
71
+ content: [
72
+ {
73
+ type: 'text',
74
+ text: JSON.stringify(mockResponse.data, null, 2),
75
+ },
76
+ ],
77
+ });
78
+ });
79
+ it('should return error when account ID cannot be determined', async () => {
80
+ mockGetAccountId.mockReturnValue(null);
81
+ const result = await tool.handler(input);
82
+ expect(result).toEqual({
83
+ content: [
84
+ {
85
+ type: 'text',
86
+ text: 'No account ID found. Please run `hs account auth` to configure an account, or set a default account with `hs account use <account>`',
87
+ },
88
+ ],
89
+ });
90
+ expect(mockHttp.get).not.toHaveBeenCalled();
91
+ });
92
+ it('should handle empty applications response', async () => {
93
+ const mockResponse = {
94
+ data: {
95
+ applications: [],
96
+ },
97
+ status: 200,
98
+ statusText: 'OK',
99
+ headers: {},
100
+ config: { headers: {} },
101
+ };
102
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
103
+ mockHttp.get.mockResolvedValue(mockResponse);
104
+ const result = await tool.handler(input);
105
+ expect(result).toEqual({
106
+ content: [
107
+ {
108
+ type: 'text',
109
+ text: JSON.stringify(mockResponse.data, null, 2),
110
+ },
111
+ ],
112
+ });
113
+ });
114
+ });
115
+ });
@@ -1,13 +1,13 @@
1
1
  import { GetConfigValuesTool } from '../GetConfigValuesTool.js';
2
2
  import { getIntermediateRepresentationSchema, mapToInternalType, } from '@hubspot/project-parsing-lib';
3
- import { getAccountId } from '@hubspot/local-dev-lib/config';
3
+ import { getAccountIdFromCliConfig } from '../../../utils/cliConfig.js';
4
4
  vi.mock('@modelcontextprotocol/sdk/server/mcp.js');
5
5
  vi.mock('@hubspot/project-parsing-lib');
6
- vi.mock('@hubspot/local-dev-lib/config');
6
+ vi.mock('../../../utils/cliConfig.js');
7
7
  vi.mock('../../../utils/toolUsageTracking');
8
8
  const mockGetIntermediateRepresentationSchema = getIntermediateRepresentationSchema;
9
9
  const mockMapToInternalType = mapToInternalType;
10
- const mockGetAccountId = getAccountId;
10
+ const mockGetAccountIdFromCliConfig = getAccountIdFromCliConfig;
11
11
  describe('mcp-server/tools/project/GetConfigValuesTool', () => {
12
12
  let mockMcpServer;
13
13
  let tool;
@@ -44,9 +44,10 @@ describe('mcp-server/tools/project/GetConfigValuesTool', () => {
44
44
  const input = {
45
45
  platformVersion: '2025.2',
46
46
  featureType: 'card',
47
+ absoluteCurrentWorkingDirectory: '/foo',
47
48
  };
48
49
  beforeEach(() => {
49
- mockGetAccountId.mockReturnValue(123456789);
50
+ mockGetAccountIdFromCliConfig.mockReturnValue(123456789);
50
51
  });
51
52
  it('should return config schema when component type exists', async () => {
52
53
  const mockSchema = {
@@ -61,6 +62,7 @@ describe('mcp-server/tools/project/GetConfigValuesTool', () => {
61
62
  mockGetIntermediateRepresentationSchema.mockResolvedValue(mockSchema);
62
63
  mockMapToInternalType.mockReturnValue('internal-card-type');
63
64
  const result = await tool.handler(input);
65
+ expect(mockGetAccountIdFromCliConfig).toHaveBeenCalledWith('/foo');
64
66
  expect(mockGetIntermediateRepresentationSchema).toHaveBeenCalledWith({
65
67
  platformVersion: '2025.2',
66
68
  projectSourceDir: '',
@@ -133,14 +135,13 @@ describe('mcp-server/tools/project/GetConfigValuesTool', () => {
133
135
  });
134
136
  });
135
137
  it('should handle null account id', async () => {
136
- mockGetAccountId.mockReturnValue(null);
137
- mockGetIntermediateRepresentationSchema.mockRejectedValue(new Error('No account ID'));
138
+ mockGetAccountIdFromCliConfig.mockReturnValue(null);
138
139
  const result = await tool.handler(input);
139
140
  expect(result).toEqual({
140
141
  content: [
141
142
  {
142
143
  type: 'text',
143
- text: 'Unable to locate JSON schema for type card',
144
+ text: 'No account ID found. Please run `hs account auth` to configure an account, or set a default account with `hs account use <account>`',
144
145
  },
145
146
  ],
146
147
  });
@@ -0,0 +1 @@
1
+ export {};