@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
@@ -0,0 +1,223 @@
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 { etag } from 'hono/etag';
19
+ import { vi, expect, test } from 'vitest';
20
+
21
+ // What a mobile shell and a browser each get from the dev server: the dev
22
+ // mobile root and JIT pages behind the surface gate, with the real
23
+ // @lowdefy/api and the middleware app.js puts on these routes. The JIT build
24
+ // itself is stubbed.
25
+
26
+ vi.doMock('../../lib/docs/getBuildId.js', () => ({
27
+ default: () => 'build-a',
28
+ }));
29
+
30
+ const mockBuildPageWithContext = vi.fn(async () => ({ result: true, buildContext: {} }));
31
+ vi.doMock('../../lib/server/jitPageBuilder.js', () => ({
32
+ buildPageWithContext: mockBuildPageWithContext,
33
+ getPageJitEnrichment: ({ pageConfig }) =>
34
+ pageConfig.target === 'mobile' ? { jsEntries: 'export default {};' } : {},
35
+ }));
36
+
37
+ vi.doMock('../../lib/build/auth.js', () => ({
38
+ default: { authPages: { signIn: '/auth/login', twoFactorEnrol: '/two-factor-enrol' } },
39
+ }));
40
+
41
+ vi.doMock('../../lib/build/config.js', () => ({
42
+ default: { basePath: '' },
43
+ }));
44
+
45
+ const { default: jitPageHandler } = await import('./jitPage.js');
46
+ const { default: mobileRootHandler } = await import('./mobileRoot.js');
47
+ const { default: noStore } = await import('../middleware/noStore.js');
48
+ const { default: stampCaller } = await import('../middleware/stampCaller.js');
49
+
50
+ const routes = [
51
+ { pageId: 'home', path: 'home', auth: { public: true } },
52
+ { pageId: 'today', path: 'today', auth: { public: true } },
53
+ { pageId: 'jobs', path: 'jobs/{job_id}', auth: { public: true } },
54
+ { pageId: 'admin', path: 'admin', auth: { public: false, roles: ['admin'] } },
55
+ ];
56
+
57
+ const pages = {
58
+ home: { id: 'page:home', pageId: 'home', target: 'web', auth: { public: true } },
59
+ today: { id: 'page:today', pageId: 'today', target: 'mobile', auth: { public: true } },
60
+ // A page built on request carries its own classes' class map entries.
61
+ jobs: {
62
+ id: 'page:jobs',
63
+ pageId: 'jobs',
64
+ target: 'mobile',
65
+ auth: { public: true },
66
+ _classMap: { 'text-lg': { fontSize: 18, lineHeight: 28 } },
67
+ },
68
+ admin: {
69
+ id: 'page:admin',
70
+ pageId: 'admin',
71
+ target: 'mobile',
72
+ auth: { public: false, roles: ['admin'] },
73
+ },
74
+ };
75
+
76
+ // The dev build's mobile artifacts: paths only, no hashes or type sets.
77
+ const configFiles = {
78
+ 'routes.json': routes,
79
+ 'mobile/config.json': {
80
+ homePageId: 'today',
81
+ minShellVersion: null,
82
+ menus: {
83
+ tabs: [
84
+ { pageId: 'today', title: 'Today' },
85
+ { pageId: 'admin', title: 'Admin' },
86
+ ],
87
+ },
88
+ shells: [],
89
+ },
90
+ 'mobile/pageIndex.json': [
91
+ { path: 'today', pageId: 'today' },
92
+ { path: 'jobs/{job_id}', pageId: 'jobs' },
93
+ { path: 'admin', pageId: 'admin' },
94
+ ],
95
+ 'mobile/typeSets.json': {},
96
+ // The skeleton build writes the theme and the class map of the pages it compiles.
97
+ 'mobile/theme.json': {
98
+ darkMode: 'system',
99
+ light: { colorPrimary: '#1677ff' },
100
+ dark: { colorPrimary: '#1668dc' },
101
+ },
102
+ 'mobile/classMap.json': { 'p-4': { paddingTop: 16 } },
103
+ 'mobile/appJs.json': { jsEntries: null },
104
+ };
105
+
106
+ function authorizeOutcome(user) {
107
+ return function outcome(config) {
108
+ if (config.auth.public === true) return 'allow';
109
+ if (!user) return 'deny';
110
+ if (!config.auth.roles.some((role) => user.roles.includes(role))) return 'deny';
111
+ return 'allow';
112
+ };
113
+ }
114
+
115
+ function createApp() {
116
+ const app = new Hono();
117
+ app.use('/api/*', async (c, next) => {
118
+ const user = c.req.header('x-test-roles')
119
+ ? { id: 'u1', roles: c.req.header('x-test-roles').split(',') }
120
+ : null;
121
+ c.set('lowdefyContext', {
122
+ user,
123
+ authSession: null,
124
+ authEnforcement: null,
125
+ authorizeOutcome: authorizeOutcome(user),
126
+ buildDirectory: '/build',
127
+ configDirectory: '/config',
128
+ handleError: vi.fn(),
129
+ logger: { debug: vi.fn(), info: vi.fn(), error: vi.fn() },
130
+ readConfigFile: async (file) => {
131
+ if (file.startsWith('pages/')) return pages[file.slice(6, -5)] ?? null;
132
+ return configFiles[file];
133
+ },
134
+ });
135
+ await next();
136
+ });
137
+ ['/api/mobile/root', '/api/page/*'].forEach((route) => {
138
+ app.use(route, noStore());
139
+ app.use(route, stampCaller());
140
+ app.use(route, etag());
141
+ });
142
+ app.get('/api/mobile/root', mobileRootHandler);
143
+ app.get('/api/page/*', jitPageHandler);
144
+ return app;
145
+ }
146
+
147
+ const shell = { 'x-lowdefy-shell': 'dev' };
148
+
149
+ test('the dev mobile root lists the paths of the pages the caller may open, with the theme and class map', async () => {
150
+ const res = await createApp().request('/api/mobile/root', { headers: shell });
151
+ expect(res.status).toEqual(200);
152
+ expect(await res.json()).toEqual({
153
+ _jsEntries: null,
154
+ auth: null,
155
+ homePageId: 'today',
156
+ i18n: {},
157
+ lowdefyGlobal: {},
158
+ minShellVersion: null,
159
+ menus: { tabs: [{ pageId: 'today', title: 'Today' }] },
160
+ pageIndex: [
161
+ { path: 'today', pageId: 'today' },
162
+ { path: 'jobs/{job_id}', pageId: 'jobs' },
163
+ ],
164
+ typeSets: {},
165
+ theme: configFiles['mobile/theme.json'],
166
+ classMap: configFiles['mobile/classMap.json'],
167
+ });
168
+ const admin = await createApp().request('/api/mobile/root', {
169
+ headers: { ...shell, 'x-test-roles': 'admin' },
170
+ });
171
+ expect((await admin.json()).pageIndex.map((entry) => entry.pageId)).toEqual([
172
+ 'today',
173
+ 'jobs',
174
+ 'admin',
175
+ ]);
176
+ });
177
+
178
+ test('the dev mobile root answers 304 to a matching If-None-Match', async () => {
179
+ const app = createApp();
180
+ const first = await app.request('/api/mobile/root', { headers: shell });
181
+ const etagValue = first.headers.get('etag');
182
+ expect(etagValue).toMatch(/^"[^"]+"$/);
183
+ const second = await app.request('/api/mobile/root', {
184
+ headers: { ...shell, 'if-none-match': etagValue },
185
+ });
186
+ expect(second.status).toEqual(304);
187
+ expect(second.headers.get('cache-control')).toEqual('private, no-store');
188
+ expect(second.headers.get('x-lowdefy-caller')).not.toBeNull();
189
+ });
190
+
191
+ test('a shell gets a mobile page with its _jsEntries and _classMap', async () => {
192
+ const res = await createApp().request('/api/page/jobs/42', { headers: shell });
193
+ expect(res.status).toEqual(200);
194
+ const body = await res.json();
195
+ expect(body.pageId).toEqual('jobs');
196
+ expect(body.pathParams).toEqual({ job_id: '42' });
197
+ expect(body.pageConfig._jsEntries).toEqual('export default {};');
198
+ expect(body.pageConfig._classMap).toEqual({ 'text-lg': { fontSize: 18, lineHeight: 28 } });
199
+ expect(body.pageConfig.target).toEqual('mobile');
200
+ });
201
+
202
+ test('a browser asking for a mobile page gets 404 naming the mobile surface', async () => {
203
+ const res = await createApp().request('/api/page/today');
204
+ expect(res.status).toEqual(404);
205
+ expect(await res.json()).toEqual({ pageConfig: null, surface: 'mobile' });
206
+ });
207
+
208
+ test('a shell asking for a web page gets 404 naming the web surface', async () => {
209
+ const res = await createApp().request('/api/page/home', { headers: shell });
210
+ expect(res.status).toEqual(404);
211
+ expect(await res.json()).toEqual({ pageConfig: null, surface: 'web' });
212
+ const browser = await createApp().request('/api/page/home');
213
+ expect(browser.status).toEqual(200);
214
+ });
215
+
216
+ test('a dev page answers 304 to a matching If-None-Match', async () => {
217
+ const app = createApp();
218
+ const first = await app.request('/api/page/today', { headers: shell });
219
+ const second = await app.request('/api/page/today', {
220
+ headers: { ...shell, 'if-none-match': first.headers.get('etag') },
221
+ });
222
+ expect(second.status).toEqual(304);
223
+ });
@@ -0,0 +1,58 @@
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 { handleMobileSignIn } from '@lowdefy/api';
18
+ import { type } from '@lowdefy/helpers';
19
+
20
+ import authJson from '../../lib/build/auth.js';
21
+ import getAuth from '../../lib/server/auth/getAuth.js';
22
+ import getMockUser from '../../lib/server/auth/getMockUser.js';
23
+ import lowdefyConfig from '../../lib/build/config.js';
24
+ import themeConfig from '../../lib/build/theme.js';
25
+
26
+ // The auth engine is off while dev.mockUser is set and for journeys on a data
27
+ // set, as on /api/auth/* (routes/auth.js).
28
+ function getEngine(c) {
29
+ if (authJson.configured !== true || getMockUser()) {
30
+ return null;
31
+ }
32
+ if (!type.isNone(c.get('lowdefyContext')?.dataSet)) {
33
+ return null;
34
+ }
35
+ return getAuth({ logger: c.get('lowdefyContext').logger });
36
+ }
37
+
38
+ // GET and POST /auth/mobile - the sign-in page a phone shell opens in a system
39
+ // sheet. handleMobileSignIn sends the person through the app's sign-in page,
40
+ // asks them to confirm (GET), and on Continue (POST) returns a one-time token
41
+ // for a new phone session, bound to the shell's PKCE code challenge, to the
42
+ // shell's scheme (iOS) or app link (Android). The page takes the app theme's
43
+ // primary colour. An app without a mobile section has no such page, so the
44
+ // path falls through to the app's own pages.
45
+ function mobileSignInHandler(c, next) {
46
+ if (type.isNone(authJson.mobile)) {
47
+ return next();
48
+ }
49
+ return handleMobileSignIn({
50
+ auth: getEngine(c),
51
+ authJson,
52
+ basePath: lowdefyConfig.basePath ?? '',
53
+ primaryColor: themeConfig.antd?.token?.colorPrimary,
54
+ request: c.req.raw,
55
+ });
56
+ }
57
+
58
+ export default mobileSignInHandler;
@@ -0,0 +1,59 @@
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 { vi, beforeEach, expect, test } from 'vitest';
18
+
19
+ const authJson = {};
20
+ const handleMobileSignIn = vi.fn(() => new Response('mobile sign-in'));
21
+
22
+ vi.doMock('@lowdefy/api', () => ({ handleMobileSignIn }));
23
+ vi.doMock('../../lib/build/auth.js', () => ({ default: authJson }));
24
+ vi.doMock('../../lib/build/config.js', () => ({ default: {} }));
25
+ vi.doMock('../../lib/build/theme.js', () => ({
26
+ default: { antd: { token: { colorPrimary: '#00aa55' } } },
27
+ }));
28
+ vi.doMock('../../lib/server/auth/getAuth.js', () => ({ default: () => null }));
29
+ vi.doMock('../../lib/server/auth/getMockUser.js', () => ({ default: () => null }));
30
+ const { default: mobileSignInHandler } = await import('./mobileSignIn.js');
31
+
32
+ function createContext() {
33
+ return {
34
+ get: () => ({ logger: {} }),
35
+ req: { raw: new Request('http://localhost/auth/mobile') },
36
+ };
37
+ }
38
+
39
+ beforeEach(() => {
40
+ delete authJson.mobile;
41
+ handleMobileSignIn.mockClear();
42
+ });
43
+
44
+ test('mobileSignInHandler falls through to the app pages when the app has no mobile section', async () => {
45
+ const next = vi.fn(() => 'page');
46
+ expect(await mobileSignInHandler(createContext(), next)).toEqual('page');
47
+ expect(handleMobileSignIn).not.toHaveBeenCalled();
48
+ });
49
+
50
+ test('mobileSignInHandler serves the mobile sign-in page when the app has a mobile section', async () => {
51
+ authJson.mobile = { shells: [] };
52
+ const next = vi.fn();
53
+ const res = await mobileSignInHandler(createContext(), next);
54
+ expect(await res.text()).toEqual('mobile sign-in');
55
+ expect(next).not.toHaveBeenCalled();
56
+ expect(handleMobileSignIn).toHaveBeenCalledWith(
57
+ expect.objectContaining({ basePath: '', primaryColor: '#00aa55' })
58
+ );
59
+ });
@@ -0,0 +1,34 @@
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 { handleMobileSignInCallback } from '@lowdefy/api';
18
+ import { type } from '@lowdefy/helpers';
19
+
20
+ import authJson from '../../lib/build/auth.js';
21
+ import themeConfig from '../../lib/build/theme.js';
22
+
23
+ // GET /auth/mobile/callback - the Android app link the sign-in sheet returns
24
+ // to. Android opens it in the shell; this page shows only when the link is not
25
+ // verified, and asks the person to return to the app. An app without a mobile
26
+ // section has no such page, so the path falls through to the app's own pages.
27
+ function mobileSignInCallbackHandler(c, next) {
28
+ if (type.isNone(authJson.mobile)) {
29
+ return next();
30
+ }
31
+ return handleMobileSignInCallback({ primaryColor: themeConfig.antd?.token?.colorPrimary });
32
+ }
33
+
34
+ export default mobileSignInCallbackHandler;
@@ -0,0 +1,51 @@
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 { vi, beforeEach, expect, test } from 'vitest';
18
+
19
+ const authJson = {};
20
+
21
+ vi.doMock('../../lib/build/auth.js', () => ({ default: authJson }));
22
+ vi.doMock('../../lib/build/theme.js', () => ({
23
+ default: { antd: { token: { colorPrimary: '#00aa55' } } },
24
+ }));
25
+ const { default: mobileSignInCallbackHandler } = await import('./mobileSignInCallback.js');
26
+
27
+ beforeEach(() => {
28
+ delete authJson.mobile;
29
+ });
30
+
31
+ test('mobileSignInCallbackHandler falls through to the app pages when the app has no mobile section', async () => {
32
+ const next = vi.fn(() => 'page');
33
+ expect(await mobileSignInCallbackHandler({}, next)).toEqual('page');
34
+ });
35
+
36
+ test('mobileSignInCallbackHandler asks the person to return to the app and never echoes the token', async () => {
37
+ authJson.mobile = { shells: [] };
38
+ const next = vi.fn();
39
+ const res = await mobileSignInCallbackHandler(
40
+ { req: { raw: new Request('http://localhost/auth/mobile/callback?token=ott-secret&state=s') } },
41
+ next
42
+ );
43
+ expect(next).not.toHaveBeenCalled();
44
+ expect(res.status).toEqual(200);
45
+ expect(res.headers.get('cache-control')).toEqual('no-store');
46
+ expect(res.headers.get('referrer-policy')).toEqual('no-referrer');
47
+ const html = await res.text();
48
+ expect(html).toContain('Return to the app');
49
+ expect(html).toContain('--primary: #00aa55;');
50
+ expect(html).not.toContain('ott-secret');
51
+ });
@@ -14,11 +14,19 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
+ import mobileSignInCallbackHandler from './mobileSignInCallback.js';
18
+ import mobileSignInHandler from './mobileSignIn.js';
19
+
17
20
  // Every page path renders the same dev shell; the client reads the page from
18
- // the URL. `.*`, not `.+`: under a basePath, `<basePath>/` arrives with an
19
- // empty rest, and is the app root like `<basePath>` itself.
21
+ // the URL. `/auth/mobile`, the sign-in page a phone shell opens (and its
22
+ // confirmation post), and `/auth/mobile/callback`, its Android app link, are
23
+ // server routes ahead of it. `.*`, not `.+`: under a basePath, `<basePath>/`
24
+ // arrives with an empty rest, and is the app root like `<basePath>` itself.
20
25
  function mountDevPageRoutes({ app, renderPage }) {
21
26
  app.get('/', renderPage);
27
+ app.get('/auth/mobile', mobileSignInHandler);
28
+ app.post('/auth/mobile', mobileSignInHandler);
29
+ app.get('/auth/mobile/callback', mobileSignInCallbackHandler);
22
30
  app.get('/:rest{.*}', renderPage);
23
31
  }
24
32
 
@@ -15,8 +15,16 @@
15
15
  */
16
16
 
17
17
  import { Hono } from 'hono';
18
+ import { vi, expect, test } from 'vitest';
18
19
 
19
- import mountDevPageRoutes from './mountDevPageRoutes.js';
20
+ vi.doMock('./mobileSignIn.js', () => ({
21
+ default: (c) => c.text(`mobile sign-in ${c.req.method}`),
22
+ }));
23
+ vi.doMock('./mobileSignInCallback.js', () => ({
24
+ default: (c) => c.text('mobile sign-in callback'),
25
+ }));
26
+
27
+ const { default: mountDevPageRoutes } = await import('./mountDevPageRoutes.js');
20
28
 
21
29
  test.each([
22
30
  ['/app', '/app'],
@@ -28,3 +36,19 @@ test.each([
28
36
  const res = await app.request(path);
29
37
  expect(await res.text()).toEqual('shell');
30
38
  });
39
+
40
+ test.each([[''], ['/app']])(
41
+ 'with basePath "%s", /auth/mobile is the mobile sign-in route, not the dev shell',
42
+ async (basePath) => {
43
+ const app = basePath === '' ? new Hono() : new Hono().basePath(basePath);
44
+ mountDevPageRoutes({ app, renderPage: (c) => c.text('shell') });
45
+ const res = await app.request(`${basePath}/auth/mobile?shell=field&state=s`);
46
+ expect(await res.text()).toEqual('mobile sign-in GET');
47
+ const posted = await app.request(`${basePath}/auth/mobile?shell=field&state=s`, {
48
+ method: 'POST',
49
+ });
50
+ expect(await posted.text()).toEqual('mobile sign-in POST');
51
+ const callback = await app.request(`${basePath}/auth/mobile/callback?state=s`);
52
+ expect(await callback.text()).toEqual('mobile sign-in callback');
53
+ }
54
+ );
@@ -0,0 +1,35 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { createAppleAppSiteAssociation, createAssetLinks } from '@lowdefy/api';
18
+
19
+ // The universal link (iOS) and app link (Android) documents for the app's
20
+ // shells, from mobile.shells. Both are public, unauthenticated and constant per
21
+ // build, so they are built once and mount outside the api context, before the
22
+ // /.well-known/* catch-all. A document no shell needs is not mounted, so the
23
+ // catch-all answers 404 for it.
24
+ function mountMobileWellKnown({ app, basePath, mobileConfig }) {
25
+ const appleAppSiteAssociation = createAppleAppSiteAssociation({ mobileConfig, basePath });
26
+ if (appleAppSiteAssociation !== null) {
27
+ app.get('/.well-known/apple-app-site-association', (c) => c.json(appleAppSiteAssociation));
28
+ }
29
+ const assetLinks = createAssetLinks({ mobileConfig });
30
+ if (assetLinks !== null) {
31
+ app.get('/.well-known/assetlinks.json', (c) => c.json(assetLinks));
32
+ }
33
+ }
34
+
35
+ export default mountMobileWellKnown;
@@ -0,0 +1,79 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { expect, test } from 'vitest';
18
+ import { Hono } from 'hono';
19
+
20
+ import mountMobileWellKnown from './mountMobileWellKnown.js';
21
+ import wellKnownFallbackHandler from './wellKnownFallback.js';
22
+
23
+ function createApp({ mobileConfig, basePath = '' }) {
24
+ const app = new Hono();
25
+ mountMobileWellKnown({ app, basePath, mobileConfig });
26
+ app.all('/.well-known/*', wellKnownFallbackHandler);
27
+ return app;
28
+ }
29
+
30
+ test('mountMobileWellKnown serves both documents when shells take iOS and Android links', async () => {
31
+ const app = createApp({
32
+ mobileConfig: {
33
+ shells: [
34
+ { id: 'ios', ios: { bundleId: 'com.example.ios', teamId: 'TEAM1' } },
35
+ { id: 'droid', android: { package: 'com.example.droid', sha256: ['AA:BB'] } },
36
+ ],
37
+ },
38
+ basePath: '/app',
39
+ });
40
+ const aasa = await app.request('/.well-known/apple-app-site-association');
41
+ expect(aasa.status).toEqual(200);
42
+ const aasaBody = await aasa.json();
43
+ expect(aasaBody.applinks.details[0].appIDs).toEqual(['TEAM1.com.example.ios']);
44
+ expect(aasaBody.applinks.details[0].components).toEqual([
45
+ { '/': '/app/api/*', exclude: true },
46
+ { '/': '/app/*' },
47
+ ]);
48
+ const assetLinks = await app.request('/.well-known/assetlinks.json');
49
+ expect(assetLinks.status).toEqual(200);
50
+ const assetLinksBody = await assetLinks.json();
51
+ expect(assetLinksBody[0].target.package_name).toEqual('com.example.droid');
52
+ // The sign-in sheet's Android app link (/auth/mobile/callback) is verified by this relation.
53
+ expect(assetLinksBody[0].relation).toEqual(['delegate_permission/common.handle_all_urls']);
54
+ });
55
+
56
+ test('mountMobileWellKnown leaves both to the 404 catch-all for an app without shells', async () => {
57
+ const app = createApp({ mobileConfig: {} });
58
+ const aasa = await app.request('/.well-known/apple-app-site-association');
59
+ expect(aasa.status).toEqual(404);
60
+ expect((await aasa.json()).name).toEqual('NotFoundError');
61
+ const assetLinks = await app.request('/.well-known/assetlinks.json');
62
+ expect(assetLinks.status).toEqual(404);
63
+ });
64
+
65
+ test('mountMobileWellKnown serves only the document a shell needs', async () => {
66
+ const app = createApp({
67
+ mobileConfig: { shells: [{ id: 'ios', ios: { bundleId: 'com.example.ios', teamId: 'T' } }] },
68
+ });
69
+ expect((await app.request('/.well-known/apple-app-site-association')).status).toEqual(200);
70
+ expect((await app.request('/.well-known/assetlinks.json')).status).toEqual(404);
71
+ });
72
+
73
+ test('the catch-all still answers other well-known paths', async () => {
74
+ const app = createApp({
75
+ mobileConfig: { shells: [{ id: 'ios', ios: { bundleId: 'com.example.ios', teamId: 'T' } }] },
76
+ });
77
+ const res = await app.request('/.well-known/openid-configuration');
78
+ expect(res.status).toEqual(404);
79
+ });
@@ -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 mockCreateAsMetadataHandler = jest.fn(
20
+ const mockCreateAsMetadataHandler = vi.fn(
21
21
  () => async () =>
22
22
  new Response(JSON.stringify({ issuer: 'https://app.test.com/api/auth' }), {
23
23
  status: 200,
24
24
  headers: { 'content-type': 'application/json' },
25
25
  })
26
26
  );
27
- jest.unstable_mockModule('@lowdefy/api', () => ({
27
+ vi.doMock('@lowdefy/api', () => ({
28
28
  createAsMetadataHandler: mockCreateAsMetadataHandler,
29
29
  }));
30
30
 
31
- jest.unstable_mockModule('./mcpProtectedResourceMetadata.js', () => ({
31
+ vi.doMock('./mcpProtectedResourceMetadata.js', () => ({
32
32
  default: (c) => c.json({ resource: 'mcp' }),
33
33
  }));
34
34
 
35
35
  const mockAuthJson = { configured: true };
36
- jest.unstable_mockModule('../../lib/build/auth.js', () => ({
36
+ vi.doMock('../../lib/build/auth.js', () => ({
37
37
  default: mockAuthJson,
38
38
  }));
39
39
 
@@ -17,6 +17,7 @@
17
17
  import { Hono } from 'hono';
18
18
 
19
19
  import normalizeMcpProtocolVersionHeader from './normalizeMcpProtocolVersionHeader.js';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  function createApp() {
22
23
  const app = new Hono();