@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -16,6 +16,7 @@
16
16
 
17
17
  import { spawn } from 'child_process';
18
18
  import crypto from 'crypto';
19
+ import readline from 'readline';
19
20
 
20
21
  import createServerEnv from '../utils/createServerEnv.mjs';
21
22
  import killTaggedBrowser from '../utils/killTaggedBrowser.mjs';
@@ -98,14 +99,11 @@ function startServer(context) {
98
99
  }
99
100
  );
100
101
 
102
+ // Whole lines, not chunks: a chunk boundary can fall inside a line, which
103
+ // split an uncaught crash's stack into many separate ERROR fragments.
101
104
  const stdErrLineHandler = createStdErrLineHandler({ context });
102
- devServer.stderr.on('data', (data) => {
103
- data
104
- .toString('utf8')
105
- .split('\n')
106
- .forEach((line) => {
107
- if (line) stdErrLineHandler(line);
108
- });
105
+ readline.createInterface({ input: devServer.stderr, crlfDelay: Infinity }).on('line', (line) => {
106
+ if (line) stdErrLineHandler(line);
109
107
  });
110
108
 
111
109
  context.logger.debug(`Started dev server with pid ${devServer.pid}.`);
@@ -15,12 +15,13 @@
15
15
  */
16
16
 
17
17
  import { EventEmitter } from 'node:events';
18
+ import { PassThrough } from 'node:stream';
18
19
 
19
- import { jest } from '@jest/globals';
20
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
20
21
 
21
- const mockSpawn = jest.fn();
22
- jest.unstable_mockModule('child_process', () => ({ spawn: mockSpawn }));
23
- jest.unstable_mockModule('../utils/readBasePath.mjs', () => ({ default: () => '' }));
22
+ const mockSpawn = vi.fn();
23
+ vi.doMock('child_process', () => ({ spawn: mockSpawn }));
24
+ vi.doMock('../utils/readBasePath.mjs', () => ({ default: () => '' }));
24
25
 
25
26
  const { default: startServer } = await import('./startServer.mjs');
26
27
 
@@ -28,20 +29,20 @@ function createContext({ mailSink }) {
28
29
  return {
29
30
  bin: { vite: 'vite.js' },
30
31
  directories: { config: '/apps/tenant' },
31
- instance: { update: jest.fn() },
32
+ instance: { update: vi.fn() },
32
33
  internalPort: 3211,
33
- logger: { debug: jest.fn(), error: jest.fn(), info: jest.fn() },
34
+ logger: { debug: vi.fn(), error: vi.fn(), info: vi.fn() },
34
35
  mailSink,
35
36
  options: { port: 3210 },
36
- serverArtifacts: { record: jest.fn() },
37
- shutdownServer: jest.fn(),
37
+ serverArtifacts: { record: vi.fn() },
38
+ shutdownServer: vi.fn(),
38
39
  version: '7.2.0',
39
40
  };
40
41
  }
41
42
 
42
43
  beforeEach(() => {
43
44
  mockSpawn.mockImplementation(() =>
44
- Object.assign(new EventEmitter(), { stderr: new EventEmitter() })
45
+ Object.assign(new EventEmitter(), { stderr: new PassThrough() })
45
46
  );
46
47
  process.env.LOWDEFY_DEV_SMTP_PORT = '2525';
47
48
  });
@@ -23,7 +23,25 @@
23
23
  // needs is part of that watcher's batch and a build-status wait covers it.
24
24
  // Calls run one at a time, after the first child start (startFirst): the
25
25
  // second finds the first's work done.
26
+ //
27
+ // While the child is stopped for being idle (createIdleChild), a restart the
28
+ // build needs is only marked pending: the next waking request starts the
29
+ // child through restartServer, which records the server artifacts, so an
30
+ // edit or a branch switch on a server nobody uses never starts it. The
31
+ // install path still installs, rebuilds and optimises, so the woken child
32
+ // starts warm.
26
33
  function syncServer(context) {
34
+ function deferWhileStopped() {
35
+ if (context.idleChild?.isStopped() !== true) {
36
+ return false;
37
+ }
38
+ context.idleChild.markRestartPending();
39
+ // No child runs, so the next start reads every artifact as it is now. Recorded here so the
40
+ // next build while stopped does not see the same package.json change and install again.
41
+ context.serverArtifacts.record();
42
+ return true;
43
+ }
44
+
27
45
  async function sync({ restart = false } = {}) {
28
46
  const changes = context.serverArtifacts.check();
29
47
  if (changes.install) {
@@ -36,11 +54,13 @@ function syncServer(context) {
36
54
  // process, so the restarted child starts warm (optimizeDependencies.mjs).
37
55
  await context.buildActivity.track(() => context.optimizeDependencies());
38
56
  } finally {
39
- await context.restartServer();
57
+ if (!deferWhileStopped()) {
58
+ await context.restartServer();
59
+ }
40
60
  }
41
61
  return;
42
62
  }
43
- if (restart || changes.restart) {
63
+ if ((restart || changes.restart) && !deferWhileStopped()) {
44
64
  await context.restartServer();
45
65
  }
46
66
  }
@@ -54,11 +74,18 @@ function syncServer(context) {
54
74
  }).then((start) => start());
55
75
  let previous = firstStart.catch(() => {});
56
76
 
57
- function queueSync(options) {
58
- const next = previous.then(() => sync(options));
77
+ function queue(task) {
78
+ const next = previous.then(task);
59
79
  previous = next.catch(() => {});
60
80
  return next;
61
81
  }
82
+
83
+ function queueSync(options) {
84
+ return queue(() => sync(options));
85
+ }
86
+ // Child lifecycle work outside a sync (the idle stop and the wake) runs in
87
+ // the same queue, so it never interleaves with a restart or an install.
88
+ queueSync.run = queue;
62
89
  queueSync.startFirst = (start) => {
63
90
  runFirstStart(start);
64
91
  return firstStart;
@@ -14,32 +14,32 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, expect, test } from 'vitest';
18
18
 
19
19
  import syncServer from './syncServer.mjs';
20
20
 
21
21
  function createContext(changes) {
22
22
  const events = [];
23
23
  const record = (name, implementation = async () => {}) =>
24
- jest.fn(async () => {
24
+ vi.fn(async () => {
25
25
  events.push(name);
26
26
  return implementation();
27
27
  });
28
28
  return {
29
29
  events,
30
30
  buildActivity: {
31
- track: jest.fn(async (task) => {
31
+ track: vi.fn(async (task) => {
32
32
  events.push('track');
33
33
  return task();
34
34
  }),
35
35
  },
36
36
  installPlugins: record('install'),
37
- logger: { warn: jest.fn() },
37
+ logger: { warn: vi.fn() },
38
38
  lowdefyBuild: record('build'),
39
39
  optimizeDependencies: record('optimize'),
40
40
  restartServer: record('restart'),
41
- serverArtifacts: { check: jest.fn(() => changes) },
42
- shutdownServer: jest.fn(() => events.push('shutdown')),
41
+ serverArtifacts: { check: vi.fn(() => changes), record: vi.fn() },
42
+ shutdownServer: vi.fn(() => events.push('shutdown')),
43
43
  };
44
44
  }
45
45
 
@@ -139,3 +139,68 @@ test('syncServer still runs queued syncs when the first child start fails', asyn
139
139
 
140
140
  expect(context.events).toEqual(['restart']);
141
141
  });
142
+
143
+ function stopChild(context) {
144
+ context.idleChild = {
145
+ isStopped: vi.fn(() => true),
146
+ markRestartPending: vi.fn(() => context.events.push('pending')),
147
+ };
148
+ }
149
+
150
+ test.each([
151
+ ['a server artifact changed', { install: false, restart: true }, {}],
152
+ ['asked to restart', { install: false, restart: false }, { restart: true }],
153
+ ])(
154
+ 'syncServer marks a restart pending instead of starting an idle-stopped child when %s',
155
+ async (_, changes, options) => {
156
+ const context = createContext(changes);
157
+ stopChild(context);
158
+
159
+ await createStartedSync(context)(options);
160
+
161
+ expect(context.events).toEqual(['pending']);
162
+ }
163
+ );
164
+
165
+ test('syncServer installs, rebuilds and optimises for an idle-stopped child without starting it', async () => {
166
+ const context = createContext({ install: true, restart: true });
167
+ stopChild(context);
168
+
169
+ await createStartedSync(context)();
170
+
171
+ expect(context.events).toEqual(['shutdown', 'install', 'build', 'track', 'optimize', 'pending']);
172
+ // Recorded, so the next build while stopped does not install again.
173
+ expect(context.serverArtifacts.record).toHaveBeenCalledTimes(1);
174
+ });
175
+
176
+ test('syncServer restarts a child that is running again', async () => {
177
+ const context = createContext({ install: false, restart: true });
178
+ context.idleChild = { isStopped: () => false, markRestartPending: vi.fn() };
179
+
180
+ await createStartedSync(context)();
181
+
182
+ expect(context.events).toEqual(['restart']);
183
+ expect(context.idleChild.markRestartPending).not.toHaveBeenCalled();
184
+ expect(context.serverArtifacts.record).not.toHaveBeenCalled();
185
+ });
186
+
187
+ test('syncServer runs queued lifecycle tasks one at a time with the syncs', async () => {
188
+ const context = createContext({ install: false, restart: true });
189
+ let finishRestart;
190
+ context.restartServer.mockImplementationOnce(
191
+ () =>
192
+ new Promise((resolve) => {
193
+ context.events.push('restart');
194
+ finishRestart = resolve;
195
+ })
196
+ );
197
+ const sync = createStartedSync(context);
198
+ const synced = sync();
199
+ const task = sync.run(async () => context.events.push('task'));
200
+ await new Promise((resolve) => setTimeout(resolve, 10));
201
+ expect(context.events).toEqual(['restart']);
202
+ finishRestart();
203
+ await Promise.all([synced, task]);
204
+
205
+ expect(context.events).toEqual(['restart', 'task']);
206
+ });
@@ -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 waitForDevServer from './waitForDevServer.mjs';
20
20
 
@@ -23,7 +23,7 @@ const STEP_MS = 250;
23
23
  // The child's /api/ping: refused until answerAt, then ok. Date.now is faked,
24
24
  // so the wait's two-minute deadline runs on the same clock.
25
25
  function stubPing({ answerAt }) {
26
- global.fetch = jest.fn(async () => {
26
+ global.fetch = vi.fn(async () => {
27
27
  if (Date.now() >= answerAt) {
28
28
  return { ok: true };
29
29
  }
@@ -36,13 +36,13 @@ function createContext() {
36
36
  basePath: '',
37
37
  devServer: { exitCode: null, signalCode: null },
38
38
  internalPort: 3211,
39
- markServerReady: jest.fn(),
39
+ markServerReady: vi.fn(),
40
40
  };
41
41
  }
42
42
 
43
43
  async function advance(ms) {
44
44
  for (let elapsed = 0; elapsed < ms; elapsed += STEP_MS) {
45
- jest.advanceTimersByTime(STEP_MS);
45
+ vi.advanceTimersByTime(STEP_MS);
46
46
  await new Promise((resolve) => setImmediate(resolve));
47
47
  }
48
48
  }
@@ -50,11 +50,26 @@ async function advance(ms) {
50
50
  const originalFetch = global.fetch;
51
51
 
52
52
  beforeEach(() => {
53
- jest.useFakeTimers({ doNotFake: ['performance', 'setImmediate'] });
53
+ vi.useFakeTimers({
54
+ toFake: [
55
+ 'Date',
56
+ 'hrtime',
57
+ 'queueMicrotask',
58
+ 'requestAnimationFrame',
59
+ 'cancelAnimationFrame',
60
+ 'requestIdleCallback',
61
+ 'cancelIdleCallback',
62
+ 'clearImmediate',
63
+ 'setInterval',
64
+ 'clearInterval',
65
+ 'setTimeout',
66
+ 'clearTimeout',
67
+ ],
68
+ });
54
69
  });
55
70
 
56
71
  afterEach(() => {
57
- jest.useRealTimers();
72
+ vi.useRealTimers();
58
73
  global.fetch = originalFetch;
59
74
  });
60
75
 
package/manager/run.mjs CHANGED
@@ -22,12 +22,15 @@ import getContext from './getContext.mjs';
22
22
  import getLowdefyVersion from './utils/getLowdefyVersion.mjs';
23
23
  import acquireDevInstance from './utils/acquireDevInstance.mjs';
24
24
  import createBuildActivity from './utils/createBuildActivity.mjs';
25
+ import createLanPairing from './utils/createLanPairing.mjs';
26
+ import createIdleChild from './processes/createIdleChild.mjs';
25
27
  import createIdleGc from './utils/createIdleGc.mjs';
26
28
  import createRequestActivity from './utils/createRequestActivity.mjs';
27
29
  import startMailSink from './processes/startMailSink.mjs';
28
30
  import startProxy from './processes/startProxy.mjs';
29
31
  import startFirstServer from './processes/startFirstServer.mjs';
30
32
  import startRecordingPruner from './utils/startRecordingPruner.mjs';
33
+ import formatLanPairing from './utils/formatLanPairing.mjs';
31
34
  import formatNoticeBox from './utils/formatNoticeBox.mjs';
32
35
  import resolvePorts from './utils/resolvePorts.mjs';
33
36
 
@@ -97,9 +100,10 @@ if (instance.acquired === false) {
97
100
  process.on('exit', () => instance.release());
98
101
  startRecordingPruner({ configDirectory: context.directories.config, logger: context.logger });
99
102
 
100
- // Requests through the proxy and finished builds are use of the server; the
101
- // hub stops a server nobody has used for its idle limit (see
102
- // createRequestActivity).
103
+ // Requests through the proxy, finished builds and open tabs are use of the
104
+ // server; the manager stops its Vite child after a few minutes unused
105
+ // (createIdleChild), and the hub stops a server nobody has used for its idle
106
+ // limit (see createRequestActivity).
103
107
  context.requestActivity = createRequestActivity({
104
108
  onChange: (fields) => instance.update(fields),
105
109
  });
@@ -187,6 +191,10 @@ try {
187
191
  // or .env change) then never drops the listener, so long-lived clients (MCP
188
192
  // agents, the reload SSE stream, HMR websockets) reconnect instead of dying
189
193
  // on ECONNREFUSED.
194
+ context.lan = createLanPairing({ lan: context.options.lan });
195
+ // Stops the Vite child after a few minutes unused and starts it on the next
196
+ // request that is use; the proxy asks it whether the child is stopped.
197
+ context.idleChild = createIdleChild(context, { idleMs: context.options.childIdleMs });
190
198
  await startProxy(context);
191
199
  context.mailSink = await startMailSink(context);
192
200
 
@@ -194,6 +202,21 @@ try {
194
202
  if (!(await startFirstServer(context))) {
195
203
  context.logger.warn('The dev server did not answer within 2 minutes - check the output above.');
196
204
  }
205
+ // The initial build runs outside buildActivity, so no idle GC followed it:
206
+ // without this the manager holds that build's heap (about 130 MB of
207
+ // footprint) for 20 s or more after ready, until V8 shrinks it on its own.
208
+ // A batch busy now gets its own GC when it ends, and a build that starts
209
+ // before this GC runs, such as the plugin check below, cancels it.
210
+ if (!context.buildActivity.isBusy()) {
211
+ idleGc.onBuildingChange(false);
212
+ }
213
+ // Not awaited: the server is usable while the plugins installed after the
214
+ // initial build are checked (see checkPendingPlugins). A failed build is
215
+ // reported in the build status, as a watcher's is.
216
+ context.checkPendingPlugins().catch((error) => {
217
+ context.logger.error(error);
218
+ });
219
+ context.idleChild.start();
197
220
  const docsUrl = `${context.url}/lowdefy-docs`;
198
221
  context.logger.info(
199
222
  { color: 'blue' },
@@ -203,15 +226,16 @@ try {
203
226
  `Docs & MCP ${docsUrl}`,
204
227
  ' run `lowdefy agent-setup` to connect your agent',
205
228
  '',
206
- 'Annotate Press Cmd/Ctrl+/ in the browser to point, draw,',
207
- ' and comment on the running app, then paste the',
208
- ' copied feedback into your coding agent session.',
209
- '',
210
- 'Open code Cmd/Ctrl+click any element in the browser to open',
229
+ 'Open code Option/Alt+click any element in the browser to open',
211
230
  ' its yaml in VS Code at the defining line.',
212
231
  ],
213
232
  })
214
233
  );
234
+ if (context.lan) {
235
+ context.logger.info(
236
+ formatLanPairing({ lan: context.lan, port: context.options.port, basePath: context.basePath })
237
+ );
238
+ }
215
239
  // Lowdefy's agent block: missing, from another version, or not imported by
216
240
  // CLAUDE.md. Build status reports the same notices to agents on every read.
217
241
  const agentFiles = checkAgentFiles({
@@ -71,7 +71,7 @@ class BatchChanges {
71
71
  this.running = false;
72
72
  } catch (error) {
73
73
  this.running = false;
74
- this.context.logger.error(error?.message ?? error);
74
+ this.context.logger.error(error);
75
75
  }
76
76
  this._settle();
77
77
  }
@@ -14,16 +14,16 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, expect, test } from 'vitest';
18
18
  import { wait } from '@lowdefy/helpers';
19
19
 
20
20
  import BatchChanges from './BatchChanges.mjs';
21
21
 
22
- const context = { logger: { error: jest.fn() } };
22
+ const context = { logger: { error: vi.fn() } };
23
23
 
24
24
  test('BatchChanges reports busy from the first change until the batch is processed', async () => {
25
25
  const events = [];
26
- const fn = jest.fn(async () => {
26
+ const fn = vi.fn(async () => {
27
27
  events.push('processed');
28
28
  });
29
29
  const batch = new BatchChanges({
@@ -43,7 +43,7 @@ test('BatchChanges reports busy from the first change until the batch is process
43
43
  test('BatchChanges stays busy through a change that arrives while a batch is running', async () => {
44
44
  const events = [];
45
45
  let batch;
46
- const fn = jest.fn(async (args) => {
46
+ const fn = vi.fn(async (args) => {
47
47
  events.push(`processed ${args.flat().join(',')}`);
48
48
  if (args.flat().includes('a.yaml')) {
49
49
  batch.newChange('b.yaml');
@@ -22,6 +22,7 @@ import { spawnSync } from 'child_process';
22
22
  import { getProcessStartTime, isProcessStartTime, readDevInstance } from '@lowdefy/node-utils';
23
23
 
24
24
  import acquireDevInstance from './acquireDevInstance.mjs';
25
+ import { afterEach, beforeEach, expect, test } from 'vitest';
25
26
 
26
27
  let configDirectory;
27
28
 
@@ -0,0 +1,45 @@
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 crypto from 'node:crypto';
18
+
19
+ import { type } from '@lowdefy/helpers';
20
+
21
+ import isLoopbackAddress from './isLoopbackAddress.mjs';
22
+
23
+ /*
24
+ The dev server answers anyone on this computer: its dev tools let through a
25
+ request with no Origin header, and its headless-user cookie can make a caller
26
+ anyone. `lowdefy dev --lan` opens it to the local network for a phone, so a
27
+ request from another address must carry the session's pairing token, which
28
+ only the developer's terminal shows. Returns 'local', 'paired' or 'refused'.
29
+ */
30
+ function checkPairing({ remoteAddress, pairToken, providedToken }) {
31
+ if (isLoopbackAddress(remoteAddress)) {
32
+ return 'local';
33
+ }
34
+ if (!type.isString(pairToken) || !type.isString(providedToken)) {
35
+ return 'refused';
36
+ }
37
+ const provided = Buffer.from(providedToken);
38
+ const expected = Buffer.from(pairToken);
39
+ if (provided.length !== expected.length) {
40
+ return 'refused';
41
+ }
42
+ return crypto.timingSafeEqual(provided, expected) ? 'paired' : 'refused';
43
+ }
44
+
45
+ export default checkPairing;
@@ -0,0 +1,53 @@
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 { expect, test } from 'vitest';
18
+ import checkPairing from './checkPairing.mjs';
19
+
20
+ const TOKEN = 'k'.repeat(43);
21
+
22
+ test.each(['127.0.0.1', '::1', '::ffff:127.0.0.1'])(
23
+ 'checkPairing lets a loopback request (%s) through without a token',
24
+ (remoteAddress) => {
25
+ expect(checkPairing({ remoteAddress, pairToken: TOKEN })).toBe('local');
26
+ expect(checkPairing({ remoteAddress, pairToken: undefined })).toBe('local');
27
+ }
28
+ );
29
+
30
+ test('checkPairing refuses a LAN request without the token', () => {
31
+ expect(checkPairing({ remoteAddress: '192.168.1.40', pairToken: TOKEN })).toBe('refused');
32
+ });
33
+
34
+ test('checkPairing refuses a LAN request with the wrong token', () => {
35
+ expect(
36
+ checkPairing({ remoteAddress: '192.168.1.40', pairToken: TOKEN, providedToken: 'k'.repeat(42) })
37
+ ).toBe('refused');
38
+ expect(
39
+ checkPairing({ remoteAddress: '192.168.1.40', pairToken: TOKEN, providedToken: 'x'.repeat(43) })
40
+ ).toBe('refused');
41
+ });
42
+
43
+ test('checkPairing pairs a LAN request with the token', () => {
44
+ expect(
45
+ checkPairing({ remoteAddress: '::ffff:192.168.1.40', pairToken: TOKEN, providedToken: TOKEN })
46
+ ).toBe('paired');
47
+ });
48
+
49
+ test('checkPairing refuses every LAN request when the session has no token', () => {
50
+ expect(
51
+ checkPairing({ remoteAddress: '192.168.1.40', pairToken: undefined, providedToken: TOKEN })
52
+ ).toBe('refused');
53
+ });
@@ -61,7 +61,11 @@ function createBuildActivity({ onChange }) {
61
61
  return { settled: true, sawBuild, waitedMs: Date.now() - start };
62
62
  }
63
63
 
64
- return { setBusy, track, waitForIdle };
64
+ function isBusy() {
65
+ return active > 0;
66
+ }
67
+
68
+ return { isBusy, setBusy, track, waitForIdle };
65
69
  }
66
70
 
67
71
  export default createBuildActivity;
@@ -14,12 +14,12 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, expect, test } from 'vitest';
18
18
 
19
19
  import createBuildActivity from './createBuildActivity.mjs';
20
20
 
21
21
  test('waitForIdle waits for tracked work to finish and reports that it saw a build', async () => {
22
- const onChange = jest.fn();
22
+ const onChange = vi.fn();
23
23
  const activity = createBuildActivity({ onChange });
24
24
  let finish;
25
25
  const work = activity.track(
@@ -17,7 +17,7 @@
17
17
  import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
- import { jest } from '@jest/globals';
20
+ import { vi, afterEach, expect, test } from 'vitest';
21
21
 
22
22
  import createChangeSignal from './createChangeSignal.mjs';
23
23
 
@@ -26,12 +26,12 @@ function readSignal(buildDirectory) {
26
26
  }
27
27
 
28
28
  afterEach(() => {
29
- jest.restoreAllMocks();
29
+ vi.restoreAllMocks();
30
30
  });
31
31
 
32
32
  test('each write gives build/invalidatePages a new, larger value, even within one millisecond', () => {
33
33
  const buildDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'ldf-change-signal-'));
34
- jest.spyOn(Date, 'now').mockReturnValue(5000);
34
+ vi.spyOn(Date, 'now').mockReturnValue(5000);
35
35
  const writeChangeSignal = createChangeSignal({ buildDirectory });
36
36
 
37
37
  expect(writeChangeSignal()).toBe(5000);
@@ -44,7 +44,7 @@ test('each write gives build/invalidatePages a new, larger value, even within on
44
44
  test('a new manager continues above the value the last one wrote', () => {
45
45
  const buildDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'ldf-change-signal-'));
46
46
  fs.writeFileSync(path.join(buildDirectory, 'invalidatePages'), '9000');
47
- jest.spyOn(Date, 'now').mockReturnValue(5000);
47
+ vi.spyOn(Date, 'now').mockReturnValue(5000);
48
48
 
49
49
  expect(createChangeSignal({ buildDirectory })()).toBe(9001);
50
50
  fs.rmSync(buildDirectory, { recursive: true, force: true });
@@ -53,7 +53,7 @@ test('a new manager continues above the value the last one wrote', () => {
53
53
  test('the value is the current time when the clock is ahead of the last value', () => {
54
54
  const buildDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'ldf-change-signal-'));
55
55
  const writeChangeSignal = createChangeSignal({ buildDirectory });
56
- jest.spyOn(Date, 'now').mockReturnValue(5000);
56
+ vi.spyOn(Date, 'now').mockReturnValue(5000);
57
57
  writeChangeSignal();
58
58
  Date.now.mockReturnValue(7000);
59
59
 
@@ -17,6 +17,7 @@
17
17
 
18
18
  import { createRequire } from 'node:module';
19
19
  import importFresh from './importFresh.mjs';
20
+ import { importPluginModule } from './pluginTypeCache.mjs';
20
21
  import readPluginDefinitions from './readPluginDefinitions.mjs';
21
22
 
22
23
  const require = createRequire(import.meta.url);
@@ -25,9 +26,11 @@ const require = createRequire(import.meta.url);
25
26
  // process instead of repeating the same skip message on each rebuild.
26
27
  const warnedMissingMessages = new Set();
27
28
 
28
- async function createCustomPluginMessagesMap({ directories, logger }) {
29
+ // cache: true reads each plugin from the plugin type cache, as
30
+ // createCustomPluginTypesMap does.
31
+ async function createCustomPluginMessagesMap({ cache = false, directories, logger }) {
29
32
  const customMessagesMap = {};
30
- const pluginDefinitions = await readPluginDefinitions({ directories });
33
+ const { plugins: pluginDefinitions } = await readPluginDefinitions({ directories });
31
34
 
32
35
  // Each import starts a worker, so the plugins are imported in parallel.
33
36
  await Promise.all(
@@ -43,7 +46,9 @@ async function createCustomPluginMessagesMap({ directories, logger }) {
43
46
  }
44
47
  return;
45
48
  }
46
- const messagesModule = await importFresh(messagesPath);
49
+ const messagesModule = cache
50
+ ? await importPluginModule({ entryPath: messagesPath, packageName: plugin.name })
51
+ : await importFresh(messagesPath);
47
52
  const messages = messagesModule.default ?? messagesModule;
48
53
  if (!messages || typeof messages !== 'object') return;
49
54
  customMessagesMap[plugin.name] = messages;