@lowdefy/server-dev 7.1.0 → 7.3.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 +101 -143
- 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.js +6 -5
- package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
- 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 +18 -4
- package/lib/docs/observe/evaluateInvariants.js +23 -0
- package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
- package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
- package/lib/docs/observe/toAppErrorFailure.js +7 -4
- package/lib/docs/observe/watchJourneyContext.js +1 -0
- package/lib/docs/observe/withAppErrors.test.mjs +22 -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/lib/vite/keepIdleConnectionsOpen.js +36 -0
- package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -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 +167 -29
- package/manager/processes/startProxy.pairing.test.mjs +204 -0
- package/manager/processes/startProxy.test.mjs +130 -5
- 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 +54 -53
- package/package.original.json +54 -53
- 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/requestTimeout.js +7 -1
- 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 +15 -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
|
@@ -17,12 +17,13 @@
|
|
|
17
17
|
import { Hono } from 'hono';
|
|
18
18
|
|
|
19
19
|
import localDevToolsOnly from './localDevToolsOnly.js';
|
|
20
|
+
import { expect, test } from 'vitest';
|
|
20
21
|
|
|
21
22
|
function request({ headers, method = 'POST' }) {
|
|
22
23
|
const app = new Hono();
|
|
23
24
|
app.use('/lowdefy-docs/*', localDevToolsOnly());
|
|
24
|
-
app.all('/lowdefy-docs/
|
|
25
|
-
return app.request('/lowdefy-docs/
|
|
25
|
+
app.all('/lowdefy-docs/journey', (c) => c.json({ allowed: true }));
|
|
26
|
+
return app.request('/lowdefy-docs/journey', { headers, method });
|
|
26
27
|
}
|
|
27
28
|
|
|
28
29
|
test.each([
|
|
@@ -59,3 +60,36 @@ test.each([
|
|
|
59
60
|
const res = await request({ headers });
|
|
60
61
|
expect(res.status).toEqual(403);
|
|
61
62
|
});
|
|
63
|
+
|
|
64
|
+
test.each([
|
|
65
|
+
['with no origin', { host: '192.168.1.20:4102', 'x-lowdefy-dev-remote': '1' }],
|
|
66
|
+
[
|
|
67
|
+
'from its own page',
|
|
68
|
+
{
|
|
69
|
+
host: '192.168.1.20:4102',
|
|
70
|
+
origin: 'http://192.168.1.20:4102',
|
|
71
|
+
'sec-fetch-site': 'same-origin',
|
|
72
|
+
'x-lowdefy-dev-remote': '1',
|
|
73
|
+
},
|
|
74
|
+
],
|
|
75
|
+
])(
|
|
76
|
+
'localDevToolsOnly refuses a paired phone (the proxy marked it remote) %s',
|
|
77
|
+
async (_, headers) => {
|
|
78
|
+
const res = await request({ headers });
|
|
79
|
+
expect(res.status).toEqual(403);
|
|
80
|
+
expect((await res.json()).error).toEqual(
|
|
81
|
+
'The dev tools answer only on the computer running lowdefy dev.'
|
|
82
|
+
);
|
|
83
|
+
}
|
|
84
|
+
);
|
|
85
|
+
|
|
86
|
+
test('localDevToolsOnly lets a paired phone through only where allowPaired says so', async () => {
|
|
87
|
+
const app = new Hono();
|
|
88
|
+
app.use('/api/dev-recording', localDevToolsOnly({ allowPaired: (c) => c.req.method === 'POST' }));
|
|
89
|
+
app.all('/api/dev-recording', (c) => c.json({ allowed: true }));
|
|
90
|
+
const headers = { host: '192.168.1.20:4102', 'x-lowdefy-dev-remote': '1' };
|
|
91
|
+
const posted = await app.request('/api/dev-recording', { headers, method: 'POST' });
|
|
92
|
+
const read = await app.request('/api/dev-recording', { headers, method: 'GET' });
|
|
93
|
+
expect(posted.status).toEqual(200);
|
|
94
|
+
expect(read.status).toEqual(403);
|
|
95
|
+
});
|
|
@@ -22,6 +22,12 @@ import { timeout } from 'hono/timeout';
|
|
|
22
22
|
// timeout signal (which apiContext folds into context.signal) cancels the upstream
|
|
23
23
|
// calls the handler is waiting on, such as an AI provider call, instead of letting
|
|
24
24
|
// them run, and bill, after the response has gone.
|
|
25
|
+
//
|
|
26
|
+
// The 504 has no body. The handler runs on after the 504 is sent, on the same context:
|
|
27
|
+
// a header set on it then, by the middleware around the handler or by the handler
|
|
28
|
+
// itself (c.redirect sets one), makes hono rebuild the sent 504 from its body. Sending
|
|
29
|
+
// it has already read that body, so the rebuild throws. A response with no body
|
|
30
|
+
// rebuilds safely. The client reads any 504 as a timeout.
|
|
25
31
|
function requestTimeout({ timeoutMs }) {
|
|
26
32
|
return function requestTimeoutMiddleware(c, next) {
|
|
27
33
|
const controller = new AbortController();
|
|
@@ -30,7 +36,7 @@ function requestTimeout({ timeoutMs }) {
|
|
|
30
36
|
controller.abort(
|
|
31
37
|
new DOMException(`The request timeout of ${timeoutMs}ms was exceeded.`, 'TimeoutError')
|
|
32
38
|
);
|
|
33
|
-
return new HTTPException(504, {
|
|
39
|
+
return new HTTPException(504, { res: new Response(null, { status: 504 }) });
|
|
34
40
|
})(c, next);
|
|
35
41
|
};
|
|
36
42
|
}
|
|
@@ -19,6 +19,7 @@ import os from 'os';
|
|
|
19
19
|
import path from 'path';
|
|
20
20
|
|
|
21
21
|
import { Hono } from 'hono';
|
|
22
|
+
import { expect, test } from 'vitest';
|
|
22
23
|
|
|
23
24
|
// The middleware reads build/buildStatus.json from process.cwd() via
|
|
24
25
|
// readBuildArtifact — point it at a throwaway server directory before import.
|
|
@@ -0,0 +1,183 @@
|
|
|
1
|
+
/*
|
|
2
|
+
Copyright 2020-2026 Lowdefy, Inc
|
|
3
|
+
|
|
4
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
you may not use this file except in compliance with the License.
|
|
6
|
+
You may obtain a copy of the License at
|
|
7
|
+
|
|
8
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
|
|
10
|
+
Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
See the License for the specific language governing permissions and
|
|
14
|
+
limitations under the License.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import fs from 'fs';
|
|
18
|
+
import path from 'path';
|
|
19
|
+
import { fileURLToPath } from 'url';
|
|
20
|
+
|
|
21
|
+
import { Hono } from 'hono';
|
|
22
|
+
import { vi, afterAll, beforeEach, expect, test } from 'vitest';
|
|
23
|
+
|
|
24
|
+
// A phone shell (Lowdefy Dev, or a shell paired with `lowdefy dev --lan`) calls /api/agent with
|
|
25
|
+
// its session as a bearer, the x-lowdefy-shell header and no cookie. The route sits behind the
|
|
26
|
+
// same apiContext middleware (createLowdefyContext) as /api/request and /api/endpoints, so the
|
|
27
|
+
// caller is resolved by the one resolver (resolveAuthentication) from the request's own headers,
|
|
28
|
+
// on its general (not MCP) branch. resolveAuthentication's bearer branch itself is covered in
|
|
29
|
+
// @lowdefy/api; this pins that the agent route reaches it and runs as the caller it resolves.
|
|
30
|
+
|
|
31
|
+
const sessions = { 'phone-session-token': { id: 'u-phone', roles: ['member'] } };
|
|
32
|
+
|
|
33
|
+
const mockResolveAuthentication = vi.fn(async (context, { headers }) => {
|
|
34
|
+
const authorization = headers.get('authorization') ?? '';
|
|
35
|
+
const token = authorization.startsWith('Bearer ') ? authorization.slice(7) : null;
|
|
36
|
+
context.user = sessions[token] ?? null;
|
|
37
|
+
});
|
|
38
|
+
const mockCallAgent = vi.fn(async () => ({
|
|
39
|
+
response: new Response('data: {"type":"start"}\n\ndata: [DONE]\n\n'),
|
|
40
|
+
}));
|
|
41
|
+
|
|
42
|
+
vi.doMock('@lowdefy/api', () => ({
|
|
43
|
+
callAgent: mockCallAgent,
|
|
44
|
+
createApiContext: vi.fn(),
|
|
45
|
+
createRequestSignal: vi.fn(({ clientSignal }) => clientSignal),
|
|
46
|
+
ensureMcpOauthResource: vi.fn(async () => {}),
|
|
47
|
+
normalizeInjectedCaller: vi.fn((user) => user),
|
|
48
|
+
parseRequestBody: ({ text }) => JSON.parse(text),
|
|
49
|
+
resolveAuthentication: mockResolveAuthentication,
|
|
50
|
+
resolvePinnedOrganization: vi.fn(async () => {}),
|
|
51
|
+
resolveTenantPreflight: vi.fn(async () => {}),
|
|
52
|
+
}));
|
|
53
|
+
vi.doMock('../../lib/build/appMeta.js', () => ({ default: {} }));
|
|
54
|
+
vi.doMock('../../lib/build/config.js', () => ({ default: {} }));
|
|
55
|
+
vi.doMock('../../lib/build/auth.js', () => ({ default: {} }));
|
|
56
|
+
vi.doMock('../../lib/build/i18n.js', () => ({ default: {} }));
|
|
57
|
+
vi.doMock('../../lib/server/log/createHandleError.js', () => ({
|
|
58
|
+
default: vi.fn(() => vi.fn()),
|
|
59
|
+
}));
|
|
60
|
+
vi.doMock('../../lib/server/log/createLogger.js', () => ({
|
|
61
|
+
default: vi.fn(() => ({
|
|
62
|
+
debug: vi.fn(),
|
|
63
|
+
info: vi.fn(),
|
|
64
|
+
warn: vi.fn(),
|
|
65
|
+
error: vi.fn(),
|
|
66
|
+
})),
|
|
67
|
+
}));
|
|
68
|
+
vi.doMock('../../lib/server/fileCache.js', () => ({ default: {} }));
|
|
69
|
+
vi.doMock('../../lib/server/auth/getAuth.js', () => ({
|
|
70
|
+
default: vi.fn(() => ({ api: {} })),
|
|
71
|
+
}));
|
|
72
|
+
vi.doMock('../../lib/server/auth/getMockUser.js', () => ({
|
|
73
|
+
default: vi.fn(() => undefined),
|
|
74
|
+
}));
|
|
75
|
+
vi.doMock('../../lib/server/auth/getStrategies.js', () => ({
|
|
76
|
+
default: vi.fn(() => null),
|
|
77
|
+
}));
|
|
78
|
+
vi.doMock('../../lib/server/loadDynamicJsMap.js', () => ({
|
|
79
|
+
default: vi.fn(() => ({})),
|
|
80
|
+
}));
|
|
81
|
+
vi.doMock('../../lib/server/log/logRequest.js', () => ({ default: vi.fn() }));
|
|
82
|
+
|
|
83
|
+
// createLowdefyContext statically imports the app build's plugin artifacts, which only exist in a
|
|
84
|
+
// built app (build/** is gitignored). The same fixtures as lib/server/createLowdefyContext.test.mjs.
|
|
85
|
+
const dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
86
|
+
const pluginsDir = path.resolve(dirname, '../../build/plugins');
|
|
87
|
+
const fixtures = [
|
|
88
|
+
'agents.js',
|
|
89
|
+
'connections.js',
|
|
90
|
+
'notifications.js',
|
|
91
|
+
path.join('operators', 'server.js'),
|
|
92
|
+
path.join('operators', 'serverJsMap.js'),
|
|
93
|
+
'steps.js',
|
|
94
|
+
'websockets.js',
|
|
95
|
+
].map((file) => path.join(pluginsDir, file));
|
|
96
|
+
|
|
97
|
+
const createdFixtures = [];
|
|
98
|
+
fixtures.forEach((absolutePath) => {
|
|
99
|
+
if (!fs.existsSync(absolutePath)) {
|
|
100
|
+
fs.mkdirSync(path.dirname(absolutePath), { recursive: true });
|
|
101
|
+
fs.writeFileSync(
|
|
102
|
+
absolutePath,
|
|
103
|
+
'export default {};\nexport const interpolateProperties = () => {};\nexport const renderEmail = () => {};\n'
|
|
104
|
+
);
|
|
105
|
+
createdFixtures.push(absolutePath);
|
|
106
|
+
}
|
|
107
|
+
});
|
|
108
|
+
fixtures.forEach((absolutePath) => {
|
|
109
|
+
vi.doMock(absolutePath, () => ({
|
|
110
|
+
default: {},
|
|
111
|
+
interpolateProperties: () => {},
|
|
112
|
+
renderEmail: () => {},
|
|
113
|
+
}));
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
afterAll(() => {
|
|
117
|
+
createdFixtures.forEach((absolutePath) => fs.rmSync(absolutePath, { force: true }));
|
|
118
|
+
});
|
|
119
|
+
|
|
120
|
+
const { default: apiContext } = await import('../middleware/apiContext.js');
|
|
121
|
+
const { default: agentHandler } = await import('./agent.js');
|
|
122
|
+
|
|
123
|
+
function createApp() {
|
|
124
|
+
const app = new Hono();
|
|
125
|
+
app.use('/api/*', apiContext());
|
|
126
|
+
app.all('/api/agent/*', agentHandler);
|
|
127
|
+
return app;
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
function postChat(headers) {
|
|
131
|
+
return createApp().request('/api/agent/atlas-chat/atlas?conversationId=c1', {
|
|
132
|
+
method: 'POST',
|
|
133
|
+
headers: { 'content-type': 'application/json', ...headers },
|
|
134
|
+
body: JSON.stringify({ messages: [], sharedState: { now: 'today' } }),
|
|
135
|
+
});
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
beforeEach(() => {
|
|
139
|
+
mockResolveAuthentication.mockClear();
|
|
140
|
+
mockCallAgent.mockClear();
|
|
141
|
+
});
|
|
142
|
+
|
|
143
|
+
test('a shell chat call with a bearer session runs the agent as that caller', async () => {
|
|
144
|
+
const res = await postChat({
|
|
145
|
+
authorization: 'Bearer phone-session-token',
|
|
146
|
+
'x-lowdefy-shell': 'dev',
|
|
147
|
+
});
|
|
148
|
+
expect(res.status).toEqual(200);
|
|
149
|
+
expect(res.headers.get('content-type')).toEqual('text/event-stream');
|
|
150
|
+
expect(await res.text()).toEqual('data: {"type":"start"}\n\ndata: [DONE]\n\n');
|
|
151
|
+
expect(mockCallAgent).toHaveBeenCalledTimes(1);
|
|
152
|
+
const [context, params] = mockCallAgent.mock.calls[0];
|
|
153
|
+
expect(context.user).toEqual({ id: 'u-phone', roles: ['member'] });
|
|
154
|
+
expect(params.agentId).toEqual('atlas');
|
|
155
|
+
expect(params.pageId).toEqual('atlas-chat');
|
|
156
|
+
expect(params.conversationId).toEqual('c1');
|
|
157
|
+
});
|
|
158
|
+
|
|
159
|
+
test('a paired phone chat call with a bearer session runs the agent as that caller', async () => {
|
|
160
|
+
// The --lan proxy marks a caller from another machine; it is never a headless one.
|
|
161
|
+
await postChat({
|
|
162
|
+
authorization: 'Bearer phone-session-token',
|
|
163
|
+
'x-lowdefy-shell': 'dev',
|
|
164
|
+
'x-lowdefy-dev-remote': '1',
|
|
165
|
+
});
|
|
166
|
+
const [context] = mockCallAgent.mock.calls[0];
|
|
167
|
+
expect(context.user).toEqual({ id: 'u-phone', roles: ['member'] });
|
|
168
|
+
});
|
|
169
|
+
|
|
170
|
+
test('the agent route resolves its caller through the general branch from the raw headers', async () => {
|
|
171
|
+
await postChat({ authorization: 'Bearer phone-session-token', 'x-lowdefy-shell': 'dev' });
|
|
172
|
+
expect(mockResolveAuthentication).toHaveBeenCalledTimes(1);
|
|
173
|
+
const [, options] = mockResolveAuthentication.mock.calls[0];
|
|
174
|
+
expect(options.mcp).toBe(false);
|
|
175
|
+
expect(options.headers.get('authorization')).toEqual('Bearer phone-session-token');
|
|
176
|
+
expect(options.headers.get('cookie')).toBeNull();
|
|
177
|
+
});
|
|
178
|
+
|
|
179
|
+
test('a shell chat call with an unknown bearer runs the agent signed out', async () => {
|
|
180
|
+
await postChat({ authorization: 'Bearer ended-session', 'x-lowdefy-shell': 'dev' });
|
|
181
|
+
const [context] = mockCallAgent.mock.calls[0];
|
|
182
|
+
expect(context.user).toBeNull();
|
|
183
|
+
});
|
package/src/routes/auth.test.mjs
CHANGED
|
@@ -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
|
-
const handleAuthRequest =
|
|
20
|
-
const getAuth =
|
|
19
|
+
const handleAuthRequest = vi.fn(async () => new Response('engine'));
|
|
20
|
+
const getAuth = vi.fn(() => ({}));
|
|
21
21
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
default:
|
|
22
|
+
vi.doMock('@lowdefy/api', () => ({ handleAuthRequest }));
|
|
23
|
+
vi.doMock('../../lib/build/auth.js', () => ({ default: { configured: true } }));
|
|
24
|
+
vi.doMock('../../lib/server/auth/getAuth.js', () => ({ default: getAuth }));
|
|
25
|
+
vi.doMock('../../lib/server/auth/getMockUser.js', () => ({
|
|
26
|
+
default: vi.fn(() => undefined),
|
|
27
27
|
}));
|
|
28
|
-
|
|
29
|
-
default:
|
|
28
|
+
vi.doMock('../../lib/server/getClientAddress.js', () => ({
|
|
29
|
+
default: vi.fn(() => '127.0.0.1'),
|
|
30
30
|
}));
|
|
31
31
|
|
|
32
32
|
const { default: authMiddleware } = await import('./auth.js');
|
|
@@ -15,12 +15,17 @@
|
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
import { logClientError, parseRequestBody } from '@lowdefy/api';
|
|
18
|
+
import { serializer } from '@lowdefy/helpers';
|
|
18
19
|
|
|
19
20
|
import clientErrorStore from '../../lib/docs/clientErrorStore.js';
|
|
20
21
|
import errorRecordingStamp from '../../lib/server/recording/errorRecordingStamp.js';
|
|
22
|
+
import getRequestSurface from '../lib/getRequestSurface.js';
|
|
21
23
|
import createSameOriginGuard from '../middleware/createSameOriginGuard.js';
|
|
22
24
|
|
|
23
|
-
|
|
25
|
+
// No Origin is allowed in dev: a phone shell (a simulator, a USB phone through
|
|
26
|
+
// adb reverse, or a phone the proxy let in with the pairing token) sends none.
|
|
27
|
+
// A browser on another site always sends one, so it is still refused.
|
|
28
|
+
const guardSameOrigin = createSameOriginGuard({ allowNoOrigin: true });
|
|
24
29
|
|
|
25
30
|
async function clientErrorHandler(c) {
|
|
26
31
|
if (c.req.method !== 'POST') {
|
|
@@ -41,13 +46,25 @@ async function clientErrorHandler(c) {
|
|
|
41
46
|
|
|
42
47
|
// Feed the agent-facing feedback loop (GET /lowdefy-docs/build-status) with a
|
|
43
48
|
// serializable summary — not the full error object, which may carry
|
|
44
|
-
// non-serializable `received` values.
|
|
49
|
+
// non-serializable `received` values. `surface` tells a phone shell's errors
|
|
50
|
+
// ('mobile', with its shell version) from a browser's ('web').
|
|
51
|
+
// When plugin-schema validation explained the error, the terminal logs that
|
|
52
|
+
// ConfigError ("property title must be type string") instead of the original
|
|
53
|
+
// ("Error rendering block"), and the agent must see the same one.
|
|
54
|
+
const surface = getRequestSurface(c);
|
|
55
|
+
const shown = response.configError ? serializer.deserialize(response.configError) : error;
|
|
45
56
|
clientErrorStore.push({
|
|
46
57
|
timestamp: new Date().toISOString(),
|
|
47
|
-
name:
|
|
48
|
-
message:
|
|
58
|
+
name: shown?.name ?? 'Error',
|
|
59
|
+
message: shown?.message ?? null,
|
|
49
60
|
source: response.source ?? null,
|
|
50
61
|
config: response.config ?? null,
|
|
62
|
+
hint: shown?.hint ?? null,
|
|
63
|
+
configKey: error?.configKey ?? null,
|
|
64
|
+
pageId: error?.pageId ?? null,
|
|
65
|
+
blockId: error?.blockId ?? null,
|
|
66
|
+
surface,
|
|
67
|
+
...(surface === 'mobile' ? { shell: c.req.header('x-lowdefy-shell') } : {}),
|
|
51
68
|
recording: errorRecordingStamp(context.recording),
|
|
52
69
|
});
|
|
53
70
|
|
|
@@ -0,0 +1,127 @@
|
|
|
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 { Hono } from 'hono';
|
|
18
|
+
import { vi, beforeEach, expect, test } from 'vitest';
|
|
19
|
+
|
|
20
|
+
const mockLogClientError = vi.fn();
|
|
21
|
+
const mockPush = vi.fn();
|
|
22
|
+
|
|
23
|
+
// The same-origin rule is the real one from @lowdefy/api; only the logging is mocked.
|
|
24
|
+
const api = await import('@lowdefy/api');
|
|
25
|
+
vi.doMock('@lowdefy/api', () => ({
|
|
26
|
+
...api,
|
|
27
|
+
logClientError: mockLogClientError,
|
|
28
|
+
}));
|
|
29
|
+
vi.doMock('../../lib/docs/clientErrorStore.js', () => ({
|
|
30
|
+
default: { push: mockPush },
|
|
31
|
+
}));
|
|
32
|
+
|
|
33
|
+
const { default: clientErrorHandler } = await import('./clientError.js');
|
|
34
|
+
|
|
35
|
+
function post(headers) {
|
|
36
|
+
const app = new Hono();
|
|
37
|
+
app.use('*', async (c, next) => {
|
|
38
|
+
c.set('lowdefyContext', { recording: null });
|
|
39
|
+
await next();
|
|
40
|
+
});
|
|
41
|
+
app.all('/api/client-error', clientErrorHandler);
|
|
42
|
+
return app.request('/api/client-error', {
|
|
43
|
+
method: 'POST',
|
|
44
|
+
headers: { 'content-type': 'application/json', ...headers },
|
|
45
|
+
body: JSON.stringify({ error: { message: 'Block failed' } }),
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
beforeEach(() => {
|
|
50
|
+
mockLogClientError.mockResolvedValue({
|
|
51
|
+
error: { name: 'BlockError', message: 'Block failed' },
|
|
52
|
+
source: 'pages/home.yaml:12',
|
|
53
|
+
});
|
|
54
|
+
});
|
|
55
|
+
|
|
56
|
+
test('clientError accepts an error from a phone paired with lowdefy dev --lan', async () => {
|
|
57
|
+
const res = await post({ host: '192.168.1.20:3000', 'x-lowdefy-dev-remote': '1' });
|
|
58
|
+
expect(res.status).toEqual(200);
|
|
59
|
+
expect(mockPush).toHaveBeenCalledWith(
|
|
60
|
+
expect.objectContaining({ name: 'BlockError', source: 'pages/home.yaml:12' })
|
|
61
|
+
);
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
test('clientError accepts an error from a simulator shell, which sends no origin', async () => {
|
|
65
|
+
const res = await post({ host: 'localhost:3000' });
|
|
66
|
+
expect(res.status).toEqual(200);
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
test('clientError accepts an error from the app page itself', async () => {
|
|
70
|
+
const res = await post({
|
|
71
|
+
host: 'localhost:3000',
|
|
72
|
+
origin: 'http://localhost:3000',
|
|
73
|
+
'sec-fetch-site': 'same-origin',
|
|
74
|
+
});
|
|
75
|
+
expect(res.status).toEqual(200);
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
test('clientError refuses an error a page on another site posts', async () => {
|
|
79
|
+
const res = await post({
|
|
80
|
+
host: 'localhost:3000',
|
|
81
|
+
origin: 'https://attacker.example',
|
|
82
|
+
'sec-fetch-site': 'cross-site',
|
|
83
|
+
});
|
|
84
|
+
expect(res.status).toEqual(403);
|
|
85
|
+
expect(mockPush).not.toHaveBeenCalled();
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
test('clientError marks a phone shell error as mobile with its shell version', async () => {
|
|
89
|
+
const res = await post({ host: 'localhost:3000', 'x-lowdefy-shell': '7.1.0' });
|
|
90
|
+
expect(res.status).toEqual(200);
|
|
91
|
+
expect(mockPush).toHaveBeenCalledWith(
|
|
92
|
+
expect.objectContaining({ name: 'BlockError', surface: 'mobile', shell: '7.1.0' })
|
|
93
|
+
);
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
test('clientError marks a browser error as web', async () => {
|
|
97
|
+
await post({
|
|
98
|
+
host: 'localhost:3000',
|
|
99
|
+
origin: 'http://localhost:3000',
|
|
100
|
+
'sec-fetch-site': 'same-origin',
|
|
101
|
+
});
|
|
102
|
+
const [entry] = mockPush.mock.calls.at(-1);
|
|
103
|
+
expect(entry.surface).toEqual('web');
|
|
104
|
+
expect(entry).not.toHaveProperty('shell');
|
|
105
|
+
});
|
|
106
|
+
|
|
107
|
+
test('clientError feeds the agent the schema ConfigError that explains a client error', async () => {
|
|
108
|
+
const { serializer } = await import('@lowdefy/helpers');
|
|
109
|
+
const { ConfigError } = await import('@lowdefy/errors');
|
|
110
|
+
const configError = new ConfigError('Block "Button" property "title" must be type "string".');
|
|
111
|
+
configError.hint = 'Set title to a string.';
|
|
112
|
+
mockLogClientError.mockResolvedValueOnce({
|
|
113
|
+
error: { name: 'BlockError', message: 'Block failed', configKey: 'k1', blockId: 'submit' },
|
|
114
|
+
source: 'pages/home.yaml:12',
|
|
115
|
+
configError: serializer.serialize(configError),
|
|
116
|
+
});
|
|
117
|
+
await post({ host: 'localhost:3000' });
|
|
118
|
+
const [entry] = mockPush.mock.calls.at(-1);
|
|
119
|
+
expect(entry).toMatchObject({
|
|
120
|
+
name: 'ConfigError',
|
|
121
|
+
message: 'Block "Button" property "title" must be type "string".',
|
|
122
|
+
hint: 'Set title to a string.',
|
|
123
|
+
configKey: 'k1',
|
|
124
|
+
blockId: 'submit',
|
|
125
|
+
source: 'pages/home.yaml:12',
|
|
126
|
+
});
|
|
127
|
+
});
|
package/src/routes/devInspect.js
CHANGED
|
@@ -15,54 +15,12 @@
|
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
import { parseRequestBody } from '@lowdefy/api';
|
|
18
|
-
import {
|
|
18
|
+
import { type } from '@lowdefy/helpers';
|
|
19
19
|
|
|
20
|
-
import { readCheckpoint } from '../../lib/docs/checkpointStore.js';
|
|
21
|
-
import { loadMocks } from '../../lib/docs/devMockRegistry.js';
|
|
22
20
|
import getPathSegments from '../lib/getPathSegments.js';
|
|
21
|
+
import isTabChannelCaller from '../lib/isTabChannelCaller.js';
|
|
23
22
|
import { listTabs, resolveTabRequest, updateTabPage } from '../../lib/docs/tabChannel.js';
|
|
24
23
|
|
|
25
|
-
// Origin/host check mirrors clientError.js — this endpoint accepts a POST
|
|
26
|
-
// from Inspector.jsx (a same-origin dev-only browser component), not from
|
|
27
|
-
// arbitrary agents, so it needs the same CSRF-style guard.
|
|
28
|
-
function checkOrigin(c) {
|
|
29
|
-
const origin = c.req.header('origin');
|
|
30
|
-
if (!origin) {
|
|
31
|
-
return false;
|
|
32
|
-
}
|
|
33
|
-
try {
|
|
34
|
-
return new URL(origin).host === c.req.header('host');
|
|
35
|
-
} catch {
|
|
36
|
-
return false;
|
|
37
|
-
}
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
// Dev-only agent-state-xray: a human tab bootstrapping from a
|
|
41
|
-
// `?_checkpoint=<name>` URL (client/Inspector.jsx) fetches this. It returns
|
|
42
|
-
// the checkpoint's state part + manifest for the tab to inject client-side,
|
|
43
|
-
// and — as a side effect — loads the checkpoint's recorded requests into
|
|
44
|
-
// devMockRegistry server-side, so that tab's own requests (src/routes/
|
|
45
|
-
// request.js) replay recorded data instead of hitting real connections.
|
|
46
|
-
function handleCheckpointBootstrap(c, { name }) {
|
|
47
|
-
let checkpoint;
|
|
48
|
-
try {
|
|
49
|
-
checkpoint = readCheckpoint({ name });
|
|
50
|
-
} catch (error) {
|
|
51
|
-
return c.json({ error: error.message }, 404);
|
|
52
|
-
}
|
|
53
|
-
loadMocks({ pageId: checkpoint.checkpoint.pageId, mocks: checkpoint.requests });
|
|
54
|
-
return c.json(
|
|
55
|
-
serializer.serialize({
|
|
56
|
-
checkpoint: checkpoint.checkpoint,
|
|
57
|
-
state: checkpoint.state,
|
|
58
|
-
urlQuery: checkpoint.urlQuery,
|
|
59
|
-
input: checkpoint.input,
|
|
60
|
-
user: checkpoint.user,
|
|
61
|
-
global: checkpoint.global,
|
|
62
|
-
})
|
|
63
|
-
);
|
|
64
|
-
}
|
|
65
|
-
|
|
66
24
|
// Inspector.jsx posts { tabId, pageId, pathParams, instanceKey } here whenever
|
|
67
25
|
// the page instance on screen in its tab changes, so the tab registry
|
|
68
26
|
// (lib/docs/tabChannel.js) knows which instance each connected tab shows, and
|
|
@@ -81,17 +39,12 @@ async function handleTabPage(c) {
|
|
|
81
39
|
return c.json({ ok: true });
|
|
82
40
|
}
|
|
83
41
|
|
|
84
|
-
// GET lists connected tabs for diagnostics
|
|
85
|
-
// bootstraps a human tab from a state checkpoint); POST /page updates the
|
|
42
|
+
// GET lists connected tabs for diagnostics; POST /page updates the
|
|
86
43
|
// page a connected tab is on; POST at the root is the answer leg of the SSE
|
|
87
44
|
// request/response round trip (Inspector.jsx posts back {requestId, result}
|
|
88
45
|
// after handling an inspect-request/eval-request event).
|
|
89
46
|
async function devInspectHandler(c) {
|
|
90
47
|
if (c.req.method === 'GET') {
|
|
91
|
-
const segments = getPathSegments(c, '/api/dev-inspect/');
|
|
92
|
-
if (segments[0] === 'checkpoint' && segments[1]) {
|
|
93
|
-
return handleCheckpointBootstrap(c, { name: segments[1] });
|
|
94
|
-
}
|
|
95
48
|
return c.json({ tabs: listTabs() });
|
|
96
49
|
}
|
|
97
50
|
|
|
@@ -101,7 +54,9 @@ async function devInspectHandler(c) {
|
|
|
101
54
|
return c.json({ error: 'Method not allowed.' }, 405);
|
|
102
55
|
}
|
|
103
56
|
|
|
104
|
-
|
|
57
|
+
// Only a dev tab answers: a browser tab's Inspector.jsx, or a phone shell's
|
|
58
|
+
// dev-tab client (@lowdefy/shell src/dev). Not a page on another site.
|
|
59
|
+
if (!isTabChannelCaller(c)) {
|
|
105
60
|
return c.json({ error: 'Forbidden' }, 403);
|
|
106
61
|
}
|
|
107
62
|
|