@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
|
@@ -0,0 +1,73 @@
|
|
|
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 { findAndroidTool } from '@lowdefy/node-utils';
|
|
18
|
+
|
|
19
|
+
import listDevices from './listDevices.js';
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* What can reach a phone tab from outside the app, for the operations a simulator or emulator does
|
|
23
|
+
* more faithfully than Lowdefy Dev itself (a screenshot with the system UI, a real location or
|
|
24
|
+
* push). Resolves one of:
|
|
25
|
+
* - `{ kind: 'simulator', udid, name }`: the one booted iOS simulator (`xcrun simctl`).
|
|
26
|
+
* - `{ kind: 'android', serial, emulator, adb }`: the one Android device adb sees, an emulator or a
|
|
27
|
+
* USB phone through adb reverse.
|
|
28
|
+
* - `{ kind: 'view', reason }`: only Lowdefy Dev itself: a phone paired over the network, or no
|
|
29
|
+
* single simulator or device it could be.
|
|
30
|
+
* A tab on this computer's localhost is a simulator or an adb-reversed device, but with several
|
|
31
|
+
* booted the dev server cannot tell which one the tab is in, so it uses Lowdefy Dev's own capture.
|
|
32
|
+
*
|
|
33
|
+
* @param {Object} params
|
|
34
|
+
* @param {Object} params.tab The registered tab (tabChannel getTab), with its `device`.
|
|
35
|
+
* @param {Object} [params.devices] Options for listDevices (`run`, `adb`, `platform`).
|
|
36
|
+
*/
|
|
37
|
+
async function findDeviceTarget({ tab, devices = {} }) {
|
|
38
|
+
const { platform, paired } = tab.device;
|
|
39
|
+
if (paired) {
|
|
40
|
+
return { kind: 'view', reason: 'the phone is paired over the network' };
|
|
41
|
+
}
|
|
42
|
+
if (platform !== 'ios' && platform !== 'android') {
|
|
43
|
+
return { kind: 'view', reason: 'Lowdefy Dev did not report its platform' };
|
|
44
|
+
}
|
|
45
|
+
const adb = devices.adb ?? findAndroidTool({ name: 'adb' });
|
|
46
|
+
const listed = await listDevices({ ...devices, adb, only: platform });
|
|
47
|
+
if (platform === 'ios') {
|
|
48
|
+
if (listed.simulators.length === 1) {
|
|
49
|
+
const [{ udid, name }] = listed.simulators;
|
|
50
|
+
return { kind: 'simulator', udid, name };
|
|
51
|
+
}
|
|
52
|
+
return {
|
|
53
|
+
kind: 'view',
|
|
54
|
+
reason:
|
|
55
|
+
listed.simulators.length === 0
|
|
56
|
+
? `no booted iOS simulator was found (${listed.unavailable.join(' ') || 'none booted'})`
|
|
57
|
+
: `${listed.simulators.length} iOS simulators are booted, and the tab could be in any`,
|
|
58
|
+
};
|
|
59
|
+
}
|
|
60
|
+
if (listed.android.length === 1) {
|
|
61
|
+
const [{ serial, emulator }] = listed.android;
|
|
62
|
+
return { kind: 'android', serial, emulator, adb };
|
|
63
|
+
}
|
|
64
|
+
return {
|
|
65
|
+
kind: 'view',
|
|
66
|
+
reason:
|
|
67
|
+
listed.android.length === 0
|
|
68
|
+
? `adb lists no Android device (${listed.unavailable.join(' ') || 'none connected'})`
|
|
69
|
+
: `adb lists ${listed.android.length} Android devices, and the tab could be on any`,
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export default findDeviceTarget;
|
|
@@ -0,0 +1,160 @@
|
|
|
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
|
+
|
|
21
|
+
import { type } from '@lowdefy/helpers';
|
|
22
|
+
import { runDeviceTool } from '@lowdefy/node-utils';
|
|
23
|
+
|
|
24
|
+
import buildDeviceCommand, { SIMCTL_PRIVACY_SERVICES } from './buildDeviceCommand.js';
|
|
25
|
+
import findDeviceTab from './findDeviceTab.js';
|
|
26
|
+
import findDeviceTarget from './findDeviceTarget.js';
|
|
27
|
+
import { requestFromTab } from '../tabChannel.js';
|
|
28
|
+
|
|
29
|
+
// The kinds an iOS simulator also does itself, more faithfully than Lowdefy Dev's own answer.
|
|
30
|
+
const SIMULATOR_KINDS = ['location', 'push', 'permission'];
|
|
31
|
+
|
|
32
|
+
// Lowdefy Dev's bundle id (shell.dev.json), for a shell that did not report its own.
|
|
33
|
+
const LOWDEFY_DEV_APP_ID = 'com.lowdefy.dev';
|
|
34
|
+
|
|
35
|
+
function appId(tab) {
|
|
36
|
+
return tab.device.app ?? LOWDEFY_DEV_APP_ID;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
async function runWithFile({ contents, task }) {
|
|
40
|
+
const directory = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'lowdefy-device-'));
|
|
41
|
+
const file = path.join(directory, 'payload.json');
|
|
42
|
+
try {
|
|
43
|
+
await fs.promises.writeFile(file, contents);
|
|
44
|
+
return await task(file);
|
|
45
|
+
} finally {
|
|
46
|
+
await fs.promises.rm(directory, { recursive: true, force: true });
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
// An APNs payload ({ aps }) on a simulator is delivered by simctl alone, as Apple's push service
|
|
51
|
+
// would deliver it. Any other push goes to Lowdefy Dev, which shows it with expo-notifications and
|
|
52
|
+
// can tap it or press a button.
|
|
53
|
+
function isApnsPayload(value) {
|
|
54
|
+
return type.isObject(value) && type.isObject(value.aps);
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
async function pushToSimulator({ tab, target, value, run }) {
|
|
58
|
+
await runWithFile({
|
|
59
|
+
contents: JSON.stringify(value),
|
|
60
|
+
task: (file) =>
|
|
61
|
+
run(
|
|
62
|
+
buildDeviceCommand({
|
|
63
|
+
action: 'simulator-push',
|
|
64
|
+
udid: target.udid,
|
|
65
|
+
bundleId: appId(tab),
|
|
66
|
+
file,
|
|
67
|
+
})
|
|
68
|
+
),
|
|
69
|
+
});
|
|
70
|
+
return { ok: true, kind: 'push', via: 'simctl', simulator: target.name };
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
async function applyOnSimulator({ tab, target, kind, name, value, run }) {
|
|
74
|
+
if (kind === 'location') {
|
|
75
|
+
await run(buildDeviceCommand({ action: 'simulator-location', udid: target.udid, value }));
|
|
76
|
+
return { ok: true, simulator: target.name };
|
|
77
|
+
}
|
|
78
|
+
if (!SIMCTL_PRIVACY_SERVICES.includes(name)) {
|
|
79
|
+
return {
|
|
80
|
+
ok: false,
|
|
81
|
+
note: `The simulator has no privacy service "${name}" (simctl privacy knows ${SIMCTL_PRIVACY_SERVICES.join(
|
|
82
|
+
', '
|
|
83
|
+
)}), so only Lowdefy Dev's answer was set.`,
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
await run(
|
|
87
|
+
buildDeviceCommand({
|
|
88
|
+
action: 'simulator-privacy',
|
|
89
|
+
udid: target.udid,
|
|
90
|
+
answer: value,
|
|
91
|
+
service: name,
|
|
92
|
+
bundleId: appId(tab),
|
|
93
|
+
})
|
|
94
|
+
);
|
|
95
|
+
return {
|
|
96
|
+
ok: true,
|
|
97
|
+
simulator: target.name,
|
|
98
|
+
note: 'iOS may restart the app when a permission changes; Lowdefy Dev then joins as a new tab (lowdefy_device list).',
|
|
99
|
+
};
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* lowdefy_device `inject`: fakes the phone's next device result. The injection goes to Lowdefy
|
|
104
|
+
* Dev's dev-tab client (`inject`, `{ kind, value, name }`), which device actions read, so it works
|
|
105
|
+
* on every phone. On an iOS simulator a location and a permission are also set on the simulator
|
|
106
|
+
* (`xcrun simctl location`, `simctl privacy`), and an APNs payload ({ aps }) is delivered by
|
|
107
|
+
* `simctl push` alone; any other push is shown by Lowdefy Dev.
|
|
108
|
+
* Resolves `{ device, kind, app, simulator? }` (what Lowdefy Dev answered, and what the simulator
|
|
109
|
+
* did), or `{ error }` with Lowdefy Dev's own message for an injection it refused.
|
|
110
|
+
*
|
|
111
|
+
* @param {Object} params
|
|
112
|
+
* @param {string} params.device The phone's tab id.
|
|
113
|
+
* @param {Object} params.inject `{ kind, value, name }`.
|
|
114
|
+
* @param {Object} [params.devices] Options for listDevices (`adb`, `platform`).
|
|
115
|
+
* @param {Function} [params.run] Runs one device command (runDeviceTool).
|
|
116
|
+
*/
|
|
117
|
+
async function injectDevice({ device, inject, devices = {}, run = runDeviceTool }) {
|
|
118
|
+
const { tab, error } = findDeviceTab({ device });
|
|
119
|
+
if (!type.isUndefined(error)) {
|
|
120
|
+
return { error };
|
|
121
|
+
}
|
|
122
|
+
if (!type.isObject(inject) || !type.isString(inject.kind)) {
|
|
123
|
+
return {
|
|
124
|
+
error: `"inject" must be { kind, value, name }, kind one of scan, photo, nfc, transcript, location, permission, network, push, share, clear. Received ${JSON.stringify(
|
|
125
|
+
inject
|
|
126
|
+
)}.`,
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
const { kind, name, value } = inject;
|
|
130
|
+
let target = { kind: 'view' };
|
|
131
|
+
if (tab.device.platform === 'ios' && !tab.device.paired && SIMULATOR_KINDS.includes(kind)) {
|
|
132
|
+
target = await findDeviceTarget({ tab, devices: { ...devices, run } });
|
|
133
|
+
}
|
|
134
|
+
if (target.kind === 'simulator' && kind === 'push' && isApnsPayload(value)) {
|
|
135
|
+
try {
|
|
136
|
+
return { device: tab.id, ...(await pushToSimulator({ tab, target, value, run })) };
|
|
137
|
+
} catch (pushError) {
|
|
138
|
+
return { error: pushError.message };
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
const answer = await requestFromTab({
|
|
142
|
+
tabId: tab.id,
|
|
143
|
+
event: 'inject',
|
|
144
|
+
payload: { inject: { kind, value, name } },
|
|
145
|
+
});
|
|
146
|
+
if (!type.isUndefined(answer?.error)) {
|
|
147
|
+
return { error: answer.error };
|
|
148
|
+
}
|
|
149
|
+
const result = { device: tab.id, kind, app: answer };
|
|
150
|
+
if (target.kind === 'simulator') {
|
|
151
|
+
try {
|
|
152
|
+
result.simulator = await applyOnSimulator({ tab, target, kind, name, value, run });
|
|
153
|
+
} catch (simulatorError) {
|
|
154
|
+
result.simulator = { ok: false, error: simulatorError.message };
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
return result;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
export default injectDevice;
|
|
@@ -0,0 +1,100 @@
|
|
|
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 { findAndroidTool, runDeviceTool } from '@lowdefy/node-utils';
|
|
18
|
+
|
|
19
|
+
import buildDeviceCommand from './buildDeviceCommand.js';
|
|
20
|
+
|
|
21
|
+
function parseSimulators(output) {
|
|
22
|
+
const { devices } = JSON.parse(output);
|
|
23
|
+
return Object.entries(devices ?? {})
|
|
24
|
+
.filter(([runtime]) => runtime.includes('.iOS-'))
|
|
25
|
+
.flatMap(([runtime, simulators]) =>
|
|
26
|
+
simulators
|
|
27
|
+
.filter((simulator) => simulator.state === 'Booted')
|
|
28
|
+
.map(({ udid, name }) => ({ udid, name, runtime: runtime.split('.').pop() }))
|
|
29
|
+
);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
// `adb devices -l`: a header line, then `<serial> <state> key:value ...` per device.
|
|
33
|
+
function parseAndroidDevices(output) {
|
|
34
|
+
return output
|
|
35
|
+
.split('\n')
|
|
36
|
+
.slice(1)
|
|
37
|
+
.map((line) => line.trim().split(/\s+/))
|
|
38
|
+
.filter(([serial, state]) => serial && state === 'device')
|
|
39
|
+
.map(([serial, , ...details]) => {
|
|
40
|
+
const model = details.find((detail) => detail.startsWith('model:'));
|
|
41
|
+
return {
|
|
42
|
+
serial,
|
|
43
|
+
emulator: serial.startsWith('emulator-'),
|
|
44
|
+
model: model === undefined ? null : model.slice('model:'.length),
|
|
45
|
+
};
|
|
46
|
+
});
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
async function listSimulators({ platform, result, run }) {
|
|
50
|
+
if (platform !== 'darwin') {
|
|
51
|
+
result.unavailable.push('iOS simulators: they run only on macOS.');
|
|
52
|
+
return;
|
|
53
|
+
}
|
|
54
|
+
try {
|
|
55
|
+
result.simulators = parseSimulators(
|
|
56
|
+
await run(buildDeviceCommand({ action: 'list-simulators' }))
|
|
57
|
+
);
|
|
58
|
+
} catch (error) {
|
|
59
|
+
result.unavailable.push(`iOS simulators: ${error.message}`);
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
async function listAndroid({ adb, result, run }) {
|
|
64
|
+
try {
|
|
65
|
+
result.android = parseAndroidDevices(
|
|
66
|
+
await run(buildDeviceCommand({ action: 'list-android', adb }))
|
|
67
|
+
);
|
|
68
|
+
} catch (error) {
|
|
69
|
+
result.unavailable.push(`Android devices: ${error.message}`);
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* The booted iOS simulators and the Android devices (emulators and USB phones) on this computer,
|
|
75
|
+
* as `{ simulators, android, unavailable }`. A tool that is not installed lists nothing, and
|
|
76
|
+
* `unavailable` says which and why, so a Linux machine without Xcode still lists its emulators.
|
|
77
|
+
*
|
|
78
|
+
* @param {Object} [params]
|
|
79
|
+
* @param {string} [params.adb] The adb executable.
|
|
80
|
+
* @param {string} [params.platform] process.platform.
|
|
81
|
+
* @param {Function} [params.run] Runs one device command (runDeviceTool).
|
|
82
|
+
* @param {string} [params.only] 'ios' or 'android' to list one kind only.
|
|
83
|
+
*/
|
|
84
|
+
async function listDevices({
|
|
85
|
+
adb = findAndroidTool({ name: 'adb' }),
|
|
86
|
+
only,
|
|
87
|
+
platform = process.platform,
|
|
88
|
+
run = runDeviceTool,
|
|
89
|
+
} = {}) {
|
|
90
|
+
const result = { simulators: [], android: [], unavailable: [] };
|
|
91
|
+
if (only !== 'android') {
|
|
92
|
+
await listSimulators({ platform, result, run });
|
|
93
|
+
}
|
|
94
|
+
if (only !== 'ios') {
|
|
95
|
+
await listAndroid({ adb, result, run });
|
|
96
|
+
}
|
|
97
|
+
return result;
|
|
98
|
+
}
|
|
99
|
+
|
|
100
|
+
export default listDevices;
|
|
@@ -0,0 +1,105 @@
|
|
|
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 { expect, test } from 'vitest';
|
|
18
|
+
import listDevices from './listDevices.js';
|
|
19
|
+
|
|
20
|
+
const SIMULATORS = JSON.stringify({
|
|
21
|
+
devices: {
|
|
22
|
+
'com.apple.CoreSimulator.SimRuntime.iOS-18-2': [
|
|
23
|
+
{ udid: 'SIM-1', name: 'iPhone 16', state: 'Booted' },
|
|
24
|
+
{ udid: 'SIM-2', name: 'iPhone 16 Pro', state: 'Shutdown' },
|
|
25
|
+
],
|
|
26
|
+
'com.apple.CoreSimulator.SimRuntime.watchOS-11-2': [
|
|
27
|
+
{ udid: 'WATCH-1', name: 'Apple Watch', state: 'Booted' },
|
|
28
|
+
],
|
|
29
|
+
},
|
|
30
|
+
});
|
|
31
|
+
|
|
32
|
+
const ANDROID = [
|
|
33
|
+
'List of devices attached',
|
|
34
|
+
'emulator-5554 device product:sdk_gphone64 model:sdk_gphone64_arm64 device:emu64a transport_id:1',
|
|
35
|
+
'R58N12ABC device usb:1-1 product:a52 model:SM_A525F device:a52q transport_id:2',
|
|
36
|
+
'emulator-5556 offline transport_id:3',
|
|
37
|
+
'',
|
|
38
|
+
].join('\n');
|
|
39
|
+
|
|
40
|
+
function fakeRun({ simulators = SIMULATORS, android = ANDROID } = {}) {
|
|
41
|
+
const calls = [];
|
|
42
|
+
async function run({ command, args }) {
|
|
43
|
+
calls.push([command, ...args]);
|
|
44
|
+
if (command === 'xcrun') {
|
|
45
|
+
if (simulators instanceof Error) throw simulators;
|
|
46
|
+
return simulators;
|
|
47
|
+
}
|
|
48
|
+
if (android instanceof Error) throw android;
|
|
49
|
+
return android;
|
|
50
|
+
}
|
|
51
|
+
return { calls, run };
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
test('listDevices lists the booted iOS simulators and the Android devices adb sees', async () => {
|
|
55
|
+
const { calls, run } = fakeRun();
|
|
56
|
+
const result = await listDevices({ adb: 'adb', platform: 'darwin', run });
|
|
57
|
+
expect(result).toEqual({
|
|
58
|
+
simulators: [{ udid: 'SIM-1', name: 'iPhone 16', runtime: 'iOS-18-2' }],
|
|
59
|
+
android: [
|
|
60
|
+
{ serial: 'emulator-5554', emulator: true, model: 'sdk_gphone64_arm64' },
|
|
61
|
+
{ serial: 'R58N12ABC', emulator: false, model: 'SM_A525F' },
|
|
62
|
+
],
|
|
63
|
+
unavailable: [],
|
|
64
|
+
});
|
|
65
|
+
expect(calls).toEqual([
|
|
66
|
+
['xcrun', 'simctl', 'list', 'devices', 'booted', '--json'],
|
|
67
|
+
['adb', 'devices', '-l'],
|
|
68
|
+
]);
|
|
69
|
+
});
|
|
70
|
+
|
|
71
|
+
test('listDevices runs no xcrun off macOS and says why', async () => {
|
|
72
|
+
const { calls, run } = fakeRun();
|
|
73
|
+
const result = await listDevices({ adb: 'adb', platform: 'linux', run });
|
|
74
|
+
expect(result.simulators).toEqual([]);
|
|
75
|
+
expect(result.android).toHaveLength(2);
|
|
76
|
+
expect(result.unavailable).toEqual(['iOS simulators: they run only on macOS.']);
|
|
77
|
+
expect(calls).toEqual([['adb', 'devices', '-l']]);
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
test('listDevices lists nothing for a tool that is not installed, and says which', async () => {
|
|
81
|
+
const { run } = fakeRun({
|
|
82
|
+
simulators: new Error('xcrun simctl list devices booted --json failed: spawn xcrun ENOENT'),
|
|
83
|
+
android: new Error('adb devices -l failed: spawn adb ENOENT'),
|
|
84
|
+
});
|
|
85
|
+
const result = await listDevices({ adb: 'adb', platform: 'darwin', run });
|
|
86
|
+
expect(result).toEqual({
|
|
87
|
+
simulators: [],
|
|
88
|
+
android: [],
|
|
89
|
+
unavailable: [
|
|
90
|
+
'iOS simulators: xcrun simctl list devices booted --json failed: spawn xcrun ENOENT',
|
|
91
|
+
'Android devices: adb devices -l failed: spawn adb ENOENT',
|
|
92
|
+
],
|
|
93
|
+
});
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
test('listDevices lists one kind only when asked', async () => {
|
|
97
|
+
const ios = fakeRun();
|
|
98
|
+
expect(
|
|
99
|
+
(await listDevices({ adb: 'adb', platform: 'darwin', run: ios.run, only: 'ios' })).android
|
|
100
|
+
).toEqual([]);
|
|
101
|
+
expect(ios.calls).toEqual([['xcrun', 'simctl', 'list', 'devices', 'booted', '--json']]);
|
|
102
|
+
const android = fakeRun();
|
|
103
|
+
await listDevices({ adb: 'adb', platform: 'darwin', run: android.run, only: 'android' });
|
|
104
|
+
expect(android.calls).toEqual([['adb', 'devices', '-l']]);
|
|
105
|
+
});
|
|
@@ -0,0 +1,68 @@
|
|
|
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
|
+
import checkShownPage from './checkShownPage.js';
|
|
20
|
+
import findDeviceTab from './findDeviceTab.js';
|
|
21
|
+
import inspectStateFromTab from '../inspectStateFromTab.js';
|
|
22
|
+
import runDeviceSteps from './runDeviceSteps.js';
|
|
23
|
+
import selectFinalState from '../selectFinalState.js';
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* lowdefy_run_journey on a phone: the steps run on the page it shows (runDeviceSteps), and the
|
|
27
|
+
* result has the browser journey's shape: `{ pageId, device, passed, steps, screenshots, state |
|
|
28
|
+
* stateOmitted, failure? }`, with the phone's final page state. Resolves `{ error }` for a call it
|
|
29
|
+
* cannot run (no such phone, another page shown, a step a phone does not run).
|
|
30
|
+
*
|
|
31
|
+
* @param {Object} params
|
|
32
|
+
* @param {string} params.device The phone's tab id.
|
|
33
|
+
* @param {string} params.pageId The page the phone must show when the journey starts.
|
|
34
|
+
* @param {Object} [params.pathParams]
|
|
35
|
+
* @param {Object[]} params.steps
|
|
36
|
+
* @param {number} [params.stepTimeout]
|
|
37
|
+
* @param {boolean|string[]} [params.state] What the result carries of the final state.
|
|
38
|
+
*/
|
|
39
|
+
async function runDeviceJourney({ device, pageId, pathParams, steps, stepTimeout, state }) {
|
|
40
|
+
const { tab, error } = findDeviceTab({ device });
|
|
41
|
+
if (!type.isUndefined(error)) {
|
|
42
|
+
return { error };
|
|
43
|
+
}
|
|
44
|
+
const notShown = checkShownPage({ tab, pageId, pathParams });
|
|
45
|
+
if (!type.isUndefined(notShown)) {
|
|
46
|
+
return { error: notShown };
|
|
47
|
+
}
|
|
48
|
+
const ran = await runDeviceSteps({ tabId: tab.id, steps, stepTimeout });
|
|
49
|
+
if (!type.isUndefined(ran.error)) {
|
|
50
|
+
return { error: ran.error };
|
|
51
|
+
}
|
|
52
|
+
const snapshot = await inspectStateFromTab({ tabId: tab.id });
|
|
53
|
+
const finalState = type.isUndefined(snapshot.error) ? snapshot.state : { error: snapshot.error };
|
|
54
|
+
const result = {
|
|
55
|
+
pageId,
|
|
56
|
+
device: tab.id,
|
|
57
|
+
passed: type.isUndefined(ran.failure),
|
|
58
|
+
steps: ran.results,
|
|
59
|
+
screenshots: ran.screenshots,
|
|
60
|
+
...selectFinalState({ state: finalState, selection: state }),
|
|
61
|
+
};
|
|
62
|
+
if (!type.isUndefined(ran.failure)) {
|
|
63
|
+
result.failure = ran.failure;
|
|
64
|
+
}
|
|
65
|
+
return result;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export default runDeviceJourney;
|
|
@@ -0,0 +1,164 @@
|
|
|
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 { get, type, wait } from '@lowdefy/helpers';
|
|
18
|
+
import { getStepKey } from '@lowdefy/node-utils';
|
|
19
|
+
|
|
20
|
+
import inspectStateFromTab from '../inspectStateFromTab.js';
|
|
21
|
+
import isDeepEqual from '../isDeepEqual.js';
|
|
22
|
+
import JourneyStepError from '../JourneyStepError.js';
|
|
23
|
+
import sendDeviceStep from './sendDeviceStep.js';
|
|
24
|
+
|
|
25
|
+
// The steps Lowdefy Dev runs itself (shell src/dev/steps/createStepRunner.js), by block id.
|
|
26
|
+
const PHONE_STEPS = ['click', 'fill', 'select', 'press', 'wait', 'screenshot'];
|
|
27
|
+
const POLL_MS = 100;
|
|
28
|
+
|
|
29
|
+
function describeUnsupported(step) {
|
|
30
|
+
const key = getStepKey(step);
|
|
31
|
+
if (key === 'expect') {
|
|
32
|
+
return `{"expect": ${JSON.stringify(
|
|
33
|
+
Object.keys(step.expect ?? {})
|
|
34
|
+
)}} (a phone checks only "state")`;
|
|
35
|
+
}
|
|
36
|
+
return `"${key}"`;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function isSupported(step) {
|
|
40
|
+
if (!type.isObject(step) || Object.keys(step).length !== 1) {
|
|
41
|
+
return false;
|
|
42
|
+
}
|
|
43
|
+
const key = getStepKey(step);
|
|
44
|
+
if (PHONE_STEPS.includes(key)) {
|
|
45
|
+
return true;
|
|
46
|
+
}
|
|
47
|
+
return (
|
|
48
|
+
key === 'expect' &&
|
|
49
|
+
type.isObject(step.expect) &&
|
|
50
|
+
Object.keys(step.expect).length === 1 &&
|
|
51
|
+
type.isObject(step.expect.state) &&
|
|
52
|
+
type.isString(step.expect.state.path)
|
|
53
|
+
);
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
async function readStateValue({ tabId, path }) {
|
|
57
|
+
const snapshot = await inspectStateFromTab({ tabId });
|
|
58
|
+
if (!type.isUndefined(snapshot.error)) {
|
|
59
|
+
return { error: new Error(snapshot.error) };
|
|
60
|
+
}
|
|
61
|
+
return { value: get(snapshot.state ?? {}, path) ?? null };
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
// Polled, as in the browser: the value a tap leads to often lands once its request has answered.
|
|
65
|
+
async function expectState({ tabId, params, stepTimeout }) {
|
|
66
|
+
const { path, equals } = params;
|
|
67
|
+
const deadline = Date.now() + stepTimeout;
|
|
68
|
+
let read = await readStateValue({ tabId, path });
|
|
69
|
+
while (
|
|
70
|
+
(!type.isUndefined(read.error) || !isDeepEqual(read.value, equals)) &&
|
|
71
|
+
Date.now() < deadline
|
|
72
|
+
) {
|
|
73
|
+
await wait(POLL_MS);
|
|
74
|
+
read = await readStateValue({ tabId, path });
|
|
75
|
+
}
|
|
76
|
+
if (!type.isUndefined(read.error)) {
|
|
77
|
+
throw read.error;
|
|
78
|
+
}
|
|
79
|
+
if (!isDeepEqual(read.value, equals)) {
|
|
80
|
+
throw new JourneyStepError(
|
|
81
|
+
`Expected state "${path}" to equal ${JSON.stringify(equals)} but found ${JSON.stringify(
|
|
82
|
+
read.value
|
|
83
|
+
)}.`,
|
|
84
|
+
{ expected: equals, actual: read.value }
|
|
85
|
+
);
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
function toFailure({ error, index, step }) {
|
|
90
|
+
if (error instanceof JourneyStepError) {
|
|
91
|
+
return {
|
|
92
|
+
index,
|
|
93
|
+
step,
|
|
94
|
+
expected: error.expected,
|
|
95
|
+
actual: type.isUndefined(error.actual) ? null : error.actual,
|
|
96
|
+
message: error.message,
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
return {
|
|
100
|
+
index,
|
|
101
|
+
step,
|
|
102
|
+
expected: `step ${index} (${getStepKey(step)}) to complete`,
|
|
103
|
+
actual: error.message,
|
|
104
|
+
message: error.message,
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* Runs journey steps on a phone, in order, stopping at the first that fails. Lowdefy Dev runs
|
|
110
|
+
* click, fill, select, press, wait and screenshot itself, by block id, through the engine; an
|
|
111
|
+
* `expect: { state }` is read from its live state. Any other step is refused before the first
|
|
112
|
+
* runs, as `{ error }`. Otherwise resolves `{ results, screenshots, failure }`, as the browser's
|
|
113
|
+
* runner does: a failed step is a result, not an error.
|
|
114
|
+
*
|
|
115
|
+
* @param {Object} params
|
|
116
|
+
* @param {string} params.tabId The phone's tab.
|
|
117
|
+
* @param {Object[]} [params.steps]
|
|
118
|
+
* @param {number} [params.stepTimeout] How long each step waits, in ms.
|
|
119
|
+
*/
|
|
120
|
+
async function runDeviceSteps({ tabId, steps = [], stepTimeout = 5000 }) {
|
|
121
|
+
const unsupported = steps.filter((step) => !isSupported(step));
|
|
122
|
+
if (unsupported.length > 0) {
|
|
123
|
+
return {
|
|
124
|
+
error: `A phone runs the steps ${PHONE_STEPS.join(
|
|
125
|
+
', '
|
|
126
|
+
)} and expect with "state", by blockId. Not supported on a phone: ${unsupported
|
|
127
|
+
.map(describeUnsupported)
|
|
128
|
+
.join(', ')}.`,
|
|
129
|
+
};
|
|
130
|
+
}
|
|
131
|
+
const results = [];
|
|
132
|
+
const screenshots = [];
|
|
133
|
+
let failure;
|
|
134
|
+
for (let index = 0; index < steps.length; index += 1) {
|
|
135
|
+
const step = steps[index];
|
|
136
|
+
if (!type.isUndefined(failure)) {
|
|
137
|
+
results.push({ index, step, status: 'skipped', durationMs: 0 });
|
|
138
|
+
continue;
|
|
139
|
+
}
|
|
140
|
+
const started = Date.now();
|
|
141
|
+
try {
|
|
142
|
+
if (getStepKey(step) === 'expect') {
|
|
143
|
+
await expectState({ tabId, params: step.expect.state, stepTimeout });
|
|
144
|
+
} else {
|
|
145
|
+
const answer = await sendDeviceStep({ tabId, step, stepTimeout });
|
|
146
|
+
if (getStepKey(step) === 'screenshot') {
|
|
147
|
+
screenshots.push({
|
|
148
|
+
name: type.isString(step.screenshot) ? step.screenshot : `step-${index}`,
|
|
149
|
+
data: answer.image,
|
|
150
|
+
mimeType: 'image/png',
|
|
151
|
+
});
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
results.push({ index, step, status: 'ok', durationMs: Date.now() - started });
|
|
155
|
+
} catch (error) {
|
|
156
|
+
failure = toFailure({ error, index, step });
|
|
157
|
+
results.push({ index, step, status: 'failed', durationMs: Date.now() - started });
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
return { results, screenshots, failure };
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
export { PHONE_STEPS };
|
|
164
|
+
export default runDeviceSteps;
|