@lowdefy/server-dev 7.0.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 (445) 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/checkSharedCollectionIds.js +20 -9
  44. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
  45. package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
  46. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  47. package/lib/docs/dataSets/getDataStore.js +11 -3
  48. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  49. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  50. package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
  51. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  52. package/lib/docs/dataSets/openDataSession.js +36 -20
  53. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
  54. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  55. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  56. package/lib/docs/dataSets/readDataSet.js +34 -19
  57. package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
  58. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  59. package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
  60. package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
  61. package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
  62. package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
  63. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  64. package/lib/docs/devEventBus.js +7 -2
  65. package/lib/docs/devEventBus.test.mjs +12 -10
  66. package/lib/docs/devToolDefinitions.js +87 -135
  67. package/lib/docs/device/buildDeviceCommand.js +103 -0
  68. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  69. package/lib/docs/device/captureDevice.js +85 -0
  70. package/lib/docs/device/checkShownPage.js +56 -0
  71. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  72. package/lib/docs/device/deviceAction.js +74 -0
  73. package/lib/docs/device/deviceTools.test.mjs +604 -0
  74. package/lib/docs/device/findDeviceTab.js +50 -0
  75. package/lib/docs/device/findDeviceTarget.js +73 -0
  76. package/lib/docs/device/injectDevice.js +160 -0
  77. package/lib/docs/device/listDevices.js +100 -0
  78. package/lib/docs/device/listDevices.test.mjs +105 -0
  79. package/lib/docs/device/runDeviceJourney.js +68 -0
  80. package/lib/docs/device/runDeviceSteps.js +164 -0
  81. package/lib/docs/device/screenshotDevice.js +68 -0
  82. package/lib/docs/device/sendDeviceStep.js +52 -0
  83. package/lib/docs/device/startDevice.js +150 -0
  84. package/lib/docs/docs.test.mjs +44 -28
  85. package/lib/docs/docsIndex.test.mjs +1 -0
  86. package/lib/docs/findConfig.js +3 -4
  87. package/lib/docs/findPageBlock.js +35 -0
  88. package/lib/docs/findPageBlock.test.mjs +45 -0
  89. package/lib/docs/fitResponse.js +18 -17
  90. package/lib/docs/fitResponse.test.mjs +18 -0
  91. package/lib/docs/getBrowser.js +4 -4
  92. package/lib/docs/getBrowser.test.mjs +32 -16
  93. package/lib/docs/getBuildId.test.mjs +1 -0
  94. package/lib/docs/getBuildStatus.js +29 -3
  95. package/lib/docs/getBuildStatus.test.mjs +108 -12
  96. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  97. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  98. package/lib/docs/getHazards.js +4 -1
  99. package/lib/docs/getHazards.test.mjs +9 -7
  100. package/lib/docs/getOverview.js +22 -44
  101. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  102. package/lib/docs/getStaleStatus.test.mjs +1 -0
  103. package/lib/docs/inspectState.js +78 -3
  104. package/lib/docs/inspectState.test.mjs +61 -9
  105. package/lib/docs/inspectStateFromTab.js +38 -6
  106. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  107. package/lib/docs/inspectStateHeadless.js +98 -34
  108. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  109. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  110. package/lib/docs/installHeadlessShell.js +5 -2
  111. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  112. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  113. package/lib/docs/isDeepEqual.js +37 -0
  114. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  115. package/lib/docs/isPageReady.test.mjs +1 -0
  116. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  117. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  118. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  119. package/lib/docs/launchBrowser.test.mjs +8 -8
  120. package/lib/docs/listTypes.js +58 -8
  121. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  122. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  123. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  124. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  125. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  126. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  127. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  128. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  129. package/lib/docs/pollTab.js +100 -0
  130. package/lib/docs/pollTab.test.mjs +64 -0
  131. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  132. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  133. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  134. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  135. package/lib/docs/rails/findExternalBlocks.js +3 -3
  136. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  137. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  138. package/lib/docs/readJourneySession.js +1 -1
  139. package/lib/docs/reportDevToolFault.js +29 -0
  140. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  141. package/lib/docs/requestRestart.test.mjs +1 -0
  142. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  143. package/lib/docs/resolveSource.js +2 -2
  144. package/lib/docs/resolveSource.test.mjs +6 -6
  145. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  146. package/lib/docs/runCheck.test.mjs +3 -3
  147. package/lib/docs/runCheckChild.js +2 -1
  148. package/lib/docs/runEndpoint.js +23 -10
  149. package/lib/docs/runEndpoint.test.mjs +42 -37
  150. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  151. package/lib/docs/runJourney.js +21 -1
  152. package/lib/docs/runJourney.test.mjs +119 -99
  153. package/lib/docs/runJourneyDataSet.test.mjs +26 -26
  154. package/lib/docs/runJourneySteps.js +8 -29
  155. package/lib/docs/runRequest.js +6 -6
  156. package/lib/docs/runRequest.test.mjs +22 -22
  157. package/lib/docs/screenshotPage.js +6 -7
  158. package/lib/docs/screenshotPage.test.mjs +46 -46
  159. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  160. package/lib/docs/searchDocs.test.mjs +1 -0
  161. package/lib/docs/searchIcons.test.mjs +5 -5
  162. package/lib/docs/selectFinalState.test.mjs +1 -0
  163. package/lib/docs/serverErrorStore.test.mjs +4 -4
  164. package/lib/docs/setupTestFixtures.mjs +25 -0
  165. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  166. package/lib/docs/tabAvailable.js +1 -1
  167. package/lib/docs/tabChannel.js +90 -14
  168. package/lib/docs/tabChannel.test.mjs +40 -15
  169. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  170. package/lib/docs/validateStateSelection.test.mjs +1 -0
  171. package/lib/docs/validateViewport.test.mjs +1 -0
  172. package/lib/docs/waitForBuild.test.mjs +1 -0
  173. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  174. package/lib/docs/withDataSession.js +2 -2
  175. package/lib/server/applyDataSetRedirect.js +14 -5
  176. package/lib/server/applyDataSetRedirect.test.mjs +121 -15
  177. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
  178. package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
  179. package/lib/server/auth/getHeadlessUser.js +6 -0
  180. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  181. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  182. package/lib/server/contextMapBudget.test.mjs +3 -3
  183. package/lib/server/continueJitKeys.test.mjs +1 -0
  184. package/lib/server/createLowdefyContext.js +8 -4
  185. package/lib/server/createLowdefyContext.test.mjs +38 -35
  186. package/lib/server/getClientAddress.test.mjs +2 -2
  187. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  188. package/lib/server/importAppCode.test.mjs +2 -2
  189. package/lib/server/jitPageBuilder.js +27 -3
  190. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  191. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  192. package/lib/server/jitPageBuilder.test.mjs +4 -4
  193. package/lib/server/journeyCookies.test.mjs +1 -0
  194. package/lib/server/loadDynamicJsMap.js +10 -1
  195. package/lib/server/log/createHandleError.js +10 -5
  196. package/lib/server/log/createHandleError.test.mjs +19 -8
  197. package/lib/server/log/createLogger.test.mjs +2 -2
  198. package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
  199. package/lib/server/mutants/listMutants.test.mjs +1 -0
  200. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  201. package/lib/server/mutants/operators.test.mjs +1 -0
  202. package/lib/server/pageBuildRecords.test.mjs +1 -0
  203. package/lib/server/pageCache.test.mjs +1 -0
  204. package/lib/server/pageRebuilds.test.mjs +3 -3
  205. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  206. package/lib/server/pruneJitMaps.test.mjs +1 -0
  207. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  208. package/lib/server/readInstanceRecord.test.mjs +24 -8
  209. package/lib/server/readMergedMaps.test.mjs +1 -0
  210. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  211. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  212. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  213. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  214. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  215. package/lib/server/startIdleGc.test.mjs +25 -9
  216. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  217. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  218. package/manager/getContext.mjs +11 -2
  219. package/manager/processes/checkPendingPlugins.mjs +49 -0
  220. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  221. package/manager/processes/createIdleChild.mjs +141 -0
  222. package/manager/processes/createIdleChild.test.mjs +209 -0
  223. package/manager/processes/initialBuild.mjs +4 -15
  224. package/manager/processes/initialBuild.test.mjs +8 -37
  225. package/manager/processes/lowdefyBuild.mjs +11 -7
  226. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
  227. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  228. package/manager/processes/restartServer.test.mjs +63 -15
  229. package/manager/processes/shutdownServer.test.mjs +3 -3
  230. package/manager/processes/startFirstServer.test.mjs +23 -22
  231. package/manager/processes/startMailSink.mjs +11 -3
  232. package/manager/processes/startMailSink.test.mjs +28 -2
  233. package/manager/processes/startProxy.mjs +158 -27
  234. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  235. package/manager/processes/startProxy.test.mjs +127 -2
  236. package/manager/processes/startServer.mjs +5 -7
  237. package/manager/processes/startServer.test.mjs +10 -9
  238. package/manager/processes/syncServer.mjs +31 -4
  239. package/manager/processes/syncServer.test.mjs +71 -6
  240. package/manager/processes/waitForDevServer.test.mjs +21 -6
  241. package/manager/run.mjs +32 -8
  242. package/manager/utils/BatchChanges.mjs +1 -1
  243. package/manager/utils/BatchChanges.test.mjs +4 -4
  244. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  245. package/manager/utils/checkPairing.mjs +45 -0
  246. package/manager/utils/checkPairing.test.mjs +53 -0
  247. package/manager/utils/createBuildActivity.mjs +5 -1
  248. package/manager/utils/createBuildActivity.test.mjs +2 -2
  249. package/manager/utils/createChangeSignal.test.mjs +5 -5
  250. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  251. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  252. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  253. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  254. package/manager/utils/createGlobIgnore.mjs +45 -0
  255. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  256. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  257. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  258. package/manager/utils/createIdleGc.test.mjs +31 -15
  259. package/manager/utils/createLanPairing.mjs +34 -0
  260. package/manager/utils/createLanPairing.test.mjs +46 -0
  261. package/manager/utils/createRequestActivity.mjs +30 -3
  262. package/manager/utils/createRequestActivity.test.mjs +76 -22
  263. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  264. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  265. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  266. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  267. package/manager/utils/findSignInCode.test.mjs +33 -0
  268. package/manager/utils/formatLanPairing.mjs +32 -0
  269. package/manager/utils/formatLanPairing.test.mjs +40 -0
  270. package/manager/utils/getLanAddress.mjs +83 -0
  271. package/manager/utils/getLanAddress.test.mjs +70 -0
  272. package/manager/utils/importFresh.test.mjs +1 -0
  273. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  274. package/manager/utils/pluginTypeCache.mjs +100 -0
  275. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  276. package/manager/utils/pruneRecordings.test.mjs +1 -0
  277. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  278. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  279. package/manager/utils/readBasePath.test.mjs +1 -0
  280. package/manager/utils/readManagerVersion.test.mjs +1 -0
  281. package/manager/utils/readPluginDefinitions.mjs +6 -6
  282. package/manager/utils/renderTerminalQr.mjs +54 -0
  283. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  284. package/manager/utils/setupWatcher.mjs +19 -4
  285. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  286. package/manager/utils/waitForChildExit.test.mjs +2 -2
  287. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  288. package/manager/watchers/envWatcher.mjs +3 -0
  289. package/manager/watchers/envWatcher.test.mjs +19 -7
  290. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  291. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  292. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  293. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  294. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  295. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  296. package/manager/watchers/resolveFile.mjs +46 -0
  297. package/manager/watchers/resolveFile.test.mjs +67 -0
  298. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  299. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  300. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  301. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  302. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  303. package/package.json +50 -49
  304. package/package.original.json +50 -49
  305. package/src/app.js +83 -85
  306. package/src/html/renderDevPage.test.mjs +1 -0
  307. package/src/lib/getPathSegments.js +16 -1
  308. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  309. package/src/lib/isTabAnswer.js +32 -0
  310. package/src/lib/isTabChannelCaller.js +35 -0
  311. package/src/middleware/apiContext.js +4 -2
  312. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  313. package/src/middleware/errorHandler.js +33 -45
  314. package/src/middleware/errorHandler.test.mjs +10 -10
  315. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  316. package/src/middleware/localDevToolsOnly.js +13 -1
  317. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  318. package/src/middleware/noStore.test.mjs +1 -0
  319. package/src/middleware/staleFlag.test.mjs +1 -0
  320. package/src/middleware/stampCaller.test.mjs +1 -0
  321. package/src/routes/agentBearer.test.mjs +183 -0
  322. package/src/routes/auth.test.mjs +10 -10
  323. package/src/routes/clientError.js +21 -4
  324. package/src/routes/clientError.test.mjs +127 -0
  325. package/src/routes/devInspect.js +6 -51
  326. package/src/routes/devInspect.test.mjs +128 -3
  327. package/src/routes/devRecording.js +6 -17
  328. package/src/routes/devRecording.test.mjs +54 -3
  329. package/src/routes/docs/buildStatus.test.mjs +6 -6
  330. package/src/routes/docs/events.test.mjs +4 -4
  331. package/src/routes/docs/find.js +3 -3
  332. package/src/routes/docs/journey.test.mjs +8 -8
  333. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  334. package/src/routes/docs/loadDocsRoutes.js +70 -0
  335. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  336. package/src/routes/docs/mcp.test.mjs +5 -5
  337. package/src/routes/docs/mutants.js +7 -0
  338. package/src/routes/docs/mutants.test.mjs +20 -6
  339. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  340. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  341. package/src/routes/docs/restart.test.mjs +1 -0
  342. package/src/routes/endpoints.js +24 -0
  343. package/src/routes/endpointsLink.test.mjs +111 -0
  344. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  345. package/src/routes/jitPage.js +13 -1
  346. package/src/routes/jitPage.test.mjs +36 -11
  347. package/src/routes/mcp.js +6 -0
  348. package/src/routes/mcp.test.mjs +23 -8
  349. package/src/routes/mcpMemberToken.test.mjs +8 -8
  350. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  351. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  352. package/src/routes/mobileRoutes.test.mjs +223 -0
  353. package/src/routes/mobileSignIn.js +58 -0
  354. package/src/routes/mobileSignIn.test.mjs +59 -0
  355. package/src/routes/mobileSignInCallback.js +34 -0
  356. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  357. package/src/routes/mountDevPageRoutes.js +10 -2
  358. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  359. package/src/routes/mountMobileWellKnown.js +35 -0
  360. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  361. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  362. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  363. package/src/routes/reload.js +101 -20
  364. package/src/routes/reload.test.mjs +153 -0
  365. package/src/routes/request.js +1 -22
  366. package/src/routes/request.test.mjs +7 -24
  367. package/src/routes/requestBody.test.mjs +14 -27
  368. package/src/routes/websocket.test.mjs +2 -2
  369. package/src/routes/wellKnownFallback.test.mjs +2 -2
  370. package/src/websocket/devWebSocket.test.mjs +12 -12
  371. package/vite.config.js +13 -1
  372. package/client/feedback/FeedbackMount.jsx +0 -83
  373. package/client/feedback/FeedbackOverlay.jsx +0 -904
  374. package/client/feedback/captureTabScreenshot.js +0 -84
  375. package/client/feedback/copyToClipboard.js +0 -45
  376. package/client/feedback/drawAnnotationsSvg.js +0 -119
  377. package/client/feedback/feedbackStyles.js +0 -304
  378. package/client/feedback/pinResponsiveImages.js +0 -59
  379. package/client/feedback/sendFeedback.js +0 -39
  380. package/client/feedback/useFeedbackToggle.js +0 -70
  381. package/client/recorder/buildEngineRecord.js +0 -37
  382. package/client/recorder/buildInteractionRecord.js +0 -64
  383. package/client/recorder/buildTraceEvent.js +0 -57
  384. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  385. package/client/recorder/chunkRecords.js +0 -69
  386. package/client/recorder/chunkRecords.test.mjs +0 -59
  387. package/client/recorder/collectEventEndpoints.js +0 -40
  388. package/client/recorder/collectEventRequests.js +0 -39
  389. package/client/recorder/createPairingBuffer.js +0 -187
  390. package/client/recorder/createPasswordRedactor.js +0 -84
  391. package/client/recorder/createRecordBatcher.js +0 -54
  392. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  393. package/client/recorder/createRecordingSession.js +0 -61
  394. package/client/recorder/createRecordingSession.test.mjs +0 -72
  395. package/client/recorder/diffStateWrites.js +0 -77
  396. package/client/recorder/diffStateWrites.test.mjs +0 -66
  397. package/client/recorder/isEventCall.js +0 -30
  398. package/client/recorder/jsonType.js +0 -39
  399. package/client/recorder/sendRecords.js +0 -40
  400. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  401. package/lib/docs/checkpointPaths.js +0 -91
  402. package/lib/docs/checkpointStore.js +0 -243
  403. package/lib/docs/checkpointToMocks.js +0 -65
  404. package/lib/docs/configCheckpoints.test.mjs +0 -156
  405. package/lib/docs/createConfigCheckpoint.js +0 -92
  406. package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
  407. package/lib/docs/devMockRegistry.js +0 -68
  408. package/lib/docs/enrichFeedback.js +0 -71
  409. package/lib/docs/evalOperator.js +0 -49
  410. package/lib/docs/evalOperator.test.mjs +0 -157
  411. package/lib/docs/evalOperatorHeadless.js +0 -159
  412. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  413. package/lib/docs/evalOperatorInTab.js +0 -49
  414. package/lib/docs/formatFeedback.js +0 -142
  415. package/lib/docs/formatFeedback.test.mjs +0 -252
  416. package/lib/docs/getPluginDoc.js +0 -53
  417. package/lib/docs/listConfigCheckpoints.js +0 -55
  418. package/lib/docs/loadState.js +0 -220
  419. package/lib/docs/revertConfigCheckpoint.js +0 -73
  420. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  421. package/lib/docs/scaffoldPage.js +0 -77
  422. package/lib/docs/scaffoldPage.test.mjs +0 -97
  423. package/lib/docs/snapshotState.js +0 -67
  424. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  425. package/manager/watchers/listServerSidePackages.mjs +0 -47
  426. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  427. package/src/routes/docs/checkpointsCreate.js +0 -28
  428. package/src/routes/docs/evalOperator.js +0 -70
  429. package/src/routes/docs/inspectState.js +0 -59
  430. package/src/routes/docs/loadState.js +0 -51
  431. package/src/routes/docs/pluginDoc.js +0 -33
  432. package/src/routes/docs/plugins.js +0 -23
  433. package/src/routes/docs/runEndpoint.js +0 -54
  434. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  435. package/src/routes/docs/runRequest.js +0 -53
  436. package/src/routes/docs/runRequest.test.mjs +0 -92
  437. package/src/routes/docs/schema.js +0 -37
  438. package/src/routes/docs/screenshot.js +0 -120
  439. package/src/routes/docs/screenshot.test.mjs +0 -117
  440. package/src/routes/docs/search.js +0 -40
  441. package/src/routes/docs/snapshotState.js +0 -50
  442. package/src/routes/docs/stateCheckpointsList.js +0 -26
  443. package/src/routes/docs/types.js +0 -33
  444. package/src/routes/feedback.js +0 -107
  445. package/src/routes/feedback.test.mjs +0 -204
@@ -14,21 +14,49 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
+ import fs from 'fs';
18
+
17
19
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
20
+ import { vi, afterEach, expect, test } from 'vitest';
21
+ import { serializer } from '@lowdefy/helpers';
19
22
 
20
23
  const { listTabs, registerTab, requestFromTab, unregisterTab, updateTabPage } = await import(
21
24
  '../../lib/docs/tabChannel.js'
22
25
  );
23
26
  const { default: devInspectHandler } = await import('./devInspect.js');
27
+ const { default: inspectStateFromTab } = await import('../../lib/docs/inspectStateFromTab.js');
28
+ const { default: isTabAnswer } = await import('../lib/isTabAnswer.js');
29
+ const { default: localDevToolsOnly } = await import('../middleware/localDevToolsOnly.js');
30
+
31
+ // The tab channel's payloads, shared with @lowdefy/shell's dev-tab client tests.
32
+ const fixtures = JSON.parse(
33
+ fs.readFileSync(new URL('../../test/tabChannelFixtures.json', import.meta.url), 'utf8')
34
+ );
24
35
 
36
+ // As app.js mounts it: a phone paired with lowdefy dev --lan may answer, nothing else.
25
37
  function createApp() {
26
38
  const app = new Hono();
39
+ const tabChannelOnly = localDevToolsOnly({ allowPaired: isTabAnswer });
40
+ app.use('/api/dev-inspect', tabChannelOnly);
41
+ app.use('/api/dev-inspect/*', tabChannelOnly);
27
42
  app.all('/api/dev-inspect', devInspectHandler);
28
43
  app.all('/api/dev-inspect/*', devInspectHandler);
29
44
  return app;
30
45
  }
31
46
 
47
+ // A phone shell (Lowdefy Dev) sends no Origin; it names itself with x-lowdefy-shell. The
48
+ // manager's proxy marks one paired over the network with x-lowdefy-dev-remote.
49
+ const shellHeaders = {
50
+ host: 'localhost:3001',
51
+ 'content-type': 'application/json',
52
+ 'x-lowdefy-shell': '7.0.0',
53
+ };
54
+ const pairedShellHeaders = {
55
+ ...shellHeaders,
56
+ host: '192.168.1.20:3001',
57
+ 'x-lowdefy-dev-remote': '1',
58
+ };
59
+
32
60
  const sameOriginHeaders = {
33
61
  host: 'localhost:3001',
34
62
  origin: 'http://localhost:3001',
@@ -41,7 +69,7 @@ afterEach(() => {
41
69
  listTabs().forEach((tab) => unregisterTab({ id: tab.id }));
42
70
  });
43
71
 
44
- function connectTab({ id, pageId, send = jest.fn() }) {
72
+ function connectTab({ id, pageId, send = vi.fn() }) {
45
73
  registerTab({ id, send });
46
74
  updateTabPage({ id, pageId, pathParams: {}, instanceKey: `page:${pageId}` });
47
75
  }
@@ -131,7 +159,7 @@ test('POST /api/dev-inspect/page for a tab that already disconnected returns ok'
131
159
  });
132
160
 
133
161
  test('POST /api/dev-inspect resolves a pending tab request with the posted result', async () => {
134
- const send = jest.fn();
162
+ const send = vi.fn();
135
163
  connectTab({ id: 'tab-1', pageId: 'home', send });
136
164
  const pending = requestFromTab({ pageId: 'home', event: 'inspect-request' });
137
165
  const [, { requestId }] = send.mock.calls[0];
@@ -154,3 +182,100 @@ test('POST /api/dev-inspect returns 400 when requestId is missing', async () =>
154
182
  });
155
183
  expect(res.status).toBe(400);
156
184
  });
185
+
186
+ function connectFixtureTab(send) {
187
+ registerTab({ id: 'phone', send });
188
+ updateTabPage({ id: 'phone', ...fixtures.page });
189
+ }
190
+
191
+ test("an inspect-request carries the page instance, and a shell's answer reads as the browser tab's", async () => {
192
+ const send = vi.fn();
193
+ connectFixtureTab(send);
194
+ const pending = inspectStateFromTab({ pageId: fixtures.page.pageId });
195
+ const [event, request] = send.mock.calls[0];
196
+ expect(event).toBe(fixtures.inspectRequest.event);
197
+ expect(request).toEqual({
198
+ requestId: expect.any(String),
199
+ ...fixtures.page,
200
+ ...fixtures.inspectRequest.payload,
201
+ });
202
+
203
+ const res = await createApp().request('/api/dev-inspect', {
204
+ method: 'POST',
205
+ headers: pairedShellHeaders,
206
+ body: JSON.stringify({
207
+ requestId: request.requestId,
208
+ result: serializer.serializeToString(fixtures.inspectResult),
209
+ }),
210
+ });
211
+ expect(res.status).toBe(200);
212
+ await expect(pending).resolves.toEqual(fixtures.inspectResult);
213
+ });
214
+
215
+ test("an eval-request carries the expression, and a shell's answer reads as the browser tab's", async () => {
216
+ const send = vi.fn();
217
+ connectFixtureTab(send);
218
+ const pending = inspectStateFromTab({
219
+ pageId: fixtures.page.pageId,
220
+ evaluate: true,
221
+ expression: fixtures.evalRequest.payload.expression,
222
+ });
223
+ const [event, request] = send.mock.calls[0];
224
+ expect(event).toBe(fixtures.evalRequest.event);
225
+ expect(request).toEqual({
226
+ requestId: expect.any(String),
227
+ ...fixtures.page,
228
+ ...fixtures.evalRequest.payload,
229
+ });
230
+
231
+ await createApp().request('/api/dev-inspect', {
232
+ method: 'POST',
233
+ headers: shellHeaders,
234
+ body: JSON.stringify({
235
+ requestId: request.requestId,
236
+ result: {
237
+ value: serializer.serializeToString(fixtures.evalResult.value),
238
+ errors: fixtures.evalResult.errors,
239
+ },
240
+ }),
241
+ });
242
+ await expect(pending).resolves.toEqual(fixtures.evalResult);
243
+ });
244
+
245
+ test('a paired phone shell posts the page it shows', async () => {
246
+ connectFixtureTab(vi.fn());
247
+ const res = await createApp().request('/api/dev-inspect/page', {
248
+ method: 'POST',
249
+ headers: pairedShellHeaders,
250
+ body: JSON.stringify({ tabId: 'phone', pageId: 'home', instanceKey: 'page:home' }),
251
+ });
252
+ expect(res.status).toBe(200);
253
+ expect(listTabs()[0].pageId).toBe('home');
254
+ });
255
+
256
+ test.each([
257
+ ['lists the tabs', 'GET', '/api/dev-inspect'],
258
+ ['gets another route', 'GET', '/api/dev-inspect/tabs/phone'],
259
+ ['posts to another route', 'POST', '/api/dev-inspect/tabs/phone'],
260
+ ])('a paired phone shell is refused when it %s', async (_, method, path) => {
261
+ const res = await createApp().request(path, { method, headers: pairedShellHeaders });
262
+ expect(res.status).toBe(403);
263
+ });
264
+
265
+ test('a request with no Origin that does not name a shell is refused', async () => {
266
+ const res = await createApp().request('/api/dev-inspect', {
267
+ method: 'POST',
268
+ headers: { host: 'localhost:3001', 'content-type': 'application/json' },
269
+ body: JSON.stringify({ requestId: 'r', result: {} }),
270
+ });
271
+ expect(res.status).toBe(403);
272
+ });
273
+
274
+ test('a page on another site is refused even when it names a shell', async () => {
275
+ const res = await createApp().request('/api/dev-inspect', {
276
+ method: 'POST',
277
+ headers: { ...shellHeaders, origin: 'https://evil.example' },
278
+ body: JSON.stringify({ requestId: 'r', result: {} }),
279
+ });
280
+ expect(res.status).toBe(403);
281
+ });
@@ -20,25 +20,11 @@ import appendRecords from '../../lib/server/recording/appendRecords.js';
20
20
  import getBuildId from '../../lib/docs/getBuildId.js';
21
21
  import readRecordingCookie from '../../lib/server/recording/readRecordingCookie.js';
22
22
  import servedBuilds from '../../lib/server/recording/servedBuilds.js';
23
- import { getConfigDirectory } from '../../lib/docs/checkpointPaths.js';
23
+ import isTabChannelCaller from '../lib/isTabChannelCaller.js';
24
+ import getConfigDirectory from '../../lib/docs/getConfigDirectory.js';
24
25
 
25
26
  const MAX_RECORDS = 500;
26
27
 
27
- // This route writes to disk, so unlike localDevToolsOnly it does not let a
28
- // request with no Origin through: only the recorder in a same-origin dev tab
29
- // posts here. Agents and curl have no reason to.
30
- function isSameOrigin(c) {
31
- const origin = c.req.header('origin');
32
- if (!origin) {
33
- return false;
34
- }
35
- try {
36
- return new URL(origin).host === c.req.header('host');
37
- } catch {
38
- return false;
39
- }
40
- }
41
-
42
28
  async function readBody(c) {
43
29
  try {
44
30
  return await c.req.json();
@@ -77,7 +63,10 @@ function stampRecord({ record, currentBuild, cookie }) {
77
63
  // (or the build served now) and is appended to the trace file of its tab
78
64
  // session (dev) or run (journey).
79
65
  async function devRecordingHandler(c) {
80
- if (!isSameOrigin(c)) {
66
+ // This route writes to disk, so unlike the dev tools it does not let any
67
+ // request with no Origin through: only a dev tab's recorder posts here, a
68
+ // browser tab's (same origin) or a phone shell's.
69
+ if (!isTabChannelCaller(c)) {
81
70
  return c.json({ error: 'Forbidden' }, 403);
82
71
  }
83
72
  if (process.env.LOWDEFY_DEV_RECORD === 'false') {
@@ -19,9 +19,11 @@ import os from 'os';
19
19
  import path from 'path';
20
20
  import { Hono } from 'hono';
21
21
  import { bodyLimit } from 'hono/body-limit';
22
- import { jest } from '@jest/globals';
22
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
23
+ import { buildSessionReport, readRecordings } from '@lowdefy/node-utils';
24
+ import validateTraceRecord from '@lowdefy/node-utils/journeyTrace/validateTraceRecord.js';
23
25
 
24
- jest.unstable_mockModule('../../lib/docs/getBuildId.js', () => ({
26
+ vi.doMock('../../lib/docs/getBuildId.js', () => ({
25
27
  default: () => '2026-10-03T14:02:00.000Z',
26
28
  }));
27
29
 
@@ -40,7 +42,7 @@ let configDirectory;
40
42
 
41
43
  function createApp() {
42
44
  const app = new Hono();
43
- app.use('/api/dev-recording', localDevToolsOnly());
45
+ app.use('/api/dev-recording', localDevToolsOnly({ allowPaired: (c) => c.req.method === 'POST' }));
44
46
  app.post('/api/dev-recording', bodyLimit({ maxSize: 1024 * 1024 }), devRecordingHandler);
45
47
  return app;
46
48
  }
@@ -120,6 +122,55 @@ test('POST /api/dev-recording refuses a request with no Origin', async () => {
120
122
  expect(tracesExist()).toBe(false);
121
123
  });
122
124
 
125
+ test("POST /api/dev-recording writes a phone shell's records, which carry no Origin", async () => {
126
+ const res = await createApp().request('/api/dev-recording', {
127
+ method: 'POST',
128
+ headers: {
129
+ host: '192.168.1.20:3001',
130
+ 'content-type': 'application/json',
131
+ 'x-lowdefy-shell': '7.0.0',
132
+ 'x-lowdefy-dev-remote': '1',
133
+ },
134
+ body: JSON.stringify({ session: SESSION, records: [record()] }),
135
+ });
136
+ expect(res.status).toBe(204);
137
+ expect(readLines('dev', '2026-10-03', `${SESSION}.jsonl`)).toHaveLength(1);
138
+ });
139
+
140
+ // What Lowdefy Dev's recorder writes for a click, a fill and a select on a phone (shell
141
+ // src/dev/recorder/createNativeRecorder.test.js checks it writes exactly these).
142
+ const nativeFixture = JSON.parse(
143
+ fs.readFileSync(new URL('../../test/nativeRecordingFixture.json', import.meta.url), 'utf8')
144
+ );
145
+
146
+ test("a phone's native records pass the trace record validation and list as a session", async () => {
147
+ const { records } = nativeFixture;
148
+ const { session } = records[0];
149
+ const res = await createApp().request('/api/dev-recording', {
150
+ method: 'POST',
151
+ headers: {
152
+ host: '192.168.1.20:3001',
153
+ 'content-type': 'application/json',
154
+ 'x-lowdefy-shell': '7.4.0',
155
+ 'x-lowdefy-dev-remote': '1',
156
+ },
157
+ body: JSON.stringify({ session, records }),
158
+ });
159
+ expect(res.status).toBe(204);
160
+ const lines = readLines('dev', '2026-10-18', `${session}.jsonl`);
161
+ expect(lines.map((line) => line.kind)).toEqual(['pageview', 'change', 'change', 'click']);
162
+ lines.forEach((line) => {
163
+ expect(validateTraceRecord({ record: line })).toEqual({});
164
+ expect(line).toMatchObject({ source: 'dev', device: 'ios', shell_version: '7.4.0' });
165
+ });
166
+ const { sessions } = buildSessionReport({
167
+ records: readRecordings({ configDirectory, source: 'dev' }),
168
+ });
169
+ expect(sessions).toEqual([
170
+ expect.objectContaining({ id: session, pages: ['ticket'], interactions: 3, failures: 0 }),
171
+ ]);
172
+ });
173
+
123
174
  test('POST /api/dev-recording answers 400 for a session id that is not a trace id', async () => {
124
175
  for (const session of ['../x', '', `${SESSION}/../../x`]) {
125
176
  const res = await post({ body: { session, records: [record()] } });
@@ -14,22 +14,22 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, expect, test } from 'vitest';
18
18
  import { Hono } from 'hono';
19
19
 
20
- jest.unstable_mockModule('../../../lib/docs/clientErrorStore.js', () => ({
20
+ vi.doMock('../../../lib/docs/clientErrorStore.js', () => ({
21
21
  default: { list: () => [] },
22
22
  }));
23
- jest.unstable_mockModule('../../../lib/docs/serverErrorStore.js', () => ({
23
+ vi.doMock('../../../lib/docs/serverErrorStore.js', () => ({
24
24
  default: { list: () => [] },
25
25
  }));
26
- jest.unstable_mockModule('../../../lib/docs/getBuildId.js', () => ({
26
+ vi.doMock('../../../lib/docs/getBuildId.js', () => ({
27
27
  default: () => '2026-10-03T08:00:00.000Z',
28
28
  }));
29
- jest.unstable_mockModule('../../../lib/docs/getPageBuildStatus.js', () => ({
29
+ vi.doMock('../../../lib/docs/getPageBuildStatus.js', () => ({
30
30
  default: () => ({ unbuilt: 0 }),
31
31
  }));
32
- jest.unstable_mockModule('../../../lib/docs/readBuildArtifact.js', () => ({
32
+ vi.doMock('../../../lib/docs/readBuildArtifact.js', () => ({
33
33
  default: () => ({ status: 'ok', errors: [], warnings: [] }),
34
34
  }));
35
35
 
@@ -15,11 +15,11 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, beforeEach, expect, test } from 'vitest';
19
19
 
20
- const mockSubscribe = jest.fn();
21
- const mockUnsubscribe = jest.fn();
22
- jest.unstable_mockModule('../../../lib/docs/devEventBus.js', () => ({
20
+ const mockSubscribe = vi.fn();
21
+ const mockUnsubscribe = vi.fn();
22
+ vi.doMock('../../../lib/docs/devEventBus.js', () => ({
23
23
  bootedAt: '2026-05-06T07:08:09.000Z',
24
24
  subscribe: mockSubscribe,
25
25
  }));
@@ -14,11 +14,11 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { ConfigError } from '@lowdefy/errors';
17
+ import { UserError } from '@lowdefy/errors';
18
18
 
19
19
  import findConfig from '../../../lib/docs/findConfig.js';
20
20
 
21
- // findConfig throws a ConfigError only for a missing or non-string id; every
21
+ // findConfig throws a UserError only for a missing or non-string id; every
22
22
  // other failure is a fault and propagates to the error handler rather than
23
23
  // being reported to the caller as bad input.
24
24
  async function docsFindHandler(c) {
@@ -28,7 +28,7 @@ async function docsFindHandler(c) {
28
28
  const result = await findConfig({ id, pageId });
29
29
  return c.json(result);
30
30
  } catch (error) {
31
- if (error instanceof ConfigError) {
31
+ if (error instanceof UserError) {
32
32
  return c.json({ error: error.message }, 400);
33
33
  }
34
34
  throw error;
@@ -14,18 +14,18 @@
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 mockRunJourney = jest.fn();
19
+ const mockRunJourney = vi.fn();
20
20
 
21
- jest.unstable_mockModule('../../../lib/docs/runJourney.js', () => ({
21
+ vi.doMock('../../../lib/docs/runJourney.js', () => ({
22
22
  default: mockRunJourney,
23
23
  }));
24
- jest.unstable_mockModule('../../../lib/build/config.js', () => ({
24
+ vi.doMock('../../../lib/build/config.js', () => ({
25
25
  default: { basePath: '/app' },
26
26
  }));
27
- const mockGetBuildId = jest.fn(() => 'build-1');
28
- jest.unstable_mockModule('../../../lib/docs/getBuildId.js', () => ({
27
+ const mockGetBuildId = vi.fn(() => 'build-1');
28
+ vi.doMock('../../../lib/docs/getBuildId.js', () => ({
29
29
  default: mockGetBuildId,
30
30
  }));
31
31
  const { readMutantRun } = await import('../../../lib/server/mutants/mutantRuns.js');
@@ -39,12 +39,12 @@ function createContext(body) {
39
39
  headers: { 'content-type': 'application/json' },
40
40
  body: JSON.stringify(body),
41
41
  });
42
- const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
42
+ const json = vi.fn((data, status) => ({ data, status: status ?? 200 }));
43
43
  return { req: { url: request.url, json: () => request.json() }, json };
44
44
  }
45
45
 
46
46
  beforeEach(() => {
47
- jest.clearAllMocks();
47
+ vi.clearAllMocks();
48
48
  mockRunJourney.mockResolvedValue({
49
49
  pageId: 'form',
50
50
  passed: true,
@@ -14,19 +14,19 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, expect, test } from 'vitest';
18
18
 
19
19
  // The real runner refuses these journeys before it fetches a browser; the mock
20
20
  // proves it never gets that far.
21
- const mockGetBrowser = jest.fn();
22
- jest.unstable_mockModule('../../../lib/docs/getBrowser.js', () => ({
21
+ const mockGetBrowser = vi.fn();
22
+ vi.doMock('../../../lib/docs/getBrowser.js', () => ({
23
23
  getBrowser: mockGetBrowser,
24
- openPage: jest.fn(),
25
- buildPageUrl: jest.fn(),
24
+ openPage: vi.fn(),
25
+ buildPageUrl: vi.fn(),
26
26
  }));
27
- jest.unstable_mockModule('../../../lib/build/config.js', () => ({ default: { basePath: '' } }));
28
- jest.unstable_mockModule('../../../lib/docs/getBuildId.js', () => ({
29
- default: jest.fn(() => 'build-1'),
27
+ vi.doMock('../../../lib/build/config.js', () => ({ default: { basePath: '' } }));
28
+ vi.doMock('../../../lib/docs/getBuildId.js', () => ({
29
+ default: vi.fn(() => 'build-1'),
30
30
  }));
31
31
 
32
32
  const { default: docsJourneyHandler } = await import('./journey.js');
@@ -37,7 +37,7 @@ function createContext(body) {
37
37
  headers: { 'content-type': 'application/json' },
38
38
  body: JSON.stringify(body),
39
39
  });
40
- const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
40
+ const json = vi.fn((data, status) => ({ data, status: status ?? 200 }));
41
41
  return { req: { url: request.url, json: () => request.json() }, json };
42
42
  }
43
43
 
@@ -0,0 +1,70 @@
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
+ let loading = null;
18
+
19
+ // The docs routes and the docs index they search, loaded on first use: their
20
+ // module graph (the MCP server, the journey runner, the doc readers) is most of
21
+ // what a child would otherwise evaluate before it answers its first request.
22
+ // Every caller shares one load, so the modules are evaluated once. A failed
23
+ // load is not kept, so the next docs request tries again.
24
+ function loadDocsRoutes() {
25
+ if (loading === null) {
26
+ loading = Promise.all([
27
+ import('./buildStatus.js'),
28
+ import('./events.js'),
29
+ import('./find.js'),
30
+ import('./index.js'),
31
+ import('./journey.js'),
32
+ import('./mcp.js'),
33
+ import('./mutants.js'),
34
+ import('./pageConfig.js'),
35
+ import('./restart.js'),
36
+ import('../../../lib/docs/getDocsIndex.js'),
37
+ ]).then(
38
+ ([
39
+ buildStatus,
40
+ events,
41
+ find,
42
+ index,
43
+ journey,
44
+ mcp,
45
+ mutants,
46
+ pageConfig,
47
+ restart,
48
+ docsIndex,
49
+ ]) => ({
50
+ buildStatus: buildStatus.default,
51
+ events: events.default,
52
+ find: find.default,
53
+ index: index.default,
54
+ journey: journey.default,
55
+ mcp: mcp.default,
56
+ mutants: mutants.default,
57
+ pageConfig: pageConfig.default,
58
+ restart: restart.default,
59
+ getDocsIndex: docsIndex.default,
60
+ }),
61
+ (error) => {
62
+ loading = null;
63
+ throw error;
64
+ }
65
+ );
66
+ }
67
+ return loading;
68
+ }
69
+
70
+ export default loadDocsRoutes;
@@ -0,0 +1,110 @@
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
+ import fs from 'node:fs';
17
+ import os from 'node:os';
18
+ import path from 'node:path';
19
+ import { fileURLToPath } from 'node:url';
20
+
21
+ import { createServer } from 'vite';
22
+ import { afterAll, beforeAll, expect, test, vi } from 'vitest';
23
+
24
+ const serverRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
25
+ const libDocsDirectory = path.join(serverRoot, 'lib', 'docs') + path.sep;
26
+
27
+ let vite;
28
+ let serverDirectory;
29
+
30
+ // The dev server loads src/app.js through Vite's SSR graph, so the docs routes
31
+ // are loaded that way here too: once statically (as reload.js and the other
32
+ // eager routes reach lib/docs) and once through loadDocsRoutes.
33
+ beforeAll(async () => {
34
+ serverDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'load-docs-routes-'));
35
+ fs.mkdirSync(path.join(serverDirectory, 'build'));
36
+ fs.writeFileSync(path.join(serverDirectory, 'build', 'config.json'), '{}');
37
+ vi.spyOn(process, 'cwd').mockReturnValue(serverDirectory);
38
+ vite = await createServer({
39
+ root: serverRoot,
40
+ configFile: false,
41
+ logLevel: 'silent',
42
+ appType: 'custom',
43
+ optimizeDeps: { noDiscovery: true, include: [] },
44
+ server: { middlewareMode: true, hmr: false, watch: null, ws: false },
45
+ });
46
+ });
47
+
48
+ afterAll(async () => {
49
+ await vite?.close();
50
+ vi.restoreAllMocks();
51
+ fs.rmSync(serverDirectory, { recursive: true, force: true });
52
+ });
53
+
54
+ // Every evaluated lib/docs module, by file, with the module instance Vite holds.
55
+ function libDocsInstances() {
56
+ const instances = new Map();
57
+ for (const mod of vite.moduleGraph.idToModuleMap.values()) {
58
+ if (mod.file?.startsWith(libDocsDirectory) && mod.ssrModule) {
59
+ expect(vite.moduleGraph.getModulesByFile(mod.file).size).toBe(1);
60
+ instances.set(mod.file, mod.ssrModule);
61
+ }
62
+ }
63
+ return instances;
64
+ }
65
+
66
+ test('loadDocsRoutes evaluates each lib/docs module once, also after Vite re-evaluates its importers', async () => {
67
+ const tabChannel = await vite.ssrLoadModule('/lib/docs/tabChannel.js');
68
+ const devEventBus = await vite.ssrLoadModule('/lib/docs/devEventBus.js');
69
+ await vite.ssrLoadModule('/src/routes/reload.js');
70
+
71
+ const { default: loadDocsRoutes } = await vite.ssrLoadModule(
72
+ '/src/routes/docs/loadDocsRoutes.js'
73
+ );
74
+ const [routes, again] = await Promise.all([loadDocsRoutes(), loadDocsRoutes()]);
75
+ expect(again).toBe(routes);
76
+ expect(Object.keys(routes).sort()).toEqual([
77
+ 'buildStatus',
78
+ 'events',
79
+ 'find',
80
+ 'getDocsIndex',
81
+ 'index',
82
+ 'journey',
83
+ 'mcp',
84
+ 'mutants',
85
+ 'pageConfig',
86
+ 'restart',
87
+ ]);
88
+
89
+ const before = libDocsInstances();
90
+ expect(before.get(path.join(libDocsDirectory, 'createDocsMcpServer.js'))).toBeDefined();
91
+ expect(before.get(path.join(libDocsDirectory, 'tabChannel.js'))).toBe(tabChannel);
92
+ expect(before.get(path.join(libDocsDirectory, 'devEventBus.js'))).toBe(devEventBus);
93
+
94
+ // A change in the server's own graph re-evaluates src/ (app.js, the routes)
95
+ // but keeps the modules it did not touch.
96
+ for (const mod of [...vite.moduleGraph.idToModuleMap.values()]) {
97
+ if (mod.file?.startsWith(path.join(serverRoot, 'src') + path.sep)) {
98
+ vite.moduleGraph.invalidateModule(mod);
99
+ }
100
+ }
101
+ const reloaded = await vite.ssrLoadModule('/src/routes/docs/loadDocsRoutes.js');
102
+ expect(reloaded.default).not.toBe(loadDocsRoutes);
103
+ await reloaded.default();
104
+
105
+ const after = libDocsInstances();
106
+ expect([...after.keys()].sort()).toEqual([...before.keys()].sort());
107
+ for (const [file, instance] of before) {
108
+ expect(after.get(file), file).toBe(instance);
109
+ }
110
+ });
@@ -15,15 +15,15 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, beforeEach, expect, test } from 'vitest';
19
19
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
20
20
 
21
21
  // A real McpServer with the logging capability rides the real @hono/mcp
22
22
  // transport, so the test covers the actual notification path; only the docs
23
23
  // tool registrations and the bus subscription are stubbed out.
24
- const mockSubscribeMcpServerToDevEvents = jest.fn();
25
- const mockUnsubscribe = jest.fn();
26
- jest.unstable_mockModule('../../../lib/docs/createDocsMcpServer.js', () => ({
24
+ const mockSubscribeMcpServerToDevEvents = vi.fn();
25
+ const mockUnsubscribe = vi.fn();
26
+ vi.doMock('../../../lib/docs/createDocsMcpServer.js', () => ({
27
27
  default: () =>
28
28
  new McpServer(
29
29
  { name: 'lowdefy-docs-test', version: '1.0.0' },
@@ -31,7 +31,7 @@ jest.unstable_mockModule('../../../lib/docs/createDocsMcpServer.js', () => ({
31
31
  ),
32
32
  subscribeMcpServerToDevEvents: mockSubscribeMcpServerToDevEvents,
33
33
  }));
34
- jest.unstable_mockModule('../../../lib/docs/devEventBus.js', () => ({
34
+ vi.doMock('../../../lib/docs/devEventBus.js', () => ({
35
35
  bootedAt: '2026-05-06T07:08:09.000Z',
36
36
  }));
37
37
 
@@ -16,6 +16,8 @@
16
16
 
17
17
  import path from 'node:path';
18
18
 
19
+ import { type } from '@lowdefy/helpers';
20
+
19
21
  import buildPageIfNeeded from '../../../lib/server/jitPageBuilder.js';
20
22
  import getBuildId from '../../../lib/docs/getBuildId.js';
21
23
  import listMutants from '../../../lib/server/mutants/listMutants.js';
@@ -53,6 +55,11 @@ async function docsMutantsHandler(c) {
53
55
  removedPages.add(pageId);
54
56
  }
55
57
  } catch (error) {
58
+ // A build error says what is wrong with the page; any other error is a
59
+ // fault of this route, for the error handler to log, not a page to fix.
60
+ if (type.isNone(error.buildErrors) && error.isLowdefyError !== true) {
61
+ throw error;
62
+ }
56
63
  return c.json(
57
64
  {
58
65
  error: `Page "${pageId}" fails to build, so its mutants cannot be listed until the errors are fixed.`,