@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
@@ -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));
@@ -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
+ });
@@ -0,0 +1,141 @@
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
+ const IDLE_CHILD_MS = 3 * 60 * 1000;
18
+
19
+ /*
20
+ Stops the Vite child of a dev server nobody uses, and starts it again on the
21
+ next request that is use. The child holds most of an idle server's memory
22
+ (360 to 720 MB measured); the manager keeps its port, watchers and build
23
+ state, so a wake costs a child start and a fresh JIT build of each page as it
24
+ is first requested, not a full restart. The hub's own stop of the whole
25
+ server is unchanged.
26
+
27
+ Unused means: no request in flight, no build running, no tab holding a reload
28
+ stream open, and nothing counted as activity for idleMs. These are the
29
+ manager's own activity counts (createRequestActivity), the record the hub
30
+ reads too.
31
+
32
+ The stop goes through shutdownServer, as any stop does, so a later start
33
+ waits for the old child to exit. Stop and wake both run in syncServer's
34
+ queue, so neither interleaves with a restart or a plugin install. While the
35
+ child is stopped, the proxy answers requests that are not use at once
36
+ (startProxy), and syncServer marks a restart pending instead of starting it.
37
+
38
+ `state` in the instance record stays `ready`: the hub treats any other state
39
+ as busy and never stops the server, and waits on `ready`. The record's
40
+ `child` field says `stopped` or `running`; older hubs and shims ignore it.
41
+ */
42
+ function createIdleChild(context, { idleMs = IDLE_CHILD_MS, checkMs, now = Date.now } = {}) {
43
+ let stopped = false;
44
+ let restartPending = false;
45
+ let waking = null;
46
+ let timer = null;
47
+
48
+ function isUnused() {
49
+ const { activeRequests, lastActivityAt, openTabs } = context.requestActivity.snapshot();
50
+ return (
51
+ !context.buildActivity.isBusy() &&
52
+ activeRequests === 0 &&
53
+ openTabs === 0 &&
54
+ now() - lastActivityAt >= idleMs
55
+ );
56
+ }
57
+
58
+ function stop() {
59
+ return context.syncServer.run(async () => {
60
+ // Checked again in the queue: a request or a build may have come since.
61
+ if (stopped || waking !== null || !context.devServer || !isUnused()) {
62
+ return false;
63
+ }
64
+ stopped = true;
65
+ context.instance.update({ child: 'stopped' });
66
+ context.shutdownServer();
67
+ context.logger.info(
68
+ { spin: 'succeed' },
69
+ `Stopped the web server after ${Math.round(
70
+ idleMs / 1000
71
+ )} s unused. The next request starts it again.`
72
+ );
73
+ return true;
74
+ });
75
+ }
76
+
77
+ // Only a request that is use calls this (startProxy). Two at once start one child.
78
+ function wake() {
79
+ if (!stopped) {
80
+ return waking ?? Promise.resolve();
81
+ }
82
+ stopped = false;
83
+ context.instance.update({ child: 'running' });
84
+ waking = context.syncServer
85
+ .run(async () => {
86
+ // A sync queued ahead of the wake (the install path) already started one, with the
87
+ // changes built while stopped.
88
+ if (context.devServer) {
89
+ restartPending = false;
90
+ return;
91
+ }
92
+ context.logger.info(
93
+ restartPending
94
+ ? 'Starting the web server again, with the changes built while it was stopped.'
95
+ : 'Starting the web server again.'
96
+ );
97
+ restartPending = false;
98
+ // The normal start path: waits for the stopped child to exit, records
99
+ // the server artifacts and waits for the new child to answer.
100
+ await context.restartServer();
101
+ })
102
+ .finally(() => {
103
+ waking = null;
104
+ });
105
+ return waking;
106
+ }
107
+
108
+ function markRestartPending() {
109
+ restartPending = true;
110
+ }
111
+
112
+ function start() {
113
+ context.instance.update({ child: 'running' });
114
+ const interval = checkMs ?? Math.min(10000, Math.max(250, Math.floor(idleMs / 4)));
115
+ timer = setInterval(() => {
116
+ if (!stopped && waking === null && isUnused()) {
117
+ stop().catch((error) => context.logger.error(error));
118
+ }
119
+ }, interval);
120
+ // The check must not keep the manager alive on shutdown.
121
+ timer.unref?.();
122
+ }
123
+
124
+ function close() {
125
+ clearInterval(timer);
126
+ timer = null;
127
+ }
128
+
129
+ return {
130
+ close,
131
+ isRestartPending: () => restartPending,
132
+ isStopped: () => stopped,
133
+ markRestartPending,
134
+ start,
135
+ stop,
136
+ wake,
137
+ };
138
+ }
139
+
140
+ export { IDLE_CHILD_MS };
141
+ export default createIdleChild;