@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
@@ -16,33 +16,53 @@
16
16
 
17
17
  import { EventEmitter } from 'node:events';
18
18
 
19
- import { jest } from '@jest/globals';
19
+ import { vi, expect, test } from 'vitest';
20
20
 
21
- const mockSpawn = jest.fn();
22
- const mockSpawnSync = jest.fn();
23
- jest.unstable_mockModule('child_process', () => ({ spawn: mockSpawn, spawnSync: mockSpawnSync }));
21
+ const mockSpawn = vi.fn();
22
+ const mockSpawnSync = vi.fn();
23
+ vi.doMock('child_process', () => ({ spawn: mockSpawn, spawnSync: mockSpawnSync }));
24
24
 
25
25
  // A file of its own: installHeadlessShell keeps its one install per process
26
26
  // in module state.
27
+ const mockLogger = { info: vi.fn(), warn: vi.fn() };
28
+ vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
29
+
27
30
  const { default: installHeadlessShell } = await import('./installHeadlessShell.js');
28
31
 
29
32
  test('installHeadlessShell kills an install that has not finished within 3 minutes and gives up', async () => {
30
33
  // performance is not redefinable on this Node, and nothing here reads it.
31
- jest.useFakeTimers({ doNotFake: ['performance'] });
32
- const warn = jest.spyOn(console, 'warn').mockImplementation(() => {});
33
- jest.spyOn(console, 'info').mockImplementation(() => {});
34
+ vi.useFakeTimers({
35
+ toFake: [
36
+ 'Date',
37
+ 'hrtime',
38
+ 'queueMicrotask',
39
+ 'requestAnimationFrame',
40
+ 'cancelAnimationFrame',
41
+ 'requestIdleCallback',
42
+ 'cancelIdleCallback',
43
+ 'setImmediate',
44
+ 'clearImmediate',
45
+ 'setInterval',
46
+ 'clearInterval',
47
+ 'setTimeout',
48
+ 'clearTimeout',
49
+ ],
50
+ });
51
+ const warn = mockLogger.warn;
52
+ warn.mockClear();
53
+ mockLogger.info.mockClear();
34
54
  try {
35
55
  const installer = Object.assign(new EventEmitter(), {
36
56
  pid: 4242,
37
57
  stderr: new EventEmitter(),
38
- kill: jest.fn(),
58
+ kill: vi.fn(),
39
59
  });
40
60
  mockSpawn.mockReturnValue(installer);
41
61
 
42
62
  const install = installHeadlessShell();
43
- jest.advanceTimersByTime(3 * 60 * 1000 - 1);
63
+ vi.advanceTimersByTime(3 * 60 * 1000 - 1);
44
64
  expect(installer.kill).not.toHaveBeenCalled();
45
- jest.advanceTimersByTime(1);
65
+ vi.advanceTimersByTime(1);
46
66
 
47
67
  const result = await install;
48
68
  expect(result.installed).toBe(false);
@@ -66,7 +86,7 @@ test('installHeadlessShell kills an install that has not finished within 3 minut
66
86
  expect(installHeadlessShell()).toBe(install);
67
87
  expect(mockSpawn).toHaveBeenCalledTimes(1);
68
88
  } finally {
69
- jest.useRealTimers();
70
- jest.restoreAllMocks();
89
+ vi.useRealTimers();
90
+ vi.restoreAllMocks();
71
91
  }
72
92
  });
@@ -0,0 +1,37 @@
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 { type } from '@lowdefy/helpers';
18
+
19
+ // Structural equality over values that have already been through a JSON
20
+ // round-trip (a page's state read in the browser or on a phone: no undefined,
21
+ // no Dates, no functions) — so key order is the only thing that must not matter.
22
+ function isDeepEqual(a, b) {
23
+ if (a === b) {
24
+ return true;
25
+ }
26
+ if (type.isArray(a) && type.isArray(b)) {
27
+ return a.length === b.length && a.every((item, index) => isDeepEqual(item, b[index]));
28
+ }
29
+ if (type.isObject(a) && type.isObject(b)) {
30
+ const keysA = Object.keys(a);
31
+ const keysB = Object.keys(b);
32
+ return keysA.length === keysB.length && keysA.every((key) => isDeepEqual(a[key], b[key]));
33
+ }
34
+ return false;
35
+ }
36
+
37
+ export default isDeepEqual;
@@ -17,6 +17,7 @@
17
17
  import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
+ import { afterAll, afterEach, expect, test } from 'vitest';
20
21
 
21
22
  // Playwright's registry reads PLAYWRIGHT_BROWSERS_PATH when it loads, so it
22
23
  // is set before the first import.
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import isPageReady from './isPageReady.js';
18
+ import { afterEach, expect, test } from 'vitest';
18
19
 
19
20
  // isPageReady runs against `window` inside the browser, so each case installs
20
21
  // a stub context on global.window and asserts the boolean.
@@ -16,7 +16,7 @@
16
16
 
17
17
  import http from 'node:http';
18
18
 
19
- import { jest } from '@jest/globals';
19
+ import { vi, afterAll, beforeAll, expect, test } from 'vitest';
20
20
 
21
21
  import pageReadyScript from '../../test-utils/pageReadyScript.mjs';
22
22
 
@@ -26,7 +26,7 @@ import pageReadyScript from '../../test-utils/pageReadyScript.mjs';
26
26
  // verifies, it rides every request of every actor of the journey and nothing
27
27
  // from any other context, page JavaScript cannot read it, and a detached hop
28
28
  // forwards it alone. Skipped when no Chromium can be launched.
29
- jest.unstable_mockModule('../build/config.js', () => ({ default: {} }));
29
+ vi.doMock('../build/config.js', () => ({ default: {} }));
30
30
 
31
31
  const { getBrowser, openPage } = await import('./getBrowser.js');
32
32
  const { default: createJourneyActors } = await import('./createJourneyActors.js');
@@ -74,7 +74,7 @@ beforeAll(async () => {
74
74
  origin = `http://127.0.0.1:${server.address().port}`;
75
75
  });
76
76
 
77
- // Closing Chromium on Windows can take longer than Jest's 5 s hook default.
77
+ // Closing Chromium on Windows can take longer than the 10 s hook default.
78
78
  afterAll(async () => {
79
79
  await browser?.close();
80
80
  server.closeAllConnections();
@@ -17,6 +17,7 @@
17
17
  import { isTraceId } from '@lowdefy/helpers';
18
18
 
19
19
  import journeyRunRecording from './journeyRunRecording.js';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  test('journeyRunRecording keeps the recording a caller passes', () => {
22
23
  const recording = {
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import keepEventStreamAlive from './keepEventStreamAlive.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  const encoder = new TextEncoder();
20
21
  const answer = 'event: message\ndata: {"jsonrpc":"2.0","id":1,"result":{}}\n\n';
@@ -14,17 +14,17 @@
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
- const mockLaunch = jest.fn();
20
- const mockInstall = jest.fn();
21
- const mockIsIncomplete = jest.fn(async () => false);
22
- jest.unstable_mockModule('playwright-core', () => ({
19
+ const mockLaunch = vi.fn();
20
+ const mockInstall = vi.fn();
21
+ const mockIsIncomplete = vi.fn(async () => false);
22
+ vi.doMock('playwright-core', () => ({
23
23
  chromium: { launch: mockLaunch },
24
- selectors: { register: jest.fn(async () => {}) },
24
+ selectors: { register: vi.fn(async () => {}) },
25
25
  }));
26
- jest.unstable_mockModule('./installHeadlessShell.js', () => ({ default: mockInstall }));
27
- jest.unstable_mockModule('./isHeadlessShellIncomplete.js', () => ({ default: mockIsIncomplete }));
26
+ vi.doMock('./installHeadlessShell.js', () => ({ default: mockInstall }));
27
+ vi.doMock('./isHeadlessShellIncomplete.js', () => ({ default: mockIsIncomplete }));
28
28
 
29
29
  const { default: launchBrowser } = await import('./launchBrowser.js');
30
30
 
@@ -30,10 +30,19 @@ function usedTypeNames({ store }) {
30
30
  return used;
31
31
  }
32
32
 
33
- function flattenKind({ kind, availableTypes }) {
33
+ const TARGETS = ['web', 'mobile'];
34
+
35
+ // The kinds a native shell draws or runs itself. Every other kind (connections,
36
+ // requests, server operators, agents, ...) runs on the app's server, the same
37
+ // for a phone as for a browser.
38
+ const SHELL_KINDS = ['blocks', 'actions'];
39
+
40
+ function flattenKind({ kind, availableTypes, clientOperators }) {
34
41
  if (kind === 'operators') {
35
42
  const merged = {};
36
- for (const [typeName, definition] of Object.entries(availableTypes.operators?.client ?? {})) {
43
+ for (const [typeName, definition] of Object.entries(
44
+ clientOperators ?? availableTypes.operators?.client ?? {}
45
+ )) {
37
46
  merged[typeName] = { ...definition, environments: ['client'] };
38
47
  }
39
48
  for (const [typeName, definition] of Object.entries(availableTypes.operators?.server ?? {})) {
@@ -48,7 +57,30 @@ function flattenKind({ kind, availableTypes }) {
48
57
  return availableTypes[kind] ?? {};
49
58
  }
50
59
 
51
- function listTypes({ kind }) {
60
+ // The types of a kind a target can use. For `mobile`, blocks, actions and
61
+ // client operators are the ones a native shell carries
62
+ // (plugins/availableTypesMobile.json), not the app's installed web plugins.
63
+ function availableForTarget({ kind, target, availableTypes, availableTypesMobile }) {
64
+ if (target !== 'mobile') {
65
+ return { definitions: flattenKind({ kind, availableTypes }), fromShell: false };
66
+ }
67
+ if (SHELL_KINDS.includes(kind)) {
68
+ return { definitions: availableTypesMobile[kind] ?? {}, fromShell: true };
69
+ }
70
+ if (kind === 'operators') {
71
+ return {
72
+ definitions: flattenKind({
73
+ kind,
74
+ availableTypes,
75
+ clientOperators: availableTypesMobile.operators?.client ?? {},
76
+ }),
77
+ fromShell: true,
78
+ };
79
+ }
80
+ return { definitions: flattenKind({ kind, availableTypes }), fromShell: false };
81
+ }
82
+
83
+ function listTypes({ kind, target }) {
52
84
  const normalizedKind = normalizeTypeKind({ kind });
53
85
  if (type.isNone(normalizedKind)) {
54
86
  throw new Error(
@@ -57,9 +89,14 @@ function listTypes({ kind }) {
57
89
  )}. Use one of: blocks, operators, actions, connections, requests, agents, notifications, websockets.`
58
90
  );
59
91
  }
92
+ if (!type.isNone(target) && !TARGETS.includes(target)) {
93
+ throw new Error(`Unknown target. Received ${JSON.stringify(target)}. Use "web" or "mobile".`);
94
+ }
60
95
  const availableTypes = readBuildArtifact({ name: 'plugins/availableTypes.json' }) ?? {};
96
+ const availableTypesMobile =
97
+ readBuildArtifact({ name: 'plugins/availableTypesMobile.json' }) ?? {};
61
98
  const types = readBuildArtifact({ name: 'types.json', deserialize: true }) ?? {};
62
- const blockMetas = readBuildArtifact({ name: 'plugins/blockMetas.json' }) ?? {};
99
+ const webBlockMetas = readBuildArtifact({ name: 'plugins/blockMetas.json' }) ?? {};
63
100
  const { entries, typeDocs } = getDocsIndex();
64
101
 
65
102
  const docSlugsByType = new Map();
@@ -86,23 +123,36 @@ function listTypes({ kind }) {
86
123
  used = usedTypeNames({ store: types[normalizedKind] });
87
124
  }
88
125
 
89
- const flattened = flattenKind({ kind: normalizedKind, availableTypes });
90
- return Object.entries(flattened)
126
+ const { definitions, fromShell } = availableForTarget({
127
+ kind: normalizedKind,
128
+ target,
129
+ availableTypes,
130
+ availableTypesMobile,
131
+ });
132
+ const blockMetas = fromShell ? availableTypesMobile.blockMetas ?? {} : webBlockMetas;
133
+ const webDefinitions = flattenKind({ kind: normalizedKind, availableTypes });
134
+ return Object.entries(definitions)
91
135
  .map(([typeName, definition]) => {
92
136
  const entry = {
93
137
  type: typeName,
94
138
  kind: normalizedKind,
95
139
  package: definition.package,
96
140
  version: definition.version,
97
- used: used.has(typeName),
98
141
  };
142
+ // types.json counts what web pages use, so it says nothing of a shell's types.
143
+ if (!fromShell) {
144
+ entry.used = used.has(typeName);
145
+ }
99
146
  if (definition.environments) {
100
147
  entry.environments = definition.environments;
101
148
  }
102
149
  if (normalizedKind === 'blocks' && blockMetas[typeName]?.category) {
103
150
  entry.category = blockMetas[typeName].category;
104
151
  }
105
- if (docSlugsByType.has(typeName)) {
152
+ // A shell type documented by its web page only when it is the same package's type: a
153
+ // native Button is not the web one.
154
+ const sameAsWeb = webDefinitions[typeName]?.package === definition.package;
155
+ if (docSlugsByType.has(typeName) && (!fromShell || sameAsWeb)) {
106
156
  entry.docSlug = docSlugsByType.get(typeName);
107
157
  }
108
158
  return entry;
@@ -14,6 +14,7 @@
14
14
  limitations under the License.
15
15
  */
16
16
  import loadFrameworkHazards from './loadFrameworkHazards.js';
17
+ import { expect, test } from 'vitest';
17
18
 
18
19
  test('loadFrameworkHazards loads the shipped hazards.json with well-formed unique entries', () => {
19
20
  const hazards = loadFrameworkHazards();
@@ -19,6 +19,7 @@ import matchExercisedPages from './matchExercisedPages.js';
19
19
  import matchJourneyRoute from './matchJourneyRoute.js';
20
20
  import mergeNetworkSnapshots from './mergeNetworkSnapshots.js';
21
21
  import nextJourneySequence from './nextJourneySequence.js';
22
+ import { expect, test } from 'vitest';
22
23
 
23
24
  const origin = 'http://localhost:3111';
24
25
 
@@ -14,9 +14,9 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
18
18
 
19
- jest.unstable_mockModule('./waitForClientErrorReports.js', () => ({ default: async () => {} }));
19
+ vi.doMock('./waitForClientErrorReports.js', () => ({ default: async () => {} }));
20
20
 
21
21
  const { default: createJourneyAppErrors } = await import('./createJourneyAppErrors.js');
22
22
  const { default: installStepObserver } = await import('./installStepObserver.js');
@@ -33,7 +33,7 @@ let emits;
33
33
 
34
34
  function createPage() {
35
35
  return {
36
- evaluate: jest.fn(async (fn) => {
36
+ evaluate: vi.fn(async (fn) => {
37
37
  if (fn === installStepObserver) return true;
38
38
  if (fn === readStepObserver) return { emits, mutationCount: 1 };
39
39
  return 'orders';
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import evaluateInvariants from './evaluateInvariants.js';
18
+ import { describe, expect, test } from 'vitest';
18
19
 
19
20
  const origin = 'http://localhost:3111';
20
21
 
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import hasNoEffect from './hasNoEffect.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  const url = 'http://localhost:3227/orders';
20
21
 
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import withAppErrors from './withAppErrors.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  const findings = [
20
21
  {
@@ -18,7 +18,7 @@ import fs from 'node:fs';
18
18
  import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
- import { jest } from '@jest/globals';
21
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
22
22
 
23
23
  import JourneyStepError from './JourneyStepError.js';
24
24
  import openJourneyEmail from './openJourneyEmail.js';
@@ -55,12 +55,12 @@ function writeMessage({ id, to, subject, secondsAfterStart = 1, html, text = nul
55
55
  function createPage({ onWait = () => {} } = {}) {
56
56
  const page = {
57
57
  opened: [],
58
- goto: jest.fn(async (url) => {
58
+ goto: vi.fn(async (url) => {
59
59
  const base64 = url.slice('data:text/html;charset=utf-8;base64,'.length);
60
60
  page.opened.push(Buffer.from(base64, 'base64').toString());
61
61
  }),
62
- evaluate: jest.fn(async () => {}),
63
- waitForTimeout: jest.fn(async () => onWait()),
62
+ evaluate: vi.fn(async () => {}),
63
+ waitForTimeout: vi.fn(async () => onWait()),
64
64
  };
65
65
  return page;
66
66
  }
@@ -96,8 +96,8 @@ test.each([
96
96
  `<a href="http://localhost/${expectedId}" target="_blank">Open ${expectedId}</a>`,
97
97
  ]);
98
98
  // Links open where the email is, since each actor drives one tab.
99
- const link = { removeAttribute: jest.fn() };
100
- global.document = { querySelectorAll: jest.fn(() => [link]) };
99
+ const link = { removeAttribute: vi.fn() };
100
+ global.document = { querySelectorAll: vi.fn(() => [link]) };
101
101
  await page.evaluate.mock.calls[0][0]();
102
102
  delete global.document;
103
103
  expect(link.removeAttribute).toHaveBeenCalledWith('target');
@@ -14,14 +14,14 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, beforeEach, expect, test } from 'vitest';
18
18
 
19
- const mockReviewPageBuilds = jest.fn();
20
- jest.unstable_mockModule('./reviewPageBuilds.js', () => ({
19
+ const mockReviewPageBuilds = vi.fn();
20
+ vi.doMock('./reviewPageBuilds.js', () => ({
21
21
  default: mockReviewPageBuilds,
22
22
  }));
23
- const mockBuildPageIfNeeded = jest.fn();
24
- jest.unstable_mockModule('../server/jitPageBuilder.js', () => ({
23
+ const mockBuildPageIfNeeded = vi.fn();
24
+ vi.doMock('../server/jitPageBuilder.js', () => ({
25
25
  default: mockBuildPageIfNeeded,
26
26
  }));
27
27
 
@@ -29,7 +29,7 @@ const { default: buildEditedPages, CONCURRENT_BUILDS } = await import('./buildEd
29
29
  const { default: getPageBuildStatus } = await import('./getPageBuildStatus.js');
30
30
 
31
31
  beforeEach(() => {
32
- jest.clearAllMocks();
32
+ vi.clearAllMocks();
33
33
  });
34
34
 
35
35
  test('buildEditedPages builds every edited page and returns their ids', async () => {
@@ -0,0 +1,100 @@
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 { randomUUID } from 'node:crypto';
18
+
19
+ import { registerTab, unregisterTab } from './tabChannel.js';
20
+
21
+ // A tab that cannot hold an event stream open - a phone shell whose fetch
22
+ // cannot stream a response body - polls /api/reload instead
23
+ // (src/routes/reload.js). It is registered in the tab channel like a streamed
24
+ // tab, but its events wait in a queue the next poll takes. A reload is read
25
+ // from build/reload, which reloadClients() rewrites after each build. A tab
26
+ // not polled for EXPIRY_MS is gone.
27
+ const EXPIRY_MS = 10000;
28
+
29
+ const polledTabs = new Map();
30
+ let sweepTimer = null;
31
+
32
+ function sweep(now) {
33
+ polledTabs.forEach((tab, id) => {
34
+ if (now - tab.lastPoll > EXPIRY_MS) {
35
+ polledTabs.delete(id);
36
+ unregisterTab({ id });
37
+ }
38
+ });
39
+ if (polledTabs.size === 0 && sweepTimer !== null) {
40
+ clearInterval(sweepTimer);
41
+ sweepTimer = null;
42
+ }
43
+ }
44
+
45
+ function startSweeping() {
46
+ if (sweepTimer !== null) {
47
+ return;
48
+ }
49
+ sweepTimer = setInterval(() => sweep(Date.now()), EXPIRY_MS);
50
+ sweepTimer.unref?.();
51
+ }
52
+
53
+ function openPolledTab({ origin, readReloadStamp, now }) {
54
+ const id = randomUUID();
55
+ const tab = { events: [], lastPoll: now, reloadStamp: readReloadStamp() };
56
+ polledTabs.set(id, tab);
57
+ registerTab({
58
+ id,
59
+ send: (event, data) => {
60
+ tab.events.push({ event, data: JSON.stringify(data) });
61
+ },
62
+ ...origin,
63
+ });
64
+ startSweeping();
65
+ tab.events.push({ event: 'tab', data: JSON.stringify({ tabId: id }) });
66
+ return id;
67
+ }
68
+
69
+ /**
70
+ * One poll of a polled tab: `{ tabId, events }`, the events sent to it since the last poll as an
71
+ * event stream carries them (`{ event, data }`, data a JSON string). An unknown or expired tabId
72
+ * opens a new tab, whose first event is `tab` with its id, as on a stream.
73
+ *
74
+ * @param {Object} params
75
+ * @param {string} [params.tabId] The tab's id from an earlier poll.
76
+ * @param {Object} params.origin `{ source, automated, device }` of the tab (routes/reload.js tabOrigin).
77
+ * @param {() => string|null} params.readReloadStamp The content of build/reload.
78
+ * @param {number} [params.now]
79
+ */
80
+ function pollTab({ tabId, origin, readReloadStamp, now = Date.now() }) {
81
+ sweep(now);
82
+ const id = polledTabs.has(tabId) ? tabId : openPolledTab({ origin, readReloadStamp, now });
83
+ const tab = polledTabs.get(id);
84
+ tab.lastPoll = now;
85
+ const stamp = readReloadStamp();
86
+ if (stamp !== null && stamp !== tab.reloadStamp) {
87
+ tab.reloadStamp = stamp;
88
+ tab.events.push({ event: 'reload', data: JSON.stringify({}) });
89
+ }
90
+ return { tabId: id, events: tab.events.splice(0) };
91
+ }
92
+
93
+ function closePolledTabs() {
94
+ polledTabs.forEach((tab, id) => unregisterTab({ id }));
95
+ polledTabs.clear();
96
+ sweep(Date.now());
97
+ }
98
+
99
+ export { closePolledTabs };
100
+ export default pollTab;
@@ -0,0 +1,64 @@
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 { afterEach, expect, test } from 'vitest';
18
+
19
+ const { default: pollTab, closePolledTabs } = await import('./pollTab.js');
20
+ const { findPageInstance, listTabs, requestFromTab, updateTabPage } = await import(
21
+ './tabChannel.js'
22
+ );
23
+
24
+ const origin = { source: 'dev', automated: false };
25
+
26
+ afterEach(() => {
27
+ closePolledTabs();
28
+ });
29
+
30
+ test('a first poll registers a tab and answers its id as a tab event', () => {
31
+ const { tabId, events } = pollTab({ origin, readReloadStamp: () => '1', now: 0 });
32
+ expect(events).toEqual([{ event: 'tab', data: JSON.stringify({ tabId }) }]);
33
+ expect(listTabs().map((tab) => tab.id)).toEqual([tabId]);
34
+ });
35
+
36
+ test('a poll takes the requests sent to the tab since the last poll', () => {
37
+ const { tabId } = pollTab({ origin, readReloadStamp: () => '1', now: 0 });
38
+ updateTabPage({ id: tabId, pageId: 'home', pathParams: {}, instanceKey: 'page:home' });
39
+ expect(findPageInstance({ pageId: 'home' }).tab.id).toBe(tabId);
40
+ requestFromTab({ pageId: 'home', event: 'inspect-request', timeout: 50 });
41
+ const { events } = pollTab({ tabId, origin, readReloadStamp: () => '1', now: 1000 });
42
+ expect(events).toHaveLength(1);
43
+ expect(events[0].event).toBe('inspect-request');
44
+ expect(JSON.parse(events[0].data)).toMatchObject({ pageId: 'home', instanceKey: 'page:home' });
45
+ expect(pollTab({ tabId, origin, readReloadStamp: () => '1', now: 2000 }).events).toEqual([]);
46
+ });
47
+
48
+ test('a poll after a build answers a reload event once', () => {
49
+ let stamp = '1';
50
+ const { tabId } = pollTab({ origin, readReloadStamp: () => stamp, now: 0 });
51
+ stamp = '2';
52
+ expect(pollTab({ tabId, origin, readReloadStamp: () => stamp, now: 1000 }).events).toEqual([
53
+ { event: 'reload', data: '{}' },
54
+ ]);
55
+ expect(pollTab({ tabId, origin, readReloadStamp: () => stamp, now: 2000 }).events).toEqual([]);
56
+ });
57
+
58
+ test('a tab not polled for 10 s is unregistered, and its next poll opens a new tab', () => {
59
+ const { tabId } = pollTab({ origin, readReloadStamp: () => null, now: 0 });
60
+ const next = pollTab({ tabId, origin, readReloadStamp: () => null, now: 20000 });
61
+ expect(next.tabId).not.toBe(tabId);
62
+ expect(next.events[0].event).toBe('tab');
63
+ expect(listTabs().map((tab) => tab.id)).toEqual([next.tabId]);
64
+ });
@@ -17,6 +17,7 @@
17
17
  import actionsCoreTypes from '@lowdefy/actions-core/types';
18
18
 
19
19
  import authEngineActions from './authEngineActions.js';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  // Every actions-core action that does not call the auth engine. A new action
22
23
  // type fails the test below until it is added here or to authEngineActions.
@@ -18,6 +18,7 @@ import fs from 'node:fs';
18
18
 
19
19
  import authEngineActions from './authEngineActions.js';
20
20
  import authEngineMethods from './authEngineMethods.js';
21
+ import { expect, test } from 'vitest';
21
22
 
22
23
  test('authEngineMethods maps client auth methods to exactly the authEngineActions types', () => {
23
24
  expect(new Set(Object.values(authEngineMethods))).toEqual(authEngineActions);
@@ -26,7 +27,7 @@ test('authEngineMethods maps client auth methods to exactly the authEngineAction
26
27
 
27
28
  test('every method of authEngineMethods is a method the client creates', () => {
28
29
  const source = fs.readFileSync(
29
- new URL('../../../../../client/src/auth/createAuthMethods.js', import.meta.url),
30
+ new URL('../../../../../client-core/src/auth/createAuthMethods.js', import.meta.url),
30
31
  'utf8'
31
32
  );
32
33
  const exported = source.slice(source.lastIndexOf(' return {'));
@@ -14,7 +14,7 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, expect, test } from 'vitest';
18
18
 
19
19
  import checkAuthActionsRan, { armAuthActionRecorder } from './checkAuthActionsRan.js';
20
20
  import authEngineMethods from './authEngineMethods.js';
@@ -46,10 +46,10 @@ async function callAuth(window, method, ...args) {
46
46
  function createWindow() {
47
47
  const store = new Map();
48
48
  const auth = {
49
- login: jest.fn(async () => 'logged in'),
50
- setActiveOrganization: jest.fn(async () => 'switched'),
51
- updateSession: jest.fn(async () => 'synced'),
52
- notAuthEngine: jest.fn(),
49
+ login: vi.fn(async () => 'logged in'),
50
+ setActiveOrganization: vi.fn(async () => 'switched'),
51
+ updateSession: vi.fn(async () => 'synced'),
52
+ notAuthEngine: vi.fn(),
53
53
  };
54
54
  return {
55
55
  auth,