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