@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
@@ -15,15 +15,15 @@
15
15
  */
16
16
 
17
17
  import fs from 'node:fs';
18
- import { jest } from '@jest/globals';
18
+ import { vi, expect, test } from 'vitest';
19
19
 
20
20
  import getDataStore from './getDataStore.js';
21
21
  import openDataSession from './openDataSession.js';
22
22
  import { MIN_PORT } from './pickDataStorePort.js';
23
23
 
24
- jest.setTimeout(120000);
24
+ vi.setConfig({ testTimeout: 120000, hookTimeout: 120000 });
25
25
 
26
- // The real memory replica set, in a process of its own (jest runs each file in its own worker), so
26
+ // The real memory replica set, in a process of its own (each test file runs in a worker of its own), so
27
27
  // killing its mongod here touches no other suite's store.
28
28
 
29
29
  async function describeMongod(store) {
@@ -17,30 +17,36 @@
17
17
  import fs from 'node:fs';
18
18
  import os from 'node:os';
19
19
  import path from 'node:path';
20
- import { jest } from '@jest/globals';
20
+ import { vi, afterEach, expect, test } from 'vitest';
21
21
 
22
- const create = jest.fn();
23
- const connect = jest.fn();
24
- const listDatabases = jest.fn();
22
+ const create = vi.fn();
23
+ const connect = vi.fn();
24
+ const listDatabases = vi.fn();
25
25
 
26
- jest.unstable_mockModule('mongodb-memory-server-core', () => ({
26
+ vi.doMock('mongodb-memory-server-core', () => ({
27
27
  MongoMemoryReplSet: { create },
28
28
  }));
29
- jest.unstable_mockModule('mongodb-memory-server-core/lib/util/DryMongoBinary.js', () => ({
29
+ vi.doMock('mongodb-memory-server-core/lib/util/DryMongoBinary.js', () => ({
30
30
  DryMongoBinary: {
31
- generateOptions: jest.fn(async () => ({ version: '6.0.14' })),
32
- locateBinary: jest.fn(async () => '/cache/mongod'),
31
+ generateOptions: vi.fn(async function () {
32
+ return { version: '6.0.14' };
33
+ }),
34
+ locateBinary: vi.fn(async function () {
35
+ return '/cache/mongod';
36
+ }),
33
37
  },
34
38
  }));
35
39
  const actualMongodb = await import('mongodb');
36
- jest.unstable_mockModule('mongodb', () => ({
40
+ vi.doMock('mongodb', () => ({
37
41
  BSON: actualMongodb.BSON,
38
42
  ObjectId: actualMongodb.ObjectId,
39
- MongoClient: jest.fn(() => ({
40
- connect,
41
- close: jest.fn(async () => {}),
42
- db: () => ({ admin: () => ({ listDatabases }), dropDatabase: async () => {} }),
43
- })),
43
+ MongoClient: vi.fn(function () {
44
+ return {
45
+ connect,
46
+ close: vi.fn(async function () {}),
47
+ db: () => ({ admin: () => ({ listDatabases }), dropDatabase: async () => {} }),
48
+ };
49
+ }),
44
50
  }));
45
51
 
46
52
  const { default: getDataStore } = await import('./getDataStore.js');
@@ -50,7 +56,9 @@ const { MIN_PORT } = await import('./pickDataStorePort.js');
50
56
  function createReplSet({ uri = 'mongodb://127.0.0.1:50001/?replicaSet=x', instanceInfo } = {}) {
51
57
  return {
52
58
  getUri: () => uri,
53
- stop: jest.fn(async () => true),
59
+ stop: vi.fn(async function () {
60
+ return true;
61
+ }),
54
62
  servers: [{ instanceInfo }],
55
63
  };
56
64
  }
@@ -77,7 +85,7 @@ afterEach(async () => {
77
85
  await store?.stop();
78
86
  }
79
87
  delete globalThis[Symbol.for('lowdefy.devServer.dataStore')];
80
- jest.restoreAllMocks();
88
+ vi.restoreAllMocks();
81
89
  create.mockReset();
82
90
  listDatabases.mockReset();
83
91
  });
@@ -90,7 +98,7 @@ test('getDataStore starts one replica set and returns the same store on every ca
90
98
  expect(first.uri).toEqual('mongodb://127.0.0.1:50001/?replicaSet=x');
91
99
  expect(create).toHaveBeenCalledTimes(1);
92
100
  expect(create).toHaveBeenCalledWith({
93
- instanceOpts: [{ port: expect.any(Number) }],
101
+ instanceOpts: [{ port: expect.any(Number), args: ['--wiredTigerCacheSizeGB', '0.25'] }],
94
102
  replSet: { count: 1, storageEngine: 'wiredTiger' },
95
103
  });
96
104
  });
@@ -114,7 +122,9 @@ test('getDataStore clears a failed start so the next call retries', async () =>
114
122
  test('a SIGTERM stops the store with cleanup, then raises the signal again', async () => {
115
123
  const replSet = createReplSet();
116
124
  create.mockResolvedValue(replSet);
117
- const kill = jest.spyOn(process, 'kill').mockImplementation(() => true);
125
+ const kill = vi.spyOn(process, 'kill').mockImplementation(function () {
126
+ return true;
127
+ });
118
128
  const before = snapshotListeners();
119
129
  await getDataStore();
120
130
  const [onSigterm] = addedListeners('SIGTERM', before.SIGTERM);
@@ -133,7 +143,9 @@ test('a SIGTERM stops the store with cleanup, then raises the signal again', asy
133
143
  test('a SIGHUP from a closed terminal stops the store with cleanup, then raises the signal again', async () => {
134
144
  const replSet = createReplSet();
135
145
  create.mockResolvedValue(replSet);
136
- const kill = jest.spyOn(process, 'kill').mockImplementation(() => true);
146
+ const kill = vi.spyOn(process, 'kill').mockImplementation(function () {
147
+ return true;
148
+ });
137
149
  const before = snapshotListeners();
138
150
  await getDataStore();
139
151
  const [onSighup] = addedListeners('SIGHUP', before.SIGHUP);
@@ -146,7 +158,7 @@ test('a SIGHUP from a closed terminal stops the store with cleanup, then raises
146
158
  test('the exit hook kills mongod and removes its temporary directory when no stop finished', async () => {
147
159
  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'mongo-mem-test-'));
148
160
  fs.writeFileSync(path.join(tmpDir, 'WiredTiger'), '');
149
- const mongodProcess = { kill: jest.fn() };
161
+ const mongodProcess = { kill: vi.fn() };
150
162
  create.mockResolvedValue(
151
163
  createReplSet({ instanceInfo: { tmpDir, dbPath: tmpDir, instance: { mongodProcess } } })
152
164
  );
@@ -15,6 +15,7 @@
15
15
  */
16
16
 
17
17
  import mergeCollectionIndexes from './mergeCollectionIndexes.js';
18
+ import { expect, test } from 'vitest';
18
19
 
19
20
  test('mergeCollectionIndexes lets a later index replace an earlier one with the same key', () => {
20
21
  expect(
@@ -17,6 +17,7 @@
17
17
  import crypto from 'node:crypto';
18
18
  import { type } from '@lowdefy/helpers';
19
19
 
20
+ import createLogger from '../../server/log/createLogger.js';
20
21
  import dataSessionRegistry from './dataSessionRegistry.js';
21
22
  import drainSessionWork from './drainSessionWork.js';
22
23
  import getDataStore from './getDataStore.js';
@@ -26,6 +27,8 @@ import loadDataSetCollection from './loadDataSetCollection.js';
26
27
  import sessionDatabaseName from './sessionDatabaseName.js';
27
28
  import sweepOrphanDatabases from './sweepOrphanDatabases.js';
28
29
 
30
+ const logger = createLogger();
31
+
29
32
  const DRAIN_TIMEOUT_MS = 30000;
30
33
 
31
34
  // Every database the session holds, the first included.
@@ -43,8 +46,7 @@ function createClose({ session, client }) {
43
46
  session.state = 'closing';
44
47
  const drained = await drainSessionWork({ work: session.work, timeoutMs: DRAIN_TIMEOUT_MS });
45
48
  if (!drained) {
46
- // eslint-disable-next-line no-console
47
- console.warn(
49
+ logger.warn(
48
50
  `Data set "${session.name}": background work was still running ${
49
51
  DRAIN_TIMEOUT_MS / 1000
50
52
  } s after its journey ended. Dropping its databases anyway; that work now fails.`
@@ -17,7 +17,7 @@
17
17
  import fs from 'node:fs';
18
18
  import os from 'node:os';
19
19
  import path from 'node:path';
20
- import { jest } from '@jest/globals';
20
+ import { vi, afterAll, afterEach, beforeAll, beforeEach, describe, expect, test } from 'vitest';
21
21
  import { MongoClient, ObjectId } from 'mongodb';
22
22
  import { parseDataSet } from '@lowdefy/node-utils';
23
23
 
@@ -29,7 +29,10 @@ import readDataSet from './readDataSet.js';
29
29
  import applyDataSetRedirect from '../../server/applyDataSetRedirect.js';
30
30
  import { journeyActorToken } from '../../server/auth/journeyActor.js';
31
31
 
32
- jest.setTimeout(120000);
32
+ const mockLogger = vi.hoisted(() => ({ info: vi.fn(), warn: vi.fn() }));
33
+ vi.mock('../../server/log/createLogger.js', () => ({ default: () => mockLogger }));
34
+
35
+ vi.setConfig({ testTimeout: 120000, hookTimeout: 120000 });
33
36
 
34
37
  let store;
35
38
  let client;
@@ -454,18 +457,33 @@ test('close() waits for background work added to the session', async () => {
454
457
  test('close() drops after 30 s with a warning when background work never settles', async () => {
455
458
  const { session, close } = await openDataSession({ dataSet: makeDataSet({}) });
456
459
  await sessionDb(session).collection('kept').insertOne({ _id: 1 });
457
- const warn = jest.spyOn(console, 'warn').mockImplementation(() => {});
460
+ const warn = mockLogger.warn;
461
+ warn.mockClear();
458
462
  session.work.add(new Promise(() => {}));
459
- jest.useFakeTimers({ doNotFake: ['nextTick', 'setImmediate', 'queueMicrotask', 'performance'] });
463
+ vi.useFakeTimers({
464
+ toFake: [
465
+ 'Date',
466
+ 'hrtime',
467
+ 'requestAnimationFrame',
468
+ 'cancelAnimationFrame',
469
+ 'requestIdleCallback',
470
+ 'cancelIdleCallback',
471
+ 'clearImmediate',
472
+ 'setInterval',
473
+ 'clearInterval',
474
+ 'setTimeout',
475
+ 'clearTimeout',
476
+ ],
477
+ });
460
478
  let warnings;
461
479
  try {
462
480
  const closing = close();
463
- jest.advanceTimersByTime(30000);
464
- jest.useRealTimers();
481
+ vi.advanceTimersByTime(30000);
482
+ vi.useRealTimers();
465
483
  await closing;
466
484
  warnings = warn.mock.calls.map(([message]) => message);
467
485
  } finally {
468
- jest.useRealTimers();
486
+ vi.useRealTimers();
469
487
  warn.mockRestore();
470
488
  }
471
489
  expect(warnings).toEqual([expect.stringContaining('Data set "sample"')]);
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { EventEmitter } from 'node:events';
18
- import { jest } from '@jest/globals';
18
+ import { vi, beforeEach, expect, test } from 'vitest';
19
19
 
20
20
  const listenErrors = [];
21
21
 
@@ -34,7 +34,7 @@ function createServer() {
34
34
  return server;
35
35
  }
36
36
 
37
- jest.unstable_mockModule('node:net', () => ({ default: { createServer } }));
37
+ vi.doMock('node:net', () => ({ default: { createServer } }));
38
38
 
39
39
  const { default: pickDataStorePort, MIN_PORT } = await import('./pickDataStorePort.js');
40
40
 
@@ -17,6 +17,7 @@
17
17
  import dataSessionRegistry from './dataSessionRegistry.js';
18
18
  import readDataSession from './readDataSession.js';
19
19
  import { journeyActorToken } from '../../server/auth/journeyActor.js';
20
+ import { afterEach, expect, test } from 'vitest';
20
21
 
21
22
  afterEach(() => {
22
23
  dataSessionRegistry.clear();
@@ -19,6 +19,7 @@ import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
21
  import readDataSet from './readDataSet.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let configDirectory;
24
25
  let buildDirectory;
@@ -19,6 +19,7 @@ import os from 'node:os';
19
19
  import path from 'node:path';
20
20
 
21
21
  import resolveJourneyDataSet from './resolveJourneyDataSet.js';
22
+ import { afterEach, beforeEach, expect, test } from 'vitest';
22
23
 
23
24
  let configDirectory;
24
25
  let buildDirectory;
@@ -19,7 +19,7 @@ import path from 'node:path';
19
19
  import { shallowBuild } from '@lowdefy/build/dev';
20
20
 
21
21
  // Builds an app into <serverDirectory>/build for a test, in a Node process of its own: the build
22
- // imports plugin modules dynamically, which jest's module runtime cannot load.
22
+ // imports plugin modules dynamically, so it runs outside the test runner's module runtime.
23
23
  // node buildTestApp.mjs <configDirectory> <serverDirectory>
24
24
  const [configDirectory, serverDirectory] = process.argv.slice(2);
25
25
  const serverDevDirectory = path.resolve(import.meta.dirname, '../../../..');
@@ -105,10 +105,15 @@ function startWatcher() {
105
105
  // rebuild's own write re-adds it.
106
106
  }
107
107
 
108
+ // The close waits until the event being handled is done. A subscriber may leave
109
+ // inside the watcher's add event, and chokidar 4 registers the new file's
110
+ // watch handle only after that event returns: a close made inside it would
111
+ // leave the handle open, and the next watcher of buildStatus.json would share
112
+ // that stale handle and miss every later write once the file is replaced.
108
113
  function stopWatcher() {
109
- const closing = watcher.close();
114
+ const stopping = watcher;
110
115
  watcher = null;
111
- return closing;
116
+ return new Promise((resolve) => setImmediate(resolve)).then(() => stopping.close());
112
117
  }
113
118
 
114
119
  function unsubscribe(send) {
@@ -18,13 +18,13 @@ 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, afterAll, afterEach, expect, test } from 'vitest';
22
22
 
23
23
  import flushFsEvents from '../../test-utils/flushFsEvents.mjs';
24
24
  import spyOnChokidar from '../../test-utils/spyOnChokidar.mjs';
25
25
 
26
26
  // macOS can hold file events back for tens of seconds on a busy machine.
27
- jest.setTimeout(180000);
27
+ vi.setConfig({ testTimeout: 180000, hookTimeout: 180000 });
28
28
 
29
29
  // The bus watches build/buildStatus.json under process.cwd() — point it at a
30
30
  // throwaway server directory before the module is imported.
@@ -111,7 +111,7 @@ test('bootedAt is an ISO timestamp fixed at module load', () => {
111
111
  });
112
112
 
113
113
  test('subscribe delivers published events with an ISO timestamp and unsubscribe stops delivery', () => {
114
- const send = jest.fn();
114
+ const send = vi.fn();
115
115
  const unsubscribe = listen(send);
116
116
 
117
117
  publish({ type: 'client_error', message: 'boom' });
@@ -126,7 +126,7 @@ test('subscribe delivers published events with an ISO timestamp and unsubscribe
126
126
  });
127
127
 
128
128
  test('publish keeps the entry timestamp when the entry carries one', () => {
129
- const send = jest.fn();
129
+ const send = vi.fn();
130
130
  listen(send);
131
131
  publish({ type: 'server_error', timestamp: '2026-01-02T03:04:05.000Z', message: 'x' });
132
132
  expect(send.mock.calls[0][0].timestamp).toEqual('2026-01-02T03:04:05.000Z');
@@ -145,10 +145,10 @@ test('subscribe rejects a non-function send', () => {
145
145
  });
146
146
 
147
147
  test('a subscriber that throws is removed and the others still receive', () => {
148
- const throwing = jest.fn(() => {
148
+ const throwing = vi.fn(() => {
149
149
  throw new Error('stream gone');
150
150
  });
151
- const healthy = jest.fn();
151
+ const healthy = vi.fn();
152
152
  listen(throwing);
153
153
  listen(healthy);
154
154
 
@@ -160,8 +160,8 @@ test('a subscriber that throws is removed and the others still receive', () => {
160
160
  });
161
161
 
162
162
  test('a subscriber whose send rejects is removed after the rejection settles', async () => {
163
- const rejecting = jest.fn(() => Promise.reject(new Error('stream gone')));
164
- const healthy = jest.fn(() => Promise.resolve());
163
+ const rejecting = vi.fn(() => Promise.reject(new Error('stream gone')));
164
+ const healthy = vi.fn(() => Promise.resolve());
165
165
  listen(rejecting);
166
166
  listen(healthy);
167
167
 
@@ -229,7 +229,7 @@ test('a successful buildStatus.json write publishes a build event that is not st
229
229
 
230
230
  test('removing buildStatus.json publishes nothing', async () => {
231
231
  await writeExistingStatus({ status: 'ok', errors: [], warnings: [] });
232
- const send = jest.fn();
232
+ const send = vi.fn();
233
233
  listen(send);
234
234
  const { watcher } = watchers.at(-1);
235
235
  await watcherReady();
@@ -254,11 +254,13 @@ test('removing buildStatus.json publishes nothing', async () => {
254
254
  });
255
255
 
256
256
  test('the watcher closes when the last subscriber leaves so a later write publishes nothing', async () => {
257
- const send = jest.fn();
257
+ const send = vi.fn();
258
258
  const unsubscribe = listen(send);
259
259
  const { watcher } = watchers.at(-1);
260
260
  await watcherReady();
261
261
  unsubscribe();
262
+ // The bus closes its watcher once the current event is handled.
263
+ await new Promise((resolve) => setImmediate(resolve));
262
264
  expect(watcher.closed).toBe(true);
263
265
 
264
266
  fs.writeFileSync(statusPath, JSON.stringify({ status: 'ok', errors: [], warnings: [] }));