@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
@@ -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,52 @@
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
+ async function getPersonalAccessKey(env, accountId) {
14
+ if (process.env.BROWSER !== 'none') {
15
+ try {
16
+ return await awaitPersonalAccessKeyOverWebsocket({
17
17
  env,
18
18
  account: accountId,
19
19
  });
20
+ }
21
+ catch (e) {
22
+ if (isPromptExitError(e))
23
+ throw e;
24
+ debugError(e);
25
+ }
26
+ }
27
+ const { personalAccessKey } = await legacyPersonalAccessKeyPrompt({
28
+ env,
29
+ account: accountId,
30
+ });
31
+ return personalAccessKey;
32
+ }
33
+ async function updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId, providedAccountName, useDefaultAccountName) {
34
+ try {
35
+ const personalAccessKey = providedPersonalAccessKey ?? (await getPersonalAccessKey(env, accountId));
20
36
  const token = await getAccessToken(personalAccessKey, env);
21
37
  const defaultAccountName = token.hubName
22
38
  ? toKebabCase(token.hubName)
23
39
  : undefined;
24
- const accountName = configAlreadyExists
25
- ? undefined
26
- : (await cliAccountNamePrompt(defaultAccountName)).name;
40
+ let accountName;
41
+ if (providedAccountName) {
42
+ accountName = providedAccountName;
43
+ }
44
+ else if (useDefaultAccountName && defaultAccountName) {
45
+ accountName = defaultAccountName;
46
+ }
47
+ else if (!configAlreadyExists) {
48
+ accountName = (await cliAccountNamePrompt(defaultAccountName)).name;
49
+ }
27
50
  const updatedConfig = await updateConfigWithAccessToken(token, personalAccessKey, env, accountName, !configAlreadyExists);
28
51
  if (!updatedConfig)
29
52
  return null;
@@ -37,7 +60,7 @@ async function updateConfigWithNewAccount(env, configAlreadyExists, providedPers
37
60
  return updatedConfig;
38
61
  }
39
62
  catch (e) {
40
- if (e instanceof PromptExitError) {
63
+ if (isPromptExitError(e)) {
41
64
  throw e;
42
65
  }
43
66
  debugError(e);
@@ -77,7 +100,15 @@ async function handleConfigMigration() {
77
100
  return false;
78
101
  }
79
102
  }
80
- export async function authenticateNewAccount({ env, providedPersonalAccessKey, accountId, setAsDefaultAccount, }) {
103
+ export function getCurrentDefaultAccount() {
104
+ try {
105
+ return getConfigDefaultAccountIfExists();
106
+ }
107
+ catch {
108
+ return undefined;
109
+ }
110
+ }
111
+ export async function authenticateNewAccount({ env, providedPersonalAccessKey, accountId, setAsDefaultAccount, accountName: providedAccountName, useDefaultAccountName, }) {
81
112
  const configMigrationSuccess = await handleConfigMigration();
82
113
  if (!configMigrationSuccess) {
83
114
  return null;
@@ -86,7 +117,7 @@ export async function authenticateNewAccount({ env, providedPersonalAccessKey, a
86
117
  if (!configAlreadyExists) {
87
118
  createEmptyConfigFile(true);
88
119
  }
89
- const updatedConfig = await updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId);
120
+ const updatedConfig = await updateConfigWithNewAccount(env, configAlreadyExists, providedPersonalAccessKey, accountId, providedAccountName, useDefaultAccountName);
90
121
  if (!updatedConfig) {
91
122
  uiLogger.error(commands.account.subcommands.auth.errors.failedToUpdateConfig);
92
123
  return null;
@@ -97,12 +128,15 @@ export async function authenticateNewAccount({ env, providedPersonalAccessKey, a
97
128
  uiLogger.success(commands.account.subcommands.auth.success.configFileCreated(getConfigFilePath()));
98
129
  uiLogger.success(commands.account.subcommands.auth.success.configFileUpdated(newAccountId));
99
130
  }
100
- else if (setAsDefaultAccount) {
101
- setConfigAccountAsDefault(name);
102
- uiLogger.log('');
103
- uiLogger.success(commands.account.subcommands.auth.success.configFileUpdated(newAccountId));
131
+ else if (setAsDefaultAccount === true) {
132
+ const currentDefault = getConfigDefaultAccountIfExists();
133
+ if (currentDefault?.name !== name) {
134
+ setConfigAccountAsDefault(name);
135
+ uiLogger.log('');
136
+ uiLogger.success(commands.account.subcommands.auth.success.configFileUpdated(newAccountId));
137
+ }
104
138
  }
105
- else {
139
+ else if (setAsDefaultAccount !== false) {
106
140
  await setAsDefaultAccountPrompt(name);
107
141
  }
108
142
  return updatedConfig;
@@ -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,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
+ }
@@ -0,0 +1,38 @@
1
+ import { AppLogEntry as ApiAppLogEntry, SystemType } from '@hubspot/local-dev-lib/types/AppLogs';
2
+ export declare const SYSTEM_TYPE_DISPLAY_NAMES: {
3
+ [key: string]: string;
4
+ };
5
+ export declare const SYSTEM_TYPE_CHOICES: string[];
6
+ export declare function parseSinceTime(sinceInput: string): {
7
+ startTime: number;
8
+ endTime: number;
9
+ };
10
+ export declare function transformApiLogEntry(apiLog: ApiAppLogEntry): {
11
+ id: string;
12
+ createdAt: number;
13
+ executionTimeMillis?: number;
14
+ portalId?: number;
15
+ traceId?: string;
16
+ status: 'SUCCESS' | 'ERROR';
17
+ errorType?: string;
18
+ errorMessage?: string;
19
+ };
20
+ export type AppLogsOptions = {
21
+ since?: string;
22
+ compact?: boolean;
23
+ json?: boolean;
24
+ limit?: number;
25
+ errorsOnly?: boolean;
26
+ };
27
+ export declare function toTypeChoice(systemType: string): string;
28
+ export declare function toSystemType(choice: string): string;
29
+ export declare function getTypeChoices(): {
30
+ name: string;
31
+ value: string;
32
+ }[];
33
+ export declare const handleLogsRequest: (accountId: number, appId: number, systemType: string, options: AppLogsOptions) => Promise<void>;
34
+ export declare const tailAppLogs: (accountId: number, appId: number, systemType: string, options: AppLogsOptions) => Promise<void>;
35
+ export type LogDetailsOptions = {
36
+ json?: boolean;
37
+ };
38
+ export declare const handleLogDetailsRequest: (accountId: number, appId: number, logId: string, systemType: SystemType, options: LogDetailsOptions) => Promise<void>;