@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -20,6 +20,8 @@ import net from 'node:net';
20
20
  import { devPassiveHeader } from '@lowdefy/node-utils';
21
21
 
22
22
  import buildWaitHeader from '../../lib/docs/buildWaitHeader.js';
23
+ import { pairHeader, remoteCallerHeader } from '../../lib/server/pairingHeaders.js';
24
+ import checkPairing from '../utils/checkPairing.mjs';
23
25
  import readBuildStatusWait from '../utils/readBuildStatusWait.mjs';
24
26
 
25
27
  /*
@@ -50,6 +52,22 @@ until then it still answers the probe. A GET or HEAD that never reached the
50
52
  child (a refused connect, or a keep-alive socket the dying child had closed)
51
53
  is replayed through the hold rather than answered 502: a child can close its
52
54
  sockets before the manager sees it exit.
55
+
56
+ Any other request that loses the child answers 502, and is never replayed: it
57
+ may already have run. A live child does not cause this, since it leaves idle
58
+ connections open for this proxy's agent to close (keepIdleConnectionsOpen).
59
+ What the proxy answers itself, because the child could not, says so in
60
+ x-lowdefy-child, and a journey reports it as a dev server failure rather than
61
+ an app error (evaluateInvariants).
62
+
63
+ A child stopped for being idle (createIdleChild) is started again only by a
64
+ request that is use (isActivity), which is held as for a restart. A request
65
+ that is not use - a passive read, an event-stream GET, a websocket upgrade -
66
+ is answered 503 at once with Retry-After, so status checks and reconnecting
67
+ streams neither wake the child nor wait out the hold.
68
+
69
+ The proxy also counts the tabs holding a reload stream open, from the
70
+ stream's response start until it closes: an open tab keeps the child up.
53
71
  */
54
72
 
55
73
  const RETRY_MS = 250;
@@ -69,10 +87,16 @@ function probeChild(port) {
69
87
  });
70
88
  }
71
89
 
72
- async function waitForChild({ port, deadline }) {
90
+ function isChildStopped(context) {
91
+ return context.idleChild?.isStopped() === true;
92
+ }
93
+
94
+ // givesUp ends the wait early: a request that does not wake the child stops
95
+ // waiting once the child is idle-stopped.
96
+ async function waitForChild({ port, deadline, givesUp = () => false }) {
73
97
  for (;;) {
74
98
  if (await probeChild(port)) return true;
75
- if (Date.now() > deadline) return false;
99
+ if (Date.now() > deadline || givesUp()) return false;
76
100
  await new Promise((resolve) => setTimeout(resolve, RETRY_MS));
77
101
  }
78
102
  }
@@ -94,13 +118,17 @@ function waitUntil({ promise, deadline }) {
94
118
  ]);
95
119
  }
96
120
 
97
- async function waitForConfirmedChild({ context, proxyState, deadline }) {
121
+ async function waitForConfirmedChild({ context, proxyState, deadline, wakes }) {
98
122
  if (isConfirmedChild({ context, proxyState })) {
99
123
  return true;
100
124
  }
101
125
  await waitUntil({ promise: context.devServerExited, deadline });
102
126
  const child = context.devServer;
103
- const up = await waitForChild({ port: context.internalPort, deadline });
127
+ const up = await waitForChild({
128
+ port: context.internalPort,
129
+ deadline,
130
+ givesUp: () => !wakes && isChildStopped(context),
131
+ });
104
132
  if (up) {
105
133
  proxyState.confirmedChild = child;
106
134
  }
@@ -109,6 +137,25 @@ async function waitForConfirmedChild({ context, proxyState, deadline }) {
109
137
 
110
138
  const REPLAYABLE_METHODS = ['GET', 'HEAD'];
111
139
 
140
+ const IDLE_RETRY_AFTER_S = 5;
141
+
142
+ function answerIdle(res) {
143
+ res.writeHead(503, {
144
+ 'content-type': 'application/json',
145
+ 'retry-after': String(IDLE_RETRY_AFTER_S),
146
+ 'x-lowdefy-child': 'stopped',
147
+ });
148
+ res.end(JSON.stringify({ message: 'Lowdefy dev server is idle.' }));
149
+ }
150
+
151
+ function isReloadStream({ context, req }) {
152
+ if (req.method !== 'GET') {
153
+ return false;
154
+ }
155
+ const { pathname } = new URL(req.url, 'http://localhost');
156
+ return pathname === `${context.basePath ?? ''}/api/reload`;
157
+ }
158
+
112
159
  // Nothing reached the child: the connect was refused, or the keep-alive socket
113
160
  // the agent reused had already been closed by a child that is going away.
114
161
  function isUnsentError({ error, proxyReq }) {
@@ -117,19 +164,28 @@ function isUnsentError({ error, proxyReq }) {
117
164
  );
118
165
  }
119
166
 
120
- function forwardRequest({ body, context, proxyState }, req, res, deadline = Date.now() + HOLD_MS) {
167
+ function forwardRequest(
168
+ { body, context, proxyState, wakes },
169
+ req,
170
+ res,
171
+ deadline = Date.now() + HOLD_MS
172
+ ) {
121
173
  // Wait for a live child BEFORE piping the request body — the body stream can
122
174
  // only be consumed once, so retrying after a failed proxy request would need
123
175
  // full-body buffering. Only a bodiless GET or HEAD that never reached the
124
176
  // child is replayed; any other request that loses the child mid-forward
125
177
  // surfaces as one 502, which the client's next attempt resolves through the
126
178
  // hold.
127
- waitForConfirmedChild({ context, proxyState, deadline }).then((up) => {
179
+ waitForConfirmedChild({ context, proxyState, deadline, wakes }).then((up) => {
128
180
  // The response, not the request: an incoming request reads as destroyed
129
181
  // once its body has been read, which a replayed GET's has.
130
182
  if (res.destroyed) return;
183
+ if (!up && !wakes && isChildStopped(context)) {
184
+ answerIdle(res);
185
+ return;
186
+ }
131
187
  if (!up) {
132
- res.writeHead(503, { 'content-type': 'application/json' });
188
+ res.writeHead(503, { 'content-type': 'application/json', 'x-lowdefy-child': 'restarting' });
133
189
  res.end(JSON.stringify({ message: 'Lowdefy dev server is restarting.' }));
134
190
  return;
135
191
  }
@@ -141,6 +197,9 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
141
197
  headers: req.headers,
142
198
  });
143
199
  proxyReq.on('response', (proxyRes) => {
200
+ if (proxyRes.statusCode === 200 && isReloadStream({ context, req })) {
201
+ context.requestActivity.trackTab(res);
202
+ }
144
203
  res.writeHead(proxyRes.statusCode, proxyRes.headers);
145
204
  // flushHeaders so SSE endpoints (reload stream, MCP notifications)
146
205
  // reach the client before the first event.
@@ -154,14 +213,14 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
154
213
  REPLAYABLE_METHODS.includes(req.method) &&
155
214
  isUnsentError({ error, proxyReq })
156
215
  ) {
157
- forwardRequest({ body, context, proxyState }, req, res, deadline);
216
+ forwardRequest({ body, context, proxyState, wakes }, req, res, deadline);
158
217
  return;
159
218
  }
160
219
  if (res.headersSent) {
161
220
  res.destroy();
162
221
  return;
163
222
  }
164
- res.writeHead(502, { 'content-type': 'application/json' });
223
+ res.writeHead(502, { 'content-type': 'application/json', 'x-lowdefy-child': 'dropped' });
165
224
  res.end(JSON.stringify({ message: 'Lowdefy dev server connection dropped.' }));
166
225
  });
167
226
  // A body read to recognise a build-status wait is sent as read. A
@@ -203,9 +262,42 @@ function isActivity(req) {
203
262
  // latest edits, restarts included, and only then forwarded: a restart ends
204
263
  // the dev server process, and any wait running in it. The header tells the
205
264
  // dev server what this wait saw, so it does not wait again.
265
+ // The pairing gate sits here, in front of Vite and the app alike, because the
266
+ // child only ever sees the proxy's loopback address. The child learns that a
267
+ // caller is remote from remoteCallerHeader, which only the proxy sets.
268
+ function readAccess({ context, req }) {
269
+ return checkPairing({
270
+ remoteAddress: req.socket.remoteAddress,
271
+ pairToken: context.lan?.token,
272
+ providedToken: req.headers[pairHeader],
273
+ });
274
+ }
275
+
276
+ const PAIRING_REFUSAL =
277
+ 'This dev server answers other machines only with the pairing token that `lowdefy dev --lan` prints.';
278
+
206
279
  async function handleRequest({ context, proxyState }, req, res) {
207
- if (isActivity(req)) {
280
+ const access = readAccess({ context, req });
281
+ if (access === 'refused') {
282
+ res.writeHead(401, { 'content-type': 'application/json' });
283
+ res.end(JSON.stringify({ message: PAIRING_REFUSAL }));
284
+ return;
285
+ }
286
+ delete req.headers[pairHeader];
287
+ delete req.headers[remoteCallerHeader];
288
+ if (access === 'paired') {
289
+ req.headers[remoteCallerHeader] = '1';
290
+ }
291
+ const wakes = isActivity(req);
292
+ if (!wakes && isChildStopped(context)) {
293
+ answerIdle(res);
294
+ return;
295
+ }
296
+ if (wakes) {
208
297
  context.requestActivity.trackResponse(res);
298
+ if (isChildStopped(context)) {
299
+ context.idleChild.wake().catch((error) => context.logger.error(error));
300
+ }
209
301
  }
210
302
  delete req.headers[buildWaitHeader];
211
303
  const { wait, body } = await readBuildStatusWait({ basePath: context.basePath, req });
@@ -217,12 +309,39 @@ async function handleRequest({ context, proxyState }, req, res) {
217
309
  waitedMs: String(waited.waitedMs),
218
310
  }).toString();
219
311
  }
220
- forwardRequest({ body, context, proxyState }, req, res);
312
+ forwardRequest({ body, context, proxyState, wakes }, req, res);
221
313
  }
222
314
 
315
+ const IDLE_UPGRADE_RESPONSE = [
316
+ 'HTTP/1.1 503 Service Unavailable',
317
+ `retry-after: ${IDLE_RETRY_AFTER_S}`,
318
+ 'x-lowdefy-child: stopped',
319
+ 'connection: close',
320
+ '',
321
+ '',
322
+ ].join('\r\n');
323
+
324
+ // An upgrade is never use (see isActivity), so it never wakes an idle-stopped child.
223
325
  function forwardUpgrade(context, req, socket, head) {
224
- waitForChild({ port: context.internalPort, deadline: Date.now() + HOLD_MS }).then((up) => {
326
+ const access = readAccess({ context, req });
327
+ if (access === 'refused') {
328
+ socket.end('HTTP/1.1 401 Unauthorized\r\nconnection: close\r\n\r\n');
329
+ return;
330
+ }
331
+ if (isChildStopped(context)) {
332
+ socket.end(IDLE_UPGRADE_RESPONSE);
333
+ return;
334
+ }
335
+ waitForChild({
336
+ port: context.internalPort,
337
+ deadline: Date.now() + HOLD_MS,
338
+ givesUp: () => isChildStopped(context),
339
+ }).then((up) => {
225
340
  if (socket.destroyed) return;
341
+ if (!up && isChildStopped(context)) {
342
+ socket.end(IDLE_UPGRADE_RESPONSE);
343
+ return;
344
+ }
226
345
  if (!up) {
227
346
  socket.end('HTTP/1.1 503 Service Unavailable\r\nconnection: close\r\n\r\n');
228
347
  return;
@@ -233,7 +352,13 @@ function forwardUpgrade(context, req, socket, head) {
233
352
  // websockets both pass through untouched.
234
353
  const lines = [`${req.method} ${req.url} HTTP/1.1`];
235
354
  for (let i = 0; i < req.rawHeaders.length; i += 2) {
236
- lines.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);
355
+ const name = req.rawHeaders[i].toLowerCase();
356
+ if (name !== pairHeader && name !== remoteCallerHeader) {
357
+ lines.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);
358
+ }
359
+ }
360
+ if (access === 'paired') {
361
+ lines.push(`${remoteCallerHeader}: 1`);
237
362
  }
238
363
  upstream.write(lines.join('\r\n') + '\r\n\r\n');
239
364
  if (head?.length) upstream.write(head);
@@ -247,9 +372,17 @@ function forwardUpgrade(context, req, socket, head) {
247
372
  });
248
373
  }
249
374
 
250
- function startProxy(context) {
251
- if (context.proxyServer) return Promise.resolve();
252
- const proxyState = { confirmedChild: null };
375
+ function listen({ server, port, host }) {
376
+ return new Promise((resolve, reject) => {
377
+ server.once('error', reject);
378
+ server.listen(port, host, () => {
379
+ server.removeListener('error', reject);
380
+ resolve();
381
+ });
382
+ });
383
+ }
384
+
385
+ function createProxyServer({ context, proxyState }) {
253
386
  const proxy = http.createServer((req, res) => {
254
387
  // A client that drops an MCP request while its body is read.
255
388
  handleRequest({ context, proxyState }, req, res).catch(() => res.destroy());
@@ -259,19 +392,24 @@ function startProxy(context) {
259
392
  // request timeout; keep the proxy transparent.
260
393
  proxy.requestTimeout = 0;
261
394
  proxy.headersTimeout = 60000;
262
- context.proxyServer = proxy;
263
- return new Promise((resolve, reject) => {
264
- proxy.once('error', reject);
265
- // 'localhost' for parity with the Vite default host the child used to bind
266
- // — the dev server stays loopback-only, not exposed on the LAN.
267
- proxy.listen(context.options.port, 'localhost', () => {
268
- proxy.removeListener('error', reject);
269
- context.logger.debug(
270
- `Proxy listening on port ${context.options.port}, forwarding to ${context.internalPort}.`
271
- );
272
- resolve();
273
- });
274
- });
395
+ return proxy;
396
+ }
397
+
398
+ async function startProxy(context) {
399
+ if (context.proxyServer) return;
400
+ const proxyState = { confirmedChild: null };
401
+ const { port } = context.options;
402
+ context.proxyServer = createProxyServer({ context, proxyState });
403
+ // 'localhost' for parity with the Vite default host the child used to bind
404
+ // - the dev server stays loopback-only unless --lan asks for the network.
405
+ await listen({ server: context.proxyServer, port, host: 'localhost' });
406
+ // --lan adds a listener on the chosen interface's address only, not on every
407
+ // interface, so a VPN or Docker network does not reach the server too.
408
+ if (context.lan) {
409
+ context.lanProxyServer = createProxyServer({ context, proxyState });
410
+ await listen({ server: context.lanProxyServer, port, host: context.lan.address });
411
+ }
412
+ context.logger.debug(`Proxy listening on port ${port}, forwarding to ${context.internalPort}.`);
275
413
  }
276
414
 
277
415
  export default startProxy;
@@ -0,0 +1,204 @@
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 dns from 'node:dns';
18
+ import http from 'node:http';
19
+ import net from 'node:net';
20
+
21
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
22
+
23
+ // Every test request comes from this computer. Mocking the loopback check
24
+ // makes the proxy treat it as a request from a phone on the network.
25
+ const mockIsLoopbackAddress = vi.fn();
26
+ vi.doMock('../utils/isLoopbackAddress.mjs', () => ({
27
+ default: mockIsLoopbackAddress,
28
+ }));
29
+
30
+ const { default: startProxy } = await import('./startProxy.mjs');
31
+ const { default: createBuildActivity } = await import('../utils/createBuildActivity.mjs');
32
+ const { default: createRequestActivity } = await import('../utils/createRequestActivity.mjs');
33
+
34
+ const TOKEN = 'a'.repeat(43);
35
+
36
+ function listen(server) {
37
+ return new Promise((resolve) => {
38
+ server.listen(0, '127.0.0.1', () => resolve(server.address().port));
39
+ });
40
+ }
41
+
42
+ function close(server) {
43
+ return new Promise((resolve) => {
44
+ server.closeAllConnections?.();
45
+ server.close(() => resolve());
46
+ });
47
+ }
48
+
49
+ function getFreePort() {
50
+ return new Promise((resolve) => {
51
+ const server = net.createServer();
52
+ server.listen(0, '127.0.0.1', () => {
53
+ const { port } = server.address();
54
+ server.close(() => resolve(port));
55
+ });
56
+ });
57
+ }
58
+
59
+ // The loopback address 'localhost' does not bind, so the LAN listener can
60
+ // share the port in a test.
61
+ async function getOtherLoopbackAddress() {
62
+ const { address } = await dns.promises.lookup('localhost');
63
+ return address === '::1' ? '127.0.0.1' : '::1';
64
+ }
65
+
66
+ let child;
67
+ let context;
68
+ let seen;
69
+
70
+ beforeEach(() => {
71
+ mockIsLoopbackAddress.mockReturnValue(true);
72
+ });
73
+
74
+ afterEach(async () => {
75
+ if (context?.proxyServer) await close(context.proxyServer);
76
+ if (context?.lanProxyServer) await close(context.lanProxyServer);
77
+ if (child) await close(child);
78
+ child = undefined;
79
+ context = undefined;
80
+ });
81
+
82
+ async function startChildAndProxy({ lan } = {}) {
83
+ seen = [];
84
+ child = http.createServer((req, res) => {
85
+ seen.push(req.headers);
86
+ res.end('ok');
87
+ });
88
+ child.on('upgrade', (req, socket) => {
89
+ seen.push(req.headers);
90
+ socket.write(
91
+ 'HTTP/1.1 101 Switching Protocols\r\nupgrade: websocket\r\nconnection: upgrade\r\n\r\n'
92
+ );
93
+ socket.destroy();
94
+ });
95
+ const internalPort = await listen(child);
96
+ context = {
97
+ basePath: '',
98
+ buildActivity: createBuildActivity({ onChange: () => {} }),
99
+ internalPort,
100
+ lan,
101
+ logger: { debug: vi.fn() },
102
+ options: { port: await getFreePort() },
103
+ requestActivity: createRequestActivity({ onChange: () => {}, throttleMs: 0 }),
104
+ };
105
+ await startProxy(context);
106
+ return context.options.port;
107
+ }
108
+
109
+ test('startProxy lets a request from this computer through without a pairing token', async () => {
110
+ const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
111
+ const response = await fetch(`http://localhost:${port}/api/ping`);
112
+ expect(response.status).toBe(200);
113
+ expect(seen[0]['x-lowdefy-dev-remote']).toBeUndefined();
114
+ });
115
+
116
+ test('startProxy strips a remote marker a local caller sends itself', async () => {
117
+ const port = await startChildAndProxy();
118
+ await fetch(`http://localhost:${port}/api/ping`, { headers: { 'x-lowdefy-dev-remote': '1' } });
119
+ expect(seen[0]['x-lowdefy-dev-remote']).toBeUndefined();
120
+ });
121
+
122
+ test('startProxy refuses a request from another machine without the pairing token', async () => {
123
+ const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
124
+ mockIsLoopbackAddress.mockReturnValue(false);
125
+ const response = await fetch(`http://localhost:${port}/api/mobile/root`);
126
+ expect(response.status).toBe(401);
127
+ expect((await response.json()).message).toContain('pairing token');
128
+ expect(seen).toEqual([]);
129
+ });
130
+
131
+ test('startProxy refuses a request from another machine with the wrong pairing token', async () => {
132
+ const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
133
+ mockIsLoopbackAddress.mockReturnValue(false);
134
+ const response = await fetch(`http://localhost:${port}/api/mobile/root`, {
135
+ headers: { 'x-lowdefy-pair': 'b'.repeat(43) },
136
+ });
137
+ expect(response.status).toBe(401);
138
+ expect(seen).toEqual([]);
139
+ });
140
+
141
+ test('startProxy refuses every request from another machine when --lan is off', async () => {
142
+ const port = await startChildAndProxy();
143
+ mockIsLoopbackAddress.mockReturnValue(false);
144
+ const response = await fetch(`http://localhost:${port}/api/mobile/root`, {
145
+ headers: { 'x-lowdefy-pair': TOKEN },
146
+ });
147
+ expect(response.status).toBe(401);
148
+ });
149
+
150
+ test('startProxy forwards a paired request marked remote, without the token', async () => {
151
+ const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
152
+ mockIsLoopbackAddress.mockReturnValue(false);
153
+ const response = await fetch(`http://localhost:${port}/api/mobile/root`, {
154
+ headers: { 'x-lowdefy-pair': TOKEN },
155
+ });
156
+ expect(response.status).toBe(200);
157
+ expect(seen[0]['x-lowdefy-dev-remote']).toBe('1');
158
+ expect(seen[0]['x-lowdefy-pair']).toBeUndefined();
159
+ });
160
+
161
+ function upgrade({ port, headers }) {
162
+ return new Promise((resolve) => {
163
+ const clientRequest = http.get(`http://localhost:${port}/hmr`, {
164
+ headers: { connection: 'upgrade', upgrade: 'websocket', ...headers },
165
+ });
166
+ clientRequest.on('upgrade', (res, socket) => {
167
+ socket.destroy();
168
+ resolve(res.statusCode);
169
+ });
170
+ clientRequest.on('response', (res) => {
171
+ res.resume();
172
+ resolve(res.statusCode);
173
+ });
174
+ });
175
+ }
176
+
177
+ test('startProxy refuses a websocket upgrade from another machine without the token', async () => {
178
+ const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
179
+ mockIsLoopbackAddress.mockReturnValue(false);
180
+ expect(await upgrade({ port, headers: {} })).toBe(401);
181
+ expect(seen).toEqual([]);
182
+ });
183
+
184
+ test('startProxy forwards a paired websocket upgrade marked remote, without the token', async () => {
185
+ const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
186
+ mockIsLoopbackAddress.mockReturnValue(false);
187
+ expect(await upgrade({ port, headers: { 'x-lowdefy-pair': TOKEN } })).toBe(101);
188
+ expect(seen[0]['x-lowdefy-dev-remote']).toBe('1');
189
+ expect(seen[0]['x-lowdefy-pair']).toBeUndefined();
190
+ });
191
+
192
+ test('startProxy also listens on the --lan address, behind the same pairing gate', async () => {
193
+ const address = await getOtherLoopbackAddress();
194
+ const port = await startChildAndProxy({ lan: { address, token: TOKEN } });
195
+ expect(context.lanProxyServer.address()).toMatchObject({ address, port });
196
+ mockIsLoopbackAddress.mockReturnValue(false);
197
+ const host = address.includes(':') ? `[${address}]` : address;
198
+ const refused = await fetch(`http://${host}:${port}/api/ping`);
199
+ expect(refused.status).toBe(401);
200
+ const paired = await fetch(`http://${host}:${port}/api/ping`, {
201
+ headers: { 'x-lowdefy-pair': TOKEN },
202
+ });
203
+ expect(paired.status).toBe(200);
204
+ });
@@ -17,7 +17,7 @@
17
17
  import http from 'node:http';
18
18
  import net from 'node:net';
19
19
 
20
- import { jest } from '@jest/globals';
20
+ import { vi, afterEach, expect, test } from 'vitest';
21
21
 
22
22
  const { default: startProxy } = await import('./startProxy.mjs');
23
23
  const { default: createBuildActivity } = await import('../utils/createBuildActivity.mjs');
@@ -64,7 +64,7 @@ async function startChildAndProxy(handler) {
64
64
  context = {
65
65
  internalPort,
66
66
  options: { port: await getFreePort() },
67
- logger: { debug: jest.fn() },
67
+ logger: { debug: vi.fn() },
68
68
  requestActivity: createRequestActivity({
69
69
  onChange: (fields) => activityRecords.push(fields),
70
70
  throttleMs: 0,
@@ -147,9 +147,9 @@ test('startProxy sends requests back through the hold once a confirmed child goe
147
147
  // A POST's body was consumed by the failed forward, so it fails once, and
148
148
  // the next request waits for the child instead of failing too.
149
149
  await stopChildAndRestartSoon();
150
- expect(
151
- (await fetch(`http://localhost:${port}/save`, { method: 'POST', body: '{}' })).status
152
- ).toBe(502);
150
+ const dropped = await fetch(`http://localhost:${port}/save`, { method: 'POST', body: '{}' });
151
+ expect(dropped.status).toBe(502);
152
+ expect(dropped.headers.get('x-lowdefy-child')).toBe('dropped');
153
153
  expect(await (await fetch(`http://localhost:${port}/c.js`)).text()).toBe('ok');
154
154
 
155
155
  // An exit the manager has seen sends the very next request through the hold.
@@ -466,3 +466,128 @@ test('startProxy keeps a request held through a child restart counted', async ()
466
466
  expect(await pending).toBe('new');
467
467
  await waitFor(() => activeRequests() === 0);
468
468
  });
469
+
470
+ function stopChildIdle() {
471
+ const idleChild = { stopped: true };
472
+ idleChild.isStopped = () => idleChild.stopped;
473
+ idleChild.wake = vi.fn(async () => {
474
+ idleChild.stopped = false;
475
+ });
476
+ context.idleChild = idleChild;
477
+ return idleChild;
478
+ }
479
+
480
+ test.each([
481
+ ['a passive read', { method: 'GET', headers: { 'x-lowdefy-passive': '1' } }, '/build-status'],
482
+ [
483
+ 'a reload stream reconnect',
484
+ { method: 'GET', headers: { accept: 'text/event-stream' } },
485
+ '/api/reload',
486
+ ],
487
+ [
488
+ 'an MCP push stream reconnect',
489
+ { method: 'GET', headers: { accept: 'text/event-stream' } },
490
+ '/lowdefy-docs/mcp',
491
+ ],
492
+ ])(
493
+ 'startProxy answers %s at once without waking an idle-stopped child',
494
+ async (_, init, requestPath) => {
495
+ let childRequests = 0;
496
+ const port = await startChildAndProxy((req, res) => {
497
+ childRequests += 1;
498
+ res.end('ok');
499
+ });
500
+ context.basePath = '';
501
+ const idleChild = stopChildIdle();
502
+
503
+ const started = Date.now();
504
+ const response = await fetch(`http://localhost:${port}${requestPath}`, init);
505
+ expect(Date.now() - started).toBeLessThan(1000);
506
+ expect(response.status).toBe(503);
507
+ expect(response.headers.get('retry-after')).toBe('5');
508
+ expect(response.headers.get('x-lowdefy-child')).toBe('stopped');
509
+ expect(await response.json()).toEqual({ message: 'Lowdefy dev server is idle.' });
510
+ expect(idleChild.wake).not.toHaveBeenCalled();
511
+ expect(childRequests).toBe(0);
512
+ }
513
+ );
514
+
515
+ test('startProxy answers a websocket upgrade 503 at once while the child is idle-stopped', async () => {
516
+ const port = await startChildAndProxy((req, res) => res.end('ok'));
517
+ const idleChild = stopChildIdle();
518
+ const clientRequest = http.get(`http://localhost:${port}/hmr`, {
519
+ headers: { connection: 'upgrade', upgrade: 'websocket' },
520
+ });
521
+ const response = await new Promise((resolve) => clientRequest.on('response', resolve));
522
+ expect(response.statusCode).toBe(503);
523
+ expect(response.headers['x-lowdefy-child']).toBe('stopped');
524
+ expect(idleChild.wake).not.toHaveBeenCalled();
525
+ });
526
+
527
+ test('startProxy wakes an idle-stopped child for a request that is use and holds it until the child answers', async () => {
528
+ const port = await startChildAndProxy((req, res) => res.end('old'));
529
+ context.basePath = '';
530
+ await close(child);
531
+ const idleChild = stopChildIdle();
532
+ idleChild.wake.mockImplementation(async () => {
533
+ idleChild.stopped = false;
534
+ await new Promise((resolve) => setTimeout(resolve, 300));
535
+ child = http.createServer((req, res) => res.end('woken'));
536
+ await new Promise((resolve) => child.listen(context.internalPort, '127.0.0.1', resolve));
537
+ context.devServer = { exitCode: null, signalCode: null };
538
+ });
539
+
540
+ const response = await fetch(`http://localhost:${port}/page/home`);
541
+ expect(await response.text()).toBe('woken');
542
+ expect(idleChild.wake).toHaveBeenCalledTimes(1);
543
+ });
544
+
545
+ test('startProxy answers a held passive read idle once the child is idle-stopped', async () => {
546
+ const port = await startChildAndProxy((req, res) => res.end('ok'));
547
+ await close(child);
548
+ context.idleChild = { isStopped: () => false, wake: vi.fn() };
549
+
550
+ const pending = fetch(`http://localhost:${port}/build-status`, {
551
+ headers: { 'x-lowdefy-passive': '1' },
552
+ });
553
+ await new Promise((resolve) => setTimeout(resolve, 300));
554
+ context.idleChild.isStopped = () => true;
555
+ const response = await pending;
556
+ expect(response.status).toBe(503);
557
+ expect(response.headers.get('x-lowdefy-child')).toBe('stopped');
558
+ });
559
+
560
+ test('startProxy counts a tab while its reload stream is open', async () => {
561
+ const child$ = heldHandler({ contentType: 'text/event-stream' });
562
+ const port = await startChildAndProxy(child$.handler);
563
+ context.basePath = '/base';
564
+
565
+ const clientRequest = http.get(`http://localhost:${port}/base/api/reload`, {
566
+ headers: { accept: 'text/event-stream' },
567
+ });
568
+ clientRequest.on('error', () => {});
569
+ await new Promise((resolve) => clientRequest.on('response', resolve));
570
+ await waitFor(() => context.requestActivity.snapshot().openTabs === 1);
571
+ expect(activityRecords.at(-1).openTabs).toBe(1);
572
+ expect(activeRequests()).toBe(0);
573
+
574
+ clientRequest.destroy();
575
+ await waitFor(() => context.requestActivity.snapshot().openTabs === 0);
576
+ child$.release();
577
+ });
578
+
579
+ test('startProxy does not count other event streams as tabs', async () => {
580
+ const child$ = heldHandler({ contentType: 'text/event-stream' });
581
+ const port = await startChildAndProxy(child$.handler);
582
+ context.basePath = '';
583
+
584
+ const clientRequest = http.get(`http://localhost:${port}/lowdefy-docs/mcp`, {
585
+ headers: { accept: 'text/event-stream' },
586
+ });
587
+ clientRequest.on('error', () => {});
588
+ await new Promise((resolve) => clientRequest.on('response', resolve));
589
+ await waitFor(() => child$.held.length === 1);
590
+ expect(context.requestActivity.snapshot().openTabs).toBe(0);
591
+ clientRequest.destroy();
592
+ child$.release();
593
+ });