@lowdefy/server-dev 7.0.0 → 7.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/client/Inspector.jsx +24 -75
- package/client/Page.jsx +8 -0
- package/client/Routing.jsx +0 -2
- package/client/clientBuildImports.test.mjs +5 -3
- package/client/devStreamConnections.test.mjs +1 -0
- package/client/journeyObserver/startJourneyObserver.test.mjs +11 -11
- package/client/openInEditor/OpenInEditorListener.jsx +36 -29
- package/client/openInEditor/OpenInEditorListener.test.mjs +116 -0
- package/client/{feedback → openInEditor}/elementInspect.js +9 -44
- package/client/openInEditor/findBlockLocation.js +2 -2
- package/client/openInEditor/openInEditorStyles.js +56 -0
- package/client/recorder/createPairingBuffer.test.mjs +27 -9
- package/client/recorder/createRecorder.js +11 -7
- package/client/recorder/createRecorder.test.mjs +9 -9
- package/client/recorder/isPasswordElement.js +41 -0
- package/client/recorder/keyChord.test.mjs +1 -0
- package/{client/recorder/toJsonSafe.js → lib/build/mobileConfig.js} +9 -12
- package/lib/client/auth/AuthConfigured.jsx +75 -48
- package/lib/client/auth/authNotConfiguredParity.test.mjs +1 -0
- package/lib/client/auth/authTemplateSync.test.mjs +1 -0
- package/lib/client/auth/betterAuthSessionContract.test.mjs +2 -1
- package/lib/client/auth/sessionCaller.js +56 -0
- package/lib/client/auth/sessionCaller.test.mjs +78 -0
- package/lib/client/getPagePath.test.mjs +1 -0
- package/lib/client/utils/formatErrorsForCopy.test.mjs +1 -0
- package/lib/client/utils/getErrorBarColor.test.mjs +1 -0
- package/lib/client/utils/usePageConfig.test.mjs +15 -15
- package/lib/configTree/buildConfigTree.test.mjs +6 -8
- package/lib/configTree/collectConfigText.test.mjs +1 -0
- package/lib/configTree/runConfigTreeBuild.mjs +2 -1
- package/lib/configTree/runConfigTreeBuild.skipPluginChecks.test.mjs +11 -11
- package/lib/configTree/runConfigTreeBuild.test.mjs +2 -2
- package/lib/docs/addNestedEndpoints.test.mjs +1 -0
- package/lib/docs/checkAgentFiles.test.mjs +1 -0
- package/lib/docs/checkStepReferences.test.mjs +3 -3
- package/lib/docs/clientErrorStore.test.mjs +4 -4
- package/lib/docs/createBrowserLifecycle.test.mjs +40 -24
- package/lib/docs/createDocsMcpServer.js +195 -138
- package/lib/docs/createDocsMcpServer.test.mjs +331 -25
- package/lib/docs/createDocsMcpServerRunJourney.test.mjs +5 -5
- package/lib/docs/createJourneyActors.chromium.test.mjs +3 -3
- package/lib/docs/createJourneyActors.test.mjs +4 -4
- package/lib/docs/dataSets/checkSharedCollectionIds.js +20 -9
- package/lib/docs/dataSets/dataSetJourneys.chromium.mongodb.test.mjs +59 -11
- package/{src/routes/docs/content.js → lib/docs/dataSets/describeTargetKey.js} +10 -14
- package/lib/docs/dataSets/drainSessionWork.test.mjs +21 -5
- package/lib/docs/dataSets/getDataStore.js +11 -3
- package/lib/docs/dataSets/getDataStore.mongodb.test.mjs +3 -3
- package/lib/docs/dataSets/getDataStore.test.mjs +32 -20
- package/lib/docs/dataSets/groupDataSetByCollection.js +19 -11
- package/lib/docs/dataSets/mergeCollectionIndexes.test.mjs +1 -0
- package/lib/docs/dataSets/openDataSession.js +36 -20
- package/lib/docs/dataSets/openDataSession.mongodb.test.mjs +175 -7
- package/lib/docs/dataSets/pickDataStorePort.test.mjs +2 -2
- package/lib/docs/dataSets/readDataSession.test.mjs +1 -0
- package/lib/docs/dataSets/readDataSet.js +34 -19
- package/lib/docs/dataSets/readDataSet.test.mjs +57 -25
- package/lib/docs/dataSets/resolveJourneyDataSet.test.mjs +1 -0
- package/lib/docs/dataSets/sessionDatabaseName.js +32 -0
- package/lib/docs/dataSets/sweepOrphanDatabases.js +7 -4
- package/lib/docs/dataSets/test/app/lowdefy.yaml +22 -0
- package/lib/docs/dataSets/test/app/tests/data/shop.yaml +4 -0
- package/lib/docs/dataSets/test/buildTestApp.mjs +1 -1
- package/lib/docs/devEventBus.js +7 -2
- package/lib/docs/devEventBus.test.mjs +12 -10
- package/lib/docs/devToolDefinitions.js +87 -135
- package/lib/docs/device/buildDeviceCommand.js +103 -0
- package/lib/docs/device/buildDeviceCommand.test.mjs +142 -0
- package/lib/docs/device/captureDevice.js +85 -0
- package/lib/docs/device/checkShownPage.js +56 -0
- package/lib/docs/device/createFakePhoneTab.mjs +77 -0
- package/lib/docs/device/deviceAction.js +74 -0
- package/lib/docs/device/deviceTools.test.mjs +604 -0
- package/lib/docs/device/findDeviceTab.js +50 -0
- package/lib/docs/device/findDeviceTarget.js +73 -0
- package/lib/docs/device/injectDevice.js +160 -0
- package/lib/docs/device/listDevices.js +100 -0
- package/lib/docs/device/listDevices.test.mjs +105 -0
- package/lib/docs/device/runDeviceJourney.js +68 -0
- package/lib/docs/device/runDeviceSteps.js +164 -0
- package/lib/docs/device/screenshotDevice.js +68 -0
- package/lib/docs/device/sendDeviceStep.js +52 -0
- package/lib/docs/device/startDevice.js +150 -0
- package/lib/docs/docs.test.mjs +44 -28
- package/lib/docs/docsIndex.test.mjs +1 -0
- package/lib/docs/findConfig.js +3 -4
- package/lib/docs/findPageBlock.js +35 -0
- package/lib/docs/findPageBlock.test.mjs +45 -0
- package/lib/docs/fitResponse.js +18 -17
- package/lib/docs/fitResponse.test.mjs +18 -0
- package/lib/docs/getBrowser.js +4 -4
- package/lib/docs/getBrowser.test.mjs +32 -16
- package/lib/docs/getBuildId.test.mjs +1 -0
- package/lib/docs/getBuildStatus.js +29 -3
- package/lib/docs/getBuildStatus.test.mjs +108 -12
- package/lib/docs/getBuildStatusAfterEdits.test.mjs +8 -8
- package/{src/routes/docs/appMap.js → lib/docs/getConfigDirectory.js} +3 -5
- package/lib/docs/getHazards.js +4 -1
- package/lib/docs/getHazards.test.mjs +9 -7
- package/lib/docs/getOverview.js +22 -44
- package/lib/docs/getOverviewBasePath.test.mjs +1 -0
- package/lib/docs/getStaleStatus.test.mjs +1 -0
- package/lib/docs/inspectState.js +78 -3
- package/lib/docs/inspectState.test.mjs +61 -9
- package/lib/docs/inspectStateFromTab.js +38 -6
- package/lib/docs/inspectStateFromTab.test.mjs +79 -0
- package/lib/docs/inspectStateHeadless.js +98 -34
- package/lib/docs/inspectStateHeadless.test.mjs +17 -5
- package/lib/docs/installHeadlessShell.failure.test.mjs +9 -5
- package/lib/docs/installHeadlessShell.js +5 -2
- package/lib/docs/installHeadlessShell.test.mjs +8 -5
- package/lib/docs/installHeadlessShell.timeout.test.mjs +32 -12
- package/lib/docs/isDeepEqual.js +37 -0
- package/lib/docs/isHeadlessShellIncomplete.test.mjs +1 -0
- package/lib/docs/isPageReady.test.mjs +1 -0
- package/lib/docs/journeyMutantCookie.chromium.test.mjs +3 -3
- package/lib/docs/journeyRunRecording.test.mjs +1 -0
- package/lib/docs/keepEventStreamAlive.test.mjs +1 -0
- package/lib/docs/launchBrowser.test.mjs +8 -8
- package/lib/docs/listTypes.js +58 -8
- package/lib/docs/loadFrameworkHazards.test.mjs +1 -0
- package/lib/docs/matchJourneyRoute.test.mjs +1 -0
- package/lib/docs/observe/createJourneyAppErrors.test.mjs +3 -3
- package/lib/docs/observe/evaluateInvariants.test.mjs +1 -0
- package/lib/docs/observe/hasNoEffect.test.mjs +1 -0
- package/lib/docs/observe/withAppErrors.test.mjs +1 -0
- package/lib/docs/openJourneyEmail.test.mjs +6 -6
- package/lib/docs/pageBuildStatus.test.mjs +6 -6
- package/lib/docs/pollTab.js +100 -0
- package/lib/docs/pollTab.test.mjs +64 -0
- package/lib/docs/rails/authEngineActions.test.mjs +1 -0
- package/lib/docs/rails/authEngineMethods.test.mjs +2 -1
- package/lib/docs/rails/checkAuthActionsRan.test.mjs +5 -5
- package/lib/docs/rails/createDataSetRails.test.mjs +1 -0
- package/lib/docs/rails/findExternalBlocks.js +3 -3
- package/lib/docs/rails/findExternalBlocks.test.mjs +1 -0
- package/lib/docs/readJourneyEmailMatch.test.mjs +2 -2
- package/lib/docs/readJourneySession.js +1 -1
- package/lib/docs/reportDevToolFault.js +29 -0
- package/lib/docs/reportDevToolFault.test.mjs +34 -0
- package/lib/docs/requestRestart.test.mjs +1 -0
- package/lib/docs/resolvePageInstance.test.mjs +1 -0
- package/lib/docs/resolveSource.js +2 -2
- package/lib/docs/resolveSource.test.mjs +6 -6
- package/lib/docs/reviewPageBuilds.test.mjs +2 -2
- package/lib/docs/runCheck.test.mjs +3 -3
- package/lib/docs/runCheckChild.js +2 -1
- package/lib/docs/runEndpoint.js +23 -10
- package/lib/docs/runEndpoint.test.mjs +42 -37
- package/lib/docs/runErrorBuffers.test.mjs +1 -0
- package/lib/docs/runJourney.js +21 -1
- package/lib/docs/runJourney.test.mjs +119 -99
- package/lib/docs/runJourneyDataSet.test.mjs +26 -26
- package/lib/docs/runJourneySteps.js +8 -29
- package/lib/docs/runRequest.js +6 -6
- package/lib/docs/runRequest.test.mjs +22 -22
- package/lib/docs/screenshotPage.js +6 -7
- package/lib/docs/screenshotPage.test.mjs +46 -46
- package/lib/docs/screenshotPageClip.test.mjs +10 -10
- package/lib/docs/searchDocs.test.mjs +1 -0
- package/lib/docs/searchIcons.test.mjs +5 -5
- package/lib/docs/selectFinalState.test.mjs +1 -0
- package/lib/docs/serverErrorStore.test.mjs +4 -4
- package/lib/docs/setupTestFixtures.mjs +25 -0
- package/lib/docs/splitSearchTerms.test.mjs +1 -0
- package/lib/docs/tabAvailable.js +1 -1
- package/lib/docs/tabChannel.js +90 -14
- package/lib/docs/tabChannel.test.mjs +40 -15
- package/lib/docs/validateJourneyTimeout.test.mjs +1 -0
- package/lib/docs/validateStateSelection.test.mjs +1 -0
- package/lib/docs/validateViewport.test.mjs +1 -0
- package/lib/docs/waitForBuild.test.mjs +1 -0
- package/lib/docs/withBrowserSlot.test.mjs +5 -5
- package/lib/docs/withDataSession.js +2 -2
- package/lib/server/applyDataSetRedirect.js +14 -5
- package/lib/server/applyDataSetRedirect.test.mjs +121 -15
- package/lib/server/applyDataSetRedirectTenantReach.test.mjs +5 -1
- package/lib/server/applyDataSetRedirectWalled.test.mjs +5 -1
- package/lib/server/auth/getHeadlessUser.js +6 -0
- package/lib/server/auth/getHeadlessUser.test.mjs +13 -2
- package/lib/server/auth/resolveHeadlessUser.test.mjs +1 -0
- package/lib/server/contextMapBudget.test.mjs +3 -3
- package/lib/server/continueJitKeys.test.mjs +1 -0
- package/lib/server/createLowdefyContext.js +8 -4
- package/lib/server/createLowdefyContext.test.mjs +38 -35
- package/lib/server/getClientAddress.test.mjs +2 -2
- package/lib/server/getPageJitEnrichment.test.mjs +1 -0
- package/lib/server/importAppCode.test.mjs +2 -2
- package/lib/server/jitPageBuilder.js +27 -3
- package/lib/server/jitPageBuilder.mobileTypes.test.mjs +65 -0
- package/lib/server/jitPageBuilder.skipPluginChecks.test.mjs +5 -6
- package/lib/server/jitPageBuilder.test.mjs +4 -4
- package/lib/server/journeyCookies.test.mjs +1 -0
- package/lib/server/loadDynamicJsMap.js +10 -1
- package/lib/server/log/createHandleError.js +10 -5
- package/lib/server/log/createHandleError.test.mjs +19 -8
- package/lib/server/log/createLogger.test.mjs +2 -2
- package/lib/server/mutantDataSetWrappers.test.mjs +5 -1
- package/lib/server/mutants/listMutants.test.mjs +1 -0
- package/lib/server/mutants/mutantRuns.test.mjs +1 -0
- package/lib/server/mutants/operators.test.mjs +1 -0
- package/lib/server/pageBuildRecords.test.mjs +1 -0
- package/lib/server/pageCache.test.mjs +1 -0
- package/lib/server/pageRebuilds.test.mjs +3 -3
- package/{src/routes/docs/examples.js → lib/server/pairingHeaders.js} +8 -15
- package/lib/server/pruneJitMaps.test.mjs +1 -0
- package/lib/server/readBuildApiArtifacts.test.mjs +1 -0
- package/lib/server/readInstanceRecord.test.mjs +24 -8
- package/lib/server/readMergedMaps.test.mjs +1 -0
- package/lib/server/recording/errorRecordingStamp.test.mjs +1 -0
- package/lib/server/recording/readRecordingCookie.test.mjs +2 -0
- package/lib/server/recording/servedBuilds.test.mjs +1 -0
- package/lib/server/sinkExternalConnections.test.mjs +6 -6
- package/lib/server/skipStaleMapWrites.test.mjs +12 -12
- package/lib/server/startIdleGc.test.mjs +25 -9
- package/lib/server/testFixtures/importAppCodeTwice.mjs +2 -2
- package/lib/vite/createDevServerExclude.test.mjs +1 -0
- package/manager/getContext.mjs +11 -2
- package/manager/processes/checkPendingPlugins.mjs +49 -0
- package/manager/processes/checkPendingPlugins.test.mjs +107 -0
- package/manager/processes/createIdleChild.mjs +141 -0
- package/manager/processes/createIdleChild.test.mjs +209 -0
- package/manager/processes/initialBuild.mjs +4 -15
- package/manager/processes/initialBuild.test.mjs +8 -37
- package/manager/processes/lowdefyBuild.mjs +11 -7
- package/manager/processes/lowdefyBuild.skipPluginChecks.test.mjs +23 -13
- package/manager/processes/lowdefyBuild.test.mjs +17 -15
- package/manager/processes/restartServer.test.mjs +63 -15
- package/manager/processes/shutdownServer.test.mjs +3 -3
- package/manager/processes/startFirstServer.test.mjs +23 -22
- package/manager/processes/startMailSink.mjs +11 -3
- package/manager/processes/startMailSink.test.mjs +28 -2
- package/manager/processes/startProxy.mjs +158 -27
- package/manager/processes/startProxy.pairing.test.mjs +204 -0
- package/manager/processes/startProxy.test.mjs +127 -2
- package/manager/processes/startServer.mjs +5 -7
- package/manager/processes/startServer.test.mjs +10 -9
- package/manager/processes/syncServer.mjs +31 -4
- package/manager/processes/syncServer.test.mjs +71 -6
- package/manager/processes/waitForDevServer.test.mjs +21 -6
- package/manager/run.mjs +32 -8
- package/manager/utils/BatchChanges.mjs +1 -1
- package/manager/utils/BatchChanges.test.mjs +4 -4
- package/manager/utils/acquireDevInstance.test.mjs +1 -0
- package/manager/utils/checkPairing.mjs +45 -0
- package/manager/utils/checkPairing.test.mjs +53 -0
- package/manager/utils/createBuildActivity.mjs +5 -1
- package/manager/utils/createBuildActivity.test.mjs +2 -2
- package/manager/utils/createChangeSignal.test.mjs +5 -5
- package/manager/utils/createCustomPluginMessagesMap.mjs +8 -3
- package/manager/utils/createCustomPluginTypesMap.mjs +48 -12
- package/manager/utils/createCustomPluginTypesMap.test.mjs +181 -19
- package/manager/utils/createDotPathIgnore.test.mjs +1 -0
- package/manager/utils/createGlobIgnore.mjs +45 -0
- package/manager/utils/createGlobIgnore.test.mjs +58 -0
- package/manager/utils/createGlobWatchPaths.mjs +75 -0
- package/manager/utils/createGlobWatchPaths.test.mjs +67 -0
- package/manager/utils/createIdleGc.test.mjs +31 -15
- package/manager/utils/createLanPairing.mjs +34 -0
- package/manager/utils/createLanPairing.test.mjs +46 -0
- package/manager/utils/createRequestActivity.mjs +30 -3
- package/manager/utils/createRequestActivity.test.mjs +76 -22
- package/manager/utils/createServerArtifactTracker.mjs +1 -0
- package/manager/utils/createServerArtifactTracker.test.mjs +1 -0
- package/manager/utils/findBuildFilesOutsideWatch.test.mjs +1 -0
- package/{client/recorder/collectEventActions.js → manager/utils/findSignInCode.mjs} +13 -10
- package/manager/utils/findSignInCode.test.mjs +33 -0
- package/manager/utils/formatLanPairing.mjs +32 -0
- package/manager/utils/formatLanPairing.test.mjs +40 -0
- package/manager/utils/getLanAddress.mjs +83 -0
- package/manager/utils/getLanAddress.test.mjs +70 -0
- package/manager/utils/importFresh.test.mjs +1 -0
- package/{src/routes/docs/icons.js → manager/utils/isLoopbackAddress.mjs} +11 -10
- package/manager/utils/pluginTypeCache.mjs +100 -0
- package/manager/utils/pluginTypeCache.test.mjs +141 -0
- package/manager/utils/pruneRecordings.test.mjs +1 -0
- package/manager/utils/publishBuildDirectory.order.test.mjs +2 -2
- package/manager/utils/publishBuildDirectory.test.mjs +6 -7
- package/manager/utils/readBasePath.test.mjs +1 -0
- package/manager/utils/readManagerVersion.test.mjs +1 -0
- package/manager/utils/readPluginDefinitions.mjs +6 -6
- package/manager/utils/renderTerminalQr.mjs +54 -0
- package/manager/utils/resolveDevAuthUrl.test.mjs +1 -0
- package/manager/utils/setupWatcher.mjs +19 -4
- package/manager/utils/startRecordingPruner.test.mjs +24 -8
- package/manager/utils/waitForChildExit.test.mjs +2 -2
- package/manager/utils/writeBuildStatus.test.mjs +1 -0
- package/manager/watchers/envWatcher.mjs +3 -0
- package/manager/watchers/envWatcher.test.mjs +19 -7
- package/manager/watchers/listServerPluginFiles.mjs +188 -0
- package/manager/watchers/listServerPluginFiles.test.mjs +257 -0
- package/manager/watchers/lowdefyBuildWatcher.mjs +5 -0
- package/manager/watchers/lowdefyBuildWatcher.test.mjs +63 -10
- package/manager/watchers/pluginSourceWatcher.mjs +45 -17
- package/manager/watchers/pluginSourceWatcher.test.mjs +97 -21
- package/manager/watchers/resolveFile.mjs +46 -0
- package/manager/watchers/resolveFile.test.mjs +67 -0
- package/manager/watchers/resolvePackageSpecifier.mjs +127 -0
- package/manager/watchers/resolvePackageSpecifier.test.mjs +151 -0
- package/manager/watchers/restartRequestWatcher.mjs +7 -4
- package/manager/watchers/restartRequestWatcher.test.mjs +43 -6
- package/manager/watchers/selectLocalPluginPackages.test.mjs +1 -0
- package/package.json +50 -49
- package/package.original.json +50 -49
- package/src/app.js +83 -85
- package/src/html/renderDevPage.test.mjs +1 -0
- package/src/lib/getPathSegments.js +16 -1
- package/src/{routes/docs/checkpointsList.js → lib/getRequestSurface.js} +6 -4
- package/src/lib/isTabAnswer.js +32 -0
- package/src/lib/isTabChannelCaller.js +35 -0
- package/src/middleware/apiContext.js +4 -2
- package/src/middleware/createSameOriginGuard.test.mjs +1 -0
- package/src/middleware/errorHandler.js +33 -45
- package/src/middleware/errorHandler.test.mjs +10 -10
- package/src/middleware/isRebindingSafeHost.test.mjs +1 -0
- package/src/middleware/localDevToolsOnly.js +13 -1
- package/src/middleware/localDevToolsOnly.test.mjs +36 -2
- package/src/middleware/noStore.test.mjs +1 -0
- package/src/middleware/staleFlag.test.mjs +1 -0
- package/src/middleware/stampCaller.test.mjs +1 -0
- package/src/routes/agentBearer.test.mjs +183 -0
- package/src/routes/auth.test.mjs +10 -10
- package/src/routes/clientError.js +21 -4
- package/src/routes/clientError.test.mjs +127 -0
- package/src/routes/devInspect.js +6 -51
- package/src/routes/devInspect.test.mjs +128 -3
- package/src/routes/devRecording.js +6 -17
- package/src/routes/devRecording.test.mjs +54 -3
- package/src/routes/docs/buildStatus.test.mjs +6 -6
- package/src/routes/docs/events.test.mjs +4 -4
- package/src/routes/docs/find.js +3 -3
- package/src/routes/docs/journey.test.mjs +8 -8
- package/src/routes/docs/journeyRefusals.test.mjs +9 -9
- package/src/routes/docs/loadDocsRoutes.js +70 -0
- package/src/routes/docs/loadDocsRoutes.test.mjs +110 -0
- package/src/routes/docs/mcp.test.mjs +5 -5
- package/src/routes/docs/mutants.js +7 -0
- package/src/routes/docs/mutants.test.mjs +20 -6
- package/src/routes/docs/parsePathParamsParam.test.mjs +1 -0
- package/src/routes/docs/parseUserParam.test.mjs +1 -0
- package/src/routes/docs/restart.test.mjs +1 -0
- package/src/routes/endpoints.js +24 -0
- package/src/routes/endpointsLink.test.mjs +111 -0
- package/src/routes/endpointsTextAnswer.test.mjs +8 -8
- package/src/routes/jitPage.js +13 -1
- package/src/routes/jitPage.test.mjs +36 -11
- package/src/routes/mcp.js +6 -0
- package/src/routes/mcp.test.mjs +23 -8
- package/src/routes/mcpMemberToken.test.mjs +8 -8
- package/src/routes/mcpProtectedResourceMetadata.test.mjs +2 -2
- package/src/routes/{docs/checkpointsRevert.js → mobileRoot.js} +10 -13
- package/src/routes/mobileRoutes.test.mjs +223 -0
- package/src/routes/mobileSignIn.js +58 -0
- package/src/routes/mobileSignIn.test.mjs +59 -0
- package/src/routes/mobileSignInCallback.js +34 -0
- package/src/routes/mobileSignInCallback.test.mjs +51 -0
- package/src/routes/mountDevPageRoutes.js +10 -2
- package/src/routes/mountDevPageRoutes.test.mjs +25 -1
- package/src/routes/mountMobileWellKnown.js +35 -0
- package/src/routes/mountMobileWellKnown.test.mjs +79 -0
- package/src/routes/mountOauthDiscovery.test.mjs +5 -5
- package/src/routes/normalizeMcpProtocolVersionHeader.test.mjs +1 -0
- package/src/routes/reload.js +101 -20
- package/src/routes/reload.test.mjs +153 -0
- package/src/routes/request.js +1 -22
- package/src/routes/request.test.mjs +7 -24
- package/src/routes/requestBody.test.mjs +14 -27
- package/src/routes/websocket.test.mjs +2 -2
- package/src/routes/wellKnownFallback.test.mjs +2 -2
- package/src/websocket/devWebSocket.test.mjs +12 -12
- package/vite.config.js +13 -1
- package/client/feedback/FeedbackMount.jsx +0 -83
- package/client/feedback/FeedbackOverlay.jsx +0 -904
- package/client/feedback/captureTabScreenshot.js +0 -84
- package/client/feedback/copyToClipboard.js +0 -45
- package/client/feedback/drawAnnotationsSvg.js +0 -119
- package/client/feedback/feedbackStyles.js +0 -304
- package/client/feedback/pinResponsiveImages.js +0 -59
- package/client/feedback/sendFeedback.js +0 -39
- package/client/feedback/useFeedbackToggle.js +0 -70
- package/client/recorder/buildEngineRecord.js +0 -37
- package/client/recorder/buildInteractionRecord.js +0 -64
- package/client/recorder/buildTraceEvent.js +0 -57
- package/client/recorder/buildTraceEvent.test.mjs +0 -81
- package/client/recorder/chunkRecords.js +0 -69
- package/client/recorder/chunkRecords.test.mjs +0 -59
- package/client/recorder/collectEventEndpoints.js +0 -40
- package/client/recorder/collectEventRequests.js +0 -39
- package/client/recorder/createPairingBuffer.js +0 -187
- package/client/recorder/createPasswordRedactor.js +0 -84
- package/client/recorder/createRecordBatcher.js +0 -54
- package/client/recorder/createRecordBatcher.test.mjs +0 -76
- package/client/recorder/createRecordingSession.js +0 -61
- package/client/recorder/createRecordingSession.test.mjs +0 -72
- package/client/recorder/diffStateWrites.js +0 -77
- package/client/recorder/diffStateWrites.test.mjs +0 -66
- package/client/recorder/isEventCall.js +0 -30
- package/client/recorder/jsonType.js +0 -39
- package/client/recorder/sendRecords.js +0 -40
- package/lib/docs/captureAnnotatedScreenshot.js +0 -99
- package/lib/docs/checkpointPaths.js +0 -91
- package/lib/docs/checkpointStore.js +0 -243
- package/lib/docs/checkpointToMocks.js +0 -65
- package/lib/docs/configCheckpoints.test.mjs +0 -156
- package/lib/docs/createConfigCheckpoint.js +0 -92
- package/lib/docs/dataSets/findCollectionCollisions.js +0 -52
- package/lib/docs/devMockRegistry.js +0 -68
- package/lib/docs/enrichFeedback.js +0 -71
- package/lib/docs/evalOperator.js +0 -49
- package/lib/docs/evalOperator.test.mjs +0 -157
- package/lib/docs/evalOperatorHeadless.js +0 -159
- package/lib/docs/evalOperatorHeadless.test.mjs +0 -78
- package/lib/docs/evalOperatorInTab.js +0 -49
- package/lib/docs/formatFeedback.js +0 -142
- package/lib/docs/formatFeedback.test.mjs +0 -252
- package/lib/docs/getPluginDoc.js +0 -53
- package/lib/docs/listConfigCheckpoints.js +0 -55
- package/lib/docs/loadState.js +0 -220
- package/lib/docs/revertConfigCheckpoint.js +0 -73
- package/lib/docs/saveAnnotatedScreenshot.js +0 -43
- package/lib/docs/scaffoldPage.js +0 -77
- package/lib/docs/scaffoldPage.test.mjs +0 -97
- package/lib/docs/snapshotState.js +0 -67
- package/lib/docs/stateCheckpoints.test.mjs +0 -443
- package/manager/watchers/listServerSidePackages.mjs +0 -47
- package/manager/watchers/listServerSidePackages.test.mjs +0 -38
- package/src/routes/docs/checkpointsCreate.js +0 -28
- package/src/routes/docs/evalOperator.js +0 -70
- package/src/routes/docs/inspectState.js +0 -59
- package/src/routes/docs/loadState.js +0 -51
- package/src/routes/docs/pluginDoc.js +0 -33
- package/src/routes/docs/plugins.js +0 -23
- package/src/routes/docs/runEndpoint.js +0 -54
- package/src/routes/docs/runEndpoint.test.mjs +0 -165
- package/src/routes/docs/runRequest.js +0 -53
- package/src/routes/docs/runRequest.test.mjs +0 -92
- package/src/routes/docs/schema.js +0 -37
- package/src/routes/docs/screenshot.js +0 -120
- package/src/routes/docs/screenshot.test.mjs +0 -117
- package/src/routes/docs/search.js +0 -40
- package/src/routes/docs/snapshotState.js +0 -50
- package/src/routes/docs/stateCheckpointsList.js +0 -26
- package/src/routes/docs/types.js +0 -33
- package/src/routes/feedback.js +0 -107
- package/src/routes/feedback.test.mjs +0 -204
|
@@ -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
|
+
import { runDeviceTool } from '@lowdefy/node-utils';
|
|
19
|
+
|
|
20
|
+
import captureDevice from './captureDevice.js';
|
|
21
|
+
import checkShownPage from './checkShownPage.js';
|
|
22
|
+
import findDeviceTab from './findDeviceTab.js';
|
|
23
|
+
import findDeviceTarget from './findDeviceTarget.js';
|
|
24
|
+
import runDeviceSteps from './runDeviceSteps.js';
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* lowdefy_screenshot_page on a phone: runs `steps` on it through Lowdefy Dev, then captures its
|
|
28
|
+
* screen (captureDevice). Resolves `{ data, mimeType, capture, note?, failure, screenshots,
|
|
29
|
+
* device }` in the shape screenshotPage gives a browser capture, or `{ error }`.
|
|
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.
|
|
34
|
+
* @param {Object} [params.pathParams]
|
|
35
|
+
* @param {Object[]} [params.steps]
|
|
36
|
+
* @param {Object} [params.devices] Options for listDevices (`adb`, `platform`).
|
|
37
|
+
* @param {Function} [params.run] Runs one device command (runDeviceTool).
|
|
38
|
+
*/
|
|
39
|
+
async function screenshotDevice({
|
|
40
|
+
device,
|
|
41
|
+
pageId,
|
|
42
|
+
pathParams,
|
|
43
|
+
steps,
|
|
44
|
+
devices = {},
|
|
45
|
+
run = runDeviceTool,
|
|
46
|
+
}) {
|
|
47
|
+
const { tab, error } = findDeviceTab({ device });
|
|
48
|
+
if (!type.isUndefined(error)) {
|
|
49
|
+
return { error };
|
|
50
|
+
}
|
|
51
|
+
const notShown = checkShownPage({ tab, pageId, pathParams });
|
|
52
|
+
if (!type.isUndefined(notShown)) {
|
|
53
|
+
return { error: notShown };
|
|
54
|
+
}
|
|
55
|
+
const ran = await runDeviceSteps({ tabId: tab.id, steps });
|
|
56
|
+
if (!type.isUndefined(ran.error)) {
|
|
57
|
+
return { error: ran.error };
|
|
58
|
+
}
|
|
59
|
+
try {
|
|
60
|
+
const target = await findDeviceTarget({ tab, devices: { ...devices, run } });
|
|
61
|
+
const capture = await captureDevice({ tab, target, run });
|
|
62
|
+
return { ...capture, failure: ran.failure, screenshots: ran.screenshots, device: tab.id };
|
|
63
|
+
} catch (captureError) {
|
|
64
|
+
return { error: `Could not capture the phone on tab "${tab.id}": ${captureError.message}` };
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export default screenshotDevice;
|
|
@@ -0,0 +1,52 @@
|
|
|
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 { requestFromTab } from '../tabChannel.js';
|
|
20
|
+
|
|
21
|
+
// A step waits up to its own timeout for its block or condition, then up to 5 s for the action
|
|
22
|
+
// chain it started to settle (shell src/dev/steps/createStepRunner.js).
|
|
23
|
+
const SETTLE_MS = 5000;
|
|
24
|
+
const MARGIN_MS = 2000;
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Runs one journey step on a phone through its dev-tab client (a `step-request`), and resolves
|
|
28
|
+
* what the phone answered: `{ ok, settled }`, or `{ ok, name, image }` for a screenshot step.
|
|
29
|
+
* Throws with the phone's own message when the step could not run.
|
|
30
|
+
*
|
|
31
|
+
* @param {Object} params
|
|
32
|
+
* @param {string} params.tabId
|
|
33
|
+
* @param {Object} params.step One journey step, e.g. `{ click: 'save' }`.
|
|
34
|
+
* @param {number} [params.stepTimeout] How long the phone waits for the step's block or condition.
|
|
35
|
+
*/
|
|
36
|
+
async function sendDeviceStep({ tabId, step, stepTimeout = 5000 }) {
|
|
37
|
+
const result = await requestFromTab({
|
|
38
|
+
tabId,
|
|
39
|
+
event: 'step-request',
|
|
40
|
+
payload: { step },
|
|
41
|
+
timeout: stepTimeout + SETTLE_MS + MARGIN_MS,
|
|
42
|
+
});
|
|
43
|
+
if (!type.isObject(result)) {
|
|
44
|
+
throw new Error(`The phone answered the step with ${JSON.stringify(result)}.`);
|
|
45
|
+
}
|
|
46
|
+
if (!type.isUndefined(result.error)) {
|
|
47
|
+
throw new Error(result.error);
|
|
48
|
+
}
|
|
49
|
+
return result;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
export default sendDeviceStep;
|
|
@@ -0,0 +1,150 @@
|
|
|
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 { wait } from '@lowdefy/helpers';
|
|
18
|
+
import {
|
|
19
|
+
bootIosSimulator,
|
|
20
|
+
createDevAppLink,
|
|
21
|
+
findAndroidDevice,
|
|
22
|
+
findAndroidTool,
|
|
23
|
+
readDevAppPath,
|
|
24
|
+
runDeviceTool,
|
|
25
|
+
} from '@lowdefy/node-utils';
|
|
26
|
+
|
|
27
|
+
import { listTabs } from '../tabChannel.js';
|
|
28
|
+
|
|
29
|
+
const PLATFORMS = ['ios', 'android'];
|
|
30
|
+
const POLL_MS = 500;
|
|
31
|
+
|
|
32
|
+
function phoneTabIds() {
|
|
33
|
+
return new Set(
|
|
34
|
+
listTabs()
|
|
35
|
+
.filter((tab) => tab.device !== null && tab.device !== undefined)
|
|
36
|
+
.map((tab) => tab.id)
|
|
37
|
+
);
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
// Lowdefy Dev joins the dev server's tab channel a moment after it opens the link.
|
|
41
|
+
async function waitForNewTab({ before, platform, timeout }) {
|
|
42
|
+
const deadline = Date.now() + timeout;
|
|
43
|
+
while (Date.now() < deadline) {
|
|
44
|
+
const joined = listTabs().find(
|
|
45
|
+
(tab) => !before.has(tab.id) && tab.device?.platform === platform
|
|
46
|
+
);
|
|
47
|
+
if (joined !== undefined) {
|
|
48
|
+
return joined.id;
|
|
49
|
+
}
|
|
50
|
+
await wait(POLL_MS);
|
|
51
|
+
}
|
|
52
|
+
return null;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
async function startIos({ hostPlatform, log, origin, run }) {
|
|
56
|
+
if (hostPlatform !== 'darwin') {
|
|
57
|
+
throw new Error('The iOS simulator runs only on macOS. Start an Android emulator instead.');
|
|
58
|
+
}
|
|
59
|
+
const appPath = readDevAppPath({ platform: 'ios' });
|
|
60
|
+
const simulator = await bootIosSimulator({ log, run });
|
|
61
|
+
await run({ command: 'xcrun', args: ['simctl', 'install', simulator.udid, appPath] });
|
|
62
|
+
await run({
|
|
63
|
+
command: 'xcrun',
|
|
64
|
+
args: ['simctl', 'openurl', simulator.udid, createDevAppLink({ url: origin })],
|
|
65
|
+
});
|
|
66
|
+
return { simulator: { udid: simulator.udid, name: simulator.name } };
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
// adb reverse makes the device's localhost:<port> this computer's, so Lowdefy Dev reaches the dev
|
|
70
|
+
// server without the network and without pairing. adb shell runs its arguments through the
|
|
71
|
+
// device's shell: the link is quoted, whose ? and & the shell would otherwise read.
|
|
72
|
+
async function startAndroid({ log, origin, run }) {
|
|
73
|
+
const adb = findAndroidTool({ name: 'adb' });
|
|
74
|
+
const appPath = readDevAppPath({ platform: 'android' });
|
|
75
|
+
const serial = await findAndroidDevice({
|
|
76
|
+
adb,
|
|
77
|
+
emulator: findAndroidTool({ name: 'emulator' }),
|
|
78
|
+
log,
|
|
79
|
+
run,
|
|
80
|
+
});
|
|
81
|
+
const port = new URL(origin).port;
|
|
82
|
+
await run({ command: adb, args: ['-s', serial, 'install', '-r', appPath] });
|
|
83
|
+
await run({ command: adb, args: ['-s', serial, 'reverse', `tcp:${port}`, `tcp:${port}`] });
|
|
84
|
+
await run({
|
|
85
|
+
command: adb,
|
|
86
|
+
args: [
|
|
87
|
+
'-s',
|
|
88
|
+
serial,
|
|
89
|
+
'shell',
|
|
90
|
+
'am',
|
|
91
|
+
'start',
|
|
92
|
+
'-a',
|
|
93
|
+
'android.intent.action.VIEW',
|
|
94
|
+
'-d',
|
|
95
|
+
`'${createDevAppLink({ url: origin })}'`,
|
|
96
|
+
],
|
|
97
|
+
});
|
|
98
|
+
return { android: { serial } };
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* lowdefy_device `start`: what `lowdefy dev --ios` or `--android` does, for a dev server that is
|
|
103
|
+
* already running. It boots a simulator (or uses the booted one), or finds an Android device or
|
|
104
|
+
* starts the first emulator, installs Lowdefy Dev from LOWDEFY_DEV_APP_IOS or
|
|
105
|
+
* LOWDEFY_DEV_APP_ANDROID, and opens it on this dev server. Resolves `{ started, platform, url,
|
|
106
|
+
* simulator | android, device }`, `device` being the tab Lowdefy Dev joined as (null when it has
|
|
107
|
+
* not joined within tabTimeout), or `{ error }`.
|
|
108
|
+
*
|
|
109
|
+
* @param {Object} params
|
|
110
|
+
* @param {string} params.platform 'ios' or 'android'.
|
|
111
|
+
* @param {string} params.origin This dev server's URL on this computer.
|
|
112
|
+
* @param {(message: string) => void} [params.log]
|
|
113
|
+
* @param {Function} [params.run] Runs one device command (runDeviceTool).
|
|
114
|
+
* @param {number} [params.tabTimeout] How long to wait for Lowdefy Dev to join, in ms.
|
|
115
|
+
* @param {string} [params.hostPlatform] process.platform.
|
|
116
|
+
*/
|
|
117
|
+
async function startDevice({
|
|
118
|
+
platform,
|
|
119
|
+
origin,
|
|
120
|
+
hostPlatform = process.platform,
|
|
121
|
+
log = () => undefined,
|
|
122
|
+
run = runDeviceTool,
|
|
123
|
+
tabTimeout = 30000,
|
|
124
|
+
}) {
|
|
125
|
+
if (!PLATFORMS.includes(platform)) {
|
|
126
|
+
return {
|
|
127
|
+
error: `start needs "platform" "ios" or "android". Received ${JSON.stringify(platform)}.`,
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
const before = phoneTabIds();
|
|
131
|
+
let started;
|
|
132
|
+
try {
|
|
133
|
+
started =
|
|
134
|
+
platform === 'ios'
|
|
135
|
+
? await startIos({ hostPlatform, log, origin, run })
|
|
136
|
+
: await startAndroid({ log, origin, run });
|
|
137
|
+
} catch (error) {
|
|
138
|
+
return { error: `Could not start Lowdefy Dev on ${platform}: ${error.message}` };
|
|
139
|
+
}
|
|
140
|
+
const device = await waitForNewTab({ before, platform, timeout: tabTimeout });
|
|
141
|
+
const result = { started: true, platform, url: origin, ...started, device };
|
|
142
|
+
if (device === null) {
|
|
143
|
+
result.note = `Lowdefy Dev opened ${origin} but has not joined as a tab within ${Math.round(
|
|
144
|
+
tabTimeout / 1000
|
|
145
|
+
)} s. Confirm the connection in the app if it asks, then call lowdefy_device with action "list".`;
|
|
146
|
+
}
|
|
147
|
+
return result;
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
export default startDevice;
|
package/lib/docs/docs.test.mjs
CHANGED
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
import fs from 'fs';
|
|
18
18
|
import path from 'path';
|
|
19
19
|
|
|
20
|
-
import {
|
|
20
|
+
import { vi, expect, test } from 'vitest';
|
|
21
21
|
|
|
22
22
|
import setupTestFixtures from './setupTestFixtures.mjs';
|
|
23
23
|
|
|
@@ -32,21 +32,21 @@ process.chdir(fixtureDir);
|
|
|
32
32
|
// server's own build/plugins/*.js — not the app fixture built above, and not
|
|
33
33
|
// present in this checkout) — mock both so runRequest can be unit tested
|
|
34
34
|
// without a real server build.
|
|
35
|
-
const mockCallRequest =
|
|
36
|
-
|
|
35
|
+
const mockCallRequest = vi.fn();
|
|
36
|
+
vi.doMock('@lowdefy/api', () => ({
|
|
37
37
|
callRequest: mockCallRequest,
|
|
38
38
|
}));
|
|
39
|
-
const mockCreateLowdefyContext =
|
|
40
|
-
logger: { info:
|
|
39
|
+
const mockCreateLowdefyContext = vi.fn(async () => ({
|
|
40
|
+
logger: { info: vi.fn(), debug: vi.fn(), warn: vi.fn(), error: vi.fn() },
|
|
41
41
|
}));
|
|
42
|
-
|
|
42
|
+
vi.doMock('../server/createLowdefyContext.js', () => ({
|
|
43
43
|
default: mockCreateLowdefyContext,
|
|
44
44
|
}));
|
|
45
45
|
|
|
46
46
|
// findConfig force-builds a page when pageId is passed — the fixture pages
|
|
47
47
|
// only exist as pre-written build artifacts, so stub the JIT builder out.
|
|
48
|
-
const mockBuildPageIfNeeded =
|
|
49
|
-
|
|
48
|
+
const mockBuildPageIfNeeded = vi.fn(async () => true);
|
|
49
|
+
vi.doMock('../server/jitPageBuilder.js', () => ({
|
|
50
50
|
default: mockBuildPageIfNeeded,
|
|
51
51
|
reviewBuiltPage: async () => 'current',
|
|
52
52
|
syncBuildSignals: () => ({
|
|
@@ -63,7 +63,6 @@ const { default: listPlugins } = await import('./listPlugins.js');
|
|
|
63
63
|
const { default: getSchema } = await import('./getSchema.js');
|
|
64
64
|
const { default: getExamples } = await import('./getExamples.js');
|
|
65
65
|
const { default: getCoreDoc } = await import('./getCoreDoc.js');
|
|
66
|
-
const { default: getPluginDoc } = await import('./getPluginDoc.js');
|
|
67
66
|
const { default: getOverview } = await import('./getOverview.js');
|
|
68
67
|
const { default: searchDocs } = await import('./searchDocs.js');
|
|
69
68
|
const { default: normalizeTypeKind } = await import('./normalizeTypeKind.js');
|
|
@@ -97,6 +96,38 @@ test('listTypes merges client and server operators with environments', () => {
|
|
|
97
96
|
expect(secret.used).toBe(false);
|
|
98
97
|
});
|
|
99
98
|
|
|
99
|
+
test('listTypes with target mobile lists the blocks a native shell carries', () => {
|
|
100
|
+
const blocks = listTypes({ kind: 'blocks', target: 'mobile' });
|
|
101
|
+
expect(blocks.map((block) => block.type)).toEqual(['Button', 'TextInput']);
|
|
102
|
+
const button = blocks.find((block) => block.type === 'Button');
|
|
103
|
+
expect(button.package).toEqual('@lowdefy/blocks-native');
|
|
104
|
+
expect(button.category).toEqual('display');
|
|
105
|
+
expect(button).not.toHaveProperty('used');
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
test('listTypes with target web lists the installed web blocks, as without a target', () => {
|
|
109
|
+
expect(listTypes({ kind: 'blocks', target: 'web' })).toEqual(listTypes({ kind: 'blocks' }));
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
test('listTypes with target mobile takes client operators from the shell and server ones from the app', () => {
|
|
113
|
+
const operators = listTypes({ kind: 'operators', target: 'mobile' });
|
|
114
|
+
expect(operators.map(({ type, environments }) => [type, environments])).toEqual([
|
|
115
|
+
['_get', ['server']],
|
|
116
|
+
['_secret', ['server']],
|
|
117
|
+
['_state', ['client']],
|
|
118
|
+
]);
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
test('listTypes with target mobile lists server kinds as for the web', () => {
|
|
122
|
+
expect(listTypes({ kind: 'requests', target: 'mobile' }).map(({ type }) => type)).toEqual([
|
|
123
|
+
'AxiosHttp',
|
|
124
|
+
]);
|
|
125
|
+
});
|
|
126
|
+
|
|
127
|
+
test('listTypes throws on an unknown target', () => {
|
|
128
|
+
expect(() => listTypes({ kind: 'blocks', target: 'watch' })).toThrow('Unknown target');
|
|
129
|
+
});
|
|
130
|
+
|
|
100
131
|
test('listTypes accepts singular kind names', () => {
|
|
101
132
|
expect(listTypes({ kind: 'block' }).length).toEqual(2);
|
|
102
133
|
});
|
|
@@ -193,22 +224,6 @@ test('getExamples returns null for unknown block type', () => {
|
|
|
193
224
|
expect(getExamples({ type: 'Nope' })).toBeNull();
|
|
194
225
|
});
|
|
195
226
|
|
|
196
|
-
test('getPluginDoc returns README markdown for installed plugin', () => {
|
|
197
|
-
const result = getPluginDoc({ packageName: 'test-plugin' });
|
|
198
|
-
expect(result.markdown).toContain('# test-plugin');
|
|
199
|
-
});
|
|
200
|
-
|
|
201
|
-
test('getPluginDoc returns null for packages without docs', () => {
|
|
202
|
-
expect(getPluginDoc({ packageName: 'no-such-package' })).toBeNull();
|
|
203
|
-
});
|
|
204
|
-
|
|
205
|
-
test('getPluginDoc reads only the app plugins, never a path out of node_modules', () => {
|
|
206
|
-
fs.writeFileSync(path.join(fixtureDir, 'README.md'), '# Server readme\n');
|
|
207
|
-
expect(getPluginDoc({ packageName: '..' })).toBeNull();
|
|
208
|
-
expect(getPluginDoc({ packageName: 'test-plugin/../..' })).toBeNull();
|
|
209
|
-
fs.rmSync(path.join(fixtureDir, 'README.md'));
|
|
210
|
-
});
|
|
211
|
-
|
|
212
227
|
test('getCoreDoc returns markdown by slug from docs-content', () => {
|
|
213
228
|
const doc = getCoreDoc({ slug: 'operators/_get' });
|
|
214
229
|
expect(doc.title).toEqual('_get');
|
|
@@ -255,7 +270,8 @@ test('searchDocs throws on empty query', () => {
|
|
|
255
270
|
test('getOverview includes counts and route guidance', () => {
|
|
256
271
|
const overview = getOverview();
|
|
257
272
|
expect(overview).toContain('2 block types');
|
|
258
|
-
expect(overview).toContain('/lowdefy-docs/
|
|
273
|
+
expect(overview).toContain('`GET /lowdefy-docs/build-status`');
|
|
274
|
+
expect(overview).not.toContain('/lowdefy-docs/schema');
|
|
259
275
|
expect(overview).toContain('lowdefy_list_types');
|
|
260
276
|
expect(overview).not.toContain('config.basePath');
|
|
261
277
|
});
|
|
@@ -319,8 +335,8 @@ test('findConfig resolves a known pageId to its source file', async () => {
|
|
|
319
335
|
expect(result.kind).toEqual('page');
|
|
320
336
|
expect(result.pageId).toEqual('home');
|
|
321
337
|
expect(result.file).toEqual('pages/home.yaml');
|
|
322
|
-
// A page's root block renders with blockId === pageId — open-in-editor
|
|
323
|
-
//
|
|
338
|
+
// A page's root block renders with blockId === pageId — open-in-editor
|
|
339
|
+
// reads matches[0].location.source from this result.
|
|
324
340
|
expect(result.matches.length).toEqual(1);
|
|
325
341
|
expect(result.matches[0].location.source).toContain(path.join('pages', 'home.yaml'));
|
|
326
342
|
});
|
|
@@ -19,6 +19,7 @@ import os from 'os';
|
|
|
19
19
|
import path from 'path';
|
|
20
20
|
|
|
21
21
|
import { serializer } from '@lowdefy/helpers';
|
|
22
|
+
import { afterAll, expect, test } from 'vitest';
|
|
22
23
|
|
|
23
24
|
// A server directory whose build lists an installed plugin, a local plugin
|
|
24
25
|
// linked from outside node_modules, one of Lowdefy's own plugins and a local
|
package/lib/docs/findConfig.js
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
*/
|
|
16
16
|
|
|
17
17
|
import path from 'node:path';
|
|
18
|
-
import {
|
|
18
|
+
import { UserError, resolveConfigLocation } from '@lowdefy/errors';
|
|
19
19
|
import { type } from '@lowdefy/helpers';
|
|
20
20
|
|
|
21
21
|
import buildPageIfNeeded from '../server/jitPageBuilder.js';
|
|
@@ -221,7 +221,7 @@ function scanKeyMapWithDeIndex({ id, keyMap, refMap, configDirectory, pageScope,
|
|
|
221
221
|
// "no matches" as a normal result and try another id or pageId.
|
|
222
222
|
async function findConfig({ id, pageId }) {
|
|
223
223
|
if (type.isNone(id) || !type.isString(id)) {
|
|
224
|
-
throw new
|
|
224
|
+
throw new UserError(
|
|
225
225
|
`findConfig requires an "id" string. Received ${JSON.stringify(id)}. ` +
|
|
226
226
|
'Use GET /lowdefy-docs/find/:id.'
|
|
227
227
|
);
|
|
@@ -232,8 +232,7 @@ async function findConfig({ id, pageId }) {
|
|
|
232
232
|
const buildDirectory = path.join(process.cwd(), 'build');
|
|
233
233
|
|
|
234
234
|
// A page's root block renders with blockId === pageId, so open-in-editor
|
|
235
|
-
//
|
|
236
|
-
// matches[0].location.source, so the page result must carry a match, not
|
|
235
|
+
// hits this branch for it — it reads matches[0].location.source, so the page result must carry a match, not
|
|
237
236
|
// just the file field the docs/MCP consumers use.
|
|
238
237
|
if (pageRegistry[id]) {
|
|
239
238
|
const refPath = pageRegistry[id].refPath;
|
|
@@ -0,0 +1,35 @@
|
|
|
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
|
+
// The block of a built page with this blockId, children included, or null.
|
|
18
|
+
// Children sit in the blocks of each slot and area, as pageBlocks walks them.
|
|
19
|
+
function findPageBlock({ page, blockId }) {
|
|
20
|
+
const containers = ['slots', 'areas'].flatMap((key) => Object.values(page[key] ?? {}));
|
|
21
|
+
for (const container of containers) {
|
|
22
|
+
for (const block of container?.blocks ?? []) {
|
|
23
|
+
if (block.blockId === blockId) {
|
|
24
|
+
return block;
|
|
25
|
+
}
|
|
26
|
+
const found = findPageBlock({ page: block, blockId });
|
|
27
|
+
if (found !== null) {
|
|
28
|
+
return found;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
return null;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export default findPageBlock;
|
|
@@ -0,0 +1,45 @@
|
|
|
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
|
+
|
|
19
|
+
import findPageBlock from './findPageBlock.js';
|
|
20
|
+
|
|
21
|
+
const title = { blockId: 'title', type: 'Title' };
|
|
22
|
+
const card = { blockId: 'card', type: 'Card', slots: { content: { blocks: [title] } } };
|
|
23
|
+
const footer = { blockId: 'footer', type: 'Box' };
|
|
24
|
+
const page = {
|
|
25
|
+
id: 'home',
|
|
26
|
+
type: 'Box',
|
|
27
|
+
slots: { content: { blocks: [card] } },
|
|
28
|
+
areas: { footer: { blocks: [footer] } },
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
test('findPageBlock returns a top-level block with its children', () => {
|
|
32
|
+
expect(findPageBlock({ page, blockId: 'card' })).toBe(card);
|
|
33
|
+
});
|
|
34
|
+
|
|
35
|
+
test('findPageBlock finds a nested block', () => {
|
|
36
|
+
expect(findPageBlock({ page, blockId: 'title' })).toBe(title);
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
test('findPageBlock searches areas as well as slots', () => {
|
|
40
|
+
expect(findPageBlock({ page, blockId: 'footer' })).toBe(footer);
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
test('findPageBlock returns null when no block has the blockId', () => {
|
|
44
|
+
expect(findPageBlock({ page, blockId: 'missing' })).toBeNull();
|
|
45
|
+
});
|
package/lib/docs/fitResponse.js
CHANGED
|
@@ -18,9 +18,9 @@ import crypto from 'node:crypto';
|
|
|
18
18
|
import fs from 'node:fs';
|
|
19
19
|
import path from 'node:path';
|
|
20
20
|
|
|
21
|
-
// Largest
|
|
22
|
-
//
|
|
23
|
-
//
|
|
21
|
+
// Largest value returned inline, in serialized characters. Tool results are
|
|
22
|
+
// compact JSON, so a result is about this size, which keeps it inside the
|
|
23
|
+
// output budget of common MCP clients.
|
|
24
24
|
const MAX_INLINE_RESPONSE_CHARS = 40_000;
|
|
25
25
|
|
|
26
26
|
// Saved responses kept per app; the oldest beyond this are deleted on write.
|
|
@@ -51,29 +51,30 @@ function writeResponseFile({ name, response }) {
|
|
|
51
51
|
return filePath;
|
|
52
52
|
}
|
|
53
53
|
|
|
54
|
-
// Returns the result untouched when its response
|
|
55
|
-
//
|
|
56
|
-
// .lowdefy/responses/ in the config directory, and the result carries
|
|
57
|
-
// file's path and size in its place,
|
|
58
|
-
// or query the
|
|
59
|
-
|
|
54
|
+
// Returns the result untouched when its field (response, by default) fits
|
|
55
|
+
// inline. A larger value, or any value when saveResponse is set, is written in
|
|
56
|
+
// full to .lowdefy/responses/ in the config directory, and the result carries
|
|
57
|
+
// the file's path and size in its place (<field>File, <field>Chars and, for an
|
|
58
|
+
// array, <field>Items), so nothing is cut and an agent can read or query the
|
|
59
|
+
// whole value.
|
|
60
|
+
function fitResponse({ result, name, field = 'response', saveResponse = false }) {
|
|
60
61
|
// A request can resolve with no response; it is written as null.
|
|
61
|
-
const {
|
|
62
|
-
const json = JSON.stringify(
|
|
62
|
+
const { [field]: value = null, ...rest } = result;
|
|
63
|
+
const json = JSON.stringify(value);
|
|
63
64
|
if (!saveResponse && json.length <= MAX_INLINE_RESPONSE_CHARS) {
|
|
64
65
|
return result;
|
|
65
66
|
}
|
|
66
67
|
const fitted = {
|
|
67
68
|
...rest,
|
|
68
|
-
|
|
69
|
-
|
|
69
|
+
[`${field}File`]: writeResponseFile({ name, response: value }),
|
|
70
|
+
[`${field}Chars`]: json.length,
|
|
70
71
|
};
|
|
71
|
-
if (Array.isArray(
|
|
72
|
-
fitted
|
|
72
|
+
if (Array.isArray(value)) {
|
|
73
|
+
fitted[`${field}Items`] = value.length;
|
|
73
74
|
}
|
|
74
75
|
fitted.note = saveResponse
|
|
75
|
-
?
|
|
76
|
-
: `The
|
|
76
|
+
? `The full ${field} was written to ${field}File.`
|
|
77
|
+
: `The ${field} is ${json.length} characters, over the ${MAX_INLINE_RESPONSE_CHARS} returned inline, so it was written in full to ${field}File. Read or query that file instead.`;
|
|
77
78
|
return fitted;
|
|
78
79
|
}
|
|
79
80
|
|
|
@@ -19,6 +19,7 @@ import os from 'node:os';
|
|
|
19
19
|
import path from 'node:path';
|
|
20
20
|
|
|
21
21
|
import fitResponse, { MAX_INLINE_RESPONSE_CHARS, MAX_SAVED_RESPONSES } from './fitResponse.js';
|
|
22
|
+
import { afterEach, beforeEach, expect, test } from 'vitest';
|
|
22
23
|
|
|
23
24
|
let configDirectory;
|
|
24
25
|
|
|
@@ -78,6 +79,23 @@ test('fitResponse writes an oversized response to a file and returns its path in
|
|
|
78
79
|
expect(result.response).toBe(rows);
|
|
79
80
|
});
|
|
80
81
|
|
|
82
|
+
test('fitResponse fits the field it is given, naming the file after the field', () => {
|
|
83
|
+
const page = { id: 'big', blocks: 'x'.repeat(MAX_INLINE_RESPONSE_CHARS) };
|
|
84
|
+
|
|
85
|
+
const fitted = fitResponse({ result: { page }, name: 'big', field: 'page' });
|
|
86
|
+
|
|
87
|
+
expect(fitted.page).toBeUndefined();
|
|
88
|
+
expect(fitted.pageChars).toBe(JSON.stringify(page).length);
|
|
89
|
+
expect(fitted.note).toContain('The page is');
|
|
90
|
+
expect(fitted.note).toContain('written in full to pageFile');
|
|
91
|
+
expect(JSON.parse(fs.readFileSync(fitted.pageFile, 'utf8'))).toEqual(page);
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
test('fitResponse returns a small field untouched', () => {
|
|
95
|
+
const result = { page: { id: 'small' } };
|
|
96
|
+
expect(fitResponse({ result, name: 'small', field: 'page' })).toBe(result);
|
|
97
|
+
});
|
|
98
|
+
|
|
81
99
|
test('fitResponse writes a small response to a file when saveResponse is set', () => {
|
|
82
100
|
const result = { response: { total: 3 }, status: 'success' };
|
|
83
101
|
|
package/lib/docs/getBrowser.js
CHANGED
|
@@ -28,10 +28,10 @@ import recordingCookiePayload from '../server/recording/recordingCookiePayload.j
|
|
|
28
28
|
|
|
29
29
|
// Module-level singleton, shared by every headless caller (screenshots,
|
|
30
30
|
// journeys, state inspection, operator evaluation, state loads) and closed
|
|
31
|
-
// after
|
|
31
|
+
// after 45 s unused. See createBrowserLifecycle.js.
|
|
32
32
|
const { getBrowser, trackContext } = createBrowserLifecycle({
|
|
33
33
|
launch: launchBrowser,
|
|
34
|
-
idleTimeout:
|
|
34
|
+
idleTimeout: 45_000,
|
|
35
35
|
});
|
|
36
36
|
|
|
37
37
|
// `origin` should already include any configured basePath prefix that the
|
|
@@ -127,7 +127,7 @@ async function openPage({
|
|
|
127
127
|
]);
|
|
128
128
|
}
|
|
129
129
|
// A journey on a data set: every request from this context reads the data
|
|
130
|
-
// session's
|
|
130
|
+
// session's databases (see lib/server/applyDataSetRedirect.js), while the
|
|
131
131
|
// developer's own tabs keep the app's real one. Set before the first
|
|
132
132
|
// navigation, so no request from this context ever goes without it.
|
|
133
133
|
if (!type.isUndefined(dataCookie)) {
|
|
@@ -165,7 +165,7 @@ async function openPage({
|
|
|
165
165
|
await page.goto(url, { waitUntil: 'load', timeout });
|
|
166
166
|
// The engine builds the page context (and runs onInit + initial requests)
|
|
167
167
|
// after the bundle loads — 'load' fires before that. Every caller
|
|
168
|
-
// (screenshot, inspect, eval,
|
|
168
|
+
// (screenshot, inspect, eval, journeys) needs the app's
|
|
169
169
|
// async lifecycle to have settled, not just the bundle to have loaded, so
|
|
170
170
|
// wait on isPageReady - for the instance the app shows, which is not the
|
|
171
171
|
// one asked for when the app redirects, as a protected page does for a
|