@hubspot/cli 8.3.0 → 8.3.1-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 (825) 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 +20 -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 +13 -13
  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 +28 -33
  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 +605 -52
  150. package/lang/en.js +648 -78
  151. package/lib/CLIWebSocketServer.d.ts +5 -3
  152. package/lib/CLIWebSocketServer.js +31 -4
  153. package/lib/accountAuth.d.ts +4 -1
  154. package/lib/accountAuth.js +53 -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 -1
  165. package/lib/app/urls.js +6 -4
  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 +20 -2
  175. package/lib/constants.js +27 -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/middleware/deprecationWarningMiddleware.d.ts +1 -0
  245. package/lib/middleware/deprecationWarningMiddleware.js +57 -0
  246. package/lib/npm/npmCli.d.ts +1 -0
  247. package/lib/npm/npmCli.js +13 -0
  248. package/lib/npm/packageJson.js +1 -1
  249. package/lib/process.d.ts +1 -1
  250. package/lib/process.js +10 -3
  251. package/lib/projects/ProjectLogsManager.js +7 -7
  252. package/lib/projects/add/legacyAddComponent.d.ts +2 -1
  253. package/lib/projects/add/legacyAddComponent.js +3 -0
  254. package/lib/projects/add/v2AddComponent.d.ts +2 -1
  255. package/lib/projects/add/v2AddComponent.js +7 -1
  256. package/lib/projects/builds.d.ts +2 -0
  257. package/lib/projects/builds.js +22 -0
  258. package/lib/projects/config.d.ts +6 -5
  259. package/lib/projects/config.js +7 -38
  260. package/lib/projects/create/index.js +2 -2
  261. package/lib/projects/create/legacy.js +2 -2
  262. package/lib/projects/create/tracking.d.ts +1 -0
  263. package/lib/projects/create/tracking.js +27 -0
  264. package/lib/projects/create/v2.js +4 -4
  265. package/lib/projects/delete.d.ts +13 -0
  266. package/lib/projects/delete.js +206 -0
  267. package/lib/projects/deploy.d.ts +1 -1
  268. package/lib/projects/deploy.js +2 -2
  269. package/lib/projects/installApp.d.ts +58 -0
  270. package/lib/projects/installApp.js +283 -0
  271. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  272. package/lib/projects/localDev/AppDevModeInterface.js +33 -55
  273. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  274. package/lib/projects/localDev/DevSessionManager.js +35 -49
  275. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  276. package/lib/projects/localDev/LocalDevLogger.js +18 -0
  277. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  278. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  279. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  280. package/lib/projects/localDev/LocalDevState.js +21 -1
  281. package/lib/projects/localDev/LocalDevWatcher.js +2 -2
  282. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  283. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  284. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  285. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  286. package/lib/projects/localDev/helpers/account.js +8 -90
  287. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  288. package/lib/projects/localDev/helpers/process.js +4 -10
  289. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  290. package/lib/projects/localDev/helpers/project.js +80 -29
  291. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  292. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  293. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  294. package/lib/projects/npmAuditOnUpload.js +73 -0
  295. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  296. package/lib/projects/pollProjectBuildAndDeploy.js +3 -2
  297. package/lib/projects/preview.d.ts +7 -0
  298. package/lib/projects/preview.js +48 -0
  299. package/lib/projects/projectInfo.d.ts +5 -0
  300. package/lib/projects/projectInfo.js +82 -0
  301. package/lib/projects/projectProfiles.d.ts +3 -3
  302. package/lib/projects/projectProfiles.js +11 -18
  303. package/lib/projects/release.d.ts +4 -0
  304. package/lib/projects/release.js +90 -0
  305. package/lib/projects/ui.d.ts +1 -0
  306. package/lib/projects/ui.js +14 -0
  307. package/lib/projects/uieLinting.d.ts +23 -3
  308. package/lib/projects/uieLinting.js +134 -28
  309. package/lib/projects/upload.d.ts +17 -3
  310. package/lib/projects/upload.js +65 -14
  311. package/lib/projects/urls.d.ts +0 -1
  312. package/lib/projects/urls.js +6 -13
  313. package/lib/projects/validate.d.ts +18 -0
  314. package/lib/projects/validate.js +142 -0
  315. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  316. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  317. package/lib/projects/workspaces.d.ts +60 -0
  318. package/lib/projects/workspaces.js +404 -0
  319. package/lib/prompts/createApiSamplePrompt.js +4 -0
  320. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  321. package/lib/prompts/personalAccessKeyPrompt.js +7 -5
  322. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  323. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  324. package/lib/prompts/projectProfilePrompt.d.ts +9 -0
  325. package/lib/prompts/projectProfilePrompt.js +46 -0
  326. package/lib/prompts/projectsLogsPrompt.js +3 -0
  327. package/lib/prompts/promptUtils.js +4 -2
  328. package/lib/prompts/selectAppPrompt.js +1 -0
  329. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  330. package/lib/prompts/selectPublicAppForMigrationPrompt.js +2 -2
  331. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  332. package/lib/serverlessLogs.js +2 -2
  333. package/lib/testUtils.d.ts +6 -0
  334. package/lib/testUtils.js +38 -0
  335. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  336. package/lib/theme/cmsDevServerProcess.js +8 -7
  337. package/lib/theme/migrate.js +1 -4
  338. package/lib/ui/SpinniesManager.d.ts +2 -0
  339. package/lib/ui/SpinniesManager.js +34 -10
  340. package/lib/ui/accountTable.d.ts +8 -0
  341. package/lib/ui/accountTable.js +67 -0
  342. package/lib/ui/appLogs.d.ts +32 -0
  343. package/lib/ui/appLogs.js +175 -0
  344. package/lib/ui/index.js +13 -3
  345. package/lib/ui/spinniesUtils.d.ts +0 -1
  346. package/lib/ui/spinniesUtils.js +6 -16
  347. package/lib/ui/supportsColor.d.ts +4 -0
  348. package/lib/ui/supportsColor.js +25 -6
  349. package/lib/ui/uiMessages.d.ts +1 -0
  350. package/lib/ui/uiMessages.js +1 -0
  351. package/lib/usageTracking.d.ts +10 -20
  352. package/lib/usageTracking.js +77 -30
  353. package/lib/yargs/makeWrappedYargsHandler.d.ts +7 -0
  354. package/lib/yargs/makeWrappedYargsHandler.js +179 -0
  355. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  356. package/lib/yargs/makeYargsBuilder.js +33 -0
  357. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  358. package/lib/yargs/parseYargsOrExit.js +25 -0
  359. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  360. package/lib/yargs/strictEnforceBoolean.js +13 -0
  361. package/lib/yargsUtils.d.ts +3 -16
  362. package/lib/yargsUtils.js +3 -48
  363. package/mcp-server/Tool.d.ts +25 -0
  364. package/mcp-server/Tool.js +83 -0
  365. package/mcp-server/server.js +69 -3
  366. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +5 -3
  367. package/mcp-server/tools/cms/HsCreateFunctionTool.js +18 -23
  368. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  369. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  370. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  371. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  372. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +6 -4
  373. package/mcp-server/tools/cms/HsFunctionLogsTool.js +75 -20
  374. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  375. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  376. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  377. package/mcp-server/tools/cms/HsListTool.js +14 -16
  378. package/mcp-server/tools/index.d.ts +3 -2
  379. package/mcp-server/tools/index.js +28 -22
  380. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  381. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  382. package/mcp-server/tools/project/AuthAccountTool.d.ts +19 -0
  383. package/mcp-server/tools/project/AuthAccountTool.js +109 -0
  384. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  385. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  386. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  387. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  388. package/mcp-server/tools/project/DeployProjectTool.d.ts +6 -4
  389. package/mcp-server/tools/project/DeployProjectTool.js +44 -28
  390. package/mcp-server/tools/project/DocFetchTool.d.ts +5 -3
  391. package/mcp-server/tools/project/DocFetchTool.js +9 -7
  392. package/mcp-server/tools/project/DocsSearchTool.d.ts +12 -3
  393. package/mcp-server/tools/project/DocsSearchTool.js +50 -17
  394. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  395. package/mcp-server/tools/project/FindProjectsTool.js +72 -0
  396. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +8 -4
  397. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +48 -17
  398. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +7 -3
  399. package/mcp-server/tools/project/GetApplicationInfoTool.js +26 -22
  400. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +6 -3
  401. package/mcp-server/tools/project/GetBuildLogsTool.js +25 -17
  402. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  403. package/mcp-server/tools/project/GetBuildStatusTool.js +25 -17
  404. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +7 -3
  405. package/mcp-server/tools/project/GetConfigValuesTool.js +25 -15
  406. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  407. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  408. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  409. package/mcp-server/tools/project/KnowledgeSearchTool.js +82 -0
  410. package/mcp-server/tools/project/UploadProjectTools.d.ts +6 -4
  411. package/mcp-server/tools/project/UploadProjectTools.js +63 -42
  412. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  413. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  414. package/mcp-server/tools/project/apps.d.ts +8 -0
  415. package/mcp-server/tools/project/apps.js +7 -0
  416. package/mcp-server/tools/project/constants.d.ts +6 -2
  417. package/mcp-server/tools/project/constants.js +12 -1
  418. package/mcp-server/tools/project/productionConfirmation.d.ts +12 -0
  419. package/mcp-server/tools/project/productionConfirmation.js +45 -0
  420. package/mcp-server/tools/project/resolveAccount.d.ts +15 -0
  421. package/mcp-server/tools/project/resolveAccount.js +60 -0
  422. package/mcp-server/types.d.ts +3 -8
  423. package/mcp-server/types.js +1 -13
  424. package/mcp-server/utils/command.d.ts +26 -2
  425. package/mcp-server/utils/command.js +75 -15
  426. package/mcp-server/utils/config.js +6 -0
  427. package/mcp-server/utils/content.d.ts +3 -2
  428. package/mcp-server/utils/content.js +6 -1
  429. package/mcp-server/utils/elicitSelection.d.ts +11 -0
  430. package/mcp-server/utils/elicitSelection.js +25 -0
  431. package/mcp-server/utils/elicitation.d.ts +11 -0
  432. package/mcp-server/utils/elicitation.js +38 -0
  433. package/mcp-server/utils/json.d.ts +3 -0
  434. package/mcp-server/utils/json.js +29 -0
  435. package/mcp-server/utils/logger.d.ts +13 -0
  436. package/mcp-server/utils/logger.js +59 -0
  437. package/mcp-server/utils/toolUsageTracking.js +28 -11
  438. package/package.json +37 -28
  439. package/types/AccountTargets.d.ts +37 -0
  440. package/types/AccountTargets.js +12 -0
  441. package/types/Link.d.ts +32 -0
  442. package/types/Link.js +5 -0
  443. package/types/LocalDev.d.ts +15 -2
  444. package/types/PackageJson.d.ts +1 -0
  445. package/types/ProjectComponents.d.ts +2 -1
  446. package/types/Projects.d.ts +25 -5
  447. package/types/Prompts.d.ts +1 -0
  448. package/types/Yargs.d.ts +23 -2
  449. package/ui/components/ActionSection.d.ts +1 -1
  450. package/ui/components/InputField.d.ts +1 -1
  451. package/ui/components/SelectInput.d.ts +1 -1
  452. package/ui/components/StatusIcon.d.ts +1 -1
  453. package/ui/components/Table.d.ts +13 -13
  454. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  455. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  456. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  457. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  458. package/api/__tests__/migrate.test.d.ts +0 -1
  459. package/api/__tests__/migrate.test.js +0 -199
  460. package/commands/__tests__/account.test.d.ts +0 -1
  461. package/commands/__tests__/account.test.js +0 -69
  462. package/commands/__tests__/auth.test.d.ts +0 -1
  463. package/commands/__tests__/auth.test.js +0 -43
  464. package/commands/__tests__/cms.test.d.ts +0 -1
  465. package/commands/__tests__/cms.test.js +0 -87
  466. package/commands/__tests__/config.test.d.ts +0 -1
  467. package/commands/__tests__/config.test.js +0 -44
  468. package/commands/__tests__/customObject.test.d.ts +0 -1
  469. package/commands/__tests__/customObject.test.js +0 -68
  470. package/commands/__tests__/doctor.test.d.ts +0 -1
  471. package/commands/__tests__/doctor.test.js +0 -132
  472. package/commands/__tests__/feedback.test.d.ts +0 -1
  473. package/commands/__tests__/feedback.test.js +0 -24
  474. package/commands/__tests__/filemanager.test.d.ts +0 -1
  475. package/commands/__tests__/filemanager.test.js +0 -45
  476. package/commands/__tests__/getStarted.test.d.ts +0 -1
  477. package/commands/__tests__/getStarted.test.js +0 -173
  478. package/commands/__tests__/hubdb.test.d.ts +0 -1
  479. package/commands/__tests__/hubdb.test.js +0 -50
  480. package/commands/__tests__/init.test.d.ts +0 -1
  481. package/commands/__tests__/init.test.js +0 -42
  482. package/commands/__tests__/mcp.test.d.ts +0 -1
  483. package/commands/__tests__/mcp.test.js +0 -46
  484. package/commands/__tests__/open.test.d.ts +0 -1
  485. package/commands/__tests__/open.test.js +0 -58
  486. package/commands/__tests__/project.test.d.ts +0 -1
  487. package/commands/__tests__/project.test.js +0 -125
  488. package/commands/__tests__/sandbox.test.d.ts +0 -1
  489. package/commands/__tests__/sandbox.test.js +0 -44
  490. package/commands/__tests__/secret.test.d.ts +0 -1
  491. package/commands/__tests__/secret.test.js +0 -49
  492. package/commands/__tests__/testAccount.test.d.ts +0 -1
  493. package/commands/__tests__/testAccount.test.js +0 -57
  494. package/commands/__tests__/upgrade.test.d.ts +0 -1
  495. package/commands/__tests__/upgrade.test.js +0 -309
  496. package/commands/account/__tests__/auth.test.d.ts +0 -1
  497. package/commands/account/__tests__/auth.test.js +0 -206
  498. package/commands/account/__tests__/clean.test.d.ts +0 -1
  499. package/commands/account/__tests__/clean.test.js +0 -28
  500. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  501. package/commands/account/__tests__/createOverride.test.js +0 -32
  502. package/commands/account/__tests__/info.test.d.ts +0 -1
  503. package/commands/account/__tests__/info.test.js +0 -28
  504. package/commands/account/__tests__/list.test.d.ts +0 -1
  505. package/commands/account/__tests__/list.test.js +0 -153
  506. package/commands/account/__tests__/remove.test.d.ts +0 -1
  507. package/commands/account/__tests__/remove.test.js +0 -36
  508. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  509. package/commands/account/__tests__/removeOverride.js +0 -25
  510. package/commands/account/__tests__/rename.test.d.ts +0 -1
  511. package/commands/account/__tests__/rename.test.js +0 -82
  512. package/commands/account/__tests__/use.test.d.ts +0 -1
  513. package/commands/account/__tests__/use.test.js +0 -170
  514. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  515. package/commands/app/__tests__/migrate.test.js +0 -111
  516. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  517. package/commands/app/secret/__tests__/add.test.js +0 -140
  518. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  519. package/commands/app/secret/__tests__/delete.test.js +0 -28
  520. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  521. package/commands/app/secret/__tests__/list.test.js +0 -25
  522. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  523. package/commands/app/secret/__tests__/update.test.js +0 -28
  524. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  525. package/commands/cms/__tests__/delete.test.js +0 -39
  526. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  527. package/commands/cms/__tests__/fetch.test.js +0 -156
  528. package/commands/cms/__tests__/function.test.d.ts +0 -1
  529. package/commands/cms/__tests__/function.test.js +0 -50
  530. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  531. package/commands/cms/__tests__/lint.test.js +0 -33
  532. package/commands/cms/__tests__/list.test.d.ts +0 -1
  533. package/commands/cms/__tests__/list.test.js +0 -42
  534. package/commands/cms/__tests__/module.test.d.ts +0 -1
  535. package/commands/cms/__tests__/module.test.js +0 -45
  536. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  537. package/commands/cms/__tests__/mv.test.js +0 -46
  538. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  539. package/commands/cms/__tests__/theme.test.js +0 -54
  540. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  541. package/commands/cms/__tests__/upload.test.js +0 -312
  542. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  543. package/commands/cms/__tests__/watch.test.js +0 -204
  544. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  545. package/commands/cms/function/__tests__/logs.test.js +0 -70
  546. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  547. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  548. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  549. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  550. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  551. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  552. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  553. package/commands/customObject/__tests__/create.test.js +0 -40
  554. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  555. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  556. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  557. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  558. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  559. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  560. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  561. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  562. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  563. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  564. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  565. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  566. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  567. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  568. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  569. package/commands/filemanager/__tests__/upload.test.js +0 -191
  570. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  571. package/commands/hubdb/__tests__/clear.test.js +0 -28
  572. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  573. package/commands/hubdb/__tests__/create.test.js +0 -28
  574. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  575. package/commands/hubdb/__tests__/delete.test.js +0 -28
  576. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  577. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  578. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  579. package/commands/hubdb/__tests__/list.test.js +0 -88
  580. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  581. package/commands/mcp/__tests__/setup.test.js +0 -26
  582. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  583. package/commands/mcp/__tests__/start.test.js +0 -144
  584. package/commands/project/__tests__/add.test.d.ts +0 -1
  585. package/commands/project/__tests__/add.test.js +0 -107
  586. package/commands/project/__tests__/create.test.d.ts +0 -1
  587. package/commands/project/__tests__/create.test.js +0 -97
  588. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  589. package/commands/project/__tests__/deploy.test.js +0 -307
  590. package/commands/project/__tests__/dev.test.d.ts +0 -1
  591. package/commands/project/__tests__/dev.test.js +0 -273
  592. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  593. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  594. package/commands/project/__tests__/download.test.d.ts +0 -1
  595. package/commands/project/__tests__/download.test.js +0 -39
  596. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  597. package/commands/project/__tests__/installDeps.test.js +0 -140
  598. package/commands/project/__tests__/lint.test.d.ts +0 -1
  599. package/commands/project/__tests__/lint.test.js +0 -704
  600. package/commands/project/__tests__/list.test.d.ts +0 -1
  601. package/commands/project/__tests__/list.test.js +0 -31
  602. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  603. package/commands/project/__tests__/listBuilds.test.js +0 -38
  604. package/commands/project/__tests__/logs.test.d.ts +0 -1
  605. package/commands/project/__tests__/logs.test.js +0 -202
  606. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  607. package/commands/project/__tests__/migrate.test.js +0 -106
  608. package/commands/project/__tests__/open.test.d.ts +0 -1
  609. package/commands/project/__tests__/open.test.js +0 -39
  610. package/commands/project/__tests__/profile.test.d.ts +0 -1
  611. package/commands/project/__tests__/profile.test.js +0 -42
  612. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  613. package/commands/project/__tests__/updateDeps.test.js +0 -140
  614. package/commands/project/__tests__/upload.test.d.ts +0 -1
  615. package/commands/project/__tests__/upload.test.js +0 -234
  616. package/commands/project/__tests__/validate.test.d.ts +0 -1
  617. package/commands/project/__tests__/validate.test.js +0 -381
  618. package/commands/project/__tests__/watch.test.d.ts +0 -1
  619. package/commands/project/__tests__/watch.test.js +0 -35
  620. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  621. package/commands/project/dev/deprecatedFlow.js +0 -135
  622. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  623. package/commands/sandbox/__tests__/create.test.js +0 -198
  624. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  625. package/commands/sandbox/__tests__/delete.test.js +0 -31
  626. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  627. package/commands/secret/__tests__/addSecret.test.js +0 -162
  628. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  629. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  630. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  631. package/commands/secret/__tests__/listSecret.test.js +0 -29
  632. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  633. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  634. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  635. package/commands/testAccount/__tests__/create.test.js +0 -106
  636. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  637. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  638. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  639. package/commands/testAccount/__tests__/delete.test.js +0 -29
  640. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  641. package/commands/testAccount/__tests__/importData.test.js +0 -92
  642. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  643. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  644. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  645. package/lib/__tests__/accountAuth.test.js +0 -258
  646. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  647. package/lib/__tests__/accountTypes.test.js +0 -98
  648. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  649. package/lib/__tests__/buildAccount.test.js +0 -211
  650. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  651. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  652. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  653. package/lib/__tests__/commandSuggestion.test.js +0 -121
  654. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  655. package/lib/__tests__/commonOpts.test.js +0 -80
  656. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  657. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  658. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  659. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  660. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  661. package/lib/__tests__/hasFeature.test.js +0 -167
  662. package/lib/__tests__/http.test.d.ts +0 -1
  663. package/lib/__tests__/http.test.js +0 -40
  664. package/lib/__tests__/importData.test.d.ts +0 -1
  665. package/lib/__tests__/importData.test.js +0 -98
  666. package/lib/__tests__/npmCli.test.d.ts +0 -1
  667. package/lib/__tests__/npmCli.test.js +0 -84
  668. package/lib/__tests__/oauth.test.d.ts +0 -1
  669. package/lib/__tests__/oauth.test.js +0 -109
  670. package/lib/__tests__/parsing.test.d.ts +0 -1
  671. package/lib/__tests__/parsing.test.js +0 -34
  672. package/lib/__tests__/polling.test.d.ts +0 -1
  673. package/lib/__tests__/polling.test.js +0 -76
  674. package/lib/__tests__/process.test.d.ts +0 -1
  675. package/lib/__tests__/process.test.js +0 -89
  676. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  677. package/lib/__tests__/sandboxes.test.js +0 -128
  678. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  679. package/lib/__tests__/serverlessLogs.test.js +0 -163
  680. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  681. package/lib/__tests__/usageTracking.test.js +0 -197
  682. package/lib/__tests__/validation.test.d.ts +0 -1
  683. package/lib/__tests__/validation.test.js +0 -143
  684. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  685. package/lib/__tests__/yargsUtils.test.js +0 -124
  686. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  687. package/lib/app/__tests__/migrate.test.js +0 -638
  688. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  689. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  690. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  691. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  692. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  693. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  694. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  695. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  696. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  697. package/lib/mcp/__tests__/setup.test.js +0 -523
  698. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  699. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  700. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  701. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  702. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  703. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  704. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  705. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  706. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  707. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  708. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  709. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  710. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  711. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  712. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  713. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  714. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  715. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  716. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  717. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  718. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  719. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  720. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  721. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  722. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  723. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  724. package/lib/projects/__tests__/components.test.d.ts +0 -1
  725. package/lib/projects/__tests__/components.test.js +0 -440
  726. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  727. package/lib/projects/__tests__/deploy.test.js +0 -231
  728. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  729. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  730. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  731. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  732. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  733. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  734. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  735. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  736. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  737. package/lib/projects/__tests__/projects.test.js +0 -58
  738. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  739. package/lib/projects/__tests__/structure.test.js +0 -210
  740. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  741. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  742. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  743. package/lib/projects/__tests__/upload.test.js +0 -183
  744. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  745. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  746. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  747. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  748. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  749. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  750. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  751. package/lib/projects/create/__tests__/v2.test.js +0 -257
  752. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  753. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  754. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  755. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  756. package/lib/projects/platformVersion.d.ts +0 -9
  757. package/lib/projects/platformVersion.js +0 -39
  758. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  759. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  760. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  761. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  762. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  763. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  764. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  765. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  766. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  767. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  768. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  769. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  770. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  771. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  772. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  773. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  774. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  775. package/lib/theme/__tests__/migrate.test.js +0 -247
  776. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  777. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  778. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  779. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  780. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  781. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  782. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  783. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  784. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  785. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  786. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  787. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  788. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  789. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  790. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  791. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  792. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  793. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  794. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  795. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  796. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  797. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  798. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  799. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  800. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  801. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  802. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  803. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  804. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  805. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  806. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  807. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  808. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  809. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  810. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  811. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  812. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  813. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  814. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  815. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  816. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  817. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  818. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  819. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  820. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  821. package/mcp-server/utils/__tests__/command.test.js +0 -275
  822. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  823. package/mcp-server/utils/__tests__/content.test.js +0 -164
  824. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  825. 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,79 @@
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
+ - The user asks whether an API or feature is available on a subscription
22
+ tier (for example Starter, Professional, or Enterprise) — answer it via
23
+ \`search-docs\` then \`fetch-doc\`, not the knowledge base. The doc lists
24
+ any required product and tier in a "Supported products" section.
25
+
26
+ REQUIRED WORKFLOWS
27
+ 1. Authentication: call \`auth-account\` when the user wants to connect a
28
+ HubSpot account, when any tool reports "No account ID found", or when
29
+ there are no authenticated accounts. The tool opens a browser tab for
30
+ the user to authorize — no Personal Access Key is required up front.
31
+ 2. Documentation lookup: for developer APIs, SDKs, and platform reference,
32
+ call \`search-docs\` first, then \`fetch-doc\` on the most relevant
33
+ result(s). For HubSpot product, feature, or account and subscription
34
+ how-to questions, call \`search-knowledge-base\`. Whether a feature or
35
+ API is available on a subscription tier is a developer-docs question:
36
+ use \`search-docs\` then \`fetch-doc\`, not \`search-knowledge-base\`.
37
+ Answer from these tools before planning, writing code, or answering. Do
38
+ not answer from memory.
39
+ 3. Locating a HubSpot project: when the current working directory is not
40
+ a HubSpot project (no \`hsproject.json\`) or you need to determine
41
+ whether a directory contains one, call \`find-projects\` before
42
+ running any tool that requires a project path.
43
+ 4. Editing \`*-hsmeta.json\`: call \`get-feature-config-schema\` for that
44
+ feature type first to learn the allowed fields and values.
45
+ 5. Debugging a failed build: start with \`get-build-status\` to surface
46
+ error messages, and only reach for \`get-build-logs\` for deeper
47
+ troubleshooting or warnings.
48
+ 6. Reading serverless function logs: call \`list-cms-serverless-functions\`
49
+ first to discover the endpoint path, then
50
+ \`get-cms-serverless-function-logs\`.
51
+ 7. Serverless functions come in two distinct kinds. CMS serverless
52
+ functions are website endpoints served at \`/hs/serverless/<path>\`.
53
+ Create them with \`create-cms-function\`, and manage them with
54
+ \`list-cms-serverless-functions\` and
55
+ \`get-cms-serverless-function-logs\`. App functions are serverless
56
+ functions built inside a developer-platform app, either private
57
+ (the \`app-function\` feature) or publicly accessible via an endpoint
58
+ (the \`app-function-endpoint\` feature). Create them with
59
+ \`add-feature-to-project\`. Do not use the CMS function tools for app
60
+ functions.
61
+ 8. App analytics: call \`get-apps-info\` to discover \`appId\` values
62
+ before \`get-api-usage-patterns-by-app-id\`.
63
+
64
+ OUTPUT
65
+ Tool results contain the relevant \`hs\` stdout/stderr or structured data.
66
+ Surface error text from results to the user verbatim when troubleshooting,
67
+ rather than paraphrasing.
68
+ `.trim();
4
69
  const server = new McpServer({
5
70
  name: 'HubSpot CLI MCP Server',
6
71
  version: '0.0.1',
7
72
  description: 'Helps perform tasks for local development of HubSpot projects.',
8
- });
9
- registerProjectTools(server);
10
- registerCmsTools(server);
73
+ }, { capabilities: { logging: {} }, instructions });
74
+ const logger = new McpLogger(server);
75
+ registerProjectTools(server, logger);
76
+ registerCmsTools(server, logger);
11
77
  // Start receiving messages on stdin and sending messages on stdout
12
78
  const transport = new StdioServerTransport();
13
79
  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
  }