@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
package/lang/en.js CHANGED
@@ -1,12 +1,13 @@
1
1
  import chalk from 'chalk';
2
2
  import { mapToUserFriendlyName } from '@hubspot/project-parsing-lib/transform';
3
- import { PLATFORM_VERSIONS } from '@hubspot/local-dev-lib/constants/projects';
3
+ import { PLATFORM_VERSIONS } from '@hubspot/project-parsing-lib/constants';
4
4
  import { PERSONAL_ACCESS_KEY_AUTH_METHOD } from '@hubspot/local-dev-lib/constants/auth';
5
- import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, } from '@hubspot/local-dev-lib/constants/config';
6
- import { uiAccountDescription, uiBetaTag, uiCommandReference, uiLink, UI_COLORS, uiAuthCommandReference, } from '../lib/ui/index.js';
7
- import { getProjectDetailUrl, getProjectSettingsUrl, getLocalDevUiUrl, } from '../lib/projects/urls.js';
5
+ import { APP_AUTH_TYPES, APP_DISTRIBUTION_TYPES, CLI_SUPPORT_GUIDELINES_URL, LEGACY_PUBLIC_APP_FILE, LOCAL_DEV_DEFAULT_PORT, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, } from '../lib/constants.js';
6
+ import { ARCHIVED_HUBSPOT_CONFIG_YAML_FILE_NAME, DEFAULT_HUBSPOT_CONFIG_YAML_FILE_NAME, GLOBAL_CONFIG_PATH, } from '@hubspot/local-dev-lib/constants/config';
7
+ import { indent, UI_COLORS, uiAccountDescription, uiAuthCommandReference, uiBetaTag, uiCommandReference, uiDeprecatedTag, uiLink, } from '../lib/ui/index.js';
8
+ import { getLocalDevUiUrl, getProjectDetailUrl, getProjectSettingsUrl, } from '../lib/projects/urls.js';
8
9
  import { getProductUpdatesUrl } from '../lib/links.js';
9
- import { APP_DISTRIBUTION_TYPES, APP_AUTH_TYPES, PROJECT_CONFIG_FILE, PROJECT_WITH_APP, LEGACY_PUBLIC_APP_FILE, } from '../lib/constants.js';
10
+ const MIGRATION_SUPPORT_CUTOFF_NOTICE = 'Automated platform version migrations beyond 2026.09 will not be supported.';
10
11
  export const commands = {
11
12
  generalErrors: {
12
13
  srcIsProject: (src, command) => `"${src}" is in a project folder. Did you mean "hs project ${command}"?`,
@@ -123,6 +124,9 @@ export const commands = {
123
124
  options: {
124
125
  account: 'HubSpot account to authenticate',
125
126
  personalAccessKey: 'Enter existing personal access key',
127
+ default: 'Set the authenticated account as the default account',
128
+ name: 'Set a name for the account in the CLI config',
129
+ useDefaultName: 'Use the account name derived from the HubSpot portal name',
126
130
  },
127
131
  errors: {
128
132
  invalidAccountIdProvided: `--account must be a number.`,
@@ -137,8 +141,12 @@ export const commands = {
137
141
  },
138
142
  list: {
139
143
  accounts: `${chalk.bold('Accounts')}:`,
144
+ allAccounts: `${chalk.bold('All Accounts')}:`,
145
+ linkedAccounts: `${chalk.bold('Linked Accounts')}:`,
140
146
  defaultAccountTitle: `${chalk.bold('Default Account')}`,
147
+ linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
141
148
  currentResolvedDefaultAccount: (accountId) => `Account: ${uiAccountDescription(accountId)}`,
149
+ directory: (dir) => `Directory: ${dir}`,
142
150
  describe: 'List names of accounts defined in config.',
143
151
  configPath: (configPath) => `Source: ${configPath}`,
144
152
  overrideFilePathTitle: `${chalk.bold('Default Account Override')}`,
@@ -185,6 +193,70 @@ export const commands = {
185
193
  success: {
186
194
  defaultAccountUpdated: (accountName) => `Default account updated to "${accountName}"`,
187
195
  },
196
+ linked: {
197
+ editingLinkedDefault: (dir) => `Editing the default linked account for this directory (not the global default):\n${indent(1)}${dir}`,
198
+ alreadyDefault: (accountId) => `${uiAccountDescription(accountId)} is the only linked account and is already the default.`,
199
+ setLinkedDefault: (account) => `Linked default set to ${chalk.cyan(account)}`,
200
+ accountNotLinked: (account) => `${account} is not linked to this directory.`,
201
+ promptToLink: (account) => `Would you like to link ${account} to this directory?`,
202
+ settingGlobalDefault: 'Setting global default instead.',
203
+ nonInteractiveNotLinked: (account) => `${account} is not linked to this directory. Setting global default instead.`,
204
+ },
205
+ },
206
+ link: {
207
+ describe: 'Link authenticated HubSpot accounts to the current directory',
208
+ verboseDescribe: `Link one or more authenticated HubSpot accounts to the current directory. Linked accounts are saved in a local ${chalk.bold('.hs/settings.json')} file (added to .gitignore automatically).\n\nThis lets the CLI know which account to use when you run commands from this directory, without changing the global default. Run ${uiCommandReference('hs account current')} to see the active configuration.`,
209
+ shared: {
210
+ noLinkedAccounts: 'No HubSpot accounts are linked in this directory.',
211
+ globalAccountsAvailable: (count) => `You have ${chalk.cyan(count.toString())} ${count === 1 ? 'account' : 'accounts'} in your global config.`,
212
+ configurePrompt: `To configure this directory, run:\n${indent(1)}${uiCommandReference('hs account link')}`,
213
+ deprecatedConfigNotSupported: (command) => `${uiCommandReference(command)} does not support deprecated config. Run ${uiCommandReference('hs config migrate')} to migrate to global config. Then re-run ${uiCommandReference(command)}`,
214
+ writeSettingsFailed: (path, err) => `Failed to write to ${path}: ${err}`,
215
+ savedToSettings: (path) => `Saved to ${path}`,
216
+ usingLinkedAccounts: (settingsPath) => `This directory has linked accounts via ${settingsPath}. Only linked accounts will be available for this command. To manage linked accounts, run ${uiCommandReference('hs account link')}.`,
217
+ accountAutoLinked: (accountId) => `Automatically linked ${uiAccountDescription(accountId)} to this directory.`,
218
+ accountAutoLinkFailed: (accountId) => `Could not automatically link ${uiAccountDescription(accountId)} to this directory. Run ${uiCommandReference('hs account link')} to link it manually.`,
219
+ },
220
+ linkingDirectory: (dir) => `Linking HubSpot account(s) for directory:\n${indent(1)}${dir}`,
221
+ managingLinkedAccounts: (dir) => `Managing linked accounts for:\n${indent(1)}${dir}`,
222
+ settingsInfo: (path) => `\u2139 Accounts linked here are saved in ${path}`,
223
+ success: {
224
+ created: (path) => `Linked to ${path} (created .hs and added to .gitignore).\n${indent(1)}Now when you work within this directory, the CLI will use the linked account(s).`,
225
+ },
226
+ errors: {
227
+ authFailed: `Authentication failed to complete`,
228
+ },
229
+ events: {
230
+ accountsLinked: (count) => `Linked ${count} account${count !== 1 ? 's' : ''}`,
231
+ accountsUnlinked: (count) => `Unlinked ${count} account${count !== 1 ? 's' : ''}`,
232
+ overrideAccountDetected: (accountId) => `\nCurrent default account (from .hsaccount):\n${indent(1)}${uiAccountDescription(accountId)}`,
233
+ defaultAccountSet: (accountId) => `Linked default account set to ${chalk.cyan(uiAccountDescription(accountId))}`,
234
+ defaultAccountRemoved: (isSelectionRequired) => `The linked default account was removed. ${isSelectionRequired ? 'A linked default account is required.\n' : ''}`,
235
+ defaultAccountRemains: (accountId) => `Linked default account remains ${chalk.cyan(uiAccountDescription(accountId))}`,
236
+ updatedLinkedAccounts: 'Updated linked accounts',
237
+ noAccountsLinked: `All accounts have been unlinked. Your global config accounts will be used.\n${indent(1)}The ${chalk.bold('.hs')} directory is no longer needed and can be safely deleted.`,
238
+ overrideFileRemoved: '.hsaccount file removed',
239
+ invalidDefaultAccount: (accountId) => `Default account ${uiAccountDescription(accountId)} is not in the linked accounts list and has been reset. Please select a new default.`,
240
+ },
241
+ prompts: {
242
+ howToProceed: 'How would you like to link an account?',
243
+ whatToDo: 'Which action would you like to perform?',
244
+ linkExisting: 'Link existing authenticated account(s)',
245
+ authenticateNew: 'Authenticate and link a new account',
246
+ cancel: 'Cancel',
247
+ selectDefault: 'Select a linked default account',
248
+ selectToLink: 'Select authenticated account(s) to link:',
249
+ selectToUnlink: 'Select account(s) to unlink',
250
+ alreadyLinked: '- Already linked',
251
+ fromHsAccount: '(from .hsaccount)',
252
+ newlyAuthenticated: '(just authenticated)',
253
+ mustSelectOne: 'You must select at least one account to link',
254
+ keepAsDefault: 'Keep this as the default?',
255
+ },
256
+ },
257
+ unlink: {
258
+ describe: 'Unlink HubSpot account(s) from the current directory',
259
+ verboseDescribe: `Remove one or more linked accounts from this directory's ${chalk.bold('.hs/settings.json')}. If the default account is removed, you will be prompted to select a new one.\n\nThis does not delete the account from the global config - it only removes the local association.`,
188
260
  },
189
261
  remove: {
190
262
  describe: 'Remove an account from the config.',
@@ -253,6 +325,9 @@ export const commands = {
253
325
  },
254
326
  name: (name) => `${chalk.bold('Account name')}: ${name}`,
255
327
  scopeGroups: `${chalk.bold('Scopes available')}:`,
328
+ linkedDefaultTitle: `${chalk.bold('Linked Default Account')}`,
329
+ settingsPath: (path) => `Source: ${path}`,
330
+ linkedDefault: (account) => `Account: ${account}`,
256
331
  },
257
332
  clean: {
258
333
  describe: 'Check for inactive accounts and removes them from the CLI config.',
@@ -1251,22 +1326,34 @@ export const commands = {
1251
1326
  },
1252
1327
  mcp: {
1253
1328
  describe: 'Commands for managing HubSpot MCP servers.',
1329
+ promotion: {
1330
+ activeNudge: `${chalk.bold('Tip:')} Work faster with AI coding tools. Run ${uiCommandReference('hs mcp setup')} to connect HubSpot developer context to supported clients.`,
1331
+ },
1254
1332
  setup: {
1255
- describe: 'Setup the HubSpot development MCP servers.',
1333
+ describe: `Run ${uiCommandReference('hs mcp setup')} to connect the HubSpot Dev MCP and work faster with your AI coding tools.`,
1256
1334
  installingDocSearch: 'Adding the docs-search mcp server',
1257
1335
  codex: 'Codex CLI',
1258
1336
  claudeCode: 'Claude Code',
1259
1337
  cursor: 'Cursor',
1338
+ devin: 'Devin',
1260
1339
  gemini: 'Gemini CLI',
1261
- windsurf: 'Windsurf',
1340
+ opencode: 'OpenCode',
1262
1341
  vsCode: 'VSCode',
1342
+ other: 'Other (manual setup)',
1263
1343
  args: {
1264
1344
  client: 'Target apps to configure',
1345
+ standalone: 'Use npx for all of the hs commands run by the MCP server. This allows you to use the MCP server without having the CLI globally installed.',
1346
+ cliVersion: 'Pin a specific CLI version for standalone mode',
1265
1347
  docsSearch: 'Should the docs search mcp server be installed',
1266
1348
  },
1349
+ examples: {
1350
+ nonInteractive: 'Configure Claude Code without prompts',
1351
+ standalone: 'Configure Cursor in standalone mode with a pinned CLI version',
1352
+ },
1267
1353
  success: (derivedTargets) => `You can now use the HubSpot CLI MCP Server in ${derivedTargets.join(', ')}. ${chalk.bold('You may need to restart these tools to apply the changes')}.`,
1268
1354
  errors: {
1269
1355
  errorParsingJsonFIle: (filename, errorMessage) => `Unable to update ${chalk.bold(filename)} due to invalid JSON: ${errorMessage}`,
1356
+ cliVersionRequiresStandalone: '`--cli-version` requires `--standalone`. Pass `--standalone` to use a specific CLI version.',
1270
1357
  },
1271
1358
  spinners: {
1272
1359
  failedToConfigure: 'Failed to configure the HubSpot mcp server.',
@@ -1291,16 +1378,28 @@ export const commands = {
1291
1378
  geminiNotFound: "Gemini CLI is not installed (missing 'gemini' command). Install it and re-run hs mcp setup.",
1292
1379
  geminiInstallFailed: 'Failed to configure Gemini CLI',
1293
1380
  alreadyInstalled: 'HubSpot CLI mcp server already installed, reinstalling',
1294
- // Windsurf
1295
- configuringWindsurf: 'Configuring Windsurf...',
1296
- windsurfNotFound: 'Windsurf is not installed. Install it and re-run hs mcp setup.',
1297
- failedToConfigureWindsurf: 'Failed to configure Windsurf',
1298
- configuredWindsurf: 'Configured Windsurf',
1381
+ // Devin
1382
+ configuringDevin: 'Configuring Devin...',
1383
+ devinNotFound: 'Devin is not installed. Install it and re-run hs mcp setup.',
1384
+ failedToConfigureDevin: 'Failed to configure Devin',
1385
+ configuredDevin: 'Configured Devin',
1386
+ // OpenCode
1387
+ configuringOpenCode: 'Configuring OpenCode...',
1388
+ openCodeNotFound: "OpenCode is not installed (missing 'opencode' command). Install it and re-run hs mcp setup.",
1389
+ openCodeInstallFailed: 'Failed to configure OpenCode',
1390
+ configuredOpenCode: 'Configured OpenCode',
1299
1391
  // VS Code
1300
1392
  configuringVsCode: 'Configuring VSCode...',
1301
1393
  failedToConfigureVsCode: 'Failed to configure VSCode',
1302
1394
  configuredVsCode: 'Configured VSCode',
1303
1395
  vsCodeNotFound: "VSCode CLI is not installed (missing 'code' command). Install it and re-run hs mcp setup.",
1396
+ vsCodeVersionUnsupported: 'VSCode 1.99 or later is required for MCP server support. Please update VSCode and try again.',
1397
+ },
1398
+ otherInstructions: {
1399
+ header: 'To connect the HubSpot MCP server to another tool, add the following MCP server configuration.',
1400
+ docsNote: "Each tool handles MCP setup differently. Check your tool's documentation for how to add an MCP server using a command or JSON config.",
1401
+ commandLabel: 'Command:',
1402
+ jsonLabel: 'JSON configuration (for tools that use a config file):',
1304
1403
  },
1305
1404
  prompts: {
1306
1405
  targets: '[--client] Which tools would you like to add the HubSpot CLI MCP server to?',
@@ -1320,6 +1419,30 @@ export const commands = {
1320
1419
  shuttingDown: 'Shutting down MCP server...',
1321
1420
  },
1322
1421
  },
1422
+ api: {
1423
+ describe: 'Make an authenticated HTTP request to any HubSpot API endpoint that supports PAKs.',
1424
+ verboseDescribe: `Make an authenticated HTTP request to any HubSpot API that supports PAKs using your CLI authentication.\n\nThis command is intended for testing and exploration of HubSpot APIs. It uses the authentication credentials configured in the CLI to make requests on your behalf.\n\nThe endpoint should be the API path, e.g. ${chalk.bold('/crm/v3/objects/contacts')}. The request will be authenticated using the account specified by ${uiCommandReference('--account')} or the default account.\n\nNote: The available endpoints depend on the scopes granted to your personal access key. If you receive a 403 error, check that your key includes the required scopes for the endpoint you are trying to reach. ${uiLink('Learn more about the HubSpot API', 'https://developers.hubspot.com/docs/api-reference/latest/overview')}`,
1425
+ positionals: {
1426
+ endpoint: {
1427
+ describe: 'API endpoint path (e.g. /crm/v3/objects/contacts)',
1428
+ },
1429
+ },
1430
+ options: {
1431
+ method: {
1432
+ describe: 'HTTP method to use. Defaults to GET, or POST if --data is provided',
1433
+ },
1434
+ data: {
1435
+ describe: 'JSON-formatted request body for POST, PUT, and PATCH requests',
1436
+ },
1437
+ },
1438
+ requestLog: (method, url) => `${chalk.bold(method)} ${url}`,
1439
+ requestBodyLog: (body) => `Request body: ${body}`,
1440
+ responseLog: 'Response:',
1441
+ errors: {
1442
+ invalidJson: 'The value passed to --data is not valid JSON. Please provide a valid JSON string.',
1443
+ statusLine: (status, statusText) => `${chalk.red(`${status} ${statusText}`)}`,
1444
+ },
1445
+ },
1323
1446
  open: {
1324
1447
  describe: 'Open a HubSpot page in your browser.',
1325
1448
  options: {
@@ -1343,6 +1466,7 @@ export const commands = {
1343
1466
  describe: 'Add a new project profile',
1344
1467
  verboseDescribe: `Add a new project profile\n\nProfiles enable you to reference variables in your component configuration files. Use the syntax ${chalk.bold('\${VARIABLE_NAME}')} to reference profile variables in your component configuration files. Then target the profile using the ${uiCommandReference('--profile')} flag when you upload your project.`,
1345
1468
  example: 'Add a new project profile named hsprofile.qa.json',
1469
+ exampleCopyFrom: 'Add a profile and copy variables from the staging profile',
1346
1470
  logs: {
1347
1471
  copyExistingProfile: (profileName) => `Found an existing profile. We can copy the variables from ${chalk.bold(profileName)} into your new profile.`,
1348
1472
  copyExistingProfiles: 'We can copy the variables from one of your existing profiles into your new profile.',
@@ -1360,11 +1484,12 @@ export const commands = {
1360
1484
  duplicateTargetAccount: (targetAccountId) => `The account ${uiAccountDescription(targetAccountId)} is being used in an existing profile. Make sure to edit your project's name between uploads if you do not want to overwrite the existing project in this account.`,
1361
1485
  },
1362
1486
  errors: {
1363
- noProjectConfig: 'No project config found. Please run this command from a project directory.',
1487
+ unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
1364
1488
  profileExists: (profileName) => `Profile ${chalk.bold(profileName)} already exists. Please choose a different name.`,
1365
1489
  invalidTargetAccount: 'Target account is not configured in the CLI',
1366
1490
  noAccountsConfigured: 'No accounts configured in the CLI',
1367
1491
  failedToLoadProfile: (profileName) => `Unable to copy variables. Failed to load profile ${chalk.bold(profileName)}`,
1492
+ copyFromProfileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} does not exist. Available profiles can be found in your project source directory.`,
1368
1493
  failedToCreateProfile: 'Failed to create profile',
1369
1494
  },
1370
1495
  positionals: {
@@ -1372,6 +1497,7 @@ export const commands = {
1372
1497
  },
1373
1498
  options: {
1374
1499
  targetAccount: 'The target account ID for this profile',
1500
+ copyFrom: 'Copy variables from an existing profile',
1375
1501
  },
1376
1502
  },
1377
1503
  delete: {
@@ -1390,7 +1516,7 @@ export const commands = {
1390
1516
  deleteProjectPrompt: (accountId) => `Would you like to delete this project from ${uiAccountDescription(accountId)}?`,
1391
1517
  },
1392
1518
  errors: {
1393
- noProjectConfig: 'No project config found. Please run this command from a project directory.',
1519
+ unsupportedPlatformVersion: 'This command is only available for projects 2025.2 and later.',
1394
1520
  noProfileFound: (profileName) => `No profile with filename ${chalk.bold(profileName)} found in your project.`,
1395
1521
  noProfilesFound: 'No profiles found in your project.',
1396
1522
  failedToDeleteProfile: (profileName) => `Unable to delete profile ${chalk.bold(profileName)}. Please try again.`,
@@ -1405,27 +1531,20 @@ export const commands = {
1405
1531
  describe: 'Start local dev for the current project.',
1406
1532
  logs: {
1407
1533
  header: 'HubSpot projects local development',
1408
- placeholderAccountSelection: 'Using default account as target account (for now)',
1409
- accountTypeInformation: 'Testing in a developer test account is strongly recommended, but you can use a sandbox account if your plan allows you to create one.',
1410
1534
  learnMoreMessageV2: `Learn more about ${uiLink('HubSpot projects local dev', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server')} | ${uiLink('HubSpot account types', 'https://developers.hubspot.com/docs/getting-started/account-types')}`,
1411
- learnMoreMessageLegacy: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands#start-a-local-development-server'),
1412
1535
  profileProjectAccountExplanation: (accountId, profileName) => `Using account ${uiAccountDescription(accountId)} from profile ${chalk.bold(profileName)} for project upload`,
1413
1536
  defaultProjectAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for project upload`,
1414
1537
  projectAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --project-account flag for project upload`,
1415
- accountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --account flag for project upload`,
1416
1538
  defaultSandboxOrDevTestTestingAccountExplanation: (accountId) => `Using default account ${uiAccountDescription(accountId)} for testing`,
1417
1539
  testingAccountFlagExplanation: (accountId) => `Using account ${uiAccountDescription(accountId)} provided by the --testing-account flag for testing`,
1418
1540
  },
1419
1541
  errors: {
1420
- noProjectConfig: 'No project detected. Please run this command again from a project directory.',
1421
1542
  noAccount: (accountId) => `An error occurred while reading account ${uiAccountDescription(accountId)} from your config. Run ${uiAuthCommandReference()} to re-auth this account.`,
1422
- noAccountsInConfig: `No accounts found in your config. Run ${uiAuthCommandReference()} to configure a HubSpot account with the CLI.`,
1423
- invalidProjectComponents: 'Projects cannot contain both private and public apps. Move your apps to separate projects before attempting local development.',
1543
+ unsupportedPlatformVersion: (platformVersion) => `Local development is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
1424
1544
  noRunnableComponents: `No supported components were found in this project. Run ${uiCommandReference('hs project add')} to see a list of available components and add one to your project.`,
1425
1545
  accountNotCombined: `\nLocal development of unified apps is currently only compatible with accounts that are opted into the unified apps beta. Make sure that this account is opted in or switch accounts using ${uiCommandReference('hs account use')}.`,
1426
- unsupportedAccountFlagLegacy: 'The --project-account and --testing-account flags are not supported for projects with platform versions earlier than 2025.2.',
1427
- unsupportedAccountFlagV2: 'The --account flag is is not supported supported for projects with platform versions 2025.2 and newer. Use --testing-account and --project-account flags to specify accounts to use for local dev',
1428
1546
  localDevAlreadyRunning: `Another ${uiCommandReference('hs project dev')} process is already running. To proceed with local development of this project, stop the existing process and re-run ${uiCommandReference('hs project dev')}.`,
1547
+ autoUploadRequiresAutoDeploy: `${uiCommandReference('hs project dev --auto-upload')} requires auto-deploy to be enabled for this project, since auto-upload deploys every change. Enable auto-deploy in your project settings, or run ${uiCommandReference('hs project dev')} without it.`,
1429
1548
  },
1430
1549
  examples: {
1431
1550
  default: 'Start local dev for the current project',
@@ -1435,9 +1554,10 @@ export const commands = {
1435
1554
  },
1436
1555
  options: {
1437
1556
  profile: 'The profile to target during local dev',
1438
- projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account. Supported on platform versions 2025.2 and newer.',
1439
- testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account. Supported on platform versions 2025.2 and newer.',
1440
- account: 'The id of the account to upload your project to. Unsupported on platform versions 2025.2 and newer.',
1557
+ projectAccount: 'The id of the account to upload your project to. Must be used with --testing-account.',
1558
+ testingAccount: 'The id of the account to install apps and test on. Must be used with --project-account.',
1559
+ port: `The port for the local dev server. Defaults to ${LOCAL_DEV_DEFAULT_PORT}.`,
1560
+ autoUpload: 'Automatically upload local changes to HubSpot as you edit files, instead of uploading manually from the Local Dev Panel.',
1441
1561
  },
1442
1562
  },
1443
1563
  create: {
@@ -1448,6 +1568,9 @@ export const commands = {
1448
1568
  failedToFetchProjectList: 'Failed to fetch the list of available project templates. Please try again later.',
1449
1569
  cannotNestProjects: (projectDir) => `A project already exists at ${projectDir}. Projects cannot be nested within other projects. Please choose a different destination and try again.`,
1450
1570
  },
1571
+ warnings: {
1572
+ betaPlatformVersion: (platformVersion) => `Your portal must be enrolled in the beta to use platform version ${platformVersion}. If you are not enrolled in the beta, your upload will fail. ${uiLink('Enroll in the beta', getProductUpdatesUrl('286886'))}`,
1573
+ },
1451
1574
  logs: {
1452
1575
  success: (projectName, projectDest) => `Project ${chalk.bold(projectName)} was successfully created in ${projectDest}`,
1453
1576
  },
@@ -1494,7 +1617,8 @@ export const commands = {
1494
1617
  },
1495
1618
  },
1496
1619
  migrateApp: {
1497
- describe: 'Migrate a public app to the projects framework.',
1620
+ describe: uiDeprecatedTag(`Migrate a public app to the projects framework. ${MIGRATION_SUPPORT_CUTOFF_NOTICE}`, false),
1621
+ verboseDescribe: uiDeprecatedTag(`Migrate a public app to the projects framework. This command walks you through the fields required to complete the migration and downloads the project source code into a directory of your choosing.\n\n${chalk.bold.yellow(MIGRATION_SUPPORT_CUTOFF_NOTICE)}`, false),
1498
1622
  examples: {
1499
1623
  default: 'Migrate a public app to the projects framework',
1500
1624
  },
@@ -1538,10 +1662,10 @@ export const commands = {
1538
1662
  },
1539
1663
  migrate: {
1540
1664
  preamble: (platformVersion) => `This command will migrate an existing project to platformVersion ${platformVersion}. It will walk you through the fields required to complete the migration and download the new project source code into the project source directory. It will also copy all of your existing files to a new directory (archive) in case you need access to your old files later.`,
1541
- describe: 'Migrate an existing project to the new version of the projects framework.',
1665
+ describe: uiDeprecatedTag(`Migrate an existing project to the new version of the projects framework. ${MIGRATION_SUPPORT_CUTOFF_NOTICE}`, false),
1666
+ verboseDescribe: uiDeprecatedTag(`Migrate an existing project to a newer platform version. This command walks you through the fields required to complete the migration and downloads the new project source code into the project source directory. Your existing files are copied to a new directory (archive) in case you need access to them later.\n\n${chalk.bold.yellow(MIGRATION_SUPPORT_CUTOFF_NOTICE)}`, false),
1542
1667
  errors: {
1543
1668
  noProjectConfig: (command) => `No project detected. Please run this command again from a project directory. If you are trying to migrate an app, run ${command}`,
1544
- noThemeMigrationAccess: (accountId) => `This project contains a CMS theme. You must opt in to theme migration beta to continue updating it on ${uiAccountDescription(accountId)}. Try again with a different account or ${uiLink('join the beta now', getProductUpdatesUrl('253920', accountId))}`,
1545
1669
  },
1546
1670
  examples: {
1547
1671
  default: 'Migrate an existing project to the new version of the projects framework.',
@@ -1614,13 +1738,16 @@ export const commands = {
1614
1738
  deploy: {
1615
1739
  describe: 'Deploy a project build.',
1616
1740
  deployBuildIdPrompt: '[--build] Deploy which build?',
1741
+ profileMessage: (profileName, accountId) => `Deploying with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
1617
1742
  debug: {
1618
1743
  deploying: (path) => `Deploying project at path: ${path}`,
1619
1744
  },
1620
1745
  errors: {
1621
1746
  deploy: 'Deploy error: an unknown error occurred.',
1622
1747
  noBuilds: 'Deploy error: no builds for this project were found.',
1748
+ noSuccessfulBuilds: 'Deploy error: no successful builds for this project were found.',
1623
1749
  noBuildId: 'You must specify a build to deploy',
1750
+ notSupportedForBuildVersion: `This build's platform version does not support deploy. Run ${uiCommandReference('hs project release create')} to create a release instead.`,
1624
1751
  projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
1625
1752
  buildIdDoesNotExist: (accountId, buildId, projectName) => `Build ${buildId} does not exist for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds for this project.`,
1626
1753
  buildAlreadyDeployed: (accountId, buildId, projectName) => `Build ${buildId} is already deployed. ${uiLink('View project builds in HubSpot', getProjectDetailUrl(projectName, accountId))}`,
@@ -1631,7 +1758,7 @@ export const commands = {
1631
1758
  deployIssueComponentWarning: (uid, componentTypeName, message) => `- [${mapToUserFriendlyName(componentTypeName)}] ${chalk.bold('(' + uid + ')')} ${message}`,
1632
1759
  },
1633
1760
  examples: {
1634
- default: 'Deploy the latest build of the current project',
1761
+ default: 'Deploy the last successful build of the current project',
1635
1762
  withOptions: 'Deploy build 5 of the project my-project',
1636
1763
  withProfile: 'Deploy using the provided profile',
1637
1764
  },
@@ -1640,7 +1767,96 @@ export const commands = {
1640
1767
  project: 'Project name',
1641
1768
  profile: 'The profile to target with this deploy',
1642
1769
  force: 'Skip warnings and force deploy. Use this carefully as it will bypass warnings for destructive actions.',
1643
- deployLatestBuild: 'Deploy the latest build of the current project',
1770
+ deployLatestBuild: 'Deploy the last successful build of the current project',
1771
+ },
1772
+ },
1773
+ release: {
1774
+ describe: 'Manage project releases.',
1775
+ create: {
1776
+ describe: 'Create a release for a project build.',
1777
+ verboseDescribe: `Create a release for a project build\n\nReleases mark an uploaded build with an auto-generated semantic version tag (e.g. v1.0.0).\n\nBy default, the latest build is used. Use ${uiCommandReference('--build')} to specify a different build ID.`,
1778
+ confirmPrompt: (projectName, buildId) => `Create a release for project ${chalk.bold(projectName)} using build ${chalk.bold(String(buildId))}?`,
1779
+ success: (releaseTag, buildId) => `Release ${chalk.bold(releaseTag)} created for build ${chalk.bold(String(buildId))}.`,
1780
+ successNoTag: (buildId) => `Released build ${chalk.bold(String(buildId))}. Your project is now live.`,
1781
+ cancelled: 'Release creation cancelled.',
1782
+ buildIdPrompt: '[--build] Select a successful build to release:',
1783
+ noUploadMessage: 'No upload message',
1784
+ buildStatus: {
1785
+ BUILDING: 'Build in progress',
1786
+ FAILURE: 'Build failed',
1787
+ PENDING: 'Pending',
1788
+ PREPARING: 'Preparing',
1789
+ },
1790
+ uploadPrompt: (projectName) => `No successful builds for project ${chalk.bold(projectName)}. Would you like to upload it?`,
1791
+ errors: {
1792
+ projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
1793
+ buildNotFound: (buildId, projectName) => `Build ${chalk.bold(String(buildId))} was not found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project list-builds')} to view existing builds or ${uiCommandReference('hs project upload')} to upload a build first.`,
1794
+ noSuccessfulBuilds: (projectName) => `No successful builds found for project ${chalk.bold(projectName)}. Run ${uiCommandReference('hs project upload')} to create a new build.`,
1795
+ incompatibleBuildVersion: `This build's platform version does not support releases. Upgrade your project to a newer platform version to use releases.`,
1796
+ },
1797
+ options: {
1798
+ build: 'Build ID to release. Defaults to the latest build.',
1799
+ force: 'Skip all confirmation prompts, including automatic upload when no build exists.',
1800
+ },
1801
+ examples: {
1802
+ default: 'Create a release for the latest build',
1803
+ withBuild: 'Create a release for a specific build',
1804
+ },
1805
+ },
1806
+ list: {
1807
+ describe: 'List releases for the current project.',
1808
+ verboseDescribe: `List releases for the current project\n\nDisplays all releases in sorted order, newest first. Includes the version tag, build ID, and creation date. Use ${uiCommandReference('--limit')} to control how many results are shown.`,
1809
+ noReleases: 'No releases found for this project.',
1810
+ showingReleases: (count, projectName) => `Showing ${count} release${count === 1 ? '' : 's'} for ${chalk.bold(projectName)}:`,
1811
+ continueOrExitPrompt: 'Press <enter> to load more, or ctrl+c to exit',
1812
+ errors: {
1813
+ projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in account ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
1814
+ },
1815
+ options: {
1816
+ limit: 'Number of releases to show',
1817
+ },
1818
+ examples: {
1819
+ default: 'List releases for the current project',
1820
+ withLimit: 'Show only the 5 most recent releases',
1821
+ },
1822
+ },
1823
+ info: {
1824
+ describe: 'Show details about a specific release.',
1825
+ verboseDescribe: `Show details about a specific release\n\nDisplays the release tag, build ID, creation date, and list of components included in the release. Use ${uiCommandReference('--json')} for machine-readable output.`,
1826
+ releaseDetails: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} for ${chalk.bold(projectName)}:`,
1827
+ components: 'Components:',
1828
+ noComponents: 'No components found for this release.',
1829
+ moreReleasesHint: `Not all releases are shown. Use ${uiCommandReference('--tag')} to look up an older release directly.`,
1830
+ selectRelease: (projectName) => `Select a release for ${chalk.bold(projectName)}`,
1831
+ errors: {
1832
+ releaseNotFound: (releaseTag, projectName) => `Release ${chalk.bold(releaseTag)} was not found for project ${chalk.bold(projectName)}. Verify the project has been uploaded and the release tag exists. Run ${uiCommandReference('hs project release list')} to view existing releases.`,
1833
+ noReleases: 'No releases found for this project.',
1834
+ },
1835
+ options: {
1836
+ tag: 'Release tag to look up (e.g. v1.0.0)',
1837
+ },
1838
+ examples: {
1839
+ default: 'Show details about a specific release',
1840
+ json: 'Output release details as JSON',
1841
+ },
1842
+ },
1843
+ preview: {
1844
+ describe: 'Build and preview a project on a target portal.',
1845
+ verboseDescribe: `Build and preview a project on a target portal\n\nUploads the current project (unless ${uiCommandReference('--build')} is passed), then deploys that build to the target portal so you can try it before releasing it. Use ${uiCommandReference('--target')} to choose the portal.`,
1846
+ uploadPrompt: (projectName) => `No successful builds for project ${chalk.bold(projectName)}. Would you like to upload it?`,
1847
+ errors: {
1848
+ targetRequired: `${uiCommandReference('--target=<portalId>')} is required to specify the portal to preview on.`,
1849
+ previewFailed: 'The preview failed. You can try again or preview this build from the project UI.',
1850
+ },
1851
+ options: {
1852
+ build: 'Build ID to preview. Defaults to the latest build.',
1853
+ target: 'Portal ID to preview the build on.',
1854
+ force: 'Skip all confirmation prompts, including automatic upload when no build exists.',
1855
+ },
1856
+ examples: {
1857
+ default: 'Build and preview the current project on a target portal',
1858
+ withBuild: 'Preview a specific build on a target portal',
1859
+ },
1644
1860
  },
1645
1861
  },
1646
1862
  listBuilds: {
@@ -1663,6 +1879,8 @@ export const commands = {
1663
1879
  },
1664
1880
  examples: {
1665
1881
  default: 'List the builds for the current project',
1882
+ withLimit: 'List the five most recent builds for the current project',
1883
+ json: 'Output the builds for the current project as JSON',
1666
1884
  },
1667
1885
  },
1668
1886
  logs: {
@@ -1673,6 +1891,7 @@ export const commands = {
1673
1891
  noFunctionsLinkText: 'Visit developer docs',
1674
1892
  noFunctionsInProject: `There aren't any functions in this project\n\t- Run ${uiCommandReference('hs project logs --help')} to learn more about logs\n\t- ${uiLink('Visit developer docs', 'https://developers.hubspot.com/docs/platform/serverless-functions')} to learn more about serverless functions`,
1675
1893
  noFunctionWithName: (name) => `No function with name "${name}"`,
1894
+ functionNameRequired: `A function name is required. Pass ${uiCommandReference('--function=<name>')} or run without it to select one interactively.`,
1676
1895
  functionNotDeployed: (name) => `The function with name "${name}" is not deployed`,
1677
1896
  projectLogsManagerNotInitialized: 'Function called on ProjectLogsManager before initialization',
1678
1897
  noDeployedBuild: 'This project has not been deployed yet. Deploy the project first, then try again.',
@@ -1718,19 +1937,31 @@ export const commands = {
1718
1937
  examples: {
1719
1938
  default: 'Upload a project into your HubSpot account',
1720
1939
  withProfile: 'Upload a project into your HubSpot account when using profiles',
1940
+ withPreview: 'Upload and preview the build on a target portal',
1721
1941
  },
1722
1942
  logs: {
1943
+ forceCreateDeprecated: `The ${uiCommandReference('--force-create')} flag is deprecated. Use ${uiCommandReference('--force')} instead.`,
1723
1944
  buildSucceeded: (buildId) => `Build #${buildId} succeeded\n`,
1724
1945
  readyToGoLive: '🚀 Ready to take your project live?',
1725
1946
  runCommand: (command) => `Run \`${uiCommandReference(command)}\``,
1726
1947
  autoDeployDisabled: (deployCommand) => `Automatic deploys are disabled for this project. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
1948
+ autoDeploySkipped: (deployCommand) => `Auto-deploy was skipped for this build. Run ${uiCommandReference(deployCommand)} to deploy this build.`,
1949
+ releaseManagementRequired: (releaseCommand) => `This build is not live yet. Run ${uiCommandReference(releaseCommand)} to make it live.`,
1950
+ uploadingWithProfile: (profileName, accountId) => `Initializing project upload with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
1951
+ uploadingToAccount: (accountId) => `Initializing project upload to account ${uiAccountDescription(accountId)}`,
1952
+ uploadedToAccount: (accountId) => `Project uploaded to ${uiAccountDescription(accountId)}`,
1727
1953
  },
1728
1954
  errors: {
1729
1955
  projectLockedError: `Your project is locked. This may mean that another user is running the ${uiCommandReference('hs project dev')} command for this project. If this is you, unlock the project in Projects UI.`,
1956
+ previewRequiresTarget: `${uiCommandReference('--preview')} requires ${uiCommandReference('--target=<portalId>')} to specify the portal to preview on.`,
1957
+ targetRequiresPreview: `${uiCommandReference('--target')} can only be used with ${uiCommandReference('--preview')}.`,
1730
1958
  },
1731
1959
  options: {
1960
+ force: {
1961
+ describe: 'Skip confirmation prompts and force the upload.',
1962
+ },
1732
1963
  forceCreate: {
1733
- describe: 'Automatically create project if it does not exist',
1964
+ describe: uiDeprecatedTag(`Automatically create project if it does not exist. Use ${uiCommandReference('--force')} instead.`, false),
1734
1965
  },
1735
1966
  message: {
1736
1967
  describe: 'Add a message when you upload your project and create a build',
@@ -1738,6 +1969,18 @@ export const commands = {
1738
1969
  profile: {
1739
1970
  describe: 'Profile to target for this upload',
1740
1971
  },
1972
+ skipNpmAudit: {
1973
+ describe: 'Skip the npm audit security check before uploading',
1974
+ },
1975
+ skipAutoDeploy: {
1976
+ describe: 'Skip automatic deployment after a successful build',
1977
+ },
1978
+ preview: {
1979
+ describe: 'Preview the build on a target portal after a successful upload',
1980
+ },
1981
+ target: {
1982
+ describe: 'Portal ID to preview the build on',
1983
+ },
1741
1984
  },
1742
1985
  },
1743
1986
  watch: {
@@ -1770,7 +2013,6 @@ export const commands = {
1770
2013
  fileAlreadyQueued: (filePath) => `File "${filePath}" is already queued for upload`,
1771
2014
  },
1772
2015
  errors: {
1773
- projectConfigNotFound: 'No project config found. Please ensure that you are in a project directory.',
1774
2016
  projectLockedError: `Your project is locked. This may mean that another user is running the ${chalk.bold(`hs project dev`)} command for this project. If this is you, unlock the project in Projects UI.`,
1775
2017
  uploadFailed: (remotePath, filePath) => `Failed to upload file "${filePath}" to "${remotePath}"`,
1776
2018
  deleteFileFailed: (remotePath) => `Failed to delete file "${remotePath}"`,
@@ -1782,6 +2024,7 @@ export const commands = {
1782
2024
  describe: 'Download your project files from HubSpot.',
1783
2025
  examples: {
1784
2026
  default: 'Download the project myProject into myProjectFolder folder',
2027
+ json: 'Output the download result as JSON for scripting',
1785
2028
  },
1786
2029
  logs: {
1787
2030
  downloadCancelled: 'Cancelling project download',
@@ -1837,7 +2080,6 @@ export const commands = {
1837
2080
  installationSuccessful: (directory) => `Installed dependencies in ${directory}`,
1838
2081
  addingDependenciesToLocation: (dependencies, directory) => `Installing ${dependencies} in ${directory}`,
1839
2082
  installingDependenciesFailed: (directory) => `Installing dependencies for ${directory} failed`,
1840
- noProjectConfig: 'No project detected. Run this command from a project directory.',
1841
2083
  noPackageJsonInProject: (projectName) => `No dependencies to install. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
1842
2084
  packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
1843
2085
  },
@@ -1852,15 +2094,16 @@ export const commands = {
1852
2094
  loading: {
1853
2095
  checking: 'Checking lint packages and configuration…',
1854
2096
  creatingConfig: 'Creating ESLint configuration files…',
2097
+ addingLintScripts: 'Adding lint scripts to package.json files…',
1855
2098
  linting: 'Linting…',
1856
2099
  },
1857
- noProjectConfig: 'No project detected. Run this command from a project directory.',
1858
2100
  failedToReadPackageJson: (packageJsonPath) => `Failed to read package.json at ${packageJsonPath}`,
1859
2101
  installLintPackagesPrompt: (directories, missingPackages) => {
1860
2102
  const uniquePackages = Array.from(new Set(missingPackages)).sort();
1861
2103
  return `The dependencies required for linting are missing or outdated.\n\nDependencies:\n${uniquePackages.map(p => ` - ${p}`).join('\n')}\n\n${directories.length === 1 ? 'Directory' : 'Directories'}:\n${directories.map(d => ` - ${d}`).join('\n')}\n\nWould you like to install the required dependencies?`;
1862
2104
  },
1863
2105
  skippingDirectoriesWarning: (directories) => `Skipping linting for the following ${directories.length === 1 ? 'directory' : 'directories'}:\n${directories.map(d => ` - ${d}`).join('\n')}`,
2106
+ skippedDirectoriesError: (directoryCount) => `Linting could not run for ${directoryCount === 1 ? 'the directory' : 'the directories'} above because the required dependencies are missing. Run ${uiCommandReference('hs project lint --install-missing-deps')} to install them.`,
1864
2107
  deprecatedEslintConfigWarning: (details) => {
1865
2108
  const dirCount = details.length;
1866
2109
  const header = `Deprecated ESLint configuration file${dirCount === 1 ? '' : 's'} detected in the following ${dirCount === 1 ? 'directory' : 'directories'}:`;
@@ -1871,8 +2114,17 @@ export const commands = {
1871
2114
  },
1872
2115
  createEslintConfigPrompt: (directories) => `ESLint configuration file not found in the following ${directories.length === 1 ? 'directory' : 'directories'}:\n${directories.map(d => ` - ${d}`).join('\n')}\n\nWould you like to set up the required ESLint configuration?`,
1873
2116
  eslintConfigCreated: (configPath) => `ESLint configuration created at ${configPath}`,
2117
+ createEslintConfigRequiresV2Platform: (platformVersion) => {
2118
+ if (!platformVersion) {
2119
+ return 'Automatic ESLint configuration requires a Developer Platform project (2025.2 or later) with platformVersion set in hsproject.json. Add an eslint.config.js file manually, or set platformVersion and try again.';
2120
+ }
2121
+ return `Automatic ESLint configuration is not available for platform version ${platformVersion}. Use Developer Platform 2025.2 or later, or add eslint.config.js manually.`;
2122
+ },
2123
+ failedToFetchRemoteEslintConfig: (platformVersion) => `Could not download the ESLint config from HubSpot project components for platform version ${platformVersion}. Check your network connection and try again, or add eslint.config.js manually.`,
1874
2124
  failedToCreateEslintConfig: (configPath) => `Failed to create ESLint configuration at ${configPath}`,
1875
2125
  eslintConfigRequired: 'ESLint configuration is required to run the lint command. Run the command again to create the configuration.',
2126
+ lintScriptsAdded: (scriptNames, packageJsonPath) => `Added ${scriptNames.map(s => `"${s}"`).join(' and ')} to ${packageJsonPath}`,
2127
+ failedToAddLintScripts: (packageJsonPath) => `Failed to add lint scripts to ${packageJsonPath}`,
1876
2128
  },
1877
2129
  updateDeps: {
1878
2130
  help: {
@@ -1886,7 +2138,6 @@ export const commands = {
1886
2138
  updateSuccessful: (directory) => `Updated dependencies in ${directory}`,
1887
2139
  updatingDependenciesToLocation: (dependencies, directory) => `Updating ${dependencies} in ${directory}`,
1888
2140
  updatingDependenciesFailed: (directory) => `Updating dependencies for ${directory} failed`,
1889
- noProjectConfig: 'No project detected. Run this command from a project directory.',
1890
2141
  noPackageJsonInProject: (projectName) => `No dependencies to update. The project ${projectName} folder might be missing component or subcomponent files. ${uiLink('Learn how to create a project from scratch', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/create-an-app#customize-a-new-project-using-the-cli')}`,
1891
2142
  packageManagerNotInstalled: (packageManager) => `This command depends on ${packageManager}, install ${uiLink(packageManager, 'https://docs.npmjs.com/downloading-and-installing-node-js-and-npm')}`,
1892
2143
  },
@@ -1897,6 +2148,7 @@ export const commands = {
1897
2148
  examples: {
1898
2149
  default: 'Validate the project before uploading',
1899
2150
  withProfile: 'Validate the project with a profile before uploading.',
2151
+ json: 'Output validation results as JSON for scripting',
1900
2152
  },
1901
2153
  success: (projectName) => `Project ${projectName} is valid and ready to upload`,
1902
2154
  failure: (projectName, profileName) => `Project ${projectName} is invalid${profileName ? ` with profile "${profileName}" applied` : ''}`,
@@ -1923,10 +2175,145 @@ export const commands = {
1923
2175
  name: 'Name',
1924
2176
  platformVersion: 'Platform Version',
1925
2177
  },
2178
+ examples: {
2179
+ default: 'List projects in the target account',
2180
+ json: 'Output as JSON for scripting',
2181
+ },
2182
+ errors: {
2183
+ noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
2184
+ },
2185
+ },
2186
+ info: {
2187
+ describe: 'Display information about a project, its app, and its components',
2188
+ verboseDescribe: `Display information about a project, its app, and its components\n\nShows the project's platform version, deployed build ID, auto-deploy status, app metadata, and a list of components.\n\nRun ${uiCommandReference('hs project info --json')} to output the result as JSON for scripting.`,
2189
+ project: {
2190
+ title: (name) => `Project: ${name}`,
2191
+ platformVersion: (version) => `Platform Version: ${version}`,
2192
+ id: (id) => `Project ID: ${id}`,
2193
+ deployedBuild: (buildId) => `Deployed Build: #${buildId}`,
2194
+ autoDeploy: (enabled) => `Auto-deploy: ${enabled ? 'Enabled' : 'Disabled'}`,
2195
+ },
2196
+ app: {
2197
+ title: 'App',
2198
+ name: (name) => `Name: ${name}`,
2199
+ id: (id) => `App ID: ${id}`,
2200
+ uid: (uid) => `UID: ${uid}`,
2201
+ authType: (authType) => `Auth Type: ${authType}`,
2202
+ distributionType: (distributionType) => `Distribution: ${distributionType}`,
2203
+ },
2204
+ examples: {
2205
+ default: 'Display project information',
2206
+ json: 'Output as JSON for scripting',
2207
+ },
2208
+ viewProjectLink: 'View project in HubSpot',
2209
+ componentsHeader: 'Components',
2210
+ labels: {
2211
+ type: 'Type',
2212
+ uid: 'UID',
2213
+ },
2214
+ errors: {
2215
+ projectNotFound: (projectName, accountId) => `Project "${projectName}" was not found in account ${uiAccountDescription(accountId)}. Make sure the project has been uploaded at least once.`,
2216
+ noDeployedBuild: `This project has not been deployed yet.\n\nRun ${uiCommandReference('hs project deploy')} to deploy your project.`,
2217
+ unsupportedPlatformVersion: (platformVersion) => `This command is not supported for platform version ${chalk.bold(platformVersion)}. Please upgrade to 2025.2 or later.`,
2218
+ },
2219
+ },
2220
+ delete: {
2221
+ describe: 'Delete a project from the current target account',
2222
+ verboseDescribe: `Delete a project from the current target account\n\nThis will permanently delete the project, all deployed components, and any app installations associated with it. Your local project files will not be affected.`,
2223
+ warnings: {
2224
+ irreversibleTitle: 'Warning: This will permanently delete your project',
2225
+ irreversible: 'Deleting this project will also delete all deployed components and app installations. This action cannot be undone. Your local project files will not be affected.',
2226
+ },
2227
+ prompts: {
2228
+ selectProject: (accountId) => `Select a project to delete in ${uiAccountDescription(accountId)}`,
2229
+ confirmDelete: (projectName, accountId) => `[--force] Delete ${chalk.bold(projectName)} from ${uiAccountDescription(accountId)}? This cannot be undone.`,
2230
+ validation: {
2231
+ projectRequired: 'Please select a project to delete',
2232
+ },
2233
+ },
2234
+ logs: {
2235
+ deleting: (projectName) => `Deleting project ${chalk.bold(projectName)}...`,
2236
+ deleted: (projectName, accountId) => `Deleted project ${chalk.bold(projectName)} from ${uiAccountDescription(accountId)}`,
2237
+ cancelled: 'Deletion cancelled',
2238
+ componentsToDeleteUnified: (components) => `The following deployed components will be deleted:\n${components.map(c => ` - ${chalk.bold(c.componentId)} (${mapToUserFriendlyName(c.componentType)})`).join('\n')}`,
2239
+ componentsToDeleteLegacy: (components) => `The following deployed components will be deleted:\n${components.map(c => ` - ${chalk.bold(c)}`).join('\n')}`,
2240
+ deletingComponents: (projectName) => `Deleting deployed components from ${chalk.bold(projectName)}...`,
2241
+ componentsDeleted: (projectName) => `Deleted deployed components from ${chalk.bold(projectName)}`,
2242
+ unableToDetermineIfComponentsWereDeleted: (projectName) => `Unable to determine if components were successfully deleted from ${chalk.bold(projectName)}. Please try again.`,
2243
+ installWarning: (installCount) => `This project has ${chalk.bold(String(installCount))} active app ${installCount === 1 ? 'installation' : 'installations'} that will be deleted.`,
2244
+ installCountUnknown: 'Unable to determine the number of active app installations for this project.',
2245
+ },
1926
2246
  errors: {
1927
2247
  noProjectsFound: (accountId) => `No projects found for account ${uiAccountDescription(accountId)}`,
2248
+ projectNotFound: (projectName, accountId) => `Project ${chalk.bold(projectName)} not found in ${uiAccountDescription(accountId)}`,
2249
+ deleteFailed: (projectName) => `Failed to delete project ${chalk.bold(projectName)}. Run with --debug for details or try again.`,
2250
+ cannotDelete: (projectName, reason) => `Cannot delete project ${chalk.bold(projectName)}: ${reason}`,
2251
+ noPlatformVersion: 'Unable to determine platform version for project',
2252
+ componentDeletionFailed: (projectName) => `Failed to delete deployed components from ${chalk.bold(projectName)}. The project was not deleted.`,
2253
+ },
2254
+ options: {
2255
+ project: 'name of the project to delete',
2256
+ force: 'skip confirmation prompt',
1928
2257
  },
1929
2258
  },
2259
+ installApp: {
2260
+ describe: 'Install a static auth app from the current project into the target account',
2261
+ verboseDescribe: `Install a static auth app from the current project into the target account.\n\nRun this command from within the project directory. The project must contain a privately distributed static auth app and must already be uploaded to the target account.`,
2262
+ examples: {
2263
+ default: 'Install the static auth app from the current project',
2264
+ withAccount: 'Install the app into a specific account',
2265
+ withProfile: 'Install the app into the account targeted by a profile',
2266
+ json: 'Output install result as JSON',
2267
+ },
2268
+ options: {
2269
+ force: 'Skip confirmation prompts',
2270
+ profile: 'The profile to target with this install',
2271
+ },
2272
+ errors: {
2273
+ unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
2274
+ failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
2275
+ noAppInProject: 'No app was found in the local project. This command requires a project that contains an app.',
2276
+ unsupportedAuthType: (authType) => `This command only supports static auth apps. Detected auth type: ${authType}.`,
2277
+ unsupportedDistribution: (distribution) => `This command only supports privately distributed apps. Detected distribution: ${distribution}.`,
2278
+ invalidAppDeveloperAccount: (accountId) => `Static auth apps can't be installed into the app developer account ${uiAccountDescription(accountId)}. Switch to a standard, sandbox, or developer test account with ${uiCommandReference('hs account use')}, or pass ${uiCommandReference('--account')}.`,
2279
+ projectNotFound: (accountId, projectName) => `The project ${chalk.bold(projectName)} does not exist in ${uiAccountDescription(accountId)}. Run ${uiCommandReference('hs project upload')} to upload your project files to HubSpot.`,
2280
+ appNotDeployed: (appName, accountId) => `The app ${chalk.bold(appName)} has not been deployed to ${uiAccountDescription(accountId)}. Upload the project with ${uiCommandReference('hs project upload')} and ensure the build succeeds, then try again.`,
2281
+ automaticInstallUnavailable: (appName, accountId) => `${chalk.bold(appName)} could not be installed automatically in ${uiAccountDescription(accountId)}.`,
2282
+ installFailed: (appName, accountId) => `Failed to install ${chalk.bold(appName)} in ${uiAccountDescription(accountId)}.`,
2283
+ },
2284
+ jsonErrors: {
2285
+ automaticInstallUnavailable: 'Automatic install is unavailable for this account.',
2286
+ installFailed: (appName, accountId) => `Failed to install ${appName} in account ${accountId}.`,
2287
+ },
2288
+ profileMessage: (profileName, accountId) => `Installing with ${chalk.bold(profileName)} profile: ${uiAccountDescription(accountId)}`,
2289
+ appDeveloperAccountNotice: (accountId) => `${uiAccountDescription(accountId)} is an app developer account, which can't have apps installed into it.`,
2290
+ selectInstallAccountPrompt: 'Select an account to install the app into',
2291
+ uploadAndDeployPrompt: (accountId) => `The app isn't deployed to ${uiAccountDescription(accountId)} yet. Upload and deploy the project now?`,
2292
+ alreadyInstalled: (appName, accountId) => `${chalk.bold(appName)} is already installed in ${uiAccountDescription(accountId)}.`,
2293
+ outdatedScopes: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)} with outdated scopes.`,
2294
+ reinstallPrompt: 'Reinstall the app to grant the latest scopes?',
2295
+ installPrompt: (appName, accountId) => `Install ${chalk.bold(appName)} in ${uiAccountDescription(accountId)}?`,
2296
+ installFromBrowser: (installUrl) => `Install the app in HubSpot: ${uiLink('Open install page', installUrl)}`,
2297
+ success: (appName, accountId) => `${chalk.bold(appName)} installed in ${uiAccountDescription(accountId)}.`,
2298
+ },
2299
+ installStatus: {
2300
+ describe: 'Check whether a static auth app in the current project is installed in the target account. This command must be run from within a HubSpot project directory.',
2301
+ examples: {
2302
+ default: 'Check install status for the static auth app in the current project',
2303
+ json: 'Output install status as JSON',
2304
+ },
2305
+ errors: {
2306
+ unsupportedPlatformVersion: (platformVersion) => `This command is only supported for projects on platform version 2025.2 or later (detected: ${platformVersion}).`,
2307
+ failedToParseProject: 'Failed to parse the project. Check your project configuration is valid and try again.',
2308
+ noAppInProject: 'No app was found in the local project. Install status is only available for projects that contain an app.',
2309
+ unsupportedAuthType: (authType) => `This command only supports static auth apps. Detected auth type: ${authType}.`,
2310
+ },
2311
+ success: {
2312
+ installed: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)}.`,
2313
+ installedWithOutdatedScopes: (appName, accountId) => `${chalk.bold(appName)} is installed in ${uiAccountDescription(accountId)} with outdated scopes. Reinstall the app to grant the latest scopes.`,
2314
+ },
2315
+ notInstalled: (appName, accountId) => `${chalk.bold(appName)} is not installed in ${uiAccountDescription(accountId)}.`,
2316
+ },
1930
2317
  },
1931
2318
  sandbox: {
1932
2319
  describe: 'Commands for managing sandboxes.',
@@ -2121,6 +2508,111 @@ export const commands = {
2121
2508
  },
2122
2509
  },
2123
2510
  },
2511
+ logs: {
2512
+ describe: 'View recent application logs.',
2513
+ verboseDescribe: `View recent application logs for a specific log type.\n\nFilter by time range with ${uiCommandReference('--since')} (e.g. 1h, 30m, 2d, or an ISO timestamp). Use ${uiCommandReference('--tail')} to follow logs in real-time, ${uiCommandReference('--compact')} for one-line-per-log output, or ${uiCommandReference('--json')} for machine-readable output.\n\nRun ${uiCommandReference('hs app log-details <logId>')} to inspect a specific log entry.`,
2514
+ options: {
2515
+ appId: 'App ID',
2516
+ type: 'Log type',
2517
+ json: 'Output logs as JSON',
2518
+ limit: 'Maximum number of logs to return',
2519
+ since: 'Filter logs by time ago (1h, 30m, 2d, or ISO timestamp)',
2520
+ tail: 'Follow logs in real-time',
2521
+ errorsOnly: 'Only show error logs',
2522
+ compact: 'Display logs in compact format (one line per log)',
2523
+ },
2524
+ errors: {
2525
+ noLogs: 'No logs found. Try a wider time range (--since) or remove --errors-only to see all logs.',
2526
+ noApps: `No apps found. Create an app with ${uiCommandReference('hs project create')}.`,
2527
+ },
2528
+ prompts: {
2529
+ selectType: '[--type] Select the type of logs to view:',
2530
+ },
2531
+ examples: {
2532
+ basic: 'Fetch webhook logs for app 123456',
2533
+ since: 'Fetch logs from the last hour',
2534
+ tail: 'Follow logs in real-time',
2535
+ json: 'Output logs as JSON',
2536
+ compact: 'Display logs in compact format',
2537
+ },
2538
+ outputMessages: {
2539
+ viewInHubSpot: (url) => uiLink('View in HubSpot', url),
2540
+ tableHeaders: {
2541
+ appId: 'App ID',
2542
+ type: 'Type',
2543
+ logsFound: 'Logs Found',
2544
+ },
2545
+ logDetails: {
2546
+ id: 'ID',
2547
+ duration: 'Duration',
2548
+ portal: 'Portal',
2549
+ trace: 'Trace',
2550
+ error: 'Error',
2551
+ viewDetails: (logId, appId, systemType) => `To view more details, run: ${uiCommandReference(`hs app log-details ${logId} --app=${appId} --type=${systemType}`)}`,
2552
+ viewInUI: (url) => uiLink('View details in UI', url),
2553
+ },
2554
+ tailMessages: {
2555
+ following: (appId) => `Following logs for app ${appId}`,
2556
+ stop: `> Press ${chalk.bold('q')} to stop following`,
2557
+ },
2558
+ },
2559
+ },
2560
+ logDetails: {
2561
+ describe: 'View details for a specific log entry.',
2562
+ verboseDescribe: `View full details for a specific app log entry, including request/response bodies, context information, and error details.\n\nUse ${uiCommandReference('--json')} for machine-readable output.`,
2563
+ positionals: {
2564
+ logId: 'The log ID to fetch details for',
2565
+ },
2566
+ options: {
2567
+ appId: 'App ID',
2568
+ type: 'Log type',
2569
+ json: 'Output details as JSON',
2570
+ },
2571
+ errors: {
2572
+ noApps: `No apps found. Create an app with ${uiCommandReference('hs project create')}.`,
2573
+ },
2574
+ prompts: {
2575
+ selectType: '[--type] Select the log type:',
2576
+ },
2577
+ examples: {
2578
+ basic: 'Fetch details for log abc-123',
2579
+ json: 'Output log details as JSON',
2580
+ },
2581
+ outputMessages: {
2582
+ viewInHubSpot: (url) => uiLink('View in HubSpot', url),
2583
+ logDetailsHeader: 'Log Details',
2584
+ basicInfo: {
2585
+ id: 'Log ID',
2586
+ timestamp: 'Timestamp',
2587
+ status: 'Status',
2588
+ duration: 'Duration',
2589
+ systemType: 'Type',
2590
+ },
2591
+ contextInfo: {
2592
+ header: 'Context',
2593
+ portalId: 'Portal ID',
2594
+ traceId: 'Trace ID',
2595
+ function: 'Function',
2596
+ location: 'Location',
2597
+ card: 'Card',
2598
+ userId: 'User ID',
2599
+ },
2600
+ requestResponse: {
2601
+ header: 'Request/Response',
2602
+ requestBody: 'Request Body',
2603
+ responseBody: 'Response Body',
2604
+ },
2605
+ errorInfo: {
2606
+ header: 'Error Details',
2607
+ errorType: 'Type',
2608
+ errorMessage: 'Message',
2609
+ stackTrace: 'Stack Trace',
2610
+ },
2611
+ additionalInfo: {
2612
+ header: 'Additional Information',
2613
+ },
2614
+ },
2615
+ },
2124
2616
  },
2125
2617
  },
2126
2618
  secret: {
@@ -2222,7 +2714,7 @@ export const commands = {
2222
2714
  configPathPrompt: '[--config-path] Enter the path to the test account config: ',
2223
2715
  createTestAccountFromConfigPrompt: 'How would you like to create your test account?',
2224
2716
  createFromConfigOption: 'Create test account from config file',
2225
- createFromScratchOption: 'Create test account from scratch',
2717
+ createFromScratchOption: 'Select hub tiers manually',
2226
2718
  errors: {
2227
2719
  configFileNotFound: (configPath) => `No test account config file exists at ${configPath}. Create a test account config file with the ${uiCommandReference('hs test-account create-config')} command.`,
2228
2720
  configFileParseFailed: (configPath) => `Failed to parse test account config file at ${configPath}`,
@@ -2242,8 +2734,8 @@ export const commands = {
2242
2734
  opsLevel: 'Operations Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2243
2735
  serviceLevel: 'Service Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2244
2736
  salesLevel: 'Sales Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2245
- contentLevel: 'CMS Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2246
- commerceLevel: 'Commerce Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
2737
+ contentLevel: 'Content Hub tier. Options: FREE, STARTER, PROFESSIONAL, ENTERPRISE',
2738
+ commerceLevel: 'Revenue Hub tier. Options: FREE, PROFESSIONAL, ENTERPRISE',
2247
2739
  },
2248
2740
  example: (configPath) => `Create a test account from the config file at ${configPath}`,
2249
2741
  examples: {
@@ -2895,15 +3387,30 @@ export const commands = {
2895
3387
  },
2896
3388
  };
2897
3389
  export const lib = {
3390
+ linkedDirectory: {
3391
+ warning: (action, settingsPath) => `This directory has linked accounts via ${settingsPath}. ${uiCommandReference(action)} modifies your global config, not the linked directory settings. Use ${uiCommandReference('hs account link')} to manage linked accounts.\n`,
3392
+ },
2898
3393
  parsing: {
2899
3394
  unableToParseStringToNumber: 'Unable to parse string to number',
2900
3395
  },
2901
3396
  configMiddleWare: {
2902
3397
  invalidAccountIdEnvironmentVariable: 'Unable to parse `HUBSPOT_ACCOUNT_ID` environment variable into a number',
2903
3398
  },
3399
+ accountTargetDiscovery: {
3400
+ errors: {
3401
+ explicitAccountNotFound: (account) => `Account ${chalk.bold(String(account))} was not found in your config. Run ${uiCommandReference('hs account list')} to see available accounts.`,
3402
+ },
3403
+ },
2904
3404
  process: {
2905
3405
  exitDebug: (signal) => `Attempting to gracefully exit. Triggered by ${signal}`,
2906
3406
  },
3407
+ handlerLogFile: {
3408
+ saved: (filePath) => `Debug logs can be viewed at ${filePath}`,
3409
+ },
3410
+ jsonSchema: {
3411
+ noSchemaForCommand: 'No schema defined for this command',
3412
+ validationFailed: 'JSON output may be missing or malformed fields. The output schema may be out of date.',
3413
+ },
2907
3414
  DevServerManager: {
2908
3415
  portConflict: (port) => `The port ${port} is already in use.`,
2909
3416
  notInitialized: 'The Dev Server Manager must be initialized before it is started.',
@@ -2918,6 +3425,7 @@ export const lib = {
2918
3425
  learnMoreLocalDevServer: uiLink('Learn more about the projects local dev server', 'https://developers.hubspot.com/docs/developer-tooling/local-development/hubspot-cli/project-commands'),
2919
3426
  running: (projectName, accountIdentifier) => chalk.hex(UI_COLORS.SORBET)(`Running ${chalk.bold(projectName)} locally on ${accountIdentifier}, waiting for changes ...`),
2920
3427
  quitHelper: `Press ${chalk.bold('q')} to stop the local dev server`,
3428
+ autoUploadEnabled: `${chalk.bold('Auto-upload is on.')} Changes you make locally will be uploaded to HubSpot automatically.`,
2921
3429
  viewProjectLink: (name, accountId) => uiLink('View project in HubSpot', getProjectDetailUrl(name, accountId) || ''),
2922
3430
  viewLocalDevUILink: (accountId, showWelcomeScreen) => uiLink('View local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen)),
2923
3431
  localDevUIAutoMessage: (accountId, showWelcomeScreen) => `Opening your ${uiLink('local dev session in HubSpot', getLocalDevUiUrl(accountId, showWelcomeScreen))}...`,
@@ -2986,6 +3494,13 @@ export const lib = {
2986
3494
  appDataNotFound: 'An error occurred while fetching data for your app.',
2987
3495
  oauthAppRedirectUrlError: (redirectUrl) => `${chalk.bold('No reponse from your OAuth service:')} ${redirectUrl}\nYour app needs a valid OAuth2 service to be installed for local dev. ${uiLink('Learn more', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/authentication/oauth/working-with-oauth')}`,
2988
3496
  },
3497
+ accountAuthWebsocket: {
3498
+ logs: {
3499
+ openingWebBrowser: (url) => `Opening ${uiLink('HubSpot', url)} in your web browser\n`,
3500
+ spinner: 'Waiting for HubSpot to send your personal access key... (press any key to enter it manually)',
3501
+ received: 'Personal access key received',
3502
+ },
3503
+ },
2989
3504
  CLIWebsocketServer: {
2990
3505
  errors: {
2991
3506
  portManagerNotRunning: (prefix) => `${prefix ? `${prefix} ` : ''}PortManagerServing must be running before starting WebsocketServer.`,
@@ -2993,6 +3508,7 @@ export const lib = {
2993
3508
  missingTypeField: (data) => `Unsupported message received. Missing type field: ${data}`,
2994
3509
  invalidJSON: (data) => `Unsupported message received. Invalid JSON: ${data}`,
2995
3510
  unknownMessageType: (type) => `Unsupported message received. Unknown message type: ${type}`,
3511
+ failedToBindEphemeralPort: (prefix) => `${prefix ? `${prefix} ` : ''}Failed to determine the assigned port for the WebsocketServer.`,
2996
3512
  },
2997
3513
  logs: {
2998
3514
  startup: (port) => `WebsocketServer running on port ${port}`,
@@ -3000,8 +3516,14 @@ export const lib = {
3000
3516
  },
3001
3517
  LocalDevProcess: {
3002
3518
  projectConfigMismatch: `Unable to upload project. The project config has been modified since starting ${uiCommandReference('hs project dev')}.`,
3003
- uploadInitiated: 'Project upload initiated from Local Dev UI.',
3004
- deployInitiated: 'Project deploy initiated from Local Dev UI.',
3519
+ uploadInitiated: 'Project upload initiated.',
3520
+ autoUploadScheduled: (filePath) => `Auto-upload: detected change to ${filePath}, upload scheduled.`,
3521
+ autoUploadTriggered: 'Auto-upload: debounce elapsed, uploading now.',
3522
+ autoUploadInProgress: 'Auto-upload: an upload is already running, will re-run after it finishes.',
3523
+ autoUploadToggled: (enabled) => enabled
3524
+ ? `${chalk.bold('Auto-upload turned on')} from the Local Dev Panel. Changes you make locally will be uploaded to HubSpot automatically.`
3525
+ : `${chalk.bold('Auto-upload turned off')} from the Local Dev Panel. Upload manually from the Local Dev Panel to push your changes.`,
3526
+ deployInitiated: 'Project deploy initiated from the Local Dev Panel.',
3005
3527
  uploadFailed: 'Project upload failed. To proceed with local development, fix any necessary errors, then re-upload your project.',
3006
3528
  deployFailed: 'Project deploy failed. To proceed with local development, fix any necessary errors, then re-deploy your project.',
3007
3529
  uploadSuccess: 'Project upload completed successfully. Resuming local dev...',
@@ -3016,7 +3538,21 @@ export const lib = {
3016
3538
  checking: 'Checking if your deployed build is up to date...',
3017
3539
  upToDate: 'Deployed build is up to date.',
3018
3540
  notUpToDate: `Your project contains undeployed local changes.`,
3541
+ changedFiles: (changed) => {
3542
+ const sections = [];
3543
+ if (changed.added.length > 0) {
3544
+ sections.push(`${chalk.bold('Features Added:')}\n${changed.added.map(f => ` - ${f}`).join('\n')}`);
3545
+ }
3546
+ if (changed.updated.length > 0) {
3547
+ sections.push(`${chalk.bold('Features Modified:')}\n${changed.updated.map(f => ` - ${f}`).join('\n')}`);
3548
+ }
3549
+ if (changed.removed.length > 0) {
3550
+ sections.push(`${chalk.bold('Features Removed:')}\n${changed.removed.map(f => ` - ${f}`).join('\n')}`);
3551
+ }
3552
+ return sections.join('\n\n');
3553
+ },
3019
3554
  notUpToDateExplanation: (profile) => `Run ${uiCommandReference(`hs project upload${profile ? ` --profile ${profile}` : ''}`)} to upload these changes to HubSpot, then re-run ${uiCommandReference(`hs project dev${profile ? ` --profile ${profile}` : ''}`)} to continue local development.`,
3555
+ unableToCompare: `Unable to check if local *-hsmeta.json files match the deployed build. Run ${uiCommandReference('hs project upload')} to upload any local changes before continuing.`,
3020
3556
  },
3021
3557
  createNewProjectForLocalDev: {
3022
3558
  projectMustExistExplanation: (projectName, accountId) => `The project ${projectName} does not exist in the target account ${uiAccountDescription(accountId)}. This command requires the project to exist in the target account.`,
@@ -3039,19 +3575,6 @@ export const lib = {
3039
3575
  },
3040
3576
  },
3041
3577
  account: {
3042
- checkIfDefaultAccountIsSupported: {
3043
- publicApp: `This project contains a public app. Local development of public apps is only supported on developer accounts and developer test accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
3044
- privateApp: `This project contains a private app. Local development of private apps is not supported in developer accounts. Change your default account using ${uiCommandReference('hs account use')}, or link a new account with ${uiAuthCommandReference()}.`,
3045
- },
3046
- validateAccountOption: {
3047
- invalidPublicAppAccount: `This project contains a public app. The "--account" flag must point to a developer test account to develop this project locally. Alternatively, change your default account to an app developer account using ${uiCommandReference('hs account use')} and run ${uiCommandReference('hs project dev')} to set up a new developer test account.`,
3048
- invalidPrivateAppAccount: `This project contains a private app. The account specified with the "--account" flag points to a developer account, which do not support the local development of private apps. Update the "--account" flag to point to a standard, sandbox, or developer test account, or change your default account by running ${uiCommandReference('hs account use')}.`,
3049
- nonSandboxWarning: `Testing in a sandbox is strongly recommended. To switch the target account, select an option below or run ${uiCommandReference('hs account use')} before running the command again.`,
3050
- publicAppNonDeveloperTestAccountWarning: `Local development of public apps is only supported in ${chalk.bold('developer test accounts')}.`,
3051
- },
3052
- checkIfParentAccountIsAuthed: {
3053
- notAuthedError: (parentAccountId, accountIdentifier) => `To develop this project locally, run ${uiAuthCommandReference({ accountId: parentAccountId })} to authenticate the App Developer Account ${parentAccountId} associated with ${accountIdentifier}.`,
3054
- },
3055
3578
  selectAccountTypePrompt: {
3056
3579
  message: 'Choose the type of account to test on',
3057
3580
  developerTestAccountOption: 'Test on a developer test account (recommended)',
@@ -3059,10 +3582,7 @@ export const lib = {
3059
3582
  sandboxAccountOptionDisabled: 'Disabled - requires access to sandbox accounts',
3060
3583
  productionAccountOption: (accountId) => `<${chalk.red('!')} Test on your project account: ${uiAccountDescription(accountId, false)} ${chalk.red('!')}>`,
3061
3584
  },
3062
- confirmDefaultAccountIsTarget: {
3063
- configError: `An error occurred while reading the default account from your config. Run ${uiAuthCommandReference()} to re-auth this account`,
3064
- declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
3065
- },
3585
+ declineDefaultAccountExplanation: `To develop on a different account, run ${uiCommandReference('hs account use')} to change your default account, then re-run ${uiCommandReference('hs project dev')}.`,
3066
3586
  },
3067
3587
  },
3068
3588
  middleware: {
@@ -3078,6 +3598,12 @@ export const lib = {
3078
3598
  updateFailed: (latestVersion) => `Failed to update HubSpot CLI to version ${chalk.bold(latestVersion)}`,
3079
3599
  enableAutoUpdatesMessage: `The HubSpot CLI can automatically keep itself up to date.\n\nThis helps ensure compatibility with the HubSpot platform. You can change this later at any time.\n\nRun ${uiCommandReference('hs config set --allow-auto-updates=true')}`,
3080
3600
  },
3601
+ deprecationWarning: {
3602
+ deprecatedTitle: 'Deprecated',
3603
+ deprecatedMessage: (currentVersion, eolDate) => `Version: HubSpot CLI v${currentVersion}\n\nStatus: Deprecated (End of Life: ${eolDate})\n\nAction Required: Upgrade to the latest major version to continue receiving new features\n\nReplacement: Run ${uiCommandReference('npm install -g @hubspot/cli@latest')} to upgrade\n\n${uiLink('CLI Support Guidelines', CLI_SUPPORT_GUIDELINES_URL)}`,
3604
+ endOfLifeTitle: 'End of Life',
3605
+ endOfLifeMessage: (currentVersion, eolDate) => `Version: HubSpot CLI v${currentVersion}\n\nStatus: End of Life (as of ${eolDate})\n\nAction Required: This version is no longer supported. Upgrade immediately to continue receiving updates\n\nReplacement: Run ${uiCommandReference('npm install -g @hubspot/cli@latest')} to upgrade\n\n${uiLink('CLI Support Guidelines', CLI_SUPPORT_GUIDELINES_URL)}`,
3606
+ },
3081
3607
  },
3082
3608
  projectProfiles: {
3083
3609
  logs: {
@@ -3085,14 +3611,8 @@ export const lib = {
3085
3611
  profileTargetAccount: (accountId) => `Targeting ${uiAccountDescription(accountId)}`,
3086
3612
  profileVariables: 'Profile variables',
3087
3613
  },
3088
- exitIfUsingProfiles: {
3089
- errors: {
3090
- noProfileSpecified: `This project is configured to use profiles, but no profile was specified. Target a profile using the ${uiCommandReference('--profile')} flag.`,
3091
- },
3092
- },
3093
3614
  loadProfile: {
3094
3615
  errors: {
3095
- noProjectConfig: 'No project config found. Please run this command from a project directory.',
3096
3616
  profileNotFound: (profileName) => `Profile ${chalk.bold(profileName)} not found.`,
3097
3617
  missingAccountId: (profileName) => `Profile ${chalk.bold(profileName)} is missing an account id.`,
3098
3618
  listedAccountNotFound: (accountId, profileName) => `The account ${uiAccountDescription(accountId)} is defined in your profile ${chalk.bold(profileName)}, but is missing in your config file`,
@@ -3134,12 +3654,6 @@ export const lib = {
3134
3654
  },
3135
3655
  validateProjectConfig: {
3136
3656
  configNotFound: `Unable to locate a project configuration file. Try running again from a project directory, or run ${uiCommandReference('hs project create')} to create a new project.`,
3137
- configMissingFields: (missingFields) => `The project configuration file is missing required field${missingFields.length > 1 ? 's' : ''}: ${missingFields.map(f => chalk.bold(f)).join(', ')}`,
3138
- srcDirNotFound: (srcDir, projectDir) => `Project source directory ${chalk.bold(srcDir)} could not be found in ${chalk.bold(projectDir)}.`,
3139
- srcOutsideProjectDir: (projectConfig, srcDir) => `Invalid value for 'srcDir' in ${projectConfig}: ${chalk.bold(`srcDir: "${srcDir}"`)}\n\t'srcDir' must be a relative path to a folder under the project root, such as "." or "./src"`,
3140
- },
3141
- getProjectConfig: {
3142
- error: 'Could not read from project config',
3143
3657
  },
3144
3658
  platformVersion: {
3145
3659
  unsupported: (currentCliVersion, latestSupported, platformVersion) => `Platform version${platformVersion ? ' ' + chalk.bold(platformVersion) : ''} is not officially supported by this version of the CLI (${chalk.bold(currentCliVersion)}).\n\nUpdate your CLI to the latest version with ${uiCommandReference('hs upgrade')} or use a compatible platform version (${chalk.bold(latestSupported)} or earlier).`,
@@ -3157,6 +3671,11 @@ export const lib = {
3157
3671
  feedbackHeader: "We'd love to hear your feedback!",
3158
3672
  feedbackMessage: `How are you liking the new projects and developer tools? \n > Run ${uiCommandReference('hs feedback')} to let us know what you think!\n`,
3159
3673
  },
3674
+ skippedHsMetaFiles: {
3675
+ warning: (files) => `The following *-hsmeta.json files will be skipped.\nThis CLI version doesn't support the features they require:\n${files.map(f => ` ${chalk.bold(f)}`).join('\n')}\nRun ${uiCommandReference('hs upgrade')} to update the CLI, which may add support for these features.`,
3676
+ uploadWarning: (files) => `The following *-hsmeta.json files will be skipped during upload.\nThis CLI version doesn't support the features they require:\n${files.map(f => ` ${chalk.bold(f)}`).join('\n')}\nRun ${uiCommandReference('hs upgrade')} to update the CLI, which may add support for these features.`,
3677
+ prompt: '[--force] Continue anyway?',
3678
+ },
3160
3679
  components: {
3161
3680
  unableToGetUidFromHsmeta: 'Unable to get UID from hsmeta',
3162
3681
  buildSuccessMessage: {
@@ -3164,9 +3683,9 @@ export const lib = {
3164
3683
  docsUrl: 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/overview',
3165
3684
  headerCreated: (projectName, projectDest) => `${chalk.bold(projectName)} was successfully created in ${projectDest}`,
3166
3685
  headerAdded: (featureText, uid, plural) => `${featureText} ${plural ? 'were' : 'was'} successfully added to ${uid}:`,
3167
- docsDetails: (docsLink) => `📖 ${docsLink} for more details about building and testing these features.`,
3168
- uploadPrompt: `🚀 Run ${uiCommandReference('hs project upload')} when you're ready to deploy.`,
3169
- devPrompt: `🧪 Run ${uiCommandReference('hs project dev')} to start local development.`,
3686
+ docsDetails: (docsLink) => `${docsLink} for more details about building and testing these features.`,
3687
+ uploadPrompt: `Run ${uiCommandReference('hs project upload')} when you're ready to deploy.`,
3688
+ devPrompt: `Run ${uiCommandReference('hs project dev')} to start local development.`,
3170
3689
  },
3171
3690
  },
3172
3691
  },
@@ -3202,8 +3721,33 @@ export const lib = {
3202
3721
  fileFiltered: (filename) => `Ignore rule triggered for "${filename}"`,
3203
3722
  legacyFileDetected: (filename, platformVersion) => `The ${chalk.bold(filename)} file is not supported on platform version ${chalk.bold(platformVersion)} and will be ignored.`,
3204
3723
  projectDoesNotExist: (accountId) => `Upload cancelled. Run ${uiCommandReference('hs project upload')} again to create the project in ${uiAccountDescription(accountId)}.`,
3724
+ workspaceIncluded: (workspaceDir, archivePath) => `Including workspace: ${workspaceDir} → ${archivePath}`,
3725
+ fileDependencyIncluded: (packageName, localPath, archivePath) => `Including file: dependency ${packageName}: ${localPath} → ${archivePath}`,
3726
+ malformedPackageJson: (packageJsonPath, error) => `Skipping malformed package.json at ${packageJsonPath}: ${error}`,
3727
+ workspaceCollision: (archivePath, workspaceDir, existingWorkspace) => `Workspace collision: ${archivePath} from ${workspaceDir} and ${existingWorkspace}`,
3728
+ fileDependencyAlreadyIncluded: (packageName, archivePath) => `file: dependency ${packageName} already included as workspace: ${archivePath}`,
3729
+ updatingLockfile: (lockfilePath) => `Updating package-lock.json in archive: ${lockfilePath}`,
3730
+ updatingPackageJsonWorkspaces: (packageJsonPath) => `Updating package.json workspaces in archive: ${packageJsonPath}`,
3731
+ updatedWorkspaces: (workspaces) => ` Updated workspaces: ${workspaces}`,
3732
+ updatedFileDependency: (packageName, relativePath) => ` Updated dependencies.${packageName}: file:${relativePath}`,
3733
+ lintPackagesNotConfigured: (packageRoot) => `Project lint: lint packages not installed for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to install them.`,
3734
+ lintConfigNotFound: (packageRoot) => `Project lint: ESLint configuration not found for ${chalk.bold(packageRoot)}. Run ${uiCommandReference('hs project lint')} to create an ESLint config.`,
3735
+ lintHubSpotRulesNotActive: (packageRoot) => `Project lint: HubSpot ESLint rules not active for ${chalk.bold(packageRoot)}. Configure ${chalk.bold('@hubspot/eslint-config-ui-extensions')} — see ${uiLink('setup instructions', 'https://www.npmjs.com/package/@hubspot/eslint-config-ui-extensions')}.`,
3736
+ npmAuditClean: (packageRoot) => `npm audit: No npm dependency issues found for ${chalk.bold(packageRoot)}`,
3737
+ npmAuditIssues: (packageRoot, details) => `npm audit: security issues found for ${chalk.bold(packageRoot)}: ${details}`,
3738
+ npmAuditNpmUnavailable: (packageRoot) => `npm audit: skipped for ${chalk.bold(packageRoot)} (npm not available in PATH)`,
3739
+ npmAuditNonZeroExit: (packageRoot, exitCode) => `npm audit: ${chalk.bold(packageRoot)} exited with code ${exitCode}`,
3205
3740
  },
3206
3741
  },
3742
+ projectPreview: {
3743
+ triggeringPreview: (buildId, targetPortalId) => `Previewing build #${buildId} on ${uiAccountDescription(targetPortalId)}`,
3744
+ pollingStatus: (releaseTag, targetPortalId) => `Previewing ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
3745
+ succeeded: (releaseTag, targetPortalId) => `Previewed ${chalk.bold(releaseTag)} on ${uiAccountDescription(targetPortalId)}`,
3746
+ triggerFailed: 'Failed to trigger preview',
3747
+ pollFailed: 'Failed to poll preview status',
3748
+ warning: 'The build succeeded but the preview failed. You can manually preview this build from the project UI.',
3749
+ missingProjectId: 'Unable to preview: could not resolve the project ID.',
3750
+ },
3207
3751
  importData: {
3208
3752
  errors: {
3209
3753
  incorrectAccountType: (derivedAccountId) => `The account ${uiAccountDescription(derivedAccountId)} is not a standard account, developer test account, or app developer account.`,
@@ -3312,6 +3856,9 @@ export const lib = {
3312
3856
  pakFailure: 'Failed to generate personal access key for developer test account',
3313
3857
  },
3314
3858
  },
3859
+ usageTracking: {
3860
+ transparencyMessage: `HubSpot CLI collects anonymous usage data to improve the product. Run ${uiCommandReference('hs config set --enable-usage-tracking=false', false)} to opt out.\n`,
3861
+ },
3315
3862
  configOptions: {
3316
3863
  enableOrDisableBooleanFieldPrompt: {
3317
3864
  message: (fieldName) => `Choose to enable or disable ${fieldName}`,
@@ -3357,7 +3904,9 @@ export const lib = {
3357
3904
  qa: 'Run command in QA mode',
3358
3905
  useEnv: 'Use environment variable config',
3359
3906
  jsonOutput: 'Format output as JSON',
3907
+ jsonSchema: 'Print the JSON output schema and exit',
3360
3908
  debug: 'Set log level to debug',
3909
+ color: 'Enable colored output (use --no-color to disable)',
3361
3910
  },
3362
3911
  },
3363
3912
  configMigrate: {
@@ -3400,8 +3949,14 @@ export const lib = {
3400
3949
  promptUtils: {
3401
3950
  errors: {
3402
3951
  noSelectableChoices: 'Exiting prompt because no selectable choices are available',
3952
+ userCancelled: 'User cancelled prompt',
3403
3953
  },
3404
3954
  },
3955
+ projectProfilePrompt: {
3956
+ message: '[--profile] This project is configured to use profiles. Select a profile to use:',
3957
+ exitMessage: `This project is configured to use profiles, but no profile was specified. Try again using ${uiCommandReference('--profile')}`,
3958
+ noValidProfilesMessage: 'There are no valid profiles in this project. Ensure the accounts they are targeting are authenticated and try again.',
3959
+ },
3405
3960
  importDataFilePathPrompt: {
3406
3961
  promptContext: `To view the JSON schema for data imports, visit ${uiLink('the docs', 'https://developers.hubspot.com/docs/guides/api/crm/imports')}`,
3407
3962
  promptMessage: '[--file-path] Select the JSON file that will be used to import your data.',
@@ -3425,13 +3980,15 @@ export const lib = {
3425
3980
  developerTestAccountLimit: (limit) => `Your account reached the limit of ${limit} developer test accounts.`,
3426
3981
  confirmDefaultAccount: (accountName, accountType) => `Continue testing on ${chalk.bold(`${accountName} (${accountType})`)}? (Y/n)`,
3427
3982
  confirmUseExistingDeveloperTestAccount: (accountName) => `Continue with ${accountName}? This account isn't currently connected to the HubSpot CLI. By continuing, you'll be prompted to generate a personal access key and connect it.`,
3983
+ confirmLinkExistingDeveloperTestAccount: (accountName) => `${accountName} is not linked to this directory. Would you like to link it?`,
3428
3984
  noAccountId: 'No account ID found for the selected account. Please try again.',
3985
+ fetchDeveloperTestAccountsError: 'Unable to fetch developer test accounts. Please try again.',
3429
3986
  },
3430
3987
  projectLogsPrompt: {
3431
3988
  functionName: (projectName) => `[--function] Select function in ${chalk.bold(projectName)} project`,
3432
3989
  },
3433
3990
  setAsDefaultAccountPrompt: {
3434
- setAsDefaultAccountMessage: 'Set this account as the default?',
3991
+ setAsDefaultAccountMessage: (accountName) => `Set ${accountName} as your default account? [--default]`,
3435
3992
  setAsDefaultAccount: (accountName) => `Account "${accountName}" set as the default account`,
3436
3993
  keepingCurrentDefault: (accountName) => `Account "${accountName}" will continue to be the default account`,
3437
3994
  },
@@ -3830,6 +4387,11 @@ export const lib = {
3830
4387
  installed: (npmVersion) => `npm v${npmVersion} is installed`,
3831
4388
  unableToDetermine: 'Unable to determine if npm is installed',
3832
4389
  },
4390
+ mcpChecks: {
4391
+ configured: (clients) => `HubSpot MCP server configured in ${clients.join(', ')}`,
4392
+ notConfigured: (clients) => `HubSpot MCP server not configured in ${clients.join(', ')}`,
4393
+ notConfiguredSecondary: `Run ${uiCommandReference('hs mcp setup')} to connect AI coding tools to HubSpot developer context`,
4394
+ },
3833
4395
  hsChecks: {
3834
4396
  notLatest: (hsVersion) => `Version ${hsVersion} outdated`,
3835
4397
  notLatestSecondary: (command, hsVersion) => `Run ${uiCommandReference(command)} to upgrade to the latest version ${hsVersion}`,
@@ -3848,9 +4410,9 @@ export const lib = {
3848
4410
  validJson: 'JSON files valid',
3849
4411
  },
3850
4412
  port: {
3851
- inUse: (port) => `Port ${port} is in use`,
3852
- inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}`,
3853
- available: (port) => `Port ${port} available for local development`,
4413
+ inUse: (port) => `Default port ${port} is in use`,
4414
+ inUseSecondary: `Make sure it is available before running ${uiCommandReference('hs project dev')}, or use ${uiCommandReference('--port')} to specify a different port`,
4415
+ available: (port) => `Default port ${port} available for local development`,
3854
4416
  },
3855
4417
  projectValidation: {
3856
4418
  valid: 'Project configuration and structure is valid',
@@ -3941,6 +4503,7 @@ export const lib = {
3941
4503
  migrate: {
3942
4504
  componentsToBeMigrated: (components) => `${chalk.bold('The following features will be migrated:')} ${components}`,
3943
4505
  componentsThatWillNotBeMigrated: (components) => `[NOTE] These features are not yet supported for migration but will be available later: ${components}`,
4506
+ legacyCrmCardMigrationDocs: () => `For more information on migrating legacy-crm-card components, follow ${uiLink('these docs', 'https://developers.hubspot.com/docs/apps/developer-platform/build-apps/migrate-an-app/migrate-legacy-crm-cards-to-app-cards')}`,
3944
4507
  sourceContentsMoved: (newLocation) => `The contents of your old source directory have been moved to ${newLocation}, move any required files to the new source directory.`,
3945
4508
  projectMigrationWarningTitle: (platformVersion) => `Important: Migrating to platformVersion ${platformVersion} is irreversible`,
3946
4509
  projectMigrationWarning: (platformVersion) => uiBetaTag(`Running the ${uiCommandReference('hs project migrate')} command will permanently upgrade your project to platformVersion ${platformVersion}. This action cannot be undone. To ensure you have access to your original files, they will be copied to a new directory (archive) for safekeeping.\n\nThis command will guide you through the process, prompting you to enter the required fields and will download the new project source code into your project source directory.`, false),
@@ -3955,7 +4518,7 @@ export const lib = {
3955
4518
  doesNotExist: (account) => `Project does not exist in ${uiAccountDescription(account)}. Migrations are only supported for existing projects.`,
3956
4519
  themesAlreadyMigrated: 'This project has already been migrated to the latest platform version.',
3957
4520
  noProjectForThemesMigration: 'Theme migrations are only supported for projects. Please try again from a project directory.',
3958
- themesAndAppsNotAllowed: 'Support for migrating projects containing both themes and apps to the latest platform version is coming soon. Try again later.',
4521
+ themesAndAppsNotAllowed: 'Projects containing both themes and apps cannot be migrated together. To migrate, split the project into separate theme-only and app-only projects, then run migrate on each individually.',
3959
4522
  multipleApps: 'Multiple apps found in project, this is not allowed in 2025.2',
3960
4523
  alreadyExists: (projectName) => `A project with name ${projectName} already exists. Please choose another name.`,
3961
4524
  failedToMigrateThemes: 'Failed to migrate project themes. Please verify that your themes are properly formatted before trying again.',
@@ -4000,6 +4563,13 @@ export const lib = {
4000
4563
  copyingProjectFilesFailed: 'Unable to copy migrated project files',
4001
4564
  },
4002
4565
  },
4566
+ cms: {
4567
+ serverlessDevRuntime: {
4568
+ installStarted: (targetVersion) => `Installing serverless-dev-runtime ${targetVersion}...`,
4569
+ installSucceeded: 'serverless-dev-runtime setup complete',
4570
+ installFailed: 'Failed to install serverless-dev-runtime',
4571
+ },
4572
+ },
4003
4573
  theme: {
4004
4574
  cmsDevServerProcess: {
4005
4575
  installStarted: (targetVersion) => `Installing cms-dev-server ${targetVersion}...`,