@lowdefy/server-dev 7.1.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (432) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +87 -135
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  106. package/lib/docs/isPageReady.test.mjs +1 -0
  107. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  108. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  109. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  110. package/lib/docs/launchBrowser.test.mjs +8 -8
  111. package/lib/docs/listTypes.js +58 -8
  112. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  113. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  114. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  115. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  116. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  117. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  118. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  119. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  120. package/lib/docs/pollTab.js +100 -0
  121. package/lib/docs/pollTab.test.mjs +64 -0
  122. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  123. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  124. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  125. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  126. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  127. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  128. package/lib/docs/readJourneySession.js +1 -1
  129. package/lib/docs/reportDevToolFault.js +29 -0
  130. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  131. package/lib/docs/requestRestart.test.mjs +1 -0
  132. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  133. package/lib/docs/resolveSource.js +2 -2
  134. package/lib/docs/resolveSource.test.mjs +6 -6
  135. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  136. package/lib/docs/runCheck.test.mjs +3 -3
  137. package/lib/docs/runCheckChild.js +2 -1
  138. package/lib/docs/runEndpoint.js +23 -10
  139. package/lib/docs/runEndpoint.test.mjs +42 -37
  140. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  141. package/lib/docs/runJourney.js +21 -1
  142. package/lib/docs/runJourney.test.mjs +119 -99
  143. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  144. package/lib/docs/runJourneySteps.js +8 -29
  145. package/lib/docs/runRequest.js +6 -6
  146. package/lib/docs/runRequest.test.mjs +22 -22
  147. package/lib/docs/screenshotPage.js +6 -7
  148. package/lib/docs/screenshotPage.test.mjs +46 -46
  149. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  150. package/lib/docs/searchDocs.test.mjs +1 -0
  151. package/lib/docs/searchIcons.test.mjs +5 -5
  152. package/lib/docs/selectFinalState.test.mjs +1 -0
  153. package/lib/docs/serverErrorStore.test.mjs +4 -4
  154. package/lib/docs/setupTestFixtures.mjs +25 -0
  155. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  156. package/lib/docs/tabAvailable.js +1 -1
  157. package/lib/docs/tabChannel.js +90 -14
  158. package/lib/docs/tabChannel.test.mjs +40 -15
  159. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  160. package/lib/docs/validateStateSelection.test.mjs +1 -0
  161. package/lib/docs/validateViewport.test.mjs +1 -0
  162. package/lib/docs/waitForBuild.test.mjs +1 -0
  163. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  164. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  165. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  166. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  167. package/lib/server/auth/getHeadlessUser.js +6 -0
  168. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  169. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  170. package/lib/server/contextMapBudget.test.mjs +3 -3
  171. package/lib/server/continueJitKeys.test.mjs +1 -0
  172. package/lib/server/createLowdefyContext.js +5 -1
  173. package/lib/server/createLowdefyContext.test.mjs +32 -32
  174. package/lib/server/getClientAddress.test.mjs +2 -2
  175. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  176. package/lib/server/importAppCode.test.mjs +2 -2
  177. package/lib/server/jitPageBuilder.js +27 -3
  178. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  179. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  180. package/lib/server/jitPageBuilder.test.mjs +4 -4
  181. package/lib/server/journeyCookies.test.mjs +1 -0
  182. package/lib/server/loadDynamicJsMap.js +10 -1
  183. package/lib/server/log/createHandleError.js +10 -5
  184. package/lib/server/log/createHandleError.test.mjs +19 -8
  185. package/lib/server/log/createLogger.test.mjs +2 -2
  186. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  187. package/lib/server/mutants/listMutants.test.mjs +1 -0
  188. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  189. package/lib/server/mutants/operators.test.mjs +1 -0
  190. package/lib/server/pageBuildRecords.test.mjs +1 -0
  191. package/lib/server/pageCache.test.mjs +1 -0
  192. package/lib/server/pageRebuilds.test.mjs +3 -3
  193. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  194. package/lib/server/pruneJitMaps.test.mjs +1 -0
  195. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  196. package/lib/server/readInstanceRecord.test.mjs +24 -8
  197. package/lib/server/readMergedMaps.test.mjs +1 -0
  198. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  199. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  200. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  201. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  202. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  203. package/lib/server/startIdleGc.test.mjs +25 -9
  204. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  205. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  206. package/manager/getContext.mjs +9 -0
  207. package/manager/processes/checkPendingPlugins.mjs +49 -0
  208. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  209. package/manager/processes/createIdleChild.mjs +141 -0
  210. package/manager/processes/createIdleChild.test.mjs +209 -0
  211. package/manager/processes/initialBuild.mjs +2 -15
  212. package/manager/processes/initialBuild.test.mjs +8 -40
  213. package/manager/processes/lowdefyBuild.mjs +7 -4
  214. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  215. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  216. package/manager/processes/restartServer.test.mjs +63 -15
  217. package/manager/processes/shutdownServer.test.mjs +3 -3
  218. package/manager/processes/startFirstServer.test.mjs +23 -22
  219. package/manager/processes/startMailSink.mjs +11 -3
  220. package/manager/processes/startMailSink.test.mjs +28 -2
  221. package/manager/processes/startProxy.mjs +158 -27
  222. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  223. package/manager/processes/startProxy.test.mjs +127 -2
  224. package/manager/processes/startServer.mjs +5 -7
  225. package/manager/processes/startServer.test.mjs +10 -9
  226. package/manager/processes/syncServer.mjs +31 -4
  227. package/manager/processes/syncServer.test.mjs +71 -6
  228. package/manager/processes/waitForDevServer.test.mjs +21 -6
  229. package/manager/run.mjs +32 -8
  230. package/manager/utils/BatchChanges.mjs +1 -1
  231. package/manager/utils/BatchChanges.test.mjs +4 -4
  232. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  233. package/manager/utils/checkPairing.mjs +45 -0
  234. package/manager/utils/checkPairing.test.mjs +53 -0
  235. package/manager/utils/createBuildActivity.mjs +5 -1
  236. package/manager/utils/createBuildActivity.test.mjs +2 -2
  237. package/manager/utils/createChangeSignal.test.mjs +5 -5
  238. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  239. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  240. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  241. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  242. package/manager/utils/createGlobIgnore.mjs +45 -0
  243. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  244. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  245. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  246. package/manager/utils/createIdleGc.test.mjs +31 -15
  247. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  248. package/manager/utils/createLanPairing.test.mjs +46 -0
  249. package/manager/utils/createRequestActivity.mjs +30 -3
  250. package/manager/utils/createRequestActivity.test.mjs +76 -22
  251. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  252. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  253. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  254. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  255. package/manager/utils/findSignInCode.test.mjs +33 -0
  256. package/manager/utils/formatLanPairing.mjs +32 -0
  257. package/manager/utils/formatLanPairing.test.mjs +40 -0
  258. package/manager/utils/getLanAddress.mjs +83 -0
  259. package/manager/utils/getLanAddress.test.mjs +70 -0
  260. package/manager/utils/importFresh.test.mjs +1 -0
  261. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  262. package/manager/utils/pluginTypeCache.mjs +100 -0
  263. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  264. package/manager/utils/pruneRecordings.test.mjs +1 -0
  265. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  266. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  267. package/manager/utils/readBasePath.test.mjs +1 -0
  268. package/manager/utils/readManagerVersion.test.mjs +1 -0
  269. package/manager/utils/readPluginDefinitions.mjs +6 -6
  270. package/manager/utils/renderTerminalQr.mjs +54 -0
  271. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  272. package/manager/utils/setupWatcher.mjs +19 -4
  273. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  274. package/manager/utils/waitForChildExit.test.mjs +2 -2
  275. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  276. package/manager/watchers/envWatcher.mjs +3 -0
  277. package/manager/watchers/envWatcher.test.mjs +19 -7
  278. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  279. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  280. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  281. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  282. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  283. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  284. package/manager/watchers/resolveFile.mjs +46 -0
  285. package/manager/watchers/resolveFile.test.mjs +67 -0
  286. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  287. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  288. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  289. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  290. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  291. package/package.json +50 -49
  292. package/package.original.json +50 -49
  293. package/src/app.js +83 -85
  294. package/src/html/renderDevPage.test.mjs +1 -0
  295. package/src/lib/getPathSegments.js +16 -1
  296. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  297. package/src/lib/isTabAnswer.js +32 -0
  298. package/src/lib/isTabChannelCaller.js +35 -0
  299. package/src/middleware/apiContext.js +4 -2
  300. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  301. package/src/middleware/errorHandler.js +33 -45
  302. package/src/middleware/errorHandler.test.mjs +10 -10
  303. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  304. package/src/middleware/localDevToolsOnly.js +13 -1
  305. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  306. package/src/middleware/noStore.test.mjs +1 -0
  307. package/src/middleware/staleFlag.test.mjs +1 -0
  308. package/src/middleware/stampCaller.test.mjs +1 -0
  309. package/src/routes/agentBearer.test.mjs +183 -0
  310. package/src/routes/auth.test.mjs +10 -10
  311. package/src/routes/clientError.js +21 -4
  312. package/src/routes/clientError.test.mjs +127 -0
  313. package/src/routes/devInspect.js +6 -51
  314. package/src/routes/devInspect.test.mjs +128 -3
  315. package/src/routes/devRecording.js +6 -17
  316. package/src/routes/devRecording.test.mjs +54 -3
  317. package/src/routes/docs/buildStatus.test.mjs +6 -6
  318. package/src/routes/docs/events.test.mjs +4 -4
  319. package/src/routes/docs/find.js +3 -3
  320. package/src/routes/docs/journey.test.mjs +8 -8
  321. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  322. package/src/routes/docs/loadDocsRoutes.js +70 -0
  323. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  324. package/src/routes/docs/mcp.test.mjs +5 -5
  325. package/src/routes/docs/mutants.js +7 -0
  326. package/src/routes/docs/mutants.test.mjs +20 -6
  327. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  328. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  329. package/src/routes/docs/restart.test.mjs +1 -0
  330. package/src/routes/endpoints.js +24 -0
  331. package/src/routes/endpointsLink.test.mjs +111 -0
  332. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  333. package/src/routes/jitPage.js +13 -1
  334. package/src/routes/jitPage.test.mjs +36 -11
  335. package/src/routes/mcp.js +6 -0
  336. package/src/routes/mcp.test.mjs +23 -8
  337. package/src/routes/mcpMemberToken.test.mjs +8 -8
  338. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  339. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  340. package/src/routes/mobileRoutes.test.mjs +223 -0
  341. package/src/routes/mobileSignIn.js +58 -0
  342. package/src/routes/mobileSignIn.test.mjs +59 -0
  343. package/src/routes/mobileSignInCallback.js +34 -0
  344. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  345. package/src/routes/mountDevPageRoutes.js +10 -2
  346. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  347. package/src/routes/mountMobileWellKnown.js +35 -0
  348. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  349. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  350. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  351. package/src/routes/reload.js +101 -20
  352. package/src/routes/reload.test.mjs +153 -0
  353. package/src/routes/request.js +1 -22
  354. package/src/routes/request.test.mjs +7 -24
  355. package/src/routes/requestBody.test.mjs +14 -27
  356. package/src/routes/websocket.test.mjs +2 -2
  357. package/src/routes/wellKnownFallback.test.mjs +2 -2
  358. package/src/websocket/devWebSocket.test.mjs +12 -12
  359. package/vite.config.js +13 -1
  360. package/client/feedback/FeedbackMount.jsx +0 -83
  361. package/client/feedback/FeedbackOverlay.jsx +0 -904
  362. package/client/feedback/captureTabScreenshot.js +0 -84
  363. package/client/feedback/copyToClipboard.js +0 -45
  364. package/client/feedback/drawAnnotationsSvg.js +0 -119
  365. package/client/feedback/feedbackStyles.js +0 -304
  366. package/client/feedback/pinResponsiveImages.js +0 -59
  367. package/client/feedback/sendFeedback.js +0 -39
  368. package/client/feedback/useFeedbackToggle.js +0 -70
  369. package/client/recorder/buildEngineRecord.js +0 -37
  370. package/client/recorder/buildInteractionRecord.js +0 -64
  371. package/client/recorder/buildTraceEvent.js +0 -57
  372. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  373. package/client/recorder/chunkRecords.js +0 -69
  374. package/client/recorder/chunkRecords.test.mjs +0 -59
  375. package/client/recorder/collectEventEndpoints.js +0 -40
  376. package/client/recorder/collectEventRequests.js +0 -39
  377. package/client/recorder/createPairingBuffer.js +0 -187
  378. package/client/recorder/createPasswordRedactor.js +0 -84
  379. package/client/recorder/createRecordBatcher.js +0 -54
  380. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  381. package/client/recorder/createRecordingSession.js +0 -61
  382. package/client/recorder/createRecordingSession.test.mjs +0 -72
  383. package/client/recorder/diffStateWrites.js +0 -77
  384. package/client/recorder/diffStateWrites.test.mjs +0 -66
  385. package/client/recorder/isEventCall.js +0 -30
  386. package/client/recorder/jsonType.js +0 -39
  387. package/client/recorder/sendRecords.js +0 -40
  388. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  389. package/lib/docs/checkpointPaths.js +0 -91
  390. package/lib/docs/checkpointStore.js +0 -243
  391. package/lib/docs/checkpointToMocks.js +0 -65
  392. package/lib/docs/configCheckpoints.test.mjs +0 -156
  393. package/lib/docs/createConfigCheckpoint.js +0 -92
  394. package/lib/docs/devMockRegistry.js +0 -68
  395. package/lib/docs/enrichFeedback.js +0 -71
  396. package/lib/docs/evalOperator.js +0 -49
  397. package/lib/docs/evalOperator.test.mjs +0 -157
  398. package/lib/docs/evalOperatorHeadless.js +0 -159
  399. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  400. package/lib/docs/evalOperatorInTab.js +0 -49
  401. package/lib/docs/formatFeedback.js +0 -142
  402. package/lib/docs/formatFeedback.test.mjs +0 -252
  403. package/lib/docs/getPluginDoc.js +0 -53
  404. package/lib/docs/listConfigCheckpoints.js +0 -55
  405. package/lib/docs/loadState.js +0 -220
  406. package/lib/docs/revertConfigCheckpoint.js +0 -73
  407. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  408. package/lib/docs/scaffoldPage.js +0 -77
  409. package/lib/docs/scaffoldPage.test.mjs +0 -97
  410. package/lib/docs/snapshotState.js +0 -67
  411. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  412. package/manager/watchers/listServerSidePackages.mjs +0 -47
  413. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  414. package/src/routes/docs/checkpointsCreate.js +0 -28
  415. package/src/routes/docs/evalOperator.js +0 -70
  416. package/src/routes/docs/inspectState.js +0 -59
  417. package/src/routes/docs/loadState.js +0 -51
  418. package/src/routes/docs/pluginDoc.js +0 -33
  419. package/src/routes/docs/plugins.js +0 -23
  420. package/src/routes/docs/runEndpoint.js +0 -54
  421. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  422. package/src/routes/docs/runRequest.js +0 -53
  423. package/src/routes/docs/runRequest.test.mjs +0 -92
  424. package/src/routes/docs/schema.js +0 -37
  425. package/src/routes/docs/screenshot.js +0 -120
  426. package/src/routes/docs/screenshot.test.mjs +0 -117
  427. package/src/routes/docs/search.js +0 -40
  428. package/src/routes/docs/snapshotState.js +0 -50
  429. package/src/routes/docs/stateCheckpointsList.js +0 -26
  430. package/src/routes/docs/types.js +0 -33
  431. package/src/routes/feedback.js +0 -107
  432. package/src/routes/feedback.test.mjs +0 -204
@@ -1,156 +0,0 @@
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 fs from 'fs';
18
- import os from 'os';
19
- import path from 'path';
20
-
21
- import { MAX_CHECKPOINTS } from './checkpointPaths.js';
22
- import createConfigCheckpoint from './createConfigCheckpoint.js';
23
- import listConfigCheckpoints from './listConfigCheckpoints.js';
24
- import revertConfigCheckpoint from './revertConfigCheckpoint.js';
25
-
26
- let configDirectory;
27
- let previousConfigDirectory;
28
- let previousCwd;
29
-
30
- function writeFile(relativePath, content) {
31
- const filePath = path.join(configDirectory, relativePath);
32
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
33
- fs.writeFileSync(filePath, content);
34
- }
35
-
36
- function readFile(relativePath) {
37
- return fs.readFileSync(path.join(configDirectory, relativePath), 'utf8');
38
- }
39
-
40
- function exists(relativePath) {
41
- return fs.existsSync(path.join(configDirectory, relativePath));
42
- }
43
-
44
- // Checkpoint ids are timestamp-prefixed (see createConfigCheckpoint.js), so
45
- // tests asserting ordering/eviction need genuinely distinct timestamps
46
- // between calls. A real (short) delay is used instead of mocking the clock —
47
- // this Node/Jest combination's fake timers cannot redefine `performance`.
48
- function sleep(ms) {
49
- return new Promise((resolve) => setTimeout(resolve, ms));
50
- }
51
-
52
- beforeEach(() => {
53
- configDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-config-checkpoints-test-'));
54
- previousConfigDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG;
55
- process.env.LOWDEFY_DIRECTORY_CONFIG = configDirectory;
56
- previousCwd = process.cwd();
57
- process.chdir(configDirectory);
58
-
59
- writeFile('lowdefy.yaml', 'name: my-app\n');
60
- writeFile(path.join('pages', 'home.yaml'), 'id: home\n');
61
- writeFile('.env', 'SECRET=abc\n');
62
- writeFile('README.md', '# My App\n');
63
- // Should never be snapshotted.
64
- writeFile(path.join('node_modules', 'some-dep', 'index.js'), 'module.exports = {};\n');
65
- writeFile(path.join('.git', 'HEAD'), 'ref: refs/heads/main\n');
66
- });
67
-
68
- afterEach(() => {
69
- process.chdir(previousCwd);
70
- fs.rmSync(configDirectory, { recursive: true, force: true });
71
- if (previousConfigDirectory === undefined) {
72
- delete process.env.LOWDEFY_DIRECTORY_CONFIG;
73
- } else {
74
- process.env.LOWDEFY_DIRECTORY_CONFIG = previousConfigDirectory;
75
- }
76
- });
77
-
78
- test('createConfigCheckpoint snapshots config-relevant files and excludes build/vcs/dependency directories', () => {
79
- const result = createConfigCheckpoint({ label: 'before change' });
80
-
81
- expect(result.fileCount).toBe(4);
82
- expect(result.id).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z-before-change$/);
83
-
84
- const snapshotDirectory = path.join(configDirectory, '.lowdefy', 'checkpoints', result.id);
85
- const manifest = JSON.parse(
86
- fs.readFileSync(path.join(snapshotDirectory, 'manifest.json'), 'utf8')
87
- );
88
- expect(manifest.files.sort()).toEqual(
89
- ['lowdefy.yaml', path.join('pages', 'home.yaml'), '.env', 'README.md'].sort()
90
- );
91
-
92
- expect(fs.readFileSync(path.join(snapshotDirectory, 'lowdefy.yaml'), 'utf8')).toBe(
93
- 'name: my-app\n'
94
- );
95
- expect(fs.existsSync(path.join(snapshotDirectory, 'node_modules'))).toBe(false);
96
- expect(fs.existsSync(path.join(snapshotDirectory, '.git'))).toBe(false);
97
- });
98
-
99
- test('listConfigCheckpoints returns an empty array when no checkpoints exist', () => {
100
- expect(listConfigCheckpoints()).toEqual([]);
101
- });
102
-
103
- test('listConfigCheckpoints lists checkpoints most recent first', async () => {
104
- const first = createConfigCheckpoint({ label: 'first' });
105
- await sleep(5);
106
- const second = createConfigCheckpoint({ label: 'second' });
107
-
108
- const checkpoints = listConfigCheckpoints();
109
- expect(checkpoints).toEqual([
110
- { id: second.id, label: 'second', createdAt: expect.any(String), fileCount: 4 },
111
- { id: first.id, label: 'first', createdAt: expect.any(String), fileCount: 4 },
112
- ]);
113
- });
114
-
115
- test('revertConfigCheckpoint restores modified and deleted files, and deletes files added since the checkpoint', () => {
116
- const { id } = createConfigCheckpoint({ label: 'snapshot' });
117
-
118
- // Modify an existing file.
119
- writeFile('lowdefy.yaml', 'name: modified-app\n');
120
- // Delete a file that was in the checkpoint.
121
- fs.rmSync(path.join(configDirectory, 'pages', 'home.yaml'));
122
- // Add a new config-relevant file that was not in the checkpoint.
123
- writeFile(path.join('pages', 'extra.yaml'), 'id: extra\n');
124
-
125
- const result = revertConfigCheckpoint({ id });
126
-
127
- expect(readFile('lowdefy.yaml')).toBe('name: my-app\n');
128
- expect(exists(path.join('pages', 'home.yaml'))).toBe(true);
129
- expect(readFile(path.join('pages', 'home.yaml'))).toBe('id: home\n');
130
- expect(exists(path.join('pages', 'extra.yaml'))).toBe(false);
131
-
132
- expect(result.restored.sort()).toEqual(
133
- ['lowdefy.yaml', path.join('pages', 'home.yaml'), '.env', 'README.md'].sort()
134
- );
135
- expect(result.deleted).toEqual([path.join('pages', 'extra.yaml')]);
136
- });
137
-
138
- test('revertConfigCheckpoint throws an actionable error when the checkpoint id does not exist', () => {
139
- expect(() => revertConfigCheckpoint({ id: 'does-not-exist' })).toThrow(
140
- 'Config checkpoint "does-not-exist" not found.'
141
- );
142
- });
143
-
144
- test('createConfigCheckpoint evicts the oldest checkpoint once more than the cap are stored', async () => {
145
- for (let i = 0; i < MAX_CHECKPOINTS + 1; i += 1) {
146
- createConfigCheckpoint({ label: `checkpoint-${i}` });
147
- await sleep(2);
148
- }
149
-
150
- const checkpoints = listConfigCheckpoints();
151
- expect(checkpoints).toHaveLength(MAX_CHECKPOINTS);
152
- expect(checkpoints.some((checkpoint) => checkpoint.label === 'checkpoint-0')).toBe(false);
153
- expect(
154
- checkpoints.some((checkpoint) => checkpoint.label === `checkpoint-${MAX_CHECKPOINTS}`)
155
- ).toBe(true);
156
- });
@@ -1,92 +0,0 @@
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 fs from 'fs';
18
- import path from 'path';
19
-
20
- import {
21
- getCheckpointsRoot,
22
- getConfigDirectory,
23
- listConfigFiles,
24
- MANIFEST_FILE_NAME,
25
- MAX_CHECKPOINTS,
26
- slug,
27
- } from './checkpointPaths.js';
28
-
29
- // Checkpoint ids sort chronologically as plain strings (ISO timestamp
30
- // prefix), which is what listConfigCheckpoints and the checkpoint cap rely
31
- // on — ":" and "." are replaced since they're awkward/unsafe in directory
32
- // names on some filesystems.
33
- function buildCheckpointId(label) {
34
- const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
35
- return `${timestamp}-${slug(label)}`;
36
- }
37
-
38
- function copyIntoSnapshot({ configDirectory, snapshotDirectory, relativeFilePath }) {
39
- const source = path.join(configDirectory, relativeFilePath);
40
- const destination = path.join(snapshotDirectory, relativeFilePath);
41
- fs.mkdirSync(path.dirname(destination), { recursive: true });
42
- fs.copyFileSync(source, destination);
43
- }
44
-
45
- // Deletes the oldest checkpoints once the stored count exceeds MAX_CHECKPOINTS.
46
- // Checkpoint directory names sort chronologically, so a plain string sort
47
- // puts the oldest first.
48
- function enforceCheckpointCap({ checkpointsRoot }) {
49
- const ids = fs
50
- .readdirSync(checkpointsRoot, { withFileTypes: true })
51
- .filter((entry) => entry.isDirectory())
52
- .map((entry) => entry.name)
53
- .sort();
54
-
55
- const excessCount = ids.length - MAX_CHECKPOINTS;
56
- if (excessCount <= 0) {
57
- return;
58
- }
59
- ids.slice(0, excessCount).forEach((id) => {
60
- fs.rmSync(path.join(checkpointsRoot, id), { recursive: true, force: true });
61
- });
62
- }
63
-
64
- // Snapshots every config-relevant file in the config directory into
65
- // <configDir>/.lowdefy/checkpoints/<id>/, alongside a manifest.json listing
66
- // the files it holds — revertConfigCheckpoint uses that manifest to restore
67
- // exactly, including deleting files that didn't exist at checkpoint time.
68
- function createConfigCheckpoint({ label }) {
69
- const configDirectory = getConfigDirectory();
70
- const checkpointsRoot = getCheckpointsRoot();
71
- const id = buildCheckpointId(label);
72
- const snapshotDirectory = path.join(checkpointsRoot, id);
73
-
74
- const files = listConfigFiles({ configDirectory });
75
-
76
- fs.mkdirSync(snapshotDirectory, { recursive: true });
77
- files.forEach((relativeFilePath) => {
78
- copyIntoSnapshot({ configDirectory, snapshotDirectory, relativeFilePath });
79
- });
80
-
81
- const createdAt = new Date().toISOString();
82
- fs.writeFileSync(
83
- path.join(snapshotDirectory, MANIFEST_FILE_NAME),
84
- JSON.stringify({ id, label: label ?? null, createdAt, files }, null, 2)
85
- );
86
-
87
- enforceCheckpointCap({ checkpointsRoot });
88
-
89
- return { id, fileCount: files.length };
90
- }
91
-
92
- export default createConfigCheckpoint;
@@ -1,68 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { type } from '@lowdefy/helpers';
18
-
19
- // Dev-only agent tooling: an in-memory registry of recorded request
20
- // responses, keyed by (pageId, requestId). Populated by lib/docs/loadState.js
21
- // when a state checkpoint is loaded, and consulted by src/routes/request.js
22
- // so that once a checkpoint is loaded — for a headless verification page, a
23
- // human tester's browser tab, or a future e2e test driving the dev server
24
- // directly — its recorded requests replay instead of hitting the real
25
- // connection. Module-level state is fine: a dev server runs a single process
26
- // per app.
27
- const mocks = new Map();
28
-
29
- function buildKey({ pageId, requestId }) {
30
- return `${pageId}::${requestId}`;
31
- }
32
-
33
- // `mocks` here is the `requests` shape read.js/writeCheckpoint deal in:
34
- // an object keyed by requestId, each value `{ payload, response, error,
35
- // responseTime }`. Only response/error are replayed; payload/responseTime
36
- // are recording metadata, not part of the replay contract.
37
- function loadMocks({ pageId, mocks: entries = {} }) {
38
- if (type.isNone(pageId) || !type.isString(pageId)) {
39
- throw new Error(`loadMocks requires a "pageId" string. Received ${JSON.stringify(pageId)}.`);
40
- }
41
- Object.entries(entries).forEach(([requestId, entry]) => {
42
- mocks.set(buildKey({ pageId, requestId }), {
43
- pageId,
44
- requestId,
45
- response: entry?.response ?? null,
46
- error: entry?.error ?? null,
47
- });
48
- });
49
- }
50
-
51
- function getMock({ pageId, requestId }) {
52
- return mocks.get(buildKey({ pageId, requestId }));
53
- }
54
-
55
- function clearMocks() {
56
- mocks.clear();
57
- }
58
-
59
- function listMocks() {
60
- return Array.from(mocks.values()).map(({ pageId, requestId, response, error }) => ({
61
- pageId,
62
- requestId,
63
- hasResponse: !type.isNone(response),
64
- hasError: !type.isNone(error),
65
- }));
66
- }
67
-
68
- export { clearMocks, getMock, listMocks, loadMocks };
@@ -1,71 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import { type } from '@lowdefy/helpers';
18
-
19
- import findConfig from './findConfig.js';
20
-
21
- // Resolves each annotation's target.blockId to a config source location
22
- // (file:line) via findConfig, which force-builds the batch's page — so an
23
- // annotation drawn on a block the agent hasn't looked at yet still resolves.
24
- // Runs before the batch is queued (src/routes/feedback.js) so
25
- // formatFeedback.js can stay a pure string formatter with no build-artifact
26
- // access of its own.
27
- async function enrichFeedback({ batch }) {
28
- const annotations = await Promise.all(
29
- (batch.annotations ?? []).map((annotation) => enrichAnnotation({ annotation, batch }))
30
- );
31
- return { ...batch, annotations };
32
- }
33
-
34
- async function enrichAnnotation({ annotation, batch }) {
35
- const blockId = annotation.target?.blockId;
36
- if (type.isNone(blockId)) {
37
- return annotation;
38
- }
39
- try {
40
- // Dynamically generated blocks (Dynamic endpoints, list items) have ids
41
- // that exist only at runtime — walk up the ancestor chain until an id
42
- // resolves in config, so the annotation still points at the yaml that
43
- // produces the block.
44
- const candidates = [blockId, ...(annotation.target?.ancestorBlockIds ?? []).slice(1)];
45
- for (const candidateId of candidates) {
46
- const result = await findConfig({ id: candidateId, pageId: batch.pageId });
47
- const location = result.matches?.[0]?.location;
48
- if (location) {
49
- if (candidateId !== blockId) {
50
- return {
51
- ...annotation,
52
- location: { ...location, resolvedVia: candidateId },
53
- };
54
- }
55
- return { ...annotation, location };
56
- }
57
- }
58
- return {
59
- ...annotation,
60
- location: {
61
- note: `Block is generated at runtime — no configured ancestor found on page "${batch.pageId}".`,
62
- },
63
- };
64
- } catch (error) {
65
- // Never drop feedback because location resolution failed — the
66
- // developer's annotation is still useful without a file:line pointer.
67
- return { ...annotation, location: { note: `Failed to resolve location: ${error.message}` } };
68
- }
69
- }
70
-
71
- export default enrichFeedback;
@@ -1,49 +0,0 @@
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 evalOperatorInTab from './evalOperatorInTab.js';
18
- import evalOperatorHeadless from './evalOperatorHeadless.js';
19
- import resolveSource from './resolveSource.js';
20
-
21
- // resolveSource picks the tab or headless — including why `user` is
22
- // headless-only. Falls back to headless whenever the tab path isn't usable
23
- // (no tab connected, or `source: 'tab'` was requested but it errored) so
24
- // agents always get an answer.
25
- async function evalOperator({ origin, pageId, pathParams, expression, source, user, data }) {
26
- const { tryTab, error, invalidInput } = resolveSource({
27
- name: 'evalOperator',
28
- pageId,
29
- pathParams,
30
- source,
31
- user,
32
- data,
33
- });
34
- if (error) {
35
- return { error, invalidInput };
36
- }
37
-
38
- if (tryTab) {
39
- const result = await evalOperatorInTab({ pageId, pathParams, expression });
40
- if (!result?.error) {
41
- return { ...result, source: 'tab' };
42
- }
43
- }
44
-
45
- const result = await evalOperatorHeadless({ origin, pageId, pathParams, expression, user, data });
46
- return { ...result, source: 'headless' };
47
- }
48
-
49
- export default evalOperator;
@@ -1,157 +0,0 @@
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 { jest } from '@jest/globals';
18
-
19
- // evalOperator.js only chooses between the tab and headless sources - the
20
- // sources' own behavior is covered by evalOperatorHeadless.test.mjs and (once
21
- // written) evalOperatorInTab's own tests. Mock both, plus tabAvailable, so
22
- // only the fallback logic is under test here.
23
- const mockEvalOperatorInTab = jest.fn();
24
- const mockEvalOperatorHeadless = jest.fn();
25
- const mockTabAvailable = jest.fn();
26
-
27
- jest.unstable_mockModule('./evalOperatorInTab.js', () => ({
28
- default: mockEvalOperatorInTab,
29
- }));
30
- jest.unstable_mockModule('./evalOperatorHeadless.js', () => ({
31
- default: mockEvalOperatorHeadless,
32
- }));
33
- jest.unstable_mockModule('./tabAvailable.js', () => ({
34
- default: mockTabAvailable,
35
- }));
36
-
37
- const { default: evalOperator } = await import('./evalOperator.js');
38
-
39
- beforeEach(() => {
40
- jest.clearAllMocks();
41
- });
42
-
43
- const expression = { _state: 'name' };
44
-
45
- test('evalOperator uses the tab when source is "tab" and it succeeds', async () => {
46
- mockEvalOperatorInTab.mockResolvedValue({ value: 'Jane', errors: [] });
47
-
48
- const result = await evalOperator({
49
- origin: 'http://localhost:3001',
50
- pageId: 'home',
51
- expression,
52
- source: 'tab',
53
- });
54
-
55
- expect(result).toEqual({ value: 'Jane', errors: [], source: 'tab' });
56
- expect(mockEvalOperatorInTab).toHaveBeenCalledWith({ pageId: 'home', expression });
57
- expect(mockEvalOperatorHeadless).not.toHaveBeenCalled();
58
- });
59
-
60
- test('evalOperator falls back to headless when source is "tab" but the tab errors', async () => {
61
- mockEvalOperatorInTab.mockResolvedValue({ error: 'No browser tab connected.' });
62
- mockEvalOperatorHeadless.mockResolvedValue({ value: 'Jane', errors: [] });
63
-
64
- const result = await evalOperator({
65
- origin: 'http://localhost:3001',
66
- pageId: 'home',
67
- expression,
68
- source: 'tab',
69
- });
70
-
71
- expect(result).toEqual({ value: 'Jane', errors: [], source: 'headless' });
72
- expect(mockEvalOperatorHeadless).toHaveBeenCalledWith({
73
- origin: 'http://localhost:3001',
74
- pageId: 'home',
75
- expression,
76
- });
77
- });
78
-
79
- test('evalOperator goes straight to headless when source is "headless"', async () => {
80
- mockEvalOperatorHeadless.mockResolvedValue({ value: 'Jane', errors: [] });
81
-
82
- const result = await evalOperator({
83
- origin: 'http://localhost:3001',
84
- pageId: 'home',
85
- expression,
86
- source: 'headless',
87
- });
88
-
89
- expect(result).toEqual({ value: 'Jane', errors: [], source: 'headless' });
90
- expect(mockTabAvailable).not.toHaveBeenCalled();
91
- expect(mockEvalOperatorInTab).not.toHaveBeenCalled();
92
- });
93
-
94
- test('evalOperator prefers the tab when source is unset and a tab is available', async () => {
95
- mockTabAvailable.mockReturnValue(true);
96
- mockEvalOperatorInTab.mockResolvedValue({ value: 'Jane', errors: [] });
97
-
98
- const result = await evalOperator({
99
- origin: 'http://localhost:3001',
100
- pageId: 'home',
101
- expression,
102
- });
103
-
104
- expect(result).toEqual({ value: 'Jane', errors: [], source: 'tab' });
105
- expect(mockEvalOperatorHeadless).not.toHaveBeenCalled();
106
- });
107
-
108
- test('evalOperator ignores an available tab and passes the user to headless when a user is given', async () => {
109
- mockTabAvailable.mockReturnValue(true);
110
- mockEvalOperatorHeadless.mockResolvedValue({ value: 'Jane', errors: [] });
111
-
112
- const result = await evalOperator({
113
- origin: 'http://localhost:3001',
114
- pageId: 'home',
115
- expression,
116
- user: { roles: ['admin'] },
117
- });
118
-
119
- expect(result).toEqual({ value: 'Jane', errors: [], source: 'headless' });
120
- expect(mockEvalOperatorInTab).not.toHaveBeenCalled();
121
- expect(mockEvalOperatorHeadless).toHaveBeenCalledWith({
122
- origin: 'http://localhost:3001',
123
- pageId: 'home',
124
- expression,
125
- user: { roles: ['admin'] },
126
- });
127
- });
128
-
129
- test('evalOperator errors when a user is combined with source "tab"', async () => {
130
- const result = await evalOperator({
131
- origin: 'http://localhost:3001',
132
- pageId: 'home',
133
- expression,
134
- source: 'tab',
135
- user: { roles: ['admin'] },
136
- });
137
-
138
- expect(result.error).toMatch(/cannot apply "user" to the developer's live tab/);
139
- // Flagged as the caller's mistake so the HTTP route answers 400, not 502.
140
- expect(result.invalidInput).toBe(true);
141
- expect(mockEvalOperatorInTab).not.toHaveBeenCalled();
142
- expect(mockEvalOperatorHeadless).not.toHaveBeenCalled();
143
- });
144
-
145
- test('evalOperator goes straight to headless when source is unset and no tab is available', async () => {
146
- mockTabAvailable.mockReturnValue(false);
147
- mockEvalOperatorHeadless.mockResolvedValue({ value: 'Jane', errors: [] });
148
-
149
- const result = await evalOperator({
150
- origin: 'http://localhost:3001',
151
- pageId: 'home',
152
- expression,
153
- });
154
-
155
- expect(result).toEqual({ value: 'Jane', errors: [], source: 'headless' });
156
- expect(mockEvalOperatorInTab).not.toHaveBeenCalled();
157
- });