@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
package/lib/docs/getPluginDoc.js
DELETED
|
@@ -1,53 +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 { type } from '@lowdefy/helpers';
|
|
19
|
-
|
|
20
|
-
import listPackageDocFiles from './listPackageDocFiles.js';
|
|
21
|
-
import readBuildArtifact from './readBuildArtifact.js';
|
|
22
|
-
import readPluginPackages from './readPluginPackages.js';
|
|
23
|
-
import resolvePluginDir from './resolvePluginDir.js';
|
|
24
|
-
|
|
25
|
-
// The package name comes from the caller, and a name such as "../../x" would
|
|
26
|
-
// resolve outside node_modules, so only the app's own plugins are read.
|
|
27
|
-
function isAppPlugin({ packageName }) {
|
|
28
|
-
const installed = readBuildArtifact({ name: 'installedPluginPackages.json' }) ?? [];
|
|
29
|
-
if (installed.includes(packageName)) {
|
|
30
|
-
return true;
|
|
31
|
-
}
|
|
32
|
-
return readPluginPackages().some((plugin) => plugin.package === packageName);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
// Every markdown file a plugin package ships, joined into one document.
|
|
36
|
-
function getPluginDoc({ packageName }) {
|
|
37
|
-
if (!isAppPlugin({ packageName })) {
|
|
38
|
-
return null;
|
|
39
|
-
}
|
|
40
|
-
const pluginDir = resolvePluginDir({ packageName });
|
|
41
|
-
if (type.isNone(pluginDir)) {
|
|
42
|
-
return null;
|
|
43
|
-
}
|
|
44
|
-
const { readme, docs } = listPackageDocFiles({ dir: pluginDir });
|
|
45
|
-
const files = type.isNone(readme) ? docs : [readme, ...docs];
|
|
46
|
-
if (files.length === 0) {
|
|
47
|
-
return null;
|
|
48
|
-
}
|
|
49
|
-
const sections = files.map((filePath) => fs.readFileSync(filePath, 'utf8'));
|
|
50
|
-
return { package: packageName, markdown: sections.join('\n\n---\n\n') };
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
export default getPluginDoc;
|
|
@@ -1,55 +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
|
-
import { getCheckpointsRoot, MANIFEST_FILE_NAME } from './checkpointPaths.js';
|
|
21
|
-
|
|
22
|
-
// Lists stored config checkpoints, most recent first. Reads manifest.json
|
|
23
|
-
// from each snapshot directory rather than re-scanning the config
|
|
24
|
-
// directory — the manifest is the source of truth for what a checkpoint
|
|
25
|
-
// contains, and stays accurate even after later checkpoints or reverts.
|
|
26
|
-
function listConfigCheckpoints() {
|
|
27
|
-
const checkpointsRoot = getCheckpointsRoot();
|
|
28
|
-
if (!fs.existsSync(checkpointsRoot)) {
|
|
29
|
-
return [];
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
const checkpoints = fs
|
|
33
|
-
.readdirSync(checkpointsRoot, { withFileTypes: true })
|
|
34
|
-
.filter((entry) => entry.isDirectory())
|
|
35
|
-
.map((entry) => {
|
|
36
|
-
const manifestPath = path.join(checkpointsRoot, entry.name, MANIFEST_FILE_NAME);
|
|
37
|
-
if (!fs.existsSync(manifestPath)) {
|
|
38
|
-
// A checkpoint directory without a manifest is not one this module
|
|
39
|
-
// wrote (or was interrupted mid-write) — skip rather than guess.
|
|
40
|
-
return null;
|
|
41
|
-
}
|
|
42
|
-
const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
|
|
43
|
-
return {
|
|
44
|
-
id: manifest.id,
|
|
45
|
-
label: manifest.label,
|
|
46
|
-
createdAt: manifest.createdAt,
|
|
47
|
-
fileCount: manifest.files.length,
|
|
48
|
-
};
|
|
49
|
-
})
|
|
50
|
-
.filter((checkpoint) => checkpoint !== null);
|
|
51
|
-
|
|
52
|
-
return checkpoints.sort((a, b) => (a.id < b.id ? 1 : -1));
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
export default listConfigCheckpoints;
|
package/lib/docs/loadState.js
DELETED
|
@@ -1,220 +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, urlQuery as urlQueryFn } from '@lowdefy/helpers';
|
|
18
|
-
|
|
19
|
-
import { buildPageUrl, getBrowser, openPage } from './getBrowser.js';
|
|
20
|
-
import noBrowserError from './noBrowserError.js';
|
|
21
|
-
import { loadMocks } from './devMockRegistry.js';
|
|
22
|
-
import { readCheckpoint } from './checkpointStore.js';
|
|
23
|
-
import resolvePageInstance from './resolvePageInstance.js';
|
|
24
|
-
import resolveToolCaller from './resolveToolCaller.js';
|
|
25
|
-
import unsettledPageNote from './unsettledPageNote.js';
|
|
26
|
-
import withBrowserSlot from './withBrowserSlot.js';
|
|
27
|
-
import withDataSession from './withDataSession.js';
|
|
28
|
-
|
|
29
|
-
const VERIFY_KEY_COUNT = 3;
|
|
30
|
-
const READY_TIMEOUT = 15000;
|
|
31
|
-
|
|
32
|
-
// Loads a state checkpoint's recorded requests into devMockRegistry (shared
|
|
33
|
-
// by both modes below — src/routes/request.js consults it regardless of how
|
|
34
|
-
// the page was opened), then either:
|
|
35
|
-
// - 'headless': drives a headless page to the checkpoint's page instance
|
|
36
|
-
// (pageId, pathParams) and urlQuery, injects its recorded state directly
|
|
37
|
-
// into that instance's context, and verifies
|
|
38
|
-
// a few keys round-tripped. Good for an agent verifying its own change.
|
|
39
|
-
// Takes a `user` (and `data`, see resolveToolCaller) so a checkpoint
|
|
40
|
-
// captured on a role-gated page restores into a page that actually
|
|
41
|
-
// renders (see resolveHeadlessUser.js).
|
|
42
|
-
// - 'registry-only': just returns a URL a human can open in a real browser
|
|
43
|
-
// tab — client/Inspector.jsx's `?_checkpoint=` bootstrap does the state
|
|
44
|
-
// injection client-side once that tab loads.
|
|
45
|
-
async function loadState({ origin, name, mode = 'headless', user, data }) {
|
|
46
|
-
if (type.isNone(name) || !type.isString(name)) {
|
|
47
|
-
return { error: `loadState requires a "name" string. Received ${JSON.stringify(name)}.` };
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
// `user` only reaches a page this function opens itself. In 'registry-only'
|
|
51
|
-
// mode the developer opens the returned URL in their own browser, carrying
|
|
52
|
-
// their own session, so an injected caller would be silently dropped.
|
|
53
|
-
if ((!type.isNone(user) || !type.isNone(data)) && mode === 'registry-only') {
|
|
54
|
-
const param = type.isNone(user) ? 'data' : 'user';
|
|
55
|
-
return {
|
|
56
|
-
error: `loadState cannot apply "${param}" in "registry-only" mode — the developer opens the returned URL in their own browser, carrying their own session and database. Use the default "headless" mode.`,
|
|
57
|
-
invalidInput: true,
|
|
58
|
-
};
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
let checkpoint;
|
|
62
|
-
try {
|
|
63
|
-
checkpoint = readCheckpoint({ name });
|
|
64
|
-
} catch (error) {
|
|
65
|
-
return { error: error.message };
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
const pageId = checkpoint.checkpoint.pageId;
|
|
69
|
-
if (type.isNone(pageId)) {
|
|
70
|
-
return { error: `Checkpoint "${name}" has no recorded pageId.` };
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
const { pathParams } = checkpoint;
|
|
74
|
-
const instance = resolvePageInstance({ pageId, pathParams });
|
|
75
|
-
if (!type.isUndefined(instance.error)) {
|
|
76
|
-
return { error: `Checkpoint "${name}" cannot open its page: ${instance.error}` };
|
|
77
|
-
}
|
|
78
|
-
|
|
79
|
-
loadMocks({ pageId, mocks: checkpoint.requests });
|
|
80
|
-
|
|
81
|
-
// The checkpoint keeps the query string the page was captured at.
|
|
82
|
-
const urlQuery = urlQueryFn.parse(checkpoint.urlQuery);
|
|
83
|
-
|
|
84
|
-
if (mode === 'registry-only') {
|
|
85
|
-
const url = buildPageUrl({
|
|
86
|
-
origin,
|
|
87
|
-
pageId,
|
|
88
|
-
path: instance.path,
|
|
89
|
-
pathParams,
|
|
90
|
-
urlQuery: { ...urlQuery, _checkpoint: name },
|
|
91
|
-
});
|
|
92
|
-
return {
|
|
93
|
-
url,
|
|
94
|
-
instructions:
|
|
95
|
-
'Open this URL in a browser — state is injected on load, requests serve recorded data.',
|
|
96
|
-
};
|
|
97
|
-
}
|
|
98
|
-
|
|
99
|
-
if (mode !== 'headless') {
|
|
100
|
-
return {
|
|
101
|
-
error: `loadState "mode" must be "headless" or "registry-only". Received ${JSON.stringify(
|
|
102
|
-
mode
|
|
103
|
-
)}.`,
|
|
104
|
-
};
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
if (type.isNone(origin) || !type.isString(origin)) {
|
|
108
|
-
return { error: `loadState requires an "origin" string. Received ${JSON.stringify(origin)}.` };
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
const caller = await resolveToolCaller({ user, data });
|
|
112
|
-
if (!type.isUndefined(caller.error)) {
|
|
113
|
-
return caller;
|
|
114
|
-
}
|
|
115
|
-
|
|
116
|
-
return withBrowserSlot({
|
|
117
|
-
task: () =>
|
|
118
|
-
withDataSession({
|
|
119
|
-
dataSet: caller.dataSet,
|
|
120
|
-
task: ({ dataCookie }) =>
|
|
121
|
-
loadStateInBrowser({
|
|
122
|
-
origin,
|
|
123
|
-
name,
|
|
124
|
-
mode,
|
|
125
|
-
user: caller.user,
|
|
126
|
-
dataCookie,
|
|
127
|
-
pageId,
|
|
128
|
-
instance,
|
|
129
|
-
pathParams,
|
|
130
|
-
urlQuery,
|
|
131
|
-
checkpoint,
|
|
132
|
-
}),
|
|
133
|
-
}),
|
|
134
|
-
});
|
|
135
|
-
}
|
|
136
|
-
|
|
137
|
-
// The part of loadState that runs in the browser, inside a browser slot.
|
|
138
|
-
async function loadStateInBrowser({
|
|
139
|
-
origin,
|
|
140
|
-
name,
|
|
141
|
-
mode,
|
|
142
|
-
user,
|
|
143
|
-
dataCookie,
|
|
144
|
-
pageId,
|
|
145
|
-
instance,
|
|
146
|
-
pathParams,
|
|
147
|
-
urlQuery,
|
|
148
|
-
checkpoint,
|
|
149
|
-
}) {
|
|
150
|
-
let browser;
|
|
151
|
-
try {
|
|
152
|
-
browser = await getBrowser();
|
|
153
|
-
} catch (error) {
|
|
154
|
-
return { error: noBrowserError(error) };
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
let context;
|
|
158
|
-
try {
|
|
159
|
-
const opened = await openPage({
|
|
160
|
-
browser,
|
|
161
|
-
origin,
|
|
162
|
-
pageId,
|
|
163
|
-
path: instance.path,
|
|
164
|
-
pathParams,
|
|
165
|
-
urlQuery,
|
|
166
|
-
user,
|
|
167
|
-
dataCookie,
|
|
168
|
-
timeout: READY_TIMEOUT,
|
|
169
|
-
});
|
|
170
|
-
context = opened.context;
|
|
171
|
-
const { page } = opened;
|
|
172
|
-
|
|
173
|
-
await page.waitForFunction(
|
|
174
|
-
(contextKey) => Boolean(window.lowdefy?.contexts?.[contextKey]),
|
|
175
|
-
instance.instanceKey,
|
|
176
|
-
{
|
|
177
|
-
timeout: READY_TIMEOUT,
|
|
178
|
-
}
|
|
179
|
-
);
|
|
180
|
-
|
|
181
|
-
const stateEntries = Object.entries(checkpoint.state ?? {});
|
|
182
|
-
await page.evaluate(
|
|
183
|
-
({ contextKey, entries }) => {
|
|
184
|
-
const pageContext = window.lowdefy.contexts[contextKey];
|
|
185
|
-
entries.forEach(([key, value]) => {
|
|
186
|
-
pageContext._internal.State.set(key, value);
|
|
187
|
-
});
|
|
188
|
-
pageContext._internal.update();
|
|
189
|
-
},
|
|
190
|
-
{ contextKey: instance.instanceKey, entries: stateEntries }
|
|
191
|
-
);
|
|
192
|
-
|
|
193
|
-
const verifyKeys = stateEntries.slice(0, VERIFY_KEY_COUNT).map(([key]) => key);
|
|
194
|
-
const verifiedKeys = await page.evaluate(
|
|
195
|
-
({ contextKey, keys }) => {
|
|
196
|
-
const pageContext = window.lowdefy.contexts[contextKey];
|
|
197
|
-
const result = {};
|
|
198
|
-
keys.forEach((key) => {
|
|
199
|
-
result[key] = pageContext.state?.[key];
|
|
200
|
-
});
|
|
201
|
-
return result;
|
|
202
|
-
},
|
|
203
|
-
{ contextKey: instance.instanceKey, keys: verifyKeys }
|
|
204
|
-
);
|
|
205
|
-
|
|
206
|
-
const result = { loaded: true, mode, url: opened.url, verifiedKeys };
|
|
207
|
-
if (!opened.ready) {
|
|
208
|
-
return { ...result, ready: false, note: unsettledPageNote({ timeout: READY_TIMEOUT }) };
|
|
209
|
-
}
|
|
210
|
-
return result;
|
|
211
|
-
} catch (error) {
|
|
212
|
-
return { error: `Failed to load checkpoint "${name}": ${error.message}` };
|
|
213
|
-
} finally {
|
|
214
|
-
if (context) {
|
|
215
|
-
await context.close();
|
|
216
|
-
}
|
|
217
|
-
}
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
export default loadState;
|
|
@@ -1,73 +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 { type } from '@lowdefy/helpers';
|
|
20
|
-
|
|
21
|
-
import {
|
|
22
|
-
getCheckpointsRoot,
|
|
23
|
-
getConfigDirectory,
|
|
24
|
-
listConfigFiles,
|
|
25
|
-
MANIFEST_FILE_NAME,
|
|
26
|
-
} from './checkpointPaths.js';
|
|
27
|
-
|
|
28
|
-
function copyFromSnapshot({ snapshotDirectory, configDirectory, relativeFilePath }) {
|
|
29
|
-
const source = path.join(snapshotDirectory, relativeFilePath);
|
|
30
|
-
const destination = path.join(configDirectory, relativeFilePath);
|
|
31
|
-
fs.mkdirSync(path.dirname(destination), { recursive: true });
|
|
32
|
-
fs.copyFileSync(source, destination);
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
// Restores the config directory to exactly the state captured by checkpoint
|
|
36
|
-
// `id`: every file the manifest lists is copied back (covering both
|
|
37
|
-
// modified files and files deleted after the checkpoint was taken), and any
|
|
38
|
-
// config-relevant file that exists now but isn't in the manifest is deleted
|
|
39
|
-
// (covering files added after the checkpoint). The manifest — not a diff
|
|
40
|
-
// against the live directory — is the single source of truth for what
|
|
41
|
-
// "restored" means, so reverts are exact and repeatable.
|
|
42
|
-
function revertConfigCheckpoint({ id }) {
|
|
43
|
-
if (type.isNone(id) || !type.isString(id)) {
|
|
44
|
-
throw new Error(
|
|
45
|
-
`revertConfigCheckpoint requires an "id" string. Received ${JSON.stringify(id)}.`
|
|
46
|
-
);
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
const checkpointsRoot = getCheckpointsRoot();
|
|
50
|
-
const snapshotDirectory = path.join(checkpointsRoot, id);
|
|
51
|
-
const manifestPath = path.join(snapshotDirectory, MANIFEST_FILE_NAME);
|
|
52
|
-
if (!fs.existsSync(manifestPath)) {
|
|
53
|
-
throw new Error(`Config checkpoint "${id}" not found.`);
|
|
54
|
-
}
|
|
55
|
-
|
|
56
|
-
const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
|
|
57
|
-
const configDirectory = getConfigDirectory();
|
|
58
|
-
|
|
59
|
-
manifest.files.forEach((relativeFilePath) => {
|
|
60
|
-
copyFromSnapshot({ snapshotDirectory, configDirectory, relativeFilePath });
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
const manifestFiles = new Set(manifest.files);
|
|
64
|
-
const currentFiles = listConfigFiles({ configDirectory });
|
|
65
|
-
const deleted = currentFiles.filter((relativeFilePath) => !manifestFiles.has(relativeFilePath));
|
|
66
|
-
deleted.forEach((relativeFilePath) => {
|
|
67
|
-
fs.rmSync(path.join(configDirectory, relativeFilePath));
|
|
68
|
-
});
|
|
69
|
-
|
|
70
|
-
return { restored: manifest.files, deleted };
|
|
71
|
-
}
|
|
72
|
-
|
|
73
|
-
export default revertConfigCheckpoint;
|
|
@@ -1,43 +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
|
-
const PNG_DATA_URL_PREFIX = 'data:image/png;base64,';
|
|
21
|
-
|
|
22
|
-
// Saves a tab-captured annotated screenshot (PNG data URL POSTed with the
|
|
23
|
-
// feedback batch) under the config dir's .lowdefy/annotations/ — the same
|
|
24
|
-
// location and naming captureAnnotatedScreenshot.js uses, so formatFeedback's
|
|
25
|
-
// screenshotPath contract is identical for both capture paths. Never throws —
|
|
26
|
-
// returns { path } or { error }.
|
|
27
|
-
function saveAnnotatedScreenshot({ dataUrl, fileName }) {
|
|
28
|
-
if (typeof dataUrl !== 'string' || !dataUrl.startsWith(PNG_DATA_URL_PREFIX)) {
|
|
29
|
-
return { error: 'Screenshot is not a PNG data URL.' };
|
|
30
|
-
}
|
|
31
|
-
try {
|
|
32
|
-
const buffer = Buffer.from(dataUrl.slice(PNG_DATA_URL_PREFIX.length), 'base64');
|
|
33
|
-
const configDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
|
|
34
|
-
const dir = path.join(configDirectory, '.lowdefy', 'annotations');
|
|
35
|
-
fs.mkdirSync(dir, { recursive: true });
|
|
36
|
-
fs.writeFileSync(path.join(dir, fileName), buffer);
|
|
37
|
-
return { path: path.posix.join('.lowdefy', 'annotations', fileName) };
|
|
38
|
-
} catch (error) {
|
|
39
|
-
return { error: `Failed to save annotated screenshot: ${error.message}` };
|
|
40
|
-
}
|
|
41
|
-
}
|
|
42
|
-
|
|
43
|
-
export default saveAnnotatedScreenshot;
|
package/lib/docs/scaffoldPage.js
DELETED
|
@@ -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 fs from 'fs';
|
|
18
|
-
import path from 'path';
|
|
19
|
-
import { type } from '@lowdefy/helpers';
|
|
20
|
-
|
|
21
|
-
import readBuildArtifact from './readBuildArtifact.js';
|
|
22
|
-
|
|
23
|
-
const pageIdPattern = /^[a-z0-9-_]+$/i;
|
|
24
|
-
|
|
25
|
-
function buildPageYaml({ pageId, title }) {
|
|
26
|
-
const titleJson = JSON.stringify(title);
|
|
27
|
-
return `id: ${pageId}
|
|
28
|
-
type: PageHeaderMenu
|
|
29
|
-
properties:
|
|
30
|
-
title: ${titleJson}
|
|
31
|
-
blocks:
|
|
32
|
-
- id: ${pageId}_title
|
|
33
|
-
type: Title
|
|
34
|
-
properties:
|
|
35
|
-
content: ${titleJson}
|
|
36
|
-
`;
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
// Scaffolds a new page config file for an AI agent to wire up — it never edits lowdefy.yaml
|
|
40
|
-
// itself, since that would risk destroying the user's comments and formatting.
|
|
41
|
-
function scaffoldPage({ pageId, title }) {
|
|
42
|
-
if (type.isNone(pageId) || !pageIdPattern.test(pageId)) {
|
|
43
|
-
return {
|
|
44
|
-
error: `Invalid page id ${JSON.stringify(
|
|
45
|
-
pageId
|
|
46
|
-
)}. Page ids may only contain letters, numbers, "-" and "_".`,
|
|
47
|
-
};
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
const configDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG || process.cwd();
|
|
51
|
-
const pageRelativePath = path.join('pages', `${pageId}.yaml`);
|
|
52
|
-
// _ref paths in config use forward slashes on every platform.
|
|
53
|
-
const pageRefPath = path.posix.join('pages', `${pageId}.yaml`);
|
|
54
|
-
const pageFilePath = path.join(configDirectory, pageRelativePath);
|
|
55
|
-
|
|
56
|
-
if (fs.existsSync(pageFilePath)) {
|
|
57
|
-
return { error: `"${pageRelativePath}" already exists.` };
|
|
58
|
-
}
|
|
59
|
-
|
|
60
|
-
const pageRegistry = readBuildArtifact({ name: 'pageRegistry.json' }) ?? {};
|
|
61
|
-
if (Object.keys(pageRegistry).includes(pageId)) {
|
|
62
|
-
return {
|
|
63
|
-
error: `Page id "${pageId}" is already used by another page in the build (see build/pageRegistry.json). Choose a different id.`,
|
|
64
|
-
};
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
const pageTitle = title ?? pageId;
|
|
68
|
-
fs.mkdirSync(path.dirname(pageFilePath), { recursive: true });
|
|
69
|
-
fs.writeFileSync(pageFilePath, buildPageYaml({ pageId, title: pageTitle }));
|
|
70
|
-
|
|
71
|
-
return {
|
|
72
|
-
created: pageRelativePath,
|
|
73
|
-
next: `Add \`- _ref: ${pageRefPath}\` under \`pages:\` in lowdefy.yaml (or the relevant pages file), then check lowdefy_build_status.`,
|
|
74
|
-
};
|
|
75
|
-
}
|
|
76
|
-
|
|
77
|
-
export default scaffoldPage;
|
|
@@ -1,97 +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 os from 'os';
|
|
19
|
-
import path from 'path';
|
|
20
|
-
|
|
21
|
-
import scaffoldPage from './scaffoldPage.js';
|
|
22
|
-
|
|
23
|
-
let configDirectory;
|
|
24
|
-
let previousConfigDirectory;
|
|
25
|
-
let previousCwd;
|
|
26
|
-
|
|
27
|
-
beforeEach(() => {
|
|
28
|
-
configDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-scaffold-page-test-'));
|
|
29
|
-
previousConfigDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG;
|
|
30
|
-
process.env.LOWDEFY_DIRECTORY_CONFIG = configDirectory;
|
|
31
|
-
// readBuildArtifact.js (used to check pageRegistry.json) reads from process.cwd(), which is
|
|
32
|
-
// the same directory as LOWDEFY_DIRECTORY_CONFIG in a real dev server run.
|
|
33
|
-
previousCwd = process.cwd();
|
|
34
|
-
process.chdir(configDirectory);
|
|
35
|
-
});
|
|
36
|
-
|
|
37
|
-
afterEach(() => {
|
|
38
|
-
process.chdir(previousCwd);
|
|
39
|
-
fs.rmSync(configDirectory, { recursive: true, force: true });
|
|
40
|
-
if (previousConfigDirectory === undefined) {
|
|
41
|
-
delete process.env.LOWDEFY_DIRECTORY_CONFIG;
|
|
42
|
-
} else {
|
|
43
|
-
process.env.LOWDEFY_DIRECTORY_CONFIG = previousConfigDirectory;
|
|
44
|
-
}
|
|
45
|
-
});
|
|
46
|
-
|
|
47
|
-
test('scaffoldPage writes a canonical page file and reports the next step', () => {
|
|
48
|
-
const result = scaffoldPage({ pageId: 'reports', title: 'Reports' });
|
|
49
|
-
|
|
50
|
-
expect(result).toEqual({
|
|
51
|
-
created: path.join('pages', 'reports.yaml'),
|
|
52
|
-
next: 'Add `- _ref: pages/reports.yaml` under `pages:` in lowdefy.yaml (or the relevant pages file), then check lowdefy_build_status.',
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
const written = fs.readFileSync(path.join(configDirectory, 'pages', 'reports.yaml'), 'utf8');
|
|
56
|
-
expect(written).toContain('id: reports');
|
|
57
|
-
expect(written).toContain('type: PageHeaderMenu');
|
|
58
|
-
expect(written).toContain('title: "Reports"');
|
|
59
|
-
expect(written).toContain('type: Title');
|
|
60
|
-
expect(written).toContain('content: "Reports"');
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
test('scaffoldPage defaults the title to the pageId when no title is given', () => {
|
|
64
|
-
scaffoldPage({ pageId: 'dashboard' });
|
|
65
|
-
|
|
66
|
-
const written = fs.readFileSync(path.join(configDirectory, 'pages', 'dashboard.yaml'), 'utf8');
|
|
67
|
-
expect(written).toContain('title: "dashboard"');
|
|
68
|
-
});
|
|
69
|
-
|
|
70
|
-
test('scaffoldPage refuses an invalid page id', () => {
|
|
71
|
-
const result = scaffoldPage({ pageId: 'has a space' });
|
|
72
|
-
|
|
73
|
-
expect(result.error).toContain('Invalid page id');
|
|
74
|
-
expect(fs.existsSync(path.join(configDirectory, 'pages', 'has a space.yaml'))).toBe(false);
|
|
75
|
-
});
|
|
76
|
-
|
|
77
|
-
test('scaffoldPage refuses when the page file already exists', () => {
|
|
78
|
-
fs.mkdirSync(path.join(configDirectory, 'pages'), { recursive: true });
|
|
79
|
-
fs.writeFileSync(path.join(configDirectory, 'pages', 'reports.yaml'), 'id: reports\n');
|
|
80
|
-
|
|
81
|
-
const result = scaffoldPage({ pageId: 'reports' });
|
|
82
|
-
|
|
83
|
-
expect(result.error).toEqual(`"${path.join('pages', 'reports.yaml')}" already exists.`);
|
|
84
|
-
});
|
|
85
|
-
|
|
86
|
-
test('scaffoldPage refuses when the pageId is already used in the build registry', () => {
|
|
87
|
-
fs.mkdirSync(path.join(configDirectory, 'build'), { recursive: true });
|
|
88
|
-
fs.writeFileSync(
|
|
89
|
-
path.join(configDirectory, 'build', 'pageRegistry.json'),
|
|
90
|
-
JSON.stringify({ reports: {} })
|
|
91
|
-
);
|
|
92
|
-
|
|
93
|
-
const result = scaffoldPage({ pageId: 'reports' });
|
|
94
|
-
|
|
95
|
-
expect(result.error).toContain('Page id "reports" is already used');
|
|
96
|
-
expect(fs.existsSync(path.join(configDirectory, 'pages', 'reports.yaml'))).toBe(false);
|
|
97
|
-
});
|
|
@@ -1,67 +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 { buildPageUrl } from './getBrowser.js';
|
|
20
|
-
import inspectState from './inspectState.js';
|
|
21
|
-
import readPagePath from './readPagePath.js';
|
|
22
|
-
import { writeCheckpoint } from './checkpointStore.js';
|
|
23
|
-
|
|
24
|
-
// Snapshots the running app (page state + recorded request/api responses)
|
|
25
|
-
// into a checkpoint folder under .lowdefy — see checkpointStore.js for the
|
|
26
|
-
// on-disk layout. Reuses inspectState.js's tab-first/headless-fallback
|
|
27
|
-
// snapshot rather than driving a browser directly, so a snapshot always
|
|
28
|
-
// reflects whatever a developer is actually looking at when one is
|
|
29
|
-
// available. With only a `pageId`, a tab's snapshot is of the instance it
|
|
30
|
-
// names (see findPageInstance in tabChannel.js), and the checkpoint keeps that
|
|
31
|
-
// instance's pathParams.
|
|
32
|
-
async function snapshotState({ origin, pageId, pathParams, name, notes, source, overwrite }) {
|
|
33
|
-
if (type.isNone(pageId) || !type.isString(pageId)) {
|
|
34
|
-
return {
|
|
35
|
-
error: `snapshotState requires a "pageId" string. Received ${JSON.stringify(pageId)}.`,
|
|
36
|
-
};
|
|
37
|
-
}
|
|
38
|
-
if (type.isNone(name) || !type.isString(name)) {
|
|
39
|
-
return { error: `snapshotState requires a "name" string. Received ${JSON.stringify(name)}.` };
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
const snapshot = await inspectState({ origin, pageId, pathParams, source });
|
|
43
|
-
if (snapshot?.error) {
|
|
44
|
-
return { error: snapshot.error, invalidInput: snapshot.invalidInput };
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
const url = `${buildPageUrl({
|
|
48
|
-
origin,
|
|
49
|
-
pageId,
|
|
50
|
-
path: readPagePath({ pageId }),
|
|
51
|
-
pathParams: snapshot.pathParams,
|
|
52
|
-
})}${snapshot.urlQuery ?? ''}`;
|
|
53
|
-
|
|
54
|
-
try {
|
|
55
|
-
const { dir, parts } = writeCheckpoint({
|
|
56
|
-
name,
|
|
57
|
-
snapshot: { ...snapshot, url },
|
|
58
|
-
notes,
|
|
59
|
-
overwrite,
|
|
60
|
-
});
|
|
61
|
-
return { name, dir, parts, source: snapshot.source };
|
|
62
|
-
} catch (error) {
|
|
63
|
-
return { error: error.message };
|
|
64
|
-
}
|
|
65
|
-
}
|
|
66
|
-
|
|
67
|
-
export default snapshotState;
|