@hubspot/cli 8.3.0 → 8.3.1-experimental.1

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 (859) hide show
  1. package/api/feedback.d.ts +10 -0
  2. package/api/feedback.js +9 -0
  3. package/api/migrate.js +3 -3
  4. package/api/releases.d.ts +39 -0
  5. package/api/releases.js +41 -0
  6. package/bin/cli.js +39 -8
  7. package/bin/hs.js +1 -0
  8. package/bin/hscms.js +1 -0
  9. package/bin/setupColor.d.ts +2 -0
  10. package/bin/setupColor.js +10 -0
  11. package/commands/account/auth.d.ts +6 -3
  12. package/commands/account/auth.js +49 -30
  13. package/commands/account/clean.js +7 -6
  14. package/commands/account/createOverride.js +12 -7
  15. package/commands/account/info.js +36 -17
  16. package/commands/account/link.d.ts +4 -0
  17. package/commands/account/link.js +87 -0
  18. package/commands/account/list.js +32 -76
  19. package/commands/account/remove.js +4 -3
  20. package/commands/account/removeOverride.js +13 -10
  21. package/commands/account/rename.js +5 -6
  22. package/commands/account/unlink.d.ts +4 -0
  23. package/commands/account/unlink.js +68 -0
  24. package/commands/account/use.js +79 -20
  25. package/commands/account.js +4 -0
  26. package/commands/api.d.ts +13 -0
  27. package/commands/api.js +161 -0
  28. package/commands/app/logDetails.d.ts +9 -0
  29. package/commands/app/logDetails.js +86 -0
  30. package/commands/app/logs.d.ts +13 -0
  31. package/commands/app/logs.js +126 -0
  32. package/commands/app/migrate.js +13 -13
  33. package/commands/app/secret/add.js +7 -8
  34. package/commands/app/secret/delete.js +10 -11
  35. package/commands/app/secret/list.js +7 -8
  36. package/commands/app/secret/update.js +9 -10
  37. package/commands/app/secret.js +1 -1
  38. package/commands/app.js +8 -1
  39. package/commands/auth.js +16 -15
  40. package/commands/cms/app/create.js +9 -5
  41. package/commands/cms/convertFields.js +8 -8
  42. package/commands/cms/delete.js +2 -3
  43. package/commands/cms/fetch.js +7 -7
  44. package/commands/cms/function/create.js +7 -35
  45. package/commands/cms/function/deploy.js +10 -4
  46. package/commands/cms/function/list.js +15 -7
  47. package/commands/cms/function/logs.js +19 -23
  48. package/commands/cms/function/server.js +22 -10
  49. package/commands/cms/getReactModule.js +7 -8
  50. package/commands/cms/lighthouseScore.js +26 -25
  51. package/commands/cms/lint.js +4 -5
  52. package/commands/cms/list.js +5 -6
  53. package/commands/cms/module/create.js +15 -5
  54. package/commands/cms/module/marketplace-validate.js +7 -8
  55. package/commands/cms/mv.js +2 -3
  56. package/commands/cms/template/create.js +10 -6
  57. package/commands/cms/theme/create.js +5 -5
  58. package/commands/cms/theme/generate-selectors.js +5 -4
  59. package/commands/cms/theme/marketplace-validate.js +8 -9
  60. package/commands/cms/theme/preview.js +24 -9
  61. package/commands/cms/upload.js +21 -12
  62. package/commands/cms/watch.js +7 -5
  63. package/commands/cms/webpack/create.js +7 -34
  64. package/commands/completion.js +3 -5
  65. package/commands/config/migrate.js +6 -7
  66. package/commands/config/set.js +29 -11
  67. package/commands/customObject/create.js +4 -5
  68. package/commands/customObject/createSchema.js +6 -8
  69. package/commands/customObject/deleteSchema.js +4 -5
  70. package/commands/customObject/fetchAllSchemas.js +2 -3
  71. package/commands/customObject/fetchSchema.js +2 -3
  72. package/commands/customObject/listSchemas.js +2 -3
  73. package/commands/customObject/updateSchema.js +6 -8
  74. package/commands/customObject.js +2 -2
  75. package/commands/doctor.js +8 -8
  76. package/commands/feedback.d.ts +6 -2
  77. package/commands/feedback.js +87 -11
  78. package/commands/filemanager/fetch.js +5 -6
  79. package/commands/filemanager/upload.js +5 -5
  80. package/commands/getStarted.js +38 -42
  81. package/commands/hubdb/clear.js +5 -6
  82. package/commands/hubdb/create.js +4 -5
  83. package/commands/hubdb/delete.js +8 -9
  84. package/commands/hubdb/fetch.js +5 -6
  85. package/commands/hubdb/list.d.ts +1 -1
  86. package/commands/hubdb/list.js +23 -22
  87. package/commands/init.js +20 -20
  88. package/commands/mcp/setup.d.ts +3 -0
  89. package/commands/mcp/setup.js +43 -8
  90. package/commands/mcp/start.js +2 -3
  91. package/commands/open.js +4 -5
  92. package/commands/project/add.d.ts +3 -2
  93. package/commands/project/add.js +26 -18
  94. package/commands/project/appInstallStatus.d.ts +5 -0
  95. package/commands/project/appInstallStatus.js +139 -0
  96. package/commands/project/create.d.ts +4 -2
  97. package/commands/project/create.js +64 -23
  98. package/commands/project/delete.d.ts +7 -0
  99. package/commands/project/delete.js +74 -0
  100. package/commands/project/deploy.d.ts +2 -1
  101. package/commands/project/deploy.js +72 -50
  102. package/commands/project/dev/index.d.ts +3 -3
  103. package/commands/project/dev/index.js +49 -92
  104. package/commands/project/dev/unifiedFlow.js +81 -22
  105. package/commands/project/download.d.ts +5 -2
  106. package/commands/project/download.js +77 -25
  107. package/commands/project/info.d.ts +5 -0
  108. package/commands/project/info.js +73 -0
  109. package/commands/project/installApp.d.ts +8 -0
  110. package/commands/project/installApp.js +185 -0
  111. package/commands/project/installDeps.js +17 -11
  112. package/commands/project/lint.js +57 -19
  113. package/commands/project/list.d.ts +3 -2
  114. package/commands/project/list.js +34 -15
  115. package/commands/project/listBuilds.d.ts +3 -2
  116. package/commands/project/listBuilds.js +50 -19
  117. package/commands/project/logs.js +9 -12
  118. package/commands/project/migrate.js +28 -33
  119. package/commands/project/open.js +20 -13
  120. package/commands/project/profile/add.d.ts +2 -1
  121. package/commands/project/profile/add.js +42 -13
  122. package/commands/project/profile/delete.d.ts +1 -1
  123. package/commands/project/profile/delete.js +23 -15
  124. package/commands/project/release/create.d.ts +8 -0
  125. package/commands/project/release/create.js +160 -0
  126. package/commands/project/release/info.d.ts +7 -0
  127. package/commands/project/release/info.js +148 -0
  128. package/commands/project/release/list.d.ts +7 -0
  129. package/commands/project/release/list.js +119 -0
  130. package/commands/project/release/preview.d.ts +9 -0
  131. package/commands/project/release/preview.js +167 -0
  132. package/commands/project/release.d.ts +3 -0
  133. package/commands/project/release.js +26 -0
  134. package/commands/project/updateDeps.js +15 -11
  135. package/commands/project/upload.d.ts +7 -1
  136. package/commands/project/upload.js +163 -35
  137. package/commands/project/validate.d.ts +3 -2
  138. package/commands/project/validate.js +73 -103
  139. package/commands/project/watch.js +27 -29
  140. package/commands/project.js +17 -4
  141. package/commands/sandbox/create.js +18 -18
  142. package/commands/sandbox/delete.js +16 -18
  143. package/commands/sandbox.js +1 -1
  144. package/commands/secret/addSecret.js +6 -7
  145. package/commands/secret/deleteSecret.js +5 -6
  146. package/commands/secret/listSecret.js +2 -3
  147. package/commands/secret/updateSecret.js +4 -5
  148. package/commands/testAccount/create.d.ts +3 -2
  149. package/commands/testAccount/create.js +29 -25
  150. package/commands/testAccount/createConfig.js +7 -8
  151. package/commands/testAccount/delete.js +27 -18
  152. package/commands/testAccount/importData.d.ts +1 -1
  153. package/commands/testAccount/importData.js +6 -7
  154. package/commands/upgrade.js +11 -10
  155. package/lang/en.d.ts +710 -58
  156. package/lang/en.js +909 -121
  157. package/lib/CLIWebSocketServer.d.ts +5 -3
  158. package/lib/CLIWebSocketServer.js +31 -4
  159. package/lib/accountAuth.d.ts +4 -1
  160. package/lib/accountAuth.js +65 -19
  161. package/lib/accountCredentials.d.ts +1 -0
  162. package/lib/accountCredentials.js +25 -0
  163. package/lib/accountTargetDiscovery.d.ts +15 -0
  164. package/lib/accountTargetDiscovery.js +175 -0
  165. package/lib/agentHelp.d.ts +17 -0
  166. package/lib/agentHelp.js +90 -0
  167. package/lib/api/usageTracking.d.ts +30 -0
  168. package/lib/api/usageTracking.js +11 -0
  169. package/lib/app/install.d.ts +22 -0
  170. package/lib/app/install.js +42 -0
  171. package/lib/app/logs.d.ts +38 -0
  172. package/lib/app/logs.js +225 -0
  173. package/lib/app/migrate.js +18 -15
  174. package/lib/app/urls.d.ts +2 -1
  175. package/lib/app/urls.js +6 -4
  176. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.d.ts +4 -0
  177. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.js +146 -0
  178. package/lib/buildAccount.js +4 -4
  179. package/lib/cms/serverlessDevRuntime.d.ts +1 -0
  180. package/lib/cms/serverlessDevRuntime.js +72 -0
  181. package/lib/commonOpts.js +10 -2
  182. package/lib/configOptions.d.ts +10 -10
  183. package/lib/configOptions.js +10 -11
  184. package/lib/constants.d.ts +24 -2
  185. package/lib/constants.js +33 -2
  186. package/lib/dependencyManagement.js +10 -17
  187. package/lib/doctor/Diagnosis.js +5 -5
  188. package/lib/doctor/DiagnosticInfoBuilder.d.ts +2 -2
  189. package/lib/doctor/DiagnosticInfoBuilder.js +8 -8
  190. package/lib/doctor/Doctor.d.ts +1 -0
  191. package/lib/doctor/Doctor.js +40 -16
  192. package/lib/errorHandlers/index.js +4 -3
  193. package/lib/errorHandlers/suppressError.js +7 -3
  194. package/lib/errors/ProjectErrors.d.ts +0 -6
  195. package/lib/errors/ProjectErrors.js +0 -12
  196. package/lib/errors/ProjectValidationError.d.ts +2 -1
  197. package/lib/errors/ProjectValidationError.js +3 -1
  198. package/lib/errors/PromptExitError.d.ts +4 -2
  199. package/lib/errors/PromptExitError.js +3 -0
  200. package/lib/feedback.d.ts +3 -0
  201. package/lib/feedback.js +13 -0
  202. package/lib/filesystem.d.ts +6 -0
  203. package/lib/filesystem.js +9 -0
  204. package/lib/getStartedV2Actions.js +18 -21
  205. package/lib/hasFeature.js +1 -2
  206. package/lib/importData.js +3 -4
  207. package/lib/jsonOutput/accountAuth.d.ts +7 -0
  208. package/lib/jsonOutput/accountAuth.js +6 -0
  209. package/lib/jsonOutput/projectAdd.d.ts +9 -0
  210. package/lib/jsonOutput/projectAdd.js +10 -0
  211. package/lib/jsonOutput/projectAppInstallStatus.d.ts +14 -0
  212. package/lib/jsonOutput/projectAppInstallStatus.js +14 -0
  213. package/lib/jsonOutput/projectCreate.d.ts +8 -0
  214. package/lib/jsonOutput/projectCreate.js +7 -0
  215. package/lib/jsonOutput/projectDeploy.d.ts +5 -0
  216. package/lib/jsonOutput/projectDeploy.js +4 -0
  217. package/lib/jsonOutput/projectDownload.d.ts +8 -0
  218. package/lib/jsonOutput/projectDownload.js +7 -0
  219. package/lib/jsonOutput/projectInfo.d.ts +21 -0
  220. package/lib/jsonOutput/projectInfo.js +19 -0
  221. package/lib/jsonOutput/projectInstallApp.d.ts +11 -0
  222. package/lib/jsonOutput/projectInstallApp.js +10 -0
  223. package/lib/jsonOutput/projectList.d.ts +29 -0
  224. package/lib/jsonOutput/projectList.js +28 -0
  225. package/lib/jsonOutput/projectListBuilds.d.ts +75 -0
  226. package/lib/jsonOutput/projectListBuilds.js +65 -0
  227. package/lib/jsonOutput/projectRelease.d.ts +49 -0
  228. package/lib/jsonOutput/projectRelease.js +44 -0
  229. package/lib/jsonOutput/projectUpload.d.ts +30 -0
  230. package/lib/jsonOutput/projectUpload.js +24 -0
  231. package/lib/jsonOutput/projectValidate.d.ts +36 -0
  232. package/lib/jsonOutput/projectValidate.js +20 -0
  233. package/lib/jsonOutput/testAccountCreate.d.ts +7 -0
  234. package/lib/jsonOutput/testAccountCreate.js +6 -0
  235. package/lib/link/accountTableUtils.d.ts +10 -0
  236. package/lib/link/accountTableUtils.js +39 -0
  237. package/lib/link/index.d.ts +18 -0
  238. package/lib/link/index.js +185 -0
  239. package/lib/link/linkUtils.d.ts +5 -0
  240. package/lib/link/linkUtils.js +49 -0
  241. package/lib/link/prompts.d.ts +7 -0
  242. package/lib/link/prompts.js +126 -0
  243. package/lib/link/renderLinkedAccountsTable.d.ts +2 -0
  244. package/lib/link/renderLinkedAccountsTable.js +14 -0
  245. package/lib/link/warnIfLinkedDirectory.d.ts +1 -0
  246. package/lib/link/warnIfLinkedDirectory.js +9 -0
  247. package/lib/links.js +6 -5
  248. package/lib/mcp/clients.d.ts +14 -0
  249. package/lib/mcp/clients.js +62 -0
  250. package/lib/mcp/promotion.d.ts +3 -0
  251. package/lib/mcp/promotion.js +109 -0
  252. package/lib/mcp/setup.d.ts +14 -3
  253. package/lib/mcp/setup.js +135 -55
  254. package/lib/mcp/skills.d.ts +8 -0
  255. package/lib/mcp/skills.js +64 -0
  256. package/lib/middleware/autoUpdateMiddleware.js +6 -3
  257. package/lib/middleware/commandTargetingUtils.js +1 -0
  258. package/lib/middleware/deprecationWarningMiddleware.d.ts +1 -0
  259. package/lib/middleware/deprecationWarningMiddleware.js +57 -0
  260. package/lib/npm/npmCli.d.ts +1 -0
  261. package/lib/npm/npmCli.js +13 -0
  262. package/lib/npm/packageJson.js +1 -1
  263. package/lib/process.d.ts +1 -1
  264. package/lib/process.js +10 -3
  265. package/lib/projects/ProjectLogsManager.js +7 -7
  266. package/lib/projects/add/legacyAddComponent.d.ts +2 -1
  267. package/lib/projects/add/legacyAddComponent.js +3 -0
  268. package/lib/projects/add/v2AddComponent.d.ts +2 -1
  269. package/lib/projects/add/v2AddComponent.js +7 -1
  270. package/lib/projects/archive.d.ts +8 -0
  271. package/lib/projects/archive.js +104 -0
  272. package/lib/projects/archiveDiff.d.ts +12 -0
  273. package/lib/projects/archiveDiff.js +68 -0
  274. package/lib/projects/builds.d.ts +2 -0
  275. package/lib/projects/builds.js +22 -0
  276. package/lib/projects/config.d.ts +6 -5
  277. package/lib/projects/config.js +8 -39
  278. package/lib/projects/create/index.js +2 -2
  279. package/lib/projects/create/legacy.js +2 -2
  280. package/lib/projects/create/tracking.d.ts +1 -0
  281. package/lib/projects/create/tracking.js +27 -0
  282. package/lib/projects/create/v2.js +4 -4
  283. package/lib/projects/delete.d.ts +13 -0
  284. package/lib/projects/delete.js +206 -0
  285. package/lib/projects/deploy.d.ts +1 -1
  286. package/lib/projects/deploy.js +2 -2
  287. package/lib/projects/download.d.ts +37 -0
  288. package/lib/projects/download.js +123 -0
  289. package/lib/projects/installApp.d.ts +58 -0
  290. package/lib/projects/installApp.js +283 -0
  291. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  292. package/lib/projects/localDev/AppDevModeInterface.js +36 -58
  293. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  294. package/lib/projects/localDev/DevSessionManager.js +35 -49
  295. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  296. package/lib/projects/localDev/LocalDevLogger.js +23 -5
  297. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  298. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  299. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  300. package/lib/projects/localDev/LocalDevState.js +21 -1
  301. package/lib/projects/localDev/LocalDevWatcher.js +3 -2
  302. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  303. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  304. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  305. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  306. package/lib/projects/localDev/helpers/account.js +8 -90
  307. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  308. package/lib/projects/localDev/helpers/process.js +4 -10
  309. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  310. package/lib/projects/localDev/helpers/project.js +82 -31
  311. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  312. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  313. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  314. package/lib/projects/npmAuditOnUpload.js +73 -0
  315. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  316. package/lib/projects/pollProjectBuildAndDeploy.js +7 -6
  317. package/lib/projects/preview.d.ts +7 -0
  318. package/lib/projects/preview.js +48 -0
  319. package/lib/projects/projectInfo.d.ts +5 -0
  320. package/lib/projects/projectInfo.js +82 -0
  321. package/lib/projects/projectProfiles.d.ts +3 -3
  322. package/lib/projects/projectProfiles.js +13 -20
  323. package/lib/projects/release.d.ts +4 -0
  324. package/lib/projects/release.js +90 -0
  325. package/lib/projects/ui.d.ts +1 -0
  326. package/lib/projects/ui.js +17 -3
  327. package/lib/projects/uieLinting.d.ts +23 -3
  328. package/lib/projects/uieLinting.js +134 -28
  329. package/lib/projects/upload.d.ts +19 -3
  330. package/lib/projects/upload.js +84 -16
  331. package/lib/projects/urls.d.ts +0 -1
  332. package/lib/projects/urls.js +6 -13
  333. package/lib/projects/validate.d.ts +18 -0
  334. package/lib/projects/validate.js +142 -0
  335. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  336. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  337. package/lib/projects/watch.js +4 -2
  338. package/lib/projects/workspaces.d.ts +60 -0
  339. package/lib/projects/workspaces.js +404 -0
  340. package/lib/prompts/createApiSamplePrompt.js +4 -0
  341. package/lib/prompts/importDataTestAccountSelectPrompt.js +1 -1
  342. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  343. package/lib/prompts/personalAccessKeyPrompt.js +9 -7
  344. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  345. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  346. package/lib/prompts/projectProfilePrompt.d.ts +9 -0
  347. package/lib/prompts/projectProfilePrompt.js +46 -0
  348. package/lib/prompts/projectsLogsPrompt.js +3 -0
  349. package/lib/prompts/promptUtils.js +4 -2
  350. package/lib/prompts/selectAppPrompt.js +1 -0
  351. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  352. package/lib/prompts/selectPublicAppForMigrationPrompt.js +5 -5
  353. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  354. package/lib/serverlessLogs.js +2 -2
  355. package/lib/serverlessSunset.d.ts +6 -0
  356. package/lib/serverlessSunset.js +32 -0
  357. package/lib/testUtils.d.ts +11 -1
  358. package/lib/testUtils.js +40 -2
  359. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  360. package/lib/theme/cmsDevServerProcess.js +8 -7
  361. package/lib/theme/migrate.js +1 -4
  362. package/lib/ui/SpinniesManager.d.ts +2 -0
  363. package/lib/ui/SpinniesManager.js +34 -10
  364. package/lib/ui/accountTable.d.ts +8 -0
  365. package/lib/ui/accountTable.js +67 -0
  366. package/lib/ui/appLogs.d.ts +32 -0
  367. package/lib/ui/appLogs.js +175 -0
  368. package/lib/ui/git.js +3 -3
  369. package/lib/ui/index.d.ts +8 -10
  370. package/lib/ui/index.js +46 -33
  371. package/lib/ui/spinniesUtils.d.ts +0 -1
  372. package/lib/ui/spinniesUtils.js +6 -16
  373. package/lib/ui/supportsColor.d.ts +4 -0
  374. package/lib/ui/supportsColor.js +25 -6
  375. package/lib/ui/uiMessages.d.ts +1 -0
  376. package/lib/ui/uiMessages.js +1 -0
  377. package/lib/usageTracking.d.ts +10 -20
  378. package/lib/usageTracking.js +77 -30
  379. package/lib/validation.js +16 -1
  380. package/lib/yargs/makeWrappedYargsHandler.d.ts +8 -0
  381. package/lib/yargs/makeWrappedYargsHandler.js +186 -0
  382. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  383. package/lib/yargs/makeYargsBuilder.js +33 -0
  384. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  385. package/lib/yargs/parseYargsOrExit.js +25 -0
  386. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  387. package/lib/yargs/strictEnforceBoolean.js +13 -0
  388. package/lib/yargsUtils.d.ts +3 -16
  389. package/lib/yargsUtils.js +3 -48
  390. package/mcp-server/Tool.d.ts +26 -0
  391. package/mcp-server/Tool.js +86 -0
  392. package/mcp-server/server.js +80 -3
  393. package/mcp-server/skills/hubspot-fix-build/SKILL.md +61 -0
  394. package/mcp-server/skills/hubspot-new-app/SKILL.md +84 -0
  395. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  396. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  397. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  398. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  399. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +6 -4
  400. package/mcp-server/tools/cms/HsFunctionLogsTool.js +75 -20
  401. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  402. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  403. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  404. package/mcp-server/tools/cms/HsListTool.js +14 -16
  405. package/mcp-server/tools/index.d.ts +3 -2
  406. package/mcp-server/tools/index.js +29 -23
  407. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  408. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  409. package/mcp-server/tools/project/AuthAccountTool.d.ts +19 -0
  410. package/mcp-server/tools/project/AuthAccountTool.js +109 -0
  411. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  412. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  413. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  414. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  415. package/mcp-server/tools/project/DeployProjectTool.d.ts +6 -4
  416. package/mcp-server/tools/project/DeployProjectTool.js +44 -28
  417. package/mcp-server/tools/project/DocFetchTool.d.ts +8 -3
  418. package/mcp-server/tools/project/DocFetchTool.js +61 -18
  419. package/mcp-server/tools/project/DocsSearchTool.d.ts +12 -3
  420. package/mcp-server/tools/project/DocsSearchTool.js +52 -24
  421. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  422. package/mcp-server/tools/project/FindProjectsTool.js +75 -0
  423. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +8 -4
  424. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +50 -24
  425. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +7 -3
  426. package/mcp-server/tools/project/GetApplicationInfoTool.js +28 -29
  427. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +7 -4
  428. package/mcp-server/tools/project/GetBuildLogsTool.js +27 -29
  429. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  430. package/mcp-server/tools/project/GetBuildStatusTool.js +27 -29
  431. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +7 -3
  432. package/mcp-server/tools/project/GetConfigValuesTool.js +25 -15
  433. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  434. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  435. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  436. package/mcp-server/tools/project/KnowledgeSearchTool.js +79 -0
  437. package/mcp-server/tools/project/SubmitFeedbackTool.d.ts +25 -0
  438. package/mcp-server/tools/project/SubmitFeedbackTool.js +73 -0
  439. package/mcp-server/tools/project/UploadProjectTools.d.ts +6 -4
  440. package/mcp-server/tools/project/UploadProjectTools.js +63 -42
  441. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  442. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  443. package/mcp-server/tools/project/apps.d.ts +8 -0
  444. package/mcp-server/tools/project/apps.js +7 -0
  445. package/mcp-server/tools/project/constants.d.ts +6 -2
  446. package/mcp-server/tools/project/constants.js +12 -1
  447. package/mcp-server/tools/project/productionConfirmation.d.ts +12 -0
  448. package/mcp-server/tools/project/productionConfirmation.js +45 -0
  449. package/mcp-server/tools/project/resolveAccount.d.ts +15 -0
  450. package/mcp-server/tools/project/resolveAccount.js +60 -0
  451. package/mcp-server/types.d.ts +3 -8
  452. package/mcp-server/types.js +1 -13
  453. package/mcp-server/utils/command.d.ts +26 -2
  454. package/mcp-server/utils/command.js +95 -16
  455. package/mcp-server/utils/config.js +6 -0
  456. package/mcp-server/utils/content.d.ts +3 -2
  457. package/mcp-server/utils/content.js +6 -1
  458. package/mcp-server/utils/elicitSelection.d.ts +11 -0
  459. package/mcp-server/utils/elicitSelection.js +25 -0
  460. package/mcp-server/utils/elicitation.d.ts +11 -0
  461. package/mcp-server/utils/elicitation.js +38 -0
  462. package/mcp-server/utils/errors.d.ts +1 -0
  463. package/mcp-server/utils/errors.js +9 -0
  464. package/mcp-server/utils/feedbackTracking.js +3 -1
  465. package/mcp-server/utils/json.d.ts +3 -0
  466. package/mcp-server/utils/json.js +29 -0
  467. package/mcp-server/utils/logger.d.ts +13 -0
  468. package/mcp-server/utils/logger.js +59 -0
  469. package/mcp-server/utils/toolUsageTracking.js +28 -11
  470. package/package.json +41 -32
  471. package/types/AccountTargets.d.ts +37 -0
  472. package/types/AccountTargets.js +12 -0
  473. package/types/Link.d.ts +32 -0
  474. package/types/Link.js +5 -0
  475. package/types/LocalDev.d.ts +15 -2
  476. package/types/PackageJson.d.ts +1 -0
  477. package/types/ProjectComponents.d.ts +2 -1
  478. package/types/Projects.d.ts +25 -5
  479. package/types/Prompts.d.ts +1 -0
  480. package/types/Yargs.d.ts +23 -2
  481. package/ui/components/ActionSection.d.ts +1 -1
  482. package/ui/components/InputField.d.ts +1 -1
  483. package/ui/components/SelectInput.d.ts +1 -1
  484. package/ui/components/StatusIcon.d.ts +1 -1
  485. package/ui/components/Table.d.ts +13 -13
  486. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  487. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  488. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  489. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  490. package/api/__tests__/migrate.test.d.ts +0 -1
  491. package/api/__tests__/migrate.test.js +0 -199
  492. package/commands/__tests__/account.test.d.ts +0 -1
  493. package/commands/__tests__/account.test.js +0 -69
  494. package/commands/__tests__/auth.test.d.ts +0 -1
  495. package/commands/__tests__/auth.test.js +0 -43
  496. package/commands/__tests__/cms.test.d.ts +0 -1
  497. package/commands/__tests__/cms.test.js +0 -87
  498. package/commands/__tests__/config.test.d.ts +0 -1
  499. package/commands/__tests__/config.test.js +0 -44
  500. package/commands/__tests__/customObject.test.d.ts +0 -1
  501. package/commands/__tests__/customObject.test.js +0 -68
  502. package/commands/__tests__/doctor.test.d.ts +0 -1
  503. package/commands/__tests__/doctor.test.js +0 -132
  504. package/commands/__tests__/feedback.test.d.ts +0 -1
  505. package/commands/__tests__/feedback.test.js +0 -24
  506. package/commands/__tests__/filemanager.test.d.ts +0 -1
  507. package/commands/__tests__/filemanager.test.js +0 -45
  508. package/commands/__tests__/getStarted.test.d.ts +0 -1
  509. package/commands/__tests__/getStarted.test.js +0 -173
  510. package/commands/__tests__/hubdb.test.d.ts +0 -1
  511. package/commands/__tests__/hubdb.test.js +0 -50
  512. package/commands/__tests__/init.test.d.ts +0 -1
  513. package/commands/__tests__/init.test.js +0 -42
  514. package/commands/__tests__/mcp.test.d.ts +0 -1
  515. package/commands/__tests__/mcp.test.js +0 -46
  516. package/commands/__tests__/open.test.d.ts +0 -1
  517. package/commands/__tests__/open.test.js +0 -58
  518. package/commands/__tests__/project.test.d.ts +0 -1
  519. package/commands/__tests__/project.test.js +0 -125
  520. package/commands/__tests__/sandbox.test.d.ts +0 -1
  521. package/commands/__tests__/sandbox.test.js +0 -44
  522. package/commands/__tests__/secret.test.d.ts +0 -1
  523. package/commands/__tests__/secret.test.js +0 -49
  524. package/commands/__tests__/testAccount.test.d.ts +0 -1
  525. package/commands/__tests__/testAccount.test.js +0 -57
  526. package/commands/__tests__/upgrade.test.d.ts +0 -1
  527. package/commands/__tests__/upgrade.test.js +0 -309
  528. package/commands/account/__tests__/auth.test.d.ts +0 -1
  529. package/commands/account/__tests__/auth.test.js +0 -206
  530. package/commands/account/__tests__/clean.test.d.ts +0 -1
  531. package/commands/account/__tests__/clean.test.js +0 -28
  532. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  533. package/commands/account/__tests__/createOverride.test.js +0 -32
  534. package/commands/account/__tests__/info.test.d.ts +0 -1
  535. package/commands/account/__tests__/info.test.js +0 -28
  536. package/commands/account/__tests__/list.test.d.ts +0 -1
  537. package/commands/account/__tests__/list.test.js +0 -153
  538. package/commands/account/__tests__/remove.test.d.ts +0 -1
  539. package/commands/account/__tests__/remove.test.js +0 -36
  540. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  541. package/commands/account/__tests__/removeOverride.js +0 -25
  542. package/commands/account/__tests__/rename.test.d.ts +0 -1
  543. package/commands/account/__tests__/rename.test.js +0 -82
  544. package/commands/account/__tests__/use.test.d.ts +0 -1
  545. package/commands/account/__tests__/use.test.js +0 -170
  546. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  547. package/commands/app/__tests__/migrate.test.js +0 -111
  548. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  549. package/commands/app/secret/__tests__/add.test.js +0 -140
  550. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  551. package/commands/app/secret/__tests__/delete.test.js +0 -28
  552. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  553. package/commands/app/secret/__tests__/list.test.js +0 -25
  554. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  555. package/commands/app/secret/__tests__/update.test.js +0 -28
  556. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  557. package/commands/cms/__tests__/delete.test.js +0 -39
  558. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  559. package/commands/cms/__tests__/fetch.test.js +0 -156
  560. package/commands/cms/__tests__/function.test.d.ts +0 -1
  561. package/commands/cms/__tests__/function.test.js +0 -50
  562. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  563. package/commands/cms/__tests__/lint.test.js +0 -33
  564. package/commands/cms/__tests__/list.test.d.ts +0 -1
  565. package/commands/cms/__tests__/list.test.js +0 -42
  566. package/commands/cms/__tests__/module.test.d.ts +0 -1
  567. package/commands/cms/__tests__/module.test.js +0 -45
  568. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  569. package/commands/cms/__tests__/mv.test.js +0 -46
  570. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  571. package/commands/cms/__tests__/theme.test.js +0 -54
  572. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  573. package/commands/cms/__tests__/upload.test.js +0 -312
  574. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  575. package/commands/cms/__tests__/watch.test.js +0 -204
  576. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  577. package/commands/cms/function/__tests__/logs.test.js +0 -70
  578. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  579. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  580. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  581. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  582. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  583. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  584. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  585. package/commands/customObject/__tests__/create.test.js +0 -40
  586. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  587. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  588. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  589. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  590. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  591. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  592. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  593. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  594. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  595. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  596. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  597. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  598. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  599. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  600. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  601. package/commands/filemanager/__tests__/upload.test.js +0 -191
  602. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  603. package/commands/hubdb/__tests__/clear.test.js +0 -28
  604. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  605. package/commands/hubdb/__tests__/create.test.js +0 -28
  606. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  607. package/commands/hubdb/__tests__/delete.test.js +0 -28
  608. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  609. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  610. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  611. package/commands/hubdb/__tests__/list.test.js +0 -88
  612. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  613. package/commands/mcp/__tests__/setup.test.js +0 -26
  614. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  615. package/commands/mcp/__tests__/start.test.js +0 -144
  616. package/commands/project/__tests__/add.test.d.ts +0 -1
  617. package/commands/project/__tests__/add.test.js +0 -107
  618. package/commands/project/__tests__/create.test.d.ts +0 -1
  619. package/commands/project/__tests__/create.test.js +0 -97
  620. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  621. package/commands/project/__tests__/deploy.test.js +0 -307
  622. package/commands/project/__tests__/dev.test.d.ts +0 -1
  623. package/commands/project/__tests__/dev.test.js +0 -273
  624. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  625. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  626. package/commands/project/__tests__/download.test.d.ts +0 -1
  627. package/commands/project/__tests__/download.test.js +0 -39
  628. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  629. package/commands/project/__tests__/installDeps.test.js +0 -140
  630. package/commands/project/__tests__/lint.test.d.ts +0 -1
  631. package/commands/project/__tests__/lint.test.js +0 -704
  632. package/commands/project/__tests__/list.test.d.ts +0 -1
  633. package/commands/project/__tests__/list.test.js +0 -31
  634. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  635. package/commands/project/__tests__/listBuilds.test.js +0 -38
  636. package/commands/project/__tests__/logs.test.d.ts +0 -1
  637. package/commands/project/__tests__/logs.test.js +0 -202
  638. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  639. package/commands/project/__tests__/migrate.test.js +0 -106
  640. package/commands/project/__tests__/open.test.d.ts +0 -1
  641. package/commands/project/__tests__/open.test.js +0 -39
  642. package/commands/project/__tests__/profile.test.d.ts +0 -1
  643. package/commands/project/__tests__/profile.test.js +0 -42
  644. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  645. package/commands/project/__tests__/updateDeps.test.js +0 -140
  646. package/commands/project/__tests__/upload.test.d.ts +0 -1
  647. package/commands/project/__tests__/upload.test.js +0 -234
  648. package/commands/project/__tests__/validate.test.d.ts +0 -1
  649. package/commands/project/__tests__/validate.test.js +0 -381
  650. package/commands/project/__tests__/watch.test.d.ts +0 -1
  651. package/commands/project/__tests__/watch.test.js +0 -35
  652. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  653. package/commands/project/dev/deprecatedFlow.js +0 -135
  654. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  655. package/commands/sandbox/__tests__/create.test.js +0 -198
  656. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  657. package/commands/sandbox/__tests__/delete.test.js +0 -31
  658. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  659. package/commands/secret/__tests__/addSecret.test.js +0 -162
  660. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  661. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  662. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  663. package/commands/secret/__tests__/listSecret.test.js +0 -29
  664. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  665. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  666. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  667. package/commands/testAccount/__tests__/create.test.js +0 -106
  668. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  669. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  670. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  671. package/commands/testAccount/__tests__/delete.test.js +0 -29
  672. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  673. package/commands/testAccount/__tests__/importData.test.js +0 -92
  674. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  675. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  676. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  677. package/lib/__tests__/accountAuth.test.js +0 -258
  678. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  679. package/lib/__tests__/accountTypes.test.js +0 -98
  680. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  681. package/lib/__tests__/buildAccount.test.js +0 -211
  682. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  683. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  684. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  685. package/lib/__tests__/commandSuggestion.test.js +0 -121
  686. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  687. package/lib/__tests__/commonOpts.test.js +0 -80
  688. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  689. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  690. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  691. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  692. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  693. package/lib/__tests__/hasFeature.test.js +0 -167
  694. package/lib/__tests__/http.test.d.ts +0 -1
  695. package/lib/__tests__/http.test.js +0 -40
  696. package/lib/__tests__/importData.test.d.ts +0 -1
  697. package/lib/__tests__/importData.test.js +0 -98
  698. package/lib/__tests__/npmCli.test.d.ts +0 -1
  699. package/lib/__tests__/npmCli.test.js +0 -84
  700. package/lib/__tests__/oauth.test.d.ts +0 -1
  701. package/lib/__tests__/oauth.test.js +0 -109
  702. package/lib/__tests__/parsing.test.d.ts +0 -1
  703. package/lib/__tests__/parsing.test.js +0 -34
  704. package/lib/__tests__/polling.test.d.ts +0 -1
  705. package/lib/__tests__/polling.test.js +0 -76
  706. package/lib/__tests__/process.test.d.ts +0 -1
  707. package/lib/__tests__/process.test.js +0 -89
  708. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  709. package/lib/__tests__/sandboxes.test.js +0 -128
  710. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  711. package/lib/__tests__/serverlessLogs.test.js +0 -163
  712. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  713. package/lib/__tests__/usageTracking.test.js +0 -197
  714. package/lib/__tests__/validation.test.d.ts +0 -1
  715. package/lib/__tests__/validation.test.js +0 -143
  716. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  717. package/lib/__tests__/yargsUtils.test.js +0 -124
  718. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  719. package/lib/app/__tests__/migrate.test.js +0 -638
  720. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  721. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  722. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  723. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  724. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  725. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  726. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  727. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  728. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  729. package/lib/mcp/__tests__/setup.test.js +0 -523
  730. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  731. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  732. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  733. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  734. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  735. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  736. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  737. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  738. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  739. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  740. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  741. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  742. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  743. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  744. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  745. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  746. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  747. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  748. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  749. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  750. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  751. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  752. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  753. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  754. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  755. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  756. package/lib/projects/__tests__/components.test.d.ts +0 -1
  757. package/lib/projects/__tests__/components.test.js +0 -440
  758. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  759. package/lib/projects/__tests__/deploy.test.js +0 -231
  760. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  761. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  762. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  763. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  764. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  765. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  766. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  767. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  768. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  769. package/lib/projects/__tests__/projects.test.js +0 -58
  770. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  771. package/lib/projects/__tests__/structure.test.js +0 -210
  772. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  773. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  774. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  775. package/lib/projects/__tests__/upload.test.js +0 -183
  776. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  777. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  778. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  779. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  780. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  781. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  782. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  783. package/lib/projects/create/__tests__/v2.test.js +0 -257
  784. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  785. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  786. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  787. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  788. package/lib/projects/platformVersion.d.ts +0 -9
  789. package/lib/projects/platformVersion.js +0 -39
  790. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  791. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  792. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  793. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  794. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  795. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  796. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  797. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  798. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  799. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  800. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  801. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  802. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  803. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  804. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  805. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  806. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  807. package/lib/theme/__tests__/migrate.test.js +0 -247
  808. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  809. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  810. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  811. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  812. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +0 -24
  813. package/mcp-server/tools/cms/HsCreateFunctionTool.js +0 -105
  814. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  815. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  816. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  817. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  818. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  819. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  820. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  821. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  822. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  823. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  824. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  825. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  826. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  827. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  828. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  829. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  830. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  831. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  832. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  833. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  834. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  835. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  836. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  837. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  838. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  839. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  840. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  841. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  842. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  843. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  844. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  845. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  846. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  847. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  848. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  849. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  850. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  851. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  852. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  853. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  854. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  855. package/mcp-server/utils/__tests__/command.test.js +0 -275
  856. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  857. package/mcp-server/utils/__tests__/content.test.js +0 -164
  858. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  859. package/mcp-server/utils/__tests__/feedbackTracking.test.js +0 -69
@@ -5,11 +5,11 @@ export type CLIWebSocketMessage = {
5
5
  };
6
6
  declare class CLIWebSocketServer {
7
7
  private server?;
8
- private instanceId;
8
+ private instanceId?;
9
9
  private logPrefix?;
10
10
  private debug?;
11
11
  constructor({ instanceId, logPrefix, debug, }: {
12
- instanceId: string;
12
+ instanceId?: string;
13
13
  logPrefix?: string;
14
14
  debug?: boolean;
15
15
  });
@@ -17,12 +17,14 @@ declare class CLIWebSocketServer {
17
17
  private logError;
18
18
  sendMessage(websocket: WebSocket, message: CLIWebSocketMessage): void;
19
19
  private sendCliMetadata;
20
+ private bindPortManagerPort;
21
+ private bindEphemeralPort;
20
22
  start({ onConnection, onMessage, onClose, metadata, }: {
21
23
  onConnection?: (websocket: WebSocket) => void;
22
24
  onMessage?: (websocket: WebSocket, message: CLIWebSocketMessage) => boolean;
23
25
  onClose?: () => void;
24
26
  metadata?: Record<string, unknown>;
25
- }): Promise<void>;
27
+ }): Promise<number>;
26
28
  shutdown(): void;
27
29
  }
28
30
  export default CLIWebSocketServer;
@@ -39,14 +39,40 @@ class CLIWebSocketServer {
39
39
  },
40
40
  });
41
41
  }
42
- async start({ onConnection, onMessage, onClose, metadata, }) {
42
+ async bindPortManagerPort(instanceId) {
43
43
  const portManagerIsRunning = await isPortManagerServerRunning();
44
44
  if (!portManagerIsRunning) {
45
45
  throw new Error(lib.CLIWebsocketServer.errors.portManagerNotRunning(this.logPrefix));
46
46
  }
47
- const portData = await requestPorts([{ instanceId: this.instanceId }]);
48
- const port = portData[this.instanceId];
49
- this.server = new WebSocketServer({ port });
47
+ const portData = await requestPorts([{ instanceId }]);
48
+ const port = portData[instanceId];
49
+ return { server: new WebSocketServer({ port }), port };
50
+ }
51
+ async bindEphemeralPort() {
52
+ const server = new WebSocketServer({ port: 0 });
53
+ await new Promise((resolve, reject) => {
54
+ const onListening = () => {
55
+ server.off('error', onError);
56
+ resolve();
57
+ };
58
+ const onError = (err) => {
59
+ server.off('listening', onListening);
60
+ reject(err);
61
+ };
62
+ server.once('listening', onListening);
63
+ server.once('error', onError);
64
+ });
65
+ const address = server.address();
66
+ if (!address || typeof address !== 'object') {
67
+ throw new Error(lib.CLIWebsocketServer.errors.failedToBindEphemeralPort(this.logPrefix));
68
+ }
69
+ return { server, port: address.port };
70
+ }
71
+ async start({ onConnection, onMessage, onClose, metadata, }) {
72
+ const { server, port } = this.instanceId
73
+ ? await this.bindPortManagerPort(this.instanceId)
74
+ : await this.bindEphemeralPort();
75
+ this.server = server;
50
76
  this.log(lib.CLIWebsocketServer.logs.startup(port));
51
77
  this.server.on('connection', (ws, req) => {
52
78
  const origin = req.headers.origin;
@@ -82,6 +108,7 @@ class CLIWebSocketServer {
82
108
  onClose();
83
109
  }
84
110
  });
111
+ return port;
85
112
  }
86
113
  shutdown() {
87
114
  this.server?.close();
@@ -1,10 +1,13 @@
1
1
  import { Environment } from '@hubspot/local-dev-lib/types/Accounts';
2
2
  import { HubSpotConfigAccount } from '@hubspot/local-dev-lib/types/Accounts';
3
+ export declare function getCurrentDefaultAccount(): HubSpotConfigAccount | undefined;
3
4
  type AuthenticateNewAccountOptions = {
4
5
  env: Environment;
5
6
  providedPersonalAccessKey?: string;
6
7
  accountId?: number;
7
8
  setAsDefaultAccount?: boolean;
9
+ accountName?: string;
10
+ useDefaultAccountName?: boolean;
8
11
  };
9
- export declare function authenticateNewAccount({ env, providedPersonalAccessKey, accountId, setAsDefaultAccount, }: AuthenticateNewAccountOptions): Promise<HubSpotConfigAccount | null>;
12
+ export declare function authenticateNewAccount({ env, providedPersonalAccessKey, accountId, setAsDefaultAccount, accountName: providedAccountName, useDefaultAccountName, }: AuthenticateNewAccountOptions): Promise<HubSpotConfigAccount | null>;
10
13
  export {};
@@ -1,29 +1,59 @@
1
- import { updateConfigAccount, createEmptyConfigFile, getConfigFilePath, localConfigFileExists, globalConfigFileExists, setConfigAccountAsDefault, } from '@hubspot/local-dev-lib/config';
1
+ import { updateConfigAccount, createEmptyConfigFile, getConfigFilePath, localConfigFileExists, globalConfigFileExists, setConfigAccountAsDefault, getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
2
2
  import { getAccessToken, updateConfigWithAccessToken, } from '@hubspot/local-dev-lib/personalAccessKey';
3
3
  import { toKebabCase } from '@hubspot/local-dev-lib/text';
4
4
  import { handleMerge, handleMigration } from './configMigrate.js';
5
5
  import { debugError, logError } from './errorHandlers/index.js';
6
- import { PromptExitError } from './errors/PromptExitError.js';
7
- import { personalAccessKeyPrompt } from './prompts/personalAccessKeyPrompt.js';
6
+ import { isPromptExitError } from './errors/PromptExitError.js';
7
+ import { legacyPersonalAccessKeyPrompt } from './prompts/personalAccessKeyPrompt.js';
8
8
  import { cliAccountNamePrompt } from './prompts/accountNamePrompt.js';
9
9
  import { setAsDefaultAccountPrompt } from './prompts/setAsDefaultAccountPrompt.js';
10
+ import { awaitPersonalAccessKeyOverWebsocket } from './auth/awaitPersonalAccessKeyOverWebsocket.js';
10
11
  import { commands } from '../lang/en.js';
11
12
  import { uiLogger } from './ui/logger.js';
12
- async function updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId) {
13
- try {
14
- const { personalAccessKey } = providedPersonalAccessKey
15
- ? { personalAccessKey: providedPersonalAccessKey }
16
- : await personalAccessKeyPrompt({
13
+ const WHITESPACE_PATTERN = /\s/;
14
+ function getAccountNameError(accountName) {
15
+ if (!accountName || !WHITESPACE_PATTERN.test(accountName)) {
16
+ return undefined;
17
+ }
18
+ return commands.account.subcommands.auth.errors.accountNameContainsSpaces(accountName, toKebabCase(accountName) || undefined);
19
+ }
20
+ async function getPersonalAccessKey(env, accountId) {
21
+ if (process.env.BROWSER !== 'none') {
22
+ try {
23
+ return await awaitPersonalAccessKeyOverWebsocket({
17
24
  env,
18
25
  account: accountId,
19
26
  });
27
+ }
28
+ catch (e) {
29
+ if (isPromptExitError(e))
30
+ throw e;
31
+ debugError(e);
32
+ }
33
+ }
34
+ const { personalAccessKey } = await legacyPersonalAccessKeyPrompt({
35
+ env,
36
+ account: accountId,
37
+ });
38
+ return personalAccessKey;
39
+ }
40
+ async function updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId, providedAccountName, useDefaultAccountName) {
41
+ try {
42
+ const personalAccessKey = providedPersonalAccessKey ?? (await getPersonalAccessKey(env, accountId));
20
43
  const token = await getAccessToken(personalAccessKey, env);
21
44
  const defaultAccountName = token.hubName
22
45
  ? toKebabCase(token.hubName)
23
46
  : undefined;
24
- const accountName = configAlreadyExists
25
- ? undefined
26
- : (await cliAccountNamePrompt(defaultAccountName)).name;
47
+ let accountName;
48
+ if (providedAccountName) {
49
+ accountName = providedAccountName;
50
+ }
51
+ else if (useDefaultAccountName && defaultAccountName) {
52
+ accountName = defaultAccountName;
53
+ }
54
+ else if (!configAlreadyExists) {
55
+ accountName = (await cliAccountNamePrompt(defaultAccountName)).name;
56
+ }
27
57
  const updatedConfig = await updateConfigWithAccessToken(token, personalAccessKey, env, accountName, !configAlreadyExists);
28
58
  if (!updatedConfig)
29
59
  return null;
@@ -37,7 +67,7 @@ async function updateConfigWithNewAccount(env, configAlreadyExists, providedPers
37
67
  return updatedConfig;
38
68
  }
39
69
  catch (e) {
40
- if (e instanceof PromptExitError) {
70
+ if (isPromptExitError(e)) {
41
71
  throw e;
42
72
  }
43
73
  debugError(e);
@@ -77,7 +107,20 @@ async function handleConfigMigration() {
77
107
  return false;
78
108
  }
79
109
  }
80
- export async function authenticateNewAccount({ env, providedPersonalAccessKey, accountId, setAsDefaultAccount, }) {
110
+ export function getCurrentDefaultAccount() {
111
+ try {
112
+ return getConfigDefaultAccountIfExists();
113
+ }
114
+ catch {
115
+ return undefined;
116
+ }
117
+ }
118
+ export async function authenticateNewAccount({ env, providedPersonalAccessKey, accountId, setAsDefaultAccount, accountName: providedAccountName, useDefaultAccountName, }) {
119
+ const accountNameError = getAccountNameError(providedAccountName);
120
+ if (accountNameError) {
121
+ uiLogger.error(accountNameError);
122
+ return null;
123
+ }
81
124
  const configMigrationSuccess = await handleConfigMigration();
82
125
  if (!configMigrationSuccess) {
83
126
  return null;
@@ -86,7 +129,7 @@ export async function authenticateNewAccount({ env, providedPersonalAccessKey, a
86
129
  if (!configAlreadyExists) {
87
130
  createEmptyConfigFile(true);
88
131
  }
89
- const updatedConfig = await updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId);
132
+ const updatedConfig = await updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId, providedAccountName, useDefaultAccountName);
90
133
  if (!updatedConfig) {
91
134
  uiLogger.error(commands.account.subcommands.auth.errors.failedToUpdateConfig);
92
135
  return null;
@@ -97,12 +140,15 @@ export async function authenticateNewAccount({ env, providedPersonalAccessKey, a
97
140
  uiLogger.success(commands.account.subcommands.auth.success.configFileCreated(getConfigFilePath()));
98
141
  uiLogger.success(commands.account.subcommands.auth.success.configFileUpdated(newAccountId));
99
142
  }
100
- else if (setAsDefaultAccount) {
101
- setConfigAccountAsDefault(name);
102
- uiLogger.log('');
103
- uiLogger.success(commands.account.subcommands.auth.success.configFileUpdated(newAccountId));
143
+ else if (setAsDefaultAccount === true) {
144
+ const currentDefault = getConfigDefaultAccountIfExists();
145
+ if (currentDefault?.name !== name) {
146
+ setConfigAccountAsDefault(name);
147
+ uiLogger.log('');
148
+ uiLogger.success(commands.account.subcommands.auth.success.configFileUpdated(newAccountId));
149
+ }
104
150
  }
105
- else {
151
+ else if (setAsDefaultAccount !== false) {
106
152
  await setAsDefaultAccountPrompt(name);
107
153
  }
108
154
  return updatedConfig;
@@ -0,0 +1 @@
1
+ export declare function getConfigCredentials(): string[];
@@ -0,0 +1,25 @@
1
+ import { getAllConfigAccounts } from '@hubspot/local-dev-lib/config';
2
+ import { API_KEY_AUTH_METHOD, OAUTH_AUTH_METHOD, PERSONAL_ACCESS_KEY_AUTH_METHOD, } from '@hubspot/local-dev-lib/constants/auth';
3
+ function getAccountCredentials(account) {
4
+ if (account.authType === API_KEY_AUTH_METHOD.value) {
5
+ return [account.apiKey];
6
+ }
7
+ const { accessToken, refreshToken } = account.auth?.tokenInfo ?? {};
8
+ if (account.authType === PERSONAL_ACCESS_KEY_AUTH_METHOD.value) {
9
+ return [account.personalAccessKey, accessToken, refreshToken];
10
+ }
11
+ if (account.authType === OAUTH_AUTH_METHOD.value) {
12
+ return [account.auth.clientSecret, accessToken, refreshToken];
13
+ }
14
+ return [accessToken, refreshToken];
15
+ }
16
+ export function getConfigCredentials() {
17
+ try {
18
+ return getAllConfigAccounts()
19
+ .flatMap(getAccountCredentials)
20
+ .filter((credential) => Boolean(credential));
21
+ }
22
+ catch {
23
+ return [];
24
+ }
25
+ }
@@ -0,0 +1,15 @@
1
+ import { DiscoverAccountTargetsOptions, DiscoverAccountTargetsResult } from '../types/AccountTargets.js';
2
+ /**
3
+ * Discovers the candidate target accounts for a command, plus the recommended
4
+ * one to use when a single account is the obvious choice.
5
+ *
6
+ * Profiles take precedence: when the project defines profiles, the candidates
7
+ * are the profile accounts only. Otherwise they are ranked explicit account,
8
+ * then env config, then linked directory, then global default.
9
+ *
10
+ * Takes plain options (not yargs argv) and never prompts or exits, so both the
11
+ * CLI and MCP can call it. `recommended` is omitted when no account is the
12
+ * obvious choice (for example, several profiles). Throws when an explicit
13
+ * account is provided but not found in the config.
14
+ */
15
+ export declare function discoverAccountTargets(options?: DiscoverAccountTargetsOptions): Promise<DiscoverAccountTargetsResult>;
@@ -0,0 +1,175 @@
1
+ import path from 'path';
2
+ import { getConfigAccountIfExists, getConfigDefaultAccountIfExists, } from '@hubspot/local-dev-lib/config';
3
+ import { getHsSettingsFileIfExists } from '@hubspot/local-dev-lib/config/hsSettings';
4
+ import { ENVIRONMENT_VARIABLES } from '@hubspot/local-dev-lib/constants/config';
5
+ import { getAllHsProfiles, loadHsProfileFile, } from '@hubspot/project-parsing-lib/profiles';
6
+ import { isTestAccountOrSandbox } from './accountTypes.js';
7
+ import { isDirectoryLinked } from './link/linkUtils.js';
8
+ import { lib } from '../lang/en.js';
9
+ import { ACCOUNT_TARGET_CATEGORIES, ACCOUNT_TARGET_SELECTION_SOURCES, } from '../types/AccountTargets.js';
10
+ function categorizeAccount(account) {
11
+ if (isTestAccountOrSandbox(account)) {
12
+ return ACCOUNT_TARGET_CATEGORIES.RECOMMENDED_TESTING;
13
+ }
14
+ if (!account.accountType) {
15
+ return ACCOUNT_TARGET_CATEGORIES.UNKNOWN;
16
+ }
17
+ return ACCOUNT_TARGET_CATEGORIES.PRODUCTION_WITH_CARE;
18
+ }
19
+ function candidateFromAccount(account, source, profileName) {
20
+ return {
21
+ accountId: account.accountId,
22
+ accountName: account.name,
23
+ accountType: account.accountType,
24
+ environment: account.env || undefined,
25
+ source,
26
+ category: categorizeAccount(account),
27
+ ...(profileName ? { profileName } : {}),
28
+ };
29
+ }
30
+ function candidateFromAccountId(accountId, source, profileName) {
31
+ const account = getConfigAccountIfExists(accountId);
32
+ if (account) {
33
+ return candidateFromAccount(account, source, profileName);
34
+ }
35
+ return {
36
+ accountId,
37
+ source,
38
+ category: ACCOUNT_TARGET_CATEGORIES.UNKNOWN,
39
+ ...(profileName ? { profileName } : {}),
40
+ };
41
+ }
42
+ function dedupeByAccountId(candidates) {
43
+ const seen = new Set();
44
+ return candidates.filter(candidate => {
45
+ if (seen.has(candidate.accountId)) {
46
+ return false;
47
+ }
48
+ seen.add(candidate.accountId);
49
+ return true;
50
+ });
51
+ }
52
+ async function gatherProfileCandidates(projectDir, projectConfig) {
53
+ const projectSourceDir = path.join(projectDir, projectConfig.srcDir);
54
+ const profileNames = await getAllHsProfiles(projectSourceDir);
55
+ const candidates = [];
56
+ for (const name of profileNames) {
57
+ let profile;
58
+ try {
59
+ profile = loadHsProfileFile(projectSourceDir, name);
60
+ }
61
+ catch {
62
+ continue;
63
+ }
64
+ if (profile && profile.accountId) {
65
+ candidates.push(candidateFromAccountId(profile.accountId, ACCOUNT_TARGET_SELECTION_SOURCES.PROFILE, name));
66
+ }
67
+ }
68
+ return candidates;
69
+ }
70
+ function resolveProfileRecommendation(profileCandidates, explicitProfileName) {
71
+ if (explicitProfileName) {
72
+ return profileCandidates.find(candidate => candidate.profileName === explicitProfileName);
73
+ }
74
+ if (profileCandidates.length === 1) {
75
+ return profileCandidates[0];
76
+ }
77
+ return undefined;
78
+ }
79
+ function resolveNonProfileRecommendation({ explicitCandidate, envCandidate, linkedCandidates, linkedDefaultAccountId, defaultCandidate, }) {
80
+ if (explicitCandidate) {
81
+ return explicitCandidate;
82
+ }
83
+ if (envCandidate) {
84
+ return envCandidate;
85
+ }
86
+ if (linkedCandidates.length > 0) {
87
+ if (linkedDefaultAccountId !== undefined) {
88
+ const linkedDefault = linkedCandidates.find(candidate => candidate.accountId === linkedDefaultAccountId);
89
+ if (linkedDefault) {
90
+ return linkedDefault;
91
+ }
92
+ }
93
+ if (linkedCandidates.length === 1) {
94
+ return linkedCandidates[0];
95
+ }
96
+ return undefined;
97
+ }
98
+ return defaultCandidate;
99
+ }
100
+ /**
101
+ * Discovers the candidate target accounts for a command, plus the recommended
102
+ * one to use when a single account is the obvious choice.
103
+ *
104
+ * Profiles take precedence: when the project defines profiles, the candidates
105
+ * are the profile accounts only. Otherwise they are ranked explicit account,
106
+ * then env config, then linked directory, then global default.
107
+ *
108
+ * Takes plain options (not yargs argv) and never prompts or exits, so both the
109
+ * CLI and MCP can call it. `recommended` is omitted when no account is the
110
+ * obvious choice (for example, several profiles). Throws when an explicit
111
+ * account is provided but not found in the config.
112
+ */
113
+ export async function discoverAccountTargets(options = {}) {
114
+ const { explicitAccount, useEnv, profileName, projectDir, projectConfig } = options;
115
+ if (projectDir && projectConfig) {
116
+ const profileCandidates = await gatherProfileCandidates(projectDir, projectConfig);
117
+ if (profileCandidates.length > 0) {
118
+ return {
119
+ candidates: dedupeByAccountId(profileCandidates),
120
+ recommended: resolveProfileRecommendation(profileCandidates, profileName),
121
+ };
122
+ }
123
+ }
124
+ const envConfigActive = Boolean(useEnv) ||
125
+ process.env[ENVIRONMENT_VARIABLES.USE_ENVIRONMENT_HUBSPOT_CONFIG] ===
126
+ 'true';
127
+ const ordered = [];
128
+ let explicitCandidate;
129
+ if (explicitAccount !== undefined && explicitAccount !== '') {
130
+ const account = getConfigAccountIfExists(explicitAccount);
131
+ if (!account) {
132
+ throw new Error(lib.accountTargetDiscovery.errors.explicitAccountNotFound(explicitAccount));
133
+ }
134
+ explicitCandidate = candidateFromAccount(account, ACCOUNT_TARGET_SELECTION_SOURCES.EXPLICIT_ACCOUNT);
135
+ ordered.push(explicitCandidate);
136
+ }
137
+ let envCandidate;
138
+ if (envConfigActive) {
139
+ const envAccount = getConfigDefaultAccountIfExists();
140
+ if (envAccount) {
141
+ envCandidate = candidateFromAccount(envAccount, ACCOUNT_TARGET_SELECTION_SOURCES.ENV_CONFIG);
142
+ ordered.push(envCandidate);
143
+ }
144
+ }
145
+ const settings = getHsSettingsFileIfExists();
146
+ const directoryIsLinked = isDirectoryLinked(settings);
147
+ const linkedCandidates = [];
148
+ if (directoryIsLinked) {
149
+ for (const accountId of settings.accounts) {
150
+ const candidate = candidateFromAccountId(accountId, ACCOUNT_TARGET_SELECTION_SOURCES.LINKED_DIRECTORY);
151
+ linkedCandidates.push(candidate);
152
+ ordered.push(candidate);
153
+ }
154
+ }
155
+ let defaultCandidate;
156
+ if (!envConfigActive) {
157
+ const defaultAccount = getConfigDefaultAccountIfExists();
158
+ if (defaultAccount) {
159
+ defaultCandidate = candidateFromAccount(defaultAccount, ACCOUNT_TARGET_SELECTION_SOURCES.GLOBAL_DEFAULT);
160
+ ordered.push(defaultCandidate);
161
+ }
162
+ }
163
+ return {
164
+ candidates: dedupeByAccountId(ordered),
165
+ recommended: resolveNonProfileRecommendation({
166
+ explicitCandidate,
167
+ envCandidate,
168
+ linkedCandidates,
169
+ linkedDefaultAccountId: directoryIsLinked
170
+ ? settings.localDefaultAccount
171
+ : undefined,
172
+ defaultCandidate,
173
+ }),
174
+ };
175
+ }
@@ -0,0 +1,17 @@
1
+ import { Argv } from 'yargs';
2
+ type CommandModule = {
3
+ command?: string | readonly string[];
4
+ describe?: string | false;
5
+ builder?: unknown;
6
+ handler?: unknown;
7
+ };
8
+ export declare function recordCommands(instance: Argv): CommandModule[];
9
+ type VisitedCommand = {
10
+ module: CommandModule;
11
+ commandPath: string[];
12
+ usage: string;
13
+ };
14
+ export declare function walkCommands(modules: CommandModule[], visit: (command: VisitedCommand) => void, parentPath?: string[]): Promise<void>;
15
+ export declare function getRootAgentHelp(rootCommands: CommandModule[]): Promise<string>;
16
+ export declare function getCommandAgentHelp(command: string, helpText: string): string;
17
+ export {};
@@ -0,0 +1,90 @@
1
+ import yargs from 'yargs';
2
+ import { z } from 'zod';
3
+ import { lib } from '../lang/en.js';
4
+ import { indent } from './ui/index.js';
5
+ import { debugError } from './errorHandlers/index.js';
6
+ import { getJsonOutputSchema } from './yargs/makeWrappedYargsHandler.js';
7
+ const { agentHelp } = lib;
8
+ function formatSection(heading, lines) {
9
+ return [heading, ...lines.map(line => `${indent(1)}${line}`)].join('\n');
10
+ }
11
+ function formatWorkflows(workflows) {
12
+ return formatSection(agentHelp.headings.workflows, workflows.flatMap(({ title, steps }) => [
13
+ title,
14
+ ...steps.flatMap(({ command, description }, index) => [
15
+ `${indent(1)}${index + 1}. ${command}`,
16
+ `${indent(2)} ${description}`,
17
+ ]),
18
+ ]));
19
+ }
20
+ export function recordCommands(instance) {
21
+ const commands = [];
22
+ const { command } = instance;
23
+ Object.assign(instance, {
24
+ command(...args) {
25
+ const [module] = args;
26
+ if (typeof module === 'object' && module !== null) {
27
+ commands.push(module);
28
+ }
29
+ return Reflect.apply(command, instance, args);
30
+ },
31
+ });
32
+ return commands;
33
+ }
34
+ export async function walkCommands(modules, visit, parentPath = []) {
35
+ for (const module of modules) {
36
+ const [commandString = ''] = [module.command ?? []].flat();
37
+ const commandPath = [...parentPath, commandString.split(' ')[0]];
38
+ visit({
39
+ module,
40
+ commandPath,
41
+ usage: ['hs', ...parentPath, commandString].join(' '),
42
+ });
43
+ const instance = yargs([]);
44
+ const subcommands = recordCommands(instance);
45
+ try {
46
+ if (typeof module.builder === 'function') {
47
+ await module.builder(instance);
48
+ }
49
+ }
50
+ catch (e) {
51
+ debugError(e);
52
+ }
53
+ await walkCommands(subcommands, visit, commandPath);
54
+ }
55
+ }
56
+ function joinSections(sections) {
57
+ return sections.filter(Boolean).join('\n\n');
58
+ }
59
+ function formatExitCodes() {
60
+ return formatSection(agentHelp.headings.exitCodes, [agentHelp.exitCodes]);
61
+ }
62
+ export async function getRootAgentHelp(rootCommands) {
63
+ const commandLines = [];
64
+ await walkCommands(rootCommands, ({ module, usage }) => {
65
+ if (typeof module.describe === 'string') {
66
+ commandLines.push(`- ${usage}: ${module.describe.replace(/\s*\n\s*/g, ' ')}`);
67
+ }
68
+ });
69
+ return joinSections([
70
+ formatSection(agentHelp.headings.conventions, agentHelp.conventions.map(convention => `- ${convention}`)),
71
+ formatWorkflows(agentHelp.workflows),
72
+ formatSection(agentHelp.headings.commands, commandLines),
73
+ formatExitCodes(),
74
+ ]);
75
+ }
76
+ export function getCommandAgentHelp(command, helpText) {
77
+ const jsonOutputSchema = getJsonOutputSchema(command.replace(/^hs /, '').replaceAll(' ', '-'));
78
+ const workflows = agentHelp.workflows.filter(({ steps }) => steps.some(step => `${step.command} `.startsWith(`${command} `)));
79
+ return joinSections([
80
+ helpText.includes('--json') &&
81
+ formatSection(agentHelp.headings.jsonOutput, jsonOutputSchema
82
+ ? [
83
+ agentHelp.jsonOutput.schema,
84
+ ...JSON.stringify(z.toJSONSchema(jsonOutputSchema), null, 2).split('\n'),
85
+ ]
86
+ : [agentHelp.jsonOutput.noSchema]),
87
+ workflows.length > 0 && formatWorkflows(workflows),
88
+ formatExitCodes(),
89
+ ]);
90
+ }
@@ -0,0 +1,30 @@
1
+ export type ConfigType = 'local' | 'global';
2
+ export type ExecutionSource = 'ci' | 'mcp' | 'user';
3
+ export type UsageTrackingMeta = {
4
+ action?: string;
5
+ os?: string;
6
+ nodeVersion?: string;
7
+ nodeMajorVersion?: string;
8
+ version?: string;
9
+ command?: string;
10
+ authType?: string;
11
+ step?: string;
12
+ assetType?: string;
13
+ mode?: string;
14
+ type?: string | number;
15
+ file?: boolean;
16
+ successful?: boolean;
17
+ configType?: ConfigType;
18
+ executionSource?: ExecutionSource;
19
+ platformVersion?: string;
20
+ executionTime?: number;
21
+ };
22
+ export type UsageTrackingRequest = {
23
+ portalId?: number;
24
+ accountId?: number;
25
+ userId?: number;
26
+ eventName: string;
27
+ eventClass: string;
28
+ meta: UsageTrackingMeta;
29
+ };
30
+ export declare function sendUsageEvent(request: UsageTrackingRequest): Promise<void>;
@@ -0,0 +1,11 @@
1
+ import { http as unauthedHttp } from '@hubspot/local-dev-lib/http/unauthed';
2
+ const USAGE_PATH = 'local/dev/tools/proxy/v1/usage';
3
+ export async function sendUsageEvent(request) {
4
+ try {
5
+ await unauthedHttp.post({
6
+ url: USAGE_PATH,
7
+ data: request,
8
+ });
9
+ }
10
+ catch (_e) { }
11
+ }
@@ -0,0 +1,22 @@
1
+ import type { HubSpotConfigAccount } from '@hubspot/local-dev-lib/types/Accounts';
2
+ import type { IntermediateRepresentationNodeLocalDev } from '@hubspot/project-parsing-lib/translate';
3
+ import type { AppInstallationState, AppIRNode } from '../../types/ProjectComponents.js';
4
+ export type ScopeGroup = {
5
+ id: number;
6
+ name: string;
7
+ };
8
+ type CanUseStaticAuthTestAccountInstallOptions = {
9
+ accountConfig?: HubSpotConfigAccount;
10
+ appNode?: AppIRNode | null;
11
+ parentAccountId?: number;
12
+ };
13
+ export declare function getAppNodeFromProjectNodes(projectNodes: {
14
+ [key: string]: IntermediateRepresentationNodeLocalDev;
15
+ }): AppIRNode | null;
16
+ export declare function isStaticAuthApp(appNode?: AppIRNode | null): boolean;
17
+ export declare function isOAuthApp(appNode?: AppIRNode | null): boolean;
18
+ export declare function isPrivateApp(appNode?: AppIRNode | null): boolean;
19
+ export declare function isMarketplaceApp(appNode?: AppIRNode | null): boolean;
20
+ export declare function getAppInstallationState(isInstalledWithScopeGroups: boolean, previouslyAuthorizedScopeGroups: ScopeGroup[]): AppInstallationState;
21
+ export declare function canUseStaticAuthTestAccountInstall({ accountConfig, appNode, parentAccountId, }: CanUseStaticAuthTestAccountInstallOptions): boolean;
22
+ export {};
@@ -0,0 +1,42 @@
1
+ import { APP_AUTH_TYPES, APP_DISTRIBUTION_TYPES, APP_INSTALLATION_STATES, } from '../constants.js';
2
+ import { isDeveloperTestAccount, isSandbox } from '../accountTypes.js';
3
+ import { isAppIRNode } from '../projects/structure.js';
4
+ export function getAppNodeFromProjectNodes(projectNodes) {
5
+ return Object.values(projectNodes).find(isAppIRNode) || null;
6
+ }
7
+ export function isStaticAuthApp(appNode) {
8
+ return appNode?.config.auth.type.toLowerCase() === APP_AUTH_TYPES.STATIC;
9
+ }
10
+ export function isOAuthApp(appNode) {
11
+ return appNode?.config.auth.type.toLowerCase() === APP_AUTH_TYPES.OAUTH;
12
+ }
13
+ export function isPrivateApp(appNode) {
14
+ return (appNode?.config.distribution?.toLowerCase() ===
15
+ APP_DISTRIBUTION_TYPES.PRIVATE);
16
+ }
17
+ export function isMarketplaceApp(appNode) {
18
+ return (appNode?.config.distribution?.toLowerCase() ===
19
+ APP_DISTRIBUTION_TYPES.MARKETPLACE);
20
+ }
21
+ export function getAppInstallationState(isInstalledWithScopeGroups, previouslyAuthorizedScopeGroups) {
22
+ if (isInstalledWithScopeGroups) {
23
+ return APP_INSTALLATION_STATES.INSTALLED;
24
+ }
25
+ if (previouslyAuthorizedScopeGroups.length > 0) {
26
+ return APP_INSTALLATION_STATES.INSTALLED_WITH_OUTDATED_SCOPES;
27
+ }
28
+ return APP_INSTALLATION_STATES.NOT_INSTALLED;
29
+ }
30
+ export function canUseStaticAuthTestAccountInstall({ accountConfig, appNode, parentAccountId, }) {
31
+ if (!accountConfig || !isStaticAuthApp(appNode)) {
32
+ return false;
33
+ }
34
+ const accountCanUseTestInstall = isDeveloperTestAccount(accountConfig) || isSandbox(accountConfig);
35
+ if (!accountCanUseTestInstall) {
36
+ return false;
37
+ }
38
+ if (parentAccountId === undefined) {
39
+ return true;
40
+ }
41
+ return accountConfig.parentAccountId === parentAccountId;
42
+ }