@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,117 +0,0 @@
|
|
|
1
|
-
/*
|
|
2
|
-
Copyright 2020-2026 Lowdefy, Inc
|
|
3
|
-
|
|
4
|
-
Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
-
you may not use this file except in compliance with the License.
|
|
6
|
-
You may obtain a copy of the License at
|
|
7
|
-
|
|
8
|
-
http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
-
|
|
10
|
-
Unless required by applicable law or agreed to in writing, software
|
|
11
|
-
distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
-
See the License for the specific language governing permissions and
|
|
14
|
-
limitations under the License.
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
import { jest } from '@jest/globals';
|
|
18
|
-
|
|
19
|
-
const mockScreenshotPage = jest.fn();
|
|
20
|
-
|
|
21
|
-
jest.unstable_mockModule('../../../lib/docs/screenshotPage.js', () => ({
|
|
22
|
-
default: mockScreenshotPage,
|
|
23
|
-
}));
|
|
24
|
-
|
|
25
|
-
const { default: docsScreenshotHandler } = await import('./screenshot.js');
|
|
26
|
-
|
|
27
|
-
function createContext(url) {
|
|
28
|
-
const parsed = new URL(url);
|
|
29
|
-
const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
|
|
30
|
-
const body = jest.fn((data, status, headers) => ({ data, status, headers }));
|
|
31
|
-
return {
|
|
32
|
-
req: {
|
|
33
|
-
url,
|
|
34
|
-
param: () => parsed.pathname.split('/').pop(),
|
|
35
|
-
query: (key) => parsed.searchParams.get(key) ?? undefined,
|
|
36
|
-
},
|
|
37
|
-
json,
|
|
38
|
-
body,
|
|
39
|
-
};
|
|
40
|
-
}
|
|
41
|
-
|
|
42
|
-
beforeEach(() => {
|
|
43
|
-
jest.clearAllMocks();
|
|
44
|
-
mockScreenshotPage.mockResolvedValue({ data: 'cG5n', mimeType: 'image/png' });
|
|
45
|
-
});
|
|
46
|
-
|
|
47
|
-
test('docsScreenshotHandler passes the viewport size and colour scheme to screenshotPage', async () => {
|
|
48
|
-
const c = createContext(
|
|
49
|
-
'http://localhost:3227/lowdefy-docs/screenshot/home?viewportWidth=390&viewportHeight=844&colorScheme=dark'
|
|
50
|
-
);
|
|
51
|
-
|
|
52
|
-
const result = await docsScreenshotHandler(c);
|
|
53
|
-
|
|
54
|
-
expect(mockScreenshotPage).toHaveBeenCalledWith(
|
|
55
|
-
expect.objectContaining({
|
|
56
|
-
origin: 'http://localhost:3227',
|
|
57
|
-
pageId: 'home',
|
|
58
|
-
width: 390,
|
|
59
|
-
height: 844,
|
|
60
|
-
colorScheme: 'dark',
|
|
61
|
-
clip: undefined,
|
|
62
|
-
})
|
|
63
|
-
);
|
|
64
|
-
expect(result.status).toBe(200);
|
|
65
|
-
expect(result.headers).toEqual({ 'Content-Type': 'image/png' });
|
|
66
|
-
});
|
|
67
|
-
|
|
68
|
-
test('docsScreenshotHandler keeps width and height as the clip, apart from the viewport', async () => {
|
|
69
|
-
const c = createContext(
|
|
70
|
-
'http://localhost:3227/lowdefy-docs/screenshot/home?x=0&y=10&width=200&height=100&viewportWidth=800'
|
|
71
|
-
);
|
|
72
|
-
|
|
73
|
-
await docsScreenshotHandler(c);
|
|
74
|
-
|
|
75
|
-
expect(mockScreenshotPage).toHaveBeenCalledWith(
|
|
76
|
-
expect.objectContaining({
|
|
77
|
-
clip: { x: 0, y: 10, width: 200, height: 100 },
|
|
78
|
-
width: 800,
|
|
79
|
-
height: undefined,
|
|
80
|
-
colorScheme: undefined,
|
|
81
|
-
})
|
|
82
|
-
);
|
|
83
|
-
});
|
|
84
|
-
|
|
85
|
-
test('docsScreenshotHandler returns 400 for an unknown colour scheme', async () => {
|
|
86
|
-
const c = createContext('http://localhost:3227/lowdefy-docs/screenshot/home?colorScheme=dim');
|
|
87
|
-
|
|
88
|
-
const result = await docsScreenshotHandler(c);
|
|
89
|
-
|
|
90
|
-
expect(result.status).toBe(400);
|
|
91
|
-
expect(result.data.error).toEqual('Color scheme must be "light" or "dark". Received "dim".');
|
|
92
|
-
expect(mockScreenshotPage).not.toHaveBeenCalled();
|
|
93
|
-
});
|
|
94
|
-
|
|
95
|
-
test('docsScreenshotHandler returns 400 for a viewport width that is not a positive integer', async () => {
|
|
96
|
-
const c = createContext('http://localhost:3227/lowdefy-docs/screenshot/home?viewportWidth=0');
|
|
97
|
-
|
|
98
|
-
const result = await docsScreenshotHandler(c);
|
|
99
|
-
|
|
100
|
-
expect(result.status).toBe(400);
|
|
101
|
-
expect(result.data.error).toMatch(/Viewport width must be a positive integer/);
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
test.each(['viewportWidth', 'viewportHeight'])(
|
|
105
|
-
'docsScreenshotHandler returns 400 naming a non-numeric %s',
|
|
106
|
-
async (key) => {
|
|
107
|
-
const c = createContext(`http://localhost:3227/lowdefy-docs/screenshot/home?${key}=wide`);
|
|
108
|
-
|
|
109
|
-
const result = await docsScreenshotHandler(c);
|
|
110
|
-
|
|
111
|
-
expect(result.status).toBe(400);
|
|
112
|
-
expect(result.data.error).toEqual(
|
|
113
|
-
`"${key}" must be a positive integer (CSS pixels). Received "wide".`
|
|
114
|
-
);
|
|
115
|
-
expect(mockScreenshotPage).not.toHaveBeenCalled();
|
|
116
|
-
}
|
|
117
|
-
);
|
|
@@ -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 docSources from '../../../lib/docs/docSources.js';
|
|
18
|
-
import searchDocs from '../../../lib/docs/searchDocs.js';
|
|
19
|
-
|
|
20
|
-
function docsSearchHandler(c) {
|
|
21
|
-
const query = c.req.query('q');
|
|
22
|
-
const source = c.req.query('source');
|
|
23
|
-
if (!query || query.trim() === '') {
|
|
24
|
-
return c.json(
|
|
25
|
-
{ error: 'Missing search query. Use GET /lowdefy-docs/search?q=your+keywords.' },
|
|
26
|
-
400
|
|
27
|
-
);
|
|
28
|
-
}
|
|
29
|
-
if (source !== undefined && !docSources.includes(source)) {
|
|
30
|
-
return c.json(
|
|
31
|
-
{
|
|
32
|
-
error: `Unknown docs source "${source}". Use one of: ${docSources.join(', ')}.`,
|
|
33
|
-
},
|
|
34
|
-
400
|
|
35
|
-
);
|
|
36
|
-
}
|
|
37
|
-
return c.json(searchDocs({ query, source }));
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
export default docsSearchHandler;
|
|
@@ -1,50 +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 { parseRequestBody } from '@lowdefy/api';
|
|
18
|
-
|
|
19
|
-
import snapshotState from '../../../lib/docs/snapshotState.js';
|
|
20
|
-
|
|
21
|
-
// Lets an agent (or a developer) snapshot the running app's page state and
|
|
22
|
-
// recorded request/api responses into a checkpoint folder under .lowdefy,
|
|
23
|
-
// for later replay via POST /lowdefy-docs/state/load.
|
|
24
|
-
async function docsSnapshotStateHandler(c) {
|
|
25
|
-
const { pageId, pathParams, name, notes, source, overwrite } = parseRequestBody({
|
|
26
|
-
text: await c.req.text(),
|
|
27
|
-
});
|
|
28
|
-
// Derived from the incoming request rather than a config value — this is
|
|
29
|
-
// the origin an agent can actually reach the dev server on (host/port it
|
|
30
|
-
// just connected to), regardless of how the server is bound.
|
|
31
|
-
const origin = new URL(c.req.url).origin;
|
|
32
|
-
|
|
33
|
-
const result = await snapshotState({
|
|
34
|
-
origin,
|
|
35
|
-
pageId,
|
|
36
|
-
pathParams,
|
|
37
|
-
name,
|
|
38
|
-
notes,
|
|
39
|
-
source,
|
|
40
|
-
overwrite,
|
|
41
|
-
});
|
|
42
|
-
if (result.error) {
|
|
43
|
-
// pathParams the page cannot be opened with are the caller's to fix, not a
|
|
44
|
-
// failed render.
|
|
45
|
-
return c.json({ error: result.error }, result.invalidInput ? 400 : 502);
|
|
46
|
-
}
|
|
47
|
-
return c.json(result);
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
export default docsSnapshotStateHandler;
|
|
@@ -1,26 +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 { listStateCheckpoints } from '../../../lib/docs/checkpointStore.js';
|
|
18
|
-
|
|
19
|
-
// Lists state checkpoints (page state + recorded request/api
|
|
20
|
-
// responses) — distinct from GET /lowdefy-docs/checkpoints, which lists
|
|
21
|
-
// config-directory-snapshot checkpoints (see checkpointStore.js).
|
|
22
|
-
function docsStateCheckpointsListHandler(c) {
|
|
23
|
-
return c.json(listStateCheckpoints());
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
export default docsStateCheckpointsListHandler;
|
package/src/routes/docs/types.js
DELETED
|
@@ -1,33 +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 listTypes from '../../../lib/docs/listTypes.js';
|
|
18
|
-
import normalizeTypeKind from '../../../lib/docs/normalizeTypeKind.js';
|
|
19
|
-
|
|
20
|
-
function docsTypesHandler(c) {
|
|
21
|
-
const kind = c.req.param('kind');
|
|
22
|
-
if (normalizeTypeKind({ kind }) === null) {
|
|
23
|
-
return c.json(
|
|
24
|
-
{
|
|
25
|
-
error: `Unknown docs kind "${kind}". Use one of: blocks, operators, actions, connections, requests, agents, notifications, websockets. See GET /lowdefy-docs for all routes.`,
|
|
26
|
-
},
|
|
27
|
-
404
|
|
28
|
-
);
|
|
29
|
-
}
|
|
30
|
-
return c.json(listTypes({ kind }));
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
export default docsTypesHandler;
|
package/src/routes/feedback.js
DELETED
|
@@ -1,107 +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 { parseRequestBody } from '@lowdefy/api';
|
|
18
|
-
|
|
19
|
-
import enrichFeedback from '../../lib/docs/enrichFeedback.js';
|
|
20
|
-
import formatFeedback from '../../lib/docs/formatFeedback.js';
|
|
21
|
-
import createLogger from '../../lib/server/log/createLogger.js';
|
|
22
|
-
import createSameOriginGuard from '../middleware/createSameOriginGuard.js';
|
|
23
|
-
|
|
24
|
-
const logger = createLogger({ server: 'lowdefy-dev-feedback' });
|
|
25
|
-
const guardSameOrigin = createSameOriginGuard();
|
|
26
|
-
|
|
27
|
-
// Receives annotation batches from the dev browser overlay (a developer
|
|
28
|
-
// draws on a live page and comments), enriches each annotation with its
|
|
29
|
-
// yaml file:line via findConfig, and returns the formatted agent-readable
|
|
30
|
-
// text. The overlay copies that text to the clipboard — the developer
|
|
31
|
-
// pastes it into whichever agent session they choose, which is also what
|
|
32
|
-
// makes delivery unambiguous when several sessions share one dev server.
|
|
33
|
-
// The same-origin guard the browser POST routes share: only a page served by
|
|
34
|
-
// this dev server (not an arbitrary site) should be able to use it.
|
|
35
|
-
async function feedbackHandler(c) {
|
|
36
|
-
const forbidden = guardSameOrigin(c);
|
|
37
|
-
if (forbidden) {
|
|
38
|
-
return forbidden;
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
const batch = parseRequestBody({ text: await c.req.text() });
|
|
42
|
-
if (!Array.isArray(batch?.annotations)) {
|
|
43
|
-
return c.json(
|
|
44
|
-
{
|
|
45
|
-
error:
|
|
46
|
-
'Feedback batch requires an "annotations" array. See GET /lowdefy-docs for the ' +
|
|
47
|
-
'feedback batch shape.',
|
|
48
|
-
},
|
|
49
|
-
400
|
|
50
|
-
);
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
// The tab screenshot rides in as a multi-MB data URL — lift it off the
|
|
54
|
-
// batch before enrichment so it never reaches the formatted text or the
|
|
55
|
-
// headless capture path.
|
|
56
|
-
const tabScreenshot = batch.screenshot;
|
|
57
|
-
delete batch.screenshot;
|
|
58
|
-
let enriched = await enrichFeedback({ batch });
|
|
59
|
-
delete enriched.screenshot;
|
|
60
|
-
|
|
61
|
-
// Default on — the overlay sends includeScreenshot: false when the
|
|
62
|
-
// developer unticks it.
|
|
63
|
-
if (batch.includeScreenshot !== false) {
|
|
64
|
-
const fileName = `${batch.pageId}-${new Date().toISOString().replace(/[:.]/g, '-')}.png`;
|
|
65
|
-
if (typeof tabScreenshot === 'string') {
|
|
66
|
-
// Preferred path: the overlay captured the developer's actual tab —
|
|
67
|
-
// theme, loaded data, exact pixels — with annotations already drawn.
|
|
68
|
-
const { default: saveAnnotatedScreenshot } = await import(
|
|
69
|
-
'../../lib/docs/saveAnnotatedScreenshot.js'
|
|
70
|
-
);
|
|
71
|
-
const result = saveAnnotatedScreenshot({ dataUrl: tabScreenshot, fileName });
|
|
72
|
-
if (result.path) {
|
|
73
|
-
enriched = { ...enriched, screenshotPath: result.path };
|
|
74
|
-
} else {
|
|
75
|
-
logger.warn(result.error);
|
|
76
|
-
}
|
|
77
|
-
} else {
|
|
78
|
-
// Fallback: re-render the page headless (batches from agents or older
|
|
79
|
-
// clients, or when the in-tab capture failed). The response must NOT
|
|
80
|
-
// wait for this capture: the overlay writes the clipboard when this
|
|
81
|
-
// returns, and Chrome's transient user-activation (required for
|
|
82
|
-
// clipboard writes) expires within ~5s — a headless browser launch can
|
|
83
|
-
// take longer. So the path is pre-assigned, the formatted text returns
|
|
84
|
-
// immediately, and the PNG lands on disk a moment later — well before
|
|
85
|
-
// a human pastes it anywhere.
|
|
86
|
-
// Deferred import: the capture module pulls in the browser singleton,
|
|
87
|
-
// which reads build artifacts at import time — only load it when a
|
|
88
|
-
// screenshot is actually wanted.
|
|
89
|
-
const { default: captureAnnotatedScreenshot } = await import(
|
|
90
|
-
'../../lib/docs/captureAnnotatedScreenshot.js'
|
|
91
|
-
);
|
|
92
|
-
const serverOrigin = new URL(c.req.url).origin;
|
|
93
|
-
enriched = { ...enriched, screenshotPath: `.lowdefy/annotations/${fileName}` };
|
|
94
|
-
captureAnnotatedScreenshot({ origin: serverOrigin, batch: enriched, fileName }).then(
|
|
95
|
-
(result) => {
|
|
96
|
-
if (result.error) {
|
|
97
|
-
logger.warn(result.error);
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
);
|
|
101
|
-
}
|
|
102
|
-
}
|
|
103
|
-
|
|
104
|
-
return c.json({ ok: true, formatted: formatFeedback({ items: [enriched] }) });
|
|
105
|
-
}
|
|
106
|
-
|
|
107
|
-
export default feedbackHandler;
|
|
@@ -1,204 +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 { Hono } from 'hono';
|
|
22
|
-
import { jest } from '@jest/globals';
|
|
23
|
-
|
|
24
|
-
// enrichFeedback (findConfig → force-builds a page) is covered on its own in
|
|
25
|
-
// lib/docs/formatFeedback.test.mjs — here it's stubbed as a pass-through so
|
|
26
|
-
// this file only exercises the route: origin check, validation, and enrich +
|
|
27
|
-
// format wiring.
|
|
28
|
-
const mockEnrichFeedback = jest.fn(async ({ batch }) => batch);
|
|
29
|
-
jest.unstable_mockModule('../../lib/docs/enrichFeedback.js', () => ({
|
|
30
|
-
default: mockEnrichFeedback,
|
|
31
|
-
}));
|
|
32
|
-
const mockCaptureAnnotatedScreenshot = jest.fn(async () => ({
|
|
33
|
-
path: '.lowdefy/annotations/test.png',
|
|
34
|
-
}));
|
|
35
|
-
jest.unstable_mockModule('../../lib/docs/captureAnnotatedScreenshot.js', () => ({
|
|
36
|
-
default: mockCaptureAnnotatedScreenshot,
|
|
37
|
-
}));
|
|
38
|
-
|
|
39
|
-
const { default: feedbackHandler } = await import('./feedback.js');
|
|
40
|
-
|
|
41
|
-
function createApp() {
|
|
42
|
-
const app = new Hono();
|
|
43
|
-
app.all('/api/feedback', feedbackHandler);
|
|
44
|
-
return app;
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
let configDirectory;
|
|
48
|
-
const originalConfigDirectory = process.env.LOWDEFY_DIRECTORY_CONFIG;
|
|
49
|
-
|
|
50
|
-
beforeEach(() => {
|
|
51
|
-
configDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-feedback-test-'));
|
|
52
|
-
process.env.LOWDEFY_DIRECTORY_CONFIG = configDirectory;
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
afterEach(() => {
|
|
56
|
-
mockEnrichFeedback.mockClear();
|
|
57
|
-
mockCaptureAnnotatedScreenshot.mockClear();
|
|
58
|
-
fs.rmSync(configDirectory, { recursive: true, force: true });
|
|
59
|
-
if (originalConfigDirectory === undefined) {
|
|
60
|
-
delete process.env.LOWDEFY_DIRECTORY_CONFIG;
|
|
61
|
-
} else {
|
|
62
|
-
process.env.LOWDEFY_DIRECTORY_CONFIG = originalConfigDirectory;
|
|
63
|
-
}
|
|
64
|
-
});
|
|
65
|
-
|
|
66
|
-
test('feedbackHandler returns 403 when the Origin header is missing', async () => {
|
|
67
|
-
const res = await createApp().request('/api/feedback', {
|
|
68
|
-
method: 'POST',
|
|
69
|
-
headers: { host: 'localhost:3001', 'content-type': 'application/json' },
|
|
70
|
-
body: JSON.stringify({ annotations: [] }),
|
|
71
|
-
});
|
|
72
|
-
expect(res.status).toEqual(403);
|
|
73
|
-
});
|
|
74
|
-
|
|
75
|
-
test('feedbackHandler returns 403 when the Origin host does not match the request host', async () => {
|
|
76
|
-
const res = await createApp().request('/api/feedback', {
|
|
77
|
-
method: 'POST',
|
|
78
|
-
headers: {
|
|
79
|
-
host: 'localhost:3001',
|
|
80
|
-
origin: 'http://evil.example.com',
|
|
81
|
-
'content-type': 'application/json',
|
|
82
|
-
},
|
|
83
|
-
body: JSON.stringify({ annotations: [] }),
|
|
84
|
-
});
|
|
85
|
-
expect(res.status).toEqual(403);
|
|
86
|
-
});
|
|
87
|
-
|
|
88
|
-
test('feedbackHandler returns 400 with a helpful message when annotations is missing', async () => {
|
|
89
|
-
const res = await createApp().request('/api/feedback', {
|
|
90
|
-
method: 'POST',
|
|
91
|
-
headers: {
|
|
92
|
-
host: 'localhost:3001',
|
|
93
|
-
origin: 'http://localhost:3001',
|
|
94
|
-
'content-type': 'application/json',
|
|
95
|
-
},
|
|
96
|
-
body: JSON.stringify({ pageId: 'login' }),
|
|
97
|
-
});
|
|
98
|
-
expect(res.status).toEqual(400);
|
|
99
|
-
const body = await res.json();
|
|
100
|
-
expect(body.error).toMatch(/annotations/);
|
|
101
|
-
expect(body.error).toMatch(/\/lowdefy-docs/);
|
|
102
|
-
});
|
|
103
|
-
|
|
104
|
-
test('feedbackHandler enriches a valid batch and returns the formatted text', async () => {
|
|
105
|
-
const batch = { pageId: 'login', annotations: [{ id: '1', kind: 'region', comment: 'x' }] };
|
|
106
|
-
const res = await createApp().request('/api/feedback', {
|
|
107
|
-
method: 'POST',
|
|
108
|
-
headers: {
|
|
109
|
-
host: 'localhost:3001',
|
|
110
|
-
origin: 'http://localhost:3001',
|
|
111
|
-
'content-type': 'application/json',
|
|
112
|
-
},
|
|
113
|
-
body: JSON.stringify(batch),
|
|
114
|
-
});
|
|
115
|
-
|
|
116
|
-
expect(res.status).toEqual(200);
|
|
117
|
-
const body = await res.json();
|
|
118
|
-
expect(body.ok).toBe(true);
|
|
119
|
-
expect(typeof body.formatted).toBe('string');
|
|
120
|
-
expect(body.formatted).toContain('login');
|
|
121
|
-
expect(mockEnrichFeedback).toHaveBeenCalledWith({ batch });
|
|
122
|
-
});
|
|
123
|
-
|
|
124
|
-
// A real 1x1 red PNG so the saved file is a valid image, not just bytes.
|
|
125
|
-
const PNG_1X1_BASE64 =
|
|
126
|
-
'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==';
|
|
127
|
-
|
|
128
|
-
test('feedbackHandler saves a tab-captured screenshot and skips the headless capture', async () => {
|
|
129
|
-
const batch = {
|
|
130
|
-
pageId: 'dashboard',
|
|
131
|
-
annotations: [{ id: '1', kind: 'region', comment: 'x' }],
|
|
132
|
-
screenshot: `data:image/png;base64,${PNG_1X1_BASE64}`,
|
|
133
|
-
};
|
|
134
|
-
const res = await createApp().request('/api/feedback', {
|
|
135
|
-
method: 'POST',
|
|
136
|
-
headers: {
|
|
137
|
-
host: 'localhost:3001',
|
|
138
|
-
origin: 'http://localhost:3001',
|
|
139
|
-
'content-type': 'application/json',
|
|
140
|
-
},
|
|
141
|
-
body: JSON.stringify(batch),
|
|
142
|
-
});
|
|
143
|
-
|
|
144
|
-
expect(res.status).toEqual(200);
|
|
145
|
-
const body = await res.json();
|
|
146
|
-
expect(body.ok).toBe(true);
|
|
147
|
-
expect(body.formatted).toContain('.lowdefy/annotations/dashboard-');
|
|
148
|
-
// The data URL must never leak into the agent-readable text.
|
|
149
|
-
expect(body.formatted).not.toContain(PNG_1X1_BASE64);
|
|
150
|
-
expect(mockCaptureAnnotatedScreenshot).not.toHaveBeenCalled();
|
|
151
|
-
|
|
152
|
-
const dir = path.join(configDirectory, '.lowdefy', 'annotations');
|
|
153
|
-
const files = fs.readdirSync(dir);
|
|
154
|
-
expect(files).toHaveLength(1);
|
|
155
|
-
expect(files[0]).toMatch(/^dashboard-.*\.png$/);
|
|
156
|
-
expect(fs.readFileSync(path.join(dir, files[0]))).toEqual(
|
|
157
|
-
Buffer.from(PNG_1X1_BASE64, 'base64')
|
|
158
|
-
);
|
|
159
|
-
});
|
|
160
|
-
|
|
161
|
-
test('feedbackHandler falls back to the headless capture when the screenshot is not a PNG data URL', async () => {
|
|
162
|
-
const batch = {
|
|
163
|
-
pageId: 'dashboard',
|
|
164
|
-
annotations: [{ id: '1', kind: 'region', comment: 'x' }],
|
|
165
|
-
screenshot: 'data:image/jpeg;base64,notpng',
|
|
166
|
-
};
|
|
167
|
-
const res = await createApp().request('/api/feedback', {
|
|
168
|
-
method: 'POST',
|
|
169
|
-
headers: {
|
|
170
|
-
host: 'localhost:3001',
|
|
171
|
-
origin: 'http://localhost:3001',
|
|
172
|
-
'content-type': 'application/json',
|
|
173
|
-
},
|
|
174
|
-
body: JSON.stringify(batch),
|
|
175
|
-
});
|
|
176
|
-
|
|
177
|
-
expect(res.status).toEqual(200);
|
|
178
|
-
const body = await res.json();
|
|
179
|
-
expect(body.ok).toBe(true);
|
|
180
|
-
// Not a valid tab capture — no file saved, and no screenshotPath claimed
|
|
181
|
-
// for it (the invalid-string branch logs a warning instead).
|
|
182
|
-
expect(fs.existsSync(path.join(configDirectory, '.lowdefy', 'annotations'))).toBe(false);
|
|
183
|
-
});
|
|
184
|
-
|
|
185
|
-
test('feedbackHandler uses the headless capture when the batch has no screenshot', async () => {
|
|
186
|
-
const batch = {
|
|
187
|
-
pageId: 'dashboard',
|
|
188
|
-
annotations: [{ id: '1', kind: 'region', comment: 'x' }],
|
|
189
|
-
};
|
|
190
|
-
const res = await createApp().request('/api/feedback', {
|
|
191
|
-
method: 'POST',
|
|
192
|
-
headers: {
|
|
193
|
-
host: 'localhost:3001',
|
|
194
|
-
origin: 'http://localhost:3001',
|
|
195
|
-
'content-type': 'application/json',
|
|
196
|
-
},
|
|
197
|
-
body: JSON.stringify(batch),
|
|
198
|
-
});
|
|
199
|
-
|
|
200
|
-
expect(res.status).toEqual(200);
|
|
201
|
-
const body = await res.json();
|
|
202
|
-
expect(body.formatted).toContain('.lowdefy/annotations/dashboard-');
|
|
203
|
-
expect(mockCaptureAnnotatedScreenshot).toHaveBeenCalledTimes(1);
|
|
204
|
-
});
|