@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -1,117 +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
- const mockScreenshotPage = jest.fn();
20
-
21
- jest.unstable_mockModule('../../../lib/docs/screenshotPage.js', () => ({
22
- default: mockScreenshotPage,
23
- }));
24
-
25
- const { default: docsScreenshotHandler } = await import('./screenshot.js');
26
-
27
- function createContext(url) {
28
- const parsed = new URL(url);
29
- const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
30
- const body = jest.fn((data, status, headers) => ({ data, status, headers }));
31
- return {
32
- req: {
33
- url,
34
- param: () => parsed.pathname.split('/').pop(),
35
- query: (key) => parsed.searchParams.get(key) ?? undefined,
36
- },
37
- json,
38
- body,
39
- };
40
- }
41
-
42
- beforeEach(() => {
43
- jest.clearAllMocks();
44
- mockScreenshotPage.mockResolvedValue({ data: 'cG5n', mimeType: 'image/png' });
45
- });
46
-
47
- test('docsScreenshotHandler passes the viewport size and colour scheme to screenshotPage', async () => {
48
- const c = createContext(
49
- 'http://localhost:3227/lowdefy-docs/screenshot/home?viewportWidth=390&viewportHeight=844&colorScheme=dark'
50
- );
51
-
52
- const result = await docsScreenshotHandler(c);
53
-
54
- expect(mockScreenshotPage).toHaveBeenCalledWith(
55
- expect.objectContaining({
56
- origin: 'http://localhost:3227',
57
- pageId: 'home',
58
- width: 390,
59
- height: 844,
60
- colorScheme: 'dark',
61
- clip: undefined,
62
- })
63
- );
64
- expect(result.status).toBe(200);
65
- expect(result.headers).toEqual({ 'Content-Type': 'image/png' });
66
- });
67
-
68
- test('docsScreenshotHandler keeps width and height as the clip, apart from the viewport', async () => {
69
- const c = createContext(
70
- 'http://localhost:3227/lowdefy-docs/screenshot/home?x=0&y=10&width=200&height=100&viewportWidth=800'
71
- );
72
-
73
- await docsScreenshotHandler(c);
74
-
75
- expect(mockScreenshotPage).toHaveBeenCalledWith(
76
- expect.objectContaining({
77
- clip: { x: 0, y: 10, width: 200, height: 100 },
78
- width: 800,
79
- height: undefined,
80
- colorScheme: undefined,
81
- })
82
- );
83
- });
84
-
85
- test('docsScreenshotHandler returns 400 for an unknown colour scheme', async () => {
86
- const c = createContext('http://localhost:3227/lowdefy-docs/screenshot/home?colorScheme=dim');
87
-
88
- const result = await docsScreenshotHandler(c);
89
-
90
- expect(result.status).toBe(400);
91
- expect(result.data.error).toEqual('Color scheme must be "light" or "dark". Received "dim".');
92
- expect(mockScreenshotPage).not.toHaveBeenCalled();
93
- });
94
-
95
- test('docsScreenshotHandler returns 400 for a viewport width that is not a positive integer', async () => {
96
- const c = createContext('http://localhost:3227/lowdefy-docs/screenshot/home?viewportWidth=0');
97
-
98
- const result = await docsScreenshotHandler(c);
99
-
100
- expect(result.status).toBe(400);
101
- expect(result.data.error).toMatch(/Viewport width must be a positive integer/);
102
- });
103
-
104
- test.each(['viewportWidth', 'viewportHeight'])(
105
- 'docsScreenshotHandler returns 400 naming a non-numeric %s',
106
- async (key) => {
107
- const c = createContext(`http://localhost:3227/lowdefy-docs/screenshot/home?${key}=wide`);
108
-
109
- const result = await docsScreenshotHandler(c);
110
-
111
- expect(result.status).toBe(400);
112
- expect(result.data.error).toEqual(
113
- `"${key}" must be a positive integer (CSS pixels). Received "wide".`
114
- );
115
- expect(mockScreenshotPage).not.toHaveBeenCalled();
116
- }
117
- );
@@ -1,40 +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 docSources from '../../../lib/docs/docSources.js';
18
- import searchDocs from '../../../lib/docs/searchDocs.js';
19
-
20
- function docsSearchHandler(c) {
21
- const query = c.req.query('q');
22
- const source = c.req.query('source');
23
- if (!query || query.trim() === '') {
24
- return c.json(
25
- { error: 'Missing search query. Use GET /lowdefy-docs/search?q=your+keywords.' },
26
- 400
27
- );
28
- }
29
- if (source !== undefined && !docSources.includes(source)) {
30
- return c.json(
31
- {
32
- error: `Unknown docs source "${source}". Use one of: ${docSources.join(', ')}.`,
33
- },
34
- 400
35
- );
36
- }
37
- return c.json(searchDocs({ query, source }));
38
- }
39
-
40
- export default docsSearchHandler;
@@ -1,50 +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 { parseRequestBody } from '@lowdefy/api';
18
-
19
- import snapshotState from '../../../lib/docs/snapshotState.js';
20
-
21
- // Lets an agent (or a developer) snapshot the running app's page state and
22
- // recorded request/api responses into a checkpoint folder under .lowdefy,
23
- // for later replay via POST /lowdefy-docs/state/load.
24
- async function docsSnapshotStateHandler(c) {
25
- const { pageId, pathParams, name, notes, source, overwrite } = parseRequestBody({
26
- text: await c.req.text(),
27
- });
28
- // Derived from the incoming request rather than a config value — this is
29
- // the origin an agent can actually reach the dev server on (host/port it
30
- // just connected to), regardless of how the server is bound.
31
- const origin = new URL(c.req.url).origin;
32
-
33
- const result = await snapshotState({
34
- origin,
35
- pageId,
36
- pathParams,
37
- name,
38
- notes,
39
- source,
40
- overwrite,
41
- });
42
- if (result.error) {
43
- // pathParams the page cannot be opened with are the caller's to fix, not a
44
- // failed render.
45
- return c.json({ error: result.error }, result.invalidInput ? 400 : 502);
46
- }
47
- return c.json(result);
48
- }
49
-
50
- export default docsSnapshotStateHandler;
@@ -1,26 +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 { listStateCheckpoints } from '../../../lib/docs/checkpointStore.js';
18
-
19
- // Lists state checkpoints (page state + recorded request/api
20
- // responses) — distinct from GET /lowdefy-docs/checkpoints, which lists
21
- // config-directory-snapshot checkpoints (see checkpointStore.js).
22
- function docsStateCheckpointsListHandler(c) {
23
- return c.json(listStateCheckpoints());
24
- }
25
-
26
- export default docsStateCheckpointsListHandler;
@@ -1,33 +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 listTypes from '../../../lib/docs/listTypes.js';
18
- import normalizeTypeKind from '../../../lib/docs/normalizeTypeKind.js';
19
-
20
- function docsTypesHandler(c) {
21
- const kind = c.req.param('kind');
22
- if (normalizeTypeKind({ kind }) === null) {
23
- return c.json(
24
- {
25
- error: `Unknown docs kind "${kind}". Use one of: blocks, operators, actions, connections, requests, agents, notifications, websockets. See GET /lowdefy-docs for all routes.`,
26
- },
27
- 404
28
- );
29
- }
30
- return c.json(listTypes({ kind }));
31
- }
32
-
33
- export default docsTypesHandler;
@@ -1,107 +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 { parseRequestBody } from '@lowdefy/api';
18
-
19
- import enrichFeedback from '../../lib/docs/enrichFeedback.js';
20
- import formatFeedback from '../../lib/docs/formatFeedback.js';
21
- import createLogger from '../../lib/server/log/createLogger.js';
22
- import createSameOriginGuard from '../middleware/createSameOriginGuard.js';
23
-
24
- const logger = createLogger({ server: 'lowdefy-dev-feedback' });
25
- const guardSameOrigin = createSameOriginGuard();
26
-
27
- // Receives annotation batches from the dev browser overlay (a developer
28
- // draws on a live page and comments), enriches each annotation with its
29
- // yaml file:line via findConfig, and returns the formatted agent-readable
30
- // text. The overlay copies that text to the clipboard — the developer
31
- // pastes it into whichever agent session they choose, which is also what
32
- // makes delivery unambiguous when several sessions share one dev server.
33
- // The same-origin guard the browser POST routes share: only a page served by
34
- // this dev server (not an arbitrary site) should be able to use it.
35
- async function feedbackHandler(c) {
36
- const forbidden = guardSameOrigin(c);
37
- if (forbidden) {
38
- return forbidden;
39
- }
40
-
41
- const batch = parseRequestBody({ text: await c.req.text() });
42
- if (!Array.isArray(batch?.annotations)) {
43
- return c.json(
44
- {
45
- error:
46
- 'Feedback batch requires an "annotations" array. See GET /lowdefy-docs for the ' +
47
- 'feedback batch shape.',
48
- },
49
- 400
50
- );
51
- }
52
-
53
- // The tab screenshot rides in as a multi-MB data URL — lift it off the
54
- // batch before enrichment so it never reaches the formatted text or the
55
- // headless capture path.
56
- const tabScreenshot = batch.screenshot;
57
- delete batch.screenshot;
58
- let enriched = await enrichFeedback({ batch });
59
- delete enriched.screenshot;
60
-
61
- // Default on — the overlay sends includeScreenshot: false when the
62
- // developer unticks it.
63
- if (batch.includeScreenshot !== false) {
64
- const fileName = `${batch.pageId}-${new Date().toISOString().replace(/[:.]/g, '-')}.png`;
65
- if (typeof tabScreenshot === 'string') {
66
- // Preferred path: the overlay captured the developer's actual tab —
67
- // theme, loaded data, exact pixels — with annotations already drawn.
68
- const { default: saveAnnotatedScreenshot } = await import(
69
- '../../lib/docs/saveAnnotatedScreenshot.js'
70
- );
71
- const result = saveAnnotatedScreenshot({ dataUrl: tabScreenshot, fileName });
72
- if (result.path) {
73
- enriched = { ...enriched, screenshotPath: result.path };
74
- } else {
75
- logger.warn(result.error);
76
- }
77
- } else {
78
- // Fallback: re-render the page headless (batches from agents or older
79
- // clients, or when the in-tab capture failed). The response must NOT
80
- // wait for this capture: the overlay writes the clipboard when this
81
- // returns, and Chrome's transient user-activation (required for
82
- // clipboard writes) expires within ~5s — a headless browser launch can
83
- // take longer. So the path is pre-assigned, the formatted text returns
84
- // immediately, and the PNG lands on disk a moment later — well before
85
- // a human pastes it anywhere.
86
- // Deferred import: the capture module pulls in the browser singleton,
87
- // which reads build artifacts at import time — only load it when a
88
- // screenshot is actually wanted.
89
- const { default: captureAnnotatedScreenshot } = await import(
90
- '../../lib/docs/captureAnnotatedScreenshot.js'
91
- );
92
- const serverOrigin = new URL(c.req.url).origin;
93
- enriched = { ...enriched, screenshotPath: `.lowdefy/annotations/${fileName}` };
94
- captureAnnotatedScreenshot({ origin: serverOrigin, batch: enriched, fileName }).then(
95
- (result) => {
96
- if (result.error) {
97
- logger.warn(result.error);
98
- }
99
- }
100
- );
101
- }
102
- }
103
-
104
- return c.json({ ok: true, formatted: formatFeedback({ items: [enriched] }) });
105
- }
106
-
107
- export default feedbackHandler;
@@ -1,204 +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 { Hono } from 'hono';
22
- import { jest } from '@jest/globals';
23
-
24
- // enrichFeedback (findConfig → force-builds a page) is covered on its own in
25
- // lib/docs/formatFeedback.test.mjs — here it's stubbed as a pass-through so
26
- // this file only exercises the route: origin check, validation, and enrich +
27
- // format wiring.
28
- const mockEnrichFeedback = jest.fn(async ({ batch }) => batch);
29
- jest.unstable_mockModule('../../lib/docs/enrichFeedback.js', () => ({
30
- default: mockEnrichFeedback,
31
- }));
32
- const mockCaptureAnnotatedScreenshot = jest.fn(async () => ({
33
- path: '.lowdefy/annotations/test.png',
34
- }));
35
- jest.unstable_mockModule('../../lib/docs/captureAnnotatedScreenshot.js', () => ({
36
- default: mockCaptureAnnotatedScreenshot,
37
- }));
38
-
39
- const { default: feedbackHandler } = await import('./feedback.js');
40
-
41
- function createApp() {
42
- const app = new Hono();
43
- app.all('/api/feedback', feedbackHandler);
44
- return app;
45
- }
46
-
47
- let configDirectory;
48
- const originalConfigDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG;
49
-
50
- beforeEach(() => {
51
- configDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-feedback-test-'));
52
- process.env.LOWDEFY_DIRECTORY_CONFIG = configDirectory;
53
- });
54
-
55
- afterEach(() => {
56
- mockEnrichFeedback.mockClear();
57
- mockCaptureAnnotatedScreenshot.mockClear();
58
- fs.rmSync(configDirectory, { recursive: true, force: true });
59
- if (originalConfigDirectory === undefined) {
60
- delete process.env.LOWDEFY_DIRECTORY_CONFIG;
61
- } else {
62
- process.env.LOWDEFY_DIRECTORY_CONFIG = originalConfigDirectory;
63
- }
64
- });
65
-
66
- test('feedbackHandler returns 403 when the Origin header is missing', async () => {
67
- const res = await createApp().request('/api/feedback', {
68
- method: 'POST',
69
- headers: { host: 'localhost:3001', 'content-type': 'application/json' },
70
- body: JSON.stringify({ annotations: [] }),
71
- });
72
- expect(res.status).toEqual(403);
73
- });
74
-
75
- test('feedbackHandler returns 403 when the Origin host does not match the request host', async () => {
76
- const res = await createApp().request('/api/feedback', {
77
- method: 'POST',
78
- headers: {
79
- host: 'localhost:3001',
80
- origin: 'http://evil.example.com',
81
- 'content-type': 'application/json',
82
- },
83
- body: JSON.stringify({ annotations: [] }),
84
- });
85
- expect(res.status).toEqual(403);
86
- });
87
-
88
- test('feedbackHandler returns 400 with a helpful message when annotations is missing', async () => {
89
- const res = await createApp().request('/api/feedback', {
90
- method: 'POST',
91
- headers: {
92
- host: 'localhost:3001',
93
- origin: 'http://localhost:3001',
94
- 'content-type': 'application/json',
95
- },
96
- body: JSON.stringify({ pageId: 'login' }),
97
- });
98
- expect(res.status).toEqual(400);
99
- const body = await res.json();
100
- expect(body.error).toMatch(/annotations/);
101
- expect(body.error).toMatch(/\/lowdefy-docs/);
102
- });
103
-
104
- test('feedbackHandler enriches a valid batch and returns the formatted text', async () => {
105
- const batch = { pageId: 'login', annotations: [{ id: '1', kind: 'region', comment: 'x' }] };
106
- const res = await createApp().request('/api/feedback', {
107
- method: 'POST',
108
- headers: {
109
- host: 'localhost:3001',
110
- origin: 'http://localhost:3001',
111
- 'content-type': 'application/json',
112
- },
113
- body: JSON.stringify(batch),
114
- });
115
-
116
- expect(res.status).toEqual(200);
117
- const body = await res.json();
118
- expect(body.ok).toBe(true);
119
- expect(typeof body.formatted).toBe('string');
120
- expect(body.formatted).toContain('login');
121
- expect(mockEnrichFeedback).toHaveBeenCalledWith({ batch });
122
- });
123
-
124
- // A real 1x1 red PNG so the saved file is a valid image, not just bytes.
125
- const PNG_1X1_BASE64 =
126
- 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==';
127
-
128
- test('feedbackHandler saves a tab-captured screenshot and skips the headless capture', async () => {
129
- const batch = {
130
- pageId: 'dashboard',
131
- annotations: [{ id: '1', kind: 'region', comment: 'x' }],
132
- screenshot: `data:image/png;base64,${PNG_1X1_BASE64}`,
133
- };
134
- const res = await createApp().request('/api/feedback', {
135
- method: 'POST',
136
- headers: {
137
- host: 'localhost:3001',
138
- origin: 'http://localhost:3001',
139
- 'content-type': 'application/json',
140
- },
141
- body: JSON.stringify(batch),
142
- });
143
-
144
- expect(res.status).toEqual(200);
145
- const body = await res.json();
146
- expect(body.ok).toBe(true);
147
- expect(body.formatted).toContain('.lowdefy/annotations/dashboard-');
148
- // The data URL must never leak into the agent-readable text.
149
- expect(body.formatted).not.toContain(PNG_1X1_BASE64);
150
- expect(mockCaptureAnnotatedScreenshot).not.toHaveBeenCalled();
151
-
152
- const dir = path.join(configDirectory, '.lowdefy', 'annotations');
153
- const files = fs.readdirSync(dir);
154
- expect(files).toHaveLength(1);
155
- expect(files[0]).toMatch(/^dashboard-.*\.png$/);
156
- expect(fs.readFileSync(path.join(dir, files[0]))).toEqual(
157
- Buffer.from(PNG_1X1_BASE64, 'base64')
158
- );
159
- });
160
-
161
- test('feedbackHandler falls back to the headless capture when the screenshot is not a PNG data URL', async () => {
162
- const batch = {
163
- pageId: 'dashboard',
164
- annotations: [{ id: '1', kind: 'region', comment: 'x' }],
165
- screenshot: 'data:image/jpeg;base64,notpng',
166
- };
167
- const res = await createApp().request('/api/feedback', {
168
- method: 'POST',
169
- headers: {
170
- host: 'localhost:3001',
171
- origin: 'http://localhost:3001',
172
- 'content-type': 'application/json',
173
- },
174
- body: JSON.stringify(batch),
175
- });
176
-
177
- expect(res.status).toEqual(200);
178
- const body = await res.json();
179
- expect(body.ok).toBe(true);
180
- // Not a valid tab capture — no file saved, and no screenshotPath claimed
181
- // for it (the invalid-string branch logs a warning instead).
182
- expect(fs.existsSync(path.join(configDirectory, '.lowdefy', 'annotations'))).toBe(false);
183
- });
184
-
185
- test('feedbackHandler uses the headless capture when the batch has no screenshot', async () => {
186
- const batch = {
187
- pageId: 'dashboard',
188
- annotations: [{ id: '1', kind: 'region', comment: 'x' }],
189
- };
190
- const res = await createApp().request('/api/feedback', {
191
- method: 'POST',
192
- headers: {
193
- host: 'localhost:3001',
194
- origin: 'http://localhost:3001',
195
- 'content-type': 'application/json',
196
- },
197
- body: JSON.stringify(batch),
198
- });
199
-
200
- expect(res.status).toEqual(200);
201
- const body = await res.json();
202
- expect(body.formatted).toContain('.lowdefy/annotations/dashboard-');
203
- expect(mockCaptureAnnotatedScreenshot).toHaveBeenCalledTimes(1);
204
- });