@lowdefy/server-dev 7.1.0 → 7.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/client/Inspector.jsx +24 -75
- package/client/Page.jsx +8 -0
- package/client/Routing.jsx +0 -2
- package/client/clientBuildImports.test.mjs +5 -3
- package/client/devStreamConnections.test.mjs +1 -0
- package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
- package/client/openInEditor/OpenInEditorListener.jsx +36 -29
- package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
- package/client/{feedback → openInEditor}/elementInspect.js +9 -44
- package/client/openInEditor/findBlockLocation.js +2 -2
- package/client/openInEditor/openInEditorStyles.js +56 -0
- package/client/recorder/createPairingBuffer.test.mjs +27 -9
- package/client/recorder/createRecorder.js +11 -7
- package/client/recorder/createRecorder.test.mjs +9 -9
- package/client/recorder/isPasswordElement.js +41 -0
- package/client/recorder/keyChord.test.mjs +1 -0
- package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
- package/lib/client/auth/AuthConfigured.jsx +75 -48
- package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
- package/lib/client/auth/authTemplateSync.test.mjs +1 -0
- package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
- package/lib/client/auth/sessionCaller.js +56 -0
- package/lib/client/auth/sessionCaller.test.mjs +78 -0
- package/lib/client/getPagePath.test.mjs +1 -0
- package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
- package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
- package/lib/client/utils/usePageConfig.test.mjs +15 -15
- package/lib/configTree/buildConfigTree.test.mjs +6 -8
- package/lib/configTree/collectConfigText.test.mjs +1 -0
- package/lib/configTree/runConfigTreeBuild.mjs +2 -1
- package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
- package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
- package/lib/docs/addNestedEndpoints.test.mjs +1 -0
- package/lib/docs/checkAgentFiles.test.mjs +1 -0
- package/lib/docs/checkStepReferences.test.mjs +3 -3
- package/lib/docs/clientErrorStore.test.mjs +4 -4
- package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
- package/lib/docs/createDocsMcpServer.js +195 -138
- package/lib/docs/createDocsMcpServer.test.mjs +331 -25
- package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
- package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
- package/lib/docs/createJourneyActors.test.mjs +4 -4
- package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
- package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
- package/lib/docs/dataSets/getDataStore.js +11 -3
- package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
- package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
- package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
- package/lib/docs/dataSets/openDataSession.js +4 -2
- package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
- package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
- package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
- package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
- package/lib/docs/devEventBus.js +7 -2
- package/lib/docs/devEventBus.test.mjs +12 -10
- package/lib/docs/devToolDefinitions.js +87 -135
- package/lib/docs/device/buildDeviceCommand.js +103 -0
- package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
- package/lib/docs/device/captureDevice.js +85 -0
- package/lib/docs/device/checkShownPage.js +56 -0
- package/lib/docs/device/createFakePhoneTab.mjs +77 -0
- package/lib/docs/device/deviceAction.js +74 -0
- package/lib/docs/device/deviceTools.test.mjs +604 -0
- package/lib/docs/device/findDeviceTab.js +50 -0
- package/lib/docs/device/findDeviceTarget.js +73 -0
- package/lib/docs/device/injectDevice.js +160 -0
- package/lib/docs/device/listDevices.js +100 -0
- package/lib/docs/device/listDevices.test.mjs +105 -0
- package/lib/docs/device/runDeviceJourney.js +68 -0
- package/lib/docs/device/runDeviceSteps.js +164 -0
- package/lib/docs/device/screenshotDevice.js +68 -0
- package/lib/docs/device/sendDeviceStep.js +52 -0
- package/lib/docs/device/startDevice.js +150 -0
- package/lib/docs/docs.test.mjs +44 -28
- package/lib/docs/docsIndex.test.mjs +1 -0
- package/lib/docs/findConfig.js +3 -4
- package/lib/docs/findPageBlock.js +35 -0
- package/lib/docs/findPageBlock.test.mjs +45 -0
- package/lib/docs/fitResponse.js +18 -17
- package/lib/docs/fitResponse.test.mjs +18 -0
- package/lib/docs/getBrowser.js +3 -3
- package/lib/docs/getBrowser.test.mjs +32 -16
- package/lib/docs/getBuildId.test.mjs +1 -0
- package/lib/docs/getBuildStatus.test.mjs +11 -11
- package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
- package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
- package/lib/docs/getHazards.js +4 -1
- package/lib/docs/getHazards.test.mjs +9 -7
- package/lib/docs/getOverview.js +20 -42
- package/lib/docs/getOverviewBasePath.test.mjs +1 -0
- package/lib/docs/getStaleStatus.test.mjs +1 -0
- package/lib/docs/inspectState.js +78 -3
- package/lib/docs/inspectState.test.mjs +61 -9
- package/lib/docs/inspectStateFromTab.js +38 -6
- package/lib/docs/inspectStateFromTab.test.mjs +79 -0
- package/lib/docs/inspectStateHeadless.js +98 -34
- package/lib/docs/inspectStateHeadless.test.mjs +17 -5
- package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
- package/lib/docs/installHeadlessShell.js +5 -2
- package/lib/docs/installHeadlessShell.test.mjs +8 -5
- package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
- package/lib/docs/isDeepEqual.js +37 -0
- package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
- package/lib/docs/isPageReady.test.mjs +1 -0
- package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
- package/lib/docs/journeyRunRecording.test.mjs +1 -0
- package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
- package/lib/docs/launchBrowser.test.mjs +8 -8
- package/lib/docs/listTypes.js +58 -8
- package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
- package/lib/docs/matchJourneyRoute.test.mjs +1 -0
- package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
- package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
- package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
- package/lib/docs/observe/withAppErrors.test.mjs +1 -0
- package/lib/docs/openJourneyEmail.test.mjs +6 -6
- package/lib/docs/pageBuildStatus.test.mjs +6 -6
- package/lib/docs/pollTab.js +100 -0
- package/lib/docs/pollTab.test.mjs +64 -0
- package/lib/docs/rails/authEngineActions.test.mjs +1 -0
- package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
- package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
- package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
- package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
- package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
- package/lib/docs/readJourneySession.js +1 -1
- package/lib/docs/reportDevToolFault.js +29 -0
- package/lib/docs/reportDevToolFault.test.mjs +34 -0
- package/lib/docs/requestRestart.test.mjs +1 -0
- package/lib/docs/resolvePageInstance.test.mjs +1 -0
- package/lib/docs/resolveSource.js +2 -2
- package/lib/docs/resolveSource.test.mjs +6 -6
- package/lib/docs/reviewPageBuilds.test.mjs +2 -2
- package/lib/docs/runCheck.test.mjs +3 -3
- package/lib/docs/runCheckChild.js +2 -1
- package/lib/docs/runEndpoint.js +23 -10
- package/lib/docs/runEndpoint.test.mjs +42 -37
- package/lib/docs/runErrorBuffers.test.mjs +1 -0
- package/lib/docs/runJourney.js +21 -1
- package/lib/docs/runJourney.test.mjs +119 -99
- package/lib/docs/runJourneyDataSet.test.mjs +25 -25
- package/lib/docs/runJourneySteps.js +8 -29
- package/lib/docs/runRequest.js +6 -6
- package/lib/docs/runRequest.test.mjs +22 -22
- package/lib/docs/screenshotPage.js +6 -7
- package/lib/docs/screenshotPage.test.mjs +46 -46
- package/lib/docs/screenshotPageClip.test.mjs +10 -10
- package/lib/docs/searchDocs.test.mjs +1 -0
- package/lib/docs/searchIcons.test.mjs +5 -5
- package/lib/docs/selectFinalState.test.mjs +1 -0
- package/lib/docs/serverErrorStore.test.mjs +4 -4
- package/lib/docs/setupTestFixtures.mjs +25 -0
- package/lib/docs/splitSearchTerms.test.mjs +1 -0
- package/lib/docs/tabAvailable.js +1 -1
- package/lib/docs/tabChannel.js +90 -14
- package/lib/docs/tabChannel.test.mjs +40 -15
- package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
- package/lib/docs/validateStateSelection.test.mjs +1 -0
- package/lib/docs/validateViewport.test.mjs +1 -0
- package/lib/docs/waitForBuild.test.mjs +1 -0
- package/lib/docs/withBrowserSlot.test.mjs +5 -5
- package/lib/server/applyDataSetRedirect.test.mjs +2 -2
- package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
- package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
- package/lib/server/auth/getHeadlessUser.js +6 -0
- package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
- package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
- package/lib/server/contextMapBudget.test.mjs +3 -3
- package/lib/server/continueJitKeys.test.mjs +1 -0
- package/lib/server/createLowdefyContext.js +5 -1
- package/lib/server/createLowdefyContext.test.mjs +32 -32
- package/lib/server/getClientAddress.test.mjs +2 -2
- package/lib/server/getPageJitEnrichment.test.mjs +1 -0
- package/lib/server/importAppCode.test.mjs +2 -2
- package/lib/server/jitPageBuilder.js +27 -3
- package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
- package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
- package/lib/server/jitPageBuilder.test.mjs +4 -4
- package/lib/server/journeyCookies.test.mjs +1 -0
- package/lib/server/loadDynamicJsMap.js +10 -1
- package/lib/server/log/createHandleError.js +10 -5
- package/lib/server/log/createHandleError.test.mjs +19 -8
- package/lib/server/log/createLogger.test.mjs +2 -2
- package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
- package/lib/server/mutants/listMutants.test.mjs +1 -0
- package/lib/server/mutants/mutantRuns.test.mjs +1 -0
- package/lib/server/mutants/operators.test.mjs +1 -0
- package/lib/server/pageBuildRecords.test.mjs +1 -0
- package/lib/server/pageCache.test.mjs +1 -0
- package/lib/server/pageRebuilds.test.mjs +3 -3
- package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
- package/lib/server/pruneJitMaps.test.mjs +1 -0
- package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
- package/lib/server/readInstanceRecord.test.mjs +24 -8
- package/lib/server/readMergedMaps.test.mjs +1 -0
- package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
- package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
- package/lib/server/recording/servedBuilds.test.mjs +1 -0
- package/lib/server/sinkExternalConnections.test.mjs +6 -6
- package/lib/server/skipStaleMapWrites.test.mjs +12 -12
- package/lib/server/startIdleGc.test.mjs +25 -9
- package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
- package/lib/vite/createDevServerExclude.test.mjs +1 -0
- package/manager/getContext.mjs +9 -0
- package/manager/processes/checkPendingPlugins.mjs +49 -0
- package/manager/processes/checkPendingPlugins.test.mjs +107 -0
- package/manager/processes/createIdleChild.mjs +141 -0
- package/manager/processes/createIdleChild.test.mjs +209 -0
- package/manager/processes/initialBuild.mjs +2 -15
- package/manager/processes/initialBuild.test.mjs +8 -40
- package/manager/processes/lowdefyBuild.mjs +7 -4
- package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
- package/manager/processes/lowdefyBuild.test.mjs +17 -15
- package/manager/processes/restartServer.test.mjs +63 -15
- package/manager/processes/shutdownServer.test.mjs +3 -3
- package/manager/processes/startFirstServer.test.mjs +23 -22
- package/manager/processes/startMailSink.mjs +11 -3
- package/manager/processes/startMailSink.test.mjs +28 -2
- package/manager/processes/startProxy.mjs +158 -27
- package/manager/processes/startProxy.pairing.test.mjs +204 -0
- package/manager/processes/startProxy.test.mjs +127 -2
- package/manager/processes/startServer.mjs +5 -7
- package/manager/processes/startServer.test.mjs +10 -9
- package/manager/processes/syncServer.mjs +31 -4
- package/manager/processes/syncServer.test.mjs +71 -6
- package/manager/processes/waitForDevServer.test.mjs +21 -6
- package/manager/run.mjs +32 -8
- package/manager/utils/BatchChanges.mjs +1 -1
- package/manager/utils/BatchChanges.test.mjs +4 -4
- package/manager/utils/acquireDevInstance.test.mjs +1 -0
- package/manager/utils/checkPairing.mjs +45 -0
- package/manager/utils/checkPairing.test.mjs +53 -0
- package/manager/utils/createBuildActivity.mjs +5 -1
- package/manager/utils/createBuildActivity.test.mjs +2 -2
- package/manager/utils/createChangeSignal.test.mjs +5 -5
- package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
- package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
- package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
- package/manager/utils/createDotPathIgnore.test.mjs +1 -0
- package/manager/utils/createGlobIgnore.mjs +45 -0
- package/manager/utils/createGlobIgnore.test.mjs +58 -0
- package/manager/utils/createGlobWatchPaths.mjs +75 -0
- package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
- package/manager/utils/createIdleGc.test.mjs +31 -15
- package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
- package/manager/utils/createLanPairing.test.mjs +46 -0
- package/manager/utils/createRequestActivity.mjs +30 -3
- package/manager/utils/createRequestActivity.test.mjs +76 -22
- package/manager/utils/createServerArtifactTracker.mjs +1 -0
- package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
- package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
- package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
- package/manager/utils/findSignInCode.test.mjs +33 -0
- package/manager/utils/formatLanPairing.mjs +32 -0
- package/manager/utils/formatLanPairing.test.mjs +40 -0
- package/manager/utils/getLanAddress.mjs +83 -0
- package/manager/utils/getLanAddress.test.mjs +70 -0
- package/manager/utils/importFresh.test.mjs +1 -0
- package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
- package/manager/utils/pluginTypeCache.mjs +100 -0
- package/manager/utils/pluginTypeCache.test.mjs +141 -0
- package/manager/utils/pruneRecordings.test.mjs +1 -0
- package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
- package/manager/utils/publishBuildDirectory.test.mjs +6 -7
- package/manager/utils/readBasePath.test.mjs +1 -0
- package/manager/utils/readManagerVersion.test.mjs +1 -0
- package/manager/utils/readPluginDefinitions.mjs +6 -6
- package/manager/utils/renderTerminalQr.mjs +54 -0
- package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
- package/manager/utils/setupWatcher.mjs +19 -4
- package/manager/utils/startRecordingPruner.test.mjs +24 -8
- package/manager/utils/waitForChildExit.test.mjs +2 -2
- package/manager/utils/writeBuildStatus.test.mjs +1 -0
- package/manager/watchers/envWatcher.mjs +3 -0
- package/manager/watchers/envWatcher.test.mjs +19 -7
- package/manager/watchers/listServerPluginFiles.mjs +188 -0
- package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
- package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
- package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
- package/manager/watchers/pluginSourceWatcher.mjs +45 -17
- package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
- package/manager/watchers/resolveFile.mjs +46 -0
- package/manager/watchers/resolveFile.test.mjs +67 -0
- package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
- package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
- package/manager/watchers/restartRequestWatcher.mjs +7 -4
- package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
- package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
- package/package.json +50 -49
- package/package.original.json +50 -49
- package/src/app.js +83 -85
- package/src/html/renderDevPage.test.mjs +1 -0
- package/src/lib/getPathSegments.js +16 -1
- package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
- package/src/lib/isTabAnswer.js +32 -0
- package/src/lib/isTabChannelCaller.js +35 -0
- package/src/middleware/apiContext.js +4 -2
- package/src/middleware/createSameOriginGuard.test.mjs +1 -0
- package/src/middleware/errorHandler.js +33 -45
- package/src/middleware/errorHandler.test.mjs +10 -10
- package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
- package/src/middleware/localDevToolsOnly.js +13 -1
- package/src/middleware/localDevToolsOnly.test.mjs +36 -2
- package/src/middleware/noStore.test.mjs +1 -0
- package/src/middleware/staleFlag.test.mjs +1 -0
- package/src/middleware/stampCaller.test.mjs +1 -0
- package/src/routes/agentBearer.test.mjs +183 -0
- package/src/routes/auth.test.mjs +10 -10
- package/src/routes/clientError.js +21 -4
- package/src/routes/clientError.test.mjs +127 -0
- package/src/routes/devInspect.js +6 -51
- package/src/routes/devInspect.test.mjs +128 -3
- package/src/routes/devRecording.js +6 -17
- package/src/routes/devRecording.test.mjs +54 -3
- package/src/routes/docs/buildStatus.test.mjs +6 -6
- package/src/routes/docs/events.test.mjs +4 -4
- package/src/routes/docs/find.js +3 -3
- package/src/routes/docs/journey.test.mjs +8 -8
- package/src/routes/docs/journeyRefusals.test.mjs +9 -9
- package/src/routes/docs/loadDocsRoutes.js +70 -0
- package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
- package/src/routes/docs/mcp.test.mjs +5 -5
- package/src/routes/docs/mutants.js +7 -0
- package/src/routes/docs/mutants.test.mjs +20 -6
- package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
- package/src/routes/docs/parseUserParam.test.mjs +1 -0
- package/src/routes/docs/restart.test.mjs +1 -0
- package/src/routes/endpoints.js +24 -0
- package/src/routes/endpointsLink.test.mjs +111 -0
- package/src/routes/endpointsTextAnswer.test.mjs +8 -8
- package/src/routes/jitPage.js +13 -1
- package/src/routes/jitPage.test.mjs +36 -11
- package/src/routes/mcp.js +6 -0
- package/src/routes/mcp.test.mjs +23 -8
- package/src/routes/mcpMemberToken.test.mjs +8 -8
- package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
- package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
- package/src/routes/mobileRoutes.test.mjs +223 -0
- package/src/routes/mobileSignIn.js +58 -0
- package/src/routes/mobileSignIn.test.mjs +59 -0
- package/src/routes/mobileSignInCallback.js +34 -0
- package/src/routes/mobileSignInCallback.test.mjs +51 -0
- package/src/routes/mountDevPageRoutes.js +10 -2
- package/src/routes/mountDevPageRoutes.test.mjs +25 -1
- package/src/routes/mountMobileWellKnown.js +35 -0
- package/src/routes/mountMobileWellKnown.test.mjs +79 -0
- package/src/routes/mountOauthDiscovery.test.mjs +5 -5
- package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
- package/src/routes/reload.js +101 -20
- package/src/routes/reload.test.mjs +153 -0
- package/src/routes/request.js +1 -22
- package/src/routes/request.test.mjs +7 -24
- package/src/routes/requestBody.test.mjs +14 -27
- package/src/routes/websocket.test.mjs +2 -2
- package/src/routes/wellKnownFallback.test.mjs +2 -2
- package/src/websocket/devWebSocket.test.mjs +12 -12
- package/vite.config.js +13 -1
- package/client/feedback/FeedbackMount.jsx +0 -83
- package/client/feedback/FeedbackOverlay.jsx +0 -904
- package/client/feedback/captureTabScreenshot.js +0 -84
- package/client/feedback/copyToClipboard.js +0 -45
- package/client/feedback/drawAnnotationsSvg.js +0 -119
- package/client/feedback/feedbackStyles.js +0 -304
- package/client/feedback/pinResponsiveImages.js +0 -59
- package/client/feedback/sendFeedback.js +0 -39
- package/client/feedback/useFeedbackToggle.js +0 -70
- package/client/recorder/buildEngineRecord.js +0 -37
- package/client/recorder/buildInteractionRecord.js +0 -64
- package/client/recorder/buildTraceEvent.js +0 -57
- package/client/recorder/buildTraceEvent.test.mjs +0 -81
- package/client/recorder/chunkRecords.js +0 -69
- package/client/recorder/chunkRecords.test.mjs +0 -59
- package/client/recorder/collectEventEndpoints.js +0 -40
- package/client/recorder/collectEventRequests.js +0 -39
- package/client/recorder/createPairingBuffer.js +0 -187
- package/client/recorder/createPasswordRedactor.js +0 -84
- package/client/recorder/createRecordBatcher.js +0 -54
- package/client/recorder/createRecordBatcher.test.mjs +0 -76
- package/client/recorder/createRecordingSession.js +0 -61
- package/client/recorder/createRecordingSession.test.mjs +0 -72
- package/client/recorder/diffStateWrites.js +0 -77
- package/client/recorder/diffStateWrites.test.mjs +0 -66
- package/client/recorder/isEventCall.js +0 -30
- package/client/recorder/jsonType.js +0 -39
- package/client/recorder/sendRecords.js +0 -40
- package/lib/docs/captureAnnotatedScreenshot.js +0 -99
- package/lib/docs/checkpointPaths.js +0 -91
- package/lib/docs/checkpointStore.js +0 -243
- package/lib/docs/checkpointToMocks.js +0 -65
- package/lib/docs/configCheckpoints.test.mjs +0 -156
- package/lib/docs/createConfigCheckpoint.js +0 -92
- package/lib/docs/devMockRegistry.js +0 -68
- package/lib/docs/enrichFeedback.js +0 -71
- package/lib/docs/evalOperator.js +0 -49
- package/lib/docs/evalOperator.test.mjs +0 -157
- package/lib/docs/evalOperatorHeadless.js +0 -159
- package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
- package/lib/docs/evalOperatorInTab.js +0 -49
- package/lib/docs/formatFeedback.js +0 -142
- package/lib/docs/formatFeedback.test.mjs +0 -252
- package/lib/docs/getPluginDoc.js +0 -53
- package/lib/docs/listConfigCheckpoints.js +0 -55
- package/lib/docs/loadState.js +0 -220
- package/lib/docs/revertConfigCheckpoint.js +0 -73
- package/lib/docs/saveAnnotatedScreenshot.js +0 -43
- package/lib/docs/scaffoldPage.js +0 -77
- package/lib/docs/scaffoldPage.test.mjs +0 -97
- package/lib/docs/snapshotState.js +0 -67
- package/lib/docs/stateCheckpoints.test.mjs +0 -443
- package/manager/watchers/listServerSidePackages.mjs +0 -47
- package/manager/watchers/listServerSidePackages.test.mjs +0 -38
- package/src/routes/docs/checkpointsCreate.js +0 -28
- package/src/routes/docs/evalOperator.js +0 -70
- package/src/routes/docs/inspectState.js +0 -59
- package/src/routes/docs/loadState.js +0 -51
- package/src/routes/docs/pluginDoc.js +0 -33
- package/src/routes/docs/plugins.js +0 -23
- package/src/routes/docs/runEndpoint.js +0 -54
- package/src/routes/docs/runEndpoint.test.mjs +0 -165
- package/src/routes/docs/runRequest.js +0 -53
- package/src/routes/docs/runRequest.test.mjs +0 -92
- package/src/routes/docs/schema.js +0 -37
- package/src/routes/docs/screenshot.js +0 -120
- package/src/routes/docs/screenshot.test.mjs +0 -117
- package/src/routes/docs/search.js +0 -40
- package/src/routes/docs/snapshotState.js +0 -50
- package/src/routes/docs/stateCheckpointsList.js +0 -26
- package/src/routes/docs/types.js +0 -33
- package/src/routes/feedback.js +0 -107
- package/src/routes/feedback.test.mjs +0 -204
|
@@ -15,12 +15,13 @@
|
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
import { EventEmitter } from 'node:events';
|
|
18
|
+
import { PassThrough } from 'node:stream';
|
|
18
19
|
|
|
19
|
-
import {
|
|
20
|
+
import { vi, beforeEach, expect, test } from 'vitest';
|
|
20
21
|
|
|
21
|
-
const mockSpawn =
|
|
22
|
+
const mockSpawn = vi.fn();
|
|
22
23
|
const { spawnSync, execSync, exec, execFile, fork } = await import('child_process');
|
|
23
|
-
|
|
24
|
+
vi.doMock('child_process', () => ({
|
|
24
25
|
spawn: mockSpawn,
|
|
25
26
|
spawnSync,
|
|
26
27
|
execSync,
|
|
@@ -28,9 +29,9 @@ jest.unstable_mockModule('child_process', () => ({
|
|
|
28
29
|
execFile,
|
|
29
30
|
fork,
|
|
30
31
|
}));
|
|
31
|
-
|
|
32
|
-
const mockWaitForServer =
|
|
33
|
-
|
|
32
|
+
vi.doMock('../utils/readBasePath.mjs', () => ({ default: () => '' }));
|
|
33
|
+
const mockWaitForServer = vi.fn(async () => true);
|
|
34
|
+
vi.doMock('../utils/waitForServer.mjs', () => ({ default: mockWaitForServer }));
|
|
34
35
|
|
|
35
36
|
const { default: optimizeDependencies } = await import('./optimizeDependencies.mjs');
|
|
36
37
|
const { default: restartServer } = await import('./restartServer.mjs');
|
|
@@ -41,7 +42,7 @@ const { default: syncServer } = await import('./syncServer.mjs');
|
|
|
41
42
|
function createProcess() {
|
|
42
43
|
return Object.assign(new EventEmitter(), {
|
|
43
44
|
stdout: new EventEmitter(),
|
|
44
|
-
stderr: new
|
|
45
|
+
stderr: new PassThrough(),
|
|
45
46
|
});
|
|
46
47
|
}
|
|
47
48
|
|
|
@@ -49,14 +50,14 @@ function createContext() {
|
|
|
49
50
|
const context = {
|
|
50
51
|
bin: { vite: '/server/node_modules/vite/bin/vite.js' },
|
|
51
52
|
directories: { config: '/apps/tenant', server: '/server' },
|
|
52
|
-
instance: { update:
|
|
53
|
+
instance: { update: vi.fn() },
|
|
53
54
|
internalPort: 3211,
|
|
54
|
-
logger: { debug:
|
|
55
|
+
logger: { debug: vi.fn(), error: vi.fn(), info: vi.fn(), warn: vi.fn() },
|
|
55
56
|
mailSink: null,
|
|
56
|
-
markServerReady:
|
|
57
|
+
markServerReady: vi.fn(),
|
|
57
58
|
options: { port: 3210 },
|
|
58
|
-
serverArtifacts: { record:
|
|
59
|
-
shutdownServer:
|
|
59
|
+
serverArtifacts: { record: vi.fn() },
|
|
60
|
+
shutdownServer: vi.fn(),
|
|
60
61
|
};
|
|
61
62
|
context.optimizeDependencies = optimizeDependencies(context);
|
|
62
63
|
context.syncServer = syncServer(context);
|
|
@@ -69,10 +70,10 @@ function createContext() {
|
|
|
69
70
|
function createTracker(files) {
|
|
70
71
|
let started = {};
|
|
71
72
|
return {
|
|
72
|
-
record:
|
|
73
|
+
record: vi.fn(() => {
|
|
73
74
|
started = { ...files };
|
|
74
75
|
}),
|
|
75
|
-
check:
|
|
76
|
+
check: vi.fn(() => {
|
|
76
77
|
const changed = Object.keys(files).filter((file) => files[file] !== started[file]);
|
|
77
78
|
return { install: changed.includes('package.json'), restart: changed.length > 0 };
|
|
78
79
|
}),
|
|
@@ -164,7 +165,7 @@ test('the optimiser resolves the same environment as the child, apart from the b
|
|
|
164
165
|
test('a watcher sync during the optimise waits for the first start and restarts nothing', async () => {
|
|
165
166
|
const context = createContext();
|
|
166
167
|
context.serverArtifacts = createTracker({ 'build/config.json': 'a', 'package.json': 'a' });
|
|
167
|
-
context.restartServer =
|
|
168
|
+
context.restartServer = vi.fn(async () => startServer(context));
|
|
168
169
|
|
|
169
170
|
const started = startFirstServer(context);
|
|
170
171
|
await flush();
|
|
@@ -190,10 +191,10 @@ test('a config edit during the optimise is rebuilt at once, and its sync resolve
|
|
|
190
191
|
const context = createContext();
|
|
191
192
|
const files = { 'build/config.json': 'a', 'package.json': 'a' };
|
|
192
193
|
context.serverArtifacts = createTracker(files);
|
|
193
|
-
context.lowdefyBuild =
|
|
194
|
+
context.lowdefyBuild = vi.fn(async () => {
|
|
194
195
|
files['build/config.json'] = 'b';
|
|
195
196
|
});
|
|
196
|
-
context.restartServer =
|
|
197
|
+
context.restartServer = vi.fn(async () => {
|
|
197
198
|
context.serverArtifacts.record();
|
|
198
199
|
startServer(context);
|
|
199
200
|
});
|
|
@@ -225,11 +226,11 @@ test('a plugin package added during the optimise is installed by the queued sync
|
|
|
225
226
|
context.serverArtifacts = createTracker(files);
|
|
226
227
|
const events = [];
|
|
227
228
|
context.buildActivity = { track: (task) => task() };
|
|
228
|
-
context.installPlugins =
|
|
229
|
-
context.lowdefyBuild =
|
|
230
|
-
context.restartServer =
|
|
229
|
+
context.installPlugins = vi.fn(async () => events.push('install'));
|
|
230
|
+
context.lowdefyBuild = vi.fn(async () => events.push('build'));
|
|
231
|
+
context.restartServer = vi.fn(async () => events.push('restart'));
|
|
231
232
|
let finishOptimise;
|
|
232
|
-
context.optimizeDependencies =
|
|
233
|
+
context.optimizeDependencies = vi.fn(async () => events.push('optimise'));
|
|
233
234
|
context.optimizeDependencies.mockImplementationOnce(
|
|
234
235
|
() =>
|
|
235
236
|
new Promise((resolve) => {
|
|
@@ -257,7 +258,7 @@ test('startFirstServer resolves once the first child answers, before a queued sy
|
|
|
257
258
|
const context = createContext();
|
|
258
259
|
const files = { 'build/config.json': 'a', 'package.json': 'a' };
|
|
259
260
|
context.serverArtifacts = createTracker(files);
|
|
260
|
-
context.restartServer =
|
|
261
|
+
context.restartServer = vi.fn(async () => {
|
|
261
262
|
context.serverArtifacts.record();
|
|
262
263
|
startServer(context);
|
|
263
264
|
});
|
|
@@ -18,6 +18,7 @@ import fs from 'node:fs';
|
|
|
18
18
|
import path from 'node:path';
|
|
19
19
|
|
|
20
20
|
import getMailOutboxDirectory from '../../lib/docs/getMailOutboxDirectory.js';
|
|
21
|
+
import findSignInCode from '../utils/findSignInCode.mjs';
|
|
21
22
|
|
|
22
23
|
/*
|
|
23
24
|
With LOWDEFY_DEV_SMTP_PORT set, the dev server receives mail over SMTP on that
|
|
@@ -29,7 +30,10 @@ filter, nodemailer, templates - runs exactly as in production. The manager owns
|
|
|
29
30
|
the listener so it survives restarts of the server child, and tells each child
|
|
30
31
|
it is listening (startServer passes LOWDEFY_SERVER_DEV_MAIL_SINK), so a port
|
|
31
32
|
added to .env after start is not mistaken for a running sink. The outbox is
|
|
32
|
-
cleared at start, so a test run only ever sees the mail it caused.
|
|
33
|
+
cleared at start, so a test run only ever sees the mail it caused. A message
|
|
34
|
+
that carries a sign-in code also prints it (`code for <to>: <code>`), so a
|
|
35
|
+
person signing in on a phone, or an agent reading lowdefy_dev_logs, has it
|
|
36
|
+
without opening the outbox.
|
|
33
37
|
*/
|
|
34
38
|
|
|
35
39
|
function readSmtpPort() {
|
|
@@ -52,7 +56,7 @@ async function readStream(stream) {
|
|
|
52
56
|
return Buffer.concat(chunks);
|
|
53
57
|
}
|
|
54
58
|
|
|
55
|
-
function createMessageWriter({ directory, PostalMime }) {
|
|
59
|
+
function createMessageWriter({ directory, logger, PostalMime }) {
|
|
56
60
|
let sequence = 0;
|
|
57
61
|
return async function writeMessage({ raw, envelope }) {
|
|
58
62
|
// Numbered on arrival, before the parse, so the outbox order is the order
|
|
@@ -72,6 +76,10 @@ function createMessageWriter({ directory, PostalMime }) {
|
|
|
72
76
|
const filePath = path.join(directory, `${id}.json`);
|
|
73
77
|
await fs.promises.writeFile(`${filePath}.tmp`, JSON.stringify(message, null, 2));
|
|
74
78
|
await fs.promises.rename(`${filePath}.tmp`, filePath);
|
|
79
|
+
const code = findSignInCode({ text: message.text });
|
|
80
|
+
if (code !== null) {
|
|
81
|
+
logger.info(`code for ${message.to.join(', ')}: ${code}`);
|
|
82
|
+
}
|
|
75
83
|
};
|
|
76
84
|
}
|
|
77
85
|
|
|
@@ -110,7 +118,7 @@ async function startMailSink(context) {
|
|
|
110
118
|
const directory = getMailOutboxDirectory({ configDirectory: context.directories.config });
|
|
111
119
|
fs.rmSync(directory, { recursive: true, force: true });
|
|
112
120
|
fs.mkdirSync(directory, { recursive: true });
|
|
113
|
-
const writeMessage = createMessageWriter({ directory, PostalMime });
|
|
121
|
+
const writeMessage = createMessageWriter({ directory, logger: context.logger, PostalMime });
|
|
114
122
|
|
|
115
123
|
const server = new smtpServer.SMTPServer({
|
|
116
124
|
authOptional: true,
|
|
@@ -19,7 +19,7 @@ import net from 'node:net';
|
|
|
19
19
|
import os from 'node:os';
|
|
20
20
|
import path from 'node:path';
|
|
21
21
|
|
|
22
|
-
import {
|
|
22
|
+
import { vi, afterEach, beforeEach, expect, test } from 'vitest';
|
|
23
23
|
import nodemailer from 'nodemailer';
|
|
24
24
|
|
|
25
25
|
import readMailOutbox from '../../lib/docs/readMailOutbox.js';
|
|
@@ -55,7 +55,7 @@ afterEach(async () => {
|
|
|
55
55
|
function createContext() {
|
|
56
56
|
return {
|
|
57
57
|
directories: { config: configDirectory },
|
|
58
|
-
logger: { info:
|
|
58
|
+
logger: { info: vi.fn(), error: vi.fn() },
|
|
59
59
|
};
|
|
60
60
|
}
|
|
61
61
|
|
|
@@ -144,3 +144,29 @@ test('startMailSink fails with the port when LOWDEFY_DEV_SMTP_PORT is taken', as
|
|
|
144
144
|
await new Promise((resolve) => blocker.close(resolve));
|
|
145
145
|
}
|
|
146
146
|
});
|
|
147
|
+
|
|
148
|
+
test('startMailSink prints the sign-in code a message carries', async () => {
|
|
149
|
+
const port = await getFreePort();
|
|
150
|
+
process.env.LOWDEFY_DEV_SMTP_PORT = String(port);
|
|
151
|
+
const context = createContext();
|
|
152
|
+
sink = await startMailSink(context);
|
|
153
|
+
const transport = nodemailer.createTransport({ host: '127.0.0.1', port, secure: false });
|
|
154
|
+
await transport.sendMail({
|
|
155
|
+
from: 'app@localhost',
|
|
156
|
+
to: 'ada@example.test',
|
|
157
|
+
subject: 'Your sign-in code',
|
|
158
|
+
text: 'Enter this code on the sign-in page to continue.\n\n482913\n\nThis code expires in 5 minutes.',
|
|
159
|
+
});
|
|
160
|
+
await transport.sendMail({
|
|
161
|
+
from: 'app@localhost',
|
|
162
|
+
to: 'ada@example.test',
|
|
163
|
+
subject: 'Order shipped',
|
|
164
|
+
text: 'Your order 123456 has shipped.',
|
|
165
|
+
});
|
|
166
|
+
transport.close();
|
|
167
|
+
|
|
168
|
+
const printed = context.logger.info.mock.calls.map(([line]) => line);
|
|
169
|
+
expect(printed.filter((line) => line.startsWith('code for'))).toEqual([
|
|
170
|
+
'code for ada@example.test: 482913',
|
|
171
|
+
]);
|
|
172
|
+
});
|
|
@@ -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,15 @@ 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
|
+
A child stopped for being idle (createIdleChild) is started again only by a
|
|
57
|
+
request that is use (isActivity), which is held as for a restart. A request
|
|
58
|
+
that is not use - a passive read, an event-stream GET, a websocket upgrade -
|
|
59
|
+
is answered 503 at once with Retry-After, so status checks and reconnecting
|
|
60
|
+
streams neither wake the child nor wait out the hold.
|
|
61
|
+
|
|
62
|
+
The proxy also counts the tabs holding a reload stream open, from the
|
|
63
|
+
stream's response start until it closes: an open tab keeps the child up.
|
|
53
64
|
*/
|
|
54
65
|
|
|
55
66
|
const RETRY_MS = 250;
|
|
@@ -69,10 +80,16 @@ function probeChild(port) {
|
|
|
69
80
|
});
|
|
70
81
|
}
|
|
71
82
|
|
|
72
|
-
|
|
83
|
+
function isChildStopped(context) {
|
|
84
|
+
return context.idleChild?.isStopped() === true;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
// givesUp ends the wait early: a request that does not wake the child stops
|
|
88
|
+
// waiting once the child is idle-stopped.
|
|
89
|
+
async function waitForChild({ port, deadline, givesUp = () => false }) {
|
|
73
90
|
for (;;) {
|
|
74
91
|
if (await probeChild(port)) return true;
|
|
75
|
-
if (Date.now() > deadline) return false;
|
|
92
|
+
if (Date.now() > deadline || givesUp()) return false;
|
|
76
93
|
await new Promise((resolve) => setTimeout(resolve, RETRY_MS));
|
|
77
94
|
}
|
|
78
95
|
}
|
|
@@ -94,13 +111,17 @@ function waitUntil({ promise, deadline }) {
|
|
|
94
111
|
]);
|
|
95
112
|
}
|
|
96
113
|
|
|
97
|
-
async function waitForConfirmedChild({ context, proxyState, deadline }) {
|
|
114
|
+
async function waitForConfirmedChild({ context, proxyState, deadline, wakes }) {
|
|
98
115
|
if (isConfirmedChild({ context, proxyState })) {
|
|
99
116
|
return true;
|
|
100
117
|
}
|
|
101
118
|
await waitUntil({ promise: context.devServerExited, deadline });
|
|
102
119
|
const child = context.devServer;
|
|
103
|
-
const up = await waitForChild({
|
|
120
|
+
const up = await waitForChild({
|
|
121
|
+
port: context.internalPort,
|
|
122
|
+
deadline,
|
|
123
|
+
givesUp: () => !wakes && isChildStopped(context),
|
|
124
|
+
});
|
|
104
125
|
if (up) {
|
|
105
126
|
proxyState.confirmedChild = child;
|
|
106
127
|
}
|
|
@@ -109,6 +130,25 @@ async function waitForConfirmedChild({ context, proxyState, deadline }) {
|
|
|
109
130
|
|
|
110
131
|
const REPLAYABLE_METHODS = ['GET', 'HEAD'];
|
|
111
132
|
|
|
133
|
+
const IDLE_RETRY_AFTER_S = 5;
|
|
134
|
+
|
|
135
|
+
function answerIdle(res) {
|
|
136
|
+
res.writeHead(503, {
|
|
137
|
+
'content-type': 'application/json',
|
|
138
|
+
'retry-after': String(IDLE_RETRY_AFTER_S),
|
|
139
|
+
'x-lowdefy-child': 'stopped',
|
|
140
|
+
});
|
|
141
|
+
res.end(JSON.stringify({ message: 'Lowdefy dev server is idle.' }));
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
function isReloadStream({ context, req }) {
|
|
145
|
+
if (req.method !== 'GET') {
|
|
146
|
+
return false;
|
|
147
|
+
}
|
|
148
|
+
const { pathname } = new URL(req.url, 'http://localhost');
|
|
149
|
+
return pathname === `${context.basePath ?? ''}/api/reload`;
|
|
150
|
+
}
|
|
151
|
+
|
|
112
152
|
// Nothing reached the child: the connect was refused, or the keep-alive socket
|
|
113
153
|
// the agent reused had already been closed by a child that is going away.
|
|
114
154
|
function isUnsentError({ error, proxyReq }) {
|
|
@@ -117,17 +157,26 @@ function isUnsentError({ error, proxyReq }) {
|
|
|
117
157
|
);
|
|
118
158
|
}
|
|
119
159
|
|
|
120
|
-
function forwardRequest(
|
|
160
|
+
function forwardRequest(
|
|
161
|
+
{ body, context, proxyState, wakes },
|
|
162
|
+
req,
|
|
163
|
+
res,
|
|
164
|
+
deadline = Date.now() + HOLD_MS
|
|
165
|
+
) {
|
|
121
166
|
// Wait for a live child BEFORE piping the request body — the body stream can
|
|
122
167
|
// only be consumed once, so retrying after a failed proxy request would need
|
|
123
168
|
// full-body buffering. Only a bodiless GET or HEAD that never reached the
|
|
124
169
|
// child is replayed; any other request that loses the child mid-forward
|
|
125
170
|
// surfaces as one 502, which the client's next attempt resolves through the
|
|
126
171
|
// hold.
|
|
127
|
-
waitForConfirmedChild({ context, proxyState, deadline }).then((up) => {
|
|
172
|
+
waitForConfirmedChild({ context, proxyState, deadline, wakes }).then((up) => {
|
|
128
173
|
// The response, not the request: an incoming request reads as destroyed
|
|
129
174
|
// once its body has been read, which a replayed GET's has.
|
|
130
175
|
if (res.destroyed) return;
|
|
176
|
+
if (!up && !wakes && isChildStopped(context)) {
|
|
177
|
+
answerIdle(res);
|
|
178
|
+
return;
|
|
179
|
+
}
|
|
131
180
|
if (!up) {
|
|
132
181
|
res.writeHead(503, { 'content-type': 'application/json' });
|
|
133
182
|
res.end(JSON.stringify({ message: 'Lowdefy dev server is restarting.' }));
|
|
@@ -141,6 +190,9 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
|
|
|
141
190
|
headers: req.headers,
|
|
142
191
|
});
|
|
143
192
|
proxyReq.on('response', (proxyRes) => {
|
|
193
|
+
if (proxyRes.statusCode === 200 && isReloadStream({ context, req })) {
|
|
194
|
+
context.requestActivity.trackTab(res);
|
|
195
|
+
}
|
|
144
196
|
res.writeHead(proxyRes.statusCode, proxyRes.headers);
|
|
145
197
|
// flushHeaders so SSE endpoints (reload stream, MCP notifications)
|
|
146
198
|
// reach the client before the first event.
|
|
@@ -154,7 +206,7 @@ function forwardRequest({ body, context, proxyState }, req, res, deadline = Date
|
|
|
154
206
|
REPLAYABLE_METHODS.includes(req.method) &&
|
|
155
207
|
isUnsentError({ error, proxyReq })
|
|
156
208
|
) {
|
|
157
|
-
forwardRequest({ body, context, proxyState }, req, res, deadline);
|
|
209
|
+
forwardRequest({ body, context, proxyState, wakes }, req, res, deadline);
|
|
158
210
|
return;
|
|
159
211
|
}
|
|
160
212
|
if (res.headersSent) {
|
|
@@ -203,9 +255,42 @@ function isActivity(req) {
|
|
|
203
255
|
// latest edits, restarts included, and only then forwarded: a restart ends
|
|
204
256
|
// the dev server process, and any wait running in it. The header tells the
|
|
205
257
|
// dev server what this wait saw, so it does not wait again.
|
|
258
|
+
// The pairing gate sits here, in front of Vite and the app alike, because the
|
|
259
|
+
// child only ever sees the proxy's loopback address. The child learns that a
|
|
260
|
+
// caller is remote from remoteCallerHeader, which only the proxy sets.
|
|
261
|
+
function readAccess({ context, req }) {
|
|
262
|
+
return checkPairing({
|
|
263
|
+
remoteAddress: req.socket.remoteAddress,
|
|
264
|
+
pairToken: context.lan?.token,
|
|
265
|
+
providedToken: req.headers[pairHeader],
|
|
266
|
+
});
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
const PAIRING_REFUSAL =
|
|
270
|
+
'This dev server answers other machines only with the pairing token that `lowdefy dev --lan` prints.';
|
|
271
|
+
|
|
206
272
|
async function handleRequest({ context, proxyState }, req, res) {
|
|
207
|
-
|
|
273
|
+
const access = readAccess({ context, req });
|
|
274
|
+
if (access === 'refused') {
|
|
275
|
+
res.writeHead(401, { 'content-type': 'application/json' });
|
|
276
|
+
res.end(JSON.stringify({ message: PAIRING_REFUSAL }));
|
|
277
|
+
return;
|
|
278
|
+
}
|
|
279
|
+
delete req.headers[pairHeader];
|
|
280
|
+
delete req.headers[remoteCallerHeader];
|
|
281
|
+
if (access === 'paired') {
|
|
282
|
+
req.headers[remoteCallerHeader] = '1';
|
|
283
|
+
}
|
|
284
|
+
const wakes = isActivity(req);
|
|
285
|
+
if (!wakes && isChildStopped(context)) {
|
|
286
|
+
answerIdle(res);
|
|
287
|
+
return;
|
|
288
|
+
}
|
|
289
|
+
if (wakes) {
|
|
208
290
|
context.requestActivity.trackResponse(res);
|
|
291
|
+
if (isChildStopped(context)) {
|
|
292
|
+
context.idleChild.wake().catch((error) => context.logger.error(error));
|
|
293
|
+
}
|
|
209
294
|
}
|
|
210
295
|
delete req.headers[buildWaitHeader];
|
|
211
296
|
const { wait, body } = await readBuildStatusWait({ basePath: context.basePath, req });
|
|
@@ -217,12 +302,39 @@ async function handleRequest({ context, proxyState }, req, res) {
|
|
|
217
302
|
waitedMs: String(waited.waitedMs),
|
|
218
303
|
}).toString();
|
|
219
304
|
}
|
|
220
|
-
forwardRequest({ body, context, proxyState }, req, res);
|
|
305
|
+
forwardRequest({ body, context, proxyState, wakes }, req, res);
|
|
221
306
|
}
|
|
222
307
|
|
|
308
|
+
const IDLE_UPGRADE_RESPONSE = [
|
|
309
|
+
'HTTP/1.1 503 Service Unavailable',
|
|
310
|
+
`retry-after: ${IDLE_RETRY_AFTER_S}`,
|
|
311
|
+
'x-lowdefy-child: stopped',
|
|
312
|
+
'connection: close',
|
|
313
|
+
'',
|
|
314
|
+
'',
|
|
315
|
+
].join('\r\n');
|
|
316
|
+
|
|
317
|
+
// An upgrade is never use (see isActivity), so it never wakes an idle-stopped child.
|
|
223
318
|
function forwardUpgrade(context, req, socket, head) {
|
|
224
|
-
|
|
319
|
+
const access = readAccess({ context, req });
|
|
320
|
+
if (access === 'refused') {
|
|
321
|
+
socket.end('HTTP/1.1 401 Unauthorized\r\nconnection: close\r\n\r\n');
|
|
322
|
+
return;
|
|
323
|
+
}
|
|
324
|
+
if (isChildStopped(context)) {
|
|
325
|
+
socket.end(IDLE_UPGRADE_RESPONSE);
|
|
326
|
+
return;
|
|
327
|
+
}
|
|
328
|
+
waitForChild({
|
|
329
|
+
port: context.internalPort,
|
|
330
|
+
deadline: Date.now() + HOLD_MS,
|
|
331
|
+
givesUp: () => isChildStopped(context),
|
|
332
|
+
}).then((up) => {
|
|
225
333
|
if (socket.destroyed) return;
|
|
334
|
+
if (!up && isChildStopped(context)) {
|
|
335
|
+
socket.end(IDLE_UPGRADE_RESPONSE);
|
|
336
|
+
return;
|
|
337
|
+
}
|
|
226
338
|
if (!up) {
|
|
227
339
|
socket.end('HTTP/1.1 503 Service Unavailable\r\nconnection: close\r\n\r\n');
|
|
228
340
|
return;
|
|
@@ -233,7 +345,13 @@ function forwardUpgrade(context, req, socket, head) {
|
|
|
233
345
|
// websockets both pass through untouched.
|
|
234
346
|
const lines = [`${req.method} ${req.url} HTTP/1.1`];
|
|
235
347
|
for (let i = 0; i < req.rawHeaders.length; i += 2) {
|
|
236
|
-
|
|
348
|
+
const name = req.rawHeaders[i].toLowerCase();
|
|
349
|
+
if (name !== pairHeader && name !== remoteCallerHeader) {
|
|
350
|
+
lines.push(`${req.rawHeaders[i]}: ${req.rawHeaders[i + 1]}`);
|
|
351
|
+
}
|
|
352
|
+
}
|
|
353
|
+
if (access === 'paired') {
|
|
354
|
+
lines.push(`${remoteCallerHeader}: 1`);
|
|
237
355
|
}
|
|
238
356
|
upstream.write(lines.join('\r\n') + '\r\n\r\n');
|
|
239
357
|
if (head?.length) upstream.write(head);
|
|
@@ -247,9 +365,17 @@ function forwardUpgrade(context, req, socket, head) {
|
|
|
247
365
|
});
|
|
248
366
|
}
|
|
249
367
|
|
|
250
|
-
function
|
|
251
|
-
|
|
252
|
-
|
|
368
|
+
function listen({ server, port, host }) {
|
|
369
|
+
return new Promise((resolve, reject) => {
|
|
370
|
+
server.once('error', reject);
|
|
371
|
+
server.listen(port, host, () => {
|
|
372
|
+
server.removeListener('error', reject);
|
|
373
|
+
resolve();
|
|
374
|
+
});
|
|
375
|
+
});
|
|
376
|
+
}
|
|
377
|
+
|
|
378
|
+
function createProxyServer({ context, proxyState }) {
|
|
253
379
|
const proxy = http.createServer((req, res) => {
|
|
254
380
|
// A client that drops an MCP request while its body is read.
|
|
255
381
|
handleRequest({ context, proxyState }, req, res).catch(() => res.destroy());
|
|
@@ -259,19 +385,24 @@ function startProxy(context) {
|
|
|
259
385
|
// request timeout; keep the proxy transparent.
|
|
260
386
|
proxy.requestTimeout = 0;
|
|
261
387
|
proxy.headersTimeout = 60000;
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
388
|
+
return proxy;
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
async function startProxy(context) {
|
|
392
|
+
if (context.proxyServer) return;
|
|
393
|
+
const proxyState = { confirmedChild: null };
|
|
394
|
+
const { port } = context.options;
|
|
395
|
+
context.proxyServer = createProxyServer({ context, proxyState });
|
|
396
|
+
// 'localhost' for parity with the Vite default host the child used to bind
|
|
397
|
+
// - the dev server stays loopback-only unless --lan asks for the network.
|
|
398
|
+
await listen({ server: context.proxyServer, port, host: 'localhost' });
|
|
399
|
+
// --lan adds a listener on the chosen interface's address only, not on every
|
|
400
|
+
// interface, so a VPN or Docker network does not reach the server too.
|
|
401
|
+
if (context.lan) {
|
|
402
|
+
context.lanProxyServer = createProxyServer({ context, proxyState });
|
|
403
|
+
await listen({ server: context.lanProxyServer, port, host: context.lan.address });
|
|
404
|
+
}
|
|
405
|
+
context.logger.debug(`Proxy listening on port ${port}, forwarding to ${context.internalPort}.`);
|
|
275
406
|
}
|
|
276
407
|
|
|
277
408
|
export default startProxy;
|