@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,15 +14,82 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
+ import { type } from '@lowdefy/helpers';
18
+
19
+ import findDeviceTab from './device/findDeviceTab.js';
17
20
  import inspectStateFromTab from './inspectStateFromTab.js';
18
21
  import inspectStateHeadless from './inspectStateHeadless.js';
19
22
  import resolveSource from './resolveSource.js';
20
23
 
24
+ // `device` names a phone's tab (lowdefy_device list): its live state is read,
25
+ // as `source: 'tab'` reads a browser tab, and never falls back to headless,
26
+ // which would answer for a different screen than the one asked about.
27
+ async function inspectDevice({
28
+ name,
29
+ pageId,
30
+ pathParams,
31
+ device,
32
+ evaluate,
33
+ expression,
34
+ source,
35
+ user,
36
+ data,
37
+ }) {
38
+ if (source === 'headless') {
39
+ return {
40
+ error: `${name} reads a phone's live tab when "device" is given; "source" "headless" contradicts it. Leave "source" out, or pass "tab".`,
41
+ invalidInput: true,
42
+ };
43
+ }
44
+ if (!type.isNone(user) || !type.isNone(data)) {
45
+ return {
46
+ error: `${name} cannot apply "${
47
+ type.isNone(user) ? 'data' : 'user'
48
+ }" to a phone: it carries its own session and the app's real database.`,
49
+ invalidInput: true,
50
+ };
51
+ }
52
+ const { tab, error } = findDeviceTab({ device });
53
+ if (!type.isUndefined(error)) {
54
+ return { error, invalidInput: true };
55
+ }
56
+ const result = await inspectStateFromTab({
57
+ tabId: tab.id,
58
+ pageId,
59
+ pathParams,
60
+ evaluate,
61
+ expression,
62
+ });
63
+ if (!type.isUndefined(result?.error)) {
64
+ return { error: result.error };
65
+ }
66
+ return { ...result, source: 'tab', device: tab.id };
67
+ }
68
+
69
+ // Reads a running page: its state snapshot, or, when an expression is passed,
70
+ // the value of that operator expression against its live state.
21
71
  // resolveSource picks the tab or headless — including why `user` is
22
72
  // headless-only. Falls back to headless whenever the tab path isn't usable
23
73
  // (no tab connected, or `source: 'tab'` was requested but it errored) so
24
74
  // agents always get an answer.
25
- async function inspectState({ origin, pageId, pathParams, source, user, data }) {
75
+ async function inspectState(params) {
76
+ const { origin, pageId, pathParams, expression, source, user, data } = params;
77
+ // null is a valid expression, so whether one was passed is read from the key.
78
+ const evaluate = Object.hasOwn(params, 'expression');
79
+ const { device } = params;
80
+ if (!type.isNone(device)) {
81
+ return inspectDevice({
82
+ name: 'inspectState',
83
+ pageId,
84
+ pathParams,
85
+ device,
86
+ evaluate,
87
+ expression,
88
+ source,
89
+ user,
90
+ data,
91
+ });
92
+ }
26
93
  const { tryTab, error, invalidInput } = resolveSource({
27
94
  name: 'inspectState',
28
95
  pageId,
@@ -36,13 +103,21 @@ async function inspectState({ origin, pageId, pathParams, source, user, data })
36
103
  }
37
104
 
38
105
  if (tryTab) {
39
- const result = await inspectStateFromTab({ pageId, pathParams });
106
+ const result = await inspectStateFromTab({ pageId, pathParams, evaluate, expression });
40
107
  if (!result?.error) {
41
108
  return { ...result, source: 'tab' };
42
109
  }
43
110
  }
44
111
 
45
- const result = await inspectStateHeadless({ origin, pageId, pathParams, user, data });
112
+ const result = await inspectStateHeadless({
113
+ origin,
114
+ pageId,
115
+ pathParams,
116
+ evaluate,
117
+ expression,
118
+ user,
119
+ data,
120
+ });
46
121
  return { ...result, source: 'headless' };
47
122
  }
48
123
 
@@ -14,30 +14,30 @@
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
  // inspectState.js only chooses between the tab and headless sources - the
20
20
  // sources' own behavior is covered by inspectStateHeadless.test.mjs and (once
21
21
  // written) inspectStateFromTab's own tests. Mock both, plus tabAvailable, so
22
22
  // only the fallback logic is under test here.
23
- const mockInspectStateFromTab = jest.fn();
24
- const mockInspectStateHeadless = jest.fn();
25
- const mockTabAvailable = jest.fn();
23
+ const mockInspectStateFromTab = vi.fn();
24
+ const mockInspectStateHeadless = vi.fn();
25
+ const mockTabAvailable = vi.fn();
26
26
 
27
- jest.unstable_mockModule('./inspectStateFromTab.js', () => ({
27
+ vi.doMock('./inspectStateFromTab.js', () => ({
28
28
  default: mockInspectStateFromTab,
29
29
  }));
30
- jest.unstable_mockModule('./inspectStateHeadless.js', () => ({
30
+ vi.doMock('./inspectStateHeadless.js', () => ({
31
31
  default: mockInspectStateHeadless,
32
32
  }));
33
- jest.unstable_mockModule('./tabAvailable.js', () => ({
33
+ vi.doMock('./tabAvailable.js', () => ({
34
34
  default: mockTabAvailable,
35
35
  }));
36
36
 
37
37
  const { default: inspectState } = await import('./inspectState.js');
38
38
 
39
39
  beforeEach(() => {
40
- jest.clearAllMocks();
40
+ vi.clearAllMocks();
41
41
  });
42
42
 
43
43
  test('inspectState uses the tab when source is "tab" and it succeeds', async () => {
@@ -50,7 +50,7 @@ test('inspectState uses the tab when source is "tab" and it succeeds', async ()
50
50
  });
51
51
 
52
52
  expect(result).toEqual({ state: { a: 1 }, source: 'tab' });
53
- expect(mockInspectStateFromTab).toHaveBeenCalledWith({ pageId: 'home' });
53
+ expect(mockInspectStateFromTab).toHaveBeenCalledWith({ pageId: 'home', evaluate: false });
54
54
  expect(mockInspectStateHeadless).not.toHaveBeenCalled();
55
55
  });
56
56
 
@@ -68,6 +68,7 @@ test('inspectState falls back to headless when source is "tab" but the tab error
68
68
  expect(mockInspectStateHeadless).toHaveBeenCalledWith({
69
69
  origin: 'http://localhost:3001',
70
70
  pageId: 'home',
71
+ evaluate: false,
71
72
  });
72
73
  });
73
74
 
@@ -120,6 +121,7 @@ test('inspectState ignores an available tab and passes the user to headless when
120
121
  expect(mockInspectStateHeadless).toHaveBeenCalledWith({
121
122
  origin: 'http://localhost:3001',
122
123
  pageId: 'home',
124
+ evaluate: false,
123
125
  user: { roles: ['admin'] },
124
126
  });
125
127
  });
@@ -138,3 +140,53 @@ test('inspectState errors when a user is combined with source "tab"', async () =
138
140
  expect(mockInspectStateFromTab).not.toHaveBeenCalled();
139
141
  expect(mockInspectStateHeadless).not.toHaveBeenCalled();
140
142
  });
143
+
144
+ test('inspectState evaluates an expression in the tab when one is passed', async () => {
145
+ mockInspectStateFromTab.mockResolvedValue({ value: 'Jane', errors: [], reads: ['state:name'] });
146
+ const expression = { _state: 'name' };
147
+
148
+ const result = await inspectState({ pageId: 'home', expression, source: 'tab' });
149
+
150
+ expect(result).toEqual({ value: 'Jane', errors: [], reads: ['state:name'], source: 'tab' });
151
+ expect(mockInspectStateFromTab).toHaveBeenCalledWith({
152
+ pageId: 'home',
153
+ evaluate: true,
154
+ expression,
155
+ });
156
+ });
157
+
158
+ test('inspectState evaluates a null expression rather than treating it as absent', async () => {
159
+ mockInspectStateHeadless.mockResolvedValue({ value: null, errors: [], reads: [] });
160
+
161
+ const result = await inspectState({
162
+ origin: 'http://localhost:3001',
163
+ pageId: 'home',
164
+ expression: null,
165
+ source: 'headless',
166
+ });
167
+
168
+ expect(result).toEqual({ value: null, errors: [], reads: [], source: 'headless' });
169
+ expect(mockInspectStateHeadless).toHaveBeenCalledWith({
170
+ origin: 'http://localhost:3001',
171
+ pageId: 'home',
172
+ evaluate: true,
173
+ expression: null,
174
+ });
175
+ });
176
+
177
+ test('inspectState falls back to headless evaluation when the tab errors', async () => {
178
+ mockInspectStateFromTab.mockResolvedValue({ error: 'No browser tab connected.' });
179
+ mockInspectStateHeadless.mockResolvedValue({ value: 1, errors: [], reads: ['state:a'] });
180
+
181
+ const result = await inspectState({
182
+ origin: 'http://localhost:3001',
183
+ pageId: 'home',
184
+ expression: { _state: 'a' },
185
+ source: 'tab',
186
+ });
187
+
188
+ expect(result).toEqual({ value: 1, errors: [], reads: ['state:a'], source: 'headless' });
189
+ expect(mockInspectStateHeadless).toHaveBeenCalledWith(
190
+ expect.objectContaining({ evaluate: true, expression: { _state: 'a' } })
191
+ );
192
+ });
@@ -21,20 +21,52 @@ import { requestFromTab } from './tabChannel.js';
21
21
  // Reads the live state of a page open in a developer's real browser tab, via
22
22
  // the SSE + POST /api/dev-inspect round trip set up in Inspector.jsx. Lets an
23
23
  // agent inspect actual client state (not just what the build would produce).
24
+ // With evaluate, the tab evaluates the expression with the page's own
25
+ // WebParser instead, so results match runtime exactly.
24
26
  //
25
27
  // requestFromTab resolves directly with whatever the tab posted as `result`
26
- // (see tabChannel.js) — a serialized snapshot string on success, or an
27
- // `{ error }` object if no tab is connected, the request timed out, or
28
- // Inspector.jsx itself failed to build the snapshot.
29
- async function inspectStateFromTab({ pageId, pathParams } = {}) {
30
- const response = await requestFromTab({ pageId, pathParams, event: 'inspect-request' });
28
+ // (see tabChannel.js) — a serialized snapshot string, or `{ value, errors,
29
+ // reads }` for an expression, on success; an `{ error }` object if no tab is
30
+ // connected, the request timed out, or Inspector.jsx itself failed. `tabId`
31
+ // asks one tab (a phone in Lowdefy Dev answers in the same shapes), else the
32
+ // tab showing the page.
33
+ async function inspectStateFromTab({
34
+ tabId,
35
+ pageId,
36
+ pathParams,
37
+ evaluate = false,
38
+ expression,
39
+ } = {}) {
40
+ if (evaluate) {
41
+ return evaluateInTab({ tabId, pageId, pathParams, expression });
42
+ }
43
+ const response = await requestFromTab({ tabId, pageId, pathParams, event: 'inspect-request' });
31
44
  if (response?.error) {
32
45
  return { error: response.error };
33
46
  }
34
47
  if (!type.isString(response)) {
35
- return { error: 'Browser tab responded with an unexpected payload.' };
48
+ return { error: 'The tab responded with an unexpected payload.' };
36
49
  }
37
50
  return serializer.deserializeFromString(response);
38
51
  }
39
52
 
53
+ async function evaluateInTab({ tabId, pageId, pathParams, expression }) {
54
+ const response = await requestFromTab({
55
+ tabId,
56
+ pageId,
57
+ pathParams,
58
+ event: 'eval-request',
59
+ payload: { expression },
60
+ });
61
+ if (response?.error) {
62
+ return { error: response.error };
63
+ }
64
+ const { value, errors, reads } = response;
65
+ return {
66
+ value: type.isUndefined(value) ? undefined : serializer.deserializeFromString(value),
67
+ errors,
68
+ reads,
69
+ };
70
+ }
71
+
40
72
  export default inspectStateFromTab;
@@ -0,0 +1,79 @@
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 { serializer } from '@lowdefy/helpers';
18
+ import { vi, afterEach, expect, test } from 'vitest';
19
+
20
+ const { listTabs, registerTab, resolveTabRequest, unregisterTab, updateTabPage } = await import(
21
+ './tabChannel.js'
22
+ );
23
+ const { default: inspectStateFromTab } = await import('./inspectStateFromTab.js');
24
+
25
+ afterEach(() => {
26
+ listTabs().forEach((tab) => unregisterTab({ id: tab.id }));
27
+ });
28
+
29
+ function connectHomeTab() {
30
+ const send = vi.fn();
31
+ registerTab({ id: 'tab-1', send });
32
+ updateTabPage({ id: 'tab-1', pageId: 'home', pathParams: {}, instanceKey: 'page:home' });
33
+ return send;
34
+ }
35
+
36
+ test('inspectStateFromTab sends inspect-request and returns the tab snapshot', async () => {
37
+ const send = connectHomeTab();
38
+
39
+ const promise = inspectStateFromTab({ pageId: 'home' });
40
+ const [event, payload] = send.mock.calls[0];
41
+ expect(event).toEqual('inspect-request');
42
+ resolveTabRequest({
43
+ requestId: payload.requestId,
44
+ result: serializer.serializeToString({ state: { a: 1 } }),
45
+ });
46
+
47
+ await expect(promise).resolves.toEqual({ state: { a: 1 } });
48
+ });
49
+
50
+ test('inspectStateFromTab sends eval-request with the expression and returns value, errors and reads', async () => {
51
+ const send = connectHomeTab();
52
+
53
+ const promise = inspectStateFromTab({ pageId: 'home', evaluate: true, expression: null });
54
+ const [event, payload] = send.mock.calls[0];
55
+ expect(event).toEqual('eval-request');
56
+ expect(payload.expression).toBeNull();
57
+ resolveTabRequest({
58
+ requestId: payload.requestId,
59
+ result: { value: serializer.serializeToString(null), errors: [], reads: [] },
60
+ });
61
+
62
+ await expect(promise).resolves.toEqual({ value: null, errors: [], reads: [] });
63
+ });
64
+
65
+ test('inspectStateFromTab returns the tab error for an expression', async () => {
66
+ const send = connectHomeTab();
67
+
68
+ const promise = inspectStateFromTab({
69
+ pageId: 'home',
70
+ evaluate: true,
71
+ expression: { _state: 'a' },
72
+ });
73
+ resolveTabRequest({
74
+ requestId: send.mock.calls[0][1].requestId,
75
+ result: { error: 'Operator failed.' },
76
+ });
77
+
78
+ await expect(promise).resolves.toEqual({ error: 'Operator failed.' });
79
+ });
@@ -26,13 +26,24 @@ import withDataSession from './withDataSession.js';
26
26
 
27
27
  // Collects a state snapshot from a headless Chromium tab navigated to the
28
28
  // page instance's own route (`pathParams` fill a patterned page's placeholders),
29
- // read under the instance key. Mirrors Inspector.jsx's buildSnapshot (the live-tab
30
- // equivalent), but window.lowdefy does not expose the app's serializer, so
31
- // the snapshot is round-tripped through JSON.parse(JSON.stringify(...))
32
- // inside the page instead. That strips functions/undefined and turns Dates
33
- // into plain ISO strings — good enough for agent inspection, just not a
34
- // byte-for-byte match of the app's own `~d`-tagged serialization.
35
- async function inspectStateHeadless({ origin, pageId, pathParams, user, data, timeout = 15000 }) {
29
+ // read under the instance key, or with evaluate the value of an operator
30
+ // expression against that state. Mirrors Inspector.jsx's buildSnapshot and
31
+ // evalExpression (the live-tab equivalents), but window.lowdefy does not expose
32
+ // the app's serializer, so results are round-tripped through
33
+ // JSON.parse(JSON.stringify(...)) inside the page instead. That strips
34
+ // functions/undefined and turns Dates into plain ISO strings — good enough for
35
+ // agent inspection, just not a byte-for-byte match of the app's own
36
+ // `~d`-tagged serialization.
37
+ async function inspectStateHeadless({
38
+ origin,
39
+ pageId,
40
+ pathParams,
41
+ evaluate = false,
42
+ expression,
43
+ user,
44
+ data,
45
+ timeout = 15000,
46
+ }) {
36
47
  if (type.isNone(origin) || !type.isString(origin)) {
37
48
  return {
38
49
  error: `inspectStateHeadless requires an "origin" string. Received ${JSON.stringify(
@@ -66,6 +77,8 @@ async function inspectStateHeadless({ origin, pageId, pathParams, user, data, ti
66
77
  pageId,
67
78
  pathParams,
68
79
  instance,
80
+ evaluate,
81
+ expression,
69
82
  user: caller.user,
70
83
  dataCookie,
71
84
  timeout,
@@ -80,6 +93,8 @@ async function inspectStateInBrowser({
80
93
  pageId,
81
94
  pathParams,
82
95
  instance,
96
+ evaluate,
97
+ expression,
83
98
  user,
84
99
  dataCookie,
85
100
  timeout,
@@ -106,36 +121,23 @@ async function inspectStateInBrowser({
106
121
  timeout,
107
122
  });
108
123
  context = opened.context;
109
- const snapshot = await opened.page.evaluate(
110
- ({ id, instanceKey, path }) => {
111
- const lowdefy = window.lowdefy;
112
- const pageContext = lowdefy?.contexts?.[instanceKey];
113
- if (!pageContext) {
114
- return { error: `No live context for page "${id}" at "/${path}".` };
115
- }
116
- return JSON.parse(
117
- JSON.stringify({
118
- pageId: id,
119
- pathParams: pageContext.pathParams,
120
- instanceKey,
121
- state: pageContext.state,
122
- requests: pageContext.requests,
123
- eventLog: (pageContext.eventLog ?? []).slice(-50),
124
- global: lowdefy.lowdefyGlobal,
125
- user: lowdefy.user,
126
- input: lowdefy.inputs?.[instanceKey],
127
- urlQuery: window.location.search,
128
- })
129
- );
130
- },
131
- { id: pageId, instanceKey: instance.instanceKey, path: instance.path }
132
- );
124
+ const pageArgs = { id: pageId, instanceKey: instance.instanceKey, path: instance.path };
125
+ // The expression is passed through as JSON so the page-side parser always
126
+ // receives a plain value, matching how it arrives at Inspector.jsx's
127
+ // eval-request handler.
128
+ const result = evaluate
129
+ ? await opened.page.evaluate(evaluateInPage, {
130
+ ...pageArgs,
131
+ expressionJson: JSON.stringify(expression),
132
+ })
133
+ : await opened.page.evaluate(snapshotInPage, pageArgs);
133
134
  if (!opened.ready) {
134
- return { ...snapshot, ready: false, note: unsettledPageNote({ timeout }) };
135
+ return { ...result, ready: false, note: unsettledPageNote({ timeout }) };
135
136
  }
136
- return snapshot;
137
+ return result;
137
138
  } catch (error) {
138
- return { error: `Failed to inspect state at "${url}": ${error.message}` };
139
+ const action = evaluate ? 'evaluate operator' : 'inspect state';
140
+ return { error: `Failed to ${action} at "${url}": ${error.message}` };
139
141
  } finally {
140
142
  if (context) {
141
143
  await context.close();
@@ -143,4 +145,66 @@ async function inspectStateInBrowser({
143
145
  }
144
146
  }
145
147
 
148
+ // Runs in the page: serialized by Playwright, so it may use nothing from this module.
149
+ function snapshotInPage({ id, instanceKey, path }) {
150
+ const lowdefy = window.lowdefy;
151
+ const pageContext = lowdefy?.contexts?.[instanceKey];
152
+ if (!pageContext) {
153
+ return { error: `No live context for page "${id}" at "/${path}".` };
154
+ }
155
+ return JSON.parse(
156
+ JSON.stringify({
157
+ pageId: id,
158
+ pathParams: pageContext.pathParams,
159
+ instanceKey,
160
+ state: pageContext.state,
161
+ requests: pageContext.requests,
162
+ eventLog: (pageContext.eventLog ?? []).slice(-50),
163
+ global: lowdefy.lowdefyGlobal,
164
+ user: lowdefy.user,
165
+ input: lowdefy.inputs?.[instanceKey],
166
+ urlQuery: window.location.search,
167
+ })
168
+ );
169
+ }
170
+
171
+ // Runs in the page, like snapshotInPage. A read recorder set on the context
172
+ // while the expression is parsed collects the keys its operators read (the
173
+ // engine's block dependency tracking), e.g. "state:customer.name".
174
+ function evaluateInPage({ id, instanceKey, path, expressionJson }) {
175
+ const lowdefy = window.lowdefy;
176
+ const pageContext = lowdefy?.contexts?.[instanceKey];
177
+ if (!pageContext) {
178
+ return { error: `No live context for page "${id}" at "/${path}".` };
179
+ }
180
+ const reads = new Set();
181
+ const recordRead = (key) => {
182
+ if (typeof key === 'string') reads.add(key);
183
+ };
184
+ const ignore = () => {};
185
+ const previousRecorder = pageContext._internal.readRecorder;
186
+ pageContext._internal.readRecorder = {
187
+ read: recordRead,
188
+ engineRead: recordRead,
189
+ pure: ignore,
190
+ volatile: ignore,
191
+ untracked: ignore,
192
+ };
193
+ let parsed;
194
+ try {
195
+ parsed = pageContext._internal.parser.parse({
196
+ input: JSON.parse(expressionJson),
197
+ location: 'agent_eval',
198
+ });
199
+ } finally {
200
+ pageContext._internal.readRecorder = previousRecorder;
201
+ }
202
+ const { output, errors } = parsed;
203
+ return {
204
+ value: output === undefined ? undefined : JSON.parse(JSON.stringify(output)),
205
+ errors: errors.map((error) => error.message),
206
+ reads: [...reads],
207
+ };
208
+ }
209
+
146
210
  export default inspectStateHeadless;
@@ -17,18 +17,18 @@
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 headless inspection needs an installed browser, which jest can't
23
23
  // rely on, so this only covers the error paths: bad input, and
24
24
  // chromium.launch failing (the "no browser installed" case). Mirrors
25
25
  // screenshotPage.test.mjs, which exercises the same getBrowser.js singleton.
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
 
33
33
  // lib/build/config.js reads build/config.json from process.cwd() at import
34
34
  // time — chdir into a fixture that has one before getBrowser.js (which
@@ -77,3 +77,15 @@ test('inspectStateHeadless returns the error naming a missing placeholder before
77
77
  expect(result.invalidInput).toBe(true);
78
78
  expect(result.error).toMatch(/missing a value for path placeholder "ticket_id"/);
79
79
  });
80
+
81
+ test('inspectStateHeadless returns an actionable error when no browser is available to evaluate an expression', async () => {
82
+ const result = await inspectStateHeadless({
83
+ origin: 'http://localhost:3001',
84
+ pageId: 'home',
85
+ evaluate: true,
86
+ expression: { _state: 'x' },
87
+ });
88
+ expect(result.error).toMatch(
89
+ /No Chromium available. Run: npx playwright install chromium-headless-shell/
90
+ );
91
+ });
@@ -16,18 +16,22 @@
16
16
 
17
17
  import { EventEmitter } from 'node:events';
18
18
 
19
- import { jest } from '@jest/globals';
19
+ import { vi, expect, test } from 'vitest';
20
20
 
21
- const mockSpawn = jest.fn();
22
- jest.unstable_mockModule('child_process', () => ({ spawn: mockSpawn, spawnSync: jest.fn() }));
21
+ const mockSpawn = vi.fn();
22
+ vi.doMock('child_process', () => ({ spawn: mockSpawn, spawnSync: vi.fn() }));
23
23
 
24
24
  // A file of its own: installHeadlessShell keeps its one install per process
25
25
  // in module state.
26
+ const mockLogger = { info: vi.fn(), warn: vi.fn() };
27
+ vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
28
+
26
29
  const { default: installHeadlessShell } = await import('./installHeadlessShell.js');
27
30
 
28
31
  test('installHeadlessShell logs a failed install once and does not retry it in this process', async () => {
29
- const warn = jest.spyOn(console, 'warn').mockImplementation(() => {});
30
- jest.spyOn(console, 'info').mockImplementation(() => {});
32
+ const warn = mockLogger.warn;
33
+ warn.mockClear();
34
+ mockLogger.info.mockClear();
31
35
  const installer = Object.assign(new EventEmitter(), { stderr: new EventEmitter() });
32
36
  mockSpawn.mockReturnValue(installer);
33
37
 
@@ -20,6 +20,9 @@ import path from 'path';
20
20
 
21
21
  import { type } from '@lowdefy/helpers';
22
22
 
23
+ import createLogger from '../server/log/createLogger.js';
24
+
25
+ const logger = createLogger();
23
26
  // Read the way Playwright's own installer reads it, so a value that turns
24
27
  // Playwright's download off turns this one off too.
25
28
  function isDownloadSkipped() {
@@ -56,7 +59,7 @@ function runInstall() {
56
59
  path.dirname(require.resolve('playwright-core/package.json')),
57
60
  'cli.js'
58
61
  );
59
- console.info('Installing chromium-headless-shell for the dev server browser tools.');
62
+ logger.info('Installing chromium-headless-shell for the dev server browser tools.');
60
63
  return new Promise((resolve) => {
61
64
  let settled = false;
62
65
  let stderr = '';
@@ -66,7 +69,7 @@ function runInstall() {
66
69
  settled = true;
67
70
  clearTimeout(timer);
68
71
  if (!installed) {
69
- console.warn(
72
+ logger.warn(
70
73
  `Could not install chromium-headless-shell (${reason}). The dev server browser tools use system Chrome when it is installed. Run: npx playwright install chromium-headless-shell`
71
74
  );
72
75
  }
@@ -16,14 +16,17 @@
16
16
 
17
17
  import { EventEmitter } from 'node:events';
18
18
 
19
- import { jest } from '@jest/globals';
19
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
20
20
 
21
- const mockSpawn = jest.fn();
22
- jest.unstable_mockModule('child_process', () => ({ spawn: mockSpawn, spawnSync: jest.fn() }));
21
+ const mockSpawn = vi.fn();
22
+ vi.doMock('child_process', () => ({ spawn: mockSpawn, spawnSync: vi.fn() }));
23
23
 
24
24
  // installHeadlessShell keeps one install per process in module state, so the
25
25
  // tests below run in order against one module: the skipped calls first, then
26
26
  // the one install. The failure path is in installHeadlessShell.failure.test.mjs.
27
+ const mockLogger = { info: vi.fn(), warn: vi.fn() };
28
+ vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
29
+
27
30
  const { default: installHeadlessShell } = await import('./installHeadlessShell.js');
28
31
 
29
32
  function createInstaller() {
@@ -31,11 +34,11 @@ function createInstaller() {
31
34
  }
32
35
 
33
36
  beforeEach(() => {
34
- jest.spyOn(console, 'info').mockImplementation(() => {});
37
+ mockLogger.info.mockClear();
35
38
  });
36
39
 
37
40
  afterEach(() => {
38
- jest.restoreAllMocks();
41
+ vi.restoreAllMocks();
39
42
  delete process.env.PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD;
40
43
  });
41
44