@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.
- package/client/Inspector.jsx +24 -75
- package/client/Page.jsx +8 -0
- package/client/Routing.jsx +0 -2
- package/client/clientBuildImports.test.mjs +5 -3
- package/client/devStreamConnections.test.mjs +1 -0
- package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
- package/client/openInEditor/OpenInEditorListener.jsx +36 -29
- package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
- package/client/{feedback → openInEditor}/elementInspect.js +9 -44
- package/client/openInEditor/findBlockLocation.js +2 -2
- package/client/openInEditor/openInEditorStyles.js +56 -0
- package/client/recorder/createPairingBuffer.test.mjs +27 -9
- package/client/recorder/createRecorder.js +11 -7
- package/client/recorder/createRecorder.test.mjs +9 -9
- package/client/recorder/isPasswordElement.js +41 -0
- package/client/recorder/keyChord.test.mjs +1 -0
- package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
- package/lib/client/auth/AuthConfigured.jsx +75 -48
- package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
- package/lib/client/auth/authTemplateSync.test.mjs +1 -0
- package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
- package/lib/client/auth/sessionCaller.js +56 -0
- package/lib/client/auth/sessionCaller.test.mjs +78 -0
- package/lib/client/getPagePath.test.mjs +1 -0
- package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
- package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
- package/lib/client/utils/usePageConfig.test.mjs +15 -15
- package/lib/configTree/buildConfigTree.test.mjs +6 -8
- package/lib/configTree/collectConfigText.test.mjs +1 -0
- package/lib/configTree/runConfigTreeBuild.mjs +2 -1
- package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
- package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
- package/lib/docs/addNestedEndpoints.test.mjs +1 -0
- package/lib/docs/checkAgentFiles.test.mjs +1 -0
- package/lib/docs/checkStepReferences.test.mjs +3 -3
- package/lib/docs/clientErrorStore.test.mjs +4 -4
- package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
- package/lib/docs/createDocsMcpServer.js +195 -138
- package/lib/docs/createDocsMcpServer.test.mjs +331 -25
- package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
- package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
- package/lib/docs/createJourneyActors.test.mjs +4 -4
- package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
- package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
- package/lib/docs/dataSets/getDataStore.js +11 -3
- package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
- package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
- package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
- package/lib/docs/dataSets/openDataSession.js +4 -2
- package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
- package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
- package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
- package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
- package/lib/docs/devEventBus.js +7 -2
- package/lib/docs/devEventBus.test.mjs +12 -10
- package/lib/docs/devToolDefinitions.js +87 -135
- package/lib/docs/device/buildDeviceCommand.js +103 -0
- package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
- package/lib/docs/device/captureDevice.js +85 -0
- package/lib/docs/device/checkShownPage.js +56 -0
- package/lib/docs/device/createFakePhoneTab.mjs +77 -0
- package/lib/docs/device/deviceAction.js +74 -0
- package/lib/docs/device/deviceTools.test.mjs +604 -0
- package/lib/docs/device/findDeviceTab.js +50 -0
- package/lib/docs/device/findDeviceTarget.js +73 -0
- package/lib/docs/device/injectDevice.js +160 -0
- package/lib/docs/device/listDevices.js +100 -0
- package/lib/docs/device/listDevices.test.mjs +105 -0
- package/lib/docs/device/runDeviceJourney.js +68 -0
- package/lib/docs/device/runDeviceSteps.js +164 -0
- package/lib/docs/device/screenshotDevice.js +68 -0
- package/lib/docs/device/sendDeviceStep.js +52 -0
- package/lib/docs/device/startDevice.js +150 -0
- package/lib/docs/docs.test.mjs +44 -28
- package/lib/docs/docsIndex.test.mjs +1 -0
- package/lib/docs/findConfig.js +3 -4
- package/lib/docs/findPageBlock.js +35 -0
- package/lib/docs/findPageBlock.test.mjs +45 -0
- package/lib/docs/fitResponse.js +18 -17
- package/lib/docs/fitResponse.test.mjs +18 -0
- package/lib/docs/getBrowser.js +3 -3
- package/lib/docs/getBrowser.test.mjs +32 -16
- package/lib/docs/getBuildId.test.mjs +1 -0
- package/lib/docs/getBuildStatus.test.mjs +11 -11
- package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
- package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
- package/lib/docs/getHazards.js +4 -1
- package/lib/docs/getHazards.test.mjs +9 -7
- package/lib/docs/getOverview.js +20 -42
- package/lib/docs/getOverviewBasePath.test.mjs +1 -0
- package/lib/docs/getStaleStatus.test.mjs +1 -0
- package/lib/docs/inspectState.js +78 -3
- package/lib/docs/inspectState.test.mjs +61 -9
- package/lib/docs/inspectStateFromTab.js +38 -6
- package/lib/docs/inspectStateFromTab.test.mjs +79 -0
- package/lib/docs/inspectStateHeadless.js +98 -34
- package/lib/docs/inspectStateHeadless.test.mjs +17 -5
- package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
- package/lib/docs/installHeadlessShell.js +5 -2
- package/lib/docs/installHeadlessShell.test.mjs +8 -5
- package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
- package/lib/docs/isDeepEqual.js +37 -0
- package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
- package/lib/docs/isPageReady.test.mjs +1 -0
- package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
- package/lib/docs/journeyRunRecording.test.mjs +1 -0
- package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
- package/lib/docs/launchBrowser.test.mjs +8 -8
- package/lib/docs/listTypes.js +58 -8
- package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
- package/lib/docs/matchJourneyRoute.test.mjs +1 -0
- package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
- package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
- package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
- package/lib/docs/observe/withAppErrors.test.mjs +1 -0
- package/lib/docs/openJourneyEmail.test.mjs +6 -6
- package/lib/docs/pageBuildStatus.test.mjs +6 -6
- package/lib/docs/pollTab.js +100 -0
- package/lib/docs/pollTab.test.mjs +64 -0
- package/lib/docs/rails/authEngineActions.test.mjs +1 -0
- package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
- package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
- package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
- package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
- package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
- package/lib/docs/readJourneySession.js +1 -1
- package/lib/docs/reportDevToolFault.js +29 -0
- package/lib/docs/reportDevToolFault.test.mjs +34 -0
- package/lib/docs/requestRestart.test.mjs +1 -0
- package/lib/docs/resolvePageInstance.test.mjs +1 -0
- package/lib/docs/resolveSource.js +2 -2
- package/lib/docs/resolveSource.test.mjs +6 -6
- package/lib/docs/reviewPageBuilds.test.mjs +2 -2
- package/lib/docs/runCheck.test.mjs +3 -3
- package/lib/docs/runCheckChild.js +2 -1
- package/lib/docs/runEndpoint.js +23 -10
- package/lib/docs/runEndpoint.test.mjs +42 -37
- package/lib/docs/runErrorBuffers.test.mjs +1 -0
- package/lib/docs/runJourney.js +21 -1
- package/lib/docs/runJourney.test.mjs +119 -99
- package/lib/docs/runJourneyDataSet.test.mjs +25 -25
- package/lib/docs/runJourneySteps.js +8 -29
- package/lib/docs/runRequest.js +6 -6
- package/lib/docs/runRequest.test.mjs +22 -22
- package/lib/docs/screenshotPage.js +6 -7
- package/lib/docs/screenshotPage.test.mjs +46 -46
- package/lib/docs/screenshotPageClip.test.mjs +10 -10
- package/lib/docs/searchDocs.test.mjs +1 -0
- package/lib/docs/searchIcons.test.mjs +5 -5
- package/lib/docs/selectFinalState.test.mjs +1 -0
- package/lib/docs/serverErrorStore.test.mjs +4 -4
- package/lib/docs/setupTestFixtures.mjs +25 -0
- package/lib/docs/splitSearchTerms.test.mjs +1 -0
- package/lib/docs/tabAvailable.js +1 -1
- package/lib/docs/tabChannel.js +90 -14
- package/lib/docs/tabChannel.test.mjs +40 -15
- package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
- package/lib/docs/validateStateSelection.test.mjs +1 -0
- package/lib/docs/validateViewport.test.mjs +1 -0
- package/lib/docs/waitForBuild.test.mjs +1 -0
- package/lib/docs/withBrowserSlot.test.mjs +5 -5
- package/lib/server/applyDataSetRedirect.test.mjs +2 -2
- package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
- package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
- package/lib/server/auth/getHeadlessUser.js +6 -0
- package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
- package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
- package/lib/server/contextMapBudget.test.mjs +3 -3
- package/lib/server/continueJitKeys.test.mjs +1 -0
- package/lib/server/createLowdefyContext.js +5 -1
- package/lib/server/createLowdefyContext.test.mjs +32 -32
- package/lib/server/getClientAddress.test.mjs +2 -2
- package/lib/server/getPageJitEnrichment.test.mjs +1 -0
- package/lib/server/importAppCode.test.mjs +2 -2
- package/lib/server/jitPageBuilder.js +27 -3
- package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
- package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
- package/lib/server/jitPageBuilder.test.mjs +4 -4
- package/lib/server/journeyCookies.test.mjs +1 -0
- package/lib/server/loadDynamicJsMap.js +10 -1
- package/lib/server/log/createHandleError.js +10 -5
- package/lib/server/log/createHandleError.test.mjs +19 -8
- package/lib/server/log/createLogger.test.mjs +2 -2
- package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
- package/lib/server/mutants/listMutants.test.mjs +1 -0
- package/lib/server/mutants/mutantRuns.test.mjs +1 -0
- package/lib/server/mutants/operators.test.mjs +1 -0
- package/lib/server/pageBuildRecords.test.mjs +1 -0
- package/lib/server/pageCache.test.mjs +1 -0
- package/lib/server/pageRebuilds.test.mjs +3 -3
- package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
- package/lib/server/pruneJitMaps.test.mjs +1 -0
- package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
- package/lib/server/readInstanceRecord.test.mjs +24 -8
- package/lib/server/readMergedMaps.test.mjs +1 -0
- package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
- package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
- package/lib/server/recording/servedBuilds.test.mjs +1 -0
- package/lib/server/sinkExternalConnections.test.mjs +6 -6
- package/lib/server/skipStaleMapWrites.test.mjs +12 -12
- package/lib/server/startIdleGc.test.mjs +25 -9
- package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
- package/lib/vite/createDevServerExclude.test.mjs +1 -0
- package/manager/getContext.mjs +9 -0
- package/manager/processes/checkPendingPlugins.mjs +49 -0
- package/manager/processes/checkPendingPlugins.test.mjs +107 -0
- package/manager/processes/createIdleChild.mjs +141 -0
- package/manager/processes/createIdleChild.test.mjs +209 -0
- package/manager/processes/initialBuild.mjs +2 -15
- package/manager/processes/initialBuild.test.mjs +8 -40
- package/manager/processes/lowdefyBuild.mjs +7 -4
- package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
- package/manager/processes/lowdefyBuild.test.mjs +17 -15
- package/manager/processes/restartServer.test.mjs +63 -15
- package/manager/processes/shutdownServer.test.mjs +3 -3
- package/manager/processes/startFirstServer.test.mjs +23 -22
- package/manager/processes/startMailSink.mjs +11 -3
- package/manager/processes/startMailSink.test.mjs +28 -2
- package/manager/processes/startProxy.mjs +158 -27
- package/manager/processes/startProxy.pairing.test.mjs +204 -0
- package/manager/processes/startProxy.test.mjs +127 -2
- package/manager/processes/startServer.mjs +5 -7
- package/manager/processes/startServer.test.mjs +10 -9
- package/manager/processes/syncServer.mjs +31 -4
- package/manager/processes/syncServer.test.mjs +71 -6
- package/manager/processes/waitForDevServer.test.mjs +21 -6
- package/manager/run.mjs +32 -8
- package/manager/utils/BatchChanges.mjs +1 -1
- package/manager/utils/BatchChanges.test.mjs +4 -4
- package/manager/utils/acquireDevInstance.test.mjs +1 -0
- package/manager/utils/checkPairing.mjs +45 -0
- package/manager/utils/checkPairing.test.mjs +53 -0
- package/manager/utils/createBuildActivity.mjs +5 -1
- package/manager/utils/createBuildActivity.test.mjs +2 -2
- package/manager/utils/createChangeSignal.test.mjs +5 -5
- package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
- package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
- package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
- package/manager/utils/createDotPathIgnore.test.mjs +1 -0
- package/manager/utils/createGlobIgnore.mjs +45 -0
- package/manager/utils/createGlobIgnore.test.mjs +58 -0
- package/manager/utils/createGlobWatchPaths.mjs +75 -0
- package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
- package/manager/utils/createIdleGc.test.mjs +31 -15
- package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
- package/manager/utils/createLanPairing.test.mjs +46 -0
- package/manager/utils/createRequestActivity.mjs +30 -3
- package/manager/utils/createRequestActivity.test.mjs +76 -22
- package/manager/utils/createServerArtifactTracker.mjs +1 -0
- package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
- package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
- package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
- package/manager/utils/findSignInCode.test.mjs +33 -0
- package/manager/utils/formatLanPairing.mjs +32 -0
- package/manager/utils/formatLanPairing.test.mjs +40 -0
- package/manager/utils/getLanAddress.mjs +83 -0
- package/manager/utils/getLanAddress.test.mjs +70 -0
- package/manager/utils/importFresh.test.mjs +1 -0
- package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
- package/manager/utils/pluginTypeCache.mjs +100 -0
- package/manager/utils/pluginTypeCache.test.mjs +141 -0
- package/manager/utils/pruneRecordings.test.mjs +1 -0
- package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
- package/manager/utils/publishBuildDirectory.test.mjs +6 -7
- package/manager/utils/readBasePath.test.mjs +1 -0
- package/manager/utils/readManagerVersion.test.mjs +1 -0
- package/manager/utils/readPluginDefinitions.mjs +6 -6
- package/manager/utils/renderTerminalQr.mjs +54 -0
- package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
- package/manager/utils/setupWatcher.mjs +19 -4
- package/manager/utils/startRecordingPruner.test.mjs +24 -8
- package/manager/utils/waitForChildExit.test.mjs +2 -2
- package/manager/utils/writeBuildStatus.test.mjs +1 -0
- package/manager/watchers/envWatcher.mjs +3 -0
- package/manager/watchers/envWatcher.test.mjs +19 -7
- package/manager/watchers/listServerPluginFiles.mjs +188 -0
- package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
- package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
- package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
- package/manager/watchers/pluginSourceWatcher.mjs +45 -17
- package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
- package/manager/watchers/resolveFile.mjs +46 -0
- package/manager/watchers/resolveFile.test.mjs +67 -0
- package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
- package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
- package/manager/watchers/restartRequestWatcher.mjs +7 -4
- package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
- package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
- package/package.json +50 -49
- package/package.original.json +50 -49
- package/src/app.js +83 -85
- package/src/html/renderDevPage.test.mjs +1 -0
- package/src/lib/getPathSegments.js +16 -1
- package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
- package/src/lib/isTabAnswer.js +32 -0
- package/src/lib/isTabChannelCaller.js +35 -0
- package/src/middleware/apiContext.js +4 -2
- package/src/middleware/createSameOriginGuard.test.mjs +1 -0
- package/src/middleware/errorHandler.js +33 -45
- package/src/middleware/errorHandler.test.mjs +10 -10
- package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
- package/src/middleware/localDevToolsOnly.js +13 -1
- package/src/middleware/localDevToolsOnly.test.mjs +36 -2
- package/src/middleware/noStore.test.mjs +1 -0
- package/src/middleware/staleFlag.test.mjs +1 -0
- package/src/middleware/stampCaller.test.mjs +1 -0
- package/src/routes/agentBearer.test.mjs +183 -0
- package/src/routes/auth.test.mjs +10 -10
- package/src/routes/clientError.js +21 -4
- package/src/routes/clientError.test.mjs +127 -0
- package/src/routes/devInspect.js +6 -51
- package/src/routes/devInspect.test.mjs +128 -3
- package/src/routes/devRecording.js +6 -17
- package/src/routes/devRecording.test.mjs +54 -3
- package/src/routes/docs/buildStatus.test.mjs +6 -6
- package/src/routes/docs/events.test.mjs +4 -4
- package/src/routes/docs/find.js +3 -3
- package/src/routes/docs/journey.test.mjs +8 -8
- package/src/routes/docs/journeyRefusals.test.mjs +9 -9
- package/src/routes/docs/loadDocsRoutes.js +70 -0
- package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
- package/src/routes/docs/mcp.test.mjs +5 -5
- package/src/routes/docs/mutants.js +7 -0
- package/src/routes/docs/mutants.test.mjs +20 -6
- package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
- package/src/routes/docs/parseUserParam.test.mjs +1 -0
- package/src/routes/docs/restart.test.mjs +1 -0
- package/src/routes/endpoints.js +24 -0
- package/src/routes/endpointsLink.test.mjs +111 -0
- package/src/routes/endpointsTextAnswer.test.mjs +8 -8
- package/src/routes/jitPage.js +13 -1
- package/src/routes/jitPage.test.mjs +36 -11
- package/src/routes/mcp.js +6 -0
- package/src/routes/mcp.test.mjs +23 -8
- package/src/routes/mcpMemberToken.test.mjs +8 -8
- package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
- package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
- package/src/routes/mobileRoutes.test.mjs +223 -0
- package/src/routes/mobileSignIn.js +58 -0
- package/src/routes/mobileSignIn.test.mjs +59 -0
- package/src/routes/mobileSignInCallback.js +34 -0
- package/src/routes/mobileSignInCallback.test.mjs +51 -0
- package/src/routes/mountDevPageRoutes.js +10 -2
- package/src/routes/mountDevPageRoutes.test.mjs +25 -1
- package/src/routes/mountMobileWellKnown.js +35 -0
- package/src/routes/mountMobileWellKnown.test.mjs +79 -0
- package/src/routes/mountOauthDiscovery.test.mjs +5 -5
- package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
- package/src/routes/reload.js +101 -20
- package/src/routes/reload.test.mjs +153 -0
- package/src/routes/request.js +1 -22
- package/src/routes/request.test.mjs +7 -24
- package/src/routes/requestBody.test.mjs +14 -27
- package/src/routes/websocket.test.mjs +2 -2
- package/src/routes/wellKnownFallback.test.mjs +2 -2
- package/src/websocket/devWebSocket.test.mjs +12 -12
- package/vite.config.js +13 -1
- package/client/feedback/FeedbackMount.jsx +0 -83
- package/client/feedback/FeedbackOverlay.jsx +0 -904
- package/client/feedback/captureTabScreenshot.js +0 -84
- package/client/feedback/copyToClipboard.js +0 -45
- package/client/feedback/drawAnnotationsSvg.js +0 -119
- package/client/feedback/feedbackStyles.js +0 -304
- package/client/feedback/pinResponsiveImages.js +0 -59
- package/client/feedback/sendFeedback.js +0 -39
- package/client/feedback/useFeedbackToggle.js +0 -70
- package/client/recorder/buildEngineRecord.js +0 -37
- package/client/recorder/buildInteractionRecord.js +0 -64
- package/client/recorder/buildTraceEvent.js +0 -57
- package/client/recorder/buildTraceEvent.test.mjs +0 -81
- package/client/recorder/chunkRecords.js +0 -69
- package/client/recorder/chunkRecords.test.mjs +0 -59
- package/client/recorder/collectEventEndpoints.js +0 -40
- package/client/recorder/collectEventRequests.js +0 -39
- package/client/recorder/createPairingBuffer.js +0 -187
- package/client/recorder/createPasswordRedactor.js +0 -84
- package/client/recorder/createRecordBatcher.js +0 -54
- package/client/recorder/createRecordBatcher.test.mjs +0 -76
- package/client/recorder/createRecordingSession.js +0 -61
- package/client/recorder/createRecordingSession.test.mjs +0 -72
- package/client/recorder/diffStateWrites.js +0 -77
- package/client/recorder/diffStateWrites.test.mjs +0 -66
- package/client/recorder/isEventCall.js +0 -30
- package/client/recorder/jsonType.js +0 -39
- package/client/recorder/sendRecords.js +0 -40
- package/lib/docs/captureAnnotatedScreenshot.js +0 -99
- package/lib/docs/checkpointPaths.js +0 -91
- package/lib/docs/checkpointStore.js +0 -243
- package/lib/docs/checkpointToMocks.js +0 -65
- package/lib/docs/configCheckpoints.test.mjs +0 -156
- package/lib/docs/createConfigCheckpoint.js +0 -92
- package/lib/docs/devMockRegistry.js +0 -68
- package/lib/docs/enrichFeedback.js +0 -71
- package/lib/docs/evalOperator.js +0 -49
- package/lib/docs/evalOperator.test.mjs +0 -157
- package/lib/docs/evalOperatorHeadless.js +0 -159
- package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
- package/lib/docs/evalOperatorInTab.js +0 -49
- package/lib/docs/formatFeedback.js +0 -142
- package/lib/docs/formatFeedback.test.mjs +0 -252
- package/lib/docs/getPluginDoc.js +0 -53
- package/lib/docs/listConfigCheckpoints.js +0 -55
- package/lib/docs/loadState.js +0 -220
- package/lib/docs/revertConfigCheckpoint.js +0 -73
- package/lib/docs/saveAnnotatedScreenshot.js +0 -43
- package/lib/docs/scaffoldPage.js +0 -77
- package/lib/docs/scaffoldPage.test.mjs +0 -97
- package/lib/docs/snapshotState.js +0 -67
- package/lib/docs/stateCheckpoints.test.mjs +0 -443
- package/manager/watchers/listServerSidePackages.mjs +0 -47
- package/manager/watchers/listServerSidePackages.test.mjs +0 -38
- package/src/routes/docs/checkpointsCreate.js +0 -28
- package/src/routes/docs/evalOperator.js +0 -70
- package/src/routes/docs/inspectState.js +0 -59
- package/src/routes/docs/loadState.js +0 -51
- package/src/routes/docs/pluginDoc.js +0 -33
- package/src/routes/docs/plugins.js +0 -23
- package/src/routes/docs/runEndpoint.js +0 -54
- package/src/routes/docs/runEndpoint.test.mjs +0 -165
- package/src/routes/docs/runRequest.js +0 -53
- package/src/routes/docs/runRequest.test.mjs +0 -92
- package/src/routes/docs/schema.js +0 -37
- package/src/routes/docs/screenshot.js +0 -120
- package/src/routes/docs/screenshot.test.mjs +0 -117
- package/src/routes/docs/search.js +0 -40
- package/src/routes/docs/snapshotState.js +0 -50
- package/src/routes/docs/stateCheckpointsList.js +0 -26
- package/src/routes/docs/types.js +0 -33
- package/src/routes/feedback.js +0 -107
- 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
|
-
});
|