@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,51 +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 loadState from '../../../lib/docs/loadState.js';
|
|
20
|
-
import parseUserParam from './parseUserParam.js';
|
|
21
|
-
|
|
22
|
-
// Loads a state checkpoint back into the running app. mode: 'headless'
|
|
23
|
-
// (default) drives a headless page and injects state directly for an agent
|
|
24
|
-
// to verify; mode: 'registry-only' just loads the recorded requests into
|
|
25
|
-
// devMockRegistry and returns a URL for a human to open in a real browser
|
|
26
|
-
// tab (client/Inspector.jsx does the state injection there).
|
|
27
|
-
async function docsLoadStateHandler(c) {
|
|
28
|
-
const body = parseRequestBody({ text: await c.req.text() });
|
|
29
|
-
const { name, mode } = body;
|
|
30
|
-
// Derived from the incoming request rather than a config value — this is
|
|
31
|
-
// the origin an agent can actually reach the dev server on (host/port it
|
|
32
|
-
// just connected to), regardless of how the server is bound.
|
|
33
|
-
const origin = new URL(c.req.url).origin;
|
|
34
|
-
|
|
35
|
-
const { user, error: userError } = parseUserParam({ value: body.user });
|
|
36
|
-
if (userError) {
|
|
37
|
-
return c.json({ error: userError }, 400);
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
const result = await loadState({ origin, name, mode, user, data: body.data });
|
|
41
|
-
if (result.error) {
|
|
42
|
-
// A contradictory call (`user` in 'registry-only' mode) is the caller's
|
|
43
|
-
// mistake, not a failed render — 502 would read as "the renderer broke" and
|
|
44
|
-
// invite a pointless retry of the same request.
|
|
45
|
-
const status = result.invalidInput ? 400 : 502;
|
|
46
|
-
return c.json({ error: result.error }, status);
|
|
47
|
-
}
|
|
48
|
-
return c.json(result);
|
|
49
|
-
}
|
|
50
|
-
|
|
51
|
-
export default docsLoadStateHandler;
|
|
@@ -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 getPluginDoc from '../../../lib/docs/getPluginDoc.js';
|
|
18
|
-
|
|
19
|
-
function docsPluginDocHandler(c) {
|
|
20
|
-
const packageName = c.req.param('package');
|
|
21
|
-
const doc = getPluginDoc({ packageName });
|
|
22
|
-
if (doc === null) {
|
|
23
|
-
return c.json(
|
|
24
|
-
{
|
|
25
|
-
error: `Package "${packageName}" ships no markdown docs. See GET /lowdefy-docs/plugins for its types.`,
|
|
26
|
-
},
|
|
27
|
-
404
|
|
28
|
-
);
|
|
29
|
-
}
|
|
30
|
-
return c.text(doc.markdown, 200, { 'Content-Type': 'text/markdown; charset=utf-8' });
|
|
31
|
-
}
|
|
32
|
-
|
|
33
|
-
export default docsPluginDocHandler;
|
|
@@ -1,23 +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 listPlugins from '../../../lib/docs/listPlugins.js';
|
|
18
|
-
|
|
19
|
-
function docsPluginsHandler(c) {
|
|
20
|
-
return c.json(listPlugins());
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
export default docsPluginsHandler;
|
|
@@ -1,54 +0,0 @@
|
|
|
1
|
-
/*
|
|
2
|
-
Copyright 2020-2026 Lowdefy, Inc
|
|
3
|
-
|
|
4
|
-
Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
-
you may not use this file except in compliance with the License.
|
|
6
|
-
You may obtain a copy of the License at
|
|
7
|
-
|
|
8
|
-
http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
-
|
|
10
|
-
Unless required by applicable law or agreed to in writing, software
|
|
11
|
-
distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
-
See the License for the specific language governing permissions and
|
|
14
|
-
limitations under the License.
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
import { ConfigError } from '@lowdefy/errors';
|
|
18
|
-
|
|
19
|
-
import parseUserParam from './parseUserParam.js';
|
|
20
|
-
import runEndpoint from '../../../lib/docs/runEndpoint.js';
|
|
21
|
-
|
|
22
|
-
// Refusals, routine rejects and endpoint errors are returned as 200 data (see
|
|
23
|
-
// runEndpoint.js) - only malformed input (missing endpointId or a bad user,
|
|
24
|
-
// thrown as a ConfigError) is a 400. Anything else is a fault and propagates to
|
|
25
|
-
// the error handler.
|
|
26
|
-
async function docsRunEndpointHandler(c) {
|
|
27
|
-
// Parse the body from a clone: runEndpoint builds a Lowdefy context whose
|
|
28
|
-
// resolveAuthentication reads c.req.raw (headers) to resolve the caller,
|
|
29
|
-
// so leave the original request body intact and read our own copy here.
|
|
30
|
-
const { endpointId, payload, user, data, system, saveResponse } = await c.req.raw.clone().json();
|
|
31
|
-
const { user: parsedUser, error: userError } = parseUserParam({ value: user });
|
|
32
|
-
if (userError) {
|
|
33
|
-
return c.json({ error: userError }, 400);
|
|
34
|
-
}
|
|
35
|
-
try {
|
|
36
|
-
const result = await runEndpoint({
|
|
37
|
-
endpointId,
|
|
38
|
-
payload,
|
|
39
|
-
user: parsedUser,
|
|
40
|
-
data,
|
|
41
|
-
system,
|
|
42
|
-
saveResponse,
|
|
43
|
-
honoContext: c,
|
|
44
|
-
});
|
|
45
|
-
return c.json(result);
|
|
46
|
-
} catch (error) {
|
|
47
|
-
if (error instanceof ConfigError) {
|
|
48
|
-
return c.json({ error: error.message }, 400);
|
|
49
|
-
}
|
|
50
|
-
throw error;
|
|
51
|
-
}
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
export default docsRunEndpointHandler;
|
|
@@ -1,165 +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 mockRunEndpoint = jest.fn();
|
|
20
|
-
|
|
21
|
-
jest.unstable_mockModule('../../../lib/docs/runEndpoint.js', () => ({
|
|
22
|
-
default: mockRunEndpoint,
|
|
23
|
-
}));
|
|
24
|
-
|
|
25
|
-
const { ConfigError } = await import('@lowdefy/errors');
|
|
26
|
-
const { default: docsRunEndpointHandler } = await import('./runEndpoint.js');
|
|
27
|
-
|
|
28
|
-
function createContext(body) {
|
|
29
|
-
const request = new Request('http://localhost:3224/lowdefy-docs/run-endpoint', {
|
|
30
|
-
method: 'POST',
|
|
31
|
-
headers: { 'content-type': 'application/json' },
|
|
32
|
-
body: JSON.stringify(body),
|
|
33
|
-
});
|
|
34
|
-
const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
|
|
35
|
-
return { req: { raw: request }, json };
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
beforeEach(() => {
|
|
39
|
-
jest.clearAllMocks();
|
|
40
|
-
mockRunEndpoint.mockResolvedValue({ refused: false, status: 'success', response: { ok: true } });
|
|
41
|
-
});
|
|
42
|
-
|
|
43
|
-
test('docsRunEndpointHandler passes endpointId, payload and a user object through to runEndpoint', async () => {
|
|
44
|
-
const c = createContext({
|
|
45
|
-
endpointId: 'create_order',
|
|
46
|
-
payload: { sku: 'A1' },
|
|
47
|
-
user: { roles: ['admin'] },
|
|
48
|
-
});
|
|
49
|
-
|
|
50
|
-
const result = await docsRunEndpointHandler(c);
|
|
51
|
-
|
|
52
|
-
expect(mockRunEndpoint).toHaveBeenCalledWith({
|
|
53
|
-
endpointId: 'create_order',
|
|
54
|
-
payload: { sku: 'A1' },
|
|
55
|
-
user: { roles: ['admin'] },
|
|
56
|
-
system: undefined,
|
|
57
|
-
honoContext: c,
|
|
58
|
-
});
|
|
59
|
-
expect(result.status).toBe(200);
|
|
60
|
-
expect(result.data).toEqual({ refused: false, status: 'success', response: { ok: true } });
|
|
61
|
-
});
|
|
62
|
-
|
|
63
|
-
test('docsRunEndpointHandler leaves the original request body readable', async () => {
|
|
64
|
-
const c = createContext({ endpointId: 'create_order' });
|
|
65
|
-
|
|
66
|
-
await docsRunEndpointHandler(c);
|
|
67
|
-
|
|
68
|
-
expect(c.req.raw.bodyUsed).toBe(false);
|
|
69
|
-
await expect(c.req.raw.json()).resolves.toEqual({ endpointId: 'create_order' });
|
|
70
|
-
});
|
|
71
|
-
|
|
72
|
-
test('docsRunEndpointHandler returns 400 when user is malformed', async () => {
|
|
73
|
-
const c = createContext({ endpointId: 'create_order', user: '{nope' });
|
|
74
|
-
|
|
75
|
-
const result = await docsRunEndpointHandler(c);
|
|
76
|
-
|
|
77
|
-
expect(result.status).toBe(400);
|
|
78
|
-
expect(result.data.error).toMatch(/The "user" param must be JSON/);
|
|
79
|
-
expect(mockRunEndpoint).not.toHaveBeenCalled();
|
|
80
|
-
});
|
|
81
|
-
|
|
82
|
-
test('docsRunEndpointHandler passes a data set user name and data through', async () => {
|
|
83
|
-
const c = createContext({ endpointId: 'create_order', user: 'member', data: 'crm' });
|
|
84
|
-
|
|
85
|
-
await docsRunEndpointHandler(c);
|
|
86
|
-
|
|
87
|
-
expect(mockRunEndpoint).toHaveBeenCalledWith(
|
|
88
|
-
expect.objectContaining({ user: 'member', data: 'crm' })
|
|
89
|
-
);
|
|
90
|
-
});
|
|
91
|
-
|
|
92
|
-
test('docsRunEndpointHandler passes an undefined user when the body omits it', async () => {
|
|
93
|
-
const c = createContext({ endpointId: 'create_order' });
|
|
94
|
-
|
|
95
|
-
await docsRunEndpointHandler(c);
|
|
96
|
-
|
|
97
|
-
expect(mockRunEndpoint).toHaveBeenCalledWith({
|
|
98
|
-
endpointId: 'create_order',
|
|
99
|
-
payload: undefined,
|
|
100
|
-
user: undefined,
|
|
101
|
-
system: undefined,
|
|
102
|
-
honoContext: c,
|
|
103
|
-
});
|
|
104
|
-
});
|
|
105
|
-
|
|
106
|
-
test('docsRunEndpointHandler passes system through to runEndpoint', async () => {
|
|
107
|
-
const c = createContext({ endpointId: 'purge_stale', system: true });
|
|
108
|
-
|
|
109
|
-
await docsRunEndpointHandler(c);
|
|
110
|
-
|
|
111
|
-
expect(mockRunEndpoint).toHaveBeenCalledWith({
|
|
112
|
-
endpointId: 'purge_stale',
|
|
113
|
-
payload: undefined,
|
|
114
|
-
user: undefined,
|
|
115
|
-
system: true,
|
|
116
|
-
honoContext: c,
|
|
117
|
-
});
|
|
118
|
-
});
|
|
119
|
-
|
|
120
|
-
test('docsRunEndpointHandler returns 400 when system is combined with user', async () => {
|
|
121
|
-
mockRunEndpoint.mockRejectedValue(
|
|
122
|
-
new ConfigError('run_endpoint "system" cannot be combined with "user".')
|
|
123
|
-
);
|
|
124
|
-
const c = createContext({ endpointId: 'purge_stale', system: true, user: { roles: ['admin'] } });
|
|
125
|
-
|
|
126
|
-
const result = await docsRunEndpointHandler(c);
|
|
127
|
-
|
|
128
|
-
expect(result.status).toBe(400);
|
|
129
|
-
expect(result.data.error).toMatch(/cannot be combined with "user"/);
|
|
130
|
-
});
|
|
131
|
-
|
|
132
|
-
test('docsRunEndpointHandler returns 400 when runEndpoint throws a ConfigError', async () => {
|
|
133
|
-
mockRunEndpoint.mockRejectedValue(
|
|
134
|
-
new ConfigError('run_endpoint requires an "endpointId" string. Received undefined.')
|
|
135
|
-
);
|
|
136
|
-
const c = createContext({ payload: {} });
|
|
137
|
-
|
|
138
|
-
const result = await docsRunEndpointHandler(c);
|
|
139
|
-
|
|
140
|
-
expect(result.status).toBe(400);
|
|
141
|
-
expect(result.data.error).toMatch(/requires an "endpointId" string/);
|
|
142
|
-
});
|
|
143
|
-
|
|
144
|
-
test('docsRunEndpointHandler returns refusals and rejects as 200 data', async () => {
|
|
145
|
-
mockRunEndpoint.mockResolvedValue({
|
|
146
|
-
refused: false,
|
|
147
|
-
success: false,
|
|
148
|
-
status: 'reject',
|
|
149
|
-
error: { name: 'Error', message: 'Out of stock.' },
|
|
150
|
-
response: null,
|
|
151
|
-
});
|
|
152
|
-
const c = createContext({ endpointId: 'create_order' });
|
|
153
|
-
|
|
154
|
-
const result = await docsRunEndpointHandler(c);
|
|
155
|
-
|
|
156
|
-
expect(result.status).toBe(200);
|
|
157
|
-
expect(result.data.status).toBe('reject');
|
|
158
|
-
});
|
|
159
|
-
|
|
160
|
-
test('docsRunEndpointHandler rethrows faults that are not ConfigErrors', async () => {
|
|
161
|
-
mockRunEndpoint.mockRejectedValue(new Error('boom'));
|
|
162
|
-
const c = createContext({ endpointId: 'create_order' });
|
|
163
|
-
|
|
164
|
-
await expect(docsRunEndpointHandler(c)).rejects.toThrow('boom');
|
|
165
|
-
});
|
|
@@ -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 { ConfigError } from '@lowdefy/errors';
|
|
18
|
-
|
|
19
|
-
import parseUserParam from './parseUserParam.js';
|
|
20
|
-
import runRequest from '../../../lib/docs/runRequest.js';
|
|
21
|
-
|
|
22
|
-
// Refusals and request errors are returned as 200 data (see runRequest.js) —
|
|
23
|
-
// only malformed input (missing pageId/requestId, thrown as a ConfigError) is a
|
|
24
|
-
// 400. Anything else is a fault and propagates to the error handler.
|
|
25
|
-
async function docsRunRequestHandler(c) {
|
|
26
|
-
// Parse the body from a clone: runRequest builds a Lowdefy context whose
|
|
27
|
-
// resolveAuthentication reads c.req.raw (headers) to resolve the caller,
|
|
28
|
-
// so leave the original request body intact and read our own copy here.
|
|
29
|
-
const { pageId, requestId, payload, user, data, saveResponse } = await c.req.raw.clone().json();
|
|
30
|
-
const { user: parsedUser, error: userError } = parseUserParam({ value: user });
|
|
31
|
-
if (userError) {
|
|
32
|
-
return c.json({ error: userError }, 400);
|
|
33
|
-
}
|
|
34
|
-
try {
|
|
35
|
-
const result = await runRequest({
|
|
36
|
-
pageId,
|
|
37
|
-
requestId,
|
|
38
|
-
payload,
|
|
39
|
-
user: parsedUser,
|
|
40
|
-
data,
|
|
41
|
-
saveResponse,
|
|
42
|
-
honoContext: c,
|
|
43
|
-
});
|
|
44
|
-
return c.json(result);
|
|
45
|
-
} catch (error) {
|
|
46
|
-
if (error instanceof ConfigError) {
|
|
47
|
-
return c.json({ error: error.message }, 400);
|
|
48
|
-
}
|
|
49
|
-
throw error;
|
|
50
|
-
}
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
export default docsRunRequestHandler;
|
|
@@ -1,92 +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 mockRunRequest = jest.fn();
|
|
20
|
-
|
|
21
|
-
jest.unstable_mockModule('../../../lib/docs/runRequest.js', () => ({
|
|
22
|
-
default: mockRunRequest,
|
|
23
|
-
}));
|
|
24
|
-
|
|
25
|
-
const { default: docsRunRequestHandler } = await import('./runRequest.js');
|
|
26
|
-
|
|
27
|
-
function createContext(body) {
|
|
28
|
-
const request = new Request('http://localhost:3204/lowdefy-docs/run-request', {
|
|
29
|
-
method: 'POST',
|
|
30
|
-
headers: { 'content-type': 'application/json' },
|
|
31
|
-
body: JSON.stringify(body),
|
|
32
|
-
});
|
|
33
|
-
const json = jest.fn((data, status) => ({ data, status: status ?? 200 }));
|
|
34
|
-
return { req: { raw: request }, json };
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
beforeEach(() => {
|
|
38
|
-
jest.clearAllMocks();
|
|
39
|
-
mockRunRequest.mockResolvedValue({ refused: false, response: [] });
|
|
40
|
-
});
|
|
41
|
-
|
|
42
|
-
test('docsRunRequestHandler passes a user object through to runRequest', async () => {
|
|
43
|
-
const c = createContext({
|
|
44
|
-
pageId: 'home',
|
|
45
|
-
requestId: 'get_rows',
|
|
46
|
-
user: { roles: ['admin'] },
|
|
47
|
-
});
|
|
48
|
-
|
|
49
|
-
await docsRunRequestHandler(c);
|
|
50
|
-
|
|
51
|
-
expect(mockRunRequest).toHaveBeenCalledWith({
|
|
52
|
-
pageId: 'home',
|
|
53
|
-
requestId: 'get_rows',
|
|
54
|
-
payload: undefined,
|
|
55
|
-
user: { roles: ['admin'] },
|
|
56
|
-
honoContext: c,
|
|
57
|
-
});
|
|
58
|
-
});
|
|
59
|
-
|
|
60
|
-
test('docsRunRequestHandler returns 400 when user is malformed', async () => {
|
|
61
|
-
const c = createContext({ pageId: 'home', requestId: 'get_rows', user: 42 });
|
|
62
|
-
|
|
63
|
-
const result = await docsRunRequestHandler(c);
|
|
64
|
-
|
|
65
|
-
expect(result.status).toBe(400);
|
|
66
|
-
expect(result.data.error).toMatch(/must be a user object/);
|
|
67
|
-
expect(mockRunRequest).not.toHaveBeenCalled();
|
|
68
|
-
});
|
|
69
|
-
|
|
70
|
-
test('docsRunRequestHandler passes a data set user name and data through', async () => {
|
|
71
|
-
const c = createContext({ pageId: 'home', requestId: 'get_rows', user: 'member', data: 'crm' });
|
|
72
|
-
|
|
73
|
-
await docsRunRequestHandler(c);
|
|
74
|
-
|
|
75
|
-
expect(mockRunRequest).toHaveBeenCalledWith(
|
|
76
|
-
expect.objectContaining({ user: 'member', data: 'crm' })
|
|
77
|
-
);
|
|
78
|
-
});
|
|
79
|
-
|
|
80
|
-
test('docsRunRequestHandler passes an undefined user when the body omits it', async () => {
|
|
81
|
-
const c = createContext({ pageId: 'home', requestId: 'get_rows' });
|
|
82
|
-
|
|
83
|
-
await docsRunRequestHandler(c);
|
|
84
|
-
|
|
85
|
-
expect(mockRunRequest).toHaveBeenCalledWith({
|
|
86
|
-
pageId: 'home',
|
|
87
|
-
requestId: 'get_rows',
|
|
88
|
-
payload: undefined,
|
|
89
|
-
user: undefined,
|
|
90
|
-
honoContext: c,
|
|
91
|
-
});
|
|
92
|
-
});
|
|
@@ -1,37 +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 getSchema from '../../../lib/docs/getSchema.js';
|
|
18
|
-
|
|
19
|
-
function docsSchemaHandler(c) {
|
|
20
|
-
const kind = c.req.param('kind');
|
|
21
|
-
const type = c.req.param('type');
|
|
22
|
-
let schema;
|
|
23
|
-
try {
|
|
24
|
-
schema = getSchema({ kind, type });
|
|
25
|
-
} catch (error) {
|
|
26
|
-
return c.json({ error: error.message }, 400);
|
|
27
|
-
}
|
|
28
|
-
if (schema === null) {
|
|
29
|
-
return c.json(
|
|
30
|
-
{ error: `No schema found for ${kind} type "${type}". See GET /lowdefy-docs/${kind} for available types.` },
|
|
31
|
-
404
|
|
32
|
-
);
|
|
33
|
-
}
|
|
34
|
-
return c.json(schema);
|
|
35
|
-
}
|
|
36
|
-
|
|
37
|
-
export default docsSchemaHandler;
|
|
@@ -1,120 +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 parsePathParamsParam from './parsePathParamsParam.js';
|
|
20
|
-
import parseUserParam from './parseUserParam.js';
|
|
21
|
-
import screenshotPage from '../../../lib/docs/screenshotPage.js';
|
|
22
|
-
import validateViewport from '../../../lib/docs/validateViewport.js';
|
|
23
|
-
|
|
24
|
-
// Parses a query param as a number, or undefined if absent/not a valid
|
|
25
|
-
// number — undefined (not NaN/0) so callers can tell "not provided" apart
|
|
26
|
-
// from an explicit 0.
|
|
27
|
-
function queryNumber(c, key) {
|
|
28
|
-
const raw = c.req.query(key);
|
|
29
|
-
if (type.isNone(raw)) {
|
|
30
|
-
return undefined;
|
|
31
|
-
}
|
|
32
|
-
const value = Number(raw);
|
|
33
|
-
return Number.isFinite(value) ? value : undefined;
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
async function docsScreenshotHandler(c) {
|
|
37
|
-
const pageId = c.req.param('pageId');
|
|
38
|
-
const fullPage = c.req.query('fullPage') === 'true';
|
|
39
|
-
// Derived from the incoming request rather than a config value — this is
|
|
40
|
-
// the origin an agent can actually reach the dev server on (host/port it
|
|
41
|
-
// just connected to), regardless of how the server is bound.
|
|
42
|
-
const origin = new URL(c.req.url).origin;
|
|
43
|
-
|
|
44
|
-
const clipX = queryNumber(c, 'x');
|
|
45
|
-
const clipY = queryNumber(c, 'y');
|
|
46
|
-
const clipWidth = queryNumber(c, 'width');
|
|
47
|
-
const clipHeight = queryNumber(c, 'height');
|
|
48
|
-
// Only build a clip when all four dimensions are present — a partial
|
|
49
|
-
// clip is ambiguous, so screenshotPage falls back to a normal viewport
|
|
50
|
-
// screenshot in that case (same as an invalid clip).
|
|
51
|
-
const clip =
|
|
52
|
-
!type.isNone(clipX) &&
|
|
53
|
-
!type.isNone(clipY) &&
|
|
54
|
-
!type.isNone(clipWidth) &&
|
|
55
|
-
!type.isNone(clipHeight)
|
|
56
|
-
? { x: clipX, y: clipY, width: clipWidth, height: clipHeight }
|
|
57
|
-
: undefined;
|
|
58
|
-
const scrollX = queryNumber(c, 'scrollX') ?? 0;
|
|
59
|
-
const scrollY = queryNumber(c, 'scrollY') ?? 0;
|
|
60
|
-
|
|
61
|
-
// `width` and `height` name the clip here, so the viewport size takes the
|
|
62
|
-
// `viewport` prefix; the MCP tool, which nests the clip, calls them width
|
|
63
|
-
// and height.
|
|
64
|
-
for (const key of ['viewportWidth', 'viewportHeight']) {
|
|
65
|
-
const raw = c.req.query(key);
|
|
66
|
-
if (!type.isNone(raw) && type.isUndefined(queryNumber(c, key))) {
|
|
67
|
-
return c.json(
|
|
68
|
-
{
|
|
69
|
-
error: `"${key}" must be a positive integer (CSS pixels). Received ${JSON.stringify(
|
|
70
|
-
raw
|
|
71
|
-
)}.`,
|
|
72
|
-
},
|
|
73
|
-
400
|
|
74
|
-
);
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
const width = queryNumber(c, 'viewportWidth');
|
|
78
|
-
const height = queryNumber(c, 'viewportHeight');
|
|
79
|
-
const colorScheme = c.req.query('colorScheme');
|
|
80
|
-
const viewportError = validateViewport({ width, height, colorScheme });
|
|
81
|
-
if (viewportError) {
|
|
82
|
-
return c.json({ error: viewportError }, 400);
|
|
83
|
-
}
|
|
84
|
-
|
|
85
|
-
const { user, error: userError } = parseUserParam({ value: c.req.query('user') });
|
|
86
|
-
if (userError) {
|
|
87
|
-
return c.json({ error: userError }, 400);
|
|
88
|
-
}
|
|
89
|
-
|
|
90
|
-
const { pathParams, error: pathParamsError } = parsePathParamsParam({
|
|
91
|
-
value: c.req.query('pathParams'),
|
|
92
|
-
});
|
|
93
|
-
if (pathParamsError) {
|
|
94
|
-
return c.json({ error: pathParamsError }, 400);
|
|
95
|
-
}
|
|
96
|
-
|
|
97
|
-
const result = await screenshotPage({
|
|
98
|
-
origin,
|
|
99
|
-
pageId,
|
|
100
|
-
pathParams,
|
|
101
|
-
fullPage,
|
|
102
|
-
clip,
|
|
103
|
-
scrollX,
|
|
104
|
-
scrollY,
|
|
105
|
-
user,
|
|
106
|
-
data: c.req.query('data'),
|
|
107
|
-
width,
|
|
108
|
-
height,
|
|
109
|
-
colorScheme,
|
|
110
|
-
});
|
|
111
|
-
if (result.error) {
|
|
112
|
-
// pathParams the page cannot be opened with are the caller's to fix, not a
|
|
113
|
-
// failed render.
|
|
114
|
-
return c.json({ error: result.error }, result.invalidInput ? 400 : 502);
|
|
115
|
-
}
|
|
116
|
-
const buffer = Buffer.from(result.data, 'base64');
|
|
117
|
-
return c.body(buffer, 200, { 'Content-Type': result.mimeType });
|
|
118
|
-
}
|
|
119
|
-
|
|
120
|
-
export default docsScreenshotHandler;
|