@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
@@ -18,10 +18,10 @@ import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
20
 
21
- import { jest } from '@jest/globals';
21
+ import { vi, afterAll, afterEach, expect, test } from 'vitest';
22
22
 
23
- const mockGetProcessStartTime = jest.fn();
24
- jest.unstable_mockModule('child_process', () => ({
23
+ const mockGetProcessStartTime = vi.fn();
24
+ vi.doMock('child_process', () => ({
25
25
  spawnSync: mockGetProcessStartTime,
26
26
  execSync: mockGetProcessStartTime,
27
27
  execFileSync: mockGetProcessStartTime,
@@ -73,9 +73,25 @@ test('readInstanceRecord returns null for a record caught mid-write', () => {
73
73
 
74
74
  test('the idle GC poll reads the record and collects without spawning a process', () => {
75
75
  // performance is not redefinable on this Node, and nothing here reads it.
76
- jest.useFakeTimers({ doNotFake: ['performance'] });
76
+ vi.useFakeTimers({
77
+ toFake: [
78
+ 'Date',
79
+ 'hrtime',
80
+ 'queueMicrotask',
81
+ 'requestAnimationFrame',
82
+ 'cancelAnimationFrame',
83
+ 'requestIdleCallback',
84
+ 'cancelIdleCallback',
85
+ 'setImmediate',
86
+ 'clearImmediate',
87
+ 'setInterval',
88
+ 'clearInterval',
89
+ 'setTimeout',
90
+ 'clearTimeout',
91
+ ],
92
+ });
77
93
  try {
78
- const gc = jest.fn();
94
+ const gc = vi.fn();
79
95
  const start = Date.parse('2026-10-03T10:00:00.000Z');
80
96
  // A full record, which readDevInstance would check with ps.
81
97
  writeRecord({
@@ -88,12 +104,12 @@ test('the idle GC poll reads the record and collects without spawning a process'
88
104
  });
89
105
 
90
106
  startIdleGc({ configDirectory, gc, now: () => start + 10_000 });
91
- jest.advanceTimersByTime(5000);
107
+ vi.advanceTimersByTime(5000);
92
108
 
93
109
  expect(gc).toHaveBeenCalledTimes(1);
94
110
  expect(mockGetProcessStartTime).not.toHaveBeenCalled();
95
111
  } finally {
96
- jest.clearAllTimers();
97
- jest.useRealTimers();
112
+ vi.clearAllTimers();
113
+ vi.useRealTimers();
98
114
  }
99
115
  });
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import readMergedMaps from './readMergedMaps.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let buildDirectory;
24
25
 
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import errorRecordingStamp from './errorRecordingStamp.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('errorRecordingStamp gives the source, run id and journey of a verified run cookie', () => {
20
21
  expect(
@@ -14,6 +14,8 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
+ import { afterEach, expect, test } from 'vitest';
18
+
17
19
  const { default: readRecordingCookie } = await import('./readRecordingCookie.js');
18
20
  const { default: recordingCookiePayload } = await import('./recordingCookiePayload.js');
19
21
  const { default: isRecordingEnabled } = await import('./isRecordingEnabled.js');
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import servedBuilds from './servedBuilds.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  function buildId(index) {
20
21
  return new Date(Date.UTC(2026, 9, 3, 0, index)).toISOString();
@@ -14,19 +14,19 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, beforeEach, expect, test } from 'vitest';
18
18
 
19
19
  import sinkExternalConnections from './sinkExternalConnections.js';
20
20
 
21
- const realSend = jest.fn(async () => ({ sent: true }));
21
+ const realSend = vi.fn(async () => ({ sent: true }));
22
22
  realSend.schema = { type: 'object' };
23
23
  realSend.meta = { checkWrite: true };
24
- const realGather = jest.fn(async () => ({ downloaded: true }));
24
+ const realGather = vi.fn(async () => ({ downloaded: true }));
25
25
  realGather.schema = { type: 'object' };
26
26
  realGather.meta = { checkRead: true, dataSet: 'external' };
27
- const realRead = jest.fn(async () => ['doc']);
27
+ const realRead = vi.fn(async () => ['doc']);
28
28
  realRead.meta = { checkRead: true };
29
- const realMongo = jest.fn(async () => ['row']);
29
+ const realMongo = vi.fn(async () => ['row']);
30
30
 
31
31
  const connections = {
32
32
  SMTP: { schema: {}, meta: { dataSet: 'external' }, requests: { SMTPMailSend: realSend } },
@@ -38,7 +38,7 @@ const context = { scrubSecrets: (value) => value.replace('s3cret', '[REDACTED]')
38
38
 
39
39
  let session;
40
40
  beforeEach(() => {
41
- jest.clearAllMocks();
41
+ vi.clearAllMocks();
42
42
  delete process.env.LOWDEFY_DEV_SMTP_PORT;
43
43
  session = { sunk: [] };
44
44
  });
@@ -18,7 +18,7 @@ import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
20
 
21
- import { jest } from '@jest/globals';
21
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
22
22
 
23
23
  import skipStaleMapWrites from './skipStaleMapWrites.js';
24
24
 
@@ -41,7 +41,7 @@ afterEach(() => {
41
41
 
42
42
  test('a page build writes its maps while its config build is the live one', async () => {
43
43
  publishBuild('a1b2_');
44
- const writeBuildArtifact = jest.fn();
44
+ const writeBuildArtifact = vi.fn();
45
45
  const context = { writeBuildArtifact };
46
46
  skipStaleMapWrites({ buildDirectory, context, keyPrefix: 'a1b2_', isKeptContext: () => true });
47
47
 
@@ -49,14 +49,14 @@ test('a page build writes its maps while its config build is the live one', asyn
49
49
  await context.writeBuildArtifact('refMap.json', '{}');
50
50
 
51
51
  expect(writeBuildArtifact.mock.calls).toEqual([
52
- ['keyMap.json', '{}'],
53
- ['refMap.json', '{}'],
52
+ ['keyMap.json', '{}', undefined],
53
+ ['refMap.json', '{}', undefined],
54
54
  ]);
55
55
  });
56
56
 
57
57
  test('a page build started before a config rebuild does not replace the new maps', async () => {
58
58
  publishBuild('a1b2_');
59
- const writeBuildArtifact = jest.fn();
59
+ const writeBuildArtifact = vi.fn();
60
60
  const context = { writeBuildArtifact };
61
61
  skipStaleMapWrites({ buildDirectory, context, keyPrefix: 'a1b2_', isKeptContext: () => true });
62
62
 
@@ -65,12 +65,12 @@ test('a page build started before a config rebuild does not replace the new maps
65
65
  await context.writeBuildArtifact('refMap.json', '{}');
66
66
  await context.writeBuildArtifact('pages/home.json', '{}');
67
67
 
68
- expect(writeBuildArtifact.mock.calls).toEqual([['pages/home.json', '{}']]);
68
+ expect(writeBuildArtifact.mock.calls).toEqual([['pages/home.json', '{}', undefined]]);
69
69
  });
70
70
 
71
71
  test('a page build started before a config rebuild writes no jitMaps file', async () => {
72
72
  publishBuild('a1b2_');
73
- const writeBuildArtifact = jest.fn();
73
+ const writeBuildArtifact = vi.fn();
74
74
  const context = { writeBuildArtifact };
75
75
  skipStaleMapWrites({ buildDirectory, context, keyPrefix: 'a1b2_', isKeptContext: () => true });
76
76
 
@@ -78,12 +78,12 @@ test('a page build started before a config rebuild writes no jitMaps file', asyn
78
78
  publishBuild('c3d4_');
79
79
  await context.writeBuildArtifact('jitMaps/abc123-1-2.json', '{}');
80
80
 
81
- expect(writeBuildArtifact.mock.calls).toEqual([['jitMaps/abc123-1-1.json', '{}']]);
81
+ expect(writeBuildArtifact.mock.calls).toEqual([['jitMaps/abc123-1-1.json', '{}', undefined]]);
82
82
  });
83
83
 
84
84
  test('a page build on a context that is no longer kept does not write the JS maps', async () => {
85
85
  publishBuild('a1b2_');
86
- const writeBuildArtifact = jest.fn();
86
+ const writeBuildArtifact = vi.fn();
87
87
  const context = { writeBuildArtifact };
88
88
  let kept = true;
89
89
  skipStaleMapWrites({ buildDirectory, context, keyPrefix: 'a1b2_', isKeptContext: () => kept });
@@ -95,14 +95,14 @@ test('a page build on a context that is no longer kept does not write the JS map
95
95
  await context.writeBuildArtifact('pages/home.json', '{}');
96
96
 
97
97
  expect(writeBuildArtifact.mock.calls).toEqual([
98
- ['plugins/operators/serverJsMap.js', 'a'],
99
- ['pages/home.json', '{}'],
98
+ ['plugins/operators/serverJsMap.js', 'a', undefined],
99
+ ['pages/home.json', '{}', undefined],
100
100
  ]);
101
101
  });
102
102
 
103
103
  test('a page build started before a config rebuild does not write the JS maps', async () => {
104
104
  publishBuild('a1b2_');
105
- const writeBuildArtifact = jest.fn();
105
+ const writeBuildArtifact = vi.fn();
106
106
  const context = { writeBuildArtifact };
107
107
  skipStaleMapWrites({ buildDirectory, context, keyPrefix: 'a1b2_', isKeptContext: () => true });
108
108
 
@@ -14,7 +14,7 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
18
18
 
19
19
  import startIdleGc from './startIdleGc.js';
20
20
 
@@ -37,15 +37,31 @@ function start(options = {}) {
37
37
 
38
38
  function tick(ms) {
39
39
  clock += ms;
40
- jest.advanceTimersByTime(ms);
40
+ vi.advanceTimersByTime(ms);
41
41
  }
42
42
 
43
43
  beforeEach(() => {
44
44
  // performance is not redefinable on this Node, and nothing here reads it.
45
- jest.useFakeTimers({ doNotFake: ['performance'] });
45
+ vi.useFakeTimers({
46
+ toFake: [
47
+ 'Date',
48
+ 'hrtime',
49
+ 'queueMicrotask',
50
+ 'requestAnimationFrame',
51
+ 'cancelAnimationFrame',
52
+ 'requestIdleCallback',
53
+ 'cancelIdleCallback',
54
+ 'setImmediate',
55
+ 'clearImmediate',
56
+ 'setInterval',
57
+ 'clearInterval',
58
+ 'setTimeout',
59
+ 'clearTimeout',
60
+ ],
61
+ });
46
62
  delete globalThis[STARTED];
47
63
  clock = START;
48
- gc = jest.fn();
64
+ gc = vi.fn();
49
65
  record = {
50
66
  lastActivityAt: new Date(START).toISOString(),
51
67
  activeRequests: 0,
@@ -54,8 +70,8 @@ beforeEach(() => {
54
70
  });
55
71
 
56
72
  afterEach(() => {
57
- jest.clearAllTimers();
58
- jest.useRealTimers();
73
+ vi.clearAllTimers();
74
+ vi.useRealTimers();
59
75
  delete globalThis[STARTED];
60
76
  });
61
77
 
@@ -111,7 +127,7 @@ test('startIdleGc does nothing when the instance record has no activity', () =>
111
127
  });
112
128
 
113
129
  test('startIdleGc does nothing when the child was started without gc exposed', () => {
114
- // The gc default is globalThis.gc, which every later test file in a jest worker has once
130
+ // The gc default is globalThis.gc, which every later test file in a test worker has once
115
131
  // createIdleGc.test.mjs has set --expose-gc in it.
116
132
  const exposedGc = globalThis.gc;
117
133
  delete globalThis.gc;
@@ -120,7 +136,7 @@ test('startIdleGc does nothing when the child was started without gc exposed', (
120
136
  start();
121
137
 
122
138
  expect(globalThis[STARTED]).toBeUndefined();
123
- expect(jest.getTimerCount()).toBe(0);
139
+ expect(vi.getTimerCount()).toBe(0);
124
140
  } finally {
125
141
  if (exposedGc !== undefined) {
126
142
  globalThis.gc = exposedGc;
@@ -132,7 +148,7 @@ test('startIdleGc starts one interval however often the app entry is evaluated',
132
148
  start();
133
149
  start();
134
150
 
135
- expect(jest.getTimerCount()).toBe(1);
151
+ expect(vi.getTimerCount()).toBe(1);
136
152
  tick(10_000);
137
153
  expect(gc).toHaveBeenCalledTimes(1);
138
154
  });
@@ -14,8 +14,8 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- // Run by importAppCode.test.mjs in its own process: Jest can load neither Vite
18
- // nor a module URL with a query. Loads the build's importAppCode the way the dev
17
+ // Run by importAppCode.test.mjs in its own process, so it loads Vite and module
18
+ // URLs with a query as the dev server does, outside the test runner's module runtime. Loads the build's importAppCode the way the dev
19
19
  // server's JIT page builds do, then imports an app code file, imports it again
20
20
  // unchanged, edits it and imports it again. With `vite`, through Vite's SSR
21
21
  // module runner (@lowdefy/build linked, as in the monorepo); with `node`,
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import createDevServerExclude from './createDevServerExclude.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  function isExcluded(exclude, url) {
20
21
  return exclude.some((pattern) => pattern.test(url));
@@ -0,0 +1,36 @@
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
+ // The manager's proxy (startProxy) is the only HTTP client of this server, and
18
+ // reuses its connections to it. Node closes a connection left idle past
19
+ // keepAliveTimeout on a timer, and timers run before the event loop reads
20
+ // sockets. So when synchronous work blocks the loop for longer than the timer
21
+ // (a page build deserializing large build artifacts takes seconds), a request
22
+ // the proxy has already written is never read: the expired timer closes the
23
+ // socket over it, the client sees ECONNRESET, and a POST cannot be replayed
24
+ // because the proxy cannot tell whether the app ran it. With no timer here, the
25
+ // proxy's agent alone decides when an idle connection closes, and a request
26
+ // waits out the blocked loop instead.
27
+ function keepIdleConnectionsOpen() {
28
+ return {
29
+ name: 'lowdefy-keep-idle-connections-open',
30
+ configureServer(server) {
31
+ server.httpServer.keepAliveTimeout = 0;
32
+ },
33
+ };
34
+ }
35
+
36
+ export default keepIdleConnectionsOpen;
@@ -0,0 +1,104 @@
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 { spawn } from 'node:child_process';
18
+ import net from 'node:net';
19
+
20
+ import { afterEach, expect, test } from 'vitest';
21
+
22
+ const pluginUrl = new URL('./keepIdleConnectionsOpen.js', import.meta.url).href;
23
+
24
+ const BLOCK_MS = 1000;
25
+
26
+ // Runs in its own process, so its blocked event loop does not block the test's
27
+ // client. A timer far shorter than Node's default keeps the test quick; it
28
+ // expires during the block just as the default does in a long page build.
29
+ function serverScript({ applyPlugin }) {
30
+ return `
31
+ import http from 'node:http';
32
+ import keepIdleConnectionsOpen from ${JSON.stringify(pluginUrl)};
33
+ const server = http.createServer((req, res) => {
34
+ req.resume();
35
+ req.on('end', () => {
36
+ if (req.url === '/block') {
37
+ res.on('finish', () => setImmediate(() => {
38
+ const until = Date.now() + ${BLOCK_MS};
39
+ while (Date.now() < until);
40
+ }));
41
+ }
42
+ res.end('answered ' + req.url);
43
+ });
44
+ });
45
+ server.keepAliveTimeout = 100;
46
+ server.keepAliveTimeoutBuffer = 0;
47
+ ${applyPlugin ? 'keepIdleConnectionsOpen().configureServer({ httpServer: server });' : ''}
48
+ server.listen(0, '127.0.0.1', () => console.log(server.address().port));
49
+ `;
50
+ }
51
+
52
+ let serverProcess;
53
+
54
+ afterEach(() => {
55
+ serverProcess?.kill();
56
+ });
57
+
58
+ function startServer({ applyPlugin }) {
59
+ serverProcess = spawn(process.execPath, [
60
+ '--input-type=module',
61
+ '-e',
62
+ serverScript({ applyPlugin }),
63
+ ]);
64
+ return new Promise((resolve, reject) => {
65
+ serverProcess.once('error', reject);
66
+ serverProcess.stdout.once('data', (data) => resolve(Number(String(data))));
67
+ });
68
+ }
69
+
70
+ // Writes the second request on the first's connection while the server is
71
+ // blocked, as the proxy's agent does when it reuses an idle socket.
72
+ function postDuringBlock({ port }) {
73
+ return new Promise((resolve) => {
74
+ const socket = net.connect({ host: '127.0.0.1', port });
75
+ let responses = '';
76
+ let posted = false;
77
+ socket.on('error', (error) => resolve({ error: error.code }));
78
+ socket.on('close', () => resolve({ responses }));
79
+ socket.on('data', (data) => {
80
+ responses += String(data);
81
+ if (!posted && responses.includes('answered /block')) {
82
+ posted = true;
83
+ setTimeout(() => {
84
+ socket.write('POST /save HTTP/1.1\r\nHost: x\r\nContent-Length: 0\r\n\r\n');
85
+ }, 50);
86
+ }
87
+ if (responses.includes('answered /save')) {
88
+ socket.destroy();
89
+ }
90
+ });
91
+ socket.write('GET /block HTTP/1.1\r\nHost: x\r\n\r\n');
92
+ });
93
+ }
94
+
95
+ test('a keep-alive timer that expires while the event loop is blocked resets a request already sent', async () => {
96
+ const port = await startServer({ applyPlugin: false });
97
+ expect(await postDuringBlock({ port })).toEqual({ error: 'ECONNRESET' });
98
+ });
99
+
100
+ test('keepIdleConnectionsOpen answers a request sent while the event loop is blocked', async () => {
101
+ const port = await startServer({ applyPlugin: true });
102
+ const { responses } = await postDuringBlock({ port });
103
+ expect(responses).toContain('answered /save');
104
+ });
@@ -22,6 +22,7 @@ import { hideBin } from 'yargs/helpers';
22
22
  import pino from 'pino';
23
23
  import { createNodeLogger } from '@lowdefy/logger/node';
24
24
  import checkMockUserWarning from './processes/checkMockUserWarning.mjs';
25
+ import checkPendingPlugins from './processes/checkPendingPlugins.mjs';
25
26
  import initialBuild from './processes/initialBuild.mjs';
26
27
  import installPlugins from './processes/installPlugins.mjs';
27
28
  import lowdefyBuild from './processes/lowdefyBuild.mjs';
@@ -59,9 +60,16 @@ async function getContext() {
59
60
  destination: pino.destination({ dest: 1, sync: true }),
60
61
  }),
61
62
  options: {
63
+ // For tests only: how long the Vite child may sit unused before it stops
64
+ // (createIdleChild). Defaults to 3 minutes.
65
+ childIdleMs: env.LOWDEFY_SERVER_DEV_CHILD_IDLE_MS
66
+ ? Number(env.LOWDEFY_SERVER_DEV_CHILD_IDLE_MS)
67
+ : undefined,
62
68
  internalPort: env.LOWDEFY_SERVER_DEV_INTERNAL_PORT
63
69
  ? Number(env.LOWDEFY_SERVER_DEV_INTERNAL_PORT)
64
70
  : undefined,
71
+ // "true" or a network interface name: lowdefy dev --lan [interface].
72
+ lan: env.LOWDEFY_SERVER_DEV_LAN || undefined,
65
73
  owner: env.LOWDEFY_DEV_OWNER === 'hub' ? 'hub' : 'terminal',
66
74
  port: Number(argv.port ?? env.PORT ?? 3000),
67
75
  refResolver: argv.refResolver ?? env.LOWDEFY_BUILD_REF_RESOLVER,
@@ -84,6 +92,7 @@ async function getContext() {
84
92
 
85
93
  context.packageManagerCmd = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm';
86
94
  context.checkMockUserWarning = checkMockUserWarning(context);
95
+ context.checkPendingPlugins = checkPendingPlugins(context);
87
96
  context.initialBuild = initialBuild(context);
88
97
  context.installPlugins = installPlugins(context);
89
98
 
@@ -0,0 +1,49 @@
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 { pluginChecksNeedRebuild } from '@lowdefy/node-utils';
18
+
19
+ // The initial build lists the plugins it used but could not check, since they
20
+ // were not installed. The install after it added them, so the config builds
21
+ // once more when that checks something new, unless no checks run anyway.
22
+ // This runs after the first child answers, not before it: the checks only add
23
+ // warnings or errors, the first build's output serves meanwhile, and a large
24
+ // app's config build would otherwise double the time to a usable server on a
25
+ // fresh checkout. It is tracked as building, so
26
+ // lowdefy_build_status({ wait: true }) reads the checked build, and synced
27
+ // like a watcher's build. Open tabs are not reloaded: the checks change no
28
+ // output a tab reads, and a reload would reset the page someone is using. A
29
+ // failed build publishes nothing, so it is not synced either.
30
+ function checkPendingPlugins(context) {
31
+ return async () => {
32
+ if (
33
+ context.options.skipPluginChecks ||
34
+ !pluginChecksNeedRebuild({
35
+ buildDirectory: context.directories.build,
36
+ serverDirectory: context.directories.server,
37
+ })
38
+ ) {
39
+ return;
40
+ }
41
+ await context.buildActivity.track(async () => {
42
+ context.logger.info('Checking the plugins installed at start-up.');
43
+ await context.lowdefyBuild();
44
+ await context.syncServer();
45
+ });
46
+ };
47
+ }
48
+
49
+ export default checkPendingPlugins;
@@ -0,0 +1,107 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import fs from 'fs';
18
+ import os from 'os';
19
+ import path from 'path';
20
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
21
+
22
+ import checkPendingPlugins from './checkPendingPlugins.mjs';
23
+
24
+ let buildDirectory;
25
+ let calls;
26
+
27
+ function createContext({ lowdefyBuild, skipPluginChecks } = {}) {
28
+ const record = (name, impl) =>
29
+ vi.fn(async () => {
30
+ calls.push(name);
31
+ if (impl) await impl();
32
+ });
33
+ return {
34
+ buildActivity: {
35
+ track: vi.fn(async (task) => {
36
+ calls.push('busy');
37
+ try {
38
+ return await task();
39
+ } finally {
40
+ calls.push('idle');
41
+ }
42
+ }),
43
+ },
44
+ directories: { build: buildDirectory, server: buildDirectory },
45
+ logger: { info: vi.fn() },
46
+ options: { skipPluginChecks },
47
+ lowdefyBuild: record('lowdefyBuild', lowdefyBuild),
48
+ reloadClients: record('reloadClients'),
49
+ syncServer: record('syncServer'),
50
+ };
51
+ }
52
+
53
+ function writePending(packages) {
54
+ fs.writeFileSync(
55
+ path.join(buildDirectory, 'plugin-checks-pending.json'),
56
+ JSON.stringify({ packages })
57
+ );
58
+ }
59
+
60
+ beforeEach(() => {
61
+ calls = [];
62
+ buildDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-check-pending-plugins-'));
63
+ });
64
+
65
+ afterEach(() => {
66
+ fs.rmSync(buildDirectory, { recursive: true, force: true });
67
+ });
68
+
69
+ test('checkPendingPlugins does nothing when no plugin checks are pending', async () => {
70
+ const context = createContext();
71
+ await checkPendingPlugins(context)();
72
+ expect(calls).toEqual([]);
73
+ });
74
+
75
+ test('checkPendingPlugins builds and syncs as one tracked change, without reloading tabs, when checks are pending', async () => {
76
+ writePending([{ name: '@acme/plugin', schemaChecked: true }]);
77
+ const context = createContext();
78
+ await checkPendingPlugins(context)();
79
+ // Warnings held by the initial build are given by this one, so it passes no options.
80
+ expect(context.lowdefyBuild.mock.calls).toEqual([[]]);
81
+ expect(calls).toEqual(['busy', 'lowdefyBuild', 'syncServer', 'idle']);
82
+ });
83
+
84
+ test('checkPendingPlugins rejects with the build error and does not sync when the build fails', async () => {
85
+ writePending([{ name: '@acme/plugin', schemaChecked: true }]);
86
+ const context = createContext({
87
+ lowdefyBuild: () => {
88
+ throw new Error('Build failed with 1 error(s).');
89
+ },
90
+ });
91
+ await expect(checkPendingPlugins(context)()).rejects.toThrow('Build failed with 1 error(s).');
92
+ expect(calls).toEqual(['busy', 'lowdefyBuild', 'idle']);
93
+ });
94
+
95
+ test('checkPendingPlugins does nothing with skipPluginChecks, even when checks are pending', async () => {
96
+ writePending([{ name: '@acme/plugin', schemaChecked: true }]);
97
+ const context = createContext({ skipPluginChecks: true });
98
+ await checkPendingPlugins(context)();
99
+ expect(calls).toEqual([]);
100
+ });
101
+
102
+ test('checkPendingPlugins does nothing when the pending plugins give nothing new to check', async () => {
103
+ writePending([{ name: '@acme/connection-only', schemaChecked: false }]);
104
+ const context = createContext();
105
+ await checkPendingPlugins(context)();
106
+ expect(calls).toEqual([]);
107
+ });