@lowdefy/server-dev 7.1.0 → 7.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (432) hide show
  1. package/client/Inspector.jsx +24 -75
  2. package/client/Page.jsx +8 -0
  3. package/client/Routing.jsx +0 -2
  4. package/client/clientBuildImports.test.mjs +5 -3
  5. package/client/devStreamConnections.test.mjs +1 -0
  6. package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
  7. package/client/openInEditor/OpenInEditorListener.jsx +36 -29
  8. package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
  9. package/client/{feedback → openInEditor}/elementInspect.js +9 -44
  10. package/client/openInEditor/findBlockLocation.js +2 -2
  11. package/client/openInEditor/openInEditorStyles.js +56 -0
  12. package/client/recorder/createPairingBuffer.test.mjs +27 -9
  13. package/client/recorder/createRecorder.js +11 -7
  14. package/client/recorder/createRecorder.test.mjs +9 -9
  15. package/client/recorder/isPasswordElement.js +41 -0
  16. package/client/recorder/keyChord.test.mjs +1 -0
  17. package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
  18. package/lib/client/auth/AuthConfigured.jsx +75 -48
  19. package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
  20. package/lib/client/auth/authTemplateSync.test.mjs +1 -0
  21. package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
  22. package/lib/client/auth/sessionCaller.js +56 -0
  23. package/lib/client/auth/sessionCaller.test.mjs +78 -0
  24. package/lib/client/getPagePath.test.mjs +1 -0
  25. package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
  26. package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
  27. package/lib/client/utils/usePageConfig.test.mjs +15 -15
  28. package/lib/configTree/buildConfigTree.test.mjs +6 -8
  29. package/lib/configTree/collectConfigText.test.mjs +1 -0
  30. package/lib/configTree/runConfigTreeBuild.mjs +2 -1
  31. package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
  32. package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
  33. package/lib/docs/addNestedEndpoints.test.mjs +1 -0
  34. package/lib/docs/checkAgentFiles.test.mjs +1 -0
  35. package/lib/docs/checkStepReferences.test.mjs +3 -3
  36. package/lib/docs/clientErrorStore.test.mjs +4 -4
  37. package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
  38. package/lib/docs/createDocsMcpServer.js +195 -138
  39. package/lib/docs/createDocsMcpServer.test.mjs +331 -25
  40. package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
  41. package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
  42. package/lib/docs/createJourneyActors.test.mjs +4 -4
  43. package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
  44. package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
  45. package/lib/docs/dataSets/getDataStore.js +11 -3
  46. package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
  47. package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
  48. package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
  49. package/lib/docs/dataSets/openDataSession.js +4 -2
  50. package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
  51. package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
  52. package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
  53. package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
  54. package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
  55. package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
  56. package/lib/docs/devEventBus.js +7 -2
  57. package/lib/docs/devEventBus.test.mjs +12 -10
  58. package/lib/docs/devToolDefinitions.js +87 -135
  59. package/lib/docs/device/buildDeviceCommand.js +103 -0
  60. package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
  61. package/lib/docs/device/captureDevice.js +85 -0
  62. package/lib/docs/device/checkShownPage.js +56 -0
  63. package/lib/docs/device/createFakePhoneTab.mjs +77 -0
  64. package/lib/docs/device/deviceAction.js +74 -0
  65. package/lib/docs/device/deviceTools.test.mjs +604 -0
  66. package/lib/docs/device/findDeviceTab.js +50 -0
  67. package/lib/docs/device/findDeviceTarget.js +73 -0
  68. package/lib/docs/device/injectDevice.js +160 -0
  69. package/lib/docs/device/listDevices.js +100 -0
  70. package/lib/docs/device/listDevices.test.mjs +105 -0
  71. package/lib/docs/device/runDeviceJourney.js +68 -0
  72. package/lib/docs/device/runDeviceSteps.js +164 -0
  73. package/lib/docs/device/screenshotDevice.js +68 -0
  74. package/lib/docs/device/sendDeviceStep.js +52 -0
  75. package/lib/docs/device/startDevice.js +150 -0
  76. package/lib/docs/docs.test.mjs +44 -28
  77. package/lib/docs/docsIndex.test.mjs +1 -0
  78. package/lib/docs/findConfig.js +3 -4
  79. package/lib/docs/findPageBlock.js +35 -0
  80. package/lib/docs/findPageBlock.test.mjs +45 -0
  81. package/lib/docs/fitResponse.js +18 -17
  82. package/lib/docs/fitResponse.test.mjs +18 -0
  83. package/lib/docs/getBrowser.js +3 -3
  84. package/lib/docs/getBrowser.test.mjs +32 -16
  85. package/lib/docs/getBuildId.test.mjs +1 -0
  86. package/lib/docs/getBuildStatus.test.mjs +11 -11
  87. package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
  88. package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
  89. package/lib/docs/getHazards.js +4 -1
  90. package/lib/docs/getHazards.test.mjs +9 -7
  91. package/lib/docs/getOverview.js +20 -42
  92. package/lib/docs/getOverviewBasePath.test.mjs +1 -0
  93. package/lib/docs/getStaleStatus.test.mjs +1 -0
  94. package/lib/docs/inspectState.js +78 -3
  95. package/lib/docs/inspectState.test.mjs +61 -9
  96. package/lib/docs/inspectStateFromTab.js +38 -6
  97. package/lib/docs/inspectStateFromTab.test.mjs +79 -0
  98. package/lib/docs/inspectStateHeadless.js +98 -34
  99. package/lib/docs/inspectStateHeadless.test.mjs +17 -5
  100. package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
  101. package/lib/docs/installHeadlessShell.js +5 -2
  102. package/lib/docs/installHeadlessShell.test.mjs +8 -5
  103. package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
  104. package/lib/docs/isDeepEqual.js +37 -0
  105. package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
  106. package/lib/docs/isPageReady.test.mjs +1 -0
  107. package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
  108. package/lib/docs/journeyRunRecording.test.mjs +1 -0
  109. package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
  110. package/lib/docs/launchBrowser.test.mjs +8 -8
  111. package/lib/docs/listTypes.js +58 -8
  112. package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
  113. package/lib/docs/matchJourneyRoute.test.mjs +1 -0
  114. package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
  115. package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
  116. package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
  117. package/lib/docs/observe/withAppErrors.test.mjs +1 -0
  118. package/lib/docs/openJourneyEmail.test.mjs +6 -6
  119. package/lib/docs/pageBuildStatus.test.mjs +6 -6
  120. package/lib/docs/pollTab.js +100 -0
  121. package/lib/docs/pollTab.test.mjs +64 -0
  122. package/lib/docs/rails/authEngineActions.test.mjs +1 -0
  123. package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
  124. package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
  125. package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
  126. package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
  127. package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
  128. package/lib/docs/readJourneySession.js +1 -1
  129. package/lib/docs/reportDevToolFault.js +29 -0
  130. package/lib/docs/reportDevToolFault.test.mjs +34 -0
  131. package/lib/docs/requestRestart.test.mjs +1 -0
  132. package/lib/docs/resolvePageInstance.test.mjs +1 -0
  133. package/lib/docs/resolveSource.js +2 -2
  134. package/lib/docs/resolveSource.test.mjs +6 -6
  135. package/lib/docs/reviewPageBuilds.test.mjs +2 -2
  136. package/lib/docs/runCheck.test.mjs +3 -3
  137. package/lib/docs/runCheckChild.js +2 -1
  138. package/lib/docs/runEndpoint.js +23 -10
  139. package/lib/docs/runEndpoint.test.mjs +42 -37
  140. package/lib/docs/runErrorBuffers.test.mjs +1 -0
  141. package/lib/docs/runJourney.js +21 -1
  142. package/lib/docs/runJourney.test.mjs +119 -99
  143. package/lib/docs/runJourneyDataSet.test.mjs +25 -25
  144. package/lib/docs/runJourneySteps.js +8 -29
  145. package/lib/docs/runRequest.js +6 -6
  146. package/lib/docs/runRequest.test.mjs +22 -22
  147. package/lib/docs/screenshotPage.js +6 -7
  148. package/lib/docs/screenshotPage.test.mjs +46 -46
  149. package/lib/docs/screenshotPageClip.test.mjs +10 -10
  150. package/lib/docs/searchDocs.test.mjs +1 -0
  151. package/lib/docs/searchIcons.test.mjs +5 -5
  152. package/lib/docs/selectFinalState.test.mjs +1 -0
  153. package/lib/docs/serverErrorStore.test.mjs +4 -4
  154. package/lib/docs/setupTestFixtures.mjs +25 -0
  155. package/lib/docs/splitSearchTerms.test.mjs +1 -0
  156. package/lib/docs/tabAvailable.js +1 -1
  157. package/lib/docs/tabChannel.js +90 -14
  158. package/lib/docs/tabChannel.test.mjs +40 -15
  159. package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
  160. package/lib/docs/validateStateSelection.test.mjs +1 -0
  161. package/lib/docs/validateViewport.test.mjs +1 -0
  162. package/lib/docs/waitForBuild.test.mjs +1 -0
  163. package/lib/docs/withBrowserSlot.test.mjs +5 -5
  164. package/lib/server/applyDataSetRedirect.test.mjs +2 -2
  165. package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
  166. package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
  167. package/lib/server/auth/getHeadlessUser.js +6 -0
  168. package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
  169. package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
  170. package/lib/server/contextMapBudget.test.mjs +3 -3
  171. package/lib/server/continueJitKeys.test.mjs +1 -0
  172. package/lib/server/createLowdefyContext.js +5 -1
  173. package/lib/server/createLowdefyContext.test.mjs +32 -32
  174. package/lib/server/getClientAddress.test.mjs +2 -2
  175. package/lib/server/getPageJitEnrichment.test.mjs +1 -0
  176. package/lib/server/importAppCode.test.mjs +2 -2
  177. package/lib/server/jitPageBuilder.js +27 -3
  178. package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
  179. package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
  180. package/lib/server/jitPageBuilder.test.mjs +4 -4
  181. package/lib/server/journeyCookies.test.mjs +1 -0
  182. package/lib/server/loadDynamicJsMap.js +10 -1
  183. package/lib/server/log/createHandleError.js +10 -5
  184. package/lib/server/log/createHandleError.test.mjs +19 -8
  185. package/lib/server/log/createLogger.test.mjs +2 -2
  186. package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
  187. package/lib/server/mutants/listMutants.test.mjs +1 -0
  188. package/lib/server/mutants/mutantRuns.test.mjs +1 -0
  189. package/lib/server/mutants/operators.test.mjs +1 -0
  190. package/lib/server/pageBuildRecords.test.mjs +1 -0
  191. package/lib/server/pageCache.test.mjs +1 -0
  192. package/lib/server/pageRebuilds.test.mjs +3 -3
  193. package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
  194. package/lib/server/pruneJitMaps.test.mjs +1 -0
  195. package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
  196. package/lib/server/readInstanceRecord.test.mjs +24 -8
  197. package/lib/server/readMergedMaps.test.mjs +1 -0
  198. package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
  199. package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
  200. package/lib/server/recording/servedBuilds.test.mjs +1 -0
  201. package/lib/server/sinkExternalConnections.test.mjs +6 -6
  202. package/lib/server/skipStaleMapWrites.test.mjs +12 -12
  203. package/lib/server/startIdleGc.test.mjs +25 -9
  204. package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
  205. package/lib/vite/createDevServerExclude.test.mjs +1 -0
  206. package/manager/getContext.mjs +9 -0
  207. package/manager/processes/checkPendingPlugins.mjs +49 -0
  208. package/manager/processes/checkPendingPlugins.test.mjs +107 -0
  209. package/manager/processes/createIdleChild.mjs +141 -0
  210. package/manager/processes/createIdleChild.test.mjs +209 -0
  211. package/manager/processes/initialBuild.mjs +2 -15
  212. package/manager/processes/initialBuild.test.mjs +8 -40
  213. package/manager/processes/lowdefyBuild.mjs +7 -4
  214. package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
  215. package/manager/processes/lowdefyBuild.test.mjs +17 -15
  216. package/manager/processes/restartServer.test.mjs +63 -15
  217. package/manager/processes/shutdownServer.test.mjs +3 -3
  218. package/manager/processes/startFirstServer.test.mjs +23 -22
  219. package/manager/processes/startMailSink.mjs +11 -3
  220. package/manager/processes/startMailSink.test.mjs +28 -2
  221. package/manager/processes/startProxy.mjs +158 -27
  222. package/manager/processes/startProxy.pairing.test.mjs +204 -0
  223. package/manager/processes/startProxy.test.mjs +127 -2
  224. package/manager/processes/startServer.mjs +5 -7
  225. package/manager/processes/startServer.test.mjs +10 -9
  226. package/manager/processes/syncServer.mjs +31 -4
  227. package/manager/processes/syncServer.test.mjs +71 -6
  228. package/manager/processes/waitForDevServer.test.mjs +21 -6
  229. package/manager/run.mjs +32 -8
  230. package/manager/utils/BatchChanges.mjs +1 -1
  231. package/manager/utils/BatchChanges.test.mjs +4 -4
  232. package/manager/utils/acquireDevInstance.test.mjs +1 -0
  233. package/manager/utils/checkPairing.mjs +45 -0
  234. package/manager/utils/checkPairing.test.mjs +53 -0
  235. package/manager/utils/createBuildActivity.mjs +5 -1
  236. package/manager/utils/createBuildActivity.test.mjs +2 -2
  237. package/manager/utils/createChangeSignal.test.mjs +5 -5
  238. package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
  239. package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
  240. package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
  241. package/manager/utils/createDotPathIgnore.test.mjs +1 -0
  242. package/manager/utils/createGlobIgnore.mjs +45 -0
  243. package/manager/utils/createGlobIgnore.test.mjs +58 -0
  244. package/manager/utils/createGlobWatchPaths.mjs +75 -0
  245. package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
  246. package/manager/utils/createIdleGc.test.mjs +31 -15
  247. package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
  248. package/manager/utils/createLanPairing.test.mjs +46 -0
  249. package/manager/utils/createRequestActivity.mjs +30 -3
  250. package/manager/utils/createRequestActivity.test.mjs +76 -22
  251. package/manager/utils/createServerArtifactTracker.mjs +1 -0
  252. package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
  253. package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
  254. package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
  255. package/manager/utils/findSignInCode.test.mjs +33 -0
  256. package/manager/utils/formatLanPairing.mjs +32 -0
  257. package/manager/utils/formatLanPairing.test.mjs +40 -0
  258. package/manager/utils/getLanAddress.mjs +83 -0
  259. package/manager/utils/getLanAddress.test.mjs +70 -0
  260. package/manager/utils/importFresh.test.mjs +1 -0
  261. package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
  262. package/manager/utils/pluginTypeCache.mjs +100 -0
  263. package/manager/utils/pluginTypeCache.test.mjs +141 -0
  264. package/manager/utils/pruneRecordings.test.mjs +1 -0
  265. package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
  266. package/manager/utils/publishBuildDirectory.test.mjs +6 -7
  267. package/manager/utils/readBasePath.test.mjs +1 -0
  268. package/manager/utils/readManagerVersion.test.mjs +1 -0
  269. package/manager/utils/readPluginDefinitions.mjs +6 -6
  270. package/manager/utils/renderTerminalQr.mjs +54 -0
  271. package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
  272. package/manager/utils/setupWatcher.mjs +19 -4
  273. package/manager/utils/startRecordingPruner.test.mjs +24 -8
  274. package/manager/utils/waitForChildExit.test.mjs +2 -2
  275. package/manager/utils/writeBuildStatus.test.mjs +1 -0
  276. package/manager/watchers/envWatcher.mjs +3 -0
  277. package/manager/watchers/envWatcher.test.mjs +19 -7
  278. package/manager/watchers/listServerPluginFiles.mjs +188 -0
  279. package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
  280. package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
  281. package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
  282. package/manager/watchers/pluginSourceWatcher.mjs +45 -17
  283. package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
  284. package/manager/watchers/resolveFile.mjs +46 -0
  285. package/manager/watchers/resolveFile.test.mjs +67 -0
  286. package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
  287. package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
  288. package/manager/watchers/restartRequestWatcher.mjs +7 -4
  289. package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
  290. package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
  291. package/package.json +50 -49
  292. package/package.original.json +50 -49
  293. package/src/app.js +83 -85
  294. package/src/html/renderDevPage.test.mjs +1 -0
  295. package/src/lib/getPathSegments.js +16 -1
  296. package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
  297. package/src/lib/isTabAnswer.js +32 -0
  298. package/src/lib/isTabChannelCaller.js +35 -0
  299. package/src/middleware/apiContext.js +4 -2
  300. package/src/middleware/createSameOriginGuard.test.mjs +1 -0
  301. package/src/middleware/errorHandler.js +33 -45
  302. package/src/middleware/errorHandler.test.mjs +10 -10
  303. package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
  304. package/src/middleware/localDevToolsOnly.js +13 -1
  305. package/src/middleware/localDevToolsOnly.test.mjs +36 -2
  306. package/src/middleware/noStore.test.mjs +1 -0
  307. package/src/middleware/staleFlag.test.mjs +1 -0
  308. package/src/middleware/stampCaller.test.mjs +1 -0
  309. package/src/routes/agentBearer.test.mjs +183 -0
  310. package/src/routes/auth.test.mjs +10 -10
  311. package/src/routes/clientError.js +21 -4
  312. package/src/routes/clientError.test.mjs +127 -0
  313. package/src/routes/devInspect.js +6 -51
  314. package/src/routes/devInspect.test.mjs +128 -3
  315. package/src/routes/devRecording.js +6 -17
  316. package/src/routes/devRecording.test.mjs +54 -3
  317. package/src/routes/docs/buildStatus.test.mjs +6 -6
  318. package/src/routes/docs/events.test.mjs +4 -4
  319. package/src/routes/docs/find.js +3 -3
  320. package/src/routes/docs/journey.test.mjs +8 -8
  321. package/src/routes/docs/journeyRefusals.test.mjs +9 -9
  322. package/src/routes/docs/loadDocsRoutes.js +70 -0
  323. package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
  324. package/src/routes/docs/mcp.test.mjs +5 -5
  325. package/src/routes/docs/mutants.js +7 -0
  326. package/src/routes/docs/mutants.test.mjs +20 -6
  327. package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
  328. package/src/routes/docs/parseUserParam.test.mjs +1 -0
  329. package/src/routes/docs/restart.test.mjs +1 -0
  330. package/src/routes/endpoints.js +24 -0
  331. package/src/routes/endpointsLink.test.mjs +111 -0
  332. package/src/routes/endpointsTextAnswer.test.mjs +8 -8
  333. package/src/routes/jitPage.js +13 -1
  334. package/src/routes/jitPage.test.mjs +36 -11
  335. package/src/routes/mcp.js +6 -0
  336. package/src/routes/mcp.test.mjs +23 -8
  337. package/src/routes/mcpMemberToken.test.mjs +8 -8
  338. package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
  339. package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
  340. package/src/routes/mobileRoutes.test.mjs +223 -0
  341. package/src/routes/mobileSignIn.js +58 -0
  342. package/src/routes/mobileSignIn.test.mjs +59 -0
  343. package/src/routes/mobileSignInCallback.js +34 -0
  344. package/src/routes/mobileSignInCallback.test.mjs +51 -0
  345. package/src/routes/mountDevPageRoutes.js +10 -2
  346. package/src/routes/mountDevPageRoutes.test.mjs +25 -1
  347. package/src/routes/mountMobileWellKnown.js +35 -0
  348. package/src/routes/mountMobileWellKnown.test.mjs +79 -0
  349. package/src/routes/mountOauthDiscovery.test.mjs +5 -5
  350. package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
  351. package/src/routes/reload.js +101 -20
  352. package/src/routes/reload.test.mjs +153 -0
  353. package/src/routes/request.js +1 -22
  354. package/src/routes/request.test.mjs +7 -24
  355. package/src/routes/requestBody.test.mjs +14 -27
  356. package/src/routes/websocket.test.mjs +2 -2
  357. package/src/routes/wellKnownFallback.test.mjs +2 -2
  358. package/src/websocket/devWebSocket.test.mjs +12 -12
  359. package/vite.config.js +13 -1
  360. package/client/feedback/FeedbackMount.jsx +0 -83
  361. package/client/feedback/FeedbackOverlay.jsx +0 -904
  362. package/client/feedback/captureTabScreenshot.js +0 -84
  363. package/client/feedback/copyToClipboard.js +0 -45
  364. package/client/feedback/drawAnnotationsSvg.js +0 -119
  365. package/client/feedback/feedbackStyles.js +0 -304
  366. package/client/feedback/pinResponsiveImages.js +0 -59
  367. package/client/feedback/sendFeedback.js +0 -39
  368. package/client/feedback/useFeedbackToggle.js +0 -70
  369. package/client/recorder/buildEngineRecord.js +0 -37
  370. package/client/recorder/buildInteractionRecord.js +0 -64
  371. package/client/recorder/buildTraceEvent.js +0 -57
  372. package/client/recorder/buildTraceEvent.test.mjs +0 -81
  373. package/client/recorder/chunkRecords.js +0 -69
  374. package/client/recorder/chunkRecords.test.mjs +0 -59
  375. package/client/recorder/collectEventEndpoints.js +0 -40
  376. package/client/recorder/collectEventRequests.js +0 -39
  377. package/client/recorder/createPairingBuffer.js +0 -187
  378. package/client/recorder/createPasswordRedactor.js +0 -84
  379. package/client/recorder/createRecordBatcher.js +0 -54
  380. package/client/recorder/createRecordBatcher.test.mjs +0 -76
  381. package/client/recorder/createRecordingSession.js +0 -61
  382. package/client/recorder/createRecordingSession.test.mjs +0 -72
  383. package/client/recorder/diffStateWrites.js +0 -77
  384. package/client/recorder/diffStateWrites.test.mjs +0 -66
  385. package/client/recorder/isEventCall.js +0 -30
  386. package/client/recorder/jsonType.js +0 -39
  387. package/client/recorder/sendRecords.js +0 -40
  388. package/lib/docs/captureAnnotatedScreenshot.js +0 -99
  389. package/lib/docs/checkpointPaths.js +0 -91
  390. package/lib/docs/checkpointStore.js +0 -243
  391. package/lib/docs/checkpointToMocks.js +0 -65
  392. package/lib/docs/configCheckpoints.test.mjs +0 -156
  393. package/lib/docs/createConfigCheckpoint.js +0 -92
  394. package/lib/docs/devMockRegistry.js +0 -68
  395. package/lib/docs/enrichFeedback.js +0 -71
  396. package/lib/docs/evalOperator.js +0 -49
  397. package/lib/docs/evalOperator.test.mjs +0 -157
  398. package/lib/docs/evalOperatorHeadless.js +0 -159
  399. package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
  400. package/lib/docs/evalOperatorInTab.js +0 -49
  401. package/lib/docs/formatFeedback.js +0 -142
  402. package/lib/docs/formatFeedback.test.mjs +0 -252
  403. package/lib/docs/getPluginDoc.js +0 -53
  404. package/lib/docs/listConfigCheckpoints.js +0 -55
  405. package/lib/docs/loadState.js +0 -220
  406. package/lib/docs/revertConfigCheckpoint.js +0 -73
  407. package/lib/docs/saveAnnotatedScreenshot.js +0 -43
  408. package/lib/docs/scaffoldPage.js +0 -77
  409. package/lib/docs/scaffoldPage.test.mjs +0 -97
  410. package/lib/docs/snapshotState.js +0 -67
  411. package/lib/docs/stateCheckpoints.test.mjs +0 -443
  412. package/manager/watchers/listServerSidePackages.mjs +0 -47
  413. package/manager/watchers/listServerSidePackages.test.mjs +0 -38
  414. package/src/routes/docs/checkpointsCreate.js +0 -28
  415. package/src/routes/docs/evalOperator.js +0 -70
  416. package/src/routes/docs/inspectState.js +0 -59
  417. package/src/routes/docs/loadState.js +0 -51
  418. package/src/routes/docs/pluginDoc.js +0 -33
  419. package/src/routes/docs/plugins.js +0 -23
  420. package/src/routes/docs/runEndpoint.js +0 -54
  421. package/src/routes/docs/runEndpoint.test.mjs +0 -165
  422. package/src/routes/docs/runRequest.js +0 -53
  423. package/src/routes/docs/runRequest.test.mjs +0 -92
  424. package/src/routes/docs/schema.js +0 -37
  425. package/src/routes/docs/screenshot.js +0 -120
  426. package/src/routes/docs/screenshot.test.mjs +0 -117
  427. package/src/routes/docs/search.js +0 -40
  428. package/src/routes/docs/snapshotState.js +0 -50
  429. package/src/routes/docs/stateCheckpointsList.js +0 -26
  430. package/src/routes/docs/types.js +0 -33
  431. package/src/routes/feedback.js +0 -107
  432. package/src/routes/feedback.test.mjs +0 -204
@@ -1,187 +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 { pairTraceEvents, type } from '@lowdefy/helpers';
18
-
19
- import buildEngineRecord from './buildEngineRecord.js';
20
- import buildInteractionRecord from './buildInteractionRecord.js';
21
- import buildTraceEvent from './buildTraceEvent.js';
22
-
23
- // How long an interaction waits for the events it caused. The pairing rule
24
- // decides by when an event's actions started (within its debounce plus 1 s of
25
- // the interaction), but the trace hook reports an event when its actions
26
- // finish, and a click's Request can take seconds. Holding each interaction
27
- // this long lets a slow event, and a `bubble: true` sibling, still join it.
28
- const HOLD_MS = 10000;
29
- const PAIRED_KINDS = ['click', 'change', 'key'];
30
-
31
- function hasTargetIdentity(target) {
32
- return (
33
- !type.isNone(target) &&
34
- ((type.isString(target.block_id) && target.block_id !== '') ||
35
- (type.isString(target.text) && target.text !== ''))
36
- );
37
- }
38
-
39
- // Turns DOM interactions and engine trace payloads into finished v1 trace
40
- // records, paired in the tab with the shared pairing rule. Each record carries
41
- // the build getBuild() named when its interaction was captured or its event
42
- // arrived, never when its hold closes: a hold can outlast a config reload.
43
- //
44
- // - addInteraction({ t, kind, element, target, pageId, pathParams, value, key, url, build }):
45
- // pageview and back are recorded at once; click, change and key wait until
46
- // their hold ends, collecting the events the rule pairs with them. `build`
47
- // is given only by a caller that knows it better than getBuild() does now
48
- // (a pageview, recorded once its page config has rendered).
49
- // - addEvent(payload, { urlAfter }): the event is built into a trace event
50
- // now (its state writes are read against the state as it is now), then
51
- // paired with the latest open interaction that could have caused it, or
52
- // recorded at once as kind engine. Every interaction that could cause an
53
- // event happened before the event started, so it is already in the buffer.
54
- // - flushAll(): ends every hold now (pagehide, config reload, headless flush).
55
- function createPairingBuffer({
56
- onRecord,
57
- now = Date.now,
58
- getSession,
59
- getRoles = () => [],
60
- getBuild = () => null,
61
- redactor,
62
- }) {
63
- let open = [];
64
- let nextId = 1;
65
- let timer = null;
66
-
67
- function emit(record) {
68
- onRecord(redactor === undefined ? record : redactor.redact(record));
69
- }
70
-
71
- function finalise(interaction) {
72
- let paired = [];
73
- if (interaction.events.length > 0) {
74
- const { pairs } = pairTraceEvents({
75
- interactions: [interaction],
76
- events: interaction.events,
77
- });
78
- const order = pairs[0]?.eventIds ?? interaction.events.map((event) => event.id);
79
- paired = order.map((id) => interaction.events.find((event) => event.id === id).traceEvent);
80
- }
81
- emit(
82
- buildInteractionRecord({
83
- interaction,
84
- paired,
85
- session: getSession(),
86
- roles: getRoles(),
87
- })
88
- );
89
- }
90
-
91
- function schedule() {
92
- if (timer !== null) {
93
- clearTimeout(timer);
94
- timer = null;
95
- }
96
- if (open.length === 0) return;
97
- const next = Math.min(...open.map((interaction) => interaction.closesAt));
98
- timer = setTimeout(closeDue, Math.max(0, next - now()));
99
- }
100
-
101
- function closeDue() {
102
- timer = null;
103
- const time = now();
104
- const due = open.filter((interaction) => interaction.closesAt <= time);
105
- open = open.filter((interaction) => interaction.closesAt > time);
106
- due.forEach(finalise);
107
- schedule();
108
- }
109
-
110
- function addInteraction({
111
- t,
112
- kind,
113
- element,
114
- target,
115
- pageId,
116
- pathParams,
117
- value,
118
- key,
119
- url,
120
- build: named,
121
- }) {
122
- const time = t ?? now();
123
- const build = type.isUndefined(named) ? getBuild() : named;
124
- if (!PAIRED_KINDS.includes(kind)) {
125
- emit(
126
- buildInteractionRecord({
127
- interaction: { t: time, kind, pageId, pathParams, url, target: null, build },
128
- session: getSession(),
129
- roles: getRoles(),
130
- })
131
- );
132
- return;
133
- }
134
- // A click or change the runner could not target (no block, no text) can
135
- // be neither replayed nor paired.
136
- if (kind !== 'key' && !hasTargetIdentity(target)) return;
137
- if (redactor !== undefined && !type.isNone(element) && redactor.isPassword(element)) {
138
- redactor.remember(target?.block_id);
139
- }
140
- open.push({
141
- id: `i${nextId++}`,
142
- t: time,
143
- kind,
144
- pageId,
145
- value,
146
- key,
147
- target: kind === 'key' && !hasTargetIdentity(target) ? null : target,
148
- blockIds: target?.block_ids ?? [],
149
- build,
150
- events: [],
151
- closesAt: time + HOLD_MS,
152
- });
153
- schedule();
154
- }
155
-
156
- function addEvent(payload, { urlAfter } = {}) {
157
- const engineEvent = {
158
- id: `e${nextId++}`,
159
- blockId: payload.blockId,
160
- eventName: payload.eventName,
161
- startTimestamp: new Date(payload.record?.startTimestamp ?? now()).getTime(),
162
- debounceMs: payload.debounceMs ?? 0,
163
- scope: payload.scope,
164
- pageId: payload.pageId,
165
- build: getBuild(),
166
- traceEvent: buildTraceEvent({ payload, urlAfter }),
167
- };
168
- const { pairs } = pairTraceEvents({ interactions: open, events: [engineEvent] });
169
- if (pairs.length === 0) {
170
- emit(buildEngineRecord({ engineEvent, session: getSession(), roles: getRoles() }));
171
- return;
172
- }
173
- open.find((interaction) => interaction.id === pairs[0].interactionId).events.push(engineEvent);
174
- }
175
-
176
- function flushAll() {
177
- const all = open;
178
- open = [];
179
- all.forEach(finalise);
180
- schedule();
181
- }
182
-
183
- return { addEvent, addInteraction, flushAll };
184
- }
185
-
186
- export { HOLD_MS };
187
- export default createPairingBuffer;
@@ -1,84 +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 { journeyTargetSelectors } from '@lowdefy/helpers';
18
-
19
- const { blockWrapperPrefix } = journeyTargetSelectors;
20
-
21
- function isPasswordInput(element) {
22
- return (
23
- typeof element?.tagName === 'string' &&
24
- element.tagName.toLowerCase() === 'input' &&
25
- element.type === 'password'
26
- );
27
- }
28
-
29
- // A write holds a password block's value when its path is the block's id, or
30
- // an ancestor of it: arrays are diffed as leaves, so a password block inside a
31
- // List is written as the whole list array.
32
- function holdsPassword(path, passwordBlocks) {
33
- if (passwordBlocks.has(path)) return true;
34
- return [...passwordBlocks].some((blockId) => blockId.startsWith(`${path}.`));
35
- }
36
-
37
- function redactWrites(event, passwordBlocks) {
38
- if (event === null || event === undefined) return;
39
- (event.state_writes ?? []).forEach((write) => {
40
- if (holdsPassword(write.path, passwordBlocks)) {
41
- write.value = null;
42
- write.redacted = true;
43
- }
44
- });
45
- }
46
-
47
- // Password inputs are never recorded. A block is a password block when the
48
- // interaction's element, or its block's `<blockId>_input` element, is an
49
- // `<input type="password">`. It is remembered for the rest of the tab session,
50
- // so its value is redacted from every later change and from every state write
51
- // to its path, a later SetState echo included. It is remembered from any
52
- // interaction with the block, a click included: the visibility toggle turns
53
- // the input into `type="text"`, and a click on it comes before the typing.
54
- function createPasswordRedactor() {
55
- const passwordBlocks = new Set();
56
-
57
- function isPassword(element) {
58
- if (isPasswordInput(element)) return true;
59
- const wrapper = element?.closest?.(`[id^="${blockWrapperPrefix}"]`);
60
- if (!wrapper) return false;
61
- const blockId = wrapper.id.slice(blockWrapperPrefix.length);
62
- return isPasswordInput(element.ownerDocument?.getElementById(`${blockId}_input`));
63
- }
64
-
65
- function remember(blockId) {
66
- if (typeof blockId === 'string' && blockId !== '') {
67
- passwordBlocks.add(blockId);
68
- }
69
- }
70
-
71
- function redact(record) {
72
- if (record.kind === 'change' && passwordBlocks.has(record.target?.block_id)) {
73
- record.value = null;
74
- record.redacted = true;
75
- }
76
- redactWrites(record.event, passwordBlocks);
77
- (record.also ?? []).forEach((event) => redactWrites(event, passwordBlocks));
78
- return record;
79
- }
80
-
81
- return { isPassword, redact, remember };
82
- }
83
-
84
- export default createPasswordRedactor;
@@ -1,54 +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
- const BATCH_SIZE = 20;
18
- const BATCH_DELAY_MS = 5000;
19
-
20
- // Collects finished records and sends them: at 20 records, 5 s after the
21
- // first record of a batch, or when flush() is called (pagehide, the stream's
22
- // reload event, a headless run's flush). flush() resolves when every send it
23
- // started has settled.
24
- function createRecordBatcher({ send }) {
25
- let batch = [];
26
- let timer = null;
27
-
28
- function flush() {
29
- if (timer !== null) {
30
- clearTimeout(timer);
31
- timer = null;
32
- }
33
- if (batch.length === 0) return Promise.resolve();
34
- const records = batch;
35
- batch = [];
36
- return Promise.resolve(send(records)).catch(() => {});
37
- }
38
-
39
- function add(record) {
40
- batch.push(record);
41
- if (batch.length >= BATCH_SIZE) {
42
- flush();
43
- return;
44
- }
45
- if (timer === null) {
46
- timer = setTimeout(flush, BATCH_DELAY_MS);
47
- }
48
- }
49
-
50
- return { add, flush };
51
- }
52
-
53
- export { BATCH_DELAY_MS, BATCH_SIZE };
54
- export default createRecordBatcher;
@@ -1,76 +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 { jest } from '@jest/globals';
18
-
19
- import createRecordBatcher from './createRecordBatcher.js';
20
-
21
- beforeEach(() => {
22
- jest.useFakeTimers({ doNotFake: ['performance'] });
23
- });
24
-
25
- afterEach(() => {
26
- jest.useRealTimers();
27
- });
28
-
29
- test('createRecordBatcher sends at 20 records', () => {
30
- const send = jest.fn();
31
- const batcher = createRecordBatcher({ send });
32
- for (let index = 0; index < 19; index += 1) batcher.add({ index });
33
- expect(send).not.toHaveBeenCalled();
34
- batcher.add({ index: 19 });
35
- expect(send).toHaveBeenCalledTimes(1);
36
- expect(send.mock.calls[0][0]).toHaveLength(20);
37
- });
38
-
39
- test('createRecordBatcher sends 5 s after the first record of a batch', () => {
40
- const send = jest.fn();
41
- const batcher = createRecordBatcher({ send });
42
- batcher.add({ index: 0 });
43
- jest.advanceTimersByTime(4000);
44
- batcher.add({ index: 1 });
45
- jest.advanceTimersByTime(999);
46
- expect(send).not.toHaveBeenCalled();
47
- jest.advanceTimersByTime(1);
48
- expect(send).toHaveBeenCalledWith([{ index: 0 }, { index: 1 }]);
49
- });
50
-
51
- test('createRecordBatcher flush resolves when the send settles, and swallows a failed send', async () => {
52
- let settle;
53
- const send = jest.fn(
54
- () =>
55
- new Promise((resolve, reject) => {
56
- settle = reject;
57
- })
58
- );
59
- const batcher = createRecordBatcher({ send });
60
- batcher.add({ index: 0 });
61
- let resolved = false;
62
- const flushed = batcher.flush().then(() => {
63
- resolved = true;
64
- });
65
- await Promise.resolve();
66
- expect(resolved).toBe(false);
67
- settle(new Error('offline'));
68
- await flushed;
69
- expect(resolved).toBe(true);
70
- });
71
-
72
- test('createRecordBatcher flush with nothing batched sends nothing', async () => {
73
- const send = jest.fn();
74
- await createRecordBatcher({ send }).flush();
75
- expect(send).not.toHaveBeenCalled();
76
- });
@@ -1,61 +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 { createTraceId, isTraceId } from '@lowdefy/helpers';
18
-
19
- const STORAGE_KEY = 'lowdefy_dev_recording';
20
- const IDLE_MS = 10 * 60 * 1000;
21
-
22
- function readStored(storage) {
23
- try {
24
- const stored = JSON.parse(storage.getItem(STORAGE_KEY));
25
- if (isTraceId(stored?.id) && typeof stored.lastAt === 'number') return stored;
26
- } catch {
27
- // Blocked or malformed storage: start an unremembered session.
28
- }
29
- return null;
30
- }
31
-
32
- function writeStored(storage, value) {
33
- try {
34
- storage.setItem(STORAGE_KEY, JSON.stringify(value));
35
- } catch {
36
- // A browser that blocks site data records under an unremembered session.
37
- }
38
- }
39
-
40
- // The tab's recording session. sessionStorage lives as long as the tab, so a
41
- // session survives the reload a dev server restart triggers; a gap of more
42
- // than 10 minutes starts a new one.
43
- function createRecordingSession({ storage, now = Date.now }) {
44
- let current = null;
45
-
46
- function getId() {
47
- const time = now();
48
- const stored = readStored(storage) ?? current;
49
- const session =
50
- stored !== null && time - stored.lastAt <= IDLE_MS
51
- ? { id: stored.id, lastAt: time }
52
- : { id: createTraceId({ now: time }), lastAt: time };
53
- current = session;
54
- writeStored(storage, session);
55
- return session.id;
56
- }
57
-
58
- return { getId };
59
- }
60
-
61
- export default createRecordingSession;
@@ -1,72 +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 createRecordingSession from './createRecordingSession.js';
18
-
19
- const START = Date.parse('2026-10-03T14:03:11.000Z');
20
-
21
- function createStorage() {
22
- const values = new Map();
23
- return {
24
- getItem: (key) => (values.has(key) ? values.get(key) : null),
25
- setItem: (key, value) => values.set(key, value),
26
- };
27
- }
28
-
29
- test('createRecordingSession keeps one session id while the tab is active', () => {
30
- let time = START;
31
- const session = createRecordingSession({ storage: createStorage(), now: () => time });
32
- const id = session.getId();
33
- expect(id).toMatch(/^20261003T140311Z-[a-z0-9]{6}$/);
34
- time += 9 * 60 * 1000;
35
- expect(session.getId()).toBe(id);
36
- time += 9 * 60 * 1000;
37
- expect(session.getId()).toBe(id);
38
- });
39
-
40
- test('createRecordingSession starts a new session after 10 minutes idle', () => {
41
- let time = START;
42
- const session = createRecordingSession({ storage: createStorage(), now: () => time });
43
- const id = session.getId();
44
- time += 10 * 60 * 1000 + 1;
45
- const next = session.getId();
46
- expect(next).not.toBe(id);
47
- expect(next).toMatch(/^20261003T141311Z-/);
48
- });
49
-
50
- test('createRecordingSession survives a reload through sessionStorage', () => {
51
- const storage = createStorage();
52
- let time = START;
53
- const id = createRecordingSession({ storage, now: () => time }).getId();
54
- time += 2000;
55
- expect(createRecordingSession({ storage, now: () => time }).getId()).toBe(id);
56
- });
57
-
58
- test('createRecordingSession records under an unremembered session when storage throws', () => {
59
- const storage = {
60
- getItem: () => {
61
- throw new Error('SecurityError');
62
- },
63
- setItem: () => {
64
- throw new Error('SecurityError');
65
- },
66
- };
67
- let time = START;
68
- const session = createRecordingSession({ storage, now: () => time });
69
- const id = session.getId();
70
- time += 1000;
71
- expect(session.getId()).toBe(id);
72
- });
@@ -1,77 +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
- import jsonType from './jsonType.js';
20
- import toJsonSafe from './toJsonSafe.js';
21
-
22
- // Objects are walked to their leaves so a write to one field of a form object
23
- // reports that field's path; arrays are leaves, because a journey expectation
24
- // on "rows.3.name" locks an ordering the app never promised.
25
- // `seen` closes the cycle: page state is app data and an app is free to put a
26
- // self-referencing object in it, which the walk would otherwise follow forever.
27
- function collectLeaves({ into, path, seen = new WeakSet(), value }) {
28
- if (type.isObject(value) && Object.keys(value).length > 0 && !seen.has(value)) {
29
- seen.add(value);
30
- Object.keys(value).forEach((key) => {
31
- collectLeaves({ into, path: path === '' ? key : `${path}.${key}`, seen, value: value[key] });
32
- });
33
- return into;
34
- }
35
- into.set(path, value);
36
- return into;
37
- }
38
-
39
- function isSameValue(a, b) {
40
- if (type.isDate(a) && type.isDate(b)) {
41
- return a.getTime() === b.getTime();
42
- }
43
- try {
44
- return JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
45
- } catch {
46
- // A value that cannot be serialized cannot be compared; report it as written.
47
- return false;
48
- }
49
- }
50
-
51
- // The paths an action chain wrote, as the difference between the state before
52
- // the chain ran and the state after. `values` is the dev-only branch: in
53
- // production the recorder never asks for it, so a value cannot reach the wire.
54
- function diffStateWrites({ after, before, values = false }) {
55
- const beforeLeaves = collectLeaves({ into: new Map(), path: '', value: before ?? {} });
56
- const afterLeaves = collectLeaves({ into: new Map(), path: '', value: after ?? {} });
57
- const writes = [];
58
-
59
- afterLeaves.forEach((value, path) => {
60
- if (path === '') return;
61
- if (beforeLeaves.has(path) && isSameValue(beforeLeaves.get(path), value)) return;
62
- writes.push(
63
- values
64
- ? { path, type: jsonType(value), value: toJsonSafe(value) }
65
- : { path, type: jsonType(value) }
66
- );
67
- });
68
-
69
- beforeLeaves.forEach((_, path) => {
70
- if (path === '' || afterLeaves.has(path)) return;
71
- writes.push({ path, type: 'undefined' });
72
- });
73
-
74
- return writes;
75
- }
76
-
77
- export default diffStateWrites;
@@ -1,66 +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 diffStateWrites from './diffStateWrites.js';
18
-
19
- test('diffStateWrites reports the path and JSON type of each changed leaf', () => {
20
- expect(diffStateWrites({ after: { a: 'x', n: 2, ok: true }, before: { a: 'x', n: 1 } })).toEqual([
21
- { path: 'n', type: 'number' },
22
- { path: 'ok', type: 'boolean' },
23
- ]);
24
- });
25
-
26
- test('diffStateWrites walks into objects and treats arrays as leaves', () => {
27
- expect(diffStateWrites({ after: { form: { name: 'a' }, rows: [1, 2] }, before: {} })).toEqual([
28
- { path: 'form.name', type: 'string' },
29
- { path: 'rows', type: 'array' },
30
- ]);
31
- });
32
-
33
- test('diffStateWrites reports a removed path as undefined', () => {
34
- expect(diffStateWrites({ after: {}, before: { a: 1 } })).toEqual([
35
- { path: 'a', type: 'undefined' },
36
- ]);
37
- });
38
-
39
- test('diffStateWrites omits values unless values is true', () => {
40
- expect(diffStateWrites({ after: { a: 'secret' }, before: {} })).toEqual([
41
- { path: 'a', type: 'string' },
42
- ]);
43
- expect(diffStateWrites({ after: { a: 'secret' }, before: {}, values: true })).toEqual([
44
- { path: 'a', type: 'string', value: 'secret' },
45
- ]);
46
- });
47
-
48
- test('diffStateWrites names a Date write as a date and does not throw on a cyclic value', () => {
49
- const cyclic = {};
50
- cyclic.self = cyclic;
51
- const writes = diffStateWrites({
52
- after: { when: new Date('2026-01-02T03:04:05.000Z'), loop: cyclic },
53
- before: {},
54
- values: true,
55
- });
56
- expect(writes).toContainEqual({
57
- path: 'when',
58
- type: 'date',
59
- value: '2026-01-02T03:04:05.000Z',
60
- });
61
- expect(writes.find(({ path }) => path === 'loop.self')).toEqual({
62
- path: 'loop.self',
63
- type: 'object',
64
- value: null,
65
- });
66
- });