@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -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';
@@ -56,10 +56,11 @@ function createContext() {
56
56
  failure: () => ({ errorText: 'net::ERR_ABORTED' }),
57
57
  });
58
58
  },
59
- respond({ url, status }) {
59
+ respond({ url, status, headers = {} }) {
60
60
  listeners.response({
61
61
  url: () => url,
62
62
  status: () => status,
63
+ headers: () => headers,
63
64
  request: () => ({ method: () => 'POST' }),
64
65
  });
65
66
  },
@@ -138,6 +139,19 @@ test('an unexplained 5xx from an app API route fails the step as request-failed'
138
139
  expect(findings.map((finding) => finding.kind)).toEqual(['request-failed']);
139
140
  });
140
141
 
142
+ test('a 502 the proxy answered itself fails the step as dev-server, not request-failed', async () => {
143
+ const findings = await runStepWindow({
144
+ step: { click: 'save' },
145
+ during: () =>
146
+ context.respond({
147
+ url: `${origin}/api/request/orders/save`,
148
+ status: 502,
149
+ headers: { 'x-lowdefy-child': 'dropped' },
150
+ }),
151
+ });
152
+ expect(findings.map((finding) => finding.kind)).toEqual(['dev-server']);
153
+ });
154
+
141
155
  test.each([
142
156
  ['AuthorizationError', 403],
143
157
  ['AuthenticationError', 401],
@@ -28,6 +28,7 @@ const SEVERITY = {
28
28
  'client-error': 'error',
29
29
  'server-error': 'error',
30
30
  'request-failed': 'error',
31
+ 'dev-server': 'error',
31
32
  'dead-click': 'warning',
32
33
  environment: 'info',
33
34
  };
@@ -64,6 +65,9 @@ function isDeadClick({ step, result, window }) {
64
65
  // server-error a server error entry this run caused
65
66
  // request-failed a 5xx from the app's request or endpoint routes that no
66
67
  // server error entry in the window explains
68
+ // dev-server the dev server's proxy answered for a child it could not
69
+ // reach: the request may not have run, and the app is not
70
+ // at fault
67
71
  // dead-click a click that succeeded and changed nothing: no event, no
68
72
  // lasting DOM change, no app request, no URL change
69
73
  // environment a server error from a request using a $search or
@@ -147,8 +151,23 @@ async function evaluateInvariants({
147
151
  source: entry.source,
148
152
  });
149
153
  });
154
+ window.responses
155
+ .filter((response) => !type.isNone(response.childState))
156
+ .forEach((response) => {
157
+ add({
158
+ kind: 'dev-server',
159
+ message: `${response.method} ${
160
+ new URL(response.url).pathname
161
+ } got no answer from the app: the dev server's connection to its web server failed (${
162
+ response.status
163
+ }, ${
164
+ response.childState
165
+ }). This is not an app error. Check the dev server log for a restart or crash, then run the journey again.`,
166
+ });
167
+ });
150
168
  window.responses
151
169
  .filter((response) => response.status >= 500)
170
+ .filter((response) => type.isNone(response.childState))
152
171
  .filter((response) => !isExplained({ response, serverEntries, basePath }))
153
172
  .forEach((response) => {
154
173
  add({
@@ -170,6 +189,10 @@ async function evaluateInvariants({
170
189
  if (findings.some((finding) => finding.kind === 'environment')) {
171
190
  findings = findings.filter((finding) => finding.kind === 'environment');
172
191
  }
192
+ // The page's own errors about a request that got no answer are only its echo.
193
+ if (findings.some((finding) => finding.kind === 'dev-server')) {
194
+ findings = findings.filter((finding) => finding.kind === 'dev-server');
195
+ }
173
196
  const seen = new Set();
174
197
  return findings
175
198
  .map((finding) => ({ ...finding, key: findingKey(finding) }))
@@ -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
 
@@ -169,6 +170,32 @@ test('a server error entry is a server-error, or environment when its request us
169
170
  ).toEqual([['environment', 'info']]);
170
171
  });
171
172
 
173
+ test('an answer from the proxy is a dev-server finding, and drops the errors that echo it', async () => {
174
+ const response = {
175
+ url: `${origin}/api/request/tickets/get_ticket`,
176
+ method: 'POST',
177
+ status: 502,
178
+ childState: 'dropped',
179
+ };
180
+ const findings = await evaluate({
181
+ window: quietWindow({
182
+ requests: [response],
183
+ responses: [response],
184
+ emits: [failedEmit('RequestError')],
185
+ errors: [{ store: 'client', message: 'Lowdefy dev server connection dropped.' }],
186
+ }),
187
+ });
188
+ expect(findings).toEqual([
189
+ expect.objectContaining({
190
+ kind: 'dev-server',
191
+ severity: 'error',
192
+ message: expect.stringContaining(
193
+ 'POST /api/request/tickets/get_ticket got no answer from the app'
194
+ ),
195
+ }),
196
+ ]);
197
+ });
198
+
172
199
  test('a 5xx from an app route is request-failed unless a server error entry for that request explains it', async () => {
173
200
  const response = {
174
201
  url: `${origin}/api/endpoints/assign_ticket`,
@@ -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
 
@@ -29,7 +29,8 @@ function describeWhere({ phase, index, step }) {
29
29
  // error with its kind, message, config source and finding key.
30
30
  // When the step also failed on its own, the app error leads the message, since
31
31
  // it is usually the cause, and the step's own message follows (and is kept
32
- // apart as stepMessage).
32
+ // apart as stepMessage). A dev-server finding makes it a dev server failure,
33
+ // not an app error: the journey says nothing about the app.
33
34
  function toAppErrorFailure({ findings, phase, index, step, stepFailure }) {
34
35
  const errors = findings.map(({ kind, message, source, configKey, key }) => ({
35
36
  kind,
@@ -39,12 +40,14 @@ function toAppErrorFailure({ findings, phase, index, step, stepFailure }) {
39
40
  key,
40
41
  }));
41
42
  const actual = errors.map((error) => `${error.kind}: ${error.message}`);
43
+ const lostDevServer = errors.some((error) => error.kind === 'dev-server');
42
44
  const count = errors.length === 1 ? 'an app error' : `${errors.length} app errors`;
43
- const message = `${describeWhere({ phase, index, step })} caused ${count}: ${actual.join('; ')}`;
45
+ const outcome = lostDevServer ? 'lost the dev server' : `caused ${count}`;
46
+ const message = `${describeWhere({ phase, index, step })} ${outcome}: ${actual.join('; ')}`;
44
47
  const failure = {
45
- kind: 'app-error',
48
+ kind: lostDevServer ? 'dev-server' : 'app-error',
46
49
  message,
47
- expected: 'no app error',
50
+ expected: lostDevServer ? 'the dev server to answer' : 'no app error',
48
51
  actual,
49
52
  errors,
50
53
  };
@@ -68,6 +68,7 @@ function watchJourneyContext({ context, events, origin, basePath }) {
68
68
  url: response.url(),
69
69
  method: response.request().method(),
70
70
  status: response.status(),
71
+ childState: response.headers()['x-lowdefy-child'] ?? null,
71
72
  });
72
73
  });
73
74
  }
@@ -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
  {
@@ -65,6 +66,27 @@ test('withAppErrors fails a step that passed with the app errors its window held
65
66
  });
66
67
  });
67
68
 
69
+ test('withAppErrors reports a dev-server finding as a dev server failure, not an app error', () => {
70
+ const failure = withAppErrors({
71
+ findings: [
72
+ {
73
+ kind: 'dev-server',
74
+ message: 'POST /api/request/home/get_user got no answer from the app.',
75
+ },
76
+ ],
77
+ index: 2,
78
+ step: { goto: 'home' },
79
+ });
80
+ expect(failure).toEqual(
81
+ expect.objectContaining({
82
+ kind: 'dev-server',
83
+ expected: 'the dev server to answer',
84
+ message:
85
+ 'Step 2 (goto) lost the dev server: dev-server: POST /api/request/home/get_user got no answer from the app.',
86
+ })
87
+ );
88
+ });
89
+
68
90
  test('withAppErrors leads with the app error when the step also failed on its own', () => {
69
91
  const failure = withAppErrors({
70
92
  failure: { index: 0, step: { click: 'save' }, message: 'Expected text "Saved".' },
@@ -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,