@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
@@ -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
+ });
@@ -14,63 +14,79 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import { jest } from '@jest/globals';
17
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
18
18
 
19
19
  import createIdleGc from './createIdleGc.mjs';
20
20
 
21
21
  beforeEach(() => {
22
22
  // performance is not redefinable on this Node, and nothing here reads it.
23
- jest.useFakeTimers({ doNotFake: ['performance'] });
23
+ vi.useFakeTimers({
24
+ toFake: [
25
+ 'Date',
26
+ 'hrtime',
27
+ 'queueMicrotask',
28
+ 'requestAnimationFrame',
29
+ 'cancelAnimationFrame',
30
+ 'requestIdleCallback',
31
+ 'cancelIdleCallback',
32
+ 'setImmediate',
33
+ 'clearImmediate',
34
+ 'setInterval',
35
+ 'clearInterval',
36
+ 'setTimeout',
37
+ 'clearTimeout',
38
+ ],
39
+ });
24
40
  });
25
41
 
26
42
  afterEach(() => {
27
- jest.useRealTimers();
43
+ vi.useRealTimers();
28
44
  });
29
45
 
30
46
  test('createIdleGc collects once 5 s after the last build ends', () => {
31
- const gc = jest.fn();
47
+ const gc = vi.fn();
32
48
  const idleGc = createIdleGc({ gc });
33
49
 
34
50
  idleGc.onBuildingChange(true);
35
51
  idleGc.onBuildingChange(false);
36
- jest.advanceTimersByTime(4999);
52
+ vi.advanceTimersByTime(4999);
37
53
  expect(gc).not.toHaveBeenCalled();
38
- jest.advanceTimersByTime(1);
54
+ vi.advanceTimersByTime(1);
39
55
 
40
56
  expect(gc).toHaveBeenCalledTimes(1);
41
- jest.advanceTimersByTime(60_000);
57
+ vi.advanceTimersByTime(60_000);
42
58
  expect(gc).toHaveBeenCalledTimes(1);
43
59
  });
44
60
 
45
61
  test('createIdleGc cancels the collection when a build starts within 5 s', () => {
46
- const gc = jest.fn();
62
+ const gc = vi.fn();
47
63
  const idleGc = createIdleGc({ gc });
48
64
 
49
65
  idleGc.onBuildingChange(false);
50
- jest.advanceTimersByTime(3000);
66
+ vi.advanceTimersByTime(3000);
51
67
  idleGc.onBuildingChange(true);
52
- jest.advanceTimersByTime(60_000);
68
+ vi.advanceTimersByTime(60_000);
53
69
 
54
70
  expect(gc).not.toHaveBeenCalled();
55
71
  });
56
72
 
57
73
  test('createIdleGc collects once after several back-to-back builds', () => {
58
- const gc = jest.fn();
74
+ const gc = vi.fn();
59
75
  const idleGc = createIdleGc({ gc });
60
76
 
61
77
  for (let i = 0; i < 4; i += 1) {
62
78
  idleGc.onBuildingChange(true);
63
- jest.advanceTimersByTime(1000);
79
+ vi.advanceTimersByTime(1000);
64
80
  idleGc.onBuildingChange(false);
65
- jest.advanceTimersByTime(1000);
81
+ vi.advanceTimersByTime(1000);
66
82
  }
67
- jest.advanceTimersByTime(5000);
83
+ vi.advanceTimersByTime(5000);
68
84
 
69
85
  expect(gc).toHaveBeenCalledTimes(1);
70
86
  });
71
87
 
72
88
  test('createIdleGc exposes a working gc in a process started without --expose-gc', () => {
73
- jest.useRealTimers();
89
+ vi.useRealTimers();
74
90
  const idleGc = createIdleGc({ delayMs: 0 });
75
91
 
76
92
  expect(() => idleGc.onBuildingChange(true)).not.toThrow();
@@ -14,20 +14,21 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import getDoc from '../../../lib/docs/getDoc.js';
17
+ import crypto from 'node:crypto';
18
18
 
19
- function docsContentHandler(c) {
20
- const slug = c.req.param('slug');
21
- const doc = getDoc({ slug });
22
- if (doc === null) {
23
- return c.json(
24
- {
25
- error: `No doc found for slug "${slug}". Use GET /lowdefy-docs/search?q=... to find the right slug.`,
26
- },
27
- 404
28
- );
19
+ import getLanAddress from './getLanAddress.mjs';
20
+
21
+ // `lowdefy dev --lan [interface]` sets LOWDEFY_SERVER_DEV_LAN to "true" or to
22
+ // the interface name. The token lasts as long as this dev server.
23
+ function createLanPairing({ lan, interfaces }) {
24
+ if (lan === undefined) {
25
+ return null;
29
26
  }
30
- return c.text(doc.markdown, 200, { 'Content-Type': 'text/markdown; charset=utf-8' });
27
+ const { name, address } = getLanAddress({
28
+ interfaceName: lan === 'true' ? undefined : lan,
29
+ interfaces,
30
+ });
31
+ return { name, address, token: crypto.randomBytes(32).toString('base64url') };
31
32
  }
32
33
 
33
- export default docsContentHandler;
34
+ export default createLanPairing;