@lowdefy/server-dev 7.0.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/checkSharedCollectionIds.js +20 -9
  44. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
  45. package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
  46. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  47. package/lib/docs/dataSets/getDataStore.js +11 -3
  48. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  49. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  50. package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
  51. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  52. package/lib/docs/dataSets/openDataSession.js +36 -20
  53. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
  54. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  55. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  56. package/lib/docs/dataSets/readDataSet.js +34 -19
  57. package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
  58. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  59. package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
  60. package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
  61. package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
  62. package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
  63. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  64. package/lib/docs/devEventBus.js +7 -2
  65. package/lib/docs/devEventBus.test.mjs +12 -10
  66. package/lib/docs/devToolDefinitions.js +87 -135
  67. package/lib/docs/device/buildDeviceCommand.js +103 -0
  68. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  69. package/lib/docs/device/captureDevice.js +85 -0
  70. package/lib/docs/device/checkShownPage.js +56 -0
  71. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  72. package/lib/docs/device/deviceAction.js +74 -0
  73. package/lib/docs/device/deviceTools.test.mjs +604 -0
  74. package/lib/docs/device/findDeviceTab.js +50 -0
  75. package/lib/docs/device/findDeviceTarget.js +73 -0
  76. package/lib/docs/device/injectDevice.js +160 -0
  77. package/lib/docs/device/listDevices.js +100 -0
  78. package/lib/docs/device/listDevices.test.mjs +105 -0
  79. package/lib/docs/device/runDeviceJourney.js +68 -0
  80. package/lib/docs/device/runDeviceSteps.js +164 -0
  81. package/lib/docs/device/screenshotDevice.js +68 -0
  82. package/lib/docs/device/sendDeviceStep.js +52 -0
  83. package/lib/docs/device/startDevice.js +150 -0
  84. package/lib/docs/docs.test.mjs +44 -28
  85. package/lib/docs/docsIndex.test.mjs +1 -0
  86. package/lib/docs/findConfig.js +3 -4
  87. package/lib/docs/findPageBlock.js +35 -0
  88. package/lib/docs/findPageBlock.test.mjs +45 -0
  89. package/lib/docs/fitResponse.js +18 -17
  90. package/lib/docs/fitResponse.test.mjs +18 -0
  91. package/lib/docs/getBrowser.js +4 -4
  92. package/lib/docs/getBrowser.test.mjs +32 -16
  93. package/lib/docs/getBuildId.test.mjs +1 -0
  94. package/lib/docs/getBuildStatus.js +29 -3
  95. package/lib/docs/getBuildStatus.test.mjs +108 -12
  96. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  97. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  98. package/lib/docs/getHazards.js +4 -1
  99. package/lib/docs/getHazards.test.mjs +9 -7
  100. package/lib/docs/getOverview.js +22 -44
  101. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  102. package/lib/docs/getStaleStatus.test.mjs +1 -0
  103. package/lib/docs/inspectState.js +78 -3
  104. package/lib/docs/inspectState.test.mjs +61 -9
  105. package/lib/docs/inspectStateFromTab.js +38 -6
  106. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  107. package/lib/docs/inspectStateHeadless.js +98 -34
  108. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  109. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  110. package/lib/docs/installHeadlessShell.js +5 -2
  111. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  112. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  113. package/lib/docs/isDeepEqual.js +37 -0
  114. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  115. package/lib/docs/isPageReady.test.mjs +1 -0
  116. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  117. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  118. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  119. package/lib/docs/launchBrowser.test.mjs +8 -8
  120. package/lib/docs/listTypes.js +58 -8
  121. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  122. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  123. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  124. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  125. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  126. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  127. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  128. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  129. package/lib/docs/pollTab.js +100 -0
  130. package/lib/docs/pollTab.test.mjs +64 -0
  131. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  132. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  133. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  134. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  135. package/lib/docs/rails/findExternalBlocks.js +3 -3
  136. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  137. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  138. package/lib/docs/readJourneySession.js +1 -1
  139. package/lib/docs/reportDevToolFault.js +29 -0
  140. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  141. package/lib/docs/requestRestart.test.mjs +1 -0
  142. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  143. package/lib/docs/resolveSource.js +2 -2
  144. package/lib/docs/resolveSource.test.mjs +6 -6
  145. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  146. package/lib/docs/runCheck.test.mjs +3 -3
  147. package/lib/docs/runCheckChild.js +2 -1
  148. package/lib/docs/runEndpoint.js +23 -10
  149. package/lib/docs/runEndpoint.test.mjs +42 -37
  150. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  151. package/lib/docs/runJourney.js +21 -1
  152. package/lib/docs/runJourney.test.mjs +119 -99
  153. package/lib/docs/runJourneyDataSet.test.mjs +26 -26
  154. package/lib/docs/runJourneySteps.js +8 -29
  155. package/lib/docs/runRequest.js +6 -6
  156. package/lib/docs/runRequest.test.mjs +22 -22
  157. package/lib/docs/screenshotPage.js +6 -7
  158. package/lib/docs/screenshotPage.test.mjs +46 -46
  159. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  160. package/lib/docs/searchDocs.test.mjs +1 -0
  161. package/lib/docs/searchIcons.test.mjs +5 -5
  162. package/lib/docs/selectFinalState.test.mjs +1 -0
  163. package/lib/docs/serverErrorStore.test.mjs +4 -4
  164. package/lib/docs/setupTestFixtures.mjs +25 -0
  165. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  166. package/lib/docs/tabAvailable.js +1 -1
  167. package/lib/docs/tabChannel.js +90 -14
  168. package/lib/docs/tabChannel.test.mjs +40 -15
  169. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  170. package/lib/docs/validateStateSelection.test.mjs +1 -0
  171. package/lib/docs/validateViewport.test.mjs +1 -0
  172. package/lib/docs/waitForBuild.test.mjs +1 -0
  173. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  174. package/lib/docs/withDataSession.js +2 -2
  175. package/lib/server/applyDataSetRedirect.js +14 -5
  176. package/lib/server/applyDataSetRedirect.test.mjs +121 -15
  177. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
  178. package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
  179. package/lib/server/auth/getHeadlessUser.js +6 -0
  180. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  181. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  182. package/lib/server/contextMapBudget.test.mjs +3 -3
  183. package/lib/server/continueJitKeys.test.mjs +1 -0
  184. package/lib/server/createLowdefyContext.js +8 -4
  185. package/lib/server/createLowdefyContext.test.mjs +38 -35
  186. package/lib/server/getClientAddress.test.mjs +2 -2
  187. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  188. package/lib/server/importAppCode.test.mjs +2 -2
  189. package/lib/server/jitPageBuilder.js +27 -3
  190. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  191. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  192. package/lib/server/jitPageBuilder.test.mjs +4 -4
  193. package/lib/server/journeyCookies.test.mjs +1 -0
  194. package/lib/server/loadDynamicJsMap.js +10 -1
  195. package/lib/server/log/createHandleError.js +10 -5
  196. package/lib/server/log/createHandleError.test.mjs +19 -8
  197. package/lib/server/log/createLogger.test.mjs +2 -2
  198. package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
  199. package/lib/server/mutants/listMutants.test.mjs +1 -0
  200. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  201. package/lib/server/mutants/operators.test.mjs +1 -0
  202. package/lib/server/pageBuildRecords.test.mjs +1 -0
  203. package/lib/server/pageCache.test.mjs +1 -0
  204. package/lib/server/pageRebuilds.test.mjs +3 -3
  205. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  206. package/lib/server/pruneJitMaps.test.mjs +1 -0
  207. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  208. package/lib/server/readInstanceRecord.test.mjs +24 -8
  209. package/lib/server/readMergedMaps.test.mjs +1 -0
  210. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  211. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  212. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  213. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  214. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  215. package/lib/server/startIdleGc.test.mjs +25 -9
  216. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  217. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  218. package/manager/getContext.mjs +11 -2
  219. package/manager/processes/checkPendingPlugins.mjs +49 -0
  220. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  221. package/manager/processes/createIdleChild.mjs +141 -0
  222. package/manager/processes/createIdleChild.test.mjs +209 -0
  223. package/manager/processes/initialBuild.mjs +4 -15
  224. package/manager/processes/initialBuild.test.mjs +8 -37
  225. package/manager/processes/lowdefyBuild.mjs +11 -7
  226. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
  227. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  228. package/manager/processes/restartServer.test.mjs +63 -15
  229. package/manager/processes/shutdownServer.test.mjs +3 -3
  230. package/manager/processes/startFirstServer.test.mjs +23 -22
  231. package/manager/processes/startMailSink.mjs +11 -3
  232. package/manager/processes/startMailSink.test.mjs +28 -2
  233. package/manager/processes/startProxy.mjs +158 -27
  234. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  235. package/manager/processes/startProxy.test.mjs +127 -2
  236. package/manager/processes/startServer.mjs +5 -7
  237. package/manager/processes/startServer.test.mjs +10 -9
  238. package/manager/processes/syncServer.mjs +31 -4
  239. package/manager/processes/syncServer.test.mjs +71 -6
  240. package/manager/processes/waitForDevServer.test.mjs +21 -6
  241. package/manager/run.mjs +32 -8
  242. package/manager/utils/BatchChanges.mjs +1 -1
  243. package/manager/utils/BatchChanges.test.mjs +4 -4
  244. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  245. package/manager/utils/checkPairing.mjs +45 -0
  246. package/manager/utils/checkPairing.test.mjs +53 -0
  247. package/manager/utils/createBuildActivity.mjs +5 -1
  248. package/manager/utils/createBuildActivity.test.mjs +2 -2
  249. package/manager/utils/createChangeSignal.test.mjs +5 -5
  250. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  251. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  252. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  253. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  254. package/manager/utils/createGlobIgnore.mjs +45 -0
  255. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  256. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  257. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  258. package/manager/utils/createIdleGc.test.mjs +31 -15
  259. package/manager/utils/createLanPairing.mjs +34 -0
  260. package/manager/utils/createLanPairing.test.mjs +46 -0
  261. package/manager/utils/createRequestActivity.mjs +30 -3
  262. package/manager/utils/createRequestActivity.test.mjs +76 -22
  263. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  264. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  265. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  266. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  267. package/manager/utils/findSignInCode.test.mjs +33 -0
  268. package/manager/utils/formatLanPairing.mjs +32 -0
  269. package/manager/utils/formatLanPairing.test.mjs +40 -0
  270. package/manager/utils/getLanAddress.mjs +83 -0
  271. package/manager/utils/getLanAddress.test.mjs +70 -0
  272. package/manager/utils/importFresh.test.mjs +1 -0
  273. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  274. package/manager/utils/pluginTypeCache.mjs +100 -0
  275. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  276. package/manager/utils/pruneRecordings.test.mjs +1 -0
  277. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  278. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  279. package/manager/utils/readBasePath.test.mjs +1 -0
  280. package/manager/utils/readManagerVersion.test.mjs +1 -0
  281. package/manager/utils/readPluginDefinitions.mjs +6 -6
  282. package/manager/utils/renderTerminalQr.mjs +54 -0
  283. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  284. package/manager/utils/setupWatcher.mjs +19 -4
  285. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  286. package/manager/utils/waitForChildExit.test.mjs +2 -2
  287. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  288. package/manager/watchers/envWatcher.mjs +3 -0
  289. package/manager/watchers/envWatcher.test.mjs +19 -7
  290. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  291. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  292. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  293. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  294. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  295. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  296. package/manager/watchers/resolveFile.mjs +46 -0
  297. package/manager/watchers/resolveFile.test.mjs +67 -0
  298. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  299. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  300. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  301. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  302. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  303. package/package.json +50 -49
  304. package/package.original.json +50 -49
  305. package/src/app.js +83 -85
  306. package/src/html/renderDevPage.test.mjs +1 -0
  307. package/src/lib/getPathSegments.js +16 -1
  308. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  309. package/src/lib/isTabAnswer.js +32 -0
  310. package/src/lib/isTabChannelCaller.js +35 -0
  311. package/src/middleware/apiContext.js +4 -2
  312. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  313. package/src/middleware/errorHandler.js +33 -45
  314. package/src/middleware/errorHandler.test.mjs +10 -10
  315. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  316. package/src/middleware/localDevToolsOnly.js +13 -1
  317. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  318. package/src/middleware/noStore.test.mjs +1 -0
  319. package/src/middleware/staleFlag.test.mjs +1 -0
  320. package/src/middleware/stampCaller.test.mjs +1 -0
  321. package/src/routes/agentBearer.test.mjs +183 -0
  322. package/src/routes/auth.test.mjs +10 -10
  323. package/src/routes/clientError.js +21 -4
  324. package/src/routes/clientError.test.mjs +127 -0
  325. package/src/routes/devInspect.js +6 -51
  326. package/src/routes/devInspect.test.mjs +128 -3
  327. package/src/routes/devRecording.js +6 -17
  328. package/src/routes/devRecording.test.mjs +54 -3
  329. package/src/routes/docs/buildStatus.test.mjs +6 -6
  330. package/src/routes/docs/events.test.mjs +4 -4
  331. package/src/routes/docs/find.js +3 -3
  332. package/src/routes/docs/journey.test.mjs +8 -8
  333. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  334. package/src/routes/docs/loadDocsRoutes.js +70 -0
  335. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  336. package/src/routes/docs/mcp.test.mjs +5 -5
  337. package/src/routes/docs/mutants.js +7 -0
  338. package/src/routes/docs/mutants.test.mjs +20 -6
  339. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  340. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  341. package/src/routes/docs/restart.test.mjs +1 -0
  342. package/src/routes/endpoints.js +24 -0
  343. package/src/routes/endpointsLink.test.mjs +111 -0
  344. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  345. package/src/routes/jitPage.js +13 -1
  346. package/src/routes/jitPage.test.mjs +36 -11
  347. package/src/routes/mcp.js +6 -0
  348. package/src/routes/mcp.test.mjs +23 -8
  349. package/src/routes/mcpMemberToken.test.mjs +8 -8
  350. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  351. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  352. package/src/routes/mobileRoutes.test.mjs +223 -0
  353. package/src/routes/mobileSignIn.js +58 -0
  354. package/src/routes/mobileSignIn.test.mjs +59 -0
  355. package/src/routes/mobileSignInCallback.js +34 -0
  356. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  357. package/src/routes/mountDevPageRoutes.js +10 -2
  358. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  359. package/src/routes/mountMobileWellKnown.js +35 -0
  360. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  361. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  362. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  363. package/src/routes/reload.js +101 -20
  364. package/src/routes/reload.test.mjs +153 -0
  365. package/src/routes/request.js +1 -22
  366. package/src/routes/request.test.mjs +7 -24
  367. package/src/routes/requestBody.test.mjs +14 -27
  368. package/src/routes/websocket.test.mjs +2 -2
  369. package/src/routes/wellKnownFallback.test.mjs +2 -2
  370. package/src/websocket/devWebSocket.test.mjs +12 -12
  371. package/vite.config.js +13 -1
  372. package/client/feedback/FeedbackMount.jsx +0 -83
  373. package/client/feedback/FeedbackOverlay.jsx +0 -904
  374. package/client/feedback/captureTabScreenshot.js +0 -84
  375. package/client/feedback/copyToClipboard.js +0 -45
  376. package/client/feedback/drawAnnotationsSvg.js +0 -119
  377. package/client/feedback/feedbackStyles.js +0 -304
  378. package/client/feedback/pinResponsiveImages.js +0 -59
  379. package/client/feedback/sendFeedback.js +0 -39
  380. package/client/feedback/useFeedbackToggle.js +0 -70
  381. package/client/recorder/buildEngineRecord.js +0 -37
  382. package/client/recorder/buildInteractionRecord.js +0 -64
  383. package/client/recorder/buildTraceEvent.js +0 -57
  384. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  385. package/client/recorder/chunkRecords.js +0 -69
  386. package/client/recorder/chunkRecords.test.mjs +0 -59
  387. package/client/recorder/collectEventEndpoints.js +0 -40
  388. package/client/recorder/collectEventRequests.js +0 -39
  389. package/client/recorder/createPairingBuffer.js +0 -187
  390. package/client/recorder/createPasswordRedactor.js +0 -84
  391. package/client/recorder/createRecordBatcher.js +0 -54
  392. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  393. package/client/recorder/createRecordingSession.js +0 -61
  394. package/client/recorder/createRecordingSession.test.mjs +0 -72
  395. package/client/recorder/diffStateWrites.js +0 -77
  396. package/client/recorder/diffStateWrites.test.mjs +0 -66
  397. package/client/recorder/isEventCall.js +0 -30
  398. package/client/recorder/jsonType.js +0 -39
  399. package/client/recorder/sendRecords.js +0 -40
  400. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  401. package/lib/docs/checkpointPaths.js +0 -91
  402. package/lib/docs/checkpointStore.js +0 -243
  403. package/lib/docs/checkpointToMocks.js +0 -65
  404. package/lib/docs/configCheckpoints.test.mjs +0 -156
  405. package/lib/docs/createConfigCheckpoint.js +0 -92
  406. package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
  407. package/lib/docs/devMockRegistry.js +0 -68
  408. package/lib/docs/enrichFeedback.js +0 -71
  409. package/lib/docs/evalOperator.js +0 -49
  410. package/lib/docs/evalOperator.test.mjs +0 -157
  411. package/lib/docs/evalOperatorHeadless.js +0 -159
  412. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  413. package/lib/docs/evalOperatorInTab.js +0 -49
  414. package/lib/docs/formatFeedback.js +0 -142
  415. package/lib/docs/formatFeedback.test.mjs +0 -252
  416. package/lib/docs/getPluginDoc.js +0 -53
  417. package/lib/docs/listConfigCheckpoints.js +0 -55
  418. package/lib/docs/loadState.js +0 -220
  419. package/lib/docs/revertConfigCheckpoint.js +0 -73
  420. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  421. package/lib/docs/scaffoldPage.js +0 -77
  422. package/lib/docs/scaffoldPage.test.mjs +0 -97
  423. package/lib/docs/snapshotState.js +0 -67
  424. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  425. package/manager/watchers/listServerSidePackages.mjs +0 -47
  426. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  427. package/src/routes/docs/checkpointsCreate.js +0 -28
  428. package/src/routes/docs/evalOperator.js +0 -70
  429. package/src/routes/docs/inspectState.js +0 -59
  430. package/src/routes/docs/loadState.js +0 -51
  431. package/src/routes/docs/pluginDoc.js +0 -33
  432. package/src/routes/docs/plugins.js +0 -23
  433. package/src/routes/docs/runEndpoint.js +0 -54
  434. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  435. package/src/routes/docs/runRequest.js +0 -53
  436. package/src/routes/docs/runRequest.test.mjs +0 -92
  437. package/src/routes/docs/schema.js +0 -37
  438. package/src/routes/docs/screenshot.js +0 -120
  439. package/src/routes/docs/screenshot.test.mjs +0 -117
  440. package/src/routes/docs/search.js +0 -40
  441. package/src/routes/docs/snapshotState.js +0 -50
  442. package/src/routes/docs/stateCheckpointsList.js +0 -26
  443. package/src/routes/docs/types.js +0 -33
  444. package/src/routes/feedback.js +0 -107
  445. package/src/routes/feedback.test.mjs +0 -204
@@ -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,15 +92,16 @@ 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
 
90
99
  // Wrap lowdefyBuild to capture and store the shallow build result
91
100
  const buildFn = lowdefyBuild(context);
92
- context.lowdefyBuild = async () => {
101
+ context.lowdefyBuild = async (buildOptions) => {
93
102
  let result;
94
103
  try {
95
- result = await buildFn();
104
+ result = await buildFn(buildOptions);
96
105
  } catch (error) {
97
106
  context.lastBuildFailed = true;
98
107
  throw error;
@@ -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;
@@ -0,0 +1,209 @@
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 { vi, afterEach, expect, test } from 'vitest';
18
+
19
+ import createIdleChild from './createIdleChild.mjs';
20
+ import syncServer from './syncServer.mjs';
21
+
22
+ const IDLE_MS = 180000;
23
+
24
+ let idleChild;
25
+
26
+ afterEach(() => {
27
+ idleChild?.close();
28
+ idleChild = undefined;
29
+ vi.useRealTimers();
30
+ });
31
+
32
+ function createContext({ snapshot = {}, busy = false } = {}) {
33
+ let clock = 1000000;
34
+ const context = {
35
+ clock: {
36
+ now: () => clock,
37
+ advance: (ms) => {
38
+ clock += ms;
39
+ },
40
+ },
41
+ activity: { activeRequests: 0, lastActivityAt: 1000000, openTabs: 0, ...snapshot },
42
+ buildActivity: { isBusy: vi.fn(() => busy) },
43
+ devServer: { pid: 1 },
44
+ events: [],
45
+ instance: { update: vi.fn() },
46
+ logger: { info: vi.fn(), error: vi.fn() },
47
+ serverArtifacts: { check: vi.fn(() => ({ install: false, restart: true })), record: vi.fn() },
48
+ };
49
+ context.requestActivity = { snapshot: () => context.activity };
50
+ context.shutdownServer = vi.fn(() => {
51
+ context.events.push('shutdown');
52
+ context.devServer = null;
53
+ });
54
+ context.restartServer = vi.fn(async () => {
55
+ context.events.push('restart');
56
+ context.devServer = { pid: 2 };
57
+ });
58
+ context.syncServer = syncServer(context);
59
+ context.syncServer.startFirst(async () => {});
60
+ return context;
61
+ }
62
+
63
+ function create(context) {
64
+ idleChild = createIdleChild(context, { idleMs: IDLE_MS, now: context.clock.now });
65
+ context.idleChild = idleChild;
66
+ return idleChild;
67
+ }
68
+
69
+ test('createIdleChild stops a child unused for the idle limit through shutdownServer', async () => {
70
+ const context = createContext();
71
+ create(context);
72
+ context.clock.advance(IDLE_MS);
73
+
74
+ expect(await idleChild.stop()).toBe(true);
75
+ expect(context.shutdownServer).toHaveBeenCalledTimes(1);
76
+ expect(idleChild.isStopped()).toBe(true);
77
+ expect(context.instance.update).toHaveBeenLastCalledWith({ child: 'stopped' });
78
+ });
79
+
80
+ test.each([
81
+ ['used within the idle limit', { lastActivityAt: 1000000 + 60000 }, false],
82
+ ['with a request in flight', { activeRequests: 1 }, false],
83
+ ['with a tab open', { openTabs: 1 }, false],
84
+ ['while a build runs', {}, true],
85
+ ])('createIdleChild keeps a child %s', async (_, snapshot, busy) => {
86
+ const context = createContext({ snapshot, busy });
87
+ create(context);
88
+ context.clock.advance(IDLE_MS);
89
+
90
+ expect(await idleChild.stop()).toBe(false);
91
+ expect(context.shutdownServer).not.toHaveBeenCalled();
92
+ expect(idleChild.isStopped()).toBe(false);
93
+ });
94
+
95
+ test('createIdleChild checks on a timer once started', async () => {
96
+ vi.useFakeTimers();
97
+ const context = createContext();
98
+ create(context);
99
+ idleChild.start();
100
+ expect(context.instance.update).toHaveBeenCalledWith({ child: 'running' });
101
+
102
+ vi.advanceTimersByTime(10000);
103
+ await vi.runOnlyPendingTimersAsync();
104
+ expect(context.shutdownServer).not.toHaveBeenCalled();
105
+
106
+ context.clock.advance(IDLE_MS);
107
+ await vi.advanceTimersByTimeAsync(10000);
108
+ expect(context.shutdownServer).toHaveBeenCalledTimes(1);
109
+ expect(idleChild.isStopped()).toBe(true);
110
+ });
111
+
112
+ test('createIdleChild wakes a stopped child once for two requests at once', async () => {
113
+ const context = createContext();
114
+ create(context);
115
+ context.clock.advance(IDLE_MS);
116
+ await idleChild.stop();
117
+
118
+ await Promise.all([idleChild.wake(), idleChild.wake()]);
119
+
120
+ expect(context.restartServer).toHaveBeenCalledTimes(1);
121
+ expect(idleChild.isStopped()).toBe(false);
122
+ expect(context.instance.update).toHaveBeenLastCalledWith({ child: 'running' });
123
+ });
124
+
125
+ test('createIdleChild marks a restart built while stopped pending and starts the child once on wake', async () => {
126
+ const context = createContext();
127
+ create(context);
128
+ context.clock.advance(IDLE_MS);
129
+ await idleChild.stop();
130
+
131
+ await context.syncServer();
132
+ await context.syncServer({ restart: true });
133
+ expect(context.restartServer).not.toHaveBeenCalled();
134
+ expect(idleChild.isRestartPending()).toBe(true);
135
+
136
+ await idleChild.wake();
137
+ expect(context.restartServer).toHaveBeenCalledTimes(1);
138
+ expect(idleChild.isRestartPending()).toBe(false);
139
+ expect(context.events).toEqual(['shutdown', 'restart']);
140
+ });
141
+
142
+ test('createIdleChild does not start a second child when a queued sync started one first', async () => {
143
+ const context = createContext();
144
+ create(context);
145
+ context.clock.advance(IDLE_MS);
146
+ await idleChild.stop();
147
+
148
+ // A sync already in the queue when the wake comes sees the child running and restarts it.
149
+ let finishBuild;
150
+ const synced = context.syncServer.run(
151
+ () =>
152
+ new Promise((resolve) => {
153
+ finishBuild = resolve;
154
+ })
155
+ );
156
+ const woken = idleChild.wake();
157
+ context.devServer = { pid: 3 };
158
+ await new Promise((resolve) => setTimeout(resolve, 10));
159
+ finishBuild();
160
+ await Promise.all([synced, woken]);
161
+
162
+ expect(context.restartServer).not.toHaveBeenCalled();
163
+ });
164
+
165
+ test('createIdleChild clears a pending restart when a queued sync started the child first', async () => {
166
+ const context = createContext();
167
+ create(context);
168
+ context.clock.advance(IDLE_MS);
169
+ await idleChild.stop();
170
+ await context.syncServer();
171
+ expect(idleChild.isRestartPending()).toBe(true);
172
+
173
+ let finishInstall;
174
+ const synced = context.syncServer.run(
175
+ () =>
176
+ new Promise((resolve) => {
177
+ finishInstall = resolve;
178
+ })
179
+ );
180
+ const woken = idleChild.wake();
181
+ context.devServer = { pid: 3 };
182
+ await new Promise((resolve) => setTimeout(resolve, 10));
183
+ finishInstall();
184
+ await Promise.all([synced, woken]);
185
+
186
+ expect(context.restartServer).not.toHaveBeenCalled();
187
+ expect(idleChild.isRestartPending()).toBe(false);
188
+ });
189
+
190
+ test('createIdleChild does not stop a child that was used while the stop waited in the queue', async () => {
191
+ const context = createContext();
192
+ create(context);
193
+ context.clock.advance(IDLE_MS);
194
+ let finishSync;
195
+ const synced = context.syncServer.run(
196
+ () =>
197
+ new Promise((resolve) => {
198
+ finishSync = resolve;
199
+ })
200
+ );
201
+ const stopping = idleChild.stop();
202
+ context.activity.activeRequests = 1;
203
+ await new Promise((resolve) => setTimeout(resolve, 10));
204
+ finishSync();
205
+ await synced;
206
+
207
+ expect(await stopping).toBe(false);
208
+ expect(context.shutdownServer).not.toHaveBeenCalled();
209
+ });
@@ -15,26 +15,15 @@
15
15
  limitations under the License.
16
16
  */
17
17
 
18
- import { pluginChecksNeedRebuild } from '@lowdefy/node-utils';
19
-
20
18
  function initialBuild(context) {
21
19
  return async () => {
22
20
  context.readDotEnv();
23
- await context.lowdefyBuild();
21
+ // This build holds its warnings for plugins it could not check: the install
22
+ // below adds them, and checkPendingPlugins builds again once the server
23
+ // answers, warning for any still missing.
24
+ await context.lowdefyBuild({ pluginInstallFollows: true });
24
25
  await context.checkMockUserWarning();
25
26
  await context.installPlugins();
26
- // The build lists the plugins it used but could not check, since they were
27
- // not installed. The install above added them, so build once more when that
28
- // checks something new, unless no checks run this time anyway.
29
- if (
30
- !context.options.skipPluginChecks &&
31
- pluginChecksNeedRebuild({
32
- buildDirectory: context.directories.build,
33
- serverDirectory: context.directories.server,
34
- })
35
- ) {
36
- await context.lowdefyBuild();
37
- }
38
27
  };
39
28
  }
40
29