@lowdefy/server-dev 7.0.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/checkSharedCollectionIds.js +20 -9
  44. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
  45. package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
  46. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  47. package/lib/docs/dataSets/getDataStore.js +11 -3
  48. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  49. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  50. package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
  51. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  52. package/lib/docs/dataSets/openDataSession.js +36 -20
  53. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
  54. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  55. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  56. package/lib/docs/dataSets/readDataSet.js +34 -19
  57. package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
  58. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  59. package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
  60. package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
  61. package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
  62. package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
  63. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  64. package/lib/docs/devEventBus.js +7 -2
  65. package/lib/docs/devEventBus.test.mjs +12 -10
  66. package/lib/docs/devToolDefinitions.js +87 -135
  67. package/lib/docs/device/buildDeviceCommand.js +103 -0
  68. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  69. package/lib/docs/device/captureDevice.js +85 -0
  70. package/lib/docs/device/checkShownPage.js +56 -0
  71. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  72. package/lib/docs/device/deviceAction.js +74 -0
  73. package/lib/docs/device/deviceTools.test.mjs +604 -0
  74. package/lib/docs/device/findDeviceTab.js +50 -0
  75. package/lib/docs/device/findDeviceTarget.js +73 -0
  76. package/lib/docs/device/injectDevice.js +160 -0
  77. package/lib/docs/device/listDevices.js +100 -0
  78. package/lib/docs/device/listDevices.test.mjs +105 -0
  79. package/lib/docs/device/runDeviceJourney.js +68 -0
  80. package/lib/docs/device/runDeviceSteps.js +164 -0
  81. package/lib/docs/device/screenshotDevice.js +68 -0
  82. package/lib/docs/device/sendDeviceStep.js +52 -0
  83. package/lib/docs/device/startDevice.js +150 -0
  84. package/lib/docs/docs.test.mjs +44 -28
  85. package/lib/docs/docsIndex.test.mjs +1 -0
  86. package/lib/docs/findConfig.js +3 -4
  87. package/lib/docs/findPageBlock.js +35 -0
  88. package/lib/docs/findPageBlock.test.mjs +45 -0
  89. package/lib/docs/fitResponse.js +18 -17
  90. package/lib/docs/fitResponse.test.mjs +18 -0
  91. package/lib/docs/getBrowser.js +4 -4
  92. package/lib/docs/getBrowser.test.mjs +32 -16
  93. package/lib/docs/getBuildId.test.mjs +1 -0
  94. package/lib/docs/getBuildStatus.js +29 -3
  95. package/lib/docs/getBuildStatus.test.mjs +108 -12
  96. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  97. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  98. package/lib/docs/getHazards.js +4 -1
  99. package/lib/docs/getHazards.test.mjs +9 -7
  100. package/lib/docs/getOverview.js +22 -44
  101. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  102. package/lib/docs/getStaleStatus.test.mjs +1 -0
  103. package/lib/docs/inspectState.js +78 -3
  104. package/lib/docs/inspectState.test.mjs +61 -9
  105. package/lib/docs/inspectStateFromTab.js +38 -6
  106. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  107. package/lib/docs/inspectStateHeadless.js +98 -34
  108. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  109. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  110. package/lib/docs/installHeadlessShell.js +5 -2
  111. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  112. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  113. package/lib/docs/isDeepEqual.js +37 -0
  114. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  115. package/lib/docs/isPageReady.test.mjs +1 -0
  116. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  117. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  118. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  119. package/lib/docs/launchBrowser.test.mjs +8 -8
  120. package/lib/docs/listTypes.js +58 -8
  121. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  122. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  123. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  124. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  125. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  126. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  127. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  128. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  129. package/lib/docs/pollTab.js +100 -0
  130. package/lib/docs/pollTab.test.mjs +64 -0
  131. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  132. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  133. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  134. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  135. package/lib/docs/rails/findExternalBlocks.js +3 -3
  136. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  137. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  138. package/lib/docs/readJourneySession.js +1 -1
  139. package/lib/docs/reportDevToolFault.js +29 -0
  140. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  141. package/lib/docs/requestRestart.test.mjs +1 -0
  142. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  143. package/lib/docs/resolveSource.js +2 -2
  144. package/lib/docs/resolveSource.test.mjs +6 -6
  145. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  146. package/lib/docs/runCheck.test.mjs +3 -3
  147. package/lib/docs/runCheckChild.js +2 -1
  148. package/lib/docs/runEndpoint.js +23 -10
  149. package/lib/docs/runEndpoint.test.mjs +42 -37
  150. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  151. package/lib/docs/runJourney.js +21 -1
  152. package/lib/docs/runJourney.test.mjs +119 -99
  153. package/lib/docs/runJourneyDataSet.test.mjs +26 -26
  154. package/lib/docs/runJourneySteps.js +8 -29
  155. package/lib/docs/runRequest.js +6 -6
  156. package/lib/docs/runRequest.test.mjs +22 -22
  157. package/lib/docs/screenshotPage.js +6 -7
  158. package/lib/docs/screenshotPage.test.mjs +46 -46
  159. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  160. package/lib/docs/searchDocs.test.mjs +1 -0
  161. package/lib/docs/searchIcons.test.mjs +5 -5
  162. package/lib/docs/selectFinalState.test.mjs +1 -0
  163. package/lib/docs/serverErrorStore.test.mjs +4 -4
  164. package/lib/docs/setupTestFixtures.mjs +25 -0
  165. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  166. package/lib/docs/tabAvailable.js +1 -1
  167. package/lib/docs/tabChannel.js +90 -14
  168. package/lib/docs/tabChannel.test.mjs +40 -15
  169. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  170. package/lib/docs/validateStateSelection.test.mjs +1 -0
  171. package/lib/docs/validateViewport.test.mjs +1 -0
  172. package/lib/docs/waitForBuild.test.mjs +1 -0
  173. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  174. package/lib/docs/withDataSession.js +2 -2
  175. package/lib/server/applyDataSetRedirect.js +14 -5
  176. package/lib/server/applyDataSetRedirect.test.mjs +121 -15
  177. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
  178. package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
  179. package/lib/server/auth/getHeadlessUser.js +6 -0
  180. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  181. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  182. package/lib/server/contextMapBudget.test.mjs +3 -3
  183. package/lib/server/continueJitKeys.test.mjs +1 -0
  184. package/lib/server/createLowdefyContext.js +8 -4
  185. package/lib/server/createLowdefyContext.test.mjs +38 -35
  186. package/lib/server/getClientAddress.test.mjs +2 -2
  187. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  188. package/lib/server/importAppCode.test.mjs +2 -2
  189. package/lib/server/jitPageBuilder.js +27 -3
  190. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  191. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  192. package/lib/server/jitPageBuilder.test.mjs +4 -4
  193. package/lib/server/journeyCookies.test.mjs +1 -0
  194. package/lib/server/loadDynamicJsMap.js +10 -1
  195. package/lib/server/log/createHandleError.js +10 -5
  196. package/lib/server/log/createHandleError.test.mjs +19 -8
  197. package/lib/server/log/createLogger.test.mjs +2 -2
  198. package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
  199. package/lib/server/mutants/listMutants.test.mjs +1 -0
  200. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  201. package/lib/server/mutants/operators.test.mjs +1 -0
  202. package/lib/server/pageBuildRecords.test.mjs +1 -0
  203. package/lib/server/pageCache.test.mjs +1 -0
  204. package/lib/server/pageRebuilds.test.mjs +3 -3
  205. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  206. package/lib/server/pruneJitMaps.test.mjs +1 -0
  207. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  208. package/lib/server/readInstanceRecord.test.mjs +24 -8
  209. package/lib/server/readMergedMaps.test.mjs +1 -0
  210. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  211. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  212. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  213. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  214. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  215. package/lib/server/startIdleGc.test.mjs +25 -9
  216. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  217. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  218. package/manager/getContext.mjs +11 -2
  219. package/manager/processes/checkPendingPlugins.mjs +49 -0
  220. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  221. package/manager/processes/createIdleChild.mjs +141 -0
  222. package/manager/processes/createIdleChild.test.mjs +209 -0
  223. package/manager/processes/initialBuild.mjs +4 -15
  224. package/manager/processes/initialBuild.test.mjs +8 -37
  225. package/manager/processes/lowdefyBuild.mjs +11 -7
  226. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
  227. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  228. package/manager/processes/restartServer.test.mjs +63 -15
  229. package/manager/processes/shutdownServer.test.mjs +3 -3
  230. package/manager/processes/startFirstServer.test.mjs +23 -22
  231. package/manager/processes/startMailSink.mjs +11 -3
  232. package/manager/processes/startMailSink.test.mjs +28 -2
  233. package/manager/processes/startProxy.mjs +158 -27
  234. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  235. package/manager/processes/startProxy.test.mjs +127 -2
  236. package/manager/processes/startServer.mjs +5 -7
  237. package/manager/processes/startServer.test.mjs +10 -9
  238. package/manager/processes/syncServer.mjs +31 -4
  239. package/manager/processes/syncServer.test.mjs +71 -6
  240. package/manager/processes/waitForDevServer.test.mjs +21 -6
  241. package/manager/run.mjs +32 -8
  242. package/manager/utils/BatchChanges.mjs +1 -1
  243. package/manager/utils/BatchChanges.test.mjs +4 -4
  244. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  245. package/manager/utils/checkPairing.mjs +45 -0
  246. package/manager/utils/checkPairing.test.mjs +53 -0
  247. package/manager/utils/createBuildActivity.mjs +5 -1
  248. package/manager/utils/createBuildActivity.test.mjs +2 -2
  249. package/manager/utils/createChangeSignal.test.mjs +5 -5
  250. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  251. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  252. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  253. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  254. package/manager/utils/createGlobIgnore.mjs +45 -0
  255. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  256. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  257. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  258. package/manager/utils/createIdleGc.test.mjs +31 -15
  259. package/manager/utils/createLanPairing.mjs +34 -0
  260. package/manager/utils/createLanPairing.test.mjs +46 -0
  261. package/manager/utils/createRequestActivity.mjs +30 -3
  262. package/manager/utils/createRequestActivity.test.mjs +76 -22
  263. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  264. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  265. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  266. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  267. package/manager/utils/findSignInCode.test.mjs +33 -0
  268. package/manager/utils/formatLanPairing.mjs +32 -0
  269. package/manager/utils/formatLanPairing.test.mjs +40 -0
  270. package/manager/utils/getLanAddress.mjs +83 -0
  271. package/manager/utils/getLanAddress.test.mjs +70 -0
  272. package/manager/utils/importFresh.test.mjs +1 -0
  273. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  274. package/manager/utils/pluginTypeCache.mjs +100 -0
  275. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  276. package/manager/utils/pruneRecordings.test.mjs +1 -0
  277. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  278. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  279. package/manager/utils/readBasePath.test.mjs +1 -0
  280. package/manager/utils/readManagerVersion.test.mjs +1 -0
  281. package/manager/utils/readPluginDefinitions.mjs +6 -6
  282. package/manager/utils/renderTerminalQr.mjs +54 -0
  283. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  284. package/manager/utils/setupWatcher.mjs +19 -4
  285. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  286. package/manager/utils/waitForChildExit.test.mjs +2 -2
  287. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  288. package/manager/watchers/envWatcher.mjs +3 -0
  289. package/manager/watchers/envWatcher.test.mjs +19 -7
  290. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  291. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  292. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  293. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  294. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  295. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  296. package/manager/watchers/resolveFile.mjs +46 -0
  297. package/manager/watchers/resolveFile.test.mjs +67 -0
  298. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  299. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  300. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  301. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  302. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  303. package/package.json +50 -49
  304. package/package.original.json +50 -49
  305. package/src/app.js +83 -85
  306. package/src/html/renderDevPage.test.mjs +1 -0
  307. package/src/lib/getPathSegments.js +16 -1
  308. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  309. package/src/lib/isTabAnswer.js +32 -0
  310. package/src/lib/isTabChannelCaller.js +35 -0
  311. package/src/middleware/apiContext.js +4 -2
  312. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  313. package/src/middleware/errorHandler.js +33 -45
  314. package/src/middleware/errorHandler.test.mjs +10 -10
  315. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  316. package/src/middleware/localDevToolsOnly.js +13 -1
  317. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  318. package/src/middleware/noStore.test.mjs +1 -0
  319. package/src/middleware/staleFlag.test.mjs +1 -0
  320. package/src/middleware/stampCaller.test.mjs +1 -0
  321. package/src/routes/agentBearer.test.mjs +183 -0
  322. package/src/routes/auth.test.mjs +10 -10
  323. package/src/routes/clientError.js +21 -4
  324. package/src/routes/clientError.test.mjs +127 -0
  325. package/src/routes/devInspect.js +6 -51
  326. package/src/routes/devInspect.test.mjs +128 -3
  327. package/src/routes/devRecording.js +6 -17
  328. package/src/routes/devRecording.test.mjs +54 -3
  329. package/src/routes/docs/buildStatus.test.mjs +6 -6
  330. package/src/routes/docs/events.test.mjs +4 -4
  331. package/src/routes/docs/find.js +3 -3
  332. package/src/routes/docs/journey.test.mjs +8 -8
  333. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  334. package/src/routes/docs/loadDocsRoutes.js +70 -0
  335. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  336. package/src/routes/docs/mcp.test.mjs +5 -5
  337. package/src/routes/docs/mutants.js +7 -0
  338. package/src/routes/docs/mutants.test.mjs +20 -6
  339. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  340. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  341. package/src/routes/docs/restart.test.mjs +1 -0
  342. package/src/routes/endpoints.js +24 -0
  343. package/src/routes/endpointsLink.test.mjs +111 -0
  344. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  345. package/src/routes/jitPage.js +13 -1
  346. package/src/routes/jitPage.test.mjs +36 -11
  347. package/src/routes/mcp.js +6 -0
  348. package/src/routes/mcp.test.mjs +23 -8
  349. package/src/routes/mcpMemberToken.test.mjs +8 -8
  350. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  351. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  352. package/src/routes/mobileRoutes.test.mjs +223 -0
  353. package/src/routes/mobileSignIn.js +58 -0
  354. package/src/routes/mobileSignIn.test.mjs +59 -0
  355. package/src/routes/mobileSignInCallback.js +34 -0
  356. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  357. package/src/routes/mountDevPageRoutes.js +10 -2
  358. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  359. package/src/routes/mountMobileWellKnown.js +35 -0
  360. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  361. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  362. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  363. package/src/routes/reload.js +101 -20
  364. package/src/routes/reload.test.mjs +153 -0
  365. package/src/routes/request.js +1 -22
  366. package/src/routes/request.test.mjs +7 -24
  367. package/src/routes/requestBody.test.mjs +14 -27
  368. package/src/routes/websocket.test.mjs +2 -2
  369. package/src/routes/wellKnownFallback.test.mjs +2 -2
  370. package/src/websocket/devWebSocket.test.mjs +12 -12
  371. package/vite.config.js +13 -1
  372. package/client/feedback/FeedbackMount.jsx +0 -83
  373. package/client/feedback/FeedbackOverlay.jsx +0 -904
  374. package/client/feedback/captureTabScreenshot.js +0 -84
  375. package/client/feedback/copyToClipboard.js +0 -45
  376. package/client/feedback/drawAnnotationsSvg.js +0 -119
  377. package/client/feedback/feedbackStyles.js +0 -304
  378. package/client/feedback/pinResponsiveImages.js +0 -59
  379. package/client/feedback/sendFeedback.js +0 -39
  380. package/client/feedback/useFeedbackToggle.js +0 -70
  381. package/client/recorder/buildEngineRecord.js +0 -37
  382. package/client/recorder/buildInteractionRecord.js +0 -64
  383. package/client/recorder/buildTraceEvent.js +0 -57
  384. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  385. package/client/recorder/chunkRecords.js +0 -69
  386. package/client/recorder/chunkRecords.test.mjs +0 -59
  387. package/client/recorder/collectEventEndpoints.js +0 -40
  388. package/client/recorder/collectEventRequests.js +0 -39
  389. package/client/recorder/createPairingBuffer.js +0 -187
  390. package/client/recorder/createPasswordRedactor.js +0 -84
  391. package/client/recorder/createRecordBatcher.js +0 -54
  392. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  393. package/client/recorder/createRecordingSession.js +0 -61
  394. package/client/recorder/createRecordingSession.test.mjs +0 -72
  395. package/client/recorder/diffStateWrites.js +0 -77
  396. package/client/recorder/diffStateWrites.test.mjs +0 -66
  397. package/client/recorder/isEventCall.js +0 -30
  398. package/client/recorder/jsonType.js +0 -39
  399. package/client/recorder/sendRecords.js +0 -40
  400. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  401. package/lib/docs/checkpointPaths.js +0 -91
  402. package/lib/docs/checkpointStore.js +0 -243
  403. package/lib/docs/checkpointToMocks.js +0 -65
  404. package/lib/docs/configCheckpoints.test.mjs +0 -156
  405. package/lib/docs/createConfigCheckpoint.js +0 -92
  406. package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
  407. package/lib/docs/devMockRegistry.js +0 -68
  408. package/lib/docs/enrichFeedback.js +0 -71
  409. package/lib/docs/evalOperator.js +0 -49
  410. package/lib/docs/evalOperator.test.mjs +0 -157
  411. package/lib/docs/evalOperatorHeadless.js +0 -159
  412. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  413. package/lib/docs/evalOperatorInTab.js +0 -49
  414. package/lib/docs/formatFeedback.js +0 -142
  415. package/lib/docs/formatFeedback.test.mjs +0 -252
  416. package/lib/docs/getPluginDoc.js +0 -53
  417. package/lib/docs/listConfigCheckpoints.js +0 -55
  418. package/lib/docs/loadState.js +0 -220
  419. package/lib/docs/revertConfigCheckpoint.js +0 -73
  420. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  421. package/lib/docs/scaffoldPage.js +0 -77
  422. package/lib/docs/scaffoldPage.test.mjs +0 -97
  423. package/lib/docs/snapshotState.js +0 -67
  424. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  425. package/manager/watchers/listServerSidePackages.mjs +0 -47
  426. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  427. package/src/routes/docs/checkpointsCreate.js +0 -28
  428. package/src/routes/docs/evalOperator.js +0 -70
  429. package/src/routes/docs/inspectState.js +0 -59
  430. package/src/routes/docs/loadState.js +0 -51
  431. package/src/routes/docs/pluginDoc.js +0 -33
  432. package/src/routes/docs/plugins.js +0 -23
  433. package/src/routes/docs/runEndpoint.js +0 -54
  434. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  435. package/src/routes/docs/runRequest.js +0 -53
  436. package/src/routes/docs/runRequest.test.mjs +0 -92
  437. package/src/routes/docs/schema.js +0 -37
  438. package/src/routes/docs/screenshot.js +0 -120
  439. package/src/routes/docs/screenshot.test.mjs +0 -117
  440. package/src/routes/docs/search.js +0 -40
  441. package/src/routes/docs/snapshotState.js +0 -50
  442. package/src/routes/docs/stateCheckpointsList.js +0 -26
  443. package/src/routes/docs/types.js +0 -33
  444. package/src/routes/feedback.js +0 -107
  445. package/src/routes/feedback.test.mjs +0 -204
@@ -14,40 +14,40 @@
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
  import { buildPagePath } from '@lowdefy/helpers';
19
19
 
20
- const mockOpenPage = jest.fn();
21
- const mockGetBrowser = jest.fn();
22
- jest.unstable_mockModule('./getBrowser.js', () => ({
20
+ const mockOpenPage = vi.fn();
21
+ const mockGetBrowser = vi.fn();
22
+ vi.doMock('./getBrowser.js', () => ({
23
23
  getBrowser: mockGetBrowser,
24
24
  openPage: mockOpenPage,
25
25
  buildPageUrl: ({ origin, pageId, path, pathParams }) =>
26
26
  `${origin}/${buildPagePath({ pageId, path, pathParams })}`,
27
27
  }));
28
28
  // The route table the skeleton build writes; a page it does not hold has no pattern.
29
- const mockReadPagePath = jest.fn(() => undefined);
30
- jest.unstable_mockModule('./readPagePath.js', () => ({ default: mockReadPagePath }));
31
- const mockResolveJourneyDataSet = jest.fn();
32
- jest.unstable_mockModule('./dataSets/resolveJourneyDataSet.js', () => ({
29
+ const mockReadPagePath = vi.fn(() => undefined);
30
+ vi.doMock('./readPagePath.js', () => ({ default: mockReadPagePath }));
31
+ const mockResolveJourneyDataSet = vi.fn();
32
+ vi.doMock('./dataSets/resolveJourneyDataSet.js', () => ({
33
33
  default: mockResolveJourneyDataSet,
34
34
  }));
35
- const mockOpenDataSession = jest.fn();
36
- jest.unstable_mockModule('./dataSets/openDataSession.js', () => ({
35
+ const mockOpenDataSession = vi.fn();
36
+ vi.doMock('./dataSets/openDataSession.js', () => ({
37
37
  default: mockOpenDataSession,
38
38
  }));
39
- const mockGetDataStore = jest.fn();
40
- jest.unstable_mockModule('./dataSets/getDataStore.js', () => ({ default: mockGetDataStore }));
41
- jest.unstable_mockModule('./readDevAuthMode.js', () => ({
39
+ const mockGetDataStore = vi.fn();
40
+ vi.doMock('./dataSets/getDataStore.js', () => ({ default: mockGetDataStore }));
41
+ vi.doMock('./readDevAuthMode.js', () => ({
42
42
  default: () => ({ authConfigured: true, mockUserActive: false }),
43
43
  }));
44
- jest.unstable_mockModule('./collectExercised.js', () => ({ default: async () => ({}) }));
44
+ vi.doMock('./collectExercised.js', () => ({ default: async () => ({}) }));
45
45
  // The plugin connection map lives in a running server's build directory.
46
- jest.unstable_mockModule('./readConnectionPlugins.js', () => ({
46
+ vi.doMock('./readConnectionPlugins.js', () => ({
47
47
  default: async () => ({ MongoDBCollection: { meta: { dataSet: 'redirect' } } }),
48
48
  }));
49
49
 
50
- jest.unstable_mockModule('./observe/waitForClientErrorReports.js', () => ({
50
+ vi.doMock('./observe/waitForClientErrorReports.js', () => ({
51
51
  default: async () => {},
52
52
  }));
53
53
 
@@ -59,7 +59,7 @@ const dataSet = {
59
59
  fixtures: { tickets: [{ _id: 't1' }, { _id: 't2' }], companies: [{ _id: 'c1' }] },
60
60
  generated: { invoices: [{ _id: 'i1' }] },
61
61
  users: { outsider: { id: 'u_9', roles: ['admin'], organizationId: 'org_b' } },
62
- warnings: ['Connections "a" and "b" both name collection "events" in different databases.'],
62
+ warnings: ['Data set "sample" loads 1,200 documents for connection "tickets".'],
63
63
  };
64
64
 
65
65
  let order;
@@ -80,18 +80,18 @@ function createPage() {
80
80
  },
81
81
  };
82
82
  return {
83
- evaluate: jest.fn(async (fn, arg) => fn(arg)),
84
- waitForFunction: jest.fn(async () => {}),
85
- waitForTimeout: jest.fn(async () => {}),
83
+ evaluate: vi.fn(async (fn, arg) => fn(arg)),
84
+ waitForFunction: vi.fn(async () => {}),
85
+ waitForTimeout: vi.fn(async () => {}),
86
86
  url: () => `${origin}/tickets`,
87
87
  isClosed: () => false,
88
88
  };
89
89
  }
90
90
 
91
91
  beforeEach(() => {
92
- jest.clearAllMocks();
92
+ vi.clearAllMocks();
93
93
  order = [];
94
- close = jest.fn(async () => {
94
+ close = vi.fn(async () => {
95
95
  order.push('session.close');
96
96
  });
97
97
  mockGetBrowser.mockResolvedValue({});
@@ -100,7 +100,7 @@ beforeEach(() => {
100
100
  mockResolveJourneyDataSet.mockResolvedValue({ dataSet, user: { id: 'u_1', roles: ['admin'] } });
101
101
  mockOpenPage.mockImplementation(async () => ({
102
102
  context: {
103
- close: jest.fn(async () => {
103
+ close: vi.fn(async () => {
104
104
  order.push('context.close');
105
105
  }),
106
106
  },
@@ -162,7 +162,7 @@ test('runJourney closes the data session after every actor, even when a step thr
162
162
  mockOpenPage
163
163
  .mockImplementationOnce(async () => ({
164
164
  context: {
165
- close: jest.fn(async () => {
165
+ close: vi.fn(async () => {
166
166
  order.push('context.close');
167
167
  }),
168
168
  },
@@ -220,7 +220,7 @@ test('runJourney fails the step that sent a data set journey to another host of
220
220
  const leftOrigin = [];
221
221
  mockOpenPage
222
222
  .mockImplementationOnce(async () => ({
223
- context: { close: jest.fn(async () => {}) },
223
+ context: { close: vi.fn(async () => {}) },
224
224
  page: createPage(),
225
225
  ready: true,
226
226
  leftOrigin: [],
@@ -228,7 +228,7 @@ test('runJourney fails the step that sent a data set journey to another host of
228
228
  .mockImplementationOnce(async () => {
229
229
  leftOrigin.push('http://127.0.0.1:3227/api/page/tickets');
230
230
  return {
231
- context: { close: jest.fn(async () => {}) },
231
+ context: { close: vi.fn(async () => {}) },
232
232
  page: createPage(),
233
233
  ready: true,
234
234
  leftOrigin,
@@ -29,6 +29,7 @@ import checkStepReferences from './checkStepReferences.js';
29
29
  import createLeftOriginError from './createLeftOriginError.js';
30
30
  import { buildPageUrl } from './getBrowser.js';
31
31
  import hasNoEffect from './observe/hasNoEffect.js';
32
+ import isDeepEqual from './isDeepEqual.js';
32
33
  import isPageReady from './isPageReady.js';
33
34
  import JourneyStepError from './JourneyStepError.js';
34
35
  import nextJourneySequence from './nextJourneySequence.js';
@@ -37,24 +38,6 @@ import readJourneyEmailMatch from './readJourneyEmailMatch.js';
37
38
  import readPagePath from './readPagePath.js';
38
39
  import shownTextSelector from './shownTextSelector.js';
39
40
 
40
- // Structural equality over values that have already been through the JSON
41
- // round-trip getState performs in the page (no undefined, no Dates, no
42
- // functions) — so key order is the only thing that must not matter.
43
- function isDeepEqual(a, b) {
44
- if (a === b) {
45
- return true;
46
- }
47
- if (type.isArray(a) && type.isArray(b)) {
48
- return a.length === b.length && a.every((item, index) => isDeepEqual(item, b[index]));
49
- }
50
- if (type.isObject(a) && type.isObject(b)) {
51
- const keysA = Object.keys(a);
52
- const keysB = Object.keys(b);
53
- return keysA.length === keysB.length && keysA.every((key) => isDeepEqual(a[key], b[key]));
54
- }
55
- return false;
56
- }
57
-
58
41
  // Playwright colours its call log with ANSI escapes; the result is read by an
59
42
  // agent as JSON, where they are noise.
60
43
  function cleanMessage(error) {
@@ -97,13 +80,12 @@ function capitalise(text) {
97
80
  // Playwright would never find it visible. The selectors live in
98
81
  // @lowdefy/helpers, where the engine's describe functions read them too.
99
82
  const {
100
- cellAttribute: CELL_ATTRIBUTE,
101
83
  checkboxOption: CHECKBOX_OPTION,
102
84
  dropdownOption: DROPDOWN_OPTION,
85
+ gridSelector,
103
86
  interactiveControl: INTERACTIVE_CONTROL,
104
87
  layers: LAYERS,
105
88
  radioOption: RADIO_OPTION,
106
- rowAttribute: ROW_ATTRIBUTE,
107
89
  } = journeyTargetSelectors;
108
90
 
109
91
  // A lazy block (createLazyBlock in @lowdefy/block-utils) shows its wrapper and
@@ -191,14 +173,11 @@ function describeTarget(target) {
191
173
  return parts.join(' ');
192
174
  }
193
175
 
194
- function attributeValue(value) {
195
- return `"${String(value).replace(/["\\]/g, '\\$&')}"`;
196
- }
197
-
198
176
  // The element the target's scope keys name: the block wrapper, narrowed to a
199
- // grid row (`.ag-row[row-index]`, the row as displayed, which ag-grid renders
200
- // once per pinned/centre column container) and to a cell (`.ag-cell[col-id]`,
201
- // the column's field or colId). Undefined for a page-wide `text` target,
177
+ // grid row (the row as displayed: ag-grid's `.ag-row[row-index]`, rendered once
178
+ // per pinned/centre column container, or a Table's `.lf-table-row[data-row-index]`)
179
+ // and to a cell (ag-grid's `.ag-cell[col-id]` or a Table's
180
+ // `.lf-table-gridcell[data-col-key]`: the column's field, colId or key). Undefined for a page-wide `text` target,
202
181
  // which has no scope narrower than the page.
203
182
  function resolveScope({ page, target }) {
204
183
  if (type.isUndefined(target.blockId)) {
@@ -206,10 +185,10 @@ function resolveScope({ page, target }) {
206
185
  }
207
186
  let scope = getBlock(page, target.blockId);
208
187
  if (!type.isUndefined(target.row)) {
209
- scope = scope.locator(`.ag-row[${ROW_ATTRIBUTE}=${attributeValue(target.row)}]`);
188
+ scope = scope.locator(gridSelector({ kind: 'row', value: target.row }));
210
189
  }
211
190
  if (!type.isUndefined(target.column)) {
212
- scope = scope.locator(`.ag-cell[${CELL_ATTRIBUTE}=${attributeValue(target.column)}]`);
191
+ scope = scope.locator(gridSelector({ kind: 'cell', value: target.column }));
213
192
  }
214
193
  return scope;
215
194
  }
@@ -17,7 +17,7 @@
17
17
  import path from 'node:path';
18
18
 
19
19
  import { callRequest } from '@lowdefy/api';
20
- import { ConfigError } from '@lowdefy/errors';
20
+ import { UserError } from '@lowdefy/errors';
21
21
  import { type } from '@lowdefy/helpers';
22
22
 
23
23
  import buildPageIfNeeded, { syncBuildSignals } from '../server/jitPageBuilder.js';
@@ -60,23 +60,23 @@ async function runRequest({
60
60
  honoContext,
61
61
  }) {
62
62
  if (type.isUndefined(pageId) || !type.isString(pageId)) {
63
- throw new ConfigError(
63
+ throw new UserError(
64
64
  `run_request requires a "pageId" string. Received ${JSON.stringify(pageId)}.`
65
65
  );
66
66
  }
67
67
  if (type.isUndefined(requestId) || !type.isString(requestId)) {
68
- throw new ConfigError(
68
+ throw new UserError(
69
69
  `run_request requires a "requestId" string. Received ${JSON.stringify(requestId)}.`
70
70
  );
71
71
  }
72
72
 
73
73
  const caller = await resolveToolCaller({ user, data });
74
74
  if (!type.isUndefined(caller.error)) {
75
- throw new ConfigError(`run_request: ${caller.error}`);
75
+ throw new UserError(`run_request: ${caller.error}`);
76
76
  }
77
77
 
78
78
  if (!type.isBoolean(saveResponse)) {
79
- throw new ConfigError(
79
+ throw new UserError(
80
80
  `run_request "saveResponse" must be a boolean. Received ${JSON.stringify(saveResponse)}.`
81
81
  );
82
82
  }
@@ -104,7 +104,7 @@ async function runRequest({
104
104
  refused: true,
105
105
  reason:
106
106
  `Request "${requestId}" was not found on page "${pageId}". ` +
107
- `See GET /lowdefy-docs/app-map for the pages and requests that exist.`,
107
+ `See lowdefy_app_map for the pages and requests that exist.`,
108
108
  };
109
109
  }
110
110
 
@@ -14,51 +14,51 @@
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
19
  // runRequest reads build artifacts, builds a Lowdefy context and calls
20
20
  // callRequest - all three only exist in a running server directory, so mock
21
21
  // them and leave only runRequest's own validation and pass-through under test.
22
- const mockCallRequest = jest.fn();
23
- const mockReadBuildArtifact = jest.fn();
24
- const mockIsWriteRequestsAllowed = jest.fn();
25
- const mockCreateLowdefyContext = jest.fn();
26
- const mockLoggerInfo = jest.fn();
22
+ const mockCallRequest = vi.fn();
23
+ const mockReadBuildArtifact = vi.fn();
24
+ const mockIsWriteRequestsAllowed = vi.fn();
25
+ const mockCreateLowdefyContext = vi.fn();
26
+ const mockLoggerInfo = vi.fn();
27
27
 
28
- jest.unstable_mockModule('@lowdefy/api', () => ({
28
+ vi.doMock('@lowdefy/api', () => ({
29
29
  callRequest: mockCallRequest,
30
30
  }));
31
- jest.unstable_mockModule('./readBuildArtifact.js', () => ({
31
+ vi.doMock('./readBuildArtifact.js', () => ({
32
32
  default: mockReadBuildArtifact,
33
33
  }));
34
- jest.unstable_mockModule('./isWriteRequestsAllowed.js', () => ({
34
+ vi.doMock('./isWriteRequestsAllowed.js', () => ({
35
35
  default: mockIsWriteRequestsAllowed,
36
36
  }));
37
- jest.unstable_mockModule('../server/createLowdefyContext.js', () => ({
37
+ vi.doMock('../server/createLowdefyContext.js', () => ({
38
38
  default: mockCreateLowdefyContext,
39
39
  }));
40
- const mockBuildPageIfNeeded = jest.fn();
41
- const mockSyncBuildSignals = jest.fn(() => ({
40
+ const mockBuildPageIfNeeded = vi.fn();
41
+ const mockSyncBuildSignals = vi.fn(() => ({
42
42
  registry: { home: { pageId: 'home', refPath: 'pages/home.yaml' } },
43
43
  eventCounter: 0,
44
44
  generation: 1,
45
45
  }));
46
- jest.unstable_mockModule('../server/jitPageBuilder.js', () => ({
46
+ vi.doMock('../server/jitPageBuilder.js', () => ({
47
47
  default: mockBuildPageIfNeeded,
48
48
  syncBuildSignals: mockSyncBuildSignals,
49
49
  }));
50
- const mockReviewPage = jest.fn();
51
- jest.unstable_mockModule('./reviewPage.js', () => ({
50
+ const mockReviewPage = vi.fn();
51
+ vi.doMock('./reviewPage.js', () => ({
52
52
  default: mockReviewPage,
53
53
  }));
54
54
 
55
- const { ConfigError } = await import('@lowdefy/errors');
55
+ const { ConfigError, UserError } = await import('@lowdefy/errors');
56
56
  const { default: runRequest } = await import('./runRequest.js');
57
57
 
58
- const honoContext = { req: { path: '/lowdefy-docs/run-request' } };
58
+ const honoContext = { req: { path: '/lowdefy-docs/mcp' } };
59
59
 
60
60
  beforeEach(() => {
61
- jest.clearAllMocks();
61
+ vi.clearAllMocks();
62
62
  mockReadBuildArtifact.mockImplementation(({ name }) => {
63
63
  if (name === 'plugins/requestSchemas.json') {
64
64
  return { MongoDBFind: { meta: { checkRead: true, checkWrite: false } } };
@@ -103,10 +103,10 @@ test('runRequest logs the user it ran the request as', async () => {
103
103
  });
104
104
  });
105
105
 
106
- test('runRequest throws a ConfigError when user is neither an object nor a data set user', async () => {
106
+ test('runRequest throws a UserError when user is neither an object nor a data set user', async () => {
107
107
  await expect(
108
108
  runRequest({ pageId: 'home', requestId: 'get_rows', user: 'admin', honoContext })
109
- ).rejects.toThrow(ConfigError);
109
+ ).rejects.toThrow(UserError);
110
110
  await expect(
111
111
  runRequest({ pageId: 'home', requestId: 'get_rows', user: ['admin'], honoContext })
112
112
  ).rejects.toThrow(/run_request: "user" should be a user object/);
@@ -160,10 +160,10 @@ test('runRequest does not note stale config for a page that is current', async (
160
160
  expect(result.staleConfig).toBeUndefined();
161
161
  });
162
162
 
163
- test('runRequest throws a ConfigError when saveResponse is not a boolean', async () => {
163
+ test('runRequest throws a UserError when saveResponse is not a boolean', async () => {
164
164
  await expect(
165
165
  runRequest({ pageId: 'home', requestId: 'get_rows', saveResponse: 1, honoContext })
166
- ).rejects.toThrow(ConfigError);
166
+ ).rejects.toThrow(UserError);
167
167
  expect(mockBuildPageIfNeeded).not.toHaveBeenCalled();
168
168
  });
169
169
 
@@ -29,13 +29,12 @@ import validateViewport from './validateViewport.js';
29
29
  import withBrowserSlot from './withBrowserSlot.js';
30
30
  import withDataSession from './withDataSession.js';
31
31
 
32
- // A feedback annotation's elementRect/shapes are captured in the developer's
33
- // live tab, viewport-relative at whatever scroll position they were at
34
- // (batch.viewport.scrollX/scrollY) — so to recapture the same region
35
- // headless, this scrolls to that same offset first, then converts the
36
- // viewport-relative clip to document coordinates by adding the scroll
37
- // offset back in. Mutually exclusive with fullPage: an explicit clip always
38
- // wins, since it targets a specific annotated region rather than the page.
32
+ // A clip is viewport-relative at the given scroll position (scrollX/scrollY)
33
+ // — so to capture the same region headless, this scrolls to that offset
34
+ // first, then converts the viewport-relative clip to document coordinates by
35
+ // adding the scroll offset back in. Mutually exclusive with fullPage: an
36
+ // explicit clip always wins, since it targets a specific region rather than
37
+ // the page.
39
38
  async function resolveClip({ page, clip, scrollX, scrollY }) {
40
39
  if (type.isNone(clip)) {
41
40
  return undefined;
@@ -17,25 +17,25 @@
17
17
  import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
- import { jest } from '@jest/globals';
20
+ import { vi, afterAll, expect, test } from 'vitest';
21
21
 
22
22
  // A real screenshot needs an installed browser, which jest can't rely on, so
23
23
  // this only covers the error paths: bad input, and chromium.launch failing
24
24
  // (the "no browser installed" case). chromium.launch is mocked so the real
25
25
  // browser flow is untouched everywhere else.
26
- jest.unstable_mockModule('playwright-core', () => ({
27
- chromium: { launch: jest.fn().mockRejectedValue(new Error("Executable doesn't exist")) },
28
- selectors: { register: jest.fn(async () => {}) },
26
+ vi.doMock('playwright-core', () => ({
27
+ chromium: { launch: vi.fn().mockRejectedValue(new Error("Executable doesn't exist")) },
28
+ selectors: { register: vi.fn(async () => {}) },
29
29
  }));
30
30
  // A missing shell would otherwise start a real download.
31
- jest.unstable_mockModule('./installHeadlessShell.js', () => ({ default: () => null }));
31
+ vi.doMock('./installHeadlessShell.js', () => ({ default: () => null }));
32
32
  // A data set caller loads a data set into the dev server's memory store; both
33
33
  // are mocked so the test checks who the page opens as and on which database.
34
- const mockReadDataSet = jest.fn();
35
- const mockOpenDataSession = jest.fn();
36
- jest.unstable_mockModule('./dataSets/readDataSet.js', () => ({ default: mockReadDataSet }));
37
- jest.unstable_mockModule('./dataSets/getDataStore.js', () => ({ default: async () => ({}) }));
38
- jest.unstable_mockModule('./dataSets/openDataSession.js', () => ({
34
+ const mockReadDataSet = vi.fn();
35
+ const mockOpenDataSession = vi.fn();
36
+ vi.doMock('./dataSets/readDataSet.js', () => ({ default: mockReadDataSet }));
37
+ vi.doMock('./dataSets/getDataStore.js', () => ({ default: async () => ({}) }));
38
+ vi.doMock('./dataSets/openDataSession.js', () => ({
39
39
  default: mockOpenDataSession,
40
40
  }));
41
41
 
@@ -114,19 +114,19 @@ test('screenshotPage opens the page at the urlQuery and captures after the steps
114
114
  const { chromium } = await import('playwright-core');
115
115
  const calls = [];
116
116
  const page = {
117
- goto: jest.fn(async (url) => calls.push(`goto ${url}`)),
118
- waitForFunction: jest.fn(async () => {}),
119
- waitForTimeout: jest.fn(async () => {}),
120
- screenshot: jest.fn(async () => {
117
+ goto: vi.fn(async (url) => calls.push(`goto ${url}`)),
118
+ waitForFunction: vi.fn(async () => {}),
119
+ waitForTimeout: vi.fn(async () => {}),
120
+ screenshot: vi.fn(async () => {
121
121
  calls.push('screenshot');
122
122
  return Buffer.from('png');
123
123
  }),
124
124
  };
125
125
  const context = {
126
- addCookies: jest.fn(async () => {}),
127
- newPage: jest.fn(async () => page),
128
- close: jest.fn(async () => {}),
129
- on: jest.fn(),
126
+ addCookies: vi.fn(async () => {}),
127
+ newPage: vi.fn(async () => page),
128
+ close: vi.fn(async () => {}),
129
+ on: vi.fn(),
130
130
  };
131
131
  // getBrowser caches the browser while it reports connected; disconnecting
132
132
  // it after the test makes the next test's launch take effect.
@@ -170,24 +170,24 @@ test('screenshotPage keeps the colour scheme and returns screenshot step capture
170
170
  const { chromium } = await import('playwright-core');
171
171
  let captures = 0;
172
172
  const page = {
173
- goto: jest.fn(async () => {}),
174
- waitForFunction: jest.fn(async () => {}),
175
- waitForTimeout: jest.fn(async () => {}),
176
- screenshot: jest.fn(async () => {
173
+ goto: vi.fn(async () => {}),
174
+ waitForFunction: vi.fn(async () => {}),
175
+ waitForTimeout: vi.fn(async () => {}),
176
+ screenshot: vi.fn(async () => {
177
177
  captures += 1;
178
178
  return Buffer.from(`png-${captures}`);
179
179
  }),
180
180
  };
181
181
  const context = {
182
- addCookies: jest.fn(async () => {}),
182
+ addCookies: vi.fn(async () => {}),
183
183
  // A journey's network counter listens for the context's requests.
184
- on: jest.fn(),
184
+ on: vi.fn(),
185
185
  // Its pages report what they ran through the journey observer binding.
186
- exposeBinding: jest.fn(async () => {}),
187
- newPage: jest.fn(async () => page),
188
- close: jest.fn(async () => {}),
186
+ exposeBinding: vi.fn(async () => {}),
187
+ newPage: vi.fn(async () => page),
188
+ close: vi.fn(async () => {}),
189
189
  };
190
- const newContext = jest.fn(async () => context);
190
+ const newContext = vi.fn(async () => context);
191
191
  let connected = true;
192
192
  chromium.launch.mockResolvedValue({ isConnected: () => connected, newContext });
193
193
  try {
@@ -239,21 +239,21 @@ test("screenshotPage renders as a data set user, on the data set's own database"
239
239
  const { chromium } = await import('playwright-core');
240
240
  const member = { id: 'u_member', roles: ['member'] };
241
241
  mockReadDataSet.mockResolvedValue({ name: 'crm', users: { member } });
242
- const close = jest.fn(async () => {});
242
+ const close = vi.fn(async () => {});
243
243
  mockOpenDataSession.mockResolvedValue({ cookie: 'session1', session: { id: 'session1' }, close });
244
244
  const page = {
245
- goto: jest.fn(async () => {}),
246
- waitForFunction: jest.fn(async () => {}),
247
- waitForTimeout: jest.fn(async () => {}),
248
- screenshot: jest.fn(async () => Buffer.from('png')),
245
+ goto: vi.fn(async () => {}),
246
+ waitForFunction: vi.fn(async () => {}),
247
+ waitForTimeout: vi.fn(async () => {}),
248
+ screenshot: vi.fn(async () => Buffer.from('png')),
249
249
  };
250
250
  const cookies = [];
251
251
  const context = {
252
- addCookies: jest.fn(async (added) => cookies.push(...added)),
253
- route: jest.fn(async () => {}),
254
- newPage: jest.fn(async () => page),
255
- close: jest.fn(async () => {}),
256
- on: jest.fn(),
252
+ addCookies: vi.fn(async (added) => cookies.push(...added)),
253
+ route: vi.fn(async () => {}),
254
+ newPage: vi.fn(async () => page),
255
+ close: vi.fn(async () => {}),
256
+ on: vi.fn(),
257
257
  };
258
258
  let connected = true;
259
259
  chromium.launch.mockResolvedValue({
@@ -288,17 +288,17 @@ test('screenshotPage opens the page signed out for user "none"', async () => {
288
288
  const { chromium } = await import('playwright-core');
289
289
  mockOpenDataSession.mockClear();
290
290
  const page = {
291
- goto: jest.fn(async () => {}),
292
- waitForFunction: jest.fn(async () => {}),
293
- waitForTimeout: jest.fn(async () => {}),
294
- screenshot: jest.fn(async () => Buffer.from('png')),
291
+ goto: vi.fn(async () => {}),
292
+ waitForFunction: vi.fn(async () => {}),
293
+ waitForTimeout: vi.fn(async () => {}),
294
+ screenshot: vi.fn(async () => Buffer.from('png')),
295
295
  };
296
296
  const cookies = [];
297
297
  const context = {
298
- addCookies: jest.fn(async (added) => cookies.push(...added)),
299
- newPage: jest.fn(async () => page),
300
- close: jest.fn(async () => {}),
301
- on: jest.fn(),
298
+ addCookies: vi.fn(async (added) => cookies.push(...added)),
299
+ newPage: vi.fn(async () => page),
300
+ close: vi.fn(async () => {}),
301
+ on: vi.fn(),
302
302
  };
303
303
  let connected = true;
304
304
  chromium.launch.mockResolvedValue({
@@ -14,37 +14,37 @@
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
  // Covers the clip/scroll success path, which screenshotPage.test.mjs cannot
20
20
  // (it deliberately fails chromium.launch to test the "no browser" error
21
21
  // path). Mocking the whole ./getBrowser.js module — not just
22
22
  // playwright-core — means lib/build/config.js (which getBrowser.js reads at
23
23
  // import time) is never touched, so no fixture chdir is needed here.
24
- const mockScreenshot = jest.fn(async () => Buffer.from('fake-png'));
25
- const mockWaitForTimeout = jest.fn(async () => {});
26
- const mockEvaluate = jest.fn(async () => {});
24
+ const mockScreenshot = vi.fn(async () => Buffer.from('fake-png'));
25
+ const mockWaitForTimeout = vi.fn(async () => {});
26
+ const mockEvaluate = vi.fn(async () => {});
27
27
  const mockPage = {
28
28
  screenshot: mockScreenshot,
29
29
  waitForTimeout: mockWaitForTimeout,
30
30
  evaluate: mockEvaluate,
31
31
  };
32
- const mockContext = { close: jest.fn(async () => {}) };
33
- const mockOpenPage = jest.fn(async () => ({
32
+ const mockContext = { close: vi.fn(async () => {}) };
33
+ const mockOpenPage = vi.fn(async () => ({
34
34
  context: mockContext,
35
35
  page: mockPage,
36
36
  url: 'http://localhost:3001/home',
37
37
  }));
38
- const mockGetBrowser = jest.fn(async () => ({}));
38
+ const mockGetBrowser = vi.fn(async () => ({}));
39
39
 
40
40
  // The route table is a build artifact these tests have none of: every page is served at its id.
41
- jest.unstable_mockModule('./resolvePageInstance.js', () => ({
41
+ vi.doMock('./resolvePageInstance.js', () => ({
42
42
  default: ({ pageId }) => ({ path: pageId, instanceKey: `page:${pageId}` }),
43
43
  }));
44
- jest.unstable_mockModule('./getBrowser.js', () => ({
44
+ vi.doMock('./getBrowser.js', () => ({
45
45
  getBrowser: mockGetBrowser,
46
46
  openPage: mockOpenPage,
47
- buildPageUrl: jest.fn(() => 'http://localhost:3001/home'),
47
+ buildPageUrl: vi.fn(() => 'http://localhost:3001/home'),
48
48
  }));
49
49
 
50
50
  const { default: screenshotPage } = await import('./screenshotPage.js');
@@ -19,6 +19,7 @@ import path from 'path';
19
19
 
20
20
  import getDocsManifest from './getDocsManifest.js';
21
21
  import searchDocs from './searchDocs.js';
22
+ import { expect, test } from 'vitest';
22
23
 
23
24
  // The order the substring search gave before terms: title or slug matches,
24
25
  // then body matches, each in manifest order.
@@ -14,19 +14,19 @@
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
19
  // searchIcons reads the dev build's iconAliases.json and customTypesMap.json,
20
20
  // which only exist in a built server directory, and loads installed icon set
21
21
  // plugins through the build's loader. Lucide's names are real.
22
- const mockReadBuildArtifact = jest.fn();
23
- jest.unstable_mockModule('./readBuildArtifact.js', () => ({
22
+ const mockReadBuildArtifact = vi.fn();
23
+ vi.doMock('./readBuildArtifact.js', () => ({
24
24
  default: mockReadBuildArtifact,
25
25
  }));
26
26
 
27
27
  const buildDev = await import('@lowdefy/build/dev');
28
- const mockLoadIconSets = jest.fn();
29
- jest.unstable_mockModule('@lowdefy/build/dev', () => ({
28
+ const mockLoadIconSets = vi.fn();
29
+ vi.doMock('@lowdefy/build/dev', () => ({
30
30
  ...buildDev,
31
31
  loadIconSets: mockLoadIconSets,
32
32
  }));
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import selectFinalState, { DEFAULT_STATE_LIMIT } from './selectFinalState.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('selectFinalState returns a small state whole by default', () => {
20
21
  expect(selectFinalState({ state: { a: 1 } })).toEqual({ state: { a: 1 } });
@@ -13,13 +13,13 @@
13
13
  See the License for the specific language governing permissions and
14
14
  limitations under the License.
15
15
  */
16
- import { jest } from '@jest/globals';
16
+ import { vi, expect, test } from 'vitest';
17
17
 
18
- const mockPublish = jest.fn();
19
- jest.unstable_mockModule('./devEventBus.js', () => ({
18
+ const mockPublish = vi.fn();
19
+ vi.doMock('./devEventBus.js', () => ({
20
20
  publish: mockPublish,
21
21
  }));
22
- jest.unstable_mockModule('./getBuildId.js', () => ({
22
+ vi.doMock('./getBuildId.js', () => ({
23
23
  default: () => '2026-01-01T00:00:00.000Z',
24
24
  }));
25
25