@lowdefy/server-dev 7.0.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (445) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/checkSharedCollectionIds.js +20 -9
  44. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
  45. package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
  46. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  47. package/lib/docs/dataSets/getDataStore.js +11 -3
  48. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  49. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  50. package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
  51. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  52. package/lib/docs/dataSets/openDataSession.js +36 -20
  53. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
  54. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  55. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  56. package/lib/docs/dataSets/readDataSet.js +34 -19
  57. package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
  58. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  59. package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
  60. package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
  61. package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
  62. package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
  63. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  64. package/lib/docs/devEventBus.js +7 -2
  65. package/lib/docs/devEventBus.test.mjs +12 -10
  66. package/lib/docs/devToolDefinitions.js +87 -135
  67. package/lib/docs/device/buildDeviceCommand.js +103 -0
  68. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  69. package/lib/docs/device/captureDevice.js +85 -0
  70. package/lib/docs/device/checkShownPage.js +56 -0
  71. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  72. package/lib/docs/device/deviceAction.js +74 -0
  73. package/lib/docs/device/deviceTools.test.mjs +604 -0
  74. package/lib/docs/device/findDeviceTab.js +50 -0
  75. package/lib/docs/device/findDeviceTarget.js +73 -0
  76. package/lib/docs/device/injectDevice.js +160 -0
  77. package/lib/docs/device/listDevices.js +100 -0
  78. package/lib/docs/device/listDevices.test.mjs +105 -0
  79. package/lib/docs/device/runDeviceJourney.js +68 -0
  80. package/lib/docs/device/runDeviceSteps.js +164 -0
  81. package/lib/docs/device/screenshotDevice.js +68 -0
  82. package/lib/docs/device/sendDeviceStep.js +52 -0
  83. package/lib/docs/device/startDevice.js +150 -0
  84. package/lib/docs/docs.test.mjs +44 -28
  85. package/lib/docs/docsIndex.test.mjs +1 -0
  86. package/lib/docs/findConfig.js +3 -4
  87. package/lib/docs/findPageBlock.js +35 -0
  88. package/lib/docs/findPageBlock.test.mjs +45 -0
  89. package/lib/docs/fitResponse.js +18 -17
  90. package/lib/docs/fitResponse.test.mjs +18 -0
  91. package/lib/docs/getBrowser.js +4 -4
  92. package/lib/docs/getBrowser.test.mjs +32 -16
  93. package/lib/docs/getBuildId.test.mjs +1 -0
  94. package/lib/docs/getBuildStatus.js +29 -3
  95. package/lib/docs/getBuildStatus.test.mjs +108 -12
  96. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  97. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  98. package/lib/docs/getHazards.js +4 -1
  99. package/lib/docs/getHazards.test.mjs +9 -7
  100. package/lib/docs/getOverview.js +22 -44
  101. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  102. package/lib/docs/getStaleStatus.test.mjs +1 -0
  103. package/lib/docs/inspectState.js +78 -3
  104. package/lib/docs/inspectState.test.mjs +61 -9
  105. package/lib/docs/inspectStateFromTab.js +38 -6
  106. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  107. package/lib/docs/inspectStateHeadless.js +98 -34
  108. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  109. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  110. package/lib/docs/installHeadlessShell.js +5 -2
  111. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  112. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  113. package/lib/docs/isDeepEqual.js +37 -0
  114. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  115. package/lib/docs/isPageReady.test.mjs +1 -0
  116. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  117. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  118. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  119. package/lib/docs/launchBrowser.test.mjs +8 -8
  120. package/lib/docs/listTypes.js +58 -8
  121. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  122. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  123. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  124. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  125. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  126. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  127. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  128. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  129. package/lib/docs/pollTab.js +100 -0
  130. package/lib/docs/pollTab.test.mjs +64 -0
  131. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  132. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  133. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  134. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  135. package/lib/docs/rails/findExternalBlocks.js +3 -3
  136. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  137. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  138. package/lib/docs/readJourneySession.js +1 -1
  139. package/lib/docs/reportDevToolFault.js +29 -0
  140. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  141. package/lib/docs/requestRestart.test.mjs +1 -0
  142. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  143. package/lib/docs/resolveSource.js +2 -2
  144. package/lib/docs/resolveSource.test.mjs +6 -6
  145. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  146. package/lib/docs/runCheck.test.mjs +3 -3
  147. package/lib/docs/runCheckChild.js +2 -1
  148. package/lib/docs/runEndpoint.js +23 -10
  149. package/lib/docs/runEndpoint.test.mjs +42 -37
  150. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  151. package/lib/docs/runJourney.js +21 -1
  152. package/lib/docs/runJourney.test.mjs +119 -99
  153. package/lib/docs/runJourneyDataSet.test.mjs +26 -26
  154. package/lib/docs/runJourneySteps.js +8 -29
  155. package/lib/docs/runRequest.js +6 -6
  156. package/lib/docs/runRequest.test.mjs +22 -22
  157. package/lib/docs/screenshotPage.js +6 -7
  158. package/lib/docs/screenshotPage.test.mjs +46 -46
  159. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  160. package/lib/docs/searchDocs.test.mjs +1 -0
  161. package/lib/docs/searchIcons.test.mjs +5 -5
  162. package/lib/docs/selectFinalState.test.mjs +1 -0
  163. package/lib/docs/serverErrorStore.test.mjs +4 -4
  164. package/lib/docs/setupTestFixtures.mjs +25 -0
  165. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  166. package/lib/docs/tabAvailable.js +1 -1
  167. package/lib/docs/tabChannel.js +90 -14
  168. package/lib/docs/tabChannel.test.mjs +40 -15
  169. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  170. package/lib/docs/validateStateSelection.test.mjs +1 -0
  171. package/lib/docs/validateViewport.test.mjs +1 -0
  172. package/lib/docs/waitForBuild.test.mjs +1 -0
  173. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  174. package/lib/docs/withDataSession.js +2 -2
  175. package/lib/server/applyDataSetRedirect.js +14 -5
  176. package/lib/server/applyDataSetRedirect.test.mjs +121 -15
  177. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
  178. package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
  179. package/lib/server/auth/getHeadlessUser.js +6 -0
  180. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  181. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  182. package/lib/server/contextMapBudget.test.mjs +3 -3
  183. package/lib/server/continueJitKeys.test.mjs +1 -0
  184. package/lib/server/createLowdefyContext.js +8 -4
  185. package/lib/server/createLowdefyContext.test.mjs +38 -35
  186. package/lib/server/getClientAddress.test.mjs +2 -2
  187. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  188. package/lib/server/importAppCode.test.mjs +2 -2
  189. package/lib/server/jitPageBuilder.js +27 -3
  190. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  191. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  192. package/lib/server/jitPageBuilder.test.mjs +4 -4
  193. package/lib/server/journeyCookies.test.mjs +1 -0
  194. package/lib/server/loadDynamicJsMap.js +10 -1
  195. package/lib/server/log/createHandleError.js +10 -5
  196. package/lib/server/log/createHandleError.test.mjs +19 -8
  197. package/lib/server/log/createLogger.test.mjs +2 -2
  198. package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
  199. package/lib/server/mutants/listMutants.test.mjs +1 -0
  200. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  201. package/lib/server/mutants/operators.test.mjs +1 -0
  202. package/lib/server/pageBuildRecords.test.mjs +1 -0
  203. package/lib/server/pageCache.test.mjs +1 -0
  204. package/lib/server/pageRebuilds.test.mjs +3 -3
  205. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  206. package/lib/server/pruneJitMaps.test.mjs +1 -0
  207. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  208. package/lib/server/readInstanceRecord.test.mjs +24 -8
  209. package/lib/server/readMergedMaps.test.mjs +1 -0
  210. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  211. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  212. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  213. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  214. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  215. package/lib/server/startIdleGc.test.mjs +25 -9
  216. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  217. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  218. package/manager/getContext.mjs +11 -2
  219. package/manager/processes/checkPendingPlugins.mjs +49 -0
  220. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  221. package/manager/processes/createIdleChild.mjs +141 -0
  222. package/manager/processes/createIdleChild.test.mjs +209 -0
  223. package/manager/processes/initialBuild.mjs +4 -15
  224. package/manager/processes/initialBuild.test.mjs +8 -37
  225. package/manager/processes/lowdefyBuild.mjs +11 -7
  226. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
  227. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  228. package/manager/processes/restartServer.test.mjs +63 -15
  229. package/manager/processes/shutdownServer.test.mjs +3 -3
  230. package/manager/processes/startFirstServer.test.mjs +23 -22
  231. package/manager/processes/startMailSink.mjs +11 -3
  232. package/manager/processes/startMailSink.test.mjs +28 -2
  233. package/manager/processes/startProxy.mjs +158 -27
  234. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  235. package/manager/processes/startProxy.test.mjs +127 -2
  236. package/manager/processes/startServer.mjs +5 -7
  237. package/manager/processes/startServer.test.mjs +10 -9
  238. package/manager/processes/syncServer.mjs +31 -4
  239. package/manager/processes/syncServer.test.mjs +71 -6
  240. package/manager/processes/waitForDevServer.test.mjs +21 -6
  241. package/manager/run.mjs +32 -8
  242. package/manager/utils/BatchChanges.mjs +1 -1
  243. package/manager/utils/BatchChanges.test.mjs +4 -4
  244. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  245. package/manager/utils/checkPairing.mjs +45 -0
  246. package/manager/utils/checkPairing.test.mjs +53 -0
  247. package/manager/utils/createBuildActivity.mjs +5 -1
  248. package/manager/utils/createBuildActivity.test.mjs +2 -2
  249. package/manager/utils/createChangeSignal.test.mjs +5 -5
  250. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  251. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  252. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  253. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  254. package/manager/utils/createGlobIgnore.mjs +45 -0
  255. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  256. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  257. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  258. package/manager/utils/createIdleGc.test.mjs +31 -15
  259. package/manager/utils/createLanPairing.mjs +34 -0
  260. package/manager/utils/createLanPairing.test.mjs +46 -0
  261. package/manager/utils/createRequestActivity.mjs +30 -3
  262. package/manager/utils/createRequestActivity.test.mjs +76 -22
  263. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  264. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  265. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  266. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  267. package/manager/utils/findSignInCode.test.mjs +33 -0
  268. package/manager/utils/formatLanPairing.mjs +32 -0
  269. package/manager/utils/formatLanPairing.test.mjs +40 -0
  270. package/manager/utils/getLanAddress.mjs +83 -0
  271. package/manager/utils/getLanAddress.test.mjs +70 -0
  272. package/manager/utils/importFresh.test.mjs +1 -0
  273. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  274. package/manager/utils/pluginTypeCache.mjs +100 -0
  275. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  276. package/manager/utils/pruneRecordings.test.mjs +1 -0
  277. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  278. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  279. package/manager/utils/readBasePath.test.mjs +1 -0
  280. package/manager/utils/readManagerVersion.test.mjs +1 -0
  281. package/manager/utils/readPluginDefinitions.mjs +6 -6
  282. package/manager/utils/renderTerminalQr.mjs +54 -0
  283. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  284. package/manager/utils/setupWatcher.mjs +19 -4
  285. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  286. package/manager/utils/waitForChildExit.test.mjs +2 -2
  287. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  288. package/manager/watchers/envWatcher.mjs +3 -0
  289. package/manager/watchers/envWatcher.test.mjs +19 -7
  290. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  291. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  292. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  293. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  294. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  295. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  296. package/manager/watchers/resolveFile.mjs +46 -0
  297. package/manager/watchers/resolveFile.test.mjs +67 -0
  298. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  299. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  300. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  301. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  302. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  303. package/package.json +50 -49
  304. package/package.original.json +50 -49
  305. package/src/app.js +83 -85
  306. package/src/html/renderDevPage.test.mjs +1 -0
  307. package/src/lib/getPathSegments.js +16 -1
  308. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  309. package/src/lib/isTabAnswer.js +32 -0
  310. package/src/lib/isTabChannelCaller.js +35 -0
  311. package/src/middleware/apiContext.js +4 -2
  312. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  313. package/src/middleware/errorHandler.js +33 -45
  314. package/src/middleware/errorHandler.test.mjs +10 -10
  315. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  316. package/src/middleware/localDevToolsOnly.js +13 -1
  317. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  318. package/src/middleware/noStore.test.mjs +1 -0
  319. package/src/middleware/staleFlag.test.mjs +1 -0
  320. package/src/middleware/stampCaller.test.mjs +1 -0
  321. package/src/routes/agentBearer.test.mjs +183 -0
  322. package/src/routes/auth.test.mjs +10 -10
  323. package/src/routes/clientError.js +21 -4
  324. package/src/routes/clientError.test.mjs +127 -0
  325. package/src/routes/devInspect.js +6 -51
  326. package/src/routes/devInspect.test.mjs +128 -3
  327. package/src/routes/devRecording.js +6 -17
  328. package/src/routes/devRecording.test.mjs +54 -3
  329. package/src/routes/docs/buildStatus.test.mjs +6 -6
  330. package/src/routes/docs/events.test.mjs +4 -4
  331. package/src/routes/docs/find.js +3 -3
  332. package/src/routes/docs/journey.test.mjs +8 -8
  333. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  334. package/src/routes/docs/loadDocsRoutes.js +70 -0
  335. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  336. package/src/routes/docs/mcp.test.mjs +5 -5
  337. package/src/routes/docs/mutants.js +7 -0
  338. package/src/routes/docs/mutants.test.mjs +20 -6
  339. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  340. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  341. package/src/routes/docs/restart.test.mjs +1 -0
  342. package/src/routes/endpoints.js +24 -0
  343. package/src/routes/endpointsLink.test.mjs +111 -0
  344. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  345. package/src/routes/jitPage.js +13 -1
  346. package/src/routes/jitPage.test.mjs +36 -11
  347. package/src/routes/mcp.js +6 -0
  348. package/src/routes/mcp.test.mjs +23 -8
  349. package/src/routes/mcpMemberToken.test.mjs +8 -8
  350. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  351. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  352. package/src/routes/mobileRoutes.test.mjs +223 -0
  353. package/src/routes/mobileSignIn.js +58 -0
  354. package/src/routes/mobileSignIn.test.mjs +59 -0
  355. package/src/routes/mobileSignInCallback.js +34 -0
  356. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  357. package/src/routes/mountDevPageRoutes.js +10 -2
  358. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  359. package/src/routes/mountMobileWellKnown.js +35 -0
  360. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  361. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  362. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  363. package/src/routes/reload.js +101 -20
  364. package/src/routes/reload.test.mjs +153 -0
  365. package/src/routes/request.js +1 -22
  366. package/src/routes/request.test.mjs +7 -24
  367. package/src/routes/requestBody.test.mjs +14 -27
  368. package/src/routes/websocket.test.mjs +2 -2
  369. package/src/routes/wellKnownFallback.test.mjs +2 -2
  370. package/src/websocket/devWebSocket.test.mjs +12 -12
  371. package/vite.config.js +13 -1
  372. package/client/feedback/FeedbackMount.jsx +0 -83
  373. package/client/feedback/FeedbackOverlay.jsx +0 -904
  374. package/client/feedback/captureTabScreenshot.js +0 -84
  375. package/client/feedback/copyToClipboard.js +0 -45
  376. package/client/feedback/drawAnnotationsSvg.js +0 -119
  377. package/client/feedback/feedbackStyles.js +0 -304
  378. package/client/feedback/pinResponsiveImages.js +0 -59
  379. package/client/feedback/sendFeedback.js +0 -39
  380. package/client/feedback/useFeedbackToggle.js +0 -70
  381. package/client/recorder/buildEngineRecord.js +0 -37
  382. package/client/recorder/buildInteractionRecord.js +0 -64
  383. package/client/recorder/buildTraceEvent.js +0 -57
  384. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  385. package/client/recorder/chunkRecords.js +0 -69
  386. package/client/recorder/chunkRecords.test.mjs +0 -59
  387. package/client/recorder/collectEventEndpoints.js +0 -40
  388. package/client/recorder/collectEventRequests.js +0 -39
  389. package/client/recorder/createPairingBuffer.js +0 -187
  390. package/client/recorder/createPasswordRedactor.js +0 -84
  391. package/client/recorder/createRecordBatcher.js +0 -54
  392. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  393. package/client/recorder/createRecordingSession.js +0 -61
  394. package/client/recorder/createRecordingSession.test.mjs +0 -72
  395. package/client/recorder/diffStateWrites.js +0 -77
  396. package/client/recorder/diffStateWrites.test.mjs +0 -66
  397. package/client/recorder/isEventCall.js +0 -30
  398. package/client/recorder/jsonType.js +0 -39
  399. package/client/recorder/sendRecords.js +0 -40
  400. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  401. package/lib/docs/checkpointPaths.js +0 -91
  402. package/lib/docs/checkpointStore.js +0 -243
  403. package/lib/docs/checkpointToMocks.js +0 -65
  404. package/lib/docs/configCheckpoints.test.mjs +0 -156
  405. package/lib/docs/createConfigCheckpoint.js +0 -92
  406. package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
  407. package/lib/docs/devMockRegistry.js +0 -68
  408. package/lib/docs/enrichFeedback.js +0 -71
  409. package/lib/docs/evalOperator.js +0 -49
  410. package/lib/docs/evalOperator.test.mjs +0 -157
  411. package/lib/docs/evalOperatorHeadless.js +0 -159
  412. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  413. package/lib/docs/evalOperatorInTab.js +0 -49
  414. package/lib/docs/formatFeedback.js +0 -142
  415. package/lib/docs/formatFeedback.test.mjs +0 -252
  416. package/lib/docs/getPluginDoc.js +0 -53
  417. package/lib/docs/listConfigCheckpoints.js +0 -55
  418. package/lib/docs/loadState.js +0 -220
  419. package/lib/docs/revertConfigCheckpoint.js +0 -73
  420. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  421. package/lib/docs/scaffoldPage.js +0 -77
  422. package/lib/docs/scaffoldPage.test.mjs +0 -97
  423. package/lib/docs/snapshotState.js +0 -67
  424. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  425. package/manager/watchers/listServerSidePackages.mjs +0 -47
  426. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  427. package/src/routes/docs/checkpointsCreate.js +0 -28
  428. package/src/routes/docs/evalOperator.js +0 -70
  429. package/src/routes/docs/inspectState.js +0 -59
  430. package/src/routes/docs/loadState.js +0 -51
  431. package/src/routes/docs/pluginDoc.js +0 -33
  432. package/src/routes/docs/plugins.js +0 -23
  433. package/src/routes/docs/runEndpoint.js +0 -54
  434. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  435. package/src/routes/docs/runRequest.js +0 -53
  436. package/src/routes/docs/runRequest.test.mjs +0 -92
  437. package/src/routes/docs/schema.js +0 -37
  438. package/src/routes/docs/screenshot.js +0 -120
  439. package/src/routes/docs/screenshot.test.mjs +0 -117
  440. package/src/routes/docs/search.js +0 -40
  441. package/src/routes/docs/snapshotState.js +0 -50
  442. package/src/routes/docs/stateCheckpointsList.js +0 -26
  443. package/src/routes/docs/types.js +0 -33
  444. package/src/routes/feedback.js +0 -107
  445. package/src/routes/feedback.test.mjs +0 -204
@@ -16,13 +16,18 @@
16
16
  */
17
17
 
18
18
  import { createRequire } from 'node:module';
19
- import { createPluginTypesMap } from '@lowdefy/build';
19
+ import { createPluginTypesMap, createPluginTypesMapMobile } from '@lowdefy/build';
20
+ import { hasTypesExport } from '@lowdefy/node-utils';
20
21
  import importFresh from './importFresh.mjs';
22
+ import { importPluginModule } from './pluginTypeCache.mjs';
21
23
  import readPluginDefinitions from './readPluginDefinitions.mjs';
22
24
 
23
25
  const require = createRequire(import.meta.url);
24
26
 
25
- async function createCustomPluginTypesMap({ directories, logger }) {
27
+ // The dev manager passes cache: true and reads each plugin from the plugin
28
+ // type cache. Other callers (lowdefy_check, the config tree build) must see
29
+ // what production would load, so they import every plugin afresh.
30
+ async function createCustomPluginTypesMap({ cache = false, directories, logger }) {
26
31
  const customTypesMap = {
27
32
  actions: {},
28
33
  agents: {},
@@ -45,35 +50,66 @@ async function createCustomPluginTypesMap({ directories, logger }) {
45
50
  websockets: {},
46
51
  };
47
52
 
48
- const pluginDefinitions = await readPluginDefinitions({ directories });
53
+ const { plugins, shellPlugins } = await readPluginDefinitions({ directories });
54
+ const customTypesMapMobile = {
55
+ actions: {},
56
+ blockMetas: {},
57
+ blocks: {},
58
+ icons: {},
59
+ operators: {
60
+ client: {},
61
+ },
62
+ plugins: shellPlugins.map((plugin) => plugin.name),
63
+ };
49
64
 
50
65
  // Each import starts a worker, so the plugins are imported in parallel and
51
- // added to the map in the order lowdefy.yaml lists them.
66
+ // added to the map in the order lowdefy.yaml lists them. A plugin only
67
+ // shells list may be native-only, with no ./types export: it adds no types.
68
+ // Root plugins must export ./types.
52
69
  const pluginTypes = await Promise.all(
53
- pluginDefinitions.map(async (plugin) => {
70
+ plugins.map(async (plugin) => {
71
+ if (plugin.shellOnly && !hasTypesExport({ name: plugin.name, require })) {
72
+ return {};
73
+ }
54
74
  try {
55
- return await importFresh(require.resolve(`${plugin.name}/types`));
75
+ const entryPath = require.resolve(`${plugin.name}/types`);
76
+ const types = cache
77
+ ? await importPluginModule({ entryPath, packageName: plugin.name })
78
+ : await importFresh(entryPath);
79
+ return types.default ?? types;
56
80
  } catch (e) {
57
- logger.error(`Failed to import plugin "${plugin.name}".`);
81
+ // The reason (a syntax error, a missing dependency) goes in the message,
82
+ // since the build status shows agents the message and cause, not this log.
83
+ logger.error(`Failed to import plugin "${plugin.name}": ${e.message}`);
58
84
  logger.debug(e);
59
85
  logger.info('If the plugin was added while the server was running, restart the server.');
60
- throw new Error(`Failed to import plugin "${plugin.name}".`);
86
+ throw new Error(`Failed to import plugin "${plugin.name}": ${e.message}`, { cause: e });
61
87
  }
62
88
  })
63
89
  );
64
90
 
65
- pluginDefinitions.forEach((plugin, index) => {
66
- const types = pluginTypes[index];
91
+ const packageTypes = new Map();
92
+ plugins.forEach((plugin, index) => {
93
+ packageTypes.set(plugin.name, pluginTypes[index]);
67
94
  createPluginTypesMap({
68
- packageTypes: types.default ?? types,
95
+ packageTypes: pluginTypes[index],
69
96
  typesMap: customTypesMap,
70
97
  packageName: plugin.name,
71
98
  version: plugin.version,
72
99
  typePrefix: plugin.typePrefix,
73
100
  });
74
101
  });
102
+ shellPlugins.forEach((plugin) => {
103
+ createPluginTypesMapMobile({
104
+ packageTypes: packageTypes.get(plugin.name),
105
+ typesMap: customTypesMapMobile,
106
+ packageName: plugin.name,
107
+ version: plugin.version,
108
+ typePrefix: plugin.typePrefix,
109
+ });
110
+ });
75
111
 
76
- return customTypesMap;
112
+ return { customTypesMap, customTypesMapMobile };
77
113
  }
78
114
 
79
115
  export default createCustomPluginTypesMap;
@@ -14,34 +14,68 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import fs from 'fs';
18
+ import os from 'os';
19
+ import path from 'path';
20
+ import { vi, afterAll, beforeEach, expect, test } from 'vitest';
18
21
 
19
- const mockImportFresh = jest.fn();
20
- jest.unstable_mockModule('./importFresh.mjs', () => ({ default: mockImportFresh }));
21
- const mockCreatePluginTypesMap = jest.fn();
22
- jest.unstable_mockModule('@lowdefy/build', () => ({
22
+ // The plugin type cache reads each entry file's stat and package.json, so the
23
+ // resolved entries are real files. Their contents are never imported.
24
+ const pluginsDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-custom-plugin-maps-'));
25
+ ['plugin-a', 'plugin-b'].forEach((name) => {
26
+ fs.mkdirSync(path.join(pluginsDir, name));
27
+ fs.writeFileSync(
28
+ path.join(pluginsDir, name, 'package.json'),
29
+ JSON.stringify({ name, version: '1.0.0' })
30
+ );
31
+ fs.writeFileSync(path.join(pluginsDir, name, 'types.js'), '');
32
+ fs.writeFileSync(path.join(pluginsDir, name, 'messages.js'), '');
33
+ });
34
+ const entry = (name) => path.join(pluginsDir, `${name}.js`);
35
+
36
+ const mockImportFresh = vi.fn();
37
+ vi.doMock('./importFresh.mjs', () => ({ default: mockImportFresh }));
38
+ const mockCreatePluginTypesMap = vi.fn();
39
+ const mockCreatePluginTypesMapMobile = vi.fn();
40
+ vi.doMock('@lowdefy/build', () => ({
23
41
  createPluginTypesMap: mockCreatePluginTypesMap,
42
+ createPluginTypesMapMobile: mockCreatePluginTypesMapMobile,
24
43
  }));
25
44
  // The module under test imports @lowdefy/build, which links against every
26
45
  // export it uses, so the real module passes through and only readFile is
27
46
  // replaced.
28
47
  const realNodeUtils = await import('@lowdefy/node-utils');
29
- jest.unstable_mockModule('@lowdefy/node-utils', () => ({
48
+ const mockReadFile = vi.fn(async () => 'plugins:\n - name: plugin-a\n - name: plugin-b\n');
49
+ // @example/lowdefy-mdm exports ./shell alone, a native-only shell plugin.
50
+ const mockHasTypesExport = vi.fn(({ name }) => name !== '@example/lowdefy-mdm');
51
+ vi.doMock('@lowdefy/node-utils', () => ({
30
52
  ...realNodeUtils,
31
- readFile: jest.fn(async () => 'plugins:\n - name: plugin-a\n - name: plugin-b\n'),
53
+ hasTypesExport: mockHasTypesExport,
54
+ readFile: mockReadFile,
32
55
  }));
33
- jest.unstable_mockModule('node:module', () => ({
34
- createRequire: () => ({ resolve: (name) => `/plugins/${name}.js` }),
56
+ vi.doMock('node:module', () => ({
57
+ createRequire: () => ({ resolve: entry }),
35
58
  }));
36
59
 
37
60
  const { default: createCustomPluginTypesMap } = await import('./createCustomPluginTypesMap.mjs');
38
61
  const { default: createCustomPluginMessagesMap } = await import(
39
62
  './createCustomPluginMessagesMap.mjs'
40
63
  );
64
+ const { clearPluginTypeCache } = await import('./pluginTypeCache.mjs');
41
65
 
42
- const logger = { debug: jest.fn(), error: jest.fn(), info: jest.fn() };
66
+ const logger = { debug: vi.fn(), error: vi.fn(), info: vi.fn() };
43
67
  const directories = { config: '/app' };
44
68
 
69
+ beforeEach(() => {
70
+ clearPluginTypeCache();
71
+ mockImportFresh.mockReset();
72
+ mockCreatePluginTypesMap.mockReset();
73
+ });
74
+
75
+ afterAll(() => {
76
+ fs.rmSync(pluginsDir, { recursive: true, force: true });
77
+ });
78
+
45
79
  // Holds every import open until release(), so a test can see which imports
46
80
  // started before any of them finished.
47
81
  function deferImports(values) {
@@ -60,13 +94,13 @@ function deferImports(values) {
60
94
 
61
95
  test('createCustomPluginTypesMap imports every plugin before any import finishes', async () => {
62
96
  const imports = deferImports({
63
- '/plugins/plugin-a/types.js': { blocks: ['A'] },
64
- '/plugins/plugin-b/types.js': { blocks: ['B'] },
97
+ [entry('plugin-a/types')]: { blocks: ['A'] },
98
+ [entry('plugin-b/types')]: { blocks: ['B'] },
65
99
  });
66
100
 
67
101
  const result = createCustomPluginTypesMap({ directories, logger });
68
102
  await new Promise((resolve) => setTimeout(resolve, 10));
69
- expect(imports.started()).toEqual(['/plugins/plugin-a/types.js', '/plugins/plugin-b/types.js']);
103
+ expect(imports.started()).toEqual([entry('plugin-a/types'), entry('plugin-b/types')]);
70
104
  imports.release();
71
105
  await result;
72
106
 
@@ -78,17 +112,145 @@ test('createCustomPluginTypesMap imports every plugin before any import finishes
78
112
 
79
113
  test('createCustomPluginMessagesMap imports every plugin before any import finishes', async () => {
80
114
  const imports = deferImports({
81
- '/plugins/plugin-a/messages.js': { hello: 'A' },
82
- '/plugins/plugin-b/messages.js': { hello: 'B' },
115
+ [entry('plugin-a/messages')]: { hello: 'A' },
116
+ [entry('plugin-b/messages')]: { hello: 'B' },
83
117
  });
84
118
 
85
119
  const result = createCustomPluginMessagesMap({ directories, logger });
86
120
  await new Promise((resolve) => setTimeout(resolve, 10));
87
- expect(imports.started()).toEqual([
88
- '/plugins/plugin-a/messages.js',
89
- '/plugins/plugin-b/messages.js',
90
- ]);
121
+ expect(imports.started()).toEqual([entry('plugin-a/messages'), entry('plugin-b/messages')]);
91
122
  imports.release();
92
123
 
93
124
  expect(await result).toEqual({ 'plugin-a': { hello: 'A' }, 'plugin-b': { hello: 'B' } });
94
125
  });
126
+
127
+ test('createCustomPluginTypesMap imports a plugin in root and two shells once and reads its native types', async () => {
128
+ mockCreatePluginTypesMap.mockClear();
129
+ mockReadFile.mockResolvedValueOnce(`
130
+ plugins:
131
+ - name: '@example/lowdefy-printer'
132
+ version: 2.1.0
133
+ mobile:
134
+ shells:
135
+ - id: field
136
+ plugins:
137
+ - name: '@example/lowdefy-printer'
138
+ version: 2.1.0
139
+ typePrefix: Printer
140
+ - id: staging
141
+ plugins:
142
+ - name: '@example/lowdefy-printer'
143
+ version: 2.1.0
144
+ typePrefix: Printer
145
+ `);
146
+ const printerTypes = { native: { blocks: ['Label'] } };
147
+ mockImportFresh.mockReset();
148
+ mockImportFresh.mockResolvedValue(printerTypes);
149
+
150
+ const { customTypesMapMobile } = await createCustomPluginTypesMap({ directories, logger });
151
+
152
+ expect(mockImportFresh.mock.calls).toEqual([[entry('@example/lowdefy-printer/types')]]);
153
+ expect(mockCreatePluginTypesMap.mock.calls.map(([args]) => args.typePrefix)).toEqual([undefined]);
154
+ expect(mockCreatePluginTypesMapMobile.mock.calls).toEqual([
155
+ [
156
+ {
157
+ packageName: '@example/lowdefy-printer',
158
+ packageTypes: printerTypes,
159
+ typePrefix: 'Printer',
160
+ typesMap: customTypesMapMobile,
161
+ version: '2.1.0',
162
+ },
163
+ ],
164
+ ]);
165
+ expect(customTypesMapMobile.plugins).toEqual(['@example/lowdefy-printer']);
166
+ });
167
+
168
+ test('createCustomPluginTypesMap skips ./types of a shell-only plugin that does not export it', async () => {
169
+ mockCreatePluginTypesMap.mockClear();
170
+ mockCreatePluginTypesMapMobile.mockClear();
171
+ mockReadFile.mockResolvedValueOnce(`
172
+ mobile:
173
+ shells:
174
+ - id: field
175
+ plugins:
176
+ - name: '@example/lowdefy-printer'
177
+ version: 2.1.0
178
+ typePrefix: Printer
179
+ - name: '@example/lowdefy-mdm'
180
+ version: 1.0.3
181
+ `);
182
+ const printerTypes = { native: { blocks: ['Label'] } };
183
+ mockImportFresh.mockReset();
184
+ mockImportFresh.mockResolvedValue(printerTypes);
185
+
186
+ const { customTypesMapMobile } = await createCustomPluginTypesMap({ directories, logger });
187
+
188
+ expect(mockImportFresh.mock.calls).toEqual([[entry('@example/lowdefy-printer/types')]]);
189
+ expect(mockCreatePluginTypesMapMobile.mock.calls.map(([args]) => args.packageTypes)).toEqual([
190
+ printerTypes,
191
+ {},
192
+ ]);
193
+ expect(customTypesMapMobile.plugins).toEqual([
194
+ '@example/lowdefy-printer',
195
+ '@example/lowdefy-mdm',
196
+ ]);
197
+ });
198
+
199
+ test('createCustomPluginTypesMap reads ./types of a root plugin without asking whether it exports it', async () => {
200
+ mockHasTypesExport.mockClear();
201
+ mockReadFile.mockResolvedValueOnce(`
202
+ plugins:
203
+ - name: '@example/lowdefy-mdm'
204
+ version: 1.0.3
205
+ `);
206
+ mockImportFresh.mockReset();
207
+ mockImportFresh.mockRejectedValue(new Error('No "./types" export.'));
208
+
209
+ await expect(createCustomPluginTypesMap({ directories, logger })).rejects.toThrow(
210
+ 'Failed to import plugin "@example/lowdefy-mdm": No "./types" export.'
211
+ );
212
+ expect(mockHasTypesExport).not.toHaveBeenCalled();
213
+ });
214
+
215
+ function resolveImports(values) {
216
+ mockImportFresh.mockImplementation(async (filePath) => values[filePath]);
217
+ }
218
+
219
+ test('a second cached build of the plugin maps starts no import workers', async () => {
220
+ resolveImports({
221
+ [entry('plugin-a/types')]: { blocks: ['A'] },
222
+ [entry('plugin-b/types')]: { blocks: ['B'] },
223
+ [entry('plugin-a/messages')]: { hello: 'A' },
224
+ [entry('plugin-b/messages')]: { hello: 'B' },
225
+ });
226
+ const build = () =>
227
+ Promise.all([
228
+ createCustomPluginTypesMap({ cache: true, directories, logger }),
229
+ createCustomPluginMessagesMap({ cache: true, directories, logger }),
230
+ ]);
231
+
232
+ await build();
233
+ expect(mockImportFresh).toHaveBeenCalledTimes(4);
234
+ const [, messagesMap] = await build();
235
+
236
+ expect(mockImportFresh).toHaveBeenCalledTimes(4);
237
+ expect(messagesMap).toEqual({ 'plugin-a': { hello: 'A' }, 'plugin-b': { hello: 'B' } });
238
+ expect(mockCreatePluginTypesMap.mock.calls.map(([args]) => args.packageTypes)).toEqual([
239
+ { blocks: ['A'] },
240
+ { blocks: ['B'] },
241
+ { blocks: ['A'] },
242
+ { blocks: ['B'] },
243
+ ]);
244
+ });
245
+
246
+ test('the plugin maps import every plugin afresh without cache: true', async () => {
247
+ resolveImports({
248
+ [entry('plugin-a/types')]: { blocks: ['A'] },
249
+ [entry('plugin-b/types')]: { blocks: ['B'] },
250
+ });
251
+
252
+ await createCustomPluginTypesMap({ directories, logger });
253
+ await createCustomPluginTypesMap({ directories, logger });
254
+
255
+ expect(mockImportFresh).toHaveBeenCalledTimes(4);
256
+ });
@@ -17,6 +17,7 @@
17
17
  import path from 'path';
18
18
 
19
19
  import createDotPathIgnore from './createDotPathIgnore.mjs';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  // setupWatcher hands the ignore function paths with the platform separator.
22
23
  const appRoot = path.join('/home/dev/repo/.claude/worktrees/feature/app');
@@ -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 path from 'path';
18
+
19
+ import picomatch from 'picomatch';
20
+
21
+ function toUnixPath(filePath) {
22
+ const normalized = path.normalize(filePath);
23
+ return path.sep === '\\' ? normalized.replace(/\\/g, '/') : normalized;
24
+ }
25
+
26
+ // chokidar 4 matches a string in `ignored` only as an exact path, where chokidar 3 read it as a
27
+ // glob, and a plain path as that path and everything under it. This compiles the string ignores
28
+ // into one function that matches them as chokidar 3 did, so '**/node_modules/**' and the app's
29
+ // watchIgnore globs still apply. Paths and patterns are compared with forward slashes, as
30
+ // chokidar 3 compared them.
31
+ function createGlobIgnore(patterns) {
32
+ const matchers = patterns.map((pattern) => {
33
+ const unixPattern = toUnixPath(pattern);
34
+ if (picomatch.scan(unixPattern).isGlob) {
35
+ return picomatch(unixPattern, { dot: true });
36
+ }
37
+ return (unixPath) => unixPath === unixPattern || unixPath.startsWith(`${unixPattern}/`);
38
+ });
39
+ return function isGlobIgnored(filePath) {
40
+ const unixPath = toUnixPath(filePath);
41
+ return matchers.some((matches) => matches(unixPath));
42
+ };
43
+ }
44
+
45
+ export default createGlobIgnore;
@@ -0,0 +1,58 @@
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 path from 'path';
18
+
19
+ import { expect, test } from 'vitest';
20
+
21
+ import createGlobIgnore from './createGlobIgnore.mjs';
22
+
23
+ // setupWatcher hands the ignore function paths with the platform separator.
24
+ const appRoot = path.join('/home/dev/repo/.claude/worktrees/feature/app');
25
+
26
+ test('a globstar pattern ignores matching paths at any depth, dot-folders included', () => {
27
+ const isIgnored = createGlobIgnore(['**/node_modules/**']);
28
+ expect(isIgnored(path.join(appRoot, 'node_modules/pkg/index.js'))).toBe(true);
29
+ expect(isIgnored(path.join(appRoot, 'modules/layout/node_modules/pkg/page.yaml'))).toBe(true);
30
+ expect(isIgnored(path.join(appRoot, 'pages/home.yaml'))).toBe(false);
31
+ });
32
+
33
+ test('an absolute watchIgnore glob ignores only the files it matches', () => {
34
+ const isIgnored = createGlobIgnore([path.join(appRoot, 'drafts/**/*.yaml')]);
35
+ expect(isIgnored(path.join(appRoot, 'drafts/page.yaml'))).toBe(true);
36
+ expect(isIgnored(path.join(appRoot, 'drafts/nested/page.yaml'))).toBe(true);
37
+ expect(isIgnored(path.join(appRoot, 'drafts/notes.md'))).toBe(false);
38
+ expect(isIgnored(path.join(appRoot, 'pages/page.yaml'))).toBe(false);
39
+ });
40
+
41
+ test('a plain path ignores that path and everything under it, as chokidar 3 did', () => {
42
+ const isIgnored = createGlobIgnore([path.join(appRoot, 'drafts')]);
43
+ expect(isIgnored(path.join(appRoot, 'drafts'))).toBe(true);
44
+ expect(isIgnored(path.join(appRoot, 'drafts/page.yaml'))).toBe(true);
45
+ expect(isIgnored(path.join(appRoot, 'drafts-old/page.yaml'))).toBe(false);
46
+ });
47
+
48
+ test('a path with forward slashes matches a pattern written with the platform separator', () => {
49
+ const isIgnored = createGlobIgnore([path.join(appRoot, 'drafts', '**')]);
50
+ expect(isIgnored(`${appRoot.split(path.sep).join('/')}/drafts/page.yaml`)).toBe(true);
51
+ });
52
+
53
+ test('any of several patterns ignores a path', () => {
54
+ const isIgnored = createGlobIgnore(['**/node_modules/**', path.join(appRoot, 'drafts/**')]);
55
+ expect(isIgnored(path.join(appRoot, 'node_modules/a.js'))).toBe(true);
56
+ expect(isIgnored(path.join(appRoot, 'drafts/a.yaml'))).toBe(true);
57
+ expect(isIgnored(path.join(appRoot, 'pages/a.yaml'))).toBe(false);
58
+ });
@@ -0,0 +1,75 @@
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
+
20
+ import picomatch from 'picomatch';
21
+
22
+ function toUnixPath(filePath) {
23
+ const normalized = path.normalize(filePath);
24
+ return path.sep === '\\' ? normalized.replace(/\\/g, '/') : normalized;
25
+ }
26
+
27
+ function isUnder({ filePath, root }) {
28
+ return filePath === root || filePath.startsWith(`${root}${path.sep}`);
29
+ }
30
+
31
+ function isDirectory({ filePath, stats }) {
32
+ if (stats) {
33
+ return stats.isDirectory();
34
+ }
35
+ try {
36
+ return fs.statSync(filePath).isDirectory();
37
+ } catch {
38
+ return false;
39
+ }
40
+ }
41
+
42
+ // chokidar 4 watches paths only, where chokidar 3 also took globs, which `lowdefy dev --watch`
43
+ // documents. A glob is watched from the directory it starts at (picomatch's scan base), and the
44
+ // returned ignore function drops the files under that directory the glob does not match.
45
+ // Directories are never dropped, so chokidar still walks into those that can hold a match.
46
+ // Paths are compared with forward slashes, as chokidar 3 compared them.
47
+ function createGlobWatchPaths(watchPaths) {
48
+ const roots = [];
49
+ const globs = [];
50
+ for (const watchPath of watchPaths) {
51
+ const scan = picomatch.scan(toUnixPath(watchPath));
52
+ if (!scan.isGlob) {
53
+ roots.push(watchPath);
54
+ continue;
55
+ }
56
+ const base = path.normalize(scan.base === '' ? '.' : scan.base);
57
+ globs.push({ base, isMatch: picomatch(toUnixPath(watchPath), { dot: true }) });
58
+ roots.push(base);
59
+ }
60
+ if (globs.length === 0) {
61
+ return { watchPaths: roots, ignore: null };
62
+ }
63
+ const plainRoots = roots.filter((root) => !globs.some(({ base }) => base === root));
64
+ function isOutsideGlobs(filePath, stats) {
65
+ if (plainRoots.some((root) => isUnder({ filePath, root }))) return false;
66
+ const underGlobs = globs.filter(({ base }) => isUnder({ filePath, root: base }));
67
+ if (underGlobs.length === 0) return false;
68
+ if (isDirectory({ filePath, stats })) return false;
69
+ const unixPath = toUnixPath(filePath);
70
+ return !underGlobs.some(({ isMatch }) => isMatch(unixPath));
71
+ }
72
+ return { watchPaths: [...new Set(roots)], ignore: isOutsideGlobs };
73
+ }
74
+
75
+ export default createGlobWatchPaths;
@@ -0,0 +1,67 @@
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
+
21
+ import { afterAll, expect, test } from 'vitest';
22
+
23
+ import createGlobWatchPaths from './createGlobWatchPaths.mjs';
24
+
25
+ const root = fs.mkdtempSync(path.join(fs.realpathSync(os.tmpdir()), 'lowdefy-glob-watch-'));
26
+ const shared = path.join(root, 'shared');
27
+ fs.mkdirSync(path.join(shared, 'nested'), { recursive: true });
28
+
29
+ afterAll(() => {
30
+ fs.rmSync(root, { recursive: true, force: true });
31
+ });
32
+
33
+ test('plain watch paths are watched as they are, with nothing ignored', () => {
34
+ const app = path.join(root, 'app');
35
+ expect(createGlobWatchPaths([app, path.join(root, 'lowdefy.yaml')])).toEqual({
36
+ watchPaths: [app, path.join(root, 'lowdefy.yaml')],
37
+ ignore: null,
38
+ });
39
+ });
40
+
41
+ test('a glob is watched from the directory it starts at', () => {
42
+ const { watchPaths } = createGlobWatchPaths([path.join(shared, '**', '*.yaml')]);
43
+ expect(watchPaths).toEqual([shared]);
44
+ });
45
+
46
+ test('files under a glob base that the glob does not match are ignored', () => {
47
+ const { ignore } = createGlobWatchPaths([path.join(shared, '**', '*.yaml')]);
48
+ expect(ignore(path.join(shared, 'page.yaml'))).toBe(false);
49
+ expect(ignore(path.join(shared, 'nested', 'page.yaml'))).toBe(false);
50
+ expect(ignore(path.join(shared, 'notes.md'))).toBe(true);
51
+ expect(ignore(path.join(shared, 'nested', 'notes.md'))).toBe(true);
52
+ });
53
+
54
+ test('directories under a glob base are never ignored, so they are walked', () => {
55
+ const { ignore } = createGlobWatchPaths([path.join(shared, '**', '*.yaml')]);
56
+ expect(ignore(path.join(shared, 'nested'))).toBe(false);
57
+ expect(ignore(path.join(shared, 'other'), { isDirectory: () => true })).toBe(false);
58
+ });
59
+
60
+ test('paths outside every glob base, or under a plain watch path, are not ignored', () => {
61
+ const app = path.join(root, 'app');
62
+ const { watchPaths, ignore } = createGlobWatchPaths([app, path.join(shared, '*.yaml')]);
63
+ expect(watchPaths).toEqual([app, shared]);
64
+ expect(ignore(path.join(app, 'notes.md'))).toBe(false);
65
+ expect(ignore(path.join(root, 'other', 'notes.md'))).toBe(false);
66
+ expect(ignore(path.join(shared, 'notes.md'))).toBe(true);
67
+ });