@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
@@ -17,12 +17,13 @@
17
17
  import { Hono } from 'hono';
18
18
 
19
19
  import localDevToolsOnly from './localDevToolsOnly.js';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  function request({ headers, method = 'POST' }) {
22
23
  const app = new Hono();
23
24
  app.use('/lowdefy-docs/*', localDevToolsOnly());
24
- app.all('/lowdefy-docs/run-endpoint', (c) => c.json({ allowed: true }));
25
- return app.request('/lowdefy-docs/run-endpoint', { headers, method });
25
+ app.all('/lowdefy-docs/journey', (c) => c.json({ allowed: true }));
26
+ return app.request('/lowdefy-docs/journey', { headers, method });
26
27
  }
27
28
 
28
29
  test.each([
@@ -59,3 +60,36 @@ test.each([
59
60
  const res = await request({ headers });
60
61
  expect(res.status).toEqual(403);
61
62
  });
63
+
64
+ test.each([
65
+ ['with no origin', { host: '192.168.1.20:4102', 'x-lowdefy-dev-remote': '1' }],
66
+ [
67
+ 'from its own page',
68
+ {
69
+ host: '192.168.1.20:4102',
70
+ origin: 'http://192.168.1.20:4102',
71
+ 'sec-fetch-site': 'same-origin',
72
+ 'x-lowdefy-dev-remote': '1',
73
+ },
74
+ ],
75
+ ])(
76
+ 'localDevToolsOnly refuses a paired phone (the proxy marked it remote) %s',
77
+ async (_, headers) => {
78
+ const res = await request({ headers });
79
+ expect(res.status).toEqual(403);
80
+ expect((await res.json()).error).toEqual(
81
+ 'The dev tools answer only on the computer running lowdefy dev.'
82
+ );
83
+ }
84
+ );
85
+
86
+ test('localDevToolsOnly lets a paired phone through only where allowPaired says so', async () => {
87
+ const app = new Hono();
88
+ app.use('/api/dev-recording', localDevToolsOnly({ allowPaired: (c) => c.req.method === 'POST' }));
89
+ app.all('/api/dev-recording', (c) => c.json({ allowed: true }));
90
+ const headers = { host: '192.168.1.20:4102', 'x-lowdefy-dev-remote': '1' };
91
+ const posted = await app.request('/api/dev-recording', { headers, method: 'POST' });
92
+ const read = await app.request('/api/dev-recording', { headers, method: 'GET' });
93
+ expect(posted.status).toEqual(200);
94
+ expect(read.status).toEqual(403);
95
+ });
@@ -17,6 +17,7 @@
17
17
  import { Hono } from 'hono';
18
18
 
19
19
  import noStore from './noStore.js';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  function createApp() {
22
23
  const app = new Hono();
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import { Hono } from 'hono';
22
+ import { expect, test } from 'vitest';
22
23
 
23
24
  // The middleware reads build/buildStatus.json from process.cwd() via
24
25
  // readBuildArtifact — point it at a throwaway server directory before import.
@@ -17,6 +17,7 @@
17
17
  import { Hono } from 'hono';
18
18
 
19
19
  import stampCaller from './stampCaller.js';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  function createApp({ user, authSession }) {
22
23
  const app = new Hono();
@@ -0,0 +1,183 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import fs from 'fs';
18
+ import path from 'path';
19
+ import { fileURLToPath } from 'url';
20
+
21
+ import { Hono } from 'hono';
22
+ import { vi, afterAll, beforeEach, expect, test } from 'vitest';
23
+
24
+ // A phone shell (Lowdefy Dev, or a shell paired with `lowdefy dev --lan`) calls /api/agent with
25
+ // its session as a bearer, the x-lowdefy-shell header and no cookie. The route sits behind the
26
+ // same apiContext middleware (createLowdefyContext) as /api/request and /api/endpoints, so the
27
+ // caller is resolved by the one resolver (resolveAuthentication) from the request's own headers,
28
+ // on its general (not MCP) branch. resolveAuthentication's bearer branch itself is covered in
29
+ // @lowdefy/api; this pins that the agent route reaches it and runs as the caller it resolves.
30
+
31
+ const sessions = { 'phone-session-token': { id: 'u-phone', roles: ['member'] } };
32
+
33
+ const mockResolveAuthentication = vi.fn(async (context, { headers }) => {
34
+ const authorization = headers.get('authorization') ?? '';
35
+ const token = authorization.startsWith('Bearer ') ? authorization.slice(7) : null;
36
+ context.user = sessions[token] ?? null;
37
+ });
38
+ const mockCallAgent = vi.fn(async () => ({
39
+ response: new Response('data: {"type":"start"}\n\ndata: [DONE]\n\n'),
40
+ }));
41
+
42
+ vi.doMock('@lowdefy/api', () => ({
43
+ callAgent: mockCallAgent,
44
+ createApiContext: vi.fn(),
45
+ createRequestSignal: vi.fn(({ clientSignal }) => clientSignal),
46
+ ensureMcpOauthResource: vi.fn(async () => {}),
47
+ normalizeInjectedCaller: vi.fn((user) => user),
48
+ parseRequestBody: ({ text }) => JSON.parse(text),
49
+ resolveAuthentication: mockResolveAuthentication,
50
+ resolvePinnedOrganization: vi.fn(async () => {}),
51
+ resolveTenantPreflight: vi.fn(async () => {}),
52
+ }));
53
+ vi.doMock('../../lib/build/appMeta.js', () => ({ default: {} }));
54
+ vi.doMock('../../lib/build/config.js', () => ({ default: {} }));
55
+ vi.doMock('../../lib/build/auth.js', () => ({ default: {} }));
56
+ vi.doMock('../../lib/build/i18n.js', () => ({ default: {} }));
57
+ vi.doMock('../../lib/server/log/createHandleError.js', () => ({
58
+ default: vi.fn(() => vi.fn()),
59
+ }));
60
+ vi.doMock('../../lib/server/log/createLogger.js', () => ({
61
+ default: vi.fn(() => ({
62
+ debug: vi.fn(),
63
+ info: vi.fn(),
64
+ warn: vi.fn(),
65
+ error: vi.fn(),
66
+ })),
67
+ }));
68
+ vi.doMock('../../lib/server/fileCache.js', () => ({ default: {} }));
69
+ vi.doMock('../../lib/server/auth/getAuth.js', () => ({
70
+ default: vi.fn(() => ({ api: {} })),
71
+ }));
72
+ vi.doMock('../../lib/server/auth/getMockUser.js', () => ({
73
+ default: vi.fn(() => undefined),
74
+ }));
75
+ vi.doMock('../../lib/server/auth/getStrategies.js', () => ({
76
+ default: vi.fn(() => null),
77
+ }));
78
+ vi.doMock('../../lib/server/loadDynamicJsMap.js', () => ({
79
+ default: vi.fn(() => ({})),
80
+ }));
81
+ vi.doMock('../../lib/server/log/logRequest.js', () => ({ default: vi.fn() }));
82
+
83
+ // createLowdefyContext statically imports the app build's plugin artifacts, which only exist in a
84
+ // built app (build/** is gitignored). The same fixtures as lib/server/createLowdefyContext.test.mjs.
85
+ const dirname = path.dirname(fileURLToPath(import.meta.url));
86
+ const pluginsDir = path.resolve(dirname, '../../build/plugins');
87
+ const fixtures = [
88
+ 'agents.js',
89
+ 'connections.js',
90
+ 'notifications.js',
91
+ path.join('operators', 'server.js'),
92
+ path.join('operators', 'serverJsMap.js'),
93
+ 'steps.js',
94
+ 'websockets.js',
95
+ ].map((file) => path.join(pluginsDir, file));
96
+
97
+ const createdFixtures = [];
98
+ fixtures.forEach((absolutePath) => {
99
+ if (!fs.existsSync(absolutePath)) {
100
+ fs.mkdirSync(path.dirname(absolutePath), { recursive: true });
101
+ fs.writeFileSync(
102
+ absolutePath,
103
+ 'export default {};\nexport const interpolateProperties = () => {};\nexport const renderEmail = () => {};\n'
104
+ );
105
+ createdFixtures.push(absolutePath);
106
+ }
107
+ });
108
+ fixtures.forEach((absolutePath) => {
109
+ vi.doMock(absolutePath, () => ({
110
+ default: {},
111
+ interpolateProperties: () => {},
112
+ renderEmail: () => {},
113
+ }));
114
+ });
115
+
116
+ afterAll(() => {
117
+ createdFixtures.forEach((absolutePath) => fs.rmSync(absolutePath, { force: true }));
118
+ });
119
+
120
+ const { default: apiContext } = await import('../middleware/apiContext.js');
121
+ const { default: agentHandler } = await import('./agent.js');
122
+
123
+ function createApp() {
124
+ const app = new Hono();
125
+ app.use('/api/*', apiContext());
126
+ app.all('/api/agent/*', agentHandler);
127
+ return app;
128
+ }
129
+
130
+ function postChat(headers) {
131
+ return createApp().request('/api/agent/atlas-chat/atlas?conversationId=c1', {
132
+ method: 'POST',
133
+ headers: { 'content-type': 'application/json', ...headers },
134
+ body: JSON.stringify({ messages: [], sharedState: { now: 'today' } }),
135
+ });
136
+ }
137
+
138
+ beforeEach(() => {
139
+ mockResolveAuthentication.mockClear();
140
+ mockCallAgent.mockClear();
141
+ });
142
+
143
+ test('a shell chat call with a bearer session runs the agent as that caller', async () => {
144
+ const res = await postChat({
145
+ authorization: 'Bearer phone-session-token',
146
+ 'x-lowdefy-shell': 'dev',
147
+ });
148
+ expect(res.status).toEqual(200);
149
+ expect(res.headers.get('content-type')).toEqual('text/event-stream');
150
+ expect(await res.text()).toEqual('data: {"type":"start"}\n\ndata: [DONE]\n\n');
151
+ expect(mockCallAgent).toHaveBeenCalledTimes(1);
152
+ const [context, params] = mockCallAgent.mock.calls[0];
153
+ expect(context.user).toEqual({ id: 'u-phone', roles: ['member'] });
154
+ expect(params.agentId).toEqual('atlas');
155
+ expect(params.pageId).toEqual('atlas-chat');
156
+ expect(params.conversationId).toEqual('c1');
157
+ });
158
+
159
+ test('a paired phone chat call with a bearer session runs the agent as that caller', async () => {
160
+ // The --lan proxy marks a caller from another machine; it is never a headless one.
161
+ await postChat({
162
+ authorization: 'Bearer phone-session-token',
163
+ 'x-lowdefy-shell': 'dev',
164
+ 'x-lowdefy-dev-remote': '1',
165
+ });
166
+ const [context] = mockCallAgent.mock.calls[0];
167
+ expect(context.user).toEqual({ id: 'u-phone', roles: ['member'] });
168
+ });
169
+
170
+ test('the agent route resolves its caller through the general branch from the raw headers', async () => {
171
+ await postChat({ authorization: 'Bearer phone-session-token', 'x-lowdefy-shell': 'dev' });
172
+ expect(mockResolveAuthentication).toHaveBeenCalledTimes(1);
173
+ const [, options] = mockResolveAuthentication.mock.calls[0];
174
+ expect(options.mcp).toBe(false);
175
+ expect(options.headers.get('authorization')).toEqual('Bearer phone-session-token');
176
+ expect(options.headers.get('cookie')).toBeNull();
177
+ });
178
+
179
+ test('a shell chat call with an unknown bearer runs the agent signed out', async () => {
180
+ await postChat({ authorization: 'Bearer ended-session', 'x-lowdefy-shell': 'dev' });
181
+ const [context] = mockCallAgent.mock.calls[0];
182
+ expect(context.user).toBeNull();
183
+ });
@@ -14,19 +14,19 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, expect, test } from 'vitest';
18
18
 
19
- const handleAuthRequest = jest.fn(async () => new Response('engine'));
20
- const getAuth = jest.fn(() => ({}));
19
+ const handleAuthRequest = vi.fn(async () => new Response('engine'));
20
+ const getAuth = vi.fn(() => ({}));
21
21
 
22
- jest.unstable_mockModule('@lowdefy/api', () => ({ handleAuthRequest }));
23
- jest.unstable_mockModule('../../lib/build/auth.js', () => ({ default: { configured: true } }));
24
- jest.unstable_mockModule('../../lib/server/auth/getAuth.js', () => ({ default: getAuth }));
25
- jest.unstable_mockModule('../../lib/server/auth/getMockUser.js', () => ({
26
- default: jest.fn(() => undefined),
22
+ vi.doMock('@lowdefy/api', () => ({ handleAuthRequest }));
23
+ vi.doMock('../../lib/build/auth.js', () => ({ default: { configured: true } }));
24
+ vi.doMock('../../lib/server/auth/getAuth.js', () => ({ default: getAuth }));
25
+ vi.doMock('../../lib/server/auth/getMockUser.js', () => ({
26
+ default: vi.fn(() => undefined),
27
27
  }));
28
- jest.unstable_mockModule('../../lib/server/getClientAddress.js', () => ({
29
- default: jest.fn(() => '127.0.0.1'),
28
+ vi.doMock('../../lib/server/getClientAddress.js', () => ({
29
+ default: vi.fn(() => '127.0.0.1'),
30
30
  }));
31
31
 
32
32
  const { default: authMiddleware } = await import('./auth.js');
@@ -15,12 +15,17 @@
15
15
  */
16
16
 
17
17
  import { logClientError, parseRequestBody } from '@lowdefy/api';
18
+ import { serializer } from '@lowdefy/helpers';
18
19
 
19
20
  import clientErrorStore from '../../lib/docs/clientErrorStore.js';
20
21
  import errorRecordingStamp from '../../lib/server/recording/errorRecordingStamp.js';
22
+ import getRequestSurface from '../lib/getRequestSurface.js';
21
23
  import createSameOriginGuard from '../middleware/createSameOriginGuard.js';
22
24
 
23
- const guardSameOrigin = createSameOriginGuard();
25
+ // No Origin is allowed in dev: a phone shell (a simulator, a USB phone through
26
+ // adb reverse, or a phone the proxy let in with the pairing token) sends none.
27
+ // A browser on another site always sends one, so it is still refused.
28
+ const guardSameOrigin = createSameOriginGuard({ allowNoOrigin: true });
24
29
 
25
30
  async function clientErrorHandler(c) {
26
31
  if (c.req.method !== 'POST') {
@@ -41,13 +46,25 @@ async function clientErrorHandler(c) {
41
46
 
42
47
  // Feed the agent-facing feedback loop (GET /lowdefy-docs/build-status) with a
43
48
  // serializable summary — not the full error object, which may carry
44
- // non-serializable `received` values.
49
+ // non-serializable `received` values. `surface` tells a phone shell's errors
50
+ // ('mobile', with its shell version) from a browser's ('web').
51
+ // When plugin-schema validation explained the error, the terminal logs that
52
+ // ConfigError ("property title must be type string") instead of the original
53
+ // ("Error rendering block"), and the agent must see the same one.
54
+ const surface = getRequestSurface(c);
55
+ const shown = response.configError ? serializer.deserialize(response.configError) : error;
45
56
  clientErrorStore.push({
46
57
  timestamp: new Date().toISOString(),
47
- name: error?.name ?? 'Error',
48
- message: error?.message ?? null,
58
+ name: shown?.name ?? 'Error',
59
+ message: shown?.message ?? null,
49
60
  source: response.source ?? null,
50
61
  config: response.config ?? null,
62
+ hint: shown?.hint ?? null,
63
+ configKey: error?.configKey ?? null,
64
+ pageId: error?.pageId ?? null,
65
+ blockId: error?.blockId ?? null,
66
+ surface,
67
+ ...(surface === 'mobile' ? { shell: c.req.header('x-lowdefy-shell') } : {}),
51
68
  recording: errorRecordingStamp(context.recording),
52
69
  });
53
70
 
@@ -0,0 +1,127 @@
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 { Hono } from 'hono';
18
+ import { vi, beforeEach, expect, test } from 'vitest';
19
+
20
+ const mockLogClientError = vi.fn();
21
+ const mockPush = vi.fn();
22
+
23
+ // The same-origin rule is the real one from @lowdefy/api; only the logging is mocked.
24
+ const api = await import('@lowdefy/api');
25
+ vi.doMock('@lowdefy/api', () => ({
26
+ ...api,
27
+ logClientError: mockLogClientError,
28
+ }));
29
+ vi.doMock('../../lib/docs/clientErrorStore.js', () => ({
30
+ default: { push: mockPush },
31
+ }));
32
+
33
+ const { default: clientErrorHandler } = await import('./clientError.js');
34
+
35
+ function post(headers) {
36
+ const app = new Hono();
37
+ app.use('*', async (c, next) => {
38
+ c.set('lowdefyContext', { recording: null });
39
+ await next();
40
+ });
41
+ app.all('/api/client-error', clientErrorHandler);
42
+ return app.request('/api/client-error', {
43
+ method: 'POST',
44
+ headers: { 'content-type': 'application/json', ...headers },
45
+ body: JSON.stringify({ error: { message: 'Block failed' } }),
46
+ });
47
+ }
48
+
49
+ beforeEach(() => {
50
+ mockLogClientError.mockResolvedValue({
51
+ error: { name: 'BlockError', message: 'Block failed' },
52
+ source: 'pages/home.yaml:12',
53
+ });
54
+ });
55
+
56
+ test('clientError accepts an error from a phone paired with lowdefy dev --lan', async () => {
57
+ const res = await post({ host: '192.168.1.20:3000', 'x-lowdefy-dev-remote': '1' });
58
+ expect(res.status).toEqual(200);
59
+ expect(mockPush).toHaveBeenCalledWith(
60
+ expect.objectContaining({ name: 'BlockError', source: 'pages/home.yaml:12' })
61
+ );
62
+ });
63
+
64
+ test('clientError accepts an error from a simulator shell, which sends no origin', async () => {
65
+ const res = await post({ host: 'localhost:3000' });
66
+ expect(res.status).toEqual(200);
67
+ });
68
+
69
+ test('clientError accepts an error from the app page itself', async () => {
70
+ const res = await post({
71
+ host: 'localhost:3000',
72
+ origin: 'http://localhost:3000',
73
+ 'sec-fetch-site': 'same-origin',
74
+ });
75
+ expect(res.status).toEqual(200);
76
+ });
77
+
78
+ test('clientError refuses an error a page on another site posts', async () => {
79
+ const res = await post({
80
+ host: 'localhost:3000',
81
+ origin: 'https://attacker.example',
82
+ 'sec-fetch-site': 'cross-site',
83
+ });
84
+ expect(res.status).toEqual(403);
85
+ expect(mockPush).not.toHaveBeenCalled();
86
+ });
87
+
88
+ test('clientError marks a phone shell error as mobile with its shell version', async () => {
89
+ const res = await post({ host: 'localhost:3000', 'x-lowdefy-shell': '7.1.0' });
90
+ expect(res.status).toEqual(200);
91
+ expect(mockPush).toHaveBeenCalledWith(
92
+ expect.objectContaining({ name: 'BlockError', surface: 'mobile', shell: '7.1.0' })
93
+ );
94
+ });
95
+
96
+ test('clientError marks a browser error as web', async () => {
97
+ await post({
98
+ host: 'localhost:3000',
99
+ origin: 'http://localhost:3000',
100
+ 'sec-fetch-site': 'same-origin',
101
+ });
102
+ const [entry] = mockPush.mock.calls.at(-1);
103
+ expect(entry.surface).toEqual('web');
104
+ expect(entry).not.toHaveProperty('shell');
105
+ });
106
+
107
+ test('clientError feeds the agent the schema ConfigError that explains a client error', async () => {
108
+ const { serializer } = await import('@lowdefy/helpers');
109
+ const { ConfigError } = await import('@lowdefy/errors');
110
+ const configError = new ConfigError('Block "Button" property "title" must be type "string".');
111
+ configError.hint = 'Set title to a string.';
112
+ mockLogClientError.mockResolvedValueOnce({
113
+ error: { name: 'BlockError', message: 'Block failed', configKey: 'k1', blockId: 'submit' },
114
+ source: 'pages/home.yaml:12',
115
+ configError: serializer.serialize(configError),
116
+ });
117
+ await post({ host: 'localhost:3000' });
118
+ const [entry] = mockPush.mock.calls.at(-1);
119
+ expect(entry).toMatchObject({
120
+ name: 'ConfigError',
121
+ message: 'Block "Button" property "title" must be type "string".',
122
+ hint: 'Set title to a string.',
123
+ configKey: 'k1',
124
+ blockId: 'submit',
125
+ source: 'pages/home.yaml:12',
126
+ });
127
+ });
@@ -15,54 +15,12 @@
15
15
  */
16
16
 
17
17
  import { parseRequestBody } from '@lowdefy/api';
18
- import { serializer, type } from '@lowdefy/helpers';
18
+ import { type } from '@lowdefy/helpers';
19
19
 
20
- import { readCheckpoint } from '../../lib/docs/checkpointStore.js';
21
- import { loadMocks } from '../../lib/docs/devMockRegistry.js';
22
20
  import getPathSegments from '../lib/getPathSegments.js';
21
+ import isTabChannelCaller from '../lib/isTabChannelCaller.js';
23
22
  import { listTabs, resolveTabRequest, updateTabPage } from '../../lib/docs/tabChannel.js';
24
23
 
25
- // Origin/host check mirrors clientError.js — this endpoint accepts a POST
26
- // from Inspector.jsx (a same-origin dev-only browser component), not from
27
- // arbitrary agents, so it needs the same CSRF-style guard.
28
- function checkOrigin(c) {
29
- const origin = c.req.header('origin');
30
- if (!origin) {
31
- return false;
32
- }
33
- try {
34
- return new URL(origin).host === c.req.header('host');
35
- } catch {
36
- return false;
37
- }
38
- }
39
-
40
- // Dev-only agent-state-xray: a human tab bootstrapping from a
41
- // `?_checkpoint=<name>` URL (client/Inspector.jsx) fetches this. It returns
42
- // the checkpoint's state part + manifest for the tab to inject client-side,
43
- // and — as a side effect — loads the checkpoint's recorded requests into
44
- // devMockRegistry server-side, so that tab's own requests (src/routes/
45
- // request.js) replay recorded data instead of hitting real connections.
46
- function handleCheckpointBootstrap(c, { name }) {
47
- let checkpoint;
48
- try {
49
- checkpoint = readCheckpoint({ name });
50
- } catch (error) {
51
- return c.json({ error: error.message }, 404);
52
- }
53
- loadMocks({ pageId: checkpoint.checkpoint.pageId, mocks: checkpoint.requests });
54
- return c.json(
55
- serializer.serialize({
56
- checkpoint: checkpoint.checkpoint,
57
- state: checkpoint.state,
58
- urlQuery: checkpoint.urlQuery,
59
- input: checkpoint.input,
60
- user: checkpoint.user,
61
- global: checkpoint.global,
62
- })
63
- );
64
- }
65
-
66
24
  // Inspector.jsx posts { tabId, pageId, pathParams, instanceKey } here whenever
67
25
  // the page instance on screen in its tab changes, so the tab registry
68
26
  // (lib/docs/tabChannel.js) knows which instance each connected tab shows, and
@@ -81,17 +39,12 @@ async function handleTabPage(c) {
81
39
  return c.json({ ok: true });
82
40
  }
83
41
 
84
- // GET lists connected tabs for diagnostics (or, under /checkpoint/<name>,
85
- // bootstraps a human tab from a state checkpoint); POST /page updates the
42
+ // GET lists connected tabs for diagnostics; POST /page updates the
86
43
  // page a connected tab is on; POST at the root is the answer leg of the SSE
87
44
  // request/response round trip (Inspector.jsx posts back {requestId, result}
88
45
  // after handling an inspect-request/eval-request event).
89
46
  async function devInspectHandler(c) {
90
47
  if (c.req.method === 'GET') {
91
- const segments = getPathSegments(c, '/api/dev-inspect/');
92
- if (segments[0] === 'checkpoint' && segments[1]) {
93
- return handleCheckpointBootstrap(c, { name: segments[1] });
94
- }
95
48
  return c.json({ tabs: listTabs() });
96
49
  }
97
50
 
@@ -101,7 +54,9 @@ async function devInspectHandler(c) {
101
54
  return c.json({ error: 'Method not allowed.' }, 405);
102
55
  }
103
56
 
104
- if (!checkOrigin(c)) {
57
+ // Only a dev tab answers: a browser tab's Inspector.jsx, or a phone shell's
58
+ // dev-tab client (@lowdefy/shell src/dev). Not a page on another site.
59
+ if (!isTabChannelCaller(c)) {
105
60
  return c.json({ error: 'Forbidden' }, 403);
106
61
  }
107
62