@hubspot/cli 8.3.0-beta.0 → 8.3.0-experimental.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 (814) hide show
  1. package/api/migrate.js +3 -3
  2. package/api/releases.d.ts +39 -0
  3. package/api/releases.js +41 -0
  4. package/bin/cli.js +18 -7
  5. package/bin/hs.js +1 -0
  6. package/bin/hscms.js +1 -0
  7. package/bin/setupColor.d.ts +2 -0
  8. package/bin/setupColor.js +10 -0
  9. package/commands/account/auth.d.ts +6 -3
  10. package/commands/account/auth.js +48 -29
  11. package/commands/account/clean.js +7 -6
  12. package/commands/account/createOverride.js +10 -7
  13. package/commands/account/info.js +36 -17
  14. package/commands/account/link.d.ts +4 -0
  15. package/commands/account/link.js +87 -0
  16. package/commands/account/list.js +32 -76
  17. package/commands/account/remove.js +4 -3
  18. package/commands/account/removeOverride.js +11 -10
  19. package/commands/account/rename.js +5 -6
  20. package/commands/account/unlink.d.ts +4 -0
  21. package/commands/account/unlink.js +68 -0
  22. package/commands/account/use.js +79 -20
  23. package/commands/account.js +4 -0
  24. package/commands/api.d.ts +13 -0
  25. package/commands/api.js +161 -0
  26. package/commands/app/logDetails.d.ts +9 -0
  27. package/commands/app/logDetails.js +86 -0
  28. package/commands/app/logs.d.ts +13 -0
  29. package/commands/app/logs.js +126 -0
  30. package/commands/app/migrate.js +12 -12
  31. package/commands/app/secret/add.js +6 -7
  32. package/commands/app/secret/delete.js +9 -10
  33. package/commands/app/secret/list.js +6 -7
  34. package/commands/app/secret/update.js +8 -9
  35. package/commands/app.js +8 -1
  36. package/commands/auth.js +13 -13
  37. package/commands/cms/app/create.js +9 -5
  38. package/commands/cms/convertFields.js +8 -8
  39. package/commands/cms/delete.js +2 -3
  40. package/commands/cms/fetch.js +7 -7
  41. package/commands/cms/function/create.js +9 -5
  42. package/commands/cms/function/deploy.js +2 -3
  43. package/commands/cms/function/list.js +11 -7
  44. package/commands/cms/function/logs.js +17 -23
  45. package/commands/cms/function/server.js +16 -10
  46. package/commands/cms/getReactModule.js +7 -8
  47. package/commands/cms/lighthouseScore.js +25 -24
  48. package/commands/cms/lint.js +4 -5
  49. package/commands/cms/list.js +5 -6
  50. package/commands/cms/module/create.js +15 -5
  51. package/commands/cms/module/marketplace-validate.js +7 -8
  52. package/commands/cms/mv.js +2 -3
  53. package/commands/cms/template/create.js +10 -6
  54. package/commands/cms/theme/create.js +5 -5
  55. package/commands/cms/theme/generate-selectors.js +5 -4
  56. package/commands/cms/theme/marketplace-validate.js +8 -9
  57. package/commands/cms/theme/preview.js +24 -9
  58. package/commands/cms/upload.js +15 -12
  59. package/commands/cms/watch.js +5 -5
  60. package/commands/cms/webpack/create.js +5 -5
  61. package/commands/completion.js +3 -5
  62. package/commands/config/migrate.js +6 -7
  63. package/commands/config/set.js +29 -11
  64. package/commands/customObject/create.js +4 -5
  65. package/commands/customObject/createSchema.js +6 -8
  66. package/commands/customObject/deleteSchema.js +4 -5
  67. package/commands/customObject/fetchAllSchemas.js +2 -3
  68. package/commands/customObject/fetchSchema.js +2 -3
  69. package/commands/customObject/listSchemas.js +2 -3
  70. package/commands/customObject/updateSchema.js +6 -8
  71. package/commands/doctor.js +8 -8
  72. package/commands/feedback.js +6 -4
  73. package/commands/filemanager/fetch.js +5 -6
  74. package/commands/filemanager/upload.js +5 -5
  75. package/commands/getStarted.js +34 -38
  76. package/commands/hubdb/clear.js +5 -6
  77. package/commands/hubdb/create.js +4 -5
  78. package/commands/hubdb/delete.js +8 -9
  79. package/commands/hubdb/fetch.js +5 -6
  80. package/commands/hubdb/list.d.ts +1 -1
  81. package/commands/hubdb/list.js +23 -22
  82. package/commands/init.js +17 -18
  83. package/commands/mcp/setup.d.ts +2 -0
  84. package/commands/mcp/setup.js +35 -8
  85. package/commands/mcp/start.js +2 -3
  86. package/commands/open.js +4 -5
  87. package/commands/project/add.d.ts +3 -2
  88. package/commands/project/add.js +26 -18
  89. package/commands/project/appInstallStatus.d.ts +5 -0
  90. package/commands/project/appInstallStatus.js +139 -0
  91. package/commands/project/create.d.ts +4 -2
  92. package/commands/project/create.js +64 -23
  93. package/commands/project/delete.d.ts +7 -0
  94. package/commands/project/delete.js +74 -0
  95. package/commands/project/deploy.d.ts +2 -1
  96. package/commands/project/deploy.js +72 -50
  97. package/commands/project/dev/index.d.ts +3 -3
  98. package/commands/project/dev/index.js +47 -90
  99. package/commands/project/dev/unifiedFlow.js +81 -22
  100. package/commands/project/download.d.ts +3 -2
  101. package/commands/project/download.js +26 -14
  102. package/commands/project/info.d.ts +5 -0
  103. package/commands/project/info.js +73 -0
  104. package/commands/project/installApp.d.ts +8 -0
  105. package/commands/project/installApp.js +185 -0
  106. package/commands/project/installDeps.js +17 -11
  107. package/commands/project/lint.js +57 -19
  108. package/commands/project/list.d.ts +3 -2
  109. package/commands/project/list.js +34 -15
  110. package/commands/project/listBuilds.d.ts +3 -2
  111. package/commands/project/listBuilds.js +50 -19
  112. package/commands/project/logs.js +7 -10
  113. package/commands/project/migrate.js +26 -31
  114. package/commands/project/open.js +20 -13
  115. package/commands/project/profile/add.d.ts +2 -1
  116. package/commands/project/profile/add.js +42 -13
  117. package/commands/project/profile/delete.d.ts +1 -1
  118. package/commands/project/profile/delete.js +23 -15
  119. package/commands/project/release/create.d.ts +8 -0
  120. package/commands/project/release/create.js +160 -0
  121. package/commands/project/release/info.d.ts +7 -0
  122. package/commands/project/release/info.js +148 -0
  123. package/commands/project/release/list.d.ts +7 -0
  124. package/commands/project/release/list.js +119 -0
  125. package/commands/project/release/preview.d.ts +9 -0
  126. package/commands/project/release/preview.js +167 -0
  127. package/commands/project/release.d.ts +3 -0
  128. package/commands/project/release.js +26 -0
  129. package/commands/project/updateDeps.js +15 -11
  130. package/commands/project/upload.d.ts +7 -1
  131. package/commands/project/upload.js +159 -35
  132. package/commands/project/validate.d.ts +3 -2
  133. package/commands/project/validate.js +73 -103
  134. package/commands/project/watch.js +27 -29
  135. package/commands/project.js +17 -4
  136. package/commands/sandbox/create.js +15 -15
  137. package/commands/sandbox/delete.js +15 -17
  138. package/commands/secret/addSecret.js +6 -7
  139. package/commands/secret/deleteSecret.js +5 -6
  140. package/commands/secret/listSecret.js +2 -3
  141. package/commands/secret/updateSecret.js +4 -5
  142. package/commands/testAccount/create.d.ts +3 -2
  143. package/commands/testAccount/create.js +29 -25
  144. package/commands/testAccount/createConfig.js +7 -8
  145. package/commands/testAccount/delete.js +27 -18
  146. package/commands/testAccount/importData.d.ts +1 -1
  147. package/commands/testAccount/importData.js +6 -7
  148. package/commands/upgrade.js +11 -10
  149. package/lang/en.d.ts +597 -52
  150. package/lang/en.js +637 -76
  151. package/lib/CLIWebSocketServer.d.ts +5 -3
  152. package/lib/CLIWebSocketServer.js +31 -4
  153. package/lib/accountAuth.d.ts +3 -1
  154. package/lib/accountAuth.js +45 -19
  155. package/lib/accountTargetDiscovery.d.ts +15 -0
  156. package/lib/accountTargetDiscovery.js +175 -0
  157. package/lib/api/usageTracking.d.ts +30 -0
  158. package/lib/api/usageTracking.js +11 -0
  159. package/lib/app/install.d.ts +22 -0
  160. package/lib/app/install.js +42 -0
  161. package/lib/app/logs.d.ts +38 -0
  162. package/lib/app/logs.js +225 -0
  163. package/lib/app/migrate.js +13 -7
  164. package/lib/app/urls.d.ts +2 -0
  165. package/lib/app/urls.js +7 -1
  166. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.d.ts +4 -0
  167. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.js +146 -0
  168. package/lib/buildAccount.js +4 -4
  169. package/lib/cms/serverlessDevRuntime.d.ts +1 -0
  170. package/lib/cms/serverlessDevRuntime.js +72 -0
  171. package/lib/commonOpts.js +6 -2
  172. package/lib/configOptions.d.ts +10 -10
  173. package/lib/configOptions.js +10 -11
  174. package/lib/constants.d.ts +14 -2
  175. package/lib/constants.js +16 -2
  176. package/lib/dependencyManagement.js +10 -17
  177. package/lib/doctor/Diagnosis.js +5 -5
  178. package/lib/doctor/DiagnosticInfoBuilder.d.ts +2 -2
  179. package/lib/doctor/DiagnosticInfoBuilder.js +8 -8
  180. package/lib/doctor/Doctor.d.ts +1 -0
  181. package/lib/doctor/Doctor.js +40 -16
  182. package/lib/errorHandlers/index.js +4 -3
  183. package/lib/errorHandlers/suppressError.js +4 -0
  184. package/lib/errors/ProjectErrors.d.ts +0 -6
  185. package/lib/errors/ProjectErrors.js +0 -12
  186. package/lib/errors/ProjectValidationError.d.ts +2 -1
  187. package/lib/errors/ProjectValidationError.js +3 -1
  188. package/lib/errors/PromptExitError.d.ts +4 -2
  189. package/lib/errors/PromptExitError.js +3 -0
  190. package/lib/filesystem.d.ts +6 -0
  191. package/lib/filesystem.js +9 -0
  192. package/lib/getStartedV2Actions.js +18 -21
  193. package/lib/hasFeature.js +1 -2
  194. package/lib/importData.js +3 -4
  195. package/lib/jsonOutput/accountAuth.d.ts +7 -0
  196. package/lib/jsonOutput/accountAuth.js +6 -0
  197. package/lib/jsonOutput/projectAdd.d.ts +9 -0
  198. package/lib/jsonOutput/projectAdd.js +10 -0
  199. package/lib/jsonOutput/projectAppInstallStatus.d.ts +14 -0
  200. package/lib/jsonOutput/projectAppInstallStatus.js +14 -0
  201. package/lib/jsonOutput/projectCreate.d.ts +8 -0
  202. package/lib/jsonOutput/projectCreate.js +7 -0
  203. package/lib/jsonOutput/projectDeploy.d.ts +5 -0
  204. package/lib/jsonOutput/projectDeploy.js +4 -0
  205. package/lib/jsonOutput/projectDownload.d.ts +7 -0
  206. package/lib/jsonOutput/projectDownload.js +6 -0
  207. package/lib/jsonOutput/projectInfo.d.ts +21 -0
  208. package/lib/jsonOutput/projectInfo.js +19 -0
  209. package/lib/jsonOutput/projectInstallApp.d.ts +11 -0
  210. package/lib/jsonOutput/projectInstallApp.js +10 -0
  211. package/lib/jsonOutput/projectList.d.ts +29 -0
  212. package/lib/jsonOutput/projectList.js +28 -0
  213. package/lib/jsonOutput/projectListBuilds.d.ts +75 -0
  214. package/lib/jsonOutput/projectListBuilds.js +65 -0
  215. package/lib/jsonOutput/projectRelease.d.ts +49 -0
  216. package/lib/jsonOutput/projectRelease.js +44 -0
  217. package/lib/jsonOutput/projectUpload.d.ts +29 -0
  218. package/lib/jsonOutput/projectUpload.js +23 -0
  219. package/lib/jsonOutput/projectValidate.d.ts +36 -0
  220. package/lib/jsonOutput/projectValidate.js +20 -0
  221. package/lib/jsonOutput/testAccountCreate.d.ts +7 -0
  222. package/lib/jsonOutput/testAccountCreate.js +6 -0
  223. package/lib/link/accountTableUtils.d.ts +10 -0
  224. package/lib/link/accountTableUtils.js +39 -0
  225. package/lib/link/index.d.ts +18 -0
  226. package/lib/link/index.js +185 -0
  227. package/lib/link/linkUtils.d.ts +5 -0
  228. package/lib/link/linkUtils.js +49 -0
  229. package/lib/link/prompts.d.ts +7 -0
  230. package/lib/link/prompts.js +126 -0
  231. package/lib/link/renderLinkedAccountsTable.d.ts +2 -0
  232. package/lib/link/renderLinkedAccountsTable.js +14 -0
  233. package/lib/link/warnIfLinkedDirectory.d.ts +1 -0
  234. package/lib/link/warnIfLinkedDirectory.js +9 -0
  235. package/lib/links.js +6 -5
  236. package/lib/mcp/clients.d.ts +13 -0
  237. package/lib/mcp/clients.js +62 -0
  238. package/lib/mcp/promotion.d.ts +3 -0
  239. package/lib/mcp/promotion.js +109 -0
  240. package/lib/mcp/setup.d.ts +8 -2
  241. package/lib/mcp/setup.js +134 -39
  242. package/lib/middleware/autoUpdateMiddleware.js +6 -3
  243. package/lib/middleware/commandTargetingUtils.js +1 -0
  244. package/lib/npm/npmCli.d.ts +1 -0
  245. package/lib/npm/npmCli.js +13 -0
  246. package/lib/npm/packageJson.js +1 -1
  247. package/lib/process.d.ts +1 -1
  248. package/lib/process.js +10 -3
  249. package/lib/projects/ProjectLogsManager.js +7 -7
  250. package/lib/projects/add/legacyAddComponent.d.ts +2 -1
  251. package/lib/projects/add/legacyAddComponent.js +3 -0
  252. package/lib/projects/add/v2AddComponent.d.ts +2 -1
  253. package/lib/projects/add/v2AddComponent.js +7 -1
  254. package/lib/projects/builds.d.ts +2 -0
  255. package/lib/projects/builds.js +22 -0
  256. package/lib/projects/components.js +3 -2
  257. package/lib/projects/config.d.ts +6 -5
  258. package/lib/projects/config.js +7 -38
  259. package/lib/projects/create/index.js +2 -2
  260. package/lib/projects/create/legacy.js +2 -2
  261. package/lib/projects/create/tracking.d.ts +1 -0
  262. package/lib/projects/create/tracking.js +27 -0
  263. package/lib/projects/create/v2.js +5 -5
  264. package/lib/projects/delete.d.ts +13 -0
  265. package/lib/projects/delete.js +206 -0
  266. package/lib/projects/deploy.d.ts +1 -1
  267. package/lib/projects/deploy.js +2 -2
  268. package/lib/projects/installApp.d.ts +58 -0
  269. package/lib/projects/installApp.js +283 -0
  270. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  271. package/lib/projects/localDev/AppDevModeInterface.js +33 -55
  272. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  273. package/lib/projects/localDev/DevSessionManager.js +35 -49
  274. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  275. package/lib/projects/localDev/LocalDevLogger.js +18 -0
  276. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  277. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  278. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  279. package/lib/projects/localDev/LocalDevState.js +21 -1
  280. package/lib/projects/localDev/LocalDevWatcher.js +1 -1
  281. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  282. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  283. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  284. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  285. package/lib/projects/localDev/helpers/account.js +8 -90
  286. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  287. package/lib/projects/localDev/helpers/process.js +4 -10
  288. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  289. package/lib/projects/localDev/helpers/project.js +80 -29
  290. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  291. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  292. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  293. package/lib/projects/npmAuditOnUpload.js +73 -0
  294. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  295. package/lib/projects/pollProjectBuildAndDeploy.js +3 -2
  296. package/lib/projects/preview.d.ts +7 -0
  297. package/lib/projects/preview.js +48 -0
  298. package/lib/projects/projectInfo.d.ts +5 -0
  299. package/lib/projects/projectInfo.js +82 -0
  300. package/lib/projects/projectProfiles.d.ts +3 -3
  301. package/lib/projects/projectProfiles.js +11 -18
  302. package/lib/projects/release.d.ts +4 -0
  303. package/lib/projects/release.js +90 -0
  304. package/lib/projects/ui.d.ts +1 -0
  305. package/lib/projects/ui.js +14 -0
  306. package/lib/projects/uieLinting.d.ts +23 -3
  307. package/lib/projects/uieLinting.js +134 -28
  308. package/lib/projects/upload.d.ts +17 -3
  309. package/lib/projects/upload.js +65 -14
  310. package/lib/projects/urls.d.ts +0 -1
  311. package/lib/projects/urls.js +6 -13
  312. package/lib/projects/validate.d.ts +18 -0
  313. package/lib/projects/validate.js +142 -0
  314. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  315. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  316. package/lib/projects/workspaces.d.ts +60 -0
  317. package/lib/projects/workspaces.js +404 -0
  318. package/lib/prompts/createApiSamplePrompt.js +4 -0
  319. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  320. package/lib/prompts/personalAccessKeyPrompt.js +7 -5
  321. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  322. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  323. package/lib/prompts/projectProfilePrompt.d.ts +2 -0
  324. package/lib/prompts/projectProfilePrompt.js +46 -0
  325. package/lib/prompts/projectsLogsPrompt.js +3 -0
  326. package/lib/prompts/promptUtils.js +4 -2
  327. package/lib/prompts/selectAppPrompt.js +1 -0
  328. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  329. package/lib/prompts/selectPublicAppForMigrationPrompt.js +2 -2
  330. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  331. package/lib/serverlessLogs.js +2 -2
  332. package/lib/testUtils.d.ts +1 -0
  333. package/lib/testUtils.js +14 -0
  334. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  335. package/lib/theme/cmsDevServerProcess.js +8 -7
  336. package/lib/theme/migrate.js +1 -4
  337. package/lib/ui/SpinniesManager.d.ts +2 -0
  338. package/lib/ui/SpinniesManager.js +34 -10
  339. package/lib/ui/accountTable.d.ts +8 -0
  340. package/lib/ui/accountTable.js +67 -0
  341. package/lib/ui/appLogs.d.ts +32 -0
  342. package/lib/ui/appLogs.js +175 -0
  343. package/lib/ui/index.js +2 -2
  344. package/lib/ui/spinniesUtils.d.ts +0 -1
  345. package/lib/ui/spinniesUtils.js +6 -16
  346. package/lib/ui/supportsColor.d.ts +4 -0
  347. package/lib/ui/supportsColor.js +25 -6
  348. package/lib/usageTracking.d.ts +10 -20
  349. package/lib/usageTracking.js +77 -30
  350. package/lib/yargs/makeWrappedYargsHandler.d.ts +7 -0
  351. package/lib/yargs/makeWrappedYargsHandler.js +179 -0
  352. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  353. package/lib/yargs/makeYargsBuilder.js +33 -0
  354. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  355. package/lib/yargs/parseYargsOrExit.js +25 -0
  356. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  357. package/lib/yargs/strictEnforceBoolean.js +13 -0
  358. package/lib/yargsUtils.d.ts +3 -16
  359. package/lib/yargsUtils.js +3 -48
  360. package/mcp-server/Tool.d.ts +25 -0
  361. package/mcp-server/Tool.js +83 -0
  362. package/mcp-server/server.js +63 -3
  363. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +5 -3
  364. package/mcp-server/tools/cms/HsCreateFunctionTool.js +18 -23
  365. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  366. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  367. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  368. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  369. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +5 -3
  370. package/mcp-server/tools/cms/HsFunctionLogsTool.js +17 -16
  371. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  372. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  373. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  374. package/mcp-server/tools/cms/HsListTool.js +14 -16
  375. package/mcp-server/tools/index.d.ts +3 -2
  376. package/mcp-server/tools/index.js +28 -22
  377. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  378. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  379. package/mcp-server/tools/project/AuthAccountTool.d.ts +18 -0
  380. package/mcp-server/tools/project/AuthAccountTool.js +88 -0
  381. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  382. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  383. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  384. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  385. package/mcp-server/tools/project/DeployProjectTool.d.ts +5 -3
  386. package/mcp-server/tools/project/DeployProjectTool.js +23 -17
  387. package/mcp-server/tools/project/DocFetchTool.d.ts +5 -3
  388. package/mcp-server/tools/project/DocFetchTool.js +8 -6
  389. package/mcp-server/tools/project/DocsSearchTool.d.ts +9 -3
  390. package/mcp-server/tools/project/DocsSearchTool.js +39 -15
  391. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  392. package/mcp-server/tools/project/FindProjectsTool.js +60 -0
  393. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +6 -3
  394. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +16 -13
  395. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +6 -3
  396. package/mcp-server/tools/project/GetApplicationInfoTool.js +19 -14
  397. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +5 -3
  398. package/mcp-server/tools/project/GetBuildLogsTool.js +19 -14
  399. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  400. package/mcp-server/tools/project/GetBuildStatusTool.js +58 -15
  401. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +6 -3
  402. package/mcp-server/tools/project/GetConfigValuesTool.js +20 -13
  403. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  404. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  405. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  406. package/mcp-server/tools/project/KnowledgeSearchTool.js +79 -0
  407. package/mcp-server/tools/project/UploadProjectTools.d.ts +5 -3
  408. package/mcp-server/tools/project/UploadProjectTools.js +28 -20
  409. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  410. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  411. package/mcp-server/tools/project/constants.d.ts +4 -2
  412. package/mcp-server/tools/project/constants.js +5 -1
  413. package/mcp-server/types.d.ts +3 -8
  414. package/mcp-server/types.js +1 -13
  415. package/mcp-server/utils/command.d.ts +26 -2
  416. package/mcp-server/utils/command.js +75 -15
  417. package/mcp-server/utils/config.js +6 -0
  418. package/mcp-server/utils/content.d.ts +3 -2
  419. package/mcp-server/utils/content.js +6 -1
  420. package/mcp-server/utils/elicitation.d.ts +9 -0
  421. package/mcp-server/utils/elicitation.js +35 -0
  422. package/mcp-server/utils/json.d.ts +3 -0
  423. package/mcp-server/utils/json.js +29 -0
  424. package/mcp-server/utils/logger.d.ts +13 -0
  425. package/mcp-server/utils/logger.js +59 -0
  426. package/mcp-server/utils/toolUsageTracking.js +28 -11
  427. package/package.json +37 -28
  428. package/types/AccountTargets.d.ts +37 -0
  429. package/types/AccountTargets.js +12 -0
  430. package/types/Link.d.ts +32 -0
  431. package/types/Link.js +5 -0
  432. package/types/LocalDev.d.ts +15 -2
  433. package/types/PackageJson.d.ts +1 -0
  434. package/types/ProjectComponents.d.ts +2 -1
  435. package/types/Projects.d.ts +25 -5
  436. package/types/Prompts.d.ts +1 -0
  437. package/types/Yargs.d.ts +23 -2
  438. package/ui/components/ActionSection.d.ts +1 -1
  439. package/ui/components/InputField.d.ts +1 -1
  440. package/ui/components/SelectInput.d.ts +1 -1
  441. package/ui/components/StatusIcon.d.ts +1 -1
  442. package/ui/components/Table.d.ts +13 -13
  443. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  444. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  445. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  446. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  447. package/api/__tests__/migrate.test.d.ts +0 -1
  448. package/api/__tests__/migrate.test.js +0 -199
  449. package/commands/__tests__/account.test.d.ts +0 -1
  450. package/commands/__tests__/account.test.js +0 -69
  451. package/commands/__tests__/auth.test.d.ts +0 -1
  452. package/commands/__tests__/auth.test.js +0 -43
  453. package/commands/__tests__/cms.test.d.ts +0 -1
  454. package/commands/__tests__/cms.test.js +0 -87
  455. package/commands/__tests__/config.test.d.ts +0 -1
  456. package/commands/__tests__/config.test.js +0 -44
  457. package/commands/__tests__/customObject.test.d.ts +0 -1
  458. package/commands/__tests__/customObject.test.js +0 -68
  459. package/commands/__tests__/doctor.test.d.ts +0 -1
  460. package/commands/__tests__/doctor.test.js +0 -132
  461. package/commands/__tests__/feedback.test.d.ts +0 -1
  462. package/commands/__tests__/feedback.test.js +0 -24
  463. package/commands/__tests__/filemanager.test.d.ts +0 -1
  464. package/commands/__tests__/filemanager.test.js +0 -45
  465. package/commands/__tests__/getStarted.test.d.ts +0 -1
  466. package/commands/__tests__/getStarted.test.js +0 -173
  467. package/commands/__tests__/hubdb.test.d.ts +0 -1
  468. package/commands/__tests__/hubdb.test.js +0 -50
  469. package/commands/__tests__/init.test.d.ts +0 -1
  470. package/commands/__tests__/init.test.js +0 -42
  471. package/commands/__tests__/mcp.test.d.ts +0 -1
  472. package/commands/__tests__/mcp.test.js +0 -46
  473. package/commands/__tests__/open.test.d.ts +0 -1
  474. package/commands/__tests__/open.test.js +0 -58
  475. package/commands/__tests__/project.test.d.ts +0 -1
  476. package/commands/__tests__/project.test.js +0 -125
  477. package/commands/__tests__/sandbox.test.d.ts +0 -1
  478. package/commands/__tests__/sandbox.test.js +0 -44
  479. package/commands/__tests__/secret.test.d.ts +0 -1
  480. package/commands/__tests__/secret.test.js +0 -49
  481. package/commands/__tests__/testAccount.test.d.ts +0 -1
  482. package/commands/__tests__/testAccount.test.js +0 -57
  483. package/commands/__tests__/upgrade.test.d.ts +0 -1
  484. package/commands/__tests__/upgrade.test.js +0 -309
  485. package/commands/account/__tests__/auth.test.d.ts +0 -1
  486. package/commands/account/__tests__/auth.test.js +0 -206
  487. package/commands/account/__tests__/clean.test.d.ts +0 -1
  488. package/commands/account/__tests__/clean.test.js +0 -28
  489. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  490. package/commands/account/__tests__/createOverride.test.js +0 -32
  491. package/commands/account/__tests__/info.test.d.ts +0 -1
  492. package/commands/account/__tests__/info.test.js +0 -28
  493. package/commands/account/__tests__/list.test.d.ts +0 -1
  494. package/commands/account/__tests__/list.test.js +0 -153
  495. package/commands/account/__tests__/remove.test.d.ts +0 -1
  496. package/commands/account/__tests__/remove.test.js +0 -36
  497. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  498. package/commands/account/__tests__/removeOverride.js +0 -25
  499. package/commands/account/__tests__/rename.test.d.ts +0 -1
  500. package/commands/account/__tests__/rename.test.js +0 -82
  501. package/commands/account/__tests__/use.test.d.ts +0 -1
  502. package/commands/account/__tests__/use.test.js +0 -170
  503. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  504. package/commands/app/__tests__/migrate.test.js +0 -111
  505. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  506. package/commands/app/secret/__tests__/add.test.js +0 -140
  507. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  508. package/commands/app/secret/__tests__/delete.test.js +0 -28
  509. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  510. package/commands/app/secret/__tests__/list.test.js +0 -25
  511. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  512. package/commands/app/secret/__tests__/update.test.js +0 -28
  513. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  514. package/commands/cms/__tests__/delete.test.js +0 -39
  515. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  516. package/commands/cms/__tests__/fetch.test.js +0 -156
  517. package/commands/cms/__tests__/function.test.d.ts +0 -1
  518. package/commands/cms/__tests__/function.test.js +0 -50
  519. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  520. package/commands/cms/__tests__/lint.test.js +0 -33
  521. package/commands/cms/__tests__/list.test.d.ts +0 -1
  522. package/commands/cms/__tests__/list.test.js +0 -42
  523. package/commands/cms/__tests__/module.test.d.ts +0 -1
  524. package/commands/cms/__tests__/module.test.js +0 -45
  525. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  526. package/commands/cms/__tests__/mv.test.js +0 -46
  527. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  528. package/commands/cms/__tests__/theme.test.js +0 -54
  529. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  530. package/commands/cms/__tests__/upload.test.js +0 -312
  531. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  532. package/commands/cms/__tests__/watch.test.js +0 -204
  533. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  534. package/commands/cms/function/__tests__/logs.test.js +0 -70
  535. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  536. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  537. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  538. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  539. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  540. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  541. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  542. package/commands/customObject/__tests__/create.test.js +0 -40
  543. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  544. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  545. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  546. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  547. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  548. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  549. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  550. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  551. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  552. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  553. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  554. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  555. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  556. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  557. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  558. package/commands/filemanager/__tests__/upload.test.js +0 -191
  559. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  560. package/commands/hubdb/__tests__/clear.test.js +0 -28
  561. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  562. package/commands/hubdb/__tests__/create.test.js +0 -28
  563. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  564. package/commands/hubdb/__tests__/delete.test.js +0 -28
  565. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  566. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  567. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  568. package/commands/hubdb/__tests__/list.test.js +0 -88
  569. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  570. package/commands/mcp/__tests__/setup.test.js +0 -26
  571. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  572. package/commands/mcp/__tests__/start.test.js +0 -144
  573. package/commands/project/__tests__/add.test.d.ts +0 -1
  574. package/commands/project/__tests__/add.test.js +0 -107
  575. package/commands/project/__tests__/create.test.d.ts +0 -1
  576. package/commands/project/__tests__/create.test.js +0 -97
  577. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  578. package/commands/project/__tests__/deploy.test.js +0 -307
  579. package/commands/project/__tests__/dev.test.d.ts +0 -1
  580. package/commands/project/__tests__/dev.test.js +0 -273
  581. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  582. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  583. package/commands/project/__tests__/download.test.d.ts +0 -1
  584. package/commands/project/__tests__/download.test.js +0 -39
  585. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  586. package/commands/project/__tests__/installDeps.test.js +0 -140
  587. package/commands/project/__tests__/lint.test.d.ts +0 -1
  588. package/commands/project/__tests__/lint.test.js +0 -704
  589. package/commands/project/__tests__/list.test.d.ts +0 -1
  590. package/commands/project/__tests__/list.test.js +0 -31
  591. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  592. package/commands/project/__tests__/listBuilds.test.js +0 -38
  593. package/commands/project/__tests__/logs.test.d.ts +0 -1
  594. package/commands/project/__tests__/logs.test.js +0 -202
  595. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  596. package/commands/project/__tests__/migrate.test.js +0 -106
  597. package/commands/project/__tests__/open.test.d.ts +0 -1
  598. package/commands/project/__tests__/open.test.js +0 -39
  599. package/commands/project/__tests__/profile.test.d.ts +0 -1
  600. package/commands/project/__tests__/profile.test.js +0 -42
  601. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  602. package/commands/project/__tests__/updateDeps.test.js +0 -140
  603. package/commands/project/__tests__/upload.test.d.ts +0 -1
  604. package/commands/project/__tests__/upload.test.js +0 -234
  605. package/commands/project/__tests__/validate.test.d.ts +0 -1
  606. package/commands/project/__tests__/validate.test.js +0 -381
  607. package/commands/project/__tests__/watch.test.d.ts +0 -1
  608. package/commands/project/__tests__/watch.test.js +0 -35
  609. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  610. package/commands/project/dev/deprecatedFlow.js +0 -135
  611. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  612. package/commands/sandbox/__tests__/create.test.js +0 -198
  613. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  614. package/commands/sandbox/__tests__/delete.test.js +0 -31
  615. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  616. package/commands/secret/__tests__/addSecret.test.js +0 -162
  617. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  618. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  619. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  620. package/commands/secret/__tests__/listSecret.test.js +0 -29
  621. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  622. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  623. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  624. package/commands/testAccount/__tests__/create.test.js +0 -106
  625. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  626. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  627. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  628. package/commands/testAccount/__tests__/delete.test.js +0 -29
  629. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  630. package/commands/testAccount/__tests__/importData.test.js +0 -92
  631. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  632. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  633. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  634. package/lib/__tests__/accountAuth.test.js +0 -258
  635. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  636. package/lib/__tests__/accountTypes.test.js +0 -98
  637. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  638. package/lib/__tests__/buildAccount.test.js +0 -211
  639. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  640. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  641. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  642. package/lib/__tests__/commandSuggestion.test.js +0 -121
  643. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  644. package/lib/__tests__/commonOpts.test.js +0 -80
  645. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  646. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  647. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  648. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  649. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  650. package/lib/__tests__/hasFeature.test.js +0 -167
  651. package/lib/__tests__/http.test.d.ts +0 -1
  652. package/lib/__tests__/http.test.js +0 -40
  653. package/lib/__tests__/importData.test.d.ts +0 -1
  654. package/lib/__tests__/importData.test.js +0 -98
  655. package/lib/__tests__/npmCli.test.d.ts +0 -1
  656. package/lib/__tests__/npmCli.test.js +0 -84
  657. package/lib/__tests__/oauth.test.d.ts +0 -1
  658. package/lib/__tests__/oauth.test.js +0 -109
  659. package/lib/__tests__/parsing.test.d.ts +0 -1
  660. package/lib/__tests__/parsing.test.js +0 -34
  661. package/lib/__tests__/polling.test.d.ts +0 -1
  662. package/lib/__tests__/polling.test.js +0 -76
  663. package/lib/__tests__/process.test.d.ts +0 -1
  664. package/lib/__tests__/process.test.js +0 -89
  665. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  666. package/lib/__tests__/sandboxes.test.js +0 -128
  667. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  668. package/lib/__tests__/serverlessLogs.test.js +0 -163
  669. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  670. package/lib/__tests__/usageTracking.test.js +0 -197
  671. package/lib/__tests__/validation.test.d.ts +0 -1
  672. package/lib/__tests__/validation.test.js +0 -143
  673. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  674. package/lib/__tests__/yargsUtils.test.js +0 -124
  675. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  676. package/lib/app/__tests__/migrate.test.js +0 -638
  677. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  678. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  679. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  680. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  681. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  682. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  683. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  684. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  685. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  686. package/lib/mcp/__tests__/setup.test.js +0 -523
  687. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  688. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  689. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  690. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  691. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  692. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  693. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  694. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  695. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  696. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  697. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  698. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  699. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  700. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  701. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  702. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  703. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  704. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  705. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  706. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  707. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  708. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  709. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  710. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  711. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  712. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  713. package/lib/projects/__tests__/components.test.d.ts +0 -1
  714. package/lib/projects/__tests__/components.test.js +0 -440
  715. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  716. package/lib/projects/__tests__/deploy.test.js +0 -231
  717. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  718. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  719. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  720. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  721. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  722. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  723. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  724. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  725. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  726. package/lib/projects/__tests__/projects.test.js +0 -58
  727. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  728. package/lib/projects/__tests__/structure.test.js +0 -210
  729. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  730. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  731. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  732. package/lib/projects/__tests__/upload.test.js +0 -183
  733. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  734. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  735. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  736. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  737. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  738. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  739. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  740. package/lib/projects/create/__tests__/v2.test.js +0 -257
  741. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  742. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  743. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  744. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  745. package/lib/projects/platformVersion.d.ts +0 -9
  746. package/lib/projects/platformVersion.js +0 -39
  747. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  748. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  749. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  750. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  751. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  752. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  753. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  754. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  755. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  756. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  757. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  758. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  759. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  760. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  761. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  762. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  763. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  764. package/lib/theme/__tests__/migrate.test.js +0 -247
  765. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  766. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  767. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  768. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  769. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  770. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  771. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  772. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  773. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  774. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  775. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  776. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  777. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  778. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  779. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  780. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  781. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  782. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  783. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  784. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  785. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  786. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  787. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  788. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  789. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  790. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  791. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  792. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  793. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  794. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  795. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  796. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  797. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  798. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  799. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  800. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  801. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  802. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  803. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  804. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  805. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  806. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  807. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  808. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  809. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  810. package/mcp-server/utils/__tests__/command.test.js +0 -275
  811. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  812. package/mcp-server/utils/__tests__/content.test.js +0 -164
  813. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  814. package/mcp-server/utils/__tests__/feedbackTracking.test.js +0 -69
@@ -0,0 +1,179 @@
1
+ import os from 'os';
2
+ import path from 'path';
3
+ import { z } from 'zod';
4
+ import { getConfig } from '@hubspot/local-dev-lib/config';
5
+ import { getStateValue, setStateValue, } from '@hubspot/local-dev-lib/config/state';
6
+ import { STATE_FLAGS } from '@hubspot/local-dev-lib/constants/config';
7
+ import { logger as ldlLogger } from '@hubspot/local-dev-lib/logger';
8
+ import { trackCommandUsage as _trackCommandUsage } from '../usageTracking.js';
9
+ import { pkg } from '../jsonLoader.js';
10
+ import { uiLogger } from '../ui/logger.js';
11
+ import { lib } from '../../lang/en.js';
12
+ import { EXIT_CODES } from '../enums/exitCodes.js';
13
+ import { isPromptExitError } from '../errors/PromptExitError.js';
14
+ import { debugError } from '../errorHandlers/index.js';
15
+ import { MAX_LOG_FILES } from '../constants.js';
16
+ const HANDLER_LOG_DIR = path.join(os.homedir(), '.hscli', 'logs', 'cli');
17
+ function logUsageTrackingMessage(isJsonOutput) {
18
+ if (isJsonOutput) {
19
+ return;
20
+ }
21
+ try {
22
+ const config = getConfig();
23
+ if (config?.allowUsageTracking !== true) {
24
+ return;
25
+ }
26
+ const lastShownVersion = getStateValue(STATE_FLAGS.USAGE_TRACKING_MESSAGE_LAST_SHOW_VERSION);
27
+ if (lastShownVersion === pkg.version) {
28
+ return;
29
+ }
30
+ setStateValue(STATE_FLAGS.USAGE_TRACKING_MESSAGE_LAST_SHOW_VERSION, pkg.version);
31
+ uiLogger.info(lib.usageTracking.transparencyMessage);
32
+ }
33
+ catch (_e) {
34
+ return;
35
+ }
36
+ }
37
+ function createUsageTracker(trackingName, derivedAccountId) {
38
+ const startTime = Date.now();
39
+ const meta = {};
40
+ let fired = false;
41
+ const addMetadata = (newMeta) => {
42
+ Object.assign(meta, newMeta);
43
+ };
44
+ const track = async (successful) => {
45
+ if (fired) {
46
+ return;
47
+ }
48
+ fired = true;
49
+ try {
50
+ const { accountId: overrideAccountId, ...trackingMeta } = meta;
51
+ trackingMeta.successful = successful;
52
+ trackingMeta.executionTime = Date.now() - startTime;
53
+ await _trackCommandUsage(trackingName, trackingMeta, overrideAccountId ?? derivedAccountId);
54
+ }
55
+ catch (_e) { }
56
+ };
57
+ const onForcedExit = () => {
58
+ process.exit(EXIT_CODES.SUCCESS);
59
+ };
60
+ const onSigint = async () => {
61
+ process.removeListener('SIGINT', onSigint);
62
+ process.on('SIGINT', onForcedExit);
63
+ try {
64
+ await track(false);
65
+ }
66
+ catch (_e) { }
67
+ process.removeListener('SIGINT', onForcedExit);
68
+ process.exit(EXIT_CODES.SUCCESS);
69
+ };
70
+ process.on('SIGINT', onSigint);
71
+ const trackAndCleanup = async (successful) => {
72
+ await track(successful);
73
+ process.removeListener('SIGINT', onSigint);
74
+ process.removeListener('SIGINT', onForcedExit);
75
+ };
76
+ return { addMetadata, trackAndCleanup };
77
+ }
78
+ function createJsonOutputManager(isJsonOutput, schema) {
79
+ const data = {};
80
+ let emitted = false;
81
+ const add = (newData) => {
82
+ Object.assign(data, newData);
83
+ };
84
+ const emit = () => {
85
+ if (!emitted && isJsonOutput && Object.keys(data).length > 0) {
86
+ emitted = true;
87
+ if (schema) {
88
+ const result = schema.safeParse(data);
89
+ if (!result.success) {
90
+ uiLogger.json(data);
91
+ uiLogger.warn(lib.jsonSchema.validationFailed);
92
+ return false;
93
+ }
94
+ }
95
+ uiLogger.json(data);
96
+ }
97
+ return true;
98
+ };
99
+ return { add, emit };
100
+ }
101
+ function createLogFileWriter(trackingName, isJsonOutput) {
102
+ const writeLogFile = () => {
103
+ if (isJsonOutput) {
104
+ return null;
105
+ }
106
+ return ldlLogger.writeBufferedLogsToFile({
107
+ dir: HANDLER_LOG_DIR,
108
+ filenamePrefix: trackingName,
109
+ maxFiles: MAX_LOG_FILES,
110
+ });
111
+ };
112
+ const writeFailureLogFile = () => {
113
+ const savedPath = writeLogFile();
114
+ if (savedPath) {
115
+ uiLogger.log('');
116
+ uiLogger.error(lib.handlerLogFile.saved(savedPath));
117
+ }
118
+ };
119
+ return { writeLogFile, writeFailureLogFile };
120
+ }
121
+ export function makeWrappedYargsHandler(trackingName, handler, options) {
122
+ return async (args) => {
123
+ const wrappedHandlerArgs = args;
124
+ const isJsonOutput = Boolean(wrappedHandlerArgs.json || wrappedHandlerArgs.formatOutputAsJson);
125
+ const schema = options?.jsonOutputSchema;
126
+ const tracker = createUsageTracker(trackingName, args.derivedAccountId);
127
+ if (wrappedHandlerArgs.jsonSchema) {
128
+ if (schema) {
129
+ uiLogger.json(z.toJSONSchema(schema));
130
+ }
131
+ else {
132
+ uiLogger.json({ error: lib.jsonSchema.noSchemaForCommand });
133
+ }
134
+ await tracker.trackAndCleanup(true);
135
+ return process.exit(EXIT_CODES.SUCCESS);
136
+ }
137
+ const json = createJsonOutputManager(isJsonOutput, schema);
138
+ const logs = createLogFileWriter(trackingName, isJsonOutput);
139
+ wrappedHandlerArgs.addUsageMetadata = tracker.addMetadata;
140
+ wrappedHandlerArgs.addJsonOutput = json.add;
141
+ wrappedHandlerArgs.exit = async (code) => {
142
+ const jsonValid = json.emit();
143
+ const exitCode = !jsonValid && code === EXIT_CODES.SUCCESS ? EXIT_CODES.WARNING : code;
144
+ await tracker.trackAndCleanup(exitCode !== EXIT_CODES.ERROR);
145
+ if (exitCode === EXIT_CODES.ERROR) {
146
+ logs.writeFailureLogFile();
147
+ }
148
+ else {
149
+ logs.writeLogFile();
150
+ }
151
+ return process.exit(exitCode);
152
+ };
153
+ logUsageTrackingMessage(isJsonOutput);
154
+ try {
155
+ await handler(wrappedHandlerArgs);
156
+ }
157
+ catch (e) {
158
+ const isSuccessfulPromptExit = isPromptExitError(e)
159
+ ? e.exitCode !== EXIT_CODES.ERROR
160
+ : false;
161
+ await tracker.trackAndCleanup(isSuccessfulPromptExit);
162
+ if (isPromptExitError(e)) {
163
+ logs.writeLogFile();
164
+ return process.exit(e.exitCode);
165
+ }
166
+ else {
167
+ debugError(e);
168
+ logs.writeFailureLogFile();
169
+ return process.exit(EXIT_CODES.ERROR);
170
+ }
171
+ }
172
+ const jsonValid = json.emit();
173
+ await tracker.trackAndCleanup(true);
174
+ logs.writeLogFile();
175
+ if (!jsonValid) {
176
+ return process.exit(EXIT_CODES.WARNING);
177
+ }
178
+ };
179
+ }
@@ -0,0 +1,13 @@
1
+ import { Argv } from 'yargs';
2
+ export declare function makeYargsBuilder<T>(callback: (yargs: Argv) => Argv<T>, command: string | string[], describe?: string, options?: {
3
+ useGlobalOptions?: boolean;
4
+ useAccountOptions?: boolean;
5
+ useConfigOptions?: boolean;
6
+ useEnvironmentOptions?: boolean;
7
+ useTestingOptions?: boolean;
8
+ useCmsPublishModeOptions?: boolean | {
9
+ read?: boolean;
10
+ write?: boolean;
11
+ };
12
+ useJSONOutputOptions?: boolean;
13
+ }): (yargs: Argv) => Promise<Argv<T>>;
@@ -0,0 +1,33 @@
1
+ import { addCustomHelpOutput, addTestingOptions, addAccountOptions, addConfigOptions, addGlobalOptions, addUseEnvironmentOptions, addCmsPublishModeOptions, addJSONOutputOptions, } from '../commonOpts.js';
2
+ export function makeYargsBuilder(callback, command, describe, options = {}) {
3
+ return async function (yargs) {
4
+ if (options.useGlobalOptions) {
5
+ addGlobalOptions(yargs);
6
+ }
7
+ if (options.useAccountOptions) {
8
+ addAccountOptions(yargs);
9
+ }
10
+ if (options.useConfigOptions) {
11
+ addConfigOptions(yargs);
12
+ }
13
+ if (options.useEnvironmentOptions) {
14
+ addUseEnvironmentOptions(yargs);
15
+ }
16
+ if (options.useTestingOptions) {
17
+ addTestingOptions(yargs);
18
+ }
19
+ if (options.useJSONOutputOptions) {
20
+ addJSONOutputOptions(yargs);
21
+ }
22
+ if (options.useCmsPublishModeOptions) {
23
+ const opts = typeof options.useCmsPublishModeOptions === 'object'
24
+ ? options.useCmsPublishModeOptions
25
+ : { write: true };
26
+ addCmsPublishModeOptions(yargs, opts);
27
+ }
28
+ const result = callback(yargs);
29
+ // Must go last to pick up available options
30
+ await addCustomHelpOutput(result, command, describe);
31
+ return result;
32
+ };
33
+ }
@@ -0,0 +1,4 @@
1
+ import { ArgumentsCamelCase, Argv } from 'yargs';
2
+ type YargsFailureHandler<T> = (message: string | null, error: unknown, parser: Argv<T>) => never;
3
+ export declare function parseYargsOrExit<T>(parser: Argv<T>, handleFailure: YargsFailureHandler<T>): Promise<ArgumentsCamelCase<T>>;
4
+ export {};
@@ -0,0 +1,25 @@
1
+ function getYargsErrorMessage(error) {
2
+ return error instanceof Error && error.name === 'YError' ? error.message : '';
3
+ }
4
+ function getYargsFailureMessage(message, error) {
5
+ if (message) {
6
+ return message;
7
+ }
8
+ return getYargsErrorMessage(error) || message;
9
+ }
10
+ export async function parseYargsOrExit(parser, handleFailure) {
11
+ let failureHandled = false;
12
+ const parserWithFailureHandler = parser.fail((message, error, yargs) => {
13
+ failureHandled = true;
14
+ return handleFailure(getYargsFailureMessage(message, error), error, yargs);
15
+ });
16
+ try {
17
+ return await parserWithFailureHandler.parseAsync();
18
+ }
19
+ catch (error) {
20
+ if (failureHandled) {
21
+ throw error;
22
+ }
23
+ return handleFailure(getYargsErrorMessage(error), error, parserWithFailureHandler);
24
+ }
25
+ }
@@ -0,0 +1 @@
1
+ export declare function strictEnforceBoolean(rawArgs: string[], booleanOptions: string[]): boolean;
@@ -0,0 +1,13 @@
1
+ import { commands } from '../../lang/en.js';
2
+ export function strictEnforceBoolean(rawArgs, booleanOptions) {
3
+ for (const option of booleanOptions) {
4
+ const argIndex = rawArgs.findIndex(arg => arg.startsWith(`--${option}=`));
5
+ if (argIndex !== -1) {
6
+ const value = rawArgs[argIndex].split('=')[1];
7
+ if (value && !['true', 'false'].includes(value.toLowerCase())) {
8
+ throw new Error(commands.config.subcommands.set.errors.invalidBoolean(option, value));
9
+ }
10
+ }
11
+ }
12
+ return true;
13
+ }
@@ -1,16 +1,3 @@
1
- import { Argv } from 'yargs';
2
- import { hasFlag } from './utils/hasFlag.js';
3
- export { hasFlag };
4
- export declare function makeYargsBuilder<T>(callback: (yargs: Argv) => Argv<T>, command: string | string[], describe?: string, options?: {
5
- useGlobalOptions?: boolean;
6
- useAccountOptions?: boolean;
7
- useConfigOptions?: boolean;
8
- useEnvironmentOptions?: boolean;
9
- useTestingOptions?: boolean;
10
- useCmsPublishModeOptions?: boolean | {
11
- read?: boolean;
12
- write?: boolean;
13
- };
14
- useJSONOutputOptions?: boolean;
15
- }): (yargs: Argv) => Promise<Argv<T>>;
16
- export declare function strictEnforceBoolean(rawArgs: string[], booleanOptions: string[]): boolean;
1
+ export { hasFlag } from './utils/hasFlag.js';
2
+ export { makeYargsBuilder } from './yargs/makeYargsBuilder.js';
3
+ export { strictEnforceBoolean } from './yargs/strictEnforceBoolean.js';
package/lib/yargsUtils.js CHANGED
@@ -1,49 +1,4 @@
1
- import { addCustomHelpOutput, addTestingOptions, addAccountOptions, addConfigOptions, addGlobalOptions, addUseEnvironmentOptions, addCmsPublishModeOptions, addJSONOutputOptions, } from './commonOpts.js';
2
- import { hasFlag } from './utils/hasFlag.js';
3
- import { commands } from '../lang/en.js';
4
1
  // Re-export for backwards compatibility
5
- export { hasFlag };
6
- export function makeYargsBuilder(callback, command, describe, options = {}) {
7
- return async function (yargs) {
8
- if (options.useGlobalOptions) {
9
- addGlobalOptions(yargs);
10
- }
11
- if (options.useAccountOptions) {
12
- addAccountOptions(yargs);
13
- }
14
- if (options.useConfigOptions) {
15
- addConfigOptions(yargs);
16
- }
17
- if (options.useEnvironmentOptions) {
18
- addUseEnvironmentOptions(yargs);
19
- }
20
- if (options.useTestingOptions) {
21
- addTestingOptions(yargs);
22
- }
23
- if (options.useJSONOutputOptions) {
24
- addJSONOutputOptions(yargs);
25
- }
26
- if (options.useCmsPublishModeOptions) {
27
- const opts = typeof options.useCmsPublishModeOptions === 'object'
28
- ? options.useCmsPublishModeOptions
29
- : { write: true };
30
- addCmsPublishModeOptions(yargs, opts);
31
- }
32
- const result = callback(yargs);
33
- // Must go last to pick up available options
34
- await addCustomHelpOutput(result, command, describe);
35
- return result;
36
- };
37
- }
38
- export function strictEnforceBoolean(rawArgs, booleanOptions) {
39
- for (const option of booleanOptions) {
40
- const argIndex = rawArgs.findIndex(arg => arg.startsWith(`--${option}=`));
41
- if (argIndex !== -1) {
42
- const value = rawArgs[argIndex].split('=')[1];
43
- if (value && !['true', 'false'].includes(value.toLowerCase())) {
44
- throw new Error(commands.config.subcommands.set.errors.invalidBoolean(option, value));
45
- }
46
- }
47
- }
48
- return true;
49
- }
2
+ export { hasFlag } from './utils/hasFlag.js';
3
+ export { makeYargsBuilder } from './yargs/makeYargsBuilder.js';
4
+ export { strictEnforceBoolean } from './yargs/strictEnforceBoolean.js';
@@ -0,0 +1,25 @@
1
+ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
3
+ import { ElicitResult, PrimitiveSchemaDefinition, ServerNotification, ServerRequest } from '@modelcontextprotocol/sdk/types.js';
4
+ import { McpLogger } from './utils/logger.js';
5
+ import { McpToolResponse } from './types.js';
6
+ import { CommandResults, Command } from './utils/command.js';
7
+ export type ToolExtra = RequestHandlerExtra<ServerRequest, ServerNotification>;
8
+ export declare class Tool<InputSchema> {
9
+ protected mcpServer: McpServer;
10
+ protected logger: McpLogger;
11
+ protected toolName: string;
12
+ constructor(mcpServer: McpServer, logger: McpLogger, toolName: string);
13
+ register(): RegisteredTool;
14
+ handler(_input: InputSchema): McpToolResponse | Promise<McpToolResponse>;
15
+ protected runCommand(directory: string, command: Command, extra?: ToolExtra): Promise<CommandResults>;
16
+ protected getTrackingMeta(_input: InputSchema): {
17
+ [key: string]: string;
18
+ } | undefined;
19
+ protected elicit(params: {
20
+ message: string;
21
+ fields: Record<string, PrimitiveSchemaDefinition>;
22
+ required?: string[];
23
+ }): Promise<ElicitResult | undefined>;
24
+ protected wrappedHandler(input: InputSchema, extra?: ToolExtra): Promise<McpToolResponse>;
25
+ }
@@ -0,0 +1,83 @@
1
+ import { formatErrorTextContents } from './utils/content.js';
2
+ import { getErrorMessage } from '../lib/errorHandlers/index.js';
3
+ import { trackToolUsage } from './utils/toolUsageTracking.js';
4
+ import { runCommandInDir } from './utils/command.js';
5
+ import { requestElicitation } from './utils/elicitation.js';
6
+ export class Tool {
7
+ mcpServer;
8
+ logger;
9
+ toolName;
10
+ constructor(mcpServer, logger, toolName) {
11
+ this.mcpServer = mcpServer;
12
+ this.logger = logger;
13
+ this.toolName = toolName;
14
+ }
15
+ register() {
16
+ throw new Error('Must implement register');
17
+ }
18
+ handler(_input) {
19
+ throw new Error('Must implement handler');
20
+ }
21
+ runCommand(directory, command, extra) {
22
+ let progressCount = 0;
23
+ return runCommandInDir(directory, command, async (chunk) => {
24
+ try {
25
+ const message = `${chunk.trimEnd()}`;
26
+ this.logger.debug(this.toolName, message);
27
+ const token = extra?._meta?.progressToken;
28
+ if (token !== undefined && extra?.sendNotification) {
29
+ progressCount++;
30
+ await extra.sendNotification({
31
+ method: 'notifications/progress',
32
+ params: {
33
+ progressToken: token,
34
+ progress: progressCount,
35
+ message,
36
+ },
37
+ });
38
+ }
39
+ }
40
+ catch {
41
+ // Swallow notification errors so a failed notification never crashes the tool
42
+ }
43
+ });
44
+ }
45
+ getTrackingMeta(_input) {
46
+ return undefined;
47
+ }
48
+ elicit(params) {
49
+ return requestElicitation(this.mcpServer, params, this.logger);
50
+ }
51
+ wrappedHandler(input, extra) {
52
+ return this.logger.runWithBuffer(async () => {
53
+ const startTime = Date.now();
54
+ try {
55
+ // `input` is logged unredacted. Tool input schemas MUST NOT include
56
+ // credentials or other sensitive values, since MCP clients (Claude
57
+ // Desktop, Inspector, etc.) will display these logs.
58
+ this.logger.debug(this.toolName, {
59
+ message: 'Tool invoked',
60
+ args: input,
61
+ });
62
+ await trackToolUsage(this.toolName, this.getTrackingMeta(input));
63
+ const result = await this.handler(input, extra);
64
+ this.logger.debug(this.toolName, {
65
+ message: 'Tool completed',
66
+ durationMs: Date.now() - startTime,
67
+ });
68
+ return result;
69
+ }
70
+ catch (error) {
71
+ this.logger.error(this.toolName, {
72
+ message: 'Tool failed',
73
+ error: error instanceof Error ? error.message : String(error),
74
+ durationMs: Date.now() - startTime,
75
+ });
76
+ return formatErrorTextContents(getErrorMessage(error));
77
+ }
78
+ finally {
79
+ this.logger.flushLogsToFile(this.toolName);
80
+ }
81
+ });
82
+ }
83
+ }
@@ -1,13 +1,73 @@
1
1
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
2
  import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
3
3
  import { registerProjectTools, registerCmsTools } from './tools/index.js';
4
+ import { McpLogger } from './utils/logger.js';
5
+ const instructions = `
6
+ This server exposes the HubSpot CLI (\`hs\`) for local development of HubSpot
7
+ projects, apps, and CMS assets. Prefer these tools over running \`hs\`,
8
+ \`npx hs\`, or HubSpot HTTP APIs directly via shell — they handle config
9
+ loading, auth, platform-version flags, and structured output for you.
10
+
11
+ WHEN TO USE THIS SERVER
12
+ - The user is working in a HubSpot project directory (has an hsproject.json
13
+ or *-hsmeta.json files), or wants to scaffold one.
14
+ - The user asks about HubSpot apps, CMS modules/templates/serverless
15
+ functions, project builds, deploys, or developer test accounts.
16
+ - The user asks a HubSpot platform/API question — answer it from the docs
17
+ via \`search-docs\` + \`fetch-doc\` rather than from prior knowledge.
18
+ - The user asks how to use HubSpot products or features, or about account
19
+ and subscription settings — answer it via \`search-knowledge-base\`
20
+ rather than from prior knowledge.
21
+
22
+ REQUIRED WORKFLOWS
23
+ 1. Authentication: call \`auth-account\` when the user wants to connect a
24
+ HubSpot account, when any tool reports "No account ID found", or when
25
+ there are no authenticated accounts. The tool opens a browser tab for
26
+ the user to authorize — no Personal Access Key is required up front.
27
+ 2. Documentation lookup: for developer APIs, SDKs, and platform reference,
28
+ call \`search-docs\` first, then \`fetch-doc\` on the most relevant
29
+ result(s). For HubSpot product, feature, or account and subscription
30
+ how-to questions, call \`search-knowledge-base\`. Answer from these
31
+ tools before planning, writing code, or answering. Do not answer from
32
+ memory.
33
+ 3. Locating a HubSpot project: when the current working directory is not
34
+ a HubSpot project (no \`hsproject.json\`) or you need to determine
35
+ whether a directory contains one, call \`find-projects\` before
36
+ running any tool that requires a project path.
37
+ 4. Editing \`*-hsmeta.json\`: call \`get-feature-config-schema\` for that
38
+ feature type first to learn the allowed fields and values.
39
+ 5. Debugging a failed build: start with \`get-build-status\` to surface
40
+ error messages, and only reach for \`get-build-logs\` for deeper
41
+ troubleshooting or warnings.
42
+ 6. Reading serverless function logs: call \`list-cms-serverless-functions\`
43
+ first to discover the endpoint path, then
44
+ \`get-cms-serverless-function-logs\`.
45
+ 7. Serverless functions come in two distinct kinds. CMS serverless
46
+ functions are website endpoints served at \`/hs/serverless/<path>\`.
47
+ Create them with \`create-cms-function\`, and manage them with
48
+ \`list-cms-serverless-functions\` and
49
+ \`get-cms-serverless-function-logs\`. App functions are serverless
50
+ functions built inside a developer-platform app, either private
51
+ (the \`app-function\` feature) or publicly accessible via an endpoint
52
+ (the \`app-function-endpoint\` feature). Create them with
53
+ \`add-feature-to-project\`. Do not use the CMS function tools for app
54
+ functions.
55
+ 8. App analytics: call \`get-apps-info\` to discover \`appId\` values
56
+ before \`get-api-usage-patterns-by-app-id\`.
57
+
58
+ OUTPUT
59
+ Tool results contain the relevant \`hs\` stdout/stderr or structured data.
60
+ Surface error text from results to the user verbatim when troubleshooting,
61
+ rather than paraphrasing.
62
+ `.trim();
4
63
  const server = new McpServer({
5
64
  name: 'HubSpot CLI MCP Server',
6
65
  version: '0.0.1',
7
66
  description: 'Helps perform tasks for local development of HubSpot projects.',
8
- });
9
- registerProjectTools(server);
10
- registerCmsTools(server);
67
+ }, { capabilities: { logging: {} }, instructions });
68
+ const logger = new McpLogger(server);
69
+ registerProjectTools(server, logger);
70
+ registerCmsTools(server, logger);
11
71
  // Start receiving messages on stdin and sending messages on stdout
12
72
  const transport = new StdioServerTransport();
13
73
  server.connect(transport);
@@ -1,5 +1,7 @@
1
- import { TextContentResponse, Tool } from '../../types.js';
1
+ import { McpToolResponse } from '../../types.js';
2
+ import { Tool, ToolExtra } from '../../Tool.js';
2
3
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { McpLogger } from '../../utils/logger.js';
3
5
  import { z } from 'zod';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  absoluteCurrentWorkingDirectory: z.ZodString;
@@ -17,8 +19,8 @@ declare const inputSchemaZodObject: z.ZodObject<{
17
19
  }, z.core.$strip>;
18
20
  export type HsCreateFunctionInputSchema = z.infer<typeof inputSchemaZodObject>;
19
21
  export declare class HsCreateFunctionTool extends Tool<HsCreateFunctionInputSchema> {
20
- constructor(mcpServer: McpServer);
21
- handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }: HsCreateFunctionInputSchema): Promise<TextContentResponse>;
22
+ constructor(mcpServer: McpServer, logger: McpLogger);
23
+ handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }: HsCreateFunctionInputSchema, extra?: ToolExtra): Promise<McpToolResponse>;
22
24
  register(): RegisteredTool;
23
25
  }
24
26
  export {};
@@ -1,11 +1,9 @@
1
- import { Tool } from '../../types.js';
1
+ import { Tool } from '../../Tool.js';
2
2
  import { z } from 'zod';
3
3
  import { absoluteCurrentWorkingDirectory } from '../project/constants.js';
4
- import { runCommandInDir } from '../../utils/command.js';
5
4
  import { formatTextContents, formatTextContent } from '../../utils/content.js';
6
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
7
- import { addFlag } from '../../utils/command.js';
8
5
  import { HTTP_METHODS } from '../../../types/Cms.js';
6
+ import { HubSpotCommand } from '../../utils/command.js';
9
7
  import { setupHubSpotConfig } from '../../utils/config.js';
10
8
  import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
11
9
  const inputSchema = {
@@ -35,12 +33,11 @@ const inputSchema = {
35
33
  const inputSchemaZodObject = z.object({ ...inputSchema });
36
34
  const toolName = 'create-cms-function';
37
35
  export class HsCreateFunctionTool extends Tool {
38
- constructor(mcpServer) {
39
- super(mcpServer);
36
+ constructor(mcpServer, logger) {
37
+ super(mcpServer, logger, toolName);
40
38
  }
41
- async handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }) {
39
+ async handler({ dest, functionsFolder, filename, endpointMethod, endpointPath, absoluteCurrentWorkingDirectory, }, extra) {
42
40
  setupHubSpotConfig(absoluteCurrentWorkingDirectory);
43
- await trackToolUsage(toolName);
44
41
  const content = [];
45
42
  // Require functions folder
46
43
  if (!functionsFolder) {
@@ -61,38 +58,36 @@ export class HsCreateFunctionTool extends Tool {
61
58
  };
62
59
  }
63
60
  // Build the command
64
- let command = 'hs create function';
61
+ const command = new HubSpotCommand('cms function create');
65
62
  if (dest) {
66
- command += ` "${dest}"`;
63
+ command.addArg(dest);
67
64
  }
68
- // Add function-specific flags
69
65
  if (functionsFolder) {
70
- command = addFlag(command, 'functions-folder', functionsFolder);
66
+ command.addFlag('functions-folder', functionsFolder);
71
67
  }
72
68
  if (filename) {
73
- command = addFlag(command, 'filename', filename);
74
- }
75
- if (endpointMethod) {
76
- command = addFlag(command, 'endpoint-method', endpointMethod);
77
- }
78
- else {
79
- command = addFlag(command, 'endpoint-method', 'GET');
69
+ command.addFlag('filename', filename);
80
70
  }
71
+ command.addFlag('endpoint-method', endpointMethod ?? 'GET');
81
72
  if (endpointPath) {
82
- command = addFlag(command, 'endpoint-path', endpointPath);
73
+ command.addFlag('endpoint-path', endpointPath);
83
74
  }
84
75
  try {
85
- const { stdout, stderr } = await runCommandInDir(absoluteCurrentWorkingDirectory, command);
76
+ const { stdout, stderr } = await this.runCommand(absoluteCurrentWorkingDirectory, command, extra);
86
77
  return formatTextContents(stdout, stderr);
87
78
  }
88
79
  catch (error) {
80
+ this.logger.debug(toolName, {
81
+ message: 'Handler caught error',
82
+ error: error instanceof Error ? error.message : String(error),
83
+ });
89
84
  return formatTextContents(getErrorMessage(error));
90
85
  }
91
86
  }
92
87
  register() {
93
88
  return this.mcpServer.registerTool(toolName, {
94
89
  title: 'Create HubSpot CMS Serverless Function',
95
- description: `Creates a new HubSpot CMS serverless function using the hs create function command. Functions can be created non-interactively by specifying functionsFolder, filename, and endpointPath. Supports all HTTP methods (${HTTP_METHODS.join(', ')}).`,
90
+ description: `Creates a new HubSpot CMS serverless function using the hs cms function create command. This is for CMS/website projects, served at /hs/serverless/<path>. Do NOT use this for developer-platform app functions (the private app-function feature or the public app-function-endpoint feature). For those, use add-feature-to-project. Functions can be created non-interactively by specifying functionsFolder, filename, and endpointPath. Supports all HTTP methods (${HTTP_METHODS.join(', ')}).`,
96
91
  inputSchema,
97
92
  annotations: {
98
93
  readOnlyHint: false,
@@ -100,6 +95,6 @@ export class HsCreateFunctionTool extends Tool {
100
95
  idempotentHint: false,
101
96
  openWorldHint: false,
102
97
  },
103
- }, this.handler);
98
+ }, (input, extra) => this.wrappedHandler(input, extra));
104
99
  }
105
100
  }
@@ -1,5 +1,7 @@
1
- import { TextContentResponse, Tool } from '../../types.js';
1
+ import { McpToolResponse } from '../../types.js';
2
+ import { Tool, ToolExtra } from '../../Tool.js';
2
3
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { McpLogger } from '../../utils/logger.js';
3
5
  import { z } from 'zod';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  absoluteCurrentWorkingDirectory: z.ZodString;
@@ -13,8 +15,8 @@ declare const inputSchemaZodObject: z.ZodObject<{
13
15
  }, z.core.$strip>;
14
16
  export type HsCreateModuleInputSchema = z.infer<typeof inputSchemaZodObject>;
15
17
  export declare class HsCreateModuleTool extends Tool<HsCreateModuleInputSchema> {
16
- constructor(mcpServer: McpServer);
17
- handler({ userSuppliedName, dest, moduleLabel, reactType, contentTypes, global, availableForNewContent, absoluteCurrentWorkingDirectory, }: HsCreateModuleInputSchema): Promise<TextContentResponse>;
18
+ constructor(mcpServer: McpServer, logger: McpLogger);
19
+ handler({ userSuppliedName, dest, moduleLabel, reactType, contentTypes, global, availableForNewContent, absoluteCurrentWorkingDirectory, }: HsCreateModuleInputSchema, extra?: ToolExtra): Promise<McpToolResponse>;
18
20
  register(): RegisteredTool;
19
21
  }
20
22
  export {};