@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
@@ -1,30 +0,0 @@
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 { type } from '@lowdefy/helpers';
18
-
19
- // Whether the newest call of a request or endpoint was made by this event.
20
- // Action ids are config ids, not unique across blocks or runs, so an id in
21
- // the event's responses is not enough: the call must come from the event's
22
- // own block, and from an action this run did not skip (a skipped action keeps
23
- // its response entry while the call history still holds an earlier run's).
24
- function isEventCall({ blockId, call, responses }) {
25
- if (type.isNone(call) || type.isNone(call.actionId)) return false;
26
- if (call.blockId !== blockId || !(call.actionId in responses)) return false;
27
- return responses[call.actionId]?.skipped !== true;
28
- }
29
-
30
- export default isEventCall;
@@ -1,39 +0,0 @@
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 { type } from '@lowdefy/helpers';
18
-
19
- // The JSON type name a trace event carries for a written state value. Dates are
20
- // named as dates rather than collapsed into "object": the engine keeps real Date
21
- // objects in state, and a journey expectation compiled from the trace has to know
22
- // it is comparing a date, not a bag of fields.
23
- function jsonType(value) {
24
- if (type.isNone(value)) {
25
- return value === null ? 'null' : 'undefined';
26
- }
27
- if (type.isArray(value)) {
28
- return 'array';
29
- }
30
- if (type.isDate(value)) {
31
- return 'date';
32
- }
33
- if (type.isObject(value)) {
34
- return 'object';
35
- }
36
- return typeof value;
37
- }
38
-
39
- export default jsonType;
@@ -1,40 +0,0 @@
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 chunkRecords from './chunkRecords.js';
18
-
19
- // One same-origin POST per chunk. keepalive lets a send started on pagehide
20
- // finish after the tab is gone, as a beacon would, with one code path. A
21
- // failed send is dropped: recording must never get in the developer's way.
22
- async function sendRecords({ basePath, records, fetch }) {
23
- const chunks = chunkRecords({ records });
24
- await Promise.all(
25
- chunks.map(async (chunk) => {
26
- try {
27
- await fetch(`${basePath}/api/dev-recording`, {
28
- method: 'POST',
29
- keepalive: true,
30
- headers: { 'Content-Type': 'application/json' },
31
- body: JSON.stringify(chunk),
32
- });
33
- } catch {
34
- // Dropped silently.
35
- }
36
- })
37
- );
38
- }
39
-
40
- export default sendRecords;
@@ -1,99 +0,0 @@
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
-
20
- import { urlQuery as urlQueryFn } from '@lowdefy/helpers';
21
-
22
- import drawAnnotationsSvg from '../../client/feedback/drawAnnotationsSvg.js';
23
- import { getBrowser, openPage } from './getBrowser.js';
24
- import noBrowserError from './noBrowserError.js';
25
- import readPagePath from './readPagePath.js';
26
- import withBrowserSlot from './withBrowserSlot.js';
27
-
28
- // Renders the batch's page instance (pageId, pathParams, urlQuery) headless at
29
- // the batch's recorded viewport/scroll, injects the developer's drawn shapes
30
- // and element outlines as an SVG layer inside the page, screenshots the
31
- // composite, and saves it under the config dir's .lowdefy/annotations/
32
- // (gitignored). The saved path goes into the formatted feedback text so an
33
- // agent can read the image. Never throws — returns { path } or { error }.
34
- async function captureInBrowser({ origin, batch, fileName }) {
35
- let browser;
36
- try {
37
- browser = await getBrowser();
38
- } catch (error) {
39
- return { error: noBrowserError(error) };
40
- }
41
-
42
- const viewport = batch.viewport ?? {};
43
- const width = viewport.width || 1280;
44
- const height = viewport.height || 800;
45
- let context;
46
- try {
47
- const opened = await openPage({
48
- browser,
49
- origin,
50
- pageId: batch.pageId,
51
- path: readPagePath({ pageId: batch.pageId }),
52
- pathParams: batch.pathParams,
53
- urlQuery: urlQueryFn.parse(batch.urlQuery ?? ''),
54
- width,
55
- height,
56
- });
57
- context = opened.context;
58
- const { page } = opened;
59
-
60
- if (viewport.scrollX || viewport.scrollY) {
61
- await page.evaluate(
62
- ([x, y]) => window.scrollTo(x, y),
63
- [viewport.scrollX ?? 0, viewport.scrollY ?? 0]
64
- );
65
- await page.waitForTimeout(200);
66
- }
67
-
68
- // Shapes and element rects are viewport-relative at the recorded scroll
69
- // offset — after scrolling to the same offset they overlay 1:1. The
70
- // compositor is shared with the in-tab capture (drawAnnotationsSvg is
71
- // self-contained, so Playwright can serialize it into the page).
72
- await page.evaluate(drawAnnotationsSvg, batch.annotations ?? []);
73
- await page.waitForTimeout(150);
74
-
75
- const buffer = await page.screenshot({ type: 'png' });
76
-
77
- const configDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
78
- const dir = path.join(configDirectory, '.lowdefy', 'annotations');
79
- fs.mkdirSync(dir, { recursive: true });
80
- const name =
81
- fileName ?? `${batch.pageId}-${new Date().toISOString().replace(/[:.]/g, '-')}.png`;
82
- fs.writeFileSync(path.join(dir, name), buffer);
83
-
84
- return { path: path.posix.join('.lowdefy', 'annotations', name) };
85
- } catch (error) {
86
- return { error: `Failed to capture annotated screenshot: ${error.message}` };
87
- } finally {
88
- if (context) {
89
- await context.close();
90
- }
91
- }
92
- }
93
-
94
- // One browser slot for the whole capture.
95
- async function captureAnnotatedScreenshot({ origin, batch, fileName }) {
96
- return withBrowserSlot({ task: () => captureInBrowser({ origin, batch, fileName }) });
97
- }
98
-
99
- export default captureAnnotatedScreenshot;
@@ -1,91 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import fs from 'fs';
18
- import path from 'path';
19
-
20
- // Shared path/file-listing helpers for createConfigCheckpoint.js,
21
- // listConfigCheckpoints.js and revertConfigCheckpoint.js.
22
-
23
- const CONFIG_FILE_EXTENSIONS = ['.yaml', '.yml', '.json', '.md', '.js', '.env'];
24
- const EXCLUDED_DIRECTORY_NAMES = ['.lowdefy', 'node_modules', '.git', 'checkpoints'];
25
- const MAX_CHECKPOINTS = 20;
26
- const MANIFEST_FILE_NAME = 'manifest.json';
27
-
28
- function getConfigDirectory() {
29
- return process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
30
- }
31
-
32
- function getCheckpointsRoot() {
33
- return path.join(getConfigDirectory(), '.lowdefy', 'checkpoints');
34
- }
35
-
36
- // path.extname('.env') is '' (dotfiles have no extension in Node's eyes), so a
37
- // dotfile named exactly ".env" needs its own basename check.
38
- function isConfigFile(filePath) {
39
- if (path.basename(filePath) === '.env') {
40
- return true;
41
- }
42
- return CONFIG_FILE_EXTENSIONS.includes(path.extname(filePath));
43
- }
44
-
45
- // Recursively lists config-relevant files under `configDirectory`, returned as
46
- // paths relative to it. Skips directories that should never be snapshotted —
47
- // build output (.lowdefy, which also holds the checkpoints themselves),
48
- // dependencies (node_modules) and version control (.git).
49
- function listConfigFiles({ configDirectory }) {
50
- const results = [];
51
-
52
- function walk(currentDir) {
53
- for (const entry of fs.readdirSync(currentDir, { withFileTypes: true })) {
54
- const fullPath = path.join(currentDir, entry.name);
55
- if (entry.isDirectory()) {
56
- if (EXCLUDED_DIRECTORY_NAMES.includes(entry.name)) {
57
- continue;
58
- }
59
- walk(fullPath);
60
- } else if (entry.isFile() && isConfigFile(fullPath)) {
61
- results.push(path.relative(configDirectory, fullPath));
62
- }
63
- }
64
- }
65
-
66
- if (fs.existsSync(configDirectory)) {
67
- walk(configDirectory);
68
- }
69
- return results;
70
- }
71
-
72
- // Slugifies a checkpoint label for use in a directory name — lowercase,
73
- // non-alphanumeric runs collapsed to a single "-", leading/trailing "-"
74
- // trimmed. Falls back to "checkpoint" when the label slugifies to nothing
75
- // (e.g. an empty string or a label made only of punctuation).
76
- function slug(label) {
77
- const slugified = String(label ?? '')
78
- .toLowerCase()
79
- .replace(/[^a-z0-9]+/g, '-')
80
- .replace(/^-+|-+$/g, '');
81
- return slugified === '' ? 'checkpoint' : slugified;
82
- }
83
-
84
- export {
85
- getCheckpointsRoot,
86
- getConfigDirectory,
87
- listConfigFiles,
88
- MANIFEST_FILE_NAME,
89
- MAX_CHECKPOINTS,
90
- slug,
91
- };
@@ -1,243 +0,0 @@
1
- /*
2
- Copyright 2020-2026 Lowdefy, Inc
3
-
4
- Licensed under the Apache License, Version 2.0 (the "License");
5
- you may not use this file except in compliance with the License.
6
- You may obtain a copy of the License at
7
-
8
- http://www.apache.org/licenses/LICENSE-2.0
9
-
10
- Unless required by applicable law or agreed to in writing, software
11
- distributed under the License is distributed on an "AS IS" BASIS,
12
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- See the License for the specific language governing permissions and
14
- limitations under the License.
15
- */
16
-
17
- import fs from 'fs';
18
- import path from 'path';
19
- import { isReserved, serializer, setKey, type } from '@lowdefy/helpers';
20
-
21
- import { getConfigDirectory } from './checkpointPaths.js';
22
-
23
- // State checkpoints (page state + recorded request/api responses) live under
24
- // <configDir>/.lowdefy/state-checkpoints/<name>/ — inside .lowdefy because a
25
- // checkpoint captures the signed-in user's data and live backend responses,
26
- // which must not sit in a committable spot by default (.lowdefy is gitignored
27
- // by convention and ignored by the dev file watcher). A sibling of
28
- // .lowdefy/checkpoints (the config-directory-snapshot checkpoints in
29
- // checkpointPaths.js/createConfigCheckpoint.js) rather than a subdirectory,
30
- // because that store prunes its oldest directories beyond a cap. These two
31
- // "checkpoint" concepts are unrelated: this one is for putting the *running
32
- // app* into a specific state (agent verification, human testing, e2e test
33
- // generation), not for reverting config files.
34
- const NAME_PATTERN = /^[a-z0-9-_]+$/i;
35
-
36
- function getStateCheckpointsRoot() {
37
- return path.join(getConfigDirectory(), '.lowdefy', 'state-checkpoints');
38
- }
39
-
40
- function validateName(name) {
41
- if (type.isNone(name) || !type.isString(name)) {
42
- throw new Error(`Checkpoint "name" must be a string. Received ${JSON.stringify(name)}.`);
43
- }
44
- if (!NAME_PATTERN.test(name)) {
45
- throw new Error(
46
- `Checkpoint name "${name}" is invalid — use only letters, numbers, "-" and "_".`
47
- );
48
- }
49
- }
50
-
51
- function writeJsonFile(filePath, value) {
52
- fs.mkdirSync(path.dirname(filePath), { recursive: true });
53
- fs.writeFileSync(filePath, JSON.stringify(serializer.serialize(value), null, 2));
54
- }
55
-
56
- function readJsonFile(filePath, defaultValue) {
57
- if (!fs.existsSync(filePath)) {
58
- return defaultValue;
59
- }
60
- return serializer.deserialize(JSON.parse(fs.readFileSync(filePath, 'utf8')));
61
- }
62
-
63
- // Requests/api responses arrive as either an array of entries (newest first —
64
- // the shape of context.requests in both Requests.js and Inspector.jsx's
65
- // buildSnapshot) or a single entry object. Either way only the newest
66
- // recording is kept per id.
67
- function newestEntry(value) {
68
- return Array.isArray(value) ? value[0] : value;
69
- }
70
-
71
- function writeEntries({ dir, subdir, entries, parts }) {
72
- Object.entries(entries ?? {}).forEach(([id, value]) => {
73
- const entry = newestEntry(value);
74
- if (type.isNone(entry)) {
75
- return;
76
- }
77
- const { payload, response, error, responseTime } = entry;
78
- writeJsonFile(path.join(dir, subdir, `${id}.json`), { payload, response, error, responseTime });
79
- parts.push(`${subdir}/${id}.json`);
80
- });
81
- }
82
-
83
- function readEntries({ dir, subdir }) {
84
- const entriesDir = path.join(dir, subdir);
85
- const entries = {};
86
- if (!fs.existsSync(entriesDir)) {
87
- return entries;
88
- }
89
- fs.readdirSync(entriesDir)
90
- .filter((fileName) => fileName.endsWith('.json'))
91
- .forEach((fileName) => {
92
- const id = fileName.slice(0, -'.json'.length);
93
- // A checkpoint directory is on-disk state a developer can edit by hand.
94
- // A reserved file name can't round-trip through the entries map, so skip
95
- // it rather than fail the whole checkpoint load.
96
- if (isReserved(id)) {
97
- return;
98
- }
99
- setKey(entries, id, readJsonFile(path.join(entriesDir, fileName), null));
100
- });
101
- return entries;
102
- }
103
-
104
- // Snapshots a running page's state + recorded request/api responses into a
105
- // checkpoint folder. Refuses to clobber an existing checkpoint unless
106
- // `overwrite: true` — when overwriting, the old folder is removed first so a
107
- // checkpoint written with fewer requests than a previous one doesn't leave
108
- // stale per-request files behind.
109
- function writeCheckpoint({ name, snapshot, notes, overwrite }) {
110
- validateName(name);
111
- if (type.isNone(snapshot) || !type.isObject(snapshot)) {
112
- throw new Error(
113
- `writeCheckpoint requires a "snapshot" object. Received ${JSON.stringify(snapshot)}.`
114
- );
115
- }
116
-
117
- const dir = path.join(getStateCheckpointsRoot(), name);
118
- const exists = fs.existsSync(dir);
119
- if (exists && overwrite !== true) {
120
- throw new Error(`Checkpoint "${name}" already exists. Pass overwrite: true to replace it.`);
121
- }
122
- if (exists) {
123
- fs.rmSync(dir, { recursive: true, force: true });
124
- }
125
- fs.mkdirSync(dir, { recursive: true });
126
-
127
- const parts = [];
128
- const manifest = {
129
- name,
130
- pageId: snapshot.pageId ?? null,
131
- url: snapshot.url ?? null,
132
- capturedAt: new Date().toISOString(),
133
- notes: notes ?? null,
134
- };
135
- writeJsonFile(path.join(dir, 'checkpoint.json'), manifest);
136
- parts.push('checkpoint.json');
137
-
138
- writeJsonFile(path.join(dir, 'state.json'), snapshot.state ?? {});
139
- parts.push('state.json');
140
- writeJsonFile(path.join(dir, 'urlQuery.json'), snapshot.urlQuery ?? '');
141
- parts.push('urlQuery.json');
142
- writeJsonFile(path.join(dir, 'pathParams.json'), snapshot.pathParams ?? {});
143
- parts.push('pathParams.json');
144
- writeJsonFile(path.join(dir, 'inputs.json'), snapshot.input ?? {});
145
- parts.push('inputs.json');
146
- writeJsonFile(path.join(dir, 'user.json'), snapshot.user ?? null);
147
- parts.push('user.json');
148
- writeJsonFile(path.join(dir, 'global.json'), snapshot.global ?? {});
149
- parts.push('global.json');
150
-
151
- writeEntries({ dir, subdir: 'requests', entries: snapshot.requests, parts });
152
- if (!type.isNone(snapshot.apiResponses)) {
153
- writeEntries({ dir, subdir: 'api', entries: snapshot.apiResponses, parts });
154
- }
155
-
156
- return { dir, parts };
157
- }
158
-
159
- // Reads a checkpoint back, tolerant of individually missing parts (a
160
- // developer may hand-edit or delete files in a committed checkpoint folder) —
161
- // only a missing checkpoint directory itself is an error.
162
- function readCheckpoint({ name }) {
163
- validateName(name);
164
- const dir = path.join(getStateCheckpointsRoot(), name);
165
- if (!fs.existsSync(dir)) {
166
- throw new Error(`Checkpoint "${name}" not found.`);
167
- }
168
-
169
- const checkpoint = readJsonFile(path.join(dir, 'checkpoint.json'), {
170
- name,
171
- pageId: null,
172
- url: null,
173
- capturedAt: null,
174
- notes: null,
175
- });
176
-
177
- return {
178
- name,
179
- checkpoint,
180
- state: readJsonFile(path.join(dir, 'state.json'), {}),
181
- urlQuery: readJsonFile(path.join(dir, 'urlQuery.json'), ''),
182
- pathParams: readJsonFile(path.join(dir, 'pathParams.json'), {}),
183
- input: readJsonFile(path.join(dir, 'inputs.json'), {}),
184
- user: readJsonFile(path.join(dir, 'user.json'), null),
185
- global: readJsonFile(path.join(dir, 'global.json'), {}),
186
- requests: readEntries({ dir, subdir: 'requests' }),
187
- api: readEntries({ dir, subdir: 'api' }),
188
- };
189
- }
190
-
191
- function checkpointExists({ name }) {
192
- validateName(name);
193
- return fs.existsSync(path.join(getStateCheckpointsRoot(), name));
194
- }
195
-
196
- // Lists stored state checkpoints, most recent first. Corrupted/hand-edited
197
- // checkpoints without a manifest still show up (with null fields) rather
198
- // than being silently hidden, since these folders are meant to be
199
- // human-editable.
200
- function listStateCheckpoints() {
201
- const root = getStateCheckpointsRoot();
202
- if (!fs.existsSync(root)) {
203
- return [];
204
- }
205
-
206
- const checkpoints = fs
207
- .readdirSync(root, { withFileTypes: true })
208
- .filter((entry) => entry.isDirectory())
209
- .map((entry) => {
210
- const dir = path.join(root, entry.name);
211
- const manifest = readJsonFile(path.join(dir, 'checkpoint.json'), {
212
- name: entry.name,
213
- pageId: null,
214
- capturedAt: null,
215
- notes: null,
216
- });
217
- const requestsDir = path.join(dir, 'requests');
218
- const requestCount = fs.existsSync(requestsDir)
219
- ? fs.readdirSync(requestsDir).filter((fileName) => fileName.endsWith('.json')).length
220
- : 0;
221
- return {
222
- name: entry.name,
223
- pageId: manifest.pageId ?? null,
224
- capturedAt: manifest.capturedAt ?? null,
225
- notes: manifest.notes ?? null,
226
- requestCount,
227
- };
228
- });
229
-
230
- return checkpoints.sort((a, b) => {
231
- if (type.isNone(a.capturedAt)) return 1;
232
- if (type.isNone(b.capturedAt)) return -1;
233
- return a.capturedAt < b.capturedAt ? 1 : -1;
234
- });
235
- }
236
-
237
- export {
238
- checkpointExists,
239
- getStateCheckpointsRoot,
240
- listStateCheckpoints,
241
- readCheckpoint,
242
- writeCheckpoint,
243
- };
@@ -1,65 +0,0 @@
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 YAML from 'yaml';
18
-
19
- import { readCheckpoint } from './checkpointStore.js';
20
-
21
- // Errors can't round-trip through YAML as Error instances (and don't need
22
- // to) — @lowdefy/e2e-utils' createMockManager accepts a plain string and
23
- // wraps it itself (`error instanceof Error ? error : new Error(error)`), so
24
- // only the message is kept here.
25
- function toMockError(error) {
26
- if (!error) {
27
- return undefined;
28
- }
29
- return error.message ?? String(error);
30
- }
31
-
32
- function toMockEntries(entries, idKey, extraFields = {}) {
33
- return Object.entries(entries ?? {}).map(([id, entry]) => {
34
- const error = toMockError(entry?.error);
35
- const base = { [idKey]: id, ...extraFields };
36
- if (error) {
37
- return { ...base, error };
38
- }
39
- return { ...base, response: entry?.response ?? null };
40
- });
41
- }
42
-
43
- // Converts a state checkpoint's recorded requests/api responses into the
44
- // exact shape @lowdefy/e2e-utils' loadStaticMocks/createMockManager expect
45
- // (`{ requests: [...], api: [...] }`), so a checkpoint recorded from a live
46
- // dev session can seed a future AI-generated (or hand-written) e2e test's
47
- // mocks file directly.
48
- function checkpointToMocks({ name }) {
49
- let checkpoint;
50
- try {
51
- checkpoint = readCheckpoint({ name });
52
- } catch (error) {
53
- return { error: error.message };
54
- }
55
-
56
- const pageId = checkpoint.checkpoint.pageId;
57
- const requests = toMockEntries(checkpoint.requests, 'requestId', { pageId });
58
- const api = toMockEntries(checkpoint.api, 'endpointId');
59
-
60
- const yamlContent = YAML.stringify({ requests, api });
61
-
62
- return { requests, api, yaml: yamlContent };
63
- }
64
-
65
- export default checkpointToMocks;