@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
@@ -35,6 +35,31 @@ function setupTestFixtures() {
35
35
  write('build/config.json', {});
36
36
  write('build/routes.json', [{ pageId: 'home', path: 'home' }]);
37
37
 
38
+ // The client types a native shell carries (writeAvailableTypes), for target mobile.
39
+ write('build/plugins/availableTypesMobile.json', {
40
+ actions: {
41
+ SetState: {
42
+ package: '@lowdefy/actions-core',
43
+ originalTypeName: 'SetState',
44
+ version: '5.0.0',
45
+ },
46
+ },
47
+ blockMetas: { Button: { category: 'display' }, TextInput: { category: 'input' } },
48
+ blocks: {
49
+ Button: { package: '@lowdefy/blocks-native', originalTypeName: 'Button', version: '5.0.0' },
50
+ TextInput: {
51
+ package: '@lowdefy/blocks-native',
52
+ originalTypeName: 'TextInput',
53
+ version: '5.0.0',
54
+ },
55
+ },
56
+ operators: {
57
+ client: {
58
+ _state: { package: '@lowdefy/operators-js', originalTypeName: '_state', version: '5.0.0' },
59
+ },
60
+ },
61
+ });
62
+
38
63
  write('build/plugins/availableTypes.json', {
39
64
  actions: {
40
65
  SetState: {
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import splitSearchTerms from './splitSearchTerms.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('splitSearchTerms lowercases and splits on spaces and punctuation', () => {
20
21
  expect(splitSearchTerms({ query: 'Link action, pathParams? (path parameters)' })).toEqual([
@@ -18,7 +18,7 @@ import { type } from '@lowdefy/helpers';
18
18
 
19
19
  import { findPageInstance } from './tabChannel.js';
20
20
 
21
- // Shared by inspectState.js and evalOperator.js to decide, when no explicit
21
+ // Used by inspectState.js (through resolveSource.js) to decide, when no explicit
22
22
  // `source` is requested, whether a live browser tab holds the requested page
23
23
  // instance, to prefer over a fresh headless one. A tab the dev server's own
24
24
  // headless browser opened is not one to prefer (findPageInstance never picks it).
@@ -36,7 +36,13 @@ let renderSequence = 0;
36
36
  // headless tool) is automated: it is listed, so the hub keeps
37
37
  // the server alive while it runs, but findPageInstance never picks it for an
38
38
  // agent's or developer's live-tab request.
39
- function registerTab({ id, send, source = 'dev', automated = false }) {
39
+ //
40
+ // A phone shell (Lowdefy Dev) registers with `device`: { shell, platform, app,
41
+ // paired } - its shell version, 'ios' or 'android', its bundle id, and whether
42
+ // it came in over the network with the pairing token rather than on this
43
+ // computer's localhost (a simulator, or a USB phone through adb reverse). A
44
+ // browser tab has none. The device tools address a phone by its tab id.
45
+ function registerTab({ id, send, source = 'dev', automated = false, device = null }) {
40
46
  if (type.isNone(id) || !type.isString(id)) {
41
47
  throw new Error(`registerTab requires an "id" string. Received ${JSON.stringify(id)}.`);
42
48
  }
@@ -50,12 +56,19 @@ function registerTab({ id, send, source = 'dev', automated = false }) {
50
56
  send,
51
57
  source,
52
58
  automated,
59
+ device,
53
60
  connectedAt: new Date(),
54
61
  });
55
62
  }
56
63
 
64
+ function getTab({ id }) {
65
+ return tabs.get(id);
66
+ }
67
+
57
68
  // Records the page instance a tab shows, { pageId, pathParams, instanceKey }, and keeps it among
58
69
  // the instances the tab has rendered, whose contexts the tab still holds.
70
+ const INSTANCES_PER_PAGE = 10;
71
+
59
72
  function updateTabPage({ id, pageId, pathParams, instanceKey }) {
60
73
  const tab = tabs.get(id);
61
74
  if (type.isNone(tab)) {
@@ -75,6 +88,12 @@ function updateTabPage({ id, pageId, pathParams, instanceKey }) {
75
88
  const page = { pageId, pathParams: pathParams ?? {}, instanceKey };
76
89
  tab.page = page;
77
90
  tab.rendered.set(instanceKey, { ...page, sequence: renderSequence });
91
+ // Keep the 10 most recent instances per page, as the engine's keepPageInstance does, so the
92
+ // list matches the contexts the tab still holds.
93
+ const ofPage = Array.from(tab.rendered.values())
94
+ .filter((instance) => instance.pageId === pageId)
95
+ .sort((a, b) => b.sequence - a.sequence);
96
+ ofPage.slice(INSTANCES_PER_PAGE).forEach((instance) => tab.rendered.delete(instance.instanceKey));
78
97
  }
79
98
 
80
99
  function unregisterTab({ id }) {
@@ -82,13 +101,14 @@ function unregisterTab({ id }) {
82
101
  }
83
102
 
84
103
  function listTabs() {
85
- return Array.from(tabs.values()).map(({ id, page, source, automated, connectedAt }) => ({
104
+ return Array.from(tabs.values()).map(({ id, page, source, automated, device, connectedAt }) => ({
86
105
  id,
87
106
  pageId: page?.pageId ?? null,
88
107
  pathParams: page?.pathParams ?? null,
89
108
  instanceKey: page?.instanceKey ?? null,
90
109
  source,
91
110
  automated,
111
+ device,
92
112
  connectedAt,
93
113
  }));
94
114
  }
@@ -123,9 +143,12 @@ function instanceMatches({ instance, pageId, pathParams }) {
123
143
  // - else the requested page's most recently rendered instance (with those values) in any tab,
124
144
  // whose context that tab still holds.
125
145
  // A request naming no page reads the instance on screen in the most recently connected tab.
126
- // Automated tabs are skipped.
146
+ // Automated tabs and phones are skipped: a phone is read only when a tool names it (`device`,
147
+ // findTabInstance), so a request meant for the browser never reads a phone on the same page.
127
148
  function findPageInstance({ pageId, pathParams } = {}) {
128
- const candidates = Array.from(tabs.values()).filter((tab) => !tab.automated);
149
+ const candidates = Array.from(tabs.values()).filter(
150
+ (tab) => !tab.automated && type.isNone(tab.device)
151
+ );
129
152
  const onScreen = candidates.filter(
130
153
  (tab) => !type.isNone(tab.page) && instanceMatches({ instance: tab.page, pageId, pathParams })
131
154
  );
@@ -154,6 +177,46 @@ function findPageInstance({ pageId, pathParams } = {}) {
154
177
  return instance;
155
178
  }
156
179
 
180
+ // The instance a request to one named tab reads: the one it shows, or with a
181
+ // pageId, that page's instance on screen there or else the most recently
182
+ // rendered one it still holds. A request naming no page and a tab showing none
183
+ // yet (an injection, a step) reads no instance: the tab answers from its own
184
+ // screen. Returns { instance } or { error }.
185
+ function findTabInstance({ tabId, pageId, pathParams }) {
186
+ const tab = tabs.get(tabId);
187
+ if (type.isNone(tab)) {
188
+ return {
189
+ error: `No tab "${tabId}" is connected. lowdefy_device with action "list" names the connected phones.`,
190
+ };
191
+ }
192
+ if (type.isNone(pageId)) {
193
+ return { instance: { tab, pageId: null, pathParams: null, instanceKey: null, ...tab.page } };
194
+ }
195
+ if (!type.isNone(tab.page) && instanceMatches({ instance: tab.page, pageId, pathParams })) {
196
+ return { instance: { tab, ...tab.page } };
197
+ }
198
+ let found;
199
+ tab.rendered.forEach((instance) => {
200
+ if (!instanceMatches({ instance, pageId, pathParams })) {
201
+ return;
202
+ }
203
+ if (type.isNone(found) || instance.sequence > found.sequence) {
204
+ found = instance;
205
+ }
206
+ });
207
+ if (type.isNone(found)) {
208
+ const shows = type.isNone(tab.page) ? 'no page yet' : `page "${tab.page.pageId}"`;
209
+ return {
210
+ error: `Tab "${tabId}" has not shown ${describeRequestedPage({
211
+ pageId,
212
+ pathParams,
213
+ })}; it shows ${shows}. Open the page on the device first.`,
214
+ };
215
+ }
216
+ const { sequence, ...instance } = found;
217
+ return { instance: { tab, ...instance } };
218
+ }
219
+
157
220
  function describeRequestedPage({ pageId, pathParams }) {
158
221
  if (type.isNone(pageId)) {
159
222
  return 'any page';
@@ -164,27 +227,39 @@ function describeRequestedPage({ pageId, pathParams }) {
164
227
  return `page "${pageId}" with pathParams ${JSON.stringify(pathParams)}`;
165
228
  }
166
229
 
167
- function requestFromTab({ pageId, pathParams, event, payload = {}, timeout = 5000 }) {
230
+ // Sends one request to a tab and resolves with what it answers. With tabId the
231
+ // request goes to that tab (findTabInstance), else to the tab findPageInstance
232
+ // picks for the page.
233
+ function requestFromTab({ tabId, pageId, pathParams, event, payload = {}, timeout = 5000 }) {
168
234
  if (type.isNone(event) || !type.isString(event)) {
169
235
  throw new Error(
170
236
  `requestFromTab requires an "event" string. Received ${JSON.stringify(event)}.`
171
237
  );
172
238
  }
173
- const instance = findPageInstance({ pageId, pathParams });
174
- if (type.isNone(instance)) {
175
- return Promise.resolve({
176
- error: `No browser tab connected on ${describeRequestedPage({
177
- pageId,
178
- pathParams,
179
- })}. Ask the developer to open the page, or use source: "headless".`,
180
- });
239
+ let instance;
240
+ if (type.isNone(tabId)) {
241
+ instance = findPageInstance({ pageId, pathParams });
242
+ if (type.isNone(instance)) {
243
+ return Promise.resolve({
244
+ error: `No browser tab connected on ${describeRequestedPage({
245
+ pageId,
246
+ pathParams,
247
+ })}. Ask the developer to open the page, or use source: "headless".`,
248
+ });
249
+ }
250
+ } else {
251
+ const found = findTabInstance({ tabId, pageId, pathParams });
252
+ if (!type.isUndefined(found.error)) {
253
+ return Promise.resolve({ error: found.error });
254
+ }
255
+ instance = found.instance;
181
256
  }
182
257
 
183
258
  const requestId = randomUUID();
184
259
  return new Promise((resolve) => {
185
260
  const timer = setTimeout(() => {
186
261
  pendingRequests.delete(requestId);
187
- resolve({ error: `Timed out waiting ${timeout}ms for a response from the browser tab.` });
262
+ resolve({ error: `Timed out waiting ${timeout}ms for a response from the tab.` });
188
263
  }, timeout);
189
264
 
190
265
  pendingRequests.set(requestId, (result) => {
@@ -216,6 +291,7 @@ function resolveTabRequest({ requestId, result }) {
216
291
 
217
292
  export {
218
293
  findPageInstance,
294
+ getTab,
219
295
  listTabs,
220
296
  registerTab,
221
297
  requestFromTab,
@@ -14,7 +14,7 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, afterEach, expect, test } from 'vitest';
18
18
 
19
19
  const {
20
20
  findPageInstance,
@@ -40,7 +40,7 @@ function ticket({ space = 's', ticketId }) {
40
40
  };
41
41
  }
42
42
 
43
- function connectTab({ id, pageId, send = jest.fn(), ...origin }) {
43
+ function connectTab({ id, pageId, send = vi.fn(), ...origin }) {
44
44
  registerTab({ id, send, ...origin });
45
45
  if (pageId) {
46
46
  updateTabPage({ id, pageId, pathParams: {}, instanceKey: `page:${pageId}` });
@@ -49,7 +49,7 @@ function connectTab({ id, pageId, send = jest.fn(), ...origin }) {
49
49
  }
50
50
 
51
51
  test('registerTab adds a tab visible via listTabs, on no page until its first page renders', () => {
52
- registerTab({ id: 'tab-1', send: jest.fn() });
52
+ registerTab({ id: 'tab-1', send: vi.fn() });
53
53
  const tabs = listTabs();
54
54
  expect(tabs).toHaveLength(1);
55
55
  expect(tabs[0]).toMatchObject({ id: 'tab-1', pageId: null, pathParams: null, instanceKey: null });
@@ -57,7 +57,7 @@ test('registerTab adds a tab visible via listTabs, on no page until its first pa
57
57
  });
58
58
 
59
59
  test('registerTab throws when id is missing', () => {
60
- expect(() => registerTab({ send: jest.fn() })).toThrow('registerTab requires');
60
+ expect(() => registerTab({ send: vi.fn() })).toThrow('registerTab requires');
61
61
  });
62
62
 
63
63
  test('registerTab throws when send is not a function', () => {
@@ -88,14 +88,14 @@ test('updateTabPage on an unknown tab id does not throw', () => {
88
88
  });
89
89
 
90
90
  test('updateTabPage throws when the instance key is missing', () => {
91
- registerTab({ id: 'tab-1', send: jest.fn() });
91
+ registerTab({ id: 'tab-1', send: vi.fn() });
92
92
  expect(() => updateTabPage({ id: 'tab-1', pageId: 'about' })).toThrow(
93
93
  'updateTabPage requires "pageId" and "instanceKey" strings'
94
94
  );
95
95
  });
96
96
 
97
97
  test('findPageInstance reads the instance on screen when the tab is on the page', () => {
98
- registerTab({ id: 'tab-1', send: jest.fn() });
98
+ registerTab({ id: 'tab-1', send: vi.fn() });
99
99
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '1' }) });
100
100
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '2' }) });
101
101
  const { tab, ...instance } = findPageInstance({ pageId: 'ticket' });
@@ -104,8 +104,8 @@ test('findPageInstance reads the instance on screen when the tab is on the page'
104
104
  });
105
105
 
106
106
  test('findPageInstance reads the most recently rendered instance when no tab is on the page', () => {
107
- registerTab({ id: 'tab-1', send: jest.fn() });
108
- registerTab({ id: 'tab-2', send: jest.fn() });
107
+ registerTab({ id: 'tab-1', send: vi.fn() });
108
+ registerTab({ id: 'tab-2', send: vi.fn() });
109
109
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '1' }) });
110
110
  updateTabPage({ id: 'tab-2', ...ticket({ ticketId: '2' }) });
111
111
  updateTabPage({ id: 'tab-1', pageId: 'home', instanceKey: 'page:home' });
@@ -116,8 +116,8 @@ test('findPageInstance reads the most recently rendered instance when no tab is
116
116
  });
117
117
 
118
118
  test('findPageInstance prefers a tab showing the page over a later render elsewhere', () => {
119
- registerTab({ id: 'tab-1', send: jest.fn() });
120
- registerTab({ id: 'tab-2', send: jest.fn() });
119
+ registerTab({ id: 'tab-1', send: vi.fn() });
120
+ registerTab({ id: 'tab-2', send: vi.fn() });
121
121
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '1' }) });
122
122
  updateTabPage({ id: 'tab-2', ...ticket({ ticketId: '2' }) });
123
123
  updateTabPage({ id: 'tab-2', pageId: 'home', instanceKey: 'page:home' });
@@ -127,7 +127,7 @@ test('findPageInstance prefers a tab showing the page over a later render elsewh
127
127
  });
128
128
 
129
129
  test('findPageInstance with pathParams reads that instance, comparing values as strings', () => {
130
- registerTab({ id: 'tab-1', send: jest.fn() });
130
+ registerTab({ id: 'tab-1', send: vi.fn() });
131
131
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '1' }) });
132
132
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '2' }) });
133
133
  const { tab, ...instance } = findPageInstance({
@@ -139,7 +139,7 @@ test('findPageInstance with pathParams reads that instance, comparing values as
139
139
  });
140
140
 
141
141
  test('findPageInstance returns undefined for values no tab has rendered', () => {
142
- registerTab({ id: 'tab-1', send: jest.fn() });
142
+ registerTab({ id: 'tab-1', send: vi.fn() });
143
143
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '1' }) });
144
144
  expect(
145
145
  findPageInstance({ pageId: 'ticket', pathParams: { space: 's', ticket_id: '3' } })
@@ -150,14 +150,26 @@ test('findPageInstance returns undefined for values no tab has rendered', () =>
150
150
  test('findPageInstance without a pageId reads the most recently connected tab on screen', () => {
151
151
  connectTab({ id: 'tab-1', pageId: 'home' });
152
152
  connectTab({ id: 'tab-2', pageId: 'about' });
153
- registerTab({ id: 'tab-3', send: jest.fn() });
153
+ registerTab({ id: 'tab-3', send: vi.fn() });
154
154
  const { tab, ...instance } = findPageInstance();
155
155
  expect(tab.id).toEqual('tab-2');
156
156
  expect(instance).toEqual({ pageId: 'about', pathParams: {}, instanceKey: 'page:about' });
157
157
  });
158
158
 
159
+ test('findPageInstance skips a phone on the page for the browser tab', () => {
160
+ connectTab({ id: 'browser', pageId: 'home' });
161
+ connectTab({ id: 'phone', pageId: 'home', device: { shell: 'lowdefy-dev', platform: 'ios' } });
162
+ expect(findPageInstance({ pageId: 'home' }).tab.id).toBe('browser');
163
+ expect(findPageInstance().tab.id).toBe('browser');
164
+ });
165
+
166
+ test('findPageInstance finds no instance when only a phone shows the page', () => {
167
+ connectTab({ id: 'phone', pageId: 'home', device: { shell: 'lowdefy-dev', platform: 'ios' } });
168
+ expect(findPageInstance({ pageId: 'home' })).toBeUndefined();
169
+ });
170
+
159
171
  test('findPageInstance forgets the instances of a tab that disconnected', () => {
160
- registerTab({ id: 'tab-1', send: jest.fn() });
172
+ registerTab({ id: 'tab-1', send: vi.fn() });
161
173
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '1' }) });
162
174
  unregisterTab({ id: 'tab-1' });
163
175
  expect(findPageInstance({ pageId: 'ticket' })).toBeUndefined();
@@ -178,7 +190,7 @@ test('requestFromTab sends the event to the matching tab and resolves via resolv
178
190
  });
179
191
 
180
192
  test('requestFromTab names the instance to read in the event it sends', async () => {
181
- const send = jest.fn();
193
+ const send = vi.fn();
182
194
  registerTab({ id: 'tab-1', send });
183
195
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '1' }) });
184
196
  updateTabPage({ id: 'tab-1', ...ticket({ ticketId: '2' }) });
@@ -286,3 +298,16 @@ test('requestFromTab finds no tab when only an automated tab is on the page', as
286
298
  'No browser tab connected on page "tickets". Ask the developer to open the page, or use source: "headless".',
287
299
  });
288
300
  });
301
+
302
+ test('updateTabPage keeps the 10 most recent instances per page, as the engine does', () => {
303
+ connectTab({ id: 'tab-cap', pageId: 'home' });
304
+ for (let i = 0; i < 12; i += 1) {
305
+ updateTabPage({ id: 'tab-cap', ...ticket({ ticketId: String(i) }) });
306
+ }
307
+ expect(findPageInstance({ pageId: 'ticket', pathParams: { space: 's', ticket_id: '0' } })).toBe(
308
+ undefined
309
+ );
310
+ expect(
311
+ findPageInstance({ pageId: 'ticket', pathParams: { space: 's', ticket_id: '11' } })
312
+ ).toBeDefined();
313
+ });
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import validateJourneyTimeout from './validateJourneyTimeout.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test.each([undefined, 1, 5000, 60000])('validateJourneyTimeout accepts %j', (timeout) => {
20
21
  expect(validateJourneyTimeout({ timeout })).toBeUndefined();
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import validateStateSelection from './validateStateSelection.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test.each([undefined, true, false, [], ['form.name', 'rows']])(
20
21
  'validateStateSelection accepts %j',
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import validateViewport from './validateViewport.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('validateViewport accepts no options and every valid option', () => {
20
21
  expect(validateViewport({})).toBeUndefined();
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import waitForBuild from './waitForBuild.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let configDirectory;
24
25
  const originalConfigDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG;
@@ -18,19 +18,19 @@ 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, expect, test } from 'vitest';
22
22
 
23
23
  import withBrowserSlot from './withBrowserSlot.js';
24
24
 
25
25
  function fakeAcquire() {
26
- const release = jest.fn();
27
- const acquire = jest.fn(async () => ({ release }));
26
+ const release = vi.fn();
27
+ const acquire = vi.fn(async () => ({ release }));
28
28
  return { acquire, release };
29
29
  }
30
30
 
31
31
  test('withBrowserSlot runs the operation in a browser slot and releases it after', async () => {
32
32
  const { acquire, release } = fakeAcquire();
33
- const task = jest.fn(async () => {
33
+ const task = vi.fn(async () => {
34
34
  expect(release).not.toHaveBeenCalled();
35
35
  return { data: 'png' };
36
36
  });
@@ -52,7 +52,7 @@ test('withBrowserSlot answers a slot wait that outlasts its limit as the operati
52
52
  const acquire = async () => {
53
53
  throw new Error('All 3 browser slots on this machine stayed busy for 5 minutes. Try again.');
54
54
  };
55
- const task = jest.fn();
55
+ const task = vi.fn();
56
56
  await expect(withBrowserSlot({ task, acquire })).resolves.toEqual({
57
57
  error: 'All 3 browser slots on this machine stayed busy for 5 minutes. Try again.',
58
58
  });
@@ -19,8 +19,8 @@ import { type } from '@lowdefy/helpers';
19
19
  import getDataStore from './dataSets/getDataStore.js';
20
20
  import openDataSession from './dataSets/openDataSession.js';
21
21
 
22
- // Runs `task` on a data set's own database when the call named one: a fresh
23
- // database on the dev server's memory store, loaded with the data set and
22
+ // Runs `task` on a data set's own databases when the call named one: fresh
23
+ // databases on the dev server's memory store, loaded with the data set and
24
24
  // dropped once the task settles, exactly as a journey's. The task gets
25
25
  // `dataCookie` (for a headless browser context, see openPage) and
26
26
  // `dataSession` (for a context the dev server builds itself, see
@@ -17,6 +17,8 @@
17
17
  import { mergeObjects, type } from '@lowdefy/helpers';
18
18
 
19
19
  import createDataSetRefusal from './createDataSetRefusal.js';
20
+ import describeTargetKey from '../docs/dataSets/describeTargetKey.js';
21
+ import sessionDatabaseName from '../docs/dataSets/sessionDatabaseName.js';
20
22
 
21
23
  // Module connections are written under their module's folder (connections/<module>/<id>.json), so
22
24
  // the pattern matches every depth.
@@ -29,13 +31,16 @@ function hasLiteralKeys(properties) {
29
31
  }
30
32
 
31
33
  // The one gate for connections under a data session, for this request only. It fails closed: a
32
- // connection is either verifiably pointed at the session's database or the read throws. A type
34
+ // connection is either verifiably pointed at a session database or the read throws. A type
33
35
  // declares how it behaves through meta.dataSet on its plugin, in one of three modes:
34
- // - 'redirect' takes its database from databaseUri and databaseName, so the session's are merged
35
- // over its properties whether or not the data set lists it.
36
+ // - 'redirect' takes its database from databaseUri and databaseName, so the session's URI and the
37
+ // session database of its own target (its databaseUri secret or literal and databaseName) are
38
+ // merged over its properties whether or not the data set lists it. Connections on different
39
+ // targets read different databases, as they do outside the session; one whose target is computed
40
+ // per request reads the session's first database.
36
41
  // - 'walled' holds no database address and reaches MongoDB only through the walled client (the
37
42
  // resolver's walled(connectionId) argument), so it passes unchanged: the walled connections it
38
- // names are read through this same gate and take the session database as redirect connections.
43
+ // names are read through this same gate and take their session databases as redirect connections.
39
44
  // - 'external' reaches an outside service and keeps its target.
40
45
  // Anything else, including no declaration, refuses. The gate cannot verify a walled or external
41
46
  // declaration, since properties are evaluated later and may read secrets: it is the plugin
@@ -70,11 +75,15 @@ function applyDataSetRedirect({ context, session, connections }) {
70
75
  reason: 'its properties are an operator, so the redirect cannot be checked',
71
76
  });
72
77
  }
78
+ const target = describeTargetKey({ properties: artifact.properties });
73
79
  return {
74
80
  ...artifact,
75
81
  properties: mergeObjects([
76
82
  artifact.properties,
77
- { databaseUri: session.databaseUri, databaseName: session.databaseName },
83
+ {
84
+ databaseUri: session.databaseUri,
85
+ databaseName: sessionDatabaseName({ session, target }),
86
+ },
78
87
  ]),
79
88
  };
80
89
  };