@lowdefy/server-dev 7.0.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/checkSharedCollectionIds.js +20 -9
- package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
- package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
- 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/groupDataSetByCollection.js +19 -11
- package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
- package/lib/docs/dataSets/openDataSession.js +36 -20
- package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
- package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
- package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
- package/lib/docs/dataSets/readDataSet.js +34 -19
- package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
- package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
- package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
- package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
- package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -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 +4 -4
- package/lib/docs/getBrowser.test.mjs +32 -16
- package/lib/docs/getBuildId.test.mjs +1 -0
- package/lib/docs/getBuildStatus.js +29 -3
- package/lib/docs/getBuildStatus.test.mjs +108 -12
- 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 +22 -44
- 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.js +3 -3
- 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 +26 -26
- 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/docs/withDataSession.js +2 -2
- package/lib/server/applyDataSetRedirect.js +14 -5
- package/lib/server/applyDataSetRedirect.test.mjs +121 -15
- package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
- package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
- 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 +8 -4
- package/lib/server/createLowdefyContext.test.mjs +38 -35
- 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 +5 -1
- 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 +11 -2
- 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 +4 -15
- package/manager/processes/initialBuild.test.mjs +8 -37
- package/manager/processes/lowdefyBuild.mjs +11 -7
- package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -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/manager/utils/createLanPairing.mjs +34 -0
- 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/dataSets/findCollectionCollisions.js +0 -52
- package/lib/docs/devMockRegistry.js +0 -68
- package/lib/docs/enrichFeedback.js +0 -71
- package/lib/docs/evalOperator.js +0 -49
- package/lib/docs/evalOperator.test.mjs +0 -157
- package/lib/docs/evalOperatorHeadless.js +0 -159
- package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
- package/lib/docs/evalOperatorInTab.js +0 -49
- package/lib/docs/formatFeedback.js +0 -142
- package/lib/docs/formatFeedback.test.mjs +0 -252
- package/lib/docs/getPluginDoc.js +0 -53
- package/lib/docs/listConfigCheckpoints.js +0 -55
- package/lib/docs/loadState.js +0 -220
- package/lib/docs/revertConfigCheckpoint.js +0 -73
- package/lib/docs/saveAnnotatedScreenshot.js +0 -43
- package/lib/docs/scaffoldPage.js +0 -77
- package/lib/docs/scaffoldPage.test.mjs +0 -97
- package/lib/docs/snapshotState.js +0 -67
- package/lib/docs/stateCheckpoints.test.mjs +0 -443
- package/manager/watchers/listServerSidePackages.mjs +0 -47
- package/manager/watchers/listServerSidePackages.test.mjs +0 -38
- package/src/routes/docs/checkpointsCreate.js +0 -28
- package/src/routes/docs/evalOperator.js +0 -70
- package/src/routes/docs/inspectState.js +0 -59
- package/src/routes/docs/loadState.js +0 -51
- package/src/routes/docs/pluginDoc.js +0 -33
- package/src/routes/docs/plugins.js +0 -23
- package/src/routes/docs/runEndpoint.js +0 -54
- package/src/routes/docs/runEndpoint.test.mjs +0 -165
- package/src/routes/docs/runRequest.js +0 -53
- package/src/routes/docs/runRequest.test.mjs +0 -92
- package/src/routes/docs/schema.js +0 -37
- package/src/routes/docs/screenshot.js +0 -120
- package/src/routes/docs/screenshot.test.mjs +0 -117
- package/src/routes/docs/search.js +0 -40
- package/src/routes/docs/snapshotState.js +0 -50
- package/src/routes/docs/stateCheckpointsList.js +0 -26
- package/src/routes/docs/types.js +0 -33
- package/src/routes/feedback.js +0 -107
- package/src/routes/feedback.test.mjs +0 -204
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
import {
|
|
17
|
+
import { vi, afterEach, beforeEach, expect, test } from 'vitest';
|
|
18
18
|
|
|
19
19
|
import startIdleGc from './startIdleGc.js';
|
|
20
20
|
|
|
@@ -37,15 +37,31 @@ function start(options = {}) {
|
|
|
37
37
|
|
|
38
38
|
function tick(ms) {
|
|
39
39
|
clock += ms;
|
|
40
|
-
|
|
40
|
+
vi.advanceTimersByTime(ms);
|
|
41
41
|
}
|
|
42
42
|
|
|
43
43
|
beforeEach(() => {
|
|
44
44
|
// performance is not redefinable on this Node, and nothing here reads it.
|
|
45
|
-
|
|
45
|
+
vi.useFakeTimers({
|
|
46
|
+
toFake: [
|
|
47
|
+
'Date',
|
|
48
|
+
'hrtime',
|
|
49
|
+
'queueMicrotask',
|
|
50
|
+
'requestAnimationFrame',
|
|
51
|
+
'cancelAnimationFrame',
|
|
52
|
+
'requestIdleCallback',
|
|
53
|
+
'cancelIdleCallback',
|
|
54
|
+
'setImmediate',
|
|
55
|
+
'clearImmediate',
|
|
56
|
+
'setInterval',
|
|
57
|
+
'clearInterval',
|
|
58
|
+
'setTimeout',
|
|
59
|
+
'clearTimeout',
|
|
60
|
+
],
|
|
61
|
+
});
|
|
46
62
|
delete globalThis[STARTED];
|
|
47
63
|
clock = START;
|
|
48
|
-
gc =
|
|
64
|
+
gc = vi.fn();
|
|
49
65
|
record = {
|
|
50
66
|
lastActivityAt: new Date(START).toISOString(),
|
|
51
67
|
activeRequests: 0,
|
|
@@ -54,8 +70,8 @@ beforeEach(() => {
|
|
|
54
70
|
});
|
|
55
71
|
|
|
56
72
|
afterEach(() => {
|
|
57
|
-
|
|
58
|
-
|
|
73
|
+
vi.clearAllTimers();
|
|
74
|
+
vi.useRealTimers();
|
|
59
75
|
delete globalThis[STARTED];
|
|
60
76
|
});
|
|
61
77
|
|
|
@@ -111,7 +127,7 @@ test('startIdleGc does nothing when the instance record has no activity', () =>
|
|
|
111
127
|
});
|
|
112
128
|
|
|
113
129
|
test('startIdleGc does nothing when the child was started without gc exposed', () => {
|
|
114
|
-
// The gc default is globalThis.gc, which every later test file in a
|
|
130
|
+
// The gc default is globalThis.gc, which every later test file in a test worker has once
|
|
115
131
|
// createIdleGc.test.mjs has set --expose-gc in it.
|
|
116
132
|
const exposedGc = globalThis.gc;
|
|
117
133
|
delete globalThis.gc;
|
|
@@ -120,7 +136,7 @@ test('startIdleGc does nothing when the child was started without gc exposed', (
|
|
|
120
136
|
start();
|
|
121
137
|
|
|
122
138
|
expect(globalThis[STARTED]).toBeUndefined();
|
|
123
|
-
expect(
|
|
139
|
+
expect(vi.getTimerCount()).toBe(0);
|
|
124
140
|
} finally {
|
|
125
141
|
if (exposedGc !== undefined) {
|
|
126
142
|
globalThis.gc = exposedGc;
|
|
@@ -132,7 +148,7 @@ test('startIdleGc starts one interval however often the app entry is evaluated',
|
|
|
132
148
|
start();
|
|
133
149
|
start();
|
|
134
150
|
|
|
135
|
-
expect(
|
|
151
|
+
expect(vi.getTimerCount()).toBe(1);
|
|
136
152
|
tick(10_000);
|
|
137
153
|
expect(gc).toHaveBeenCalledTimes(1);
|
|
138
154
|
});
|
|
@@ -14,8 +14,8 @@
|
|
|
14
14
|
limitations under the License.
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
|
-
// Run by importAppCode.test.mjs in its own process
|
|
18
|
-
//
|
|
17
|
+
// Run by importAppCode.test.mjs in its own process, so it loads Vite and module
|
|
18
|
+
// URLs with a query as the dev server does, outside the test runner's module runtime. Loads the build's importAppCode the way the dev
|
|
19
19
|
// server's JIT page builds do, then imports an app code file, imports it again
|
|
20
20
|
// unchanged, edits it and imports it again. With `vite`, through Vite's SSR
|
|
21
21
|
// module runner (@lowdefy/build linked, as in the monorepo); with `node`,
|
package/manager/getContext.mjs
CHANGED
|
@@ -22,6 +22,7 @@ import { hideBin } from 'yargs/helpers';
|
|
|
22
22
|
import pino from 'pino';
|
|
23
23
|
import { createNodeLogger } from '@lowdefy/logger/node';
|
|
24
24
|
import checkMockUserWarning from './processes/checkMockUserWarning.mjs';
|
|
25
|
+
import checkPendingPlugins from './processes/checkPendingPlugins.mjs';
|
|
25
26
|
import initialBuild from './processes/initialBuild.mjs';
|
|
26
27
|
import installPlugins from './processes/installPlugins.mjs';
|
|
27
28
|
import lowdefyBuild from './processes/lowdefyBuild.mjs';
|
|
@@ -59,9 +60,16 @@ async function getContext() {
|
|
|
59
60
|
destination: pino.destination({ dest: 1, sync: true }),
|
|
60
61
|
}),
|
|
61
62
|
options: {
|
|
63
|
+
// For tests only: how long the Vite child may sit unused before it stops
|
|
64
|
+
// (createIdleChild). Defaults to 3 minutes.
|
|
65
|
+
childIdleMs: env.LOWDEFY_SERVER_DEV_CHILD_IDLE_MS
|
|
66
|
+
? Number(env.LOWDEFY_SERVER_DEV_CHILD_IDLE_MS)
|
|
67
|
+
: undefined,
|
|
62
68
|
internalPort: env.LOWDEFY_SERVER_DEV_INTERNAL_PORT
|
|
63
69
|
? Number(env.LOWDEFY_SERVER_DEV_INTERNAL_PORT)
|
|
64
70
|
: undefined,
|
|
71
|
+
// "true" or a network interface name: lowdefy dev --lan [interface].
|
|
72
|
+
lan: env.LOWDEFY_SERVER_DEV_LAN || undefined,
|
|
65
73
|
owner: env.LOWDEFY_DEV_OWNER === 'hub' ? 'hub' : 'terminal',
|
|
66
74
|
port: Number(argv.port ?? env.PORT ?? 3000),
|
|
67
75
|
refResolver: argv.refResolver ?? env.LOWDEFY_BUILD_REF_RESOLVER,
|
|
@@ -84,15 +92,16 @@ async function getContext() {
|
|
|
84
92
|
|
|
85
93
|
context.packageManagerCmd = process.platform === 'win32' ? 'pnpm.cmd' : 'pnpm';
|
|
86
94
|
context.checkMockUserWarning = checkMockUserWarning(context);
|
|
95
|
+
context.checkPendingPlugins = checkPendingPlugins(context);
|
|
87
96
|
context.initialBuild = initialBuild(context);
|
|
88
97
|
context.installPlugins = installPlugins(context);
|
|
89
98
|
|
|
90
99
|
// Wrap lowdefyBuild to capture and store the shallow build result
|
|
91
100
|
const buildFn = lowdefyBuild(context);
|
|
92
|
-
context.lowdefyBuild = async () => {
|
|
101
|
+
context.lowdefyBuild = async (buildOptions) => {
|
|
93
102
|
let result;
|
|
94
103
|
try {
|
|
95
|
-
result = await buildFn();
|
|
104
|
+
result = await buildFn(buildOptions);
|
|
96
105
|
} catch (error) {
|
|
97
106
|
context.lastBuildFailed = true;
|
|
98
107
|
throw error;
|
|
@@ -0,0 +1,49 @@
|
|
|
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 { pluginChecksNeedRebuild } from '@lowdefy/node-utils';
|
|
18
|
+
|
|
19
|
+
// The initial build lists the plugins it used but could not check, since they
|
|
20
|
+
// were not installed. The install after it added them, so the config builds
|
|
21
|
+
// once more when that checks something new, unless no checks run anyway.
|
|
22
|
+
// This runs after the first child answers, not before it: the checks only add
|
|
23
|
+
// warnings or errors, the first build's output serves meanwhile, and a large
|
|
24
|
+
// app's config build would otherwise double the time to a usable server on a
|
|
25
|
+
// fresh checkout. It is tracked as building, so
|
|
26
|
+
// lowdefy_build_status({ wait: true }) reads the checked build, and synced
|
|
27
|
+
// like a watcher's build. Open tabs are not reloaded: the checks change no
|
|
28
|
+
// output a tab reads, and a reload would reset the page someone is using. A
|
|
29
|
+
// failed build publishes nothing, so it is not synced either.
|
|
30
|
+
function checkPendingPlugins(context) {
|
|
31
|
+
return async () => {
|
|
32
|
+
if (
|
|
33
|
+
context.options.skipPluginChecks ||
|
|
34
|
+
!pluginChecksNeedRebuild({
|
|
35
|
+
buildDirectory: context.directories.build,
|
|
36
|
+
serverDirectory: context.directories.server,
|
|
37
|
+
})
|
|
38
|
+
) {
|
|
39
|
+
return;
|
|
40
|
+
}
|
|
41
|
+
await context.buildActivity.track(async () => {
|
|
42
|
+
context.logger.info('Checking the plugins installed at start-up.');
|
|
43
|
+
await context.lowdefyBuild();
|
|
44
|
+
await context.syncServer();
|
|
45
|
+
});
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
export default checkPendingPlugins;
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
/*
|
|
2
|
+
Copyright 2020-2026 Lowdefy, Inc
|
|
3
|
+
|
|
4
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
you may not use this file except in compliance with the License.
|
|
6
|
+
You may obtain a copy of the License at
|
|
7
|
+
|
|
8
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
|
|
10
|
+
Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
See the License for the specific language governing permissions and
|
|
14
|
+
limitations under the License.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import fs from 'fs';
|
|
18
|
+
import os from 'os';
|
|
19
|
+
import path from 'path';
|
|
20
|
+
import { vi, afterEach, beforeEach, expect, test } from 'vitest';
|
|
21
|
+
|
|
22
|
+
import checkPendingPlugins from './checkPendingPlugins.mjs';
|
|
23
|
+
|
|
24
|
+
let buildDirectory;
|
|
25
|
+
let calls;
|
|
26
|
+
|
|
27
|
+
function createContext({ lowdefyBuild, skipPluginChecks } = {}) {
|
|
28
|
+
const record = (name, impl) =>
|
|
29
|
+
vi.fn(async () => {
|
|
30
|
+
calls.push(name);
|
|
31
|
+
if (impl) await impl();
|
|
32
|
+
});
|
|
33
|
+
return {
|
|
34
|
+
buildActivity: {
|
|
35
|
+
track: vi.fn(async (task) => {
|
|
36
|
+
calls.push('busy');
|
|
37
|
+
try {
|
|
38
|
+
return await task();
|
|
39
|
+
} finally {
|
|
40
|
+
calls.push('idle');
|
|
41
|
+
}
|
|
42
|
+
}),
|
|
43
|
+
},
|
|
44
|
+
directories: { build: buildDirectory, server: buildDirectory },
|
|
45
|
+
logger: { info: vi.fn() },
|
|
46
|
+
options: { skipPluginChecks },
|
|
47
|
+
lowdefyBuild: record('lowdefyBuild', lowdefyBuild),
|
|
48
|
+
reloadClients: record('reloadClients'),
|
|
49
|
+
syncServer: record('syncServer'),
|
|
50
|
+
};
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function writePending(packages) {
|
|
54
|
+
fs.writeFileSync(
|
|
55
|
+
path.join(buildDirectory, 'plugin-checks-pending.json'),
|
|
56
|
+
JSON.stringify({ packages })
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
beforeEach(() => {
|
|
61
|
+
calls = [];
|
|
62
|
+
buildDirectory = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-check-pending-plugins-'));
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
afterEach(() => {
|
|
66
|
+
fs.rmSync(buildDirectory, { recursive: true, force: true });
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
test('checkPendingPlugins does nothing when no plugin checks are pending', async () => {
|
|
70
|
+
const context = createContext();
|
|
71
|
+
await checkPendingPlugins(context)();
|
|
72
|
+
expect(calls).toEqual([]);
|
|
73
|
+
});
|
|
74
|
+
|
|
75
|
+
test('checkPendingPlugins builds and syncs as one tracked change, without reloading tabs, when checks are pending', async () => {
|
|
76
|
+
writePending([{ name: '@acme/plugin', schemaChecked: true }]);
|
|
77
|
+
const context = createContext();
|
|
78
|
+
await checkPendingPlugins(context)();
|
|
79
|
+
// Warnings held by the initial build are given by this one, so it passes no options.
|
|
80
|
+
expect(context.lowdefyBuild.mock.calls).toEqual([[]]);
|
|
81
|
+
expect(calls).toEqual(['busy', 'lowdefyBuild', 'syncServer', 'idle']);
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
test('checkPendingPlugins rejects with the build error and does not sync when the build fails', async () => {
|
|
85
|
+
writePending([{ name: '@acme/plugin', schemaChecked: true }]);
|
|
86
|
+
const context = createContext({
|
|
87
|
+
lowdefyBuild: () => {
|
|
88
|
+
throw new Error('Build failed with 1 error(s).');
|
|
89
|
+
},
|
|
90
|
+
});
|
|
91
|
+
await expect(checkPendingPlugins(context)()).rejects.toThrow('Build failed with 1 error(s).');
|
|
92
|
+
expect(calls).toEqual(['busy', 'lowdefyBuild', 'idle']);
|
|
93
|
+
});
|
|
94
|
+
|
|
95
|
+
test('checkPendingPlugins does nothing with skipPluginChecks, even when checks are pending', async () => {
|
|
96
|
+
writePending([{ name: '@acme/plugin', schemaChecked: true }]);
|
|
97
|
+
const context = createContext({ skipPluginChecks: true });
|
|
98
|
+
await checkPendingPlugins(context)();
|
|
99
|
+
expect(calls).toEqual([]);
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
test('checkPendingPlugins does nothing when the pending plugins give nothing new to check', async () => {
|
|
103
|
+
writePending([{ name: '@acme/connection-only', schemaChecked: false }]);
|
|
104
|
+
const context = createContext();
|
|
105
|
+
await checkPendingPlugins(context)();
|
|
106
|
+
expect(calls).toEqual([]);
|
|
107
|
+
});
|
|
@@ -0,0 +1,141 @@
|
|
|
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
|
+
const IDLE_CHILD_MS = 3 * 60 * 1000;
|
|
18
|
+
|
|
19
|
+
/*
|
|
20
|
+
Stops the Vite child of a dev server nobody uses, and starts it again on the
|
|
21
|
+
next request that is use. The child holds most of an idle server's memory
|
|
22
|
+
(360 to 720 MB measured); the manager keeps its port, watchers and build
|
|
23
|
+
state, so a wake costs a child start and a fresh JIT build of each page as it
|
|
24
|
+
is first requested, not a full restart. The hub's own stop of the whole
|
|
25
|
+
server is unchanged.
|
|
26
|
+
|
|
27
|
+
Unused means: no request in flight, no build running, no tab holding a reload
|
|
28
|
+
stream open, and nothing counted as activity for idleMs. These are the
|
|
29
|
+
manager's own activity counts (createRequestActivity), the record the hub
|
|
30
|
+
reads too.
|
|
31
|
+
|
|
32
|
+
The stop goes through shutdownServer, as any stop does, so a later start
|
|
33
|
+
waits for the old child to exit. Stop and wake both run in syncServer's
|
|
34
|
+
queue, so neither interleaves with a restart or a plugin install. While the
|
|
35
|
+
child is stopped, the proxy answers requests that are not use at once
|
|
36
|
+
(startProxy), and syncServer marks a restart pending instead of starting it.
|
|
37
|
+
|
|
38
|
+
`state` in the instance record stays `ready`: the hub treats any other state
|
|
39
|
+
as busy and never stops the server, and waits on `ready`. The record's
|
|
40
|
+
`child` field says `stopped` or `running`; older hubs and shims ignore it.
|
|
41
|
+
*/
|
|
42
|
+
function createIdleChild(context, { idleMs = IDLE_CHILD_MS, checkMs, now = Date.now } = {}) {
|
|
43
|
+
let stopped = false;
|
|
44
|
+
let restartPending = false;
|
|
45
|
+
let waking = null;
|
|
46
|
+
let timer = null;
|
|
47
|
+
|
|
48
|
+
function isUnused() {
|
|
49
|
+
const { activeRequests, lastActivityAt, openTabs } = context.requestActivity.snapshot();
|
|
50
|
+
return (
|
|
51
|
+
!context.buildActivity.isBusy() &&
|
|
52
|
+
activeRequests === 0 &&
|
|
53
|
+
openTabs === 0 &&
|
|
54
|
+
now() - lastActivityAt >= idleMs
|
|
55
|
+
);
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function stop() {
|
|
59
|
+
return context.syncServer.run(async () => {
|
|
60
|
+
// Checked again in the queue: a request or a build may have come since.
|
|
61
|
+
if (stopped || waking !== null || !context.devServer || !isUnused()) {
|
|
62
|
+
return false;
|
|
63
|
+
}
|
|
64
|
+
stopped = true;
|
|
65
|
+
context.instance.update({ child: 'stopped' });
|
|
66
|
+
context.shutdownServer();
|
|
67
|
+
context.logger.info(
|
|
68
|
+
{ spin: 'succeed' },
|
|
69
|
+
`Stopped the web server after ${Math.round(
|
|
70
|
+
idleMs / 1000
|
|
71
|
+
)} s unused. The next request starts it again.`
|
|
72
|
+
);
|
|
73
|
+
return true;
|
|
74
|
+
});
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
// Only a request that is use calls this (startProxy). Two at once start one child.
|
|
78
|
+
function wake() {
|
|
79
|
+
if (!stopped) {
|
|
80
|
+
return waking ?? Promise.resolve();
|
|
81
|
+
}
|
|
82
|
+
stopped = false;
|
|
83
|
+
context.instance.update({ child: 'running' });
|
|
84
|
+
waking = context.syncServer
|
|
85
|
+
.run(async () => {
|
|
86
|
+
// A sync queued ahead of the wake (the install path) already started one, with the
|
|
87
|
+
// changes built while stopped.
|
|
88
|
+
if (context.devServer) {
|
|
89
|
+
restartPending = false;
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
context.logger.info(
|
|
93
|
+
restartPending
|
|
94
|
+
? 'Starting the web server again, with the changes built while it was stopped.'
|
|
95
|
+
: 'Starting the web server again.'
|
|
96
|
+
);
|
|
97
|
+
restartPending = false;
|
|
98
|
+
// The normal start path: waits for the stopped child to exit, records
|
|
99
|
+
// the server artifacts and waits for the new child to answer.
|
|
100
|
+
await context.restartServer();
|
|
101
|
+
})
|
|
102
|
+
.finally(() => {
|
|
103
|
+
waking = null;
|
|
104
|
+
});
|
|
105
|
+
return waking;
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
function markRestartPending() {
|
|
109
|
+
restartPending = true;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
function start() {
|
|
113
|
+
context.instance.update({ child: 'running' });
|
|
114
|
+
const interval = checkMs ?? Math.min(10000, Math.max(250, Math.floor(idleMs / 4)));
|
|
115
|
+
timer = setInterval(() => {
|
|
116
|
+
if (!stopped && waking === null && isUnused()) {
|
|
117
|
+
stop().catch((error) => context.logger.error(error));
|
|
118
|
+
}
|
|
119
|
+
}, interval);
|
|
120
|
+
// The check must not keep the manager alive on shutdown.
|
|
121
|
+
timer.unref?.();
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
function close() {
|
|
125
|
+
clearInterval(timer);
|
|
126
|
+
timer = null;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
return {
|
|
130
|
+
close,
|
|
131
|
+
isRestartPending: () => restartPending,
|
|
132
|
+
isStopped: () => stopped,
|
|
133
|
+
markRestartPending,
|
|
134
|
+
start,
|
|
135
|
+
stop,
|
|
136
|
+
wake,
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
export { IDLE_CHILD_MS };
|
|
141
|
+
export default createIdleChild;
|
|
@@ -0,0 +1,209 @@
|
|
|
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 { vi, afterEach, expect, test } from 'vitest';
|
|
18
|
+
|
|
19
|
+
import createIdleChild from './createIdleChild.mjs';
|
|
20
|
+
import syncServer from './syncServer.mjs';
|
|
21
|
+
|
|
22
|
+
const IDLE_MS = 180000;
|
|
23
|
+
|
|
24
|
+
let idleChild;
|
|
25
|
+
|
|
26
|
+
afterEach(() => {
|
|
27
|
+
idleChild?.close();
|
|
28
|
+
idleChild = undefined;
|
|
29
|
+
vi.useRealTimers();
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
function createContext({ snapshot = {}, busy = false } = {}) {
|
|
33
|
+
let clock = 1000000;
|
|
34
|
+
const context = {
|
|
35
|
+
clock: {
|
|
36
|
+
now: () => clock,
|
|
37
|
+
advance: (ms) => {
|
|
38
|
+
clock += ms;
|
|
39
|
+
},
|
|
40
|
+
},
|
|
41
|
+
activity: { activeRequests: 0, lastActivityAt: 1000000, openTabs: 0, ...snapshot },
|
|
42
|
+
buildActivity: { isBusy: vi.fn(() => busy) },
|
|
43
|
+
devServer: { pid: 1 },
|
|
44
|
+
events: [],
|
|
45
|
+
instance: { update: vi.fn() },
|
|
46
|
+
logger: { info: vi.fn(), error: vi.fn() },
|
|
47
|
+
serverArtifacts: { check: vi.fn(() => ({ install: false, restart: true })), record: vi.fn() },
|
|
48
|
+
};
|
|
49
|
+
context.requestActivity = { snapshot: () => context.activity };
|
|
50
|
+
context.shutdownServer = vi.fn(() => {
|
|
51
|
+
context.events.push('shutdown');
|
|
52
|
+
context.devServer = null;
|
|
53
|
+
});
|
|
54
|
+
context.restartServer = vi.fn(async () => {
|
|
55
|
+
context.events.push('restart');
|
|
56
|
+
context.devServer = { pid: 2 };
|
|
57
|
+
});
|
|
58
|
+
context.syncServer = syncServer(context);
|
|
59
|
+
context.syncServer.startFirst(async () => {});
|
|
60
|
+
return context;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
function create(context) {
|
|
64
|
+
idleChild = createIdleChild(context, { idleMs: IDLE_MS, now: context.clock.now });
|
|
65
|
+
context.idleChild = idleChild;
|
|
66
|
+
return idleChild;
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
test('createIdleChild stops a child unused for the idle limit through shutdownServer', async () => {
|
|
70
|
+
const context = createContext();
|
|
71
|
+
create(context);
|
|
72
|
+
context.clock.advance(IDLE_MS);
|
|
73
|
+
|
|
74
|
+
expect(await idleChild.stop()).toBe(true);
|
|
75
|
+
expect(context.shutdownServer).toHaveBeenCalledTimes(1);
|
|
76
|
+
expect(idleChild.isStopped()).toBe(true);
|
|
77
|
+
expect(context.instance.update).toHaveBeenLastCalledWith({ child: 'stopped' });
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
test.each([
|
|
81
|
+
['used within the idle limit', { lastActivityAt: 1000000 + 60000 }, false],
|
|
82
|
+
['with a request in flight', { activeRequests: 1 }, false],
|
|
83
|
+
['with a tab open', { openTabs: 1 }, false],
|
|
84
|
+
['while a build runs', {}, true],
|
|
85
|
+
])('createIdleChild keeps a child %s', async (_, snapshot, busy) => {
|
|
86
|
+
const context = createContext({ snapshot, busy });
|
|
87
|
+
create(context);
|
|
88
|
+
context.clock.advance(IDLE_MS);
|
|
89
|
+
|
|
90
|
+
expect(await idleChild.stop()).toBe(false);
|
|
91
|
+
expect(context.shutdownServer).not.toHaveBeenCalled();
|
|
92
|
+
expect(idleChild.isStopped()).toBe(false);
|
|
93
|
+
});
|
|
94
|
+
|
|
95
|
+
test('createIdleChild checks on a timer once started', async () => {
|
|
96
|
+
vi.useFakeTimers();
|
|
97
|
+
const context = createContext();
|
|
98
|
+
create(context);
|
|
99
|
+
idleChild.start();
|
|
100
|
+
expect(context.instance.update).toHaveBeenCalledWith({ child: 'running' });
|
|
101
|
+
|
|
102
|
+
vi.advanceTimersByTime(10000);
|
|
103
|
+
await vi.runOnlyPendingTimersAsync();
|
|
104
|
+
expect(context.shutdownServer).not.toHaveBeenCalled();
|
|
105
|
+
|
|
106
|
+
context.clock.advance(IDLE_MS);
|
|
107
|
+
await vi.advanceTimersByTimeAsync(10000);
|
|
108
|
+
expect(context.shutdownServer).toHaveBeenCalledTimes(1);
|
|
109
|
+
expect(idleChild.isStopped()).toBe(true);
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
test('createIdleChild wakes a stopped child once for two requests at once', async () => {
|
|
113
|
+
const context = createContext();
|
|
114
|
+
create(context);
|
|
115
|
+
context.clock.advance(IDLE_MS);
|
|
116
|
+
await idleChild.stop();
|
|
117
|
+
|
|
118
|
+
await Promise.all([idleChild.wake(), idleChild.wake()]);
|
|
119
|
+
|
|
120
|
+
expect(context.restartServer).toHaveBeenCalledTimes(1);
|
|
121
|
+
expect(idleChild.isStopped()).toBe(false);
|
|
122
|
+
expect(context.instance.update).toHaveBeenLastCalledWith({ child: 'running' });
|
|
123
|
+
});
|
|
124
|
+
|
|
125
|
+
test('createIdleChild marks a restart built while stopped pending and starts the child once on wake', async () => {
|
|
126
|
+
const context = createContext();
|
|
127
|
+
create(context);
|
|
128
|
+
context.clock.advance(IDLE_MS);
|
|
129
|
+
await idleChild.stop();
|
|
130
|
+
|
|
131
|
+
await context.syncServer();
|
|
132
|
+
await context.syncServer({ restart: true });
|
|
133
|
+
expect(context.restartServer).not.toHaveBeenCalled();
|
|
134
|
+
expect(idleChild.isRestartPending()).toBe(true);
|
|
135
|
+
|
|
136
|
+
await idleChild.wake();
|
|
137
|
+
expect(context.restartServer).toHaveBeenCalledTimes(1);
|
|
138
|
+
expect(idleChild.isRestartPending()).toBe(false);
|
|
139
|
+
expect(context.events).toEqual(['shutdown', 'restart']);
|
|
140
|
+
});
|
|
141
|
+
|
|
142
|
+
test('createIdleChild does not start a second child when a queued sync started one first', async () => {
|
|
143
|
+
const context = createContext();
|
|
144
|
+
create(context);
|
|
145
|
+
context.clock.advance(IDLE_MS);
|
|
146
|
+
await idleChild.stop();
|
|
147
|
+
|
|
148
|
+
// A sync already in the queue when the wake comes sees the child running and restarts it.
|
|
149
|
+
let finishBuild;
|
|
150
|
+
const synced = context.syncServer.run(
|
|
151
|
+
() =>
|
|
152
|
+
new Promise((resolve) => {
|
|
153
|
+
finishBuild = resolve;
|
|
154
|
+
})
|
|
155
|
+
);
|
|
156
|
+
const woken = idleChild.wake();
|
|
157
|
+
context.devServer = { pid: 3 };
|
|
158
|
+
await new Promise((resolve) => setTimeout(resolve, 10));
|
|
159
|
+
finishBuild();
|
|
160
|
+
await Promise.all([synced, woken]);
|
|
161
|
+
|
|
162
|
+
expect(context.restartServer).not.toHaveBeenCalled();
|
|
163
|
+
});
|
|
164
|
+
|
|
165
|
+
test('createIdleChild clears a pending restart when a queued sync started the child first', async () => {
|
|
166
|
+
const context = createContext();
|
|
167
|
+
create(context);
|
|
168
|
+
context.clock.advance(IDLE_MS);
|
|
169
|
+
await idleChild.stop();
|
|
170
|
+
await context.syncServer();
|
|
171
|
+
expect(idleChild.isRestartPending()).toBe(true);
|
|
172
|
+
|
|
173
|
+
let finishInstall;
|
|
174
|
+
const synced = context.syncServer.run(
|
|
175
|
+
() =>
|
|
176
|
+
new Promise((resolve) => {
|
|
177
|
+
finishInstall = resolve;
|
|
178
|
+
})
|
|
179
|
+
);
|
|
180
|
+
const woken = idleChild.wake();
|
|
181
|
+
context.devServer = { pid: 3 };
|
|
182
|
+
await new Promise((resolve) => setTimeout(resolve, 10));
|
|
183
|
+
finishInstall();
|
|
184
|
+
await Promise.all([synced, woken]);
|
|
185
|
+
|
|
186
|
+
expect(context.restartServer).not.toHaveBeenCalled();
|
|
187
|
+
expect(idleChild.isRestartPending()).toBe(false);
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
test('createIdleChild does not stop a child that was used while the stop waited in the queue', async () => {
|
|
191
|
+
const context = createContext();
|
|
192
|
+
create(context);
|
|
193
|
+
context.clock.advance(IDLE_MS);
|
|
194
|
+
let finishSync;
|
|
195
|
+
const synced = context.syncServer.run(
|
|
196
|
+
() =>
|
|
197
|
+
new Promise((resolve) => {
|
|
198
|
+
finishSync = resolve;
|
|
199
|
+
})
|
|
200
|
+
);
|
|
201
|
+
const stopping = idleChild.stop();
|
|
202
|
+
context.activity.activeRequests = 1;
|
|
203
|
+
await new Promise((resolve) => setTimeout(resolve, 10));
|
|
204
|
+
finishSync();
|
|
205
|
+
await synced;
|
|
206
|
+
|
|
207
|
+
expect(await stopping).toBe(false);
|
|
208
|
+
expect(context.shutdownServer).not.toHaveBeenCalled();
|
|
209
|
+
});
|
|
@@ -15,26 +15,15 @@
|
|
|
15
15
|
limitations under the License.
|
|
16
16
|
*/
|
|
17
17
|
|
|
18
|
-
import { pluginChecksNeedRebuild } from '@lowdefy/node-utils';
|
|
19
|
-
|
|
20
18
|
function initialBuild(context) {
|
|
21
19
|
return async () => {
|
|
22
20
|
context.readDotEnv();
|
|
23
|
-
|
|
21
|
+
// This build holds its warnings for plugins it could not check: the install
|
|
22
|
+
// below adds them, and checkPendingPlugins builds again once the server
|
|
23
|
+
// answers, warning for any still missing.
|
|
24
|
+
await context.lowdefyBuild({ pluginInstallFollows: true });
|
|
24
25
|
await context.checkMockUserWarning();
|
|
25
26
|
await context.installPlugins();
|
|
26
|
-
// The build lists the plugins it used but could not check, since they were
|
|
27
|
-
// not installed. The install above added them, so build once more when that
|
|
28
|
-
// checks something new, unless no checks run this time anyway.
|
|
29
|
-
if (
|
|
30
|
-
!context.options.skipPluginChecks &&
|
|
31
|
-
pluginChecksNeedRebuild({
|
|
32
|
-
buildDirectory: context.directories.build,
|
|
33
|
-
serverDirectory: context.directories.server,
|
|
34
|
-
})
|
|
35
|
-
) {
|
|
36
|
-
await context.lowdefyBuild();
|
|
37
|
-
}
|
|
38
27
|
};
|
|
39
28
|
}
|
|
40
29
|
|