@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
@@ -18,14 +18,14 @@ import fs from 'node:fs';
18
18
  import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
- import { jest } from '@jest/globals';
21
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
22
22
  import { Hono } from 'hono';
23
23
  import { serializer } from '@lowdefy/helpers';
24
24
 
25
25
  import { endpointFixture, pageFixture } from '../../../lib/server/mutants/test/fixtures.mjs';
26
26
 
27
- const mockBuildPageIfNeeded = jest.fn();
28
- jest.unstable_mockModule('../../../lib/server/jitPageBuilder.js', () => ({
27
+ const mockBuildPageIfNeeded = vi.fn();
28
+ vi.doMock('../../../lib/server/jitPageBuilder.js', () => ({
29
29
  default: mockBuildPageIfNeeded,
30
30
  }));
31
31
 
@@ -41,7 +41,7 @@ function write(name, content) {
41
41
  }
42
42
 
43
43
  beforeEach(() => {
44
- jest.clearAllMocks();
44
+ vi.clearAllMocks();
45
45
  mockBuildPageIfNeeded.mockResolvedValue(true);
46
46
  serverDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-mutants-route-'));
47
47
  const page = pageFixture();
@@ -146,14 +146,28 @@ test.each([
146
146
  );
147
147
 
148
148
  test('POST /lowdefy-docs/mutants answers a page that fails to build with a 422 and its errors', async () => {
149
- mockBuildPageIfNeeded.mockRejectedValue(new Error('Block type "Buton" not found.'));
149
+ const { ConfigError } = await import('@lowdefy/errors');
150
+ mockBuildPageIfNeeded.mockRejectedValue(new ConfigError('Block type "Buton" not found.'));
150
151
  const { status, data } = await post({ pages: ['tickets'] });
151
152
  expect(status).toBe(422);
152
153
  expect(data.buildErrors).toEqual([
153
- { type: 'Error', message: 'Block type "Buton" not found.', source: null },
154
+ { type: 'ConfigError', message: 'Block type "Buton" not found.', source: null },
154
155
  ]);
155
156
  });
156
157
 
158
+ test('POST /lowdefy-docs/mutants does not answer a fault of its own as a page that fails to build', async () => {
159
+ mockBuildPageIfNeeded.mockRejectedValue(new TypeError('Cannot read properties of undefined'));
160
+ const app = new Hono();
161
+ app.post('/lowdefy-docs/mutants', docsMutantsHandler);
162
+ app.onError(() => new Response('fault', { status: 500 }));
163
+ const response = await app.request('/lowdefy-docs/mutants', {
164
+ method: 'POST',
165
+ headers: { 'content-type': 'application/json' },
166
+ body: JSON.stringify({ pages: ['tickets'] }),
167
+ });
168
+ expect(response.status).toBe(500);
169
+ });
170
+
157
171
  test('POST /lowdefy-docs/mutants answers with the build id read before the pages built', async () => {
158
172
  // An edit lands while the page builds: its keys may be the new build's, so
159
173
  // the answer must carry the older id and the journey route refuse it as stale.
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import parsePathParamsParam from './parsePathParamsParam.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('parsePathParamsParam returns nothing when the param is absent', () => {
20
21
  expect(parsePathParamsParam({ value: undefined })).toEqual({});
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import parseUserParam from './parseUserParam.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('parseUserParam returns nothing when the param is absent', () => {
20
21
  expect(parseUserParam({ value: undefined })).toEqual({});
@@ -18,6 +18,7 @@ import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
20
  import { Hono } from 'hono';
21
+ import { afterAll, expect, test } from 'vitest';
21
22
 
22
23
  const originalCwd = process.cwd();
23
24
  const fixtureDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-restart-route-test-'));
@@ -18,12 +18,36 @@ import {
18
18
  callEndpoint,
19
19
  getEndpointConfig,
20
20
  parseRequestBody,
21
+ runLinkEndpoint,
21
22
  runWebhookEndpoint,
22
23
  } from '@lowdefy/api';
24
+ import { type } from '@lowdefy/helpers';
23
25
 
24
26
  import getPathSegments from '../lib/getPathSegments.js';
25
27
 
28
+ // A GET serves a link endpoint (`link: true`): typically an <img src> or a download link, sent
29
+ // by the browser with the session cookie and no Lowdefy headers. The routine runs as that caller
30
+ // and the answer is a 302 to the URL it returns, or a status with no body. The noStore middleware
31
+ // sets Cache-Control: private, no-store on it, so a redirect to a short-lived URL is never cached.
32
+ async function linkHandler(c) {
33
+ const context = c.get('lowdefyContext');
34
+ const { status, location, body } = await runLinkEndpoint(context, {
35
+ segments: getPathSegments(c, '/api/endpoints/'),
36
+ query: c.req.query(),
37
+ });
38
+ if (status === 302) {
39
+ return c.redirect(location, 302);
40
+ }
41
+ if (type.isNone(body)) {
42
+ return c.body(null, status);
43
+ }
44
+ return c.json(body, status);
45
+ }
46
+
26
47
  async function endpointsHandler(c) {
48
+ if (c.req.method === 'GET') {
49
+ return linkHandler(c);
50
+ }
27
51
  if (c.req.method !== 'POST') {
28
52
  // A wrong-method request is client-caused: answer 405 rather than raising a
29
53
  // fault that would be logged at error level and answered with a 500.
@@ -0,0 +1,111 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { Hono } from 'hono';
18
+ import { vi, beforeEach, expect, test } from 'vitest';
19
+
20
+ const mockRunLinkEndpoint = vi.fn();
21
+ const mockCallEndpoint = vi.fn();
22
+ vi.doMock('@lowdefy/api', () => ({
23
+ callEndpoint: mockCallEndpoint,
24
+ getEndpointConfig: vi.fn().mockRejectedValue(new Error('API Endpoint does not exist.')),
25
+ parseRequestBody: vi.fn(() => ({ payload: {} })),
26
+ runLinkEndpoint: mockRunLinkEndpoint,
27
+ runWebhookEndpoint: vi.fn(),
28
+ }));
29
+
30
+ const { default: endpointsHandler } = await import('./endpoints.js');
31
+ const { default: noStore } = await import('../middleware/noStore.js');
32
+ const { default: stampCaller } = await import('../middleware/stampCaller.js');
33
+
34
+ const logger = { debug: vi.fn(), error: vi.fn(), info: vi.fn(), warn: vi.fn() };
35
+
36
+ // The middleware app.js puts on /api/endpoints/*, so a plain browser image GET is checked
37
+ // against what they do with no Lowdefy headers.
38
+ function createApp() {
39
+ const app = new Hono();
40
+ app.use('*', async (c, next) => {
41
+ c.set('lowdefyContext', { logger, handleError: vi.fn(), user: { id: 'user_1' } });
42
+ await next();
43
+ });
44
+ app.use('/api/endpoints/*', noStore());
45
+ app.use('/api/endpoints/*', stampCaller());
46
+ app.all('/api/endpoints/*', endpointsHandler);
47
+ return app;
48
+ }
49
+
50
+ beforeEach(() => {
51
+ mockRunLinkEndpoint.mockReset();
52
+ });
53
+
54
+ test('a GET answers 302 to the link, not stored by any cache', async () => {
55
+ mockRunLinkEndpoint.mockResolvedValue({
56
+ status: 302,
57
+ location: 'https://bucket.s3.amazonaws.com/x.png?X-Amz-Signature=sig',
58
+ });
59
+ const res = await createApp().request('/api/endpoints/files/x.png', { headers: {} });
60
+ expect(res.status).toBe(302);
61
+ expect(res.headers.get('location')).toBe(
62
+ 'https://bucket.s3.amazonaws.com/x.png?X-Amz-Signature=sig'
63
+ );
64
+ expect(res.headers.get('cache-control')).toBe('private, no-store');
65
+ expect(await res.text()).toBe('');
66
+ });
67
+
68
+ test('a GET passes the decoded path segments and the query to runLinkEndpoint', async () => {
69
+ mockRunLinkEndpoint.mockResolvedValue({ status: 302, location: '/x.png' });
70
+ await createApp().request('/api/endpoints/a/b/log-events/2024/x%20y+z.png?v=2&w=a+b');
71
+ expect(mockRunLinkEndpoint).toHaveBeenCalledWith(expect.anything(), {
72
+ segments: ['a', 'b', 'log-events', '2024', 'x y+z.png'],
73
+ query: { v: '2', w: 'a b' },
74
+ });
75
+ });
76
+
77
+ test('a GET keeps an encoded slash and percent sign inside one segment', async () => {
78
+ mockRunLinkEndpoint.mockResolvedValue({ status: 302, location: '/x.png' });
79
+ await createApp().request('/api/endpoints/files/a%2Fb%25.png');
80
+ expect(mockRunLinkEndpoint).toHaveBeenCalledWith(expect.anything(), {
81
+ segments: ['files', 'a/b%.png'],
82
+ query: {},
83
+ });
84
+ });
85
+
86
+ test('a refused GET answers its status with no body', async () => {
87
+ mockRunLinkEndpoint.mockResolvedValue({ status: 401 });
88
+ const res = await createApp().request('/api/endpoints/files/x.png');
89
+ expect(res.status).toBe(401);
90
+ expect(res.headers.get('cache-control')).toBe('private, no-store');
91
+ expect(await res.text()).toBe('');
92
+ });
93
+
94
+ test('a GET that names no link endpoint answers 404 with an error body', async () => {
95
+ mockRunLinkEndpoint.mockResolvedValue({ status: 404, body: { error: 'Not found.' } });
96
+ const res = await createApp().request('/api/endpoints/unknown/x.png');
97
+ expect(res.status).toBe(404);
98
+ expect(await res.json()).toEqual({ error: 'Not found.' });
99
+ });
100
+
101
+ test('any method but GET and POST answers 405', async () => {
102
+ const res = await createApp().request('/api/endpoints/files/x.png', { method: 'PUT' });
103
+ expect(res.status).toBe(405);
104
+ expect(mockRunLinkEndpoint).not.toHaveBeenCalled();
105
+ });
106
+
107
+ test('a GET with a malformed percent escape answers 400 without running the link', async () => {
108
+ const res = await createApp().request('/api/endpoints/files/100%ZZ.png');
109
+ expect(res.status).toBe(400);
110
+ expect(mockRunLinkEndpoint).not.toHaveBeenCalled();
111
+ });
@@ -15,25 +15,25 @@
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 mockGetEndpointConfig = jest.fn();
21
- const mockRunWebhookEndpoint = jest.fn();
22
- jest.unstable_mockModule('@lowdefy/api', () => ({
23
- callEndpoint: jest.fn(),
20
+ const mockGetEndpointConfig = vi.fn();
21
+ const mockRunWebhookEndpoint = vi.fn();
22
+ vi.doMock('@lowdefy/api', () => ({
23
+ callEndpoint: vi.fn(),
24
24
  getEndpointConfig: mockGetEndpointConfig,
25
- parseRequestBody: jest.fn(),
25
+ parseRequestBody: vi.fn(),
26
26
  runWebhookEndpoint: mockRunWebhookEndpoint,
27
27
  }));
28
28
 
29
29
  const { default: endpointsHandler } = await import('./endpoints.js');
30
30
 
31
- const logger = { debug: jest.fn(), error: jest.fn(), info: jest.fn(), warn: jest.fn() };
31
+ const logger = { debug: vi.fn(), error: vi.fn(), info: vi.fn(), warn: vi.fn() };
32
32
 
33
33
  function createApp() {
34
34
  const app = new Hono();
35
35
  app.use('*', async (c, next) => {
36
- c.set('lowdefyContext', { logger, handleError: jest.fn() });
36
+ c.set('lowdefyContext', { logger, handleError: vi.fn() });
37
37
  await next();
38
38
  });
39
39
  app.all('/api/endpoints/*', endpointsHandler);
@@ -21,6 +21,7 @@ import authJson from '../../lib/build/auth.js';
21
21
  import { buildPageWithContext, getPageJitEnrichment } from '../../lib/server/jitPageBuilder.js';
22
22
  import getBuildId from '../../lib/docs/getBuildId.js';
23
23
  import getRequestPath from '../lib/getRequestPath.js';
24
+ import getRequestSurface from '../lib/getRequestSurface.js';
24
25
  import lowdefyConfig from '../../lib/build/config.js';
25
26
  import servedBuilds from '../../lib/server/recording/servedBuilds.js';
26
27
 
@@ -33,6 +34,8 @@ const basePath = lowdefyConfig.basePath ?? '';
33
34
  // 401 { redirect } — logged-out navigation to a protected page
34
35
  // 403 { redirect } — authorised but second factor not yet enrolled
35
36
  // 404 'Page not found.'
37
+ // 404 { pageConfig: null, surface } — the page is for the other surface
38
+ // (x-lowdefy-shell marks a mobile shell)
36
39
  // 200 { pageId, pathParams, matchedPath, pageConfig } (pageConfig + _buildId,
37
40
  // + _warnings, + _jsEntries module text, + _dynamicIcons data)
38
41
  //
@@ -87,7 +90,11 @@ async function jitPageHandler(c) {
87
90
  });
88
91
  }
89
92
 
90
- const result = await getPageConfig(context, { path, urlQuery: c.req.query() });
93
+ const result = await getPageConfig(context, {
94
+ path,
95
+ urlQuery: c.req.query(),
96
+ surface: getRequestSurface(c),
97
+ });
91
98
  if (result.status === 'unauthenticated') {
92
99
  // The client follows this redirect with a full page load, so the login
93
100
  // page can return to the requested page after sign-in.
@@ -119,6 +126,11 @@ async function jitPageHandler(c) {
119
126
  403
120
127
  );
121
128
  }
129
+ if (result.status === 'wrong_surface') {
130
+ // The page is for the other surface: a shell opens a web page in the
131
+ // browser, and a browser shows its 404.
132
+ return c.json({ pageConfig: null, surface: result.surface }, 404);
133
+ }
122
134
  if (result.status !== 'ok') {
123
135
  return c.text('Page not found.', 404);
124
136
  }
@@ -18,38 +18,38 @@ import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
20
  import { Hono } from 'hono';
21
- import { jest } from '@jest/globals';
21
+ import { vi, afterEach, expect, test } from 'vitest';
22
22
 
23
23
  const BUILD_A = '2026-10-03T14:02:00.000Z';
24
24
  const BUILD_B = '2026-10-03T14:05:00.000Z';
25
25
  let mockBuildId = BUILD_A;
26
- jest.unstable_mockModule('../../lib/docs/getBuildId.js', () => ({
26
+ vi.doMock('../../lib/docs/getBuildId.js', () => ({
27
27
  default: () => mockBuildId,
28
28
  }));
29
29
 
30
- const mockGetPageConfig = jest.fn();
31
- jest.unstable_mockModule('@lowdefy/api', () => ({
30
+ const mockGetPageConfig = vi.fn();
31
+ vi.doMock('@lowdefy/api', () => ({
32
32
  getPageConfig: mockGetPageConfig,
33
33
  }));
34
34
 
35
35
  // No JIT build work in these tests — the route's build branch is exercised
36
36
  // elsewhere; here we only drive the getPageConfig status fork.
37
- const mockGetPageJitEnrichment = jest.fn(() => ({}));
37
+ const mockGetPageJitEnrichment = vi.fn(() => ({}));
38
38
  const mockBuildContext = { jsMap: { client: {} } };
39
- const mockBuildPageWithContext = jest.fn(async () => ({
39
+ const mockBuildPageWithContext = vi.fn(async () => ({
40
40
  result: true,
41
41
  buildContext: mockBuildContext,
42
42
  }));
43
- jest.unstable_mockModule('../../lib/server/jitPageBuilder.js', () => ({
43
+ vi.doMock('../../lib/server/jitPageBuilder.js', () => ({
44
44
  buildPageWithContext: mockBuildPageWithContext,
45
45
  getPageJitEnrichment: mockGetPageJitEnrichment,
46
46
  }));
47
47
 
48
- jest.unstable_mockModule('../../lib/build/auth.js', () => ({
48
+ vi.doMock('../../lib/build/auth.js', () => ({
49
49
  default: { authPages: { signIn: '/auth/login', twoFactorEnrol: '/two-factor-enrol' } },
50
50
  }));
51
51
 
52
- jest.unstable_mockModule('../../lib/build/config.js', () => ({
52
+ vi.doMock('../../lib/build/config.js', () => ({
53
53
  default: { basePath: '' },
54
54
  }));
55
55
 
@@ -69,8 +69,8 @@ function createApp() {
69
69
  buildDirectory: '/build',
70
70
  configDirectory: '/config',
71
71
  readConfigFile: async (file) => (file === 'routes.json' ? routes : null),
72
- logger: { debug: jest.fn(), info: jest.fn(), error: jest.fn() },
73
- handleError: jest.fn(),
72
+ logger: { debug: vi.fn(), info: vi.fn(), error: vi.fn() },
73
+ handleError: vi.fn(),
74
74
  });
75
75
  await next();
76
76
  });
@@ -142,6 +142,7 @@ test('jitPageHandler builds the page a patterned path matches and returns its pa
142
142
  expect(mockGetPageConfig.mock.calls[0][1]).toEqual({
143
143
  path: 'support/tickets/1234/',
144
144
  urlQuery: { tab: '2' },
145
+ surface: 'web',
145
146
  });
146
147
  expect(res.status).toEqual(200);
147
148
  const body = await res.json();
@@ -246,3 +247,27 @@ test('jitPageHandler names the build it served, and the recording route keeps th
246
247
  delete process.env.LOWDEFY_DIRECTORY_CONFIG;
247
248
  }
248
249
  });
250
+
251
+ test('jitPageHandler passes the web surface to getPageConfig for a browser', async () => {
252
+ mockGetPageConfig.mockResolvedValue({ status: 'not_found' });
253
+ await createApp().request('/api/page/dashboard');
254
+ expect(mockGetPageConfig.mock.calls[0][1].surface).toEqual('web');
255
+ });
256
+
257
+ test('jitPageHandler passes the mobile surface to getPageConfig for a shell', async () => {
258
+ mockGetPageConfig.mockResolvedValue({ status: 'not_found' });
259
+ await createApp().request('/api/page/dashboard', { headers: { 'x-lowdefy-shell': '7.4.0' } });
260
+ expect(mockGetPageConfig.mock.calls[0][1].surface).toEqual('mobile');
261
+ });
262
+
263
+ test('jitPageHandler returns 404 naming the surface when the page is for the other one', async () => {
264
+ mockGetPageConfig.mockResolvedValue({
265
+ status: 'wrong_surface',
266
+ pageId: 'dashboard',
267
+ pathParams: {},
268
+ surface: 'mobile',
269
+ });
270
+ const res = await createApp().request('/api/page/dashboard');
271
+ expect(res.status).toEqual(404);
272
+ expect(await res.json()).toEqual({ pageConfig: null, surface: 'mobile' });
273
+ });
package/src/routes/mcp.js CHANGED
@@ -102,6 +102,12 @@ async function mcpHandler(c) {
102
102
  });
103
103
  }
104
104
  }
105
+ // The server is stateless and pushes nothing, so it offers no event stream:
106
+ // the MCP spec's answer to a GET is then 405. Opening one would hold the
107
+ // request, and on a serverless host its function, until the host's time limit.
108
+ if (c.req.method === 'GET') {
109
+ return c.json({ error: 'Method not allowed.' }, 405, { Allow: 'POST' });
110
+ }
105
111
  const server = await createMcpServer({ context });
106
112
  const transport = new StreamableHTTPTransport();
107
113
  await server.connect(transport);
@@ -15,20 +15,20 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, afterAll, beforeEach, expect, test } from 'vitest';
19
19
 
20
20
  // The real URI helpers drive the challenge strings, so the header assertions
21
21
  // below exercise the actual BETTER_AUTH_URL derivation - only createMcpServer
22
22
  // is stubbed out.
23
23
  const uriHelpers = await import('@lowdefy/api/routes/mcp/getMcpUri.js');
24
24
 
25
- const mockCreateMcpServer = jest.fn();
26
- jest.unstable_mockModule('@lowdefy/api', () => ({
25
+ const mockCreateMcpServer = vi.fn();
26
+ vi.doMock('@lowdefy/api', () => ({
27
27
  ...uriHelpers,
28
28
  createMcpServer: mockCreateMcpServer,
29
29
  }));
30
30
 
31
- jest.unstable_mockModule('@hono/mcp', () => ({
31
+ vi.doMock('@hono/mcp', () => ({
32
32
  StreamableHTTPTransport: class {
33
33
  handleRequest() {
34
34
  return new Response(JSON.stringify({ served: true }), {
@@ -40,7 +40,7 @@ jest.unstable_mockModule('@hono/mcp', () => ({
40
40
  }));
41
41
 
42
42
  const mockAuthJson = { configured: true, oauthProvider: { consentPage: '/oauth/consent' } };
43
- jest.unstable_mockModule('../../lib/build/auth.js', () => ({
43
+ vi.doMock('../../lib/build/auth.js', () => ({
44
44
  default: mockAuthJson,
45
45
  }));
46
46
 
@@ -48,7 +48,7 @@ const { default: mcpHandler } = await import('./mcp.js');
48
48
 
49
49
  const originalBetterAuthUrl = process.env.BETTER_AUTH_URL;
50
50
 
51
- const mockReadConfigFile = jest.fn();
51
+ const mockReadConfigFile = vi.fn();
52
52
 
53
53
  let contextOverrides;
54
54
 
@@ -57,7 +57,7 @@ function createApp() {
57
57
  app.use('*', async (c, next) => {
58
58
  c.set('lowdefyContext', {
59
59
  config: { basePath: '' },
60
- logger: { debug: jest.fn(), info: jest.fn(), warn: jest.fn(), error: jest.fn() },
60
+ logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
61
61
  readConfigFile: mockReadConfigFile,
62
62
  ...contextOverrides,
63
63
  });
@@ -73,7 +73,7 @@ beforeEach(() => {
73
73
  contextOverrides = {};
74
74
  mockReadConfigFile.mockReset();
75
75
  mockCreateMcpServer.mockReset();
76
- mockCreateMcpServer.mockResolvedValue({ connect: jest.fn() });
76
+ mockCreateMcpServer.mockResolvedValue({ connect: vi.fn() });
77
77
  mockReadConfigFile.mockResolvedValue({ configured: true, hasPublicTool: true, endpoints: [] });
78
78
  });
79
79
 
@@ -213,3 +213,18 @@ test('mcpHandler serves openly with no envelope when oauthProvider is not config
213
213
  expect(res.status).toEqual(200);
214
214
  expect(await res.json()).toEqual({ served: true });
215
215
  });
216
+
217
+ test('mcpHandler answers a GET with 405, since the stateless server offers no event stream', async () => {
218
+ contextOverrides.mcpAuth = { tokenStatus: 'valid' };
219
+ const res = await createApp().request('/api/mcp', { method: 'GET' });
220
+ expect(res.status).toEqual(405);
221
+ expect(res.headers.get('Allow')).toEqual('POST');
222
+ expect(await res.json()).toEqual({ error: 'Method not allowed.' });
223
+ expect(mockCreateMcpServer).not.toHaveBeenCalled();
224
+ });
225
+
226
+ test('mcpHandler challenges a GET with an invalid token before answering 405', async () => {
227
+ contextOverrides.mcpAuth = { tokenStatus: 'invalid', parseableJwt: true };
228
+ const res = await createApp().request('/api/mcp', { method: 'GET' });
229
+ expect(res.status).toEqual(401);
230
+ });
@@ -15,20 +15,20 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, afterAll, beforeEach, expect, test } from 'vitest';
19
19
 
20
20
  // The real URI helpers drive the challenge strings, so the header assertions
21
21
  // below exercise the actual BETTER_AUTH_URL derivation - only createMcpServer
22
22
  // is stubbed out.
23
23
  const uriHelpers = await import('@lowdefy/api/routes/mcp/getMcpUri.js');
24
24
 
25
- const mockCreateMcpServer = jest.fn();
26
- jest.unstable_mockModule('@lowdefy/api', () => ({
25
+ const mockCreateMcpServer = vi.fn();
26
+ vi.doMock('@lowdefy/api', () => ({
27
27
  ...uriHelpers,
28
28
  createMcpServer: mockCreateMcpServer,
29
29
  }));
30
30
 
31
- jest.unstable_mockModule('@hono/mcp', () => ({
31
+ vi.doMock('@hono/mcp', () => ({
32
32
  StreamableHTTPTransport: class {
33
33
  handleRequest() {
34
34
  return new Response(JSON.stringify({ served: true }), {
@@ -40,7 +40,7 @@ jest.unstable_mockModule('@hono/mcp', () => ({
40
40
  }));
41
41
 
42
42
  const mockAuthJson = { configured: true, oauthProvider: { consentPage: '/oauth/consent' } };
43
- jest.unstable_mockModule('../../lib/build/auth.js', () => ({
43
+ vi.doMock('../../lib/build/auth.js', () => ({
44
44
  default: mockAuthJson,
45
45
  }));
46
46
 
@@ -48,7 +48,7 @@ const { default: mcpHandler } = await import('./mcp.js');
48
48
 
49
49
  const originalBetterAuthUrl = process.env.BETTER_AUTH_URL;
50
50
 
51
- const mockReadConfigFile = jest.fn();
51
+ const mockReadConfigFile = vi.fn();
52
52
 
53
53
  let contextOverrides;
54
54
 
@@ -57,7 +57,7 @@ function createApp() {
57
57
  app.use('*', async (c, next) => {
58
58
  c.set('lowdefyContext', {
59
59
  config: { basePath: '' },
60
- logger: { debug: jest.fn(), info: jest.fn(), warn: jest.fn(), error: jest.fn() },
60
+ logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
61
61
  readConfigFile: mockReadConfigFile,
62
62
  ...contextOverrides,
63
63
  });
@@ -73,7 +73,7 @@ beforeEach(() => {
73
73
  contextOverrides = {};
74
74
  mockReadConfigFile.mockReset();
75
75
  mockCreateMcpServer.mockReset();
76
- mockCreateMcpServer.mockResolvedValue({ connect: jest.fn() });
76
+ mockCreateMcpServer.mockResolvedValue({ connect: vi.fn() });
77
77
  mockReadConfigFile.mockResolvedValue({ configured: true, hasPublicTool: true, endpoints: [] });
78
78
  });
79
79
 
@@ -15,9 +15,9 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
- import { jest } from '@jest/globals';
18
+ import { vi, afterAll, beforeEach, expect, test } from 'vitest';
19
19
 
20
- jest.unstable_mockModule('../../lib/build/config.js', () => ({
20
+ vi.doMock('../../lib/build/config.js', () => ({
21
21
  default: { basePath: '' },
22
22
  }));
23
23
 
@@ -14,20 +14,17 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import revertConfigCheckpoint from '../../../lib/docs/revertConfigCheckpoint.js';
17
+ import { getMobileRootConfig } from '@lowdefy/api';
18
18
 
19
- async function docsCheckpointsRevertHandler(c) {
20
- const body = await c.req.json().catch(() => ({}));
21
- if (!body.id) {
22
- return c.json({ error: 'revert requires an "id" of the checkpoint to restore.' }, 400);
23
- }
24
-
25
- try {
26
- const result = revertConfigCheckpoint({ id: body.id });
27
- return c.json(result);
28
- } catch (error) {
29
- return c.json({ error: error.message }, 400);
19
+ // The root config a shell syncs on start (getMobileRootConfig), filtered to
20
+ // the caller. An app without a mobile key has no shell, so it answers 404.
21
+ async function mobileRootHandler(c) {
22
+ const context = c.get('lowdefyContext');
23
+ const rootConfig = await getMobileRootConfig(context);
24
+ if (rootConfig === null) {
25
+ return c.json({ name: 'NotFoundError', message: 'This app has no mobile config.' }, 404);
30
26
  }
27
+ return c.json(rootConfig);
31
28
  }
32
29
 
33
- export default docsCheckpointsRevertHandler;
30
+ export default mobileRootHandler;