@lowdefy/server-dev 7.1.0 → 7.2.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 (432) 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 +87 -135
  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.test.mjs +1 -0
  106. package/lib/docs/isPageReady.test.mjs +1 -0
  107. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  108. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  109. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  110. package/lib/docs/launchBrowser.test.mjs +8 -8
  111. package/lib/docs/listTypes.js +58 -8
  112. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  113. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  114. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  115. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  116. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  117. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  118. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  119. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  120. package/lib/docs/pollTab.js +100 -0
  121. package/lib/docs/pollTab.test.mjs +64 -0
  122. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  123. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  124. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  125. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  126. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  127. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  128. package/lib/docs/readJourneySession.js +1 -1
  129. package/lib/docs/reportDevToolFault.js +29 -0
  130. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  131. package/lib/docs/requestRestart.test.mjs +1 -0
  132. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  133. package/lib/docs/resolveSource.js +2 -2
  134. package/lib/docs/resolveSource.test.mjs +6 -6
  135. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  136. package/lib/docs/runCheck.test.mjs +3 -3
  137. package/lib/docs/runCheckChild.js +2 -1
  138. package/lib/docs/runEndpoint.js +23 -10
  139. package/lib/docs/runEndpoint.test.mjs +42 -37
  140. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  141. package/lib/docs/runJourney.js +21 -1
  142. package/lib/docs/runJourney.test.mjs +119 -99
  143. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  144. package/lib/docs/runJourneySteps.js +8 -29
  145. package/lib/docs/runRequest.js +6 -6
  146. package/lib/docs/runRequest.test.mjs +22 -22
  147. package/lib/docs/screenshotPage.js +6 -7
  148. package/lib/docs/screenshotPage.test.mjs +46 -46
  149. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  150. package/lib/docs/searchDocs.test.mjs +1 -0
  151. package/lib/docs/searchIcons.test.mjs +5 -5
  152. package/lib/docs/selectFinalState.test.mjs +1 -0
  153. package/lib/docs/serverErrorStore.test.mjs +4 -4
  154. package/lib/docs/setupTestFixtures.mjs +25 -0
  155. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  156. package/lib/docs/tabAvailable.js +1 -1
  157. package/lib/docs/tabChannel.js +90 -14
  158. package/lib/docs/tabChannel.test.mjs +40 -15
  159. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  160. package/lib/docs/validateStateSelection.test.mjs +1 -0
  161. package/lib/docs/validateViewport.test.mjs +1 -0
  162. package/lib/docs/waitForBuild.test.mjs +1 -0
  163. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  164. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  165. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  166. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  167. package/lib/server/auth/getHeadlessUser.js +6 -0
  168. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  169. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  170. package/lib/server/contextMapBudget.test.mjs +3 -3
  171. package/lib/server/continueJitKeys.test.mjs +1 -0
  172. package/lib/server/createLowdefyContext.js +5 -1
  173. package/lib/server/createLowdefyContext.test.mjs +32 -32
  174. package/lib/server/getClientAddress.test.mjs +2 -2
  175. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  176. package/lib/server/importAppCode.test.mjs +2 -2
  177. package/lib/server/jitPageBuilder.js +27 -3
  178. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  179. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  180. package/lib/server/jitPageBuilder.test.mjs +4 -4
  181. package/lib/server/journeyCookies.test.mjs +1 -0
  182. package/lib/server/loadDynamicJsMap.js +10 -1
  183. package/lib/server/log/createHandleError.js +10 -5
  184. package/lib/server/log/createHandleError.test.mjs +19 -8
  185. package/lib/server/log/createLogger.test.mjs +2 -2
  186. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  187. package/lib/server/mutants/listMutants.test.mjs +1 -0
  188. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  189. package/lib/server/mutants/operators.test.mjs +1 -0
  190. package/lib/server/pageBuildRecords.test.mjs +1 -0
  191. package/lib/server/pageCache.test.mjs +1 -0
  192. package/lib/server/pageRebuilds.test.mjs +3 -3
  193. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  194. package/lib/server/pruneJitMaps.test.mjs +1 -0
  195. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  196. package/lib/server/readInstanceRecord.test.mjs +24 -8
  197. package/lib/server/readMergedMaps.test.mjs +1 -0
  198. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  199. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  200. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  201. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  202. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  203. package/lib/server/startIdleGc.test.mjs +25 -9
  204. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  205. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  206. package/manager/getContext.mjs +9 -0
  207. package/manager/processes/checkPendingPlugins.mjs +49 -0
  208. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  209. package/manager/processes/createIdleChild.mjs +141 -0
  210. package/manager/processes/createIdleChild.test.mjs +209 -0
  211. package/manager/processes/initialBuild.mjs +2 -15
  212. package/manager/processes/initialBuild.test.mjs +8 -40
  213. package/manager/processes/lowdefyBuild.mjs +7 -4
  214. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  215. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  216. package/manager/processes/restartServer.test.mjs +63 -15
  217. package/manager/processes/shutdownServer.test.mjs +3 -3
  218. package/manager/processes/startFirstServer.test.mjs +23 -22
  219. package/manager/processes/startMailSink.mjs +11 -3
  220. package/manager/processes/startMailSink.test.mjs +28 -2
  221. package/manager/processes/startProxy.mjs +158 -27
  222. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  223. package/manager/processes/startProxy.test.mjs +127 -2
  224. package/manager/processes/startServer.mjs +5 -7
  225. package/manager/processes/startServer.test.mjs +10 -9
  226. package/manager/processes/syncServer.mjs +31 -4
  227. package/manager/processes/syncServer.test.mjs +71 -6
  228. package/manager/processes/waitForDevServer.test.mjs +21 -6
  229. package/manager/run.mjs +32 -8
  230. package/manager/utils/BatchChanges.mjs +1 -1
  231. package/manager/utils/BatchChanges.test.mjs +4 -4
  232. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  233. package/manager/utils/checkPairing.mjs +45 -0
  234. package/manager/utils/checkPairing.test.mjs +53 -0
  235. package/manager/utils/createBuildActivity.mjs +5 -1
  236. package/manager/utils/createBuildActivity.test.mjs +2 -2
  237. package/manager/utils/createChangeSignal.test.mjs +5 -5
  238. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  239. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  240. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  241. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  242. package/manager/utils/createGlobIgnore.mjs +45 -0
  243. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  244. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  245. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  246. package/manager/utils/createIdleGc.test.mjs +31 -15
  247. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  248. package/manager/utils/createLanPairing.test.mjs +46 -0
  249. package/manager/utils/createRequestActivity.mjs +30 -3
  250. package/manager/utils/createRequestActivity.test.mjs +76 -22
  251. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  252. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  253. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  254. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  255. package/manager/utils/findSignInCode.test.mjs +33 -0
  256. package/manager/utils/formatLanPairing.mjs +32 -0
  257. package/manager/utils/formatLanPairing.test.mjs +40 -0
  258. package/manager/utils/getLanAddress.mjs +83 -0
  259. package/manager/utils/getLanAddress.test.mjs +70 -0
  260. package/manager/utils/importFresh.test.mjs +1 -0
  261. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  262. package/manager/utils/pluginTypeCache.mjs +100 -0
  263. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  264. package/manager/utils/pruneRecordings.test.mjs +1 -0
  265. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  266. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  267. package/manager/utils/readBasePath.test.mjs +1 -0
  268. package/manager/utils/readManagerVersion.test.mjs +1 -0
  269. package/manager/utils/readPluginDefinitions.mjs +6 -6
  270. package/manager/utils/renderTerminalQr.mjs +54 -0
  271. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  272. package/manager/utils/setupWatcher.mjs +19 -4
  273. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  274. package/manager/utils/waitForChildExit.test.mjs +2 -2
  275. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  276. package/manager/watchers/envWatcher.mjs +3 -0
  277. package/manager/watchers/envWatcher.test.mjs +19 -7
  278. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  279. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  280. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  281. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  282. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  283. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  284. package/manager/watchers/resolveFile.mjs +46 -0
  285. package/manager/watchers/resolveFile.test.mjs +67 -0
  286. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  287. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  288. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  289. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  290. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  291. package/package.json +50 -49
  292. package/package.original.json +50 -49
  293. package/src/app.js +83 -85
  294. package/src/html/renderDevPage.test.mjs +1 -0
  295. package/src/lib/getPathSegments.js +16 -1
  296. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  297. package/src/lib/isTabAnswer.js +32 -0
  298. package/src/lib/isTabChannelCaller.js +35 -0
  299. package/src/middleware/apiContext.js +4 -2
  300. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  301. package/src/middleware/errorHandler.js +33 -45
  302. package/src/middleware/errorHandler.test.mjs +10 -10
  303. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  304. package/src/middleware/localDevToolsOnly.js +13 -1
  305. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  306. package/src/middleware/noStore.test.mjs +1 -0
  307. package/src/middleware/staleFlag.test.mjs +1 -0
  308. package/src/middleware/stampCaller.test.mjs +1 -0
  309. package/src/routes/agentBearer.test.mjs +183 -0
  310. package/src/routes/auth.test.mjs +10 -10
  311. package/src/routes/clientError.js +21 -4
  312. package/src/routes/clientError.test.mjs +127 -0
  313. package/src/routes/devInspect.js +6 -51
  314. package/src/routes/devInspect.test.mjs +128 -3
  315. package/src/routes/devRecording.js +6 -17
  316. package/src/routes/devRecording.test.mjs +54 -3
  317. package/src/routes/docs/buildStatus.test.mjs +6 -6
  318. package/src/routes/docs/events.test.mjs +4 -4
  319. package/src/routes/docs/find.js +3 -3
  320. package/src/routes/docs/journey.test.mjs +8 -8
  321. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  322. package/src/routes/docs/loadDocsRoutes.js +70 -0
  323. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  324. package/src/routes/docs/mcp.test.mjs +5 -5
  325. package/src/routes/docs/mutants.js +7 -0
  326. package/src/routes/docs/mutants.test.mjs +20 -6
  327. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  328. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  329. package/src/routes/docs/restart.test.mjs +1 -0
  330. package/src/routes/endpoints.js +24 -0
  331. package/src/routes/endpointsLink.test.mjs +111 -0
  332. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  333. package/src/routes/jitPage.js +13 -1
  334. package/src/routes/jitPage.test.mjs +36 -11
  335. package/src/routes/mcp.js +6 -0
  336. package/src/routes/mcp.test.mjs +23 -8
  337. package/src/routes/mcpMemberToken.test.mjs +8 -8
  338. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  339. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  340. package/src/routes/mobileRoutes.test.mjs +223 -0
  341. package/src/routes/mobileSignIn.js +58 -0
  342. package/src/routes/mobileSignIn.test.mjs +59 -0
  343. package/src/routes/mobileSignInCallback.js +34 -0
  344. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  345. package/src/routes/mountDevPageRoutes.js +10 -2
  346. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  347. package/src/routes/mountMobileWellKnown.js +35 -0
  348. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  349. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  350. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  351. package/src/routes/reload.js +101 -20
  352. package/src/routes/reload.test.mjs +153 -0
  353. package/src/routes/request.js +1 -22
  354. package/src/routes/request.test.mjs +7 -24
  355. package/src/routes/requestBody.test.mjs +14 -27
  356. package/src/routes/websocket.test.mjs +2 -2
  357. package/src/routes/wellKnownFallback.test.mjs +2 -2
  358. package/src/websocket/devWebSocket.test.mjs +12 -12
  359. package/vite.config.js +13 -1
  360. package/client/feedback/FeedbackMount.jsx +0 -83
  361. package/client/feedback/FeedbackOverlay.jsx +0 -904
  362. package/client/feedback/captureTabScreenshot.js +0 -84
  363. package/client/feedback/copyToClipboard.js +0 -45
  364. package/client/feedback/drawAnnotationsSvg.js +0 -119
  365. package/client/feedback/feedbackStyles.js +0 -304
  366. package/client/feedback/pinResponsiveImages.js +0 -59
  367. package/client/feedback/sendFeedback.js +0 -39
  368. package/client/feedback/useFeedbackToggle.js +0 -70
  369. package/client/recorder/buildEngineRecord.js +0 -37
  370. package/client/recorder/buildInteractionRecord.js +0 -64
  371. package/client/recorder/buildTraceEvent.js +0 -57
  372. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  373. package/client/recorder/chunkRecords.js +0 -69
  374. package/client/recorder/chunkRecords.test.mjs +0 -59
  375. package/client/recorder/collectEventEndpoints.js +0 -40
  376. package/client/recorder/collectEventRequests.js +0 -39
  377. package/client/recorder/createPairingBuffer.js +0 -187
  378. package/client/recorder/createPasswordRedactor.js +0 -84
  379. package/client/recorder/createRecordBatcher.js +0 -54
  380. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  381. package/client/recorder/createRecordingSession.js +0 -61
  382. package/client/recorder/createRecordingSession.test.mjs +0 -72
  383. package/client/recorder/diffStateWrites.js +0 -77
  384. package/client/recorder/diffStateWrites.test.mjs +0 -66
  385. package/client/recorder/isEventCall.js +0 -30
  386. package/client/recorder/jsonType.js +0 -39
  387. package/client/recorder/sendRecords.js +0 -40
  388. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  389. package/lib/docs/checkpointPaths.js +0 -91
  390. package/lib/docs/checkpointStore.js +0 -243
  391. package/lib/docs/checkpointToMocks.js +0 -65
  392. package/lib/docs/configCheckpoints.test.mjs +0 -156
  393. package/lib/docs/createConfigCheckpoint.js +0 -92
  394. package/lib/docs/devMockRegistry.js +0 -68
  395. package/lib/docs/enrichFeedback.js +0 -71
  396. package/lib/docs/evalOperator.js +0 -49
  397. package/lib/docs/evalOperator.test.mjs +0 -157
  398. package/lib/docs/evalOperatorHeadless.js +0 -159
  399. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  400. package/lib/docs/evalOperatorInTab.js +0 -49
  401. package/lib/docs/formatFeedback.js +0 -142
  402. package/lib/docs/formatFeedback.test.mjs +0 -252
  403. package/lib/docs/getPluginDoc.js +0 -53
  404. package/lib/docs/listConfigCheckpoints.js +0 -55
  405. package/lib/docs/loadState.js +0 -220
  406. package/lib/docs/revertConfigCheckpoint.js +0 -73
  407. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  408. package/lib/docs/scaffoldPage.js +0 -77
  409. package/lib/docs/scaffoldPage.test.mjs +0 -97
  410. package/lib/docs/snapshotState.js +0 -67
  411. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  412. package/manager/watchers/listServerSidePackages.mjs +0 -47
  413. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  414. package/src/routes/docs/checkpointsCreate.js +0 -28
  415. package/src/routes/docs/evalOperator.js +0 -70
  416. package/src/routes/docs/inspectState.js +0 -59
  417. package/src/routes/docs/loadState.js +0 -51
  418. package/src/routes/docs/pluginDoc.js +0 -33
  419. package/src/routes/docs/plugins.js +0 -23
  420. package/src/routes/docs/runEndpoint.js +0 -54
  421. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  422. package/src/routes/docs/runRequest.js +0 -53
  423. package/src/routes/docs/runRequest.test.mjs +0 -92
  424. package/src/routes/docs/schema.js +0 -37
  425. package/src/routes/docs/screenshot.js +0 -120
  426. package/src/routes/docs/screenshot.test.mjs +0 -117
  427. package/src/routes/docs/search.js +0 -40
  428. package/src/routes/docs/snapshotState.js +0 -50
  429. package/src/routes/docs/stateCheckpointsList.js +0 -26
  430. package/src/routes/docs/types.js +0 -33
  431. package/src/routes/feedback.js +0 -107
  432. package/src/routes/feedback.test.mjs +0 -204
@@ -0,0 +1,68 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { type } from '@lowdefy/helpers';
18
+ import { runDeviceTool } from '@lowdefy/node-utils';
19
+
20
+ import captureDevice from './captureDevice.js';
21
+ import checkShownPage from './checkShownPage.js';
22
+ import findDeviceTab from './findDeviceTab.js';
23
+ import findDeviceTarget from './findDeviceTarget.js';
24
+ import runDeviceSteps from './runDeviceSteps.js';
25
+
26
+ /**
27
+ * lowdefy_screenshot_page on a phone: runs `steps` on it through Lowdefy Dev, then captures its
28
+ * screen (captureDevice). Resolves `{ data, mimeType, capture, note?, failure, screenshots,
29
+ * device }` in the shape screenshotPage gives a browser capture, or `{ error }`.
30
+ *
31
+ * @param {Object} params
32
+ * @param {string} params.device The phone's tab id.
33
+ * @param {string} params.pageId The page the phone must show.
34
+ * @param {Object} [params.pathParams]
35
+ * @param {Object[]} [params.steps]
36
+ * @param {Object} [params.devices] Options for listDevices (`adb`, `platform`).
37
+ * @param {Function} [params.run] Runs one device command (runDeviceTool).
38
+ */
39
+ async function screenshotDevice({
40
+ device,
41
+ pageId,
42
+ pathParams,
43
+ steps,
44
+ devices = {},
45
+ run = runDeviceTool,
46
+ }) {
47
+ const { tab, error } = findDeviceTab({ device });
48
+ if (!type.isUndefined(error)) {
49
+ return { error };
50
+ }
51
+ const notShown = checkShownPage({ tab, pageId, pathParams });
52
+ if (!type.isUndefined(notShown)) {
53
+ return { error: notShown };
54
+ }
55
+ const ran = await runDeviceSteps({ tabId: tab.id, steps });
56
+ if (!type.isUndefined(ran.error)) {
57
+ return { error: ran.error };
58
+ }
59
+ try {
60
+ const target = await findDeviceTarget({ tab, devices: { ...devices, run } });
61
+ const capture = await captureDevice({ tab, target, run });
62
+ return { ...capture, failure: ran.failure, screenshots: ran.screenshots, device: tab.id };
63
+ } catch (captureError) {
64
+ return { error: `Could not capture the phone on tab "${tab.id}": ${captureError.message}` };
65
+ }
66
+ }
67
+
68
+ export default screenshotDevice;
@@ -0,0 +1,52 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { type } from '@lowdefy/helpers';
18
+
19
+ import { requestFromTab } from '../tabChannel.js';
20
+
21
+ // A step waits up to its own timeout for its block or condition, then up to 5 s for the action
22
+ // chain it started to settle (shell src/dev/steps/createStepRunner.js).
23
+ const SETTLE_MS = 5000;
24
+ const MARGIN_MS = 2000;
25
+
26
+ /**
27
+ * Runs one journey step on a phone through its dev-tab client (a `step-request`), and resolves
28
+ * what the phone answered: `{ ok, settled }`, or `{ ok, name, image }` for a screenshot step.
29
+ * Throws with the phone's own message when the step could not run.
30
+ *
31
+ * @param {Object} params
32
+ * @param {string} params.tabId
33
+ * @param {Object} params.step One journey step, e.g. `{ click: 'save' }`.
34
+ * @param {number} [params.stepTimeout] How long the phone waits for the step's block or condition.
35
+ */
36
+ async function sendDeviceStep({ tabId, step, stepTimeout = 5000 }) {
37
+ const result = await requestFromTab({
38
+ tabId,
39
+ event: 'step-request',
40
+ payload: { step },
41
+ timeout: stepTimeout + SETTLE_MS + MARGIN_MS,
42
+ });
43
+ if (!type.isObject(result)) {
44
+ throw new Error(`The phone answered the step with ${JSON.stringify(result)}.`);
45
+ }
46
+ if (!type.isUndefined(result.error)) {
47
+ throw new Error(result.error);
48
+ }
49
+ return result;
50
+ }
51
+
52
+ export default sendDeviceStep;
@@ -0,0 +1,150 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { wait } from '@lowdefy/helpers';
18
+ import {
19
+ bootIosSimulator,
20
+ createDevAppLink,
21
+ findAndroidDevice,
22
+ findAndroidTool,
23
+ readDevAppPath,
24
+ runDeviceTool,
25
+ } from '@lowdefy/node-utils';
26
+
27
+ import { listTabs } from '../tabChannel.js';
28
+
29
+ const PLATFORMS = ['ios', 'android'];
30
+ const POLL_MS = 500;
31
+
32
+ function phoneTabIds() {
33
+ return new Set(
34
+ listTabs()
35
+ .filter((tab) => tab.device !== null && tab.device !== undefined)
36
+ .map((tab) => tab.id)
37
+ );
38
+ }
39
+
40
+ // Lowdefy Dev joins the dev server's tab channel a moment after it opens the link.
41
+ async function waitForNewTab({ before, platform, timeout }) {
42
+ const deadline = Date.now() + timeout;
43
+ while (Date.now() < deadline) {
44
+ const joined = listTabs().find(
45
+ (tab) => !before.has(tab.id) && tab.device?.platform === platform
46
+ );
47
+ if (joined !== undefined) {
48
+ return joined.id;
49
+ }
50
+ await wait(POLL_MS);
51
+ }
52
+ return null;
53
+ }
54
+
55
+ async function startIos({ hostPlatform, log, origin, run }) {
56
+ if (hostPlatform !== 'darwin') {
57
+ throw new Error('The iOS simulator runs only on macOS. Start an Android emulator instead.');
58
+ }
59
+ const appPath = readDevAppPath({ platform: 'ios' });
60
+ const simulator = await bootIosSimulator({ log, run });
61
+ await run({ command: 'xcrun', args: ['simctl', 'install', simulator.udid, appPath] });
62
+ await run({
63
+ command: 'xcrun',
64
+ args: ['simctl', 'openurl', simulator.udid, createDevAppLink({ url: origin })],
65
+ });
66
+ return { simulator: { udid: simulator.udid, name: simulator.name } };
67
+ }
68
+
69
+ // adb reverse makes the device's localhost:<port> this computer's, so Lowdefy Dev reaches the dev
70
+ // server without the network and without pairing. adb shell runs its arguments through the
71
+ // device's shell: the link is quoted, whose ? and & the shell would otherwise read.
72
+ async function startAndroid({ log, origin, run }) {
73
+ const adb = findAndroidTool({ name: 'adb' });
74
+ const appPath = readDevAppPath({ platform: 'android' });
75
+ const serial = await findAndroidDevice({
76
+ adb,
77
+ emulator: findAndroidTool({ name: 'emulator' }),
78
+ log,
79
+ run,
80
+ });
81
+ const port = new URL(origin).port;
82
+ await run({ command: adb, args: ['-s', serial, 'install', '-r', appPath] });
83
+ await run({ command: adb, args: ['-s', serial, 'reverse', `tcp:${port}`, `tcp:${port}`] });
84
+ await run({
85
+ command: adb,
86
+ args: [
87
+ '-s',
88
+ serial,
89
+ 'shell',
90
+ 'am',
91
+ 'start',
92
+ '-a',
93
+ 'android.intent.action.VIEW',
94
+ '-d',
95
+ `'${createDevAppLink({ url: origin })}'`,
96
+ ],
97
+ });
98
+ return { android: { serial } };
99
+ }
100
+
101
+ /**
102
+ * lowdefy_device `start`: what `lowdefy dev --ios` or `--android` does, for a dev server that is
103
+ * already running. It boots a simulator (or uses the booted one), or finds an Android device or
104
+ * starts the first emulator, installs Lowdefy Dev from LOWDEFY_DEV_APP_IOS or
105
+ * LOWDEFY_DEV_APP_ANDROID, and opens it on this dev server. Resolves `{ started, platform, url,
106
+ * simulator | android, device }`, `device` being the tab Lowdefy Dev joined as (null when it has
107
+ * not joined within tabTimeout), or `{ error }`.
108
+ *
109
+ * @param {Object} params
110
+ * @param {string} params.platform 'ios' or 'android'.
111
+ * @param {string} params.origin This dev server's URL on this computer.
112
+ * @param {(message: string) => void} [params.log]
113
+ * @param {Function} [params.run] Runs one device command (runDeviceTool).
114
+ * @param {number} [params.tabTimeout] How long to wait for Lowdefy Dev to join, in ms.
115
+ * @param {string} [params.hostPlatform] process.platform.
116
+ */
117
+ async function startDevice({
118
+ platform,
119
+ origin,
120
+ hostPlatform = process.platform,
121
+ log = () => undefined,
122
+ run = runDeviceTool,
123
+ tabTimeout = 30000,
124
+ }) {
125
+ if (!PLATFORMS.includes(platform)) {
126
+ return {
127
+ error: `start needs "platform" "ios" or "android". Received ${JSON.stringify(platform)}.`,
128
+ };
129
+ }
130
+ const before = phoneTabIds();
131
+ let started;
132
+ try {
133
+ started =
134
+ platform === 'ios'
135
+ ? await startIos({ hostPlatform, log, origin, run })
136
+ : await startAndroid({ log, origin, run });
137
+ } catch (error) {
138
+ return { error: `Could not start Lowdefy Dev on ${platform}: ${error.message}` };
139
+ }
140
+ const device = await waitForNewTab({ before, platform, timeout: tabTimeout });
141
+ const result = { started: true, platform, url: origin, ...started, device };
142
+ if (device === null) {
143
+ result.note = `Lowdefy Dev opened ${origin} but has not joined as a tab within ${Math.round(
144
+ tabTimeout / 1000
145
+ )} s. Confirm the connection in the app if it asks, then call lowdefy_device with action "list".`;
146
+ }
147
+ return result;
148
+ }
149
+
150
+ export default startDevice;
@@ -17,7 +17,7 @@
17
17
  import fs from 'fs';
18
18
  import path from 'path';
19
19
 
20
- import { jest } from '@jest/globals';
20
+ import { vi, expect, test } from 'vitest';
21
21
 
22
22
  import setupTestFixtures from './setupTestFixtures.mjs';
23
23
 
@@ -32,21 +32,21 @@ process.chdir(fixtureDir);
32
32
  // server's own build/plugins/*.js — not the app fixture built above, and not
33
33
  // present in this checkout) — mock both so runRequest can be unit tested
34
34
  // without a real server build.
35
- const mockCallRequest = jest.fn();
36
- jest.unstable_mockModule('@lowdefy/api', () => ({
35
+ const mockCallRequest = vi.fn();
36
+ vi.doMock('@lowdefy/api', () => ({
37
37
  callRequest: mockCallRequest,
38
38
  }));
39
- const mockCreateLowdefyContext = jest.fn(async () => ({
40
- logger: { info: jest.fn(), debug: jest.fn(), warn: jest.fn(), error: jest.fn() },
39
+ const mockCreateLowdefyContext = vi.fn(async () => ({
40
+ logger: { info: vi.fn(), debug: vi.fn(), warn: vi.fn(), error: vi.fn() },
41
41
  }));
42
- jest.unstable_mockModule('../server/createLowdefyContext.js', () => ({
42
+ vi.doMock('../server/createLowdefyContext.js', () => ({
43
43
  default: mockCreateLowdefyContext,
44
44
  }));
45
45
 
46
46
  // findConfig force-builds a page when pageId is passed — the fixture pages
47
47
  // only exist as pre-written build artifacts, so stub the JIT builder out.
48
- const mockBuildPageIfNeeded = jest.fn(async () => true);
49
- jest.unstable_mockModule('../server/jitPageBuilder.js', () => ({
48
+ const mockBuildPageIfNeeded = vi.fn(async () => true);
49
+ vi.doMock('../server/jitPageBuilder.js', () => ({
50
50
  default: mockBuildPageIfNeeded,
51
51
  reviewBuiltPage: async () => 'current',
52
52
  syncBuildSignals: () => ({
@@ -63,7 +63,6 @@ const { default: listPlugins } = await import('./listPlugins.js');
63
63
  const { default: getSchema } = await import('./getSchema.js');
64
64
  const { default: getExamples } = await import('./getExamples.js');
65
65
  const { default: getCoreDoc } = await import('./getCoreDoc.js');
66
- const { default: getPluginDoc } = await import('./getPluginDoc.js');
67
66
  const { default: getOverview } = await import('./getOverview.js');
68
67
  const { default: searchDocs } = await import('./searchDocs.js');
69
68
  const { default: normalizeTypeKind } = await import('./normalizeTypeKind.js');
@@ -97,6 +96,38 @@ test('listTypes merges client and server operators with environments', () => {
97
96
  expect(secret.used).toBe(false);
98
97
  });
99
98
 
99
+ test('listTypes with target mobile lists the blocks a native shell carries', () => {
100
+ const blocks = listTypes({ kind: 'blocks', target: 'mobile' });
101
+ expect(blocks.map((block) => block.type)).toEqual(['Button', 'TextInput']);
102
+ const button = blocks.find((block) => block.type === 'Button');
103
+ expect(button.package).toEqual('@lowdefy/blocks-native');
104
+ expect(button.category).toEqual('display');
105
+ expect(button).not.toHaveProperty('used');
106
+ });
107
+
108
+ test('listTypes with target web lists the installed web blocks, as without a target', () => {
109
+ expect(listTypes({ kind: 'blocks', target: 'web' })).toEqual(listTypes({ kind: 'blocks' }));
110
+ });
111
+
112
+ test('listTypes with target mobile takes client operators from the shell and server ones from the app', () => {
113
+ const operators = listTypes({ kind: 'operators', target: 'mobile' });
114
+ expect(operators.map(({ type, environments }) => [type, environments])).toEqual([
115
+ ['_get', ['server']],
116
+ ['_secret', ['server']],
117
+ ['_state', ['client']],
118
+ ]);
119
+ });
120
+
121
+ test('listTypes with target mobile lists server kinds as for the web', () => {
122
+ expect(listTypes({ kind: 'requests', target: 'mobile' }).map(({ type }) => type)).toEqual([
123
+ 'AxiosHttp',
124
+ ]);
125
+ });
126
+
127
+ test('listTypes throws on an unknown target', () => {
128
+ expect(() => listTypes({ kind: 'blocks', target: 'watch' })).toThrow('Unknown target');
129
+ });
130
+
100
131
  test('listTypes accepts singular kind names', () => {
101
132
  expect(listTypes({ kind: 'block' }).length).toEqual(2);
102
133
  });
@@ -193,22 +224,6 @@ test('getExamples returns null for unknown block type', () => {
193
224
  expect(getExamples({ type: 'Nope' })).toBeNull();
194
225
  });
195
226
 
196
- test('getPluginDoc returns README markdown for installed plugin', () => {
197
- const result = getPluginDoc({ packageName: 'test-plugin' });
198
- expect(result.markdown).toContain('# test-plugin');
199
- });
200
-
201
- test('getPluginDoc returns null for packages without docs', () => {
202
- expect(getPluginDoc({ packageName: 'no-such-package' })).toBeNull();
203
- });
204
-
205
- test('getPluginDoc reads only the app plugins, never a path out of node_modules', () => {
206
- fs.writeFileSync(path.join(fixtureDir, 'README.md'), '# Server readme\n');
207
- expect(getPluginDoc({ packageName: '..' })).toBeNull();
208
- expect(getPluginDoc({ packageName: 'test-plugin/../..' })).toBeNull();
209
- fs.rmSync(path.join(fixtureDir, 'README.md'));
210
- });
211
-
212
227
  test('getCoreDoc returns markdown by slug from docs-content', () => {
213
228
  const doc = getCoreDoc({ slug: 'operators/_get' });
214
229
  expect(doc.title).toEqual('_get');
@@ -255,7 +270,8 @@ test('searchDocs throws on empty query', () => {
255
270
  test('getOverview includes counts and route guidance', () => {
256
271
  const overview = getOverview();
257
272
  expect(overview).toContain('2 block types');
258
- expect(overview).toContain('/lowdefy-docs/schema/{kind}/{type}');
273
+ expect(overview).toContain('`GET /lowdefy-docs/build-status`');
274
+ expect(overview).not.toContain('/lowdefy-docs/schema');
259
275
  expect(overview).toContain('lowdefy_list_types');
260
276
  expect(overview).not.toContain('config.basePath');
261
277
  });
@@ -319,8 +335,8 @@ test('findConfig resolves a known pageId to its source file', async () => {
319
335
  expect(result.kind).toEqual('page');
320
336
  expect(result.pageId).toEqual('home');
321
337
  expect(result.file).toEqual('pages/home.yaml');
322
- // A page's root block renders with blockId === pageId — open-in-editor and
323
- // feedback enrichment read matches[0].location.source from this result.
338
+ // A page's root block renders with blockId === pageId — open-in-editor
339
+ // reads matches[0].location.source from this result.
324
340
  expect(result.matches.length).toEqual(1);
325
341
  expect(result.matches[0].location.source).toContain(path.join('pages', 'home.yaml'));
326
342
  });
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import { serializer } from '@lowdefy/helpers';
22
+ import { afterAll, expect, test } from 'vitest';
22
23
 
23
24
  // A server directory whose build lists an installed plugin, a local plugin
24
25
  // linked from outside node_modules, one of Lowdefy's own plugins and a local
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import path from 'node:path';
18
- import { ConfigError, resolveConfigLocation } from '@lowdefy/errors';
18
+ import { UserError, resolveConfigLocation } from '@lowdefy/errors';
19
19
  import { type } from '@lowdefy/helpers';
20
20
 
21
21
  import buildPageIfNeeded from '../server/jitPageBuilder.js';
@@ -221,7 +221,7 @@ function scanKeyMapWithDeIndex({ id, keyMap, refMap, configDirectory, pageScope,
221
221
  // "no matches" as a normal result and try another id or pageId.
222
222
  async function findConfig({ id, pageId }) {
223
223
  if (type.isNone(id) || !type.isString(id)) {
224
- throw new ConfigError(
224
+ throw new UserError(
225
225
  `findConfig requires an "id" string. Received ${JSON.stringify(id)}. ` +
226
226
  'Use GET /lowdefy-docs/find/:id.'
227
227
  );
@@ -232,8 +232,7 @@ async function findConfig({ id, pageId }) {
232
232
  const buildDirectory = path.join(process.cwd(), 'build');
233
233
 
234
234
  // A page's root block renders with blockId === pageId, so open-in-editor
235
- // and feedback enrichment hit this branch for it — they read
236
- // matches[0].location.source, so the page result must carry a match, not
235
+ // hits this branch for it — it reads matches[0].location.source, so the page result must carry a match, not
237
236
  // just the file field the docs/MCP consumers use.
238
237
  if (pageRegistry[id]) {
239
238
  const refPath = pageRegistry[id].refPath;
@@ -0,0 +1,35 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ // The block of a built page with this blockId, children included, or null.
18
+ // Children sit in the blocks of each slot and area, as pageBlocks walks them.
19
+ function findPageBlock({ page, blockId }) {
20
+ const containers = ['slots', 'areas'].flatMap((key) => Object.values(page[key] ?? {}));
21
+ for (const container of containers) {
22
+ for (const block of container?.blocks ?? []) {
23
+ if (block.blockId === blockId) {
24
+ return block;
25
+ }
26
+ const found = findPageBlock({ page: block, blockId });
27
+ if (found !== null) {
28
+ return found;
29
+ }
30
+ }
31
+ }
32
+ return null;
33
+ }
34
+
35
+ export default findPageBlock;
@@ -0,0 +1,45 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { expect, test } from 'vitest';
18
+
19
+ import findPageBlock from './findPageBlock.js';
20
+
21
+ const title = { blockId: 'title', type: 'Title' };
22
+ const card = { blockId: 'card', type: 'Card', slots: { content: { blocks: [title] } } };
23
+ const footer = { blockId: 'footer', type: 'Box' };
24
+ const page = {
25
+ id: 'home',
26
+ type: 'Box',
27
+ slots: { content: { blocks: [card] } },
28
+ areas: { footer: { blocks: [footer] } },
29
+ };
30
+
31
+ test('findPageBlock returns a top-level block with its children', () => {
32
+ expect(findPageBlock({ page, blockId: 'card' })).toBe(card);
33
+ });
34
+
35
+ test('findPageBlock finds a nested block', () => {
36
+ expect(findPageBlock({ page, blockId: 'title' })).toBe(title);
37
+ });
38
+
39
+ test('findPageBlock searches areas as well as slots', () => {
40
+ expect(findPageBlock({ page, blockId: 'footer' })).toBe(footer);
41
+ });
42
+
43
+ test('findPageBlock returns null when no block has the blockId', () => {
44
+ expect(findPageBlock({ page, blockId: 'missing' })).toBeNull();
45
+ });
@@ -18,9 +18,9 @@ import crypto from 'node:crypto';
18
18
  import fs from 'node:fs';
19
19
  import path from 'node:path';
20
20
 
21
- // Largest response returned inline, in serialized characters. The tool result
22
- // is pretty-printed, which adds roughly half again, so this keeps a result
23
- // inside the output budget of common MCP clients.
21
+ // Largest value returned inline, in serialized characters. Tool results are
22
+ // compact JSON, so a result is about this size, which keeps it inside the
23
+ // output budget of common MCP clients.
24
24
  const MAX_INLINE_RESPONSE_CHARS = 40_000;
25
25
 
26
26
  // Saved responses kept per app; the oldest beyond this are deleted on write.
@@ -51,29 +51,30 @@ function writeResponseFile({ name, response }) {
51
51
  return filePath;
52
52
  }
53
53
 
54
- // Returns the result untouched when its response fits inline. A larger
55
- // response, or any response when saveResponse is set, is written in full to
56
- // .lowdefy/responses/ in the config directory, and the result carries the
57
- // file's path and size in its place, so nothing is cut and an agent can read
58
- // or query the whole value.
59
- function fitResponse({ result, name, saveResponse = false }) {
54
+ // Returns the result untouched when its field (response, by default) fits
55
+ // inline. A larger value, or any value when saveResponse is set, is written in
56
+ // full to .lowdefy/responses/ in the config directory, and the result carries
57
+ // the file's path and size in its place (<field>File, <field>Chars and, for an
58
+ // array, <field>Items), so nothing is cut and an agent can read or query the
59
+ // whole value.
60
+ function fitResponse({ result, name, field = 'response', saveResponse = false }) {
60
61
  // A request can resolve with no response; it is written as null.
61
- const { response = null, ...rest } = result;
62
- const json = JSON.stringify(response);
62
+ const { [field]: value = null, ...rest } = result;
63
+ const json = JSON.stringify(value);
63
64
  if (!saveResponse && json.length <= MAX_INLINE_RESPONSE_CHARS) {
64
65
  return result;
65
66
  }
66
67
  const fitted = {
67
68
  ...rest,
68
- responseFile: writeResponseFile({ name, response }),
69
- responseChars: json.length,
69
+ [`${field}File`]: writeResponseFile({ name, response: value }),
70
+ [`${field}Chars`]: json.length,
70
71
  };
71
- if (Array.isArray(response)) {
72
- fitted.responseItems = response.length;
72
+ if (Array.isArray(value)) {
73
+ fitted[`${field}Items`] = value.length;
73
74
  }
74
75
  fitted.note = saveResponse
75
- ? 'The full response was written to responseFile.'
76
- : `The response is ${json.length} characters, over the ${MAX_INLINE_RESPONSE_CHARS} returned inline, so it was written in full to responseFile. Read or query that file instead.`;
76
+ ? `The full ${field} was written to ${field}File.`
77
+ : `The ${field} is ${json.length} characters, over the ${MAX_INLINE_RESPONSE_CHARS} returned inline, so it was written in full to ${field}File. Read or query that file instead.`;
77
78
  return fitted;
78
79
  }
79
80
 
@@ -19,6 +19,7 @@ import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
21
  import fitResponse, { MAX_INLINE_RESPONSE_CHARS, MAX_SAVED_RESPONSES } from './fitResponse.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let configDirectory;
24
25
 
@@ -78,6 +79,23 @@ test('fitResponse writes an oversized response to a file and returns its path in
78
79
  expect(result.response).toBe(rows);
79
80
  });
80
81
 
82
+ test('fitResponse fits the field it is given, naming the file after the field', () => {
83
+ const page = { id: 'big', blocks: 'x'.repeat(MAX_INLINE_RESPONSE_CHARS) };
84
+
85
+ const fitted = fitResponse({ result: { page }, name: 'big', field: 'page' });
86
+
87
+ expect(fitted.page).toBeUndefined();
88
+ expect(fitted.pageChars).toBe(JSON.stringify(page).length);
89
+ expect(fitted.note).toContain('The page is');
90
+ expect(fitted.note).toContain('written in full to pageFile');
91
+ expect(JSON.parse(fs.readFileSync(fitted.pageFile, 'utf8'))).toEqual(page);
92
+ });
93
+
94
+ test('fitResponse returns a small field untouched', () => {
95
+ const result = { page: { id: 'small' } };
96
+ expect(fitResponse({ result, name: 'small', field: 'page' })).toBe(result);
97
+ });
98
+
81
99
  test('fitResponse writes a small response to a file when saveResponse is set', () => {
82
100
  const result = { response: { total: 3 }, status: 'success' };
83
101
 
@@ -28,10 +28,10 @@ import recordingCookiePayload from '../server/recording/recordingCookiePayload.j
28
28
 
29
29
  // Module-level singleton, shared by every headless caller (screenshots,
30
30
  // journeys, state inspection, operator evaluation, state loads) and closed
31
- // after 90 s unused. See createBrowserLifecycle.js.
31
+ // after 45 s unused. See createBrowserLifecycle.js.
32
32
  const { getBrowser, trackContext } = createBrowserLifecycle({
33
33
  launch: launchBrowser,
34
- idleTimeout: 90_000,
34
+ idleTimeout: 45_000,
35
35
  });
36
36
 
37
37
  // `origin` should already include any configured basePath prefix that the
@@ -165,7 +165,7 @@ async function openPage({
165
165
  await page.goto(url, { waitUntil: 'load', timeout });
166
166
  // The engine builds the page context (and runs onInit + initial requests)
167
167
  // after the bundle loads — 'load' fires before that. Every caller
168
- // (screenshot, inspect, eval, checkpoint load, journeys) needs the app's
168
+ // (screenshot, inspect, eval, journeys) needs the app's
169
169
  // async lifecycle to have settled, not just the bundle to have loaded, so
170
170
  // wait on isPageReady - for the instance the app shows, which is not the
171
171
  // one asked for when the app redirects, as a protected page does for a