@lowdefy/server-dev 7.1.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (432) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +87 -135
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  106. package/lib/docs/isPageReady.test.mjs +1 -0
  107. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  108. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  109. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  110. package/lib/docs/launchBrowser.test.mjs +8 -8
  111. package/lib/docs/listTypes.js +58 -8
  112. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  113. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  114. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  115. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  116. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  117. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  118. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  119. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  120. package/lib/docs/pollTab.js +100 -0
  121. package/lib/docs/pollTab.test.mjs +64 -0
  122. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  123. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  124. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  125. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  126. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  127. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  128. package/lib/docs/readJourneySession.js +1 -1
  129. package/lib/docs/reportDevToolFault.js +29 -0
  130. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  131. package/lib/docs/requestRestart.test.mjs +1 -0
  132. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  133. package/lib/docs/resolveSource.js +2 -2
  134. package/lib/docs/resolveSource.test.mjs +6 -6
  135. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  136. package/lib/docs/runCheck.test.mjs +3 -3
  137. package/lib/docs/runCheckChild.js +2 -1
  138. package/lib/docs/runEndpoint.js +23 -10
  139. package/lib/docs/runEndpoint.test.mjs +42 -37
  140. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  141. package/lib/docs/runJourney.js +21 -1
  142. package/lib/docs/runJourney.test.mjs +119 -99
  143. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  144. package/lib/docs/runJourneySteps.js +8 -29
  145. package/lib/docs/runRequest.js +6 -6
  146. package/lib/docs/runRequest.test.mjs +22 -22
  147. package/lib/docs/screenshotPage.js +6 -7
  148. package/lib/docs/screenshotPage.test.mjs +46 -46
  149. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  150. package/lib/docs/searchDocs.test.mjs +1 -0
  151. package/lib/docs/searchIcons.test.mjs +5 -5
  152. package/lib/docs/selectFinalState.test.mjs +1 -0
  153. package/lib/docs/serverErrorStore.test.mjs +4 -4
  154. package/lib/docs/setupTestFixtures.mjs +25 -0
  155. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  156. package/lib/docs/tabAvailable.js +1 -1
  157. package/lib/docs/tabChannel.js +90 -14
  158. package/lib/docs/tabChannel.test.mjs +40 -15
  159. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  160. package/lib/docs/validateStateSelection.test.mjs +1 -0
  161. package/lib/docs/validateViewport.test.mjs +1 -0
  162. package/lib/docs/waitForBuild.test.mjs +1 -0
  163. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  164. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  165. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  166. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  167. package/lib/server/auth/getHeadlessUser.js +6 -0
  168. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  169. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  170. package/lib/server/contextMapBudget.test.mjs +3 -3
  171. package/lib/server/continueJitKeys.test.mjs +1 -0
  172. package/lib/server/createLowdefyContext.js +5 -1
  173. package/lib/server/createLowdefyContext.test.mjs +32 -32
  174. package/lib/server/getClientAddress.test.mjs +2 -2
  175. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  176. package/lib/server/importAppCode.test.mjs +2 -2
  177. package/lib/server/jitPageBuilder.js +27 -3
  178. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  179. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  180. package/lib/server/jitPageBuilder.test.mjs +4 -4
  181. package/lib/server/journeyCookies.test.mjs +1 -0
  182. package/lib/server/loadDynamicJsMap.js +10 -1
  183. package/lib/server/log/createHandleError.js +10 -5
  184. package/lib/server/log/createHandleError.test.mjs +19 -8
  185. package/lib/server/log/createLogger.test.mjs +2 -2
  186. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  187. package/lib/server/mutants/listMutants.test.mjs +1 -0
  188. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  189. package/lib/server/mutants/operators.test.mjs +1 -0
  190. package/lib/server/pageBuildRecords.test.mjs +1 -0
  191. package/lib/server/pageCache.test.mjs +1 -0
  192. package/lib/server/pageRebuilds.test.mjs +3 -3
  193. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  194. package/lib/server/pruneJitMaps.test.mjs +1 -0
  195. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  196. package/lib/server/readInstanceRecord.test.mjs +24 -8
  197. package/lib/server/readMergedMaps.test.mjs +1 -0
  198. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  199. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  200. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  201. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  202. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  203. package/lib/server/startIdleGc.test.mjs +25 -9
  204. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  205. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  206. package/manager/getContext.mjs +9 -0
  207. package/manager/processes/checkPendingPlugins.mjs +49 -0
  208. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  209. package/manager/processes/createIdleChild.mjs +141 -0
  210. package/manager/processes/createIdleChild.test.mjs +209 -0
  211. package/manager/processes/initialBuild.mjs +2 -15
  212. package/manager/processes/initialBuild.test.mjs +8 -40
  213. package/manager/processes/lowdefyBuild.mjs +7 -4
  214. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  215. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  216. package/manager/processes/restartServer.test.mjs +63 -15
  217. package/manager/processes/shutdownServer.test.mjs +3 -3
  218. package/manager/processes/startFirstServer.test.mjs +23 -22
  219. package/manager/processes/startMailSink.mjs +11 -3
  220. package/manager/processes/startMailSink.test.mjs +28 -2
  221. package/manager/processes/startProxy.mjs +158 -27
  222. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  223. package/manager/processes/startProxy.test.mjs +127 -2
  224. package/manager/processes/startServer.mjs +5 -7
  225. package/manager/processes/startServer.test.mjs +10 -9
  226. package/manager/processes/syncServer.mjs +31 -4
  227. package/manager/processes/syncServer.test.mjs +71 -6
  228. package/manager/processes/waitForDevServer.test.mjs +21 -6
  229. package/manager/run.mjs +32 -8
  230. package/manager/utils/BatchChanges.mjs +1 -1
  231. package/manager/utils/BatchChanges.test.mjs +4 -4
  232. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  233. package/manager/utils/checkPairing.mjs +45 -0
  234. package/manager/utils/checkPairing.test.mjs +53 -0
  235. package/manager/utils/createBuildActivity.mjs +5 -1
  236. package/manager/utils/createBuildActivity.test.mjs +2 -2
  237. package/manager/utils/createChangeSignal.test.mjs +5 -5
  238. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  239. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  240. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  241. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  242. package/manager/utils/createGlobIgnore.mjs +45 -0
  243. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  244. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  245. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  246. package/manager/utils/createIdleGc.test.mjs +31 -15
  247. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  248. package/manager/utils/createLanPairing.test.mjs +46 -0
  249. package/manager/utils/createRequestActivity.mjs +30 -3
  250. package/manager/utils/createRequestActivity.test.mjs +76 -22
  251. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  252. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  253. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  254. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  255. package/manager/utils/findSignInCode.test.mjs +33 -0
  256. package/manager/utils/formatLanPairing.mjs +32 -0
  257. package/manager/utils/formatLanPairing.test.mjs +40 -0
  258. package/manager/utils/getLanAddress.mjs +83 -0
  259. package/manager/utils/getLanAddress.test.mjs +70 -0
  260. package/manager/utils/importFresh.test.mjs +1 -0
  261. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  262. package/manager/utils/pluginTypeCache.mjs +100 -0
  263. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  264. package/manager/utils/pruneRecordings.test.mjs +1 -0
  265. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  266. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  267. package/manager/utils/readBasePath.test.mjs +1 -0
  268. package/manager/utils/readManagerVersion.test.mjs +1 -0
  269. package/manager/utils/readPluginDefinitions.mjs +6 -6
  270. package/manager/utils/renderTerminalQr.mjs +54 -0
  271. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  272. package/manager/utils/setupWatcher.mjs +19 -4
  273. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  274. package/manager/utils/waitForChildExit.test.mjs +2 -2
  275. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  276. package/manager/watchers/envWatcher.mjs +3 -0
  277. package/manager/watchers/envWatcher.test.mjs +19 -7
  278. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  279. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  280. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  281. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  282. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  283. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  284. package/manager/watchers/resolveFile.mjs +46 -0
  285. package/manager/watchers/resolveFile.test.mjs +67 -0
  286. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  287. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  288. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  289. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  290. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  291. package/package.json +50 -49
  292. package/package.original.json +50 -49
  293. package/src/app.js +83 -85
  294. package/src/html/renderDevPage.test.mjs +1 -0
  295. package/src/lib/getPathSegments.js +16 -1
  296. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  297. package/src/lib/isTabAnswer.js +32 -0
  298. package/src/lib/isTabChannelCaller.js +35 -0
  299. package/src/middleware/apiContext.js +4 -2
  300. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  301. package/src/middleware/errorHandler.js +33 -45
  302. package/src/middleware/errorHandler.test.mjs +10 -10
  303. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  304. package/src/middleware/localDevToolsOnly.js +13 -1
  305. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  306. package/src/middleware/noStore.test.mjs +1 -0
  307. package/src/middleware/staleFlag.test.mjs +1 -0
  308. package/src/middleware/stampCaller.test.mjs +1 -0
  309. package/src/routes/agentBearer.test.mjs +183 -0
  310. package/src/routes/auth.test.mjs +10 -10
  311. package/src/routes/clientError.js +21 -4
  312. package/src/routes/clientError.test.mjs +127 -0
  313. package/src/routes/devInspect.js +6 -51
  314. package/src/routes/devInspect.test.mjs +128 -3
  315. package/src/routes/devRecording.js +6 -17
  316. package/src/routes/devRecording.test.mjs +54 -3
  317. package/src/routes/docs/buildStatus.test.mjs +6 -6
  318. package/src/routes/docs/events.test.mjs +4 -4
  319. package/src/routes/docs/find.js +3 -3
  320. package/src/routes/docs/journey.test.mjs +8 -8
  321. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  322. package/src/routes/docs/loadDocsRoutes.js +70 -0
  323. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  324. package/src/routes/docs/mcp.test.mjs +5 -5
  325. package/src/routes/docs/mutants.js +7 -0
  326. package/src/routes/docs/mutants.test.mjs +20 -6
  327. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  328. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  329. package/src/routes/docs/restart.test.mjs +1 -0
  330. package/src/routes/endpoints.js +24 -0
  331. package/src/routes/endpointsLink.test.mjs +111 -0
  332. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  333. package/src/routes/jitPage.js +13 -1
  334. package/src/routes/jitPage.test.mjs +36 -11
  335. package/src/routes/mcp.js +6 -0
  336. package/src/routes/mcp.test.mjs +23 -8
  337. package/src/routes/mcpMemberToken.test.mjs +8 -8
  338. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  339. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  340. package/src/routes/mobileRoutes.test.mjs +223 -0
  341. package/src/routes/mobileSignIn.js +58 -0
  342. package/src/routes/mobileSignIn.test.mjs +59 -0
  343. package/src/routes/mobileSignInCallback.js +34 -0
  344. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  345. package/src/routes/mountDevPageRoutes.js +10 -2
  346. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  347. package/src/routes/mountMobileWellKnown.js +35 -0
  348. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  349. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  350. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  351. package/src/routes/reload.js +101 -20
  352. package/src/routes/reload.test.mjs +153 -0
  353. package/src/routes/request.js +1 -22
  354. package/src/routes/request.test.mjs +7 -24
  355. package/src/routes/requestBody.test.mjs +14 -27
  356. package/src/routes/websocket.test.mjs +2 -2
  357. package/src/routes/wellKnownFallback.test.mjs +2 -2
  358. package/src/websocket/devWebSocket.test.mjs +12 -12
  359. package/vite.config.js +13 -1
  360. package/client/feedback/FeedbackMount.jsx +0 -83
  361. package/client/feedback/FeedbackOverlay.jsx +0 -904
  362. package/client/feedback/captureTabScreenshot.js +0 -84
  363. package/client/feedback/copyToClipboard.js +0 -45
  364. package/client/feedback/drawAnnotationsSvg.js +0 -119
  365. package/client/feedback/feedbackStyles.js +0 -304
  366. package/client/feedback/pinResponsiveImages.js +0 -59
  367. package/client/feedback/sendFeedback.js +0 -39
  368. package/client/feedback/useFeedbackToggle.js +0 -70
  369. package/client/recorder/buildEngineRecord.js +0 -37
  370. package/client/recorder/buildInteractionRecord.js +0 -64
  371. package/client/recorder/buildTraceEvent.js +0 -57
  372. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  373. package/client/recorder/chunkRecords.js +0 -69
  374. package/client/recorder/chunkRecords.test.mjs +0 -59
  375. package/client/recorder/collectEventEndpoints.js +0 -40
  376. package/client/recorder/collectEventRequests.js +0 -39
  377. package/client/recorder/createPairingBuffer.js +0 -187
  378. package/client/recorder/createPasswordRedactor.js +0 -84
  379. package/client/recorder/createRecordBatcher.js +0 -54
  380. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  381. package/client/recorder/createRecordingSession.js +0 -61
  382. package/client/recorder/createRecordingSession.test.mjs +0 -72
  383. package/client/recorder/diffStateWrites.js +0 -77
  384. package/client/recorder/diffStateWrites.test.mjs +0 -66
  385. package/client/recorder/isEventCall.js +0 -30
  386. package/client/recorder/jsonType.js +0 -39
  387. package/client/recorder/sendRecords.js +0 -40
  388. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  389. package/lib/docs/checkpointPaths.js +0 -91
  390. package/lib/docs/checkpointStore.js +0 -243
  391. package/lib/docs/checkpointToMocks.js +0 -65
  392. package/lib/docs/configCheckpoints.test.mjs +0 -156
  393. package/lib/docs/createConfigCheckpoint.js +0 -92
  394. package/lib/docs/devMockRegistry.js +0 -68
  395. package/lib/docs/enrichFeedback.js +0 -71
  396. package/lib/docs/evalOperator.js +0 -49
  397. package/lib/docs/evalOperator.test.mjs +0 -157
  398. package/lib/docs/evalOperatorHeadless.js +0 -159
  399. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  400. package/lib/docs/evalOperatorInTab.js +0 -49
  401. package/lib/docs/formatFeedback.js +0 -142
  402. package/lib/docs/formatFeedback.test.mjs +0 -252
  403. package/lib/docs/getPluginDoc.js +0 -53
  404. package/lib/docs/listConfigCheckpoints.js +0 -55
  405. package/lib/docs/loadState.js +0 -220
  406. package/lib/docs/revertConfigCheckpoint.js +0 -73
  407. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  408. package/lib/docs/scaffoldPage.js +0 -77
  409. package/lib/docs/scaffoldPage.test.mjs +0 -97
  410. package/lib/docs/snapshotState.js +0 -67
  411. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  412. package/manager/watchers/listServerSidePackages.mjs +0 -47
  413. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  414. package/src/routes/docs/checkpointsCreate.js +0 -28
  415. package/src/routes/docs/evalOperator.js +0 -70
  416. package/src/routes/docs/inspectState.js +0 -59
  417. package/src/routes/docs/loadState.js +0 -51
  418. package/src/routes/docs/pluginDoc.js +0 -33
  419. package/src/routes/docs/plugins.js +0 -23
  420. package/src/routes/docs/runEndpoint.js +0 -54
  421. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  422. package/src/routes/docs/runRequest.js +0 -53
  423. package/src/routes/docs/runRequest.test.mjs +0 -92
  424. package/src/routes/docs/schema.js +0 -37
  425. package/src/routes/docs/screenshot.js +0 -120
  426. package/src/routes/docs/screenshot.test.mjs +0 -117
  427. package/src/routes/docs/search.js +0 -40
  428. package/src/routes/docs/snapshotState.js +0 -50
  429. package/src/routes/docs/stateCheckpointsList.js +0 -26
  430. package/src/routes/docs/types.js +0 -33
  431. package/src/routes/feedback.js +0 -107
  432. package/src/routes/feedback.test.mjs +0 -204
@@ -0,0 +1,188 @@
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 path from 'path';
19
+ import { type } from '@lowdefy/helpers';
20
+
21
+ import resolveFile from './resolveFile.mjs';
22
+ import resolvePackageSpecifier from './resolvePackageSpecifier.mjs';
23
+
24
+ // The build's plugin import files the client bundles. Every other file under
25
+ // build/plugins is imported by the server process, which caches the modules.
26
+ // A file missing here is walked as server code, which errs towards a restart.
27
+ const CLIENT_IMPORT_FILES = new Set([
28
+ 'actions.js',
29
+ 'blocks.js',
30
+ 'icons.js',
31
+ path.join('operators', 'client.js'),
32
+ path.join('operators', 'clientJsMap.js'),
33
+ ]);
34
+
35
+ // Static imports and re-exports, side-effect imports, and literal dynamic
36
+ // imports and requires. A match inside a string adds a file, or marks its
37
+ // package unsure when it names none, so at worst the server restarts when it
38
+ // did not need to.
39
+ const SPECIFIER_PATTERNS = [
40
+ /\bfrom\s*['"]([^'"]+)['"]/g,
41
+ /\bimport\s*['"]([^'"]+)['"]/g,
42
+ /\bimport\s*\(\s*['"]([^'"]+)['"]\s*[,)]/g,
43
+ /\brequire\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
44
+ ];
45
+ const DYNAMIC_IMPORT = /\b(import|require)\s*\(/g;
46
+ const LITERAL_DYNAMIC_IMPORT = /^\s*['"][^'"]+['"]\s*[,)]/;
47
+ // String literals are matched so the comment markers inside them ('**/*.js',
48
+ // 'https://...') stay text; only the comments are removed. Quoted strings end
49
+ // at a line end, so a quote misread as one (an apostrophe in a regular
50
+ // expression) cannot swallow the lines after it.
51
+ const STRINGS_AND_COMMENTS =
52
+ /('(?:\\.|[^'\\\n])*'|"(?:\\.|[^"\\\n])*"|`(?:\\[\s\S]|[^`\\])*`)|\/\*[\s\S]*?\*\/|\/\/[^\n]*/g;
53
+
54
+ function isInside({ filePath, dir }) {
55
+ const relative = path.relative(dir, filePath);
56
+ return !relative.startsWith('..') && !path.isAbsolute(relative);
57
+ }
58
+
59
+ function listFiles(dir) {
60
+ if (!fs.existsSync(dir)) {
61
+ return [];
62
+ }
63
+ return fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
64
+ const full = path.join(dir, entry.name);
65
+ return entry.isDirectory() ? listFiles(full) : [full];
66
+ });
67
+ }
68
+
69
+ function stripComments(source) {
70
+ return source.replace(STRINGS_AND_COMMENTS, (_, string) => string ?? '');
71
+ }
72
+
73
+ function readSpecifiers(source) {
74
+ const specifiers = [];
75
+ for (const pattern of SPECIFIER_PATTERNS) {
76
+ for (const match of source.matchAll(pattern)) {
77
+ specifiers.push(match[1]);
78
+ }
79
+ }
80
+ return specifiers;
81
+ }
82
+
83
+ function hasNonLiteralDynamicImport(source) {
84
+ for (const match of source.matchAll(DYNAMIC_IMPORT)) {
85
+ const rest = source.slice(match.index + match[0].length);
86
+ if (!LITERAL_DYNAMIC_IMPORT.test(rest)) {
87
+ return true;
88
+ }
89
+ }
90
+ return false;
91
+ }
92
+
93
+ function findPackageByName({ packages, specifier }) {
94
+ return packages.find(
95
+ ({ package: name }) => specifier === name || specifier.startsWith(`${name}/`)
96
+ );
97
+ }
98
+
99
+ function findPackageByFile({ packages, filePath }) {
100
+ return packages.find(({ dir }) => isInside({ filePath, dir }));
101
+ }
102
+
103
+ // Where a specifier leads, and the local package it resolves in, or null for
104
+ // a published dependency, which cannot change under a running dev server.
105
+ // Relative and subpath ('#lib/query.js') imports resolve in the importer's
106
+ // own package.
107
+ function resolveSpecifier({ packages, specifier, from }) {
108
+ if (specifier.startsWith('.')) {
109
+ const filePath = resolveFile(path.resolve(path.dirname(from), specifier));
110
+ return {
111
+ owner: findPackageByFile({ packages, filePath: from }),
112
+ resolved: filePath === null ? null : { filePath },
113
+ };
114
+ }
115
+ const owner = specifier.startsWith('#')
116
+ ? findPackageByFile({ packages, filePath: from })
117
+ : findPackageByName({ packages, specifier });
118
+ if (owner === undefined) {
119
+ return null;
120
+ }
121
+ return {
122
+ owner,
123
+ resolved: resolvePackageSpecifier({ dir: owner.dir, packageName: owner.package, specifier }),
124
+ };
125
+ }
126
+
127
+ // The files of the local plugin packages the server process imports: walked
128
+ // from the build's server-side plugin import files through each module's
129
+ // imports, staying inside the local packages. A package where the walk cannot
130
+ // be sure - an import it cannot resolve, or a dynamic import of a computed
131
+ // path - is listed in unsureDirs, and any change to it restarts the server as
132
+ // it would without the walk.
133
+ function listServerPluginFiles({ directories, packages }) {
134
+ const pluginsDir = path.join(directories.build, 'plugins');
135
+ const files = new Set();
136
+ const unsureDirs = new Set();
137
+ const queue = [];
138
+
139
+ for (const importFile of listFiles(pluginsDir)) {
140
+ const relative = path.relative(pluginsDir, importFile);
141
+ if (path.extname(importFile) !== '.js' || CLIENT_IMPORT_FILES.has(relative)) {
142
+ continue;
143
+ }
144
+ for (const specifier of readSpecifiers(fs.readFileSync(importFile, 'utf8'))) {
145
+ if (findPackageByName({ packages, specifier })) {
146
+ queue.push({ specifier, from: null });
147
+ }
148
+ }
149
+ }
150
+
151
+ while (queue.length > 0) {
152
+ const { specifier, from } = queue.shift();
153
+ const result = resolveSpecifier({ packages, specifier, from });
154
+ if (result === null) {
155
+ continue;
156
+ }
157
+ const { owner, resolved } = result;
158
+ if (resolved === null) {
159
+ unsureDirs.add(owner.dir);
160
+ continue;
161
+ }
162
+ if (!type.isNone(resolved.specifier)) {
163
+ queue.push({ specifier: resolved.specifier, from });
164
+ continue;
165
+ }
166
+ const { filePath } = resolved;
167
+ const filePackage = findPackageByFile({ packages, filePath });
168
+ // A file outside every local package is not watched, so it cannot
169
+ // restart the server either way.
170
+ if (filePackage === undefined || files.has(filePath)) {
171
+ continue;
172
+ }
173
+ files.add(filePath);
174
+ if (path.extname(filePath) === '.json') {
175
+ continue;
176
+ }
177
+ const source = stripComments(fs.readFileSync(filePath, 'utf8'));
178
+ if (hasNonLiteralDynamicImport(source)) {
179
+ unsureDirs.add(filePackage.dir);
180
+ }
181
+ for (const next of readSpecifiers(source)) {
182
+ queue.push({ specifier: next, from: filePath });
183
+ }
184
+ }
185
+ return { files, unsureDirs };
186
+ }
187
+
188
+ export default listServerPluginFiles;
@@ -0,0 +1,257 @@
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 { afterEach, beforeEach, expect, test } from 'vitest';
21
+
22
+ import listServerPluginFiles from './listServerPluginFiles.mjs';
23
+
24
+ let root;
25
+ let directories;
26
+ let pluginDir;
27
+ let packages;
28
+
29
+ function write(filePath, content) {
30
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
31
+ fs.writeFileSync(filePath, content);
32
+ }
33
+
34
+ function relativeFiles(files) {
35
+ return [...files].map((filePath) => path.relative(pluginDir, filePath)).sort();
36
+ }
37
+
38
+ function writePackageJson(packageJson) {
39
+ write(
40
+ path.join(pluginDir, 'package.json'),
41
+ JSON.stringify({ name: '@app/plugin', type: 'module', ...packageJson })
42
+ );
43
+ }
44
+
45
+ beforeEach(() => {
46
+ root = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-server-files-test-')));
47
+ const server = path.join(root, 'app', '.lowdefy', 'dev');
48
+ directories = { build: path.join(server, 'build'), server };
49
+ pluginDir = path.join(root, 'plugins', 'plugin');
50
+ write(
51
+ path.join(pluginDir, 'package.json'),
52
+ JSON.stringify({
53
+ name: '@app/plugin',
54
+ type: 'module',
55
+ exports: { './connections': './dist/connections.js', './blocks': './dist/blocks.js' },
56
+ })
57
+ );
58
+ fs.mkdirSync(path.join(server, 'node_modules', '@app'), { recursive: true });
59
+ fs.symlinkSync(pluginDir, path.join(server, 'node_modules', '@app', 'plugin'), 'dir');
60
+ write(
61
+ path.join(directories.build, 'plugins', 'connections.js'),
62
+ "import { Api as Api } from '@app/plugin/connections';\nexport default { Api };\n"
63
+ );
64
+ write(
65
+ path.join(directories.build, 'plugins', 'blocks.js'),
66
+ "import { Card as Card } from '@app/plugin/blocks';\nexport default { Card };\n"
67
+ );
68
+ write(
69
+ path.join(pluginDir, 'dist', 'blocks.js'),
70
+ "export { default as Card } from './Card.js';\n"
71
+ );
72
+ write(path.join(pluginDir, 'dist', 'Card.js'), "import format from './shared/format.js';\n");
73
+ write(path.join(pluginDir, 'dist', 'shared', 'format.js'), 'export default 1;\n');
74
+ packages = [{ package: '@app/plugin', dir: pluginDir }];
75
+ });
76
+
77
+ afterEach(() => {
78
+ fs.rmSync(root, { recursive: true, force: true });
79
+ });
80
+
81
+ test('listServerPluginFiles lists the files reachable from server-side plugin imports only', () => {
82
+ write(
83
+ path.join(pluginDir, 'dist', 'connections.js'),
84
+ "export { default as Api } from './Api/Api.js';\n"
85
+ );
86
+ write(
87
+ path.join(pluginDir, 'dist', 'Api', 'Api.js'),
88
+ [
89
+ "import request from './request';",
90
+ "import format from '../shared/format.js';",
91
+ "import data from './data.json' with { type: 'json' };",
92
+ "const lazy = () => import('./lazy.js');",
93
+ "import lodash from 'lodash';",
94
+ ].join('\n')
95
+ );
96
+ write(path.join(pluginDir, 'dist', 'Api', 'request.js'), 'export default 1;\n');
97
+ write(path.join(pluginDir, 'dist', 'Api', 'data.json'), '{}');
98
+ write(path.join(pluginDir, 'dist', 'Api', 'lazy.js'), 'export default 1;\n');
99
+
100
+ const { files, unsureDirs } = listServerPluginFiles({ directories, packages });
101
+
102
+ expect(relativeFiles(files)).toEqual([
103
+ 'dist/Api/Api.js',
104
+ 'dist/Api/data.json',
105
+ 'dist/Api/lazy.js',
106
+ 'dist/Api/request.js',
107
+ 'dist/connections.js',
108
+ 'dist/shared/format.js',
109
+ ]);
110
+ expect(unsureDirs.size).toBe(0);
111
+ });
112
+
113
+ test('listServerPluginFiles resolves a directory import to its index file', () => {
114
+ write(path.join(pluginDir, 'dist', 'connections.js'), "export * from './Api';\n");
115
+ write(path.join(pluginDir, 'dist', 'Api', 'index.js'), 'export const Api = 1;\n');
116
+
117
+ expect(relativeFiles(listServerPluginFiles({ directories, packages }).files)).toEqual([
118
+ 'dist/Api/index.js',
119
+ 'dist/connections.js',
120
+ ]);
121
+ });
122
+
123
+ test('listServerPluginFiles resolves a TypeScript import of an output name to its source', () => {
124
+ writePackageJson({ exports: { './connections': './src/connections.ts' } });
125
+ write(
126
+ path.join(pluginDir, 'src', 'connections.ts'),
127
+ "export { default as Api } from './Api.js';\n"
128
+ );
129
+ write(path.join(pluginDir, 'src', 'Api.ts'), 'export default 1;\n');
130
+
131
+ const { files, unsureDirs } = listServerPluginFiles({ directories, packages });
132
+
133
+ expect(relativeFiles(files)).toEqual(['src/Api.ts', 'src/connections.ts']);
134
+ expect(unsureDirs.size).toBe(0);
135
+ });
136
+
137
+ test('listServerPluginFiles follows the ES module export of a package that also exports CommonJS', () => {
138
+ writePackageJson({
139
+ exports: {
140
+ './connections': { require: './cjs/connections.cjs', import: './esm/connections.js' },
141
+ },
142
+ });
143
+ write(
144
+ path.join(pluginDir, 'esm', 'connections.js'),
145
+ "export { default as Api } from './Api.js';\n"
146
+ );
147
+ write(path.join(pluginDir, 'esm', 'Api.js'), 'export default 1;\n');
148
+ write(path.join(pluginDir, 'cjs', 'connections.cjs'), "module.exports = require('./Api.cjs');\n");
149
+ write(path.join(pluginDir, 'cjs', 'Api.cjs'), 'module.exports = 1;\n');
150
+
151
+ expect(relativeFiles(listServerPluginFiles({ directories, packages }).files)).toEqual([
152
+ 'esm/Api.js',
153
+ 'esm/connections.js',
154
+ ]);
155
+ });
156
+
157
+ test('listServerPluginFiles follows subpath imports through the package imports field', () => {
158
+ writePackageJson({
159
+ exports: { './connections': './src/connections.js' },
160
+ imports: { '#lib/*': './src/lib/*', '#lodash': 'lodash' },
161
+ });
162
+ write(
163
+ path.join(pluginDir, 'src', 'connections.js'),
164
+ "import query from '#lib/query.js';\nimport lodash from '#lodash';\nexport const Api = query;\n"
165
+ );
166
+ write(path.join(pluginDir, 'src', 'lib', 'query.js'), 'export default 1;\n');
167
+
168
+ const { files, unsureDirs } = listServerPluginFiles({ directories, packages });
169
+
170
+ expect(relativeFiles(files)).toEqual(['src/connections.js', 'src/lib/query.js']);
171
+ expect(unsureDirs.size).toBe(0);
172
+ });
173
+
174
+ test('listServerPluginFiles follows server imports into another local package', () => {
175
+ const helpersDir = path.join(root, 'plugins', 'helpers');
176
+ write(
177
+ path.join(helpersDir, 'package.json'),
178
+ JSON.stringify({ name: '@app/helpers', type: 'module', exports: { './query': './query.js' } })
179
+ );
180
+ write(path.join(helpersDir, 'query.js'), 'export default 1;\n');
181
+ write(path.join(helpersDir, 'Card.js'), 'export default 1;\n');
182
+ write(
183
+ path.join(pluginDir, 'dist', 'connections.js'),
184
+ "import query from '@app/helpers/query';\nexport const Api = query;\n"
185
+ );
186
+
187
+ const { files } = listServerPluginFiles({
188
+ directories,
189
+ packages: [...packages, { package: '@app/helpers', dir: helpersDir }],
190
+ });
191
+
192
+ expect(files.has(path.join(helpersDir, 'query.js'))).toBe(true);
193
+ expect(files.has(path.join(helpersDir, 'Card.js'))).toBe(false);
194
+ });
195
+
196
+ test('listServerPluginFiles marks a package unsure when server code imports a computed path', () => {
197
+ write(
198
+ path.join(pluginDir, 'dist', 'connections.js'),
199
+ "import format from './shared/format.js';\nexport const Api = (name) => import(`./handlers/${name}.js`);\n"
200
+ );
201
+
202
+ const { files, unsureDirs } = listServerPluginFiles({ directories, packages });
203
+
204
+ expect([...unsureDirs]).toEqual([pluginDir]);
205
+ expect(relativeFiles(files)).toEqual(['dist/connections.js', 'dist/shared/format.js']);
206
+ });
207
+
208
+ test('listServerPluginFiles marks a package unsure when a server import cannot be resolved', () => {
209
+ write(path.join(pluginDir, 'dist', 'connections.js'), "export { Api } from './missing.js';\n");
210
+
211
+ expect([...listServerPluginFiles({ directories, packages }).unsureDirs]).toEqual([pluginDir]);
212
+ });
213
+
214
+ test('listServerPluginFiles marks a package unsure when it does not export a server import', () => {
215
+ writePackageJson({ exports: { './blocks': './dist/blocks.js' } });
216
+
217
+ expect([...listServerPluginFiles({ directories, packages }).unsureDirs]).toEqual([pluginDir]);
218
+ });
219
+
220
+ test('listServerPluginFiles ignores imports written in comments', () => {
221
+ write(
222
+ path.join(pluginDir, 'dist', 'connections.js'),
223
+ [
224
+ '/* A computed import(name) would be refused. */',
225
+ "// import('./missing.js') used to live here",
226
+ "const url = 'https://example.com/docs';",
227
+ 'export const Api = url;',
228
+ ].join('\n')
229
+ );
230
+
231
+ const { files, unsureDirs } = listServerPluginFiles({ directories, packages });
232
+
233
+ expect(relativeFiles(files)).toEqual(['dist/connections.js']);
234
+ expect(unsureDirs.size).toBe(0);
235
+ });
236
+
237
+ test('listServerPluginFiles reads comment markers inside strings as text', () => {
238
+ write(
239
+ path.join(pluginDir, 'dist', 'connections.js'),
240
+ [
241
+ "const pattern = 'handlers/*';",
242
+ 'export const Api = (name) => import(`./handlers/${name}.js`);',
243
+ '/** A later comment. */',
244
+ ].join('\n')
245
+ );
246
+
247
+ expect([...listServerPluginFiles({ directories, packages }).unsureDirs]).toEqual([pluginDir]);
248
+ });
249
+
250
+ test('listServerPluginFiles lists nothing when the build has no plugin import files', () => {
251
+ fs.rmSync(path.join(directories.build, 'plugins'), { recursive: true });
252
+
253
+ const { files, unsureDirs } = listServerPluginFiles({ directories, packages });
254
+
255
+ expect(files.size).toBe(0);
256
+ expect(unsureDirs.size).toBe(0);
257
+ });
@@ -23,6 +23,7 @@ import findBuildFilesOutsideWatch from '../utils/findBuildFilesOutsideWatch.mjs'
23
23
  import getLowdefyVersion from '../utils/getLowdefyVersion.mjs';
24
24
  import loadSkeletonSourceFiles from '../utils/loadSkeletonSourceFiles.mjs';
25
25
  import pagePathChanged from '../utils/pagePathChanged.mjs';
26
+ import { clearPluginTypeCache } from '../utils/pluginTypeCache.mjs';
26
27
  import setupWatcher from '../utils/setupWatcher.mjs';
27
28
  import updatePageTailwindCss from '../utils/updatePageTailwindCss.mjs';
28
29
 
@@ -72,6 +73,10 @@ async function lowdefyBuildWatcher(context) {
72
73
  context.logger.warn('Lowdefy version changed. You should restart your development server.');
73
74
  process.exit();
74
75
  }
76
+ // The root lowdefy.yaml lists the plugins, and pluginSourceWatcher reads
77
+ // that list only at start, so a plugin added or changed here is read
78
+ // afresh. Other config edits keep the plugin type cache.
79
+ clearPluginTypeCache();
75
80
  }
76
81
 
77
82
  try {
@@ -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, beforeEach, expect, test } from 'vitest';
21
21
 
22
22
  import flushFsEvents from '../../test-utils/flushFsEvents.mjs';
23
23
  import spyOnChokidar from '../../test-utils/spyOnChokidar.mjs';
@@ -26,15 +26,20 @@ import waitFor from '../../test-utils/waitFor.mjs';
26
26
  // The path each page file declares now, as resolvePagePath would read it. A
27
27
  // page left out declares no path, so its path is its id.
28
28
  const declaredPaths = new Map();
29
- jest.unstable_mockModule('@lowdefy/build/dev', () => ({
30
- resolvePagePath: jest.fn(async ({ pageId }) => declaredPaths.get(pageId) ?? pageId),
29
+ vi.doMock('@lowdefy/build/dev', () => ({
30
+ resolvePagePath: vi.fn(async ({ pageId }) => declaredPaths.get(pageId) ?? pageId),
31
+ }));
32
+
33
+ const mockClearPluginTypeCache = vi.fn();
34
+ vi.doMock('../utils/pluginTypeCache.mjs', () => ({
35
+ clearPluginTypeCache: mockClearPluginTypeCache,
31
36
  }));
32
37
 
33
38
  const watchers = spyOnChokidar();
34
39
  const { default: lowdefyBuildWatcher } = await import('./lowdefyBuildWatcher.mjs');
35
40
 
36
41
  // macOS can hold file events back for tens of seconds on a busy machine.
37
- jest.setTimeout(180000);
42
+ vi.setConfig({ testTimeout: 180000, hookTimeout: 180000 });
38
43
 
39
44
  function write(filePath, content) {
40
45
  fs.mkdirSync(path.dirname(filePath), { recursive: true });
@@ -90,6 +95,7 @@ async function editUntilInvalidated(filePath) {
90
95
  // The app lives in a git worktree under a dot-folder, like the worktrees
91
96
  // Claude Code creates under .claude/worktrees/.
92
97
  beforeEach(async () => {
98
+ mockClearPluginTypeCache.mockClear();
93
99
  const tmpDir = fs.realpathSync(os.tmpdir());
94
100
  repoDir = fs.mkdtempSync(path.join(tmpDir, 'lowdefy-build-watcher-test-'));
95
101
  const worktreeDir = path.join(repoDir, '.claude', 'worktrees', 'feature');
@@ -139,13 +145,13 @@ beforeEach(async () => {
139
145
  config: configDir,
140
146
  server: path.join(configDir, '.lowdefy', 'server'),
141
147
  },
142
- logger: { info: jest.fn(), warn: jest.fn(), error: jest.fn() },
143
- buildActivity: { setBusy: jest.fn() },
144
- lowdefyBuild: jest.fn(async () => {}),
148
+ logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn() },
149
+ buildActivity: { setBusy: vi.fn() },
150
+ lowdefyBuild: vi.fn(async () => {}),
145
151
  pageRegistry: new Map([['home', { pageId: 'home', refPath: 'pages/home.yaml' }]]),
146
152
  options: { watch: [], watchIgnore: [] },
147
- reloadClients: jest.fn(async () => {}),
148
- syncServer: jest.fn(async () => {}),
153
+ reloadClients: vi.fn(async () => {}),
154
+ syncServer: vi.fn(async () => {}),
149
155
  version: 'local',
150
156
  };
151
157
  });
@@ -168,6 +174,39 @@ test('a page file edit in an app under a dot-folder invalidates pages', async ()
168
174
  });
169
175
  expect(context.lowdefyBuild).not.toHaveBeenCalled();
170
176
  expect(context.syncServer).not.toHaveBeenCalled();
177
+ expect(mockClearPluginTypeCache).not.toHaveBeenCalled();
178
+ });
179
+
180
+ test('watchIgnore globs and node_modules are not watched', async () => {
181
+ const draft = path.join(configDir, 'drafts', 'page.yaml');
182
+ const dependency = path.join(configDir, 'node_modules', 'pkg', 'page.yaml');
183
+ write(draft, 'id: draft\n');
184
+ write(dependency, 'id: dependency\n');
185
+ await flushFsEvents();
186
+ context.options.watchIgnore = ['drafts/**'];
187
+
188
+ const configWatcher = await startWatcher();
189
+
190
+ expect(isWatched({ configWatcher, filePath: draft })).toBe(false);
191
+ expect(isWatched({ configWatcher, filePath: dependency })).toBe(false);
192
+ expect(isWatched({ configWatcher, filePath: path.join(configDir, 'pages', 'home.yaml') })).toBe(
193
+ true
194
+ );
195
+ });
196
+
197
+ test('a --watch glob watches the files it matches and no others', async () => {
198
+ const shared = path.join(repoDir, 'shared');
199
+ const block = path.join(shared, 'blocks', 'title.yaml');
200
+ const notes = path.join(shared, 'blocks', 'notes.md');
201
+ write(block, 'id: title\n');
202
+ write(notes, 'notes\n');
203
+ await flushFsEvents();
204
+ context.options.watch = [path.join(shared, '**', '*.yaml')];
205
+
206
+ const configWatcher = await startWatcher();
207
+
208
+ expect(isWatched({ configWatcher, filePath: block })).toBe(true);
209
+ expect(isWatched({ configWatcher, filePath: notes })).toBe(false);
171
210
  });
172
211
 
173
212
  test('a page file edit that changes the page path rebuilds the config', async () => {
@@ -181,7 +220,7 @@ test('a page file edit that changes the page path rebuilds the config', async ()
181
220
  await waitFor(invalidated, { description: 'the pages to be invalidated' });
182
221
  });
183
222
 
184
- test('adding a page to the pages list rebuilds the config', async () => {
223
+ test('adding a page to the pages list rebuilds the config and keeps the plugin type cache', async () => {
185
224
  await startWatcher();
186
225
  fs.appendFileSync(path.join(configDir, 'pages.yaml'), '- _ref: pages/about.yaml\n');
187
226
 
@@ -189,6 +228,20 @@ test('adding a page to the pages list rebuilds the config', async () => {
189
228
  description: 'a config build',
190
229
  });
191
230
  await waitFor(invalidated, { description: 'the pages to be invalidated' });
231
+ expect(mockClearPluginTypeCache).not.toHaveBeenCalled();
232
+ });
233
+
234
+ test('a root lowdefy.yaml edit clears the plugin type cache before the config build', async () => {
235
+ await startWatcher();
236
+ write(path.join(configDir, 'lowdefy.yaml'), 'lowdefy: local\nplugins:\n - name: app-plugin\n');
237
+
238
+ await waitFor(() => context.lowdefyBuild.mock.calls.length === 1, {
239
+ description: 'a config build',
240
+ });
241
+ expect(mockClearPluginTypeCache).toHaveBeenCalledTimes(1);
242
+ expect(mockClearPluginTypeCache.mock.invocationCallOrder[0]).toBeLessThan(
243
+ context.lowdefyBuild.mock.invocationCallOrder[0]
244
+ );
192
245
  });
193
246
 
194
247
  test('a config rebuild stays busy until the server has caught up with the build', async () => {