@lowdefy/server-dev 7.1.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 (432) 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 +87 -135
  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.test.mjs +1 -0
  106. package/lib/docs/isPageReady.test.mjs +1 -0
  107. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  108. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  109. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  110. package/lib/docs/launchBrowser.test.mjs +8 -8
  111. package/lib/docs/listTypes.js +58 -8
  112. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  113. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  114. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  115. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  116. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  117. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  118. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  119. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  120. package/lib/docs/pollTab.js +100 -0
  121. package/lib/docs/pollTab.test.mjs +64 -0
  122. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  123. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  124. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  125. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  126. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  127. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  128. package/lib/docs/readJourneySession.js +1 -1
  129. package/lib/docs/reportDevToolFault.js +29 -0
  130. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  131. package/lib/docs/requestRestart.test.mjs +1 -0
  132. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  133. package/lib/docs/resolveSource.js +2 -2
  134. package/lib/docs/resolveSource.test.mjs +6 -6
  135. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  136. package/lib/docs/runCheck.test.mjs +3 -3
  137. package/lib/docs/runCheckChild.js +2 -1
  138. package/lib/docs/runEndpoint.js +23 -10
  139. package/lib/docs/runEndpoint.test.mjs +42 -37
  140. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  141. package/lib/docs/runJourney.js +21 -1
  142. package/lib/docs/runJourney.test.mjs +119 -99
  143. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  144. package/lib/docs/runJourneySteps.js +8 -29
  145. package/lib/docs/runRequest.js +6 -6
  146. package/lib/docs/runRequest.test.mjs +22 -22
  147. package/lib/docs/screenshotPage.js +6 -7
  148. package/lib/docs/screenshotPage.test.mjs +46 -46
  149. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  150. package/lib/docs/searchDocs.test.mjs +1 -0
  151. package/lib/docs/searchIcons.test.mjs +5 -5
  152. package/lib/docs/selectFinalState.test.mjs +1 -0
  153. package/lib/docs/serverErrorStore.test.mjs +4 -4
  154. package/lib/docs/setupTestFixtures.mjs +25 -0
  155. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  156. package/lib/docs/tabAvailable.js +1 -1
  157. package/lib/docs/tabChannel.js +90 -14
  158. package/lib/docs/tabChannel.test.mjs +40 -15
  159. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  160. package/lib/docs/validateStateSelection.test.mjs +1 -0
  161. package/lib/docs/validateViewport.test.mjs +1 -0
  162. package/lib/docs/waitForBuild.test.mjs +1 -0
  163. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  164. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  165. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  166. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  167. package/lib/server/auth/getHeadlessUser.js +6 -0
  168. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  169. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  170. package/lib/server/contextMapBudget.test.mjs +3 -3
  171. package/lib/server/continueJitKeys.test.mjs +1 -0
  172. package/lib/server/createLowdefyContext.js +5 -1
  173. package/lib/server/createLowdefyContext.test.mjs +32 -32
  174. package/lib/server/getClientAddress.test.mjs +2 -2
  175. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  176. package/lib/server/importAppCode.test.mjs +2 -2
  177. package/lib/server/jitPageBuilder.js +27 -3
  178. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  179. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  180. package/lib/server/jitPageBuilder.test.mjs +4 -4
  181. package/lib/server/journeyCookies.test.mjs +1 -0
  182. package/lib/server/loadDynamicJsMap.js +10 -1
  183. package/lib/server/log/createHandleError.js +10 -5
  184. package/lib/server/log/createHandleError.test.mjs +19 -8
  185. package/lib/server/log/createLogger.test.mjs +2 -2
  186. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  187. package/lib/server/mutants/listMutants.test.mjs +1 -0
  188. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  189. package/lib/server/mutants/operators.test.mjs +1 -0
  190. package/lib/server/pageBuildRecords.test.mjs +1 -0
  191. package/lib/server/pageCache.test.mjs +1 -0
  192. package/lib/server/pageRebuilds.test.mjs +3 -3
  193. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  194. package/lib/server/pruneJitMaps.test.mjs +1 -0
  195. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  196. package/lib/server/readInstanceRecord.test.mjs +24 -8
  197. package/lib/server/readMergedMaps.test.mjs +1 -0
  198. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  199. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  200. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  201. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  202. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  203. package/lib/server/startIdleGc.test.mjs +25 -9
  204. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  205. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  206. package/manager/getContext.mjs +9 -0
  207. package/manager/processes/checkPendingPlugins.mjs +49 -0
  208. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  209. package/manager/processes/createIdleChild.mjs +141 -0
  210. package/manager/processes/createIdleChild.test.mjs +209 -0
  211. package/manager/processes/initialBuild.mjs +2 -15
  212. package/manager/processes/initialBuild.test.mjs +8 -40
  213. package/manager/processes/lowdefyBuild.mjs +7 -4
  214. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  215. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  216. package/manager/processes/restartServer.test.mjs +63 -15
  217. package/manager/processes/shutdownServer.test.mjs +3 -3
  218. package/manager/processes/startFirstServer.test.mjs +23 -22
  219. package/manager/processes/startMailSink.mjs +11 -3
  220. package/manager/processes/startMailSink.test.mjs +28 -2
  221. package/manager/processes/startProxy.mjs +158 -27
  222. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  223. package/manager/processes/startProxy.test.mjs +127 -2
  224. package/manager/processes/startServer.mjs +5 -7
  225. package/manager/processes/startServer.test.mjs +10 -9
  226. package/manager/processes/syncServer.mjs +31 -4
  227. package/manager/processes/syncServer.test.mjs +71 -6
  228. package/manager/processes/waitForDevServer.test.mjs +21 -6
  229. package/manager/run.mjs +32 -8
  230. package/manager/utils/BatchChanges.mjs +1 -1
  231. package/manager/utils/BatchChanges.test.mjs +4 -4
  232. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  233. package/manager/utils/checkPairing.mjs +45 -0
  234. package/manager/utils/checkPairing.test.mjs +53 -0
  235. package/manager/utils/createBuildActivity.mjs +5 -1
  236. package/manager/utils/createBuildActivity.test.mjs +2 -2
  237. package/manager/utils/createChangeSignal.test.mjs +5 -5
  238. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  239. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  240. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  241. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  242. package/manager/utils/createGlobIgnore.mjs +45 -0
  243. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  244. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  245. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  246. package/manager/utils/createIdleGc.test.mjs +31 -15
  247. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  248. package/manager/utils/createLanPairing.test.mjs +46 -0
  249. package/manager/utils/createRequestActivity.mjs +30 -3
  250. package/manager/utils/createRequestActivity.test.mjs +76 -22
  251. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  252. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  253. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  254. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  255. package/manager/utils/findSignInCode.test.mjs +33 -0
  256. package/manager/utils/formatLanPairing.mjs +32 -0
  257. package/manager/utils/formatLanPairing.test.mjs +40 -0
  258. package/manager/utils/getLanAddress.mjs +83 -0
  259. package/manager/utils/getLanAddress.test.mjs +70 -0
  260. package/manager/utils/importFresh.test.mjs +1 -0
  261. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  262. package/manager/utils/pluginTypeCache.mjs +100 -0
  263. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  264. package/manager/utils/pruneRecordings.test.mjs +1 -0
  265. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  266. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  267. package/manager/utils/readBasePath.test.mjs +1 -0
  268. package/manager/utils/readManagerVersion.test.mjs +1 -0
  269. package/manager/utils/readPluginDefinitions.mjs +6 -6
  270. package/manager/utils/renderTerminalQr.mjs +54 -0
  271. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  272. package/manager/utils/setupWatcher.mjs +19 -4
  273. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  274. package/manager/utils/waitForChildExit.test.mjs +2 -2
  275. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  276. package/manager/watchers/envWatcher.mjs +3 -0
  277. package/manager/watchers/envWatcher.test.mjs +19 -7
  278. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  279. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  280. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  281. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  282. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  283. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  284. package/manager/watchers/resolveFile.mjs +46 -0
  285. package/manager/watchers/resolveFile.test.mjs +67 -0
  286. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  287. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  288. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  289. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  290. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  291. package/package.json +50 -49
  292. package/package.original.json +50 -49
  293. package/src/app.js +83 -85
  294. package/src/html/renderDevPage.test.mjs +1 -0
  295. package/src/lib/getPathSegments.js +16 -1
  296. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  297. package/src/lib/isTabAnswer.js +32 -0
  298. package/src/lib/isTabChannelCaller.js +35 -0
  299. package/src/middleware/apiContext.js +4 -2
  300. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  301. package/src/middleware/errorHandler.js +33 -45
  302. package/src/middleware/errorHandler.test.mjs +10 -10
  303. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  304. package/src/middleware/localDevToolsOnly.js +13 -1
  305. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  306. package/src/middleware/noStore.test.mjs +1 -0
  307. package/src/middleware/staleFlag.test.mjs +1 -0
  308. package/src/middleware/stampCaller.test.mjs +1 -0
  309. package/src/routes/agentBearer.test.mjs +183 -0
  310. package/src/routes/auth.test.mjs +10 -10
  311. package/src/routes/clientError.js +21 -4
  312. package/src/routes/clientError.test.mjs +127 -0
  313. package/src/routes/devInspect.js +6 -51
  314. package/src/routes/devInspect.test.mjs +128 -3
  315. package/src/routes/devRecording.js +6 -17
  316. package/src/routes/devRecording.test.mjs +54 -3
  317. package/src/routes/docs/buildStatus.test.mjs +6 -6
  318. package/src/routes/docs/events.test.mjs +4 -4
  319. package/src/routes/docs/find.js +3 -3
  320. package/src/routes/docs/journey.test.mjs +8 -8
  321. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  322. package/src/routes/docs/loadDocsRoutes.js +70 -0
  323. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  324. package/src/routes/docs/mcp.test.mjs +5 -5
  325. package/src/routes/docs/mutants.js +7 -0
  326. package/src/routes/docs/mutants.test.mjs +20 -6
  327. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  328. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  329. package/src/routes/docs/restart.test.mjs +1 -0
  330. package/src/routes/endpoints.js +24 -0
  331. package/src/routes/endpointsLink.test.mjs +111 -0
  332. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  333. package/src/routes/jitPage.js +13 -1
  334. package/src/routes/jitPage.test.mjs +36 -11
  335. package/src/routes/mcp.js +6 -0
  336. package/src/routes/mcp.test.mjs +23 -8
  337. package/src/routes/mcpMemberToken.test.mjs +8 -8
  338. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  339. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  340. package/src/routes/mobileRoutes.test.mjs +223 -0
  341. package/src/routes/mobileSignIn.js +58 -0
  342. package/src/routes/mobileSignIn.test.mjs +59 -0
  343. package/src/routes/mobileSignInCallback.js +34 -0
  344. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  345. package/src/routes/mountDevPageRoutes.js +10 -2
  346. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  347. package/src/routes/mountMobileWellKnown.js +35 -0
  348. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  349. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  350. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  351. package/src/routes/reload.js +101 -20
  352. package/src/routes/reload.test.mjs +153 -0
  353. package/src/routes/request.js +1 -22
  354. package/src/routes/request.test.mjs +7 -24
  355. package/src/routes/requestBody.test.mjs +14 -27
  356. package/src/routes/websocket.test.mjs +2 -2
  357. package/src/routes/wellKnownFallback.test.mjs +2 -2
  358. package/src/websocket/devWebSocket.test.mjs +12 -12
  359. package/vite.config.js +13 -1
  360. package/client/feedback/FeedbackMount.jsx +0 -83
  361. package/client/feedback/FeedbackOverlay.jsx +0 -904
  362. package/client/feedback/captureTabScreenshot.js +0 -84
  363. package/client/feedback/copyToClipboard.js +0 -45
  364. package/client/feedback/drawAnnotationsSvg.js +0 -119
  365. package/client/feedback/feedbackStyles.js +0 -304
  366. package/client/feedback/pinResponsiveImages.js +0 -59
  367. package/client/feedback/sendFeedback.js +0 -39
  368. package/client/feedback/useFeedbackToggle.js +0 -70
  369. package/client/recorder/buildEngineRecord.js +0 -37
  370. package/client/recorder/buildInteractionRecord.js +0 -64
  371. package/client/recorder/buildTraceEvent.js +0 -57
  372. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  373. package/client/recorder/chunkRecords.js +0 -69
  374. package/client/recorder/chunkRecords.test.mjs +0 -59
  375. package/client/recorder/collectEventEndpoints.js +0 -40
  376. package/client/recorder/collectEventRequests.js +0 -39
  377. package/client/recorder/createPairingBuffer.js +0 -187
  378. package/client/recorder/createPasswordRedactor.js +0 -84
  379. package/client/recorder/createRecordBatcher.js +0 -54
  380. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  381. package/client/recorder/createRecordingSession.js +0 -61
  382. package/client/recorder/createRecordingSession.test.mjs +0 -72
  383. package/client/recorder/diffStateWrites.js +0 -77
  384. package/client/recorder/diffStateWrites.test.mjs +0 -66
  385. package/client/recorder/isEventCall.js +0 -30
  386. package/client/recorder/jsonType.js +0 -39
  387. package/client/recorder/sendRecords.js +0 -40
  388. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  389. package/lib/docs/checkpointPaths.js +0 -91
  390. package/lib/docs/checkpointStore.js +0 -243
  391. package/lib/docs/checkpointToMocks.js +0 -65
  392. package/lib/docs/configCheckpoints.test.mjs +0 -156
  393. package/lib/docs/createConfigCheckpoint.js +0 -92
  394. package/lib/docs/devMockRegistry.js +0 -68
  395. package/lib/docs/enrichFeedback.js +0 -71
  396. package/lib/docs/evalOperator.js +0 -49
  397. package/lib/docs/evalOperator.test.mjs +0 -157
  398. package/lib/docs/evalOperatorHeadless.js +0 -159
  399. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  400. package/lib/docs/evalOperatorInTab.js +0 -49
  401. package/lib/docs/formatFeedback.js +0 -142
  402. package/lib/docs/formatFeedback.test.mjs +0 -252
  403. package/lib/docs/getPluginDoc.js +0 -53
  404. package/lib/docs/listConfigCheckpoints.js +0 -55
  405. package/lib/docs/loadState.js +0 -220
  406. package/lib/docs/revertConfigCheckpoint.js +0 -73
  407. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  408. package/lib/docs/scaffoldPage.js +0 -77
  409. package/lib/docs/scaffoldPage.test.mjs +0 -97
  410. package/lib/docs/snapshotState.js +0 -67
  411. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  412. package/manager/watchers/listServerSidePackages.mjs +0 -47
  413. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  414. package/src/routes/docs/checkpointsCreate.js +0 -28
  415. package/src/routes/docs/evalOperator.js +0 -70
  416. package/src/routes/docs/inspectState.js +0 -59
  417. package/src/routes/docs/loadState.js +0 -51
  418. package/src/routes/docs/pluginDoc.js +0 -33
  419. package/src/routes/docs/plugins.js +0 -23
  420. package/src/routes/docs/runEndpoint.js +0 -54
  421. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  422. package/src/routes/docs/runRequest.js +0 -53
  423. package/src/routes/docs/runRequest.test.mjs +0 -92
  424. package/src/routes/docs/schema.js +0 -37
  425. package/src/routes/docs/screenshot.js +0 -120
  426. package/src/routes/docs/screenshot.test.mjs +0 -117
  427. package/src/routes/docs/search.js +0 -40
  428. package/src/routes/docs/snapshotState.js +0 -50
  429. package/src/routes/docs/stateCheckpointsList.js +0 -26
  430. package/src/routes/docs/types.js +0 -33
  431. package/src/routes/feedback.js +0 -107
  432. package/src/routes/feedback.test.mjs +0 -204
@@ -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,
@@ -19,6 +19,7 @@ import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
21
  import createDataSetRails from './createDataSetRails.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let buildDirectory;
24
25
 
@@ -19,6 +19,7 @@ import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
21
  import findExternalBlocks from './findExternalBlocks.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let buildDirectory;
24
25
 
@@ -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 readJourneyEmailMatch from './readJourneyEmailMatch.js';
@@ -53,7 +53,7 @@ function writeMessage({ id, subject, html = null, text = null }) {
53
53
  );
54
54
  }
55
55
 
56
- const page = { waitForTimeout: jest.fn(async () => {}) };
56
+ const page = { waitForTimeout: vi.fn(async () => {}) };
57
57
 
58
58
  function read(params) {
59
59
  return readJourneyEmailMatch({
@@ -22,7 +22,7 @@ import {
22
22
  } from '@lowdefy/node-utils';
23
23
  import { type } from '@lowdefy/helpers';
24
24
 
25
- import { getConfigDirectory } from './checkpointPaths.js';
25
+ import getConfigDirectory from './getConfigDirectory.js';
26
26
  import readBuildArtifact from './readBuildArtifact.js';
27
27
 
28
28
  function describeEmpty() {
@@ -0,0 +1,29 @@
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
+ // A dev tool that throws something other than the outcome it reports (a failed
18
+ // step, an app error) has a bug of its own or lost its browser. Returned as a
19
+ // bare message, that looked to an agent like a failure of its app, and nothing
20
+ // was logged. It is logged here with its stack, and the text an agent gets says
21
+ // whose fault it is and where the stack is.
22
+ function reportDevToolFault({ error, logger, tool }) {
23
+ logger.error({ err: error, event: 'dev_tool_fault', tool }, `The ${tool} dev tool failed.`);
24
+ return `${error?.name ?? 'Error'}: ${
25
+ error?.message
26
+ } (a fault in the dev server's ${tool} tool, not in the app; the dev server terminal has the stack)`;
27
+ }
28
+
29
+ export default reportDevToolFault;
@@ -0,0 +1,34 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { expect, test, vi } from 'vitest';
18
+
19
+ import reportDevToolFault from './reportDevToolFault.js';
20
+
21
+ test('reportDevToolFault logs the error with its stack and names the tool as at fault', () => {
22
+ const logger = { error: vi.fn() };
23
+ const error = new TypeError("Cannot read properties of undefined (reading 'page')");
24
+
25
+ const text = reportDevToolFault({ error, logger, tool: 'lowdefy_run_journey' });
26
+
27
+ expect(logger.error).toHaveBeenCalledWith(
28
+ { err: error, event: 'dev_tool_fault', tool: 'lowdefy_run_journey' },
29
+ 'The lowdefy_run_journey dev tool failed.'
30
+ );
31
+ expect(text).toBe(
32
+ "TypeError: Cannot read properties of undefined (reading 'page') (a fault in the dev server's lowdefy_run_journey tool, not in the app; the dev server terminal has the stack)"
33
+ );
34
+ });
@@ -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, expect, test } from 'vitest';
20
21
 
21
22
  const originalCwd = process.cwd();
22
23
  const fixtureDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-request-restart-test-'));
@@ -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, expect, test } from 'vitest';
20
21
 
21
22
  // readPagePath reads build/routes.json from process.cwd(): chdir into a fixture
22
23
  // that has one before the module loads.
@@ -18,8 +18,8 @@ import { type } from '@lowdefy/helpers';
18
18
 
19
19
  import tabAvailable from './tabAvailable.js';
20
20
 
21
- // The single tab-vs-headless decision, shared by inspectState and evalOperator
22
- // so a change to the rule lands in both. Prefers a real, already-open browser
21
+ // The tab-vs-headless decision for inspectState, for a snapshot and for an
22
+ // expression alike. Prefers a real, already-open browser
23
23
  // tab over a fresh headless one — a live tab reflects whatever a developer is
24
24
  // actually looking at (their own interactions, in-flight requests), while
25
25
  // headless always starts a clean navigation.
@@ -14,18 +14,18 @@
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 mockTabAvailable = jest.fn();
19
+ const mockTabAvailable = vi.fn();
20
20
 
21
- jest.unstable_mockModule('./tabAvailable.js', () => ({
21
+ vi.doMock('./tabAvailable.js', () => ({
22
22
  default: mockTabAvailable,
23
23
  }));
24
24
 
25
25
  const { default: resolveSource } = await import('./resolveSource.js');
26
26
 
27
27
  beforeEach(() => {
28
- jest.clearAllMocks();
28
+ vi.clearAllMocks();
29
29
  });
30
30
 
31
31
  test('resolveSource tries the tab when source is "tab"', () => {
@@ -80,13 +80,13 @@ test('resolveSource marks a user combined with source "tab" as invalid input', (
80
80
 
81
81
  test('resolveSource names the calling function in the invalid-input error', () => {
82
82
  const result = resolveSource({
83
- name: 'evalOperator',
83
+ name: 'screenshotPage',
84
84
  pageId: 'home',
85
85
  source: 'tab',
86
86
  user: { roles: ['admin'] },
87
87
  });
88
88
 
89
- expect(result.error).toMatch(/^evalOperator cannot apply "user"/);
89
+ expect(result.error).toMatch(/^screenshotPage cannot apply "user"/);
90
90
  });
91
91
 
92
92
  test('resolveSource treats a null user as no user', () => {
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import fs from 'node:fs';
18
- import { jest } from '@jest/globals';
18
+ import { vi, beforeEach, expect, test } from 'vitest';
19
19
  import os from 'node:os';
20
20
  import path from 'node:path';
21
21
 
@@ -33,7 +33,7 @@ const { default: buildEditedPages } = await import('./buildEditedPages.js');
33
33
  const { default: reviewPageBuilds } = await import('./reviewPageBuilds.js');
34
34
 
35
35
  // A JIT page build loads the build package's plugins on first use.
36
- jest.setTimeout(30000);
36
+ vi.setConfig({ testTimeout: 30000, hookTimeout: 30000 });
37
37
 
38
38
  const longAgo = new Date('2000-01-01T00:00:00.000Z');
39
39
  let lastSignal = 0;