@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
|
@@ -20,6 +20,8 @@ import net from 'node:net';
|
|
|
20
20
|
import { devPassiveHeader } from '@lowdefy/node-utils';
|
|
21
21
|
|
|
22
22
|
import buildWaitHeader from '../../lib/docs/buildWaitHeader.js';
|
|
23
|
+
import { pairHeader, remoteCallerHeader } from '../../lib/server/pairingHeaders.js';
|
|
24
|
+
import checkPairing from '../utils/checkPairing.mjs';
|
|
23
25
|
import readBuildStatusWait from '../utils/readBuildStatusWait.mjs';
|
|
24
26
|
|
|
25
27
|
/*
|
|
@@ -50,6 +52,22 @@ until then it still answers the probe. A GET or HEAD that never reached the
|
|
|
50
52
|
child (a refused connect, or a keep-alive socket the dying child had closed)
|
|
51
53
|
is replayed through the hold rather than answered 502: a child can close its
|
|
52
54
|
sockets before the manager sees it exit.
|
|
55
|
+
|
|
56
|
+
Any other request that loses the child answers 502, and is never replayed: it
|
|
57
|
+
may already have run. A live child does not cause this, since it leaves idle
|
|
58
|
+
connections open for this proxy's agent to close (keepIdleConnectionsOpen).
|
|
59
|
+
What the proxy answers itself, because the child could not, says so in
|
|
60
|
+
x-lowdefy-child, and a journey reports it as a dev server failure rather than
|
|
61
|
+
an app error (evaluateInvariants).
|
|
62
|
+
|
|
63
|
+
A child stopped for being idle (createIdleChild) is started again only by a
|
|
64
|
+
request that is use (isActivity), which is held as for a restart. A request
|
|
65
|
+
that is not use - a passive read, an event-stream GET, a websocket upgrade -
|
|
66
|
+
is answered 503 at once with Retry-After, so status checks and reconnecting
|
|
67
|
+
streams neither wake the child nor wait out the hold.
|
|
68
|
+
|
|
69
|
+
The proxy also counts the tabs holding a reload stream open, from the
|
|
70
|
+
stream's response start until it closes: an open tab keeps the child up.
|
|
53
71
|
*/
|
|
54
72
|
|
|
55
73
|
const RETRY_MS = 250;
|
|
@@ -69,10 +87,16 @@ function probeChild(port) {
|
|
|
69
87
|
});
|
|
70
88
|
}
|
|
71
89
|
|
|
72
|
-
|
|
90
|
+
function isChildStopped(context) {
|
|
91
|
+
return context.idleChild?.isStopped() === true;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
// givesUp ends the wait early: a request that does not wake the child stops
|
|
95
|
+
// waiting once the child is idle-stopped.
|
|
96
|
+
async function waitForChild({ port, deadline, givesUp = () => false }) {
|
|
73
97
|
for (;;) {
|
|
74
98
|
if (await probeChild(port)) return true;
|
|
75
|
-
if (Date.now() > deadline) return false;
|
|
99
|
+
if (Date.now() > deadline || givesUp()) return false;
|
|
76
100
|
await new Promise((resolve) => setTimeout(resolve, RETRY_MS));
|
|
77
101
|
}
|
|
78
102
|
}
|
|
@@ -94,13 +118,17 @@ function waitUntil({ promise, deadline }) {
|
|
|
94
118
|
]);
|
|
95
119
|
}
|
|
96
120
|
|
|
97
|
-
async function waitForConfirmedChild({ context, proxyState, deadline }) {
|
|
121
|
+
async function waitForConfirmedChild({ context, proxyState, deadline, wakes }) {
|
|
98
122
|
if (isConfirmedChild({ context, proxyState })) {
|
|
99
123
|
return true;
|
|
100
124
|
}
|
|
101
125
|
await waitUntil({ promise: context.devServerExited, deadline });
|
|
102
126
|
const child = context.devServer;
|
|
103
|
-
const up = await waitForChild({
|
|
127
|
+
const up = await waitForChild({
|
|
128
|
+
port: context.internalPort,
|
|
129
|
+
deadline,
|
|
130
|
+
givesUp: () => !wakes && isChildStopped(context),
|
|
131
|
+
});
|
|
104
132
|
if (up) {
|
|
105
133
|
proxyState.confirmedChild = child;
|
|
106
134
|
}
|
|
@@ -109,6 +137,25 @@ async function waitForConfirmedChild({ context, proxyState, deadline }) {
|
|
|
109
137
|
|
|
110
138
|
const REPLAYABLE_METHODS = ['GET', 'HEAD'];
|
|
111
139
|
|
|
140
|
+
const IDLE_RETRY_AFTER_S = 5;
|
|
141
|
+
|
|
142
|
+
function answerIdle(res) {
|
|
143
|
+
res.writeHead(503, {
|
|
144
|
+
'content-type': 'application/json',
|
|
145
|
+
'retry-after': String(IDLE_RETRY_AFTER_S),
|
|
146
|
+
'x-lowdefy-child': 'stopped',
|
|
147
|
+
});
|
|
148
|
+
res.end(JSON.stringify({ message: 'Lowdefy dev server is idle.' }));
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
function isReloadStream({ context, req }) {
|
|
152
|
+
if (req.method !== 'GET') {
|
|
153
|
+
return false;
|
|
154
|
+
}
|
|
155
|
+
const { pathname } = new URL(req.url, 'http://localhost');
|
|
156
|
+
return pathname === `${context.basePath ?? ''}/api/reload`;
|
|
157
|
+
}
|
|
158
|
+
|
|
112
159
|
// Nothing reached the child: the connect was refused, or the keep-alive socket
|
|
113
160
|
// the agent reused had already been closed by a child that is going away.
|
|
114
161
|
function isUnsentError({ error, proxyReq }) {
|
|
@@ -117,19 +164,28 @@ function isUnsentError({ error, proxyReq }) {
|
|
|
117
164
|
);
|
|
118
165
|
}
|
|
119
166
|
|
|
120
|
-
function forwardRequest(
|
|
167
|
+
function forwardRequest(
|
|
168
|
+
{ body, context, proxyState, wakes },
|
|
169
|
+
req,
|
|
170
|
+
res,
|
|
171
|
+
deadline = Date.now() + HOLD_MS
|
|
172
|
+
) {
|
|
121
173
|
// Wait for a live child BEFORE piping the request body — the body stream can
|
|
122
174
|
// only be consumed once, so retrying after a failed proxy request would need
|
|
123
175
|
// full-body buffering. Only a bodiless GET or HEAD that never reached the
|
|
124
176
|
// child is replayed; any other request that loses the child mid-forward
|
|
125
177
|
// surfaces as one 502, which the client's next attempt resolves through the
|
|
126
178
|
// hold.
|
|
127
|
-
waitForConfirmedChild({ context, proxyState, deadline }).then((up) => {
|
|
179
|
+
waitForConfirmedChild({ context, proxyState, deadline, wakes }).then((up) => {
|
|
128
180
|
// The response, not the request: an incoming request reads as destroyed
|
|
129
181
|
// once its body has been read, which a replayed GET's has.
|
|
130
182
|
if (res.destroyed) return;
|
|
183
|
+
if (!up && !wakes && isChildStopped(context)) {
|
|
184
|
+
answerIdle(res);
|
|
185
|
+
return;
|
|
186
|
+
}
|
|
131
187
|
if (!up) {
|
|
132
|
-
res.writeHead(503, { 'content-type': 'application/json' });
|
|
188
|
+
res.writeHead(503, { 'content-type': 'application/json', 'x-lowdefy-child': 'restarting' });
|
|
133
189
|
res.end(JSON.stringify({ message: 'Lowdefy dev server is restarting.' }));
|
|
134
190
|
return;
|
|
135
191
|
}
|
|
@@ -141,6 +197,9 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
|
|
|
141
197
|
headers: req.headers,
|
|
142
198
|
});
|
|
143
199
|
proxyReq.on('response', (proxyRes) => {
|
|
200
|
+
if (proxyRes.statusCode === 200 && isReloadStream({ context, req })) {
|
|
201
|
+
context.requestActivity.trackTab(res);
|
|
202
|
+
}
|
|
144
203
|
res.writeHead(proxyRes.statusCode, proxyRes.headers);
|
|
145
204
|
// flushHeaders so SSE endpoints (reload stream, MCP notifications)
|
|
146
205
|
// reach the client before the first event.
|
|
@@ -154,14 +213,14 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
|
|
|
154
213
|
REPLAYABLE_METHODS.includes(req.method) &&
|
|
155
214
|
isUnsentError({ error, proxyReq })
|
|
156
215
|
) {
|
|
157
|
-
forwardRequest({ body, context, proxyState }, req, res, deadline);
|
|
216
|
+
forwardRequest({ body, context, proxyState, wakes }, req, res, deadline);
|
|
158
217
|
return;
|
|
159
218
|
}
|
|
160
219
|
if (res.headersSent) {
|
|
161
220
|
res.destroy();
|
|
162
221
|
return;
|
|
163
222
|
}
|
|
164
|
-
res.writeHead(502, { 'content-type': 'application/json' });
|
|
223
|
+
res.writeHead(502, { 'content-type': 'application/json', 'x-lowdefy-child': 'dropped' });
|
|
165
224
|
res.end(JSON.stringify({ message: 'Lowdefy dev server connection dropped.' }));
|
|
166
225
|
});
|
|
167
226
|
// A body read to recognise a build-status wait is sent as read. A
|
|
@@ -203,9 +262,42 @@ function isActivity(req) {
|
|
|
203
262
|
// latest edits, restarts included, and only then forwarded: a restart ends
|
|
204
263
|
// the dev server process, and any wait running in it. The header tells the
|
|
205
264
|
// dev server what this wait saw, so it does not wait again.
|
|
265
|
+
// The pairing gate sits here, in front of Vite and the app alike, because the
|
|
266
|
+
// child only ever sees the proxy's loopback address. The child learns that a
|
|
267
|
+
// caller is remote from remoteCallerHeader, which only the proxy sets.
|
|
268
|
+
function readAccess({ context, req }) {
|
|
269
|
+
return checkPairing({
|
|
270
|
+
remoteAddress: req.socket.remoteAddress,
|
|
271
|
+
pairToken: context.lan?.token,
|
|
272
|
+
providedToken: req.headers[pairHeader],
|
|
273
|
+
});
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
const PAIRING_REFUSAL =
|
|
277
|
+
'This dev server answers other machines only with the pairing token that `lowdefy dev --lan` prints.';
|
|
278
|
+
|
|
206
279
|
async function handleRequest({ context, proxyState }, req, res) {
|
|
207
|
-
|
|
280
|
+
const access = readAccess({ context, req });
|
|
281
|
+
if (access === 'refused') {
|
|
282
|
+
res.writeHead(401, { 'content-type': 'application/json' });
|
|
283
|
+
res.end(JSON.stringify({ message: PAIRING_REFUSAL }));
|
|
284
|
+
return;
|
|
285
|
+
}
|
|
286
|
+
delete req.headers[pairHeader];
|
|
287
|
+
delete req.headers[remoteCallerHeader];
|
|
288
|
+
if (access === 'paired') {
|
|
289
|
+
req.headers[remoteCallerHeader] = '1';
|
|
290
|
+
}
|
|
291
|
+
const wakes = isActivity(req);
|
|
292
|
+
if (!wakes && isChildStopped(context)) {
|
|
293
|
+
answerIdle(res);
|
|
294
|
+
return;
|
|
295
|
+
}
|
|
296
|
+
if (wakes) {
|
|
208
297
|
context.requestActivity.trackResponse(res);
|
|
298
|
+
if (isChildStopped(context)) {
|
|
299
|
+
context.idleChild.wake().catch((error) => context.logger.error(error));
|
|
300
|
+
}
|
|
209
301
|
}
|
|
210
302
|
delete req.headers[buildWaitHeader];
|
|
211
303
|
const { wait, body } = await readBuildStatusWait({ basePath: context.basePath, req });
|
|
@@ -217,12 +309,39 @@ async function handleRequest({ context, proxyState }, req, res) {
|
|
|
217
309
|
waitedMs: String(waited.waitedMs),
|
|
218
310
|
}).toString();
|
|
219
311
|
}
|
|
220
|
-
forwardRequest({ body, context, proxyState }, req, res);
|
|
312
|
+
forwardRequest({ body, context, proxyState, wakes }, req, res);
|
|
221
313
|
}
|
|
222
314
|
|
|
315
|
+
const IDLE_UPGRADE_RESPONSE = [
|
|
316
|
+
'HTTP/1.1 503 Service Unavailable',
|
|
317
|
+
`retry-after: ${IDLE_RETRY_AFTER_S}`,
|
|
318
|
+
'x-lowdefy-child: stopped',
|
|
319
|
+
'connection: close',
|
|
320
|
+
'',
|
|
321
|
+
'',
|
|
322
|
+
].join('\r\n');
|
|
323
|
+
|
|
324
|
+
// An upgrade is never use (see isActivity), so it never wakes an idle-stopped child.
|
|
223
325
|
function forwardUpgrade(context, req, socket, head) {
|
|
224
|
-
|
|
326
|
+
const access = readAccess({ context, req });
|
|
327
|
+
if (access === 'refused') {
|
|
328
|
+
socket.end('HTTP/1.1 401 Unauthorized\r\nconnection: close\r\n\r\n');
|
|
329
|
+
return;
|
|
330
|
+
}
|
|
331
|
+
if (isChildStopped(context)) {
|
|
332
|
+
socket.end(IDLE_UPGRADE_RESPONSE);
|
|
333
|
+
return;
|
|
334
|
+
}
|
|
335
|
+
waitForChild({
|
|
336
|
+
port: context.internalPort,
|
|
337
|
+
deadline: Date.now() + HOLD_MS,
|
|
338
|
+
givesUp: () => isChildStopped(context),
|
|
339
|
+
}).then((up) => {
|
|
225
340
|
if (socket.destroyed) return;
|
|
341
|
+
if (!up && isChildStopped(context)) {
|
|
342
|
+
socket.end(IDLE_UPGRADE_RESPONSE);
|
|
343
|
+
return;
|
|
344
|
+
}
|
|
226
345
|
if (!up) {
|
|
227
346
|
socket.end('HTTP/1.1 503 Service Unavailable\r\nconnection: close\r\n\r\n');
|
|
228
347
|
return;
|
|
@@ -233,7 +352,13 @@ function forwardUpgrade(context, req, socket, head) {
|
|
|
233
352
|
// websockets both pass through untouched.
|
|
234
353
|
const lines = [`${req.method} ${req.url} HTTP/1.1`];
|
|
235
354
|
for (let i = 0; i < req.rawHeaders.length; i += 2) {
|
|
236
|
-
|
|
355
|
+
const name = req.rawHeaders[i].toLowerCase();
|
|
356
|
+
if (name !== pairHeader && name !== remoteCallerHeader) {
|
|
357
|
+
lines.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
if (access === 'paired') {
|
|
361
|
+
lines.push(`${remoteCallerHeader}: 1`);
|
|
237
362
|
}
|
|
238
363
|
upstream.write(lines.join('\r\n') + '\r\n\r\n');
|
|
239
364
|
if (head?.length) upstream.write(head);
|
|
@@ -247,9 +372,17 @@ function forwardUpgrade(context, req, socket, head) {
|
|
|
247
372
|
});
|
|
248
373
|
}
|
|
249
374
|
|
|
250
|
-
function
|
|
251
|
-
|
|
252
|
-
|
|
375
|
+
function listen({ server, port, host }) {
|
|
376
|
+
return new Promise((resolve, reject) => {
|
|
377
|
+
server.once('error', reject);
|
|
378
|
+
server.listen(port, host, () => {
|
|
379
|
+
server.removeListener('error', reject);
|
|
380
|
+
resolve();
|
|
381
|
+
});
|
|
382
|
+
});
|
|
383
|
+
}
|
|
384
|
+
|
|
385
|
+
function createProxyServer({ context, proxyState }) {
|
|
253
386
|
const proxy = http.createServer((req, res) => {
|
|
254
387
|
// A client that drops an MCP request while its body is read.
|
|
255
388
|
handleRequest({ context, proxyState }, req, res).catch(() => res.destroy());
|
|
@@ -259,19 +392,24 @@ function startProxy(context) {
|
|
|
259
392
|
// request timeout; keep the proxy transparent.
|
|
260
393
|
proxy.requestTimeout = 0;
|
|
261
394
|
proxy.headersTimeout = 60000;
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
395
|
+
return proxy;
|
|
396
|
+
}
|
|
397
|
+
|
|
398
|
+
async function startProxy(context) {
|
|
399
|
+
if (context.proxyServer) return;
|
|
400
|
+
const proxyState = { confirmedChild: null };
|
|
401
|
+
const { port } = context.options;
|
|
402
|
+
context.proxyServer = createProxyServer({ context, proxyState });
|
|
403
|
+
// 'localhost' for parity with the Vite default host the child used to bind
|
|
404
|
+
// - the dev server stays loopback-only unless --lan asks for the network.
|
|
405
|
+
await listen({ server: context.proxyServer, port, host: 'localhost' });
|
|
406
|
+
// --lan adds a listener on the chosen interface's address only, not on every
|
|
407
|
+
// interface, so a VPN or Docker network does not reach the server too.
|
|
408
|
+
if (context.lan) {
|
|
409
|
+
context.lanProxyServer = createProxyServer({ context, proxyState });
|
|
410
|
+
await listen({ server: context.lanProxyServer, port, host: context.lan.address });
|
|
411
|
+
}
|
|
412
|
+
context.logger.debug(`Proxy listening on port ${port}, forwarding to ${context.internalPort}.`);
|
|
275
413
|
}
|
|
276
414
|
|
|
277
415
|
export default startProxy;
|
|
@@ -0,0 +1,204 @@
|
|
|
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 dns from 'node:dns';
|
|
18
|
+
import http from 'node:http';
|
|
19
|
+
import net from 'node:net';
|
|
20
|
+
|
|
21
|
+
import { vi, afterEach, beforeEach, expect, test } from 'vitest';
|
|
22
|
+
|
|
23
|
+
// Every test request comes from this computer. Mocking the loopback check
|
|
24
|
+
// makes the proxy treat it as a request from a phone on the network.
|
|
25
|
+
const mockIsLoopbackAddress = vi.fn();
|
|
26
|
+
vi.doMock('../utils/isLoopbackAddress.mjs', () => ({
|
|
27
|
+
default: mockIsLoopbackAddress,
|
|
28
|
+
}));
|
|
29
|
+
|
|
30
|
+
const { default: startProxy } = await import('./startProxy.mjs');
|
|
31
|
+
const { default: createBuildActivity } = await import('../utils/createBuildActivity.mjs');
|
|
32
|
+
const { default: createRequestActivity } = await import('../utils/createRequestActivity.mjs');
|
|
33
|
+
|
|
34
|
+
const TOKEN = 'a'.repeat(43);
|
|
35
|
+
|
|
36
|
+
function listen(server) {
|
|
37
|
+
return new Promise((resolve) => {
|
|
38
|
+
server.listen(0, '127.0.0.1', () => resolve(server.address().port));
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function close(server) {
|
|
43
|
+
return new Promise((resolve) => {
|
|
44
|
+
server.closeAllConnections?.();
|
|
45
|
+
server.close(() => resolve());
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function getFreePort() {
|
|
50
|
+
return new Promise((resolve) => {
|
|
51
|
+
const server = net.createServer();
|
|
52
|
+
server.listen(0, '127.0.0.1', () => {
|
|
53
|
+
const { port } = server.address();
|
|
54
|
+
server.close(() => resolve(port));
|
|
55
|
+
});
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
// The loopback address 'localhost' does not bind, so the LAN listener can
|
|
60
|
+
// share the port in a test.
|
|
61
|
+
async function getOtherLoopbackAddress() {
|
|
62
|
+
const { address } = await dns.promises.lookup('localhost');
|
|
63
|
+
return address === '::1' ? '127.0.0.1' : '::1';
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
let child;
|
|
67
|
+
let context;
|
|
68
|
+
let seen;
|
|
69
|
+
|
|
70
|
+
beforeEach(() => {
|
|
71
|
+
mockIsLoopbackAddress.mockReturnValue(true);
|
|
72
|
+
});
|
|
73
|
+
|
|
74
|
+
afterEach(async () => {
|
|
75
|
+
if (context?.proxyServer) await close(context.proxyServer);
|
|
76
|
+
if (context?.lanProxyServer) await close(context.lanProxyServer);
|
|
77
|
+
if (child) await close(child);
|
|
78
|
+
child = undefined;
|
|
79
|
+
context = undefined;
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
async function startChildAndProxy({ lan } = {}) {
|
|
83
|
+
seen = [];
|
|
84
|
+
child = http.createServer((req, res) => {
|
|
85
|
+
seen.push(req.headers);
|
|
86
|
+
res.end('ok');
|
|
87
|
+
});
|
|
88
|
+
child.on('upgrade', (req, socket) => {
|
|
89
|
+
seen.push(req.headers);
|
|
90
|
+
socket.write(
|
|
91
|
+
'HTTP/1.1 101 Switching Protocols\r\nupgrade: websocket\r\nconnection: upgrade\r\n\r\n'
|
|
92
|
+
);
|
|
93
|
+
socket.destroy();
|
|
94
|
+
});
|
|
95
|
+
const internalPort = await listen(child);
|
|
96
|
+
context = {
|
|
97
|
+
basePath: '',
|
|
98
|
+
buildActivity: createBuildActivity({ onChange: () => {} }),
|
|
99
|
+
internalPort,
|
|
100
|
+
lan,
|
|
101
|
+
logger: { debug: vi.fn() },
|
|
102
|
+
options: { port: await getFreePort() },
|
|
103
|
+
requestActivity: createRequestActivity({ onChange: () => {}, throttleMs: 0 }),
|
|
104
|
+
};
|
|
105
|
+
await startProxy(context);
|
|
106
|
+
return context.options.port;
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
test('startProxy lets a request from this computer through without a pairing token', async () => {
|
|
110
|
+
const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
|
|
111
|
+
const response = await fetch(`http://localhost:${port}/api/ping`);
|
|
112
|
+
expect(response.status).toBe(200);
|
|
113
|
+
expect(seen[0]['x-lowdefy-dev-remote']).toBeUndefined();
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
test('startProxy strips a remote marker a local caller sends itself', async () => {
|
|
117
|
+
const port = await startChildAndProxy();
|
|
118
|
+
await fetch(`http://localhost:${port}/api/ping`, { headers: { 'x-lowdefy-dev-remote': '1' } });
|
|
119
|
+
expect(seen[0]['x-lowdefy-dev-remote']).toBeUndefined();
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
test('startProxy refuses a request from another machine without the pairing token', async () => {
|
|
123
|
+
const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
|
|
124
|
+
mockIsLoopbackAddress.mockReturnValue(false);
|
|
125
|
+
const response = await fetch(`http://localhost:${port}/api/mobile/root`);
|
|
126
|
+
expect(response.status).toBe(401);
|
|
127
|
+
expect((await response.json()).message).toContain('pairing token');
|
|
128
|
+
expect(seen).toEqual([]);
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
test('startProxy refuses a request from another machine with the wrong pairing token', async () => {
|
|
132
|
+
const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
|
|
133
|
+
mockIsLoopbackAddress.mockReturnValue(false);
|
|
134
|
+
const response = await fetch(`http://localhost:${port}/api/mobile/root`, {
|
|
135
|
+
headers: { 'x-lowdefy-pair': 'b'.repeat(43) },
|
|
136
|
+
});
|
|
137
|
+
expect(response.status).toBe(401);
|
|
138
|
+
expect(seen).toEqual([]);
|
|
139
|
+
});
|
|
140
|
+
|
|
141
|
+
test('startProxy refuses every request from another machine when --lan is off', async () => {
|
|
142
|
+
const port = await startChildAndProxy();
|
|
143
|
+
mockIsLoopbackAddress.mockReturnValue(false);
|
|
144
|
+
const response = await fetch(`http://localhost:${port}/api/mobile/root`, {
|
|
145
|
+
headers: { 'x-lowdefy-pair': TOKEN },
|
|
146
|
+
});
|
|
147
|
+
expect(response.status).toBe(401);
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
test('startProxy forwards a paired request marked remote, without the token', async () => {
|
|
151
|
+
const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
|
|
152
|
+
mockIsLoopbackAddress.mockReturnValue(false);
|
|
153
|
+
const response = await fetch(`http://localhost:${port}/api/mobile/root`, {
|
|
154
|
+
headers: { 'x-lowdefy-pair': TOKEN },
|
|
155
|
+
});
|
|
156
|
+
expect(response.status).toBe(200);
|
|
157
|
+
expect(seen[0]['x-lowdefy-dev-remote']).toBe('1');
|
|
158
|
+
expect(seen[0]['x-lowdefy-pair']).toBeUndefined();
|
|
159
|
+
});
|
|
160
|
+
|
|
161
|
+
function upgrade({ port, headers }) {
|
|
162
|
+
return new Promise((resolve) => {
|
|
163
|
+
const clientRequest = http.get(`http://localhost:${port}/hmr`, {
|
|
164
|
+
headers: { connection: 'upgrade', upgrade: 'websocket', ...headers },
|
|
165
|
+
});
|
|
166
|
+
clientRequest.on('upgrade', (res, socket) => {
|
|
167
|
+
socket.destroy();
|
|
168
|
+
resolve(res.statusCode);
|
|
169
|
+
});
|
|
170
|
+
clientRequest.on('response', (res) => {
|
|
171
|
+
res.resume();
|
|
172
|
+
resolve(res.statusCode);
|
|
173
|
+
});
|
|
174
|
+
});
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
test('startProxy refuses a websocket upgrade from another machine without the token', async () => {
|
|
178
|
+
const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
|
|
179
|
+
mockIsLoopbackAddress.mockReturnValue(false);
|
|
180
|
+
expect(await upgrade({ port, headers: {} })).toBe(401);
|
|
181
|
+
expect(seen).toEqual([]);
|
|
182
|
+
});
|
|
183
|
+
|
|
184
|
+
test('startProxy forwards a paired websocket upgrade marked remote, without the token', async () => {
|
|
185
|
+
const port = await startChildAndProxy({ lan: { address: '127.0.0.1', token: TOKEN } });
|
|
186
|
+
mockIsLoopbackAddress.mockReturnValue(false);
|
|
187
|
+
expect(await upgrade({ port, headers: { 'x-lowdefy-pair': TOKEN } })).toBe(101);
|
|
188
|
+
expect(seen[0]['x-lowdefy-dev-remote']).toBe('1');
|
|
189
|
+
expect(seen[0]['x-lowdefy-pair']).toBeUndefined();
|
|
190
|
+
});
|
|
191
|
+
|
|
192
|
+
test('startProxy also listens on the --lan address, behind the same pairing gate', async () => {
|
|
193
|
+
const address = await getOtherLoopbackAddress();
|
|
194
|
+
const port = await startChildAndProxy({ lan: { address, token: TOKEN } });
|
|
195
|
+
expect(context.lanProxyServer.address()).toMatchObject({ address, port });
|
|
196
|
+
mockIsLoopbackAddress.mockReturnValue(false);
|
|
197
|
+
const host = address.includes(':') ? `[${address}]` : address;
|
|
198
|
+
const refused = await fetch(`http://${host}:${port}/api/ping`);
|
|
199
|
+
expect(refused.status).toBe(401);
|
|
200
|
+
const paired = await fetch(`http://${host}:${port}/api/ping`, {
|
|
201
|
+
headers: { 'x-lowdefy-pair': TOKEN },
|
|
202
|
+
});
|
|
203
|
+
expect(paired.status).toBe(200);
|
|
204
|
+
});
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
import http from 'node:http';
|
|
18
18
|
import net from 'node:net';
|
|
19
19
|
|
|
20
|
-
import {
|
|
20
|
+
import { vi, afterEach, expect, test } from 'vitest';
|
|
21
21
|
|
|
22
22
|
const { default: startProxy } = await import('./startProxy.mjs');
|
|
23
23
|
const { default: createBuildActivity } = await import('../utils/createBuildActivity.mjs');
|
|
@@ -64,7 +64,7 @@ async function startChildAndProxy(handler) {
|
|
|
64
64
|
context = {
|
|
65
65
|
internalPort,
|
|
66
66
|
options: { port: await getFreePort() },
|
|
67
|
-
logger: { debug:
|
|
67
|
+
logger: { debug: vi.fn() },
|
|
68
68
|
requestActivity: createRequestActivity({
|
|
69
69
|
onChange: (fields) => activityRecords.push(fields),
|
|
70
70
|
throttleMs: 0,
|
|
@@ -147,9 +147,9 @@ test('startProxy sends requests back through the hold once a confirmed child goe
|
|
|
147
147
|
// A POST's body was consumed by the failed forward, so it fails once, and
|
|
148
148
|
// the next request waits for the child instead of failing too.
|
|
149
149
|
await stopChildAndRestartSoon();
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
).toBe(
|
|
150
|
+
const dropped = await fetch(`http://localhost:${port}/save`, { method: 'POST', body: '{}' });
|
|
151
|
+
expect(dropped.status).toBe(502);
|
|
152
|
+
expect(dropped.headers.get('x-lowdefy-child')).toBe('dropped');
|
|
153
153
|
expect(await (await fetch(`http://localhost:${port}/c.js`)).text()).toBe('ok');
|
|
154
154
|
|
|
155
155
|
// An exit the manager has seen sends the very next request through the hold.
|
|
@@ -466,3 +466,128 @@ test('startProxy keeps a request held through a child restart counted', async ()
|
|
|
466
466
|
expect(await pending).toBe('new');
|
|
467
467
|
await waitFor(() => activeRequests() === 0);
|
|
468
468
|
});
|
|
469
|
+
|
|
470
|
+
function stopChildIdle() {
|
|
471
|
+
const idleChild = { stopped: true };
|
|
472
|
+
idleChild.isStopped = () => idleChild.stopped;
|
|
473
|
+
idleChild.wake = vi.fn(async () => {
|
|
474
|
+
idleChild.stopped = false;
|
|
475
|
+
});
|
|
476
|
+
context.idleChild = idleChild;
|
|
477
|
+
return idleChild;
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
test.each([
|
|
481
|
+
['a passive read', { method: 'GET', headers: { 'x-lowdefy-passive': '1' } }, '/build-status'],
|
|
482
|
+
[
|
|
483
|
+
'a reload stream reconnect',
|
|
484
|
+
{ method: 'GET', headers: { accept: 'text/event-stream' } },
|
|
485
|
+
'/api/reload',
|
|
486
|
+
],
|
|
487
|
+
[
|
|
488
|
+
'an MCP push stream reconnect',
|
|
489
|
+
{ method: 'GET', headers: { accept: 'text/event-stream' } },
|
|
490
|
+
'/lowdefy-docs/mcp',
|
|
491
|
+
],
|
|
492
|
+
])(
|
|
493
|
+
'startProxy answers %s at once without waking an idle-stopped child',
|
|
494
|
+
async (_, init, requestPath) => {
|
|
495
|
+
let childRequests = 0;
|
|
496
|
+
const port = await startChildAndProxy((req, res) => {
|
|
497
|
+
childRequests += 1;
|
|
498
|
+
res.end('ok');
|
|
499
|
+
});
|
|
500
|
+
context.basePath = '';
|
|
501
|
+
const idleChild = stopChildIdle();
|
|
502
|
+
|
|
503
|
+
const started = Date.now();
|
|
504
|
+
const response = await fetch(`http://localhost:${port}${requestPath}`, init);
|
|
505
|
+
expect(Date.now() - started).toBeLessThan(1000);
|
|
506
|
+
expect(response.status).toBe(503);
|
|
507
|
+
expect(response.headers.get('retry-after')).toBe('5');
|
|
508
|
+
expect(response.headers.get('x-lowdefy-child')).toBe('stopped');
|
|
509
|
+
expect(await response.json()).toEqual({ message: 'Lowdefy dev server is idle.' });
|
|
510
|
+
expect(idleChild.wake).not.toHaveBeenCalled();
|
|
511
|
+
expect(childRequests).toBe(0);
|
|
512
|
+
}
|
|
513
|
+
);
|
|
514
|
+
|
|
515
|
+
test('startProxy answers a websocket upgrade 503 at once while the child is idle-stopped', async () => {
|
|
516
|
+
const port = await startChildAndProxy((req, res) => res.end('ok'));
|
|
517
|
+
const idleChild = stopChildIdle();
|
|
518
|
+
const clientRequest = http.get(`http://localhost:${port}/hmr`, {
|
|
519
|
+
headers: { connection: 'upgrade', upgrade: 'websocket' },
|
|
520
|
+
});
|
|
521
|
+
const response = await new Promise((resolve) => clientRequest.on('response', resolve));
|
|
522
|
+
expect(response.statusCode).toBe(503);
|
|
523
|
+
expect(response.headers['x-lowdefy-child']).toBe('stopped');
|
|
524
|
+
expect(idleChild.wake).not.toHaveBeenCalled();
|
|
525
|
+
});
|
|
526
|
+
|
|
527
|
+
test('startProxy wakes an idle-stopped child for a request that is use and holds it until the child answers', async () => {
|
|
528
|
+
const port = await startChildAndProxy((req, res) => res.end('old'));
|
|
529
|
+
context.basePath = '';
|
|
530
|
+
await close(child);
|
|
531
|
+
const idleChild = stopChildIdle();
|
|
532
|
+
idleChild.wake.mockImplementation(async () => {
|
|
533
|
+
idleChild.stopped = false;
|
|
534
|
+
await new Promise((resolve) => setTimeout(resolve, 300));
|
|
535
|
+
child = http.createServer((req, res) => res.end('woken'));
|
|
536
|
+
await new Promise((resolve) => child.listen(context.internalPort, '127.0.0.1', resolve));
|
|
537
|
+
context.devServer = { exitCode: null, signalCode: null };
|
|
538
|
+
});
|
|
539
|
+
|
|
540
|
+
const response = await fetch(`http://localhost:${port}/page/home`);
|
|
541
|
+
expect(await response.text()).toBe('woken');
|
|
542
|
+
expect(idleChild.wake).toHaveBeenCalledTimes(1);
|
|
543
|
+
});
|
|
544
|
+
|
|
545
|
+
test('startProxy answers a held passive read idle once the child is idle-stopped', async () => {
|
|
546
|
+
const port = await startChildAndProxy((req, res) => res.end('ok'));
|
|
547
|
+
await close(child);
|
|
548
|
+
context.idleChild = { isStopped: () => false, wake: vi.fn() };
|
|
549
|
+
|
|
550
|
+
const pending = fetch(`http://localhost:${port}/build-status`, {
|
|
551
|
+
headers: { 'x-lowdefy-passive': '1' },
|
|
552
|
+
});
|
|
553
|
+
await new Promise((resolve) => setTimeout(resolve, 300));
|
|
554
|
+
context.idleChild.isStopped = () => true;
|
|
555
|
+
const response = await pending;
|
|
556
|
+
expect(response.status).toBe(503);
|
|
557
|
+
expect(response.headers.get('x-lowdefy-child')).toBe('stopped');
|
|
558
|
+
});
|
|
559
|
+
|
|
560
|
+
test('startProxy counts a tab while its reload stream is open', async () => {
|
|
561
|
+
const child$ = heldHandler({ contentType: 'text/event-stream' });
|
|
562
|
+
const port = await startChildAndProxy(child$.handler);
|
|
563
|
+
context.basePath = '/base';
|
|
564
|
+
|
|
565
|
+
const clientRequest = http.get(`http://localhost:${port}/base/api/reload`, {
|
|
566
|
+
headers: { accept: 'text/event-stream' },
|
|
567
|
+
});
|
|
568
|
+
clientRequest.on('error', () => {});
|
|
569
|
+
await new Promise((resolve) => clientRequest.on('response', resolve));
|
|
570
|
+
await waitFor(() => context.requestActivity.snapshot().openTabs === 1);
|
|
571
|
+
expect(activityRecords.at(-1).openTabs).toBe(1);
|
|
572
|
+
expect(activeRequests()).toBe(0);
|
|
573
|
+
|
|
574
|
+
clientRequest.destroy();
|
|
575
|
+
await waitFor(() => context.requestActivity.snapshot().openTabs === 0);
|
|
576
|
+
child$.release();
|
|
577
|
+
});
|
|
578
|
+
|
|
579
|
+
test('startProxy does not count other event streams as tabs', async () => {
|
|
580
|
+
const child$ = heldHandler({ contentType: 'text/event-stream' });
|
|
581
|
+
const port = await startChildAndProxy(child$.handler);
|
|
582
|
+
context.basePath = '';
|
|
583
|
+
|
|
584
|
+
const clientRequest = http.get(`http://localhost:${port}/lowdefy-docs/mcp`, {
|
|
585
|
+
headers: { accept: 'text/event-stream' },
|
|
586
|
+
});
|
|
587
|
+
clientRequest.on('error', () => {});
|
|
588
|
+
await new Promise((resolve) => clientRequest.on('response', resolve));
|
|
589
|
+
await waitFor(() => child$.held.length === 1);
|
|
590
|
+
expect(context.requestActivity.snapshot().openTabs).toBe(0);
|
|
591
|
+
clientRequest.destroy();
|
|
592
|
+
child$.release();
|
|
593
|
+
});
|