@lowdefy/server-dev 7.0.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/checkSharedCollectionIds.js +20 -9
  44. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
  45. package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
  46. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  47. package/lib/docs/dataSets/getDataStore.js +11 -3
  48. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  49. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  50. package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
  51. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  52. package/lib/docs/dataSets/openDataSession.js +36 -20
  53. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
  54. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  55. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  56. package/lib/docs/dataSets/readDataSet.js +34 -19
  57. package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
  58. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  59. package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
  60. package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
  61. package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
  62. package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
  63. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  64. package/lib/docs/devEventBus.js +7 -2
  65. package/lib/docs/devEventBus.test.mjs +12 -10
  66. package/lib/docs/devToolDefinitions.js +87 -135
  67. package/lib/docs/device/buildDeviceCommand.js +103 -0
  68. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  69. package/lib/docs/device/captureDevice.js +85 -0
  70. package/lib/docs/device/checkShownPage.js +56 -0
  71. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  72. package/lib/docs/device/deviceAction.js +74 -0
  73. package/lib/docs/device/deviceTools.test.mjs +604 -0
  74. package/lib/docs/device/findDeviceTab.js +50 -0
  75. package/lib/docs/device/findDeviceTarget.js +73 -0
  76. package/lib/docs/device/injectDevice.js +160 -0
  77. package/lib/docs/device/listDevices.js +100 -0
  78. package/lib/docs/device/listDevices.test.mjs +105 -0
  79. package/lib/docs/device/runDeviceJourney.js +68 -0
  80. package/lib/docs/device/runDeviceSteps.js +164 -0
  81. package/lib/docs/device/screenshotDevice.js +68 -0
  82. package/lib/docs/device/sendDeviceStep.js +52 -0
  83. package/lib/docs/device/startDevice.js +150 -0
  84. package/lib/docs/docs.test.mjs +44 -28
  85. package/lib/docs/docsIndex.test.mjs +1 -0
  86. package/lib/docs/findConfig.js +3 -4
  87. package/lib/docs/findPageBlock.js +35 -0
  88. package/lib/docs/findPageBlock.test.mjs +45 -0
  89. package/lib/docs/fitResponse.js +18 -17
  90. package/lib/docs/fitResponse.test.mjs +18 -0
  91. package/lib/docs/getBrowser.js +4 -4
  92. package/lib/docs/getBrowser.test.mjs +32 -16
  93. package/lib/docs/getBuildId.test.mjs +1 -0
  94. package/lib/docs/getBuildStatus.js +29 -3
  95. package/lib/docs/getBuildStatus.test.mjs +108 -12
  96. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  97. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  98. package/lib/docs/getHazards.js +4 -1
  99. package/lib/docs/getHazards.test.mjs +9 -7
  100. package/lib/docs/getOverview.js +22 -44
  101. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  102. package/lib/docs/getStaleStatus.test.mjs +1 -0
  103. package/lib/docs/inspectState.js +78 -3
  104. package/lib/docs/inspectState.test.mjs +61 -9
  105. package/lib/docs/inspectStateFromTab.js +38 -6
  106. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  107. package/lib/docs/inspectStateHeadless.js +98 -34
  108. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  109. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  110. package/lib/docs/installHeadlessShell.js +5 -2
  111. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  112. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  113. package/lib/docs/isDeepEqual.js +37 -0
  114. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  115. package/lib/docs/isPageReady.test.mjs +1 -0
  116. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  117. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  118. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  119. package/lib/docs/launchBrowser.test.mjs +8 -8
  120. package/lib/docs/listTypes.js +58 -8
  121. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  122. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  123. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  124. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  125. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  126. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  127. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  128. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  129. package/lib/docs/pollTab.js +100 -0
  130. package/lib/docs/pollTab.test.mjs +64 -0
  131. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  132. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  133. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  134. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  135. package/lib/docs/rails/findExternalBlocks.js +3 -3
  136. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  137. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  138. package/lib/docs/readJourneySession.js +1 -1
  139. package/lib/docs/reportDevToolFault.js +29 -0
  140. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  141. package/lib/docs/requestRestart.test.mjs +1 -0
  142. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  143. package/lib/docs/resolveSource.js +2 -2
  144. package/lib/docs/resolveSource.test.mjs +6 -6
  145. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  146. package/lib/docs/runCheck.test.mjs +3 -3
  147. package/lib/docs/runCheckChild.js +2 -1
  148. package/lib/docs/runEndpoint.js +23 -10
  149. package/lib/docs/runEndpoint.test.mjs +42 -37
  150. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  151. package/lib/docs/runJourney.js +21 -1
  152. package/lib/docs/runJourney.test.mjs +119 -99
  153. package/lib/docs/runJourneyDataSet.test.mjs +26 -26
  154. package/lib/docs/runJourneySteps.js +8 -29
  155. package/lib/docs/runRequest.js +6 -6
  156. package/lib/docs/runRequest.test.mjs +22 -22
  157. package/lib/docs/screenshotPage.js +6 -7
  158. package/lib/docs/screenshotPage.test.mjs +46 -46
  159. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  160. package/lib/docs/searchDocs.test.mjs +1 -0
  161. package/lib/docs/searchIcons.test.mjs +5 -5
  162. package/lib/docs/selectFinalState.test.mjs +1 -0
  163. package/lib/docs/serverErrorStore.test.mjs +4 -4
  164. package/lib/docs/setupTestFixtures.mjs +25 -0
  165. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  166. package/lib/docs/tabAvailable.js +1 -1
  167. package/lib/docs/tabChannel.js +90 -14
  168. package/lib/docs/tabChannel.test.mjs +40 -15
  169. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  170. package/lib/docs/validateStateSelection.test.mjs +1 -0
  171. package/lib/docs/validateViewport.test.mjs +1 -0
  172. package/lib/docs/waitForBuild.test.mjs +1 -0
  173. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  174. package/lib/docs/withDataSession.js +2 -2
  175. package/lib/server/applyDataSetRedirect.js +14 -5
  176. package/lib/server/applyDataSetRedirect.test.mjs +121 -15
  177. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
  178. package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
  179. package/lib/server/auth/getHeadlessUser.js +6 -0
  180. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  181. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  182. package/lib/server/contextMapBudget.test.mjs +3 -3
  183. package/lib/server/continueJitKeys.test.mjs +1 -0
  184. package/lib/server/createLowdefyContext.js +8 -4
  185. package/lib/server/createLowdefyContext.test.mjs +38 -35
  186. package/lib/server/getClientAddress.test.mjs +2 -2
  187. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  188. package/lib/server/importAppCode.test.mjs +2 -2
  189. package/lib/server/jitPageBuilder.js +27 -3
  190. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  191. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  192. package/lib/server/jitPageBuilder.test.mjs +4 -4
  193. package/lib/server/journeyCookies.test.mjs +1 -0
  194. package/lib/server/loadDynamicJsMap.js +10 -1
  195. package/lib/server/log/createHandleError.js +10 -5
  196. package/lib/server/log/createHandleError.test.mjs +19 -8
  197. package/lib/server/log/createLogger.test.mjs +2 -2
  198. package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
  199. package/lib/server/mutants/listMutants.test.mjs +1 -0
  200. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  201. package/lib/server/mutants/operators.test.mjs +1 -0
  202. package/lib/server/pageBuildRecords.test.mjs +1 -0
  203. package/lib/server/pageCache.test.mjs +1 -0
  204. package/lib/server/pageRebuilds.test.mjs +3 -3
  205. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  206. package/lib/server/pruneJitMaps.test.mjs +1 -0
  207. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  208. package/lib/server/readInstanceRecord.test.mjs +24 -8
  209. package/lib/server/readMergedMaps.test.mjs +1 -0
  210. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  211. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  212. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  213. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  214. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  215. package/lib/server/startIdleGc.test.mjs +25 -9
  216. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  217. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  218. package/manager/getContext.mjs +11 -2
  219. package/manager/processes/checkPendingPlugins.mjs +49 -0
  220. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  221. package/manager/processes/createIdleChild.mjs +141 -0
  222. package/manager/processes/createIdleChild.test.mjs +209 -0
  223. package/manager/processes/initialBuild.mjs +4 -15
  224. package/manager/processes/initialBuild.test.mjs +8 -37
  225. package/manager/processes/lowdefyBuild.mjs +11 -7
  226. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
  227. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  228. package/manager/processes/restartServer.test.mjs +63 -15
  229. package/manager/processes/shutdownServer.test.mjs +3 -3
  230. package/manager/processes/startFirstServer.test.mjs +23 -22
  231. package/manager/processes/startMailSink.mjs +11 -3
  232. package/manager/processes/startMailSink.test.mjs +28 -2
  233. package/manager/processes/startProxy.mjs +158 -27
  234. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  235. package/manager/processes/startProxy.test.mjs +127 -2
  236. package/manager/processes/startServer.mjs +5 -7
  237. package/manager/processes/startServer.test.mjs +10 -9
  238. package/manager/processes/syncServer.mjs +31 -4
  239. package/manager/processes/syncServer.test.mjs +71 -6
  240. package/manager/processes/waitForDevServer.test.mjs +21 -6
  241. package/manager/run.mjs +32 -8
  242. package/manager/utils/BatchChanges.mjs +1 -1
  243. package/manager/utils/BatchChanges.test.mjs +4 -4
  244. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  245. package/manager/utils/checkPairing.mjs +45 -0
  246. package/manager/utils/checkPairing.test.mjs +53 -0
  247. package/manager/utils/createBuildActivity.mjs +5 -1
  248. package/manager/utils/createBuildActivity.test.mjs +2 -2
  249. package/manager/utils/createChangeSignal.test.mjs +5 -5
  250. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  251. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  252. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  253. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  254. package/manager/utils/createGlobIgnore.mjs +45 -0
  255. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  256. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  257. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  258. package/manager/utils/createIdleGc.test.mjs +31 -15
  259. package/manager/utils/createLanPairing.mjs +34 -0
  260. package/manager/utils/createLanPairing.test.mjs +46 -0
  261. package/manager/utils/createRequestActivity.mjs +30 -3
  262. package/manager/utils/createRequestActivity.test.mjs +76 -22
  263. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  264. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  265. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  266. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  267. package/manager/utils/findSignInCode.test.mjs +33 -0
  268. package/manager/utils/formatLanPairing.mjs +32 -0
  269. package/manager/utils/formatLanPairing.test.mjs +40 -0
  270. package/manager/utils/getLanAddress.mjs +83 -0
  271. package/manager/utils/getLanAddress.test.mjs +70 -0
  272. package/manager/utils/importFresh.test.mjs +1 -0
  273. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  274. package/manager/utils/pluginTypeCache.mjs +100 -0
  275. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  276. package/manager/utils/pruneRecordings.test.mjs +1 -0
  277. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  278. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  279. package/manager/utils/readBasePath.test.mjs +1 -0
  280. package/manager/utils/readManagerVersion.test.mjs +1 -0
  281. package/manager/utils/readPluginDefinitions.mjs +6 -6
  282. package/manager/utils/renderTerminalQr.mjs +54 -0
  283. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  284. package/manager/utils/setupWatcher.mjs +19 -4
  285. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  286. package/manager/utils/waitForChildExit.test.mjs +2 -2
  287. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  288. package/manager/watchers/envWatcher.mjs +3 -0
  289. package/manager/watchers/envWatcher.test.mjs +19 -7
  290. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  291. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  292. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  293. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  294. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  295. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  296. package/manager/watchers/resolveFile.mjs +46 -0
  297. package/manager/watchers/resolveFile.test.mjs +67 -0
  298. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  299. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  300. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  301. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  302. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  303. package/package.json +50 -49
  304. package/package.original.json +50 -49
  305. package/src/app.js +83 -85
  306. package/src/html/renderDevPage.test.mjs +1 -0
  307. package/src/lib/getPathSegments.js +16 -1
  308. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  309. package/src/lib/isTabAnswer.js +32 -0
  310. package/src/lib/isTabChannelCaller.js +35 -0
  311. package/src/middleware/apiContext.js +4 -2
  312. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  313. package/src/middleware/errorHandler.js +33 -45
  314. package/src/middleware/errorHandler.test.mjs +10 -10
  315. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  316. package/src/middleware/localDevToolsOnly.js +13 -1
  317. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  318. package/src/middleware/noStore.test.mjs +1 -0
  319. package/src/middleware/staleFlag.test.mjs +1 -0
  320. package/src/middleware/stampCaller.test.mjs +1 -0
  321. package/src/routes/agentBearer.test.mjs +183 -0
  322. package/src/routes/auth.test.mjs +10 -10
  323. package/src/routes/clientError.js +21 -4
  324. package/src/routes/clientError.test.mjs +127 -0
  325. package/src/routes/devInspect.js +6 -51
  326. package/src/routes/devInspect.test.mjs +128 -3
  327. package/src/routes/devRecording.js +6 -17
  328. package/src/routes/devRecording.test.mjs +54 -3
  329. package/src/routes/docs/buildStatus.test.mjs +6 -6
  330. package/src/routes/docs/events.test.mjs +4 -4
  331. package/src/routes/docs/find.js +3 -3
  332. package/src/routes/docs/journey.test.mjs +8 -8
  333. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  334. package/src/routes/docs/loadDocsRoutes.js +70 -0
  335. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  336. package/src/routes/docs/mcp.test.mjs +5 -5
  337. package/src/routes/docs/mutants.js +7 -0
  338. package/src/routes/docs/mutants.test.mjs +20 -6
  339. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  340. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  341. package/src/routes/docs/restart.test.mjs +1 -0
  342. package/src/routes/endpoints.js +24 -0
  343. package/src/routes/endpointsLink.test.mjs +111 -0
  344. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  345. package/src/routes/jitPage.js +13 -1
  346. package/src/routes/jitPage.test.mjs +36 -11
  347. package/src/routes/mcp.js +6 -0
  348. package/src/routes/mcp.test.mjs +23 -8
  349. package/src/routes/mcpMemberToken.test.mjs +8 -8
  350. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  351. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  352. package/src/routes/mobileRoutes.test.mjs +223 -0
  353. package/src/routes/mobileSignIn.js +58 -0
  354. package/src/routes/mobileSignIn.test.mjs +59 -0
  355. package/src/routes/mobileSignInCallback.js +34 -0
  356. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  357. package/src/routes/mountDevPageRoutes.js +10 -2
  358. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  359. package/src/routes/mountMobileWellKnown.js +35 -0
  360. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  361. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  362. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  363. package/src/routes/reload.js +101 -20
  364. package/src/routes/reload.test.mjs +153 -0
  365. package/src/routes/request.js +1 -22
  366. package/src/routes/request.test.mjs +7 -24
  367. package/src/routes/requestBody.test.mjs +14 -27
  368. package/src/routes/websocket.test.mjs +2 -2
  369. package/src/routes/wellKnownFallback.test.mjs +2 -2
  370. package/src/websocket/devWebSocket.test.mjs +12 -12
  371. package/vite.config.js +13 -1
  372. package/client/feedback/FeedbackMount.jsx +0 -83
  373. package/client/feedback/FeedbackOverlay.jsx +0 -904
  374. package/client/feedback/captureTabScreenshot.js +0 -84
  375. package/client/feedback/copyToClipboard.js +0 -45
  376. package/client/feedback/drawAnnotationsSvg.js +0 -119
  377. package/client/feedback/feedbackStyles.js +0 -304
  378. package/client/feedback/pinResponsiveImages.js +0 -59
  379. package/client/feedback/sendFeedback.js +0 -39
  380. package/client/feedback/useFeedbackToggle.js +0 -70
  381. package/client/recorder/buildEngineRecord.js +0 -37
  382. package/client/recorder/buildInteractionRecord.js +0 -64
  383. package/client/recorder/buildTraceEvent.js +0 -57
  384. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  385. package/client/recorder/chunkRecords.js +0 -69
  386. package/client/recorder/chunkRecords.test.mjs +0 -59
  387. package/client/recorder/collectEventEndpoints.js +0 -40
  388. package/client/recorder/collectEventRequests.js +0 -39
  389. package/client/recorder/createPairingBuffer.js +0 -187
  390. package/client/recorder/createPasswordRedactor.js +0 -84
  391. package/client/recorder/createRecordBatcher.js +0 -54
  392. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  393. package/client/recorder/createRecordingSession.js +0 -61
  394. package/client/recorder/createRecordingSession.test.mjs +0 -72
  395. package/client/recorder/diffStateWrites.js +0 -77
  396. package/client/recorder/diffStateWrites.test.mjs +0 -66
  397. package/client/recorder/isEventCall.js +0 -30
  398. package/client/recorder/jsonType.js +0 -39
  399. package/client/recorder/sendRecords.js +0 -40
  400. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  401. package/lib/docs/checkpointPaths.js +0 -91
  402. package/lib/docs/checkpointStore.js +0 -243
  403. package/lib/docs/checkpointToMocks.js +0 -65
  404. package/lib/docs/configCheckpoints.test.mjs +0 -156
  405. package/lib/docs/createConfigCheckpoint.js +0 -92
  406. package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
  407. package/lib/docs/devMockRegistry.js +0 -68
  408. package/lib/docs/enrichFeedback.js +0 -71
  409. package/lib/docs/evalOperator.js +0 -49
  410. package/lib/docs/evalOperator.test.mjs +0 -157
  411. package/lib/docs/evalOperatorHeadless.js +0 -159
  412. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  413. package/lib/docs/evalOperatorInTab.js +0 -49
  414. package/lib/docs/formatFeedback.js +0 -142
  415. package/lib/docs/formatFeedback.test.mjs +0 -252
  416. package/lib/docs/getPluginDoc.js +0 -53
  417. package/lib/docs/listConfigCheckpoints.js +0 -55
  418. package/lib/docs/loadState.js +0 -220
  419. package/lib/docs/revertConfigCheckpoint.js +0 -73
  420. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  421. package/lib/docs/scaffoldPage.js +0 -77
  422. package/lib/docs/scaffoldPage.test.mjs +0 -97
  423. package/lib/docs/snapshotState.js +0 -67
  424. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  425. package/manager/watchers/listServerSidePackages.mjs +0 -47
  426. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  427. package/src/routes/docs/checkpointsCreate.js +0 -28
  428. package/src/routes/docs/evalOperator.js +0 -70
  429. package/src/routes/docs/inspectState.js +0 -59
  430. package/src/routes/docs/loadState.js +0 -51
  431. package/src/routes/docs/pluginDoc.js +0 -33
  432. package/src/routes/docs/plugins.js +0 -23
  433. package/src/routes/docs/runEndpoint.js +0 -54
  434. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  435. package/src/routes/docs/runRequest.js +0 -53
  436. package/src/routes/docs/runRequest.test.mjs +0 -92
  437. package/src/routes/docs/schema.js +0 -37
  438. package/src/routes/docs/screenshot.js +0 -120
  439. package/src/routes/docs/screenshot.test.mjs +0 -117
  440. package/src/routes/docs/search.js +0 -40
  441. package/src/routes/docs/snapshotState.js +0 -50
  442. package/src/routes/docs/stateCheckpointsList.js +0 -26
  443. package/src/routes/docs/types.js +0 -33
  444. package/src/routes/feedback.js +0 -107
  445. package/src/routes/feedback.test.mjs +0 -204
@@ -1,159 +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 { getBrowser, openPage, buildPageUrl } from './getBrowser.js';
20
- import noBrowserError from './noBrowserError.js';
21
- import resolvePageInstance from './resolvePageInstance.js';
22
- import resolveToolCaller from './resolveToolCaller.js';
23
- import unsettledPageNote from './unsettledPageNote.js';
24
- import withBrowserSlot from './withBrowserSlot.js';
25
- import withDataSession from './withDataSession.js';
26
-
27
- // Evaluates an operator expression against the live client state of a
28
- // headless Chromium tab navigated to the page instance's own route (`pathParams`
29
- // fill a patterned page's placeholders), read under the instance key, using the page's
30
- // own WebParser instance so results match runtime exactly. Mirrors
31
- // Inspector.jsx's evalExpression (the live-tab equivalent).
32
- async function evalOperatorHeadless({
33
- origin,
34
- pageId,
35
- pathParams,
36
- expression,
37
- user,
38
- data,
39
- timeout = 15000,
40
- }) {
41
- if (type.isNone(origin) || !type.isString(origin)) {
42
- return {
43
- error: `evalOperatorHeadless requires an "origin" string. Received ${JSON.stringify(
44
- origin
45
- )}.`,
46
- };
47
- }
48
- if (type.isNone(pageId) || !type.isString(pageId)) {
49
- return {
50
- error: `evalOperatorHeadless requires a "pageId" string. Received ${JSON.stringify(pageId)}.`,
51
- };
52
- }
53
- if (type.isNone(expression)) {
54
- return { error: 'evalOperatorHeadless requires an "expression".' };
55
- }
56
-
57
- const instance = resolvePageInstance({ pageId, pathParams });
58
- if (!type.isUndefined(instance.error)) {
59
- return { error: instance.error, invalidInput: true };
60
- }
61
-
62
- const caller = await resolveToolCaller({ user, data });
63
- if (!type.isUndefined(caller.error)) {
64
- return caller;
65
- }
66
-
67
- return withBrowserSlot({
68
- task: () =>
69
- withDataSession({
70
- dataSet: caller.dataSet,
71
- task: ({ dataCookie }) =>
72
- evalOperatorInBrowser({
73
- origin,
74
- pageId,
75
- pathParams,
76
- instance,
77
- expression,
78
- user: caller.user,
79
- dataCookie,
80
- timeout,
81
- }),
82
- }),
83
- });
84
- }
85
-
86
- // The part of evalOperatorHeadless that runs in the browser, inside a browser slot.
87
- async function evalOperatorInBrowser({
88
- origin,
89
- pageId,
90
- pathParams,
91
- instance,
92
- expression,
93
- user,
94
- dataCookie,
95
- timeout,
96
- }) {
97
- let browser;
98
- try {
99
- browser = await getBrowser();
100
- } catch (error) {
101
- return { error: noBrowserError(error) };
102
- }
103
-
104
- const url = buildPageUrl({ origin, pageId, path: instance.path, pathParams });
105
-
106
- let context;
107
- try {
108
- const opened = await openPage({
109
- browser,
110
- origin,
111
- pageId,
112
- path: instance.path,
113
- pathParams,
114
- user,
115
- dataCookie,
116
- timeout,
117
- });
118
- context = opened.context;
119
- // Passed through as JSON so the page-side parser always receives a plain
120
- // value, matching how it arrives at Inspector.jsx's eval-request handler.
121
- const expressionJson = JSON.stringify(expression);
122
- const result = await opened.page.evaluate(
123
- ({ id, instanceKey, path, exprJson }) => {
124
- const lowdefy = window.lowdefy;
125
- const pageContext = lowdefy?.contexts?.[instanceKey];
126
- if (!pageContext) {
127
- return { error: `No live context for page "${id}" at "/${path}".` };
128
- }
129
- const input = JSON.parse(exprJson);
130
- const { output, errors } = pageContext._internal.parser.parse({
131
- input,
132
- location: 'agent_eval',
133
- });
134
- return {
135
- value: output === undefined ? undefined : JSON.parse(JSON.stringify(output)),
136
- errors: errors.map((error) => error.message),
137
- };
138
- },
139
- {
140
- id: pageId,
141
- instanceKey: instance.instanceKey,
142
- path: instance.path,
143
- exprJson: expressionJson,
144
- }
145
- );
146
- if (!opened.ready) {
147
- return { ...result, ready: false, note: unsettledPageNote({ timeout }) };
148
- }
149
- return result;
150
- } catch (error) {
151
- return { error: `Failed to evaluate operator at "${url}": ${error.message}` };
152
- } finally {
153
- if (context) {
154
- await context.close();
155
- }
156
- }
157
- }
158
-
159
- export default evalOperatorHeadless;
@@ -1,78 +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
- import { jest } from '@jest/globals';
21
-
22
- // A real headless evaluation needs an installed browser, which jest can't
23
- // rely on, so this only covers the error paths: bad input, and
24
- // chromium.launch failing (the "no browser installed" case). Mirrors
25
- // screenshotPage.test.mjs, which exercises the same getBrowser.js singleton.
26
- jest.unstable_mockModule('playwright-core', () => ({
27
- chromium: { launch: jest.fn().mockRejectedValue(new Error("Executable doesn't exist")) },
28
- selectors: { register: jest.fn(async () => {}) },
29
- }));
30
- // A missing shell would otherwise start a real download.
31
- jest.unstable_mockModule('./installHeadlessShell.js', () => ({ default: () => null }));
32
-
33
- // lib/build/config.js reads build/config.json from process.cwd() at import
34
- // time — chdir into a fixture that has one before getBrowser.js (which
35
- // imports it transitively) is loaded. Mirrors the pattern in
36
- // screenshotPage.test.mjs.
37
- const originalCwd = process.cwd();
38
- const fixtureDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-eval-operator-test-'));
39
- fs.mkdirSync(path.join(fixtureDir, 'build'), { recursive: true });
40
- fs.writeFileSync(path.join(fixtureDir, 'build', 'config.json'), JSON.stringify({ basePath: '' }));
41
- fs.writeFileSync(path.join(fixtureDir, 'build', 'routes.json'), JSON.stringify([]));
42
- process.chdir(fixtureDir);
43
-
44
- const { default: evalOperatorHeadless } = await import('./evalOperatorHeadless.js');
45
-
46
- afterAll(() => {
47
- process.chdir(originalCwd);
48
- fs.rmSync(fixtureDir, { recursive: true, force: true });
49
- });
50
-
51
- test('evalOperatorHeadless returns an error when origin is missing', async () => {
52
- const result = await evalOperatorHeadless({ pageId: 'home', expression: { _state: 'x' } });
53
- expect(result.error).toMatch(/requires an "origin" string/);
54
- });
55
-
56
- test('evalOperatorHeadless returns an error when pageId is missing', async () => {
57
- const result = await evalOperatorHeadless({
58
- origin: 'http://localhost:3001',
59
- expression: { _state: 'x' },
60
- });
61
- expect(result.error).toMatch(/requires a "pageId" string/);
62
- });
63
-
64
- test('evalOperatorHeadless returns an error when expression is missing', async () => {
65
- const result = await evalOperatorHeadless({ origin: 'http://localhost:3001', pageId: 'home' });
66
- expect(result.error).toMatch(/requires an "expression"/);
67
- });
68
-
69
- test('evalOperatorHeadless returns an actionable error when no browser is available', async () => {
70
- const result = await evalOperatorHeadless({
71
- origin: 'http://localhost:3001',
72
- pageId: 'home',
73
- expression: { _state: 'x' },
74
- });
75
- expect(result.error).toMatch(
76
- /No Chromium available. Run: npx playwright install chromium-headless-shell/
77
- );
78
- });
@@ -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 { type, serializer } from '@lowdefy/helpers';
18
-
19
- import { requestFromTab } from './tabChannel.js';
20
-
21
- // Evaluates an operator expression against the live client state of a page
22
- // open in a developer's real browser tab (e.g. `{ _state: 'myInput' }`),
23
- // using the page's own WebParser instance so results match runtime exactly.
24
- //
25
- // requestFromTab resolves directly with whatever the tab posted as `result`
26
- // (see tabChannel.js) — `{ value, errors }` on success, or an `{ error }`
27
- // object if no tab is connected, the request timed out, or Inspector.jsx
28
- // itself failed to evaluate the expression.
29
- async function evalOperatorInTab({ pageId, pathParams, expression }) {
30
- if (type.isNone(expression)) {
31
- throw new Error('evalOperatorInTab requires an "expression".');
32
- }
33
- const response = await requestFromTab({
34
- pageId,
35
- pathParams,
36
- event: 'eval-request',
37
- payload: { expression },
38
- });
39
- if (response?.error) {
40
- return { error: response.error };
41
- }
42
- const { value, errors } = response;
43
- return {
44
- value: type.isUndefined(value) ? undefined : serializer.deserializeFromString(value),
45
- errors,
46
- };
47
- }
48
-
49
- export default evalOperatorInTab;
@@ -1,142 +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
- // Turns one or more enriched feedback batches (after enrichFeedback.js has
20
- // attached `annotation.location`) into a single agent-readable text block.
21
- // The overlay copies this text to the developer's clipboard — they paste it
22
- // into their agent session. Kept as a pure string formatter — no
23
- // build-artifact access.
24
- function formatFeedback({ items }) {
25
- if (type.isNone(items) || items.length === 0) {
26
- return 'No pending feedback. The developer has not submitted any annotations yet.';
27
- }
28
- return items.map(formatBatch).join('\n\n---\n\n');
29
- }
30
-
31
- // A page with placeholders in its path names the instance by its values.
32
- function hasPathParams(batch) {
33
- return Object.keys(batch.pathParams ?? {}).length > 0;
34
- }
35
-
36
- function describePage(batch) {
37
- if (!hasPathParams(batch)) {
38
- return `page "${batch.pageId}"`;
39
- }
40
- return `page "${batch.pageId}" with pathParams ${JSON.stringify(batch.pathParams)}`;
41
- }
42
-
43
- function inspectStateCall(batch) {
44
- if (!hasPathParams(batch)) {
45
- return `lowdefy_inspect_state({ pageId: "${batch.pageId}" })`;
46
- }
47
- return `lowdefy_inspect_state({ pageId: "${batch.pageId}", pathParams: ${JSON.stringify(
48
- batch.pathParams
49
- )} })`;
50
- }
51
-
52
- function formatBatch(batch) {
53
- const viewport = batch.viewport ?? {};
54
- const lines = [
55
- `Feedback: ${batch.annotations?.length ?? 0} annotation(s) on ${describePage(batch)} ` +
56
- `(${batch.url ?? 'unknown url'}) — viewport ${viewport.width}x${viewport.height} ` +
57
- `@${viewport.dpr ?? 1}x, scrollY ${viewport.scrollY ?? 0}`,
58
- '',
59
- ];
60
-
61
- (batch.annotations ?? []).forEach((annotation, index) => {
62
- lines.push(formatAnnotation({ annotation, index }));
63
- });
64
-
65
- if (batch.screenshotPath) {
66
- lines.push('');
67
- lines.push(
68
- `Annotated screenshot: ${batch.screenshotPath} (read this image to see the drawings)`
69
- );
70
- }
71
-
72
- lines.push('');
73
- lines.push(`For the page's live state call ${inspectStateCall(batch)}.`);
74
-
75
- return lines.join('\n');
76
- }
77
-
78
- function formatAnnotation({ annotation, index }) {
79
- const lines = [];
80
- const num = index + 1;
81
- const locationText = formatLocation(annotation.location);
82
-
83
- if (annotation.kind === 'element' && annotation.target) {
84
- const header = locationText
85
- ? `${num}. Element "${annotation.target.blockId}" (${locationText})`
86
- : `${num}. Element "${annotation.target.blockId}"`;
87
- lines.push(header);
88
- if (annotation.target.ancestorBlockIds?.length > 0) {
89
- lines.push(` Ancestors: ${annotation.target.ancestorBlockIds.join(' > ')}`);
90
- }
91
- if (annotation.target.tag) {
92
- const text = annotation.target.text ? ` "${annotation.target.text}"` : '';
93
- lines.push(` Tag: ${annotation.target.tag}${text}`);
94
- }
95
- } else {
96
- lines.push(`${num}. Region`);
97
- }
98
-
99
- lines.push(` Comment: ${annotation.comment}`);
100
-
101
- const shapesSummary = summarizeShapes({
102
- shapes: annotation.geometry?.shapes,
103
- hasElementRect: !type.isNone(annotation.geometry?.elementRect),
104
- });
105
- if (shapesSummary) {
106
- lines.push(` Shapes: ${shapesSummary}`);
107
- }
108
-
109
- return lines.join('\n');
110
- }
111
-
112
- function formatLocation(location) {
113
- if (type.isNone(location)) {
114
- return null;
115
- }
116
- if (location.source && location.resolvedVia) {
117
- return `generated at runtime — defined via ancestor "${location.resolvedVia}": ${location.source}`;
118
- }
119
- return location.source ?? location.note ?? null;
120
- }
121
-
122
- // Counts shapes by type (rect/arrow/freehand) preserving first-seen order,
123
- // e.g. "1 rect around the element, 1 arrow" — the first counted type is
124
- // attributed to the targeted element when the annotation carries an
125
- // elementRect, since that is the shape drawn to select it.
126
- function summarizeShapes({ shapes, hasElementRect }) {
127
- if (!shapes || shapes.length === 0) {
128
- return null;
129
- }
130
- const counts = new Map();
131
- shapes.forEach((shape) => {
132
- counts.set(shape.type, (counts.get(shape.type) ?? 0) + 1);
133
- });
134
- return Array.from(counts.entries())
135
- .map(([shapeType, shapeCount], index) => {
136
- const label = `${shapeCount} ${shapeType}${shapeCount > 1 ? 's' : ''}`;
137
- return index === 0 && hasElementRect ? `${label} around the element` : label;
138
- })
139
- .join(', ');
140
- }
141
-
142
- export default formatFeedback;
@@ -1,252 +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 mockFindConfig = jest.fn();
20
- jest.unstable_mockModule('./findConfig.js', () => ({
21
- default: mockFindConfig,
22
- }));
23
-
24
- const { default: enrichFeedback } = await import('./enrichFeedback.js');
25
- const { default: formatFeedback } = await import('./formatFeedback.js');
26
-
27
- beforeEach(() => {
28
- mockFindConfig.mockReset();
29
- });
30
-
31
- // --- enrichFeedback ---
32
-
33
- test('enrichFeedback attaches a location to annotations with a target blockId', async () => {
34
- mockFindConfig.mockResolvedValue({
35
- matches: [
36
- {
37
- keyPath: 'root.pages[0:login].blocks[2:submit_button:Button]',
38
- location: {
39
- source: 'pages/login.yaml:12',
40
- config: 'root.pages[0:login].blocks[2:submit_button:Button]',
41
- },
42
- },
43
- ],
44
- });
45
- const batch = {
46
- pageId: 'login',
47
- annotations: [
48
- {
49
- id: '1',
50
- kind: 'element',
51
- comment: 'too small',
52
- target: {
53
- blockId: 'submit_button',
54
- ancestorBlockIds: ['submit_button', 'login_form'],
55
- tag: 'BUTTON',
56
- text: 'Submit',
57
- },
58
- geometry: { elementRect: { x: 220, y: 480, width: 96, height: 40 }, shapes: [] },
59
- },
60
- ],
61
- };
62
-
63
- const enriched = await enrichFeedback({ batch });
64
-
65
- expect(mockFindConfig).toHaveBeenCalledWith({ id: 'submit_button', pageId: 'login' });
66
- expect(enriched.annotations[0].location).toEqual({
67
- source: 'pages/login.yaml:12',
68
- config: 'root.pages[0:login].blocks[2:submit_button:Button]',
69
- });
70
- });
71
-
72
- test('enrichFeedback attaches a note when findConfig finds no matches', async () => {
73
- mockFindConfig.mockResolvedValue({
74
- matches: [],
75
- note: 'Block is generated at runtime — no configured ancestor found on page "login".',
76
- });
77
- const batch = {
78
- pageId: 'login',
79
- annotations: [{ id: '1', kind: 'element', comment: 'x', target: { blockId: 'missing' } }],
80
- };
81
-
82
- const enriched = await enrichFeedback({ batch });
83
-
84
- expect(enriched.annotations[0].location).toEqual({
85
- note: 'Block is generated at runtime — no configured ancestor found on page "login".',
86
- });
87
- });
88
-
89
- test('enrichFeedback leaves annotations without a target blockId unchanged', async () => {
90
- const batch = {
91
- pageId: 'login',
92
- annotations: [{ id: '1', kind: 'region', comment: 'x', target: null }],
93
- };
94
-
95
- const enriched = await enrichFeedback({ batch });
96
-
97
- expect(mockFindConfig).not.toHaveBeenCalled();
98
- expect(enriched.annotations[0]).toEqual({ id: '1', kind: 'region', comment: 'x', target: null });
99
- });
100
-
101
- test('enrichFeedback still returns the batch when findConfig throws', async () => {
102
- mockFindConfig.mockRejectedValue(new Error('boom'));
103
- const batch = {
104
- pageId: 'login',
105
- annotations: [{ id: '1', kind: 'element', comment: 'x', target: { blockId: 'submit_button' } }],
106
- };
107
-
108
- const enriched = await enrichFeedback({ batch });
109
-
110
- expect(enriched.annotations).toHaveLength(1);
111
- expect(enriched.annotations[0].location.note).toMatch(/Failed to resolve location: boom/);
112
- });
113
-
114
- // --- formatFeedback ---
115
-
116
- test('formatFeedback returns a message when there is no pending feedback', () => {
117
- expect(formatFeedback({ items: [] })).toMatch(/No pending feedback/);
118
- });
119
-
120
- test('formatFeedback formats an element annotation with location, ancestors, comment, shapes, and screenshot', () => {
121
- const items = [
122
- {
123
- pageId: 'login',
124
- url: '/login?x=1',
125
- viewport: { width: 1280, height: 720, scrollX: 0, scrollY: 340, dpr: 2 },
126
- annotations: [
127
- {
128
- id: '1',
129
- kind: 'element',
130
- comment: 'Button is too small on mobile',
131
- target: {
132
- blockId: 'submit_button',
133
- ancestorBlockIds: ['submit_button', 'login_form'],
134
- tag: 'BUTTON',
135
- text: 'Submit',
136
- },
137
- geometry: {
138
- elementRect: { x: 220, y: 480, width: 96, height: 40 },
139
- shapes: [
140
- { type: 'rect', points: [] },
141
- { type: 'arrow', points: [] },
142
- ],
143
- },
144
- location: {
145
- source: 'pages/login.yaml:12',
146
- config: 'root.pages[0:login].blocks[2:submit_button:Button]',
147
- },
148
- },
149
- ],
150
- screenshotPath: '.lowdefy/annotations/login-test.png',
151
- },
152
- ];
153
-
154
- const text = formatFeedback({ items });
155
-
156
- expect(text).toContain('1 annotation(s) on page "login"');
157
- expect(text).toContain('viewport 1280x720 @2x, scrollY 340');
158
- expect(text).toContain('Element "submit_button" (pages/login.yaml:12)');
159
- expect(text).toContain('Ancestors: submit_button > login_form');
160
- expect(text).toContain('Comment: Button is too small on mobile');
161
- expect(text).toContain('1 rect around the element, 1 arrow');
162
- expect(text).toContain('Annotated screenshot: .lowdefy/annotations/login-test.png');
163
- expect(text).toContain('lowdefy_inspect_state({ pageId: "login" })');
164
- expect(text).not.toContain('Console');
165
- });
166
-
167
- test('formatFeedback formats a region annotation without a target', () => {
168
- const items = [
169
- {
170
- pageId: 'home',
171
- url: '/home',
172
- viewport: { width: 1280, height: 720 },
173
- annotations: [
174
- {
175
- id: '1',
176
- kind: 'region',
177
- comment: 'Layout looks off here',
178
- target: null,
179
- geometry: { elementRect: null, shapes: [{ type: 'freehand', points: [] }] },
180
- },
181
- ],
182
- },
183
- ];
184
-
185
- const text = formatFeedback({ items });
186
-
187
- expect(text).toContain('1. Region');
188
- expect(text).toContain('Comment: Layout looks off here');
189
- expect(text).toContain('1 freehand');
190
- });
191
-
192
- test('formatFeedback multiple batches are joined and each keeps its own pageId in instructions', () => {
193
- const items = [
194
- { pageId: 'login', url: '/login', viewport: { width: 100, height: 100 }, annotations: [] },
195
- { pageId: 'home', url: '/home', viewport: { width: 100, height: 100 }, annotations: [] },
196
- ];
197
-
198
- const text = formatFeedback({ items });
199
-
200
- expect(text).toContain('page "login"');
201
- expect(text).toContain('page "home"');
202
- expect(text).toContain('lowdefy_inspect_state({ pageId: "login" })');
203
- expect(text).toContain('lowdefy_inspect_state({ pageId: "home" })');
204
- });
205
-
206
- test('formatFeedback names the page instance by its pathParams', () => {
207
- const text = formatFeedback({
208
- items: [
209
- {
210
- pageId: 'ticket',
211
- pathParams: { space: 's', ticket_id: '1' },
212
- url: '/tickets/s/1',
213
- viewport: { width: 100, height: 100 },
214
- annotations: [],
215
- },
216
- ],
217
- });
218
- expect(text).toContain(
219
- 'Feedback: 0 annotation(s) on page "ticket" with pathParams {"space":"s","ticket_id":"1"} (/tickets/s/1)'
220
- );
221
- expect(text).toContain(
222
- 'lowdefy_inspect_state({ pageId: "ticket", pathParams: {"space":"s","ticket_id":"1"} })'
223
- );
224
- });
225
-
226
- test('formatFeedback leaves empty pathParams out', () => {
227
- const text = formatFeedback({
228
- items: [
229
- {
230
- pageId: 'home',
231
- pathParams: {},
232
- url: '/home',
233
- viewport: { width: 100, height: 100 },
234
- annotations: [],
235
- },
236
- ],
237
- });
238
- expect(text).toContain('Feedback: 0 annotation(s) on page "home" (/home)');
239
- expect(text).toContain('lowdefy_inspect_state({ pageId: "home" })');
240
- });
241
-
242
- test('enrichFeedback keeps the batch pathParams', async () => {
243
- const enriched = await enrichFeedback({
244
- batch: {
245
- pageId: 'ticket',
246
- pathParams: { space: 's', ticket_id: '1' },
247
- urlQuery: '',
248
- annotations: [],
249
- },
250
- });
251
- expect(enriched.pathParams).toEqual({ space: 's', ticket_id: '1' });
252
- });