@lowdefy/server-dev 7.1.0 → 7.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (439) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +101 -143
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.js +6 -5
  106. package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
  107. package/lib/docs/isPageReady.test.mjs +1 -0
  108. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  109. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  110. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  111. package/lib/docs/launchBrowser.test.mjs +8 -8
  112. package/lib/docs/listTypes.js +58 -8
  113. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  114. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  115. package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
  116. package/lib/docs/observe/evaluateInvariants.js +23 -0
  117. package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
  118. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  119. package/lib/docs/observe/toAppErrorFailure.js +7 -4
  120. package/lib/docs/observe/watchJourneyContext.js +1 -0
  121. package/lib/docs/observe/withAppErrors.test.mjs +22 -0
  122. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  123. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  124. package/lib/docs/pollTab.js +100 -0
  125. package/lib/docs/pollTab.test.mjs +64 -0
  126. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  127. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  128. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  129. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  130. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  131. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  132. package/lib/docs/readJourneySession.js +1 -1
  133. package/lib/docs/reportDevToolFault.js +29 -0
  134. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  135. package/lib/docs/requestRestart.test.mjs +1 -0
  136. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  137. package/lib/docs/resolveSource.js +2 -2
  138. package/lib/docs/resolveSource.test.mjs +6 -6
  139. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  140. package/lib/docs/runCheck.test.mjs +3 -3
  141. package/lib/docs/runCheckChild.js +2 -1
  142. package/lib/docs/runEndpoint.js +23 -10
  143. package/lib/docs/runEndpoint.test.mjs +42 -37
  144. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  145. package/lib/docs/runJourney.js +21 -1
  146. package/lib/docs/runJourney.test.mjs +119 -99
  147. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  148. package/lib/docs/runJourneySteps.js +8 -29
  149. package/lib/docs/runRequest.js +6 -6
  150. package/lib/docs/runRequest.test.mjs +22 -22
  151. package/lib/docs/screenshotPage.js +6 -7
  152. package/lib/docs/screenshotPage.test.mjs +46 -46
  153. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  154. package/lib/docs/searchDocs.test.mjs +1 -0
  155. package/lib/docs/searchIcons.test.mjs +5 -5
  156. package/lib/docs/selectFinalState.test.mjs +1 -0
  157. package/lib/docs/serverErrorStore.test.mjs +4 -4
  158. package/lib/docs/setupTestFixtures.mjs +25 -0
  159. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  160. package/lib/docs/tabAvailable.js +1 -1
  161. package/lib/docs/tabChannel.js +90 -14
  162. package/lib/docs/tabChannel.test.mjs +40 -15
  163. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  164. package/lib/docs/validateStateSelection.test.mjs +1 -0
  165. package/lib/docs/validateViewport.test.mjs +1 -0
  166. package/lib/docs/waitForBuild.test.mjs +1 -0
  167. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  168. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  169. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  170. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  171. package/lib/server/auth/getHeadlessUser.js +6 -0
  172. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  173. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  174. package/lib/server/contextMapBudget.test.mjs +3 -3
  175. package/lib/server/continueJitKeys.test.mjs +1 -0
  176. package/lib/server/createLowdefyContext.js +5 -1
  177. package/lib/server/createLowdefyContext.test.mjs +32 -32
  178. package/lib/server/getClientAddress.test.mjs +2 -2
  179. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  180. package/lib/server/importAppCode.test.mjs +2 -2
  181. package/lib/server/jitPageBuilder.js +27 -3
  182. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  183. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  184. package/lib/server/jitPageBuilder.test.mjs +4 -4
  185. package/lib/server/journeyCookies.test.mjs +1 -0
  186. package/lib/server/loadDynamicJsMap.js +10 -1
  187. package/lib/server/log/createHandleError.js +10 -5
  188. package/lib/server/log/createHandleError.test.mjs +19 -8
  189. package/lib/server/log/createLogger.test.mjs +2 -2
  190. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  191. package/lib/server/mutants/listMutants.test.mjs +1 -0
  192. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  193. package/lib/server/mutants/operators.test.mjs +1 -0
  194. package/lib/server/pageBuildRecords.test.mjs +1 -0
  195. package/lib/server/pageCache.test.mjs +1 -0
  196. package/lib/server/pageRebuilds.test.mjs +3 -3
  197. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  198. package/lib/server/pruneJitMaps.test.mjs +1 -0
  199. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  200. package/lib/server/readInstanceRecord.test.mjs +24 -8
  201. package/lib/server/readMergedMaps.test.mjs +1 -0
  202. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  203. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  204. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  205. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  206. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  207. package/lib/server/startIdleGc.test.mjs +25 -9
  208. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  209. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  210. package/lib/vite/keepIdleConnectionsOpen.js +36 -0
  211. package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
  212. package/manager/getContext.mjs +9 -0
  213. package/manager/processes/checkPendingPlugins.mjs +49 -0
  214. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  215. package/manager/processes/createIdleChild.mjs +141 -0
  216. package/manager/processes/createIdleChild.test.mjs +209 -0
  217. package/manager/processes/initialBuild.mjs +2 -15
  218. package/manager/processes/initialBuild.test.mjs +8 -40
  219. package/manager/processes/lowdefyBuild.mjs +7 -4
  220. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  221. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  222. package/manager/processes/restartServer.test.mjs +63 -15
  223. package/manager/processes/shutdownServer.test.mjs +3 -3
  224. package/manager/processes/startFirstServer.test.mjs +23 -22
  225. package/manager/processes/startMailSink.mjs +11 -3
  226. package/manager/processes/startMailSink.test.mjs +28 -2
  227. package/manager/processes/startProxy.mjs +167 -29
  228. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  229. package/manager/processes/startProxy.test.mjs +130 -5
  230. package/manager/processes/startServer.mjs +5 -7
  231. package/manager/processes/startServer.test.mjs +10 -9
  232. package/manager/processes/syncServer.mjs +31 -4
  233. package/manager/processes/syncServer.test.mjs +71 -6
  234. package/manager/processes/waitForDevServer.test.mjs +21 -6
  235. package/manager/run.mjs +32 -8
  236. package/manager/utils/BatchChanges.mjs +1 -1
  237. package/manager/utils/BatchChanges.test.mjs +4 -4
  238. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  239. package/manager/utils/checkPairing.mjs +45 -0
  240. package/manager/utils/checkPairing.test.mjs +53 -0
  241. package/manager/utils/createBuildActivity.mjs +5 -1
  242. package/manager/utils/createBuildActivity.test.mjs +2 -2
  243. package/manager/utils/createChangeSignal.test.mjs +5 -5
  244. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  245. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  246. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  247. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  248. package/manager/utils/createGlobIgnore.mjs +45 -0
  249. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  250. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  251. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  252. package/manager/utils/createIdleGc.test.mjs +31 -15
  253. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  254. package/manager/utils/createLanPairing.test.mjs +46 -0
  255. package/manager/utils/createRequestActivity.mjs +30 -3
  256. package/manager/utils/createRequestActivity.test.mjs +76 -22
  257. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  258. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  259. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  260. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  261. package/manager/utils/findSignInCode.test.mjs +33 -0
  262. package/manager/utils/formatLanPairing.mjs +32 -0
  263. package/manager/utils/formatLanPairing.test.mjs +40 -0
  264. package/manager/utils/getLanAddress.mjs +83 -0
  265. package/manager/utils/getLanAddress.test.mjs +70 -0
  266. package/manager/utils/importFresh.test.mjs +1 -0
  267. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  268. package/manager/utils/pluginTypeCache.mjs +100 -0
  269. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  270. package/manager/utils/pruneRecordings.test.mjs +1 -0
  271. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  272. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  273. package/manager/utils/readBasePath.test.mjs +1 -0
  274. package/manager/utils/readManagerVersion.test.mjs +1 -0
  275. package/manager/utils/readPluginDefinitions.mjs +6 -6
  276. package/manager/utils/renderTerminalQr.mjs +54 -0
  277. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  278. package/manager/utils/setupWatcher.mjs +19 -4
  279. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  280. package/manager/utils/waitForChildExit.test.mjs +2 -2
  281. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  282. package/manager/watchers/envWatcher.mjs +3 -0
  283. package/manager/watchers/envWatcher.test.mjs +19 -7
  284. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  285. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  286. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  287. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  288. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  289. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  290. package/manager/watchers/resolveFile.mjs +46 -0
  291. package/manager/watchers/resolveFile.test.mjs +67 -0
  292. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  293. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  294. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  295. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  296. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  297. package/package.json +54 -53
  298. package/package.original.json +54 -53
  299. package/src/app.js +83 -85
  300. package/src/html/renderDevPage.test.mjs +1 -0
  301. package/src/lib/getPathSegments.js +16 -1
  302. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  303. package/src/lib/isTabAnswer.js +32 -0
  304. package/src/lib/isTabChannelCaller.js +35 -0
  305. package/src/middleware/apiContext.js +4 -2
  306. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  307. package/src/middleware/errorHandler.js +33 -45
  308. package/src/middleware/errorHandler.test.mjs +10 -10
  309. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  310. package/src/middleware/localDevToolsOnly.js +13 -1
  311. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  312. package/src/middleware/noStore.test.mjs +1 -0
  313. package/src/middleware/requestTimeout.js +7 -1
  314. package/src/middleware/staleFlag.test.mjs +1 -0
  315. package/src/middleware/stampCaller.test.mjs +1 -0
  316. package/src/routes/agentBearer.test.mjs +183 -0
  317. package/src/routes/auth.test.mjs +10 -10
  318. package/src/routes/clientError.js +21 -4
  319. package/src/routes/clientError.test.mjs +127 -0
  320. package/src/routes/devInspect.js +6 -51
  321. package/src/routes/devInspect.test.mjs +128 -3
  322. package/src/routes/devRecording.js +6 -17
  323. package/src/routes/devRecording.test.mjs +54 -3
  324. package/src/routes/docs/buildStatus.test.mjs +6 -6
  325. package/src/routes/docs/events.test.mjs +4 -4
  326. package/src/routes/docs/find.js +3 -3
  327. package/src/routes/docs/journey.test.mjs +8 -8
  328. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  329. package/src/routes/docs/loadDocsRoutes.js +70 -0
  330. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  331. package/src/routes/docs/mcp.test.mjs +5 -5
  332. package/src/routes/docs/mutants.js +7 -0
  333. package/src/routes/docs/mutants.test.mjs +20 -6
  334. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  335. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  336. package/src/routes/docs/restart.test.mjs +1 -0
  337. package/src/routes/endpoints.js +24 -0
  338. package/src/routes/endpointsLink.test.mjs +111 -0
  339. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  340. package/src/routes/jitPage.js +13 -1
  341. package/src/routes/jitPage.test.mjs +36 -11
  342. package/src/routes/mcp.js +6 -0
  343. package/src/routes/mcp.test.mjs +23 -8
  344. package/src/routes/mcpMemberToken.test.mjs +8 -8
  345. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  346. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  347. package/src/routes/mobileRoutes.test.mjs +223 -0
  348. package/src/routes/mobileSignIn.js +58 -0
  349. package/src/routes/mobileSignIn.test.mjs +59 -0
  350. package/src/routes/mobileSignInCallback.js +34 -0
  351. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  352. package/src/routes/mountDevPageRoutes.js +10 -2
  353. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  354. package/src/routes/mountMobileWellKnown.js +35 -0
  355. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  356. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  357. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  358. package/src/routes/reload.js +101 -20
  359. package/src/routes/reload.test.mjs +153 -0
  360. package/src/routes/request.js +1 -22
  361. package/src/routes/request.test.mjs +7 -24
  362. package/src/routes/requestBody.test.mjs +14 -27
  363. package/src/routes/websocket.test.mjs +2 -2
  364. package/src/routes/wellKnownFallback.test.mjs +2 -2
  365. package/src/websocket/devWebSocket.test.mjs +12 -12
  366. package/vite.config.js +15 -1
  367. package/client/feedback/FeedbackMount.jsx +0 -83
  368. package/client/feedback/FeedbackOverlay.jsx +0 -904
  369. package/client/feedback/captureTabScreenshot.js +0 -84
  370. package/client/feedback/copyToClipboard.js +0 -45
  371. package/client/feedback/drawAnnotationsSvg.js +0 -119
  372. package/client/feedback/feedbackStyles.js +0 -304
  373. package/client/feedback/pinResponsiveImages.js +0 -59
  374. package/client/feedback/sendFeedback.js +0 -39
  375. package/client/feedback/useFeedbackToggle.js +0 -70
  376. package/client/recorder/buildEngineRecord.js +0 -37
  377. package/client/recorder/buildInteractionRecord.js +0 -64
  378. package/client/recorder/buildTraceEvent.js +0 -57
  379. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  380. package/client/recorder/chunkRecords.js +0 -69
  381. package/client/recorder/chunkRecords.test.mjs +0 -59
  382. package/client/recorder/collectEventEndpoints.js +0 -40
  383. package/client/recorder/collectEventRequests.js +0 -39
  384. package/client/recorder/createPairingBuffer.js +0 -187
  385. package/client/recorder/createPasswordRedactor.js +0 -84
  386. package/client/recorder/createRecordBatcher.js +0 -54
  387. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  388. package/client/recorder/createRecordingSession.js +0 -61
  389. package/client/recorder/createRecordingSession.test.mjs +0 -72
  390. package/client/recorder/diffStateWrites.js +0 -77
  391. package/client/recorder/diffStateWrites.test.mjs +0 -66
  392. package/client/recorder/isEventCall.js +0 -30
  393. package/client/recorder/jsonType.js +0 -39
  394. package/client/recorder/sendRecords.js +0 -40
  395. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  396. package/lib/docs/checkpointPaths.js +0 -91
  397. package/lib/docs/checkpointStore.js +0 -243
  398. package/lib/docs/checkpointToMocks.js +0 -65
  399. package/lib/docs/configCheckpoints.test.mjs +0 -156
  400. package/lib/docs/createConfigCheckpoint.js +0 -92
  401. package/lib/docs/devMockRegistry.js +0 -68
  402. package/lib/docs/enrichFeedback.js +0 -71
  403. package/lib/docs/evalOperator.js +0 -49
  404. package/lib/docs/evalOperator.test.mjs +0 -157
  405. package/lib/docs/evalOperatorHeadless.js +0 -159
  406. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  407. package/lib/docs/evalOperatorInTab.js +0 -49
  408. package/lib/docs/formatFeedback.js +0 -142
  409. package/lib/docs/formatFeedback.test.mjs +0 -252
  410. package/lib/docs/getPluginDoc.js +0 -53
  411. package/lib/docs/listConfigCheckpoints.js +0 -55
  412. package/lib/docs/loadState.js +0 -220
  413. package/lib/docs/revertConfigCheckpoint.js +0 -73
  414. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  415. package/lib/docs/scaffoldPage.js +0 -77
  416. package/lib/docs/scaffoldPage.test.mjs +0 -97
  417. package/lib/docs/snapshotState.js +0 -67
  418. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  419. package/manager/watchers/listServerSidePackages.mjs +0 -47
  420. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  421. package/src/routes/docs/checkpointsCreate.js +0 -28
  422. package/src/routes/docs/evalOperator.js +0 -70
  423. package/src/routes/docs/inspectState.js +0 -59
  424. package/src/routes/docs/loadState.js +0 -51
  425. package/src/routes/docs/pluginDoc.js +0 -33
  426. package/src/routes/docs/plugins.js +0 -23
  427. package/src/routes/docs/runEndpoint.js +0 -54
  428. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  429. package/src/routes/docs/runRequest.js +0 -53
  430. package/src/routes/docs/runRequest.test.mjs +0 -92
  431. package/src/routes/docs/schema.js +0 -37
  432. package/src/routes/docs/screenshot.js +0 -120
  433. package/src/routes/docs/screenshot.test.mjs +0 -117
  434. package/src/routes/docs/search.js +0 -40
  435. package/src/routes/docs/snapshotState.js +0 -50
  436. package/src/routes/docs/stateCheckpointsList.js +0 -26
  437. package/src/routes/docs/types.js +0 -33
  438. package/src/routes/feedback.js +0 -107
  439. package/src/routes/feedback.test.mjs +0 -204
@@ -0,0 +1,70 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import { expect, test } from 'vitest';
18
+ import getLanAddress from './getLanAddress.mjs';
19
+
20
+ const interfaces = {
21
+ lo0: [{ address: '127.0.0.1', family: 'IPv4', internal: true }],
22
+ utun4: [{ address: '100.92.10.3', family: 'IPv4', internal: false }],
23
+ bridge100: [
24
+ { address: 'fe80::1', family: 'IPv6', internal: false },
25
+ { address: '192.168.64.1', family: 4, internal: false },
26
+ ],
27
+ en0: [{ address: '10.0.0.12', family: 'IPv4', internal: false }],
28
+ };
29
+
30
+ test('getLanAddress takes the first private IPv4 address and names its interface', () => {
31
+ expect(getLanAddress({ interfaces })).toEqual({ name: 'bridge100', address: '192.168.64.1' });
32
+ });
33
+
34
+ test('getLanAddress skips addresses outside the private ranges, such as a VPN address', () => {
35
+ const vpnFirst = {
36
+ utun4: [{ address: '100.92.10.3', family: 'IPv4', internal: false }],
37
+ en0: [{ address: '172.20.1.9', family: 'IPv4', internal: false }],
38
+ };
39
+ expect(getLanAddress({ interfaces: vpnFirst })).toEqual({ name: 'en0', address: '172.20.1.9' });
40
+ });
41
+
42
+ test('getLanAddress takes a named interface', () => {
43
+ expect(getLanAddress({ interfaceName: 'en0', interfaces })).toEqual({
44
+ name: 'en0',
45
+ address: '10.0.0.12',
46
+ });
47
+ expect(getLanAddress({ interfaceName: 'utun4', interfaces })).toEqual({
48
+ name: 'utun4',
49
+ address: '100.92.10.3',
50
+ });
51
+ });
52
+
53
+ test('getLanAddress lists the interfaces when the named one has no IPv4 address', () => {
54
+ expect(() => getLanAddress({ interfaceName: 'en7', interfaces })).toThrow(
55
+ 'Network interface "en7" has no IPv4 address. Interfaces with an IPv4 address: utun4 (100.92.10.3), bridge100 (192.168.64.1), en0 (10.0.0.12).'
56
+ );
57
+ });
58
+
59
+ test('getLanAddress says how to choose when no address is private', () => {
60
+ expect(() =>
61
+ getLanAddress({
62
+ interfaces: { utun4: [{ address: '100.92.10.3', family: 'IPv4', internal: false }] },
63
+ })
64
+ ).toThrow(
65
+ 'No private network address found for --lan. Interfaces with an IPv4 address: utun4 (100.92.10.3). Pass one with --lan <interface>.'
66
+ );
67
+ expect(() => getLanAddress({ interfaces: {} })).toThrow(
68
+ 'This computer has no network interface with an IPv4 address.'
69
+ );
70
+ });
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import importFresh from './importFresh.mjs';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let pluginDir;
24
25
 
@@ -14,17 +14,18 @@
14
14
  limitations under the License.
15
15
  */
16
16
 
17
- import searchIcons from '../../../lib/docs/searchIcons.js';
17
+ import net from 'node:net';
18
18
 
19
- async function docsIconsHandler(c) {
20
- const query = c.req.query('q');
21
- if (!query || query.trim() === '') {
22
- return c.json(
23
- { error: 'Missing search query. Use GET /lowdefy-docs/icons?q=your+keywords.' },
24
- 400
25
- );
19
+ // A dual-stack listener reports an IPv4 peer as ::ffff:<address>.
20
+ function isLoopbackAddress(address) {
21
+ if (typeof address !== 'string') {
22
+ return false;
26
23
  }
27
- return c.json(await searchIcons({ query }));
24
+ const plain = address.startsWith('::ffff:') ? address.slice('::ffff:'.length) : address;
25
+ if (net.isIPv4(plain)) {
26
+ return plain.startsWith('127.');
27
+ }
28
+ return plain === '::1';
28
29
  }
29
30
 
30
- export default docsIconsHandler;
31
+ export default isLoopbackAddress;
@@ -0,0 +1,100 @@
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 'node:fs';
18
+ import path from 'node:path';
19
+ import importFresh from './importFresh.mjs';
20
+
21
+ // Each importFresh starts a worker thread (about 50 ms a plugin), and every
22
+ // skeleton rebuild reads every plugin's /types and /messages. The manager
23
+ // keeps each import here, keyed by the plugin package directory's realpath
24
+ // (pnpm gives changed contents a new store path), the entry file's mtimeNs and
25
+ // size, and the package.json version. The key can not see the files an entry
26
+ // re-exports, such as a local plugin's block list, so the watchers that can
27
+ // change a plugin's types (plugin source, restart request, .env, root
28
+ // lowdefy.yaml) clear the cache before they build. A failed import is never
29
+ // kept.
30
+ const cache = new Map();
31
+
32
+ function readPackage(directory) {
33
+ try {
34
+ return JSON.parse(fs.readFileSync(path.join(directory, 'package.json'), 'utf8'));
35
+ } catch {
36
+ return null;
37
+ }
38
+ }
39
+
40
+ // The package directory is the nearest one up from the entry file whose
41
+ // package.json has the plugin's name: a build output folder may have its own
42
+ // package.json, such as { "type": "module" }.
43
+ function findPackage({ entryPath, packageName }) {
44
+ let nearest = null;
45
+ let directory = path.dirname(entryPath);
46
+ let parent = path.dirname(directory);
47
+ while (directory !== parent) {
48
+ const packageJson = readPackage(directory);
49
+ if (packageJson) {
50
+ nearest = nearest ?? { directory, packageJson };
51
+ if (packageJson.name === packageName) {
52
+ return { directory, packageJson };
53
+ }
54
+ }
55
+ directory = parent;
56
+ parent = path.dirname(directory);
57
+ }
58
+ return nearest;
59
+ }
60
+
61
+ function readCacheKey({ entryPath, packageName }) {
62
+ const stat = fs.statSync(entryPath, { bigint: true });
63
+ const found = findPackage({ entryPath, packageName });
64
+ return JSON.stringify([
65
+ found ? fs.realpathSync(found.directory) : null,
66
+ stat.mtimeNs.toString(),
67
+ stat.size.toString(),
68
+ found?.packageJson.version ?? null,
69
+ ]);
70
+ }
71
+
72
+ // Resolves to what importFresh(entryPath) resolves to. Each caller gets its own
73
+ // copy, so a caller that changes the value can not change the cached one.
74
+ async function importPluginModule({ entryPath, packageName }) {
75
+ let key;
76
+ try {
77
+ key = readCacheKey({ entryPath, packageName });
78
+ } catch {
79
+ // The entry can not be read, so the import reports why.
80
+ cache.delete(entryPath);
81
+ return importFresh(entryPath);
82
+ }
83
+ let entry = cache.get(entryPath);
84
+ if (!entry || entry.key !== key) {
85
+ entry = { key, value: importFresh(entryPath) };
86
+ cache.set(entryPath, entry);
87
+ entry.value.catch(() => {
88
+ if (cache.get(entryPath) === entry) {
89
+ cache.delete(entryPath);
90
+ }
91
+ });
92
+ }
93
+ return structuredClone(await entry.value);
94
+ }
95
+
96
+ function clearPluginTypeCache() {
97
+ cache.clear();
98
+ }
99
+
100
+ export { clearPluginTypeCache, importPluginModule };
@@ -0,0 +1,141 @@
1
+ /*
2
+ Copyright 2020-2026 Lowdefy, Inc
3
+
4
+ Licensed under the Apache License, Version 2.0 (the "License");
5
+ you may not use this file except in compliance with the License.
6
+ You may obtain a copy of the License at
7
+
8
+ http://www.apache.org/licenses/LICENSE-2.0
9
+
10
+ Unless required by applicable law or agreed to in writing, software
11
+ distributed under the License is distributed on an "AS IS" BASIS,
12
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
+ See the License for the specific language governing permissions and
14
+ limitations under the License.
15
+ */
16
+
17
+ import fs from 'fs';
18
+ import os from 'os';
19
+ import path from 'path';
20
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
21
+
22
+ // The real import runs, in a worker, and the spy counts the workers started.
23
+ const { default: realImportFresh } = await vi.importActual('./importFresh.mjs');
24
+ const mockImportFresh = vi.fn(realImportFresh);
25
+ vi.doMock('./importFresh.mjs', () => ({ default: mockImportFresh }));
26
+
27
+ const { clearPluginTypeCache, importPluginModule } = await import('./pluginTypeCache.mjs');
28
+
29
+ const packageName = '@app/plugin';
30
+ let pluginDir;
31
+ let entryPath;
32
+
33
+ function writePackage({ version }) {
34
+ fs.writeFileSync(
35
+ path.join(pluginDir, 'package.json'),
36
+ JSON.stringify({ name: packageName, version, type: 'module' })
37
+ );
38
+ }
39
+
40
+ function writeBlocks(names) {
41
+ fs.writeFileSync(
42
+ path.join(pluginDir, 'blocks.js'),
43
+ names.map((name) => `export const ${name} = {};\n`).join('')
44
+ );
45
+ }
46
+
47
+ function importTypes() {
48
+ return importPluginModule({ entryPath, packageName });
49
+ }
50
+
51
+ beforeEach(() => {
52
+ clearPluginTypeCache();
53
+ mockImportFresh.mockClear();
54
+ pluginDir = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-plugin-type-cache-'));
55
+ writePackage({ version: '1.0.0' });
56
+ writeBlocks(['Card']);
57
+ // The entry re-exports its block list, as a local plugin's types.js often
58
+ // does, so adding a block does not change the entry file.
59
+ entryPath = path.join(pluginDir, 'types.js');
60
+ fs.writeFileSync(
61
+ entryPath,
62
+ "import * as blocks from './blocks.js';\nexport default { blocks: Object.keys(blocks) };\n"
63
+ );
64
+ });
65
+
66
+ afterEach(() => {
67
+ fs.rmSync(pluginDir, { recursive: true, force: true });
68
+ });
69
+
70
+ test('a second import of an unchanged plugin starts no worker', async () => {
71
+ expect(await importTypes()).toEqual({ blocks: ['Card'] });
72
+ expect(await importTypes()).toEqual({ blocks: ['Card'] });
73
+
74
+ expect(mockImportFresh).toHaveBeenCalledTimes(1);
75
+ });
76
+
77
+ test('a block added to a file the entry re-exports is read once the cache is cleared', async () => {
78
+ await importTypes();
79
+ writeBlocks(['Card', 'Fancy']);
80
+
81
+ expect(await importTypes()).toEqual({ blocks: ['Card'] });
82
+ clearPluginTypeCache();
83
+ expect(await importTypes()).toEqual({ blocks: ['Card', 'Fancy'] });
84
+ expect(mockImportFresh).toHaveBeenCalledTimes(2);
85
+ });
86
+
87
+ test('a changed entry file size misses the cache', async () => {
88
+ await importTypes();
89
+ writeBlocks(['Card', 'Fancy']);
90
+ fs.appendFileSync(entryPath, '// changed\n');
91
+
92
+ expect(await importTypes()).toEqual({ blocks: ['Card', 'Fancy'] });
93
+ expect(mockImportFresh).toHaveBeenCalledTimes(2);
94
+ });
95
+
96
+ test('a changed entry file mtime misses the cache', async () => {
97
+ await importTypes();
98
+ const { mtime } = fs.statSync(entryPath);
99
+ fs.utimesSync(entryPath, mtime, new Date(mtime.getTime() + 5000));
100
+
101
+ await importTypes();
102
+ expect(mockImportFresh).toHaveBeenCalledTimes(2);
103
+ });
104
+
105
+ test('a changed package.json version misses the cache', async () => {
106
+ await importTypes();
107
+ writePackage({ version: '1.0.1' });
108
+
109
+ await importTypes();
110
+ expect(mockImportFresh).toHaveBeenCalledTimes(2);
111
+ });
112
+
113
+ test('a failed import is not cached', async () => {
114
+ fs.writeFileSync(path.join(pluginDir, 'blocks.js'), 'export const = {;\n');
115
+ await expect(importTypes()).rejects.toThrow();
116
+
117
+ writeBlocks(['Card']);
118
+ expect(await importTypes()).toEqual({ blocks: ['Card'] });
119
+ expect(mockImportFresh).toHaveBeenCalledTimes(2);
120
+ });
121
+
122
+ test('each caller gets its own copy of the cached value', async () => {
123
+ const first = await importTypes();
124
+ first.blocks.push('Changed');
125
+
126
+ expect(await importTypes()).toEqual({ blocks: ['Card'] });
127
+ });
128
+
129
+ test('the key uses the package.json with the plugin name, not a nearer one', async () => {
130
+ // A build output folder can carry its own package.json with no version.
131
+ fs.mkdirSync(path.join(pluginDir, 'dist'));
132
+ fs.writeFileSync(path.join(pluginDir, 'dist', 'package.json'), '{"type":"module"}');
133
+ fs.renameSync(entryPath, path.join(pluginDir, 'dist', 'types.js'));
134
+ fs.renameSync(path.join(pluginDir, 'blocks.js'), path.join(pluginDir, 'dist', 'blocks.js'));
135
+ entryPath = path.join(pluginDir, 'dist', 'types.js');
136
+ await importTypes();
137
+ writePackage({ version: '2.0.0' });
138
+
139
+ await importTypes();
140
+ expect(mockImportFresh).toHaveBeenCalledTimes(2);
141
+ });
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import pruneRecordings from './pruneRecordings.mjs';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  const NOW = Date.parse('2026-10-03T12:00:00Z');
24
25
  let configDirectory;
@@ -18,14 +18,14 @@ import fs from 'fs';
18
18
  import os from 'os';
19
19
  import path from 'path';
20
20
 
21
- import { jest } from '@jest/globals';
21
+ import { vi, expect, test } from 'vitest';
22
22
 
23
23
  const realFs = await import('fs/promises');
24
24
  const moved = [];
25
25
 
26
26
  // readdir order is up to the file system. Listing in reverse alphabetical order puts the
27
27
  // maps ahead of idCounter.json, so only an explicit order passes.
28
- jest.unstable_mockModule('fs/promises', () => ({
28
+ vi.doMock('fs/promises', () => ({
29
29
  default: {
30
30
  ...realFs.default,
31
31
  readdir: async (...args) => (await realFs.default.readdir(...args)).reverse(),
@@ -18,15 +18,15 @@ import fs from 'fs';
18
18
  import fsPromises from 'fs/promises';
19
19
  import os from 'os';
20
20
  import path from 'path';
21
- import { jest } from '@jest/globals';
21
+ import { vi, afterEach, beforeEach, expect, test } from 'vitest';
22
22
 
23
23
  import publishBuildDirectory from './publishBuildDirectory.mjs';
24
24
 
25
25
  // The publish-window tests move 200 files through several thread pool fs calls
26
26
  // each while a poller runs on every loop turn, and the locked-rename test waits
27
- // out the full 3.3 s retry schedule. On a loaded machine they pass jest's 5 s
27
+ // out the full 3.3 s retry schedule. On a loaded machine they pass the 5 s
28
28
  // default, and a timed-out poller then fails the next test.
29
- jest.setTimeout(30000);
29
+ vi.setConfig({ testTimeout: 30000, hookTimeout: 30000 });
30
30
 
31
31
  let root;
32
32
  let buildDirectory;
@@ -50,7 +50,7 @@ beforeEach(() => {
50
50
  });
51
51
 
52
52
  afterEach(() => {
53
- jest.restoreAllMocks();
53
+ vi.restoreAllMocks();
54
54
  fs.rmSync(root, { recursive: true, force: true });
55
55
  });
56
56
 
@@ -185,8 +185,7 @@ test('publishBuildDirectory keeps the control files the manager and dev tools wr
185
185
  test('publishBuildDirectory retries a rename while another process holds the file', async () => {
186
186
  write(buildDirectory, 'app.json', 'old');
187
187
  write(stagingDirectory, 'app.json', 'new');
188
- jest
189
- .spyOn(fsPromises, 'rename')
188
+ vi.spyOn(fsPromises, 'rename')
190
189
  .mockRejectedValueOnce(lockedError('EPERM'))
191
190
  .mockRejectedValueOnce(lockedError('EBUSY'));
192
191
 
@@ -198,7 +197,7 @@ test('publishBuildDirectory retries a rename while another process holds the fil
198
197
 
199
198
  test('publishBuildDirectory fails with the rename error when a file stays locked', async () => {
200
199
  write(stagingDirectory, 'app.json', 'new');
201
- const rename = jest.spyOn(fsPromises, 'rename').mockRejectedValue(lockedError('EPERM'));
200
+ const rename = vi.spyOn(fsPromises, 'rename').mockRejectedValue(lockedError('EPERM'));
202
201
 
203
202
  await expect(publishBuildDirectory({ buildDirectory, stagingDirectory })).rejects.toThrow(
204
203
  'EPERM: resource busy or locked, rename'
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import readBasePath from './readBasePath.mjs';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let buildDirectory;
24
25
 
@@ -17,6 +17,7 @@
17
17
  import fs from 'fs';
18
18
 
19
19
  import readManagerVersion from './readManagerVersion.mjs';
20
+ import { expect, test } from 'vitest';
20
21
 
21
22
  test('readManagerVersion reads the version from the server package.json, without npm_package_version', () => {
22
23
  const saved = process.env.npm_package_version;
@@ -15,22 +15,22 @@
15
15
  */
16
16
 
17
17
  import path from 'path';
18
- import { get } from '@lowdefy/helpers';
19
- import { readFile } from '@lowdefy/node-utils';
18
+ import { collectPluginDefinitions, readFile } from '@lowdefy/node-utils';
20
19
  import YAML from 'yaml';
21
20
 
22
21
  // The plugins lowdefy.yaml lists, read straight from the file: the plugin
23
- // type maps are read before the config build, which needs them.
22
+ // type maps are read before the config build, which needs them. plugins is
23
+ // every package the server installs (root plugins, then shell-only plugins);
24
+ // shellPlugins the packages mobile.shells[].plugins lists, for native types.
24
25
  async function readPluginDefinitions({ directories }) {
25
26
  let lowdefyYaml = await readFile(path.join(directories.config, 'lowdefy.yaml'));
26
27
  if (!lowdefyYaml) {
27
28
  lowdefyYaml = await readFile(path.join(directories.config, 'lowdefy.yml'));
28
29
  }
29
30
  if (!lowdefyYaml) {
30
- return [];
31
+ return { plugins: [], shellPlugins: [] };
31
32
  }
32
- const lowdefy = YAML.parse(lowdefyYaml);
33
- return get(lowdefy, 'plugins', { default: [] });
33
+ return collectPluginDefinitions({ lowdefy: YAML.parse(lowdefyYaml) });
34
34
  }
35
35
 
36
36
  export default readPluginDefinitions;
@@ -0,0 +1,54 @@
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 qrcodegen from '@rc-component/qrcode/lib/libs/qrcodegen.js';
18
+
19
+ const { Ecc, QrCode } = qrcodegen;
20
+
21
+ const MARGIN = 2;
22
+ // Black on white whatever the terminal's own colours: a scanner needs dark
23
+ // modules on a light background.
24
+ const START = '\x1b[30;47m';
25
+ const RESET = '\x1b[0m';
26
+
27
+ // Two rows of modules per line of text, drawn with half blocks.
28
+ function renderTerminalQr(text) {
29
+ const qr = QrCode.encodeText(text, Ecc.LOW);
30
+ function isDark(x, y) {
31
+ return x >= 0 && y >= 0 && x < qr.size && y < qr.size && qr.getModule(x, y);
32
+ }
33
+ const lines = [];
34
+ for (let y = -MARGIN; y < qr.size + MARGIN; y += 2) {
35
+ let line = '';
36
+ for (let x = -MARGIN; x < qr.size + MARGIN; x += 1) {
37
+ const top = isDark(x, y);
38
+ const bottom = isDark(x, y + 1);
39
+ if (top && bottom) {
40
+ line += '█';
41
+ } else if (top) {
42
+ line += '▀';
43
+ } else if (bottom) {
44
+ line += '▄';
45
+ } else {
46
+ line += ' ';
47
+ }
48
+ }
49
+ lines.push(`${START}${line}${RESET}`);
50
+ }
51
+ return lines.join('\n');
52
+ }
53
+
54
+ export default renderTerminalQr;
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import resolveDevAuthUrl from './resolveDevAuthUrl.mjs';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('a localhost origin on another port follows the dev server port', () => {
20
21
  expect(resolveDevAuthUrl({ configured: 'http://localhost:3000', port: 4102 })).toEqual({
@@ -17,11 +17,15 @@
17
17
  import path from 'path';
18
18
 
19
19
  import chokidar from 'chokidar';
20
+ import { type } from '@lowdefy/helpers';
21
+
20
22
  import BatchChanges from './BatchChanges.mjs';
21
23
  import createDotPathIgnore from './createDotPathIgnore.mjs';
24
+ import createGlobIgnore from './createGlobIgnore.mjs';
25
+ import createGlobWatchPaths from './createGlobWatchPaths.mjs';
22
26
 
23
27
  // chokidar hands ignore functions a path with forward slashes on every platform
24
- // (anymatch normalizes it), while watch paths and the directories they are
28
+ // (its matcher normalizes it), while watch paths and the directories they are
25
29
  // compared with use the platform separator. Ignore functions get the platform
26
30
  // form, so a comparison with a watch path holds on Windows too.
27
31
  function withNativePath(ignore) {
@@ -42,9 +46,20 @@ function setupWatcher({
42
46
  }) {
43
47
  return new Promise((resolve) => {
44
48
  const batchChanges = new BatchChanges({ context, fn: callback, delay, onBusy });
45
- const defaultIgnorePaths = watchDotfiles ? [] : [createDotPathIgnore({ watchPaths })];
46
- const configWatcher = chokidar.watch(watchPaths, {
47
- ignored: [...defaultIgnorePaths, ...ignorePaths].map(withNativePath),
49
+ const globWatch = createGlobWatchPaths(watchPaths);
50
+ const ignored = watchDotfiles
51
+ ? []
52
+ : [createDotPathIgnore({ watchPaths: globWatch.watchPaths })];
53
+ if (globWatch.ignore !== null) {
54
+ ignored.push(globWatch.ignore);
55
+ }
56
+ ignored.push(...ignorePaths.filter((ignore) => !type.isString(ignore)));
57
+ const globIgnores = ignorePaths.filter((ignore) => type.isString(ignore));
58
+ if (globIgnores.length > 0) {
59
+ ignored.push(createGlobIgnore(globIgnores));
60
+ }
61
+ const configWatcher = chokidar.watch(globWatch.watchPaths, {
62
+ ignored: ignored.map(withNativePath),
48
63
  persistent: true,
49
64
  ignoreInitial: true,
50
65
  });
@@ -14,24 +14,40 @@
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
- const mockPruneRecordings = jest.fn();
20
- jest.unstable_mockModule('./pruneRecordings.mjs', () => ({ default: mockPruneRecordings }));
19
+ const mockPruneRecordings = vi.fn();
20
+ vi.doMock('./pruneRecordings.mjs', () => ({ default: mockPruneRecordings }));
21
21
 
22
22
  const { default: startRecordingPruner } = await import('./startRecordingPruner.mjs');
23
23
 
24
- const logger = { debug: jest.fn() };
24
+ const logger = { debug: vi.fn() };
25
25
 
26
26
  beforeEach(() => {
27
- jest.useFakeTimers({ doNotFake: ['performance'] });
27
+ vi.useFakeTimers({
28
+ toFake: [
29
+ 'Date',
30
+ 'hrtime',
31
+ 'queueMicrotask',
32
+ 'requestAnimationFrame',
33
+ 'cancelAnimationFrame',
34
+ 'requestIdleCallback',
35
+ 'cancelIdleCallback',
36
+ 'setImmediate',
37
+ 'clearImmediate',
38
+ 'setInterval',
39
+ 'clearInterval',
40
+ 'setTimeout',
41
+ 'clearTimeout',
42
+ ],
43
+ });
28
44
  mockPruneRecordings.mockReset();
29
45
  mockPruneRecordings.mockReturnValue({ directories: [], files: [] });
30
46
  logger.debug.mockReset();
31
47
  });
32
48
 
33
49
  afterEach(() => {
34
- jest.useRealTimers();
50
+ vi.useRealTimers();
35
51
  });
36
52
 
37
53
  test('startRecordingPruner prunes at start and then on the interval, with recording off', () => {
@@ -39,7 +55,7 @@ test('startRecordingPruner prunes at start and then on the interval, with record
39
55
  const interval = startRecordingPruner({ configDirectory: '/app', logger, intervalMs: 1000 });
40
56
  expect(mockPruneRecordings).toHaveBeenCalledTimes(1);
41
57
  expect(mockPruneRecordings).toHaveBeenCalledWith({ configDirectory: '/app' });
42
- jest.advanceTimersByTime(2500);
58
+ vi.advanceTimersByTime(2500);
43
59
  expect(mockPruneRecordings).toHaveBeenCalledTimes(3);
44
60
  clearInterval(interval);
45
61
  delete process.env.LOWDEFY_DEV_RECORD;
@@ -51,7 +67,7 @@ test('startRecordingPruner logs a failure at debug and keeps running', () => {
51
67
  });
52
68
  const interval = startRecordingPruner({ configDirectory: '/app', logger, intervalMs: 1000 });
53
69
  expect(logger.debug).toHaveBeenCalledWith('Pruning dev recordings failed: EACCES');
54
- jest.advanceTimersByTime(1000);
70
+ vi.advanceTimersByTime(1000);
55
71
  expect(mockPruneRecordings).toHaveBeenCalledTimes(2);
56
72
  clearInterval(interval);
57
73
  });
@@ -16,7 +16,7 @@
16
16
 
17
17
  import { EventEmitter } from 'node:events';
18
18
 
19
- import { jest } from '@jest/globals';
19
+ import { vi, expect, test } from 'vitest';
20
20
 
21
21
  import waitForChildExit from './waitForChildExit.mjs';
22
22
 
@@ -24,7 +24,7 @@ function createChild({ exitOn = [] } = {}) {
24
24
  const child = Object.assign(new EventEmitter(), {
25
25
  exitCode: null,
26
26
  signalCode: null,
27
- kill: jest.fn((signal) => {
27
+ kill: vi.fn((signal) => {
28
28
  if (exitOn.includes(signal)) {
29
29
  setImmediate(() => {
30
30
  child.signalCode = signal;
@@ -19,6 +19,7 @@ import os from 'os';
19
19
  import path from 'path';
20
20
 
21
21
  import writeBuildStatus from './writeBuildStatus.mjs';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let buildDir;
24
25