@lowdefy/server-dev 7.1.0 → 7.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/client/Inspector.jsx +24 -75
- package/client/Page.jsx +8 -0
- package/client/Routing.jsx +0 -2
- package/client/clientBuildImports.test.mjs +5 -3
- package/client/devStreamConnections.test.mjs +1 -0
- package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
- package/client/openInEditor/OpenInEditorListener.jsx +36 -29
- package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
- package/client/{feedback → openInEditor}/elementInspect.js +9 -44
- package/client/openInEditor/findBlockLocation.js +2 -2
- package/client/openInEditor/openInEditorStyles.js +56 -0
- package/client/recorder/createPairingBuffer.test.mjs +27 -9
- package/client/recorder/createRecorder.js +11 -7
- package/client/recorder/createRecorder.test.mjs +9 -9
- package/client/recorder/isPasswordElement.js +41 -0
- package/client/recorder/keyChord.test.mjs +1 -0
- package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
- package/lib/client/auth/AuthConfigured.jsx +75 -48
- package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
- package/lib/client/auth/authTemplateSync.test.mjs +1 -0
- package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
- package/lib/client/auth/sessionCaller.js +56 -0
- package/lib/client/auth/sessionCaller.test.mjs +78 -0
- package/lib/client/getPagePath.test.mjs +1 -0
- package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
- package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
- package/lib/client/utils/usePageConfig.test.mjs +15 -15
- package/lib/configTree/buildConfigTree.test.mjs +6 -8
- package/lib/configTree/collectConfigText.test.mjs +1 -0
- package/lib/configTree/runConfigTreeBuild.mjs +2 -1
- package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
- package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
- package/lib/docs/addNestedEndpoints.test.mjs +1 -0
- package/lib/docs/checkAgentFiles.test.mjs +1 -0
- package/lib/docs/checkStepReferences.test.mjs +3 -3
- package/lib/docs/clientErrorStore.test.mjs +4 -4
- package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
- package/lib/docs/createDocsMcpServer.js +195 -138
- package/lib/docs/createDocsMcpServer.test.mjs +331 -25
- package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
- package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
- package/lib/docs/createJourneyActors.test.mjs +4 -4
- package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +6 -6
- package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
- package/lib/docs/dataSets/getDataStore.js +11 -3
- package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
- package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
- package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
- package/lib/docs/dataSets/openDataSession.js +4 -2
- package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +25 -7
- package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
- package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
- package/lib/docs/dataSets/readDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
- package/lib/docs/devEventBus.js +7 -2
- package/lib/docs/devEventBus.test.mjs +12 -10
- package/lib/docs/devToolDefinitions.js +101 -143
- package/lib/docs/device/buildDeviceCommand.js +103 -0
- package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
- package/lib/docs/device/captureDevice.js +85 -0
- package/lib/docs/device/checkShownPage.js +56 -0
- package/lib/docs/device/createFakePhoneTab.mjs +77 -0
- package/lib/docs/device/deviceAction.js +74 -0
- package/lib/docs/device/deviceTools.test.mjs +604 -0
- package/lib/docs/device/findDeviceTab.js +50 -0
- package/lib/docs/device/findDeviceTarget.js +73 -0
- package/lib/docs/device/injectDevice.js +160 -0
- package/lib/docs/device/listDevices.js +100 -0
- package/lib/docs/device/listDevices.test.mjs +105 -0
- package/lib/docs/device/runDeviceJourney.js +68 -0
- package/lib/docs/device/runDeviceSteps.js +164 -0
- package/lib/docs/device/screenshotDevice.js +68 -0
- package/lib/docs/device/sendDeviceStep.js +52 -0
- package/lib/docs/device/startDevice.js +150 -0
- package/lib/docs/docs.test.mjs +44 -28
- package/lib/docs/docsIndex.test.mjs +1 -0
- package/lib/docs/findConfig.js +3 -4
- package/lib/docs/findPageBlock.js +35 -0
- package/lib/docs/findPageBlock.test.mjs +45 -0
- package/lib/docs/fitResponse.js +18 -17
- package/lib/docs/fitResponse.test.mjs +18 -0
- package/lib/docs/getBrowser.js +3 -3
- package/lib/docs/getBrowser.test.mjs +32 -16
- package/lib/docs/getBuildId.test.mjs +1 -0
- package/lib/docs/getBuildStatus.test.mjs +11 -11
- package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
- package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
- package/lib/docs/getHazards.js +4 -1
- package/lib/docs/getHazards.test.mjs +9 -7
- package/lib/docs/getOverview.js +20 -42
- package/lib/docs/getOverviewBasePath.test.mjs +1 -0
- package/lib/docs/getStaleStatus.test.mjs +1 -0
- package/lib/docs/inspectState.js +78 -3
- package/lib/docs/inspectState.test.mjs +61 -9
- package/lib/docs/inspectStateFromTab.js +38 -6
- package/lib/docs/inspectStateFromTab.test.mjs +79 -0
- package/lib/docs/inspectStateHeadless.js +98 -34
- package/lib/docs/inspectStateHeadless.test.mjs +17 -5
- package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
- package/lib/docs/installHeadlessShell.js +5 -2
- package/lib/docs/installHeadlessShell.test.mjs +8 -5
- package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
- package/lib/docs/isDeepEqual.js +37 -0
- package/lib/docs/isHeadlessShellIncomplete.js +6 -5
- package/lib/docs/isHeadlessShellIncomplete.test.mjs +4 -1
- package/lib/docs/isPageReady.test.mjs +1 -0
- package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
- package/lib/docs/journeyRunRecording.test.mjs +1 -0
- package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
- package/lib/docs/launchBrowser.test.mjs +8 -8
- package/lib/docs/listTypes.js +58 -8
- package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
- package/lib/docs/matchJourneyRoute.test.mjs +1 -0
- package/lib/docs/observe/createJourneyAppErrors.test.mjs +18 -4
- package/lib/docs/observe/evaluateInvariants.js +23 -0
- package/lib/docs/observe/evaluateInvariants.test.mjs +27 -0
- package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
- package/lib/docs/observe/toAppErrorFailure.js +7 -4
- package/lib/docs/observe/watchJourneyContext.js +1 -0
- package/lib/docs/observe/withAppErrors.test.mjs +22 -0
- package/lib/docs/openJourneyEmail.test.mjs +6 -6
- package/lib/docs/pageBuildStatus.test.mjs +6 -6
- package/lib/docs/pollTab.js +100 -0
- package/lib/docs/pollTab.test.mjs +64 -0
- package/lib/docs/rails/authEngineActions.test.mjs +1 -0
- package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
- package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
- package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
- package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
- package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
- package/lib/docs/readJourneySession.js +1 -1
- package/lib/docs/reportDevToolFault.js +29 -0
- package/lib/docs/reportDevToolFault.test.mjs +34 -0
- package/lib/docs/requestRestart.test.mjs +1 -0
- package/lib/docs/resolvePageInstance.test.mjs +1 -0
- package/lib/docs/resolveSource.js +2 -2
- package/lib/docs/resolveSource.test.mjs +6 -6
- package/lib/docs/reviewPageBuilds.test.mjs +2 -2
- package/lib/docs/runCheck.test.mjs +3 -3
- package/lib/docs/runCheckChild.js +2 -1
- package/lib/docs/runEndpoint.js +23 -10
- package/lib/docs/runEndpoint.test.mjs +42 -37
- package/lib/docs/runErrorBuffers.test.mjs +1 -0
- package/lib/docs/runJourney.js +21 -1
- package/lib/docs/runJourney.test.mjs +119 -99
- package/lib/docs/runJourneyDataSet.test.mjs +25 -25
- package/lib/docs/runJourneySteps.js +8 -29
- package/lib/docs/runRequest.js +6 -6
- package/lib/docs/runRequest.test.mjs +22 -22
- package/lib/docs/screenshotPage.js +6 -7
- package/lib/docs/screenshotPage.test.mjs +46 -46
- package/lib/docs/screenshotPageClip.test.mjs +10 -10
- package/lib/docs/searchDocs.test.mjs +1 -0
- package/lib/docs/searchIcons.test.mjs +5 -5
- package/lib/docs/selectFinalState.test.mjs +1 -0
- package/lib/docs/serverErrorStore.test.mjs +4 -4
- package/lib/docs/setupTestFixtures.mjs +25 -0
- package/lib/docs/splitSearchTerms.test.mjs +1 -0
- package/lib/docs/tabAvailable.js +1 -1
- package/lib/docs/tabChannel.js +90 -14
- package/lib/docs/tabChannel.test.mjs +40 -15
- package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
- package/lib/docs/validateStateSelection.test.mjs +1 -0
- package/lib/docs/validateViewport.test.mjs +1 -0
- package/lib/docs/waitForBuild.test.mjs +1 -0
- package/lib/docs/withBrowserSlot.test.mjs +5 -5
- package/lib/server/applyDataSetRedirect.test.mjs +2 -2
- package/lib/server/applyDataSetRedirectTenantReach.test.mjs +1 -0
- package/lib/server/applyDataSetRedirectWalled.test.mjs +1 -0
- package/lib/server/auth/getHeadlessUser.js +6 -0
- package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
- package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
- package/lib/server/contextMapBudget.test.mjs +3 -3
- package/lib/server/continueJitKeys.test.mjs +1 -0
- package/lib/server/createLowdefyContext.js +5 -1
- package/lib/server/createLowdefyContext.test.mjs +32 -32
- package/lib/server/getClientAddress.test.mjs +2 -2
- package/lib/server/getPageJitEnrichment.test.mjs +1 -0
- package/lib/server/importAppCode.test.mjs +2 -2
- package/lib/server/jitPageBuilder.js +27 -3
- package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
- package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
- package/lib/server/jitPageBuilder.test.mjs +4 -4
- package/lib/server/journeyCookies.test.mjs +1 -0
- package/lib/server/loadDynamicJsMap.js +10 -1
- package/lib/server/log/createHandleError.js +10 -5
- package/lib/server/log/createHandleError.test.mjs +19 -8
- package/lib/server/log/createLogger.test.mjs +2 -2
- package/lib/server/mutantDataSetWrappers.test.mjs +1 -0
- package/lib/server/mutants/listMutants.test.mjs +1 -0
- package/lib/server/mutants/mutantRuns.test.mjs +1 -0
- package/lib/server/mutants/operators.test.mjs +1 -0
- package/lib/server/pageBuildRecords.test.mjs +1 -0
- package/lib/server/pageCache.test.mjs +1 -0
- package/lib/server/pageRebuilds.test.mjs +3 -3
- package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
- package/lib/server/pruneJitMaps.test.mjs +1 -0
- package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
- package/lib/server/readInstanceRecord.test.mjs +24 -8
- package/lib/server/readMergedMaps.test.mjs +1 -0
- package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
- package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
- package/lib/server/recording/servedBuilds.test.mjs +1 -0
- package/lib/server/sinkExternalConnections.test.mjs +6 -6
- package/lib/server/skipStaleMapWrites.test.mjs +12 -12
- package/lib/server/startIdleGc.test.mjs +25 -9
- package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
- package/lib/vite/createDevServerExclude.test.mjs +1 -0
- package/lib/vite/keepIdleConnectionsOpen.js +36 -0
- package/lib/vite/keepIdleConnectionsOpen.test.mjs +104 -0
- package/manager/getContext.mjs +9 -0
- package/manager/processes/checkPendingPlugins.mjs +49 -0
- package/manager/processes/checkPendingPlugins.test.mjs +107 -0
- package/manager/processes/createIdleChild.mjs +141 -0
- package/manager/processes/createIdleChild.test.mjs +209 -0
- package/manager/processes/initialBuild.mjs +2 -15
- package/manager/processes/initialBuild.test.mjs +8 -40
- package/manager/processes/lowdefyBuild.mjs +7 -4
- package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +13 -13
- package/manager/processes/lowdefyBuild.test.mjs +17 -15
- package/manager/processes/restartServer.test.mjs +63 -15
- package/manager/processes/shutdownServer.test.mjs +3 -3
- package/manager/processes/startFirstServer.test.mjs +23 -22
- package/manager/processes/startMailSink.mjs +11 -3
- package/manager/processes/startMailSink.test.mjs +28 -2
- package/manager/processes/startProxy.mjs +167 -29
- package/manager/processes/startProxy.pairing.test.mjs +204 -0
- package/manager/processes/startProxy.test.mjs +130 -5
- package/manager/processes/startServer.mjs +5 -7
- package/manager/processes/startServer.test.mjs +10 -9
- package/manager/processes/syncServer.mjs +31 -4
- package/manager/processes/syncServer.test.mjs +71 -6
- package/manager/processes/waitForDevServer.test.mjs +21 -6
- package/manager/run.mjs +32 -8
- package/manager/utils/BatchChanges.mjs +1 -1
- package/manager/utils/BatchChanges.test.mjs +4 -4
- package/manager/utils/acquireDevInstance.test.mjs +1 -0
- package/manager/utils/checkPairing.mjs +45 -0
- package/manager/utils/checkPairing.test.mjs +53 -0
- package/manager/utils/createBuildActivity.mjs +5 -1
- package/manager/utils/createBuildActivity.test.mjs +2 -2
- package/manager/utils/createChangeSignal.test.mjs +5 -5
- package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
- package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
- package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
- package/manager/utils/createDotPathIgnore.test.mjs +1 -0
- package/manager/utils/createGlobIgnore.mjs +45 -0
- package/manager/utils/createGlobIgnore.test.mjs +58 -0
- package/manager/utils/createGlobWatchPaths.mjs +75 -0
- package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
- package/manager/utils/createIdleGc.test.mjs +31 -15
- package/{src/routes/docs/content.js → manager/utils/createLanPairing.mjs} +14 -13
- package/manager/utils/createLanPairing.test.mjs +46 -0
- package/manager/utils/createRequestActivity.mjs +30 -3
- package/manager/utils/createRequestActivity.test.mjs +76 -22
- package/manager/utils/createServerArtifactTracker.mjs +1 -0
- package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
- package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
- package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
- package/manager/utils/findSignInCode.test.mjs +33 -0
- package/manager/utils/formatLanPairing.mjs +32 -0
- package/manager/utils/formatLanPairing.test.mjs +40 -0
- package/manager/utils/getLanAddress.mjs +83 -0
- package/manager/utils/getLanAddress.test.mjs +70 -0
- package/manager/utils/importFresh.test.mjs +1 -0
- package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
- package/manager/utils/pluginTypeCache.mjs +100 -0
- package/manager/utils/pluginTypeCache.test.mjs +141 -0
- package/manager/utils/pruneRecordings.test.mjs +1 -0
- package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
- package/manager/utils/publishBuildDirectory.test.mjs +6 -7
- package/manager/utils/readBasePath.test.mjs +1 -0
- package/manager/utils/readManagerVersion.test.mjs +1 -0
- package/manager/utils/readPluginDefinitions.mjs +6 -6
- package/manager/utils/renderTerminalQr.mjs +54 -0
- package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
- package/manager/utils/setupWatcher.mjs +19 -4
- package/manager/utils/startRecordingPruner.test.mjs +24 -8
- package/manager/utils/waitForChildExit.test.mjs +2 -2
- package/manager/utils/writeBuildStatus.test.mjs +1 -0
- package/manager/watchers/envWatcher.mjs +3 -0
- package/manager/watchers/envWatcher.test.mjs +19 -7
- package/manager/watchers/listServerPluginFiles.mjs +188 -0
- package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
- package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
- package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
- package/manager/watchers/pluginSourceWatcher.mjs +45 -17
- package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
- package/manager/watchers/resolveFile.mjs +46 -0
- package/manager/watchers/resolveFile.test.mjs +67 -0
- package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
- package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
- package/manager/watchers/restartRequestWatcher.mjs +7 -4
- package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
- package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
- package/package.json +54 -53
- package/package.original.json +54 -53
- package/src/app.js +83 -85
- package/src/html/renderDevPage.test.mjs +1 -0
- package/src/lib/getPathSegments.js +16 -1
- package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
- package/src/lib/isTabAnswer.js +32 -0
- package/src/lib/isTabChannelCaller.js +35 -0
- package/src/middleware/apiContext.js +4 -2
- package/src/middleware/createSameOriginGuard.test.mjs +1 -0
- package/src/middleware/errorHandler.js +33 -45
- package/src/middleware/errorHandler.test.mjs +10 -10
- package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
- package/src/middleware/localDevToolsOnly.js +13 -1
- package/src/middleware/localDevToolsOnly.test.mjs +36 -2
- package/src/middleware/noStore.test.mjs +1 -0
- package/src/middleware/requestTimeout.js +7 -1
- package/src/middleware/staleFlag.test.mjs +1 -0
- package/src/middleware/stampCaller.test.mjs +1 -0
- package/src/routes/agentBearer.test.mjs +183 -0
- package/src/routes/auth.test.mjs +10 -10
- package/src/routes/clientError.js +21 -4
- package/src/routes/clientError.test.mjs +127 -0
- package/src/routes/devInspect.js +6 -51
- package/src/routes/devInspect.test.mjs +128 -3
- package/src/routes/devRecording.js +6 -17
- package/src/routes/devRecording.test.mjs +54 -3
- package/src/routes/docs/buildStatus.test.mjs +6 -6
- package/src/routes/docs/events.test.mjs +4 -4
- package/src/routes/docs/find.js +3 -3
- package/src/routes/docs/journey.test.mjs +8 -8
- package/src/routes/docs/journeyRefusals.test.mjs +9 -9
- package/src/routes/docs/loadDocsRoutes.js +70 -0
- package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
- package/src/routes/docs/mcp.test.mjs +5 -5
- package/src/routes/docs/mutants.js +7 -0
- package/src/routes/docs/mutants.test.mjs +20 -6
- package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
- package/src/routes/docs/parseUserParam.test.mjs +1 -0
- package/src/routes/docs/restart.test.mjs +1 -0
- package/src/routes/endpoints.js +24 -0
- package/src/routes/endpointsLink.test.mjs +111 -0
- package/src/routes/endpointsTextAnswer.test.mjs +8 -8
- package/src/routes/jitPage.js +13 -1
- package/src/routes/jitPage.test.mjs +36 -11
- package/src/routes/mcp.js +6 -0
- package/src/routes/mcp.test.mjs +23 -8
- package/src/routes/mcpMemberToken.test.mjs +8 -8
- package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
- package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
- package/src/routes/mobileRoutes.test.mjs +223 -0
- package/src/routes/mobileSignIn.js +58 -0
- package/src/routes/mobileSignIn.test.mjs +59 -0
- package/src/routes/mobileSignInCallback.js +34 -0
- package/src/routes/mobileSignInCallback.test.mjs +51 -0
- package/src/routes/mountDevPageRoutes.js +10 -2
- package/src/routes/mountDevPageRoutes.test.mjs +25 -1
- package/src/routes/mountMobileWellKnown.js +35 -0
- package/src/routes/mountMobileWellKnown.test.mjs +79 -0
- package/src/routes/mountOauthDiscovery.test.mjs +5 -5
- package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
- package/src/routes/reload.js +101 -20
- package/src/routes/reload.test.mjs +153 -0
- package/src/routes/request.js +1 -22
- package/src/routes/request.test.mjs +7 -24
- package/src/routes/requestBody.test.mjs +14 -27
- package/src/routes/websocket.test.mjs +2 -2
- package/src/routes/wellKnownFallback.test.mjs +2 -2
- package/src/websocket/devWebSocket.test.mjs +12 -12
- package/vite.config.js +15 -1
- package/client/feedback/FeedbackMount.jsx +0 -83
- package/client/feedback/FeedbackOverlay.jsx +0 -904
- package/client/feedback/captureTabScreenshot.js +0 -84
- package/client/feedback/copyToClipboard.js +0 -45
- package/client/feedback/drawAnnotationsSvg.js +0 -119
- package/client/feedback/feedbackStyles.js +0 -304
- package/client/feedback/pinResponsiveImages.js +0 -59
- package/client/feedback/sendFeedback.js +0 -39
- package/client/feedback/useFeedbackToggle.js +0 -70
- package/client/recorder/buildEngineRecord.js +0 -37
- package/client/recorder/buildInteractionRecord.js +0 -64
- package/client/recorder/buildTraceEvent.js +0 -57
- package/client/recorder/buildTraceEvent.test.mjs +0 -81
- package/client/recorder/chunkRecords.js +0 -69
- package/client/recorder/chunkRecords.test.mjs +0 -59
- package/client/recorder/collectEventEndpoints.js +0 -40
- package/client/recorder/collectEventRequests.js +0 -39
- package/client/recorder/createPairingBuffer.js +0 -187
- package/client/recorder/createPasswordRedactor.js +0 -84
- package/client/recorder/createRecordBatcher.js +0 -54
- package/client/recorder/createRecordBatcher.test.mjs +0 -76
- package/client/recorder/createRecordingSession.js +0 -61
- package/client/recorder/createRecordingSession.test.mjs +0 -72
- package/client/recorder/diffStateWrites.js +0 -77
- package/client/recorder/diffStateWrites.test.mjs +0 -66
- package/client/recorder/isEventCall.js +0 -30
- package/client/recorder/jsonType.js +0 -39
- package/client/recorder/sendRecords.js +0 -40
- package/lib/docs/captureAnnotatedScreenshot.js +0 -99
- package/lib/docs/checkpointPaths.js +0 -91
- package/lib/docs/checkpointStore.js +0 -243
- package/lib/docs/checkpointToMocks.js +0 -65
- package/lib/docs/configCheckpoints.test.mjs +0 -156
- package/lib/docs/createConfigCheckpoint.js +0 -92
- package/lib/docs/devMockRegistry.js +0 -68
- package/lib/docs/enrichFeedback.js +0 -71
- package/lib/docs/evalOperator.js +0 -49
- package/lib/docs/evalOperator.test.mjs +0 -157
- package/lib/docs/evalOperatorHeadless.js +0 -159
- package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
- package/lib/docs/evalOperatorInTab.js +0 -49
- package/lib/docs/formatFeedback.js +0 -142
- package/lib/docs/formatFeedback.test.mjs +0 -252
- package/lib/docs/getPluginDoc.js +0 -53
- package/lib/docs/listConfigCheckpoints.js +0 -55
- package/lib/docs/loadState.js +0 -220
- package/lib/docs/revertConfigCheckpoint.js +0 -73
- package/lib/docs/saveAnnotatedScreenshot.js +0 -43
- package/lib/docs/scaffoldPage.js +0 -77
- package/lib/docs/scaffoldPage.test.mjs +0 -97
- package/lib/docs/snapshotState.js +0 -67
- package/lib/docs/stateCheckpoints.test.mjs +0 -443
- package/manager/watchers/listServerSidePackages.mjs +0 -47
- package/manager/watchers/listServerSidePackages.test.mjs +0 -38
- package/src/routes/docs/checkpointsCreate.js +0 -28
- package/src/routes/docs/evalOperator.js +0 -70
- package/src/routes/docs/inspectState.js +0 -59
- package/src/routes/docs/loadState.js +0 -51
- package/src/routes/docs/pluginDoc.js +0 -33
- package/src/routes/docs/plugins.js +0 -23
- package/src/routes/docs/runEndpoint.js +0 -54
- package/src/routes/docs/runEndpoint.test.mjs +0 -165
- package/src/routes/docs/runRequest.js +0 -53
- package/src/routes/docs/runRequest.test.mjs +0 -92
- package/src/routes/docs/schema.js +0 -37
- package/src/routes/docs/screenshot.js +0 -120
- package/src/routes/docs/screenshot.test.mjs +0 -117
- package/src/routes/docs/search.js +0 -40
- package/src/routes/docs/snapshotState.js +0 -50
- package/src/routes/docs/stateCheckpointsList.js +0 -26
- package/src/routes/docs/types.js +0 -33
- package/src/routes/feedback.js +0 -107
- package/src/routes/feedback.test.mjs +0 -204
|
@@ -21,20 +21,52 @@ import { requestFromTab } from './tabChannel.js';
|
|
|
21
21
|
// Reads the live state of a page open in a developer's real browser tab, via
|
|
22
22
|
// the SSE + POST /api/dev-inspect round trip set up in Inspector.jsx. Lets an
|
|
23
23
|
// agent inspect actual client state (not just what the build would produce).
|
|
24
|
+
// With evaluate, the tab evaluates the expression with the page's own
|
|
25
|
+
// WebParser instead, so results match runtime exactly.
|
|
24
26
|
//
|
|
25
27
|
// requestFromTab resolves directly with whatever the tab posted as `result`
|
|
26
|
-
// (see tabChannel.js) — a serialized snapshot string
|
|
27
|
-
// `{ error }` object if no tab is
|
|
28
|
-
// Inspector.jsx itself failed
|
|
29
|
-
|
|
30
|
-
|
|
28
|
+
// (see tabChannel.js) — a serialized snapshot string, or `{ value, errors,
|
|
29
|
+
// reads }` for an expression, on success; an `{ error }` object if no tab is
|
|
30
|
+
// connected, the request timed out, or Inspector.jsx itself failed. `tabId`
|
|
31
|
+
// asks one tab (a phone in Lowdefy Dev answers in the same shapes), else the
|
|
32
|
+
// tab showing the page.
|
|
33
|
+
async function inspectStateFromTab({
|
|
34
|
+
tabId,
|
|
35
|
+
pageId,
|
|
36
|
+
pathParams,
|
|
37
|
+
evaluate = false,
|
|
38
|
+
expression,
|
|
39
|
+
} = {}) {
|
|
40
|
+
if (evaluate) {
|
|
41
|
+
return evaluateInTab({ tabId, pageId, pathParams, expression });
|
|
42
|
+
}
|
|
43
|
+
const response = await requestFromTab({ tabId, pageId, pathParams, event: 'inspect-request' });
|
|
31
44
|
if (response?.error) {
|
|
32
45
|
return { error: response.error };
|
|
33
46
|
}
|
|
34
47
|
if (!type.isString(response)) {
|
|
35
|
-
return { error: '
|
|
48
|
+
return { error: 'The tab responded with an unexpected payload.' };
|
|
36
49
|
}
|
|
37
50
|
return serializer.deserializeFromString(response);
|
|
38
51
|
}
|
|
39
52
|
|
|
53
|
+
async function evaluateInTab({ tabId, pageId, pathParams, expression }) {
|
|
54
|
+
const response = await requestFromTab({
|
|
55
|
+
tabId,
|
|
56
|
+
pageId,
|
|
57
|
+
pathParams,
|
|
58
|
+
event: 'eval-request',
|
|
59
|
+
payload: { expression },
|
|
60
|
+
});
|
|
61
|
+
if (response?.error) {
|
|
62
|
+
return { error: response.error };
|
|
63
|
+
}
|
|
64
|
+
const { value, errors, reads } = response;
|
|
65
|
+
return {
|
|
66
|
+
value: type.isUndefined(value) ? undefined : serializer.deserializeFromString(value),
|
|
67
|
+
errors,
|
|
68
|
+
reads,
|
|
69
|
+
};
|
|
70
|
+
}
|
|
71
|
+
|
|
40
72
|
export default inspectStateFromTab;
|
|
@@ -0,0 +1,79 @@
|
|
|
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 { serializer } from '@lowdefy/helpers';
|
|
18
|
+
import { vi, afterEach, expect, test } from 'vitest';
|
|
19
|
+
|
|
20
|
+
const { listTabs, registerTab, resolveTabRequest, unregisterTab, updateTabPage } = await import(
|
|
21
|
+
'./tabChannel.js'
|
|
22
|
+
);
|
|
23
|
+
const { default: inspectStateFromTab } = await import('./inspectStateFromTab.js');
|
|
24
|
+
|
|
25
|
+
afterEach(() => {
|
|
26
|
+
listTabs().forEach((tab) => unregisterTab({ id: tab.id }));
|
|
27
|
+
});
|
|
28
|
+
|
|
29
|
+
function connectHomeTab() {
|
|
30
|
+
const send = vi.fn();
|
|
31
|
+
registerTab({ id: 'tab-1', send });
|
|
32
|
+
updateTabPage({ id: 'tab-1', pageId: 'home', pathParams: {}, instanceKey: 'page:home' });
|
|
33
|
+
return send;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
test('inspectStateFromTab sends inspect-request and returns the tab snapshot', async () => {
|
|
37
|
+
const send = connectHomeTab();
|
|
38
|
+
|
|
39
|
+
const promise = inspectStateFromTab({ pageId: 'home' });
|
|
40
|
+
const [event, payload] = send.mock.calls[0];
|
|
41
|
+
expect(event).toEqual('inspect-request');
|
|
42
|
+
resolveTabRequest({
|
|
43
|
+
requestId: payload.requestId,
|
|
44
|
+
result: serializer.serializeToString({ state: { a: 1 } }),
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
await expect(promise).resolves.toEqual({ state: { a: 1 } });
|
|
48
|
+
});
|
|
49
|
+
|
|
50
|
+
test('inspectStateFromTab sends eval-request with the expression and returns value, errors and reads', async () => {
|
|
51
|
+
const send = connectHomeTab();
|
|
52
|
+
|
|
53
|
+
const promise = inspectStateFromTab({ pageId: 'home', evaluate: true, expression: null });
|
|
54
|
+
const [event, payload] = send.mock.calls[0];
|
|
55
|
+
expect(event).toEqual('eval-request');
|
|
56
|
+
expect(payload.expression).toBeNull();
|
|
57
|
+
resolveTabRequest({
|
|
58
|
+
requestId: payload.requestId,
|
|
59
|
+
result: { value: serializer.serializeToString(null), errors: [], reads: [] },
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
await expect(promise).resolves.toEqual({ value: null, errors: [], reads: [] });
|
|
63
|
+
});
|
|
64
|
+
|
|
65
|
+
test('inspectStateFromTab returns the tab error for an expression', async () => {
|
|
66
|
+
const send = connectHomeTab();
|
|
67
|
+
|
|
68
|
+
const promise = inspectStateFromTab({
|
|
69
|
+
pageId: 'home',
|
|
70
|
+
evaluate: true,
|
|
71
|
+
expression: { _state: 'a' },
|
|
72
|
+
});
|
|
73
|
+
resolveTabRequest({
|
|
74
|
+
requestId: send.mock.calls[0][1].requestId,
|
|
75
|
+
result: { error: 'Operator failed.' },
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
await expect(promise).resolves.toEqual({ error: 'Operator failed.' });
|
|
79
|
+
});
|
|
@@ -26,13 +26,24 @@ import withDataSession from './withDataSession.js';
|
|
|
26
26
|
|
|
27
27
|
// Collects a state snapshot from a headless Chromium tab navigated to the
|
|
28
28
|
// page instance's own route (`pathParams` fill a patterned page's placeholders),
|
|
29
|
-
// read under the instance key
|
|
30
|
-
//
|
|
31
|
-
// the
|
|
32
|
-
//
|
|
33
|
-
//
|
|
34
|
-
//
|
|
35
|
-
|
|
29
|
+
// read under the instance key, or with evaluate the value of an operator
|
|
30
|
+
// expression against that state. Mirrors Inspector.jsx's buildSnapshot and
|
|
31
|
+
// evalExpression (the live-tab equivalents), but window.lowdefy does not expose
|
|
32
|
+
// the app's serializer, so results are round-tripped through
|
|
33
|
+
// JSON.parse(JSON.stringify(...)) inside the page instead. That strips
|
|
34
|
+
// functions/undefined and turns Dates into plain ISO strings — good enough for
|
|
35
|
+
// agent inspection, just not a byte-for-byte match of the app's own
|
|
36
|
+
// `~d`-tagged serialization.
|
|
37
|
+
async function inspectStateHeadless({
|
|
38
|
+
origin,
|
|
39
|
+
pageId,
|
|
40
|
+
pathParams,
|
|
41
|
+
evaluate = false,
|
|
42
|
+
expression,
|
|
43
|
+
user,
|
|
44
|
+
data,
|
|
45
|
+
timeout = 15000,
|
|
46
|
+
}) {
|
|
36
47
|
if (type.isNone(origin) || !type.isString(origin)) {
|
|
37
48
|
return {
|
|
38
49
|
error: `inspectStateHeadless requires an "origin" string. Received ${JSON.stringify(
|
|
@@ -66,6 +77,8 @@ async function inspectStateHeadless({ origin, pageId, pathParams, user, data, ti
|
|
|
66
77
|
pageId,
|
|
67
78
|
pathParams,
|
|
68
79
|
instance,
|
|
80
|
+
evaluate,
|
|
81
|
+
expression,
|
|
69
82
|
user: caller.user,
|
|
70
83
|
dataCookie,
|
|
71
84
|
timeout,
|
|
@@ -80,6 +93,8 @@ async function inspectStateInBrowser({
|
|
|
80
93
|
pageId,
|
|
81
94
|
pathParams,
|
|
82
95
|
instance,
|
|
96
|
+
evaluate,
|
|
97
|
+
expression,
|
|
83
98
|
user,
|
|
84
99
|
dataCookie,
|
|
85
100
|
timeout,
|
|
@@ -106,36 +121,23 @@ async function inspectStateInBrowser({
|
|
|
106
121
|
timeout,
|
|
107
122
|
});
|
|
108
123
|
context = opened.context;
|
|
109
|
-
const
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
pathParams: pageContext.pathParams,
|
|
120
|
-
instanceKey,
|
|
121
|
-
state: pageContext.state,
|
|
122
|
-
requests: pageContext.requests,
|
|
123
|
-
eventLog: (pageContext.eventLog ?? []).slice(-50),
|
|
124
|
-
global: lowdefy.lowdefyGlobal,
|
|
125
|
-
user: lowdefy.user,
|
|
126
|
-
input: lowdefy.inputs?.[instanceKey],
|
|
127
|
-
urlQuery: window.location.search,
|
|
128
|
-
})
|
|
129
|
-
);
|
|
130
|
-
},
|
|
131
|
-
{ id: pageId, instanceKey: instance.instanceKey, path: instance.path }
|
|
132
|
-
);
|
|
124
|
+
const pageArgs = { id: pageId, instanceKey: instance.instanceKey, path: instance.path };
|
|
125
|
+
// The expression is passed through as JSON so the page-side parser always
|
|
126
|
+
// receives a plain value, matching how it arrives at Inspector.jsx's
|
|
127
|
+
// eval-request handler.
|
|
128
|
+
const result = evaluate
|
|
129
|
+
? await opened.page.evaluate(evaluateInPage, {
|
|
130
|
+
...pageArgs,
|
|
131
|
+
expressionJson: JSON.stringify(expression),
|
|
132
|
+
})
|
|
133
|
+
: await opened.page.evaluate(snapshotInPage, pageArgs);
|
|
133
134
|
if (!opened.ready) {
|
|
134
|
-
return { ...
|
|
135
|
+
return { ...result, ready: false, note: unsettledPageNote({ timeout }) };
|
|
135
136
|
}
|
|
136
|
-
return
|
|
137
|
+
return result;
|
|
137
138
|
} catch (error) {
|
|
138
|
-
|
|
139
|
+
const action = evaluate ? 'evaluate operator' : 'inspect state';
|
|
140
|
+
return { error: `Failed to ${action} at "${url}": ${error.message}` };
|
|
139
141
|
} finally {
|
|
140
142
|
if (context) {
|
|
141
143
|
await context.close();
|
|
@@ -143,4 +145,66 @@ async function inspectStateInBrowser({
|
|
|
143
145
|
}
|
|
144
146
|
}
|
|
145
147
|
|
|
148
|
+
// Runs in the page: serialized by Playwright, so it may use nothing from this module.
|
|
149
|
+
function snapshotInPage({ id, instanceKey, path }) {
|
|
150
|
+
const lowdefy = window.lowdefy;
|
|
151
|
+
const pageContext = lowdefy?.contexts?.[instanceKey];
|
|
152
|
+
if (!pageContext) {
|
|
153
|
+
return { error: `No live context for page "${id}" at "/${path}".` };
|
|
154
|
+
}
|
|
155
|
+
return JSON.parse(
|
|
156
|
+
JSON.stringify({
|
|
157
|
+
pageId: id,
|
|
158
|
+
pathParams: pageContext.pathParams,
|
|
159
|
+
instanceKey,
|
|
160
|
+
state: pageContext.state,
|
|
161
|
+
requests: pageContext.requests,
|
|
162
|
+
eventLog: (pageContext.eventLog ?? []).slice(-50),
|
|
163
|
+
global: lowdefy.lowdefyGlobal,
|
|
164
|
+
user: lowdefy.user,
|
|
165
|
+
input: lowdefy.inputs?.[instanceKey],
|
|
166
|
+
urlQuery: window.location.search,
|
|
167
|
+
})
|
|
168
|
+
);
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
// Runs in the page, like snapshotInPage. A read recorder set on the context
|
|
172
|
+
// while the expression is parsed collects the keys its operators read (the
|
|
173
|
+
// engine's block dependency tracking), e.g. "state:customer.name".
|
|
174
|
+
function evaluateInPage({ id, instanceKey, path, expressionJson }) {
|
|
175
|
+
const lowdefy = window.lowdefy;
|
|
176
|
+
const pageContext = lowdefy?.contexts?.[instanceKey];
|
|
177
|
+
if (!pageContext) {
|
|
178
|
+
return { error: `No live context for page "${id}" at "/${path}".` };
|
|
179
|
+
}
|
|
180
|
+
const reads = new Set();
|
|
181
|
+
const recordRead = (key) => {
|
|
182
|
+
if (typeof key === 'string') reads.add(key);
|
|
183
|
+
};
|
|
184
|
+
const ignore = () => {};
|
|
185
|
+
const previousRecorder = pageContext._internal.readRecorder;
|
|
186
|
+
pageContext._internal.readRecorder = {
|
|
187
|
+
read: recordRead,
|
|
188
|
+
engineRead: recordRead,
|
|
189
|
+
pure: ignore,
|
|
190
|
+
volatile: ignore,
|
|
191
|
+
untracked: ignore,
|
|
192
|
+
};
|
|
193
|
+
let parsed;
|
|
194
|
+
try {
|
|
195
|
+
parsed = pageContext._internal.parser.parse({
|
|
196
|
+
input: JSON.parse(expressionJson),
|
|
197
|
+
location: 'agent_eval',
|
|
198
|
+
});
|
|
199
|
+
} finally {
|
|
200
|
+
pageContext._internal.readRecorder = previousRecorder;
|
|
201
|
+
}
|
|
202
|
+
const { output, errors } = parsed;
|
|
203
|
+
return {
|
|
204
|
+
value: output === undefined ? undefined : JSON.parse(JSON.stringify(output)),
|
|
205
|
+
errors: errors.map((error) => error.message),
|
|
206
|
+
reads: [...reads],
|
|
207
|
+
};
|
|
208
|
+
}
|
|
209
|
+
|
|
146
210
|
export default inspectStateHeadless;
|
|
@@ -17,18 +17,18 @@
|
|
|
17
17
|
import fs from 'fs';
|
|
18
18
|
import os from 'os';
|
|
19
19
|
import path from 'path';
|
|
20
|
-
import {
|
|
20
|
+
import { vi, afterAll, expect, test } from 'vitest';
|
|
21
21
|
|
|
22
22
|
// A real headless inspection needs an installed browser, which jest can't
|
|
23
23
|
// rely on, so this only covers the error paths: bad input, and
|
|
24
24
|
// chromium.launch failing (the "no browser installed" case). Mirrors
|
|
25
25
|
// screenshotPage.test.mjs, which exercises the same getBrowser.js singleton.
|
|
26
|
-
|
|
27
|
-
chromium: { launch:
|
|
28
|
-
selectors: { register:
|
|
26
|
+
vi.doMock('playwright-core', () => ({
|
|
27
|
+
chromium: { launch: vi.fn().mockRejectedValue(new Error("Executable doesn't exist")) },
|
|
28
|
+
selectors: { register: vi.fn(async () => {}) },
|
|
29
29
|
}));
|
|
30
30
|
// A missing shell would otherwise start a real download.
|
|
31
|
-
|
|
31
|
+
vi.doMock('./installHeadlessShell.js', () => ({ default: () => null }));
|
|
32
32
|
|
|
33
33
|
// lib/build/config.js reads build/config.json from process.cwd() at import
|
|
34
34
|
// time — chdir into a fixture that has one before getBrowser.js (which
|
|
@@ -77,3 +77,15 @@ test('inspectStateHeadless returns the error naming a missing placeholder before
|
|
|
77
77
|
expect(result.invalidInput).toBe(true);
|
|
78
78
|
expect(result.error).toMatch(/missing a value for path placeholder "ticket_id"/);
|
|
79
79
|
});
|
|
80
|
+
|
|
81
|
+
test('inspectStateHeadless returns an actionable error when no browser is available to evaluate an expression', async () => {
|
|
82
|
+
const result = await inspectStateHeadless({
|
|
83
|
+
origin: 'http://localhost:3001',
|
|
84
|
+
pageId: 'home',
|
|
85
|
+
evaluate: true,
|
|
86
|
+
expression: { _state: 'x' },
|
|
87
|
+
});
|
|
88
|
+
expect(result.error).toMatch(
|
|
89
|
+
/No Chromium available. Run: npx playwright install chromium-headless-shell/
|
|
90
|
+
);
|
|
91
|
+
});
|
|
@@ -16,18 +16,22 @@
|
|
|
16
16
|
|
|
17
17
|
import { EventEmitter } from 'node:events';
|
|
18
18
|
|
|
19
|
-
import {
|
|
19
|
+
import { vi, expect, test } from 'vitest';
|
|
20
20
|
|
|
21
|
-
const mockSpawn =
|
|
22
|
-
|
|
21
|
+
const mockSpawn = vi.fn();
|
|
22
|
+
vi.doMock('child_process', () => ({ spawn: mockSpawn, spawnSync: vi.fn() }));
|
|
23
23
|
|
|
24
24
|
// A file of its own: installHeadlessShell keeps its one install per process
|
|
25
25
|
// in module state.
|
|
26
|
+
const mockLogger = { info: vi.fn(), warn: vi.fn() };
|
|
27
|
+
vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
|
|
28
|
+
|
|
26
29
|
const { default: installHeadlessShell } = await import('./installHeadlessShell.js');
|
|
27
30
|
|
|
28
31
|
test('installHeadlessShell logs a failed install once and does not retry it in this process', async () => {
|
|
29
|
-
const warn =
|
|
30
|
-
|
|
32
|
+
const warn = mockLogger.warn;
|
|
33
|
+
warn.mockClear();
|
|
34
|
+
mockLogger.info.mockClear();
|
|
31
35
|
const installer = Object.assign(new EventEmitter(), { stderr: new EventEmitter() });
|
|
32
36
|
mockSpawn.mockReturnValue(installer);
|
|
33
37
|
|
|
@@ -20,6 +20,9 @@ import path from 'path';
|
|
|
20
20
|
|
|
21
21
|
import { type } from '@lowdefy/helpers';
|
|
22
22
|
|
|
23
|
+
import createLogger from '../server/log/createLogger.js';
|
|
24
|
+
|
|
25
|
+
const logger = createLogger();
|
|
23
26
|
// Read the way Playwright's own installer reads it, so a value that turns
|
|
24
27
|
// Playwright's download off turns this one off too.
|
|
25
28
|
function isDownloadSkipped() {
|
|
@@ -56,7 +59,7 @@ function runInstall() {
|
|
|
56
59
|
path.dirname(require.resolve('playwright-core/package.json')),
|
|
57
60
|
'cli.js'
|
|
58
61
|
);
|
|
59
|
-
|
|
62
|
+
logger.info('Installing chromium-headless-shell for the dev server browser tools.');
|
|
60
63
|
return new Promise((resolve) => {
|
|
61
64
|
let settled = false;
|
|
62
65
|
let stderr = '';
|
|
@@ -66,7 +69,7 @@ function runInstall() {
|
|
|
66
69
|
settled = true;
|
|
67
70
|
clearTimeout(timer);
|
|
68
71
|
if (!installed) {
|
|
69
|
-
|
|
72
|
+
logger.warn(
|
|
70
73
|
`Could not install chromium-headless-shell (${reason}). The dev server browser tools use system Chrome when it is installed. Run: npx playwright install chromium-headless-shell`
|
|
71
74
|
);
|
|
72
75
|
}
|
|
@@ -16,14 +16,17 @@
|
|
|
16
16
|
|
|
17
17
|
import { EventEmitter } from 'node:events';
|
|
18
18
|
|
|
19
|
-
import {
|
|
19
|
+
import { vi, afterEach, beforeEach, expect, test } from 'vitest';
|
|
20
20
|
|
|
21
|
-
const mockSpawn =
|
|
22
|
-
|
|
21
|
+
const mockSpawn = vi.fn();
|
|
22
|
+
vi.doMock('child_process', () => ({ spawn: mockSpawn, spawnSync: vi.fn() }));
|
|
23
23
|
|
|
24
24
|
// installHeadlessShell keeps one install per process in module state, so the
|
|
25
25
|
// tests below run in order against one module: the skipped calls first, then
|
|
26
26
|
// the one install. The failure path is in installHeadlessShell.failure.test.mjs.
|
|
27
|
+
const mockLogger = { info: vi.fn(), warn: vi.fn() };
|
|
28
|
+
vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
|
|
29
|
+
|
|
27
30
|
const { default: installHeadlessShell } = await import('./installHeadlessShell.js');
|
|
28
31
|
|
|
29
32
|
function createInstaller() {
|
|
@@ -31,11 +34,11 @@ function createInstaller() {
|
|
|
31
34
|
}
|
|
32
35
|
|
|
33
36
|
beforeEach(() => {
|
|
34
|
-
|
|
37
|
+
mockLogger.info.mockClear();
|
|
35
38
|
});
|
|
36
39
|
|
|
37
40
|
afterEach(() => {
|
|
38
|
-
|
|
41
|
+
vi.restoreAllMocks();
|
|
39
42
|
delete process.env.PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD;
|
|
40
43
|
});
|
|
41
44
|
|
|
@@ -16,33 +16,53 @@
|
|
|
16
16
|
|
|
17
17
|
import { EventEmitter } from 'node:events';
|
|
18
18
|
|
|
19
|
-
import {
|
|
19
|
+
import { vi, expect, test } from 'vitest';
|
|
20
20
|
|
|
21
|
-
const mockSpawn =
|
|
22
|
-
const mockSpawnSync =
|
|
23
|
-
|
|
21
|
+
const mockSpawn = vi.fn();
|
|
22
|
+
const mockSpawnSync = vi.fn();
|
|
23
|
+
vi.doMock('child_process', () => ({ spawn: mockSpawn, spawnSync: mockSpawnSync }));
|
|
24
24
|
|
|
25
25
|
// A file of its own: installHeadlessShell keeps its one install per process
|
|
26
26
|
// in module state.
|
|
27
|
+
const mockLogger = { info: vi.fn(), warn: vi.fn() };
|
|
28
|
+
vi.doMock('../server/log/createLogger.js', () => ({ default: () => mockLogger }));
|
|
29
|
+
|
|
27
30
|
const { default: installHeadlessShell } = await import('./installHeadlessShell.js');
|
|
28
31
|
|
|
29
32
|
test('installHeadlessShell kills an install that has not finished within 3 minutes and gives up', async () => {
|
|
30
33
|
// performance is not redefinable on this Node, and nothing here reads it.
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
+
vi.useFakeTimers({
|
|
35
|
+
toFake: [
|
|
36
|
+
'Date',
|
|
37
|
+
'hrtime',
|
|
38
|
+
'queueMicrotask',
|
|
39
|
+
'requestAnimationFrame',
|
|
40
|
+
'cancelAnimationFrame',
|
|
41
|
+
'requestIdleCallback',
|
|
42
|
+
'cancelIdleCallback',
|
|
43
|
+
'setImmediate',
|
|
44
|
+
'clearImmediate',
|
|
45
|
+
'setInterval',
|
|
46
|
+
'clearInterval',
|
|
47
|
+
'setTimeout',
|
|
48
|
+
'clearTimeout',
|
|
49
|
+
],
|
|
50
|
+
});
|
|
51
|
+
const warn = mockLogger.warn;
|
|
52
|
+
warn.mockClear();
|
|
53
|
+
mockLogger.info.mockClear();
|
|
34
54
|
try {
|
|
35
55
|
const installer = Object.assign(new EventEmitter(), {
|
|
36
56
|
pid: 4242,
|
|
37
57
|
stderr: new EventEmitter(),
|
|
38
|
-
kill:
|
|
58
|
+
kill: vi.fn(),
|
|
39
59
|
});
|
|
40
60
|
mockSpawn.mockReturnValue(installer);
|
|
41
61
|
|
|
42
62
|
const install = installHeadlessShell();
|
|
43
|
-
|
|
63
|
+
vi.advanceTimersByTime(3 * 60 * 1000 - 1);
|
|
44
64
|
expect(installer.kill).not.toHaveBeenCalled();
|
|
45
|
-
|
|
65
|
+
vi.advanceTimersByTime(1);
|
|
46
66
|
|
|
47
67
|
const result = await install;
|
|
48
68
|
expect(result.installed).toBe(false);
|
|
@@ -66,7 +86,7 @@ test('installHeadlessShell kills an install that has not finished within 3 minut
|
|
|
66
86
|
expect(installHeadlessShell()).toBe(install);
|
|
67
87
|
expect(mockSpawn).toHaveBeenCalledTimes(1);
|
|
68
88
|
} finally {
|
|
69
|
-
|
|
70
|
-
|
|
89
|
+
vi.useRealTimers();
|
|
90
|
+
vi.restoreAllMocks();
|
|
71
91
|
}
|
|
72
92
|
});
|
|
@@ -0,0 +1,37 @@
|
|
|
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 { type } from '@lowdefy/helpers';
|
|
18
|
+
|
|
19
|
+
// Structural equality over values that have already been through a JSON
|
|
20
|
+
// round-trip (a page's state read in the browser or on a phone: no undefined,
|
|
21
|
+
// no Dates, no functions) — so key order is the only thing that must not matter.
|
|
22
|
+
function isDeepEqual(a, b) {
|
|
23
|
+
if (a === b) {
|
|
24
|
+
return true;
|
|
25
|
+
}
|
|
26
|
+
if (type.isArray(a) && type.isArray(b)) {
|
|
27
|
+
return a.length === b.length && a.every((item, index) => isDeepEqual(item, b[index]));
|
|
28
|
+
}
|
|
29
|
+
if (type.isObject(a) && type.isObject(b)) {
|
|
30
|
+
const keysA = Object.keys(a);
|
|
31
|
+
const keysB = Object.keys(b);
|
|
32
|
+
return keysA.length === keysB.length && keysA.every((key) => isDeepEqual(a[key], b[key]));
|
|
33
|
+
}
|
|
34
|
+
return false;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
export default isDeepEqual;
|
|
@@ -21,12 +21,13 @@ import fs from 'fs';
|
|
|
21
21
|
// that was killed or crashed after the executable landed leaves a directory
|
|
22
22
|
// without it: chromium.launch() checks only the executable and fails with a
|
|
23
23
|
// launch error, while a new `playwright install` sees the missing marker and
|
|
24
|
-
// installs again. The registry is Playwright's own (
|
|
25
|
-
// pinned playwright-core), so the directory honours
|
|
24
|
+
// installs again. The registry is Playwright's own (the `registry` namespace of
|
|
25
|
+
// the pinned playwright-core's exported core bundle), so the directory honours
|
|
26
|
+
// PLAYWRIGHT_BROWSERS_PATH.
|
|
26
27
|
async function isHeadlessShellIncomplete() {
|
|
27
|
-
const {
|
|
28
|
-
|
|
29
|
-
);
|
|
28
|
+
const {
|
|
29
|
+
registry: { browserDirectoryToMarkerFilePath, registry },
|
|
30
|
+
} = await import('playwright-core/lib/coreBundle');
|
|
30
31
|
const { directory } = registry.findExecutable('chromium-headless-shell');
|
|
31
32
|
return fs.existsSync(directory) && !fs.existsSync(browserDirectoryToMarkerFilePath(directory));
|
|
32
33
|
}
|
|
@@ -17,13 +17,16 @@
|
|
|
17
17
|
import fs from 'fs';
|
|
18
18
|
import os from 'os';
|
|
19
19
|
import path from 'path';
|
|
20
|
+
import { afterAll, afterEach, expect, test } from 'vitest';
|
|
20
21
|
|
|
21
22
|
// Playwright's registry reads PLAYWRIGHT_BROWSERS_PATH when it loads, so it
|
|
22
23
|
// is set before the first import.
|
|
23
24
|
const browsersPath = fs.mkdtempSync(path.join(os.tmpdir(), 'lowdefy-shell-'));
|
|
24
25
|
process.env.PLAYWRIGHT_BROWSERS_PATH = browsersPath;
|
|
25
26
|
|
|
26
|
-
const {
|
|
27
|
+
const {
|
|
28
|
+
registry: { registry },
|
|
29
|
+
} = await import('playwright-core/lib/coreBundle');
|
|
27
30
|
const { default: isHeadlessShellIncomplete } = await import('./isHeadlessShellIncomplete.js');
|
|
28
31
|
|
|
29
32
|
const { directory } = registry.findExecutable('chromium-headless-shell');
|
|
@@ -16,7 +16,7 @@
|
|
|
16
16
|
|
|
17
17
|
import http from 'node:http';
|
|
18
18
|
|
|
19
|
-
import {
|
|
19
|
+
import { vi, afterAll, beforeAll, expect, test } from 'vitest';
|
|
20
20
|
|
|
21
21
|
import pageReadyScript from '../../test-utils/pageReadyScript.mjs';
|
|
22
22
|
|
|
@@ -26,7 +26,7 @@ import pageReadyScript from '../../test-utils/pageReadyScript.mjs';
|
|
|
26
26
|
// verifies, it rides every request of every actor of the journey and nothing
|
|
27
27
|
// from any other context, page JavaScript cannot read it, and a detached hop
|
|
28
28
|
// forwards it alone. Skipped when no Chromium can be launched.
|
|
29
|
-
|
|
29
|
+
vi.doMock('../build/config.js', () => ({ default: {} }));
|
|
30
30
|
|
|
31
31
|
const { getBrowser, openPage } = await import('./getBrowser.js');
|
|
32
32
|
const { default: createJourneyActors } = await import('./createJourneyActors.js');
|
|
@@ -74,7 +74,7 @@ beforeAll(async () => {
|
|
|
74
74
|
origin = `http://127.0.0.1:${server.address().port}`;
|
|
75
75
|
});
|
|
76
76
|
|
|
77
|
-
// Closing Chromium on Windows can take longer than
|
|
77
|
+
// Closing Chromium on Windows can take longer than the 10 s hook default.
|
|
78
78
|
afterAll(async () => {
|
|
79
79
|
await browser?.close();
|
|
80
80
|
server.closeAllConnections();
|