@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -15,25 +15,95 @@
15
15
  */
16
16
 
17
17
  import { randomUUID } from 'node:crypto';
18
+ import fs from 'node:fs';
18
19
 
19
20
  import chokidar from 'chokidar';
20
21
  import { streamSSE } from 'hono/streaming';
21
22
 
23
+ import pollTab from '../../lib/docs/pollTab.js';
22
24
  import { registerTab, unregisterTab } from '../../lib/docs/tabChannel.js';
25
+ import { remoteCallerHeader } from '../../lib/server/pairingHeaders.js';
23
26
  import readRecordingCookie from '../../lib/server/recording/readRecordingCookie.js';
24
27
 
28
+ const PLATFORMS = ['ios', 'android'];
29
+
30
+ // A phone shell (Lowdefy Dev) names its shell version in x-lowdefy-shell, and
31
+ // its platform and bundle id in the query; the manager's proxy marks a phone
32
+ // paired over the network (remoteCallerHeader). A browser tab is no device.
33
+ function tabDevice(c) {
34
+ const shell = c.req.header('x-lowdefy-shell');
35
+ if (shell === undefined) {
36
+ return null;
37
+ }
38
+ const platform = c.req.query('platform');
39
+ return {
40
+ shell,
41
+ platform: PLATFORMS.includes(platform) ? platform : null,
42
+ app: c.req.query('app') ?? null,
43
+ paired: c.req.header(remoteCallerHeader) !== undefined,
44
+ };
45
+ }
46
+
25
47
  // A verified recording cookie means the dev server's own headless browser
26
48
  // opened the tab: a journey run ({ source }), or a headless
27
49
  // tool ('off'). A developer's tab carries none.
28
- function tabOrigin(cookieHeader) {
29
- const recording = readRecordingCookie(cookieHeader);
50
+ function tabOrigin(c) {
51
+ const device = tabDevice(c);
52
+ const recording = readRecordingCookie(c.req.header('cookie'));
30
53
  if (recording === null) {
31
- return { source: 'dev', automated: false };
54
+ return { source: 'dev', automated: false, device };
32
55
  }
33
56
  if (recording === 'off') {
34
- return { source: 'headless', automated: true };
57
+ return { source: 'headless', automated: true, device };
58
+ }
59
+ return { source: recording.source, automated: true, device };
60
+ }
61
+
62
+ // Every tab's stream shares one watcher on build/reload: a watcher per
63
+ // connection held one fs handle per open tab, headless journey and screenshot
64
+ // tabs included. Same shape as lib/docs/devEventBus.js.
65
+ const subscribers = new Set();
66
+
67
+ let watcher = null;
68
+
69
+ function notifySubscribers() {
70
+ [...subscribers].forEach((notify) => notify());
71
+ }
72
+
73
+ function startWatcher() {
74
+ watcher = chokidar.watch(['./build/reload'], {
75
+ persistent: true,
76
+ ignoreInitial: true,
77
+ });
78
+ watcher.on('add', notifySubscribers);
79
+ watcher.on('change', notifySubscribers);
80
+ // Do not reload on unlink — cleanBuildDirectory deletes build/reload during
81
+ // skeleton rebuilds, which would send a premature SSE event before the new
82
+ // build artifacts are written. The real reload comes via add/change when
83
+ // reloadClients() creates the file after the build completes.
84
+ }
85
+
86
+ // The close waits until the event being handled is done, for the reason
87
+ // devEventBus.js gives: chokidar 4 registers a new file's watch handle only
88
+ // after its add event returns, so a close made inside it would leave that
89
+ // handle open for the next watcher of build/reload to share.
90
+ function stopWatcher() {
91
+ const stopping = watcher;
92
+ watcher = null;
93
+ return new Promise((resolve) => setImmediate(resolve)).then(() => stopping.close());
94
+ }
95
+
96
+ function subscribeToReload(notify) {
97
+ subscribers.add(notify);
98
+ if (watcher === null) {
99
+ startWatcher();
35
100
  }
36
- return { source: recording.source, automated: true };
101
+ return () => {
102
+ if (!subscribers.delete(notify)) return;
103
+ if (subscribers.size === 0 && watcher !== null) {
104
+ stopWatcher();
105
+ }
106
+ };
37
107
  }
38
108
 
39
109
  // SSE endpoint — notifies the client when build/reload is written so it can
@@ -50,39 +120,50 @@ function tabOrigin(cookieHeader) {
50
120
  // would force a reconnect on every navigation — but posted by
51
121
  // client/Inspector.jsx to /api/dev-inspect/page (routes/devInspect.js) as
52
122
  // { tabId, pageId } whenever it changes.
123
+ function readReloadStamp() {
124
+ try {
125
+ return fs.readFileSync('./build/reload', 'utf8');
126
+ } catch {
127
+ // No build has finished since the build directory was cleaned.
128
+ return null;
129
+ }
130
+ }
131
+
132
+ // GET /api/reload?transport=poll[&tabId=<id>] is the same channel for a tab
133
+ // that cannot read an event stream (a phone shell whose fetch cannot stream):
134
+ // it answers { tabId, events } with the events queued since the last poll
135
+ // (lib/docs/pollTab.js).
53
136
  async function reloadHandler(c) {
137
+ if (c.req.query('transport') === 'poll') {
138
+ return c.json(
139
+ pollTab({
140
+ tabId: c.req.query('tabId'),
141
+ origin: tabOrigin(c),
142
+ readReloadStamp,
143
+ })
144
+ );
145
+ }
54
146
  return streamSSE(c, async (stream) => {
55
- const watcher = chokidar.watch(['./build/reload'], {
56
- persistent: true,
57
- ignoreInitial: true,
147
+ const unsubscribe = subscribeToReload(() => {
148
+ stream.writeSSE({ event: 'reload', data: JSON.stringify({}) });
58
149
  });
59
150
 
60
151
  const tabId = randomUUID();
61
152
  registerTab({
62
153
  id: tabId,
63
154
  send: (event, data) => stream.writeSSE({ event, data: JSON.stringify(data) }),
64
- ...tabOrigin(c.req.header('cookie')),
155
+ ...tabOrigin(c),
65
156
  });
66
157
 
67
158
  let open = true;
68
159
  stream.onAbort(() => {
69
160
  open = false;
70
- watcher.close();
161
+ unsubscribe();
71
162
  unregisterTab({ id: tabId });
72
163
  });
73
164
 
74
165
  await stream.writeSSE({ event: 'tab', data: JSON.stringify({ tabId }) });
75
166
 
76
- const reload = () => {
77
- stream.writeSSE({ event: 'reload', data: JSON.stringify({}) });
78
- };
79
- watcher.on('add', () => reload());
80
- watcher.on('change', () => reload());
81
- // Do not reload on unlink — cleanBuildDirectory deletes build/reload during
82
- // skeleton rebuilds, which would send a premature SSE event before the new
83
- // build artifacts are written. The real reload comes via add/change when
84
- // reloadClients() creates the file after the build completes.
85
-
86
167
  while (open) {
87
168
  await stream.sleep(15000);
88
169
  if (open) {
@@ -0,0 +1,153 @@
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 { EventEmitter } from 'node:events';
17
+
18
+ import { Hono } from 'hono';
19
+ import { vi, afterEach, expect, test } from 'vitest';
20
+
21
+ const watchers = [];
22
+
23
+ vi.doMock('chokidar', () => ({
24
+ default: {
25
+ watch: vi.fn((paths) => {
26
+ const watcher = new EventEmitter();
27
+ watcher.paths = paths;
28
+ watcher.close = vi.fn(async () => {});
29
+ watchers.push(watcher);
30
+ return watcher;
31
+ }),
32
+ },
33
+ }));
34
+
35
+ const { default: reloadHandler } = await import('./reload.js');
36
+ const { listTabs } = await import('../../lib/docs/tabChannel.js');
37
+ const { closePolledTabs } = await import('../../lib/docs/pollTab.js');
38
+
39
+ const app = new Hono();
40
+ app.get('/api/reload', reloadHandler);
41
+
42
+ function poll({ query, headers }) {
43
+ return app.request(`/api/reload?transport=poll&${query}`, { headers });
44
+ }
45
+
46
+ afterEach(() => {
47
+ closePolledTabs();
48
+ });
49
+
50
+ const decoder = new TextDecoder();
51
+
52
+ // Reads SSE frames off a stream until one with the given event arrives.
53
+ async function readEvent(connection, event) {
54
+ for (;;) {
55
+ const frameEnd = connection.buffer.indexOf('\n\n');
56
+ if (frameEnd !== -1) {
57
+ const frame = connection.buffer.slice(0, frameEnd);
58
+ connection.buffer = connection.buffer.slice(frameEnd + 2);
59
+ if (frame.includes(`event: ${event}\n`)) {
60
+ return frame;
61
+ }
62
+ continue;
63
+ }
64
+ const { value, done } = await connection.reader.read();
65
+ if (done) {
66
+ throw new Error(`Stream ended before a ${event} event.`);
67
+ }
68
+ connection.buffer += decoder.decode(value, { stream: true });
69
+ }
70
+ }
71
+
72
+ async function connect() {
73
+ const response = await app.request('/api/reload');
74
+ const connection = { reader: response.body.getReader(), buffer: '' };
75
+ await readEvent(connection, 'tab');
76
+ return connection;
77
+ }
78
+
79
+ function countEvents(connection, event) {
80
+ return connection.buffer.split('\n\n').filter((frame) => frame.includes(`event: ${event}\n`))
81
+ .length;
82
+ }
83
+
84
+ test('reload streams share one watcher, each gets a reload once, and the last to close closes it', async () => {
85
+ const connections = [await connect(), await connect(), await connect()];
86
+ expect(watchers).toHaveLength(1);
87
+ expect(watchers[0].paths).toEqual(['./build/reload']);
88
+ expect(listTabs()).toHaveLength(3);
89
+
90
+ watchers[0].emit('change', './build/reload');
91
+ for (const connection of connections) {
92
+ await readEvent(connection, 'reload');
93
+ }
94
+ // Give a duplicate frame the chance to arrive before counting.
95
+ await new Promise((resolve) => setImmediate(resolve));
96
+ connections.forEach((connection) => expect(countEvents(connection, 'reload')).toBe(0));
97
+
98
+ // No reload on unlink: a skeleton rebuild removes build/reload before it publishes.
99
+ watchers[0].emit('unlink', './build/reload');
100
+
101
+ await connections[0].reader.cancel();
102
+ await connections[1].reader.cancel();
103
+ await new Promise((resolve) => setImmediate(resolve));
104
+ expect(watchers[0].close).not.toHaveBeenCalled();
105
+
106
+ await connections[2].reader.cancel();
107
+ await vi.waitFor(() => expect(watchers[0].close).toHaveBeenCalledTimes(1));
108
+ expect(listTabs()).toHaveLength(0);
109
+
110
+ // A tab opened after every stream closed starts a new watcher.
111
+ const next = await connect();
112
+ expect(watchers).toHaveLength(2);
113
+ await next.reader.cancel();
114
+ await vi.waitFor(() => expect(watchers[1].close).toHaveBeenCalledTimes(1));
115
+ });
116
+
117
+ test('a phone shell registers as a device tab with its shell version, platform and app id', async () => {
118
+ const res = await poll({
119
+ query: 'client=lowdefy-dev-tab-client&platform=ios&app=com.lowdefy.dev',
120
+ headers: { 'x-lowdefy-shell': '7.1.0' },
121
+ });
122
+ expect(res.status).toBe(200);
123
+ const { tabId } = await res.json();
124
+ expect(listTabs()).toEqual([
125
+ expect.objectContaining({
126
+ id: tabId,
127
+ device: { shell: '7.1.0', platform: 'ios', app: 'com.lowdefy.dev', paired: false },
128
+ }),
129
+ ]);
130
+ });
131
+
132
+ test('a phone paired over the network is marked paired', async () => {
133
+ await poll({
134
+ query: 'platform=android',
135
+ headers: { 'x-lowdefy-shell': '7.1.0', 'x-lowdefy-dev-remote': '1' },
136
+ });
137
+ expect(listTabs()[0].device).toEqual({
138
+ shell: '7.1.0',
139
+ platform: 'android',
140
+ app: null,
141
+ paired: true,
142
+ });
143
+ });
144
+
145
+ test('a browser tab is no device, whatever its query says', async () => {
146
+ await poll({ query: 'platform=ios', headers: {} });
147
+ expect(listTabs()[0].device).toBeNull();
148
+ });
149
+
150
+ test('an unknown platform is recorded as none', async () => {
151
+ await poll({ query: 'platform=watchos', headers: { 'x-lowdefy-shell': '7.1.0' } });
152
+ expect(listTabs()[0].device.platform).toBeNull();
153
+ });
@@ -14,12 +14,10 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { callRequest, parseRequestBody, redactErrorResponse } from '@lowdefy/api';
18
- import { serializer } from '@lowdefy/helpers';
17
+ import { callRequest, parseRequestBody } from '@lowdefy/api';
19
18
 
20
19
  import buildPageIfNeeded from '../../lib/server/jitPageBuilder.js';
21
20
  import getPathSegments from '../lib/getPathSegments.js';
22
- import { getMock } from '../../lib/docs/devMockRegistry.js';
23
21
 
24
22
  async function requestHandler(c) {
25
23
  if (c.req.method !== 'POST') {
@@ -36,25 +34,6 @@ async function requestHandler(c) {
36
34
  const pageId = segments.slice(0, -1).join('/');
37
35
  const { actionId, blockId, payload } = parseRequestBody({ text: await c.req.text() });
38
36
 
39
- // Dev-only agent tooling: once a state checkpoint has been loaded
40
- // (lib/docs/loadState.js), its recorded request/response pairs live in
41
- // devMockRegistry keyed by (pageId, requestId). Short-circuit here, before
42
- // ever touching the real connection, so a headless verification page, a
43
- // human tester's browser tab, or an e2e test replays exactly what was
44
- // recorded. The response shape mirrors @lowdefy/api's callRequest contract
45
- // (see callRequestResolver.js / callRequest.js success shape, and
46
- // middleware/errorHandler.js for the error shape) so the client's
47
- // Requests.js can't tell the difference from a real request.
48
- const mock = getMock({ pageId, requestId });
49
- if (mock) {
50
- context.logger.info({ event: 'dev_mock_request', pageId, requestId, blockId, actionId });
51
- if (mock.error) {
52
- const error = mock.error instanceof Error ? mock.error : new Error(mock.error);
53
- return c.json(redactErrorResponse(context, error), 500);
54
- }
55
- return c.json({ success: true, response: serializer.serialize(mock.response) });
56
- }
57
-
58
37
  // Page artifacts (including pages/{pageId}/requests/{requestId}.json) are
59
38
  // built JIT by GET /api/page/* and thrown away on every page invalidation
60
39
  // (lowdefyBuildWatcher). A client that already holds
@@ -15,24 +15,18 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
19
19
 
20
- const mockCallRequest = jest.fn();
21
- jest.unstable_mockModule('@lowdefy/api', () => ({
20
+ const mockCallRequest = vi.fn();
21
+ vi.doMock('@lowdefy/api', () => ({
22
22
  callRequest: mockCallRequest,
23
23
  parseRequestBody: ({ text }) => JSON.parse(text),
24
- redactErrorResponse: jest.fn((context, error) => ({ error: error.message })),
25
24
  }));
26
25
 
27
- const mockBuildPageIfNeeded = jest.fn(async () => true);
28
- jest.unstable_mockModule('../../lib/server/jitPageBuilder.js', () => ({
26
+ const mockBuildPageIfNeeded = vi.fn(async () => true);
27
+ vi.doMock('../../lib/server/jitPageBuilder.js', () => ({
29
28
  default: mockBuildPageIfNeeded,
30
- getPageJitEnrichment: jest.fn(() => ({})),
31
- }));
32
-
33
- const mockGetMock = jest.fn(() => null);
34
- jest.unstable_mockModule('../../lib/docs/devMockRegistry.js', () => ({
35
- getMock: mockGetMock,
29
+ getPageJitEnrichment: vi.fn(() => ({})),
36
30
  }));
37
31
 
38
32
  const { default: requestHandler } = await import('./request.js');
@@ -45,7 +39,7 @@ function createApp() {
45
39
  c.set('lowdefyContext', {
46
40
  buildDirectory: '/build',
47
41
  configDirectory: '/config',
48
- logger: { debug: jest.fn(), info: jest.fn(), error: jest.fn() },
42
+ logger: { debug: vi.fn(), info: vi.fn(), error: vi.fn() },
49
43
  });
50
44
  await next();
51
45
  });
@@ -76,8 +70,6 @@ beforeEach(() => {
76
70
  afterEach(() => {
77
71
  mockCallRequest.mockReset();
78
72
  mockBuildPageIfNeeded.mockReset();
79
- mockGetMock.mockReset();
80
- mockGetMock.mockImplementation(() => null);
81
73
  });
82
74
 
83
75
  test('requestHandler builds the page JIT before calling the request', async () => {
@@ -107,15 +99,6 @@ test('requestHandler builds nested page ids as one page', async () => {
107
99
  );
108
100
  });
109
101
 
110
- test('requestHandler replays a dev mock without building or calling the request', async () => {
111
- mockGetMock.mockImplementation(() => ({ response: { rows: [1] } }));
112
- const res = await post(createApp(), '/api/request/dashboard/get_rows');
113
- expect(res.status).toEqual(200);
114
- expect(await res.json()).toEqual({ success: true, response: { rows: [1] } });
115
- expect(mockBuildPageIfNeeded).not.toHaveBeenCalled();
116
- expect(mockCallRequest).not.toHaveBeenCalled();
117
- });
118
-
119
102
  // A GET to the request route is client-caused, so it must answer 405 rather
120
103
  // than throwing into the error handler and being logged as a fault with a 500.
121
104
  test('requestHandler returns 405 without building or calling the request for a non-POST method', async () => {
@@ -17,36 +17,30 @@
17
17
  import { fileURLToPath } from 'node:url';
18
18
 
19
19
  import { Hono } from 'hono';
20
- import { jest } from '@jest/globals';
20
+ import { vi, afterAll, beforeAll, expect, test } from 'vitest';
21
21
 
22
22
  import { isSameOriginRequest, parseRequestBody } from '@lowdefy/api';
23
23
 
24
24
  // usage.js reads package.json from the working directory as it loads, and a suite that
25
- // ran earlier in the same jest worker may have left the working directory in a temporary
25
+ // ran earlier in the same test worker may have left the working directory in a temporary
26
26
  // fixture directory.
27
27
  process.chdir(fileURLToPath(new URL('../..', import.meta.url)));
28
28
 
29
- const mockGetEndpointConfig = jest.fn().mockRejectedValue(new Error('not found'));
30
- const mockRunWebhookEndpoint = jest.fn();
31
- jest.unstable_mockModule('@lowdefy/api', () => ({
32
- acceptDetachedEndpoint: jest.fn(),
33
- callAgent: jest.fn(),
34
- callEndpoint: jest.fn(),
35
- callRequest: jest.fn(),
29
+ const mockGetEndpointConfig = vi.fn().mockRejectedValue(new Error('not found'));
30
+ const mockRunWebhookEndpoint = vi.fn();
31
+ vi.doMock('@lowdefy/api', () => ({
32
+ acceptDetachedEndpoint: vi.fn(),
33
+ callAgent: vi.fn(),
34
+ callEndpoint: vi.fn(),
35
+ callRequest: vi.fn(),
36
36
  getEndpointConfig: mockGetEndpointConfig,
37
- logClientError: jest.fn(),
37
+ logClientError: vi.fn(),
38
38
  isSameOriginRequest,
39
39
  parseRequestBody,
40
- redactErrorResponse: jest.fn(),
40
+ redactErrorResponse: vi.fn(),
41
41
  runWebhookEndpoint: mockRunWebhookEndpoint,
42
42
  }));
43
- jest.unstable_mockModule('../../lib/server/jitPageBuilder.js', () => ({ default: jest.fn() }));
44
- jest.unstable_mockModule('../../lib/docs/devMockRegistry.js', () => ({
45
- getMock: jest.fn(),
46
- loadMocks: jest.fn(),
47
- }));
48
- jest.unstable_mockModule('../../lib/docs/loadState.js', () => ({ default: jest.fn() }));
49
- jest.unstable_mockModule('../../lib/docs/snapshotState.js', () => ({ default: jest.fn() }));
43
+ vi.doMock('../../lib/server/jitPageBuilder.js', () => ({ default: vi.fn() }));
50
44
 
51
45
  const { default: createErrorHandler } = await import('../middleware/errorHandler.js');
52
46
  const routes = {
@@ -58,17 +52,14 @@ const routes = {
58
52
  '/api/endpoints/*': (await import('./endpoints.js')).default,
59
53
  '/api/request/*': (await import('./request.js')).default,
60
54
  '/api/usage': (await import('./usage.js')).default,
61
- '/lowdefy-docs/state-checkpoints/load': (await import('./docs/loadState.js')).default,
62
- '/lowdefy-docs/state-checkpoints/snapshot': (await import('./docs/snapshotState.js')).default,
63
- '/lowdefy-feedback': (await import('./feedback.js')).default,
64
55
  };
65
56
 
66
- const logger = { debug: jest.fn(), error: jest.fn(), info: jest.fn(), warn: jest.fn() };
57
+ const logger = { debug: vi.fn(), error: vi.fn(), info: vi.fn(), warn: vi.fn() };
67
58
 
68
59
  function createApp() {
69
60
  const app = new Hono();
70
61
  app.use('*', async (c, next) => {
71
- c.set('lowdefyContext', { logger, handleError: jest.fn() });
62
+ c.set('lowdefyContext', { logger, handleError: vi.fn() });
72
63
  await next();
73
64
  });
74
65
  Object.entries(routes).forEach(([path, handler]) => app.all(path, handler));
@@ -91,7 +82,6 @@ afterAll(() => {
91
82
  const sameOrigin = { host: 'localhost', origin: 'http://localhost' };
92
83
  const notJson = JSON.stringify({ name: 'UserError', message: 'Request body is not valid JSON.' });
93
84
 
94
- // Paths outside /api/ get the error handler's plain-text answer.
95
85
  test.each([
96
86
  ['/api/endpoints/save', {}, notJson],
97
87
  ['/api/request/orders/load', {}, notJson],
@@ -101,9 +91,6 @@ test.each([
101
91
  ['/api/client-error', sameOrigin, notJson],
102
92
  ['/api/dev-inspect', sameOrigin, notJson],
103
93
  ['/api/dev-inspect/page', sameOrigin, notJson],
104
- ['/lowdefy-docs/state-checkpoints/load', {}, 'Bad Request'],
105
- ['/lowdefy-docs/state-checkpoints/snapshot', {}, 'Bad Request'],
106
- ['/lowdefy-feedback', sameOrigin, 'Bad Request'],
107
94
  ])(
108
95
  'POST %s with a body that is not JSON answers 400 and logs a warning',
109
96
  async (path, headers, text) => {
@@ -15,10 +15,10 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, expect, test } from 'vitest';
19
19
 
20
20
  const mockStrategies = [];
21
- jest.unstable_mockModule('../../lib/server/auth/getStrategies.js', () => ({
21
+ vi.doMock('../../lib/server/auth/getStrategies.js', () => ({
22
22
  default: () => mockStrategies,
23
23
  }));
24
24
 
@@ -14,12 +14,12 @@
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
  import wellKnownFallbackHandler from './wellKnownFallback.js';
20
20
 
21
21
  test('an unserved well-known path answers 404 JSON, never the app shell', () => {
22
- const json = jest.fn((data, status) => ({ data, status }));
22
+ const json = vi.fn((data, status) => ({ data, status }));
23
23
  const result = wellKnownFallbackHandler({
24
24
  req: { path: '/.well-known/oauth-protected-resource' },
25
25
  json,
@@ -15,25 +15,25 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, expect, test } from 'vitest';
19
19
 
20
- const mockCreateWebSocketConnection = jest.fn(() => ({
21
- close: jest.fn(),
22
- handleMessage: jest.fn(),
20
+ const mockCreateWebSocketConnection = vi.fn(() => ({
21
+ close: vi.fn(),
22
+ handleMessage: vi.fn(),
23
23
  }));
24
24
  // The route's origin rule has its own tests (src/routes/websocket.test.mjs);
25
25
  // these requests carry no Origin, which it allows.
26
- jest.unstable_mockModule('@lowdefy/api', () => ({
27
- createChannelRegistry: jest.fn(() => ({})),
26
+ vi.doMock('@lowdefy/api', () => ({
27
+ createChannelRegistry: vi.fn(() => ({})),
28
28
  createWebSocketConnection: mockCreateWebSocketConnection,
29
29
  isWebSocketOriginAllowed: () => true,
30
30
  }));
31
31
  const mockStrategies = [];
32
- jest.unstable_mockModule('../../lib/server/auth/getStrategies.js', () => ({
32
+ vi.doMock('../../lib/server/auth/getStrategies.js', () => ({
33
33
  default: () => mockStrategies,
34
34
  }));
35
- const mockLogger = { warn: jest.fn(), debug: jest.fn() };
36
- jest.unstable_mockModule('../../lib/server/log/createLogger.js', () => ({
35
+ const mockLogger = { warn: vi.fn(), debug: vi.fn() };
36
+ vi.doMock('../../lib/server/log/createLogger.js', () => ({
37
37
  default: () => mockLogger,
38
38
  }));
39
39
 
@@ -56,10 +56,10 @@ function createApp({ status } = {}) {
56
56
  }
57
57
 
58
58
  function createUpgrade() {
59
- const socket = { end: jest.fn() };
60
- const ws = { close: jest.fn(), on: jest.fn(), send: jest.fn() };
59
+ const socket = { end: vi.fn() };
60
+ const ws = { close: vi.fn(), on: vi.fn(), send: vi.fn() };
61
61
  const wss = {
62
- handleUpgrade: jest.fn((request, socket, head, callback) => {
62
+ handleUpgrade: vi.fn((request, socket, head, callback) => {
63
63
  callback(ws);
64
64
  return ws;
65
65
  }),
package/vite.config.js CHANGED
@@ -22,6 +22,7 @@ import { WebSocketServer } from 'ws';
22
22
  import watchOwner from '@lowdefy/node-utils/watchOwner.js';
23
23
 
24
24
  import createDevServerExclude from './lib/vite/createDevServerExclude.js';
25
+ import keepIdleConnectionsOpen from './lib/vite/keepIdleConnectionsOpen.js';
25
26
 
26
27
  const devServerEntry = './src/app.js';
27
28
 
@@ -88,6 +89,7 @@ export default defineConfig(({ mode }) => ({
88
89
  plugins: [
89
90
  react(),
90
91
  lowdefyWebSocket(),
92
+ keepIdleConnectionsOpen(),
91
93
  devServer({
92
94
  entry: devServerEntry,
93
95
  exclude: createDevServerExclude({ basePath }),
@@ -135,7 +137,19 @@ export default defineConfig(({ mode }) => ({
135
137
  // sole recompile trigger — see writeGlobalsCss in @lowdefy/build).
136
138
  // The config build writes into build-staging and then moves each file
137
139
  // into build, so only build is watched.
138
- ignored: ['**/lowdefy-build/tailwind/**', '**/build-staging/**'],
140
+ //
141
+ // These build/ folders hold the page, request, api, connection, agent
142
+ // and JIT map artifacts, thousands in a large app. The server reads them
143
+ // from disk and no module imports them, so Vite need not watch them.
144
+ ignored: [
145
+ '**/lowdefy-build/tailwind/**',
146
+ '**/build-staging/**',
147
+ '**/build/pages/**',
148
+ '**/build/api/**',
149
+ '**/build/connections/**',
150
+ '**/build/agents/**',
151
+ '**/build/jitMaps/**',
152
+ ],
139
153
  },
140
154
  },
141
155
  }));