@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
|
@@ -14,21 +14,49 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
+
import fs from 'fs';
|
|
18
|
+
|
|
17
19
|
import { Hono } from 'hono';
|
|
18
|
-
import {
|
|
20
|
+
import { vi, afterEach, expect, test } from 'vitest';
|
|
21
|
+
import { serializer } from '@lowdefy/helpers';
|
|
19
22
|
|
|
20
23
|
const { listTabs, registerTab, requestFromTab, unregisterTab, updateTabPage } = await import(
|
|
21
24
|
'../../lib/docs/tabChannel.js'
|
|
22
25
|
);
|
|
23
26
|
const { default: devInspectHandler } = await import('./devInspect.js');
|
|
27
|
+
const { default: inspectStateFromTab } = await import('../../lib/docs/inspectStateFromTab.js');
|
|
28
|
+
const { default: isTabAnswer } = await import('../lib/isTabAnswer.js');
|
|
29
|
+
const { default: localDevToolsOnly } = await import('../middleware/localDevToolsOnly.js');
|
|
30
|
+
|
|
31
|
+
// The tab channel's payloads, shared with @lowdefy/shell's dev-tab client tests.
|
|
32
|
+
const fixtures = JSON.parse(
|
|
33
|
+
fs.readFileSync(new URL('../../test/tabChannelFixtures.json', import.meta.url), 'utf8')
|
|
34
|
+
);
|
|
24
35
|
|
|
36
|
+
// As app.js mounts it: a phone paired with lowdefy dev --lan may answer, nothing else.
|
|
25
37
|
function createApp() {
|
|
26
38
|
const app = new Hono();
|
|
39
|
+
const tabChannelOnly = localDevToolsOnly({ allowPaired: isTabAnswer });
|
|
40
|
+
app.use('/api/dev-inspect', tabChannelOnly);
|
|
41
|
+
app.use('/api/dev-inspect/*', tabChannelOnly);
|
|
27
42
|
app.all('/api/dev-inspect', devInspectHandler);
|
|
28
43
|
app.all('/api/dev-inspect/*', devInspectHandler);
|
|
29
44
|
return app;
|
|
30
45
|
}
|
|
31
46
|
|
|
47
|
+
// A phone shell (Lowdefy Dev) sends no Origin; it names itself with x-lowdefy-shell. The
|
|
48
|
+
// manager's proxy marks one paired over the network with x-lowdefy-dev-remote.
|
|
49
|
+
const shellHeaders = {
|
|
50
|
+
host: 'localhost:3001',
|
|
51
|
+
'content-type': 'application/json',
|
|
52
|
+
'x-lowdefy-shell': '7.0.0',
|
|
53
|
+
};
|
|
54
|
+
const pairedShellHeaders = {
|
|
55
|
+
...shellHeaders,
|
|
56
|
+
host: '192.168.1.20:3001',
|
|
57
|
+
'x-lowdefy-dev-remote': '1',
|
|
58
|
+
};
|
|
59
|
+
|
|
32
60
|
const sameOriginHeaders = {
|
|
33
61
|
host: 'localhost:3001',
|
|
34
62
|
origin: 'http://localhost:3001',
|
|
@@ -41,7 +69,7 @@ afterEach(() => {
|
|
|
41
69
|
listTabs().forEach((tab) => unregisterTab({ id: tab.id }));
|
|
42
70
|
});
|
|
43
71
|
|
|
44
|
-
function connectTab({ id, pageId, send =
|
|
72
|
+
function connectTab({ id, pageId, send = vi.fn() }) {
|
|
45
73
|
registerTab({ id, send });
|
|
46
74
|
updateTabPage({ id, pageId, pathParams: {}, instanceKey: `page:${pageId}` });
|
|
47
75
|
}
|
|
@@ -131,7 +159,7 @@ test('POST /api/dev-inspect/page for a tab that already disconnected returns ok'
|
|
|
131
159
|
});
|
|
132
160
|
|
|
133
161
|
test('POST /api/dev-inspect resolves a pending tab request with the posted result', async () => {
|
|
134
|
-
const send =
|
|
162
|
+
const send = vi.fn();
|
|
135
163
|
connectTab({ id: 'tab-1', pageId: 'home', send });
|
|
136
164
|
const pending = requestFromTab({ pageId: 'home', event: 'inspect-request' });
|
|
137
165
|
const [, { requestId }] = send.mock.calls[0];
|
|
@@ -154,3 +182,100 @@ test('POST /api/dev-inspect returns 400 when requestId is missing', async () =>
|
|
|
154
182
|
});
|
|
155
183
|
expect(res.status).toBe(400);
|
|
156
184
|
});
|
|
185
|
+
|
|
186
|
+
function connectFixtureTab(send) {
|
|
187
|
+
registerTab({ id: 'phone', send });
|
|
188
|
+
updateTabPage({ id: 'phone', ...fixtures.page });
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
test("an inspect-request carries the page instance, and a shell's answer reads as the browser tab's", async () => {
|
|
192
|
+
const send = vi.fn();
|
|
193
|
+
connectFixtureTab(send);
|
|
194
|
+
const pending = inspectStateFromTab({ pageId: fixtures.page.pageId });
|
|
195
|
+
const [event, request] = send.mock.calls[0];
|
|
196
|
+
expect(event).toBe(fixtures.inspectRequest.event);
|
|
197
|
+
expect(request).toEqual({
|
|
198
|
+
requestId: expect.any(String),
|
|
199
|
+
...fixtures.page,
|
|
200
|
+
...fixtures.inspectRequest.payload,
|
|
201
|
+
});
|
|
202
|
+
|
|
203
|
+
const res = await createApp().request('/api/dev-inspect', {
|
|
204
|
+
method: 'POST',
|
|
205
|
+
headers: pairedShellHeaders,
|
|
206
|
+
body: JSON.stringify({
|
|
207
|
+
requestId: request.requestId,
|
|
208
|
+
result: serializer.serializeToString(fixtures.inspectResult),
|
|
209
|
+
}),
|
|
210
|
+
});
|
|
211
|
+
expect(res.status).toBe(200);
|
|
212
|
+
await expect(pending).resolves.toEqual(fixtures.inspectResult);
|
|
213
|
+
});
|
|
214
|
+
|
|
215
|
+
test("an eval-request carries the expression, and a shell's answer reads as the browser tab's", async () => {
|
|
216
|
+
const send = vi.fn();
|
|
217
|
+
connectFixtureTab(send);
|
|
218
|
+
const pending = inspectStateFromTab({
|
|
219
|
+
pageId: fixtures.page.pageId,
|
|
220
|
+
evaluate: true,
|
|
221
|
+
expression: fixtures.evalRequest.payload.expression,
|
|
222
|
+
});
|
|
223
|
+
const [event, request] = send.mock.calls[0];
|
|
224
|
+
expect(event).toBe(fixtures.evalRequest.event);
|
|
225
|
+
expect(request).toEqual({
|
|
226
|
+
requestId: expect.any(String),
|
|
227
|
+
...fixtures.page,
|
|
228
|
+
...fixtures.evalRequest.payload,
|
|
229
|
+
});
|
|
230
|
+
|
|
231
|
+
await createApp().request('/api/dev-inspect', {
|
|
232
|
+
method: 'POST',
|
|
233
|
+
headers: shellHeaders,
|
|
234
|
+
body: JSON.stringify({
|
|
235
|
+
requestId: request.requestId,
|
|
236
|
+
result: {
|
|
237
|
+
value: serializer.serializeToString(fixtures.evalResult.value),
|
|
238
|
+
errors: fixtures.evalResult.errors,
|
|
239
|
+
},
|
|
240
|
+
}),
|
|
241
|
+
});
|
|
242
|
+
await expect(pending).resolves.toEqual(fixtures.evalResult);
|
|
243
|
+
});
|
|
244
|
+
|
|
245
|
+
test('a paired phone shell posts the page it shows', async () => {
|
|
246
|
+
connectFixtureTab(vi.fn());
|
|
247
|
+
const res = await createApp().request('/api/dev-inspect/page', {
|
|
248
|
+
method: 'POST',
|
|
249
|
+
headers: pairedShellHeaders,
|
|
250
|
+
body: JSON.stringify({ tabId: 'phone', pageId: 'home', instanceKey: 'page:home' }),
|
|
251
|
+
});
|
|
252
|
+
expect(res.status).toBe(200);
|
|
253
|
+
expect(listTabs()[0].pageId).toBe('home');
|
|
254
|
+
});
|
|
255
|
+
|
|
256
|
+
test.each([
|
|
257
|
+
['lists the tabs', 'GET', '/api/dev-inspect'],
|
|
258
|
+
['gets another route', 'GET', '/api/dev-inspect/tabs/phone'],
|
|
259
|
+
['posts to another route', 'POST', '/api/dev-inspect/tabs/phone'],
|
|
260
|
+
])('a paired phone shell is refused when it %s', async (_, method, path) => {
|
|
261
|
+
const res = await createApp().request(path, { method, headers: pairedShellHeaders });
|
|
262
|
+
expect(res.status).toBe(403);
|
|
263
|
+
});
|
|
264
|
+
|
|
265
|
+
test('a request with no Origin that does not name a shell is refused', async () => {
|
|
266
|
+
const res = await createApp().request('/api/dev-inspect', {
|
|
267
|
+
method: 'POST',
|
|
268
|
+
headers: { host: 'localhost:3001', 'content-type': 'application/json' },
|
|
269
|
+
body: JSON.stringify({ requestId: 'r', result: {} }),
|
|
270
|
+
});
|
|
271
|
+
expect(res.status).toBe(403);
|
|
272
|
+
});
|
|
273
|
+
|
|
274
|
+
test('a page on another site is refused even when it names a shell', async () => {
|
|
275
|
+
const res = await createApp().request('/api/dev-inspect', {
|
|
276
|
+
method: 'POST',
|
|
277
|
+
headers: { ...shellHeaders, origin: 'https://evil.example' },
|
|
278
|
+
body: JSON.stringify({ requestId: 'r', result: {} }),
|
|
279
|
+
});
|
|
280
|
+
expect(res.status).toBe(403);
|
|
281
|
+
});
|
|
@@ -20,25 +20,11 @@ import appendRecords from '../../lib/server/recording/appendRecords.js';
|
|
|
20
20
|
import getBuildId from '../../lib/docs/getBuildId.js';
|
|
21
21
|
import readRecordingCookie from '../../lib/server/recording/readRecordingCookie.js';
|
|
22
22
|
import servedBuilds from '../../lib/server/recording/servedBuilds.js';
|
|
23
|
-
import
|
|
23
|
+
import isTabChannelCaller from '../lib/isTabChannelCaller.js';
|
|
24
|
+
import getConfigDirectory from '../../lib/docs/getConfigDirectory.js';
|
|
24
25
|
|
|
25
26
|
const MAX_RECORDS = 500;
|
|
26
27
|
|
|
27
|
-
// This route writes to disk, so unlike localDevToolsOnly it does not let a
|
|
28
|
-
// request with no Origin through: only the recorder in a same-origin dev tab
|
|
29
|
-
// posts here. Agents and curl have no reason to.
|
|
30
|
-
function isSameOrigin(c) {
|
|
31
|
-
const origin = c.req.header('origin');
|
|
32
|
-
if (!origin) {
|
|
33
|
-
return false;
|
|
34
|
-
}
|
|
35
|
-
try {
|
|
36
|
-
return new URL(origin).host === c.req.header('host');
|
|
37
|
-
} catch {
|
|
38
|
-
return false;
|
|
39
|
-
}
|
|
40
|
-
}
|
|
41
|
-
|
|
42
28
|
async function readBody(c) {
|
|
43
29
|
try {
|
|
44
30
|
return await c.req.json();
|
|
@@ -77,7 +63,10 @@ function stampRecord({ record, currentBuild, cookie }) {
|
|
|
77
63
|
// (or the build served now) and is appended to the trace file of its tab
|
|
78
64
|
// session (dev) or run (journey).
|
|
79
65
|
async function devRecordingHandler(c) {
|
|
80
|
-
|
|
66
|
+
// This route writes to disk, so unlike the dev tools it does not let any
|
|
67
|
+
// request with no Origin through: only a dev tab's recorder posts here, a
|
|
68
|
+
// browser tab's (same origin) or a phone shell's.
|
|
69
|
+
if (!isTabChannelCaller(c)) {
|
|
81
70
|
return c.json({ error: 'Forbidden' }, 403);
|
|
82
71
|
}
|
|
83
72
|
if (process.env.LOWDEFY_DEV_RECORD === 'false') {
|
|
@@ -19,9 +19,11 @@ import os from 'os';
|
|
|
19
19
|
import path from 'path';
|
|
20
20
|
import { Hono } from 'hono';
|
|
21
21
|
import { bodyLimit } from 'hono/body-limit';
|
|
22
|
-
import {
|
|
22
|
+
import { vi, afterEach, beforeEach, expect, test } from 'vitest';
|
|
23
|
+
import { buildSessionReport, readRecordings } from '@lowdefy/node-utils';
|
|
24
|
+
import validateTraceRecord from '@lowdefy/node-utils/journeyTrace/validateTraceRecord.js';
|
|
23
25
|
|
|
24
|
-
|
|
26
|
+
vi.doMock('../../lib/docs/getBuildId.js', () => ({
|
|
25
27
|
default: () => '2026-10-03T14:02:00.000Z',
|
|
26
28
|
}));
|
|
27
29
|
|
|
@@ -40,7 +42,7 @@ let configDirectory;
|
|
|
40
42
|
|
|
41
43
|
function createApp() {
|
|
42
44
|
const app = new Hono();
|
|
43
|
-
app.use('/api/dev-recording', localDevToolsOnly());
|
|
45
|
+
app.use('/api/dev-recording', localDevToolsOnly({ allowPaired: (c) => c.req.method === 'POST' }));
|
|
44
46
|
app.post('/api/dev-recording', bodyLimit({ maxSize: 1024 * 1024 }), devRecordingHandler);
|
|
45
47
|
return app;
|
|
46
48
|
}
|
|
@@ -120,6 +122,55 @@ test('POST /api/dev-recording refuses a request with no Origin', async () => {
|
|
|
120
122
|
expect(tracesExist()).toBe(false);
|
|
121
123
|
});
|
|
122
124
|
|
|
125
|
+
test("POST /api/dev-recording writes a phone shell's records, which carry no Origin", async () => {
|
|
126
|
+
const res = await createApp().request('/api/dev-recording', {
|
|
127
|
+
method: 'POST',
|
|
128
|
+
headers: {
|
|
129
|
+
host: '192.168.1.20:3001',
|
|
130
|
+
'content-type': 'application/json',
|
|
131
|
+
'x-lowdefy-shell': '7.0.0',
|
|
132
|
+
'x-lowdefy-dev-remote': '1',
|
|
133
|
+
},
|
|
134
|
+
body: JSON.stringify({ session: SESSION, records: [record()] }),
|
|
135
|
+
});
|
|
136
|
+
expect(res.status).toBe(204);
|
|
137
|
+
expect(readLines('dev', '2026-10-03', `${SESSION}.jsonl`)).toHaveLength(1);
|
|
138
|
+
});
|
|
139
|
+
|
|
140
|
+
// What Lowdefy Dev's recorder writes for a click, a fill and a select on a phone (shell
|
|
141
|
+
// src/dev/recorder/createNativeRecorder.test.js checks it writes exactly these).
|
|
142
|
+
const nativeFixture = JSON.parse(
|
|
143
|
+
fs.readFileSync(new URL('../../test/nativeRecordingFixture.json', import.meta.url), 'utf8')
|
|
144
|
+
);
|
|
145
|
+
|
|
146
|
+
test("a phone's native records pass the trace record validation and list as a session", async () => {
|
|
147
|
+
const { records } = nativeFixture;
|
|
148
|
+
const { session } = records[0];
|
|
149
|
+
const res = await createApp().request('/api/dev-recording', {
|
|
150
|
+
method: 'POST',
|
|
151
|
+
headers: {
|
|
152
|
+
host: '192.168.1.20:3001',
|
|
153
|
+
'content-type': 'application/json',
|
|
154
|
+
'x-lowdefy-shell': '7.4.0',
|
|
155
|
+
'x-lowdefy-dev-remote': '1',
|
|
156
|
+
},
|
|
157
|
+
body: JSON.stringify({ session, records }),
|
|
158
|
+
});
|
|
159
|
+
expect(res.status).toBe(204);
|
|
160
|
+
const lines = readLines('dev', '2026-10-18', `${session}.jsonl`);
|
|
161
|
+
expect(lines.map((line) => line.kind)).toEqual(['pageview', 'change', 'change', 'click']);
|
|
162
|
+
lines.forEach((line) => {
|
|
163
|
+
expect(validateTraceRecord({ record: line })).toEqual({});
|
|
164
|
+
expect(line).toMatchObject({ source: 'dev', device: 'ios', shell_version: '7.4.0' });
|
|
165
|
+
});
|
|
166
|
+
const { sessions } = buildSessionReport({
|
|
167
|
+
records: readRecordings({ configDirectory, source: 'dev' }),
|
|
168
|
+
});
|
|
169
|
+
expect(sessions).toEqual([
|
|
170
|
+
expect.objectContaining({ id: session, pages: ['ticket'], interactions: 3, failures: 0 }),
|
|
171
|
+
]);
|
|
172
|
+
});
|
|
173
|
+
|
|
123
174
|
test('POST /api/dev-recording answers 400 for a session id that is not a trace id', async () => {
|
|
124
175
|
for (const session of ['../x', '', `${SESSION}/../../x`]) {
|
|
125
176
|
const res = await post({ body: { session, records: [record()] } });
|
|
@@ -14,22 +14,22 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
import {
|
|
17
|
+
import { vi, expect, test } from 'vitest';
|
|
18
18
|
import { Hono } from 'hono';
|
|
19
19
|
|
|
20
|
-
|
|
20
|
+
vi.doMock('../../../lib/docs/clientErrorStore.js', () => ({
|
|
21
21
|
default: { list: () => [] },
|
|
22
22
|
}));
|
|
23
|
-
|
|
23
|
+
vi.doMock('../../../lib/docs/serverErrorStore.js', () => ({
|
|
24
24
|
default: { list: () => [] },
|
|
25
25
|
}));
|
|
26
|
-
|
|
26
|
+
vi.doMock('../../../lib/docs/getBuildId.js', () => ({
|
|
27
27
|
default: () => '2026-10-03T08:00:00.000Z',
|
|
28
28
|
}));
|
|
29
|
-
|
|
29
|
+
vi.doMock('../../../lib/docs/getPageBuildStatus.js', () => ({
|
|
30
30
|
default: () => ({ unbuilt: 0 }),
|
|
31
31
|
}));
|
|
32
|
-
|
|
32
|
+
vi.doMock('../../../lib/docs/readBuildArtifact.js', () => ({
|
|
33
33
|
default: () => ({ status: 'ok', errors: [], warnings: [] }),
|
|
34
34
|
}));
|
|
35
35
|
|
|
@@ -15,11 +15,11 @@
|
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
import { Hono } from 'hono';
|
|
18
|
-
import {
|
|
18
|
+
import { vi, beforeEach, expect, test } from 'vitest';
|
|
19
19
|
|
|
20
|
-
const mockSubscribe =
|
|
21
|
-
const mockUnsubscribe =
|
|
22
|
-
|
|
20
|
+
const mockSubscribe = vi.fn();
|
|
21
|
+
const mockUnsubscribe = vi.fn();
|
|
22
|
+
vi.doMock('../../../lib/docs/devEventBus.js', () => ({
|
|
23
23
|
bootedAt: '2026-05-06T07:08:09.000Z',
|
|
24
24
|
subscribe: mockSubscribe,
|
|
25
25
|
}));
|
package/src/routes/docs/find.js
CHANGED
|
@@ -14,11 +14,11 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
import {
|
|
17
|
+
import { UserError } from '@lowdefy/errors';
|
|
18
18
|
|
|
19
19
|
import findConfig from '../../../lib/docs/findConfig.js';
|
|
20
20
|
|
|
21
|
-
// findConfig throws a
|
|
21
|
+
// findConfig throws a UserError only for a missing or non-string id; every
|
|
22
22
|
// other failure is a fault and propagates to the error handler rather than
|
|
23
23
|
// being reported to the caller as bad input.
|
|
24
24
|
async function docsFindHandler(c) {
|
|
@@ -28,7 +28,7 @@ async function docsFindHandler(c) {
|
|
|
28
28
|
const result = await findConfig({ id, pageId });
|
|
29
29
|
return c.json(result);
|
|
30
30
|
} catch (error) {
|
|
31
|
-
if (error instanceof
|
|
31
|
+
if (error instanceof UserError) {
|
|
32
32
|
return c.json({ error: error.message }, 400);
|
|
33
33
|
}
|
|
34
34
|
throw error;
|
|
@@ -14,18 +14,18 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
import {
|
|
17
|
+
import { vi, beforeEach, expect, test } from 'vitest';
|
|
18
18
|
|
|
19
|
-
const mockRunJourney =
|
|
19
|
+
const mockRunJourney = vi.fn();
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
vi.doMock('../../../lib/docs/runJourney.js', () => ({
|
|
22
22
|
default: mockRunJourney,
|
|
23
23
|
}));
|
|
24
|
-
|
|
24
|
+
vi.doMock('../../../lib/build/config.js', () => ({
|
|
25
25
|
default: { basePath: '/app' },
|
|
26
26
|
}));
|
|
27
|
-
const mockGetBuildId =
|
|
28
|
-
|
|
27
|
+
const mockGetBuildId = vi.fn(() => 'build-1');
|
|
28
|
+
vi.doMock('../../../lib/docs/getBuildId.js', () => ({
|
|
29
29
|
default: mockGetBuildId,
|
|
30
30
|
}));
|
|
31
31
|
const { readMutantRun } = await import('../../../lib/server/mutants/mutantRuns.js');
|
|
@@ -39,12 +39,12 @@ function createContext(body) {
|
|
|
39
39
|
headers: { 'content-type': 'application/json' },
|
|
40
40
|
body: JSON.stringify(body),
|
|
41
41
|
});
|
|
42
|
-
const json =
|
|
42
|
+
const json = vi.fn((data, status) => ({ data, status: status ?? 200 }));
|
|
43
43
|
return { req: { url: request.url, json: () => request.json() }, json };
|
|
44
44
|
}
|
|
45
45
|
|
|
46
46
|
beforeEach(() => {
|
|
47
|
-
|
|
47
|
+
vi.clearAllMocks();
|
|
48
48
|
mockRunJourney.mockResolvedValue({
|
|
49
49
|
pageId: 'form',
|
|
50
50
|
passed: true,
|
|
@@ -14,19 +14,19 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
import {
|
|
17
|
+
import { vi, expect, test } from 'vitest';
|
|
18
18
|
|
|
19
19
|
// The real runner refuses these journeys before it fetches a browser; the mock
|
|
20
20
|
// proves it never gets that far.
|
|
21
|
-
const mockGetBrowser =
|
|
22
|
-
|
|
21
|
+
const mockGetBrowser = vi.fn();
|
|
22
|
+
vi.doMock('../../../lib/docs/getBrowser.js', () => ({
|
|
23
23
|
getBrowser: mockGetBrowser,
|
|
24
|
-
openPage:
|
|
25
|
-
buildPageUrl:
|
|
24
|
+
openPage: vi.fn(),
|
|
25
|
+
buildPageUrl: vi.fn(),
|
|
26
26
|
}));
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
default:
|
|
27
|
+
vi.doMock('../../../lib/build/config.js', () => ({ default: { basePath: '' } }));
|
|
28
|
+
vi.doMock('../../../lib/docs/getBuildId.js', () => ({
|
|
29
|
+
default: vi.fn(() => 'build-1'),
|
|
30
30
|
}));
|
|
31
31
|
|
|
32
32
|
const { default: docsJourneyHandler } = await import('./journey.js');
|
|
@@ -37,7 +37,7 @@ function createContext(body) {
|
|
|
37
37
|
headers: { 'content-type': 'application/json' },
|
|
38
38
|
body: JSON.stringify(body),
|
|
39
39
|
});
|
|
40
|
-
const json =
|
|
40
|
+
const json = vi.fn((data, status) => ({ data, status: status ?? 200 }));
|
|
41
41
|
return { req: { url: request.url, json: () => request.json() }, json };
|
|
42
42
|
}
|
|
43
43
|
|
|
@@ -0,0 +1,70 @@
|
|
|
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
|
+
let loading = null;
|
|
18
|
+
|
|
19
|
+
// The docs routes and the docs index they search, loaded on first use: their
|
|
20
|
+
// module graph (the MCP server, the journey runner, the doc readers) is most of
|
|
21
|
+
// what a child would otherwise evaluate before it answers its first request.
|
|
22
|
+
// Every caller shares one load, so the modules are evaluated once. A failed
|
|
23
|
+
// load is not kept, so the next docs request tries again.
|
|
24
|
+
function loadDocsRoutes() {
|
|
25
|
+
if (loading === null) {
|
|
26
|
+
loading = Promise.all([
|
|
27
|
+
import('./buildStatus.js'),
|
|
28
|
+
import('./events.js'),
|
|
29
|
+
import('./find.js'),
|
|
30
|
+
import('./index.js'),
|
|
31
|
+
import('./journey.js'),
|
|
32
|
+
import('./mcp.js'),
|
|
33
|
+
import('./mutants.js'),
|
|
34
|
+
import('./pageConfig.js'),
|
|
35
|
+
import('./restart.js'),
|
|
36
|
+
import('../../../lib/docs/getDocsIndex.js'),
|
|
37
|
+
]).then(
|
|
38
|
+
([
|
|
39
|
+
buildStatus,
|
|
40
|
+
events,
|
|
41
|
+
find,
|
|
42
|
+
index,
|
|
43
|
+
journey,
|
|
44
|
+
mcp,
|
|
45
|
+
mutants,
|
|
46
|
+
pageConfig,
|
|
47
|
+
restart,
|
|
48
|
+
docsIndex,
|
|
49
|
+
]) => ({
|
|
50
|
+
buildStatus: buildStatus.default,
|
|
51
|
+
events: events.default,
|
|
52
|
+
find: find.default,
|
|
53
|
+
index: index.default,
|
|
54
|
+
journey: journey.default,
|
|
55
|
+
mcp: mcp.default,
|
|
56
|
+
mutants: mutants.default,
|
|
57
|
+
pageConfig: pageConfig.default,
|
|
58
|
+
restart: restart.default,
|
|
59
|
+
getDocsIndex: docsIndex.default,
|
|
60
|
+
}),
|
|
61
|
+
(error) => {
|
|
62
|
+
loading = null;
|
|
63
|
+
throw error;
|
|
64
|
+
}
|
|
65
|
+
);
|
|
66
|
+
}
|
|
67
|
+
return loading;
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
export default loadDocsRoutes;
|
|
@@ -0,0 +1,110 @@
|
|
|
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
|
+
import fs from 'node:fs';
|
|
17
|
+
import os from 'node:os';
|
|
18
|
+
import path from 'node:path';
|
|
19
|
+
import { fileURLToPath } from 'node:url';
|
|
20
|
+
|
|
21
|
+
import { createServer } from 'vite';
|
|
22
|
+
import { afterAll, beforeAll, expect, test, vi } from 'vitest';
|
|
23
|
+
|
|
24
|
+
const serverRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../..');
|
|
25
|
+
const libDocsDirectory = path.join(serverRoot, 'lib', 'docs') + path.sep;
|
|
26
|
+
|
|
27
|
+
let vite;
|
|
28
|
+
let serverDirectory;
|
|
29
|
+
|
|
30
|
+
// The dev server loads src/app.js through Vite's SSR graph, so the docs routes
|
|
31
|
+
// are loaded that way here too: once statically (as reload.js and the other
|
|
32
|
+
// eager routes reach lib/docs) and once through loadDocsRoutes.
|
|
33
|
+
beforeAll(async () => {
|
|
34
|
+
serverDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'load-docs-routes-'));
|
|
35
|
+
fs.mkdirSync(path.join(serverDirectory, 'build'));
|
|
36
|
+
fs.writeFileSync(path.join(serverDirectory, 'build', 'config.json'), '{}');
|
|
37
|
+
vi.spyOn(process, 'cwd').mockReturnValue(serverDirectory);
|
|
38
|
+
vite = await createServer({
|
|
39
|
+
root: serverRoot,
|
|
40
|
+
configFile: false,
|
|
41
|
+
logLevel: 'silent',
|
|
42
|
+
appType: 'custom',
|
|
43
|
+
optimizeDeps: { noDiscovery: true, include: [] },
|
|
44
|
+
server: { middlewareMode: true, hmr: false, watch: null, ws: false },
|
|
45
|
+
});
|
|
46
|
+
});
|
|
47
|
+
|
|
48
|
+
afterAll(async () => {
|
|
49
|
+
await vite?.close();
|
|
50
|
+
vi.restoreAllMocks();
|
|
51
|
+
fs.rmSync(serverDirectory, { recursive: true, force: true });
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
// Every evaluated lib/docs module, by file, with the module instance Vite holds.
|
|
55
|
+
function libDocsInstances() {
|
|
56
|
+
const instances = new Map();
|
|
57
|
+
for (const mod of vite.moduleGraph.idToModuleMap.values()) {
|
|
58
|
+
if (mod.file?.startsWith(libDocsDirectory) && mod.ssrModule) {
|
|
59
|
+
expect(vite.moduleGraph.getModulesByFile(mod.file).size).toBe(1);
|
|
60
|
+
instances.set(mod.file, mod.ssrModule);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
return instances;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
test('loadDocsRoutes evaluates each lib/docs module once, also after Vite re-evaluates its importers', async () => {
|
|
67
|
+
const tabChannel = await vite.ssrLoadModule('/lib/docs/tabChannel.js');
|
|
68
|
+
const devEventBus = await vite.ssrLoadModule('/lib/docs/devEventBus.js');
|
|
69
|
+
await vite.ssrLoadModule('/src/routes/reload.js');
|
|
70
|
+
|
|
71
|
+
const { default: loadDocsRoutes } = await vite.ssrLoadModule(
|
|
72
|
+
'/src/routes/docs/loadDocsRoutes.js'
|
|
73
|
+
);
|
|
74
|
+
const [routes, again] = await Promise.all([loadDocsRoutes(), loadDocsRoutes()]);
|
|
75
|
+
expect(again).toBe(routes);
|
|
76
|
+
expect(Object.keys(routes).sort()).toEqual([
|
|
77
|
+
'buildStatus',
|
|
78
|
+
'events',
|
|
79
|
+
'find',
|
|
80
|
+
'getDocsIndex',
|
|
81
|
+
'index',
|
|
82
|
+
'journey',
|
|
83
|
+
'mcp',
|
|
84
|
+
'mutants',
|
|
85
|
+
'pageConfig',
|
|
86
|
+
'restart',
|
|
87
|
+
]);
|
|
88
|
+
|
|
89
|
+
const before = libDocsInstances();
|
|
90
|
+
expect(before.get(path.join(libDocsDirectory, 'createDocsMcpServer.js'))).toBeDefined();
|
|
91
|
+
expect(before.get(path.join(libDocsDirectory, 'tabChannel.js'))).toBe(tabChannel);
|
|
92
|
+
expect(before.get(path.join(libDocsDirectory, 'devEventBus.js'))).toBe(devEventBus);
|
|
93
|
+
|
|
94
|
+
// A change in the server's own graph re-evaluates src/ (app.js, the routes)
|
|
95
|
+
// but keeps the modules it did not touch.
|
|
96
|
+
for (const mod of [...vite.moduleGraph.idToModuleMap.values()]) {
|
|
97
|
+
if (mod.file?.startsWith(path.join(serverRoot, 'src') + path.sep)) {
|
|
98
|
+
vite.moduleGraph.invalidateModule(mod);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
const reloaded = await vite.ssrLoadModule('/src/routes/docs/loadDocsRoutes.js');
|
|
102
|
+
expect(reloaded.default).not.toBe(loadDocsRoutes);
|
|
103
|
+
await reloaded.default();
|
|
104
|
+
|
|
105
|
+
const after = libDocsInstances();
|
|
106
|
+
expect([...after.keys()].sort()).toEqual([...before.keys()].sort());
|
|
107
|
+
for (const [file, instance] of before) {
|
|
108
|
+
expect(after.get(file), file).toBe(instance);
|
|
109
|
+
}
|
|
110
|
+
});
|
|
@@ -15,15 +15,15 @@
|
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
import { Hono } from 'hono';
|
|
18
|
-
import {
|
|
18
|
+
import { vi, beforeEach, expect, test } from 'vitest';
|
|
19
19
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
20
20
|
|
|
21
21
|
// A real McpServer with the logging capability rides the real @hono/mcp
|
|
22
22
|
// transport, so the test covers the actual notification path; only the docs
|
|
23
23
|
// tool registrations and the bus subscription are stubbed out.
|
|
24
|
-
const mockSubscribeMcpServerToDevEvents =
|
|
25
|
-
const mockUnsubscribe =
|
|
26
|
-
|
|
24
|
+
const mockSubscribeMcpServerToDevEvents = vi.fn();
|
|
25
|
+
const mockUnsubscribe = vi.fn();
|
|
26
|
+
vi.doMock('../../../lib/docs/createDocsMcpServer.js', () => ({
|
|
27
27
|
default: () =>
|
|
28
28
|
new McpServer(
|
|
29
29
|
{ name: 'lowdefy-docs-test', version: '1.0.0' },
|
|
@@ -31,7 +31,7 @@ jest.unstable_mockModule('../../../lib/docs/createDocsMcpServer.js', () => ({
|
|
|
31
31
|
),
|
|
32
32
|
subscribeMcpServerToDevEvents: mockSubscribeMcpServerToDevEvents,
|
|
33
33
|
}));
|
|
34
|
-
|
|
34
|
+
vi.doMock('../../../lib/docs/devEventBus.js', () => ({
|
|
35
35
|
bootedAt: '2026-05-06T07:08:09.000Z',
|
|
36
36
|
}));
|
|
37
37
|
|
|
@@ -16,6 +16,8 @@
|
|
|
16
16
|
|
|
17
17
|
import path from 'node:path';
|
|
18
18
|
|
|
19
|
+
import { type } from '@lowdefy/helpers';
|
|
20
|
+
|
|
19
21
|
import buildPageIfNeeded from '../../../lib/server/jitPageBuilder.js';
|
|
20
22
|
import getBuildId from '../../../lib/docs/getBuildId.js';
|
|
21
23
|
import listMutants from '../../../lib/server/mutants/listMutants.js';
|
|
@@ -53,6 +55,11 @@ async function docsMutantsHandler(c) {
|
|
|
53
55
|
removedPages.add(pageId);
|
|
54
56
|
}
|
|
55
57
|
} catch (error) {
|
|
58
|
+
// A build error says what is wrong with the page; any other error is a
|
|
59
|
+
// fault of this route, for the error handler to log, not a page to fix.
|
|
60
|
+
if (type.isNone(error.buildErrors) && error.isLowdefyError !== true) {
|
|
61
|
+
throw error;
|
|
62
|
+
}
|
|
56
63
|
return c.json(
|
|
57
64
|
{
|
|
58
65
|
error: `Page "${pageId}" fails to build, so its mutants cannot be listed until the errors are fixed.`,
|