@lowdefy/server-dev 7.1.0 → 7.3.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 (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -19,12 +19,12 @@ import fs from 'fs';
19
19
  import os from 'os';
20
20
  import path from 'path';
21
21
  import { Hono } from 'hono';
22
- import { jest } from '@jest/globals';
22
+ import { vi, afterAll, afterEach, expect, test } from 'vitest';
23
23
 
24
- const mockLaunch = jest.fn();
25
- jest.unstable_mockModule('playwright-core', () => ({
24
+ const mockLaunch = vi.fn();
25
+ vi.doMock('playwright-core', () => ({
26
26
  chromium: { launch: mockLaunch },
27
- selectors: { register: jest.fn(async () => {}) },
27
+ selectors: { register: vi.fn(async () => {}) },
28
28
  }));
29
29
 
30
30
  // openPage takes its browser as a parameter, so a fake one covers the cookie
@@ -56,26 +56,26 @@ afterEach(async () => {
56
56
  });
57
57
 
58
58
  function createBrowser() {
59
- const addCookies = jest.fn();
59
+ const addCookies = vi.fn();
60
60
  const page = {
61
- goto: jest.fn().mockResolvedValue(undefined),
62
- waitForFunction: jest.fn().mockResolvedValue(undefined),
61
+ goto: vi.fn().mockResolvedValue(undefined),
62
+ waitForFunction: vi.fn().mockResolvedValue(undefined),
63
63
  };
64
64
  // Like Playwright's, the context emits close once, when it first closes.
65
65
  const context = Object.assign(new EventEmitter(), {
66
66
  addCookies,
67
- newPage: jest.fn().mockResolvedValue(page),
68
- route: jest.fn().mockResolvedValue(undefined),
67
+ newPage: vi.fn().mockResolvedValue(page),
68
+ route: vi.fn().mockResolvedValue(undefined),
69
69
  });
70
70
  let closed = false;
71
- context.close = jest.fn(async () => {
71
+ context.close = vi.fn(async () => {
72
72
  if (closed) return;
73
73
  closed = true;
74
74
  context.emit('close');
75
75
  });
76
76
  openedContexts.push(context);
77
77
  return {
78
- browser: { newContext: jest.fn().mockResolvedValue(context) },
78
+ browser: { newContext: vi.fn().mockResolvedValue(context) },
79
79
  addCookies,
80
80
  context,
81
81
  page,
@@ -465,7 +465,7 @@ test('openPage aborts and records a data set journey request to the dev server p
465
465
  }
466
466
  const route = {
467
467
  request: () => ({ url: () => 'http://127.0.0.1:3001/api/page/tickets' }),
468
- abort: jest.fn(async () => {}),
468
+ abort: vi.fn(async () => {}),
469
469
  };
470
470
  await handle(route);
471
471
  expect(route.abort).toHaveBeenCalledTimes(1);
@@ -489,11 +489,27 @@ test('openPage routes nothing and records no departures without a dataCookie', a
489
489
  });
490
490
 
491
491
  test('a failed openPage closes its context, so the idle browser still closes', async () => {
492
- jest.useFakeTimers({ doNotFake: ['performance'] });
492
+ vi.useFakeTimers({
493
+ toFake: [
494
+ 'Date',
495
+ 'hrtime',
496
+ 'queueMicrotask',
497
+ 'requestAnimationFrame',
498
+ 'cancelAnimationFrame',
499
+ 'requestIdleCallback',
500
+ 'cancelIdleCallback',
501
+ 'setImmediate',
502
+ 'clearImmediate',
503
+ 'setInterval',
504
+ 'clearInterval',
505
+ 'setTimeout',
506
+ 'clearTimeout',
507
+ ],
508
+ });
493
509
  try {
494
510
  const { browser, page } = createBrowser();
495
511
  browser.isConnected = () => true;
496
- browser.close = jest.fn(async () => {});
512
+ browser.close = vi.fn(async () => {});
497
513
  mockLaunch.mockResolvedValue(browser);
498
514
  page.goto.mockRejectedValue(new Error('net::ERR_CONNECTION_REFUSED'));
499
515
 
@@ -501,13 +517,13 @@ test('a failed openPage closes its context, so the idle browser still closes', a
501
517
  await expect(
502
518
  openPage({ browser: launched, origin: 'http://localhost:3001', pageId: 'home' })
503
519
  ).rejects.toThrow('net::ERR_CONNECTION_REFUSED');
504
- jest.advanceTimersByTime(90_000);
520
+ vi.advanceTimersByTime(45_000);
505
521
  for (let i = 0; i < 5; i += 1) {
506
522
  await Promise.resolve();
507
523
  }
508
524
 
509
525
  expect(browser.close).toHaveBeenCalledTimes(1);
510
526
  } finally {
511
- jest.useRealTimers();
527
+ vi.useRealTimers();
512
528
  }
513
529
  });
@@ -17,6 +17,7 @@
17
17
  import fs from 'node:fs';
18
18
  import os from 'node:os';
19
19
  import path from 'node:path';
20
+ import { afterEach, expect, test } from 'vitest';
20
21
 
21
22
  // getBuildId reads build/buildStatus.json and build/invalidatePages from
22
23
  // process.cwd(): point it at a throwaway server directory.
@@ -17,18 +17,18 @@
17
17
  import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
- import { jest } from '@jest/globals';
21
-
22
- const mockClientErrors = jest.fn();
23
- jest.unstable_mockModule('./clientErrorStore.js', () => ({ default: { list: mockClientErrors } }));
24
- const mockServerErrors = jest.fn();
25
- jest.unstable_mockModule('./serverErrorStore.js', () => ({ default: { list: mockServerErrors } }));
26
- jest.unstable_mockModule('./getBuildId.js', () => ({ default: () => 'build-2' }));
27
- const mockGetPageBuildStatus = jest.fn(() => ({ unbuilt: 0 }));
28
- jest.unstable_mockModule('./getPageBuildStatus.js', () => ({ default: mockGetPageBuildStatus }));
20
+ import { vi, afterEach, beforeEach, describe, expect, test } from 'vitest';
21
+
22
+ const mockClientErrors = vi.fn();
23
+ vi.doMock('./clientErrorStore.js', () => ({ default: { list: mockClientErrors } }));
24
+ const mockServerErrors = vi.fn();
25
+ vi.doMock('./serverErrorStore.js', () => ({ default: { list: mockServerErrors } }));
26
+ vi.doMock('./getBuildId.js', () => ({ default: () => 'build-2' }));
27
+ const mockGetPageBuildStatus = vi.fn(() => ({ unbuilt: 0 }));
28
+ vi.doMock('./getPageBuildStatus.js', () => ({ default: mockGetPageBuildStatus }));
29
29
  const okBuild = () => ({ status: 'ok', errors: [], warnings: ['a build warning'] });
30
- const mockReadBuildArtifact = jest.fn(okBuild);
31
- jest.unstable_mockModule('./readBuildArtifact.js', () => ({ default: mockReadBuildArtifact }));
30
+ const mockReadBuildArtifact = vi.fn(okBuild);
31
+ vi.doMock('./readBuildArtifact.js', () => ({ default: mockReadBuildArtifact }));
32
32
 
33
33
  const { default: getBuildStatus } = await import('./getBuildStatus.js');
34
34
 
@@ -14,20 +14,20 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, beforeEach, expect, test } from 'vitest';
18
18
 
19
- const mockWaitForBuild = jest.fn();
20
- jest.unstable_mockModule('./waitForBuild.js', () => ({ default: mockWaitForBuild }));
21
- const mockBuildEditedPages = jest.fn();
22
- jest.unstable_mockModule('./buildEditedPages.js', () => ({ default: mockBuildEditedPages }));
23
- const mockGetBuildStatus = jest.fn(({ checked } = {}) => ({ build: { status: 'ok' }, checked }));
24
- jest.unstable_mockModule('./getBuildStatus.js', () => ({ default: mockGetBuildStatus }));
19
+ const mockWaitForBuild = vi.fn();
20
+ vi.doMock('./waitForBuild.js', () => ({ default: mockWaitForBuild }));
21
+ const mockBuildEditedPages = vi.fn();
22
+ vi.doMock('./buildEditedPages.js', () => ({ default: mockBuildEditedPages }));
23
+ const mockGetBuildStatus = vi.fn(({ checked } = {}) => ({ build: { status: 'ok' }, checked }));
24
+ vi.doMock('./getBuildStatus.js', () => ({ default: mockGetBuildStatus }));
25
25
 
26
26
  const { default: getBuildStatusAfterEdits } = await import('./getBuildStatusAfterEdits.js');
27
27
  const { default: readProxyBuildWait } = await import('./readProxyBuildWait.js');
28
28
 
29
29
  beforeEach(() => {
30
- jest.clearAllMocks();
30
+ vi.clearAllMocks();
31
31
  });
32
32
 
33
33
  test('getBuildStatusAfterEdits builds the edited pages once the edits are processed', async () => {
@@ -14,10 +14,8 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import getAppMap from '../../../lib/docs/getAppMap.js';
18
-
19
- function docsAppMapHandler(c) {
20
- return c.json(getAppMap());
17
+ function getConfigDirectory() {
18
+ return process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
21
19
  }
22
20
 
23
- export default docsAppMapHandler;
21
+ export default getConfigDirectory;
@@ -15,10 +15,13 @@
15
15
  */
16
16
  import { type } from '@lowdefy/helpers';
17
17
 
18
+ import createLogger from '../server/log/createLogger.js';
18
19
  import loadFrameworkHazards from './loadFrameworkHazards.js';
19
20
  import normalizeTypeKind from './normalizeTypeKind.js';
20
21
  import readBuildArtifact from './readBuildArtifact.js';
21
22
 
23
+ const logger = createLogger();
24
+
22
25
  // Where each kind's plugin-declared hazards land in the build: block metas
23
26
  // pick them from meta.hazards, request metas ride along whole, operators
24
27
  // get a dedicated metas artifact (they carry no other meta).
@@ -74,7 +77,7 @@ function hazardApplies({ hazard, kind, typeName, connectionId }) {
74
77
  if (type.isNone(condition)) {
75
78
  if (!warnedUnknownWhen.has(when)) {
76
79
  warnedUnknownWhen.add(when);
77
- console.warn(
80
+ logger.warn(
78
81
  `Hazard "${hazard.id}" declares unknown when condition ${JSON.stringify(
79
82
  when
80
83
  )} and was skipped.`
@@ -13,7 +13,7 @@
13
13
  See the License for the specific language governing permissions and
14
14
  limitations under the License.
15
15
  */
16
- import { jest } from '@jest/globals';
16
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
17
17
 
18
18
  import setupTestFixtures from './setupTestFixtures.mjs';
19
19
 
@@ -24,11 +24,14 @@ process.chdir(fixtureDir);
24
24
 
25
25
  // The framework list ships in @lowdefy/docs-content; mock the loader so each
26
26
  // test controls the list (and the "package not installed" case).
27
- const mockLoadFrameworkHazards = jest.fn();
28
- jest.unstable_mockModule('./loadFrameworkHazards.js', () => ({
27
+ const mockLoadFrameworkHazards = vi.fn();
28
+ vi.doMock('./loadFrameworkHazards.js', () => ({
29
29
  default: mockLoadFrameworkHazards,
30
30
  }));
31
31
 
32
+ const mockLogger = { info: vi.fn(), warn: vi.fn() };
33
+ vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
34
+
32
35
  const { default: getHazards } = await import('./getHazards.js');
33
36
 
34
37
  const frameworkHazards = [
@@ -63,12 +66,11 @@ let warnSpy;
63
66
  beforeEach(() => {
64
67
  mockLoadFrameworkHazards.mockReset();
65
68
  mockLoadFrameworkHazards.mockReturnValue(frameworkHazards);
66
- warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => {});
69
+ warnSpy = mockLogger.warn;
70
+ warnSpy.mockClear();
67
71
  });
68
72
 
69
- afterEach(() => {
70
- warnSpy.mockRestore();
71
- });
73
+ afterEach(() => {});
72
74
 
73
75
  test('getHazards returns type-attached hazards only when no framework hazard applies', () => {
74
76
  mockLoadFrameworkHazards.mockReturnValue([]);
@@ -57,7 +57,7 @@ function patternedPageLines() {
57
57
  return [
58
58
  '## Pages with path parameters',
59
59
  '',
60
- 'These pages are served at a URL pattern with placeholders. Pass `pathParams` with a value for each placeholder (e.g. `{"ticket_id": "1"}`) to `lowdefy_screenshot_page`, `lowdefy_inspect_state`, `lowdefy_eval_operator`, `lowdefy_snapshot_state` and `lowdefy_run_journey`, or as `?pathParams=` JSON on the GET routes. A live tab is read at the instance it shows without them.',
60
+ 'These pages are served at a URL pattern with placeholders. Pass `pathParams` with a value for each placeholder (e.g. `{"ticket_id": "1"}`) to `lowdefy_screenshot_page`, `lowdefy_inspect_state` and `lowdefy_run_journey`. A live tab is read at the instance it shows without them.',
61
61
  '',
62
62
  ...patterned.map((route) => `- \`${route.pageId}\`: \`${route.path}\``),
63
63
  '',
@@ -107,15 +107,17 @@ function getOverview() {
107
107
  '',
108
108
  '## How to use this (recommended order)',
109
109
  '',
110
- '1. **List what exists**: `GET /lowdefy-docs/blocks`, `/lowdefy-docs/operators`, `/lowdefy-docs/actions`, `/lowdefy-docs/connections`, `/lowdefy-docs/requests` — or the `lowdefy_list_types` MCP tool. Each entry links to its schema, examples, and doc.',
111
- '2. **Get the exact contract**: `GET /lowdefy-docs/schema/{kind}/{type}` (e.g. `/lowdefy-docs/schema/blocks/Button`) — or `lowdefy_get_schema`. JSON Schema of all properties.',
112
- '3. **See real usage**: `GET /lowdefy-docs/examples/{type}` — or `lowdefy_get_examples`. YAML examples for block types.',
113
- '4. **Read concept docs**: `GET /lowdefy-docs/content/{slug}` (e.g. `/lowdefy-docs/content/operators/_get`) — or `lowdefy_get_doc`. Start with `concepts/lowdefy-schema`, `concepts/blocks`, `concepts/events-and-actions`, `concepts/connections-and-requests`, `concepts/operators`.',
114
- '5. **Search**: `GET /lowdefy-docs/search?q=...` — or `lowdefy_search_docs`. The query is split into words and pages are ranked by how many match, title matches first. Each hit names its `source` (`core`, `plugin`, `local-plugin` or `module`), package and version; `&source=` narrows the search to one source.',
115
- '6. **Icons**: `GET /lowdefy-docs/icons?q=...` — or `lowdefy_search_icons`. Use a semantic name (`icon: edit`); otherwise use a Lucide name in PascalCase (`icon: Receipt`) found by search. Never invent a name. In HTML use `<i data-icon="edit"></i>`, `data-tooltip` and `data-popover`.',
116
- "7. **Plugin and module docs**: search and `lowdefy_get_doc` also cover the docs this app's own plugins and modules ship, local ones included: each README (`plugins/{package}`, `modules/{id}`), each `docs/*.md` file (`plugins/{package}/{file}`, `modules/{id}/{file}`), and for each module a generated page of the components, exports and vars its `module.lowdefy.yaml` declares (`modules/{id}/manifest`). `GET /lowdefy-docs/plugins` lists every installed plugin; `GET /lowdefy-docs/plugin-doc/{package}` returns all the markdown one plugin ships as one page.",
110
+ 'Agents use these through the MCP endpoint (`/lowdefy-docs/mcp`, or `lowdefy mcp` set up by `lowdefy agent-setup`).',
117
111
  '',
118
- 'A `stale` field on a JSON response, a `> STALE:` banner on markdown, or an `X-Lowdefy-Stale` header means the last build FAILED and the served build is behind the source — this answer predates your latest edits. Call `GET /lowdefy-docs/build-status` and fix the errors before trusting anything else.',
112
+ '1. **List what exists**: `lowdefy_list_types` with a kind (blocks, operators, actions, connections, requests, ...). Each entry names its package and doc slug.',
113
+ "2. **Get the exact contract**: `lowdefy_get_schema` for the JSON Schema of a type's properties.",
114
+ '3. **See real usage**: `lowdefy_get_examples` for YAML examples of a block type.',
115
+ '4. **Read concept docs**: `lowdefy_get_doc` with a slug (e.g. `operators/_get`). Start with `concepts/lowdefy-schema`, `concepts/blocks`, `concepts/events-and-actions`, `concepts/connections-and-requests`, `concepts/operators`.',
116
+ '5. **Search**: `lowdefy_search_docs`. The query is split into words and pages are ranked by how many match, title matches first. Each hit names its `source` (`core`, `plugin`, `local-plugin` or `module`), package and version; `source` narrows the search to one source.',
117
+ '6. **Icons**: `lowdefy_search_icons`. Use a semantic name (`icon: edit`); otherwise use a Lucide name in PascalCase (`icon: Receipt`) found by search. Never invent a name. In HTML use `<i data-icon="edit"></i>`, `data-tooltip` and `data-popover`.',
118
+ "7. **Plugin and module docs**: search and `lowdefy_get_doc` also cover the docs this app's own plugins and modules ship, local ones included: each README (`plugins/{package}`, `modules/{id}`), each `docs/*.md` file (`plugins/{package}/{file}`, `modules/{id}/{file}`), and for each module a generated page of the components, exports and vars its `module.lowdefy.yaml` declares (`modules/{id}/manifest`).",
119
+ '',
120
+ 'A `stale` field on a JSON response, a `> STALE:` banner on markdown, an `X-Lowdefy-Stale` header or a tool result that begins with `STALE:` means the last build FAILED and the served build is behind the source — this answer predates your latest edits. Call `GET /lowdefy-docs/build-status` (`lowdefy_build_status`) and fix the errors before trusting anything else.',
119
121
  '',
120
122
  '## The feedback loop (after every edit)',
121
123
  '',
@@ -124,56 +126,32 @@ function getOverview() {
124
126
  '1. **Check what broke**: `GET /lowdefy-docs/build-status?wait=true` — or `lowdefy_build_status` with `wait: true`, which answers once your latest edit has been processed and the pages it touched have been built. `build.status` is `ok` when the config builds and no page failed its latest build: `pages_failed` (with `build.failedPages` naming the pages) when a page failed its latest build and has not changed since, `error` when the config build fails. Then the build errors and warnings and the errors of each failed page, with source file locations, plus recent browser runtime errors. Errors from before the latest edit come apart under `earlierErrors`.',
125
127
  ' Or subscribe instead of polling: `GET /lowdefy-docs/events` streams `build`, `client_error`, `server_error` and `restart` events over SSE (MCP clients receive the same as `notifications/message` from logger `lowdefy`). A `build` event covers the config build only, so check build status for pages that fail to build.',
126
128
  '2. **Verify the page**: `GET /lowdefy-docs/page-config/{pageId}` — or `lowdefy_get_page_config`. The fully built page config, or its structured build errors.',
127
- "3. **See it rendered**: `GET /lowdefy-docs/screenshot/{pageId}` — or `lowdefy_screenshot_page`. PNG of the page in headless Chromium; `?viewportWidth=390&colorScheme=dark` (the tool's `width` and `colorScheme`) checks a phone layout in dark mode.",
128
- '4. **Verify behaviour**: `POST /lowdefy-docs/journey` `{pageId, steps, user, urlQuery, state}` — or `lowdefy_run_journey`. Drive the page headless with declarative steps (`click`, `fill`, `select`, `press`, `back`, `goto`, `email`, `as`, `wait`, `screenshot`, `expect: { state | visible | text | url | title }`) and assert what happens. `user: "none"` injects no caller, so sign-up, sign-in and invitations run through the app\'s own auth. Targets are a blockId, or `{ blockId, row, column, text, nth }` to reach the button in a grid cell, a control by its exact text, or — with `text` alone — a confirm dialog / modal footer button rendered outside every block. A failing step stops the journey and returns `passed: false` with `failure: { index, step, expected, actual, message }` and the final page `state` — data, not an error. A final state over 10000 characters comes back as `stateOmitted` (its size and top-level keys); pass `state: [paths]` for the paths you need, `true` for all of it or `false` for none.',
129
+ '3. **See it rendered**: `lowdefy_screenshot_page`. PNG of the page in headless Chromium; `width` and `colorScheme` check a phone layout in dark mode.',
130
+ '4. **Verify behaviour**: `POST /lowdefy-docs/journey` `{pageId, steps, user, urlQuery, state}` — or `lowdefy_run_journey`. Drive the page headless with declarative steps (`click`, `fill`, `select`, `press`, `back`, `goto`, `email`, `as`, `wait`, `screenshot`, `expect: { state | visible | text | url | title }`) and assert what happens. `user: "none"` injects no caller, so sign-up, sign-in and invitations run through the app\'s own auth. A failing step stops the journey and returns `passed: false` with `failure: { index, step, expected, actual, message }` and the final page `state` — data, not an error. `lowdefy_get_schema` with kind `journey-step` returns the step grammar.',
129
131
  '5. **Locate config**: `GET /lowdefy-docs/find/{id}?pageId=...` — or `lowdefy_find_config`. Which yaml file defines a page/block/request id.',
130
- '6. **Scaffold**: `lowdefy_scaffold_page` creates a canonical new page file (then register it in lowdefy.yaml).',
131
132
  '',
132
133
  '## Live state and testing',
133
134
  '',
134
- "1. **Inspect live state**: `GET /lowdefy-docs/inspect-state/{pageId}` — or `lowdefy_inspect_state`. The actual state, request results, and event log of a running page. Reads the developer's open browser tab when connected (ask them to interact, then inspect), else runs the page headless.",
135
- '2. **Evaluate operators**: `POST /lowdefy-docs/eval-operator` `{pageId, expression}` — or `lowdefy_eval_operator`. A REPL for config: run any operator expression against live page state. The operator goes in the `expression` body key (`operator` is accepted as an alias).',
136
- '3. **Run a request**: `POST /lowdefy-docs/run-request` `{pageId, requestId, payload}` — or `lowdefy_run_request`. Verify the data shape a request returns. The page is rebuilt first when it changed since its last build. Read-only types always run; writes need `cli.agentTools.allowWriteRequests: true` in lowdefy.yaml. A response over 40,000 characters is written in full to `responseFile` under `.lowdefy/responses/`; add `saveResponse: true` to always write it there.',
137
- '4. **Run an endpoint**: `POST /lowdefy-docs/run-endpoint` `{endpointId, payload, user}` — or `lowdefy_run_endpoint`. Run an Api routine headlessly and see what it returns, rejects or throws — a `:reject` comes back as `status: "reject"` with the routine\'s own error, not as a failure. Always needs `cli.agentTools.allowWriteRequests: true` (routines are not classified read-only). Add `system: true` to run a scheduled or detached-only `InternalApi` routine as a system context (no `_user`, auth not checked), the way cron does — not combinable with `user`. A large response is written to `responseFile` the same way as for a request, and `saveResponse: true` always writes it there.',
138
- '5. **Understand the app**: `GET /lowdefy-docs/app-map` — or `lowdefy_app_map`. Every page, menu, connection, endpoint, agent, and websocket in one call.',
139
- '6. **Config checkpoints**: `POST /lowdefy-docs/checkpoints` `{label}` / `POST /lowdefy-docs/checkpoints/revert` `{id}` — or `lowdefy_checkpoint` / `lowdefy_revert_checkpoint`. Snapshot config files before risky changes; revert instantly.',
140
- "7. **State checkpoints**: `POST /lowdefy-docs/state-checkpoints/snapshot` `{pageId, name}` captures live page state + request responses into .lowdefy/state-checkpoints/<name>/ (gitignored — checkpoints contain user/session data); `POST /lowdefy-docs/state-checkpoints/load` `{name, mode}` restores it — 'registry-only' mode returns a ?_checkpoint URL a human can open to test the app in that exact state. `lowdefy_checkpoint_to_mocks` converts one into e2e mocks.yaml fixtures.",
141
- '8. **Restart the server**: `POST /lowdefy-docs/restart` `{reason}` — or `lowdefy_restart` (through `lowdefy mcp`: `lowdefy_dev_start` with `restart: true`, a full process restart when the hub runs the server). Only when the server seems stuck or build-status looks stale, or after secrets a wrapper (for example infisical) injects have changed. Answers before the restart lands: then call `GET /lowdefy-docs/build-status?wait=true`, which answers once the restarted server is ready. `.env` edits and local plugin code need no restart: `.env` is watched and restarts the server, and a local plugin change rebuilds, restarting the server when the plugin has server-side types.',
142
- '',
143
- '## Visual feedback (annotation helper)',
144
- '',
145
- 'The developer can press Cmd/Ctrl+/ in the running app to point at elements, draw, and comment; the helper copies an agent-readable feedback block to their clipboard which they paste into their agent session. Pasted blocks start with "Feedback:" and carry the blockId, resolved config file:line, drawn shapes (usable as screenshot clip geometry), and recent console entries — treat them as precise UI feedback.',
135
+ "1. **Inspect live state**: `lowdefy_inspect_state`. The actual state, request results, and event log of a running page. Reads the developer's open browser tab when connected (ask them to interact, then inspect), else runs the page headless.",
136
+ '2. **Evaluate operators**: `lowdefy_inspect_state` with `expression`. A REPL for config: run any operator expression against live page state; the result names the paths it read.',
137
+ '3. **Run a request**: `lowdefy_run_request`. Verify the data shape a request returns. The page is rebuilt first when it changed since its last build. Read-only types always run; writes need `cli.agentTools.allowWriteRequests: true` in lowdefy.yaml. A response over 40,000 characters is written in full to `responseFile` under `.lowdefy/responses/`; add `saveResponse: true` to always write it there.',
138
+ '4. **Run an endpoint**: `lowdefy_run_endpoint`. Run an Api routine headlessly and see what it returns, rejects or throws — a `:reject` comes back as `status: "reject"` with the routine\'s own error, not as a failure. Always needs `cli.agentTools.allowWriteRequests: true` (routines are not classified read-only). Add `system: true` to run a scheduled or detached-only `InternalApi` routine as a system context (no `_user`, auth not checked), the way cron does — not combinable with `user`.',
139
+ '5. **Understand the app**: `lowdefy_app_map`. Every page, menu, connection, endpoint, agent, and websocket in one call.',
140
+ '6. **Restart the server**: `POST /lowdefy-docs/restart` `{reason}` — or `lowdefy_restart` (through `lowdefy mcp`: `lowdefy_dev_start` with `restart: true`, a full process restart when the hub runs the server). Only when the server seems stuck or build-status looks stale, or after secrets a wrapper (for example infisical) injects have changed. Answers before the restart lands: then call `GET /lowdefy-docs/build-status?wait=true`, which answers once the restarted server is ready. `.env` edits and local plugin code need no restart: `.env` is watched and restarts the server, and a local plugin change rebuilds, restarting the server when the plugin has server-side types.',
146
141
  '',
147
142
  '## Routes',
148
143
  '',
149
144
  '| Route | Purpose |',
150
145
  '| --- | --- |',
151
146
  '| `GET /lowdefy-docs` | This overview |',
152
- '| `GET /lowdefy-docs/{kind}` | List all available types of a kind (blocks, operators, actions, connections, requests, agents, notifications, websockets) |',
153
- '| `GET /lowdefy-docs/plugins` | Installed plugin packages and the types each provides |',
154
- '| `GET /lowdefy-docs/schema/{kind}/{type}` | JSON schema for a type |',
155
- '| `GET /lowdefy-docs/examples/{type}` | Example yaml for a block type |',
156
- '| `GET /lowdefy-docs/content/{slug}` | A doc page as markdown: core, plugin or module |',
157
- '| `GET /lowdefy-docs/search?q={query}&source={source}` | Search the docs, ranked by matching words |',
158
- '| `GET /lowdefy-docs/icons?q={query}` | Search icon names (semantic names first, then Lucide names, then installed icon sets) |',
159
- '| `GET /lowdefy-docs/plugin-doc/{package}` | Markdown shipped inside a plugin package |',
160
147
  '| `GET /lowdefy-docs/build-status` | Current build errors/warnings, failing pages + recent browser errors |',
161
148
  '| `GET /lowdefy-docs/events` | SSE push channel: `restart` on connect, then `build`, `client_error`, `server_error` events as they happen (build events carry `stale`) |',
162
149
  '| `GET /lowdefy-docs/page-config/{pageId}` | Fully built page config, or its build errors |',
163
- '| `GET /lowdefy-docs/screenshot/{pageId}` | PNG screenshot of the rendered page |',
164
150
  '| `POST /lowdefy-docs/journey` | Drive a page headless through declarative steps (click, fill, select, press, back, goto, email, as, wait, screenshot, expect) and assert state, visibility, text, url or title; screenshots returned as base64 |',
165
151
  '| `POST /lowdefy-docs/mutants` | Config mutants on what journeys exercised `{pages, requests, endpoints, appEvents, operators}`: each with a stable `id`, its anchor and source line (for `lowdefy journeys harden`) |',
166
152
  '| `GET /lowdefy-docs/find/{id}?pageId=` | Locate where a page/block/request id is defined |',
167
- '| `GET /lowdefy-docs/inspect-state/{pageId}?source=` | Live state/requests/eventLog of a running page (tab or headless) |',
168
- '| `POST /lowdefy-docs/eval-operator` | Evaluate an operator expression against live page state |',
169
- '| `POST /lowdefy-docs/run-request` | Execute a request with a test payload (read-only unless opted in) |',
170
- '| `POST /lowdefy-docs/run-endpoint` | Execute an Api endpoint routine with a test payload and caller, or `system: true` for a cron-style system run (needs agent write access; rejects return as data) |',
171
- '| `GET /lowdefy-docs/app-map` | Whole-app graph: pages, menus, connections, endpoints, agents |',
172
- '| `GET/POST /lowdefy-docs/checkpoints` + `/revert` | Config-file checkpoints: list, create, revert |',
173
- '| `GET/POST /lowdefy-docs/state-checkpoints` + `/snapshot`, `/load` | State & data checkpoints: capture/restore live app state |',
174
153
  '| `POST /lowdefy-docs/restart` | Restart the dev server process (answers before the restart lands; then `build-status?wait=true` answers once it is back) |',
175
- '| `POST /lowdefy-feedback` | Annotation helper: enrich + format a feedback batch (overlay → clipboard) |',
176
- '| `ALL /lowdefy-docs/mcp` | MCP endpoint (streamable HTTP) exposing all of the above as tools |',
154
+ '| `ALL /lowdefy-docs/mcp` | MCP endpoint (streamable HTTP) exposing every dev tool |',
177
155
  ];
178
156
  return lines.join('\n');
179
157
  }
@@ -18,6 +18,7 @@ import fs from 'fs';
18
18
  import path from 'path';
19
19
 
20
20
  import setupTestFixtures from './setupTestFixtures.mjs';
21
+ import { expect, test } from 'vitest';
21
22
 
22
23
  // lib/build/config.js reads build/config.json from process.cwd() at import
23
24
  // time, so the fixture carries the basePath before getOverview is imported.
@@ -17,6 +17,7 @@
17
17
  import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  // getStaleStatus reads build/buildStatus.json from process.cwd() — point it at
22
23
  // a throwaway server directory before the module is imported.
@@ -14,15 +14,82 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
+ import { type } from '@lowdefy/helpers';
18
+
19
+ import findDeviceTab from './device/findDeviceTab.js';
17
20
  import inspectStateFromTab from './inspectStateFromTab.js';
18
21
  import inspectStateHeadless from './inspectStateHeadless.js';
19
22
  import resolveSource from './resolveSource.js';
20
23
 
24
+ // `device` names a phone's tab (lowdefy_device list): its live state is read,
25
+ // as `source: 'tab'` reads a browser tab, and never falls back to headless,
26
+ // which would answer for a different screen than the one asked about.
27
+ async function inspectDevice({
28
+ name,
29
+ pageId,
30
+ pathParams,
31
+ device,
32
+ evaluate,
33
+ expression,
34
+ source,
35
+ user,
36
+ data,
37
+ }) {
38
+ if (source === 'headless') {
39
+ return {
40
+ error: `${name} reads a phone's live tab when "device" is given; "source" "headless" contradicts it. Leave "source" out, or pass "tab".`,
41
+ invalidInput: true,
42
+ };
43
+ }
44
+ if (!type.isNone(user) || !type.isNone(data)) {
45
+ return {
46
+ error: `${name} cannot apply "${
47
+ type.isNone(user) ? 'data' : 'user'
48
+ }" to a phone: it carries its own session and the app's real database.`,
49
+ invalidInput: true,
50
+ };
51
+ }
52
+ const { tab, error } = findDeviceTab({ device });
53
+ if (!type.isUndefined(error)) {
54
+ return { error, invalidInput: true };
55
+ }
56
+ const result = await inspectStateFromTab({
57
+ tabId: tab.id,
58
+ pageId,
59
+ pathParams,
60
+ evaluate,
61
+ expression,
62
+ });
63
+ if (!type.isUndefined(result?.error)) {
64
+ return { error: result.error };
65
+ }
66
+ return { ...result, source: 'tab', device: tab.id };
67
+ }
68
+
69
+ // Reads a running page: its state snapshot, or, when an expression is passed,
70
+ // the value of that operator expression against its live state.
21
71
  // resolveSource picks the tab or headless — including why `user` is
22
72
  // headless-only. Falls back to headless whenever the tab path isn't usable
23
73
  // (no tab connected, or `source: 'tab'` was requested but it errored) so
24
74
  // agents always get an answer.
25
- async function inspectState({ origin, pageId, pathParams, source, user, data }) {
75
+ async function inspectState(params) {
76
+ const { origin, pageId, pathParams, expression, source, user, data } = params;
77
+ // null is a valid expression, so whether one was passed is read from the key.
78
+ const evaluate = Object.hasOwn(params, 'expression');
79
+ const { device } = params;
80
+ if (!type.isNone(device)) {
81
+ return inspectDevice({
82
+ name: 'inspectState',
83
+ pageId,
84
+ pathParams,
85
+ device,
86
+ evaluate,
87
+ expression,
88
+ source,
89
+ user,
90
+ data,
91
+ });
92
+ }
26
93
  const { tryTab, error, invalidInput } = resolveSource({
27
94
  name: 'inspectState',
28
95
  pageId,
@@ -36,13 +103,21 @@ async function inspectState({ origin, pageId, pathParams, source, user, data })
36
103
  }
37
104
 
38
105
  if (tryTab) {
39
- const result = await inspectStateFromTab({ pageId, pathParams });
106
+ const result = await inspectStateFromTab({ pageId, pathParams, evaluate, expression });
40
107
  if (!result?.error) {
41
108
  return { ...result, source: 'tab' };
42
109
  }
43
110
  }
44
111
 
45
- const result = await inspectStateHeadless({ origin, pageId, pathParams, user, data });
112
+ const result = await inspectStateHeadless({
113
+ origin,
114
+ pageId,
115
+ pathParams,
116
+ evaluate,
117
+ expression,
118
+ user,
119
+ data,
120
+ });
46
121
  return { ...result, source: 'headless' };
47
122
  }
48
123
 
@@ -14,30 +14,30 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, beforeEach, expect, test } from 'vitest';
18
18
 
19
19
  // inspectState.js only chooses between the tab and headless sources - the
20
20
  // sources' own behavior is covered by inspectStateHeadless.test.mjs and (once
21
21
  // written) inspectStateFromTab's own tests. Mock both, plus tabAvailable, so
22
22
  // only the fallback logic is under test here.
23
- const mockInspectStateFromTab = jest.fn();
24
- const mockInspectStateHeadless = jest.fn();
25
- const mockTabAvailable = jest.fn();
23
+ const mockInspectStateFromTab = vi.fn();
24
+ const mockInspectStateHeadless = vi.fn();
25
+ const mockTabAvailable = vi.fn();
26
26
 
27
- jest.unstable_mockModule('./inspectStateFromTab.js', () => ({
27
+ vi.doMock('./inspectStateFromTab.js', () => ({
28
28
  default: mockInspectStateFromTab,
29
29
  }));
30
- jest.unstable_mockModule('./inspectStateHeadless.js', () => ({
30
+ vi.doMock('./inspectStateHeadless.js', () => ({
31
31
  default: mockInspectStateHeadless,
32
32
  }));
33
- jest.unstable_mockModule('./tabAvailable.js', () => ({
33
+ vi.doMock('./tabAvailable.js', () => ({
34
34
  default: mockTabAvailable,
35
35
  }));
36
36
 
37
37
  const { default: inspectState } = await import('./inspectState.js');
38
38
 
39
39
  beforeEach(() => {
40
- jest.clearAllMocks();
40
+ vi.clearAllMocks();
41
41
  });
42
42
 
43
43
  test('inspectState uses the tab when source is "tab" and it succeeds', async () => {
@@ -50,7 +50,7 @@ test('inspectState uses the tab when source is "tab" and it succeeds', async ()
50
50
  });
51
51
 
52
52
  expect(result).toEqual({ state: { a: 1 }, source: 'tab' });
53
- expect(mockInspectStateFromTab).toHaveBeenCalledWith({ pageId: 'home' });
53
+ expect(mockInspectStateFromTab).toHaveBeenCalledWith({ pageId: 'home', evaluate: false });
54
54
  expect(mockInspectStateHeadless).not.toHaveBeenCalled();
55
55
  });
56
56
 
@@ -68,6 +68,7 @@ test('inspectState falls back to headless when source is "tab" but the tab error
68
68
  expect(mockInspectStateHeadless).toHaveBeenCalledWith({
69
69
  origin: 'http://localhost:3001',
70
70
  pageId: 'home',
71
+ evaluate: false,
71
72
  });
72
73
  });
73
74
 
@@ -120,6 +121,7 @@ test('inspectState ignores an available tab and passes the user to headless when
120
121
  expect(mockInspectStateHeadless).toHaveBeenCalledWith({
121
122
  origin: 'http://localhost:3001',
122
123
  pageId: 'home',
124
+ evaluate: false,
123
125
  user: { roles: ['admin'] },
124
126
  });
125
127
  });
@@ -138,3 +140,53 @@ test('inspectState errors when a user is combined with source "tab"', async () =
138
140
  expect(mockInspectStateFromTab).not.toHaveBeenCalled();
139
141
  expect(mockInspectStateHeadless).not.toHaveBeenCalled();
140
142
  });
143
+
144
+ test('inspectState evaluates an expression in the tab when one is passed', async () => {
145
+ mockInspectStateFromTab.mockResolvedValue({ value: 'Jane', errors: [], reads: ['state:name'] });
146
+ const expression = { _state: 'name' };
147
+
148
+ const result = await inspectState({ pageId: 'home', expression, source: 'tab' });
149
+
150
+ expect(result).toEqual({ value: 'Jane', errors: [], reads: ['state:name'], source: 'tab' });
151
+ expect(mockInspectStateFromTab).toHaveBeenCalledWith({
152
+ pageId: 'home',
153
+ evaluate: true,
154
+ expression,
155
+ });
156
+ });
157
+
158
+ test('inspectState evaluates a null expression rather than treating it as absent', async () => {
159
+ mockInspectStateHeadless.mockResolvedValue({ value: null, errors: [], reads: [] });
160
+
161
+ const result = await inspectState({
162
+ origin: 'http://localhost:3001',
163
+ pageId: 'home',
164
+ expression: null,
165
+ source: 'headless',
166
+ });
167
+
168
+ expect(result).toEqual({ value: null, errors: [], reads: [], source: 'headless' });
169
+ expect(mockInspectStateHeadless).toHaveBeenCalledWith({
170
+ origin: 'http://localhost:3001',
171
+ pageId: 'home',
172
+ evaluate: true,
173
+ expression: null,
174
+ });
175
+ });
176
+
177
+ test('inspectState falls back to headless evaluation when the tab errors', async () => {
178
+ mockInspectStateFromTab.mockResolvedValue({ error: 'No browser tab connected.' });
179
+ mockInspectStateHeadless.mockResolvedValue({ value: 1, errors: [], reads: ['state:a'] });
180
+
181
+ const result = await inspectState({
182
+ origin: 'http://localhost:3001',
183
+ pageId: 'home',
184
+ expression: { _state: 'a' },
185
+ source: 'tab',
186
+ });
187
+
188
+ expect(result).toEqual({ value: 1, errors: [], reads: ['state:a'], source: 'headless' });
189
+ expect(mockInspectStateHeadless).toHaveBeenCalledWith(
190
+ expect.objectContaining({ evaluate: true, expression: { _state: 'a' } })
191
+ );
192
+ });