@lowdefy/server-dev 7.1.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (432) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +87 -135
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  106. package/lib/docs/isPageReady.test.mjs +1 -0
  107. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  108. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  109. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  110. package/lib/docs/launchBrowser.test.mjs +8 -8
  111. package/lib/docs/listTypes.js +58 -8
  112. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  113. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  114. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  115. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  116. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  117. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  118. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  119. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  120. package/lib/docs/pollTab.js +100 -0
  121. package/lib/docs/pollTab.test.mjs +64 -0
  122. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  123. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  124. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  125. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  126. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  127. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  128. package/lib/docs/readJourneySession.js +1 -1
  129. package/lib/docs/reportDevToolFault.js +29 -0
  130. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  131. package/lib/docs/requestRestart.test.mjs +1 -0
  132. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  133. package/lib/docs/resolveSource.js +2 -2
  134. package/lib/docs/resolveSource.test.mjs +6 -6
  135. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  136. package/lib/docs/runCheck.test.mjs +3 -3
  137. package/lib/docs/runCheckChild.js +2 -1
  138. package/lib/docs/runEndpoint.js +23 -10
  139. package/lib/docs/runEndpoint.test.mjs +42 -37
  140. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  141. package/lib/docs/runJourney.js +21 -1
  142. package/lib/docs/runJourney.test.mjs +119 -99
  143. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  144. package/lib/docs/runJourneySteps.js +8 -29
  145. package/lib/docs/runRequest.js +6 -6
  146. package/lib/docs/runRequest.test.mjs +22 -22
  147. package/lib/docs/screenshotPage.js +6 -7
  148. package/lib/docs/screenshotPage.test.mjs +46 -46
  149. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  150. package/lib/docs/searchDocs.test.mjs +1 -0
  151. package/lib/docs/searchIcons.test.mjs +5 -5
  152. package/lib/docs/selectFinalState.test.mjs +1 -0
  153. package/lib/docs/serverErrorStore.test.mjs +4 -4
  154. package/lib/docs/setupTestFixtures.mjs +25 -0
  155. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  156. package/lib/docs/tabAvailable.js +1 -1
  157. package/lib/docs/tabChannel.js +90 -14
  158. package/lib/docs/tabChannel.test.mjs +40 -15
  159. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  160. package/lib/docs/validateStateSelection.test.mjs +1 -0
  161. package/lib/docs/validateViewport.test.mjs +1 -0
  162. package/lib/docs/waitForBuild.test.mjs +1 -0
  163. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  164. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  165. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  166. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  167. package/lib/server/auth/getHeadlessUser.js +6 -0
  168. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  169. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  170. package/lib/server/contextMapBudget.test.mjs +3 -3
  171. package/lib/server/continueJitKeys.test.mjs +1 -0
  172. package/lib/server/createLowdefyContext.js +5 -1
  173. package/lib/server/createLowdefyContext.test.mjs +32 -32
  174. package/lib/server/getClientAddress.test.mjs +2 -2
  175. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  176. package/lib/server/importAppCode.test.mjs +2 -2
  177. package/lib/server/jitPageBuilder.js +27 -3
  178. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  179. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  180. package/lib/server/jitPageBuilder.test.mjs +4 -4
  181. package/lib/server/journeyCookies.test.mjs +1 -0
  182. package/lib/server/loadDynamicJsMap.js +10 -1
  183. package/lib/server/log/createHandleError.js +10 -5
  184. package/lib/server/log/createHandleError.test.mjs +19 -8
  185. package/lib/server/log/createLogger.test.mjs +2 -2
  186. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  187. package/lib/server/mutants/listMutants.test.mjs +1 -0
  188. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  189. package/lib/server/mutants/operators.test.mjs +1 -0
  190. package/lib/server/pageBuildRecords.test.mjs +1 -0
  191. package/lib/server/pageCache.test.mjs +1 -0
  192. package/lib/server/pageRebuilds.test.mjs +3 -3
  193. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  194. package/lib/server/pruneJitMaps.test.mjs +1 -0
  195. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  196. package/lib/server/readInstanceRecord.test.mjs +24 -8
  197. package/lib/server/readMergedMaps.test.mjs +1 -0
  198. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  199. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  200. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  201. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  202. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  203. package/lib/server/startIdleGc.test.mjs +25 -9
  204. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  205. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  206. package/manager/getContext.mjs +9 -0
  207. package/manager/processes/checkPendingPlugins.mjs +49 -0
  208. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  209. package/manager/processes/createIdleChild.mjs +141 -0
  210. package/manager/processes/createIdleChild.test.mjs +209 -0
  211. package/manager/processes/initialBuild.mjs +2 -15
  212. package/manager/processes/initialBuild.test.mjs +8 -40
  213. package/manager/processes/lowdefyBuild.mjs +7 -4
  214. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  215. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  216. package/manager/processes/restartServer.test.mjs +63 -15
  217. package/manager/processes/shutdownServer.test.mjs +3 -3
  218. package/manager/processes/startFirstServer.test.mjs +23 -22
  219. package/manager/processes/startMailSink.mjs +11 -3
  220. package/manager/processes/startMailSink.test.mjs +28 -2
  221. package/manager/processes/startProxy.mjs +158 -27
  222. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  223. package/manager/processes/startProxy.test.mjs +127 -2
  224. package/manager/processes/startServer.mjs +5 -7
  225. package/manager/processes/startServer.test.mjs +10 -9
  226. package/manager/processes/syncServer.mjs +31 -4
  227. package/manager/processes/syncServer.test.mjs +71 -6
  228. package/manager/processes/waitForDevServer.test.mjs +21 -6
  229. package/manager/run.mjs +32 -8
  230. package/manager/utils/BatchChanges.mjs +1 -1
  231. package/manager/utils/BatchChanges.test.mjs +4 -4
  232. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  233. package/manager/utils/checkPairing.mjs +45 -0
  234. package/manager/utils/checkPairing.test.mjs +53 -0
  235. package/manager/utils/createBuildActivity.mjs +5 -1
  236. package/manager/utils/createBuildActivity.test.mjs +2 -2
  237. package/manager/utils/createChangeSignal.test.mjs +5 -5
  238. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  239. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  240. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  241. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  242. package/manager/utils/createGlobIgnore.mjs +45 -0
  243. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  244. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  245. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  246. package/manager/utils/createIdleGc.test.mjs +31 -15
  247. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  248. package/manager/utils/createLanPairing.test.mjs +46 -0
  249. package/manager/utils/createRequestActivity.mjs +30 -3
  250. package/manager/utils/createRequestActivity.test.mjs +76 -22
  251. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  252. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  253. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  254. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  255. package/manager/utils/findSignInCode.test.mjs +33 -0
  256. package/manager/utils/formatLanPairing.mjs +32 -0
  257. package/manager/utils/formatLanPairing.test.mjs +40 -0
  258. package/manager/utils/getLanAddress.mjs +83 -0
  259. package/manager/utils/getLanAddress.test.mjs +70 -0
  260. package/manager/utils/importFresh.test.mjs +1 -0
  261. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  262. package/manager/utils/pluginTypeCache.mjs +100 -0
  263. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  264. package/manager/utils/pruneRecordings.test.mjs +1 -0
  265. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  266. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  267. package/manager/utils/readBasePath.test.mjs +1 -0
  268. package/manager/utils/readManagerVersion.test.mjs +1 -0
  269. package/manager/utils/readPluginDefinitions.mjs +6 -6
  270. package/manager/utils/renderTerminalQr.mjs +54 -0
  271. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  272. package/manager/utils/setupWatcher.mjs +19 -4
  273. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  274. package/manager/utils/waitForChildExit.test.mjs +2 -2
  275. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  276. package/manager/watchers/envWatcher.mjs +3 -0
  277. package/manager/watchers/envWatcher.test.mjs +19 -7
  278. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  279. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  280. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  281. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  282. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  283. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  284. package/manager/watchers/resolveFile.mjs +46 -0
  285. package/manager/watchers/resolveFile.test.mjs +67 -0
  286. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  287. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  288. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  289. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  290. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  291. package/package.json +50 -49
  292. package/package.original.json +50 -49
  293. package/src/app.js +83 -85
  294. package/src/html/renderDevPage.test.mjs +1 -0
  295. package/src/lib/getPathSegments.js +16 -1
  296. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  297. package/src/lib/isTabAnswer.js +32 -0
  298. package/src/lib/isTabChannelCaller.js +35 -0
  299. package/src/middleware/apiContext.js +4 -2
  300. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  301. package/src/middleware/errorHandler.js +33 -45
  302. package/src/middleware/errorHandler.test.mjs +10 -10
  303. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  304. package/src/middleware/localDevToolsOnly.js +13 -1
  305. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  306. package/src/middleware/noStore.test.mjs +1 -0
  307. package/src/middleware/staleFlag.test.mjs +1 -0
  308. package/src/middleware/stampCaller.test.mjs +1 -0
  309. package/src/routes/agentBearer.test.mjs +183 -0
  310. package/src/routes/auth.test.mjs +10 -10
  311. package/src/routes/clientError.js +21 -4
  312. package/src/routes/clientError.test.mjs +127 -0
  313. package/src/routes/devInspect.js +6 -51
  314. package/src/routes/devInspect.test.mjs +128 -3
  315. package/src/routes/devRecording.js +6 -17
  316. package/src/routes/devRecording.test.mjs +54 -3
  317. package/src/routes/docs/buildStatus.test.mjs +6 -6
  318. package/src/routes/docs/events.test.mjs +4 -4
  319. package/src/routes/docs/find.js +3 -3
  320. package/src/routes/docs/journey.test.mjs +8 -8
  321. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  322. package/src/routes/docs/loadDocsRoutes.js +70 -0
  323. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  324. package/src/routes/docs/mcp.test.mjs +5 -5
  325. package/src/routes/docs/mutants.js +7 -0
  326. package/src/routes/docs/mutants.test.mjs +20 -6
  327. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  328. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  329. package/src/routes/docs/restart.test.mjs +1 -0
  330. package/src/routes/endpoints.js +24 -0
  331. package/src/routes/endpointsLink.test.mjs +111 -0
  332. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  333. package/src/routes/jitPage.js +13 -1
  334. package/src/routes/jitPage.test.mjs +36 -11
  335. package/src/routes/mcp.js +6 -0
  336. package/src/routes/mcp.test.mjs +23 -8
  337. package/src/routes/mcpMemberToken.test.mjs +8 -8
  338. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  339. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  340. package/src/routes/mobileRoutes.test.mjs +223 -0
  341. package/src/routes/mobileSignIn.js +58 -0
  342. package/src/routes/mobileSignIn.test.mjs +59 -0
  343. package/src/routes/mobileSignInCallback.js +34 -0
  344. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  345. package/src/routes/mountDevPageRoutes.js +10 -2
  346. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  347. package/src/routes/mountMobileWellKnown.js +35 -0
  348. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  349. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  350. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  351. package/src/routes/reload.js +101 -20
  352. package/src/routes/reload.test.mjs +153 -0
  353. package/src/routes/request.js +1 -22
  354. package/src/routes/request.test.mjs +7 -24
  355. package/src/routes/requestBody.test.mjs +14 -27
  356. package/src/routes/websocket.test.mjs +2 -2
  357. package/src/routes/wellKnownFallback.test.mjs +2 -2
  358. package/src/websocket/devWebSocket.test.mjs +12 -12
  359. package/vite.config.js +13 -1
  360. package/client/feedback/FeedbackMount.jsx +0 -83
  361. package/client/feedback/FeedbackOverlay.jsx +0 -904
  362. package/client/feedback/captureTabScreenshot.js +0 -84
  363. package/client/feedback/copyToClipboard.js +0 -45
  364. package/client/feedback/drawAnnotationsSvg.js +0 -119
  365. package/client/feedback/feedbackStyles.js +0 -304
  366. package/client/feedback/pinResponsiveImages.js +0 -59
  367. package/client/feedback/sendFeedback.js +0 -39
  368. package/client/feedback/useFeedbackToggle.js +0 -70
  369. package/client/recorder/buildEngineRecord.js +0 -37
  370. package/client/recorder/buildInteractionRecord.js +0 -64
  371. package/client/recorder/buildTraceEvent.js +0 -57
  372. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  373. package/client/recorder/chunkRecords.js +0 -69
  374. package/client/recorder/chunkRecords.test.mjs +0 -59
  375. package/client/recorder/collectEventEndpoints.js +0 -40
  376. package/client/recorder/collectEventRequests.js +0 -39
  377. package/client/recorder/createPairingBuffer.js +0 -187
  378. package/client/recorder/createPasswordRedactor.js +0 -84
  379. package/client/recorder/createRecordBatcher.js +0 -54
  380. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  381. package/client/recorder/createRecordingSession.js +0 -61
  382. package/client/recorder/createRecordingSession.test.mjs +0 -72
  383. package/client/recorder/diffStateWrites.js +0 -77
  384. package/client/recorder/diffStateWrites.test.mjs +0 -66
  385. package/client/recorder/isEventCall.js +0 -30
  386. package/client/recorder/jsonType.js +0 -39
  387. package/client/recorder/sendRecords.js +0 -40
  388. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  389. package/lib/docs/checkpointPaths.js +0 -91
  390. package/lib/docs/checkpointStore.js +0 -243
  391. package/lib/docs/checkpointToMocks.js +0 -65
  392. package/lib/docs/configCheckpoints.test.mjs +0 -156
  393. package/lib/docs/createConfigCheckpoint.js +0 -92
  394. package/lib/docs/devMockRegistry.js +0 -68
  395. package/lib/docs/enrichFeedback.js +0 -71
  396. package/lib/docs/evalOperator.js +0 -49
  397. package/lib/docs/evalOperator.test.mjs +0 -157
  398. package/lib/docs/evalOperatorHeadless.js +0 -159
  399. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  400. package/lib/docs/evalOperatorInTab.js +0 -49
  401. package/lib/docs/formatFeedback.js +0 -142
  402. package/lib/docs/formatFeedback.test.mjs +0 -252
  403. package/lib/docs/getPluginDoc.js +0 -53
  404. package/lib/docs/listConfigCheckpoints.js +0 -55
  405. package/lib/docs/loadState.js +0 -220
  406. package/lib/docs/revertConfigCheckpoint.js +0 -73
  407. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  408. package/lib/docs/scaffoldPage.js +0 -77
  409. package/lib/docs/scaffoldPage.test.mjs +0 -97
  410. package/lib/docs/snapshotState.js +0 -67
  411. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  412. package/manager/watchers/listServerSidePackages.mjs +0 -47
  413. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  414. package/src/routes/docs/checkpointsCreate.js +0 -28
  415. package/src/routes/docs/evalOperator.js +0 -70
  416. package/src/routes/docs/inspectState.js +0 -59
  417. package/src/routes/docs/loadState.js +0 -51
  418. package/src/routes/docs/pluginDoc.js +0 -33
  419. package/src/routes/docs/plugins.js +0 -23
  420. package/src/routes/docs/runEndpoint.js +0 -54
  421. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  422. package/src/routes/docs/runRequest.js +0 -53
  423. package/src/routes/docs/runRequest.test.mjs +0 -92
  424. package/src/routes/docs/schema.js +0 -37
  425. package/src/routes/docs/screenshot.js +0 -120
  426. package/src/routes/docs/screenshot.test.mjs +0 -117
  427. package/src/routes/docs/search.js +0 -40
  428. package/src/routes/docs/snapshotState.js +0 -50
  429. package/src/routes/docs/stateCheckpointsList.js +0 -26
  430. package/src/routes/docs/types.js +0 -33
  431. package/src/routes/feedback.js +0 -107
  432. package/src/routes/feedback.test.mjs +0 -204
@@ -15,12 +15,13 @@
15
15
  */
16
16
 
17
17
  import { EventEmitter } from 'node:events';
18
+ import { PassThrough } from 'node:stream';
18
19
 
19
- import { jest } from '@jest/globals';
20
+ import { vi, beforeEach, expect, test } from 'vitest';
20
21
 
21
- const mockSpawn = jest.fn();
22
+ const mockSpawn = vi.fn();
22
23
  const { spawnSync, execSync, exec, execFile, fork } = await import('child_process');
23
- jest.unstable_mockModule('child_process', () => ({
24
+ vi.doMock('child_process', () => ({
24
25
  spawn: mockSpawn,
25
26
  spawnSync,
26
27
  execSync,
@@ -28,9 +29,9 @@ jest.unstable_mockModule('child_process', () => ({
28
29
  execFile,
29
30
  fork,
30
31
  }));
31
- jest.unstable_mockModule('../utils/readBasePath.mjs', () => ({ default: () => '' }));
32
- const mockWaitForServer = jest.fn(async () => true);
33
- jest.unstable_mockModule('../utils/waitForServer.mjs', () => ({ default: mockWaitForServer }));
32
+ vi.doMock('../utils/readBasePath.mjs', () => ({ default: () => '' }));
33
+ const mockWaitForServer = vi.fn(async () => true);
34
+ vi.doMock('../utils/waitForServer.mjs', () => ({ default: mockWaitForServer }));
34
35
 
35
36
  const { default: optimizeDependencies } = await import('./optimizeDependencies.mjs');
36
37
  const { default: restartServer } = await import('./restartServer.mjs');
@@ -41,7 +42,7 @@ const { default: syncServer } = await import('./syncServer.mjs');
41
42
  function createProcess() {
42
43
  return Object.assign(new EventEmitter(), {
43
44
  stdout: new EventEmitter(),
44
- stderr: new EventEmitter(),
45
+ stderr: new PassThrough(),
45
46
  });
46
47
  }
47
48
 
@@ -49,14 +50,14 @@ function createContext() {
49
50
  const context = {
50
51
  bin: { vite: '/server/node_modules/vite/bin/vite.js' },
51
52
  directories: { config: '/apps/tenant', server: '/server' },
52
- instance: { update: jest.fn() },
53
+ instance: { update: vi.fn() },
53
54
  internalPort: 3211,
54
- logger: { debug: jest.fn(), error: jest.fn(), info: jest.fn(), warn: jest.fn() },
55
+ logger: { debug: vi.fn(), error: vi.fn(), info: vi.fn(), warn: vi.fn() },
55
56
  mailSink: null,
56
- markServerReady: jest.fn(),
57
+ markServerReady: vi.fn(),
57
58
  options: { port: 3210 },
58
- serverArtifacts: { record: jest.fn() },
59
- shutdownServer: jest.fn(),
59
+ serverArtifacts: { record: vi.fn() },
60
+ shutdownServer: vi.fn(),
60
61
  };
61
62
  context.optimizeDependencies = optimizeDependencies(context);
62
63
  context.syncServer = syncServer(context);
@@ -69,10 +70,10 @@ function createContext() {
69
70
  function createTracker(files) {
70
71
  let started = {};
71
72
  return {
72
- record: jest.fn(() => {
73
+ record: vi.fn(() => {
73
74
  started = { ...files };
74
75
  }),
75
- check: jest.fn(() => {
76
+ check: vi.fn(() => {
76
77
  const changed = Object.keys(files).filter((file) => files[file] !== started[file]);
77
78
  return { install: changed.includes('package.json'), restart: changed.length > 0 };
78
79
  }),
@@ -164,7 +165,7 @@ test('the optimiser resolves the same environment as the child, apart from the b
164
165
  test('a watcher sync during the optimise waits for the first start and restarts nothing', async () => {
165
166
  const context = createContext();
166
167
  context.serverArtifacts = createTracker({ 'build/config.json': 'a', 'package.json': 'a' });
167
- context.restartServer = jest.fn(async () => startServer(context));
168
+ context.restartServer = vi.fn(async () => startServer(context));
168
169
 
169
170
  const started = startFirstServer(context);
170
171
  await flush();
@@ -190,10 +191,10 @@ test('a config edit during the optimise is rebuilt at once, and its sync resolve
190
191
  const context = createContext();
191
192
  const files = { 'build/config.json': 'a', 'package.json': 'a' };
192
193
  context.serverArtifacts = createTracker(files);
193
- context.lowdefyBuild = jest.fn(async () => {
194
+ context.lowdefyBuild = vi.fn(async () => {
194
195
  files['build/config.json'] = 'b';
195
196
  });
196
- context.restartServer = jest.fn(async () => {
197
+ context.restartServer = vi.fn(async () => {
197
198
  context.serverArtifacts.record();
198
199
  startServer(context);
199
200
  });
@@ -225,11 +226,11 @@ test('a plugin package added during the optimise is installed by the queued sync
225
226
  context.serverArtifacts = createTracker(files);
226
227
  const events = [];
227
228
  context.buildActivity = { track: (task) => task() };
228
- context.installPlugins = jest.fn(async () => events.push('install'));
229
- context.lowdefyBuild = jest.fn(async () => events.push('build'));
230
- context.restartServer = jest.fn(async () => events.push('restart'));
229
+ context.installPlugins = vi.fn(async () => events.push('install'));
230
+ context.lowdefyBuild = vi.fn(async () => events.push('build'));
231
+ context.restartServer = vi.fn(async () => events.push('restart'));
231
232
  let finishOptimise;
232
- context.optimizeDependencies = jest.fn(async () => events.push('optimise'));
233
+ context.optimizeDependencies = vi.fn(async () => events.push('optimise'));
233
234
  context.optimizeDependencies.mockImplementationOnce(
234
235
  () =>
235
236
  new Promise((resolve) => {
@@ -257,7 +258,7 @@ test('startFirstServer resolves once the first child answers, before a queued sy
257
258
  const context = createContext();
258
259
  const files = { 'build/config.json': 'a', 'package.json': 'a' };
259
260
  context.serverArtifacts = createTracker(files);
260
- context.restartServer = jest.fn(async () => {
261
+ context.restartServer = vi.fn(async () => {
261
262
  context.serverArtifacts.record();
262
263
  startServer(context);
263
264
  });
@@ -18,6 +18,7 @@ import fs from 'node:fs';
18
18
  import path from 'node:path';
19
19
 
20
20
  import getMailOutboxDirectory from '../../lib/docs/getMailOutboxDirectory.js';
21
+ import findSignInCode from '../utils/findSignInCode.mjs';
21
22
 
22
23
  /*
23
24
  With LOWDEFY_DEV_SMTP_PORT set, the dev server receives mail over SMTP on that
@@ -29,7 +30,10 @@ filter, nodemailer, templates - runs exactly as in production. The manager owns
29
30
  the listener so it survives restarts of the server child, and tells each child
30
31
  it is listening (startServer passes LOWDEFY_SERVER_DEV_MAIL_SINK), so a port
31
32
  added to .env after start is not mistaken for a running sink. The outbox is
32
- cleared at start, so a test run only ever sees the mail it caused.
33
+ cleared at start, so a test run only ever sees the mail it caused. A message
34
+ that carries a sign-in code also prints it (`code for <to>: <code>`), so a
35
+ person signing in on a phone, or an agent reading lowdefy_dev_logs, has it
36
+ without opening the outbox.
33
37
  */
34
38
 
35
39
  function readSmtpPort() {
@@ -52,7 +56,7 @@ async function readStream(stream) {
52
56
  return Buffer.concat(chunks);
53
57
  }
54
58
 
55
- function createMessageWriter({ directory, PostalMime }) {
59
+ function createMessageWriter({ directory, logger, PostalMime }) {
56
60
  let sequence = 0;
57
61
  return async function writeMessage({ raw, envelope }) {
58
62
  // Numbered on arrival, before the parse, so the outbox order is the order
@@ -72,6 +76,10 @@ function createMessageWriter({ directory, PostalMime }) {
72
76
  const filePath = path.join(directory, `${id}.json`);
73
77
  await fs.promises.writeFile(`${filePath}.tmp`, JSON.stringify(message, null, 2));
74
78
  await fs.promises.rename(`${filePath}.tmp`, filePath);
79
+ const code = findSignInCode({ text: message.text });
80
+ if (code !== null) {
81
+ logger.info(`code for ${message.to.join(', ')}: ${code}`);
82
+ }
75
83
  };
76
84
  }
77
85
 
@@ -110,7 +118,7 @@ async function startMailSink(context) {
110
118
  const directory = getMailOutboxDirectory({ configDirectory: context.directories.config });
111
119
  fs.rmSync(directory, { recursive: true, force: true });
112
120
  fs.mkdirSync(directory, { recursive: true });
113
- const writeMessage = createMessageWriter({ directory, PostalMime });
121
+ const writeMessage = createMessageWriter({ directory, logger: context.logger, PostalMime });
114
122
 
115
123
  const server = new smtpServer.SMTPServer({
116
124
  authOptional: true,
@@ -19,7 +19,7 @@ import net from 'node:net';
19
19
  import os from 'node:os';
20
20
  import path from 'node:path';
21
21
 
22
- import { jest } from '@jest/globals';
22
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
23
23
  import nodemailer from 'nodemailer';
24
24
 
25
25
  import readMailOutbox from '../../lib/docs/readMailOutbox.js';
@@ -55,7 +55,7 @@ afterEach(async () => {
55
55
  function createContext() {
56
56
  return {
57
57
  directories: { config: configDirectory },
58
- logger: { info: jest.fn(), error: jest.fn() },
58
+ logger: { info: vi.fn(), error: vi.fn() },
59
59
  };
60
60
  }
61
61
 
@@ -144,3 +144,29 @@ test('startMailSink fails with the port when LOWDEFY_DEV_SMTP_PORT is taken', as
144
144
  await new Promise((resolve) => blocker.close(resolve));
145
145
  }
146
146
  });
147
+
148
+ test('startMailSink prints the sign-in code a message carries', async () => {
149
+ const port = await getFreePort();
150
+ process.env.LOWDEFY_DEV_SMTP_PORT = String(port);
151
+ const context = createContext();
152
+ sink = await startMailSink(context);
153
+ const transport = nodemailer.createTransport({ host: '127.0.0.1', port, secure: false });
154
+ await transport.sendMail({
155
+ from: 'app@localhost',
156
+ to: 'ada@example.test',
157
+ subject: 'Your sign-in code',
158
+ text: 'Enter this code on the sign-in page to continue.\n\n482913\n\nThis code expires in 5 minutes.',
159
+ });
160
+ await transport.sendMail({
161
+ from: 'app@localhost',
162
+ to: 'ada@example.test',
163
+ subject: 'Order shipped',
164
+ text: 'Your order 123456 has shipped.',
165
+ });
166
+ transport.close();
167
+
168
+ const printed = context.logger.info.mock.calls.map(([line]) => line);
169
+ expect(printed.filter((line) => line.startsWith('code for'))).toEqual([
170
+ 'code for ada@example.test: 482913',
171
+ ]);
172
+ });
@@ -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,15 @@ 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
+ A child stopped for being idle (createIdleChild) is started again only by a
57
+ request that is use (isActivity), which is held as for a restart. A request
58
+ that is not use - a passive read, an event-stream GET, a websocket upgrade -
59
+ is answered 503 at once with Retry-After, so status checks and reconnecting
60
+ streams neither wake the child nor wait out the hold.
61
+
62
+ The proxy also counts the tabs holding a reload stream open, from the
63
+ stream's response start until it closes: an open tab keeps the child up.
53
64
  */
54
65
 
55
66
  const RETRY_MS = 250;
@@ -69,10 +80,16 @@ function probeChild(port) {
69
80
  });
70
81
  }
71
82
 
72
- async function waitForChild({ port, deadline }) {
83
+ function isChildStopped(context) {
84
+ return context.idleChild?.isStopped() === true;
85
+ }
86
+
87
+ // givesUp ends the wait early: a request that does not wake the child stops
88
+ // waiting once the child is idle-stopped.
89
+ async function waitForChild({ port, deadline, givesUp = () => false }) {
73
90
  for (;;) {
74
91
  if (await probeChild(port)) return true;
75
- if (Date.now() > deadline) return false;
92
+ if (Date.now() > deadline || givesUp()) return false;
76
93
  await new Promise((resolve) => setTimeout(resolve, RETRY_MS));
77
94
  }
78
95
  }
@@ -94,13 +111,17 @@ function waitUntil({ promise, deadline }) {
94
111
  ]);
95
112
  }
96
113
 
97
- async function waitForConfirmedChild({ context, proxyState, deadline }) {
114
+ async function waitForConfirmedChild({ context, proxyState, deadline, wakes }) {
98
115
  if (isConfirmedChild({ context, proxyState })) {
99
116
  return true;
100
117
  }
101
118
  await waitUntil({ promise: context.devServerExited, deadline });
102
119
  const child = context.devServer;
103
- const up = await waitForChild({ port: context.internalPort, deadline });
120
+ const up = await waitForChild({
121
+ port: context.internalPort,
122
+ deadline,
123
+ givesUp: () => !wakes && isChildStopped(context),
124
+ });
104
125
  if (up) {
105
126
  proxyState.confirmedChild = child;
106
127
  }
@@ -109,6 +130,25 @@ async function waitForConfirmedChild({ context, proxyState, deadline }) {
109
130
 
110
131
  const REPLAYABLE_METHODS = ['GET', 'HEAD'];
111
132
 
133
+ const IDLE_RETRY_AFTER_S = 5;
134
+
135
+ function answerIdle(res) {
136
+ res.writeHead(503, {
137
+ 'content-type': 'application/json',
138
+ 'retry-after': String(IDLE_RETRY_AFTER_S),
139
+ 'x-lowdefy-child': 'stopped',
140
+ });
141
+ res.end(JSON.stringify({ message: 'Lowdefy dev server is idle.' }));
142
+ }
143
+
144
+ function isReloadStream({ context, req }) {
145
+ if (req.method !== 'GET') {
146
+ return false;
147
+ }
148
+ const { pathname } = new URL(req.url, 'http://localhost');
149
+ return pathname === `${context.basePath ?? ''}/api/reload`;
150
+ }
151
+
112
152
  // Nothing reached the child: the connect was refused, or the keep-alive socket
113
153
  // the agent reused had already been closed by a child that is going away.
114
154
  function isUnsentError({ error, proxyReq }) {
@@ -117,17 +157,26 @@ function isUnsentError({ error, proxyReq }) {
117
157
  );
118
158
  }
119
159
 
120
- function forwardRequest({ body, context, proxyState }, req, res, deadline = Date.now() + HOLD_MS) {
160
+ function forwardRequest(
161
+ { body, context, proxyState, wakes },
162
+ req,
163
+ res,
164
+ deadline = Date.now() + HOLD_MS
165
+ ) {
121
166
  // Wait for a live child BEFORE piping the request body — the body stream can
122
167
  // only be consumed once, so retrying after a failed proxy request would need
123
168
  // full-body buffering. Only a bodiless GET or HEAD that never reached the
124
169
  // child is replayed; any other request that loses the child mid-forward
125
170
  // surfaces as one 502, which the client's next attempt resolves through the
126
171
  // hold.
127
- waitForConfirmedChild({ context, proxyState, deadline }).then((up) => {
172
+ waitForConfirmedChild({ context, proxyState, deadline, wakes }).then((up) => {
128
173
  // The response, not the request: an incoming request reads as destroyed
129
174
  // once its body has been read, which a replayed GET's has.
130
175
  if (res.destroyed) return;
176
+ if (!up && !wakes && isChildStopped(context)) {
177
+ answerIdle(res);
178
+ return;
179
+ }
131
180
  if (!up) {
132
181
  res.writeHead(503, { 'content-type': 'application/json' });
133
182
  res.end(JSON.stringify({ message: 'Lowdefy dev server is restarting.' }));
@@ -141,6 +190,9 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
141
190
  headers: req.headers,
142
191
  });
143
192
  proxyReq.on('response', (proxyRes) => {
193
+ if (proxyRes.statusCode === 200 && isReloadStream({ context, req })) {
194
+ context.requestActivity.trackTab(res);
195
+ }
144
196
  res.writeHead(proxyRes.statusCode, proxyRes.headers);
145
197
  // flushHeaders so SSE endpoints (reload stream, MCP notifications)
146
198
  // reach the client before the first event.
@@ -154,7 +206,7 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
154
206
  REPLAYABLE_METHODS.includes(req.method) &&
155
207
  isUnsentError({ error, proxyReq })
156
208
  ) {
157
- forwardRequest({ body, context, proxyState }, req, res, deadline);
209
+ forwardRequest({ body, context, proxyState, wakes }, req, res, deadline);
158
210
  return;
159
211
  }
160
212
  if (res.headersSent) {
@@ -203,9 +255,42 @@ function isActivity(req) {
203
255
  // latest edits, restarts included, and only then forwarded: a restart ends
204
256
  // the dev server process, and any wait running in it. The header tells the
205
257
  // dev server what this wait saw, so it does not wait again.
258
+ // The pairing gate sits here, in front of Vite and the app alike, because the
259
+ // child only ever sees the proxy's loopback address. The child learns that a
260
+ // caller is remote from remoteCallerHeader, which only the proxy sets.
261
+ function readAccess({ context, req }) {
262
+ return checkPairing({
263
+ remoteAddress: req.socket.remoteAddress,
264
+ pairToken: context.lan?.token,
265
+ providedToken: req.headers[pairHeader],
266
+ });
267
+ }
268
+
269
+ const PAIRING_REFUSAL =
270
+ 'This dev server answers other machines only with the pairing token that `lowdefy dev --lan` prints.';
271
+
206
272
  async function handleRequest({ context, proxyState }, req, res) {
207
- if (isActivity(req)) {
273
+ const access = readAccess({ context, req });
274
+ if (access === 'refused') {
275
+ res.writeHead(401, { 'content-type': 'application/json' });
276
+ res.end(JSON.stringify({ message: PAIRING_REFUSAL }));
277
+ return;
278
+ }
279
+ delete req.headers[pairHeader];
280
+ delete req.headers[remoteCallerHeader];
281
+ if (access === 'paired') {
282
+ req.headers[remoteCallerHeader] = '1';
283
+ }
284
+ const wakes = isActivity(req);
285
+ if (!wakes && isChildStopped(context)) {
286
+ answerIdle(res);
287
+ return;
288
+ }
289
+ if (wakes) {
208
290
  context.requestActivity.trackResponse(res);
291
+ if (isChildStopped(context)) {
292
+ context.idleChild.wake().catch((error) => context.logger.error(error));
293
+ }
209
294
  }
210
295
  delete req.headers[buildWaitHeader];
211
296
  const { wait, body } = await readBuildStatusWait({ basePath: context.basePath, req });
@@ -217,12 +302,39 @@ async function handleRequest({ context, proxyState }, req, res) {
217
302
  waitedMs: String(waited.waitedMs),
218
303
  }).toString();
219
304
  }
220
- forwardRequest({ body, context, proxyState }, req, res);
305
+ forwardRequest({ body, context, proxyState, wakes }, req, res);
221
306
  }
222
307
 
308
+ const IDLE_UPGRADE_RESPONSE = [
309
+ 'HTTP/1.1 503 Service Unavailable',
310
+ `retry-after: ${IDLE_RETRY_AFTER_S}`,
311
+ 'x-lowdefy-child: stopped',
312
+ 'connection: close',
313
+ '',
314
+ '',
315
+ ].join('\r\n');
316
+
317
+ // An upgrade is never use (see isActivity), so it never wakes an idle-stopped child.
223
318
  function forwardUpgrade(context, req, socket, head) {
224
- waitForChild({ port: context.internalPort, deadline: Date.now() + HOLD_MS }).then((up) => {
319
+ const access = readAccess({ context, req });
320
+ if (access === 'refused') {
321
+ socket.end('HTTP/1.1 401 Unauthorized\r\nconnection: close\r\n\r\n');
322
+ return;
323
+ }
324
+ if (isChildStopped(context)) {
325
+ socket.end(IDLE_UPGRADE_RESPONSE);
326
+ return;
327
+ }
328
+ waitForChild({
329
+ port: context.internalPort,
330
+ deadline: Date.now() + HOLD_MS,
331
+ givesUp: () => isChildStopped(context),
332
+ }).then((up) => {
225
333
  if (socket.destroyed) return;
334
+ if (!up && isChildStopped(context)) {
335
+ socket.end(IDLE_UPGRADE_RESPONSE);
336
+ return;
337
+ }
226
338
  if (!up) {
227
339
  socket.end('HTTP/1.1 503 Service Unavailable\r\nconnection: close\r\n\r\n');
228
340
  return;
@@ -233,7 +345,13 @@ function forwardUpgrade(context, req, socket, head) {
233
345
  // websockets both pass through untouched.
234
346
  const lines = [`${req.method} ${req.url} HTTP/1.1`];
235
347
  for (let i = 0; i < req.rawHeaders.length; i += 2) {
236
- lines.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);
348
+ const name = req.rawHeaders[i].toLowerCase();
349
+ if (name !== pairHeader && name !== remoteCallerHeader) {
350
+ lines.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);
351
+ }
352
+ }
353
+ if (access === 'paired') {
354
+ lines.push(`${remoteCallerHeader}: 1`);
237
355
  }
238
356
  upstream.write(lines.join('\r\n') + '\r\n\r\n');
239
357
  if (head?.length) upstream.write(head);
@@ -247,9 +365,17 @@ function forwardUpgrade(context, req, socket, head) {
247
365
  });
248
366
  }
249
367
 
250
- function startProxy(context) {
251
- if (context.proxyServer) return Promise.resolve();
252
- const proxyState = { confirmedChild: null };
368
+ function listen({ server, port, host }) {
369
+ return new Promise((resolve, reject) => {
370
+ server.once('error', reject);
371
+ server.listen(port, host, () => {
372
+ server.removeListener('error', reject);
373
+ resolve();
374
+ });
375
+ });
376
+ }
377
+
378
+ function createProxyServer({ context, proxyState }) {
253
379
  const proxy = http.createServer((req, res) => {
254
380
  // A client that drops an MCP request while its body is read.
255
381
  handleRequest({ context, proxyState }, req, res).catch(() => res.destroy());
@@ -259,19 +385,24 @@ function startProxy(context) {
259
385
  // request timeout; keep the proxy transparent.
260
386
  proxy.requestTimeout = 0;
261
387
  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
- });
388
+ return proxy;
389
+ }
390
+
391
+ async function startProxy(context) {
392
+ if (context.proxyServer) return;
393
+ const proxyState = { confirmedChild: null };
394
+ const { port } = context.options;
395
+ context.proxyServer = createProxyServer({ context, proxyState });
396
+ // 'localhost' for parity with the Vite default host the child used to bind
397
+ // - the dev server stays loopback-only unless --lan asks for the network.
398
+ await listen({ server: context.proxyServer, port, host: 'localhost' });
399
+ // --lan adds a listener on the chosen interface's address only, not on every
400
+ // interface, so a VPN or Docker network does not reach the server too.
401
+ if (context.lan) {
402
+ context.lanProxyServer = createProxyServer({ context, proxyState });
403
+ await listen({ server: context.lanProxyServer, port, host: context.lan.address });
404
+ }
405
+ context.logger.debug(`Proxy listening on port ${port}, forwarding to ${context.internalPort}.`);
275
406
  }
276
407
 
277
408
  export default startProxy;